@niscorp/cli 0.9.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/shell-site.ts","../src/routes.ts"],"names":["pad"],"mappings":"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","file":"index.cjs","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { shellSettled, shellView } from '@niscorp/nova';\nimport type { Shell } from '@niscorp/nova';\nimport { headOf, placeHead } from '@niscorp/nova/document';\nimport type { ScreenHead } from '@niscorp/nova/document';\nimport { livenessOf } from '@niscorp/nova/reflect';\nimport type { NiscShellProject } from './project';\n\nconst DEFAULT_BUILD_WAIT_MS = 5000;\nexport const DEFAULT_ROOT = '<div id=\"root\"></div>';\n\nexport type ShellRouteReport = {\n path: string;\n html: string;\n problems: readonly string[];\n actions: readonly string[];\n opensWith: readonly string[];\n callsLater: readonly string[];\n listens: readonly string[];\n head?: ScreenHead;\n};\n\nconst escapeAttribute = (value: string): string => value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;');\n\nexport const placeScreen = (template: string, screen: string, attributes: Record<string, string> = {}, root = DEFAULT_ROOT): string => {\n const written = Object.entries(attributes)\n .map(([name, value]) => ` ${name}=\"${escapeAttribute(value)}\"`)\n .join('');\n return (\n template\n // functions, both, so nothing in the screen is read as a replacement pattern\n .replace(root, () => root.replace('></div>', () => `>${screen}</div>`))\n .replace(/<html([^>]*)>/, (whole, existing: string) => (written === '' ? whole : `<html${existing}${written}>`))\n );\n};\n\nconst factsOf = (shell: Shell): Pick<ShellRouteReport, 'actions' | 'opensWith' | 'callsLater' | 'listens'> => {\n const [actions, opensWith, callsLater, listens] = [new Set<string>(), new Set<string>(), new Set<string>(), new Set<string>()];\n for (const canvas of Object.values(shell.getState().canvases)) {\n for (const instance of canvas.stack) {\n const definition = shell.getRuntime(instance.id)?.definition;\n if (definition === undefined) continue;\n actions.add(definition.id);\n const liveness = livenessOf(definition);\n for (const channel of liveness.listens) listens.add(channel);\n for (const endpoint of liveness.endpoints) {\n const label = `${definition.id}.${endpoint.name}${endpoint.kind === 'fn' ? ' (a function)' : endpoint.url !== undefined ? ` (${endpoint.url})` : ''}`;\n if (endpoint.onOpen) opensWith.add(label);\n if (endpoint.later) callsLater.add(label);\n }\n }\n }\n const sorted = (set: Set<string>): string[] => [...set].sort();\n return { actions: sorted(actions), opensWith: sorted(opensWith), callsLater: sorted(callsLater), listens: sorted(listens) };\n};\n\ntype Drawn = { screen: string; whole: boolean; attributes: Record<string, string>; head: ScreenHead | undefined; facts: ReturnType<typeof factsOf> };\n\nconst documentOf = (project: NiscShellProject, template: string, path: string, drawn: Drawn): string =>\n placeHead(placeScreen(template, drawn.screen, drawn.attributes), drawn.head?.elements, { ...(project.site !== undefined ? { site: project.site } : {}), path });\n\nconst drawOnce = async (project: NiscShellProject, path: string): Promise<Drawn> => {\n const booted = await project.shell({ path });\n try {\n const whole = await shellSettled(booted.shell, { waitMs: project.waitMs ?? DEFAULT_BUILD_WAIT_MS });\n const screen = await project.draw(booted.shell);\n return { screen, whole, attributes: project.htmlAttributes?.(booted.shell) ?? {}, head: headOf(shellView(booted.shell).api), facts: factsOf(booted.shell) };\n } finally {\n await booted.close?.();\n }\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n// The adoption check runs in a process of its own (./adopt): a DOM has to exist\n// before the app's modules load, because an adapter decides what it is running\n// in when it is imported.\ntype Adoption = { path: string; complaints: string[] };\n\nconst isAdoption = (value: unknown): value is Adoption =>\n value !== null &&\n typeof value === 'object' &&\n typeof Reflect.get(value, 'path') === 'string' &&\n Array.isArray(Reflect.get(value, 'complaints'));\n\nconst adoptAll = (root: string, pages: readonly { path: string; screen: string }[]): Adoption[] => {\n if (pages.length === 0) return [];\n const here = dirname(fileURLToPath(import.meta.url));\n // built: beside this file. From source (the package's own tests): in dist.\n const entry = [join(here, 'adopt.js'), join(here, '..', 'dist', 'adopt.js')].find((candidate) => existsSync(candidate));\n if (entry === undefined) throw new Error('nisc: the adoption check is not built (packages/cli/dist/adopt.js).');\n const scratch = mkdtempSync(join(tmpdir(), 'nisc-adopt-'));\n try {\n const [asked, answered] = [join(scratch, 'pages.json'), join(scratch, 'adopted.json')];\n writeFileSync(asked, JSON.stringify(pages));\n const result = spawnSync(process.execPath, [entry, root, asked, answered], { cwd: root, stdio: ['ignore', 'ignore', 'pipe'], encoding: 'utf8' });\n if (!existsSync(answered)) {\n const why = result.stderr.trim().split('\\n').slice(-6).join('\\n');\n return pages.map((page) => ({ path: page.path, complaints: [`the adoption check could not run${why === '' ? '' : ` — ${why}`}`] }));\n }\n const parsed: unknown = JSON.parse(readFileSync(answered, 'utf8'));\n return Array.isArray(parsed) ? parsed.filter(isAdoption) : [];\n } finally {\n rmSync(scratch, { recursive: true, force: true });\n }\n};\n\nexport const surveyShell = async (root: string, project: NiscShellProject, template: string): Promise<ShellRouteReport[]> => {\n if (!template.includes(DEFAULT_ROOT)) {\n throw new Error(`nisc: the built index.html has no empty root (${DEFAULT_ROOT}) — that is where a screen goes.`);\n }\n const paths = project.paths === undefined ? ['/'] : await project.paths();\n const none = { actions: [], opensWith: [], callsLater: [], listens: [] };\n\n const first: { path: string; drawn?: Drawn; problems: string[] }[] = [];\n for (const path of paths) {\n const problems: string[] = [];\n let drawn: Drawn | undefined;\n try {\n drawn = await drawOnce(project, path);\n if (drawn.screen.trim() === '') problems.push('drawn: it drew to nothing');\n if (!drawn.whole) problems.push(`whole: it was still loading after ${project.waitMs ?? DEFAULT_BUILD_WAIT_MS}ms`);\n for (const why of drawn.head?.refused ?? []) problems.push(`head: ${why}`);\n const again = await drawOnce(project, path);\n if (again.screen !== drawn.screen) problems.push(`same twice: a second boot drew different markup${differenceOf(drawn.screen, again.screen)}`);\n const [head, headAgain] = [JSON.stringify(drawn.head ?? null), JSON.stringify(again.head ?? null)];\n if (headAgain !== head) problems.push(`same twice: a second boot said a different head${differenceOf(head, headAgain)}`);\n } catch (error) {\n problems.push(`drawn: ${said(error)}`);\n }\n first.push({ path, ...(drawn !== undefined ? { drawn } : {}), problems });\n }\n\n const adoptable = first.flatMap((route) => (route.drawn !== undefined && route.drawn.whole && route.drawn.screen.trim() !== '' ? [{ path: route.path, screen: route.drawn.screen }] : []));\n const adoptions = new Map(adoptAll(root, adoptable).map((adoption) => [adoption.path, adoption.complaints]));\n\n return first.map((route) => {\n const asked = adoptable.some((page) => page.path === route.path);\n const complaints = asked ? (adoptions.get(route.path) ?? ['the adoption check said nothing about it']) : [];\n const problems = [...route.problems, ...complaints.map((complaint) => `adopted: ${complaint}`)];\n return {\n path: route.path,\n html: route.drawn === undefined ? template : documentOf(project, template, route.path, route.drawn),\n problems,\n ...(route.drawn?.facts ?? none),\n ...(route.drawn?.head !== undefined ? { head: route.drawn.head } : {}),\n };\n });\n};\n\nconst differenceOf = (a: string, b: string): string => {\n let at = 0;\n while (at < a.length && at < b.length && a[at] === b[at]) at += 1;\n const around = (text: string): string => JSON.stringify(text.slice(Math.max(0, at - 30), at + 50));\n return ` — at character ${at}: ${around(a)} then ${around(b)}`;\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const shellRouteTable = (routes: readonly ShellRouteReport[]): string => {\n const width = Math.max(5, ...routes.map((route) => route.path.length)) + 2;\n const lines = [` ${pad('Route', width)}First screen`];\n const indent = ' '.repeat(width + 2);\n const says = (route: ShellRouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const headNote = (route: ShellRouteReport): string =>\n says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own';\n for (const route of routes) {\n const ok = route.problems.length === 0;\n const notes = ok\n ? [\n `drawn · whole · same twice · adopted${route.actions.length > 0 ? ` (${route.actions.join(', ')})` : ''}`,\n ...(route.opensWith.length > 0 ? [`opened with ${route.opensWith.join(', ')} — in the file as answered at build`] : []),\n ...(route.callsLater.length > 0 ? [`can still call ${route.callsLater.join(', ')}`] : []),\n ...(route.listens.length > 0 ? [`waits on ${route.listens.join(', ')}`] : []),\n ...(headed ? [headNote(route)] : []),\n ]\n : route.problems;\n const [head, ...rest] = notes;\n lines.push(`${ok ? '○' : '✗'} ${pad(route.path, width)}${head ?? ''}`);\n for (const note of rest) lines.push(`${indent}${note}`);\n }\n lines.push('');\n lines.push('○ a file: the first screen, drawn for nobody in particular; the page’s own shell picks it up');\n lines.push('✗ not written: a check did not hold');\n return lines.join('\\n');\n};\n\nconst TYPES: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'text/javascript; charset=utf-8',\n '.mjs': 'text/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.json': 'application/json; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.ico': 'image/x-icon',\n '.woff2': 'font/woff2',\n '.woff': 'font/woff',\n '.wasm': 'application/wasm',\n '.data': 'application/octet-stream',\n '.map': 'application/json; charset=utf-8',\n '.txt': 'text/plain; charset=utf-8',\n};\n\nexport const shellSite = (project: NiscShellProject, dist: string): ((request: Request) => Promise<Response>) => {\n const base = resolve(dist);\n return async (request) => {\n const path = decodeURIComponent(new URL(request.url).pathname);\n if (path !== '/' && path !== '/index.html') {\n const file = resolve(base, `.${path}`);\n const stats = file === base || file.startsWith(base + sep) ? statSync(file, { throwIfNoEntry: false }) : undefined;\n if (stats?.isFile() === true) {\n return new Response(readFileSync(file), {\n headers: { 'content-type': TYPES[extname(file)] ?? 'application/octet-stream', 'content-length': String(stats.size), 'last-modified': stats.mtime.toUTCString() },\n });\n }\n if (extname(path) !== '') return new Response('not found', { status: 404 });\n }\n const template = readFileSync(join(base, 'index.html'), 'utf8');\n const headers = { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' };\n try {\n const at = path === '/index.html' ? '/' : path;\n return new Response(documentOf(project, template, at, await drawOnce(project, at)), { headers });\n } catch (error) {\n console.error(`[nisc] \"${path}\" could not be drawn — serving it undrawn:`, error);\n return new Response(template, { headers });\n }\n };\n};\n","export type RouteReport = {\n path: string;\n page?: string;\n drawn: boolean;\n live: boolean;\n why: readonly string[];\n drawnWith: readonly string[];\n settled: boolean;\n head?: { elements: readonly unknown[]; actions: readonly string[] };\n};\n\nexport const defaultPaths = (pages: readonly { name: string; path: string }[]): string[] => [\n '/',\n ...pages\n .map((page) => page.path)\n .filter((path) => !path.split('/').some((segment) => segment.startsWith(':')))\n .sort(),\n];\n\nexport const fileOf = (path: string): string => {\n const segments = path.split('?')[0]?.split('/').filter((segment) => segment !== '') ?? [];\n if (segments.some((segment) => segment === '..' || segment === '.')) throw new Error(`nisc: \"${path}\" is not a path a file can be written for.`);\n return [...segments, 'index.html'].join('/');\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const routeTable = (routes: readonly RouteReport[]): string => {\n const says = (route: RouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const rows = routes.map((route) => {\n const mark = !route.drawn ? '✗' : route.live ? '●' : '○';\n const what = route.page === undefined ? 'the app' : `page ${route.page}`;\n const served = !route.drawn ? 'not drawn' : route.live ? 'server' : 'file';\n const notes = [\n ...(route.drawn ? route.why : ['it could not be drawn — it goes out as the undrawn template']),\n ...(route.drawn && !route.settled ? ['it was still loading when the wait ran out — drawn with what it had'] : []),\n ...(route.drawnWith.length > 0 ? [`drawn with ${route.drawnWith.join(', ')} — as it answered at build`] : []),\n ];\n const head = headed && route.drawn ? [says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own'] : [];\n return { mark, path: route.path, what, served, notes, head };\n });\n const widths = {\n path: Math.max(5, ...rows.map((row) => row.path.length)),\n what: Math.max(4, ...rows.map((row) => row.what.length)),\n served: Math.max(9, ...rows.map((row) => row.served.length)),\n };\n const lines = [` ${pad('Route', widths.path + 2)}${pad('What', widths.what + 2)}${pad('Served as', widths.served + 2)}Because`];\n for (const row of rows) {\n const head = `${row.mark} ${pad(row.path, widths.path + 2)}${pad(row.what, widths.what + 2)}${pad(row.served, widths.served + 2)}`;\n const [first, ...rest] = [...(row.notes.length > 0 ? row.notes : ['nothing on it can still happen']), ...row.head];\n lines.push(`${head}${first ?? ''}`);\n for (const note of rest) lines.push(`${' '.repeat(head.length)}${note}`);\n }\n lines.push('');\n lines.push('○ file drawn once, for nobody in particular; nothing on it can still happen');\n lines.push('● server something on it can still happen; it wants moss behind it');\n return lines.join('\\n');\n};\n"]}
1
+ {"version":3,"sources":["../src/serve/shell-site.ts","../src/build/routes.ts"],"names":["pad"],"mappings":"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","file":"index.cjs","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { shellSettled, shellView } from '@niscorp/nova';\nimport type { Shell } from '@niscorp/nova';\nimport { headOf, placeHead } from '@niscorp/nova/document';\nimport type { ScreenHead } from '@niscorp/nova/document';\nimport { livenessOf } from '@niscorp/nova/reflect';\nimport type { NiscShellProject } from '../project';\n\nconst DEFAULT_BUILD_WAIT_MS = 5000;\nexport const DEFAULT_ROOT = '<div id=\"root\"></div>';\n\nexport type ShellRouteReport = {\n path: string;\n html: string;\n problems: readonly string[];\n actions: readonly string[];\n opensWith: readonly string[];\n callsLater: readonly string[];\n listens: readonly string[];\n head?: ScreenHead;\n};\n\nconst escapeAttribute = (value: string): string => value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;');\n\nexport const placeScreen = (template: string, screen: string, attributes: Record<string, string> = {}, root = DEFAULT_ROOT): string => {\n const written = Object.entries(attributes)\n .map(([name, value]) => ` ${name}=\"${escapeAttribute(value)}\"`)\n .join('');\n return (\n template\n // functions, both, so nothing in the screen is read as a replacement pattern\n .replace(root, () => root.replace('></div>', () => `>${screen}</div>`))\n .replace(/<html([^>]*)>/, (whole, existing: string) => (written === '' ? whole : `<html${existing}${written}>`))\n );\n};\n\nconst factsOf = (shell: Shell): Pick<ShellRouteReport, 'actions' | 'opensWith' | 'callsLater' | 'listens'> => {\n const [actions, opensWith, callsLater, listens] = [new Set<string>(), new Set<string>(), new Set<string>(), new Set<string>()];\n for (const canvas of Object.values(shell.getState().canvases)) {\n for (const instance of canvas.stack) {\n const definition = shell.getRuntime(instance.id)?.definition;\n if (definition === undefined) continue;\n actions.add(definition.id);\n const liveness = livenessOf(definition);\n for (const channel of liveness.listens) listens.add(channel);\n for (const endpoint of liveness.endpoints) {\n const label = `${definition.id}.${endpoint.name}${endpoint.kind === 'fn' ? ' (a function)' : endpoint.url !== undefined ? ` (${endpoint.url})` : ''}`;\n if (endpoint.onOpen) opensWith.add(label);\n if (endpoint.later) callsLater.add(label);\n }\n }\n }\n const sorted = (set: Set<string>): string[] => [...set].sort();\n return { actions: sorted(actions), opensWith: sorted(opensWith), callsLater: sorted(callsLater), listens: sorted(listens) };\n};\n\ntype Drawn = { screen: string; whole: boolean; attributes: Record<string, string>; head: ScreenHead | undefined; facts: ReturnType<typeof factsOf> };\n\nconst documentOf = (project: NiscShellProject, template: string, path: string, drawn: Drawn): string =>\n placeHead(placeScreen(template, drawn.screen, drawn.attributes), drawn.head?.elements, { ...(project.site !== undefined ? { site: project.site } : {}), path });\n\nconst drawOnce = async (project: NiscShellProject, path: string): Promise<Drawn> => {\n const booted = await project.shell({ path });\n try {\n const whole = await shellSettled(booted.shell, { waitMs: project.waitMs ?? DEFAULT_BUILD_WAIT_MS });\n const screen = await project.draw(booted.shell);\n return { screen, whole, attributes: project.htmlAttributes?.(booted.shell) ?? {}, head: headOf(shellView(booted.shell).api), facts: factsOf(booted.shell) };\n } finally {\n await booted.close?.();\n }\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n// The adoption check runs in a process of its own (./adopt): a DOM has to exist\n// before the app's modules load, because an adapter decides what it is running\n// in when it is imported.\ntype Adoption = { path: string; complaints: string[] };\n\nconst isAdoption = (value: unknown): value is Adoption =>\n value !== null &&\n typeof value === 'object' &&\n typeof Reflect.get(value, 'path') === 'string' &&\n Array.isArray(Reflect.get(value, 'complaints'));\n\nconst adoptAll = (root: string, pages: readonly { path: string; screen: string }[]): Adoption[] => {\n if (pages.length === 0) return [];\n const here = dirname(fileURLToPath(import.meta.url));\n // built: beside this file. From source (the package's own tests): in dist.\n const entry = [join(here, 'adopt.js'), join(here, '..', '..', 'dist', 'adopt.js')].find((candidate) => existsSync(candidate));\n if (entry === undefined) throw new Error('nisc: the adoption check is not built (packages/cli/dist/adopt.js).');\n const scratch = mkdtempSync(join(tmpdir(), 'nisc-adopt-'));\n try {\n const [asked, answered] = [join(scratch, 'pages.json'), join(scratch, 'adopted.json')];\n writeFileSync(asked, JSON.stringify(pages));\n const result = spawnSync(process.execPath, [entry, root, asked, answered], { cwd: root, stdio: ['ignore', 'ignore', 'pipe'], encoding: 'utf8' });\n if (!existsSync(answered)) {\n const why = result.stderr.trim().split('\\n').slice(-6).join('\\n');\n return pages.map((page) => ({ path: page.path, complaints: [`the adoption check could not run${why === '' ? '' : ` — ${why}`}`] }));\n }\n const parsed: unknown = JSON.parse(readFileSync(answered, 'utf8'));\n return Array.isArray(parsed) ? parsed.filter(isAdoption) : [];\n } finally {\n rmSync(scratch, { recursive: true, force: true });\n }\n};\n\nexport const surveyShell = async (root: string, project: NiscShellProject, template: string): Promise<ShellRouteReport[]> => {\n if (!template.includes(DEFAULT_ROOT)) {\n throw new Error(`nisc: the built index.html has no empty root (${DEFAULT_ROOT}) — that is where a screen goes.`);\n }\n const paths = project.paths === undefined ? ['/'] : await project.paths();\n const none = { actions: [], opensWith: [], callsLater: [], listens: [] };\n\n const first: { path: string; drawn?: Drawn; problems: string[] }[] = [];\n for (const path of paths) {\n const problems: string[] = [];\n let drawn: Drawn | undefined;\n try {\n drawn = await drawOnce(project, path);\n if (drawn.screen.trim() === '') problems.push('drawn: it drew to nothing');\n if (!drawn.whole) problems.push(`whole: it was still loading after ${project.waitMs ?? DEFAULT_BUILD_WAIT_MS}ms`);\n for (const why of drawn.head?.refused ?? []) problems.push(`head: ${why}`);\n const again = await drawOnce(project, path);\n if (again.screen !== drawn.screen) problems.push(`same twice: a second boot drew different markup${differenceOf(drawn.screen, again.screen)}`);\n const [head, headAgain] = [JSON.stringify(drawn.head ?? null), JSON.stringify(again.head ?? null)];\n if (headAgain !== head) problems.push(`same twice: a second boot said a different head${differenceOf(head, headAgain)}`);\n } catch (error) {\n problems.push(`drawn: ${said(error)}`);\n }\n first.push({ path, ...(drawn !== undefined ? { drawn } : {}), problems });\n }\n\n const adoptable = first.flatMap((route) => (route.drawn !== undefined && route.drawn.whole && route.drawn.screen.trim() !== '' ? [{ path: route.path, screen: route.drawn.screen }] : []));\n const adoptions = new Map(adoptAll(root, adoptable).map((adoption) => [adoption.path, adoption.complaints]));\n\n return first.map((route) => {\n const asked = adoptable.some((page) => page.path === route.path);\n const complaints = asked ? (adoptions.get(route.path) ?? ['the adoption check said nothing about it']) : [];\n const problems = [...route.problems, ...complaints.map((complaint) => `adopted: ${complaint}`)];\n return {\n path: route.path,\n html: route.drawn === undefined ? template : documentOf(project, template, route.path, route.drawn),\n problems,\n ...(route.drawn?.facts ?? none),\n ...(route.drawn?.head !== undefined ? { head: route.drawn.head } : {}),\n };\n });\n};\n\nconst differenceOf = (a: string, b: string): string => {\n let at = 0;\n while (at < a.length && at < b.length && a[at] === b[at]) at += 1;\n const around = (text: string): string => JSON.stringify(text.slice(Math.max(0, at - 30), at + 50));\n return ` — at character ${at}: ${around(a)} then ${around(b)}`;\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const shellRouteTable = (routes: readonly ShellRouteReport[]): string => {\n const width = Math.max(5, ...routes.map((route) => route.path.length)) + 2;\n const lines = [` ${pad('Route', width)}First screen`];\n const indent = ' '.repeat(width + 2);\n const says = (route: ShellRouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const headNote = (route: ShellRouteReport): string =>\n says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own';\n for (const route of routes) {\n const ok = route.problems.length === 0;\n const notes = ok\n ? [\n `drawn · whole · same twice · adopted${route.actions.length > 0 ? ` (${route.actions.join(', ')})` : ''}`,\n ...(route.opensWith.length > 0 ? [`opened with ${route.opensWith.join(', ')} — in the file as answered at build`] : []),\n ...(route.callsLater.length > 0 ? [`can still call ${route.callsLater.join(', ')}`] : []),\n ...(route.listens.length > 0 ? [`waits on ${route.listens.join(', ')}`] : []),\n ...(headed ? [headNote(route)] : []),\n ]\n : route.problems;\n const [head, ...rest] = notes;\n lines.push(`${ok ? '○' : '✗'} ${pad(route.path, width)}${head ?? ''}`);\n for (const note of rest) lines.push(`${indent}${note}`);\n }\n lines.push('');\n lines.push('○ a file: the first screen, drawn for nobody in particular; the page’s own shell picks it up');\n lines.push('✗ not written: a check failed');\n return lines.join('\\n');\n};\n\nconst TYPES: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'text/javascript; charset=utf-8',\n '.mjs': 'text/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.json': 'application/json; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.ico': 'image/x-icon',\n '.woff2': 'font/woff2',\n '.woff': 'font/woff',\n '.wasm': 'application/wasm',\n '.data': 'application/octet-stream',\n '.map': 'application/json; charset=utf-8',\n '.txt': 'text/plain; charset=utf-8',\n};\n\nconst decodedPath = (pathname: string): string | undefined => {\n try {\n const path = decodeURIComponent(pathname);\n return path.includes('\\0') ? undefined : path;\n } catch {\n return undefined;\n }\n};\n\nexport const shellSite = (project: NiscShellProject, dist: string): ((request: Request) => Promise<Response>) => {\n const base = resolve(dist);\n return async (request) => {\n const path = decodedPath(new URL(request.url).pathname);\n if (path === undefined) return new Response('not a path', { status: 400 });\n if (path !== '/' && path !== '/index.html') {\n const file = resolve(base, `.${path}`);\n const stats = file === base || file.startsWith(base + sep) ? statSync(file, { throwIfNoEntry: false }) : undefined;\n if (stats?.isFile() === true) {\n return new Response(readFileSync(file), {\n headers: { 'content-type': TYPES[extname(file)] ?? 'application/octet-stream', 'content-length': String(stats.size), 'last-modified': stats.mtime.toUTCString() },\n });\n }\n if (extname(path) !== '') return new Response('not found', { status: 404 });\n }\n const template = readFileSync(join(base, 'index.html'), 'utf8');\n const headers = { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' };\n try {\n const at = path === '/index.html' ? '/' : path;\n return new Response(documentOf(project, template, at, await drawOnce(project, at)), { headers });\n } catch (error) {\n console.error(`[nisc] \"${path}\" could not be drawn — serving it undrawn:`, error);\n return new Response(template, { headers });\n }\n };\n};\n","export type RouteReport = {\n path: string;\n page?: string;\n drawn: boolean;\n live: boolean;\n why: readonly string[];\n drawnWith: readonly string[];\n settled: boolean;\n head?: { elements: readonly unknown[]; actions: readonly string[] };\n};\n\nexport const defaultPaths = (pages: readonly { name: string; path: string }[]): string[] => [\n '/',\n ...pages\n .map((page) => page.path)\n .filter((path) => !path.split('/').some((segment) => segment.startsWith(':')))\n .sort(),\n];\n\nexport const fileOf = (path: string): string => {\n const segments = path.split('?')[0]?.split('/').filter((segment) => segment !== '') ?? [];\n if (segments.some((segment) => segment === '..' || segment === '.')) throw new Error(`nisc: \"${path}\" is not a path a file can be written for.`);\n return [...segments, 'index.html'].join('/');\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const routeTable = (routes: readonly RouteReport[]): string => {\n const says = (route: RouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const rows = routes.map((route) => {\n const mark = !route.drawn ? '✗' : route.live ? '●' : '○';\n const what = route.page === undefined ? 'the app' : `page ${route.page}`;\n const served = !route.drawn ? 'not drawn' : route.live ? 'server' : 'file';\n const notes = [\n ...(route.drawn ? route.why : ['it could not be drawn — it goes out as the undrawn template']),\n ...(route.drawn && !route.settled ? ['it was still loading when the wait ran out — drawn with what it had'] : []),\n ...(route.drawnWith.length > 0 ? [`drawn with ${route.drawnWith.join(', ')} — as it answered at build`] : []),\n ];\n const head = headed && route.drawn ? [says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own'] : [];\n return { mark, path: route.path, what, served, notes, head };\n });\n const widths = {\n path: Math.max(5, ...rows.map((row) => row.path.length)),\n what: Math.max(4, ...rows.map((row) => row.what.length)),\n served: Math.max(9, ...rows.map((row) => row.served.length)),\n };\n const lines = [` ${pad('Route', widths.path + 2)}${pad('What', widths.what + 2)}${pad('Served as', widths.served + 2)}Because`];\n for (const row of rows) {\n const head = `${row.mark} ${pad(row.path, widths.path + 2)}${pad(row.what, widths.what + 2)}${pad(row.served, widths.served + 2)}`;\n const [first, ...rest] = [...(row.notes.length > 0 ? row.notes : ['nothing on it can still happen']), ...row.head];\n lines.push(`${head}${first ?? ''}`);\n for (const note of rest) lines.push(`${' '.repeat(head.length)}${note}`);\n }\n lines.push('');\n lines.push('○ file drawn once, for nobody in particular; nothing on it can still happen');\n lines.push('● server something on it can still happen; it wants moss behind it');\n return lines.join('\\n');\n};\n"]}
package/dist/index.js CHANGED
@@ -7,7 +7,7 @@ import '@niscorp/nova';
7
7
  import '@niscorp/nova/document';
