@graview/core 0.1.0

package/dist/scaffold/domain.js

@@ -0,0 +1,331 @@
+import { escapeString, escapeTemplate } from "./names.js";
+/*
+ * THE DECLARATION A NEW PROJECT STARTS WITH: one kind, its acts, its rule,
+ * its brand, the app that holds them, and the test that proves they hold.
+ */
+/* --------------------------------------------------------------- domain */
+export function schemaTs(ids) {
+    return `import { createSchema, defineNode } from "@graview/core";
+import { z } from "@graview/core";
+
+/**
+ * The first kind. Model one thing well before modelling the domain: the
+ * loop that matters on day one is declare → \`graview check\` → look at it →
+ * declare more.
+ */
+export const ${ids.kindVar} = defineNode("${ids.kind}", {
+  description: "${ids.ASpoken}: something ${escapeString(ids.name)} keeps track of.",
+  fields: z.object({
+    // A name, bounded: a model filling it writes a name, not a paragraph.
+    label: z.string().min(1).max(60),
+    status: z.enum(["open", "closed"]),
+  }),
+  edges: {
+    // An edge to a kind nobody declared is a typecheck failure, not a
+    // runtime surprise.
+    // One edge, two readings: each end is captioned in its own words.
+    "depends-on": {
+      to: ["${ids.kind}"],
+      description: "what has to be closed first",
+      inverse: "what is waiting on this",
+    },
+  },
+  plural: "${ids.Plural}",
+  label: (node) => node.label,
+  /*
+   * The horizon: a closed ${ids.spoken} leaves the counts but never the graph.
+   * Districts say "+N past" instead of drowning, and \`past=1\` widens the view.
+   */
+  lifecycle: { field: "status", retired: ["closed"] },
+});
+
+export const ${ids.schemaVar} = createSchema([${ids.kindVar}]);
+export type ${ids.SchemaType} = typeof ${ids.schemaVar};
+`;
+}
+export function mutationsTs(ids) {
+    return `import { bindSchema, nodeRef, type GraphReader } from "@graview/core";
+import { z } from "@graview/core";
+import { ${ids.schemaVar} } from "./schema.js";
+
+const { defineMutation } = bindSchema(${ids.schemaVar});
+
+type Reader = GraphReader<{ id: string; kind: string } & Record<string, unknown>>;
+const nameOf = (graph: Reader, id: string): string => {
+  const node = graph.getNode(id);
+  return typeof node?.["label"] === "string" ? (node["label"] as string) : id;
+};
+
+/**
+ * Every change is a named act. The title is the label in the strip and the
+ * instruction in an agent's tool schema, so an opaque one costs twice.
+ */
+
+export const add${ids.KindPascal} = defineMutation("add-${ids.kind}", {
+  title: "Add ${ids.aSpoken}",
+  description: "Bring a new ${ids.spoken} into ${escapeString(ids.name)}.",
+  // Says what it brings into existence: an EMPTY district offers this act
+  // as its own beginning, which is the whole onboarding of a blank graph.
+  creates: ["${ids.kind}"],
+  input: z.object({ label: z.string().min(1).max(60) }),
+  describe: (args) => \`Add \${args.label}\`,
+  apply(ctx, args) {
+    ctx.addNode({
+      id: ctx.freshId(args.label, "${ids.kind}"),
+      kind: "${ids.kind}",
+      label: args.label,
+      status: "open",
+    });
+  },
+});
+
+export const link${ids.KindPascal} = defineMutation("link-${ids.kind}", {
+  title: "Depends on",
+  description: "Say one ${ids.spoken} has to be closed before another.",
+  subject: { kinds: ["${ids.kind}"], arg: "id" },
+  // Names the edge kind it makes: the drawn line becomes selectable, and
+  // the act is offered from either end.
+  connects: ["depends-on"],
+  input: z.object({ id: nodeRef(["${ids.kind}"]), dependsOn: nodeRef(["${ids.kind}"]) }),
+  describe: (args, graph) =>
+    \`\${nameOf(graph as Reader, args.id)} depends on \${nameOf(graph as Reader, args.dependsOn)}\`,
+  apply(ctx, args) {
+    if (args.id === args.dependsOn) return;
+    ctx.addEdge({ kind: "depends-on", from: args.id, to: args.dependsOn });
+  },
+});
+
+export const unlink${ids.KindPascal} = defineMutation("unlink-${ids.kind}", {
+  title: "No longer depends on",
+  description: "Take back a dependency between two ${ids.spokenPlural}.",
+  subject: { kinds: ["${ids.kind}"], arg: "id" },
+  // Names the edge kind it breaks: a relation you can make but never unmake
+  // is a check warning, and a drawn line with nothing to sever hides the act.
+  severs: ["depends-on"],
+  input: z.object({ id: nodeRef(["${ids.kind}"]), dependsOn: nodeRef(["${ids.kind}"]) }),
+  describe: (args, graph) =>
+    \`\${nameOf(graph as Reader, args.id)} no longer depends on \${nameOf(graph as Reader, args.dependsOn)}\`,
+  apply(ctx, args) {
+    ctx.removeEdge({ kind: "depends-on", from: args.id, to: args.dependsOn });
+  },
+});
+
+export const close${ids.KindPascal} = defineMutation("close-${ids.kind}", {
+  title: "Close it",
+  description: "Mark ${ids.aSpoken} closed. It leaves the picture, never the record.",
+  subject: { kinds: ["${ids.kind}"], arg: "id" },
+  // Writes the status without asking for it, and says so.
+  writes: ["status"],
+  input: z.object({ id: nodeRef(["${ids.kind}"]) }),
+  describe: (args, graph) => \`Close \${nameOf(graph as Reader, args.id)}\`,
+  apply(ctx, args) {
+    ctx.patchNode(args.id, { status: "closed" });
+  },
+});
+
+export const mutations = [add${ids.KindPascal}, link${ids.KindPascal}, unlink${ids.KindPascal}, close${ids.KindPascal}];
+`;
+}
+export function invariantsTs(ids) {
+    return `import { bindSchema, type Violation } from "@graview/core";
+import { ${ids.schemaVar} } from "./schema.js";
+
+const { defineInvariant } = bindSchema(${ids.schemaVar});
+
+/**
+ * The first rule, and the repair it names. A rule that only complains is
+ * half a rule: the repairs below become one-click fixes in the interface
+ * and legal moves for an agent, so name the mutation that resolves it.
+ *
+ * It judges the OPEN ${ids.spoken}: a closed one is behind the horizon, and
+ * the horizon is exactly the promise that what is closed stops asking for
+ * attention. What is wrong here is that something closed still leans on
+ * something open.
+ */
+export const closedInOrder = defineInvariant("closed-in-order", {
+  label: "Closed in order",
+  description: "Nothing closed may still depend on an open ${ids.spoken}.",
+  scope: { kind: "${ids.kind}" },
+  repairs: ["close-${ids.kind}"],
+  evaluate({ graph, subject }): Violation[] {
+    if (subject.status === "closed") return [];
+    const closed = graph
+      .in(subject.id, "depends-on")
+      .filter((other) => (other as { status: string }).status === "closed");
+    if (closed.length === 0) return [];
+    return [
+      {
+        invariant: "closed-in-order",
+        subjectId: subject.id,
+        label: subject.label,
+        message: \`\${subject.label} is still open, but \${closed.length} closed \${closed.length === 1 ? "${ids.spoken} depends" : "${ids.spokenPlural} depend"} on it\`,
+        nodeIds: [subject.id, ...closed.map((other) => other.id)],
+        repairs: [
+          {
+            mutation: "close-${ids.kind}",
+            args: { id: subject.id },
+            label: \`Close \${subject.label}\`,
+          },
+        ],
+      },
+    ];
+  },
+});
+
+export const invariants = [closedInOrder];
+`;
+}
+export function brandTs(ids) {
+    return `import { brandFromAccent, DARK, LIGHT, type Brand } from "@graview/core";
+
+/**
+ * One accent, and both schemes derived from it. \`graview check\` measures
+ * every text pair against AA rather than trusting the colour; if the accent
+ * cannot label a pending action legibly, the derivation says which pair
+ * failed and why instead of shipping it.
+ */
+const ACCENT = "${ids.accent}";
+
+const derived = brandFromAccent({ accent: ACCENT, base: { dark: DARK, light: LIGHT } });
+
+if (!derived.ok) {
+  throw new Error(
+    \`${escapeTemplate(ids.name)} cannot be derived from \${ACCENT} alone. Needs: \${derived.missing.join(", ")} — \${derived.why}\`,
+  );
+}
+
+export const ${ids.brandVar}: Brand = {
+  name: "${escapeString(ids.name)}",
+  // A mark: replace it with your own. Sixteen pixels, currentColor.
+  logo:
+    '<svg viewBox="0 0 24 24" width="16" height="16" aria-hidden="true" fill="none" ' +
+    'stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">' +
+    '<circle cx="12" cy="12" r="9"/><path d="M12 7v5l3 3"/></svg>',
+  typography: {
+    body: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+    display: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif',
+    mono: 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace',
+  },
+  shape: { radius: 10, density: 1 },
+  // Colour-by-kind, declared rather than hashed: one hue per kind.
+  accents: { "${ids.kind}": 150 },
+  schemes: derived.schemes,
+};
+`;
+}
+export function appTs(ids) {
+    return `import { defineApp, readerSettings, Store, type StoreOptions } from "@graview/core";
+import { ${ids.brandVar} } from "./brand.js";
+import { invariants } from "./invariants.js";
+import { mutations } from "./mutations.js";
+import { ${ids.schemaVar}, type ${ids.SchemaType} } from "./schema.js";
+
+/**
+ * The whole surface, in one object. \`graview check\` reads this; so do the
+ * docs generator, the tool surface, the pages face and the scene. Keep React
+ * out of this directory and the declaration stays inspectable by a build, a
+ * CLI and an agent.
+ */
+export const ${ids.appVar} = defineApp({
+  name: "${escapeString(ids.name)}",
+  schema: ${ids.schemaVar},
+  mutations,
+  invariants,
+  brand: ${ids.brandVar},
+  /*
+   * What belongs to the READER rather than to this installation: how big
+   * the words are, and whether things move. The profile pane on the bar
+   * draws exactly what is declared here, and the shell has already carried
+   * the answer to the root element — every surface is sized in \`rem\`, so
+   * one answer resizes the picture, the panes and the pages together.
+   */
+  settings: readerSettings(),
+  /*
+   * The intelligence, declared. The starter provider proposes first data
+   * from the schema alone (no key, no model); a real model plugs the same
+   * seam with one completion function. Both may only call what is listed.
+   */
+  intelligence: [
+    {
+      name: "starter",
+      kind: "graph",
+      description: "Proposes first data and open repairs from the declaration alone.",
+      may: ["add-${ids.kind}", "link-${ids.kind}", "unlink-${ids.kind}", "close-${ids.kind}"],
+    },
+  ],
+});
+
+export type ${ids.StoreType} = Store<${ids.SchemaType}>;
+
+export function createStore(options: Partial<StoreOptions<${ids.SchemaType}>> = {}): ${ids.StoreType} {
+  return new Store<${ids.SchemaType}>({ schema: ${ids.schemaVar}, mutations, invariants, ...options });
+}
+
+export default ${ids.appVar};
+`;
+}
+/* ---------------------------------------------------------------- tests */
+export function domainTest(ids) {
+    return `import { checkApp } from "@graview/core";
+import { kindCardId } from "@graview/layout";
+import { deriveAffordances } from "@graview/tools";
+import { describe, expect, it } from "vitest";
+import { ${ids.appVar}, createStore } from "../src/domain/app.js";
+
+/**
+ * The domain tier has no DOM in it, so these run headless. The test worth
+ * having is the one that catches a real regression: the rule fires on a
+ * graph that breaks it, and the repair it names resolves it.
+ */
+
+describe("the declaration", () => {
+  it("passes its own check", () => {
+    const result = checkApp(${ids.appVar});
+    expect(result.findings.filter((f) => f.severity === "error")).toEqual([]);
+    expect(result.ok).toBe(true);
+  });
+
+  it("offers an empty district its own beginnings, through creates", () => {
+    const store = createStore();
+    const { affordances } = deriveAffordances(store, [kindCardId("${ids.kind}")], {
+      kindSelection: ["${ids.kind}"],
+    });
+    expect(affordances.map((a) => a.mutation)).toContain("add-${ids.kind}");
+  });
+});
+
+describe("the rule", () => {
+  const broken = () => {
+    const store = createStore();
+    store.apply({ name: "add-${ids.kind}", args: { label: "First" } });
+    store.apply({ name: "add-${ids.kind}", args: { label: "Second" } });
+    const [first, second] = store.graph.nodesOfKind("${ids.kind}");
+    store.apply({ name: "link-${ids.kind}", args: { id: second!.id, dependsOn: first!.id } });
+    store.apply({ name: "close-${ids.kind}", args: { id: second!.id } });
+    return store;
+  };
+
+  it("fires when a closed ${ids.spoken} still depends on an open one", () => {
+    // One rule at a time: the second rule you declare must not fail this test.
+    const violations = broken().violations().filter((v) => v.invariant === "closed-in-order");
+    expect(violations).toHaveLength(1);
+    expect(violations[0]?.message).toMatch(/still open, but 1 closed/);
+    expect(violations[0]?.repairs).toHaveLength(1);
+  });
+
+  it("is resolved by the repair it names", () => {
+    const store = broken();
+    const repair = store.violations().find((v) => v.invariant === "closed-in-order")!.repairs[0]!;
+    store.apply({ name: repair.mutation, args: { ...repair.args } });
+    expect(store.violations().filter((v) => v.invariant === "closed-in-order")).toEqual([]);
+  });
+
+  it("keeps a closed ${ids.spoken} in the record, behind the horizon", () => {
+    const store = broken();
+    const closed = store.graph.nodesOfKind("${ids.kind}").filter((n) => n.status === "closed");
+    expect(closed).toHaveLength(1);
+  });
+});
+`;
+}
+//# sourceMappingURL=domain.js.map

