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