8
8
  import '@niscorp/nova/reflect';
9
9
 
10
- // src/shell-site.ts
10
+ // src/serve/shell-site.ts
11
11
  var DEFAULT_ROOT = '<div id="root"></div>';
12
12
  var escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
13
13
  var placeScreen = (template, screen, attributes = {}, root = DEFAULT_ROOT) => {
@@ -37,11 +37,11 @@ var shellRouteTable = (routes) => {
37
37
  }
38
38
  lines.push("");
39
39
  lines.push("\u25CB a file: the first screen, drawn for nobody in particular; the page\u2019s own shell picks it up");
40
- lines.push("\u2717 not written: a check did not hold");
40
+ lines.push("\u2717 not written: a check failed");
41
41
  return lines.join("\n");
42
42
  };
43
43
 
44
- // src/routes.ts
44
+ // src/build/routes.ts
45
45
  var defaultPaths = (pages) => [
46
46
  "/",
47
47
  ...pages.map((page) => page.path).filter((path) => !path.split("/").some((segment) => segment.startsWith(":"))).sort()
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/shell-site.ts","../src/routes.ts"],"names":["pad"],"mappings":"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","file":"index.js","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { shellSettled, shellView } from '@niscorp/nova';\nimport type { Shell } from '@niscorp/nova';\nimport { headOf, placeHead } from '@niscorp/nova/document';\nimport type { ScreenHead } from '@niscorp/nova/document';\nimport { livenessOf } from '@niscorp/nova/reflect';\nimport type { NiscShellProject } from './project';\n\nconst DEFAULT_BUILD_WAIT_MS = 5000;\nexport const DEFAULT_ROOT = '<div id=\"root\"></div>';\n\nexport type ShellRouteReport = {\n path: string;\n html: string;\n problems: readonly string[];\n actions: readonly string[];\n opensWith: readonly string[];\n callsLater: readonly string[];\n listens: readonly string[];\n head?: ScreenHead;\n};\n\nconst escapeAttribute = (value: string): string => value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;');\n\nexport const placeScreen = (template: string, screen: string, attributes: Record<string, string> = {}, root = DEFAULT_ROOT): string => {\n const written = Object.entries(attributes)\n .map(([name, value]) => ` ${name}=\"${escapeAttribute(value)}\"`)\n .join('');\n return (\n template\n // functions, both, so nothing in the screen is read as a replacement pattern\n .replace(root, () => root.replace('></div>', () => `>${screen}</div>`))\n .replace(/<html([^>]*)>/, (whole, existing: string) => (written === '' ? whole : `<html${existing}${written}>`))\n );\n};\n\nconst factsOf = (shell: Shell): Pick<ShellRouteReport, 'actions' | 'opensWith' | 'callsLater' | 'listens'> => {\n const [actions, opensWith, callsLater, listens] = [new Set<string>(), new Set<string>(), new Set<string>(), new Set<string>()];\n for (const canvas of Object.values(shell.getState().canvases)) {\n for (const instance of canvas.stack) {\n const definition = shell.getRuntime(instance.id)?.definition;\n if (definition === undefined) continue;\n actions.add(definition.id);\n const liveness = livenessOf(definition);\n for (const channel of liveness.listens) listens.add(channel);\n for (const endpoint of liveness.endpoints) {\n const label = `${definition.id}.${endpoint.name}${endpoint.kind === 'fn' ? ' (a function)' : endpoint.url !== undefined ? ` (${endpoint.url})` : ''}`;\n if (endpoint.onOpen) opensWith.add(label);\n if (endpoint.later) callsLater.add(label);\n }\n }\n }\n const sorted = (set: Set<string>): string[] => [...set].sort();\n return { actions: sorted(actions), opensWith: sorted(opensWith), callsLater: sorted(callsLater), listens: sorted(listens) };\n};\n\ntype Drawn = { screen: string; whole: boolean; attributes: Record<string, string>; head: ScreenHead | undefined; facts: ReturnType<typeof factsOf> };\n\nconst documentOf = (project: NiscShellProject, template: string, path: string, drawn: Drawn): string =>\n placeHead(placeScreen(template, drawn.screen, drawn.attributes), drawn.head?.elements, { ...(project.site !== undefined ? { site: project.site } : {}), path });\n\nconst drawOnce = async (project: NiscShellProject, path: string): Promise<Drawn> => {\n const booted = await project.shell({ path });\n try {\n const whole = await shellSettled(booted.shell, { waitMs: project.waitMs ?? DEFAULT_BUILD_WAIT_MS });\n const screen = await project.draw(booted.shell);\n return { screen, whole, attributes: project.htmlAttributes?.(booted.shell) ?? {}, head: headOf(shellView(booted.shell).api), facts: factsOf(booted.shell) };\n } finally {\n await booted.close?.();\n }\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n// The adoption check runs in a process of its own (./adopt): a DOM has to exist\n// before the app's modules load, because an adapter decides what it is running\n// in when it is imported.\ntype Adoption = { path: string; complaints: string[] };\n\nconst isAdoption = (value: unknown): value is Adoption =>\n value !== null &&\n typeof value === 'object' &&\n typeof Reflect.get(value, 'path') === 'string' &&\n Array.isArray(Reflect.get(value, 'complaints'));\n\nconst adoptAll = (root: string, pages: readonly { path: string; screen: string }[]): Adoption[] => {\n if (pages.length === 0) return [];\n const here = dirname(fileURLToPath(import.meta.url));\n // built: beside this file. From source (the package's own tests): in dist.\n const entry = [join(here, 'adopt.js'), join(here, '..', 'dist', 'adopt.js')].find((candidate) => existsSync(candidate));\n if (entry === undefined) throw new Error('nisc: the adoption check is not built (packages/cli/dist/adopt.js).');\n const scratch = mkdtempSync(join(tmpdir(), 'nisc-adopt-'));\n try {\n const [asked, answered] = [join(scratch, 'pages.json'), join(scratch, 'adopted.json')];\n writeFileSync(asked, JSON.stringify(pages));\n const result = spawnSync(process.execPath, [entry, root, asked, answered], { cwd: root, stdio: ['ignore', 'ignore', 'pipe'], encoding: 'utf8' });\n if (!existsSync(answered)) {\n const why = result.stderr.trim().split('\\n').slice(-6).join('\\n');\n return pages.map((page) => ({ path: page.path, complaints: [`the adoption check could not run${why === '' ? '' : ` — ${why}`}`] }));\n }\n const parsed: unknown = JSON.parse(readFileSync(answered, 'utf8'));\n return Array.isArray(parsed) ? parsed.filter(isAdoption) : [];\n } finally {\n rmSync(scratch, { recursive: true, force: true });\n }\n};\n\nexport const surveyShell = async (root: string, project: NiscShellProject, template: string): Promise<ShellRouteReport[]> => {\n if (!template.includes(DEFAULT_ROOT)) {\n throw new Error(`nisc: the built index.html has no empty root (${DEFAULT_ROOT}) — that is where a screen goes.`);\n }\n const paths = project.paths === undefined ? ['/'] : await project.paths();\n const none = { actions: [], opensWith: [], callsLater: [], listens: [] };\n\n const first: { path: string; drawn?: Drawn; problems: string[] }[] = [];\n for (const path of paths) {\n const problems: string[] = [];\n let drawn: Drawn | undefined;\n try {\n drawn = await drawOnce(project, path);\n if (drawn.screen.trim() === '') problems.push('drawn: it drew to nothing');\n if (!drawn.whole) problems.push(`whole: it was still loading after ${project.waitMs ?? DEFAULT_BUILD_WAIT_MS}ms`);\n for (const why of drawn.head?.refused ?? []) problems.push(`head: ${why}`);\n const again = await drawOnce(project, path);\n if (again.screen !== drawn.screen) problems.push(`same twice: a second boot drew different markup${differenceOf(drawn.screen, again.screen)}`);\n const [head, headAgain] = [JSON.stringify(drawn.head ?? null), JSON.stringify(again.head ?? null)];\n if (headAgain !== head) problems.push(`same twice: a second boot said a different head${differenceOf(head, headAgain)}`);\n } catch (error) {\n problems.push(`drawn: ${said(error)}`);\n }\n first.push({ path, ...(drawn !== undefined ? { drawn } : {}), problems });\n }\n\n const adoptable = first.flatMap((route) => (route.drawn !== undefined && route.drawn.whole && route.drawn.screen.trim() !== '' ? [{ path: route.path, screen: route.drawn.screen }] : []));\n const adoptions = new Map(adoptAll(root, adoptable).map((adoption) => [adoption.path, adoption.complaints]));\n\n return first.map((route) => {\n const asked = adoptable.some((page) => page.path === route.path);\n const complaints = asked ? (adoptions.get(route.path) ?? ['the adoption check said nothing about it']) : [];\n const problems = [...route.problems, ...complaints.map((complaint) => `adopted: ${complaint}`)];\n return {\n path: route.path,\n html: route.drawn === undefined ? template : documentOf(project, template, route.path, route.drawn),\n problems,\n ...(route.drawn?.facts ?? none),\n ...(route.drawn?.head !== undefined ? { head: route.drawn.head } : {}),\n };\n });\n};\n\nconst differenceOf = (a: string, b: string): string => {\n let at = 0;\n while (at < a.length && at < b.length && a[at] === b[at]) at += 1;\n const around = (text: string): string => JSON.stringify(text.slice(Math.max(0, at - 30), at + 50));\n return ` — at character ${at}: ${around(a)} then ${around(b)}`;\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const shellRouteTable = (routes: readonly ShellRouteReport[]): string => {\n const width = Math.max(5, ...routes.map((route) => route.path.length)) + 2;\n const lines = [` ${pad('Route', width)}First screen`];\n const indent = ' '.repeat(width + 2);\n const says = (route: ShellRouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const headNote = (route: ShellRouteReport): string =>\n says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own';\n for (const route of routes) {\n const ok = route.problems.length === 0;\n const notes = ok\n ? [\n `drawn · whole · same twice · adopted${route.actions.length > 0 ? ` (${route.actions.join(', ')})` : ''}`,\n ...(route.opensWith.length > 0 ? [`opened with ${route.opensWith.join(', ')} — in the file as answered at build`] : []),\n ...(route.callsLater.length > 0 ? [`can still call ${route.callsLater.join(', ')}`] : []),\n ...(route.listens.length > 0 ? [`waits on ${route.listens.join(', ')}`] : []),\n ...(headed ? [headNote(route)] : []),\n ]\n : route.problems;\n const [head, ...rest] = notes;\n lines.push(`${ok ? '○' : '✗'} ${pad(route.path, width)}${head ?? ''}`);\n for (const note of rest) lines.push(`${indent}${note}`);\n }\n lines.push('');\n lines.push('○ a file: the first screen, drawn for nobody in particular; the page’s own shell picks it up');\n lines.push('✗ not written: a check did not hold');\n return lines.join('\\n');\n};\n\nconst TYPES: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'text/javascript; charset=utf-8',\n '.mjs': 'text/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.json': 'application/json; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.ico': 'image/x-icon',\n '.woff2': 'font/woff2',\n '.woff': 'font/woff',\n '.wasm': 'application/wasm',\n '.data': 'application/octet-stream',\n '.map': 'application/json; charset=utf-8',\n '.txt': 'text/plain; charset=utf-8',\n};\n\nexport const shellSite = (project: NiscShellProject, dist: string): ((request: Request) => Promise<Response>) => {\n const base = resolve(dist);\n return async (request) => {\n const path = decodeURIComponent(new URL(request.url).pathname);\n if (path !== '/' && path !== '/index.html') {\n const file = resolve(base, `.${path}`);\n const stats = file === base || file.startsWith(base + sep) ? statSync(file, { throwIfNoEntry: false }) : undefined;\n if (stats?.isFile() === true) {\n return new Response(readFileSync(file), {\n headers: { 'content-type': TYPES[extname(file)] ?? 'application/octet-stream', 'content-length': String(stats.size), 'last-modified': stats.mtime.toUTCString() },\n });\n }\n if (extname(path) !== '') return new Response('not found', { status: 404 });\n }\n const template = readFileSync(join(base, 'index.html'), 'utf8');\n const headers = { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' };\n try {\n const at = path === '/index.html' ? '/' : path;\n return new Response(documentOf(project, template, at, await drawOnce(project, at)), { headers });\n } catch (error) {\n console.error(`[nisc] \"${path}\" could not be drawn — serving it undrawn:`, error);\n return new Response(template, { headers });\n }\n };\n};\n","export type RouteReport = {\n path: string;\n page?: string;\n drawn: boolean;\n live: boolean;\n why: readonly string[];\n drawnWith: readonly string[];\n settled: boolean;\n head?: { elements: readonly unknown[]; actions: readonly string[] };\n};\n\nexport const defaultPaths = (pages: readonly { name: string; path: string }[]): string[] => [\n '/',\n ...pages\n .map((page) => page.path)\n .filter((path) => !path.split('/').some((segment) => segment.startsWith(':')))\n .sort(),\n];\n\nexport const fileOf = (path: string): string => {\n const segments = path.split('?')[0]?.split('/').filter((segment) => segment !== '') ?? [];\n if (segments.some((segment) => segment === '..' || segment === '.')) throw new Error(`nisc: \"${path}\" is not a path a file can be written for.`);\n return [...segments, 'index.html'].join('/');\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const routeTable = (routes: readonly RouteReport[]): string => {\n const says = (route: RouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const rows = routes.map((route) => {\n const mark = !route.drawn ? '✗' : route.live ? '●' : '○';\n const what = route.page === undefined ? 'the app' : `page ${route.page}`;\n const served = !route.drawn ? 'not drawn' : route.live ? 'server' : 'file';\n const notes = [\n ...(route.drawn ? route.why : ['it could not be drawn — it goes out as the undrawn template']),\n ...(route.drawn && !route.settled ? ['it was still loading when the wait ran out — drawn with what it had'] : []),\n ...(route.drawnWith.length > 0 ? [`drawn with ${route.drawnWith.join(', ')} — as it answered at build`] : []),\n ];\n const head = headed && route.drawn ? [says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own'] : [];\n return { mark, path: route.path, what, served, notes, head };\n });\n const widths = {\n path: Math.max(5, ...rows.map((row) => row.path.length)),\n what: Math.max(4, ...rows.map((row) => row.what.length)),\n served: Math.max(9, ...rows.map((row) => row.served.length)),\n };\n const lines = [` ${pad('Route', widths.path + 2)}${pad('What', widths.what + 2)}${pad('Served as', widths.served + 2)}Because`];\n for (const row of rows) {\n const head = `${row.mark} ${pad(row.path, widths.path + 2)}${pad(row.what, widths.what + 2)}${pad(row.served, widths.served + 2)}`;\n const [first, ...rest] = [...(row.notes.length > 0 ? row.notes : ['nothing on it can still happen']), ...row.head];\n lines.push(`${head}${first ?? ''}`);\n for (const note of rest) lines.push(`${' '.repeat(head.length)}${note}`);\n }\n lines.push('');\n lines.push('○ file drawn once, for nobody in particular; nothing on it can still happen');\n lines.push('● server something on it can still happen; it wants moss behind it');\n return lines.join('\\n');\n};\n"]}
1
+ {"version":3,"sources":["../src/serve/shell-site.ts","../src/build/routes.ts"],"names":["pad"],"mappings":"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","file":"index.js","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { dirname, extname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { shellSettled, shellView } from '@niscorp/nova';\nimport type { Shell } from '@niscorp/nova';\nimport { headOf, placeHead } from '@niscorp/nova/document';\nimport type { ScreenHead } from '@niscorp/nova/document';\nimport { livenessOf } from '@niscorp/nova/reflect';\nimport type { NiscShellProject } from '../project';\n\nconst DEFAULT_BUILD_WAIT_MS = 5000;\nexport const DEFAULT_ROOT = '<div id=\"root\"></div>';\n\nexport type ShellRouteReport = {\n path: string;\n html: string;\n problems: readonly string[];\n actions: readonly string[];\n opensWith: readonly string[];\n callsLater: readonly string[];\n listens: readonly string[];\n head?: ScreenHead;\n};\n\nconst escapeAttribute = (value: string): string => value.replace(/&/g, '&amp;').replace(/\"/g, '&quot;').replace(/</g, '&lt;');\n\nexport const placeScreen = (template: string, screen: string, attributes: Record<string, string> = {}, root = DEFAULT_ROOT): string => {\n const written = Object.entries(attributes)\n .map(([name, value]) => ` ${name}=\"${escapeAttribute(value)}\"`)\n .join('');\n return (\n template\n // functions, both, so nothing in the screen is read as a replacement pattern\n .replace(root, () => root.replace('></div>', () => `>${screen}</div>`))\n .replace(/<html([^>]*)>/, (whole, existing: string) => (written === '' ? whole : `<html${existing}${written}>`))\n );\n};\n\nconst factsOf = (shell: Shell): Pick<ShellRouteReport, 'actions' | 'opensWith' | 'callsLater' | 'listens'> => {\n const [actions, opensWith, callsLater, listens] = [new Set<string>(), new Set<string>(), new Set<string>(), new Set<string>()];\n for (const canvas of Object.values(shell.getState().canvases)) {\n for (const instance of canvas.stack) {\n const definition = shell.getRuntime(instance.id)?.definition;\n if (definition === undefined) continue;\n actions.add(definition.id);\n const liveness = livenessOf(definition);\n for (const channel of liveness.listens) listens.add(channel);\n for (const endpoint of liveness.endpoints) {\n const label = `${definition.id}.${endpoint.name}${endpoint.kind === 'fn' ? ' (a function)' : endpoint.url !== undefined ? ` (${endpoint.url})` : ''}`;\n if (endpoint.onOpen) opensWith.add(label);\n if (endpoint.later) callsLater.add(label);\n }\n }\n }\n const sorted = (set: Set<string>): string[] => [...set].sort();\n return { actions: sorted(actions), opensWith: sorted(opensWith), callsLater: sorted(callsLater), listens: sorted(listens) };\n};\n\ntype Drawn = { screen: string; whole: boolean; attributes: Record<string, string>; head: ScreenHead | undefined; facts: ReturnType<typeof factsOf> };\n\nconst documentOf = (project: NiscShellProject, template: string, path: string, drawn: Drawn): string =>\n placeHead(placeScreen(template, drawn.screen, drawn.attributes), drawn.head?.elements, { ...(project.site !== undefined ? { site: project.site } : {}), path });\n\nconst drawOnce = async (project: NiscShellProject, path: string): Promise<Drawn> => {\n const booted = await project.shell({ path });\n try {\n const whole = await shellSettled(booted.shell, { waitMs: project.waitMs ?? DEFAULT_BUILD_WAIT_MS });\n const screen = await project.draw(booted.shell);\n return { screen, whole, attributes: project.htmlAttributes?.(booted.shell) ?? {}, head: headOf(shellView(booted.shell).api), facts: factsOf(booted.shell) };\n } finally {\n await booted.close?.();\n }\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n// The adoption check runs in a process of its own (./adopt): a DOM has to exist\n// before the app's modules load, because an adapter decides what it is running\n// in when it is imported.\ntype Adoption = { path: string; complaints: string[] };\n\nconst isAdoption = (value: unknown): value is Adoption =>\n value !== null &&\n typeof value === 'object' &&\n typeof Reflect.get(value, 'path') === 'string' &&\n Array.isArray(Reflect.get(value, 'complaints'));\n\nconst adoptAll = (root: string, pages: readonly { path: string; screen: string }[]): Adoption[] => {\n if (pages.length === 0) return [];\n const here = dirname(fileURLToPath(import.meta.url));\n // built: beside this file. From source (the package's own tests): in dist.\n const entry = [join(here, 'adopt.js'), join(here, '..', '..', 'dist', 'adopt.js')].find((candidate) => existsSync(candidate));\n if (entry === undefined) throw new Error('nisc: the adoption check is not built (packages/cli/dist/adopt.js).');\n const scratch = mkdtempSync(join(tmpdir(), 'nisc-adopt-'));\n try {\n const [asked, answered] = [join(scratch, 'pages.json'), join(scratch, 'adopted.json')];\n writeFileSync(asked, JSON.stringify(pages));\n const result = spawnSync(process.execPath, [entry, root, asked, answered], { cwd: root, stdio: ['ignore', 'ignore', 'pipe'], encoding: 'utf8' });\n if (!existsSync(answered)) {\n const why = result.stderr.trim().split('\\n').slice(-6).join('\\n');\n return pages.map((page) => ({ path: page.path, complaints: [`the adoption check could not run${why === '' ? '' : ` — ${why}`}`] }));\n }\n const parsed: unknown = JSON.parse(readFileSync(answered, 'utf8'));\n return Array.isArray(parsed) ? parsed.filter(isAdoption) : [];\n } finally {\n rmSync(scratch, { recursive: true, force: true });\n }\n};\n\nexport const surveyShell = async (root: string, project: NiscShellProject, template: string): Promise<ShellRouteReport[]> => {\n if (!template.includes(DEFAULT_ROOT)) {\n throw new Error(`nisc: the built index.html has no empty root (${DEFAULT_ROOT}) — that is where a screen goes.`);\n }\n const paths = project.paths === undefined ? ['/'] : await project.paths();\n const none = { actions: [], opensWith: [], callsLater: [], listens: [] };\n\n const first: { path: string; drawn?: Drawn; problems: string[] }[] = [];\n for (const path of paths) {\n const problems: string[] = [];\n let drawn: Drawn | undefined;\n try {\n drawn = await drawOnce(project, path);\n if (drawn.screen.trim() === '') problems.push('drawn: it drew to nothing');\n if (!drawn.whole) problems.push(`whole: it was still loading after ${project.waitMs ?? DEFAULT_BUILD_WAIT_MS}ms`);\n for (const why of drawn.head?.refused ?? []) problems.push(`head: ${why}`);\n const again = await drawOnce(project, path);\n if (again.screen !== drawn.screen) problems.push(`same twice: a second boot drew different markup${differenceOf(drawn.screen, again.screen)}`);\n const [head, headAgain] = [JSON.stringify(drawn.head ?? null), JSON.stringify(again.head ?? null)];\n if (headAgain !== head) problems.push(`same twice: a second boot said a different head${differenceOf(head, headAgain)}`);\n } catch (error) {\n problems.push(`drawn: ${said(error)}`);\n }\n first.push({ path, ...(drawn !== undefined ? { drawn } : {}), problems });\n }\n\n const adoptable = first.flatMap((route) => (route.drawn !== undefined && route.drawn.whole && route.drawn.screen.trim() !== '' ? [{ path: route.path, screen: route.drawn.screen }] : []));\n const adoptions = new Map(adoptAll(root, adoptable).map((adoption) => [adoption.path, adoption.complaints]));\n\n return first.map((route) => {\n const asked = adoptable.some((page) => page.path === route.path);\n const complaints = asked ? (adoptions.get(route.path) ?? ['the adoption check said nothing about it']) : [];\n const problems = [...route.problems, ...complaints.map((complaint) => `adopted: ${complaint}`)];\n return {\n path: route.path,\n html: route.drawn === undefined ? template : documentOf(project, template, route.path, route.drawn),\n problems,\n ...(route.drawn?.facts ?? none),\n ...(route.drawn?.head !== undefined ? { head: route.drawn.head } : {}),\n };\n });\n};\n\nconst differenceOf = (a: string, b: string): string => {\n let at = 0;\n while (at < a.length && at < b.length && a[at] === b[at]) at += 1;\n const around = (text: string): string => JSON.stringify(text.slice(Math.max(0, at - 30), at + 50));\n return ` — at character ${at}: ${around(a)} then ${around(b)}`;\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const shellRouteTable = (routes: readonly ShellRouteReport[]): string => {\n const width = Math.max(5, ...routes.map((route) => route.path.length)) + 2;\n const lines = [` ${pad('Route', width)}First screen`];\n const indent = ' '.repeat(width + 2);\n const says = (route: ShellRouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const headNote = (route: ShellRouteReport): string =>\n says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own';\n for (const route of routes) {\n const ok = route.problems.length === 0;\n const notes = ok\n ? [\n `drawn · whole · same twice · adopted${route.actions.length > 0 ? ` (${route.actions.join(', ')})` : ''}`,\n ...(route.opensWith.length > 0 ? [`opened with ${route.opensWith.join(', ')} — in the file as answered at build`] : []),\n ...(route.callsLater.length > 0 ? [`can still call ${route.callsLater.join(', ')}`] : []),\n ...(route.listens.length > 0 ? [`waits on ${route.listens.join(', ')}`] : []),\n ...(headed ? [headNote(route)] : []),\n ]\n : route.problems;\n const [head, ...rest] = notes;\n lines.push(`${ok ? '○' : '✗'} ${pad(route.path, width)}${head ?? ''}`);\n for (const note of rest) lines.push(`${indent}${note}`);\n }\n lines.push('');\n lines.push('○ a file: the first screen, drawn for nobody in particular; the page’s own shell picks it up');\n lines.push('✗ not written: a check failed');\n return lines.join('\\n');\n};\n\nconst TYPES: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'text/javascript; charset=utf-8',\n '.mjs': 'text/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.json': 'application/json; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.ico': 'image/x-icon',\n '.woff2': 'font/woff2',\n '.woff': 'font/woff',\n '.wasm': 'application/wasm',\n '.data': 'application/octet-stream',\n '.map': 'application/json; charset=utf-8',\n '.txt': 'text/plain; charset=utf-8',\n};\n\nconst decodedPath = (pathname: string): string | undefined => {\n try {\n const path = decodeURIComponent(pathname);\n return path.includes('\\0') ? undefined : path;\n } catch {\n return undefined;\n }\n};\n\nexport const shellSite = (project: NiscShellProject, dist: string): ((request: Request) => Promise<Response>) => {\n const base = resolve(dist);\n return async (request) => {\n const path = decodedPath(new URL(request.url).pathname);\n if (path === undefined) return new Response('not a path', { status: 400 });\n if (path !== '/' && path !== '/index.html') {\n const file = resolve(base, `.${path}`);\n const stats = file === base || file.startsWith(base + sep) ? statSync(file, { throwIfNoEntry: false }) : undefined;\n if (stats?.isFile() === true) {\n return new Response(readFileSync(file), {\n headers: { 'content-type': TYPES[extname(file)] ?? 'application/octet-stream', 'content-length': String(stats.size), 'last-modified': stats.mtime.toUTCString() },\n });\n }\n if (extname(path) !== '') return new Response('not found', { status: 404 });\n }\n const template = readFileSync(join(base, 'index.html'), 'utf8');\n const headers = { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' };\n try {\n const at = path === '/index.html' ? '/' : path;\n return new Response(documentOf(project, template, at, await drawOnce(project, at)), { headers });\n } catch (error) {\n console.error(`[nisc] \"${path}\" could not be drawn — serving it undrawn:`, error);\n return new Response(template, { headers });\n }\n };\n};\n","export type RouteReport = {\n path: string;\n page?: string;\n drawn: boolean;\n live: boolean;\n why: readonly string[];\n drawnWith: readonly string[];\n settled: boolean;\n head?: { elements: readonly unknown[]; actions: readonly string[] };\n};\n\nexport const defaultPaths = (pages: readonly { name: string; path: string }[]): string[] => [\n '/',\n ...pages\n .map((page) => page.path)\n .filter((path) => !path.split('/').some((segment) => segment.startsWith(':')))\n .sort(),\n];\n\nexport const fileOf = (path: string): string => {\n const segments = path.split('?')[0]?.split('/').filter((segment) => segment !== '') ?? [];\n if (segments.some((segment) => segment === '..' || segment === '.')) throw new Error(`nisc: \"${path}\" is not a path a file can be written for.`);\n return [...segments, 'index.html'].join('/');\n};\n\nconst pad = (text: string, width: number): string => text + ' '.repeat(Math.max(0, width - text.length));\n\nexport const routeTable = (routes: readonly RouteReport[]): string => {\n const says = (route: RouteReport): boolean => (route.head?.elements.length ?? 0) > 0;\n const headed = routes.some(says);\n const rows = routes.map((route) => {\n const mark = !route.drawn ? '✗' : route.live ? '●' : '○';\n const what = route.page === undefined ? 'the app' : `page ${route.page}`;\n const served = !route.drawn ? 'not drawn' : route.live ? 'server' : 'file';\n const notes = [\n ...(route.drawn ? route.why : ['it could not be drawn — it goes out as the undrawn template']),\n ...(route.drawn && !route.settled ? ['it was still loading when the wait ran out — drawn with what it had'] : []),\n ...(route.drawnWith.length > 0 ? [`drawn with ${route.drawnWith.join(', ')} — as it answered at build`] : []),\n ];\n const head = headed && route.drawn ? [says(route) ? `head: its own, said by ${route.head?.actions.join(', ') || 'the shell’s chrome'}` : 'head: the template’s own'] : [];\n return { mark, path: route.path, what, served, notes, head };\n });\n const widths = {\n path: Math.max(5, ...rows.map((row) => row.path.length)),\n what: Math.max(4, ...rows.map((row) => row.what.length)),\n served: Math.max(9, ...rows.map((row) => row.served.length)),\n };\n const lines = [` ${pad('Route', widths.path + 2)}${pad('What', widths.what + 2)}${pad('Served as', widths.served + 2)}Because`];\n for (const row of rows) {\n const head = `${row.mark} ${pad(row.path, widths.path + 2)}${pad(row.what, widths.what + 2)}${pad(row.served, widths.served + 2)}`;\n const [first, ...rest] = [...(row.notes.length > 0 ? row.notes : ['nothing on it can still happen']), ...row.head];\n lines.push(`${head}${first ?? ''}`);\n for (const note of rest) lines.push(`${' '.repeat(head.length)}${note}`);\n }\n lines.push('');\n lines.push('○ file drawn once, for nobody in particular; nothing on it can still happen');\n lines.push('● server something on it can still happen; it wants moss behind it');\n return lines.join('\\n');\n};\n"]}
@@ -0,0 +1,3 @@
1
+ export { configFileOf, distOf, isProject, isShellProject, loadProject, say, toolOf } from './chunk-VGA7OHHG.js';
2
+ //# sourceMappingURL=project-5TBKATKF.js.map
3
+ //# sourceMappingURL=project-5TBKATKF.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":[],"names":[],"mappings":"","file":"project-RA4IMQ4V.js"}
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"project-5TBKATKF.js"}
package/dist/shape.cjs CHANGED
@@ -29,16 +29,17 @@ var lastName = (ts, node) => {
29
29
  if (ts.isPropertyAccessExpression(node)) return node.name.text;
30
30
  return void 0;
31
31
  };
