@graview/core 0.1.0

package/dist/persistence/sqlite.d.ts

@@ -0,0 +1,59 @@
+import type { PersistenceAdapter } from "./types.js";
+/**
+ * The slice of better-sqlite3 this adapter needs. Typed structurally so the
+ * package never has to import the native module, and so a Drizzle app can
+ * hand over its underlying client (`db.$client`) with no wrapper.
+ */
+export interface SqliteStatement {
+    all(...params: unknown[]): unknown[];
+    run(...params: unknown[]): unknown;
+}
+export interface SqliteDatabase {
+    prepare(sql: string): SqliteStatement;
+    exec(sql: string): unknown;
+    transaction<T extends (...args: never[]) => unknown>(fn: T): T;
+}
+export interface SqliteAdapterOptions {
+    readonly database: SqliteDatabase;
+    /** Defaults match the household example's existing tables exactly. */
+    readonly nodeTable?: string;
+    readonly edgeTable?: string;
+    readonly opTable?: string;
+    /** Column holding the scope key (the household example: `household_id`). */
+    readonly scopeColumn?: string;
+    /** Creates the tables when absent. Off by default: never touch an app's schema. */
+    readonly createTables?: boolean;
+}
+/**
+ * The Drizzle/SQLite table shapes this adapter reads and writes, for an app
+ * that wants to declare them in its own Drizzle schema:
+ *
+ * ```ts
+ * export const graphNodes = sqliteTable("graph_nodes", {
+ *   householdId: text("household_id").notNull(),
+ *   id: text("id").notNull(),
+ *   kind: text("kind").notNull(),
+ *   data: text("data").notNull(),
+ * }, (t) => [primaryKey({ columns: [t.householdId, t.id] })]);
+ *
+ * export const graphEdges = sqliteTable("graph_edges", {
+ *   householdId: text("household_id").notNull(),
+ *   position: integer("position").notNull(),
+ *   kind: text("kind").notNull(),
+ *   fromId: text("from_id").notNull(),
+ *   toId: text("to_id").notNull(),
+ * }, (t) => [primaryKey({ columns: [t.householdId, t.position] })]);
+ * ```
+ */
+export declare const SQLITE_TABLE_SHAPE: {
+    readonly nodes: readonly ["scope", "id", "kind", "data"];
+    readonly edges: readonly ["scope", "position", "kind", "from_id", "to_id"];
+};
+/**
+ * Reads and writes an app's existing `graph_nodes` / `graph_edges` tables —
+ * the shape the household example already stores. `data` is schemaless JSON on disk and
+ * becomes a typed node on the way in, validated by the schema registry when
+ * the snapshot is loaded into a Graph.
+ */
+export declare function createSqliteAdapter(options: SqliteAdapterOptions): PersistenceAdapter<string>;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/persistence/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/persistence/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IACrC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CACpC;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAAC,MAAM,CAAC,CAmH5B"}

package/dist/persistence/sqlite.js

