Polyatomics

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_363":364,"_365":366},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_274":-5,"_20":275,"_22":276,"_277":278,"_279":280,"_26":281,"_24":282,"_283":-5,"_284":-5,"_285":69,"_286":287,"_288":63,"_289":-5,"_290":-5,"_291":292},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","altors_graphika","name","polyatomics","branchName","main","version","path","frontend/lib/quiz.ts","project",{"_33":216,"_13":14,"_47":217,"_218":-5,"_219":69,"_220":221,"_222":221,"_223":224,"_225":-5,"_226":227,"_228":60,"_229":63,"_230":-5,"_231":-5,"_232":85,"_233":234,"_235":236,"_237":238,"_239":240,"_241":-5,"_242":243,"_244":243,"_245":246,"_247":246,"_248":246,"_249":243,"_250":243,"_251":252,"_253":254,"_255":256,"_257":69},"tree",[55,56,57],"file",{"_33":34,"_35":36,"_37":38,"_13":39,"_40":41,"_42":43,"_17":44,"_45":46,"_47":48,"_49":50,"_51":-5,"_18":52},"contents",[],"upstream","pull","ahead","behind","envVars","id","d64496c0-cf8d-410d-a2d2-66cd0995586b","branchId","91efcfc2-57fc-4e40-a802-a0a982202b7c","fileId","f8d8fb4e-a3cf-11f1-87dc-1607ee4eb77e","quiz.ts","content","import { CATEGORIES, IONS, type Config, type Ion } from \"./polyatomics.ts\";\n\nconst SUB = [\"₀\",\"₁\",\"₂\",\"₃\",\"₄\",\"₅\",\"₆\",\"₇\",\"₈\",\"₉\"];\n\nexport const FORMULA_PATTERN = \"[A-Z][a-z]?[0-9₀₁₂₃₄₅₆₇₈₉]*(?:[A-Z][a-z]?[0-9₀₁₂₃₄₅₆₇₈₉]*)*\";\nexport const CHARGE_PATTERN = \"(?:[+−-]?\\\\d+|\\\\d+[+−-]|[+−-])\";\n\nexport function normalizeFormula(value: string) {\n return value.trim().replace(/\\s/g, \"\").replace(/[₀₁₂₃₄₅₆₇₈₉]/g, (c) => String(SUB.indexOf(c)));\n}\n\nexport function normalizeCharge(value: string) {\n const compact = value.trim().replace(/\\s/g, \"\").replace(/-/g, \"−\");\n if (!compact) return \"\";\n if (/^[+−]$/.test(compact)) return `${compact}1`;\n if (/^[+−]\\d+$/.test(compact)) return compact;\n if (/^\\d+[+−]$/.test(compact)) return `${compact.slice(-1)}${compact.slice(0, -1)}`;\n return compact;\n}\n\nexport function formatFormula(value: string) {\n return value.replace(/(\\d+)/g, (n) => n.split(\"\").map((d) => SUB[Number(d)]).join(\"\"));\n}\n\nexport function formatCharge(value: string) {\n const clean = value.replace(\"−\", \"-\");\n return clean.replace(/([+-]?)(\\d+)/g, (_, sign, n) => `${n === \"1\" ? \"\" : n.split(\"\").map((d: string) => \"⁰¹²³⁴⁵⁶⁷⁸⁹\"[Number(d)]).join(\"\")}${sign === \"-\" ? \"⁻\" : sign === \"+\" ? \"⁺\" : \"\"}`);\n}\n\nexport function formatChargeInput(value: string) {\n return value.replace(/^−/, \"–\").replace(/^-/, \"–\");\n}\n\nexport function shuffle(items: T[]) { return [...items].sort(() => Math.random() - 0.5); }\n\nexport function pickNext(pool: Ion[], current: Ion) {\n const choices = pool.filter((ion) => ion !== current);\n return choices[Math.floor(Math.random() * choices.length)] ?? current;\n}\n\nexport function selectedPool(config: Config) {\n const byCategory = IONS.filter((item) => config.categories.includes(item.category));\n const byIndividual = IONS.filter((item) => config.ions.includes(item.name));\n return [...new Map([...byCategory, ...byIndividual].map((item) => [item.name, item])).values()];\n}\n\nexport function selectedIonNames(config: Config) {\n return new Set(IONS.filter((ion) => config.categories.includes(ion.category)).map((ion) => ion.name).concat(config.ions));\n}\n\nexport function toggleCategory(config: Config, category: string): Config {\n return { ...config, categories: config.categories.includes(category) ? config.categories.filter((c) => c !== category) : [...config.categories, category] };\n}\n\nexport function toggleIon(config: Config, name: string): Config {\n const ion = IONS.find((item) => item.name === name);\n if (!ion) return config;\n const categoryIons = IONS.filter((item) => item.category === ion.category).map((item) => item.name);\n const selectedExplicit = new Set(config.ions);\n if (config.categories.includes(ion.category)) {\n categoryIons.forEach((ionName) => selectedExplicit.add(ionName));\n selectedExplicit.delete(name);\n return { ...config, categories: config.categories.filter((category) => category !== ion.category), ions: [...selectedExplicit] };\n }\n if (selectedExplicit.has(name)) selectedExplicit.delete(name);\n else selectedExplicit.add(name);\n const nextCategories = [...config.categories];\n CATEGORIES.forEach((category) => {\n const names = IONS.filter((item) => item.category === category).map((item) => item.name);\n if (names.every((ionName) => selectedExplicit.has(ionName))) {\n if (!nextCategories.includes(category)) nextCategories.push(category);\n names.forEach((ionName) => selectedExplicit.delete(ionName));\n }\n });\n return { ...config, categories: nextCategories, ions: [...selectedExplicit] };\n}\n","fileType","script",2,"parentId","01a04e96-de68-75d9-b234-65a22cb743f0","createdAt",["D",1788040093208],"branchVersion",203,"label",[53,54,39],"frontend","lib",{"_33":82,"_13":53,"_37":83,"_45":-5,"_35":36,"_49":78,"_62":63,"_47":84,"_17":85,"_42":86,"_40":-5,"_68":69,"_51":-5,"_70":87,"_18":88},{"_33":73,"_13":74,"_37":75,"_45":-5,"_35":36,"_49":76,"_62":63,"_47":77,"_17":78,"_42":24,"_40":79,"_68":69,"_51":-5,"_70":80,"_18":81},{"_33":58,"_13":59,"_37":60,"_45":-5,"_35":36,"_49":61,"_62":63,"_47":64,"_17":65,"_42":66,"_40":67,"_68":69,"_51":14,"_70":71,"_18":72},"e9eb1765-be20-45bc-b40c-2fe4c6e163d4","index.ts","01a04b7f-e043-776f-9b1e-67170ce79a7b",169,"latest",true,["D",1788037454141],9,"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\n\nconst app = new Hono();\n\napp.get(\"/\", (c) => c.html(Root()));\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;\n","deleted",false,"children",[],[59],"8fd05197-c6e3-4b8e-b16a-e383aca59d99","README.md","01a04b7f-e043-776f-9b1e-61c237442125",146,["D",1788025063496],1,"# Polyatomics\n\nA focused practice app for memorizing common polyatomic ion formulas and charges.\n\n## Features\n\n- Practice 32 common polyatomic ions.\n- Choose a time limit or practice without a timer.\n- Practice by category or select individual ions.\n- Loop mode continuously cycles through the selected pool.\n- Immediate feedback shows the correct formula and charge.\n- Session results include accuracy, correct answers, average answer time, and missed ions.\n- Installable as a PWA with update notifications.\n\n## Architecture\n\n```mermaid\ngraph LR\n Browser -->|GET /| Hono[\"index.ts\"]\n Hono -->|HTML shell| Root[\"frontend/root.tsx\"]\n Root --> Entry[\"frontend/index.tsx\"]\n Entry --> App[\"frontend/components/App.tsx\"]\n App --> Start[\"StartScreen.tsx\"]\n App --> Quiz[\"QuizScreen.tsx\"]\n App --> End[\"EndScreen.tsx\"]\n App --> Install[\"InstallNudge.tsx\"]\n App --> Session[\"hooks/useQuizSession.ts\"]\n Session --> Rules[\"lib/quiz.ts\"]\n Rules --> Data[\"lib/polyatomics.ts\"]\n```\n\n## File structure\n\n```text\nindex.ts\nfrontend/\n root.tsx # HTML shell and immutable asset URLs\n index.tsx # React entrypoint and service-worker registration\n manifest.webmanifest # PWA metadata\n favicon.svg # App icon\n favicon-green.svg # App icon used by the shell\n icon-192.svg\n icon-512.svg\n components/\n App.tsx # Composition/root component\n StartScreen.tsx # Session configuration\n QuizScreen.tsx # Question and answer UI\n EndScreen.tsx # Session results\n InstallNudge.tsx # Install/update UI\n hooks/\n useQuizSession.ts # Quiz state and transitions\n lib/\n polyatomics.ts # Ion data, types, and defaults\n quiz.ts # Pure quiz rules and formatting helpers\n```\n\n## Design principles\n\nThe UI components are intentionally thin. Quiz behavior lives in `useQuizSession`, while pure domain rules live in `lib/quiz.ts`. The ion dataset and shared types live in `lib/polyatomics.ts`, so other practice modes can reuse them without depending on the UI.\n\nThe app does not require application cookies or a login to practice. Browser persistence for the install prompt is treated as optional: if web storage is unavailable or blocked, the prompt simply falls back to its default behavior and the quiz remains usable.\n\n## Development\n\nThe HTTP entrypoint is `index.ts`. React components live under `frontend/components/`, with reusable state and domain logic under `frontend/hooks/` and `frontend/lib/`.\n\nThe app uses React 18, Hono, Twind, and immutable Val Town asset URLs.\n",[],[74],"aa37af58-90fd-4bfa-85a4-500c985f1deb","01a04b7f-e043-776f-9b1e-58a885ba27e3",["D",1787973066715],0,"directory",[89,90,91,92,93,94,95],[53],{"_33":162,"_13":163,"_37":164,"_45":83,"_35":36,"_49":78,"_62":63,"_47":165,"_17":85,"_42":86,"_40":-5,"_68":69,"_51":-5,"_70":166,"_18":167},{"_33":146,"_13":147,"_37":148,"_45":83,"_35":36,"_49":129,"_62":63,"_47":149,"_17":85,"_42":86,"_40":-5,"_68":69,"_51":-5,"_70":150,"_18":151},{"_33":128,"_13":54,"_37":46,"_45":83,"_35":36,"_49":129,"_62":63,"_47":130,"_17":85,"_42":86,"_40":-5,"_68":69,"_51":-5,"_70":131,"_18":132},{"_33":120,"_13":121,"_37":122,"_45":83,"_35":36,"_49":123,"_62":63,"_47":124,"_17":78,"_42":24,"_40":125,"_68":69,"_51":-5,"_70":126,"_18":127},{"_33":113,"_13":114,"_37":115,"_45":83,"_35":36,"_49":78,"_62":63,"_47":116,"_17":85,"_42":24,"_40":117,"_68":69,"_51":-5,"_70":118,"_18":119},{"_33":105,"_13":106,"_37":107,"_45":83,"_35":36,"_49":108,"_62":63,"_47":109,"_17":44,"_42":43,"_40":110,"_68":69,"_51":-5,"_70":111,"_18":112},{"_33":96,"_13":97,"_37":98,"_45":83,"_35":36,"_49":99,"_62":63,"_47":100,"_17":101,"_42":43,"_40":102,"_68":69,"_51":-5,"_70":103,"_18":104},"8a7077c9-c302-4867-9620-078644758112","root.tsx","01a04b7f-e043-776f-9b1e-554f5bc7b179",213,["D",1788040505046],22,"/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\nexport function Root() {\n return (\n <>\n {raw(\"\")}\n \n \n \n \n \n \n \n \n Polyatomics\n