32
+ var isConst = (ts, type) => ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName) && type.typeName.text === "const";
32
33
  var hasModifier = (ts, node, kind) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);
33
34
  var findingsIn = (ts, file, source) => {
34
35
  const found = [];
35
36
  const inSrc = (folder) => file.startsWith(`src/${folder}/`);
36
- const at = (rule, node, what) => {
37
- found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, what });
37
+ const at = (rule, node, what, name = what) => {
38
+ found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, name, what });
38
39
  };
39
40
  const visit = (node) => {
40
- if (ts.isAsExpression(node) && !(ts.isTypeReferenceNode(node.type) && ts.isIdentifier(node.type.typeName) && node.type.typeName.text === "const")) at("style", node, `"as ${node.type.getText(source)}"`);
41
- if (ts.isTypeAssertionExpression(node)) at("style", node, 'a "<T>" assertion');
41
+ if (ts.isAsExpression(node) && !isConst(ts, node.type)) at("style", node, `"as ${node.type.getText(source)}"`);
42
+ if (ts.isTypeAssertionExpression(node) && !isConst(ts, node.type)) at("style", node, 'a "<T>" assertion');
42
43
  if (ts.isNonNullExpression(node)) at("style", node, 'a non-null "!"');
43
44
  if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at("style", node, "a function declaration");
44
45
  if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at("style", node, "a class");
@@ -46,20 +47,22 @@ var findingsIn = (ts, file, source) => {
46
47
  if (node.kind === ts.SyntaxKind.AnyKeyword) at("style", node, '"any"');
47
48
  if (ts.isExportAssignment(node) && node.isExportEquals !== true || ts.isExportSpecifier(node) && node.name.text === "default" || hasModifier(ts, node, ts.SyntaxKind.DefaultKeyword)) at("style", node, "a default export");
48
49
  if (!inSrc("dev")) {
49
- if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "Intl") at("formatting", node, `Intl.${node.name.text}`);
50
- if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith("toLocale")) at("formatting", node, `.${node.expression.name.text}()`);
50
+ if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "Intl") at("formatting", node, `Intl.${node.name.text}`, "Intl");
51
+ if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text.startsWith("toLocale")) {
52
+ at("formatting", node, `.${node.expression.name.text}()`, node.expression.name.text);
53
+ }
51
54
  }
