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\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport {\n parseProject,\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\"\nurls:\n\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\nHowever, it's _extremely importing_ to note that `parseProject` and other\nStandard Library utilities ONLY RUN ON THE SERVER. If you need access to this\ndata on the client, run it in the server and pass it to the client by splicing\nit into the HTML page or by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use\n `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})`\n instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode\n symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use:\n `

`\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)\n unless otherwise specified\n- **View Source:** Add a view source link by importing & using\n `import.meta.url.replace(\"esm.sh\", \"val.town)\"` (or passing this data to the\n client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add\n `` to HTML to capture\n client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local\n resolution; Avoid catches that merely log or return 500s. Let errors bubble up\n with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but\n generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure\n compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer\n simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with\n `?deps=react@18.2.0,react-dom@18.2.0` and start the file with\n `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same\n version\n- **Styling:** Default to using TailwindCSS via\n `` unless otherwise\n specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\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 # Frontend 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\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project\n files:\n ```ts\n import {\n readFile,\n serveFile,\n } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", (c) => serveFile(c.req.path, 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- Always include this snippet at the top-level Hono app to re-throwing errors to\n 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### Database Patterns\n\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\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\n 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\n `export default app.fetch // This is the entry point for HTTP vals`\n","label",[18],"pulls","branches",3,"forks","envVars",{"_169":26,"_171":26},"connections",{"_169":26,"_170":26},"count","unfilledCount","emptyCount",{"_33":609,"_13":568,"_62":562,"_43":-5,"_35":36,"_153":408,"_154":91,"_37":610,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":611,"_17":612},{"_33":601,"_13":602,"_62":603,"_43":562,"_35":36,"_153":604,"_154":91,"_37":605,"_39":408,"_64":275,"_157":606,"_65":24,"_159":-5,"_230":607,"_17":608},{"_33":593,"_13":594,"_62":595,"_43":562,"_35":36,"_153":596,"_154":91,"_37":597,"_39":300,"_64":275,"_157":598,"_65":24,"_159":-5,"_230":599,"_17":600},{"_33":585,"_13":586,"_62":587,"_43":562,"_35":36,"_153":588,"_154":91,"_37":589,"_39":26,"_64":275,"_157":590,"_65":24,"_159":-5,"_230":591,"_17":592},{"_33":577,"_13":578,"_62":579,"_43":562,"_35":36,"_153":580,"_154":91,"_37":581,"_39":26,"_64":275,"_157":582,"_65":24,"_159":-5,"_230":583,"_17":584},{"_33":569,"_13":570,"_62":571,"_43":562,"_35":36,"_153":572,"_154":91,"_37":573,"_39":156,"_64":275,"_157":574,"_65":24,"_159":-5,"_230":575,"_17":576},{"_33":559,"_13":560,"_62":561,"_43":562,"_35":36,"_153":563,"_154":91,"_37":564,"_39":285,"_64":275,"_157":565,"_65":24,"_159":-5,"_230":566,"_17":567},{"_33":555,"_13":304,"_62":297,"_43":-5,"_35":36,"_153":300,"_154":91,"_37":556,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":557,"_17":558},{"_33":551,"_13":426,"_62":420,"_43":297,"_35":36,"_153":300,"_154":91,"_37":552,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":553,"_17":554},{"_33":546,"_13":537,"_62":531,"_43":420,"_35":36,"_153":547,"_154":91,"_37":548,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":549,"_17":550},{"_33":538,"_13":539,"_62":540,"_43":531,"_35":36,"_153":541,"_154":91,"_37":542,"_39":360,"_64":275,"_157":543,"_65":24,"_159":-5,"_230":544,"_17":545},{"_33":528,"_13":529,"_62":530,"_43":531,"_35":36,"_153":532,"_154":91,"_37":533,"_39":408,"_64":275,"_157":534,"_65":24,"_159":-5,"_230":535,"_17":536},{"_33":523,"_13":498,"_62":492,"_43":420,"_35":36,"_153":524,"_154":91,"_37":525,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":526,"_17":527},{"_33":515,"_13":516,"_62":517,"_43":492,"_35":36,"_153":518,"_154":91,"_37":519,"_39":300,"_64":275,"_157":520,"_65":24,"_159":-5,"_230":521,"_17":522},{"_33":507,"_13":508,"_62":509,"_43":492,"_35":36,"_153":510,"_154":91,"_37":511,"_39":360,"_64":275,"_157":512,"_65":24,"_159":-5,"_230":513,"_17":514},{"_33":499,"_13":500,"_62":501,"_43":492,"_35":36,"_153":502,"_154":91,"_37":503,"_39":408,"_64":275,"_157":504,"_65":24,"_159":-5,"_230":505,"_17":506},{"_33":489,"_13":490,"_62":491,"_43":492,"_35":36,"_153":493,"_154":91,"_37":494,"_39":300,"_64":275,"_157":495,"_65":24,"_159":-5,"_230":496,"_17":497},{"_33":484,"_13":467,"_62":461,"_43":420,"_35":36,"_153":485,"_154":91,"_37":486,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":487,"_17":488},{"_33":476,"_13":477,"_62":478,"_43":461,"_35":36,"_153":479,"_154":91,"_37":480,"_39":26,"_64":275,"_157":481,"_65":24,"_159":-5,"_230":482,"_17":483},{"_33":468,"_13":469,"_62":470,"_43":461,"_35":36,"_153":471,"_154":91,"_37":472,"_39":163,"_64":275,"_157":473,"_65":24,"_159":-5,"_230":474,"_17":475},{"_33":458,"_13":459,"_62":460,"_43":461,"_35":36,"_153":462,"_154":91,"_37":463,"_39":26,"_64":275,"_157":464,"_65":24,"_159":-5,"_230":465,"_17":466},{"_33":453,"_13":444,"_62":438,"_43":420,"_35":36,"_153":454,"_154":91,"_37":455,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":456,"_17":457},{"_33":445,"_13":446,"_62":447,"_43":438,"_35":36,"_153":448,"_154":91,"_37":449,"_39":408,"_64":275,"_157":450,"_65":24,"_159":-5,"_230":451,"_17":452},{"_33":435,"_13":436,"_62":437,"_43":438,"_35":36,"_153":439,"_154":91,"_37":440,"_39":300,"_64":275,"_157":441,"_65":24,"_159":-5,"_230":442,"_17":443},{"_33":427,"_13":428,"_62":429,"_43":420,"_35":36,"_153":430,"_154":91,"_37":431,"_39":300,"_64":275,"_157":432,"_65":24,"_159":-5,"_230":433,"_17":434},{"_33":417,"_13":418,"_62":419,"_43":420,"_35":36,"_153":421,"_154":91,"_37":422,"_39":408,"_64":275,"_157":423,"_65":24,"_159":-5,"_230":424,"_17":425},{"_33":412,"_13":378,"_62":372,"_43":297,"_35":36,"_153":413,"_154":91,"_37":414,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":415,"_17":416},{"_33":403,"_13":404,"_62":405,"_43":372,"_35":36,"_153":406,"_154":91,"_37":407,"_39":408,"_64":275,"_157":409,"_65":24,"_159":-5,"_230":410,"_17":411},{"_33":395,"_13":396,"_62":397,"_43":372,"_35":36,"_153":398,"_154":91,"_37":399,"_39":26,"_64":275,"_157":400,"_65":24,"_159":-5,"_230":401,"_17":402},{"_33":387,"_13":388,"_62":389,"_43":372,"_35":36,"_153":390,"_154":91,"_37":391,"_39":300,"_64":275,"_157":392,"_65":24,"_159":-5,"_230":393,"_17":394},{"_33":379,"_13":380,"_62":381,"_43":372,"_35":36,"_153":382,"_154":91,"_37":383,"_39":156,"_64":275,"_157":384,"_65":24,"_159":-5,"_230":385,"_17":386},{"_33":369,"_13":370,"_62":371,"_43":372,"_35":36,"_153":373,"_154":91,"_37":374,"_39":26,"_64":275,"_157":375,"_65":24,"_159":-5,"_230":376,"_17":377},{"_33":364,"_13":330,"_62":324,"_43":297,"_35":36,"_153":365,"_154":91,"_37":366,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":367,"_17":368},{"_33":355,"_13":356,"_62":357,"_43":324,"_35":36,"_153":358,"_154":91,"_37":359,"_39":360,"_64":275,"_157":361,"_65":24,"_159":-5,"_230":362,"_17":363},{"_33":347,"_13":348,"_62":349,"_43":324,"_35":36,"_153":350,"_154":91,"_37":351,"_39":156,"_64":275,"_157":352,"_65":24,"_159":-5,"_230":353,"_17":354},{"_33":339,"_13":340,"_62":341,"_43":324,"_35":36,"_153":342,"_154":91,"_37":343,"_39":156,"_64":275,"_157":344,"_65":24,"_159":-5,"_230":345,"_17":346},{"_33":331,"_13":332,"_62":333,"_43":324,"_35":36,"_153":334,"_154":91,"_37":335,"_39":163,"_64":275,"_157":336,"_65":24,"_159":-5,"_230":337,"_17":338},{"_33":321,"_13":322,"_62":323,"_43":324,"_35":36,"_153":325,"_154":91,"_37":326,"_39":156,"_64":275,"_157":327,"_65":24,"_159":-5,"_230":328,"_17":329},{"_33":313,"_13":314,"_62":315,"_43":297,"_35":36,"_153":316,"_154":91,"_37":317,"_39":156,"_64":21,"_157":318,"_65":24,"_159":-5,"_230":319,"_17":320},{"_33":305,"_13":306,"_62":307,"_43":297,"_35":36,"_153":308,"_154":91,"_37":309,"_39":156,"_64":275,"_157":310,"_65":24,"_159":-5,"_230":311,"_17":312},{"_33":294,"_13":295,"_62":296,"_43":297,"_35":36,"_153":298,"_154":91,"_37":299,"_39":300,"_64":275,"_157":301,"_65":24,"_159":-5,"_230":302,"_17":303},{"_33":289,"_13":279,"_62":271,"_43":-5,"_35":36,"_153":163,"_154":91,"_37":290,"_39":26,"_64":291,"_157":-5,"_65":24,"_159":-5,"_230":292,"_17":293},{"_33":280,"_13":281,"_62":282,"_43":271,"_35":36,"_153":283,"_154":91,"_37":284,"_39":285,"_64":275,"_157":286,"_65":24,"_159":-5,"_230":287,"_17":288},{"_33":268,"_13":269,"_62":270,"_43":271,"_35":36,"_153":272,"_154":91,"_37":273,"_39":274,"_64":275,"_157":276,"_65":24,"_159":-5,"_230":277,"_17":278},{"_33":260,"_13":261,"_62":262,"_43":-5,"_35":36,"_153":263,"_154":91,"_37":264,"_39":26,"_64":21,"_157":265,"_65":24,"_159":-5,"_230":266,"_17":267},{"_33":152,"_13":18,"_62":63,"_43":-5,"_35":36,"_153":71,"_154":91,"_37":257,"_39":156,"_64":21,"_157":158,"_65":24,"_159":-5,"_230":258,"_17":259},{"_33":250,"_13":251,"_62":252,"_43":-5,"_35":36,"_153":117,"_154":91,"_37":253,"_39":26,"_64":21,"_157":254,"_65":24,"_159":-5,"_230":255,"_17":256},{"_33":241,"_13":242,"_62":243,"_43":-5,"_35":36,"_153":244,"_154":91,"_37":245,"_39":246,"_64":21,"_157":247,"_65":24,"_159":-5,"_230":248,"_17":249},{"_33":233,"_13":234,"_62":235,"_43":-5,"_35":36,"_153":236,"_154":91,"_37":237,"_39":156,"_64":21,"_157":238,"_65":24,"_159":-5,"_230":239,"_17":240},{"_33":222,"_13":223,"_62":89,"_43":-5,"_35":36,"_153":224,"_154":91,"_37":225,"_39":226,"_64":227,"_157":228,"_65":24,"_159":229,"_230":231,"_17":232},"a3d5a2cb-a23f-4c73-82b1-b828767f9fe8","index.ts",140,["D",1788849921968],9,"http","import {\n parseVal,\n serveImmutableFile,\n} from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { bodyLimit } from \"npm:hono/body-limit\";\nimport { HTTPException } from \"npm:hono/http-exception\";\nimport { getCookie, setCookie } from \"npm:hono/cookie\";\nimport QRCode from \"npm:qrcode\";\nimport { buildResults } from \"./backend/aggregate.ts\";\nimport { randomId } from \"./backend/db.ts\";\nimport {\n clearResponses,\n createSurvey,\n deleteSurvey,\n filterAnswers,\n getAllResponses,\n getResponse,\n getSurveyByAdminKey,\n getSurveyBySlug,\n mergeReleasedAnswers,\n publicSurvey,\n sanitizeAnswers,\n setQuestionReleased,\n updateSurvey,\n upsertResponse,\n} from \"./backend/surveys.ts\";\nimport { Root } from \"./frontend/root.tsx\";\nimport {\n approveProposal,\n createProposal,\n listProposals,\n setProposalVote,\n} from \"./backend/proposals.ts\";\nimport { RequestError } from \"./backend/errors.ts\";\nimport {\n normalizeMatrixAnswer,\n QuestionValidationError,\n} from \"./shared/questions.ts\";\nimport type { Survey } from \"./shared/types.ts\";\n\nconst app = new Hono();\n\n// ---- Frontend shell (client-side routing handles the rest) ----\nconst SHELL_PATHS = [\n \"/\",\n \"/new\",\n \"/s/:slug\",\n \"/s/:slug/results\",\n \"/s/:slug/present\",\n \"/admin/:key\",\n];\nfor (const p of SHELL_PATHS) app.get(p, (c) => c.html(Root()));\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// ---- Respondent identity cookie ----\nconst SID_COOKIE = \"survey_sid\";\nfunction getOrSetSid(c: any): string {\n let sid = getCookie(c, SID_COOKIE);\n if (!sid || !/^[a-z0-9]{24}$/.test(sid)) {\n sid = randomId(24);\n setCookie(c, SID_COOKIE, sid, {\n path: \"/\",\n httpOnly: true,\n sameSite: \"Lax\",\n secure: true,\n maxAge: 60 * 60 * 24 * 365,\n });\n }\n return sid;\n}\n\n// ---- Public API ----\nconst proposalBodyLimit = bodyLimit({\n maxSize: 16 * 1024,\n onError: (c) =>\n c.json({ error: \"Question requests must be smaller than 16 KB.\" }, 413),\n});\n\nasync function questionBody(req: Request): Promise> {\n let body: unknown;\n try {\n body = await req.json();\n } catch (error) {\n if (error instanceof SyntaxError) {\n throw new RequestError(\"Provide valid JSON.\", 400);\n }\n throw error;\n }\n if (!body || typeof body !== \"object\" || Array.isArray(body)) {\n throw new RequestError(\"Provide a JSON object.\", 400);\n }\n return body as Record;\n}\n\napp.post(\"/api/surveys\", async (c) => {\n const body = await c.req.json().catch(() => ({}));\n const title = String(body.title ?? \"\").slice(0, 120);\n const { survey, adminKey } = await createSurvey(title);\n return c.json({ slug: survey.slug, adminKey });\n});\n\n// Survey for respondents (strips nothing sensitive: admin key never leaves the DB)\napp.get(\"/api/s/:slug\", async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n const sid = getOrSetSid(c);\n const existing = await getResponse(survey.id, sid);\n const visibleSurvey = publicSurvey(survey);\n return c.json({\n survey: visibleSurvey,\n existing: filterAnswers(existing, visibleSurvey.questions),\n });\n});\n\napp.post(\"/api/s/:slug/respond\", async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n if (!survey.acceptingResponses) {\n return c.json({ error: \"This survey is closed.\" }, 403);\n }\n const sid = getOrSetSid(c);\n const body = await c.req.json().catch(() => ({}));\n const visibleSurvey = publicSurvey(survey);\n const answers = sanitizeAnswers(visibleSurvey, body.answers);\n const existing = await getResponse(survey.id, sid);\n await upsertResponse(\n survey.id,\n sid,\n mergeReleasedAnswers(existing, visibleSurvey.questions, answers),\n );\n return c.json({ ok: true, answers });\n});\n\napp.get(\"/api/s/:slug/proposals\", async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n const proposals = await listProposals(survey.id, getOrSetSid(c));\n return c.json({ proposals, acceptingResponses: survey.acceptingResponses });\n});\n\napp.post(\"/api/s/:slug/proposals\", proposalBodyLimit, async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n if (!survey.acceptingResponses) {\n return c.json({ error: \"This survey is closed.\" }, 403);\n }\n const body = await questionBody(c.req.raw);\n await createProposal(survey.id, getOrSetSid(c), body.question);\n return c.json({ ok: true }, 201);\n});\n\napp.put(\n \"/api/s/:slug/proposals/:proposalId/vote\",\n proposalBodyLimit,\n async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n if (!survey.acceptingResponses) {\n return c.json({\n error: \"This survey is closed.\",\n }, 403);\n }\n const body = await questionBody(c.req.raw);\n if (typeof body.voted !== \"boolean\") {\n return c.json({\n error: \"voted must be a boolean.\",\n }, 400);\n }\n await setProposalVote(\n survey.id,\n c.req.param(\"proposalId\"),\n getOrSetSid(c),\n body.voted,\n );\n return c.json({ ok: true });\n },\n);\n\napp.get(\"/api/s/:slug/results\", async (c) => {\n const survey = await getSurveyBySlug(c.req.param(\"slug\"));\n if (!survey) return c.json({ error: \"Not found\" }, 404);\n if (!survey.resultsVisible) {\n return c.json({ error: \"Results are not visible yet.\" }, 403);\n }\n const visibleSurvey = publicSurvey(survey);\n const requestedGroup = visibleSurvey.audienceFacets\n ? c.req.query(\"groupBy\") || null\n : null;\n const groupBy = requestedGroup &&\n visibleSurvey.questions.some((question) =>\n question.id === requestedGroup && question.isDemographic\n )\n ? requestedGroup\n : null;\n const responses = await getAllResponses(survey.id);\n const visible = visibleSurvey.questions.filter((q) => !q.hidden);\n return c.json({\n survey: visibleSurvey,\n totalResponses: responses.length,\n groupBy,\n groups: buildResults(visibleSurvey, responses, groupBy, visible),\n });\n});\n\n// QR code (SVG) pointing to the respondent URL\napp.get(\"/api/s/:slug/qr.svg\", async (c) => {\n const url = new URL(c.req.url);\n const target = `${url.origin}/s/${c.req.param(\"slug\")}`;\n const svg = await QRCode.toString(target, {\n type: \"svg\",\n margin: 1,\n width: 512,\n errorCorrectionLevel: \"M\",\n });\n return c.body(svg, 200, {\n \"Content-Type\": \"image/svg+xml\",\n \"Cache-Control\": \"public, max-age=3600\",\n });\n});\n\n// ---- Admin API (gated by secret key) ----\nconst admin = new Hono();\nadmin.use(\"*\", async (c, next) => {\n const survey = await getSurveyByAdminKey(c.req.param(\"key\") as string);\n if (!survey) return c.json({ error: \"Invalid admin link\" }, 404);\n c.set(\"survey\" as never, survey as never);\n await next();\n});\n\nadmin.get(\"/\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n const responses = await getAllResponses(survey.id);\n return c.json({ survey, totalResponses: responses.length });\n});\n\nadmin.patch(\"/\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n const body = await c.req.json().catch(() => ({}));\n const fresh = await updateSurvey(survey.id, body);\n return c.json({ survey: fresh ?? survey });\n});\n\nadmin.patch(\"/questions/:questionId/release\", async (c) => {\n const survey = c.get(\"survey\" as never) as Survey;\n const body = await questionBody(c.req.raw);\n if (typeof body.released !== \"boolean\") {\n throw new RequestError(\"released must be a boolean.\", 400);\n }\n const fresh = await setQuestionReleased(\n survey.id,\n c.req.param(\"questionId\"),\n body.released,\n );\n return c.json({ survey: fresh });\n});\n\nadmin.get(\"/proposals\", async (c) => {\n const survey = c.get(\"survey\" as never) as Survey;\n return c.json({\n proposals: await listProposals(survey.id),\n acceptingResponses: survey.acceptingResponses,\n });\n});\n\nadmin.post(\"/proposals/:proposalId/approve\", proposalBodyLimit, async (c) => {\n const survey = c.get(\"survey\" as never) as Survey;\n const body = await questionBody(c.req.raw);\n const approvedQuestion = await approveProposal(\n survey.id,\n c.req.param(\"proposalId\"),\n body.question,\n );\n const fresh = await getSurveyBySlug(survey.slug);\n const publishedQuestion = fresh?.questions.find((question) =>\n question.id === approvedQuestion.id\n );\n if (!fresh || !publishedQuestion) {\n throw new Error(\"Approved question was not added to the survey.\");\n }\n return c.json({ survey: fresh, approvedQuestion: publishedQuestion });\n});\n\nadmin.get(\"/results\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n const groupBy = c.req.query(\"groupBy\") || null;\n const responses = await getAllResponses(survey.id);\n const all = c.req.query(\"includeHidden\") === \"1\";\n const visible = all\n ? survey.questions\n : survey.questions.filter((q: any) => !q.hidden);\n return c.json({\n survey,\n totalResponses: responses.length,\n groupBy,\n groups: buildResults(survey, responses, groupBy, visible),\n });\n});\n\nadmin.get(\"/export.csv\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n const responses = await getAllResponses(survey.id);\n const esc = (s: unknown) => `\"${String(s ?? \"\").replace(/\"/g, '\"\"')}\"`;\n const header = survey.questions.map((q: any) => esc(q.prompt)).join(\",\");\n const optLabel = (q: any, id: string) =>\n q.options.find((o: any) => o.id === id)?.label ?? id;\n const rows = responses.map((r) =>\n survey.questions.map((q: any) => {\n const v = r[q.id];\n if (Array.isArray(v)) {\n return esc(v.map((x) => optLabel(q, x)).join(\" > \"));\n }\n if (\n q.type === \"matrix_2x2\"\n ) {\n const position = normalizeMatrixAnswer(v, q.matrixSize ?? 2);\n if (position) {\n return esc(\n `x ${position.x.toFixed(3)}, y ${\n position.y.toFixed(3)\n } from top-left`,\n );\n }\n }\n if (typeof v === \"string\" && q.options.length) return esc(optLabel(q, v));\n return esc(v);\n }).join(\",\")\n );\n return c.body([header, ...rows].join(\"\\n\"), 200, {\n \"Content-Type\": \"text/csv\",\n \"Content-Disposition\":\n `attachment; filename=\"${survey.slug}-responses.csv\"`,\n });\n});\n\nadmin.delete(\"/responses\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n await clearResponses(survey.id);\n return c.json({ ok: true });\n});\n\nadmin.delete(\"/\", async (c) => {\n const survey = c.get(\"survey\" as never) as any;\n await deleteSurvey(survey.id);\n return c.json({ ok: true });\n});\n\napp.route(\"/api/admin/:key\", admin);\n\napp.onError((err, c) => {\n if (err instanceof RequestError) {\n return c.json({ error: err.message }, err.status);\n }\n if (err instanceof QuestionValidationError) {\n return c.json({ error: err.message }, 400);\n }\n if (err instanceof HTTPException) return err.getResponse();\n throw err;\n});\n\nexport default app.fetch;\n","audience-survey","children",[],[223],"6736eb8c-efd4-41b8-a16a-776428f3bec9","deno.json","239ffd84-ab17-11f1-a1f1-1607ee4eb77e",74,["D",1788844044382],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\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 },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}\n",[],[234],"2039f05c-ed77-4a77-b7ee-bf710c1e2fbd","README.md","6bf20ad2-a8ec-11f1-b671-1607ee4eb77e",148,["D",1788849922567],11,"# 📊 Audience Survey\n\nLive polling for talks. Show a QR code, let the room answer on their phones with\n**no login**, then reveal results on the projector — with ranked-choice runoffs,\nword clouds, and breakdowns by who's in the audience.\n\n**[Create a survey](url:index.ts)** · no account needed\n\n## How a talk goes\n\n1. **Create** — hit the homepage, name your survey. You get a **secret admin\n link** (bookmark it — it's the only way back).\n2. **Build** — add and edit questions as a private draft, then click **Save\n questions** to put new questions **on deck**. Mark ones like _\"What's your\n profession?\"_ as **Demographic** so you can group everything else by them\n later.\n3. **Share** — put the fullscreen **join slide** (`/s//present`) on the\n projector. It shows a big QR code + short URL.\n4. **Release and collect** — click **Release to audience** on each saved\n question when you reach it in the talk. Audience pages poll for newly\n released questions and present them one per screen. Each phone gets a cookie\n so answers are one-per-device and editable; no accounts.\n5. **Reveal** — flip **Show results to audience**. Open `/s//results` on\n the projector; it live-updates every 3s. Use **Group by** to split every\n chart by a demographic question, or click a group chip to isolate it.\n6. **Co-create** — participants suggest complete questions and upvote others\n from the intro or thank-you screen. In the admin **Proposals** tab, review a\n draft, edit it, then approve it to append a live question. Finished\n participants see an invitation to answer newly added questions rather than\n being moved away from the community queue.\n\n## Community questions\n\nParticipants can propose any supported question type, including options, scale\nbounds, or matrix configuration. Pending proposals are public, sorted by upvotes\n(oldest first on ties), and refresh every 5 seconds while the page is visible.\nEach device can toggle one upvote per proposal; submitting a proposal does not\nautomatically vote for it. Proposals do not require answering the survey first,\nand participants may upvote their own ideas.\n\nThe presenter sets required, demographic, and result-visibility flags during\nreview. Approval is manual regardless of vote count, appends the edited question\n**on deck**, and removes its proposal from the pending queue. The presenter\nreleases it separately when ready. Votes are not survey answers. There are no\ncomments, participant edits, rejection actions, or automatic approvals.\n\nClosing **Accepting responses** also closes proposals and voting, but leaves\npending ideas readable. Admins may still approve while closed; participants can\nanswer those questions when the survey reopens. Clearing responses keeps\nproposals and votes; deleting the survey removes them.\n\nProposal prompts are limited to 500 characters. Choice questions require 2–20\ndistinct nonempty options of up to 120 characters each. Scales use integer\nbounds between -100 and 100 and contain 2–21 steps. Matrix questions use a 2×2\ngrid, a nonempty subject label of up to 120 characters, four nonempty endpoint\nlabels of up to 60 characters, and up to 100 optional comparison-point labels of\n120 characters each. Submission and approval requests are limited to 16 KB.\n\n## Question types\n\n| Type | Respondent sees | Results visualization |\n| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| Multiple choice (one) | Tappable cards | Colored bar chart; grouped bars when faceted |\n| Multiple choice (many) | Tappable cards | UpSet intersection plot with an option-total bar toggle; one plot per group when faceted |\n| Scale / rating (e.g. 1–5, 0–10 NPS) | Number grid | Heat-colored histogram + animated mean |\n| **Ranked choice** | Tap-to-rank list with reorder | **Instant-runoff animation** — step through elimination rounds, or switch to Borda points / first choices. Per-group winners when faceted |\n| Word cloud | Single word/phrase | Sized, tilted word cloud |\n| Free text | Textarea | Sticky-note wall |\n| Emoji reaction | Emoji grid | Floating emoji bubbles scaled by count |\n| **2×2 matrix** | Drag/touch placement of a creator-labeled symbol anywhere in the plane, with tap and keyboard fallbacks, axis endpoints, and optional comparison points | Toggleable placement scatter plot and density heatmap with the same comparison points; one matrix per facet group |\n\n## Admin controls\n\n- **Save questions** — persist question additions, edits, deletions, and\n reordering after reviewing the draft; newly saved questions remain on deck\n- **Release to audience / Move on deck** (per question) — immediately control\n whether a saved question can be seen and answered without publishing other\n unsaved edits; moving a question back on deck preserves answers already\n collected\n- **Accepting responses** — close the survey when you move on\n- **Show results to audience** — survey-wide reveal toggle\n- **Hide results** (per question) — keeps a question out of the audience view\n even when results are on\n- **Audience can group results** — let respondents use the facet controls too\n (off by default, keeps the projector clean)\n- **Focus one question** — projector-sized single-question view for pacing a\n talk\n- **Proposals** — review the audience's most-upvoted question drafts, edit, and\n approve\n- CSV export, clear responses, delete survey\n\nMatrix questions have a creator-defined subject label for the symbol each\nrespondent places. The respondent can drag it with a mouse, touch, or stylus,\ntap/click a destination, or use the arrow keys for precise movement. Answers are\nstored as normalized coordinates measured from the top-left: `x` increases from\nleft to right and `y` increases from top to bottom. Merely viewing the centered\nunplaced symbol does not answer the question; the existing **Required** setting\nstill controls whether it may be skipped.\n\nComparison points are optional read-only context, not additional answers. Each\none appears in its cell as a symbol connected to a label, and question creators\ncan drag the symbol and label independently to avoid visual overlap while\nkeeping the full label inside its cell. Their relative placement is reused in\nthe builder, respondent grid, scatter results, and density results. Each\ncomparison point uses the same shape and color in the grid and retained legend;\nits legend entry includes a small highlighted grid showing its cell.\n\nResults can switch between plotting every submitted placement and a 12×12\ndensity heatmap. Exact overlapping scatter points receive small deterministic\noffsets so repeated positions remain visible. CSV exports use stable values such\nas `x 0.750, y 0.250 from top-left`. Existing `{ row, column }` answers remain\ncompatible: they are interpreted at the center of the original quadrant and\ncanonicalized to continuous coordinates when submitted again.\n\n## Architecture\n\n```mermaid\ngraph LR\n subgraph Browser\n Home[/ Home/] --> Admin[\"/admin/:secretKey\"]\n QR[\"/s/:slug/present
QR slide\"] -.scan.-> Respond[\"/s/:slug
one question per screen\"]\n Results[\"/s/:slug/results
live charts + facets\"]\n end\n subgraph \"index.ts (Hono)\"\n API[\"/api/s/:slug/*
cookie sid\"]\n AdminAPI[\"/api/admin/:key/*
SHA-256 key check\"]\n Agg[\"backend/aggregate.ts
IRV · Borda · facets\"]\n end\n Respond --> API --> DB[(SQLite)]\n Results -->|poll 3s| API --> Agg\n Admin --> AdminAPI --> DB\n AdminAPI --> Agg\n```\n\n**Security model:** the admin key is a 28-char random token stored only as a\nSHA-256 hash. Respondents are identified by an `HttpOnly` cookie; clearing it or\nswitching devices allows a second response or another proposal vote (acceptable\ntrade-off for a login-free live poll — a \"welcome back\" banner nudges returning\ndevices to edit instead). Public proposal payloads never expose device\nidentifiers. Votes are unique per device and proposal, not per verified person;\nthis is not strong abuse prevention.\n\nApproval claims the pending proposal and appends its question on deck in a\nsingle SQLite write transaction. Regular builder edits stay local until **Save\nquestions** is clicked. Release actions update only the persisted release flag,\nso they never publish unrelated draft edits. Saves compare their last persisted\nquestion snapshot to prevent stale tabs from overwriting an approval or release;\nconflicts retain local edits and offer a reload rather than silently losing\nquestions.\n\nQuestions saved before progressive release was introduced are treated as\nreleased, preserving existing survey behavior. Public survey and results APIs\nomit on-deck questions, and crafted response requests cannot answer them. Admin\nresults and CSV exports retain the full question set. If a released question is\nmoved back on deck, its stored answers remain available if it is released again.\n\n## Files\n\n```\nindex.ts Hono server: shell routes, public + admin API, QR SVG\nbackend/db.ts SQLite schema, hashing, random ids\nbackend/surveys.ts CRUD, response upsert, answer sanitization\nbackend/aggregate.ts per-type aggregation, pick-many intersections, instant-runoff, facet bucketing\nbackend/proposals.ts proposal normalization, queries, approval workflow\nbackend/proposal-sql.ts proposal/vote schema and atomic mutation statements\nbackend/errors.ts expected API error types\nshared/types.ts Question/answer/result types shared by client & server\nshared/questions.ts shared question defaults and proposal validation\nfrontend/\n root.tsx HTML shell\n index.tsx React mount\n lib/api.ts typed fetch helpers\n lib/useProposals.ts abortable live proposal polling\n components/App.tsx path router\n pages/Home.tsx create a survey\n pages/Admin.tsx build · share · results tabs\n pages/Respond.tsx one-question-per-screen flow\n lib/respondFlow.ts active-question reconciliation across live releases\n pages/Results.tsx public live results\n pages/Present.tsx fullscreen QR join slide\n components/builder/ QuestionEditor and matrix configuration editor\n components/proposals/ participant composer, proposal cards, admin review\n components/respond/ QuestionInput, ranked drag/tap, and continuous matrix placement\n components/charts/ Charts, matrix scatter/density results, ResultsView (polling, facets)\n```\n\n## Proposal regression tests\n\nThe tests use Deno's built-in runner and real in-memory SQLite through\n`node:sqlite`; the test configuration redirects only the Val Town SQLite import.\nNo live survey data is used. The placeholder environment value lets the existing\nVal Town asset utility initialize without real credentials.\n\n```sh\nVAL_TOWN_API_KEY=local-test-placeholder deno test --allow-import --allow-env=VAL_TOWN_API_KEY \\\n --config tests/deno.json tests/api_test.ts shared/questions_test.ts backend/aggregate_test.ts backend/proposal-sql_test.ts \\\n frontend/lib/questionDraft_test.ts frontend/components/MatrixCellReferences_test.ts \\\n frontend/components/respond/MatrixInput_test.ts frontend/components/charts/MatrixHeatmap_test.ts\n```\n",[],[242],"03c7fb49-1792-41a6-b6cf-1986cd272648","LICENSE","d2f63596-ac89-11f1-8d7a-1607ee4eb77e",["D",1788984337494],"MIT License\n\nCopyright (c) 2026 Kevin Xu\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n",[],[251],["D",1788844047840],[],[18],"9edf8260-4785-4901-86fb-409fe2ca18ea",".vtignore","23990ede-ab17-11f1-9def-1607ee4eb77e",28,["D",1788825129320],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\n.github\n.gitignore\n**/*_test.ts\ntests\n",[],[261],"205a7660-7798-4e82-8bae-92d5273d7f7b","types.ts","50d89668-a8eb-11f1-a50d-1607ee4eb77e","b40de0d0-1c08-44ab-bea0-624350d7cf7b",141,["D",1788849921433],8,"script","export type QuestionType =\n | \"single_choice\"\n | \"multi_choice\"\n | \"scale\"\n | \"free_text\"\n | \"ranked_choice\"\n | \"word_cloud\"\n | \"emoji_reaction\"\n | \"matrix_2x2\";\n\nexport type MatrixSize = 2;\n\nexport interface MatrixAxisLabels {\n left: string;\n right: string;\n bottom: string;\n top: string;\n}\n\nexport interface MatrixReference {\n id: string;\n row: number;\n column: number;\n label: string;\n /** Normalized symbol and label centers within the reference cell. */\n symbolX?: number;\n symbolY?: number;\n labelX?: number;\n labelY?: number;\n}\n\nexport interface MatrixAnswer {\n /** Normalized position across the full matrix, measured from top-left. */\n x: number;\n y: number;\n}\n\nexport interface Option {\n id: string;\n label: string;\n}\n\nexport interface Question {\n id: string;\n position: number;\n type: QuestionType;\n prompt: string;\n options: Option[]; // for choice/ranked/emoji types\n scaleMin?: number; // for scale\n scaleMax?: number;\n matrixSize?: MatrixSize;\n matrixSubjectLabel?: string;\n matrixAxisLabels?: MatrixAxisLabels;\n matrixReferences?: MatrixReference[];\n isDemographic: boolean;\n required: boolean;\n released: boolean; // available to respondents and eligible for public results\n hidden: boolean; // per-question hide override on results\n}\n\nexport interface Survey {\n id: string;\n slug: string;\n title: string;\n description: string;\n resultsVisible: boolean;\n acceptingResponses: boolean;\n audienceFacets: boolean; // can the audience use group-by on results?\n createdAt: string;\n questions: Question[];\n}\n\nexport type QuestionDraft = Pick<\n Question,\n | \"type\"\n | \"prompt\"\n | \"options\"\n | \"scaleMin\"\n | \"scaleMax\"\n | \"matrixSize\"\n | \"matrixSubjectLabel\"\n | \"matrixAxisLabels\"\n | \"matrixReferences\"\n>;\n\nexport interface QuestionProposal {\n id: string;\n draft: QuestionDraft;\n status: \"pending\" | \"approved\";\n createdAt: string;\n voteCount: number;\n voted: boolean;\n}\n\nexport interface ProposalsPayload {\n proposals: QuestionProposal[];\n acceptingResponses: boolean;\n}\n\n/** Answer values: single -> optionId; multi -> optionId[]; scale -> number;\n * free_text/word_cloud -> string; ranked_choice -> optionId[] (ordered);\n * emoji -> optionId; matrix -> normalized x/y coordinates. */\nexport type AnswerValue = string | number | string[] | MatrixAnswer;\n\nexport type Answers = Record;\n\nexport interface IRVRound {\n round: number;\n tallies: Record;\n eliminated: string | null;\n winner: string | null;\n}\n\nexport interface ChoiceIntersection {\n optionIds: string[];\n count: number;\n}\n\nexport interface QuestionAggregate {\n questionId: string;\n type: QuestionType;\n responseCount: number;\n /** For choice/emoji: counts by optionId. */\n counts?: Record;\n /** For multi-choice: exact observed option combinations. */\n intersections?: ChoiceIntersection[];\n /** For scale: counts by value, plus mean. */\n distribution?: Record;\n mean?: number | null;\n /** For text/word cloud. */\n texts?: string[];\n words?: { text: string; value: number }[];\n /** For ranked choice. */\n irv?: IRVRound[];\n borda?: Record;\n firstChoice?: Record;\n /** For matrix questions: counts keyed by \"row,column\". */\n matrixCounts?: Record;\n /** For matrix questions: normalized response positions. */\n matrixPoints?: MatrixAnswer[];\n}\n\nexport interface FacetGroup {\n key: string; // optionId or scale value, or \"__all__\"\n label: string;\n responseCount: number;\n aggregates: QuestionAggregate[];\n}\n\nexport interface ResultsPayload {\n survey: Survey;\n totalResponses: number;\n groupBy: string | null;\n groups: FacetGroup[];\n}\n\nexport const QUESTION_TYPE_LABELS: Record = {\n single_choice: \"Multiple choice (pick one)\",\n multi_choice: \"Multiple choice (pick many)\",\n scale: \"Scale / rating\",\n free_text: \"Free text\",\n ranked_choice: \"Ranked choice\",\n word_cloud: \"Word cloud (one word/phrase)\",\n emoji_reaction: \"Emoji reaction\",\n matrix_2x2: \"2×2 matrix\",\n};\n\nexport const DEFAULT_EMOJIS = [\"🔥\", \"😍\", \"🤔\", \"😴\", \"😂\", \"🤯\"];\n\nexport function hasOptions(t: QuestionType) {\n return t === \"single_choice\" || t === \"multi_choice\" ||\n t === \"ranked_choice\" || t === \"emoji_reaction\";\n}\n",[],[279,269],"shared","1c850c40-4982-4f53-b63f-ddaef8d85917","questions.ts","238b317e-ab17-11f1-9453-1607ee4eb77e",139,["D",1788849921435],7,"import { DEFAULT_EMOJIS, hasOptions, QUESTION_TYPE_LABELS } from \"./types.ts\";\nimport type {\n MatrixAnswer,\n MatrixAxisLabels,\n MatrixReference,\n MatrixSize,\n Option,\n Question,\n QuestionDraft,\n QuestionType,\n} from \"./types.ts\";\n\nexport const QUESTION_LIMITS = {\n prompt: 500,\n optionLabel: 120,\n options: 20,\n scaleSteps: 21,\n matrixSubjectLabel: 120,\n matrixAxisLabel: 60,\n matrixReferenceLabel: 120,\n matrixReferences: 100,\n};\n\nexport const MATRIX_REFERENCE_POSITION_MIN = 0.08;\nexport const MATRIX_REFERENCE_POSITION_MAX = 0.92;\n\nconst MATRIX_REFERENCE_DEFAULT_POSITIONS = [\n { x: 0.24, y: 0.2 },\n { x: 0.76, y: 0.2 },\n { x: 0.24, y: 0.8 },\n { x: 0.76, y: 0.8 },\n { x: 0.5, y: 0.2 },\n { x: 0.2, y: 0.5 },\n { x: 0.8, y: 0.5 },\n { x: 0.5, y: 0.8 },\n { x: 0.5, y: 0.5 },\n] as const;\n\nexport const DEFAULT_MATRIX_AXIS_LABELS: MatrixAxisLabels = {\n left: \"Left\",\n right: \"Right\",\n bottom: \"Bottom\",\n top: \"Top\",\n};\n\nexport class QuestionValidationError extends Error {}\n\nexport function canonicalizeChoiceSelection(\n options: Option[],\n raw: unknown,\n): string[] | null {\n if (!Array.isArray(raw)) return null;\n const selected = new Set(\n raw.filter((value): value is string => typeof value === \"string\"),\n );\n return options.filter((option) => selected.has(option.id)).map((option) =>\n option.id\n );\n}\n\nexport function newQuestion(type: QuestionType = \"single_choice\"): Question {\n return {\n id: crypto.randomUUID(),\n position: 0,\n type,\n prompt: \"\",\n options: hasOptions(type)\n ? (type === \"emoji_reaction\" ? DEFAULT_EMOJIS : [\"\", \"\"]).map((\n label,\n ) => ({\n id: crypto.randomUUID(),\n label,\n }))\n : [],\n ...(type === \"scale\" ? { scaleMin: 1, scaleMax: 5 } : {}),\n ...(type === \"matrix_2x2\"\n ? {\n matrixSize: 2 as MatrixSize,\n matrixSubjectLabel: \"\",\n matrixAxisLabels: { ...DEFAULT_MATRIX_AXIS_LABELS },\n matrixReferences: [],\n }\n : {}),\n isDemographic: false,\n required: false,\n released: false,\n hidden: false,\n };\n}\n\n/** Questions saved before progressive release existed remain audience-visible. */\nexport function normalizeStoredQuestions(raw: unknown): Question[] {\n if (!Array.isArray(raw)) return [];\n return raw.map((question, position) => {\n const stored = question as Question;\n if (\n stored.type === \"matrix_2x2\" &&\n stored.matrixSize !== undefined &&\n stored.matrixSize !== 2\n ) {\n throw new QuestionValidationError(\n \"Stored 4x4 and 6x6 matrices are no longer supported.\",\n );\n }\n return {\n ...stored,\n position,\n released: typeof (question as Partial)?.released === \"boolean\"\n ? stored.released\n : true,\n ...(stored.type === \"matrix_2x2\"\n ? {\n matrixSize: 2 as MatrixSize,\n matrixSubjectLabel: typeof stored.matrixSubjectLabel === \"string\" &&\n stored.matrixSubjectLabel.trim()\n ? stored.matrixSubjectLabel.trim().slice(\n 0,\n QUESTION_LIMITS.matrixSubjectLabel,\n )\n : \"Item\",\n matrixAxisLabels: normalizeStoredAxisLabels(stored.matrixAxisLabels),\n matrixReferences: normalizeStoredReferences(\n stored.matrixReferences,\n 2,\n ),\n isDemographic: false,\n }\n : {}),\n };\n });\n}\n\nfunction record(raw: unknown): Record {\n if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n throw new QuestionValidationError(\"Provide a question object.\");\n }\n return raw as Record;\n}\n\nfunction text(raw: unknown, max: number, label: string): string {\n if (typeof raw !== \"string\" || !raw.trim() || raw.trim().length > max) {\n throw new QuestionValidationError(\n `${label} must contain 1-${max} characters.`,\n );\n }\n return raw.trim();\n}\n\nexport function isMatrixSize(raw: unknown): raw is MatrixSize {\n return raw === 2;\n}\n\nexport function matrixCellKey(row: number, column: number): string {\n return `${row},${column}`;\n}\n\nexport function clampMatrixReferencePosition(value: number): number {\n if (!Number.isFinite(value)) return 0.5;\n const clamped = Math.min(\n MATRIX_REFERENCE_POSITION_MAX,\n Math.max(MATRIX_REFERENCE_POSITION_MIN, value),\n );\n return Math.round(clamped * 1000) / 1000;\n}\n\nexport function matrixReferenceDefaultPosition(\n indexInCell: number,\n): { x: number; y: number } {\n const normalized = Math.max(0, Math.floor(indexInCell));\n const base = MATRIX_REFERENCE_DEFAULT_POSITIONS[\n normalized % MATRIX_REFERENCE_DEFAULT_POSITIONS.length\n ];\n const cycle = Math.floor(\n normalized / MATRIX_REFERENCE_DEFAULT_POSITIONS.length,\n );\n const offset = cycle === 0 ? 0 : ((cycle % 5) - 2) * 0.025;\n return {\n x: clampMatrixReferencePosition(base.x + offset),\n y: clampMatrixReferencePosition(base.y - offset),\n };\n}\n\nexport function matrixReferenceDefaultPositions(\n indexInCell: number,\n): {\n symbolX: number;\n symbolY: number;\n labelX: number;\n labelY: number;\n} {\n const symbol = matrixReferenceDefaultPosition(indexInCell);\n const labelOffset = symbol.x <= 0.5 ? 0.2 : -0.2;\n return {\n symbolX: symbol.x,\n symbolY: symbol.y,\n labelX: clampMatrixReferencePosition(symbol.x + labelOffset),\n labelY: symbol.y,\n };\n}\n\nexport function isMatrixAnswer(raw: unknown): raw is MatrixAnswer {\n if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return false;\n const answer = raw as Partial;\n return validMatrixCoordinate(answer.x) && validMatrixCoordinate(answer.y);\n}\n\nexport function normalizeMatrixAnswer(\n raw: unknown,\n size: MatrixSize,\n): MatrixAnswer | null {\n if (isMatrixAnswer(raw)) {\n return {\n x: roundMatrixCoordinate(raw.x),\n y: roundMatrixCoordinate(raw.y),\n };\n }\n if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return null;\n const legacy = raw as { row?: unknown; column?: unknown };\n if (\n !Number.isInteger(legacy.row) || !Number.isInteger(legacy.column) ||\n (legacy.row as number) < 0 || (legacy.row as number) >= size ||\n (legacy.column as number) < 0 || (legacy.column as number) >= size\n ) {\n return null;\n }\n return {\n x: roundMatrixCoordinate(((legacy.column as number) + 0.5) / size),\n y: roundMatrixCoordinate(((legacy.row as number) + 0.5) / size),\n };\n}\n\nexport function matrixAnswerCell(\n answer: MatrixAnswer,\n size: MatrixSize,\n): { row: number; column: number } {\n return {\n row: Math.min(size - 1, Math.floor(answer.y * size)),\n column: Math.min(size - 1, Math.floor(answer.x * size)),\n };\n}\n\nexport function clampMatrixAnswerPosition(value: number): number {\n if (!Number.isFinite(value)) return 0.5;\n return roundMatrixCoordinate(Math.min(1, Math.max(0, value)));\n}\n\nfunction validMatrixCoordinate(raw: unknown): raw is number {\n return typeof raw === \"number\" && Number.isFinite(raw) && raw >= 0 &&\n raw <= 1;\n}\n\nfunction roundMatrixCoordinate(value: number): number {\n return Math.round(value * 1000) / 1000;\n}\n\nexport function referencesWithinSize(\n references: MatrixReference[] | undefined,\n size: MatrixSize,\n): MatrixReference[] {\n return (references ?? []).filter((reference) =>\n Number.isInteger(reference.row) && Number.isInteger(reference.column) &&\n reference.row >= 0 && reference.row < size &&\n reference.column >= 0 && reference.column < size\n );\n}\n\nfunction normalizeStoredAxisLabels(raw: unknown): MatrixAxisLabels {\n if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n return { ...DEFAULT_MATRIX_AXIS_LABELS };\n }\n const labels = raw as Partial;\n return {\n left: typeof labels.left === \"string\" && labels.left.trim()\n ? labels.left\n : DEFAULT_MATRIX_AXIS_LABELS.left,\n right: typeof labels.right === \"string\" && labels.right.trim()\n ? labels.right\n : DEFAULT_MATRIX_AXIS_LABELS.right,\n bottom: typeof labels.bottom === \"string\" && labels.bottom.trim()\n ? labels.bottom\n : DEFAULT_MATRIX_AXIS_LABELS.bottom,\n top: typeof labels.top === \"string\" && labels.top.trim()\n ? labels.top\n : DEFAULT_MATRIX_AXIS_LABELS.top,\n };\n}\n\nfunction normalizeStoredReferences(\n raw: unknown,\n size: MatrixSize,\n): MatrixReference[] {\n if (!Array.isArray(raw)) return [];\n const cellCounts = new Map();\n return referencesWithinSize(\n raw.flatMap((reference) => {\n if (\n !reference || typeof reference !== \"object\" ||\n typeof (reference as MatrixReference).id !== \"string\" ||\n typeof (reference as MatrixReference).label !== \"string\" ||\n !(reference as MatrixReference).label.trim()\n ) {\n return [];\n }\n const stored = reference as MatrixReference;\n const input = reference as Record;\n const key = matrixCellKey(stored.row, stored.column);\n const indexInCell = cellCounts.get(key) ?? 0;\n cellCounts.set(key, indexInCell + 1);\n const fallback = matrixReferenceDefaultPositions(indexInCell);\n const legacyPosition = coordinatePair(input, \"x\", \"y\") ?? undefined;\n const symbolPosition = coordinatePair(input, \"symbolX\", \"symbolY\") ??\n undefined;\n const labelPosition = coordinatePair(input, \"labelX\", \"labelY\") ??\n undefined;\n return [{\n id: stored.id,\n row: stored.row,\n column: stored.column,\n label: stored.label.trim(),\n symbolX: symbolPosition?.x ?? legacyPosition?.x ?? fallback.symbolX,\n symbolY: symbolPosition?.y ?? legacyPosition?.y ?? fallback.symbolY,\n labelX: labelPosition?.x ??\n (legacyPosition\n ? clampMatrixReferencePosition(\n legacyPosition.x +\n (legacyPosition.x <= 0.5 ? 0.2 : -0.2),\n )\n : fallback.labelX),\n labelY: labelPosition?.y ?? legacyPosition?.y ?? fallback.labelY,\n }];\n }).slice(0, QUESTION_LIMITS.matrixReferences),\n size,\n );\n}\n\nfunction validStoredReferencePosition(raw: unknown): raw is number {\n return typeof raw === \"number\" && Number.isFinite(raw) &&\n raw >= MATRIX_REFERENCE_POSITION_MIN &&\n raw <= MATRIX_REFERENCE_POSITION_MAX;\n}\n\nfunction matrixAxisLabels(raw: unknown): MatrixAxisLabels {\n const input = record(raw);\n return {\n left: text(input.left, QUESTION_LIMITS.matrixAxisLabel, \"Left axis label\"),\n right: text(\n input.right,\n QUESTION_LIMITS.matrixAxisLabel,\n \"Right axis label\",\n ),\n bottom: text(\n input.bottom,\n QUESTION_LIMITS.matrixAxisLabel,\n \"Bottom axis label\",\n ),\n top: text(input.top, QUESTION_LIMITS.matrixAxisLabel, \"Top axis label\"),\n };\n}\n\nfunction matrixReferences(raw: unknown, size: MatrixSize): MatrixReference[] {\n if (!Array.isArray(raw) || raw.length > QUESTION_LIMITS.matrixReferences) {\n throw new QuestionValidationError(\n `Provide no more than ${QUESTION_LIMITS.matrixReferences} matrix reference labels.`,\n );\n }\n const cellCounts = new Map();\n return raw.map((reference) => {\n const input = record(reference);\n const row = input.row;\n const column = input.column;\n if (\n typeof row !== \"number\" || typeof column !== \"number\" ||\n !Number.isSafeInteger(row) || !Number.isSafeInteger(column) ||\n row < 0 || row >= size || column < 0 || column >= size\n ) {\n throw new QuestionValidationError(\n \"Matrix reference cells must be within the selected grid.\",\n );\n }\n const key = matrixCellKey(row, column);\n const indexInCell = cellCounts.get(key) ?? 0;\n cellCounts.set(key, indexInCell + 1);\n const fallback = matrixReferenceDefaultPositions(indexInCell);\n const legacyPosition = coordinatePair(input, \"x\", \"y\");\n const symbolPosition = coordinatePair(input, \"symbolX\", \"symbolY\");\n const labelPosition = coordinatePair(input, \"labelX\", \"labelY\");\n if (\n legacyPosition === null || symbolPosition === null ||\n labelPosition === null\n ) {\n throw new QuestionValidationError(\n `Matrix reference positions must be between ${MATRIX_REFERENCE_POSITION_MIN} and ${MATRIX_REFERENCE_POSITION_MAX}.`,\n );\n }\n const symbol = symbolPosition ?? legacyPosition ?? {\n x: fallback.symbolX,\n y: fallback.symbolY,\n };\n const label = labelPosition ?? (legacyPosition\n ? {\n x: clampMatrixReferencePosition(\n legacyPosition.x + (legacyPosition.x <= 0.5 ? 0.2 : -0.2),\n ),\n y: legacyPosition.y,\n }\n : { x: fallback.labelX, y: fallback.labelY });\n return {\n id: crypto.randomUUID(),\n row,\n column,\n label: text(\n input.label,\n QUESTION_LIMITS.matrixReferenceLabel,\n \"Matrix reference label\",\n ),\n symbolX: symbol.x,\n symbolY: symbol.y,\n labelX: label.x,\n labelY: label.y,\n };\n });\n}\n\nfunction coordinatePair(\n input: Record,\n xKey: string,\n yKey: string,\n): { x: number; y: number } | null | undefined {\n const hasX = input[xKey] !== undefined;\n const hasY = input[yKey] !== undefined;\n if (!hasX && !hasY) return undefined;\n if (\n hasX !== hasY || !validStoredReferencePosition(input[xKey]) ||\n !validStoredReferencePosition(input[yKey])\n ) {\n return null;\n }\n return { x: input[xKey], y: input[yKey] };\n}\n\n/** Ignore client IDs and admin flags; every approved question gets fresh identifiers. */\nexport function normalizeDraft(raw: unknown): QuestionDraft {\n const input = record(raw);\n if (\n typeof input.type !== \"string\" ||\n !Object.hasOwn(QUESTION_TYPE_LABELS, input.type)\n ) {\n throw new QuestionValidationError(\"Choose a supported question type.\");\n }\n const type = input.type as QuestionType;\n const draft: QuestionDraft = {\n type,\n prompt: text(input.prompt, QUESTION_LIMITS.prompt, \"Question prompt\"),\n options: [],\n };\n if (hasOptions(type)) {\n if (\n !Array.isArray(input.options) || input.options.length < 2 ||\n input.options.length > QUESTION_LIMITS.options\n ) {\n throw new QuestionValidationError(\n `Provide 2-${QUESTION_LIMITS.options} options.`,\n );\n }\n draft.options = input.options.map((option) => ({\n id: crypto.randomUUID(),\n label: text(record(option).label, QUESTION_LIMITS.optionLabel, \"Option\"),\n }));\n if (\n new Set(draft.options.map((o) => o.label.toLowerCase())).size !==\n draft.options.length\n ) {\n throw new QuestionValidationError(\"Options must have distinct labels.\");\n }\n }\n if (type === \"scale\") {\n const min = input.scaleMin;\n const max = input.scaleMax;\n if (\n typeof min !== \"number\" || typeof max !== \"number\" ||\n !Number.isSafeInteger(min) ||\n !Number.isSafeInteger(max) || min < -100 || max > 100 || min >= max ||\n max - min + 1 > QUESTION_LIMITS.scaleSteps\n ) {\n throw new QuestionValidationError(\n \"Use integer scale bounds from -100 to 100, with 2-21 steps.\",\n );\n }\n draft.scaleMin = min;\n draft.scaleMax = max;\n }\n if (type === \"matrix_2x2\") {\n if (!isMatrixSize(input.matrixSize)) {\n throw new QuestionValidationError(\"Choose a 2x2 matrix.\");\n }\n draft.matrixSize = input.matrixSize;\n draft.matrixSubjectLabel = text(\n input.matrixSubjectLabel,\n QUESTION_LIMITS.matrixSubjectLabel,\n \"Matrix subject label\",\n );\n draft.matrixAxisLabels = matrixAxisLabels(input.matrixAxisLabels);\n draft.matrixReferences = matrixReferences(\n input.matrixReferences,\n input.matrixSize,\n );\n }\n return draft;\n}\n\nexport function questionFromDraft(draft: QuestionDraft): Question {\n return { ...newQuestion(draft.type), ...draft };\n}\n\nexport function normalizeApprovedQuestion(raw: unknown): Question {\n const input = record(raw);\n const question = questionFromDraft(normalizeDraft(raw));\n for (const key of [\"required\", \"hidden\", \"isDemographic\"] as const) {\n if (input[key] !== undefined && typeof input[key] !== \"boolean\") {\n throw new QuestionValidationError(`${key} must be a boolean.`);\n }\n question[key] = input[key] === true;\n }\n const canFacet = [\"single_choice\", \"multi_choice\", \"scale\", \"emoji_reaction\"]\n .includes(question.type);\n question.isDemographic = canFacet && question.isDemographic;\n question.released = false;\n return question;\n}\n",[],[279,281],"3d8da2dc-c72c-49b4-824a-0d8647503817",["D",1788586405154],"directory",[214,215],[279],"3368e47b-5eba-484f-b4e6-3d034531850f","root.tsx","01a0700e-6ffb-769f-9a4d-f2d83060ed96","01a0700e-6ffa-7369-be27-f3f825983851",80,["D",1788844045205],2,"/** @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 Audience Survey\n

History · AGENTS.md