package/dist/scaffold/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/scaffold/domain.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/index.d.ts

@@ -0,0 +1,66 @@
+export { pascal, slugify, titleCase, validateScaffoldOptions } from "./names.js";
+export { GRAVIEW_PACKAGES, LINKED_PACKAGES } from "./project.js";
+export interface ScaffoldOptions {
+    /** The product's name, as a person would say it: "Field Notes". */
+    readonly name: string;
+    /** The first node kind, as a slug: "note". Defaults to "item". */
+    readonly kind?: string;
+    /** The kind's plural, for districts and routes. Defaults to `${kind}s`. */
+    readonly plural?: string;
+    /** The npm package name. Defaults to the name, slugged. */
+    readonly packageName?: string;
+    /**
+     * The version range every `@graview/*` dependency takes. A published
+     * project wants the version of the packages that scaffolded it.
+     */
+    readonly range?: string;
+    /**
+     * A path to the framework repository, relative to the new project, for a
+     * project that consumes the framework by path rather than from a registry
+     * (`link:` dependencies, aliases into its sources, the dev server allowed
+     * to read it). This is how the first-party products are wired.
+     */
+    readonly link?: string;
+    /**
+     * In link mode: the framework's repository as "owner/name", so the
+     * project's CI can check it out as a sibling and build it before verify.
+     * Without it the workflow says what to fill in.
+     */
+    readonly frameworkRepo?: string;
+    /** Which package manager the project's scripts and CI assume. */
+    readonly packageManager?: "pnpm" | "npm";
+    /** The dev server's port. */
+    readonly port?: number;
+    /** The brand accent, as a hex colour. */
+    readonly accent?: string;
+    /**
+     * THE LAYOUT EVERY REAL PRODUCT ENDS UP WITH: a workspace root with the
+     * app under `app/`.
+     *
+     * A single standalone package is what this wrote, and no first-party
+     * product is one — because a real product accretes sibling things:
+     * `scripts/` for the harnesses, `docs/`, a PRD, a second surface. The
+     * harnesses are the tell. The framework documents `survey`, `audit-ui`,
+     * `a11y`, `shrunk` and `seat` as the things a serious product should
+     * steal, and then scaffolded a layout with nowhere to put them, so two
+     * products independently hand-wrote a workspace root around the scaffold.
+     * Two is a gap rather than a taste.
+     */
+    readonly workspace?: boolean;
+}
+export interface ScaffoldFile {
+    readonly path: string;
+    readonly contents: string;
+}
+export interface Scaffold {
+    readonly files: readonly ScaffoldFile[];
+    readonly name: string;
+    readonly packageName: string;
+    readonly kind: string;
+    readonly plural: string;
+    readonly packageManager: "pnpm" | "npm";
+    readonly port: number;
+    readonly linked: boolean;
+}
+export declare function scaffoldProject(options: ScaffoldOptions): Scaffold;
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffold/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA6HlE"}

