@elaraai/east-ui 1.0.86 → 1.0.87

package/dist/src/collections/sheet/link.js

@@ -1,228 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * `Sheet.link` — the link value's helpers: the grammar's parse / print pair
- * as exported East functions (B§4.1, `Sheet Spec.md` §3.4), and the
- * `arity` / `check` declarations a link column takes.
- *
- * The grammar here is the SYNTACTIC half the renderer and a task share —
- * splitting halves on `>`, members on `,`, the counted form, ranges, the
- * placeholder — resolved against a register's members so a code is
- * `identified` and anything else is kept as `text`. Candidate scoring,
- * prefix completion and the countable-by-attribute forms are the renderer's
- * (`link/grammar.ts`, P3): they need the editor, not a value.
- *
- * @packageDocumentation
- */
-import { East, ArrayType, FunctionType, IntegerType, NullType, OptionType, StringType, StructType, SetType, variant, some, none, } from "@elaraai/east";
-import { SheetMemberType, SheetLinkType, SheetRegisterMemberType, SheetCountedType, } from "./types.js";
-/** A list of link members. */
-export const SheetMembersType = ArrayType(SheetMemberType);
-/** A list of register members — what `parse` resolves against. */
-export const SheetRegisterMembersType = ArrayType(SheetRegisterMemberType);
-// ============================================================================
-// Print — the grammar's display form
-// ============================================================================
-/**
- * Print one member in the grammar's display form.
- *
- * @remarks
- * A module-scope East function (the Plan's `REBASE_ROWS` precedent): built
- * once, called by `print` and by the factory's `String`-field projection.
- */
-export const printMember = East.function([SheetMemberType], StringType, (_$, m) => m.match({
-    identified: (_$2, v) => v.key,
-    range: (_$2, v) => East.str `${v.from}-${v.to}`,
-    counted: (_$2, v) => East.str `${v.n} x ${v.key}`,
-    placeholder: (_$2) => East.value("TBC", StringType),
-    text: (_$2, t) => t,
-}));
-/**
- * `Sheet.link.print` — a link value as the planner would type it (B§4.2):
- * `a > b`, `b` for a destination-only link, `a >` for a source-only one.
- *
- * @example
- * ```ts
- * import { East, StringType, variant } from "@elaraai/east";
- * import { Sheet } from "@elaraai/east-ui";
- *
- * const printed = East.function([], StringType, ($) => {
- *     const link = $.const({
- *         from: [variant("identified", { key: "M2140" }), variant("range", { from: "M2141", to: "M2145" })],
- *         to:   [variant("counted", { n: 4n, key: "CNC lathe" }), variant("placeholder", null)],
- *     }, Sheet.Types.Link);
- *     return Sheet.link.print(link);
- * });
- * ```
- */
-export const printLink = East.function([SheetLinkType], StringType, ($, link) => {
-    const pm = $.const(printMember);
-    const from = $.let(link.from.map((_$, m) => pm(m)).stringJoin(", "), StringType);
-    const to = $.let(link.to.map((_$, m) => pm(m)).stringJoin(", "), StringType);
-    return link.from.length().equal(0n).ifElse((_$) => to, (_$) => link.to.length().equal(0n).ifElse((_$2) => East.str `${from} >`, (_$2) => East.str `${from} > ${to}`));
-});
-/**
- * Print one member with the register's LABELS — the `store: "canonical"`
- * form (B§4.2): an identified member prints its member's label when the
- * register has it, its key otherwise; every other member prints as
- * {@link printMember}.
- */
-export const printMemberWith = East.function([SheetMemberType, SheetRegisterMembersType], StringType, ($, m, members) => {
-    const pm = $.const(printMember);
-    return m.match({
-        identified: (_$2, v) => members.firstMap((_$3, r) => r.key.equal(v.key).ifElse((_$4) => East.value(some(r.label), OptionType(StringType)), (_$4) => East.value(none, OptionType(StringType)))).match({
-            some: (_$3, label) => label,
-            none: (_$3) => v.key,
-        }),
-    }, (_$2) => pm(m));
-});
-/**
- * `Sheet.link.print` with the register's labels — what a `String` field
- * stores under `store: "canonical"` (B§4.2).
- */
-export const printLinkWith = East.function([SheetLinkType, SheetRegisterMembersType], StringType, ($, link, members) => {
-    const pm = $.const(printMemberWith);
-    const from = $.let(link.from.map((_$, m) => pm(m, members)).stringJoin(", "), StringType);
-    const to = $.let(link.to.map((_$, m) => pm(m, members)).stringJoin(", "), StringType);
-    return link.from.length().equal(0n).ifElse((_$) => to, (_$) => link.to.length().equal(0n).ifElse((_$2) => East.str `${from} >`, (_$2) => East.str `${from} > ${to}`));
-});
-// ============================================================================
-// Parse — text to a link value, against a register
-// ============================================================================
-/** The key of the register member a token names (by key or alias, case-insensitive). */
-const resolveKey = East.function([StringType, SheetRegisterMembersType], OptionType(StringType), ($, token, members) => {
-    const t = $.let(token.trim().lowerCase(), StringType);
-    return members.firstMap((_$, m) => m.key.lowerCase().equal(t)
-        .or(() => m.aliases.map((_$2, a) => a.lowerCase()).toSet().has(t))
-        .ifElse((_$2) => East.value(some(m.key), OptionType(StringType)), (_$2) => East.value(none, OptionType(StringType))));
-});
-/** The counted form `N x key` / `key x N` (B§4.1) — `none` when the token is not one. */
-const parseCounted = East.function([StringType, SheetRegisterMembersType], OptionType(SheetCountedType), ($, token, members) => {
-    // `×` folds into the ASCII operator so one regex covers every declared op.
-    const tok = $.let(token.replace("×", " x "), StringType);
-    const noCount = $.const(none, OptionType(SheetCountedType));
-    const resolve = $.const(resolveKey);
-    const keyOf = $.const(East.function([StringType], StringType, ($2, rest) => resolve(rest, members).match({
-        some: (_$3, k) => k,
-        none: (_$3) => rest.trim(),
-    })));
-    return tok.contains(new RegExp("^\\d+\\s*[xX*]\\s*\\S")).ifElse(($2) => {
-        // Leading count: `4 x lathe`.
-        const at = $2.let(tok.indexOf(new RegExp("[xX*]")), IntegerType);
-        const digits = $2.let(tok.substring(0n, at).trim(), StringType);
-        const n = $2.let(digits.parse(IntegerType), IntegerType);
-        const rest = $2.let(tok.substring(at.add(1n), tok.length()).trim(), StringType);
-        return East.value(some({ n, key: keyOf(rest) }), OptionType(SheetCountedType));
-    }, (_$2) => tok.contains(new RegExp("\\S\\s+[xX*]\\s*\\d+$")).ifElse(($3) => {
-        // Trailing count: `lathe x 4`.
-        const at = $3.let(tok.indexOf(new RegExp("\\s+[xX*]\\s*\\d+$")), IntegerType);
-        const rest = $3.let(tok.substring(0n, at).trim(), StringType);
-        const tail = $3.let(tok.substring(at, tok.length()), StringType);
-        const digits = $3.let(tail.substring(tail.indexOf(new RegExp("\\d")), tail.length()).trim(), StringType);
-        const n = $3.let(digits.parse(IntegerType), IntegerType);
-        return East.value(some({ n, key: keyOf(rest) }), OptionType(SheetCountedType));
-    }, (_$3) => noCount));
-});
-/**
- * One token to a member (B§4.1): the placeholder, a register code, the
- * counted form, a range, else text — never blocked.
- */
-const parseMember = East.function([StringType, SheetRegisterMembersType], SheetMemberType, ($, raw, members) => {
-    const tok = $.let(raw.trim(), StringType);
-    const resolve = $.const(resolveKey);
-    const counted = $.const(parseCounted);
-    return tok.upperCase().equal("TBC").ifElse((_$) => East.value(variant("placeholder", null), SheetMemberType), (_$2) => resolve(tok, members).match({
-        some: (_$3, key) => East.value(variant("identified", { key }), SheetMemberType),
-        none: (_$3) => counted(tok, members).match({
-            some: (_$4, c) => East.value(variant("counted", { n: c.n, key: c.key }), SheetMemberType),
-            none: (_$4) => tok.contains(new RegExp("^[A-Za-z]*\\d+-\\d+$")).ifElse(($5) => {
-                // A range; a short upper bound completes from the lower (`M2140-45` ⇒ `M2145`).
-                const parts = $5.let(tok.split("-"), ArrayType(StringType));
-                const from = $5.let(parts.get(0n), StringType);
-                const upper = $5.let(parts.get(1n), StringType);
-                const to = $5.let(upper.length().less(from.length()).ifElse((_$6) => from.substring(0n, from.length().subtract(upper.length())).concat(upper), (_$6) => upper), StringType);
-                return East.value(variant("range", { from, to }), SheetMemberType);
-            }, (_$5) => East.value(variant("text", tok), SheetMemberType)),
-        }),
-    }));
-});
-/** The members of one half — comma-separated tokens, blanks dropped. */
-const parseHalf = East.function([StringType, SheetRegisterMembersType], SheetMembersType, ($, text, members) => {
-    const member = $.const(parseMember);
-    return text.split(",").filterMap((_$2, tok) => tok.trim().length().equal(0n).ifElse((_$3) => East.value(none, OptionType(SheetMemberType)), (_$3) => East.value(some(member(tok, members)), OptionType(SheetMemberType))));
-});
-/**
- * `Sheet.link.parse` — the planner's text to a typed link, resolved against
- * a register's members (B§4.1 / B§4.2): `a > b` fills both halves, `b`
- * alone is a destination-only link, `a >` a source-only one.
- *
- * @example
- * ```ts
- * import { East, none, some } from "@elaraai/east";
- * import { Sheet } from "@elaraai/east-ui";
- *
- * const parsed = East.function([], Sheet.Types.Link, ($) => {
- *     const members = $.const([
- *         { key: "M2140", label: "M2140", kind: "machine", aliases: [], meta: some("CNC lathe"), parent: some("Line 2"), tone: none },
- *         { key: "CNC lathe", label: "CNC lathe", kind: "family", aliases: ["lathe", "lathes"], meta: some("family"), parent: none, tone: none },
- *     ], Sheet.Types.RegisterMembers);
- *     return Sheet.link.parse("m2140 > 4 x lathe, M2141-45, TBC, paint shop", members);
- * });
- * ```
- */
-export const parseLink = East.function([StringType, SheetRegisterMembersType], SheetLinkType, ($, text, members) => {
-    const emptyMembers = $.const([], SheetMembersType);
-    const half = $.const(parseHalf);
-    return text.contains(">").ifElse(($2) => {
-        const at = $2.let(text.indexOf(">"), IntegerType);
-        const from = $2.let(half(text.substring(0n, at), members), SheetMembersType);
-        const to = $2.let(half(text.substring(at.add(1n), text.length()), members), SheetMembersType);
-        return $2.let({ from, to }, SheetLinkType);
-    }, ($2) => {
-        const to = $2.let(half(text, members), SheetMembersType);
-        return $2.let({ from: emptyMembers, to }, SheetLinkType);
-    });
-});
-/** The register keys a link's identified and counted members name — the `exists` check's vocabulary. */
-export const linkKeys = East.function([SheetLinkType], SetType(StringType), (_$, link) => link.from.concat(link.to).filterMap((_$2, m) => m.match({
-    identified: (_$3, v) => East.value(some(v.key), OptionType(StringType)),
-    counted: (_$3, v) => East.value(some(v.key), OptionType(StringType)),
-    range: (_$3, v) => East.value(some(v.from), OptionType(StringType)),
-}, (_$3) => East.value(none, OptionType(StringType)))).toSet());
-/**
- * Declares a link column's arity rule.
- *
- * @typeParam R - The host's row type (inferred from `implied`)
- * @typeParam D - The driver's row type (inferred from `implied`)
- * @param half - The half the rule counts
- * @param implied - The rule — an `East.function` over `Sheet.Types.Context(R, D)` returning `Option<Sheet.Types.Counted>`
- * @returns The declaration a `Sheet.column.link` config takes as `arity`
- */
-export function createArity(half, implied) {
-    return { half, implied };
-}
-/** `Sheet.link.check` — the built-in checks. */
-export const check = {
-    /**
-     * The grammar's own check: an identified, counted or range member must
-     * name a register key; a placeholder or text passes.
-     *
-     * @returns The `exists` check
-     */
-    exists: () => ({ exists: true }),
-};
-/** Whether a check input is the `exists` marker. */
-export function isExistsCheck(c) {
-    return typeof c === "object" && c !== null && c.exists === true;
-}
-/** A `none` of the given type, as an expression — the shared fallback spelling. */
-export function noneOf(type) {
-    return East.value(none, OptionType(type));
-}
-/** The empty link value. */
-export const EMPTY_LINK = East.value({ from: [], to: [] }, SheetLinkType);
-/** Re-exported so the builders type their `NullType` driver default without a second import. */
-export { NullType };
-//# sourceMappingURL=link.js.map