52
55
  if (inSrc("server") && ts.isPropertyAccessExpression(node) && node.name.text === "roles") {
53
56
  const whose = lastName(ts, node.expression);
54
- if (whose === "session" || whose === "principal") at("roles", node, `${whose}.roles`);
57
+ if (whose === "session" || whose === "principal") at("roles", node, `${whose}.roles`, "roles");
55
58
  }
56
59
  if (inSrc("ui")) {
57
60
  if (ts.isIdentifier(node) && node.text === "FileReader" && !ts.isTypeReferenceNode(node.parent)) at("files", node, "FileReader");
58
61
  if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at("files", node, node.name.text);
59
- if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "location") at("address", node, `location.${node.name.text}`);
60
- if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "history" && ADDRESS_CHANGE.has(node.name.text)) at("address", node, `history.${node.name.text}`);
62
+ if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "location") at("address", node, `location.${node.name.text}`, "location");
63
+ if (ts.isPropertyAccessExpression(node) && lastName(ts, node.expression) === "history" && ADDRESS_CHANGE.has(node.name.text)) at("address", node, `history.${node.name.text}`, node.name.text);
61
64
  if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === "document") {
62
- at("dom", node, `document.${node.expression.name.text}`);
65
+ at("dom", node, `document.${node.expression.name.text}`, node.expression.name.text);
63
66
  }
