@assemora/schema 0.1.0

package/dist/design.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Universal design controls (SPEC.md §61).
+ *
+ * Every block gets the same seven settings — spacing, width, alignment, background,
+ * visibility, responsive visibility and container width — and gets them without its
+ * author declaring anything. What a block does with its *own* fields stays the block
+ * author's business (SPEC.md §61: "Visual specifics stay in developer-defined
+ * blocks").
+ *
+ * Every value is a token, never CSS. That is the point: a person picks `lg`, an agent
+ * writes `lg`, and what `lg` means is decided once by the theme (SPEC.md §62). Nothing
+ * here can express a colour, a pixel or a rule, so nothing here can be used to smuggle
+ * a stylesheet into a page.
+ *
+ * The settings live beside `props` on the node rather than inside it, because `props`
+ * belongs to the block's own schema and a framework key in there would collide with a
+ * field somebody declared.
+ */
+import { type ObjectSchema } from './composites-bridge.js';
+import { type OptionalSchema } from './types.js';
+export declare const SPACING_SCALE: readonly ['none', 'xs', 'sm', 'md', 'lg', 'xl', '2xl'];
+export declare const BLOCK_WIDTHS: readonly ['narrow', 'normal', 'wide', 'full'];
+export declare const BLOCK_ALIGNMENTS: readonly ['start', 'center', 'end'];
+export declare const CONTAINER_WIDTHS: readonly ['narrow', 'normal', 'wide', 'full'];
+export declare const VIEWPORTS: readonly ['mobile', 'tablet', 'desktop'];
+/**
+ * The corner radii a theme has to define (SPEC.md §62).
+ *
+ * No control of §61 names one yet, so this scale exists here rather than in
+ * `@assemora/theme` for the reason the others do: the scale a theme defines and the
+ * scale a block would one day choose from must be one list, or they drift the moment
+ * somebody adds a control. `none` and `full` are the two ends that carry meaning on
+ * their own — a square corner and a pill — and three steps between them are enough
+ * for a token system that is not a CSS editor.
+ */
+export declare const RADIUS_SCALE: readonly ['none', 'sm', 'md', 'lg', 'full'];
+export type SpacingScale = (typeof SPACING_SCALE)[number];
+export type RadiusScale = (typeof RADIUS_SCALE)[number];
+export type BlockWidth = (typeof BLOCK_WIDTHS)[number];
+export type BlockAlignment = (typeof BLOCK_ALIGNMENTS)[number];
+export type ContainerWidth = (typeof CONTAINER_WIDTHS)[number];
+export type Viewport = (typeof VIEWPORTS)[number];
+export type BlockDesign = {
+    readonly spacingTop?: SpacingScale;
+    readonly spacingBottom?: SpacingScale;
+    readonly width?: BlockWidth;
+    readonly align?: BlockAlignment;
+    /** A theme colour token, by name. Never a colour (SPEC.md §62). */
+    readonly background?: string;
+    /** A media id, for a background image. */
+    readonly backgroundImage?: string;
+    readonly container?: ContainerWidth;
+    /** Where this block is *not* drawn. Responsive visibility (SPEC.md §61). */
+    readonly hiddenOn?: readonly Viewport[];
+};
+declare const designShape: {
+    spacingTop: OptionalSchema<"2xl" | "lg" | "md" | "none" | "sm" | "xl" | "xs">;
+    spacingBottom: OptionalSchema<"2xl" | "lg" | "md" | "none" | "sm" | "xl" | "xs">;
+    width: OptionalSchema<"full" | "narrow" | "normal" | "wide">;
+    align: OptionalSchema<"center" | "end" | "start">;
+    background: OptionalSchema<string>;
+    backgroundImage: OptionalSchema<string>;
+    container: OptionalSchema<"full" | "narrow" | "normal" | "wide">;
+    hiddenOn: OptionalSchema<("desktop" | "mobile" | "tablet")[]>;
+};
+/** The parser behind {@link BlockDesign}. `*.test-d.ts` proves the two agree. */
+export declare const blockDesign: () => ObjectSchema<typeof designShape>;
+declare const patchShape: {
+    spacingTop: OptionalSchema<"2xl" | "lg" | "md" | "none" | "sm" | "xl" | "xs" | null>;
+    spacingBottom: OptionalSchema<"2xl" | "lg" | "md" | "none" | "sm" | "xl" | "xs" | null>;
+    width: OptionalSchema<"full" | "narrow" | "normal" | "wide" | null>;
+    align: OptionalSchema<"center" | "end" | "start" | null>;
+    background: OptionalSchema<string | null>;
+    backgroundImage: OptionalSchema<string | null>;
+    container: OptionalSchema<"full" | "narrow" | "normal" | "wide" | null>;
+    hiddenOn: OptionalSchema<("desktop" | "mobile" | "tablet")[] | null>;
+};
+/**
+ * What `blocks.design` accepts: the controls that changed, and nothing else.
+ *
+ * Every key is optional, and every one of them accepts `null` — see {@link clearable}.
+ */
+export type BlockDesignPatch = {
+    readonly [K in keyof BlockDesign]?: BlockDesign[K] | null;
+};
+export declare const blockDesignPatch: () => ObjectSchema<typeof patchShape>;
+/** Nothing set. What a block that has never been touched by the controls carries. */
+export declare const isPlainDesign: (design: BlockDesign | undefined) => boolean;
+/** True when this block should not be drawn on that viewport (SPEC.md §61). */
+export declare const hiddenOnViewport: (design: BlockDesign | undefined, viewport: Viewport) => boolean;
+export {};
+//# sourceMappingURL=design.d.ts.map

