@elaraai/e3-ui 1.0.85 → 1.0.87

package/dist/src/sheet/sub-rows.js

@@ -0,0 +1,272 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Sheet.subRows` and `Sheet.subRow` — sub rows (#844,
+ * `libs/east-ui/docs/proposals/Sheet Sub Rows - DX Proposal.md`): read-only
+ * rows under a line (or a flat row) that share none of the sheet's columns.
+ *
+ * `Sheet.subRows(R, { field: (item, row) => Sheet.subRow({ … }) })` is keyed
+ * like `columns`: each key names an `Array<T>` field of the type the columns
+ * are built over, and its mapper turns one element into a sub row. Key order
+ * is display order. The builder only CAPTURES; the root compiles each mapper
+ * once and the bridge calls it inside the row projection (`bridge.ts`).
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, ArrayType, OptionType, StringType, some, none, } from "@elaraai/east";
+import { SheetFacetType, SheetSubRowType } from "./types.js";
+/**
+ * Declares where a sheet's sub rows come from — `Sheet.subRows(R, { … })`.
+ *
+ * @typeParam R - The type the columns are built over (a grouped sheet: the line type)
+ * @param rowType - The row type value
+ * @param sources - Array field → mapper to a sub row, in display order
+ * @returns The declaration the `subRows` prop takes
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { ArrayType, DictType, East, FloatType, IntegerType, OptionType, StringType, StructType, VariantType, none, some, variant } from "@elaraai/east";
+ * import { Box, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Record, Sheet } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * export const BatchPart = StructType({ id: StringType, code: StringType, name: StringType, materials: ArrayType(StringType), station: OptionType(StringType) });
+ * export const BatchBooking = VariantType({
+ *     labour:    StructType({ team: StringType, people: IntegerType, hours: FloatType }),
+ *     equipment: StructType({ resource: StringType }),
+ * });
+ * export const BatchStep = StructType({ task: StringType, qty: OptionType(FloatType), parts: ArrayType(BatchPart), bookings: ArrayType(BatchBooking) });
+ * export const Batch = StructType({ id: StringType, name: StringType, steps: ArrayType(BatchStep) });
+ * export const BatchDay = StructType({ batches: ArrayType(Batch) });
+ * export const sheetBatchDays = e3.record("sheet_batch_days", DictType(StringType, BatchDay), new Map([
+ *     ["2026-10-12", { batches: [
+ *         { id: "B-101", name: "Doors, oak", steps: [
+ *             { task: "Cut doors", qty: some(12.0), parts: [
+ *                 { id: "B-101-1", code: "CUT", name: "Cut the door blanks", materials: ["Oak veneered board × 6"], station: some("S101") },
+ *             ], bookings: [variant("labour", { team: "Cutting", people: 1n, hours: 3.0 })] },
+ *             { task: "Band doors", qty: some(48.0), parts: [], bookings: [variant("equipment", { resource: "Edge bander E201" })] },
+ *             { task: "Spray doors", qty: some(12.0), parts: [
+ *                 { id: "B-101-3", code: "SPR", name: "Seal and lacquer", materials: ["Sealer", "Matt lacquer"], station: none },
+ *             ], bookings: [] },
+ *         ] },
+ *         { id: "B-102", name: "Carcasses, birch", steps: [
+ *             { task: "Cut carcasses", qty: some(8.0), parts: [], bookings: [] },
+ *             { task: "Drill carcasses", qty: some(8.0), parts: [], bookings: [variant("labour", { team: "Machining", people: 2n, hours: 2.5 })] },
+ *         ] },
+ *         { id: "B-103", name: "Shelves, ash", steps: [
+ *             { task: "Cut shelves", qty: some(20.0), parts: [], bookings: [] },
+ *             { task: "Sand shelves", qty: some(20.0), parts: [], bookings: [] },
+ *         ] },
+ *     ] }],
+ * ]));
+ * export const sheetBatchDaysPatch = e3.mutation.patch(sheetBatchDays);
+ *
+ * const sheet = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const days = $.let(Record.bind(sheetBatchDays, [sheetBatchDaysPatch]));
+ *         // The steps a finishing batch starts with: the batch template's lines.
+ *         const finishing = $.let([
+ *             { task: "Sand", qty: none, parts: [], bookings: [] },
+ *             { task: "Seal", qty: none, parts: [], bookings: [] },
+ *             { task: "Spray", qty: none, parts: [], bookings: [] },
+ *         ], ArrayType(BatchStep));
+ *         // A batch needs a name before Save.
+ *         const readyBatch = $.const(East.function([Sheet.Types.DraftGroup(Batch, "steps")], Sheet.Types.Readiness, ($, batch) => {
+ *             $.if(batch.name.hasTag("value").and(() => batch.name.unwrap("value").length().equal(0n)), $ => {
+ *                 $.return(East.value(variant("incomplete", [{ field: "name", message: "Name the batch" }]), Sheet.Types.Readiness));
+ *             });
+ *             return East.value(variant("ready", null), Sheet.Types.Readiness);
+ *         }));
+ *         const newStep = $.const(East.function([Sheet.Types.NewRow], Sheet.Types.Patch(BatchStep), () => Sheet.patch(BatchStep, { qty: none, parts: [], bookings: [] })));
+ *         const newBatch = $.const(East.function([Sheet.Types.NewGroup], Sheet.Types.Patch(Batch), () => Sheet.patch(Batch, { steps: [] })));
+ *         return (
+ *             <Box height="560px">
+ *                 <Sheet
+ *                     record={days}
+ *                     entry={{ key: "2026-10-12", rows: "batches", id: "id" }}
+ *                     group={Sheet.group(Batch, "steps", { title: "name", noun: { singular: "batch", plural: "batches" } })}
+ *                     name="batches"
+ *                     columns={{
+ *                         task: Sheet.column.text(BatchStep, { header: "Step", width: "240px" }),
+ *                         qty:  Sheet.column.quantity(BatchStep, { header: "Qty", width: "96px" }),
+ *                     }}
+ *                     subRows={Sheet.subRows(BatchStep, {
+ *                         parts: (p) => Sheet.subRow({
+ *                             code:   p.code,
+ *                             name:   p.name,
+ *                             chips:  p.materials,
+ *                             facets: { station: p.station },   // a none drops out
+ *                             id:     p.id,
+ *                         }),
+ *                         bookings: (b) => b.match({
+ *                             labour:    (_$2, l) => Sheet.subRow({ code: "LABOUR", name: East.str`${l.team} · ${l.people} people · ${l.hours} hours` }),
+ *                             equipment: (_$2, e) => Sheet.subRow({ code: "EQUIPMENT", name: e.resource }),
+ *                         }),
+ *                     })}
+ *                     // The sub rows show a step's parts and bookings; the inspector's form leaves them out.
+ *                     inspector
+ *                     fields={{ parts: Sheet.field.hidden(), bookings: Sheet.field.hidden() }}
+ *                     templates={{
+ *                         groups: [{ key: "finishing", name: "Finishing batch", group: "Batches",
+ *                                    values: Sheet.patch(Batch, { name: "Finishing", steps: finishing }) }],
+ *                         rows:   [{ key: "sand", name: "Sand", group: "Steps", values: Sheet.patch(BatchStep, { task: "Sand", qty: none }) },
+ *                                  { key: "seal", name: "Seal", group: "Steps", values: Sheet.patch(BatchStep, { task: "Seal", qty: none }) }],
+ *                     }}
+ *                     library={[Sheet.library.rows(), Sheet.library.columns()]}
+ *                     ready={{ group: readyBatch }}
+ *                     newRow={newStep}
+ *                     newGroup={newBatch}
+ *                 />
+ *             </Box>
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export function createSubRows(rowType, sources) {
+    return { rowType, sources };
+}
+/** A `String` or `Option<String>` input as an `Option<String>` expression, its shape read once at build time. */
+function optionalText(v) {
+    if (typeof v === "string")
+        return East.value(some(v), OptionType(StringType));
+    if (v instanceof Expr) {
+        if (Expr.type(v) === StringType) {
+            return East.value(some(v), OptionType(StringType));
+        }
+        return v;
+    }
+    return East.value(v, OptionType(StringType));
+}
+/** A `String` or `Option<String>` input as display text, `""` for none. */
+function textOrBlank(v) {
+    if (v === undefined)
+        return East.value("", StringType);
+    return optionalText(v).match({ some: (_$, s) => s, none: (_$) => "" });
+}
+/**
+ * Builds one sub row — `Sheet.subRow({ code?, name, chips?, facets?, id? })`.
+ * What is left out is filled in: `code` and `id` become `""`, `chips` and
+ * `facets` `[]`; a facet whose value is `none` drops out.
+ *
+ * @param input - The sub row's fields ({@link SheetSubRowInput})
+ * @returns An expression of `Sheet.Types.SubRow`
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { ArrayType, DictType, East, FloatType, IntegerType, OptionType, StringType, StructType, VariantType, none, some, variant } from "@elaraai/east";
+ * import { Box, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Record, Sheet } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * export const BatchPart = StructType({ id: StringType, code: StringType, name: StringType, materials: ArrayType(StringType), station: OptionType(StringType) });
+ * export const BatchBooking = VariantType({
+ *     labour:    StructType({ team: StringType, people: IntegerType, hours: FloatType }),
+ *     equipment: StructType({ resource: StringType }),
+ * });
+ * export const BatchStep = StructType({ task: StringType, qty: OptionType(FloatType), parts: ArrayType(BatchPart), bookings: ArrayType(BatchBooking) });
+ * export const Batch = StructType({ id: StringType, name: StringType, steps: ArrayType(BatchStep) });
+ * export const BatchDay = StructType({ batches: ArrayType(Batch) });
+ * export const sheetBatchDays = e3.record("sheet_batch_days", DictType(StringType, BatchDay), new Map([
+ *     ["2026-10-12", { batches: [
+ *         { id: "B-101", name: "Doors, oak", steps: [
+ *             { task: "Cut doors", qty: some(12.0), parts: [
+ *                 { id: "B-101-1", code: "CUT", name: "Cut the door blanks", materials: ["Oak veneered board × 6"], station: some("S101") },
+ *             ], bookings: [variant("labour", { team: "Cutting", people: 1n, hours: 3.0 })] },
+ *             { task: "Band doors", qty: some(48.0), parts: [], bookings: [variant("equipment", { resource: "Edge bander E201" })] },
+ *             { task: "Spray doors", qty: some(12.0), parts: [
+ *                 { id: "B-101-3", code: "SPR", name: "Seal and lacquer", materials: ["Sealer", "Matt lacquer"], station: none },
+ *             ], bookings: [] },
+ *         ] },
+ *         { id: "B-102", name: "Carcasses, birch", steps: [
+ *             { task: "Cut carcasses", qty: some(8.0), parts: [], bookings: [] },
+ *             { task: "Drill carcasses", qty: some(8.0), parts: [], bookings: [variant("labour", { team: "Machining", people: 2n, hours: 2.5 })] },
+ *         ] },
+ *         { id: "B-103", name: "Shelves, ash", steps: [
+ *             { task: "Cut shelves", qty: some(20.0), parts: [], bookings: [] },
+ *             { task: "Sand shelves", qty: some(20.0), parts: [], bookings: [] },
+ *         ] },
+ *     ] }],
+ * ]));
+ * export const sheetBatchDaysPatch = e3.mutation.patch(sheetBatchDays);
+ *
+ * const sheet = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const days = $.let(Record.bind(sheetBatchDays, [sheetBatchDaysPatch]));
+ *         // The steps a finishing batch starts with: the batch template's lines.
+ *         const finishing = $.let([
+ *             { task: "Sand", qty: none, parts: [], bookings: [] },
+ *             { task: "Seal", qty: none, parts: [], bookings: [] },
+ *             { task: "Spray", qty: none, parts: [], bookings: [] },
+ *         ], ArrayType(BatchStep));
+ *         // A batch needs a name before Save.
+ *         const readyBatch = $.const(East.function([Sheet.Types.DraftGroup(Batch, "steps")], Sheet.Types.Readiness, ($, batch) => {
+ *             $.if(batch.name.hasTag("value").and(() => batch.name.unwrap("value").length().equal(0n)), $ => {
+ *                 $.return(East.value(variant("incomplete", [{ field: "name", message: "Name the batch" }]), Sheet.Types.Readiness));
+ *             });
+ *             return East.value(variant("ready", null), Sheet.Types.Readiness);
+ *         }));
+ *         const newStep = $.const(East.function([Sheet.Types.NewRow], Sheet.Types.Patch(BatchStep), () => Sheet.patch(BatchStep, { qty: none, parts: [], bookings: [] })));
+ *         const newBatch = $.const(East.function([Sheet.Types.NewGroup], Sheet.Types.Patch(Batch), () => Sheet.patch(Batch, { steps: [] })));
+ *         return (
+ *             <Box height="560px">
+ *                 <Sheet
+ *                     record={days}
+ *                     entry={{ key: "2026-10-12", rows: "batches", id: "id" }}
+ *                     group={Sheet.group(Batch, "steps", { title: "name", noun: { singular: "batch", plural: "batches" } })}
+ *                     name="batches"
+ *                     columns={{
+ *                         task: Sheet.column.text(BatchStep, { header: "Step", width: "240px" }),
+ *                         qty:  Sheet.column.quantity(BatchStep, { header: "Qty", width: "96px" }),
+ *                     }}
+ *                     subRows={Sheet.subRows(BatchStep, {
+ *                         parts: (p) => Sheet.subRow({
+ *                             code:   p.code,
+ *                             name:   p.name,
+ *                             chips:  p.materials,
+ *                             facets: { station: p.station },   // a none drops out
+ *                             id:     p.id,
+ *                         }),
+ *                         bookings: (b) => b.match({
+ *                             labour:    (_$2, l) => Sheet.subRow({ code: "LABOUR", name: East.str`${l.team} · ${l.people} people · ${l.hours} hours` }),
+ *                             equipment: (_$2, e) => Sheet.subRow({ code: "EQUIPMENT", name: e.resource }),
+ *                         }),
+ *                     })}
+ *                     // The sub rows show a step's parts and bookings; the inspector's form leaves them out.
+ *                     inspector
+ *                     fields={{ parts: Sheet.field.hidden(), bookings: Sheet.field.hidden() }}
+ *                     templates={{
+ *                         groups: [{ key: "finishing", name: "Finishing batch", group: "Batches",
+ *                                    values: Sheet.patch(Batch, { name: "Finishing", steps: finishing }) }],
+ *                         rows:   [{ key: "sand", name: "Sand", group: "Steps", values: Sheet.patch(BatchStep, { task: "Sand", qty: none }) },
+ *                                  { key: "seal", name: "Seal", group: "Steps", values: Sheet.patch(BatchStep, { task: "Seal", qty: none }) }],
+ *                     }}
+ *                     library={[Sheet.library.rows(), Sheet.library.columns()]}
+ *                     ready={{ group: readyBatch }}
+ *                     newRow={newStep}
+ *                     newGroup={newBatch}
+ *                 />
+ *             </Box>
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export function createSubRow(input) {
+    const facets = Object.entries(input.facets ?? {}).map(([label, value]) => optionalText(value).match({
+        some: (_$, v) => East.value(some({ label, value: v }), OptionType(SheetFacetType)),
+        none: (_$) => East.value(none, OptionType(SheetFacetType)),
+    }));
+    return East.value({
+        code: textOrBlank(input.code),
+        name: input.name,
+        chips: input.chips ?? East.value([], ArrayType(StringType)),
+        facets: East.value(facets, ArrayType(OptionType(SheetFacetType))).filterMap((_$, f) => f),
+        id: textOrBlank(input.id),
+    }, SheetSubRowType);
+}
+//# sourceMappingURL=sub-rows.js.map

package/dist/src/sheet/sub-rows.js.map

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

package/dist/src/sheet/templates.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Sheet>`'s templates (#1183, `Sheet Builder Spec.md` §4.2, SB9): the
+ * Rows tab's cards. A row template is over the row type (a grouped sheet's
+ * line type), a group template over the group type with its lines. Each is
+ * checked against its type, and each carries a seed built by the code that
+ * builds `newRow`'s and `newGroup`'s: the constructor's defaults first, the
+ * template's set fields over them. The cells its card shows are the
+ * template's own fields, through the columns' projection.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, DictType, FunctionType, OptionType, StringType, StructType, VariantType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import { type SheetPatchOf } from "./types.js";
+import { type SheetBridge } from "./bridge.js";
+/**
+ * One card of the library's Rows tab: a preset a planner drops into the sheet.
+ *
+ * @typeParam R - The type it sets: the row type (a grouped sheet's line type), or the group type
+ */
+export interface SheetTemplate<R extends StructType> {
+    /** Its key — unique among the sheet's templates, rows and groups alike. */
+    key: string;
+    /** The card's name. */
+    name: string;
+    /** The Rows tab's group the card sits under. */
+    group?: string;
+    /** The fields it sets — `Sheet.patch(R, { … })`. A field it leaves unset takes `newRow`'s (or `newGroup`'s) default, or starts missing. */
+    values: SubtypeExprOrValue<SheetPatchOf<R>>;
+}
+/**
+ * The sheet's templates.
+ *
+ * @typeParam L - The row type (a grouped sheet's line type)
+ * @typeParam G - The group type, on a grouped sheet
+ */
+export interface SheetTemplatesInput<L extends StructType, G extends StructType = never> {
+    /** Row templates — on a grouped sheet, lines dropped into a group. */
+    rows?: SheetTemplate<L>[];
+    /** Group templates, each with its lines — a grouped sheet's only. */
+    groups?: [G] extends [never] ? never : SheetTemplate<G>[];
+}
+/**
+ * One template on the wire: its card, and its seed — the draft and the row it
+ * drops, as `newRow`'s and `newGroup`'s constructors make them.
+ *
+ * @property key - The template's key
+ * @property name - The card's name
+ * @property group - The Rows tab's group the card sits under
+ * @property cells - What the card shows: the template's own fields, through the columns' projection
+ * @property seed - A row template's seed, over the new row's context; or a group template's, over the new group's
+ */
+export declare const SheetTemplateWireType: StructType<{
+    readonly key: StringType;
+    readonly name: StringType;
+    readonly group: OptionType<StringType>;
+    readonly cells: DictType<StringType, VariantType<{
+        readonly Invalid: StringType;
+        readonly Null: import("@elaraai/east").NullType;
+        readonly Boolean: import("@elaraai/east").BooleanType;
+        readonly Integer: import("@elaraai/east").IntegerType;
+        readonly Float: import("@elaraai/east").FloatType;
+        readonly String: StringType;
+        readonly DateTime: import("@elaraai/east").DateTimeType;
+        readonly Link: StructType<{
+            readonly from: ArrayType<VariantType<{
+                readonly identified: StructType<{
+                    readonly key: StringType;
+                }>;
+                readonly range: StructType<{
+                    readonly from: StringType;
+                    readonly to: StringType;
+                }>;
+                readonly counted: StructType<{
+                    readonly n: import("@elaraai/east").IntegerType;
+                    readonly key: StringType;
+                }>;
+                readonly placeholder: import("@elaraai/east").NullType;
+                readonly text: StringType;
+            }>>;
+            readonly to: ArrayType<VariantType<{
+                readonly identified: StructType<{
+                    readonly key: StringType;
+                }>;
+                readonly range: StructType<{
+                    readonly from: StringType;
+                    readonly to: StringType;
+                }>;
+                readonly counted: StructType<{
+                    readonly n: import("@elaraai/east").IntegerType;
+                    readonly key: StringType;
+                }>;
+                readonly placeholder: import("@elaraai/east").NullType;
+                readonly text: StringType;
+            }>>;
+        }>;
+    }>>;
+    readonly seed: VariantType<{
+        readonly row: FunctionType<[StructType<{
+            readonly destination: VariantType<{
+                readonly entry: VariantType<{
+                    readonly ordered: VariantType<{
+                        readonly start: import("@elaraai/east").NullType;
+                        readonly end: import("@elaraai/east").NullType;
+                        readonly before: StringType;
+                        readonly after: StringType;
+                    }>;
+                    readonly keyOrder: import("@elaraai/east").NullType;
+                }>;
+                readonly child: StructType<{
+                    readonly group: StringType;
+                    readonly index: import("@elaraai/east").IntegerType;
+                }>;
+            }>;
+        }>], StructType<{
+            readonly draft: import("@elaraai/east").BlobType;
+            readonly row: import("@elaraai/east").BlobType;
+        }>>;
+        readonly group: FunctionType<[StructType<{
+            readonly place: VariantType<{
+                readonly ordered: VariantType<{
+                    readonly start: import("@elaraai/east").NullType;
+                    readonly end: import("@elaraai/east").NullType;
+                    readonly before: StringType;
+                    readonly after: StringType;
+                }>;
+                readonly keyOrder: import("@elaraai/east").NullType;
+            }>;
+        }>], StructType<{
+            readonly draft: import("@elaraai/east").BlobType;
+            readonly row: import("@elaraai/east").BlobType;
+        }>>;
+    }>;
+}>;
+/** Type representing {@link SheetTemplateWireType}. */
+export type SheetTemplateWireType = typeof SheetTemplateWireType;
+/** The constructors a sheet declares, already checked by its root: `newRow` and `newGroup`. */
+export interface SheetConstructors {
+    /** `newRow`: the new row's context to its defaults. */
+    newRow?: unknown;
+    /** `newGroup`: the new group's context to its defaults. */
+    newGroup?: unknown;
+}
+/**
+ * Builds the sheet's templates on the wire (SB9).
+ *
+ * @param input - The templates, by kind
+ * @param bridge - The sheet's bridge, as its root compiled it
+ * @param constructors - The sheet's `newRow` and `newGroup`, as its root checked them
+ * @returns The templates on the wire, rows first, each in the order declared
+ * @throws Error naming the template: a template over another type, a key that repeats, or a group template on a flat sheet
+ * @internal
+ */
+export declare function buildTemplates(input: {
+    rows?: SheetTemplate<StructType>[];
+    groups?: SheetTemplate<StructType>[];
+} | undefined, bridge: SheetBridge, constructors: SheetConstructors): ExprType<ArrayType<SheetTemplateWireType>>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/sheet/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/sheet/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EACH,SAAS,EACT,QAAQ,EAGR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EAMX,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAIjF,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,UAAU;IAC/C,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2IAA2I;IAC3I,MAAM,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,UAAU,GAAG,KAAK;IACnF,sEAAsE;IACtE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAEH,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AAEjE,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAC9B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,CAAA;CAAE,GAAG,SAAS,EAC/F,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,iBAAiB,GAChC,QAAQ,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAqC5C"}