64
67
  }
65
68
  ts.forEachChild(node, visit);
@@ -88,8 +91,7 @@ var importedNames = (ts, clause) => {
88
91
  const named = bindings !== void 0 && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];
89
92
  return [...clause.name === void 0 ? [] : [clause.name], ...named];
90
93
  };
91
- var appDataFindings = (ts, root) => {
92
- const program = programOf(ts, root);
94
+ var appDataFindings = (ts, root, program) => {
93
95
  const checker = program.getTypeChecker();
94
96
  const options = program.getCompilerOptions();
95
97
  return program.getSourceFiles().flatMap((source) => {
@@ -105,11 +107,78 @@ var appDataFindings = (ts, root) => {
105
107
  const calls = checker.getTypeAtLocation(name).getCallSignatures();
106
108
  if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];
107
109
  const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;
108
- return [{ rule: "data", file, line, what: `${name.text}, a function of ${from}` }];
110
+ const symbol = checker.getSymbolAtLocation(name);
111
+ const declared = symbol !== void 0 && (symbol.flags & ts.SymbolFlags.Alias) !== 0 ? checker.getAliasedSymbol(symbol).getName() : name.text;
112
+ return [{ rule: "data", file, line, name: declared, what: `${name.text}, a function of ${from}` }];
109
113
  });
110
114
  });