package/dist/design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../src/design.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAiB,KAAK,YAAY,EAAkB,MAAM,wBAAwB,CAAA;AACzF,OAAO,EAAE,KAAK,cAAc,EAAqC,MAAM,YAAY,CAAA;AAEnF,eAAO,MAAM,aAAa,YAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAU,CAAA;AACnF,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAU,CAAA;AACzE,eAAO,MAAM,gBAAgB,YAAI,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA;AACnE,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAU,CAAA;AAC7E,eAAO,MAAM,SAAS,YAAI,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAEjE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,YAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAU,CAAA;AAEvE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAA;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAA;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CACxC,CAAA;AAQD,QAAA,MAAM,WAAW;IACf,UAAU;IACV,aAAa;IACb,KAAK;IACL,KAAK;IACL,UAAU;IACV,eAAe;IACf,SAAS;IACT,QAAQ;CACT,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,WAAW,QAAO,YAAY,CAAC,OAAO,WAAW,CAAwB,CAAA;AAqBtF,QAAA,MAAM,UAAU;IACd,UAAU;IACV,aAAa;IACb,KAAK;IACL,KAAK;IACL,UAAU;IACV,eAAe;IACf,SAAS;IACT,QAAQ;CACT,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;CAC1D,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAO,YAAY,CAAC,OAAO,UAAU,CAAuB,CAAA;AAEzF,qFAAqF;AACrF,eAAO,MAAM,aAAa,WAAY,WAAW,GAAG,SAAS,KAAG,OACqB,CAAA;AAErF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,WAAY,WAAW,GAAG,SAAS,YAAY,QAAQ,KAAG,OACxC,CAAA"}

package/dist/design.js