package/dist/src/sheet/templates.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Sheet>`'s templates (#1183, `Sheet Builder Spec.md` §4.2, SB9): the
+ * Rows tab's cards. A row template is over the row type (a grouped sheet's
+ * line type), a group template over the group type with its lines. Each is
+ * checked against its type, and each carries a seed built by the code that
+ * builds `newRow`'s and `newGroup`'s: the constructor's defaults first, the
+ * template's set fields over them. The cells its card shows are the
+ * template's own fields, through the columns' projection.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, DictType, East, Expr, FunctionType, OptionType, StringType, StructType, VariantType, isTypeEqual, none, some, variant, } from "@elaraai/east";
+import { SheetCellType, SheetPatchTypeFor } from "./types.js";
+import { SheetNewGroupType, SheetNewRowType } from "./transactions.js";
+import { SheetSeedType } from "./editing-types.js";
+import { buildSheetSeed } from "./seed-bridge.js";
+import { buildPatchCells } from "./bridge.js";
+/**
+ * One template on the wire: its card, and its seed — the draft and the row it
+ * drops, as `newRow`'s and `newGroup`'s constructors make them.
+ *
+ * @property key - The template's key
+ * @property name - The card's name
+ * @property group - The Rows tab's group the card sits under
+ * @property cells - What the card shows: the template's own fields, through the columns' projection
+ * @property seed - A row template's seed, over the new row's context; or a group template's, over the new group's
+ */
+export const SheetTemplateWireType = StructType({
+    key: StringType,
+    name: StringType,
+    group: OptionType(StringType),
+    cells: DictType(StringType, SheetCellType),
+    seed: VariantType({
+        row: FunctionType([SheetNewRowType], SheetSeedType),
+        group: FunctionType([SheetNewGroupType], SheetSeedType),
+    }),
+});
+/**
+ * A constructor whose defaults the template's set fields override: each field
+ * the template sets, else the constructor's default, else unset.
+ */
+function overDefaults(contextType, rowType, values, defaults) {
+    const patchType = SheetPatchTypeFor(rowType);
+    const fields = Object.keys(rowType.fields);
+    const unset = East.value(Object.fromEntries(fields.map((f) => [f, none])), patchType);
+    const construct = defaults === undefined ? undefined
+        : East.value(defaults);
+    return East.function([contextType], patchType, ($, context) => {
+        const set = $.const(values, patchType);
+        let base;
+        if (construct === undefined)
+            base = $.const(unset, patchType);
+        else {
+            const make = $.const(construct);
+            base = $.const(make(context), patchType);
+        }
+        return Object.fromEntries(fields.map((f) => [f, set[f].hasTag("some").ifElse(() => set[f], () => base[f])]));
+    });
+}
+/** A template's values, checked against the type it must set. */
+function valuesOf(template, rowType, what) {
+    const values = East.value(template.values);
+    if (!isTypeEqual(Expr.type(values), SheetPatchTypeFor(rowType))) {
+        throw new Error(what === "row"
+            ? `Sheet: row template "${template.key}" was built over another type — build its values with Sheet.patch(RowType, …) over the sheet's row type (a grouped sheet: its line type)`
+            : `Sheet: group template "${template.key}" was built over another type — build its values with Sheet.patch(GroupType, …) over the sheet's group type`);
+    }
+    return values;
+}
+/**
+ * Builds the sheet's templates on the wire (SB9).
+ *
+ * @param input - The templates, by kind
+ * @param bridge - The sheet's bridge, as its root compiled it
+ * @param constructors - The sheet's `newRow` and `newGroup`, as its root checked them
+ * @returns The templates on the wire, rows first, each in the order declared
+ * @throws Error naming the template: a template over another type, a key that repeats, or a group template on a flat sheet
+ * @internal
+ */
+export function buildTemplates(input, bridge, constructors) {
+    const rows = input?.rows ?? [];
+    const groups = input?.groups ?? [];
+    const seen = new Set();
+    for (const t of [...rows, ...groups]) {
+        if (seen.has(t.key))
+            throw new Error(`Sheet: template key "${t.key}" repeats — each template's key is unique among the sheet's templates, rows and groups alike`);
+        seen.add(t.key);
+    }
+    const groupHalf = bridge.group;
+    if (groups.length > 0 && groupHalf === undefined) {
+        throw new Error("Sheet: `templates.groups` needs a grouped sheet — declare `group={Sheet.group(GroupType, \"lines\", …)}`, or drop the group templates");
+    }
+    const wires = [];
+    for (const t of rows) {
+        const values = valuesOf(t, bridge.lineType, "row");
+        const seed = buildSheetSeed(SheetNewRowType, bridge.lineType, overDefaults(SheetNewRowType, bridge.lineType, values, constructors.newRow), bridge.seedCells);
+        wires.push(East.value({
+            key: t.key, name: t.name, group: t.group === undefined ? none : some(t.group),
+            cells: bridge.seedCells(values),
+            seed: variant("row", seed),
+        }, SheetTemplateWireType));
+    }
+    if (groupHalf !== undefined) {
+        const groupType = groupHalf.groupType;
+        const groupCells = buildPatchCells(groupType, groupHalf.cellMetas, {}, false);
+        for (const t of groups) {
+            const values = valuesOf(t, groupType, "group");
+            const seed = buildSheetSeed(SheetNewGroupType, groupType, overDefaults(SheetNewGroupType, groupType, values, constructors.newGroup), groupCells, { field: groupHalf.linesField, project: bridge.projectRow });
+            wires.push(East.value({
+                key: t.key, name: t.name, group: t.group === undefined ? none : some(t.group),
+                cells: groupCells(values),
+                seed: variant("group", seed),
+            }, SheetTemplateWireType));
+        }
+    }
+    return East.value(wires, ArrayType(SheetTemplateWireType));
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/sheet/templates.js.map

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

package/dist/src/sheet/transactions.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The Sheet's names for the shared editing contract (`contracts/editing.ts`,
+ * #879) — each one the `Editing` namespace's own value (`Sheet.apply` is
+ * `Editing.apply`, `Sheet.Types.ChangeSet` is `Editing.Types.ChangeSet`) — and
+ * the transaction types only a sheet has: a new row's destination among a
+ * group's children, and the `newRow` / `newGroup` contexts.
+ *
+ * @packageDocumentation
+ */
+import { IntegerType, StringType, StructType, VariantType } from "@elaraai/east";
+export { EditingPositionType as SheetPositionType, EditingPlacementType as SheetEntryPlacementType, EditingFieldIssueType as SheetFieldIssueType, EditingReadinessType as SheetReadinessType, EditingIssueType as SheetIssueType, EditingBatchReadinessType as SheetBatchReadinessType, EditingOriginType as SheetOriginType, EditingApplyResultType as SheetApplyResultType, EditingDraftFieldType as SheetDraftFieldType, EditingDraftTypeFor as SheetDraftTypeFor, EditingBaseTypeFor as SheetBaseTypeFor, EditingChangeTypeFor as SheetChangeTypeFor, EditingChangeSetTypeFor as SheetChangeSetTypeFor, EditingAppliedTypeFor as SheetAppliedTypeFor, applyEditing as applySheet, type EditingDraftOf as SheetDraftOf, } from "@elaraai/east-ui/internal";
+/**
+ * A new row's destination: a top-level entry's placement, or a position among
+ * a group's children.
+ *
+ * @property entry - A top-level entry, at its placement
+ * @property child - A child row of the group with this id, at this index
+ */
+export declare const SheetRowDestinationType: VariantType<{
+    readonly entry: VariantType<{
+        readonly ordered: VariantType<{
+            readonly start: import("@elaraai/east").NullType;
+            readonly end: import("@elaraai/east").NullType;
+            readonly before: StringType;
+            readonly after: StringType;
+        }>;
+        readonly keyOrder: import("@elaraai/east").NullType;
+    }>;
+    readonly child: StructType<{
+        readonly group: StringType;
+        readonly index: IntegerType;
+    }>;
+}>;
+/**
+ * What a `newRow` constructor is told.
+ *
+ * @property destination - Where the new row goes
+ */
+export declare const SheetNewRowType: StructType<{
+    readonly destination: VariantType<{
+        readonly entry: VariantType<{
+            readonly ordered: VariantType<{
+                readonly start: import("@elaraai/east").NullType;
+                readonly end: import("@elaraai/east").NullType;
+                readonly before: StringType;
+                readonly after: StringType;
+            }>;
+            readonly keyOrder: import("@elaraai/east").NullType;
+        }>;
+        readonly child: StructType<{
+            readonly group: StringType;
+            readonly index: IntegerType;
+        }>;
+    }>;
+}>;
+/**
+ * What a `newGroup` constructor is told.
+ *
+ * @property place - Where the new group goes
+ */
+export declare const SheetNewGroupType: StructType<{
+    readonly place: VariantType<{
+        readonly ordered: VariantType<{
+            readonly start: import("@elaraai/east").NullType;
+            readonly end: import("@elaraai/east").NullType;
+            readonly before: StringType;
+            readonly after: StringType;
+        }>;
+        readonly keyOrder: import("@elaraai/east").NullType;
+    }>;
+}>;
+//# sourceMappingURL=transactions.d.ts.map