vt-dep graph

${escapeHtml(mermaid)}

Mermaid source

${escapeHtml(mermaid)}

{\n const url = new URL(request.url);\n\n if (request.method === \"GET\" && url.pathname === \"/\") {\n return htmlResponse(homeHtml());\n }\n if (request.method === \"GET\" && url.pathname === \"/sample\") {\n return jsonResponse(sample);\n }\n if (request.method === \"GET\" && url.pathname === \"/sample/mermaid\") {\n return mermaidHtmlResponse(sample.mermaid);\n }\n if (request.method === \"GET\" && url.pathname === \"/sample/mermaid.txt\") {\n return textResponse(sample.mermaid);\n }\n\n if (\n request.method === \"POST\" &&\n (url.pathname === \"/analyze\" || url.pathname === \"/\")\n ) {\n let body: unknown;\n try {\n body = await request.json();\n } catch {\n return jsonResponse({\n error:\n \"Expected JSON body with shape { files: Record }\",\n }, { status: 400 });\n }\n if (!isAnalyzeRequest(body)) {\n return jsonResponse({\n error:\n \"Expected JSON body with shape { files: Record }\",\n }, { status: 400 });\n }\n return jsonResponse(analyzeVals(body.files));\n }\n\n return jsonResponse({ error: \"Not found\" }, { status: 404 });\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replaceAll(\"&\", \"&\")\n .replaceAll(\"<\", \"<\")\n .replaceAll(\">\", \">\")\n .replaceAll('\"', \""\")\n .replaceAll(\"'\", \"'\");\n}\n\nfunction homeHtml(): string {\n return `\n\n \n \n \n vt-dep\n \n \n \n

vt-dep

Val Town-native dependency analyzer for small JS/TS projects.

API

POST /analyze\ncontent-type: application/json\n\n{\n  \"files\": {\n    \"main.ts\": \"import { helper } from './helper.ts';\",\n    \"helper.ts\": \"export const helper = 1;\"\n  }\n}

Try /sample, /sample/mermaid, or /sample/mermaid.txt.

\n \n`;\n}\n\nexport default handleRequest;\n\nexport const sample = analyzeVals({\n \"main.ts\": `\n import { helper } from \"./helper.ts\";\n import lodash from \"npm:lodash\";\n const dynamic = await import(\"./dynamic.ts\");\n console.log(helper, lodash, dynamic);\n `,\n \"helper.ts\": `\n export { cycle } from \"./cycle\";\n export const helper = 1;\n `,\n \"cycle.ts\": `\n import \"./helper.ts\";\n export const cycle = true;\n `,\n \"dynamic.ts\": `\n import { email } from \"https://esm.town/v/chad/email\";\n export default email;\n `,\n});\n","import * as parser from \"npm:@babel/parser\";\nimport traverseModule from \"npm:@babel/traverse\";\n\nexport type SourceMap = Record;\n\nexport type DependencyKind =\n | \"local\"\n | \"val\"\n | \"npm\"\n | \"jsr\"\n | \"url\"\n | \"builtin\"\n | \"unresolved\";\n\nexport type ModuleSystem = \"es6\" | \"cjs\" | \"dynamic\";\n\nexport type Dependency = {\n specifier: string;\n resolved?: string;\n kind: DependencyKind;\n dynamic: boolean;\n moduleSystem: ModuleSystem;\n typeOnly: boolean;\n};\n\nexport type ModuleNode = {\n id: string;\n dependencies: Dependency[];\n};\n\nexport type AnalysisResult = {\n modules: ModuleNode[];\n cycles: string[][];\n unresolved: Dependency[];\n externals: Dependency[];\n parseErrors: ParseError[];\n mermaid: string;\n};\n\nexport type ParseError = {\n id: string;\n message: string;\n};\n\nexport type AnalyzeRequest = {\n files: SourceMap;\n};\n\nconst traverse =\n (traverseModule as unknown as { default?: typeof traverseModule }).default ??\n traverseModule;\nconst EXTENSIONS = [\"\", \".ts\", \".tsx\", \".js\", \".jsx\", \".mjs\"];\nconst INDEXES = [\n \"/index.ts\",\n \"/index.tsx\",\n \"/index.js\",\n \"/index.jsx\",\n \"/index.mjs\",\n];\nconst NODE_BUILTINS = new Set([\n \"assert\",\n \"buffer\",\n \"child_process\",\n \"crypto\",\n \"events\",\n \"fs\",\n \"http\",\n \"https\",\n \"module\",\n \"os\",\n \"path\",\n \"process\",\n \"stream\",\n \"timers\",\n \"url\",\n \"util\",\n \"zlib\",\n]);\n\nexport function analyzeVals(files: SourceMap): AnalysisResult {\n const normalizedFiles = normalizeFileMap(files);\n const parseErrors: ParseError[] = [];\n const modules = Object.entries(normalizedFiles).map(([id, source]) => {\n const extraction = extractSpecifiers(id, source);\n if (extraction.error) parseErrors.push(extraction.error);\n return {\n id,\n dependencies: extraction.specifiers.map((item) =>\n resolveDependency(id, item, normalizedFiles)\n ),\n };\n });\n\n const unresolved = modules.flatMap((module) =>\n module.dependencies.filter((dependency) => dependency.kind === \"unresolved\")\n );\n const externals = modules.flatMap((module) =>\n module.dependencies.filter((dependency) =>\n [\"val\", \"npm\", \"jsr\", \"url\", \"builtin\"].includes(dependency.kind)\n )\n );\n\n return {\n modules,\n cycles: findCycles(modules),\n unresolved,\n externals,\n parseErrors,\n mermaid: toMermaid(modules),\n };\n}\n\ntype ExtractedSpecifier = {\n specifier: string;\n dynamic: boolean;\n moduleSystem: ModuleSystem;\n typeOnly: boolean;\n};\n\nfunction extractSpecifiers(\n id: string,\n source: string,\n): {\n specifiers: ExtractedSpecifier[];\n error?: ParseError;\n} {\n const specifiers: ExtractedSpecifier[] = [];\n let ast: parser.ParseResult;\n try {\n ast = parser.parse(source, {\n sourceType: \"unambiguous\",\n plugins: [\n \"typescript\",\n \"jsx\",\n \"decoratorAutoAccessors\",\n \"decorators-legacy\",\n \"importAssertions\",\n \"importAttributes\",\n \"explicitResourceManagement\",\n \"asyncDoExpressions\",\n \"doExpressions\",\n \"exportDefaultFrom\",\n \"functionBind\",\n \"moduleBlocks\",\n ],\n errorRecovery: true,\n });\n } catch (error) {\n return {\n specifiers,\n error: {\n id,\n message: error instanceof Error ? error.message : String(error),\n },\n };\n }\n\n traverse(ast, {\n ImportDeclaration(path: any) {\n addSpecifier(specifiers, path.node.source?.value, {\n dynamic: false,\n moduleSystem: \"es6\",\n typeOnly: path.node.importKind === \"type\" ||\n allSpecifiersTypeOnly(path.node.specifiers),\n });\n },\n ExportNamedDeclaration(path: any) {\n addSpecifier(specifiers, path.node.source?.value, {\n dynamic: false,\n moduleSystem: \"es6\",\n typeOnly: path.node.exportKind === \"type\",\n });\n },\n ExportAllDeclaration(path: any) {\n addSpecifier(specifiers, path.node.source?.value, {\n dynamic: false,\n moduleSystem: \"es6\",\n typeOnly: path.node.exportKind === \"type\",\n });\n },\n Import(path: any) {\n const parent = path.parentPath?.node;\n const firstArg = parent?.arguments?.[0];\n addSpecifier(specifiers, literalValue(firstArg), {\n dynamic: true,\n moduleSystem: \"dynamic\",\n typeOnly: false,\n });\n },\n CallExpression(path: any) {\n if (path.node.callee?.name !== \"require\") return;\n addSpecifier(specifiers, literalValue(path.node.arguments?.[0]), {\n dynamic: false,\n moduleSystem: \"cjs\",\n typeOnly: false,\n });\n },\n });\n\n return {\n specifiers: uniqueBy(\n specifiers,\n ({ specifier, dynamic, moduleSystem, typeOnly }) =>\n `${dynamic}:${moduleSystem}:${typeOnly}:${specifier}`,\n ),\n };\n}\n\nfunction addSpecifier(\n specifiers: ExtractedSpecifier[],\n value: unknown,\n attributes: Omit,\n) {\n if (typeof value === \"string\" && value.length > 0) {\n specifiers.push({ specifier: value, ...attributes });\n }\n}\n\nfunction allSpecifiersTypeOnly(specifiers: any[] = []): boolean {\n return specifiers.length > 0 &&\n specifiers.every((specifier) => specifier.importKind === \"type\");\n}\n\nfunction literalValue(node: any): string | undefined {\n if (!node) return undefined;\n if (node.type === \"StringLiteral\") return node.value;\n if (node.type === \"Literal\" && typeof node.value === \"string\") {\n return node.value;\n }\n return undefined;\n}\n\nfunction resolveDependency(\n importer: string,\n extracted: ExtractedSpecifier,\n files: SourceMap,\n): Dependency {\n const base = {\n specifier: extracted.specifier,\n dynamic: extracted.dynamic,\n moduleSystem: extracted.moduleSystem,\n typeOnly: extracted.typeOnly,\n };\n const { specifier } = extracted;\n\n if (specifier.startsWith(\"npm:\")) return { ...base, kind: \"npm\" };\n if (specifier.startsWith(\"jsr:\")) return { ...base, kind: \"jsr\" };\n if (specifier.startsWith(\"node:\")) return { ...base, kind: \"builtin\" };\n if (NODE_BUILTINS.has(specifier)) return { ...base, kind: \"builtin\" };\n if (isValTownUrl(specifier)) return { ...base, kind: \"val\" };\n if (/^https?:\\/\\//.test(specifier)) return { ...base, kind: \"url\" };\n if (!specifier.startsWith(\"./\") && !specifier.startsWith(\"../\")) {\n return { ...base, kind: \"npm\" };\n }\n\n const resolved = resolveLocal(importer, specifier, files);\n return resolved\n ? { ...base, resolved, kind: \"local\" }\n : { ...base, kind: \"unresolved\" };\n}\n\nfunction resolveLocal(\n importer: string,\n specifier: string,\n files: SourceMap,\n): string | undefined {\n const base = normalizePath(`${dirname(importer)}/${specifier}`);\n for (const extension of EXTENSIONS) {\n const candidate = `${base}${extension}`;\n if (Object.hasOwn(files, candidate)) return candidate;\n }\n for (const index of INDEXES) {\n const candidate = `${base}${index}`;\n if (Object.hasOwn(files, candidate)) return candidate;\n }\n return undefined;\n}\n\nfunction findCycles(modules: ModuleNode[]): string[][] {\n const moduleIds = new Set(modules.map(({ id }) => id));\n const graph = new Map(\n modules.map(({ id, dependencies }) => [\n id,\n dependencies\n .filter(({ kind, resolved }) =>\n kind === \"local\" && resolved && moduleIds.has(resolved)\n )\n .map(({ resolved }) => resolved as string),\n ]),\n );\n const cycles = new Set();\n const result: string[][] = [];\n\n for (const id of moduleIds) visit(id, [], new Set());\n\n function visit(id: string, stack: string[], seen: Set) {\n const stackIndex = stack.indexOf(id);\n if (stackIndex >= 0) {\n const cycle = stack.slice(stackIndex).concat(id);\n const key = canonicalCycleKey(cycle);\n if (!cycles.has(key)) {\n cycles.add(key);\n result.push(cycle);\n }\n return;\n }\n if (seen.has(id)) return;\n seen.add(id);\n for (const next of graph.get(id) ?? []) {\n visit(next, stack.concat(id), new Set(seen));\n }\n }\n\n return result;\n}\n\nfunction toMermaid(modules: ModuleNode[]): string {\n const lines = [\"graph TD\"];\n for (const module of modules) {\n if (module.dependencies.length === 0) {\n lines.push(` ${nodeId(module.id)}[${quoteLabel(module.id)}]`);\n }\n for (const dependency of module.dependencies) {\n const target = dependency.resolved ?? dependency.specifier;\n const arrow = dependency.dynamic ? \"-.->\" : \"-->\";\n lines.push(\n ` ${nodeId(module.id)}[${quoteLabel(module.id)}] ${arrow} ${\n nodeId(target)\n }[${quoteLabel(target)}]`,\n );\n }\n }\n return lines.join(\"\\n\");\n}\n\nfunction normalizeFileMap(files: SourceMap): SourceMap {\n return Object.fromEntries(\n Object.entries(files).map((\n [name, source],\n ) => [normalizePath(name), source]),\n );\n}\n\nfunction dirname(path: string): string {\n const normalized = normalizePath(path);\n const slashIndex = normalized.lastIndexOf(\"/\");\n return slashIndex === -1 ? \".\" : normalized.slice(0, slashIndex);\n}\n\nfunction normalizePath(path: string): string {\n const parts: string[] = [];\n for (const part of path.replaceAll(\"\\\\\", \"/\").split(\"/\")) {\n if (!part || part === \".\") continue;\n if (part === \"..\") parts.pop();\n else parts.push(part);\n }\n return parts.join(\"/\");\n}\n\nfunction isValTownUrl(specifier: string): boolean {\n return /^https:\\/\\/(esm\\.)?town\\/v\\//.test(specifier) ||\n /^https:\\/\\/www\\.val\\.town\\/v\\//.test(specifier);\n}\n\nfunction nodeId(value: string): string {\n return `n_${value.replace(/[^A-Za-z0-9_]/g, \"_\")}`;\n}\n\nfunction quoteLabel(value: string): string {\n return JSON.stringify(value).slice(1, -1).replaceAll('\"', \"#quot;\");\n}\n\nfunction uniqueBy(items: T[], keyFn: (item: T) => string): T[] {\n const seen = new Set();\n return items.filter((item) => {\n const key = keyFn(item);\n if (seen.has(key)) return false;\n seen.add(key);\n return true;\n });\n}\n\nfunction canonicalCycleKey(cycle: string[]): string {\n const body = cycle.slice(0, -1);\n const rotations = body.map((_, index) =>\n body.slice(index).concat(body.slice(0, index)).join(\"\\0\")\n );\n return rotations.sort()[0];\n}\n\nfunction jsonResponse(data: unknown, init?: ResponseInit): Response {\n return new Response(JSON.stringify(data, null, 2), {\n ...init,\n headers: {\n \"content-type\": \"application/json; charset=utf-8\",\n ...init?.headers,\n },\n });\n}\n\nfunction textResponse(text: string, init?: ResponseInit): Response {\n return new Response(text, {\n ...init,\n headers: {\n \"content-type\": \"text/plain; charset=utf-8\",\n ...init?.headers,\n },\n });\n}\n\nfunction mermaidHtmlResponse(mermaid: string): Response {\n return htmlResponse(`\n\n \n \n \n vt-dep Mermaid graph\n \n \n \n

vt-dep graph

${escapeHtml(mermaid)}

Mermaid source

${escapeHtml(mermaid)}

\n \n \n`);\n}\n\nfunction htmlResponse(html: string): Response {\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n}\n\nfunction isAnalyzeRequest(value: unknown): value is AnalyzeRequest {\n return Boolean(\n value &&\n typeof value === \"object\" &&\n \"files\" in value &&\n (value as AnalyzeRequest).files &&\n typeof (value as AnalyzeRequest).files === \"object\" &&\n Object.values((value as AnalyzeRequest).files).every((source) =>\n typeof source === \"string\"\n ),\n );\n}\n\nexport async function handleRequest(request: Request): Promise {\n const url = new URL(request.url);\n\n if (request.method === \"GET\" && url.pathname === \"/\") {\n return htmlResponse(homeHtml());\n }\n if (request.method === \"GET\" && url.pathname === \"/sample\") {\n return jsonResponse(sample);\n }\n if (request.method === \"GET\" && url.pathname === \"/sample/mermaid\") {\n return mermaidHtmlResponse(sample.mermaid);\n }\n if (request.method === \"GET\" && url.pathname === \"/sample/mermaid.txt\") {\n return textResponse(sample.mermaid);\n }\n\n if (\n request.method === \"POST\" &&\n (url.pathname === \"/analyze\" || url.pathname === \"/\")\n ) {\n let body: unknown;\n try {\n body = await request.json();\n } catch {\n return jsonResponse({\n error:\n \"Expected JSON body with shape { files: Record }\",\n }, { status: 400 });\n }\n if (!isAnalyzeRequest(body)) {\n return jsonResponse({\n error:\n \"Expected JSON body with shape { files: Record }\",\n }, { status: 400 });\n }\n return jsonResponse(analyzeVals(body.files));\n }\n\n return jsonResponse({ error: \"Not found\" }, { status: 404 });\n}\n\nfunction escapeHtml(value: string): string {\n return value\n .replaceAll(\"&\", \"&\")\n .replaceAll(\"<\", \"<\")\n .replaceAll(\">\", \">\")\n .replaceAll('\"', \""\")\n .replaceAll(\"'\", \"'\");\n}\n\nfunction homeHtml(): string {\n return `\n\n \n \n \n vt-dep\n \n \n \n

vt-dep

Val Town-native dependency analyzer for small JS/TS projects.

API

POST /analyze\ncontent-type: application/json\n\n{\n  \"files\": {\n    \"main.ts\": \"import { helper } from './helper.ts';\",\n    \"helper.ts\": \"export const helper = 1;\"\n  }\n}

Try /sample, /sample/mermaid, or /sample/mermaid.txt.

\n \n`;\n}\n\nexport default handleRequest;\n\nexport const sample = analyzeVals({\n \"main.tsx\": `\n import type { Helper } from \"./types.ts\";\n import { helper } from \"./helper.ts\" with { type: \"macro\" };\n import lodash from \"npm:lodash\";\n const dynamic = await import(\"./dynamic.ts\");\n\n @sealed\n class Demo {\n accessor value: Helper = helper;\n }\n\n export default

{lodash.camelCase(String(dynamic))}

;\n `,\n \"helper.ts\": `\n export { cycle } from \"./cycle\";\n export type { Helper } from \"./types.ts\";\n export const helper = 1;\n `,\n \"types.ts\": `\n export type Helper = number;\n `,\n \"cycle.ts\": `\n import \"./helper.ts\";\n export const cycle = true;\n `,\n \"dynamic.ts\": `\n import { email } from \"https://esm.town/v/chad/email\";\n export default email;\n `,\n});\n","createdAt",["D",1779166985972],"branchVersion","branchId","6d4f9684-532d-11f1-84c7-ee650bb23af1","id","6d4eea0e-532d-11f1-84c7-ee650bb23af1","vt-dep",["D",1779158999771],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Val Town-native dependency analyzer for small Val projects","imageUrl","c231b40c-c41d-4e59-83fb-00e3b1493b62","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","877241f0-f824-4e68-9f74-b02ddd9e130f","tursoName","6d4eea0e532d11f184c7ee650bb23af1","tursoHostname","6d4eea0e532d11f184c7ee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789515055826],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_105":101},"org",{"_98":97,"_99":-5,"_100":101,"_18":55,"_102":103,"_104":25},"branch",{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"isOwned",34,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","chadparker","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yTm10cGhQUklwU0tqZHNiOHNnNGd2ZjJURFUiLCJyaWQiOiJ1c2VyXzJjSWp4MTNLNjE0bkRqaEswZlhFOW9lRDRtQiIsImluaXRpYWxzIjoiQ1AifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":210,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":-5,"_57":25,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":65,"_66":67,"_68":211,"_70":-5,"_71":72,"_73":72,"_74":75,"_76":75,"_77":75,"_78":72,"_79":72,"_80":212,"_82":213,"_84":214,"_86":25},"tree",[180,182,183,184,185],"files",[180,181,182,183,184,185],"counts",{"_170":61,"_171":146,"_172":61,"_173":174,"_175":176},"contents",[129,130,131,132,133],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_43":163,"_32":164,"_30":165,"_135":-5,"_41":42,"_40":166,"_136":124,"_38":167,"_13":61,"_33":168,"_35":-5,"_24":25,"_139":-5,"_27":169},{"_43":156,"_32":157,"_30":158,"_135":-5,"_41":42,"_40":159,"_136":124,"_38":160,"_13":152,"_33":20,"_35":161,"_24":25,"_139":-5,"_27":162},{"_43":149,"_32":150,"_30":151,"_135":-5,"_41":42,"_40":152,"_136":124,"_38":153,"_13":61,"_33":20,"_35":154,"_24":25,"_139":-5,"_27":155},{"_43":141,"_32":142,"_30":143,"_135":-5,"_41":42,"_40":144,"_136":124,"_38":145,"_13":146,"_33":20,"_35":147,"_24":25,"_139":-5,"_27":148},{"_43":134,"_32":28,"_30":31,"_135":-5,"_41":42,"_40":14,"_136":25,"_38":137,"_13":138,"_33":34,"_35":37,"_24":25,"_139":-5,"_27":140},"05773a90-5340-11f1-9526-ee650bb23af1","parentId","latest",["D",1779166985972],5,"label",[28],"87ed3c64-5335-11f1-8884-ee650bb23af1","deno.lock","ac25d74e-5330-11f1-a1ae-ee650bb23af1",21,["D",1779162480383],1,"{\n \"version\": \"5\",\n \"specifiers\": {\n \"npm:@babel/parser@*\": \"7.29.3\",\n \"npm:@babel/traverse@*\": \"7.29.0\",\n \"npm:@valtown/sdk@1.9.0\": \"1.9.0\",\n \"npm:badge-maker@*\": \"5.0.2\",\n \"npm:hono@4.11.9\": \"4.11.9\",\n \"npm:mime-types@2.1.35\": \"2.1.35\",\n \"npm:preact-render-to-string@*\": \"6.7.0_preact@10.29.2\",\n \"npm:preact@*\": \"10.29.2\",\n \"npm:pretty-ms@*\": \"9.3.0\"\n },\n \"npm\": {\n \"@babel/code-frame@7.29.0\": {\n \"integrity\": \"sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==\",\n \"dependencies\": [\n \"@babel/helper-validator-identifier\",\n \"js-tokens\",\n \"picocolors\"\n ]\n },\n \"@babel/generator@7.29.1\": {\n \"integrity\": \"sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==\",\n \"dependencies\": [\n \"@babel/parser\",\n \"@babel/types\",\n \"@jridgewell/gen-mapping\",\n \"@jridgewell/trace-mapping\",\n \"jsesc\"\n ]\n },\n \"@babel/helper-globals@7.28.0\": {\n \"integrity\": \"sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==\"\n },\n \"@babel/helper-string-parser@7.27.1\": {\n \"integrity\": \"sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==\"\n },\n \"@babel/helper-validator-identifier@7.28.5\": {\n \"integrity\": \"sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==\"\n },\n \"@babel/parser@7.29.3\": {\n \"integrity\": \"sha512-b3ctpQwp+PROvU/cttc4OYl4MzfJUWy6FZg+PMXfzmt/+39iHVF0sDfqay8TQM3JA2EUOyKcFZt75jWriQijsA==\",\n \"dependencies\": [\n \"@babel/types\"\n ],\n \"bin\": true\n },\n \"@babel/template@7.28.6\": {\n \"integrity\": \"sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==\",\n \"dependencies\": [\n \"@babel/code-frame\",\n \"@babel/parser\",\n \"@babel/types\"\n ]\n },\n \"@babel/traverse@7.29.0\": {\n \"integrity\": \"sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==\",\n \"dependencies\": [\n \"@babel/code-frame\",\n \"@babel/generator\",\n \"@babel/helper-globals\",\n \"@babel/parser\",\n \"@babel/template\",\n \"@babel/types\",\n \"debug\"\n ]\n },\n \"@babel/types@7.29.0\": {\n \"integrity\": \"sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==\",\n \"dependencies\": [\n \"@babel/helper-string-parser\",\n \"@babel/helper-validator-identifier\"\n ]\n },\n \"@jridgewell/gen-mapping@0.3.13\": {\n \"integrity\": \"sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==\",\n \"dependencies\": [\n \"@jridgewell/sourcemap-codec\",\n \"@jridgewell/trace-mapping\"\n ]\n },\n \"@jridgewell/resolve-uri@3.1.2\": {\n \"integrity\": \"sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==\"\n },\n \"@jridgewell/sourcemap-codec@1.5.5\": {\n \"integrity\": \"sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==\"\n },\n \"@jridgewell/trace-mapping@0.3.31\": {\n \"integrity\": \"sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==\",\n \"dependencies\": [\n \"@jridgewell/resolve-uri\",\n \"@jridgewell/sourcemap-codec\"\n ]\n },\n \"@types/node-fetch@2.6.13\": {\n \"integrity\": \"sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==\",\n \"dependencies\": [\n \"@types/node\",\n \"form-data\"\n ]\n },\n \"@types/node@18.19.130\": {\n \"integrity\": \"sha512-GRaXQx6jGfL8sKfaIDD6OupbIHBr9jv7Jnaml9tB7l4v068PAOXqfcujMMo5PhbIs6ggR1XODELqahT2R8v0fg==\",\n \"dependencies\": [\n \"undici-types\"\n ]\n },\n \"@valtown/sdk@1.9.0\": {\n \"integrity\": \"sha512-xV8B02a+IJZYkxMk7CVS5hcNjyJ2XhZvJ3iXxqaILVbNsaq9BCAzSvYS+GteaFxG0OO9YiWSSNh68047o+Rk+g==\",\n \"dependencies\": [\n \"@types/node\",\n \"@types/node-fetch\",\n \"abort-controller\",\n \"agentkeepalive\",\n \"form-data-encoder\",\n \"formdata-node\",\n \"node-fetch\"\n ]\n },\n \"abort-controller@3.0.0\": {\n \"integrity\": \"sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==\",\n \"dependencies\": [\n \"event-target-shim\"\n ]\n },\n \"agentkeepalive@4.6.0\": {\n \"integrity\": \"sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ==\",\n \"dependencies\": [\n \"humanize-ms\"\n ]\n },\n \"anafanafo@2.0.0\": {\n \"integrity\": \"sha512-Nlfq7NC4AOkTJerWRIZcOAiMNtIDVIGWGvQ98O7Jl6Kr2Dk0dX5u4MqN778kSRTy5KRqchpLdF2RtLFEz9FVkQ==\",\n \"dependencies\": [\n \"char-width-table-consumer\"\n ]\n },\n \"asynckit@0.4.0\": {\n \"integrity\": \"sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==\"\n },\n \"badge-maker@5.0.2\": {\n \"integrity\": \"sha512-Xd3YUmKPEShQcn6PFB03Wxq0RNJRFwVVroyRz0qIjSXwniYUGsGWNHqtNsQYi/Sbs8Ni7qAEf7LKgDOtcAoCDg==\",\n \"dependencies\": [\n \"anafanafo\",\n \"css-color-converter\"\n ],\n \"bin\": true\n },\n \"binary-search@1.3.6\": {\n \"integrity\": \"sha512-nbE1WxOTTrUWIfsfZ4aHGYu5DOuNkbxGokjV6Z2kxfJK3uaAb8zNK1muzOeipoLHZjInT4Br88BHpzevc681xA==\"\n },\n \"call-bind-apply-helpers@1.0.2\": {\n \"integrity\": \"sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==\",\n \"dependencies\": [\n \"es-errors\",\n \"function-bind\"\n ]\n },\n \"char-width-table-consumer@1.0.0\": {\n \"integrity\": \"sha512-Fz4UD0LBpxPgL9i29CJ5O4KANwaMnX/OhhbxzvNa332h+9+nRKyeuLw4wA51lt/ex67+/AdsoBQJF3kgX2feYQ==\",\n \"dependencies\": [\n \"binary-search\"\n ]\n },\n \"color-convert@0.5.3\": {\n \"integrity\": \"sha512-RwBeO/B/vZR3dfKL1ye/vx8MHZ40ugzpyfeVG5GsiuGnrlMWe2o8wxBbLCpw9CsxV+wHuzYlCiWnybrIA0ling==\"\n },\n \"color-name@1.1.4\": {\n \"integrity\": \"sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==\"\n },\n \"combined-stream@1.0.8\": {\n \"integrity\": \"sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==\",\n \"dependencies\": [\n \"delayed-stream\"\n ]\n },\n \"css-color-converter@2.0.0\": {\n \"integrity\": \"sha512-oLIG2soZz3wcC3aAl/7Us5RS8Hvvc6I8G8LniF/qfMmrm7fIKQ8RIDDRZeKyGL2SrWfNqYspuLShbnjBMVWm8g==\",\n \"dependencies\": [\n \"color-convert\",\n \"color-name\",\n \"css-unit-converter\"\n ]\n },\n \"css-unit-converter@1.1.2\": {\n \"integrity\": \"sha512-IiJwMC8rdZE0+xiEZHeru6YoONC4rfPMqGm2W85jMIbkFvv5nFTwJVFHam2eFrN6txmoUYFAFXiv8ICVeTO0MA==\"\n },\n \"debug@4.4.3\": {\n \"integrity\": \"sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==\",\n \"dependencies\": [\n \"ms\"\n ]\n },\n \"delayed-stream@1.0.0\": {\n \"integrity\": \"sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==\"\n },\n \"dunder-proto@1.0.1\": {\n \"integrity\": \"sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==\",\n \"dependencies\": [\n \"call-bind-apply-helpers\",\n \"es-errors\",\n \"gopd\"\n ]\n },\n \"es-define-property@1.0.1\": {\n \"integrity\": \"sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==\"\n },\n \"es-errors@1.3.0\": {\n \"integrity\": \"sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==\"\n },\n \"es-object-atoms@1.1.1\": {\n \"integrity\": \"sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==\",\n \"dependencies\": [\n \"es-errors\"\n ]\n },\n \"es-set-tostringtag@2.1.0\": {\n \"integrity\": \"sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==\",\n \"dependencies\": [\n \"es-errors\",\n \"get-intrinsic\",\n \"has-tostringtag\",\n \"hasown\"\n ]\n },\n \"event-target-shim@5.0.1\": {\n \"integrity\": \"sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==\"\n },\n \"form-data-encoder@1.7.2\": {\n \"integrity\": \"sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A==\"\n },\n \"form-data@4.0.5\": {\n \"integrity\": \"sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==\",\n \"dependencies\": [\n \"asynckit\",\n \"combined-stream\",\n \"es-set-tostringtag\",\n \"hasown\",\n \"mime-types\"\n ]\n },\n \"formdata-node@4.4.1\": {\n \"integrity\": \"sha512-0iirZp3uVDjVGt9p49aTaqjk84TrglENEDuqfdlZQ1roC9CWlPk6Avf8EEnZNcAqPonwkG35x4n3ww/1THYAeQ==\",\n \"dependencies\": [\n \"node-domexception\",\n \"web-streams-polyfill\"\n ]\n },\n \"function-bind@1.1.2\": {\n \"integrity\": \"sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==\"\n },\n \"get-intrinsic@1.3.0\": {\n \"integrity\": \"sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==\",\n \"dependencies\": [\n \"call-bind-apply-helpers\",\n \"es-define-property\",\n \"es-errors\",\n \"es-object-atoms\",\n \"function-bind\",\n \"get-proto\",\n \"gopd\",\n \"has-symbols\",\n \"hasown\",\n \"math-intrinsics\"\n ]\n },\n \"get-proto@1.0.1\": {\n \"integrity\": \"sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==\",\n \"dependencies\": [\n \"dunder-proto\",\n \"es-object-atoms\"\n ]\n },\n \"gopd@1.2.0\": {\n \"integrity\": \"sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==\"\n },\n \"has-symbols@1.1.0\": {\n \"integrity\": \"sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==\"\n },\n \"has-tostringtag@1.0.2\": {\n \"integrity\": \"sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==\",\n \"dependencies\": [\n \"has-symbols\"\n ]\n },\n \"hasown@2.0.3\": {\n \"integrity\": \"sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==\",\n \"dependencies\": [\n \"function-bind\"\n ]\n },\n \"hono@4.11.9\": {\n \"integrity\": \"sha512-Eaw2YTGM6WOxA6CXbckaEvslr2Ne4NFsKrvc0v97JD5awbmeBLO5w9Ho9L9kmKonrwF9RJlW6BxT1PVv/agBHQ==\"\n },\n \"humanize-ms@1.2.1\": {\n \"integrity\": \"sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ==\",\n \"dependencies\": [\n \"ms\"\n ]\n },\n \"js-tokens@4.0.0\": {\n \"integrity\": \"sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==\"\n },\n \"jsesc@3.1.0\": {\n \"integrity\": \"sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==\",\n \"bin\": true\n },\n \"math-intrinsics@1.1.0\": {\n \"integrity\": \"sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==\"\n },\n \"mime-db@1.52.0\": {\n \"integrity\": \"sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==\"\n },\n \"mime-types@2.1.35\": {\n \"integrity\": \"sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==\",\n \"dependencies\": [\n \"mime-db\"\n ]\n },\n \"ms@2.1.3\": {\n \"integrity\": \"sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==\"\n },\n \"node-domexception@1.0.0\": {\n \"integrity\": \"sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==\",\n \"deprecated\": true\n },\n \"node-fetch@2.7.0\": {\n \"integrity\": \"sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==\",\n \"dependencies\": [\n \"whatwg-url\"\n ]\n },\n \"parse-ms@4.0.0\": {\n \"integrity\": \"sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw==\"\n },\n \"picocolors@1.1.1\": {\n \"integrity\": \"sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==\"\n },\n \"preact-render-to-string@6.7.0_preact@10.29.2\": {\n \"integrity\": \"sha512-Z4WR8fmLMRpdYqJ9i7vrlXSsSrxVJydwrkEXHapexfARbWfGb7vGcnvNQnIzN0cXciMVOlz/XLoiMCi9gUsy9Q==\",\n \"dependencies\": [\n \"preact\"\n ]\n },\n \"preact@10.29.2\": {\n \"integrity\": \"sha512-7tNmwg/7mzzAoB/8kSg6Hl37JraAZw3Z3A0JSY7VXlZwo82Xn0G7wKbNNs2qoF4ZEEsQGTwDAroNdqKs1ofJxQ==\"\n },\n \"pretty-ms@9.3.0\": {\n \"integrity\": \"sha512-gjVS5hOP+M3wMm5nmNOucbIrqudzs9v/57bWRHQWLYklXqoXKrVfYW2W9+glfGsqtPgpiz5WwyEEB+ksXIx3gQ==\",\n \"dependencies\": [\n \"parse-ms\"\n ]\n },\n \"tr46@0.0.3\": {\n \"integrity\": \"sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==\"\n },\n \"undici-types@5.26.5\": {\n \"integrity\": \"sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==\"\n },\n \"web-streams-polyfill@4.0.0-beta.3\": {\n \"integrity\": \"sha512-QW95TCTaHmsYfHDybGMwO5IJIM93I/6vTRk+daHTWFPhwh+C8Cg7j7XyKrwrj8Ib6vYXe0ocYNrmzY4xAAN6ug==\"\n },\n \"webidl-conversions@3.0.1\": {\n \"integrity\": \"sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==\"\n },\n \"whatwg-url@5.0.0\": {\n \"integrity\": \"sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==\",\n \"dependencies\": [\n \"tr46\",\n \"webidl-conversions\"\n ]\n }\n },\n \"redirects\": {\n \"https://esm.town/v/std/API_URL\": \"https://esm.town/v/std/API_URL?v=5\",\n \"https://esm.town/v/std/utils/index.ts\": \"https://esm.town/v/std/utils@257-main/index.ts\"\n },\n \"remote\": {\n \"https://esm.town/v/std/API_URL?v=5\": \"46109f905a50e32281d3ffbe7b9c8209a778290c5274d83d131fba2d26c4974d\",\n \"https://esm.town/v/std/utils@105-main/parseImportMeta/project.ts\": \"1ebbe08847a68e921c988511b0ad1d0f18ead83d9b755503e6b4787d443bb2db\",\n \"https://esm.town/v/std/utils@257-main/file.ts\": \"b1694c5e9316e6f0b2bc18ebf39ed174f1d5cb03f06b34bfdfd8f65892ca614a\",\n \"https://esm.town/v/std/utils@257-main/hot-reload.ts\": \"018b27b330183912946b40839297aa13aecf042f12d3ca1bc59bff195e56a2f1\",\n \"https://esm.town/v/std/utils@257-main/index.ts\": \"4bbe68ecfe3a9f8e2940fcca3c74c22bc782f0eeb1bca65a62e88045d44b4f11\",\n \"https://esm.town/v/std/utils@257-main/is-main.ts\": \"7427331557b36ff63263c6830672bcd42093325aa253c46c1a98d3cb467533ed\",\n \"https://esm.town/v/std/utils@257-main/parseImportMeta.ts\": \"573f43f595991e6c3a6044653dfe10168cb70679ff073ab4bf1e5d72d02ae202\",\n \"https://esm.town/v/std/utils@257-main/serve-file.ts\": \"bfb81621bb2dcf7951720973749cfb377134ccc60b2187c68242f4b2a6af3c6e\",\n \"https://esm.town/v/std/utils@257-main/static.tsx\": \"ab80587e6ce23efdbe7b59dfa4d314c82fa2357697af884e011d9d0232b976c0\",\n \"https://esm.town/v/std/utils@257-main/test.tsx\": \"4f88c9f426f54a43fd40269dc0f7b35f54bfbb5804fa4dfc877ce8a385a135ad\"\n }\n}\n",[142],"ac29fe3c-5330-11f1-a906-ee650bb23af1","deno.json","ac29ff68-5330-11f1-a906-ee650bb23af1",3,["D",1779160393708],"{\n \"compilerOptions\": {\n \"lib\": [\"deno.ns\", \"dom\", \"esnext\"],\n \"strict\": true\n }\n}\n",[150],"a481c91c-5335-11f1-b941-ee650bb23af1","README.md","6dc04424-532d-11f1-b320-ee650bb23af1",22,["D",1779162528339],"# Val Dependency Cruiser\n\nA small Val Town-native dependency analyzer inspired by\n[`dependency-cruiser`](https://github.com/sverweij/dependency-cruiser), focused\non reading and visualizing dependencies between Vals and small Val Town\nprojects.\n\n## Goal\n\nRun as a Val that can read source for other Vals/projects, extract their\nimports, and produce a useful dependency graph plus a few simple checks.\n\nThis is **not** intended to port all of dependency-cruiser. Full\ndependency-cruiser assumes a local Node project with filesystem crawling,\n`node_modules`, package manifests, config loading, caches, and subprocess-based\ngraph rendering. Val Town projects are smaller and can use a simpler analyzer.\n\n## HTTP endpoint\n\nCurrent endpoint:\n\n```text\nhttps://chadparker--87d29e86533511f18884ee650bb23af1.web.val.run\n```\n\nThis endpoint is provided by `api.http.ts`, which re-exports the handler from\n`main.http.ts`.\n\n## Current API\n\nThe Val exports `analyzeVals(files)` for direct use and also exposes an HTTP\nhandler.\n\n```ts\nimport { analyzeVals } from \"https://esm.town/v/chad/vt_dep\";\n\nconst result = analyzeVals({\n \"main.http.ts\": `import { helper } from \"./helper.ts\";`,\n \"helper.ts\": `export const helper = 1;`,\n});\n```\n\nHTTP:\n\n```http\nPOST /analyze\ncontent-type: application/json\n\n{\n \"files\": {\n \"main.http.ts\": \"import { helper } from './helper.ts';\",\n \"helper.ts\": \"export const helper = 1;\"\n }\n}\n```\n\nOutput:\n\n- dependency graph as JSON\n- detected cycles\n- unresolved imports\n- parse errors\n- external dependencies grouped by type\n- Mermaid graph text for quick visualization\n\nTry:\n\n- `/sample` for example JSON\n- `/sample/mermaid` for example Mermaid output\n\nExample API shape:\n\n```ts\ntype SourceMap = Record;\n\ntype DependencyKind =\n | \"local\"\n | \"val\"\n | \"npm\"\n | \"jsr\"\n | \"url\"\n | \"builtin\"\n | \"unresolved\";\n\ntype Dependency = {\n specifier: string;\n resolved?: string;\n kind: DependencyKind;\n dynamic: boolean;\n};\n\ntype ModuleNode = {\n id: string;\n dependencies: Dependency[];\n};\n\ntype AnalysisResult = {\n modules: ModuleNode[];\n cycles: string[][];\n unresolved: Dependency[];\n externals: Dependency[];\n mermaid: string;\n};\n\nexport async function analyzeVals(files: SourceMap): Promise;\n```\n\n## Import forms to support first\n\nStatic ES modules:\n\n```ts\nimport x from \"./foo.ts\";\nimport { helper } from \"https://esm.town/v/chad/helper\";\nexport { thing } from \"./thing.ts\";\n```\n\nDynamic imports:\n\n```ts\nconst mod = await import(\"./mod.ts\");\n```\n\nBasic CommonJS, if encountered:\n\n```ts\nconst lodash = require(\"npm:lodash\");\n```\n\n## Dependency classification\n\n- `local` — relative project import like `./foo.ts` or `../lib/bar.ts`\n- `val` — Val Town URL/import like `https://esm.town/v/user/valName`\n- `npm` — `npm:package` or bare npm package imports if Val Town\n allows/normalizes them\n- `jsr` — `jsr:@scope/package`\n- `url` — other `http:`/`https:` imports\n- `builtin` — `node:fs`, `node:path`, etc.\n- `unresolved` — local-looking import that does not match known files\n\n## Likely implementation\n\nUse parser-level extraction instead of regexes.\n\nPotential libraries:\n\n- `npm:acorn`\n- `npm:acorn-walk`\n- `npm:acorn-jsx` if JSX is needed\n- Possibly `npm:@typescript-eslint/typescript-estree` or `npm:oxc-parser` later\n for better TypeScript support\n\nInitial extraction can be small:\n\n1. Parse source as module, falling back to loose/script mode if needed.\n2. Walk AST.\n3. Collect:\n - `ImportDeclaration`\n - `ExportNamedDeclaration.source`\n - `ExportAllDeclaration.source`\n - `ImportExpression` with string literal source\n - `CallExpression` where callee is `require` and first arg is a string\n literal\n4. Resolve/classify each specifier.\n5. Build adjacency list.\n6. Run DFS/Tarjan to find cycles.\n7. Emit Mermaid.\n\n## Resolution rules for MVP\n\nGiven `files: Record`:\n\n- Normalize module ids to POSIX-style paths.\n- For relative imports, resolve from importer directory.\n- Try exact match first.\n- Then try common extensions: `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs`.\n- Then try `/index.ts`, `/index.tsx`, `/index.js`, etc.\n- Non-relative imports are classified as external unless they match a Val Town\n URL.\n\n## Example Mermaid output\n\n```mermaid\ngraph TD\n main_ts[main.http.ts] --> helper_ts[helper.ts]\n main_ts --> npm_lodash[npm:lodash]\n helper_ts --> val_chad_util[esm.town/v/chad/util]\n```\n\n## Later features\n\n- Fetch files from Val Town APIs directly.\n- Analyze one Val, a folder/project, or a user namespace.\n- HTML response with interactive graph.\n- Rule checks:\n - no cycles\n - no unresolved imports\n - no private/external Val imports\n - no npm imports outside allowlist\n - no imports from specific users/namespaces\n- `focus` mode: show only neighbors around one Val/file.\n- Diff mode: compare dependency graph between two versions.\n- Export dependency-cruiser-like JSON for compatibility with other tools.\n\n## Estimated effort\n\n- MVP analyzer: 1–2 days\n- Useful Val Town integration and nicer output: 3–5 days\n- Rule system and richer reporting: 1–2 weeks\n\n## Open questions\n\n- Which Val Town API endpoint should this use to read another Val/project's\n source?\n- Should this analyze only the current user's Vals or public Vals too?\n- Should output be a JSON API, an HTML page, or both?\n- Should the Val store historical graphs for diffs?\n",[157],"96e80ce6-533d-11f1-8c90-ee650bb23af1",".chisel","96e80da4-533d-11f1-8c90-ee650bb23af1",23,["D",1779165941491],"directory",[164],"pulls","branches","forks","envVars",{"_177":61,"_179":61},"connections",{"_177":61,"_178":61},"count","unfilledCount","emptyCount",{"_43":163,"_32":164,"_30":165,"_135":-5,"_41":42,"_40":166,"_136":124,"_38":207,"_13":61,"_33":168,"_35":-5,"_24":25,"_139":-5,"_187":208,"_27":209},{"_43":199,"_32":200,"_30":201,"_135":165,"_41":42,"_40":202,"_136":25,"_38":203,"_13":61,"_33":20,"_35":204,"_24":25,"_139":-5,"_187":205,"_27":206},{"_43":156,"_32":157,"_30":158,"_135":-5,"_41":42,"_40":159,"_136":124,"_38":196,"_13":152,"_33":20,"_35":161,"_24":25,"_139":-5,"_187":197,"_27":198},{"_43":149,"_32":150,"_30":151,"_135":-5,"_41":42,"_40":152,"_136":124,"_38":193,"_13":61,"_33":20,"_35":154,"_24":25,"_139":-5,"_187":194,"_27":195},{"_43":141,"_32":142,"_30":143,"_135":-5,"_41":42,"_40":144,"_136":124,"_38":190,"_13":146,"_33":20,"_35":147,"_24":25,"_139":-5,"_187":191,"_27":192},{"_43":134,"_32":28,"_30":31,"_135":-5,"_41":42,"_40":14,"_136":25,"_38":186,"_13":138,"_33":34,"_35":37,"_24":25,"_139":-5,"_187":188,"_27":189},["D",1779166985972],"children",[],[28],["D",1779162480383],[],[142],["D",1779160393708],[],[150],["D",1779162528339],[],[157],"9715a656-533d-11f1-b274-ee650bb23af1","file-metadata.json","9715a732-533d-11f1-b274-ee650bb23af1",24,["D",1779165941790],"{\n \"schemaVersion\": 1,\n \"updatedAt\": \"2026-05-19T04:45:41.201Z\",\n \"files\": {\n \"87d29e86-5335-11f1-8884-ee650bb23af1\": {\n \"fileId\": \"87d29e86-5335-11f1-8884-ee650bb23af1\",\n \"path\": \"api.http.ts\",\n \"name\": \"api.http.ts\",\n \"type\": \"http\",\n \"fileVersion\": 20,\n \"fileUpdatedAt\": \"2026-05-19T03:48:00.220Z\",\n \"contentHash\": \"33657875976dbc197de59cb55220a790685c7fd42949f503ee1287d4e496518e\",\n \"language\": \"TypeScript\",\n \"lines\": 2,\n \"summary\": {\n \"model\": \"openai/gpt-oss-20b\",\n \"promptHash\": \"7de726a21367c28fa0c8c3f743ae5044652ca6163fb74026fd3a0b7c8880d4ec\",\n \"generatedAt\": \"2026-05-19T04:45:41.200Z\",\n \"markdown\": \"Re‑exports the default export from `main.http.ts`. \\n\\n**Outline** \\n- Export default from \\\"./main.http.ts\\\"\"\n }\n }\n }\n}",[],[164,200],["D",1779165941491],[181],[164],["D",1779158999771],["D",1789515055826],{"_98":97,"_105":101},{"_98":97,"_99":-5,"_100":101,"_18":55,"_102":103,"_104":25},{"_13":87,"_32":88,"_43":42,"_89":44,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":45,"_96":97},"ctx",{"_80":-5,"_126":248,"_249":250,"_251":252,"_253":25,"_254":25,"_255":25,"_256":124,"_257":-5,"_258":-7,"_259":-7,"_260":61,"_261":25,"_262":25,"_263":-5,"_264":25,"_265":25,"_266":25,"_267":-5},"ENV",{"_219":220,"_221":222,"_223":88,"_224":225,"_226":227,"_228":229,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243,"_244":245,"_246":247},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v28