@@ -0,0 +1,86 @@
+/**
+ * Universal design controls (SPEC.md §61).
+ *
+ * Every block gets the same seven settings — spacing, width, alignment, background,
+ * visibility, responsive visibility and container width — and gets them without its
+ * author declaring anything. What a block does with its *own* fields stays the block
+ * author's business (SPEC.md §61: "Visual specifics stay in developer-defined
+ * blocks").
+ *
+ * Every value is a token, never CSS. That is the point: a person picks `lg`, an agent
+ * writes `lg`, and what `lg` means is decided once by the theme (SPEC.md §62). Nothing
+ * here can express a colour, a pixel or a rule, so nothing here can be used to smuggle
+ * a stylesheet into a page.
+ *
+ * The settings live beside `props` on the node rather than inside it, because `props`
+ * belongs to the block's own schema and a framework key in there would collide with a
+ * field somebody declared.
+ */
+import { array, enumOf, object, string } from './composites-bridge.js';
+import { ok } from './types.js';
+export const SPACING_SCALE = ['none', 'xs', 'sm', 'md', 'lg', 'xl', '2xl'];
+export const BLOCK_WIDTHS = ['narrow', 'normal', 'wide', 'full'];
+export const BLOCK_ALIGNMENTS = ['start', 'center', 'end'];
+export const CONTAINER_WIDTHS = ['narrow', 'normal', 'wide', 'full'];
+export const VIEWPORTS = ['mobile', 'tablet', 'desktop'];
+/**
+ * The corner radii a theme has to define (SPEC.md §62).
+ *
+ * No control of §61 names one yet, so this scale exists here rather than in
+ * `@assemora/theme` for the reason the others do: the scale a theme defines and the
+ * scale a block would one day choose from must be one list, or they drift the moment
+ * somebody adds a control. `none` and `full` are the two ends that carry meaning on
+ * their own — a square corner and a pill — and three steps between them are enough
+ * for a token system that is not a CSS editor.
+ */
+export const RADIUS_SCALE = ['none', 'sm', 'md', 'lg', 'full'];
+/**
+ * A background token names a theme entry, so it is spelled like one: letters, digits
+ * and dashes. `#ff0000` and `red; position: fixed` are both refused.
+ */
+const TOKEN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const designShape = {
+    spacingTop: enumOf(...SPACING_SCALE).optional(),
+    spacingBottom: enumOf(...SPACING_SCALE).optional(),
+    width: enumOf(...BLOCK_WIDTHS).optional(),
+    align: enumOf(...BLOCK_ALIGNMENTS).optional(),
+    background: string().pattern(TOKEN, 'Expected a theme token').optional(),
+    backgroundImage: string().optional(),
+    container: enumOf(...CONTAINER_WIDTHS).optional(),
+    hiddenOn: array(enumOf(...VIEWPORTS)).optional(),
+};
+/** The parser behind {@link BlockDesign}. `*.test-d.ts` proves the two agree. */
+export const blockDesign = () => object(designShape);
+/**
+ * A control may be absent, or explicitly `null`.
+ *
+ * They are different answers: absent means "leave this control alone", and `null`
+ * means "clear it and let the theme decide again". A properties panel needs both, and
+ * only one of them can be expressed by omission.
+ */
+const clearable = (inner) => ({
+    kind: inner.kind,
+    isOptional: true,
+    isNullable: true,
+    description: inner.description,
+    parse: (value) => value === undefined || value === null
+        ? ok(value)
+        : inner.parse(value),
+    toJsonSchema: () => ({ ...inner.toJsonSchema(), nullable: true }),
+});
+const patchShape = {
+    spacingTop: clearable(enumOf(...SPACING_SCALE)),
+    spacingBottom: clearable(enumOf(...SPACING_SCALE)),
+    width: clearable(enumOf(...BLOCK_WIDTHS)),
+    align: clearable(enumOf(...BLOCK_ALIGNMENTS)),
+    background: clearable(string().pattern(TOKEN, 'Expected a theme token')),
+    backgroundImage: clearable(string()),
+    container: clearable(enumOf(...CONTAINER_WIDTHS)),
+    hiddenOn: clearable(array(enumOf(...VIEWPORTS))),
+};
+export const blockDesignPatch = () => object(patchShape);
+/** Nothing set. What a block that has never been touched by the controls carries. */
+export const isPlainDesign = (design) => design === undefined || Object.values(design).every((value) => value === undefined);
+/** True when this block should not be drawn on that viewport (SPEC.md §61). */
+export const hiddenOnViewport = (design, viewport) => design?.hiddenOn?.includes(viewport) ?? false;
+//# sourceMappingURL=design.js.map

