create-nisc 0.6.0 → 0.6.1
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.
- package/CHANGELOG.md +4 -0
- package/bin/create-nisc.js +2 -3
- package/dist/{chunk-QZFX24QW.js → chunk-4VAHF5TY.js} +3 -3
- package/dist/chunk-4VAHF5TY.js.map +1 -0
- package/dist/cli.js +1 -1
- package/dist/cli.js.map +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/moss-dom/nisc.config.ts +0 -8
- package/templates/moss-dom/src/app/action-catalog.ts +0 -2
- package/templates/moss-dom/src/app/actions/surfaces/welcome.action.ts +0 -3
- package/templates/moss-dom/src/app/actions/surfaces/welcome.layout.ts +0 -2
- package/templates/moss-dom/src/app/app.ts +0 -3
- package/templates/moss-dom/src/app/charter/assignments.ts +1 -2
- package/templates/moss-dom/src/app/charter/charter.ts +0 -3
- package/templates/moss-dom/src/app/shell/frame.layout.ts +0 -2
- package/templates/moss-dom/src/app/shell/shell.ts +0 -3
- package/templates/moss-dom/src/dev/all-checks.ts +0 -3
- package/templates/moss-dom/src/dev/artifacts-check.ts +0 -7
- package/templates/moss-dom/src/dev/strata.ts +0 -8
- package/templates/moss-dom/src/dev/welcome-check.ts +0 -5
- package/templates/moss-dom/src/main.ts +0 -10
- package/templates/moss-dom/src/server/boot.ts +0 -3
- package/templates/moss-dom/src/server/document.ts +0 -4
- package/templates/moss-dom/src/server/runtime.ts +2 -10
- package/templates/moss-dom/src/ui/kit.ts +2 -8
- package/templates/moss-dom/src/ui/registry.ts +2 -3
- package/templates/moss-dom/vite.config.ts +0 -3
- package/templates/moss-react/nisc.config.ts +0 -8
- package/templates/moss-react/src/app/action-catalog.ts +0 -2
- package/templates/moss-react/src/app/actions/surfaces/welcome.action.ts +0 -3
- package/templates/moss-react/src/app/actions/surfaces/welcome.layout.ts +0 -2
- package/templates/moss-react/src/app/app.ts +0 -3
- package/templates/moss-react/src/app/charter/assignments.ts +1 -2
- package/templates/moss-react/src/app/charter/charter.ts +0 -3
- package/templates/moss-react/src/app/shell/frame.layout.ts +0 -2
- package/templates/moss-react/src/app/shell/shell.ts +0 -3
- package/templates/moss-react/src/dev/all-checks.ts +0 -3
- package/templates/moss-react/src/dev/artifacts-check.ts +0 -7
- package/templates/moss-react/src/dev/strata.ts +0 -8
- package/templates/moss-react/src/dev/welcome-check.ts +0 -5
- package/templates/moss-react/src/main.tsx +0 -9
- package/templates/moss-react/src/server/boot.ts +0 -3
- package/templates/moss-react/src/server/document.ts +0 -3
- package/templates/moss-react/src/server/runtime.ts +2 -10
- package/templates/moss-react/src/ui/kit.tsx +0 -10
- package/templates/moss-react/src/ui/registry.ts +0 -2
- package/templates/moss-react/vite.config.ts +0 -3
- package/templates/shell-dom/nisc.config.ts +0 -9
- package/templates/shell-dom/src/app/action-catalog.ts +0 -2
- package/templates/shell-dom/src/app/actions/surfaces/welcome.action.ts +0 -2
- package/templates/shell-dom/src/app/actions/surfaces/welcome.layout.ts +0 -5
- package/templates/shell-dom/src/app/shell/frame.layout.ts +0 -2
- package/templates/shell-dom/src/app/shell/shell.ts +0 -3
- package/templates/shell-dom/src/boot.ts +3 -8
- package/templates/shell-dom/src/dev/all-checks.ts +0 -3
- package/templates/shell-dom/src/dev/artifacts-check.ts +0 -7
- package/templates/shell-dom/src/dev/strata.ts +0 -8
- package/templates/shell-dom/src/dev/welcome-check.ts +0 -5
- package/templates/shell-dom/src/main.ts +0 -3
- package/templates/shell-dom/src/ui/kit.ts +2 -8
- package/templates/shell-dom/src/ui/registry.ts +2 -3
- package/templates/shell-dom/src/ui/screen.ts +0 -4
- package/templates/shell-dom/vite.config.ts +0 -1
- package/templates/shell-react/nisc.config.ts +0 -8
- package/templates/shell-react/src/app/action-catalog.ts +0 -2
- package/templates/shell-react/src/app/actions/surfaces/welcome.action.ts +0 -2
- package/templates/shell-react/src/app/actions/surfaces/welcome.layout.ts +0 -5
- package/templates/shell-react/src/app/shell/frame.layout.ts +0 -2
- package/templates/shell-react/src/app/shell/shell.ts +0 -3
- package/templates/shell-react/src/boot.ts +3 -8
- package/templates/shell-react/src/dev/all-checks.ts +0 -3
- package/templates/shell-react/src/dev/artifacts-check.ts +0 -7
- package/templates/shell-react/src/dev/strata.ts +0 -8
- package/templates/shell-react/src/dev/welcome-check.ts +0 -5
- package/templates/shell-react/src/main.tsx +0 -9
- package/templates/shell-react/src/ui/kit.tsx +0 -10
- package/templates/shell-react/src/ui/registry.ts +0 -2
- package/templates/shell-react/src/ui/screen.tsx +0 -6
- package/templates/shell-react/vite.config.ts +0 -1
- package/dist/chunk-QZFX24QW.js.map +0 -1
|
@@ -3,7 +3,4 @@ import type { MossServer } from '@niscorp/moss';
|
|
|
3
3
|
import { app } from '../app/app';
|
|
4
4
|
import { runtime } from './runtime';
|
|
5
5
|
|
|
6
|
-
// The one composition: the app's artifacts plus an environment → the server.
|
|
7
|
-
// The dev server, `nisc build`, `nisc start` and every check boot through here.
|
|
8
|
-
// moss refuses to boot an incoherent charter — a refusal is a finding.
|
|
9
6
|
export const boot = async (): Promise<{ server: MossServer }> => ({ server: await createServer(app, await runtime()) });
|
|
@@ -2,9 +2,6 @@ import type { ShellSnapshot } from '@niscorp/moss';
|
|
|
2
2
|
import { renderSnapshot } from '@niscorp/moss/terminal/react/server';
|
|
3
3
|
import { buildRegistry } from '../ui/registry';
|
|
4
4
|
|
|
5
|
-
// HOW A SCREEN IS DRAWN on the server: the kit the browser draws with, handed
|
|
6
|
-
// to moss. A page request is answered with the screen the socket would have
|
|
7
|
-
// streamed a moment later, and the browser's terminal adopts it (src/main.tsx).
|
|
8
5
|
const registry = buildRegistry();
|
|
9
6
|
|
|
10
7
|
export const drawing = {
|
|
@@ -3,18 +3,10 @@ import { createPostgresCache } from '@niscorp/vex';
|
|
|
3
3
|
import { createPglitePool, RAW_DATE_PARSERS } from '@niscorp/vex/pglite';
|
|
4
4
|
import type { NiscRuntime } from '@niscorp/moss';
|
|
5
5
|
|
|
6
|
-
// The environment (D2): what the app is handed to run on. An in-memory Postgres
|
|
7
|
-
// (PGlite) — every boot starts empty, which is what development and the checks
|
|
8
|
-
// want. A deployment hands moss a real Postgres pool here instead; nothing else
|
|
9
|
-
// in the app changes (see PLAN.md).
|
|
10
|
-
//
|
|
11
|
-
// `sessions`: moss verifies session tokens against its own table. Nobody can
|
|
12
|
-
// sign in yet — signing in is an application of its own, the anonymous
|
|
13
|
-
// principal's (AGENTS.md rule 12) — so every request is `public` for now.
|
|
14
6
|
export const runtime = async (): Promise<NiscRuntime> => {
|
|
15
7
|
const db = new PGlite();
|
|
16
|
-
//
|
|
17
|
-
//
|
|
8
|
+
// Two pools over one database: app queries get raw date strings (Prism
|
|
9
|
+
// formats them), the cache keeps Dates.
|
|
18
10
|
const cache = createPostgresCache({ pool: createPglitePool(db) });
|
|
19
11
|
await cache.init();
|
|
20
12
|
return { db, pool: createPglitePool(db, RAW_DATE_PARSERS), cache, session: 'sessions' };
|
|
@@ -2,16 +2,6 @@ import { z } from 'zod';
|
|
|
2
2
|
import { useNovaDispatch } from '@niscorp/nova/adapters/react';
|
|
3
3
|
import type { NovaComponent } from '@niscorp/nova/adapters/react';
|
|
4
4
|
|
|
5
|
-
// ═══════════════════════════════════════════════════════════
|
|
6
|
-
// The kit: domain-blind primitives. Props in, events out. Each one is
|
|
7
|
-
// CONFIGURED, never styled — it reads what a thing is (a tone, a level) from a
|
|
8
|
-
// closed set of names, and anything it does not know falls back to the default.
|
|
9
|
-
// The look lives in kit.css alone.
|
|
10
|
-
//
|
|
11
|
-
// Every prop a layout passes is parsed here, at the boundary (rule 13); a
|
|
12
|
-
// layout that names an unknown value gets the default, never a crash.
|
|
13
|
-
// ═══════════════════════════════════════════════════════════
|
|
14
|
-
|
|
15
5
|
const parsed = <T,>(schema: z.ZodType<T>, props: unknown, fallback: T): T => {
|
|
16
6
|
const result = schema.safeParse(props);
|
|
17
7
|
return result.success ? result.data : fallback;
|
|
@@ -4,8 +4,6 @@ import { ActionSlot, CanvasSlot } from '@niscorp/nova/adapters/react/components'
|
|
|
4
4
|
import type { NovaComponent } from '@niscorp/nova/adapters/react';
|
|
5
5
|
import { Button, Heading, Page, Row, Text } from './kit';
|
|
6
6
|
|
|
7
|
-
// The one registry, assembled once (rule 2): nova's two slot markers, then the
|
|
8
|
-
// kit. Every component a layout may name is here, and nothing else is.
|
|
9
7
|
export const buildRegistry = (): ComponentRegistry<NovaComponent> => {
|
|
10
8
|
const registry = createComponentRegistry<NovaComponent>();
|
|
11
9
|
registry.registerAll({ CanvasSlot, ActionSlot });
|
|
@@ -3,9 +3,6 @@
|
|
|
3
3
|
import { defineConfig } from 'vite';
|
|
4
4
|
import react from '@vitejs/plugin-react';
|
|
5
5
|
|
|
6
|
-
// The browser's bundle: React and nothing else. The app server runs inside
|
|
7
|
-
// vite's dev process too, but that is `nisc dev`'s doing (moss's dev plugin,
|
|
8
|
-
// fed from nisc.config.ts) — nothing about it belongs here.
|
|
9
6
|
export default defineConfig({
|
|
10
7
|
plugins: [react()],
|
|
11
8
|
});
|
|
@@ -3,15 +3,6 @@ import type { NiscShellProject } from '@niscorp/cli';
|
|
|
3
3
|
import { boot } from './src/boot';
|
|
4
4
|
import { adopt, draw } from './src/ui/screen';
|
|
5
5
|
|
|
6
|
-
// What this app tells the `nisc` command. It has no server: the shell runs in
|
|
7
|
-
// the page. So it hands over its own boot (the one src/main.ts runs) and the
|
|
8
|
-
// two ends of a drawn screen — drawn to markup at build (in a DOM jsdom
|
|
9
|
-
// provides), picked up in the page.
|
|
10
|
-
//
|
|
11
|
-
// npm run dev the app in vite
|
|
12
|
-
// npm run build bundle, draw every path, and check what was drawn
|
|
13
|
-
// npm run export …and write each path as a file: the site as a folder
|
|
14
|
-
// npm run check the checks in src/dev
|
|
15
6
|
export const project: NiscShellProject = {
|
|
16
7
|
shell: async () => ({ shell: boot() }),
|
|
17
8
|
draw: (shell) => draw(shell, new JSDOM('').window),
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
import type { ActionDefinition } from '@niscorp/nova';
|
|
2
2
|
import { welcomeAction } from './actions/surfaces/welcome.action';
|
|
3
3
|
|
|
4
|
-
// Ring 1: every action the app ships, by id. Which of them exist for a given
|
|
5
|
-
// principal is the charter's answer, not this file's.
|
|
6
4
|
export const actions: Record<string, ActionDefinition> = {
|
|
7
5
|
[welcomeAction.id]: welcomeAction,
|
|
8
6
|
};
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
import type { ActionDefinition } from '@niscorp/nova';
|
|
2
2
|
import { welcomeLayout } from './welcome.layout';
|
|
3
3
|
|
|
4
|
-
// The first action: data with defaults, a JSON layout, and one trigger. The
|
|
5
|
-
// press is counted in the shell — which lives in this page, with no server.
|
|
6
4
|
export const welcomeAction: ActionDefinition = {
|
|
7
5
|
id: 'welcome',
|
|
8
6
|
title: 'Welcome',
|
|
@@ -1,13 +1,8 @@
|
|
|
1
1
|
import type { LayoutNode } from '@niscorp/nova';
|
|
2
2
|
|
|
3
|
-
// JSON, bound to the action's data. Every component name is one the kit in
|
|
4
|
-
// src/ui registers; `ref` is what the action's trigger catches.
|
|
5
3
|
export const welcomeLayout: LayoutNode = {
|
|
6
4
|
component: 'Page',
|
|
7
5
|
children: [
|
|
8
|
-
// This page's <head>. It draws nothing on the screen: `nisc export` writes
|
|
9
|
-
// what it holds into the file's <head>, and in the page the head follows it.
|
|
10
|
-
// A child's props are the element's attributes — any <meta>, any <link>.
|
|
11
6
|
{
|
|
12
7
|
component: 'nova:head',
|
|
13
8
|
children: [
|
|
@@ -1,5 +1,3 @@
|
|
|
1
1
|
import type { LayoutNode } from '@niscorp/nova';
|
|
2
2
|
|
|
3
|
-
// The frame around the canvases — chrome lives here, as layout, never as a
|
|
4
|
-
// wrapper component. One canvas for now: `main`, drawn where its slot is.
|
|
5
3
|
export const frameLayout: LayoutNode = { component: 'CanvasSlot', props: { canvasId: 'main' } };
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
import type { CanvasConfig, LayoutNode } from '@niscorp/nova';
|
|
2
2
|
import { frameLayout } from './frame.layout';
|
|
3
3
|
|
|
4
|
-
// The shell, as data: one canvas, the action it opens with, and the frame
|
|
5
|
-
// around it. Shells host canvases, canvases host action instances, actions
|
|
6
|
-
// render JSON layouts. src/boot.ts builds the shell from this.
|
|
7
4
|
export const shell: { canvases: CanvasConfig[]; canvasLayout: LayoutNode } = {
|
|
8
5
|
canvases: [{ id: 'main', initial: 'welcome' }],
|
|
9
6
|
canvasLayout: frameLayout,
|
|
@@ -4,14 +4,9 @@ import { actions } from './app/action-catalog';
|
|
|
4
4
|
import { shell } from './app/shell/shell';
|
|
5
5
|
import { buildRegistry } from './ui/registry';
|
|
6
6
|
|
|
7
|
-
//
|
|
8
|
-
//
|
|
9
|
-
//
|
|
10
|
-
//
|
|
11
|
-
// A FRESH shell on every call: the page boots one, and a build boots more than
|
|
12
|
-
// one (it draws the first screen from one and checks it against others), so
|
|
13
|
-
// nothing may be shared between calls. Instance ids are counted, not random, so
|
|
14
|
-
// two boots draw the same markup.
|
|
7
|
+
// A fresh shell on every call: a build boots more than one and checks what
|
|
8
|
+
// they draw against each other, so nothing may be shared between calls.
|
|
9
|
+
// Instance ids are counted, not random, so two boots draw the same markup.
|
|
15
10
|
export const boot = (): Shell => {
|
|
16
11
|
let minted = 0;
|
|
17
12
|
return createShell({ ...shell, actions, registry: buildRegistry(), instanceIdFn: () => `i${(minted += 1)}` });
|
|
@@ -1,8 +1,5 @@
|
|
|
1
1
|
import { spawnSync } from 'node:child_process';
|
|
2
2
|
|
|
3
|
-
// Every check, each in its own process: a check ships the app a
|
|
4
|
-
// history, and a shared one would make the order of the suite part of its
|
|
5
|
-
// meaning. `nisc check` runs this. A new feature adds its check here.
|
|
6
3
|
const CHECKS: readonly (readonly [name: string, what: string, args?: readonly string[]])[] = [
|
|
7
4
|
['artifacts-check', 'src/app is data: pure JSON, and every artifact parses its schema'],
|
|
8
5
|
['strata', 'the source is written at the installed grammars (strata.lock.json)', ['status', '--check']],
|
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
// The artifacts check — what makes `src/app/` a tree of DATA: everything in it
|
|
2
|
-
// is pure JSON (no function, no Date, no undefined, no class instance) and
|
|
3
|
-
// parses through its own schema, so a code file cannot pass for an artifact
|
|
4
|
-
// (AGENTS.md, review item 6a). It also holds rule 14: an action's `input`
|
|
5
|
-
// declares only keys its `data` has.
|
|
6
1
|
import { ActionDefinitionSchema, LayoutNodeSchema } from '@niscorp/nova';
|
|
7
2
|
import { actions } from '../app/action-catalog';
|
|
8
3
|
import { shell } from '../app/shell/shell';
|
|
@@ -13,7 +8,6 @@ const check = (name: string, passed: boolean, detail = ''): void => {
|
|
|
13
8
|
if (!passed) failures += 1;
|
|
14
9
|
};
|
|
15
10
|
|
|
16
|
-
// The first thing in a value that is not JSON, as a path — or '' when all of it is.
|
|
17
11
|
const impurity = (value: unknown, path: string): string => {
|
|
18
12
|
if (value === null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return '';
|
|
19
13
|
if (Array.isArray(value)) return value.map((item, at) => impurity(item, `${path}[${at}]`)).find((found) => found !== '') ?? '';
|
|
@@ -42,7 +36,6 @@ parses('the shell’s frame', () => LayoutNodeSchema.parse(shell.canvasLayout));
|
|
|
42
36
|
for (const [id, definition] of Object.entries(actions)) {
|
|
43
37
|
check(`action "${id}" is catalogued under its own id`, definition.id === id, `its id is "${definition.id}"`);
|
|
44
38
|
parses(`action "${id}"`, () => ActionDefinitionSchema.parse(definition));
|
|
45
|
-
// rule 14: what an opener may seed is a subset of the action's data
|
|
46
39
|
const properties = isRecord(definition.input) && isRecord(definition.input['properties']) ? Object.keys(definition.input['properties']) : [];
|
|
47
40
|
const unknown = properties.filter((key) => !(key in (definition.data ?? {})));
|
|
48
41
|
check(`action "${id}" declares only inputs its data has`, unknown.length === 0, unknown.join(', '));
|
|
@@ -1,11 +1,3 @@
|
|
|
1
|
-
// strata for this app's SOURCE artifacts — which version of each grammar
|
|
2
|
-
// (nova's, Prism's) the actions in src/app are written in, recorded in
|
|
3
|
-
// strata.lock.json, and how they are brought forward when a grammar moves
|
|
4
|
-
// (AGENTS.md rule 20).
|
|
5
|
-
//
|
|
6
|
-
// npm run strata status where the source stands (`-- --check` to fail when behind)
|
|
7
|
-
// npm run strata upgrade the exact expected JSON + a report of what to edit
|
|
8
|
-
// npm run strata verify holds the edit to that JSON, then moves the lock
|
|
9
1
|
import { fileURLToPath } from 'node:url';
|
|
10
2
|
import { NOVA_SCHEMAS, NOVA_SEQUENCE } from '@niscorp/nova/migrations';
|
|
11
3
|
import { evaluate } from '@niscorp/prism';
|
|
@@ -1,11 +1,6 @@
|
|
|
1
1
|
import { shellSettled } from '@niscorp/nova';
|
|
2
2
|
import { boot } from '../boot';
|
|
3
3
|
|
|
4
|
-
// The welcome screen, with no browser: the app's own boot, its first screen
|
|
5
|
-
// whole, and a press reaching the shell. One `[pass]`/`[fail]` line per
|
|
6
|
-
// assertion; any failure exits non-zero (AGENTS.md, "Verification"). Whether
|
|
7
|
-
// the screen draws and is picked up in a page is `nisc build`'s to check.
|
|
8
|
-
|
|
9
4
|
let failures = 0;
|
|
10
5
|
const check = (name: string, passed: boolean, detail = ''): void => {
|
|
11
6
|
console.log(`${passed ? '[pass]' : '[fail]'} ${name}${!passed && detail !== '' ? ` — ${detail}` : ''}`);
|
|
@@ -3,9 +3,6 @@ import { boot } from './boot';
|
|
|
3
3
|
import { adopt } from './ui/screen';
|
|
4
4
|
import './ui/kit.css';
|
|
5
5
|
|
|
6
|
-
// The entry: boot the shell, let it reach its first screen, and mount it — over
|
|
7
|
-
// the screen that arrived drawn (`nisc export` or `nisc start` wrote it), or
|
|
8
|
-
// into an empty root (dev). The shell is this page's own from here on.
|
|
9
6
|
const root = document.getElementById('root');
|
|
10
7
|
if (root === null) throw new Error('index.html has no #root');
|
|
11
8
|
|
|
@@ -1,14 +1,8 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import type { DomComponent } from '@niscorp/nova/adapters/dom';
|
|
3
3
|
|
|
4
|
-
//
|
|
5
|
-
//
|
|
6
|
-
// Props in, an element out; nova's DOM adapter wires a `ref`'d element's clicks
|
|
7
|
-
// by convention, so a button is just a button. Each one is CONFIGURED, never
|
|
8
|
-
// styled: it reads what a thing is (a tone) from a closed set of names, and
|
|
9
|
-
// anything it does not know falls back to the default. The look lives in
|
|
10
|
-
// kit.css alone.
|
|
11
|
-
// ═══════════════════════════════════════════════════════════
|
|
4
|
+
// nova's DOM adapter wires the clicks of an element with a `ref` itself, so
|
|
5
|
+
// `Button` adds no listener.
|
|
12
6
|
|
|
13
7
|
const parsed = <T>(schema: z.ZodType<T>, props: unknown, fallback: T): T => {
|
|
14
8
|
const result = schema.safeParse(props);
|
|
@@ -4,9 +4,8 @@ import type { DomComponent } from '@niscorp/nova/adapters/dom';
|
|
|
4
4
|
import { fallback } from '@niscorp/nova/adapters/dom/components';
|
|
5
5
|
import { Button, Heading, Page, Row, Text } from './kit';
|
|
6
6
|
|
|
7
|
-
// The
|
|
8
|
-
//
|
|
9
|
-
// wrapper). Every component a layout may name is here, and nothing else is.
|
|
7
|
+
// The adapter resolves a canvas slot itself, and an action slot is a plain
|
|
8
|
+
// wrapper: `fallback` does for both.
|
|
10
9
|
export const buildRegistry = (): ComponentRegistry<DomComponent> => {
|
|
11
10
|
const registry = createComponentRegistry<DomComponent>();
|
|
12
11
|
registry.register(CANVAS_SLOT_NAME, fallback);
|
|
@@ -5,10 +5,6 @@ import type { Shell } from '@niscorp/nova';
|
|
|
5
5
|
import { fallback } from '@niscorp/nova/adapters/dom/components';
|
|
6
6
|
import { buildRegistry } from './registry';
|
|
7
7
|
|
|
8
|
-
// The screen, with nova's DOM adapter — no framework in the page. Drawn to
|
|
9
|
-
// markup at build (`draw`, handed a DOM to build in), and mounted in the page
|
|
10
|
-
// over what was drawn (`adopt`): the adapter rebuilds its root with the same
|
|
11
|
-
// elements, and from then on it is the shell's.
|
|
12
8
|
export const draw = (shell: Shell, window: object): string => renderToString(buildRegistry(), shellView(shell).api, { window, fallback });
|
|
13
9
|
|
|
14
10
|
export const adopt = (root: HTMLElement, shell: Shell): void => {
|
|
@@ -4,14 +4,6 @@ import type { NiscShellProject } from '@niscorp/cli';
|
|
|
4
4
|
import { boot } from './src/boot';
|
|
5
5
|
import { Screen, adopt } from './src/ui/screen';
|
|
6
6
|
|
|
7
|
-
// What this app tells the `nisc` command. It has no server: the shell runs in
|
|
8
|
-
// the page. So it hands over its own boot (the one src/main.tsx runs) and the
|
|
9
|
-
// two ends of a drawn screen — drawn to markup at build, picked up in the page.
|
|
10
|
-
//
|
|
11
|
-
// npm run dev the app in vite
|
|
12
|
-
// npm run build bundle, draw every path, and check what was drawn
|
|
13
|
-
// npm run export …and write each path as a file: the site as a folder
|
|
14
|
-
// npm run check the checks in src/dev
|
|
15
7
|
export const project: NiscShellProject = {
|
|
16
8
|
shell: async () => ({ shell: boot() }),
|
|
17
9
|
draw: (shell) => renderToString(createElement(Screen, { shell })),
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
import type { ActionDefinition } from '@niscorp/nova';
|
|
2
2
|
import { welcomeAction } from './actions/surfaces/welcome.action';
|
|
3
3
|
|
|
4
|
-
// Ring 1: every action the app ships, by id. Which of them exist for a given
|
|
5
|
-
// principal is the charter's answer, not this file's.
|
|
6
4
|
export const actions: Record<string, ActionDefinition> = {
|
|
7
5
|
[welcomeAction.id]: welcomeAction,
|
|
8
6
|
};
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
import type { ActionDefinition } from '@niscorp/nova';
|
|
2
2
|
import { welcomeLayout } from './welcome.layout';
|
|
3
3
|
|
|
4
|
-
// The first action: data with defaults, a JSON layout, and one trigger. The
|
|
5
|
-
// press is counted in the shell — which lives in this page, with no server.
|
|
6
4
|
export const welcomeAction: ActionDefinition = {
|
|
7
5
|
id: 'welcome',
|
|
8
6
|
title: 'Welcome',
|
|
@@ -1,13 +1,8 @@
|
|
|
1
1
|
import type { LayoutNode } from '@niscorp/nova';
|
|
2
2
|
|
|
3
|
-
// JSON, bound to the action's data. Every component name is one the kit in
|
|
4
|
-
// src/ui registers; `ref` is what the action's trigger catches.
|
|
5
3
|
export const welcomeLayout: LayoutNode = {
|
|
6
4
|
component: 'Page',
|
|
7
5
|
children: [
|
|
8
|
-
// This page's <head>. It draws nothing on the screen: `nisc export` writes
|
|
9
|
-
// what it holds into the file's <head>, and in the page the head follows it.
|
|
10
|
-
// A child's props are the element's attributes — any <meta>, any <link>.
|
|
11
6
|
{
|
|
12
7
|
component: 'nova:head',
|
|
13
8
|
children: [
|
|
@@ -1,5 +1,3 @@
|
|
|
1
1
|
import type { LayoutNode } from '@niscorp/nova';
|
|
2
2
|
|
|
3
|
-
// The frame around the canvases — chrome lives here, as layout, never as a
|
|
4
|
-
// wrapper component. One canvas for now: `main`, drawn where its slot is.
|
|
5
3
|
export const frameLayout: LayoutNode = { component: 'CanvasSlot', props: { canvasId: 'main' } };
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
import type { CanvasConfig, LayoutNode } from '@niscorp/nova';
|
|
2
2
|
import { frameLayout } from './frame.layout';
|
|
3
3
|
|
|
4
|
-
// The shell, as data: one canvas, the action it opens with, and the frame
|
|
5
|
-
// around it. Shells host canvases, canvases host action instances, actions
|
|
6
|
-
// render JSON layouts. src/boot.ts builds the shell from this.
|
|
7
4
|
export const shell: { canvases: CanvasConfig[]; canvasLayout: LayoutNode } = {
|
|
8
5
|
canvases: [{ id: 'main', initial: 'welcome' }],
|
|
9
6
|
canvasLayout: frameLayout,
|
|
@@ -4,14 +4,9 @@ import { actions } from './app/action-catalog';
|
|
|
4
4
|
import { shell } from './app/shell/shell';
|
|
5
5
|
import { buildRegistry } from './ui/registry';
|
|
6
6
|
|
|
7
|
-
//
|
|
8
|
-
//
|
|
9
|
-
//
|
|
10
|
-
//
|
|
11
|
-
// A FRESH shell on every call: the page boots one, and a build boots more than
|
|
12
|
-
// one (it draws the first screen from one and checks it against others), so
|
|
13
|
-
// nothing may be shared between calls. Instance ids are counted, not random, so
|
|
14
|
-
// two boots draw the same markup.
|
|
7
|
+
// A fresh shell on every call: a build boots more than one and checks what
|
|
8
|
+
// they draw against each other, so nothing may be shared between calls.
|
|
9
|
+
// Instance ids are counted, not random, so two boots draw the same markup.
|
|
15
10
|
export const boot = (): Shell => {
|
|
16
11
|
let minted = 0;
|
|
17
12
|
return createShell({ ...shell, actions, registry: buildRegistry(), instanceIdFn: () => `i${(minted += 1)}` });
|
|
@@ -1,8 +1,5 @@
|
|
|
1
1
|
import { spawnSync } from 'node:child_process';
|
|
2
2
|
|
|
3
|
-
// Every check, each in its own process: a check ships the app a
|
|
4
|
-
// history, and a shared one would make the order of the suite part of its
|
|
5
|
-
// meaning. `nisc check` runs this. A new feature adds its check here.
|
|
6
3
|
const CHECKS: readonly (readonly [name: string, what: string, args?: readonly string[]])[] = [
|
|
7
4
|
['artifacts-check', 'src/app is data: pure JSON, and every artifact parses its schema'],
|
|
8
5
|
['strata', 'the source is written at the installed grammars (strata.lock.json)', ['status', '--check']],
|
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
// The artifacts check — what makes `src/app/` a tree of DATA: everything in it
|
|
2
|
-
// is pure JSON (no function, no Date, no undefined, no class instance) and
|
|
3
|
-
// parses through its own schema, so a code file cannot pass for an artifact
|
|
4
|
-
// (AGENTS.md, review item 6a). It also holds rule 14: an action's `input`
|
|
5
|
-
// declares only keys its `data` has.
|
|
6
1
|
import { ActionDefinitionSchema, LayoutNodeSchema } from '@niscorp/nova';
|
|
7
2
|
import { actions } from '../app/action-catalog';
|
|
8
3
|
import { shell } from '../app/shell/shell';
|
|
@@ -13,7 +8,6 @@ const check = (name: string, passed: boolean, detail = ''): void => {
|
|
|
13
8
|
if (!passed) failures += 1;
|
|
14
9
|
};
|
|
15
10
|
|
|
16
|
-
// The first thing in a value that is not JSON, as a path — or '' when all of it is.
|
|
17
11
|
const impurity = (value: unknown, path: string): string => {
|
|
18
12
|
if (value === null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') return '';
|
|
19
13
|
if (Array.isArray(value)) return value.map((item, at) => impurity(item, `${path}[${at}]`)).find((found) => found !== '') ?? '';
|
|
@@ -42,7 +36,6 @@ parses('the shell’s frame', () => LayoutNodeSchema.parse(shell.canvasLayout));
|
|
|
42
36
|
for (const [id, definition] of Object.entries(actions)) {
|
|
43
37
|
check(`action "${id}" is catalogued under its own id`, definition.id === id, `its id is "${definition.id}"`);
|
|
44
38
|
parses(`action "${id}"`, () => ActionDefinitionSchema.parse(definition));
|
|
45
|
-
// rule 14: what an opener may seed is a subset of the action's data
|
|
46
39
|
const properties = isRecord(definition.input) && isRecord(definition.input['properties']) ? Object.keys(definition.input['properties']) : [];
|
|
47
40
|
const unknown = properties.filter((key) => !(key in (definition.data ?? {})));
|
|
48
41
|
check(`action "${id}" declares only inputs its data has`, unknown.length === 0, unknown.join(', '));
|
|
@@ -1,11 +1,3 @@
|
|
|
1
|
-
// strata for this app's SOURCE artifacts — which version of each grammar
|
|
2
|
-
// (nova's, Prism's) the actions in src/app are written in, recorded in
|
|
3
|
-
// strata.lock.json, and how they are brought forward when a grammar moves
|
|
4
|
-
// (AGENTS.md rule 20).
|
|
5
|
-
//
|
|
6
|
-
// npm run strata status where the source stands (`-- --check` to fail when behind)
|
|
7
|
-
// npm run strata upgrade the exact expected JSON + a report of what to edit
|
|
8
|
-
// npm run strata verify holds the edit to that JSON, then moves the lock
|
|
9
1
|
import { fileURLToPath } from 'node:url';
|
|
10
2
|
import { NOVA_SCHEMAS, NOVA_SEQUENCE } from '@niscorp/nova/migrations';
|
|
11
3
|
import { evaluate } from '@niscorp/prism';
|
|
@@ -1,11 +1,6 @@
|
|
|
1
1
|
import { shellSettled } from '@niscorp/nova';
|
|
2
2
|
import { boot } from '../boot';
|
|
3
3
|
|
|
4
|
-
// The welcome screen, with no browser: the app's own boot, its first screen
|
|
5
|
-
// whole, and a press reaching the shell. One `[pass]`/`[fail]` line per
|
|
6
|
-
// assertion; any failure exits non-zero (AGENTS.md, "Verification"). Whether
|
|
7
|
-
// the screen draws and is picked up in a page is `nisc build`'s to check.
|
|
8
|
-
|
|
9
4
|
let failures = 0;
|
|
10
5
|
const check = (name: string, passed: boolean, detail = ''): void => {
|
|
11
6
|
console.log(`${passed ? '[pass]' : '[fail]'} ${name}${!passed && detail !== '' ? ` — ${detail}` : ''}`);
|
|
@@ -4,15 +4,6 @@ import { boot } from './boot';
|
|
|
4
4
|
import { Screen, adopt } from './ui/screen';
|
|
5
5
|
import './ui/kit.css';
|
|
6
6
|
|
|
7
|
-
// The entry: boot the shell, then one of two things —
|
|
8
|
-
//
|
|
9
|
-
// the screen ARRIVED DRAWN (`nisc export` or `nisc start` wrote it into the
|
|
10
|
-
// root): the shell reaches that same screen, and picks the elements up as
|
|
11
|
-
// they are;
|
|
12
|
-
//
|
|
13
|
-
// the root is empty (dev): the screen is rendered from nothing.
|
|
14
|
-
//
|
|
15
|
-
// Either way the shell is this page's own from here on.
|
|
16
7
|
const root = document.getElementById('root');
|
|
17
8
|
if (root === null) throw new Error('index.html has no #root');
|
|
18
9
|
|
|
@@ -2,16 +2,6 @@ import { z } from 'zod';
|
|
|
2
2
|
import { useNovaDispatch } from '@niscorp/nova/adapters/react';
|
|
3
3
|
import type { NovaComponent } from '@niscorp/nova/adapters/react';
|
|
4
4
|
|
|
5
|
-
// ═══════════════════════════════════════════════════════════
|
|
6
|
-
// The kit: domain-blind primitives. Props in, events out. Each one is
|
|
7
|
-
// CONFIGURED, never styled — it reads what a thing is (a tone, a level) from a
|
|
8
|
-
// closed set of names, and anything it does not know falls back to the default.
|
|
9
|
-
// The look lives in kit.css alone.
|
|
10
|
-
//
|
|
11
|
-
// Every prop a layout passes is parsed here, at the boundary (rule 13); a
|
|
12
|
-
// layout that names an unknown value gets the default, never a crash.
|
|
13
|
-
// ═══════════════════════════════════════════════════════════
|
|
14
|
-
|
|
15
5
|
const parsed = <T,>(schema: z.ZodType<T>, props: unknown, fallback: T): T => {
|
|
16
6
|
const result = schema.safeParse(props);
|
|
17
7
|
return result.success ? result.data : fallback;
|
|
@@ -4,8 +4,6 @@ import { ActionSlot, CanvasSlot } from '@niscorp/nova/adapters/react/components'
|
|
|
4
4
|
import type { NovaComponent } from '@niscorp/nova/adapters/react';
|
|
5
5
|
import { Button, Heading, Page, Row, Text } from './kit';
|
|
6
6
|
|
|
7
|
-
// The one registry, assembled once (rule 2): nova's two slot markers, then the
|
|
8
|
-
// kit. Every component a layout may name is here, and nothing else is.
|
|
9
7
|
export const buildRegistry = (): ComponentRegistry<NovaComponent> => {
|
|
10
8
|
const registry = createComponentRegistry<NovaComponent>();
|
|
11
9
|
registry.registerAll({ CanvasSlot, ActionSlot });
|
|
@@ -2,14 +2,8 @@ import { hydrateRoot } from 'react-dom/client';
|
|
|
2
2
|
import { NovaShell } from '@niscorp/nova/adapters/react';
|
|
3
3
|
import type { Shell } from '@niscorp/nova';
|
|
4
4
|
|
|
5
|
-
// The screen: the shell's frame and canvases, drawn with the shell's own kit.
|
|
6
|
-
// Drawn three ways from this one description — to markup at build
|
|
7
|
-
// (nisc.config.ts), over that markup in the page (`adopt`), and from nothing
|
|
8
|
-
// in dev (src/main.tsx).
|
|
9
5
|
export const Screen = ({ shell }: { shell: Shell }): React.JSX.Element => <NovaShell shell={shell} />;
|
|
10
6
|
|
|
11
|
-
// Pick up a screen that arrived drawn — the one call both the page and the
|
|
12
|
-
// build's adoption check make.
|
|
13
7
|
export const adopt = (root: HTMLElement, shell: Shell): void => {
|
|
14
8
|
hydrateRoot(root, <Screen shell={shell} />);
|
|
15
9
|
};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["%3Cdefine:__NISC_SET__%3E","../src/docs.ts","../src/generate.ts","../src/set.ts"],"names":[],"mappings":"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","file":"chunk-QZFX24QW.js","sourcesContent":["{\"@niscorp/charter\":\"0.1.3\",\"@niscorp/cli\":\"0.6.0\",\"@niscorp/cortex\":\"0.1.3\",\"@niscorp/loom\":\"0.3.0\",\"@niscorp/moss\":\"0.6.0\",\"@niscorp/nisc\":\"0.6.0\",\"@niscorp/nova\":\"0.3.0\",\"@niscorp/prism\":\"0.3.0\",\"@niscorp/signal\":\"0.1.3\",\"@niscorp/solid\":\"0.1.2\",\"@niscorp/strata\":\"0.1.6\",\"@niscorp/tide\":\"0.1.6\",\"@niscorp/vex\":\"0.3.0\"}","import type { Posture, Ui } from './generate';\n\n// ═══════════════════════════════════════════════════════════════\n// The two documents only a new app has.\n//\n// AGENTS.md says where the rules are — the installed @niscorp/nisc carries\n// them, for the version installed — and what is particular to this app. It\n// does not restate a rule: a copy would be frozen at the version it was made\n// with, and the rules move with releases.\n//\n// PLAN.md is the interview's record (AGENTS.md, \"Before any code\"). The\n// walkthrough asks what shapes the files; everything else is written down as\n// OPEN, and an open decision point blocks the build until it is answered or\n// delegated by name.\n// ═══════════════════════════════════════════════════════════════\n\ntype Facts = { name: string; posture: Posture; ui: Ui; today: string; nisc: string };\n\nconst uiName = (ui: Ui): string => (ui === 'react' ? 'React' : 'plain DOM (nova’s DOM adapter — no framework in the page)');\n\nconst layoutOf = (facts: Facts): string =>\n facts.posture === 'moss'\n ? `src/app/ ARTIFACTS ONLY — the manifest (app.ts), the charter, the actions, the shell\nsrc/server/ the environment (runtime.ts), the boot, how a screen is drawn (document.ts)\nsrc/ui/ the kit — the only renderer code, with ${facts.ui === 'react' ? 'src/main.tsx' : 'src/main.ts'}, the terminal entry\nsrc/dev/ the checks (\\`npm run check\\`) — a new feature adds its own\nnisc.config.ts how the app boots and how a screen is drawn, for the \\`nisc\\` command\nstrata.lock.json the grammar versions the source is written at (rule 20) — moved only\n by \\`npm run strata verify\\`, never by hand`\n : `src/app/ ARTIFACTS ONLY — the actions and the shell's canvases\nsrc/boot.ts the shell factory: the artifacts plus everything environmental\nsrc/ui/ the kit and the screen — the only renderer code, with ${facts.ui === 'react' ? 'src/main.tsx' : 'src/main.ts'}, the entry\nsrc/dev/ the checks (\\`npm run check\\`) — a new feature adds its own\nnisc.config.ts how the app boots and how its screen is drawn and picked up, for the \\`nisc\\` command\nstrata.lock.json the grammar versions the source is written at (rule 20) — moved only\n by \\`npm run strata verify\\`, never by hand`;\n\nexport const agentsDoc = (facts: Facts): string => `# ${facts.name}\n\nA nisc application. **The rules it is built by are \\`node_modules/@niscorp/nisc/AGENTS.md\\`** — read all of it before changing anything here (it is there once the app's dependencies are installed). It is the rulebook for the nisc version this app has installed, and \\`STYLE_GUIDE.md\\` sits beside it. The grammars it names — a layout node, an \\`ActionDefinition\\`, a Prism config, a charter, a Vex DSL — are in each package's own \\`README.md\\` and \\`DESIGN.md\\`, under \\`node_modules/@niscorp/<name>/\\`.\n\nWhat is particular to this app:\n\n- **Its decisions are in PLAN.md.** What was answered when it was made, what was derived, and what is still open. An open decision point is asked before anything is built on it, never resolved silently.\n- **It is ${facts.posture === 'moss' ? 'behind moss' : 'its own shell'}**, drawn with ${uiName(facts.ui)}.\n- **Where things go:**\n\n\\`\\`\\`\n${layoutOf(facts)}\n\\`\\`\\`\n\n- **How it runs:** \\`npm run dev\\`, \\`npm run build\\`, \\`npm run check\\`${facts.posture === 'page' ? ', `npm run export`' : ', `npm start`'} — all of them the \\`nisc\\` command — and \\`npm run strata status\\` for the grammars.\n`;\n\nconst d1 = (posture: Posture): string =>\n posture === 'moss'\n ? `| D1 Posture | answered | **A moss server app.** The shell runs on the server, one per person; the browser is a canvas terminal over a socket. The charter is enforced there: a principal reaches only the actions and the data it is granted. |`\n : `| D1 Posture | answered | **Its own shell, in the page — no server.** The shell, its actions and its endpoints run in the browser. Consequence, said plainly: **the charter is not enforcement here.** Whatever data and policy the page has, its user has; nothing in this posture is a security boundary. An app that needs one needs a server — moss. |`;\n\nconst d2 = (posture: Posture): string =>\n posture === 'moss'\n ? `| D2 Environment | derived · **open for deployment** | Development and the checks run on PGlite, an in-memory Postgres that starts empty every boot (\\`src/server/runtime.ts\\`). Open: the Postgres a deployment hands it, and where it runs. |`\n : `| D2 Environment | **open** | The app has no data yet. Open: what serves its endpoints — in-memory fixtures, PGlite in the page (your data lives in one browser profile: no sync, no other devices, gone if site data is cleared), a real backend, or a mix. |`;\n\nconst d5 = (posture: Posture): string =>\n posture === 'moss'\n ? `| D5 Routing | derived · **partly open** | The first screen is drawn on the server and adopted by the terminal — it costs nothing while nobody can sign in. Open: once sign-in exists, the browser keeps the session in a cookie no script can read, and the page is drawn for whoever it says (AGENTS.md rule 12) — a page drawn for somebody is theirs alone (\\`private, no-store\\`). Open: which paths are **pages** rather than the app, and whether the app's shell state syncs to the address bar. |`\n : `| D5 Routing | derived · **partly open** | The first screen is drawn at build (\\`nisc export\\`) — one file per path, the screen as nobody in particular sees it — and the page's own shell picks it up. Open: which paths exist beyond \\`/\\`, and whether shell state syncs to the address bar. |`;\n\nexport const planDoc = (facts: Facts): string => `# PLAN — ${facts.name}\n\nMade ${facts.today} by \\`npm create nisc\\`, on nisc ${facts.nisc}. This is the record AGENTS.md's interview asks for (\"Before any code\"). The walkthrough asked what shapes the files; everything else is **open**, and an open decision blocks the build that depends on it until it is answered by the user or delegated by name. A blanket \"go\" delegates nothing.\n\n## Decision points\n\n| | Tier | |\n|---|---|---|\n${d1(facts.posture)}\n${d2(facts.posture)}\n| D3 Reads | **open** | Vex entries (\\`{ fingerprint, context }\\`, the shape an AI feature can reach later) or plain endpoints with hand-written handlers. |\n| D4 Writes | **open** | Vex mutation entries or plain endpoint handlers. Either way a write is an endpoint, never inline. |\n${d5(facts.posture)}\n\n## Answered when it was made\n\n- **What draws the screen:** ${uiName(facts.ui)}. The kit in \\`src/ui/\\` is where the look lives; a layout names components, never styles.\n\n## The dial-in — open\n\n- The entities, and how they relate.\n- Expected scale.\n- Who uses it: one person, or roles. More than one principal sketches its roles and charter now, not later.\n- AI features: now, later, never. (Later still shapes D3.)\n- Look and feel.\n- Where it is deployed.\n- What happens to the data long-term.\n\n## Order of work\n\n1. **The interview** — every open item above, answered or delegated by name. ← here\n2. **Scaffold** — done: ${facts.posture === 'moss' ? 'manifest, runtime and terminal' : 'the shell factory and the entry'}, one action rendering, and its checks (the artifacts, the grammar lock, the welcome screen).\n3. **Kit** — the primitives, against a kitchen-sink action; lock the look before any feature.\n4. **Data layer** — per D2/D3: schema, seed, entries; one read end to end.\n5. **Actions** — domain by domain: list → detail → form.\n6. **Writes** — per D4; one round trip: create → announce → re-read.\n7. **Checks and polish** — a check per feature in \\`src/dev/\\`; empty states and transitions last.\n`;\n\n// What a nisc app keeps out of git. Lines, so an existing .gitignore can be\n// given only the ones it lacks.\nexport const gitignoreLines = ['node_modules/', 'dist/', 'out/', '.strata/', '*.tsbuildinfo', '.env', '.env.*', '!.env.example'];\n","import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';\nimport { dirname, extname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { agentsDoc, gitignoreLines, planDoc } from './docs';\n\n// ═══════════════════════════════════════════════════════════════\n// A new app, from a template — and nothing in it that the walkthrough did not\n// decide or PLAN.md does not record.\n//\n// The templates (../templates) are real apps: members of the nisc repository's\n// workspace, typechecked, built and checked by its CI like any other. What a\n// new app gets is one of them, copied, with three things changed: its name, the\n// `workspace:^` versions turned into the released set the template was checked\n// against, and the two documents that only exist for a new app — PLAN.md (the\n// decisions) and AGENTS.md (where the rules are).\n//\n// It never overwrites. A folder that already holds something is fine — a fresh\n// repository's .git, a LICENSE — as long as nothing it would write is there\n// already; if anything is, it writes nothing at all and says which files.\n// ═══════════════════════════════════════════════════════════════\n\n// Where the shell runs (D1): on a server (moss), or in the page.\nexport type Posture = 'moss' | 'page';\n// What draws the screen: React, or plain DOM.\nexport type Ui = 'react' | 'dom';\n\nexport type CreateOptions = {\n // where the app goes\n dir: string;\n // its package name\n name: string;\n posture: Posture;\n ui: Ui;\n // the @niscorp versions to depend on: package name → version\n versions: Readonly<Record<string, string>>;\n // the day it was made (PLAN.md), as YYYY-MM-DD\n today: string;\n};\n\nexport type Created = {\n // every file written, relative to the app\n files: string[];\n // files that were already there and were left as they were\n kept: string[];\n // files that were already there and were added to\n extended: string[];\n};\n\nexport const TEMPLATES = fileURLToPath(new URL('../templates', import.meta.url));\n\nexport const templateOf = (posture: Posture, ui: Ui): string => `${posture === 'moss' ? 'moss' : 'shell'}-${ui}`;\n\n// The token each template is named by — its package name, and wherever the\n// name shows (the page title, the welcome screen, its README).\nconst tokenOf = (template: string): string => `nisc-template-${template}`;\n\nconst SKIP = new Set(['node_modules', 'dist', 'out', '.turbo']);\nconst TEXT = new Set(['.ts', '.tsx', '.json', '.html', '.css', '.md']);\n// A file of the app's own that an existing folder may already have, and keeps.\nconst KEEP_THEIRS = new Set(['README.md']);\n\n// npm's rule for a package name, as the app's directory will mostly be named.\nexport const validName = (name: string): boolean => /^[a-z0-9][a-z0-9._-]*$/.test(name) && name.length <= 214;\n\nconst filesIn = (dir: string, base = ''): string[] =>\n readdirSync(join(dir, base), { withFileTypes: true }).flatMap((entry) => {\n if (SKIP.has(entry.name)) return [];\n const rel = base === '' ? entry.name : `${base}/${entry.name}`;\n return entry.isDirectory() ? filesIn(dir, rel) : [rel];\n });\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => value !== null && typeof value === 'object' && !Array.isArray(value);\n\n// `workspace:^` → `^<the released version>`, for every dependency the template\n// takes from the workspace. A version the set does not have is a broken set,\n// not something to guess.\nconst pinned = (deps: unknown, versions: Readonly<Record<string, string>>): Record<string, string> => {\n if (!isRecord(deps)) return {};\n return Object.fromEntries(\n Object.entries(deps).map(([name, spec]): [string, string] => {\n if (typeof spec !== 'string') throw new Error(`create-nisc: ${name} has no version in the template`);\n if (!spec.startsWith('workspace:')) return [name, spec];\n const version = versions[name];\n if (version === undefined) throw new Error(`create-nisc: the nisc release has no ${name} — the set it was given is incomplete`);\n return [name, `^${version}`];\n }),\n );\n};\n\nexport const generate = (options: CreateOptions): Created => {\n const template = templateOf(options.posture, options.ui);\n const source = join(TEMPLATES, template);\n if (!existsSync(source)) throw new Error(`create-nisc: no template \"${template}\"`);\n if (!validName(options.name)) throw new Error(`create-nisc: \"${options.name}\" is not a package name (lowercase letters, digits, - . _)`);\n if (existsSync(options.dir) && !statSync(options.dir).isDirectory()) throw new Error(`create-nisc: ${options.dir} is a file`);\n\n // ── everything it would write, worked out before anything is written ──\n const token = tokenOf(template);\n const planned = new Map<string, string | Buffer>();\n for (const rel of filesIn(source)) {\n const from = join(source, rel);\n if (rel === 'package.json') {\n const manifest: unknown = JSON.parse(readFileSync(from, 'utf8'));\n if (!isRecord(manifest)) throw new Error(`create-nisc: ${template}/package.json is not an object`);\n const app = {\n ...manifest,\n name: options.name,\n dependencies: pinned(manifest['dependencies'], options.versions),\n devDependencies: pinned(manifest['devDependencies'], options.versions),\n };\n planned.set(rel, `${JSON.stringify(app, null, 2)}\\n`);\n } else if (TEXT.has(extname(rel))) {\n planned.set(rel, readFileSync(from, 'utf8').split(token).join(options.name));\n } else {\n planned.set(rel, readFileSync(from));\n }\n }\n const facts = { name: options.name, posture: options.posture, ui: options.ui, today: options.today, nisc: options.versions['@niscorp/nisc'] ?? 'unknown' };\n planned.set('AGENTS.md', agentsDoc(facts));\n planned.set('PLAN.md', planDoc(facts));\n\n // ── what is already there ──\n const there = (rel: string): boolean => existsSync(join(options.dir, rel));\n const kept = [...planned.keys()].filter((rel) => KEEP_THEIRS.has(rel) && there(rel));\n const collisions = [...planned.keys()].filter((rel) => !KEEP_THEIRS.has(rel) && there(rel)).sort();\n if (collisions.length > 0) {\n throw new Error(\n `create-nisc: ${options.dir} already has ${collisions.length === 1 ? 'a file' : 'files'} a new app would write — nothing was written:\\n ${collisions.join('\\n ')}\\nMake the app in an empty folder, or in a subfolder of this one.`,\n );\n }\n for (const rel of kept) planned.delete(rel);\n\n // .gitignore is the one file that is added to: theirs, plus what is missing.\n const ignorePath = join(options.dir, '.gitignore');\n const theirs = existsSync(ignorePath) ? readFileSync(ignorePath, 'utf8') : undefined;\n const have = new Set((theirs ?? '').split('\\n').map((line) => line.trim()));\n const missing = gitignoreLines.filter((line) => !have.has(line));\n const extended = theirs !== undefined && missing.length > 0 ? ['.gitignore'] : [];\n if (theirs === undefined) planned.set('.gitignore', `${gitignoreLines.join('\\n')}\\n`);\n else if (missing.length > 0) planned.set('.gitignore', `${theirs.replace(/\\n*$/, '\\n')}${missing.join('\\n')}\\n`);\n\n // ── only now ──\n for (const [rel, content] of planned) {\n const to = join(options.dir, rel);\n mkdirSync(dirname(to), { recursive: true });\n writeFileSync(to, content);\n }\n return { files: [...planned.keys()].filter((rel) => !extended.includes(rel)).sort(), kept, extended };\n};\n","// The versions a new app depends on: the nisc release its template was checked\n// against — written into this package when it is built (tsup.config.ts reads\n// them off the workspace), never looked up.\n//\n// \"Whatever is newest on npm\" would be a set nobody tested the templates with.\n// This is the set the repository's CI built, typechecked and checked every\n// template against, at the commit this package was built from; create-nisc is\n// versioned in lockstep with @niscorp/nisc, so the newest create-nisc carries\n// the newest set. It also means making an app needs no network.\ndeclare const __NISC_SET__: Readonly<Record<string, string>> | undefined;\n\nexport const testedSet = (): Readonly<Record<string, string>> => {\n if (typeof __NISC_SET__ === 'undefined') throw new Error('create-nisc: this copy was not built — it carries no nisc release to pin a new app to');\n return __NISC_SET__;\n};\n"]}
|