@@ -0,0 +1,131 @@
+/**
+ * The Drizzle/SQLite table shapes this adapter reads and writes, for an app
+ * that wants to declare them in its own Drizzle schema:
+ *
+ * ```ts
+ * export const graphNodes = sqliteTable("graph_nodes", {
+ *   householdId: text("household_id").notNull(),
+ *   id: text("id").notNull(),
+ *   kind: text("kind").notNull(),
+ *   data: text("data").notNull(),
+ * }, (t) => [primaryKey({ columns: [t.householdId, t.id] })]);
+ *
+ * export const graphEdges = sqliteTable("graph_edges", {
+ *   householdId: text("household_id").notNull(),
+ *   position: integer("position").notNull(),
+ *   kind: text("kind").notNull(),
+ *   fromId: text("from_id").notNull(),
+ *   toId: text("to_id").notNull(),
+ * }, (t) => [primaryKey({ columns: [t.householdId, t.position] })]);
+ * ```
+ */
+export const SQLITE_TABLE_SHAPE = {
+    nodes: ["scope", "id", "kind", "data"],
+    edges: ["scope", "position", "kind", "from_id", "to_id"],
+};
+/**
+ * Reads and writes an app's existing `graph_nodes` / `graph_edges` tables —
+ * the shape the household example already stores. `data` is schemaless JSON on disk and
+ * becomes a typed node on the way in, validated by the schema registry when
+ * the snapshot is loaded into a Graph.
+ */
+export function createSqliteAdapter(options) {
+    const db = options.database;
+    const nodeTable = options.nodeTable ?? "graph_nodes";
+    const edgeTable = options.edgeTable ?? "graph_edges";
+    const opTable = options.opTable ?? "graview_ops";
+    const scope = options.scopeColumn ?? "household_id";
+    if (options.createTables) {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS ${nodeTable} (
+        ${scope} TEXT NOT NULL, id TEXT NOT NULL,
+        kind TEXT NOT NULL, data TEXT NOT NULL,
+        PRIMARY KEY (${scope}, id)
+      );
+      CREATE TABLE IF NOT EXISTS ${edgeTable} (
+        ${scope} TEXT NOT NULL, position INTEGER NOT NULL,
+        kind TEXT NOT NULL, from_id TEXT NOT NULL, to_id TEXT NOT NULL,
+        PRIMARY KEY (${scope}, position)
+      );
+      CREATE TABLE IF NOT EXISTS ${opTable} (
+        ${scope} TEXT NOT NULL, seq INTEGER NOT NULL, data TEXT NOT NULL,
+        PRIMARY KEY (${scope}, seq)
+      );
+    `);
+    }
+    const selectNodes = db.prepare(`SELECT id, kind, data FROM ${nodeTable} WHERE ${scope} = ?`);
+    const selectEdges = db.prepare(`SELECT kind, from_id, to_id FROM ${edgeTable} WHERE ${scope} = ? ORDER BY position ASC`);
+    const deleteNodes = db.prepare(`DELETE FROM ${nodeTable} WHERE ${scope} = ?`);
+    const deleteEdges = db.prepare(`DELETE FROM ${edgeTable} WHERE ${scope} = ?`);
+    const insertNode = db.prepare(`INSERT INTO ${nodeTable} (${scope}, id, kind, data) VALUES (?, ?, ?, ?)`);
+    const insertEdge = db.prepare(`INSERT INTO ${edgeTable} (${scope}, position, kind, from_id, to_id) VALUES (?, ?, ?, ?, ?)`);
+    /**
+     * The op table is the framework's own, not the app's, so it is created on
+     * demand. The node and edge tables are the app's and are never touched
+     * unless `createTables` explicitly asks for them.
+     */
+    let opTableReady = false;
+    function ensureOpTable() {
+        if (opTableReady)
+            return;
+        db.exec(`CREATE TABLE IF NOT EXISTS ${opTable} (
+         ${scope} TEXT NOT NULL, seq INTEGER NOT NULL, data TEXT NOT NULL,
+         PRIMARY KEY (${scope}, seq)
+       )`);
+        opTableReady = true;
+    }
+    const write = db.transaction(((key, snapshot) => {
+        deleteEdges.run(key);
+        deleteNodes.run(key);
+        for (const node of snapshot.nodes) {
+            insertNode.run(key, node.id, node.kind, JSON.stringify(node));
+        }
+        snapshot.edges.forEach((edge, position) => {
+            insertEdge.run(key, position, edge.kind, edge.from, edge.to);
+        });
+    }));
+    return {
+        name: "sqlite",
+        async load(key) {
+            const nodeRows = selectNodes.all(key);
+            if (nodeRows.length === 0)
+                return null;
+            const edgeRows = selectEdges.all(key);
+            const nodes = nodeRows.map((row) => {
+                const parsed = JSON.parse(row.data);
+                // `id` and `kind` live in columns as well as the JSON blob; the
+                // columns win so a row is never internally inconsistent.
+                return { ...parsed, id: row.id, kind: row.kind };
+            });
+            const edges = edgeRows.map((row) => ({
+                kind: row.kind,
+                from: row.from_id,
+                to: row.to_id,
+            }));
+            return { nodes, edges };
+        },
+        async save(key, snapshot) {
+            write(key, snapshot);
+        },
+        async delete(key) {
+            deleteEdges.run(key);
+            deleteNodes.run(key);
+        },
+        async loadLog(key) {
+            ensureOpTable();
+            const rows = db
+                .prepare(`SELECT data FROM ${opTable} WHERE ${scope} = ? ORDER BY seq ASC`)
+                .all(key);
+            return rows.map((row) => JSON.parse(row.data));
+        },
+        async appendOps(key, ops) {
+            if (ops.length === 0)
+                return;
+            ensureOpTable();
+            const insert = db.prepare(`INSERT OR REPLACE INTO ${opTable} (${scope}, seq, data) VALUES (?, ?, ?)`);
+            for (const op of ops)
+                insert.run(key, op.seq, JSON.stringify(op));
+        },
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/persistence/sqlite.js.map

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

package/dist/persistence/types.d.ts

@@ -0,0 +1,22 @@
+import type { GraphSnapshot } from "../graph/types.js";
+import type { Operation } from "../ops/types.js";
+/**
+ * The framework owns the reactive graph, invariants, diff and undo;
+ * persistence is pluggable underneath. One interface, so a memory adapter
+ * in a test and a SQLite adapter in production are interchangeable.
+ */
+export interface PersistenceAdapter<Scope = string> {
+    readonly name: string;
+    /**
+     * Returns null when nothing has been stored for this scope. Note that a
+     * store of an EMPTY graph is indistinguishable from no store at all in a
+     * row-backed adapter — treat "null" as "no nodes", not as "never saved".
+     */
+    load(scope: Scope): Promise<GraphSnapshot | null>;
+    save(scope: Scope, snapshot: GraphSnapshot): Promise<void>;
+    delete(scope: Scope): Promise<void>;
+    /** Optional: adapters that keep history append the log too. */
+    loadLog?(scope: Scope): Promise<Operation[]>;
+    appendOps?(scope: Scope, ops: readonly Operation[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/persistence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,MAAM;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,+DAA+D;IAC/D,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7C,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE"}

package/dist/persistence/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":""}

package/dist/presence.d.ts

@@ -0,0 +1,38 @@
+export interface PresenceRobot {
+    /** What the robot stands at: a node id, `kind:<kind>`, or null for its dock. */
+    readonly at: string | null;
+    readonly mode: string;
+}
+export interface Presence {
+    /** `kind:id:session` — the op log's own reading of an author, so a figure and its edits agree. */
+    readonly participant: string;
+    /** What to call them. Absent for an anonymous viewer, who is counted rather than drawn. */
+    readonly name?: string;
+    readonly hue: number;
+    /** Where they are: `toUrl(view)`, the complete answer. */
+    readonly stop: string;
+    /** What they are hovering, when they have chosen to share it. */
+    readonly over?: string | null;
+    /** Their seat's robot, if it has a body somewhere. */
+    readonly robot?: PresenceRobot;
+    /** When they last said so, ISO. */
+    readonly at: string;
+}
+export interface PresenceChannel {
+    /** Say where you are. Called on every change and on every heartbeat. */
+    here(presence: Presence): void;
+    /** Told who else is here, every time that changes. Returns the way to stop listening. */
+    onWho(listener: (who: readonly Presence[]) => void): () => void;
+    /** Say you have gone, and stop. */
+    leave(): void;
+}
+/** How long a presence stands after its last word: three missed heartbeats at the poll's own pace. */
+export declare const PRESENCE_TTL_MS = 2500;
+/**
+ * The others as they are now: what arrived, minus what has gone quiet, minus
+ * yourself. Pure, so a test can ask what a viewer sees without a channel.
+ */
+export declare function foldPresence(known: ReadonlyMap<string, Presence>, arrived: readonly Presence[], now: number, ttlMs?: number, self?: string): Map<string, Presence>;
+/** Two presences that would draw the same figure in the same place. */
+export declare function samePresence(a: Presence | undefined, b: Presence | undefined): boolean;
+//# sourceMappingURL=presence.d.ts.map

package/dist/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,kGAAkG;IAClG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,yFAAyF;IACzF,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,QAAQ,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAChE,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,sGAAsG;AACtG,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,MAAwB,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAevB;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAWtF"}

package/dist/presence.js

@@ -0,0 +1,50 @@
+/*
+ * WHO IS WHERE — a fact about a person at a screen, not a change to the graph.
+ *
+ * Presence never enters the op log. It is a payload each viewer sends about
+ * itself — which stop it is on, what it is hovering, where its robot stands
+ * — and each viewer draws everybody else on ITS OWN map from those facts,
+ * so two windows of different sizes agree about who is at the tasks plot
+ * without agreeing about a single pixel. The channel that carries it is
+ * behind one interface with two implementations in `@graview/ship`: a
+ * BroadcastChannel between tabs of one origin, and two routes on the served
+ * store folded into the poll it already makes.
+ */
+/** How long a presence stands after its last word: three missed heartbeats at the poll's own pace. */
+export const PRESENCE_TTL_MS = 2500;
+/**
+ * The others as they are now: what arrived, minus what has gone quiet, minus
+ * yourself. Pure, so a test can ask what a viewer sees without a channel.
+ */
+export function foldPresence(known, arrived, now, ttlMs = PRESENCE_TTL_MS, self) {
+    const next = new Map();
+    for (const [participant, presence] of known) {
+        if (now - Date.parse(presence.at) < ttlMs)
+            next.set(participant, presence);
+    }
+    for (const presence of arrived) {
+        if (now - Date.parse(presence.at) >= ttlMs) {
+            next.delete(presence.participant);
+            continue;
+        }
+        const held = next.get(presence.participant);
+        if (!held || Date.parse(held.at) <= Date.parse(presence.at))
+            next.set(presence.participant, presence);
+    }
+    if (self !== undefined)
+        next.delete(self);
+    return next;
+}
+/** Two presences that would draw the same figure in the same place. */
+export function samePresence(a, b) {
+    if (!a || !b)
+        return a === b;
+    return (a.participant === b.participant &&
+        a.name === b.name &&
+        a.hue === b.hue &&
+        a.stop === b.stop &&
+        (a.over ?? null) === (b.over ?? null) &&
+        (a.robot?.at ?? null) === (b.robot?.at ?? null) &&
+        (a.robot?.mode ?? null) === (b.robot?.mode ?? null));
+}
+//# sourceMappingURL=presence.js.map

package/dist/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiCH,sGAAsG;AACtG,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoC,EACpC,OAA4B,EAC5B,GAAW,EACX,QAAgB,eAAe,EAC/B,IAAa;IAEb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;QAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,CAAuB,EAAE,CAAuB;IAC3E,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CACL,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;QAC/B,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACjB,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;QACf,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACjB,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QACrC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC;QAC/C,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,CACpD,CAAC;AACJ,CAAC"}

package/dist/scaffold/domain.d.ts

@@ -0,0 +1,8 @@
+import { type Ids } from "./names.js";
+export declare function schemaTs(ids: Ids): string;
+export declare function mutationsTs(ids: Ids): string;
+export declare function invariantsTs(ids: Ids): string;
+export declare function brandTs(ids: Ids): string;
+export declare function appTs(ids: Ids): string;
+export declare function domainTest(ids: Ids): string;
+//# sourceMappingURL=domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/scaffold/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,YAAY,CAAC;AASpE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAsCzC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAkF5C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAgD7C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAqCxC;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAkDtC;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CA8D3C"}