create-nisc 0.2.4 → 0.3.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.
- package/CHANGELOG.md +25 -0
- package/dist/{chunk-AF3Z4L5M.js → chunk-BN7HYPGT.js} +3 -3
- package/dist/{chunk-AF3Z4L5M.js.map → chunk-BN7HYPGT.js.map} +1 -1
- package/dist/cli.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/moss-dom/strata.lock.json +1 -1
- package/templates/moss-react/strata.lock.json +1 -1
- package/templates/shell-dom/src/app/actions/surfaces/welcome.layout.ts +10 -3
- package/templates/shell-dom/strata.lock.json +1 -1
- package/templates/shell-react/src/app/actions/surfaces/welcome.layout.ts +10 -3
- package/templates/shell-react/strata.lock.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,30 @@
|
|
|
1
1
|
# create-nisc
|
|
2
2
|
|
|
3
|
+
## 0.3.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- de6d980: A fix for the last fix: `nova:head` is the document's `<head>`, and holds what a head holds. 0.1.4 gave it five props (`title`, `description`, `image`, `kind`, `structured`) and wrote tags from them, which closed a head to whatever nova had been taught: no `og:image:alt`, no `og:type` but two, no whole address inside structured data. That was wrong, and it is replaced, not extended. The maintainer withdrew 0.1.4's props on 2026-10-04; this ships as a patch on that decision.
|
|
8
|
+
|
|
9
|
+
**What to change** (only an app that used 0.1.4's props): a `nova:head` node no longer takes props. Write its children instead — `nova:title`, `nova:meta`, `nova:link`, `nova:script` — each with the element's attributes as its props. `{ title: X }` becomes `{ component: 'nova:title', children: X }`; `description` becomes `nova:meta` with `name: 'description'`; `image` and `kind` become `nova:meta` with `property: 'og:image'` and `property: 'og:type'`; `structured` becomes `nova:script` with `type: 'application/ld+json'` and `data`. `og:title` and `og:description` are no longer written from the title and description: say them if they are wanted. An address is written as given — a picture's is not made whole from `site`. Code that called `headOf`, `placeHead` or `createTitleKeeper`, or read `head` off `renderDocument`'s result or a route report, takes the new shapes below.
|
|
10
|
+
- **nova** — a head's children are the elements a head holds, named as HTML names them, and **a child's props are that element's attributes, written as given**: nova keeps no list of them, so any `name`, `property` or `rel` can be said. Nothing in a head is drawn on the screen and no name has to be registered. With more than one head on a screen they are read in the order the screen is drawn, and an element that says the same thing as an earlier one (the title, a `<meta>` of that name or property, the canonical address) takes its place; anything else stands beside its like. What runs or styles is refused, left out and named: a script a browser would execute (`nova:script` is a data block — a JSON `type`, never a `src`), a stylesheet, `http-equiv`, a handler attribute. `headOf(api)` returns `{ elements, actions, refused }`. In `@niscorp/nova/document`, `placeHead(html, elements, { site, path })` writes them — an element takes the place of the tag that said the same thing, where it stood; what it wrote is marked `data-nova-head`, and a tag that gave way is kept inert in a `<template data-nova-own>` — and `createHeadKeeper(document)` replaces `createTitleKeeper`: the whole head follows the screen in the page, and the document's own tags come back when the screen stops saying them. Removed: the five props, the `Head` and `HeadProps` types, `createTitleKeeper`.
|
|
11
|
+
- **cli** — `build`, `export` and `start` write each path's head from those elements. A head that holds what it may not fails the path, like any other check. `site` still gives every path its own canonical address and `og:url`; it no longer touches a picture's address.
|
|
12
|
+
- **moss** — `renderDocument` and `exportDocuments` do the same from the snapshot (`head` on the result is `{ elements, actions, refused }`; a refusal is logged and left out), and the terminal keeps the whole head off the wire.
|
|
13
|
+
- **create-nisc** — the two own-shell templates write their welcome screen's head this way.
|
|
14
|
+
|
|
15
|
+
**Where a script goes:** in the app's own `index.html`, which holds anything and from which every page is written, or in the kit component that needs it. A layout is data and does not carry one.
|
|
16
|
+
|
|
17
|
+
- f1cec45: A Prism config that validates no longer names an op Prism does not have. `validate` accepted `{ card: { $fetch: … } }` and `{ $eval: "…" }`: the plain-object branch refused only the names of ops that exist, so any other `$` key passed as a template key. Such a config could be stored — an endpoint request, a vex mapping, a strata migration — and then failed every time it was evaluated (`E_NODE_SHAPE`, "Unsupported node shape").
|
|
18
|
+
|
|
19
|
+
A key that starts with `$` is now an op's name and nothing else. The template branch refuses every `$` key — the rule the evaluator already held — so `validate` reports it with the key and where it is (`card.$fetch: Not a Prism op. A key that starts with "$" names an op; data with such a key goes in $const.`), and `evaluate` and `compile` fail with `E_SCHEMA` before anything runs. An op's name used as a template key keeps its own message. `E_NODE_SHAPE` is left for a tree that never went through the schema: an IR handed to `execute`. Adding an op no longer takes a key away from templates.
|
|
20
|
+
- **prism** — the change, and a grammar narrowing: `nisc.prism` 2, a marker with no document step (a key that never evaluated has nothing to be rewritten to). `$` keys that are data are untouched: a `$const` payload, `$with` names, `$renameKeys` and `$fromEntries` keys. The JSON Schema's template key pattern is `^(?!\$)` instead of a list of every op.
|
|
21
|
+
- **nova, vex, moss, loom, cli, nisc** — no change of their own. They depend on prism and are released with it, so the set installs together; the configs they hand to prism (endpoint `request` and `response`, `$prism` bindings, vex mappings) are held to the same rule.
|
|
22
|
+
- **create-nisc** — the templates' sources are recorded at `nisc.prism` 2.
|
|
23
|
+
|
|
24
|
+
**What to change:** in a config with a `$`-prefixed key that is not a Prism op, remove the key — or put the object in `$const` if it is literal data. An app that keeps a `strata.lock.json` runs `pnpm strata upgrade`, then `pnpm strata verify`; there is nothing to edit unless it has such a config. Everything else: nothing.
|
|
25
|
+
|
|
26
|
+
BREAKING — approved by moccadroid, 2026-10-04: a config with a `$`-prefixed key that is not a Prism op no longer validates, compiles or evaluates — also where evaluation never reached the key (an untaken `$case` branch, a short-circuited `$or`, a `$map` body over an empty array), which used to work. A vex seed mapping with one fails when it is seeded, at boot, instead of on each replay. Code that matched `E_NODE_SHAPE` from `evaluate` gets `E_SCHEMA`. The `@niscorp` packages that depend on prism move with it, so an app moves them together (`@niscorp/nisc` 0.3.0).
|
|
27
|
+
|
|
3
28
|
## 0.2.4
|
|
4
29
|
|
|
5
30
|
### Patch Changes
|
|
@@ -3,7 +3,7 @@ import { join, extname, dirname } from 'path';
|
|
|
3
3
|
import { fileURLToPath } from 'url';
|
|
4
4
|
|
|
5
5
|
// <define:__NISC_SET__>
|
|
6
|
-
var define_NISC_SET_default = { "@niscorp/charter": "0.1.1", "@niscorp/cli": "0.
|
|
6
|
+
var define_NISC_SET_default = { "@niscorp/charter": "0.1.1", "@niscorp/cli": "0.3.0", "@niscorp/cortex": "0.1.1", "@niscorp/loom": "0.2.0", "@niscorp/moss": "0.3.0", "@niscorp/nisc": "0.3.0", "@niscorp/nova": "0.2.0", "@niscorp/prism": "0.2.0", "@niscorp/signal": "0.1.1", "@niscorp/solid": "0.1.0", "@niscorp/strata": "0.1.1", "@niscorp/tide": "0.1.2", "@niscorp/vex": "0.2.0" };
|
|
7
7
|
|
|
8
8
|
// src/docs.ts
|
|
9
9
|
var uiName = (ui) => ui === "react" ? "React" : "plain DOM (nova\u2019s DOM adapter \u2014 no framework in the page)";
|
|
@@ -170,5 +170,5 @@ var testedSet = () => {
|
|
|
170
170
|
};
|
|
171
171
|
|
|
172
172
|
export { TEMPLATES, generate, templateOf, testedSet, validName };
|
|
173
|
-
//# sourceMappingURL=chunk-
|
|
174
|
-
//# sourceMappingURL=chunk-
|
|
173
|
+
//# sourceMappingURL=chunk-BN7HYPGT.js.map
|
|
174
|
+
//# sourceMappingURL=chunk-BN7HYPGT.js.map
|
|
@@ -1 +1 @@
|
|
|
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-AF3Z4L5M.js","sourcesContent":["{\"@niscorp/charter\":\"0.1.1\",\"@niscorp/cli\":\"0.2.3\",\"@niscorp/cortex\":\"0.1.1\",\"@niscorp/loom\":\"0.1.1\",\"@niscorp/moss\":\"0.2.4\",\"@niscorp/nisc\":\"0.2.4\",\"@niscorp/nova\":\"0.1.4\",\"@niscorp/prism\":\"0.1.2\",\"@niscorp/signal\":\"0.1.1\",\"@niscorp/solid\":\"0.1.0\",\"@niscorp/strata\":\"0.1.1\",\"@niscorp/tide\":\"0.1.2\",\"@niscorp/vex\":\"0.1.1\"}","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 wire keeps a cookie copy of the session token so a page can be drawn for the person asking (AGENTS.md rule 12), and 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"]}
|
|
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-BN7HYPGT.js","sourcesContent":["{\"@niscorp/charter\":\"0.1.1\",\"@niscorp/cli\":\"0.3.0\",\"@niscorp/cortex\":\"0.1.1\",\"@niscorp/loom\":\"0.2.0\",\"@niscorp/moss\":\"0.3.0\",\"@niscorp/nisc\":\"0.3.0\",\"@niscorp/nova\":\"0.2.0\",\"@niscorp/prism\":\"0.2.0\",\"@niscorp/signal\":\"0.1.1\",\"@niscorp/solid\":\"0.1.0\",\"@niscorp/strata\":\"0.1.1\",\"@niscorp/tide\":\"0.1.2\",\"@niscorp/vex\":\"0.2.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 wire keeps a cookie copy of the session token so a page can be drawn for the person asking (AGENTS.md rule 12), and 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"]}
|
package/dist/cli.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { validName, generate, testedSet } from './chunk-
|
|
1
|
+
import { validName, generate, testedSet } from './chunk-BN7HYPGT.js';
|
|
2
2
|
import { existsSync, readdirSync } from 'fs';
|
|
3
3
|
import { basename, resolve, relative } from 'path';
|
|
4
4
|
import { intro, text, confirm, cancel, select, note, outro, isCancel } from '@clack/prompts';
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-nisc",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "npm create nisc — a new nisc application: a few questions, then an app with the right structure, its rulebook, and a first screen that works.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -5,9 +5,16 @@ import type { LayoutNode } from '@niscorp/nova';
|
|
|
5
5
|
export const welcomeLayout: LayoutNode = {
|
|
6
6
|
component: 'Page',
|
|
7
7
|
children: [
|
|
8
|
-
//
|
|
9
|
-
// into the file's <head>, and in the page the
|
|
10
|
-
|
|
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
|
+
{
|
|
12
|
+
component: 'nova:head',
|
|
13
|
+
children: [
|
|
14
|
+
{ component: 'nova:title', children: '{{$.name}}' },
|
|
15
|
+
{ component: 'nova:meta', props: { name: 'description', content: 'A nisc app with its own shell.' } },
|
|
16
|
+
],
|
|
17
|
+
},
|
|
11
18
|
{ component: 'Heading', children: '{{$.name}}' },
|
|
12
19
|
{
|
|
13
20
|
component: 'Text',
|
|
@@ -5,9 +5,16 @@ import type { LayoutNode } from '@niscorp/nova';
|
|
|
5
5
|
export const welcomeLayout: LayoutNode = {
|
|
6
6
|
component: 'Page',
|
|
7
7
|
children: [
|
|
8
|
-
//
|
|
9
|
-
// into the file's <head>, and in the page the
|
|
10
|
-
|
|
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
|
+
{
|
|
12
|
+
component: 'nova:head',
|
|
13
|
+
children: [
|
|
14
|
+
{ component: 'nova:title', children: '{{$.name}}' },
|
|
15
|
+
{ component: 'nova:meta', props: { name: 'description', content: 'A nisc app with its own shell.' } },
|
|
16
|
+
],
|
|
17
|
+
},
|
|
11
18
|
{ component: 'Heading', children: '{{$.name}}' },
|
|
12
19
|
{
|
|
13
20
|
component: 'Text',
|