111
115
  });
112
116
  };
117
+ var packageRootOf = (ts, file) => {
118
+ const up = path.dirname(file);
119
+ if (ts.sys.fileExists(path.join(up, "package.json"))) return up;
120
+ return up === file ? void 0 : packageRootOf(ts, up);
121
+ };
122
+ var referenceFindings = (ts, root, program) => {
123
+ const checker = program.getTypeChecker();
124
+ const moss = ts.resolveModuleName("@niscorp/moss", path.join(root, "package.json"), program.getCompilerOptions(), ts.sys).resolvedModule?.resolvedFileName;
125
+ const mossRoot = moss === void 0 ? void 0 : packageRootOf(ts, path.resolve(moss));
126
+ const isDeclaredIn = (symbol, where) => (symbol?.declarations ?? []).some((declaration) => where(declaration.getSourceFile()));
127
+ const isLibrary = (symbol) => isDeclaredIn(symbol, (source) => program.isSourceFileDefaultLibrary(source));
128
+ const isMoss = (symbol) => mossRoot !== void 0 && isDeclaredIn(symbol, (source) => path.resolve(source.fileName).startsWith(`${mossRoot}${path.sep}`));
129
+ const typeIs = (node, name) => {
130
+ const symbol = checker.getTypeAtLocation(node).getSymbol();
131
+ return symbol?.getName() === name && isLibrary(symbol);
132
+ };
133
+ const unaliased = (symbol) => symbol !== void 0 && (symbol.flags & ts.SymbolFlags.Alias) !== 0 ? checker.getAliasedSymbol(symbol) : symbol;
134
+ const referredOf = (node) => {
135
+ const bound = node.parent;
136
+ if (ts.isBindingElement(bound) && bound.name === node && ts.isObjectBindingPattern(bound.parent)) {
137
+ const property = bound.propertyName ?? node;
138
+ return ts.isIdentifier(property) || ts.isStringLiteral(property) ? unaliased(checker.getTypeAtLocation(bound.parent).getProperty(property.text)) : void 0;
139
+ }
140
+ return unaliased(checker.getSymbolAtLocation(node));
141
+ };
142
+ const isAppFunction = (symbol, node) => {
143
+ const declared = symbol.valueDeclaration;
144
+ if (declared === void 0 || !pathOf(root, path.resolve(declared.getSourceFile().fileName)).startsWith("src/app/")) return false;
145
+ const calls = checker.getTypeOfSymbolAtLocation(symbol, node).getCallSignatures();
146
+ return calls.length > 0 && !calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())));
147
+ };
148
+ return program.getSourceFiles().flatMap((source) => {
149
+ const file = pathOf(root, path.resolve(source.fileName));
150
+ if (!file.startsWith("src/") || source.isDeclarationFile) return [];
151
+ const inSrc = (folder) => file.startsWith(`src/${folder}/`);
152
+ const found = [];
153
+ const at = (rule, node, name, what = name) => {
154
+ found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, name, what });
155
+ };
156
+ const isTypeOnly = (node) => (ts.isImportClause(node) || ts.isImportSpecifier(node) || ts.isExportDeclaration(node) || ts.isExportSpecifier(node)) && node.isTypeOnly;
157
+ const visit = (node, isType) => {
158
+ const isName = ts.isIdentifier(node) || ts.isStringLiteral(node) && ts.isElementAccessExpression(node.parent) && node.parent.argumentExpression === node;
159
+ const referred = !isType && isName ? referredOf(node) : void 0;
160
+ if (referred !== void 0) {
161
+ if (!inSrc("dev") && referred.getName() === "Intl" && isLibrary(referred)) at("formatting", node, "Intl", "Intl, the global one");
162
+ if (inSrc("server") && referred.getName() === "roles" && isMoss(referred)) at("roles", node, "roles", "roles, read off a moss session");
163
+ if (!inSrc("app") && !inSrc("dev") && isAppFunction(referred, node)) {
164
+ at("data", node, referred.getName(), `${referred.getName()}, a function of ${pathOf(root, path.resolve(referred.valueDeclaration?.getSourceFile().fileName ?? ""))}`);
165
+ }
166
+ }
167
+ if (!isType && inSrc("ui")) {
168
+ const isLocation = (ts.isIdentifier(node) || ts.isPropertyAccessExpression(node) || ts.isElementAccessExpression(node)) && typeIs(node, "Location");
169
+ if (isLocation && !(ts.isExpression(node.parent) && typeIs(node.parent, "Location"))) at("address", node, "location", `location, as ${node.getText(source)}`);
170
+ if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression)) {
171
+ const { name, expression } = node.expression;
172
+ if (ADDRESS_CHANGE.has(name.text) && typeIs(expression, "History")) at("address", node, name.text, `${name.text} on a History`);
173
+ if (FIND_ELEMENTS.has(name.text) && typeIs(expression, "Document")) at("dom", node, name.text, `${name.text} on a Document`);
174
+ }
175
+ }
176
+ ts.forEachChild(node, (child) => visit(child, isType || ts.isTypeNode(node) || isTypeOnly(node)));
177
+ };
178
+ visit(source, false);
179
+ return found;
180
+ });
181
+ };
113
182
  var isTypeScript = (value) => value !== null && typeof value === "object" && typeof Reflect.get(value, "createProgram") === "function" && typeof Reflect.get(value, "version") === "string";
