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",[178],"868eda70-4d8d-11f0-b958-76b3cceeab13","ui-kit","868edb7e-4d8d-11f0-b958-76b3cceeab13",166,["D",1750393069165],[185],"a527b656-3c43-11f0-baed-9e149126039e","shared","f51258e7-ba5a-41ab-9356-127b9178fe98",["D",1748492167939],[191],"9dba5c4a-3c46-11f0-b3a3-9e149126039e","frontend","2c2592a9-213d-42d8-b3c8-e300bf3eaa04",28,["D",1748493443987],[196],"397162ac-3c45-11f0-9e6e-9e149126039e","docs","3679b36a-3c45-11f0-9e6e-9e149126039e",5,["D",1748492846253],[202],"018e8d82-3c46-11f0-b1b1-9e149126039e","backend","b913e97a-f723-4624-98c5-8a0153655046",23,["D",1748493181993],[208],"e2b98a54-44e4-11f0-b4e2-76b3cceeab13",".storybook","e2b98b30-44e4-11f0-b4e2-76b3cceeab13",131,["D",1749441029546],[214],"pulls","branches","forks","envVars",{"_226":228,"_229":181},"connections",{"_226":181,"_227":181},"count","unfilledCount",4,"emptyCount",{"_42":213,"_32":214,"_30":215,"_155":-5,"_40":41,"_39":216,"_157":25,"_37":773,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":774,"_27":775},{"_42":766,"_32":572,"_30":767,"_155":215,"_40":41,"_39":768,"_157":25,"_37":769,"_13":181,"_34":315,"_36":770,"_24":48,"_161":-5,"_298":771,"_27":772},{"_42":758,"_32":759,"_30":760,"_155":215,"_40":41,"_39":761,"_157":25,"_37":762,"_13":181,"_34":20,"_36":763,"_24":48,"_161":-5,"_298":764,"_27":765},{"_42":750,"_32":751,"_30":752,"_155":215,"_40":41,"_39":753,"_157":25,"_37":754,"_13":181,"_34":315,"_36":755,"_24":48,"_161":-5,"_298":756,"_27":757},{"_42":207,"_32":208,"_30":209,"_155":-5,"_40":41,"_39":210,"_157":25,"_37":747,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":748,"_27":749},{"_42":743,"_32":726,"_30":720,"_155":209,"_40":41,"_39":210,"_157":25,"_37":744,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":745,"_27":746},{"_42":735,"_32":736,"_30":737,"_155":720,"_40":41,"_39":738,"_157":25,"_37":739,"_13":638,"_34":315,"_36":740,"_24":48,"_161":-5,"_298":741,"_27":742},{"_42":727,"_32":728,"_30":729,"_155":720,"_40":41,"_39":730,"_157":25,"_37":731,"_13":61,"_34":315,"_36":732,"_24":48,"_161":-5,"_298":733,"_27":734},{"_42":717,"_32":718,"_30":719,"_155":720,"_40":41,"_39":721,"_157":25,"_37":722,"_13":61,"_34":315,"_36":723,"_24":48,"_161":-5,"_298":724,"_27":725},{"_42":712,"_32":703,"_30":696,"_155":209,"_40":41,"_39":713,"_157":25,"_37":714,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":715,"_27":716},{"_42":704,"_32":705,"_30":706,"_155":696,"_40":41,"_39":707,"_157":25,"_37":708,"_13":61,"_34":315,"_36":709,"_24":48,"_161":-5,"_298":710,"_27":711},{"_42":693,"_32":694,"_30":695,"_155":696,"_40":41,"_39":697,"_157":25,"_37":698,"_13":699,"_34":315,"_36":700,"_24":48,"_161":-5,"_298":701,"_27":702},{"_42":685,"_32":686,"_30":687,"_155":209,"_40":41,"_39":688,"_157":25,"_37":689,"_13":61,"_34":315,"_36":690,"_24":48,"_161":-5,"_298":691,"_27":692},{"_42":676,"_32":401,"_30":56,"_155":209,"_40":41,"_39":677,"_157":48,"_37":678,"_13":679,"_34":680,"_36":681,"_24":48,"_161":682,"_298":683,"_27":684},{"_42":201,"_32":202,"_30":203,"_155":-5,"_40":41,"_39":204,"_157":25,"_37":673,"_13":61,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":674,"_27":675},{"_42":666,"_32":667,"_30":668,"_155":203,"_40":41,"_39":90,"_157":25,"_37":669,"_13":638,"_34":20,"_36":670,"_24":48,"_161":-5,"_298":671,"_27":672},{"_42":658,"_32":659,"_30":660,"_155":203,"_40":41,"_39":661,"_157":25,"_37":662,"_13":638,"_34":20,"_36":663,"_24":48,"_161":-5,"_298":664,"_27":665},{"_42":650,"_32":651,"_30":652,"_155":203,"_40":41,"_39":653,"_157":25,"_37":654,"_13":638,"_34":20,"_36":655,"_24":48,"_161":-5,"_298":656,"_27":657},{"_42":642,"_32":643,"_30":644,"_155":203,"_40":41,"_39":645,"_157":25,"_37":646,"_13":61,"_34":20,"_36":647,"_24":48,"_161":-5,"_298":648,"_27":649},{"_42":634,"_32":635,"_30":636,"_155":203,"_40":41,"_39":610,"_157":25,"_37":637,"_13":638,"_34":20,"_36":639,"_24":48,"_161":-5,"_298":640,"_27":641},{"_42":626,"_32":627,"_30":628,"_155":203,"_40":41,"_39":629,"_157":25,"_37":630,"_13":181,"_34":20,"_36":631,"_24":48,"_161":-5,"_298":632,"_27":633},{"_42":195,"_32":196,"_30":197,"_155":-5,"_40":41,"_39":198,"_157":25,"_37":623,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":624,"_27":625},{"_42":614,"_32":615,"_30":616,"_155":197,"_40":41,"_39":617,"_157":25,"_37":618,"_13":619,"_34":20,"_36":620,"_24":48,"_161":-5,"_298":621,"_27":622},{"_42":605,"_32":606,"_30":607,"_155":197,"_40":41,"_39":608,"_157":25,"_37":609,"_13":610,"_34":315,"_36":611,"_24":48,"_161":-5,"_298":612,"_27":613},{"_42":597,"_32":598,"_30":599,"_155":197,"_40":41,"_39":600,"_157":25,"_37":601,"_13":181,"_34":20,"_36":602,"_24":48,"_161":-5,"_298":603,"_27":604},{"_42":190,"_32":191,"_30":192,"_155":-5,"_40":41,"_39":61,"_157":25,"_37":594,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":595,"_27":596},{"_42":587,"_32":424,"_30":588,"_155":192,"_40":41,"_39":589,"_157":25,"_37":590,"_13":204,"_34":315,"_36":591,"_24":48,"_161":-5,"_298":592,"_27":593},{"_42":184,"_32":185,"_30":186,"_155":-5,"_40":41,"_39":187,"_157":25,"_37":584,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":585,"_27":586},{"_42":579,"_32":214,"_30":565,"_155":186,"_40":41,"_39":580,"_157":25,"_37":581,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":582,"_27":583},{"_42":571,"_32":572,"_30":573,"_155":565,"_40":41,"_39":574,"_157":25,"_37":575,"_13":181,"_34":315,"_36":576,"_24":48,"_161":-5,"_298":577,"_27":578},{"_42":562,"_32":563,"_30":564,"_155":565,"_40":41,"_39":566,"_157":25,"_37":567,"_13":181,"_34":315,"_36":568,"_24":48,"_161":-5,"_298":569,"_27":570},{"_42":557,"_32":399,"_30":393,"_155":186,"_40":41,"_39":558,"_157":25,"_37":559,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":560,"_27":561},{"_42":552,"_32":33,"_30":426,"_155":393,"_40":41,"_39":553,"_157":25,"_37":554,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":555,"_27":556},{"_42":544,"_32":545,"_30":546,"_155":426,"_40":41,"_39":547,"_157":25,"_37":548,"_13":61,"_34":315,"_36":549,"_24":48,"_161":-5,"_298":550,"_27":551},{"_42":536,"_32":537,"_30":538,"_155":426,"_40":41,"_39":539,"_157":48,"_37":540,"_13":61,"_34":315,"_36":541,"_24":48,"_161":-5,"_298":542,"_27":543},{"_42":528,"_32":529,"_30":530,"_155":426,"_40":41,"_39":531,"_157":48,"_37":532,"_13":61,"_34":315,"_36":533,"_24":48,"_161":-5,"_298":534,"_27":535},{"_42":520,"_32":521,"_30":522,"_155":426,"_40":41,"_39":523,"_157":25,"_37":524,"_13":61,"_34":315,"_36":525,"_24":48,"_161":-5,"_298":526,"_27":527},{"_42":512,"_32":513,"_30":514,"_155":426,"_40":41,"_39":515,"_157":48,"_37":516,"_13":61,"_34":315,"_36":517,"_24":48,"_161":-5,"_298":518,"_27":519},{"_42":504,"_32":505,"_30":506,"_155":426,"_40":41,"_39":507,"_157":48,"_37":508,"_13":61,"_34":315,"_36":509,"_24":48,"_161":-5,"_298":510,"_27":511},{"_42":496,"_32":497,"_30":498,"_155":426,"_40":41,"_39":499,"_157":25,"_37":500,"_13":61,"_34":315,"_36":501,"_24":48,"_161":-5,"_298":502,"_27":503},{"_42":488,"_32":489,"_30":490,"_155":426,"_40":41,"_39":491,"_157":48,"_37":492,"_13":61,"_34":315,"_36":493,"_24":48,"_161":-5,"_298":494,"_27":495},{"_42":480,"_32":481,"_30":482,"_155":426,"_40":41,"_39":483,"_157":25,"_37":484,"_13":61,"_34":315,"_36":485,"_24":48,"_161":-5,"_298":486,"_27":487},{"_42":472,"_32":473,"_30":474,"_155":426,"_40":41,"_39":475,"_157":48,"_37":476,"_13":61,"_34":315,"_36":477,"_24":48,"_161":-5,"_298":478,"_27":479},{"_42":464,"_32":465,"_30":466,"_155":426,"_40":41,"_39":467,"_157":25,"_37":468,"_13":181,"_34":315,"_36":469,"_24":48,"_161":-5,"_298":470,"_27":471},{"_42":456,"_32":457,"_30":458,"_155":426,"_40":41,"_39":459,"_157":48,"_37":460,"_13":181,"_34":315,"_36":461,"_24":48,"_161":-5,"_298":462,"_27":463},{"_42":448,"_32":449,"_30":450,"_155":426,"_40":41,"_39":451,"_157":25,"_37":452,"_13":181,"_34":315,"_36":453,"_24":48,"_161":-5,"_298":454,"_27":455},{"_42":440,"_32":441,"_30":442,"_155":426,"_40":41,"_39":443,"_157":48,"_37":444,"_13":181,"_34":315,"_36":445,"_24":48,"_161":-5,"_298":446,"_27":447},{"_42":432,"_32":433,"_30":434,"_155":426,"_40":41,"_39":435,"_157":25,"_37":436,"_13":181,"_34":315,"_36":437,"_24":48,"_161":-5,"_298":438,"_27":439},{"_42":423,"_32":424,"_30":425,"_155":426,"_40":41,"_39":427,"_157":25,"_37":428,"_13":61,"_34":315,"_36":429,"_24":48,"_161":-5,"_298":430,"_27":431},{"_42":418,"_32":417,"_30":411,"_155":393,"_40":41,"_39":419,"_157":25,"_37":420,"_13":181,"_34":35,"_36":-5,"_24":48,"_161":-5,"_298":421,"_27":422},{"_42":408,"_32":409,"_30":410,"_155":411,"_40":41,"_39":412,"_157":25,"_37":413,"_13":181,"_34":20,"_36":414,"_24":48,"_161":-5,"_298":415,"_27":416},{"_42":400,"_32":401,"_30":402,"_155":393,"_40":41,"_39":403,"_157":25,"_37":404,"_13":181,"_34":315,"_36":405,"_24":48,"_161":-5,"_298":406,"_27":407},{"_42":390,"_32":391,"_30":392,"_155":393,"_40":41,"_39":394,"_157":25,"_37":395,"_13":181,"_34":315,"_36":396,"_24":48,"_161":-5,"_298":397,"_27":398},{"_42":382,"_32":383,"_30":384,"_155":186,"_40":41,"_39":385,"_157":25,"_37":386,"_13":181,"_34":20,"_36":387,"_24":48,"_161":-5,"_298":388,"_27":389},{"_42":374,"_32":375,"_30":376,"_155":186,"_40":41,"_39":377,"_157":25,"_37":378,"_13":181,"_34":20,"_36":379,"_24":48,"_161":-5,"_298":380,"_27":381},{"_42":367,"_32":164,"_30":368,"_155":186,"_40":41,"_39":369,"_157":25,"_37":370,"_13":181,"_34":20,"_36":371,"_24":48,"_161":-5,"_298":372,"_27":373},{"_42":359,"_32":360,"_30":361,"_155":186,"_40":41,"_39":362,"_157":25,"_37":363,"_13":181,"_34":20,"_36":364,"_24":48,"_161":-5,"_298":365,"_27":366},{"_42":351,"_32":352,"_30":353,"_155":186,"_40":41,"_39":354,"_157":25,"_37":355,"_13":181,"_34":315,"_36":356,"_24":48,"_161":-5,"_298":357,"_27":358},{"_42":343,"_32":344,"_30":345,"_155":186,"_40":41,"_39":346,"_157":25,"_37":347,"_13":181,"_34":315,"_36":348,"_24":48,"_161":-5,"_298":349,"_27":350},{"_42":335,"_32":336,"_30":337,"_155":186,"_40":41,"_39":338,"_157":25,"_37":339,"_13":181,"_34":20,"_36":340,"_24":48,"_161":-5,"_298":341,"_27":342},{"_42":327,"_32":328,"_30":329,"_155":186,"_40":41,"_39":330,"_157":25,"_37":331,"_13":181,"_34":20,"_36":332,"_24":48,"_161":-5,"_298":333,"_27":334},{"_42":319,"_32":320,"_30":321,"_155":186,"_40":41,"_39":322,"_157":25,"_37":323,"_13":181,"_34":315,"_36":324,"_24":48,"_161":-5,"_298":325,"_27":326},{"_42":310,"_32":311,"_30":312,"_155":186,"_40":41,"_39":313,"_157":25,"_37":314,"_13":181,"_34":315,"_36":316,"_24":48,"_161":-5,"_298":317,"_27":318},{"_42":177,"_32":178,"_30":179,"_155":-5,"_40":41,"_39":61,"_157":25,"_37":307,"_13":181,"_34":20,"_36":182,"_24":48,"_161":-5,"_298":308,"_27":309},{"_42":170,"_32":171,"_30":172,"_155":-5,"_40":41,"_39":173,"_157":25,"_37":304,"_13":61,"_34":20,"_36":175,"_24":48,"_161":-5,"_298":305,"_27":306},{"_42":163,"_32":164,"_30":165,"_155":-5,"_40":41,"_39":166,"_157":25,"_37":301,"_13":159,"_34":20,"_36":168,"_24":48,"_161":-5,"_298":302,"_27":303},{"_42":152,"_32":153,"_30":154,"_155":-5,"_40":41,"_39":156,"_157":25,"_37":297,"_13":159,"_34":20,"_36":160,"_24":48,"_161":-5,"_298":299,"_27":300},["D",1749441030650],"children",[],[153],["D",1748493484473],[],[164],["D",1748667949184],[],[171],["D",1748492167939],[],[178],"874c38ea-4d8d-11f0-825e-76b3cceeab13","vitest.config.ts","874c39b2-4d8d-11f0-825e-76b3cceeab13",191,["D",1750393070407],"script","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",[],[185,311],"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",[],[185,320],"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",[],[185,328],"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",[],[185,336],"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",[],[185,344],"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",[],[185,352],"873c5af6-4d8d-11f0-a392-76b3cceeab13","package.json","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",[],[185,360],"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.",[],[185,164],"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",[],[185,375],"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",[],[185,383],"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",[],[185,399,391],"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",[],[185,399,401],"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",[],[185,399,417,409],"styles","86c699c4-4d8d-11f0-b958-76b3cceeab13",169,["D",1750393069531],[280],[185,399,417],"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",[],[185,399,33,424],"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 · v206