[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_800":801,"_802":803},"routes/_app.x.$handle.$name",{"_100":99,"_32":45,"_108":86,"_27":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_20":-5,"_120":121,"_122":123,"_124":49,"_125":126,"_127":25,"_128":-5,"_129":-5,"_130":131},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":57,"_58":25,"_59":25,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":49},"version",204,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",true,"deletedHere","path","frontend/components/ShoppingListCreator.tsx","latestPath","fileId","e31ede04-44e4-11f0-be29-76b3cceeab13","name","ShoppingListCreator.tsx","fileType","script","content","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useState } from \"https://esm.sh/react@18.2.0\";\n\nexport function ShoppingListCreator(): JSX.Element {\n const [currentItem, setCurrentItem] = useState(\"\");\n const [items, setItems] = useState([]);\n\n const handleInputChange = (e: React.ChangeEvent) => {\n setCurrentItem(e.target.value);\n };\n\n const addItem = () => {\n const trimmedItem = currentItem.trim();\n if (trimmedItem && !items.includes(trimmedItem)) {\n setItems([...items, trimmedItem]);\n setCurrentItem(\"\");\n }\n };\n\n const handleKeyPress = (e: React.KeyboardEvent) => {\n if (e.key === \"Enter\") {\n e.preventDefault();\n addItem();\n }\n };\n\n const removeItem = (indexToRemove: number) => {\n setItems(items.filter((_, index) => index !== indexToRemove));\n };\n\n const clearAll = () => {\n setItems([]);\n };\n\n return (\n

\n Create Shopping List\n

\n\n {/* Add Item Input */}\n

\n \n \n Add\n \n