114
183
  var loadTypeScript = (root) => {
115
184
  const require2 = module$1.createRequire(path.join(root, "package.json"));
@@ -142,6 +211,16 @@ var replayOf = (endpoint) => {
142
211
  const fingerprint = request["fingerprint"];
143
212
  return typeof fingerprint === "string" ? { fingerprint } : {};
144
213
  };
214
+ var messageOf = (error) => error instanceof Error ? error.message : String(error);
215
+ var readSource = (root) => {
216
+ try {
217
+ const ts = loadTypeScript(root);
218
+ const program = programOf(ts, root);
219
+ return { ts, program, findings: [...sourceFindings(ts, root), ...appDataFindings(ts, root, program)] };
220
+ } catch (error) {
221
+ return messageOf(error);
222
+ }
223
+ };
145
224
  var runShapeCheck = (config) => {
146
225
  const log = config.log ?? ((line) => console.log(line));
147
226
  let failures = 0;
@@ -153,20 +232,34 @@ var runShapeCheck = (config) => {
153
232
  log(failures === 0 ? "[pass] shape: all checks passed" : `[fail] shape: ${failures} check(s) failed`);
154
233
  return failures === 0 ? 0 : 1;
155
234
  };
156
- let findings;
157
- try {
158
- const ts = loadTypeScript(config.root);
159
- findings = [...sourceFindings(ts, config.root), ...appDataFindings(ts, config.root)];
160
- } catch (error) {
161
- check("the source is read", false, [error instanceof Error ? error.message : String(error)]);
235
+ const read = readSource(config.root);
236
+ if (typeof read === "string") {
237
+ check("the source is read", false, [read]);
162
238
  return done();
163
239
  }
240
+ const { findings } = read;
164
241
  const allow = config.allow ?? {};
165
242
  for (const [rule, what] of RULES) {
166
243
  const allowed = allow[rule] ?? {};
167
244
  const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === void 0);
168
245
  check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));
169
246
  }
