[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_204":205,"_206":207},"routes/_app.x.$handle.$name",{"_105":104,"_33":51,"_113":95,"_28":114,"_13":14,"_115":-5,"_11":116,"_117":118,"_119":120,"_121":122,"_123":124,"_21":-5,"_125":-5,"_126":-5,"_127":55,"_128":129,"_130":55,"_131":-5,"_132":-5,"_133":134},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_49":50,"_33":51,"_38":52,"_53":-5,"_54":55,"_56":57,"_58":57,"_59":60,"_61":-5,"_18":62,"_63":-5,"_64":55,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":79,"_80":79,"_81":82,"_83":82,"_84":82,"_85":79,"_86":79,"_87":88,"_89":90,"_91":92,"_93":55},"version",18,"changes",[19,20],"aiChatInfo","userId",{"_21":43,"_23":44,"_25":26,"_27":26,"_28":45,"_30":45},{"_21":22,"_23":24,"_25":26,"_27":26,"_28":29,"_30":29},"file",{"_31":32,"_33":34,"_35":21,"_36":37,"_38":39,"_40":14,"_41":42,"_25":26},"previous",{"_31":32,"_33":34,"_35":21,"_36":37},"deleted",true,"deletedHere","path",".chisel/file-metadata.json","latestPath","fileId","e75f82ee-5333-11f1-abb4-ee650bb23af1","name","file-metadata.json","fileType","content","{\n \"schemaVersion\": 1,\n \"updatedAt\": \"2026-05-19T03:36:56.589Z\",\n \"files\": {\n \"ac29ff68-5330-11f1-a906-ee650bb23af1\": {\n \"fileId\": \"ac29ff68-5330-11f1-a906-ee650bb23af1\",\n \"path\": \"deno.json\",\n \"name\": \"deno.json\",\n \"type\": \"file\",\n \"fileVersion\": 3,\n \"fileUpdatedAt\": \"2026-05-19T03:13:13.708Z\",\n \"contentHash\": \"178d964a5a0490e780eba0d852a59c9998d5377f3efd9036ccd4062205f7346d\",\n \"language\": \"JSON\",\n \"lines\": 7,\n \"summary\": {\n \"model\": \"openai/gpt-oss-20b\",\n \"promptHash\": \"7de726a21367c28fa0c8c3f743ae5044652ca6163fb74026fd3a0b7c8880d4ec\",\n \"generatedAt\": \"2026-05-19T03:36:20.734Z\",\n \"markdown\": \"Specifies Deno TypeScript compiler options with strict mode and a set of libraries. \\n\\n**Outline**\\n\\n- compilerOptions \\n - lib: [\\\"deno.ns\\\", \\\"dom\\\", \\\"esnext\\\"] \\n - strict: true\"\n }\n },\n \"ac25d74e-5330-11f1-a1ae-ee650bb23af1\": {\n \"fileId\": \"ac25d74e-5330-11f1-a1ae-ee650bb23af1\",\n \"path\": \"deno.lock\",\n \"name\": \"deno.lock\",\n \"type\": \"file\",\n \"fileVersion\": 2,\n \"fileUpdatedAt\": \"2026-05-19T03:13:13.679Z\",\n \"contentHash\": \"f051a711ac330e503a5785dba8770954e0f16b9a6c9ce29c368b494fe441c76d\",\n \"language\": \"LOCK\",\n \"lines\": 110,\n \"summary\": {\n \"model\": \"openai/gpt-oss-20b\",\n \"promptHash\": \"7de726a21367c28fa0c8c3f743ae5044652ca6163fb74026fd3a0b7c8880d4ec\",\n \"generatedAt\": \"2026-05-19T03:36:33.144Z\",\n \"markdown\": \"**Summary** \\nA Deno lockfile that records the exact npm package versions, their integrity hashes, and dependency relationships for a project.\\n\\n**Structure Outline** \\n- root object \\n - `version` \\n - `specifiers` \\n - `npm:@babel/parser@*` → `7.29.3` \\n - `npm:@babel/traverse@*` → `7.29.0` \\n - `npm` \\n - `@babel/code-frame@7.29.0` \\n - `integrity` \\n - `dependencies` \\n - `@babel/helper-validator-identifier` \\n - `js-tokens` \\n - `picocolors` \\n - `@babel/generator@7.29.1` \\n - `integrity` \\n - `dependencies` \\n - `@babel/parser` \\n - `@babel/types` \\n - `@jridgewell/gen-mapping` \\n - `@jridgewell/trace-mapping` \\n - `jsesc` \\n - `@babel/helper-globals@7.28.0` \\n - `integrity` \\n - `@babel/helper-string-parser@7.27.1` \\n - `integrity` \\n - `@babel/helper-validator-identifier@7.28.5` \\n - `integrity` \\n - `@babel/parser@7.29.3` \\n - `integrity` \\n - `dependencies` \\n - `@babel/types` \\n - `bin` \\n - `@babel/template@7.28.6` \\n - `integrity` \\n - `dependencies` \\n - `@babel/code-frame` \\n - `@babel/parser` \\n - `@babel/types` \\n - `@babel/traverse@7.29.0` \\n - `integrity` \\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 - `@babel/types@7.29.0` \\n - `integrity` \\n - `dependencies` \\n - `@babel/helper-string-parser` \\n - `@babel/helper-validator-identifier` \\n - `@jridgewell/gen-mapping@0.3.13` \\n - `integrity` \\n - `dependencies` \\n - `@jridgewell/sourcemap-codec` \\n - `@jridgewell/trace-mapping` \\n - `@jridgewell/resolve-uri@3.1.2` \\n - `integrity` \\n - `@jridgewell/sourcemap-codec@1.5.5` \\n - `integrity` \\n - `@jridgewell/trace-mapping@0.3.31` \\n - `integrity` \\n - `dependencies` \\n - `@jridgewell/resolve-uri` \\n - `@jridgewell/sourcemap-codec` \\n - `debug@4.4.3` \\n - `integrity` \\n - `dependencies` \\n - `ms` \\n - `js-tokens@4.0.0` \\n - `integrity` \\n - `jsesc@3.1.0` \\n - `integrity` \\n - `bin` \\n - `ms@2.1.3` \\n - `integrity` \\n - `picocolors@1.1.1` \\n - `integrity`\"\n }\n },\n \"6dc04424-532d-11f1-b320-ee650bb23af1\": {\n \"fileId\": \"6dc04424-532d-11f1-b320-ee650bb23af1\",\n \"path\": \"README.md\",\n \"name\": \"README.md\",\n \"type\": \"file\",\n \"fileVersion\": 8,\n \"fileUpdatedAt\": \"2026-05-19T03:34:14.473Z\",\n \"contentHash\": \"a91780a3de113d1b84ce707749cc4759785b4a559cc0407b66a2edf444361bcc\",\n \"language\": \"Markdown\",\n \"lines\": 207,\n \"summary\": {\n \"model\": \"openai/gpt-oss-20b\",\n \"promptHash\": \"7de726a21367c28fa0c8c3f743ae5044652ca6163fb74026fd3a0b7c8880d4ec\",\n \"generatedAt\": \"2026-05-19T03:36:36.015Z\",\n \"markdown\": \"**Summary** \\nThis README documents Val Dependency Cruiser, a lightweight dependency analyzer for Val Town projects, outlining its API, implementation strategy, feature roadmap, and open questions.\\n\\n**Outline** \\n- Val Dependency Cruiser \\n- Intro: small Val‑Town‑native dependency analyzer inspired by dependency‑cruiser \\n- Goal: read other Vals’ source, extract imports, output graph & checks \\n- Current API \\n - `analyzeVals(files)` function \\n - HTTP POST /analyze handler \\n - API shape (SourceMap, DependencyKind, Dependency, ModuleNode, AnalysisResult) \\n - Example usage snippets \\n- Import forms to support first \\n - Static ES modules \\n - Dynamic imports (`import()` syntax) \\n - Basic CommonJS (`require`) \\n- Dependency classification \\n - local, val, npm, jsr, url, builtin, unresolved \\n- Likely implementation \\n - Parser‑level extraction (acorn, acorn‑walk, etc.) \\n - AST walk: ImportDeclaration, ExportNamedDeclaration, ExportAllDeclaration, ImportExpression, CallExpression(`require`) \\n - Resolve/classify specifiers \\n - Build adjacency list \\n - Cycle detection (DFS/Tarjan) \\n - Emit Mermaid graph \\n- Resolution rules for MVP \\n - Normalize module IDs, resolve relative imports, try extensions, index files, external classification \\n- Example Mermaid output \\n- Later features \\n - Fetch from Val Town APIs, analyze projects, HTML graph, rule checks, focus/diff mode, export JSON \\n- Estimated effort \\n - MVP analyzer 1–2 days \\n - Integration 3–5 days \\n - Rules/reporting 1–2 weeks \\n- Open questions \\n - Which Val Town API to use for source? \\n - Scope of analysis (private vs public Vals) \\n - Output format (JSON, HTML, or both) \\n - Storing historical graphs for diffs\"\n }\n },\n \"ac2fe5cc-5330-11f1-9c84-ee650bb23af1\": {\n \"fileId\": \"ac2fe5cc-5330-11f1-9c84-ee650bb23af1\",\n \"path\": \"main.ts\",\n \"name\": \"main.ts\",\n \"type\": \"script\",\n \"fileVersion\": 10,\n \"fileUpdatedAt\": \"2026-05-19T03:34:14.473Z\",\n \"contentHash\": \"60001b4f4cb2766649a89edd92286cff1da1e0cc82043ebb3f87e6c3114eafba\",\n \"language\": \"TypeScript\",\n \"lines\": 475,\n \"summary\": {\n \"model\": \"openai/gpt-oss-20b\",\n \"promptHash\": \"7de726a21367c28fa0c8c3f743ae5044652ca6163fb74026fd3a0b7c8880d4ec\",\n \"generatedAt\": \"2026-05-19T03:36:56.589Z\",\n \"markdown\": \"**Summary** \\nThis file implements a Val‑Town‑native dependency analyzer: it parses JS/TS source, extracts import/export specifiers, resolves local and external dependencies (npm, jsr, URLs, built‑ins), detects circular imports, produces a Mermaid graph, and exposes an HTTP API for analysis.\\n\\n---\\n\\n### Code Outline\\n\\n- **Type Declarations**\\n - `SourceMap`\\n - `DependencyKind`\\n - `Dependency`\\n - `ModuleNode`\\n - `AnalysisResult`\\n - `ParseError`\\n - `AnalyzeRequest`\\n\\n- **Constants & Imports**\\n - `traverse` (Babel traverse)\\n - `EXTENSIONS` (file extensions to try)\\n - `INDEXES` (index file names)\\n - `NODE_BUILTINS` (set of Node.js built‑in modules)\\n\\n- **Public API**\\n - `analyzeVals(files: SourceMap): AnalysisResult` \\n *Main entry point for dependency analysis.*\\n\\n- **Specifiers Extraction**\\n - `extractSpecifiers(id, source)` \\n *Parses AST and collects import/export specifiers; returns errors if parsing fails.*\\n - `addSpecifier(specifiers, value, dynamic)` \\n *Adds a valid specifier to the list.*\\n - `literalValue(node)` \\n *Extracts string literals from AST nodes.*\\n\\n- **Dependency Resolution**\\n - `resolveDependency(importer, specifier, dynamic, files)` \\n *Classifies a specifier as local, npm, jsr, val, builtin, url, or unresolved.*\\n - `resolveLocal(importer, specifier, files)` \\n *Attempts to resolve a local module path against the supplied file map.*\\n\\n- **Cycle Detection**\\n - `findCycles(modules)` \\n *Detects circular dependency chains among local modules.*\\n\\n- **Mermaid Diagram Generation**\\n - `toMermaid(modules)` \\n *Produces a Mermaid graph representation of the module dependency graph.*\\n\\n- **File Map Normalization & Path Utilities**\\n - `normalizeFileMap(files)` \\n *Normalizes file names to a consistent path format.*\\n - `dirname(path)` \\n *Returns the directory part of a path.*\\n - `normalizePath(path)` \\n *Resolves `./`, `../`, and Windows backslashes to a POSIX‑style path.*\\n\\n- **Special URL Detection**\\n - `isValTownUrl(specifier)` \\n *Recognises Val Town “val” URLs.*\\n\\n- **Graph Node Helpers**\\n - `nodeId(value)` \\n *Generates a safe Mermaid node identifier.*\\n - `quoteLabel(value)` \\n *Escapes labels for Mermaid syntax.*\\n\\n- **Utility Functions**\\n - `uniqueBy(items, keyFn)` \\n *Removes duplicates based on a key function.*\\n - `canonicalCycleKey(cycle)` \\n *Creates a unique string key for a cycle to avoid duplicates.*\\n\\n- **HTTP Response Helpers**\\n - `jsonResponse(data, init?)` \\n - `textResponse(text, init?)` \\n - `htmlResponse(html)`\\n\\n- **Request Validation**\\n - `isAnalyzeRequest(value)` \\n *Type guard for the POST body shape `{ files: Record }`.*\\n\\n- **HTTP Request Handler**\\n - `handleRequest(request)` \\n *Handles GET/POST routes for the API (`/`, `/sample`, `/sample/mermaid`, `/analyze`).*\\n\\n- **HTML Page**\\n - `homeHtml()` \\n *Returns a minimal HTML page describing the API.*\\n\\n- **Exports**\\n - `default handleRequest`\\n - `sample` (pre‑computed analysis result for demo files)\\n\\n---\"\n }\n }\n }\n}","createdAt",["D",1779162375475],"branchVersion","branchId","6d4f9684-532d-11f1-84c7-ee650bb23af1",{"_31":46,"_33":45,"_35":47,"_36":-5,"_38":48,"_40":14,"_41":42,"_25":26},{"_31":46,"_33":45,"_35":47,"_36":-5},".chisel","e71a4616-5333-11f1-abb4-ee650bb23af1","directory",["D",1779162375475],"id","6d4eea0e-532d-11f1-84c7-ee650bb23af1","vt-dep",["D",1779158999771],"deletedAt","legacyEnvVars",false,"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",{"_105":104,"_112":108},"org",{"_105":104,"_106":-5,"_107":108,"_18":62,"_109":110,"_111":55},"branch",{"_13":94,"_33":95,"_49":42,"_96":50,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":-5,"_102":51,"_103":104},"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",{"_49":50,"_33":51,"_38":199,"_53":-5,"_54":55,"_56":57,"_58":57,"_59":60,"_61":-5,"_18":62,"_63":-5,"_64":55,"_65":-5,"_66":-5,"_67":68,"_69":70,"_71":72,"_73":74,"_75":200,"_77":-5,"_78":79,"_80":79,"_81":82,"_83":82,"_84":82,"_85":79,"_86":79,"_87":201,"_89":202,"_91":203,"_93":55},"tree",[182,183,184,185],"files",[182,183,184,185],"counts",{"_172":68,"_173":169,"_174":68,"_175":176,"_177":178},"contents",[135,136,137,138],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_49":164,"_33":165,"_31":166,"_142":-5,"_41":42,"_40":167,"_144":55,"_38":168,"_13":169,"_35":21,"_36":170,"_25":55,"_149":-5,"_28":171},{"_49":157,"_33":158,"_31":159,"_142":-5,"_41":42,"_40":160,"_144":26,"_38":161,"_13":68,"_35":21,"_36":162,"_25":55,"_149":-5,"_28":163},{"_49":151,"_33":152,"_31":153,"_142":-5,"_41":42,"_40":146,"_144":55,"_38":154,"_13":68,"_35":21,"_36":155,"_25":55,"_149":-5,"_28":156},{"_49":139,"_33":140,"_31":141,"_142":-5,"_41":42,"_40":143,"_144":55,"_38":145,"_13":146,"_35":147,"_36":148,"_25":55,"_149":-5,"_28":150},"495cae58-5335-11f1-965a-ee650bb23af1","main.http.ts","ac2fe5cc-5330-11f1-9c84-ee650bb23af1","parentId",17,"latest",["D",1779162375425],2,"script","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 Dependency = {\n specifier: string;\n resolved?: string;\n kind: DependencyKind;\n dynamic: 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.specifier, item.dynamic, 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\nfunction extractSpecifiers(\n id: string,\n source: string,\n): {\n specifiers: { specifier: string; dynamic: boolean }[];\n error?: ParseError;\n} {\n const specifiers: { specifier: string; dynamic: boolean }[] = [];\n let ast: parser.ParseResult;\n try {\n ast = parser.parse(source, {\n sourceType: \"unambiguous\",\n plugins: [\n \"typescript\",\n \"jsx\",\n \"decorators-legacy\",\n \"importAssertions\",\n \"explicitResourceManagement\",\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, false);\n },\n ExportNamedDeclaration(path: any) {\n addSpecifier(specifiers, path.node.source?.value, false);\n },\n ExportAllDeclaration(path: any) {\n addSpecifier(specifiers, path.node.source?.value, false);\n },\n Import(path: any) {\n const parent = path.parentPath?.node;\n const firstArg = parent?.arguments?.[0];\n addSpecifier(specifiers, literalValue(firstArg), true);\n },\n CallExpression(path: any) {\n if (path.node.callee?.name !== \"require\") return;\n addSpecifier(specifiers, literalValue(path.node.arguments?.[0]), false);\n },\n });\n\n return {\n specifiers: uniqueBy(\n specifiers,\n ({ specifier, dynamic }) => `${dynamic}:${specifier}`,\n ),\n };\n}\n\nfunction addSpecifier(\n specifiers: { specifier: string; dynamic: boolean }[],\n value: unknown,\n dynamic: boolean,\n) {\n if (typeof value === \"string\" && value.length > 0) {\n specifiers.push({ specifier: value, dynamic });\n }\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 specifier: string,\n dynamic: boolean,\n files: SourceMap,\n): Dependency {\n if (specifier.startsWith(\"npm:\")) return { specifier, kind: \"npm\", dynamic };\n if (specifier.startsWith(\"jsr:\")) return { specifier, kind: \"jsr\", dynamic };\n if (specifier.startsWith(\"node:\")) {\n return { specifier, kind: \"builtin\", dynamic };\n }\n if (NODE_BUILTINS.has(specifier)) {\n return { specifier, kind: \"builtin\", dynamic };\n }\n if (isValTownUrl(specifier)) return { specifier, kind: \"val\", dynamic };\n if (/^https?:\\/\\//.test(specifier)) {\n return { specifier, kind: \"url\", dynamic };\n }\n if (!specifier.startsWith(\"./\") && !specifier.startsWith(\"../\")) {\n return { specifier, kind: \"npm\", dynamic };\n }\n\n const resolved = resolveLocal(importer, specifier, files);\n return resolved\n ? { specifier, resolved, kind: \"local\", dynamic }\n : { specifier, kind: \"unresolved\", dynamic };\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 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 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 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 or /sample/mermaid.

\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","label",[140],"ac25d69a-5330-11f1-a1ae-ee650bb23af1","deno.lock","ac25d74e-5330-11f1-a1ae-ee650bb23af1",["D",1779160393679],"{\n \"version\": \"5\",\n \"specifiers\": {\n \"npm:@babel/parser@*\": \"7.29.3\",\n \"npm:@babel/traverse@*\": \"7.29.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 \"debug@4.4.3\": {\n \"integrity\": \"sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==\",\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 \"ms@2.1.3\": {\n \"integrity\": \"sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==\"\n },\n \"picocolors@1.1.1\": {\n \"integrity\": \"sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==\"\n }\n }\n}\n",[152],"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",[158],"9ba45532-5333-11f1-8a91-ee650bb23af1","README.md","6dc04424-532d-11f1-b320-ee650bb23af1",8,["D",1779161654473],1,"# 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## 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.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.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.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",[165],"pulls","branches","forks","envVars",{"_179":68,"_181":68},"connections",{"_179":68,"_180":68},"count","unfilledCount","emptyCount",{"_49":164,"_33":165,"_31":166,"_142":-5,"_41":42,"_40":167,"_144":55,"_38":196,"_13":169,"_35":21,"_36":170,"_25":55,"_149":-5,"_187":197,"_28":198},{"_49":157,"_33":158,"_31":159,"_142":-5,"_41":42,"_40":160,"_144":26,"_38":193,"_13":68,"_35":21,"_36":162,"_25":55,"_149":-5,"_187":194,"_28":195},{"_49":151,"_33":152,"_31":153,"_142":-5,"_41":42,"_40":146,"_144":55,"_38":190,"_13":68,"_35":21,"_36":155,"_25":55,"_149":-5,"_187":191,"_28":192},{"_49":139,"_33":140,"_31":141,"_142":-5,"_41":42,"_40":143,"_144":55,"_38":186,"_13":146,"_35":147,"_36":148,"_25":55,"_149":-5,"_187":188,"_28":189},["D",1779162375425],"children",[],[140],["D",1779160393679],[],[152],["D",1779160393708],[],[158],["D",1779161654473],[],[165],["D",1779158999771],["D",1789515055826],{"_105":104,"_112":108},{"_105":104,"_106":-5,"_107":108,"_18":62,"_109":110,"_111":55},{"_13":94,"_33":95,"_49":42,"_96":50,"_97":-5,"_98":-5,"_99":-5,"_100":-5,"_101":-5,"_102":51,"_103":104},"ctx",{"_87":-5,"_132":237,"_238":239,"_240":241,"_242":55,"_243":55,"_244":55,"_245":26,"_246":-5,"_247":-7,"_248":-7,"_249":68,"_250":55,"_251":55,"_252":-5,"_253":55,"_254":55,"_255":55,"_256":-5},"ENV",{"_208":209,"_210":211,"_212":95,"_213":214,"_215":216,"_217":218,"_219":220,"_221":222,"_223":224,"_225":226,"_227":228,"_229":230,"_231":232,"_233":234,"_235":236},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","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 · v18