package/dist/src/collections/sheet/link.js.map

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

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

@@ -1,278 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * `Sheet.register` and `Sheet.driver` — registers are the grammar's
- * vocabulary, projected from the host's rows through accessors reified once
- * (Plan's `derive` move, `Sheet Spec.md` §3.3). There is no attribute bag:
- * a value another declaration needs is read off a TYPED row by an accessor.
- *
- * @packageDocumentation
- */
-import { type EastType, type ExprType, type SubtypeExprOrValue, ArrayType, DictType, FunctionType, OptionType, StringType, StructType } from "@elaraai/east";
-import { StatusValueType } from "../../feedback/status/types.js";
-import { SheetRegisterMemberType } from "./types.js";
-/** A built register — its members, as an expression. What `Sheet.register.*` returns and `registers={…}` takes. */
-export type SheetRegisterValue = ExprType<ArrayType<SheetRegisterMemberType>>;
-/**
- * The accessors `Sheet.register.members` reifies over one data ENTRY — its
- * value and its key (`(_v, k) => k` is the normal spelling over a `Dict`;
- * over an `Array` the key is the index, printed).
- *
- * @typeParam T - The data's element type
- * @property kind - The member kind (`"machine"`, `"line"`, `"family"`)
- * @property key - What the grammar resolves — accessor
- * @property label - What a chip prints — accessor
- * @property aliases - Alternative spellings — accessor returning the field's array
- * @property meta - Chip meta — accessor returning the field's `Option`
- * @property parent - The parent key — accessor returning the field's `Option`
- * @property tone - An `enum` member's valence — accessor returning the field's `Option`
- */
-export interface SheetMembersConfig<T extends EastType> {
-    /** The member kind. */
-    kind: string;
-    /** What the grammar resolves. */
-    key: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<StringType>;
-    /** What a chip prints. */
-    label: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<StringType>;
-    /** Alternative spellings the grammar also resolves. */
-    aliases?: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<ArrayType<StringType>>;
-    /** Chip meta — return the field's `Option`. */
-    meta?: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<OptionType<StringType>>;
-    /** The parent key — return the field's `Option`. */
-    parent?: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<OptionType<StringType>>;
-    /** The valence dot — return the field's `Option`. */
-    tone?: (value: ExprType<T>, key: ExprType<StringType>) => SubtypeExprOrValue<OptionType<StatusValueType>>;
-}
-/**
- * Projects the host's rows into register members — `Sheet.register.members`.
- *
- * @remarks
- * The accessors are reified ONCE into a describe function which the map
- * then CALLS (`shared/reify.ts`, `EAST_UI_PROP_PATTERNS.md`). Duplicate keys
- * fold, first occurrence wins — a countable-by-attribute kind (`"CNC lathe"`
- * from every machine of that family) declares one member per distinct value.
- *
- * @typeParam T - The data's element type
- * @param data - The rows — an `Array<T>` or a `Dict<String, T>` value or expression
- * @param config - The accessors ({@link SheetMembersConfig})
- * @returns The members, as an expression
- *
- * @example
- * ```tsx
- * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
- * import { ArrayType, DateTimeType, DictType, East, FloatType, IntegerType, OptionType, StringType, StructType, none, some, variant } from "@elaraai/east";
- * import { Reactive, Sheet, State, UIComponentType } from "@elaraai/east-ui";
- *
- * const sheet = East.function([], UIComponentType, (_$) => (
- *     <Reactive>{$ => {
- *         const JobType = StructType({
- *             id: StringType, activity: StringType, start: OptionType(DateTimeType), end: OptionType(DateTimeType),
- *             qty: OptionType(FloatType), machines: Sheet.Types.Link,
- *         });
- *         const ActivityType = StructType({ name: StringType, uom: StringType, days: IntegerType });
- *         const MachineType = StructType({ code: StringType, family: StringType, line: StringType });
- *         const LineType = StructType({ name: StringType, aliases: ArrayType(StringType) });
- *         const activities = $.const([
- *             { name: "Machining", uom: "pcs", days: 4n },
- *             { name: "Inspection", uom: "lots", days: 1n },
- *         ], ArrayType(ActivityType));
- *         const machines = $.const([
- *             { code: "M2140", family: "CNC lathe", line: "L2" },
- *             { code: "M2141", family: "CNC lathe", line: "L2" },
- *             { code: "M3210", family: "5-axis mill", line: "L3" },
- *         ], ArrayType(MachineType));
- *         const lines = $.const(new Map([
- *             ["L2", { name: "Line 2", aliases: ["l2", "line 2"] }],
- *             ["L3", { name: "Line 3", aliases: ["l3", "line 3"] }],
- *         ]), DictType(StringType, LineType));
- *         const jobs = $.let(State.bind([ArrayType(JobType)], "sheet_registers_jobs", [
- *             { id: "j1", activity: "Machining", start: some(new Date("2026-02-16T00:00:00Z")), end: none, qty: some(1200.0),
- *               machines: { from: [], to: [variant("counted", { n: 2n, key: "CNC lathe" })] } },
- *         ]));
- *         // The driver's row reaches a fill typed: End = Start + the activity's days.
- *         const DateFill = OptionType(Sheet.Types.Fill(DateTimeType));
- *         const endFromStart = $.const(East.function([Sheet.Types.DraftContext(JobType, ActivityType)], DateFill, ($, ctx) => {
- *             const noFill = $.const(none, DateFill);
- *             return ctx.row.start.match({
- *                 value: (_$, supplied) => supplied.match({
- *                     none: () => noFill,
- *                     some: (_$, start) => ctx.driver.match({
- *                         none: () => noFill,
- *                         some: (_$, d) => some({ value: start.addDays(d.days), meta: East.str`+${d.days}d · ${d.name}` }),
- *                     }),
- *                 }),
- *             }, () => noFill);
- *         }));
- *         const newJob = $.const(East.function([Sheet.Types.NewRow], Sheet.Types.Patch(JobType), () => Sheet.patch(JobType, { machines: { from: [], to: [] } })));
- *         return (
- *             <Sheet
- *                 data={jobs}
- *                 id="id"
- *                 driver={Sheet.driver("activity", activities, { key: a => a.name, label: a => a.name, meta: a => some(a.uom) })}
- *                 registers={{
- *                     machines: Sheet.register.concat([
- *                         Sheet.register.members(machines, { kind: "machine", key: m => m.code, label: m => m.code,
- *                             meta: m => some(m.family), parent: m => some(m.line) }),
- *                         // A Dict's key rides as the accessors' second argument.
- *                         Sheet.register.members(lines, { kind: "line", key: (_l, code) => code, label: l => l.name, aliases: l => l.aliases }),
- *                         // Both lathes name one family — duplicate keys fold, the first wins.
- *                         Sheet.register.members(machines, { kind: "family", key: m => m.family, label: m => m.family, meta: _m => some("family") }),
- *                     ]),
- *                 }}
- *                 columns={{
- *                     activity: Sheet.column.lookup(JobType, { header: "Activity", width: "140px" }),
- *                     start:    Sheet.column.date(JobType, { header: "Start", width: "96px" }),
- *                     end:      Sheet.column.date(JobType, { header: "End", sub: "start + days", width: "96px", base: "start", fill: [endFromStart] }),
- *                     qty:      Sheet.column.quantity(JobType, ActivityType, { header: "Qty", sub: "uom per activity", width: "112px", uom: d => d.uom }),
- *                     machines: Sheet.column.set(JobType, "machines", { header: "Machines", sub: "M2140 · 2 x lathe · line 2", width: "240px",
- *                                   members: [{ kind: "machine", identified: true }, { kind: "line", countable: true, resolvesTo: "machine" },
- *                                             { kind: "family", countable: true, resolvesTo: "machine" }] }),
- *                 }}
- *                 newRow={newJob}
- *                 onUpdate={jobs.write}
- *             />
- *         );
- *     }}</Reactive>
- * ));
- * ```
- */
-export declare function createMembers<T extends EastType>(data: SubtypeExprOrValue<ArrayType<T>> | SubtypeExprOrValue<DictType<StringType, T>>, config: SheetMembersConfig<T>): SheetRegisterValue;
-/**
- * Joins member sets of different kinds into one register — `Sheet.register.concat`.
- *
- * @param parts - The member sets, in order
- * @returns The concatenated members
- */
-export declare function concatMembers(parts: SheetRegisterValue[]): SheetRegisterValue;
-/**
- * The accessors `Sheet.driver` reifies over one driver row.
- *
- * @typeParam D - The driver's row type
- */
-export interface SheetDriverConfig<D extends StructType> {
-    /** The member key — what the driver column's cell stores. */
-    key: (row: ExprType<D>) => SubtypeExprOrValue<StringType>;
-    /** What a chip / candidate prints. */
-    label: (row: ExprType<D>) => SubtypeExprOrValue<StringType>;
-    /** Alternative spellings. */
-    aliases?: (row: ExprType<D>) => SubtypeExprOrValue<ArrayType<StringType>>;
-    /** Chip meta — return the field's `Option`. */
-    meta?: (row: ExprType<D>) => SubtypeExprOrValue<OptionType<StringType>>;
-}
-/**
- * The driver declaration — the column, its data, the row type `D` every
- * driver-reading accessor is typed by, and the reified key lookup.
- *
- * @remarks
- * The typed parts (`rowType`, `data`, `keyFn`) never reach the IR: the root
- * applies a column's `uom` / `sides` accessors over `data` and the bridge
- * folds `data` into the `ctx.driver` lookup. Only `column` and `members`
- * ride ({@link SheetDriverType}).
- *
- */
-export interface SheetDriverValue {
-    /** The driver column's key — must be a `lookup` column on a `String` field. */
-    readonly column: string;
-    /** The driver's row type (erased here; the builders that read the driver's row take it explicitly). */
-    readonly rowType: StructType;
-    /** The driver rows. */
-    readonly data: ExprType<ArrayType<StructType>>;
-    /** The reified key accessor. */
-    readonly keyFn: ExprType<FunctionType<[StructType], StringType>>;
-    /** The driver's register members. */
-    readonly members: SheetRegisterValue;
-}
-/**
- * Declares the driver — `Sheet.driver(column, data, { key, label })`: the
- * `lookup` column whose member decides what the row does, with its data,
- * so `D` reaches every `uom` / `sides` accessor and `ctx.driver` (§3.3).
- *
- * @typeParam D - The driver's row type (inferred from `data`)
- * @param column - The driver column's key
- * @param data - The driver rows — an `Array<D>` value or expression
- * @param config - The accessors ({@link SheetDriverConfig})
- * @returns The driver declaration the `driver` prop takes
- *
- * @example
- * ```tsx
- * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
- * import { ArrayType, DateTimeType, DictType, East, FloatType, IntegerType, OptionType, StringType, StructType, none, some, variant } from "@elaraai/east";
- * import { Reactive, Sheet, State, UIComponentType } from "@elaraai/east-ui";
- *
- * const sheet = East.function([], UIComponentType, (_$) => (
- *     <Reactive>{$ => {
- *         const JobType = StructType({
- *             id: StringType, activity: StringType, start: OptionType(DateTimeType), end: OptionType(DateTimeType),
- *             qty: OptionType(FloatType), machines: Sheet.Types.Link,
- *         });
- *         const ActivityType = StructType({ name: StringType, uom: StringType, days: IntegerType });
- *         const MachineType = StructType({ code: StringType, family: StringType, line: StringType });
- *         const LineType = StructType({ name: StringType, aliases: ArrayType(StringType) });
- *         const activities = $.const([
- *             { name: "Machining", uom: "pcs", days: 4n },
- *             { name: "Inspection", uom: "lots", days: 1n },
- *         ], ArrayType(ActivityType));
- *         const machines = $.const([
- *             { code: "M2140", family: "CNC lathe", line: "L2" },
- *             { code: "M2141", family: "CNC lathe", line: "L2" },
- *             { code: "M3210", family: "5-axis mill", line: "L3" },
- *         ], ArrayType(MachineType));
- *         const lines = $.const(new Map([
- *             ["L2", { name: "Line 2", aliases: ["l2", "line 2"] }],
- *             ["L3", { name: "Line 3", aliases: ["l3", "line 3"] }],
- *         ]), DictType(StringType, LineType));
- *         const jobs = $.let(State.bind([ArrayType(JobType)], "sheet_registers_jobs", [
- *             { id: "j1", activity: "Machining", start: some(new Date("2026-02-16T00:00:00Z")), end: none, qty: some(1200.0),
- *               machines: { from: [], to: [variant("counted", { n: 2n, key: "CNC lathe" })] } },
- *         ]));
- *         // The driver's row reaches a fill typed: End = Start + the activity's days.
- *         const DateFill = OptionType(Sheet.Types.Fill(DateTimeType));
- *         const endFromStart = $.const(East.function([Sheet.Types.DraftContext(JobType, ActivityType)], DateFill, ($, ctx) => {
- *             const noFill = $.const(none, DateFill);
- *             return ctx.row.start.match({
- *                 value: (_$, supplied) => supplied.match({
- *                     none: () => noFill,
- *                     some: (_$, start) => ctx.driver.match({
- *                         none: () => noFill,
- *                         some: (_$, d) => some({ value: start.addDays(d.days), meta: East.str`+${d.days}d · ${d.name}` }),
- *                     }),
- *                 }),
- *             }, () => noFill);
- *         }));
- *         const newJob = $.const(East.function([Sheet.Types.NewRow], Sheet.Types.Patch(JobType), () => Sheet.patch(JobType, { machines: { from: [], to: [] } })));
- *         return (
- *             <Sheet
- *                 data={jobs}
- *                 id="id"
- *                 driver={Sheet.driver("activity", activities, { key: a => a.name, label: a => a.name, meta: a => some(a.uom) })}
- *                 registers={{
- *                     machines: Sheet.register.concat([
- *                         Sheet.register.members(machines, { kind: "machine", key: m => m.code, label: m => m.code,
- *                             meta: m => some(m.family), parent: m => some(m.line) }),
- *                         // A Dict's key rides as the accessors' second argument.
- *                         Sheet.register.members(lines, { kind: "line", key: (_l, code) => code, label: l => l.name, aliases: l => l.aliases }),
- *                         // Both lathes name one family — duplicate keys fold, the first wins.
- *                         Sheet.register.members(machines, { kind: "family", key: m => m.family, label: m => m.family, meta: _m => some("family") }),
- *                     ]),
- *                 }}
- *                 columns={{
- *                     activity: Sheet.column.lookup(JobType, { header: "Activity", width: "140px" }),
- *                     start:    Sheet.column.date(JobType, { header: "Start", width: "96px" }),
- *                     end:      Sheet.column.date(JobType, { header: "End", sub: "start + days", width: "96px", base: "start", fill: [endFromStart] }),
- *                     qty:      Sheet.column.quantity(JobType, ActivityType, { header: "Qty", sub: "uom per activity", width: "112px", uom: d => d.uom }),
- *                     machines: Sheet.column.set(JobType, "machines", { header: "Machines", sub: "M2140 · 2 x lathe · line 2", width: "240px",
- *                                   members: [{ kind: "machine", identified: true }, { kind: "line", countable: true, resolvesTo: "machine" },
- *                                             { kind: "family", countable: true, resolvesTo: "machine" }] }),
- *                 }}
- *                 newRow={newJob}
- *                 onUpdate={jobs.write}
- *             />
- *         );
- *     }}</Reactive>
- * ));
- * ```
- */
-export declare function createDriver<D extends StructType>(column: string, data: SubtypeExprOrValue<ArrayType<D>>, config: SheetDriverConfig<D>): SheetDriverValue;
-//# sourceMappingURL=registers.d.ts.map

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

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