@niscorp/cli 0.9.0 → 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 ADDED
@@ -0,0 +1,294 @@
1
+ 'use strict';
2
+
3
+ var fs = require('fs');
4
+ var path = require('path');
5
+ var module$1 = require('module');
6
+
7
+ // src/shape/index.ts
8
+ var SOURCE = /\.(ts|tsx|mts|cts)$/;
9
+ var pathOf = (root, file) => path.relative(root, file).split(path.sep).join("/");
10
+ var sourceFilesOf = (root, dir = path.join(root, "src")) => {
11
+ let entries;
12
+ try {
13
+ entries = fs.readdirSync(dir, { withFileTypes: true });
14
+ } catch {
15
+ return [];
16
+ }
17
+ return entries.flatMap((entry) => {
18
+ if (entry.name === "node_modules") return [];
19
+ const path$1 = path.join(dir, entry.name);
20
+ if (entry.isDirectory()) return sourceFilesOf(root, path$1);
21
+ return SOURCE.test(entry.name) && !entry.name.endsWith(".d.ts") ? [path$1] : [];
22
+ });
23
+ };
24
+ var READ_FILE = /* @__PURE__ */ new Set(["readAsDataURL", "readAsText", "readAsArrayBuffer", "readAsBinaryString"]);
25
+ var FIND_ELEMENTS = /* @__PURE__ */ new Set(["querySelector", "querySelectorAll", "getElementById", "getElementsByClassName", "getElementsByTagName", "getElementsByName"]);
26
+ var ADDRESS_CHANGE = /* @__PURE__ */ new Set(["pushState", "replaceState"]);
27
+ var lastName = (ts, node) => {
28
+ if (ts.isIdentifier(node)) return node.text;
29
+ if (ts.isPropertyAccessExpression(node)) return node.name.text;
30
+ return void 0;
31
+ };
32
+ var isConst = (ts, type) => ts.isTypeReferenceNode(type) && ts.isIdentifier(type.typeName) && type.typeName.text === "const";
33
+ var hasModifier = (ts, node, kind) => ts.canHaveModifiers(node) && (ts.getModifiers(node) ?? []).some((modifier) => modifier.kind === kind);
34
+ var findingsIn = (ts, file, source) => {
35
+ const found = [];
36
+ const inSrc = (folder) => file.startsWith(`src/${folder}/`);
37
+ const at = (rule, node, what, name = what) => {
38
+ found.push({ rule, file, line: source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1, name, what });
39
+ };
40
+ const visit = (node) => {
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');
43
+ if (ts.isNonNullExpression(node)) at("style", node, 'a non-null "!"');
44
+ if (ts.isFunctionDeclaration(node) && !hasModifier(ts, node, ts.SyntaxKind.DeclareKeyword)) at("style", node, "a function declaration");
45
+ if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) at("style", node, "a class");
46
+ if (ts.isEnumDeclaration(node)) at("style", node, "an enum");
47
+ if (node.kind === ts.SyntaxKind.AnyKeyword) at("style", node, '"any"');
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");
49
+ if (!inSrc("dev")) {
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
+ }
54
+ }
55
+ if (inSrc("server") && ts.isPropertyAccessExpression(node) && node.name.text === "roles") {
56
+ const whose = lastName(ts, node.expression);
57
+ if (whose === "session" || whose === "principal") at("roles", node, `${whose}.roles`, "roles");
58
+ }
59
+ if (inSrc("ui")) {
60
+ if (ts.isIdentifier(node) && node.text === "FileReader" && !ts.isTypeReferenceNode(node.parent)) at("files", node, "FileReader");
61
+ if (ts.isPropertyAccessExpression(node) && READ_FILE.has(node.name.text)) at("files", node, 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);
64
+ if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && FIND_ELEMENTS.has(node.expression.name.text) && lastName(ts, node.expression.expression) === "document") {
65
+ at("dom", node, `document.${node.expression.name.text}`, node.expression.name.text);
66
+ }
67
+ }
68
+ ts.forEachChild(node, visit);
69
+ };
70
+ visit(source);
71
+ return found;
72
+ };
73
+ var sourceFindings = (ts, root) => sourceFilesOf(root).flatMap((path) => {
74
+ const file = pathOf(root, path);
75
+ const source = ts.createSourceFile(file, fs.readFileSync(path, "utf8"), ts.ScriptTarget.Latest, true, path.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
76
+ return findingsIn(ts, file, source);
77
+ });
78
+
79
+ // src/shape/app-data.ts
80
+ var MANIFEST = /^(Promise<)?NiscApp>?$/;
81
+ var programOf = (ts, root) => {
82
+ const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json");
83
+ if (config === void 0 || !path.resolve(config).startsWith(path.resolve(root))) throw new Error(`the shape check reads the app as its tsconfig.json says, and ${root} has none.`);
84
+ const parsed = ts.getParsedCommandLineOfConfigFile(config, {}, { ...ts.sys, onUnRecoverableConfigFileDiagnostic: () => void 0 });
85
+ if (parsed === void 0) throw new Error(`${config} could not be read.`);
86
+ return ts.createProgram({ rootNames: parsed.fileNames, options: parsed.options });
87
+ };
88
+ var importedNames = (ts, clause) => {
89
+ if (clause === void 0 || clause.isTypeOnly) return [];
90
+ const bindings = clause.namedBindings;
91
+ const named = bindings !== void 0 && ts.isNamedImports(bindings) ? bindings.elements.filter((element) => !element.isTypeOnly).map((element) => element.name) : [];
92
+ return [...clause.name === void 0 ? [] : [clause.name], ...named];
93
+ };
94
+ var appDataFindings = (ts, root, program) => {
95
+ const checker = program.getTypeChecker();
96
+ const options = program.getCompilerOptions();
97
+ return program.getSourceFiles().flatMap((source) => {
98
+ const file = pathOf(root, path.resolve(source.fileName));
99
+ if (!file.startsWith("src/") || file.startsWith("src/app/") || file.startsWith("src/dev/") || source.isDeclarationFile) return [];
100
+ return source.statements.flatMap((statement) => {
101
+ if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) return [];
102
+ const target = ts.resolveModuleName(statement.moduleSpecifier.text, source.fileName, options, ts.sys).resolvedModule?.resolvedFileName;
103
+ if (target === void 0) return [];
104
+ const from = pathOf(root, path.resolve(target));
105
+ if (!from.startsWith("src/app/")) return [];
106
+ return importedNames(ts, statement.importClause).flatMap((name) => {
107
+ const calls = checker.getTypeAtLocation(name).getCallSignatures();
108
+ if (calls.length === 0 || calls.every((call) => MANIFEST.test(checker.typeToString(call.getReturnType())))) return [];
109
+ const line = source.getLineAndCharacterOfPosition(name.getStart(source)).line + 1;
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}` }];
113
+ });
114
+ });
115
+ });
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
+ };
182
+ var isTypeScript = (value) => value !== null && typeof value === "object" && typeof Reflect.get(value, "createProgram") === "function" && typeof Reflect.get(value, "version") === "string";
183
+ var loadTypeScript = (root) => {
184
+ const require2 = module$1.createRequire(path.join(root, "package.json"));
185
+ let library;
186
+ try {
187
+ library = require2("typescript");
188
+ } catch {
189
+ throw new Error(`the shape check reads the source with TypeScript, and this app has none installed (looked from ${root}). pnpm add -D typescript`);
190
+ }
191
+ if (!isTypeScript(library)) throw new Error('the "typescript" this app has installed is not the TypeScript compiler.');
192
+ if (!library.version.startsWith("6.")) throw new Error(`the shape check is written against TypeScript 6, and this app has ${library.version}.`);
193
+ return library;
194
+ };
195
+
196
+ // src/shape/index.ts
197
+ var RULES = [
198
+ ["style", 'rule 16: no assertion but "as const", no non-null "!", no function declaration, class, enum, "any" or default export in src/'],
199
+ ["formatting", "rule 9: no Intl and no toLocale\u2026 outside Prism (src/, but src/dev/)"],
200
+ ["roles", "rule 11: no server code reads the caller\u2019s roles (src/server/)"],
201
+ ["files", "rule 9a: the kit reads no file into data (src/ui/)"],
202
+ ["address", "rule 4: the kit neither reads nor changes the address (src/ui/)"],
203
+ ["dom", "rule 2: no component finds elements in the document (src/ui/)"],
204
+ ["data", "src/app is data: no code outside it calls a function of it, but the manifest\u2019s factory"]
205
+ ];
206
+ var isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
207
+ var endpointsOf = (actions) => actions.flatMap((action) => Object.values(action.endpoints ?? {}).flatMap((endpoint) => isRecord(endpoint) ? [{ action: action.id, endpoint }] : []));
208
+ var replayOf = (endpoint) => {
209
+ const request = endpoint["request"];
210
+ if (!isRecord(request) || !("fingerprint" in request)) return void 0;
211
+ const fingerprint = request["fingerprint"];
212
+ return typeof fingerprint === "string" ? { fingerprint } : {};
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
+ };
224
+ var runShapeCheck = (config) => {
225
+ const log = config.log ?? ((line) => console.log(line));
226
+ let failures = 0;
227
+ const check = (what, passed, detail = []) => {
228
+ log(`${passed ? "[pass]" : "[fail]"} ${what}${passed || detail.length === 0 ? "" : ` \u2014 ${detail.join("; ")}`}`);
229
+ if (!passed) failures += 1;
230
+ };
231
+ const done = () => {
232
+ log(failures === 0 ? "[pass] shape: all checks passed" : `[fail] shape: ${failures} check(s) failed`);
233
+ return failures === 0 ? 0 : 1;
234
+ };
235
+ const read = readSource(config.root);
236
+ if (typeof read === "string") {
237
+ check("the source is read", false, [read]);
238
+ return done();
239
+ }
240
+ const { findings } = read;
241
+ const allow = config.allow ?? {};
242
+ for (const [rule, what] of RULES) {
243
+ const allowed = allow[rule] ?? {};
244
+ const left = findings.filter((finding) => finding.rule === rule && allowed[finding.file] === void 0);
245
+ check(what, left.length === 0, left.map((finding) => `${finding.file}:${finding.line} ${finding.what}`));
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
+ }
263
+ const idle = RULES.flatMap(
264
+ ([rule]) => Object.entries(allow[rule] ?? {}).flatMap(([file, reason]) => {
265
+ if (reason.trim() === "") return [`${rule}: ${file} gives no reason`];
266
+ if (!fs.existsSync(path.join(config.root, file))) return [`${rule}: ${file} does not exist`];
267
+ return findings.some((finding) => finding.rule === rule && finding.file === file) ? [] : [`${rule}: ${file} has nothing to allow`];
268
+ })
269
+ );
270
+ check("every allowance names a file there is, why, and something it allows", idle.length === 0, idle);
271
+ const endpoints = endpointsOf(config.actions);
272
+ const ledger = config.functions ?? {};
273
+ const called = new Set(endpoints.flatMap(({ endpoint }) => typeof endpoint["fn"] === "string" ? [endpoint["fn"]] : []));
274
+ const unexplained = [...called].filter((id) => (ledger[id] ?? "").trim() === "").sort();
275
+ check("every server function an action calls is named in `functions`, with what it does that a vex read or write cannot", unexplained.length === 0, unexplained);
276
+ const uncalled = Object.keys(ledger).filter((id) => !called.has(id)).sort();
277
+ check("every function named in `functions` is called by an action", uncalled.length === 0, uncalled);
278
+ const replays = endpoints.flatMap(({ endpoint }) => {
279
+ const replay = replayOf(endpoint);
280
+ return replay === void 0 ? [] : [replay];
281
+ });
282
+ const named = new Set(replays.flatMap((replay) => replay.fingerprint === void 0 ? [] : [replay.fingerprint]));
283
+ const reads = (config.entries ?? []).filter((entry) => entry.dsl !== void 0);
284
+ const calls = endpoints.filter(({ endpoint }) => typeof endpoint["fn"] === "string").length;
285
+ log(`[info] actions call server functions ${calls} times and replay vex ${replays.length} times`);
286
+ log(`[info] ${reads.filter((entry) => entry.mapping !== void 0).length} of ${reads.length} reads word their rows with a Prism mapping`);
287
+ const unnamed = reads.filter((entry) => entry.refresh === "reactive" && !named.has(entry.fingerprint)).map((entry) => entry.fingerprint);
288
+ if (unnamed.length > 0) log(`[info] reactive reads no action replays by name: ${unnamed.join(", ")}`);
289
+ return done();
290
+ };
291
+
292
+ exports.runShapeCheck = runShapeCheck;
293
+ //# sourceMappingURL=shape.cjs.map
294
+ //# sourceMappingURL=shape.cjs.map