package/dist/design.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@assemora/schema` — the primitives every other layer is built on.
+ *
+ * A declaration made here is simultaneously a runtime parser, a compile-time type
+ * and a JSON description, so validation, the database, Studio, OpenAPI, the SDK and
+ * MCP all read one source (SPEC.md §3.4, §42).
+ *
+ * This package has no dependencies, external ones included, and never will —
+ * `pnpm boundaries` enforces that.
+ */
+export { type BlockNode, type BlockTree, blockIds, blockTree, type ChangedBlock, diffTrees, emptyTree, findBlock, type TreeChange, walkBlocks, } from './blocks.js';
+export { type ArraySchema, array, type ObjectSchema, object, } from './composites.js';
+export { BLOCK_ALIGNMENTS, BLOCK_WIDTHS, type BlockAlignment, type BlockDesign, type BlockDesignPatch, type BlockWidth, blockDesign, blockDesignPatch, CONTAINER_WIDTHS, type ContainerWidth, hiddenOnViewport, isPlainDesign, RADIUS_SCALE, type RadiusScale, SPACING_SCALE, type SpacingScale, VIEWPORTS, type Viewport, } from './design.js';
+export { changedFields, diff, type Patch } from './patch.js';
+export { type BigIntSchema, type BinarySchema, type BooleanSchema, bigint, binary, boolean, type EnumSchema, email, enumOf, integer, type JsonValueSchema, json, type NumberSchema, nullable, number, optional, type StringSchema, string, type TimestampSchema, timestamp, type UnknownSchema, unknown, uuid, } from './primitives.js';
+export { fail, failWith, type Infer, type InferShape, type Issue, type JsonSchema, nest, type OptionalSchema, ok, type ParseResult, type Schema, type SchemaKind, type Shape, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,QAAQ,EACR,SAAS,EACT,KAAK,YAAY,EACjB,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,UAAU,EACf,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,EACL,KAAK,YAAY,EACjB,MAAM,GACP,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,cAAc,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,YAAY,EACjB,SAAS,EACT,KAAK,QAAQ,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,MAAM,EACN,MAAM,EACN,OAAO,EACP,KAAK,UAAU,EACf,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,eAAe,EACpB,IAAI,EACJ,KAAK,YAAY,EACjB,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,KAAK,YAAY,EACjB,MAAM,EACN,KAAK,eAAe,EACpB,SAAS,EACT,KAAK,aAAa,EAClB,OAAO,EACP,IAAI,GACL,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,UAAU,EACf,IAAI,EACJ,KAAK,cAAc,EACnB,EAAE,EACF,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,KAAK,GACX,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@assemora/schema` — the primitives every other layer is built on.
+ *
+ * A declaration made here is simultaneously a runtime parser, a compile-time type
+ * and a JSON description, so validation, the database, Studio, OpenAPI, the SDK and
+ * MCP all read one source (SPEC.md §3.4, §42).
+ *
+ * This package has no dependencies, external ones included, and never will —
+ * `pnpm boundaries` enforces that.
+ */
+export { blockIds, blockTree, diffTrees, emptyTree, findBlock, walkBlocks, } from './blocks.js';
+export { array, object, } from './composites.js';
+export { BLOCK_ALIGNMENTS, BLOCK_WIDTHS, blockDesign, blockDesignPatch, CONTAINER_WIDTHS, hiddenOnViewport, isPlainDesign, RADIUS_SCALE, SPACING_SCALE, VIEWPORTS, } from './design.js';
+export { changedFields, diff } from './patch.js';
+export { bigint, binary, boolean, email, enumOf, integer, json, nullable, number, optional, string, timestamp, unknown, uuid, } from './primitives.js';
+export { fail, failWith, nest, ok, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,QAAQ,EACR,SAAS,EAET,SAAS,EACT,SAAS,EACT,SAAS,EAET,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAEL,KAAK,EAEL,MAAM,GACP,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,gBAAgB,EAChB,YAAY,EAKZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAEhB,gBAAgB,EAChB,aAAa,EACb,YAAY,EAEZ,aAAa,EAEb,SAAS,GAEV,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAC5D,OAAO,EAIL,MAAM,EACN,MAAM,EACN,OAAO,EAEP,KAAK,EACL,MAAM,EACN,OAAO,EAEP,IAAI,EAEJ,QAAQ,EACR,MAAM,EACN,QAAQ,EAER,MAAM,EAEN,SAAS,EAET,OAAO,EACP,IAAI,GACL,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,IAAI,EACJ,QAAQ,EAKR,IAAI,EAEJ,EAAE,GAKH,MAAM,YAAY,CAAA"}

package/dist/patch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What changed between two states (SPEC.md §64, §65, §75).
+ *
+ * Studio shows this, not the whole document: "spacing: xl → md" is what a person can
+ * act on. It lives here because three layers need it and none of them may depend on
+ * the others — a revision records one, a dry run builds one, and a change set stores
+ * one. Two implementations over the same two snapshots would eventually disagree on
+ * a screen that shows both (ADR-0019).
+ */
+/** A field-level diff of two snapshots. */
+export type Patch = Readonly<Record<string, {
+    readonly from: unknown;
+    readonly to: unknown;
+}>>;
+/** A field-level diff of two snapshots. Keys present in either side are considered. */
+export declare const diff: (before: unknown, after: unknown) => Patch;
+export declare const changedFields: (patch: Patch) => readonly string[];
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAAA;AAsB9F,uFAAuF;AACvF,eAAO,MAAM,IAAI,WAAY,OAAO,SAAS,OAAO,KAAG,KAgBtD,CAAA;AAED,eAAO,MAAM,aAAa,UAAW,KAAK,KAAG,SAAS,MAAM,EAAwB,CAAA"}

package/dist/patch.js

@@ -0,0 +1,43 @@
+/**
+ * What changed between two states (SPEC.md §64, §65, §75).
+ *
+ * Studio shows this, not the whole document: "spacing: xl → md" is what a person can
+ * act on. It lives here because three layers need it and none of them may depend on
+ * the others — a revision records one, a dry run builds one, and a change set stores
+ * one. Two implementations over the same two snapshots would eventually disagree on
+ * a screen that shows both (ADR-0019).
+ */
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * One value out of a snapshot, read only where the snapshot has it.
+ *
+ * A snapshot is keyed by field names somebody chose (SPEC.md §37, §86), and
+ * `constructor`, `toString`, `valueOf` and `hasOwnProperty` are all legal ones —
+ * answered by `Object.prototype` on any plain object that was never given the key.
+ */
+const own = (record, key) => Object.hasOwn(record, key) ? record[key] : undefined;
+const same = (left, right) => {
+    if (left === right)
+        return true;
+    if (left instanceof Date && right instanceof Date)
+        return left.getTime() === right.getTime();
+    return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);
+};
+/** A field-level diff of two snapshots. Keys present in either side are considered. */
+export const diff = (before, after) => {
+    const from = isRecord(before) ? before : {};
+    const to = isRecord(after) ? after : {};
+    const patch = {};
+    for (const key of new Set([...Object.keys(from), ...Object.keys(to)])) {
+        // Own keys only. A key is an own key of *one* side here, not of both, so the other
+        // side answers it from `Object.prototype` — a field called `constructor` that was
+        // cleared read as having changed to a function.
+        const was = own(from, key);
+        const is = own(to, key);
+        if (!same(was, is))
+            patch[key] = { from: was, to: is };
+    }
+    return patch;
+};
+export const changedFields = (patch) => Object.keys(patch);
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE;;;;;;GAMG;AACH,MAAM,GAAG,GAAG,CAAC,MAAyC,EAAE,GAAW,EAAW,EAAE,CAC9E,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAEtD,MAAM,IAAI,GAAG,CAAC,IAAa,EAAE,KAAc,EAAW,EAAE;IACtD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAA;IAC/B,IAAI,IAAI,YAAY,IAAI,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CAAA;IAE5F,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAA;AACvE,CAAC,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAe,EAAE,KAAc,EAAS,EAAE;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACvC,MAAM,KAAK,GAAmD,EAAE,CAAA;IAEhE,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,mFAAmF;QACnF,kFAAkF;QAClF,gDAAgD;QAChD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC1B,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;QAEvB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;IACxD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAY,EAAqB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA"}