package/dist/scaffold/index.js

@@ -0,0 +1,142 @@
+/**
+ * A new project, as a list of files.
+ *
+ * This module writes nothing. It takes a name and a first kind and returns
+ * every file a product on Graview starts with — the declaration split into
+ * domain and UI, the shell, the tests, the CI — so that the CLI can put them
+ * on disk, a test can assert on them without a filesystem, and a host that
+ * provisions apps from a declaration can call the same thing in-process.
+ *
+ * The shape here IS the shape the `graview-new-app` skill describes. When one
+ * changes, the other has to, and `scripts/smoke-create.mjs` is what notices:
+ * it scaffolds a project from the packed tarballs, installs it the way a
+ * stranger would, and runs the project's own `verify`.
+ */
+import { withArticle } from "../schema/define-node.js";
+import { slugify, titleCase, camel, pascal, validateScaffoldOptions } from "./names.js";
+import { SURVEY_SAYS, AUDIT_SAYS, A11Y_SAYS, harness, workspaceRoot, tsconfigBase, rootVitest, packageJson, tsconfig, tsconfigBuild, viteConfig, gitignore, readme, ciYml, } from "./project.js";
+import { schemaTs, mutationsTs, invariantsTs, brandTs, appTs, domainTest } from "./domain.js";
+import { indexHtml, embedHtml, embedTsx, viewsTsx, uiAppTsx, pagesTsx, mainTsx } from "./ui.js";
+export { pascal, slugify, titleCase, validateScaffoldOptions } from "./names.js";
+export { GRAVIEW_PACKAGES, LINKED_PACKAGES } from "./project.js";
+export function scaffoldProject(options) {
+    const problems = validateScaffoldOptions(options);
+    if (problems.length > 0)
+        throw new Error(problems.join("\n"));
+    const name = options.name.trim();
+    const kind = options.kind ?? "item";
+    const plural = options.plural ?? `${kind}s`;
+    const packageName = options.packageName ?? slugify(name);
+    const packageManager = options.packageManager ?? "pnpm";
+    const port = options.port ?? 5170;
+    const range = options.range ?? "*";
+    const workspace = options.workspace === true;
+    const rootLink = options.link?.replace(/\/+$/, "");
+    /*
+     * Every path the APP writes is one directory deeper in a workspace, so
+     * the link it consumes the framework by is one `../` longer. The root's
+     * own files use the link as given.
+     */
+    const link = rootLink === undefined ? undefined : workspace ? `../${rootLink}` : rootLink;
+    // A worked green that clears the checker's contrast pairs in both schemes.
+    const accent = options.accent ?? "#2e7d32";
+    // "work-order" is an identifier; a button says "work order".
+    const spoken = kind.replace(/-/g, " ");
+    const spokenPlural = plural.replace(/-/g, " ");
+    /*
+     * "Add a item" is what a template writes when the article is a literal.
+     * The kind is the author's word and half of them begin with a vowel, so
+     * every generated sentence takes its article from `withArticle` — the same
+     * one the checker and the strip use, so the project a stranger reads and
+     * the framework talking about it cannot disagree.
+     */
+    const aSpoken = withArticle(kind);
+    const ASpoken = aSpoken.charAt(0).toUpperCase() + aSpoken.slice(1);
+    const ids = {
+        name,
+        kind,
+        plural,
+        spoken,
+        spokenPlural,
+        aSpoken,
+        ASpoken,
+        Kind: titleCase(kind),
+        Plural: titleCase(plural),
+        kindVar: camel(kind),
+        KindPascal: pascal(kind),
+        appVar: `${camel(slugify(name))}App`,
+        brandVar: `${camel(slugify(name))}Brand`,
+        schemaVar: `${camel(slugify(name))}Schema`,
+        SchemaType: `${pascal(slugify(name))}Schema`,
+        StoreType: `${pascal(slugify(name))}Store`,
+        AppComponent: `${pascal(slugify(name))}App`,
+        accent,
+        port,
+        link,
+        frameworkRepo: options.frameworkRepo,
+        range,
+        packageManager,
+        packageName,
+    };
+    const files = [
+        { path: "package.json", contents: packageJson(ids, workspace) },
+        { path: "tsconfig.json", contents: tsconfig(workspace) },
+        { path: "tsconfig.build.json", contents: tsconfigBuild() },
+        { path: "vite.config.ts", contents: viteConfig(ids) },
+        { path: "index.html", contents: indexHtml(ids) },
+        { path: "embed.html", contents: embedHtml(ids) },
+        { path: ".gitignore", contents: gitignore() },
+        { path: "README.md", contents: readme(ids) },
+        { path: "src/domain/schema.ts", contents: schemaTs(ids) },
+        { path: "src/domain/mutations.ts", contents: mutationsTs(ids) },
+        { path: "src/domain/invariants.ts", contents: invariantsTs(ids) },
+        { path: "src/domain/brand.ts", contents: brandTs(ids) },
+        { path: "src/domain/app.ts", contents: appTs(ids) },
+        { path: "src/ui/views.tsx", contents: viewsTsx(ids) },
+        { path: "src/ui/app.tsx", contents: uiAppTsx(ids) },
+        { path: "src/ui/pages.tsx", contents: pagesTsx(ids) },
+        { path: "src/main.tsx", contents: mainTsx(ids) },
+        { path: "src/embed.tsx", contents: embedTsx(ids) },
+        { path: "tests/domain.test.ts", contents: domainTest(ids) },
+        { path: ".github/workflows/ci.yml", contents: ciYml(ids) },
+    ];
+    if (!workspace) {
+        return { files, name, packageName, kind, plural, packageManager, port, linked: link !== undefined };
+    }
+    /*
+     * THE WORKSPACE: the app under `app/`, and a root that has somewhere to
+     * put the things a product accretes. The harnesses are the point — they
+     * want to live at a root and drive the app — so they are written as stubs
+     * that say what they would measure rather than as a `scripts/` directory
+     * somebody has to invent.
+     */
+    /*
+     * What belongs to the PRODUCT rather than to the app package stays at the
+     * root: the README a person reads first, the CI that verifies the whole
+     * workspace, and the one .gitignore.
+     */
+    const atRoot = new Set(["README.md", ".gitignore", ".github/workflows/ci.yml"]);
+    const rooted = files.map((file) => atRoot.has(file.path) ? file : { ...file, path: `app/${file.path}` });
+    return {
+        files: [
+            { path: "package.json", contents: workspaceRoot(ids, rootLink) },
+            ...(packageManager === "pnpm"
+                ? [{ path: "pnpm-workspace.yaml", contents: "packages:\n  - app\n" }]
+                : []),
+            { path: "tsconfig.base.json", contents: tsconfigBase() },
+            { path: "vitest.config.ts", contents: rootVitest() },
+            { path: "scripts/survey.mjs", contents: harness("survey", SURVEY_SAYS, ids) },
+            { path: "scripts/audit-ui.mjs", contents: harness("audit-ui", AUDIT_SAYS, ids) },
+            { path: "scripts/a11y.mjs", contents: harness("a11y", A11Y_SAYS, ids) },
+            ...rooted,
+        ],
+        name,
+        packageName,
+        kind,
+        plural,
+        packageManager,
+        port,
+        linked: link !== undefined,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/scaffold/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/lens.d.ts

@@ -0,0 +1,31 @@
+import type { ScaffoldFile } from "./index.js";
+/**
+ * `graview lens <name>`: a lens, started.
+ *
+ * `graview figure` draws line art for a kind, and nothing generated a lens.
+ * The `graview-lens` skill is excellent about the RULES — bind roles not
+ * field names, fail loudly on a bad binding, mark every target with
+ * `data-graview-pick`, three fidelities, a title that makes it a place — and
+ * those are exactly the rules that are easy to agree with and easy to forget
+ * at line 300.
+ *
+ * So the stub has all of them already in it, and the reuse test — the one
+ * instruction with nothing enforcing it — starts life as a RED test in a
+ * domain the app is not about, rather than as a good intention. A lens whose
+ * reuse test cannot be written is a view; the stub says so in the place
+ * where you would find that out.
+ */
+export interface LensScaffoldOptions {
+    /** The lens's name, as a slug: "grounds-map". */
+    readonly name: string;
+    /** Roles the lens requires an app to bind. */
+    readonly roles: readonly string[];
+    /** Field names onto roles, or roles onto whole kinds and edges. */
+    readonly binds?: "fields" | "entities";
+    /** Where the lens goes. Defaults to `src/ui/lens`. */
+    readonly dir?: string;
+}
+export declare function validateLensOptions(options: LensScaffoldOptions): readonly string[];
+/** The files a new lens is: the lens itself, and the test that proves it. */
+export declare function scaffoldLens(options: LensScaffoldOptions): readonly ScaffoldFile[];
+//# sourceMappingURL=lens.d.ts.map

package/dist/scaffold/lens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.d.ts","sourceRoot":"","sources":["../../src/scaffold/lens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACvC,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,MAAM,EAAE,CAYnF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,YAAY,EAAE,CAUlF"}