@elaraai/east-ui 1.0.74 → 1.0.76

package/dist/src/collections/index.d.ts

@@ -17,5 +17,6 @@ export { Roster, type RosterConfig, type RosterPersonFields, type RosterShiftFie
 export { Board, type BoardConfig, type BoardEntityFields, type BoardAssignmentFields, type BoardRequirementFields, BoardModeType, type BoardModeLiteral, } from "./board/index.js";
 export { Deck, DeckItemType, DeckRootType, DeckCardFaceType, DeckFactType, DeckLayoutType, DeckStyleType, type DeckConfig, type DeckCardFields, type DeckGroupOption, type DeckLayoutLiteral, type DeckStyle, } from "./deck/index.js";
 export { ValueTree, ValueTreeStepType, ValueTreePathType, ValueTreeLeafType, ValueTreeNodeType, ValueTreeStyleType, ValueTreeRootType, type ValueTreeOptions, type ValueTreeScope, type ValueTreeScopeStep, type ValueTreeProbe, } from "./value-tree/index.js";
+export { Sheet, type SheetNamespace, type SheetOptions, type SheetSuggestInput, type SheetProposerInput, type SheetStringField, type SheetBindHandle, type SheetColumn, type SheetColumnSpec, type SheetFieldKey, type SheetMemberArrayField, type SheetFillInput, type SheetColumnBaseConfig, type SheetValueConfig, type SheetTextConfig, type SheetDateConfig, type SheetQuantityConfig, type SheetIntegerConfig, type SheetLookupConfig, type SheetReferenceConfig, type SheetEnumConfig, type SheetMemberKindInput, type SheetMultipleInput, type SheetSetConfig, type SheetSidesInput, type SheetLinkConfig, type SheetStampedConfig, type SheetCustomConfig, type SheetRegisterValue, type SheetMembersConfig, type SheetDriverConfig, type SheetDriverValue, type SheetArityInput, type SheetCheckInput, type SheetExistsCheck, type SheetLocksInput, type SheetContextOf, type SheetFillOf, type SheetPatchOf, type SheetProposalOf, type SheetEditOf, type SheetCheckContextOf, type SheetPatchInput, } from "./sheet/index.js";
 export { Library, type LibraryConfig, type LibraryCardFields, type LibraryDimensionDef, type LibraryMeterDimDef, type LibraryChipsDimDef, type LibraryTextDimDef, type LibraryGroupDef, } from "./library/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/collections/index.d.ts.map

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

package/dist/src/collections/index.js

@@ -17,5 +17,6 @@ export { Roster, RosterModeType, } from "./roster/index.js";
 export { Board, BoardModeType, } from "./board/index.js";
 export { Deck, DeckItemType, DeckRootType, DeckCardFaceType, DeckFactType, DeckLayoutType, DeckStyleType, } from "./deck/index.js";
 export { ValueTree, ValueTreeStepType, ValueTreePathType, ValueTreeLeafType, ValueTreeNodeType, ValueTreeStyleType, ValueTreeRootType, } from "./value-tree/index.js";
+export { Sheet, } from "./sheet/index.js";
 export { Library, } from "./library/index.js";
 //# sourceMappingURL=index.js.map

package/dist/src/collections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAA0B,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACH,IAAI,EAMJ,iBAAiB,GAoEpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,KAAK,GAKR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,SAAS,GAKZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,SAAS,GAWZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,GAAG,GAcN,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,QAAQ,GAGX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,MAAM,EAIN,cAAc,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,KAAK,EAKL,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,GAMhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAKpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,OAAO,GAQV,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAA0B,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACH,IAAI,EAMJ,iBAAiB,GAoEpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,KAAK,GAKR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,SAAS,GAKZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,SAAS,GAWZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,GAAG,GAcN,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,QAAQ,GAGX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,MAAM,EAIN,cAAc,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,KAAK,EAKL,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,GAMhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAKpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,KAAK,GA2CR,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,OAAO,GAQV,MAAM,oBAAoB,CAAC"}

package/dist/src/collections/sheet/bridge.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The typed bridge (`Sheet Spec.md` §4.8) — factory internals, both arms.
+ *
+ * Everything the author writes is typed over the host's row `R` and the
+ * driver's row `D`; everything on the wire is closed. This module joins the
+ * two with compiled East functions that capture only data, bind handles and
+ * the author's functions:
+ *
+ * - `projectRow` — `R` → the wire cells (the same projection the row source
+ *   uses, so `encode` and `make` cannot disagree);
+ * - `rowById` — the REAL source row by id: the captured collection or bind
+ *   handle on the inline arm, the source's `page` at the row's offset on the
+ *   paged arm. Built ONCE per sheet and shared by every wrapper;
+ * - `decode` — the source row as the base (the row type's default when
+ *   absent — an insert, a proposal), then each column's field from its cell
+ *   by the static tag. A field with no column keeps the base row's value;
+ * - `bridgeCtx` — the wire context to `Sheet.Types.Context(R, D)`;
+ * - the wrappers — a fill provider, a proposer, an arity rule, a member
+ *   check, a custom kind's parse / print, `onEdit` — each the author's typed
+ *   function inside its closed wire twin.
+ *
+ * The bridge is the one place a string ever names a field: inside the
+ * factory, against the column list it has already validated.
+ *
+ * @packageDocumentation
+ */
+import { type EastType, type ExprType, ArrayType, AsyncFunctionType, BooleanType, DateTimeType, DictType, FloatType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType } from "@elaraai/east";
+import { SheetCellType, SheetContextType, SheetProviderType, SheetProposerType, SheetCheckType, SheetCountedType, SheetEditType, SheetHalfType, type SheetColumnKindLiteral } from "./types.js";
+import { EMPTY_LINK } from "./link.js";
+import type { SheetAnyColumnConfig, SheetColumn } from "./columns.js";
+import type { SheetDriverValue, SheetRegisterValue } from "./registers.js";
+/** The wire cells dictionary type. */
+export declare const SheetCellsType: DictType<StringType, import("@elaraai/east").VariantType<{
+    readonly Null: NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: FloatType;
+    readonly String: StringType;
+    readonly DateTime: DateTimeType;
+    readonly Link: StructType<{
+        readonly from: ArrayType<import("@elaraai/east").VariantType<{
+            readonly identified: StructType<{
+                readonly key: StringType;
+            }>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly counted: StructType<{
+                readonly n: IntegerType;
+                readonly key: StringType;
+            }>;
+            readonly placeholder: NullType;
+            readonly text: StringType;
+        }>>;
+        readonly to: ArrayType<import("@elaraai/east").VariantType<{
+            readonly identified: StructType<{
+                readonly key: StringType;
+            }>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly counted: StructType<{
+                readonly n: IntegerType;
+                readonly key: StringType;
+            }>;
+            readonly placeholder: NullType;
+            readonly text: StringType;
+        }>>;
+    }>;
+}>>;
+/** How a `set` / `link` column's halves live on the row (§3.4). */
+export type SheetLinkForm = "link" | "array" | "string";
+/**
+ * One declared column, described against the row type — the static facts
+ * every East function below is built from.
+ *
+ * @internal
+ */
+export interface SheetColumnMeta {
+    /** The column key — the row field it sits on. */
+    key: string;
+    /** The column kind. */
+    kind: SheetColumnKindLiteral;
+    /** The author's config. */
+    config: SheetAnyColumnConfig;
+    /** The row field's static type. */
+    fieldType: EastType;
+    /** Whether the field is an `Option` of the payload. */
+    optional: boolean;
+    /** The kind's payload type. */
+    payloadType: EastType;
+    /** The cell arm the payload lands in. */
+    cellTag: "String" | "DateTime" | "Float" | "Integer" | "Boolean" | "Link";
+    /** Whether the sheet writes the column. */
+    editable: boolean;
+    /** A reified `value` projection — the column is a derived, read-only read. */
+    derived?: ExprType<FunctionType<[StructType], EastType>>;
+    /** Whether the derived projection returns an `Option` of the payload. */
+    derivedOptional?: boolean;
+    /** A `set` / `link` column's storage form. */
+    form?: SheetLinkForm;
+    /** For the `array` form: the half THIS field holds. */
+    ownHalf?: "from" | "to";
+    /** For a `link` column in the `array` form: the field holding the other half. */
+    otherField?: string;
+    /** The register the column resolves against. */
+    register?: string;
+    /** The driver's row type the column was built with. */
+    driverType?: StructType;
+}
+/** Whether a type is `Option<T>` — a variant of exactly `none: Null` and `some`. */
+export declare function optionPayload(t: EastType): EastType | undefined;
+/** The cell arm a primitive payload lands in, or `undefined` for a type no cell holds. */
+export declare function cellTagOf(t: EastType): SheetColumnMeta["cellTag"] | undefined;
+/**
+ * Describe one column against the row type — the build-time refusals of
+ * §3.12 live here, every one naming the column and the remedy.
+ *
+ * @param key - The column key
+ * @param col - The built column
+ * @param rowType - The host's row type
+ * @returns The column's metadata
+ * @throws Error naming the column when the kind cannot sit on the field
+ */
+export declare function describeColumn(key: string, col: SheetColumn<StructType, EastType>, rowType: StructType): SheetColumnMeta;
+/** A payload value as a cell. */
+export declare function cellOfPayload(tag: SheetColumnMeta["cellTag"], v: ExprType<EastType>): ExprType<SheetCellType>;
+/** The blank cell. */
+export declare const NULL_CELL: import("@elaraai/east").VariantExpr<{
+    readonly Null: NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: FloatType;
+    readonly String: StringType;
+    readonly DateTime: DateTimeType;
+    readonly Link: StructType<{
+        readonly from: ArrayType<import("@elaraai/east").VariantType<{
+            readonly identified: StructType<{
+                readonly key: StringType;
+            }>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly counted: StructType<{
+                readonly n: IntegerType;
+                readonly key: StringType;
+            }>;
+            readonly placeholder: NullType;
+            readonly text: StringType;
+        }>>;
+        readonly to: ArrayType<import("@elaraai/east").VariantType<{
+            readonly identified: StructType<{
+                readonly key: StringType;
+            }>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly counted: StructType<{
+                readonly n: IntegerType;
+                readonly key: StringType;
+            }>;
+            readonly placeholder: NullType;
+            readonly text: StringType;
+        }>>;
+    }>;
+}>;
+/** The resolved source the bridge reads real rows from. */
+export type SheetBridgeSource = {
+    kind: "inline";
+    rows: ExprType<ArrayType<StructType>>;
+} | {
+    kind: "paged";
+    source: ExprType<StructType>;
+    keyed: boolean;
+};
+/**
+ * The compiled bridge of one sheet — every wire function the root stores is
+ * built from these.
+ *
+ * @internal
+ */
+export interface SheetBridge {
+    /** The host's row type. */
+    rowType: StructType;
+    /** The driver's row type (`NullType` without a driver). */
+    driverType: EastType;
+    /** `Sheet.Types.Context(R, D)`. */
+    ctxType: StructType;
+    /** `Sheet.Types.CheckContext(R)`. */
+    checkCtxType: StructType;
+    /** `Sheet.Types.Edit(R)`. */
+    editType: EastType;
+    /** `Sheet.Types.Patch(R)`. */
+    patchType: StructType;
+    /** `Sheet.Types.Proposal(R)`. */
+    proposalType: StructType;
+    /** `R` → the wire cells. */
+    projectRow: ExprType<FunctionType<[StructType], typeof SheetCellsType>>;
+    /** `(id, cells, base)` → `R`. */
+    decode: ExprType<FunctionType<[StringType, typeof SheetCellsType, OptionType<StructType>], StructType>>;
+    /** `(id, offset)` → the real source row. */
+    rowById: ExprType<FunctionType<[StringType, IntegerType], OptionType<StructType>>>;
+    /** The wire context → `Sheet.Types.Context(R, D)`. */
+    bridgeCtx: ExprType<FunctionType<[SheetContextType], StructType>>;
+    /** `Sheet.Types.Patch(R)` → the set fields as cells. */
+    encodePatch: ExprType<FunctionType<[StructType], typeof SheetCellsType>>;
+}
+/** What the bridge needs from the root. */
+export interface SheetBridgeInput {
+    rowType: StructType;
+    idField: string | undefined;
+    metas: SheetColumnMeta[];
+    registers: Record<string, SheetRegisterValue>;
+    driver: SheetDriverValue | undefined;
+    source: SheetBridgeSource;
+}
+/**
+ * Compile the bridge for one sheet.
+ *
+ * @param input - The root's resolved declaration
+ * @returns The bridge
+ */
+export declare function buildBridge(input: SheetBridgeInput): SheetBridge;
+/** Whether an East function value is asynchronous. */
+export declare function isAsyncFunction(fn: ExprType<EastType>): boolean;
+/**
+ * Wrap a fill provider — `Sheet.Types.Context(R, D)` → `Option<Fill(T)>` —
+ * into the wire provider variant (sync or async by the function's type).
+ */
+export declare function wrapProvider(bridge: SheetBridge, meta: SheetColumnMeta, fn: unknown, index: number): ExprType<SheetProviderType>;
+/**
+ * Wrap a row proposer — `Sheet.Types.Context(R, D)` → `Array<Proposal(R)>` —
+ * into the wire proposer variant.
+ */
+export declare function wrapProposer(bridge: SheetBridge, fn: unknown, index: number): ExprType<SheetProposerType>;
+/** Wrap an arity rule — `Sheet.Types.Context(R, D)` → `Option<Counted>`. */
+export declare function wrapArity(bridge: SheetBridge, meta: SheetColumnMeta, fn: unknown): ExprType<FunctionType<[SheetContextType], OptionType<SheetCountedType>>>;
+/** Wrap an author member check — `Sheet.Types.CheckContext(R)` → `Option<String>` — into the `custom` check arm. */
+export declare function wrapCheck(bridge: SheetBridge, meta: SheetColumnMeta, fn: unknown, index: number): ExprType<SheetCheckType>;
+/** Wrap a custom kind's `parse` — `(text, Context(R, D))` → `Option<P>` — into the wire parse. */
+export declare function wrapCustomParse(bridge: SheetBridge, meta: SheetColumnMeta, fn: unknown): ExprType<FunctionType<[StringType, SheetContextType], OptionType<SheetCellType>>>;
+/** Wrap a custom kind's `print` — `P` → `String` — into the wire print. */
+export declare function wrapCustomPrint(meta: SheetColumnMeta, fn: unknown): ExprType<FunctionType<[SheetCellType], StringType>>;
+/** Wrap a typed `onEdit` — `Sheet.Types.Edit(R)` → `Null` — into the wire edit handler. */
+export declare function wrapOnEdit(bridge: SheetBridge, fn: unknown): ExprType<FunctionType<[SheetEditType], NullType>>;
+/**
+ * Compile `onUpdate` into the wire edit handler (§4.7) — the whole-value
+ * rebuild: a commit rewrites one row, an insert appends a fresh row after
+ * `afterRowId`, a remove filters ids; then the author's `onUpdate` receives
+ * the collection.
+ */
+export declare function compileOnUpdate(bridge: SheetBridge, rows: ExprType<ArrayType<StructType>>, idField: string, fn: unknown): ExprType<FunctionType<[SheetEditType], NullType>>;
+/** Both channels at once — `onEdit` observes, then `onUpdate` writes. */
+export declare function composeEditHandlers(observe: ExprType<FunctionType<[SheetEditType], NullType>> | undefined, write: ExprType<FunctionType<[SheetEditType], NullType>> | undefined): ExprType<FunctionType<[SheetEditType], NullType>> | undefined;
+/** Re-exported for the root's driver-typed refusals. */
+export { SheetHalfType, BooleanType, AsyncFunctionType, EMPTY_LINK };
+//# sourceMappingURL=bridge.d.ts.map

package/dist/src/collections/sheet/bridge.d.ts.map

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