\n\n {/* Shopping List */}\n {items.length > 0 && (\n

\n Shopping List ({items.length} items)\n

\n \n Clear all\n \n

\n\n

\n {item}\n removeItem(index)}\n className=\"text-red-600 hover:text-red-800 text-sm font-medium\"\n aria-label={`Remove ${item}`}\n >\n ✕\n \n \n ))}\n

\n )}\n\n {/* Empty State */}\n {items.length === 0 && (\n

No items added yet.

\n Type an item above and press Enter or click Add.\n

\n )}\n\n {/* Process Button */}\n {items.length > 0 && (\n

\n alert(\"Shopping list processing coming soon!\")}\n className=\"inline-flex items-center px-4 py-2 border border-transparent text-sm font-medium rounded-md shadow-sm text-white bg-green-600 hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500\"\n >\n Process List ({items.length} items)\n \n

\n )}\n

\n );\n}\n","createdAt",["D",1750393070864],"branchVersion","branchId","a523f804-3c43-11f0-baed-9e149126039e","id","a5228f14-3c43-11f0-baed-9e149126039e","personalShopper",["D",1748492167939],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","imageUrl","70d1fa10-3c43-11f0-8f77-839c97346035","pinnedFileId","7bbe5560-3c46-11f0-bcc1-9e149126039e","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"orgId","5448abbb-bf1c-494f-95e1-0b9bc21d0698","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_100":99,"_107":103},"org",{"_100":99,"_101":-5,"_102":103,"_18":55,"_104":105,"_106":49},"branch",{"_13":85,"_32":86,"_43":42,"_87":44,"_88":89,"_90":91,"_92":51,"_93":94,"_95":96,"_97":45,"_98":99},"isOwned",218,"main","projectId","forkedBranchId","f2b37196-17c5-11f0-8a41-569c3dd06744","forkedBranchVersion",9,"forkedProjectPrivacy","forkedProjectId","f2b0e6b0-17c5-11f0-8a41-569c3dd06744","forkedProjectOrgId","69d201b4-10ca-4770-a6d6-a8839b626fda","projectName","userHandle","bgschiller","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yeGtwbDJtR1BUTXlCMWc5R1Qwb2ZzTlFYQzgifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":796,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":-5,"_54":-5,"_18":55,"_56":57,"_58":25,"_59":25,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":797,"_80":798,"_82":799,"_84":49},"tree",[240,244,254,261,266,268,304,305,306,307,308],"files",[240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308],"counts",{"_229":161,"_230":62,"_231":62,"_232":233,"_234":235},"contents",[143,144,145,146,147,148,149,150,151,152,153],"upstreamProject",{"_43":94,"_32":140,"_53":-5,"_54":-5,"_50":51,"_78":141},"upstreamBranch",{"_43":89,"_38":132,"_133":134,"_32":86,"_87":94,"_13":91,"_88":135,"_90":136,"_137":138,"_47":-5,"_84":49,"_50":51,"_98":139,"_63":96,"_97":140},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1744479939609],"updatedAt",["D",1744990353681],"419a43c8-147b-11f0-96a2-569c3dd06744",228,"lockfileKey","1767112378995-esm.town_v_geoffreylitt_stevensDemo@9-main","geoffreylitt","stevensDemo",{"_100":139,"_107":142},"https://secure.gravatar.com/avatar/94262cddd28e127e29dacba5f09c8125.jpg?s=200&d=identicon",{"_43":223,"_32":224,"_30":225,"_157":-5,"_41":42,"_40":226,"_159":25,"_38":227,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":228},{"_43":217,"_32":218,"_30":219,"_157":-5,"_41":42,"_40":220,"_159":25,"_38":221,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":222},{"_43":211,"_32":212,"_30":213,"_157":-5,"_41":42,"_40":214,"_159":25,"_38":215,"_13":62,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":216},{"_43":205,"_32":206,"_30":207,"_157":-5,"_41":42,"_40":208,"_159":25,"_38":209,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":210},{"_43":200,"_32":201,"_30":202,"_157":-5,"_41":42,"_40":62,"_159":25,"_38":203,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":204},{"_43":193,"_32":194,"_30":195,"_157":-5,"_41":42,"_40":196,"_159":25,"_38":197,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_27":199},{"_43":187,"_32":188,"_30":189,"_157":-5,"_41":42,"_40":62,"_159":25,"_38":190,"_13":161,"_34":20,"_36":191,"_24":49,"_163":-5,"_27":192},{"_43":180,"_32":181,"_30":182,"_157":-5,"_41":42,"_40":183,"_159":25,"_38":184,"_13":62,"_34":20,"_36":185,"_24":49,"_163":-5,"_27":186},{"_43":173,"_32":174,"_30":175,"_157":-5,"_41":42,"_40":176,"_159":25,"_38":177,"_13":170,"_34":20,"_36":178,"_24":49,"_163":-5,"_27":179},{"_43":165,"_32":166,"_30":167,"_157":-5,"_41":42,"_40":168,"_159":25,"_38":169,"_13":170,"_34":20,"_36":171,"_24":49,"_163":-5,"_27":172},{"_43":154,"_32":155,"_30":156,"_157":-5,"_41":42,"_40":158,"_159":49,"_38":160,"_13":161,"_34":20,"_36":162,"_24":49,"_163":-5,"_27":164},"e352a7fc-44e4-11f0-b4ed-76b3cceeab13","package.json","e352a8c4-44e4-11f0-b4ed-76b3cceeab13","parentId",150,"latest",["D",1749441030551],0,"{\n \"name\": \"personal-shopper\",\n \"version\": \"1.0.0\",\n \"description\": \"AI-powered grocery shopping with Kroger\",\n \"scripts\": {\n \"storybook\": \"storybook dev -p 6006\",\n \"build-storybook\": \"storybook build\"\n },\n \"dependencies\": {\n \"react\": \"^18.2.0\",\n \"react-dom\": \"^18.2.0\"\n },\n \"devDependencies\": {\n \"@storybook/addon-essentials\": \"^7.6.17\",\n \"@storybook/addon-interactions\": \"^7.6.17\",\n \"@storybook/addon-links\": \"^7.6.17\",\n \"@storybook/blocks\": \"^7.6.17\",\n \"@storybook/react\": \"^7.6.17\",\n \"@storybook/react-vite\": \"^7.6.17\",\n \"@storybook/testing-library\": \"^0.2.2\",\n \"storybook\": \"^7.6.17\",\n \"typescript\": \"^5.3.3\",\n \"vite\": \"^5.1.4\"\n },\n \"packageManager\": \"pnpm@8.15.4+sha512.0bd3a9be9eb0e9a692676deec00a303ba218ba279d99241475616b398dbaeedd11146f92c2843458f557b1d127e09d4c171e105bdcd6b61002b39685a8016b9e\"\n}\n","label",[155],"e365355c-44e4-11f0-937c-76b3cceeab13","deno.json","f544c966-3dd4-11f0-ae70-76b3cceeab13",152,["D",1749441030650],2,"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ],\n \"jsx\": \"react-jsx\",\n \"jsxImportSource\": \"https://esm.sh/react@18.2.0\"\n },\n \"lint\": {\n \"files\": {\n \"include\": [\"deno:/https/esm.town/**/*\"]\n },\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"nodeModulesDir\": \"auto\",\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}\n",[166],"b5d9b24e-3c46-11f0-bde3-9e149126039e","README.md","80b611a2-c042-4094-a22c-81cb2ded5934",29,["D",1748493484473],"# Personal Shopper\n\n## Description\n\nThis is an AI-powered Grocery Shopping assistant that turns an imprecise list of items like \"milk, bread, eggs\" into a Kroger cart full of groceries. It relies on the Kroger API to search each item, then uses an LLM to decide which specific UPC to add to the cart (again, using the Kroger API). Once an item is selected, we store the UPC in the database so we can avoid consulting the LLM for that item again.\n\nHouseholds have preferences for which items to buy, and what priorities they have for each item. For example, we prefer to buy free range eggs and poultry, but don't particularly care whether they are organic or not. These details are stored in a database, which should also be consulted to add context to the LLM's decisions.\n\n## Kroger OAuth Implementation\n\nThe application now includes a complete OAuth2 flow for Kroger authentication:\n\n### Environment Variables Required\n\nSet these in your Val Town environment:\n\n- `KROGER_CLIENT_ID` - Your Kroger API client ID\n- `KROGER_CLIENT_SECRET` - Your Kroger API client secret \n- `KROGER_REDIRECT_URI` - Your registered redirect URI (e.g., `https://your-val.web.val.run/auth/callback`)\n\n### OAuth Flow\n\n1. **Login**: User clicks \"Connect with Kroger\" → redirected to `/auth/login`\n2. **Authorization**: App redirects to Kroger's OAuth endpoint with proper parameters\n3. **Callback**: Kroger redirects back to `/auth/callback` with authorization code\n4. **Token Exchange**: App exchanges code for access/refresh tokens\n5. **Profile Fetch**: App gets user's Kroger profile ID\n6. **Session**: User is logged in with session cookie\n\n### Authentication Features\n\n- **Secure Sessions**: HTTP-only cookies with proper security settings\n- **Token Refresh**: Automatic refresh of expired access tokens\n- **State Validation**: CSRF protection using state parameter\n- **User Management**: Create/update users based on Kroger profile ID\n\n## Database Schema\n\nThe database consists of the following tables:\n\n### kroger_users_1\n- `id` - Unique user ID (primary key)\n- `krogerProfileId` - Kroger's unique user identifier\n- `accessToken` - Current OAuth access token\n- `refreshToken` - OAuth refresh token\n- `tokenExpiresAt` - Token expiration timestamp\n- `preferredLocationId` - User's preferred Kroger store location\n- `createdAt` / `updatedAt` - Timestamps\n\n### guidance_1\n- `id` - Unique guidance ID (primary key)\n- `userId` - Foreign key to kroger_users_1\n- `itemName` - Name of the item (e.g., \"milk\", \"bread\")\n- `guidance` - Textual preferences (e.g., \"prefer free range eggs\")\n- `createdAt` / `updatedAt` - Timestamps\n\n### selections_1\n- `id` - Unique selection ID (primary key)\n- `userId` - Foreign key to kroger_users_1\n- `itemName` - User's free text item name\n- `upc` - Selected product UPC code\n- `productName` - Full product name from Kroger\n- `createdAt` / `updatedAt` - Timestamps\n- Unique constraint on (userId, itemName)\n\n## API Endpoints\n\n### Authentication\n- `GET /auth/login` - Start OAuth flow\n- `GET /auth/callback` - OAuth callback handler\n- `POST /auth/logout` - Logout user\n- `GET /api/user` - Get current user info\n- `PUT /api/user/location` - Update preferred store location\n\n### Guidance Management\n- `GET /api/guidance` - Get all guidance for current user\n- `GET /api/guidance/search?q=item` - Search guidance by item name\n- `POST /api/guidance` - Create new guidance\n- `PUT /api/guidance/:id` - Update guidance\n- `DELETE /api/guidance/:id` - Delete guidance\n\n### Selection Management\n- `GET /api/selections` - Get all selections for current user\n- `GET /api/selections/item/:itemName` - Get selection for specific item\n- `POST /api/selections` - Create/update selection\n- `PUT /api/selections/:id` - Update selection\n- `DELETE /api/selections/:id` - Delete selection\n\n## Shopping Process\n\n1. The user supplies a list of items they want to buy.\n2. We search the Kroger API, getting a list of products that match the free text name.\n3. For each item, we:\n 1. Try to find it in selections. If we can't find it there,\n 2. Use full-text search to find the most relevant guidance. Then ask the LLM to decide which specific UPC to add to the cart. Store this in the selections table for next time.\n4. We use the Kroger API to add the item to the cart.\n5. Repeat for each item.\n\nThere is no need to check out the cart, as the user will review the cart in the app and make any necessary changes.\n\n### Secondary flows\n\n- The user can add new items to the guidance table.\n- The user can CRUD their selections.\n- The user can change their Kroger location ID.\n- The user can log out.\n\n## Tech Stack\n\n- TypeScript\n- Val.Town with SQLite integration\n- Hono for the API\n- TailwindCSS for styling\n- Kroger API for product data and cart management\n\n## File Structure\n\n```\n├── backend/\n│ ├── index.ts # Main HTTP handler with OAuth routes\n│ ├── database/\n│ │ ├── migrations.ts # Database schema setup\n│ │ └── krogerQueries.ts # Database query functions\n│ └── services/\n│ └── krogerAuth.ts # Kroger OAuth service\n├── frontend/\n│ └── index.html # Single-page application\n├── shared/\n│ └── types.ts # Shared TypeScript interfaces\n└── docs/ # Kroger API documentation\n```\n\nSee .cursorrules for more details.",[174],"eaec26d2-3ddc-11f0-b9b0-76b3cceeab13",".vtignore","f53a2524-3dd4-11f0-831a-76b3cceeab13",88,["D",1748667949184],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\n.envrc\n",[181],"a527b8e0-3c43-11f0-baed-9e149126039e",".cursorrules","5b776fdb-b581-4e9e-a17f-0d15b7a21e1b",["D",1748492167939],"# Val Town Project Rules and Guidelines\n\nYou are an advanced assistant specialized in generating Val Town code.\n\n\n## Types of Vals\n\n### 1. Script Vals\n\n- Basic JavaScript/TypeScript functions\n- Can be imported by other vals\n- Example structure:\n\n```typescript\nexport function myFunction() {\n // Your code here\n}\n```\n\n### 2. HTTP Vals\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```typescript\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\n### 3. Cron Vals\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```typescript\nexport default async function () {\n // Scheduled task code\n}\n```\n\n### 4. Email Vals\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```typescript\nexport default async function (email: Email) {\n // Process email\n}\n```\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\nAlways import utilities with version pins to avoid breaking changes:\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n1. **parseProject** - Extract information about the current project from import.meta.url:\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\n2. **readFile** - Read files from within the project:\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n3. **serveFile** - Serve project files with proper content types:\n```ts\n// Serve a file from the project with proper Content-Type header\napp.get(\"/public/style.css\", c => serveFile(\"/frontend/style.css\", import.meta.url));\n```\n\n4. **listFiles** - List all files in the project:\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n5. **fetchTranspiledJavaScript** - Fetch and transpile TypeScript to JavaScript:\n```ts\nconst jsCode = await fetchTranspiledJavaScript(\"https://esm.town/v/username/project/path/to/file.ts\");\n```\n\n6. **testServer** - Create a test server for running test suites:\n```ts\nexport default testServer([\n {\n name: \"Feature Tests\",\n tests: [\n {\n name: \"should add numbers correctly\",\n function: () => {\n expect(1 + 1).toBe(2);\n },\n }\n ],\n }\n]);\n```\n\n## Val Town Platform Specifics\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- For AI-generated images, use: `https://maxm-imggenurl.web.val.run/the-description-of-your-image`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link with `import.meta.url.replace(\"esm.town\", \"val.town\")` and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; avoid catches that merely log or return 500s - let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` and minimize their use - prefer APIs without keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- For persistence, use Val Town SQLite or Blob storage with `import.meta.url` for keys/table names\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and include the `@jsxImportSource` pragma\n- When facing client-side render issues, check if all React dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n- Hono is the recommended API framework (similar to Express, Flask, or Sinatra)\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n // Use the serveFile utility to handle content types automatically\n app.get(\"/public/*\", c => serveFile(c.req.path.replace(\"/public\", \"/frontend\"), import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Be careful with error handling as Hono tends to swallow errors\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Frontend Best Practices\n- Structure as a standard client-side React app\n- Use SVG for favicons (Val Town only supports text files)\n- Separate components into individual files\n- Access bootstrapped data from `window.__INITIAL_DATA__`\n- Use React 18.2.0 consistently in all imports and the `@jsxImportSource` pragma\n- Follow the React component pattern from the example project\n- Handle API calls properly with proper error catching\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n- Follow the queries and migrations pattern from the example\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n - Properly handle CORS if needed for external access",[188],"868eda70-4d8d-11f0-b958-76b3cceeab13","ui-kit","868edb7e-4d8d-11f0-b958-76b3cceeab13",166,["D",1750393069165],"directory",[194],"a527b656-3c43-11f0-baed-9e149126039e","shared","f51258e7-ba5a-41ab-9356-127b9178fe98",["D",1748492167939],[201],"9dba5c4a-3c46-11f0-b3a3-9e149126039e","frontend","2c2592a9-213d-42d8-b3c8-e300bf3eaa04",28,["D",1748493443987],[206],"397162ac-3c45-11f0-9e6e-9e149126039e","docs","3679b36a-3c45-11f0-9e6e-9e149126039e",5,["D",1748492846253],[212],"018e8d82-3c46-11f0-b1b1-9e149126039e","backend","b913e97a-f723-4624-98c5-8a0153655046",23,["D",1748493181993],[218],"e2b98a54-44e4-11f0-b4e2-76b3cceeab13",".storybook","e2b98b30-44e4-11f0-b4e2-76b3cceeab13",131,["D",1749441029546],[224],"pulls","branches","forks","envVars",{"_236":238,"_239":161},"connections",{"_236":161,"_237":161},"count","unfilledCount",4,"emptyCount",{"_43":223,"_32":224,"_30":225,"_157":-5,"_41":42,"_40":226,"_159":25,"_38":793,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":794,"_27":795},{"_43":786,"_32":586,"_30":787,"_157":225,"_41":42,"_40":788,"_159":25,"_38":789,"_13":161,"_34":35,"_36":790,"_24":49,"_163":-5,"_310":791,"_27":792},{"_43":778,"_32":779,"_30":780,"_157":225,"_41":42,"_40":781,"_159":25,"_38":782,"_13":161,"_34":20,"_36":783,"_24":49,"_163":-5,"_310":784,"_27":785},{"_43":770,"_32":771,"_30":772,"_157":225,"_41":42,"_40":773,"_159":25,"_38":774,"_13":161,"_34":35,"_36":775,"_24":49,"_163":-5,"_310":776,"_27":777},{"_43":217,"_32":218,"_30":219,"_157":-5,"_41":42,"_40":220,"_159":25,"_38":767,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":768,"_27":769},{"_43":763,"_32":746,"_30":740,"_157":219,"_41":42,"_40":220,"_159":25,"_38":764,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":765,"_27":766},{"_43":755,"_32":756,"_30":757,"_157":740,"_41":42,"_40":758,"_159":25,"_38":759,"_13":658,"_34":35,"_36":760,"_24":49,"_163":-5,"_310":761,"_27":762},{"_43":747,"_32":748,"_30":749,"_157":740,"_41":42,"_40":750,"_159":25,"_38":751,"_13":62,"_34":35,"_36":752,"_24":49,"_163":-5,"_310":753,"_27":754},{"_43":737,"_32":738,"_30":739,"_157":740,"_41":42,"_40":741,"_159":25,"_38":742,"_13":62,"_34":35,"_36":743,"_24":49,"_163":-5,"_310":744,"_27":745},{"_43":732,"_32":723,"_30":716,"_157":219,"_41":42,"_40":733,"_159":25,"_38":734,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":735,"_27":736},{"_43":724,"_32":725,"_30":726,"_157":716,"_41":42,"_40":727,"_159":25,"_38":728,"_13":62,"_34":35,"_36":729,"_24":49,"_163":-5,"_310":730,"_27":731},{"_43":713,"_32":714,"_30":715,"_157":716,"_41":42,"_40":717,"_159":25,"_38":718,"_13":719,"_34":35,"_36":720,"_24":49,"_163":-5,"_310":721,"_27":722},{"_43":705,"_32":706,"_30":707,"_157":219,"_41":42,"_40":708,"_159":25,"_38":709,"_13":62,"_34":35,"_36":710,"_24":49,"_163":-5,"_310":711,"_27":712},{"_43":696,"_32":414,"_30":57,"_157":219,"_41":42,"_40":697,"_159":49,"_38":698,"_13":699,"_34":700,"_36":701,"_24":49,"_163":702,"_310":703,"_27":704},{"_43":211,"_32":212,"_30":213,"_157":-5,"_41":42,"_40":214,"_159":25,"_38":693,"_13":62,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":694,"_27":695},{"_43":686,"_32":687,"_30":688,"_157":213,"_41":42,"_40":91,"_159":25,"_38":689,"_13":658,"_34":20,"_36":690,"_24":49,"_163":-5,"_310":691,"_27":692},{"_43":678,"_32":679,"_30":680,"_157":213,"_41":42,"_40":681,"_159":25,"_38":682,"_13":658,"_34":20,"_36":683,"_24":49,"_163":-5,"_310":684,"_27":685},{"_43":670,"_32":671,"_30":672,"_157":213,"_41":42,"_40":673,"_159":25,"_38":674,"_13":658,"_34":20,"_36":675,"_24":49,"_163":-5,"_310":676,"_27":677},{"_43":662,"_32":663,"_30":664,"_157":213,"_41":42,"_40":665,"_159":25,"_38":666,"_13":62,"_34":20,"_36":667,"_24":49,"_163":-5,"_310":668,"_27":669},{"_43":654,"_32":655,"_30":656,"_157":213,"_41":42,"_40":624,"_159":25,"_38":657,"_13":658,"_34":20,"_36":659,"_24":49,"_163":-5,"_310":660,"_27":661},{"_43":646,"_32":647,"_30":648,"_157":213,"_41":42,"_40":649,"_159":25,"_38":650,"_13":161,"_34":20,"_36":651,"_24":49,"_163":-5,"_310":652,"_27":653},{"_43":205,"_32":206,"_30":207,"_157":-5,"_41":42,"_40":208,"_159":25,"_38":643,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":644,"_27":645},{"_43":637,"_32":445,"_30":638,"_157":207,"_41":42,"_40":639,"_159":49,"_38":640,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":641,"_27":642},{"_43":628,"_32":629,"_30":630,"_157":207,"_41":42,"_40":631,"_159":25,"_38":632,"_13":633,"_34":20,"_36":634,"_24":49,"_163":-5,"_310":635,"_27":636},{"_43":619,"_32":620,"_30":621,"_157":207,"_41":42,"_40":622,"_159":25,"_38":623,"_13":624,"_34":35,"_36":625,"_24":49,"_163":-5,"_310":626,"_27":627},{"_43":611,"_32":612,"_30":613,"_157":207,"_41":42,"_40":614,"_159":25,"_38":615,"_13":161,"_34":20,"_36":616,"_24":49,"_163":-5,"_310":617,"_27":618},{"_43":200,"_32":201,"_30":202,"_157":-5,"_41":42,"_40":62,"_159":25,"_38":608,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":609,"_27":610},{"_43":601,"_32":437,"_30":602,"_157":202,"_41":42,"_40":603,"_159":25,"_38":604,"_13":214,"_34":35,"_36":605,"_24":49,"_163":-5,"_310":606,"_27":607},{"_43":193,"_32":194,"_30":195,"_157":-5,"_41":42,"_40":196,"_159":25,"_38":598,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":599,"_27":600},{"_43":593,"_32":224,"_30":579,"_157":195,"_41":42,"_40":594,"_159":25,"_38":595,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":596,"_27":597},{"_43":585,"_32":586,"_30":587,"_157":579,"_41":42,"_40":588,"_159":25,"_38":589,"_13":161,"_34":35,"_36":590,"_24":49,"_163":-5,"_310":591,"_27":592},{"_43":576,"_32":577,"_30":578,"_157":579,"_41":42,"_40":580,"_159":25,"_38":581,"_13":161,"_34":35,"_36":582,"_24":49,"_163":-5,"_310":583,"_27":584},{"_43":571,"_32":412,"_30":406,"_157":195,"_41":42,"_40":572,"_159":25,"_38":573,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":574,"_27":575},{"_43":566,"_32":445,"_30":439,"_157":406,"_41":42,"_40":567,"_159":25,"_38":568,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":569,"_27":570},{"_43":558,"_32":559,"_30":560,"_157":439,"_41":42,"_40":561,"_159":25,"_38":562,"_13":62,"_34":35,"_36":563,"_24":49,"_163":-5,"_310":564,"_27":565},{"_43":550,"_32":551,"_30":552,"_157":439,"_41":42,"_40":553,"_159":49,"_38":554,"_13":62,"_34":35,"_36":555,"_24":49,"_163":-5,"_310":556,"_27":557},{"_43":542,"_32":543,"_30":544,"_157":439,"_41":42,"_40":545,"_159":49,"_38":546,"_13":62,"_34":35,"_36":547,"_24":49,"_163":-5,"_310":548,"_27":549},{"_43":534,"_32":535,"_30":536,"_157":439,"_41":42,"_40":537,"_159":25,"_38":538,"_13":62,"_34":35,"_36":539,"_24":49,"_163":-5,"_310":540,"_27":541},{"_43":526,"_32":527,"_30":528,"_157":439,"_41":42,"_40":529,"_159":49,"_38":530,"_13":62,"_34":35,"_36":531,"_24":49,"_163":-5,"_310":532,"_27":533},{"_43":518,"_32":519,"_30":520,"_157":439,"_41":42,"_40":521,"_159":49,"_38":522,"_13":62,"_34":35,"_36":523,"_24":49,"_163":-5,"_310":524,"_27":525},{"_43":510,"_32":511,"_30":512,"_157":439,"_41":42,"_40":513,"_159":25,"_38":514,"_13":62,"_34":35,"_36":515,"_24":49,"_163":-5,"_310":516,"_27":517},{"_43":502,"_32":503,"_30":504,"_157":439,"_41":42,"_40":505,"_159":49,"_38":506,"_13":62,"_34":35,"_36":507,"_24":49,"_163":-5,"_310":508,"_27":509},{"_43":494,"_32":495,"_30":496,"_157":439,"_41":42,"_40":497,"_159":25,"_38":498,"_13":62,"_34":35,"_36":499,"_24":49,"_163":-5,"_310":500,"_27":501},{"_43":486,"_32":487,"_30":488,"_157":439,"_41":42,"_40":489,"_159":49,"_38":490,"_13":62,"_34":35,"_36":491,"_24":49,"_163":-5,"_310":492,"_27":493},{"_43":478,"_32":479,"_30":480,"_157":439,"_41":42,"_40":481,"_159":25,"_38":482,"_13":161,"_34":35,"_36":483,"_24":49,"_163":-5,"_310":484,"_27":485},{"_43":470,"_32":471,"_30":472,"_157":439,"_41":42,"_40":473,"_159":49,"_38":474,"_13":161,"_34":35,"_36":475,"_24":49,"_163":-5,"_310":476,"_27":477},{"_43":462,"_32":463,"_30":464,"_157":439,"_41":42,"_40":465,"_159":25,"_38":466,"_13":161,"_34":35,"_36":467,"_24":49,"_163":-5,"_310":468,"_27":469},{"_43":454,"_32":455,"_30":456,"_157":439,"_41":42,"_40":457,"_159":49,"_38":458,"_13":161,"_34":35,"_36":459,"_24":49,"_163":-5,"_310":460,"_27":461},{"_43":446,"_32":447,"_30":448,"_157":439,"_41":42,"_40":449,"_159":25,"_38":450,"_13":161,"_34":35,"_36":451,"_24":49,"_163":-5,"_310":452,"_27":453},{"_43":436,"_32":437,"_30":438,"_157":439,"_41":42,"_40":440,"_159":25,"_38":441,"_13":62,"_34":35,"_36":442,"_24":49,"_163":-5,"_310":443,"_27":444},{"_43":431,"_32":430,"_30":424,"_157":406,"_41":42,"_40":432,"_159":25,"_38":433,"_13":161,"_34":198,"_36":-5,"_24":49,"_163":-5,"_310":434,"_27":435},{"_43":421,"_32":422,"_30":423,"_157":424,"_41":42,"_40":425,"_159":25,"_38":426,"_13":161,"_34":20,"_36":427,"_24":49,"_163":-5,"_310":428,"_27":429},{"_43":413,"_32":414,"_30":415,"_157":406,"_41":42,"_40":416,"_159":25,"_38":417,"_13":161,"_34":35,"_36":418,"_24":49,"_163":-5,"_310":419,"_27":420},{"_43":403,"_32":404,"_30":405,"_157":406,"_41":42,"_40":407,"_159":25,"_38":408,"_13":161,"_34":35,"_36":409,"_24":49,"_163":-5,"_310":410,"_27":411},{"_43":395,"_32":396,"_30":397,"_157":195,"_41":42,"_40":398,"_159":25,"_38":399,"_13":161,"_34":20,"_36":400,"_24":49,"_163":-5,"_310":401,"_27":402},{"_43":387,"_32":388,"_30":389,"_157":195,"_41":42,"_40":390,"_159":25,"_38":391,"_13":161,"_34":20,"_36":392,"_24":49,"_163":-5,"_310":393,"_27":394},{"_43":380,"_32":174,"_30":381,"_157":195,"_41":42,"_40":382,"_159":25,"_38":383,"_13":161,"_34":20,"_36":384,"_24":49,"_163":-5,"_310":385,"_27":386},{"_43":373,"_32":155,"_30":374,"_157":195,"_41":42,"_40":375,"_159":25,"_38":376,"_13":161,"_34":20,"_36":377,"_24":49,"_163":-5,"_310":378,"_27":379},{"_43":365,"_32":366,"_30":367,"_157":195,"_41":42,"_40":368,"_159":25,"_38":369,"_13":161,"_34":35,"_36":370,"_24":49,"_163":-5,"_310":371,"_27":372},{"_43":357,"_32":358,"_30":359,"_157":195,"_41":42,"_40":360,"_159":25,"_38":361,"_13":161,"_34":35,"_36":362,"_24":49,"_163":-5,"_310":363,"_27":364},{"_43":349,"_32":350,"_30":351,"_157":195,"_41":42,"_40":352,"_159":25,"_38":353,"_13":161,"_34":20,"_36":354,"_24":49,"_163":-5,"_310":355,"_27":356},{"_43":341,"_32":342,"_30":343,"_157":195,"_41":42,"_40":344,"_159":25,"_38":345,"_13":161,"_34":20,"_36":346,"_24":49,"_163":-5,"_310":347,"_27":348},{"_43":333,"_32":334,"_30":335,"_157":195,"_41":42,"_40":336,"_159":25,"_38":337,"_13":161,"_34":35,"_36":338,"_24":49,"_163":-5,"_310":339,"_27":340},{"_43":325,"_32":326,"_30":327,"_157":195,"_41":42,"_40":328,"_159":25,"_38":329,"_13":161,"_34":35,"_36":330,"_24":49,"_163":-5,"_310":331,"_27":332},{"_43":187,"_32":188,"_30":189,"_157":-5,"_41":42,"_40":62,"_159":25,"_38":322,"_13":161,"_34":20,"_36":191,"_24":49,"_163":-5,"_310":323,"_27":324},{"_43":180,"_32":181,"_30":182,"_157":-5,"_41":42,"_40":183,"_159":25,"_38":319,"_13":62,"_34":20,"_36":185,"_24":49,"_163":-5,"_310":320,"_27":321},{"_43":173,"_32":174,"_30":175,"_157":-5,"_41":42,"_40":176,"_159":25,"_38":316,"_13":170,"_34":20,"_36":178,"_24":49,"_163":-5,"_310":317,"_27":318},{"_43":165,"_32":166,"_30":167,"_157":-5,"_41":42,"_40":168,"_159":25,"_38":313,"_13":170,"_34":20,"_36":171,"_24":49,"_163":-5,"_310":314,"_27":315},{"_43":154,"_32":155,"_30":156,"_157":-5,"_41":42,"_40":158,"_159":49,"_38":309,"_13":161,"_34":20,"_36":162,"_24":49,"_163":-5,"_310":311,"_27":312},["D",1749441030551],"children",[],[155],["D",1749441030650],[],[166],["D",1748493484473],[],[174],["D",1748667949184],[],[181],["D",1748492167939],[],[188],"874c38ea-4d8d-11f0-825e-76b3cceeab13","vitest.config.ts","874c39b2-4d8d-11f0-825e-76b3cceeab13",191,["D",1750393070407],"import { defineConfig } from 'vitest/config';\nimport react from '@vitejs/plugin-react';\n\nexport default defineConfig({\n plugins: [react()],\n test: {\n environment: 'jsdom',\n setupFiles: ['./src/setupTests.ts'],\n globals: true,\n css: true,\n coverage: {\n reporter: ['text', 'html'],\n exclude: [\n '**/*.d.ts',\n '**/*.stories.*',\n '**/index.ts',\n '**/setupTests.ts',\n ],\n },\n include: [\n 'src/**/*.test.{ts,tsx}',\n 'src/**/*.spec.{ts,tsx}',\n 'src/**/__tests__/*.{ts,tsx}',\n 'src/components/**/*.test.{ts,tsx}',\n ],\n },\n});\n",[],[194,326],"87482a7a-4d8d-11f0-ade6-76b3cceeab13","vite.config.ts","87482b2e-4d8d-11f0-ade6-76b3cceeab13",190,["D",1750393070380],"import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\nimport dts from 'vite-plugin-dts'\nimport { resolve } from 'path'\n\n// https://vitejs.dev/config/\nexport default defineConfig({\n plugins: [\n react(),\n dts({\n insertTypesEntry: true,\n }),\n ],\n build: {\n lib: {\n entry: resolve(__dirname, 'src/index.ts'),\n name: 'PersonalShopperUIKit',\n formats: ['es'],\n fileName: 'index',\n },\n rollupOptions: {\n external: ['react', 'react-dom', 'react/jsx-runtime'],\n output: {\n globals: {\n react: 'React',\n 'react-dom': 'ReactDOM',\n 'react/jsx-runtime': 'react/jsx-runtime',\n },\n },\n },\n },\n resolve: {\n alias: {\n '@': resolve(__dirname, './src'),\n },\n },\n})\n",[],[194,334],"8721c984-4d8d-11f0-ade6-76b3cceeab13","tsconfig.node.json","8721ca4c-4d8d-11f0-ade6-76b3cceeab13",182,["D",1750393070118],"{\n \"compilerOptions\": {\n \"composite\": true,\n \"skipLibCheck\": true,\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"allowSyntheticDefaultImports\": true,\n \"strict\": true\n },\n \"include\": [\"vite.config.ts\", \".storybook/**/*\"]\n}\n",[],[194,342],"8744acba-4d8d-11f0-bb34-76b3cceeab13","tsconfig.json","8744ad82-4d8d-11f0-bb34-76b3cceeab13",189,["D",1750393070359],"{\n \"compilerOptions\": {\n \"target\": \"ES2020\",\n \"useDefineForClassFields\": true,\n \"lib\": [\"ES2020\", \"DOM\", \"DOM.Iterable\"],\n \"module\": \"ESNext\",\n \"skipLibCheck\": true,\n\n /* Bundler mode */\n \"moduleResolution\": \"bundler\",\n \"allowImportingTsExtensions\": true,\n \"resolveJsonModule\": true,\n \"isolatedModules\": true,\n \"noEmit\": true,\n \"jsx\": \"react-jsx\",\n\n /* Linting */\n \"strict\": true,\n \"noUnusedLocals\": true,\n \"noUnusedParameters\": true,\n \"noFallthroughCasesInSwitch\": true,\n\n /* Path mapping */\n \"baseUrl\": \".\",\n \"paths\": {\n \"@/*\": [\"./src/*\"]\n },\n\n /* Library build */\n \"declaration\": true,\n \"declarationMap\": true,\n \"outDir\": \"./dist\"\n },\n \"include\": [\n \"src/**/*\",\n \"components/**/*\"\n ],\n \"exclude\": [\n \"node_modules\",\n \"dist\",\n \"storybook-static\"\n ],\n \"references\": [{ \"path\": \"./tsconfig.node.json\" }]\n}\n",[],[194,350],"87250ea0-4d8d-11f0-a09a-76b3cceeab13","tailwind.config.js","87250f36-4d8d-11f0-a09a-76b3cceeab13",183,["D",1750393070119],"/** @type {import('tailwindcss').Config} */\nexport default {\n content: [\n \"./components/**/*.{js,ts,jsx,tsx}\",\n \"./src/**/*.{js,ts,jsx,tsx}\",\n \"./.storybook/**/*.{js,ts,jsx,tsx}\",\n ],\n theme: {\n extend: {\n colors: {\n primary: {\n 50: '#eff6ff',\n 100: '#dbeafe',\n 200: '#bfdbfe',\n 300: '#93c5fd',\n 400: '#60a5fa',\n 500: '#3b82f6',\n 600: '#2563eb',\n 700: '#1d4ed8',\n 800: '#1e40af',\n 900: '#1e3a8a',\n },\n secondary: {\n 50: '#f9fafb',\n 100: '#f3f4f6',\n 200: '#e5e7eb',\n 300: '#d1d5db',\n 400: '#9ca3af',\n 500: '#6b7280',\n 600: '#4b5563',\n 700: '#374151',\n 800: '#1f2937',\n 900: '#111827',\n },\n success: {\n 50: '#f0fdf4',\n 100: '#dcfce7',\n 200: '#bbf7d0',\n 300: '#86efac',\n 400: '#4ade80',\n 500: '#22c55e',\n 600: '#16a34a',\n 700: '#15803d',\n 800: '#166534',\n 900: '#14532d',\n },\n warning: {\n 50: '#fffbeb',\n 100: '#fef3c7',\n 200: '#fde68a',\n 300: '#fcd34d',\n 400: '#fbbf24',\n 500: '#f59e0b',\n 600: '#d97706',\n 700: '#b45309',\n 800: '#92400e',\n 900: '#78350f',\n },\n error: {\n 50: '#fef2f2',\n 100: '#fee2e2',\n 200: '#fecaca',\n 300: '#fca5a5',\n 400: '#f87171',\n 500: '#ef4444',\n 600: '#dc2626',\n 700: '#b91c1c',\n 800: '#991b1b',\n 900: '#7f1d1d',\n },\n },\n fontFamily: {\n sans: [\n '-apple-system',\n 'BlinkMacSystemFont',\n 'Segoe UI',\n 'Roboto',\n 'Oxygen',\n 'Ubuntu',\n 'Cantarell',\n 'Fira Sans',\n 'Droid Sans',\n 'Helvetica Neue',\n 'sans-serif',\n ],\n },\n spacing: {\n '18': '4.5rem',\n '88': '22rem',\n },\n maxWidth: {\n '8xl': '88rem',\n '9xl': '96rem',\n },\n animation: {\n 'fade-in': 'fadeIn 0.5s ease-in-out',\n 'slide-up': 'slideUp 0.3s ease-out',\n 'slide-down': 'slideDown 0.3s ease-out',\n },\n keyframes: {\n fadeIn: {\n '0%': { opacity: '0' },\n '100%': { opacity: '1' },\n },\n slideUp: {\n '0%': { transform: 'translateY(10px)', opacity: '0' },\n '100%': { transform: 'translateY(0)', opacity: '1' },\n },\n slideDown: {\n '0%': { transform: 'translateY(-10px)', opacity: '0' },\n '100%': { transform: 'translateY(0)', opacity: '1' },\n },\n },\n },\n },\n plugins: [],\n}\n",[],[194,358],"87546a42-4d8d-11f0-ae04-76b3cceeab13","postcss.config.js","87546b82-4d8d-11f0-ae04-76b3cceeab13",192,["D",1750393070462],"export default {\n plugins: {\n tailwindcss: {},\n autoprefixer: {},\n },\n}\n",[],[194,366],"873c5af6-4d8d-11f0-a392-76b3cceeab13","873c5ba0-4d8d-11f0-a392-76b3cceeab13",188,["D",1750393070292],"{\n \"name\": \"personal-shopper-ui-kit\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"type\": \"module\",\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.js\",\n \"types\": \"./dist/index.d.ts\"\n }\n },\n \"files\": [\n \"dist\"\n ],\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"tsc && vite build\",\n \"preview\": \"vite preview\",\n \"test\": \"vitest run\",\n \"test:watch\": \"vitest\",\n \"storybook\": \"storybook dev -p 6006\",\n \"build-storybook\": \"storybook build\",\n \"lint\": \"eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0\",\n \"type-check\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"react\": \"^18.2.0\",\n \"react-dom\": \"^18.2.0\"\n },\n \"devDependencies\": {\n \"@storybook/addon-essentials\": \"^7.6.7\",\n \"@storybook/addon-interactions\": \"^7.6.7\",\n \"@storybook/addon-links\": \"^7.6.7\",\n \"@storybook/blocks\": \"^7.6.7\",\n \"@storybook/react\": \"^7.6.7\",\n \"@storybook/react-vite\": \"^7.6.7\",\n \"@storybook/testing-library\": \"^0.2.2\",\n \"@testing-library/jest-dom\": \"^6.1.5\",\n \"@testing-library/react\": \"^14.1.2\",\n \"@testing-library/user-event\": \"^14.5.1\",\n \"@types/react\": \"^18.2.45\",\n \"@types/react-dom\": \"^18.2.18\",\n \"@typescript-eslint/eslint-plugin\": \"^6.14.0\",\n \"@typescript-eslint/parser\": \"^6.14.0\",\n \"@vitejs/plugin-react\": \"^4.2.1\",\n \"autoprefixer\": \"^10.4.16\",\n \"eslint\": \"^8.55.0\",\n \"eslint-plugin-react\": \"^7.37.5\",\n \"eslint-plugin-react-hooks\": \"^4.6.0\",\n \"eslint-plugin-react-refresh\": \"^0.4.5\",\n \"eslint-plugin-storybook\": \"^0.6.15\",\n \"identity-obj-proxy\": \"^3.0.0\",\n \"jsdom\": \"^26.1.0\",\n \"postcss\": \"^8.4.32\",\n \"storybook\": \"^7.6.7\",\n \"tailwindcss\": \"^3.3.6\",\n \"typescript\": \"^5.2.2\",\n \"vite\": \"^5.0.8\",\n \"vite-plugin-dts\": \"^3.6.4\",\n \"vitest\": \"^1.4.0\"\n },\n \"peerDependencies\": {\n \"react\": \">=18.0.0\",\n \"react-dom\": \">=18.0.0\"\n },\n \"packageManager\": \"pnpm@8.15.4+sha512.0bd3a9be9eb0e9a692676deec00a303ba218ba279d99241475616b398dbaeedd11146f92c2843458f557b1d127e09d4c171e105bdcd6b61002b39685a8016b9e\"\n}\n",[],[194,155],"8731de50-4d8d-11f0-aae6-76b3cceeab13","8731df0e-4d8d-11f0-aae6-76b3cceeab13",185,["D",1750393070234],"# Personal Shopper UI Kit\n\nA React component library for the Personal Shopper application, built with Vite, TypeScript, and Tailwind CSS.\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\npnpm install\n```\n\n### Development\n\nStart Storybook for component development:\n\n```bash\npnpm storybook\n```\n\nBuild the library:\n\n```bash\npnpm build\n```\n\nRun type checking:\n\n```bash\npnpm type-check\n```\n\nRun linting:\n\n```bash\npnpm lint\n```\n\n## 📦 Components\n\nThis UI kit includes the following components:\n\n- **Dashboard** - Main dashboard layout with location picker and action cards\n- **DashboardCard** - Reusable card component for dashboard metrics\n- **CurrentLocationIndicator** - Shows current store location or prompts to select one\n- **LocationSearch** - Search and select Kroger store locations by zip code\n- **LoginPage** - OAuth login page for Kroger authentication\n- **Navbar** - Application navigation bar with user info and logout\n- **ShoppingListCreator** - Create and manage shopping lists\n\n## 🛠 Technology Stack\n\n- **React 18** - UI library\n- **TypeScript** - Type safety\n- **Vite** - Build tool and dev server\n- **Tailwind CSS** - Utility-first CSS framework\n- **Storybook** - Component development and documentation\n- **ESLint** - Code linting\n\n## 📁 Project Structure\n\n```\nui-kit/\n├── .storybook/ # Storybook configuration\n├── components/ # React components\n│ ├── *.tsx # Component implementations\n│ ├── *.stories.tsx # Storybook stories\n│ └── types.ts # Component type definitions\n├── src/\n│ ├── components/ # Future home for components (migration)\n│ ├── styles/ # Global styles and CSS\n│ └── index.ts # Main library exports\n├── dist/ # Built library output\n└── storybook-static/ # Built Storybook output\n```\n\n## 🎨 Styling\n\nThis library uses Tailwind CSS for styling. The configuration includes:\n\n- Custom color palette for branding\n- Extended spacing and sizing utilities\n- Custom animations and transitions\n- Component-specific utility classes\n\n### Custom Tailwind Classes\n\n```css\n.btn-primary # Primary button styling\n.btn-secondary # Secondary button styling\n.card # Card container styling\n.form-input # Form input styling\n```\n\n## 📖 Storybook\n\nEach component has corresponding Storybook stories for development and documentation. Stories include:\n\n- Default state examples\n- Various prop combinations\n- Interactive controls for testing\n- Documentation and usage examples\n\nAccess Storybook at `http://localhost:6006` when running `pnpm storybook`.\n\n## 🔧 Build Configuration\n\n### Vite Configuration\n\n- Library mode for component distribution\n- TypeScript declaration generation\n- React plugin for JSX transform\n- Path aliases for cleaner imports\n\n### TypeScript Configuration\n\n- Strict type checking enabled\n- JSX React runtime\n- Declaration file generation\n- Path mapping for imports\n\n## 📝 Usage\n\n### Installing as a Dependency\n\nOnce published, install the UI kit in your project:\n\n```bash\npnpm add personal-shopper-ui-kit\n```\n\n### Importing Components\n\n```tsx\nimport { Dashboard, Navbar, LoginPage } from 'personal-shopper-ui-kit';\nimport type { DashboardProps } from 'personal-shopper-ui-kit';\n```\n\n### Including Styles\n\nMake sure to import the CSS in your main application:\n\n```tsx\nimport 'personal-shopper-ui-kit/dist/style.css';\n```\n\n## 🤝 Contributing\n\n1. Make changes to components in the `components/` directory\n2. Update or add Storybook stories for new features\n3. Run `pnpm type-check` and `pnpm lint` before committing\n4. Test components in Storybook before integration\n\n## 📄 License\n\nThis project is part of the Personal Shopper application and follows the same licensing terms.",[],[194,174],"873573ee-4d8d-11f0-a2e6-76b3cceeab13",".gitignore","87357484-4d8d-11f0-a2e6-76b3cceeab13",186,["D",1750393070257],"# Dependencies\nnode_modules/\n.pnpm-store/\n\n# Build outputs\ndist/\nbuild/\n*.tsbuildinfo\n\n# Storybook\nstorybook-static/\n\n# Environment variables\n.env\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\n# Logs\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\nlerna-debug.log*\n\n# Runtime data\npids\n*.pid\n*.seed\n*.pid.lock\n\n# Coverage directory used by tools like istanbul\ncoverage/\n*.lcov\n\n# nyc test coverage\n.nyc_output\n\n# ESLint cache\n.eslintcache\n\n# Optional npm cache directory\n.npm\n\n# Optional eslint cache\n.eslintcache\n\n# Microbundle cache\n.rpt2_cache/\n.rts2_cache_cjs/\n.rts2_cache_es/\n.rts2_cache_umd/\n\n# Optional REPL history\n.node_repl_history\n\n# Output of 'npm pack'\n*.tgz\n\n# Yarn Integrity file\n.yarn-integrity\n\n# parcel-bundler cache (https://parceljs.org/)\n.cache\n.parcel-cache\n\n# Next.js build output\n.next\n\n# Nuxt.js build / generate output\n.nuxt\ndist\n\n# Gatsby files\n.cache/\npublic\n\n# Vuepress build output\n.vuepress/dist\n\n# Serverless directories\n.serverless/\n\n# FuseBox cache\n.fusebox/\n\n# DynamoDB Local files\n.dynamodb/\n\n# TernJS port file\n.tern-port\n\n# Stores VSCode versions used for testing VSCode extensions\n.vscode-test\n\n# Temporary folders\ntmp/\ntemp/\n\n# IDE files\n.vscode/\n.idea/\n*.swp\n*.swo\n*~\n\n# OS generated files\n.DS_Store\n.DS_Store?\n._*\n.Spotlight-V100\n.Trashes\nehthumbs.db\nThumbs.db\n",[],[194,388],"872aa892-4d8d-11f0-a392-76b3cceeab13",".eslintrc.cjs","872aa928-4d8d-11f0-a392-76b3cceeab13",184,["D",1750393070188],"module.exports = {\n root: true,\n env: {\n browser: true,\n es2020: true,\n node: true,\n },\n extends: [\n \"eslint:recommended\",\n \"plugin:@typescript-eslint/recommended\",\n \"plugin:react/recommended\",\n \"plugin:react-hooks/recommended\",\n ],\n ignorePatterns: [\n \"dist\",\n \".eslintrc.cjs\",\n \"storybook-static\",\n \"vite.config.ts\",\n ],\n parser: \"@typescript-eslint/parser\",\n parserOptions: {\n ecmaVersion: \"latest\",\n sourceType: \"module\",\n ecmaFeatures: {\n jsx: true,\n },\n project: \"./tsconfig.json\",\n },\n rules: {\n \"prefer-const\": \"error\",\n \"no-var\": \"error\",\n \"object-shorthand\": \"error\",\n \"prefer-template\": \"error\",\n \"no-unused-vars\": \"off\", // Disable for now to avoid conflicts\n \"react/react-in-jsx-scope\": \"off\",\n \"react/prop-types\": \"off\",\n },\n settings: {\n react: {\n version: \"detect\",\n },\n },\n};\n",[],[194,396],"8757b030-4d8d-11f0-863f-76b3cceeab13","setupTests.ts","8757b102-4d8d-11f0-863f-76b3cceeab13","86b5cd92-4d8d-11f0-9d77-76b3cceeab13",193,["D",1750393070483],"import \"@testing-library/jest-dom\";\n\n// Mock window.alert for tests (Vitest)\nbeforeAll(() => {\n window.alert = vi.fn();\n});\n\n// Only mock setSelectionRange as a no-op for Vitest/jsdom\nbeforeAll(() => {\n Object.defineProperty(HTMLTextAreaElement.prototype, \"setSelectionRange\", {\n writable: true,\n value: () => {},\n });\n});\n",[],[194,412,404],"src","878032a8-4d8d-11f0-a7ec-76b3cceeab13","index.ts","87803352-4d8d-11f0-a7ec-76b3cceeab13",201,["D",1750393070747],"// Main library exports\nexport { Dashboard } from \"src/components/Dashboard\";\nexport { DashboardCard } from \"src/components/DashboardCard\";\nexport { CurrentLocationIndicator } from \"src/components/CurrentLocationIndicator\";\nexport { LocationSearch } from \"src/components/LocationSearch\";\nexport { LoginPage } from \"src/components/LoginPage\";\nexport { Navbar } from \"src/components/Navbar\";\nexport { ShoppingListCreator } from \"src/components/ShoppingListCreator\";\nexport { ProductCard } from \"src/components/ProductCard\";\n\n// Type exports\nexport type {\n DashboardProps,\n DashboardCardProps,\n CurrentLocationIndicatorProps,\n LocationSearchProps,\n NavbarProps,\n} from \"src/components/types\";\nexport type { ProductCardProps, Product } from \"src/components/ProductCard\";\n\n// Re-export shared types for convenience\nexport type { UserData, Location } from \"../../shared/types\";\n",[],[194,412,414],"877016ac-4d8d-11f0-a392-76b3cceeab13","globals.css","87701742-4d8d-11f0-a392-76b3cceeab13","86c69a6e-4d8d-11f0-b958-76b3cceeab13",198,["D",1750393070485],"@tailwind base;\n@tailwind components;\n@tailwind utilities;\n\n/* Custom base styles */\n@layer base {\n * {\n box-sizing: border-box;\n }\n\n html,\n body {\n padding: 0;\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Oxygen,\n Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue, sans-serif;\n }\n\n a {\n color: inherit;\n text-decoration: none;\n }\n\n button {\n font-family: inherit;\n }\n}\n\n/* Custom component styles */\n@layer components {\n .btn-primary {\n @apply inline-flex items-center px-4 py-2 border border-transparent text-sm font-medium rounded-md shadow-sm text-white bg-blue-600 hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500;\n }\n\n .btn-secondary {\n @apply inline-flex items-center px-4 py-2 border border-gray-300 text-sm font-medium rounded-md shadow-sm text-gray-700 bg-white hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500;\n }\n\n .card {\n @apply bg-white overflow-hidden shadow rounded-lg;\n }\n\n .form-input {\n @apply block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:ring-blue-500 focus:border-blue-500 sm:text-sm;\n }\n}\n\n/* Custom utility styles */\n@layer utilities {\n .text-balance {\n text-wrap: balance;\n }\n}\n",[],[194,412,430,422],"styles","86c699c4-4d8d-11f0-b958-76b3cceeab13",169,["D",1750393069531],[291],[194,412,430],"871abfa4-4d8d-11f0-aae6-76b3cceeab13","types.ts","e312bb92-44e4-11f0-bb93-76b3cceeab13","86d722f8-4d8d-11f0-bcd0-76b3cceeab13",180,["D",1750393069755],"import { ReactNode } from \"react\";\nimport { UserData, Location } from \"../../shared/types.ts\";\n\nexport interface DashboardCardProps {\n title: string;\n count: string | number;\n icon: ReactNode;\n actionText: string;\n onAction: () => void;\n}\n\nexport interface NavbarProps {\n userData: UserData;\n}\n\nexport interface DashboardProps {\n userData: UserData;\n}\n\nexport interface LocationSearchProps {\n onLocationSelected?: () => void;\n}\n\nexport interface CurrentLocationIndicatorProps {\n location: Location | null;\n onClick: () => void;\n}\n",[],[194,412,445,437],"components","87784f20-4d8d-11f0-a7ec-76b3cceeab13","ShoppingListCreator.stories.tsx","87784ff2-4d8d-11f0-a7ec-76b3cceeab13",200,["D",1750393070695],"import React from \"react\";\nimport { Meta, StoryObj } from \"@storybook/react\";\nimport { ShoppingListCreator } from \"./ShoppingListCreator\";\n\nconst meta: Meta = {\n title: \"Components/ShoppingListCreator\",\n component: ShoppingListCreator,\n parameters: {\n layout: \"centered\",\n },\n};\n\nexport default meta;\n\ntype Story = StoryObj;\n\nexport const Default: Story = {\n render: () => {\n const [items, setItems] = React.useState([]);\n const [cursorLine, setCursorLine] = React.useState(null);\n\n return (\n

\n {\n setItems(value);\n // eslint-disable-next-line no-console\n console.log(\"onChange:\", value);\n }}\n onCursorLineChange={(line) => {\n setCursorLine(line);\n // eslint-disable-next-line no-console\n console.log(\"onCursorLineChange: line\", line);\n }}\n />\n

\n Current items:\n

\n              {JSON.stringify(items, null, 2)}\n

Diff · v204