package/dist/primitives.d.ts

@@ -0,0 +1,85 @@
+import { type Infer, type OptionalSchema, type Schema } from './types.js';
+/**
+ * The two modifiers, as combinators, for a schema whose builder is out of reach.
+ *
+ * `string().optional()` is how a *declaration* says it. These are how a caller holding
+ * a `Schema<T>` says the same thing — and by the time a schema crosses a package
+ * boundary that is all it is: `@assemora/resources` builds a group's shape out of the
+ * schemas its fields carry, and those arrive already erased to the interface. Without
+ * these the only way to make one of them absent-able is to rebuild the wrapper object
+ * by hand in every package that needs one, which is how the meaning of "optional"
+ * comes to differ between two of them.
+ */
+export declare const optional: <T>(inner: Schema<T>) => OptionalSchema<T>;
+export declare const nullable: <T>(inner: Schema<T>) => Schema<T | null>;
+export type StringSchema = Schema<string> & {
+    min(length: number): StringSchema;
+    max(length: number): StringSchema;
+    pattern(expression: RegExp, message?: string): StringSchema;
+    email(): StringSchema;
+    uuid(): StringSchema;
+    describe(text: string): StringSchema;
+    optional(): OptionalSchema<string>;
+    nullable(): Schema<string | null>;
+};
+export declare const string: () => StringSchema;
+/** A UUID string. Shorthand for `string().uuid()`, which reads better in a model. */
+export declare const uuid: () => StringSchema;
+/** An email address. Shorthand for `string().email()`. */
+export declare const email: () => StringSchema;
+export type NumberSchema = Schema<number> & {
+    min(value: number): NumberSchema;
+    max(value: number): NumberSchema;
+    integer(): NumberSchema;
+    describe(text: string): NumberSchema;
+    optional(): OptionalSchema<number>;
+    nullable(): Schema<number | null>;
+};
+export declare const number: () => NumberSchema;
+export declare const integer: () => NumberSchema;
+export type BooleanSchema = Schema<boolean> & {
+    describe(text: string): BooleanSchema;
+    optional(): OptionalSchema<boolean>;
+    nullable(): Schema<boolean | null>;
+};
+export declare const boolean: () => BooleanSchema;
+export type EnumSchema<T extends string> = Schema<T> & {
+    readonly values: readonly T[];
+    describe(text: string): EnumSchema<T>;
+    optional(): OptionalSchema<T>;
+    nullable(): Schema<T | null>;
+};
+/** `enumOf('draft', 'published')` infers the literal union, not `string`. */
+export declare const enumOf: <const V extends readonly [string, ...string[]]>(...values: V) => EnumSchema<V[number]>;
+export type TimestampSchema = Schema<Date> & {
+    describe(text: string): TimestampSchema;
+    optional(): OptionalSchema<Date>;
+    nullable(): Schema<Date | null>;
+};
+export declare const timestamp: () => TimestampSchema;
+export type JsonValueSchema<T> = Schema<T> & {
+    describe(text: string): JsonValueSchema<T>;
+    optional(): OptionalSchema<T>;
+    nullable(): Schema<T | null>;
+};
+/** An opaque JSON payload whose shape the caller declares: `json<UserSettings>()`. */
+export declare const json: <T = unknown>() => JsonValueSchema<T>;
+export type UnknownSchema = Schema<unknown> & {
+    describe(text: string): UnknownSchema;
+    optional(): OptionalSchema<unknown>;
+};
+export declare const unknown: () => UnknownSchema;
+export type BigIntSchema = Schema<bigint> & {
+    describe(text: string): BigIntSchema;
+    optional(): OptionalSchema<bigint>;
+    nullable(): Schema<bigint | null>;
+};
+export declare const bigint: () => BigIntSchema;
+export type BinarySchema = Schema<Uint8Array> & {
+    describe(text: string): BinarySchema;
+    optional(): OptionalSchema<Uint8Array>;
+    nullable(): Schema<Uint8Array | null>;
+};
+export declare const binary: () => BinarySchema;
+export type { Infer };
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

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