247
+ try {
248
+ const failed = new Set(findings.map((finding) => `${finding.rule} ${finding.file} ${finding.name}`));
249
+ const shown = /* @__PURE__ */ new Set();
250
+ const others = referenceFindings(read.ts, config.root, read.program).filter((finding) => {
251
+ const key = `${finding.rule} ${finding.file} ${finding.name}`;
252
+ if (failed.has(key) || allow[finding.rule]?.[finding.file] !== void 0 || shown.has(`${key} ${finding.line}`)) return false;
253
+ shown.add(`${key} ${finding.line}`);
254
+ return true;
255
+ });
256
+ const ruleOf = new Map(RULES.map(([rule, what]) => [rule, what.split(":")[0] ?? what]));
257
+ for (const finding of others) {
258
+ log(`[info] ${ruleOf.get(finding.rule) ?? finding.rule}: ${finding.file}:${finding.line} ${finding.what} \u2014 another spelling of what the rule fails on; reported, not failed`);
259
+ }
260
+ } catch (error) {
261
+ log(`[info] what names refer to could not be read, so other spellings are not reported: ${messageOf(error)}`);
262
+ }
170
263
  const idle = RULES.flatMap(
171
264
  ([rule]) => Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {
172
265
  if (reason.trim() === "") return [`${rule}: ${file} gives no reason`];