@elaraai/e3-ui 1.0.86 → 1.0.87

package/dist/src/schedule/patch.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Schedule.patch(R, { … })` (#1195): what a card dropped on an event sets —
+ * a patch over an event kind's row type, every field an `Option`, the fields
+ * it leaves out `none`. It is built as the Sheet's `Sheet.patch` is. A
+ * builder's library tab returns one from its `drop` (`Plan.library.tab`), and
+ * the patch's type names the event kind whose events take the drop.
+ *
+ * @packageDocumentation
+ */
+import { OptionType, StructType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+/**
+ * The TS type of `Schedule.Types.Patch(R)`: every field of `R` as an `Option`.
+ *
+ * @typeParam R - The event kind's row type
+ */
+export type SchedulePatchOf<R extends StructType> = StructType<{
+    [K in keyof R["fields"]]: OptionType<R["fields"][K]>;
+}>;
+/**
+ * The literal-record input of `Schedule.patch(R, …)`: every field of `R`
+ * optional, each a literal or an expression of the field's type; a field left
+ * out is `none`.
+ *
+ * @typeParam R - The event kind's row type
+ */
+export type SchedulePatchInput<R extends StructType> = {
+    [K in keyof R["fields"]]?: SubtypeExprOrValue<R["fields"][K]>;
+};
+/**
+ * `Schedule.Types.Patch(R)`: a patch over an event kind's row type — every
+ * field of `R` as an `Option`, `none` leaving the event's field as it is.
+ *
+ * @typeParam R - The event kind's row type
+ * @param rowType - The row type value
+ * @returns The patch type
+ */
+export declare function SchedulePatchTypeFor<R extends StructType>(rowType: R): SchedulePatchOf<R>;
+/**
+ * Builds a patch over an event kind's row type — `Schedule.patch(R, { … })`:
+ * the fields it sets, every other field `none`. A library card's `drop`
+ * returns one, the fields a card dropped on an event sets
+ * (`Plan.library.tab`).
+ *
+ * @typeParam R - The event kind's row type
+ * @param rowType - The row type value
+ * @param record - The fields to set
+ * @returns An expression of `Schedule.Types.Patch(R)`
+ *
+ * @example
+ * ```tsx
+ * import { DateTimeType, DictType, OptionType, StringType, StructType } from "@elaraai/east";
+ * import { Plan, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * const JobType = StructType({
+ *     title: StringType, start: OptionType(DateTimeType), end: OptionType(DateTimeType),
+ *     press: OptionType(StringType), customer: StringType,
+ * });
+ * const CustomerType = StructType({ name: StringType, town: StringType });
+ * const customers = e3.record("customers", DictType(StringType, CustomerType), new Map());
+ *
+ * // Inside a Plan's Reactive body: a card per customer, which sets the job it is dropped on.
+ * const customerTab = Plan.library.tab(Record.bind(customers, []).read(), {
+ *     name: "Customers", icon: "building", label: (c) => c.name,
+ *     drop: (c) => Schedule.patch(JobType, { customer: c.name }),
+ * });
+ * ```
+ */
+export declare function schedulePatch<R extends StructType>(rowType: R, record: SchedulePatchInput<R>): ExprType<SchedulePatchOf<R>>;
+//# sourceMappingURL=patch.d.ts.map

package/dist/src/schedule/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/schedule/patch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAQ,UAAU,EAAE,UAAU,EAA6B,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhI;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,UAAU,IAAI,UAAU,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAAC;AAEzH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,UAAU,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEzH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAIzF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAO3H"}

package/dist/src/schedule/patch.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Schedule.patch(R, { … })` (#1195): what a card dropped on an event sets —
+ * a patch over an event kind's row type, every field an `Option`, the fields
+ * it leaves out `none`. It is built as the Sheet's `Sheet.patch` is. A
+ * builder's library tab returns one from its `drop` (`Plan.library.tab`), and
+ * the patch's type names the event kind whose events take the drop.
+ *
+ * @packageDocumentation
+ */
+import { East, OptionType, StructType, none, some } from "@elaraai/east";
+/**
+ * `Schedule.Types.Patch(R)`: a patch over an event kind's row type — every
+ * field of `R` as an `Option`, `none` leaving the event's field as it is.
+ *
+ * @typeParam R - The event kind's row type
+ * @param rowType - The row type value
+ * @returns The patch type
+ */
+export function SchedulePatchTypeFor(rowType) {
+    const fields = {};
+    for (const [name, type] of Object.entries(rowType.fields))
+        fields[name] = OptionType(type);
+    return StructType(fields);
+}
+/**
+ * Builds a patch over an event kind's row type — `Schedule.patch(R, { … })`:
+ * the fields it sets, every other field `none`. A library card's `drop`
+ * returns one, the fields a card dropped on an event sets
+ * (`Plan.library.tab`).
+ *
+ * @typeParam R - The event kind's row type
+ * @param rowType - The row type value
+ * @param record - The fields to set
+ * @returns An expression of `Schedule.Types.Patch(R)`
+ *
+ * @example
+ * ```tsx
+ * import { DateTimeType, DictType, OptionType, StringType, StructType } from "@elaraai/east";
+ * import { Plan, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * const JobType = StructType({
+ *     title: StringType, start: OptionType(DateTimeType), end: OptionType(DateTimeType),
+ *     press: OptionType(StringType), customer: StringType,
+ * });
+ * const CustomerType = StructType({ name: StringType, town: StringType });
+ * const customers = e3.record("customers", DictType(StringType, CustomerType), new Map());
+ *
+ * // Inside a Plan's Reactive body: a card per customer, which sets the job it is dropped on.
+ * const customerTab = Plan.library.tab(Record.bind(customers, []).read(), {
+ *     name: "Customers", icon: "building", label: (c) => c.name,
+ *     drop: (c) => Schedule.patch(JobType, { customer: c.name }),
+ * });
+ * ```
+ */
+export function schedulePatch(rowType, record) {
+    const fields = {};
+    const given = record;
+    for (const name of Object.keys(rowType.fields)) {
+        fields[name] = given[name] !== undefined ? some(given[name]) : none;
+    }
+    return East.value(fields, SchedulePatchTypeFor(rowType));
+}
+//# sourceMappingURL=patch.js.map

package/dist/src/schedule/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/schedule/patch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAyD,MAAM,eAAe,CAAC;AAkBhI;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAuB,OAAU;IACjE,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAkC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACvH,OAAO,UAAU,CAAC,MAAM,CAAkC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAAuB,OAAU,EAAE,MAA6B;IACzF,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAiC,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAkC,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxG,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAiC,CAAC;AACtG,CAAC"}

package/dist/src/schedule/record-window.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Schedule's typed adapter to record Slice's indexed queries. */
+import { ArrayType, DateTimeType, DictType, FunctionType, IntegerType, OptionType, StringType, StructType, type EastType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+/** Minimal typed query reader; additional index-entry fields remain opaque. */
+export declare function ScheduleRecordSliceType<K extends EastType, R extends EastType>(key: K, row: R): StructType<{
+    readonly data: StructType<{
+        readonly id: StringType;
+        readonly revision: FunctionType<[], OptionType<StringType>>;
+    }>;
+    readonly pageWhere: FunctionType<[DictType<StringType, import("@elaraai/east").VariantType<{
+        readonly values: ArrayType<StringType>;
+        readonly range: StructType<{
+            readonly from: StringType;
+            readonly to: StringType;
+        }>;
+        readonly prefix: StringType;
+    }>>, IntegerType, IntegerType], OptionType<ArrayType<StructType<{
+        readonly key: K;
+        readonly row: OptionType<R>;
+    }>>>>;
+    readonly key: StringType;
+    readonly config: StructType<{
+        readonly fields: ArrayType<StructType<{
+            readonly fieldId: StringType;
+            readonly label: StringType;
+            readonly kind: StringType;
+            readonly optional: import("@elaraai/east").BooleanType;
+            readonly multiple: import("@elaraai/east").BooleanType;
+            readonly set: import("@elaraai/east").BooleanType;
+            readonly values: ArrayType<StructType<{
+                readonly value: StringType;
+                readonly label: StringType;
+            }>>;
+            readonly format: OptionType<import("@elaraai/east").VariantType<{
+                readonly number: import("@elaraai/east").NullType;
+                readonly currency: StructType<{
+                    readonly code: StringType;
+                    readonly compact: import("@elaraai/east").BooleanType;
+                }>;
+                readonly percent: import("@elaraai/east").NullType;
+                readonly compact: import("@elaraai/east").NullType;
+                readonly date: StringType;
+                readonly time: StringType;
+                readonly datetime: StringType;
+            }>>;
+        }>>;
+        readonly indexes: ArrayType<StructType<{
+            readonly name: StringType;
+            readonly fields: ArrayType<StringType>;
+            readonly sets: import("@elaraai/east").SetType<StringType>;
+            readonly structured: import("@elaraai/east").BooleanType;
+            readonly interval: OptionType<StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+                readonly optional: import("@elaraai/east").BooleanType;
+            }>>;
+        }>>;
+        readonly range: OptionType<StringType>;
+        readonly search: ArrayType<StringType>;
+        readonly presets: ArrayType<StructType<{
+            readonly id: StringType;
+            readonly name: StringType;
+            readonly where: DictType<StringType, import("@elaraai/east").VariantType<{
+                readonly values: ArrayType<StringType>;
+                readonly range: StructType<{
+                    readonly from: StringType;
+                    readonly to: StringType;
+                }>;
+                readonly prefix: StringType;
+            }>>;
+        }>>;
+    }>;
+    readonly read: FunctionType<[], StructType<{
+        readonly where: DictType<StringType, import("@elaraai/east").VariantType<{
+            readonly values: ArrayType<StringType>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly prefix: StringType;
+        }>>;
+        readonly preset: OptionType<StringType>;
+        readonly resolution: OptionType<import("@elaraai/east").VariantType<{
+            readonly auto: import("@elaraai/east").NullType;
+            readonly hour: import("@elaraai/east").NullType;
+            readonly day: import("@elaraai/east").NullType;
+            readonly week: import("@elaraai/east").NullType;
+            readonly month: import("@elaraai/east").NullType;
+            readonly quarter: import("@elaraai/east").NullType;
+            readonly year: import("@elaraai/east").NullType;
+        }>>;
+    }>>;
+    readonly write: FunctionType<[StructType<{
+        readonly where: DictType<StringType, import("@elaraai/east").VariantType<{
+            readonly values: ArrayType<StringType>;
+            readonly range: StructType<{
+                readonly from: StringType;
+                readonly to: StringType;
+            }>;
+            readonly prefix: StringType;
+        }>>;
+        readonly preset: OptionType<StringType>;
+        readonly resolution: OptionType<import("@elaraai/east").VariantType<{
+            readonly auto: import("@elaraai/east").NullType;
+            readonly hour: import("@elaraai/east").NullType;
+            readonly day: import("@elaraai/east").NullType;
+            readonly week: import("@elaraai/east").NullType;
+            readonly month: import("@elaraai/east").NullType;
+            readonly quarter: import("@elaraai/east").NullType;
+            readonly year: import("@elaraai/east").NullType;
+        }>>;
+    }>], import("@elaraai/east").NullType>;
+    readonly choose: FunctionType<[StringType, ArrayType<StringType>], import("@elaraai/east").NullType>;
+    readonly range: FunctionType<[StringType, StringType, StringType], import("@elaraai/east").NullType>;
+    readonly prefix: FunctionType<[StringType, StringType], import("@elaraai/east").NullType>;
+    readonly clear: FunctionType<[StringType], import("@elaraai/east").NullType>;
+    readonly clearAll: FunctionType<[], import("@elaraai/east").NullType>;
+    readonly count: FunctionType<[], OptionType<IntegerType>>;
+    readonly countWhere: FunctionType<[DictType<StringType, import("@elaraai/east").VariantType<{
+        readonly values: ArrayType<StringType>;
+        readonly range: StructType<{
+            readonly from: StringType;
+            readonly to: StringType;
+        }>;
+        readonly prefix: StringType;
+    }>>], OptionType<IntegerType>>;
+    readonly total: FunctionType<[], OptionType<IntegerType>>;
+    readonly domain: FunctionType<[StringType], OptionType<StructType<{
+        readonly from: StringType;
+        readonly to: StringType;
+    }>>>;
+    readonly values: FunctionType<[StringType], ArrayType<StructType<{
+        readonly value: StringType;
+        readonly label: StringType;
+        readonly count: OptionType<IntegerType>;
+        readonly selected: import("@elaraai/east").BooleanType;
+        readonly error: OptionType<StringType>;
+    }>>>;
+    readonly suggest: FunctionType<[StringType, StringType], OptionType<ArrayType<StructType<{
+        readonly value: StringType;
+        readonly label: StringType;
+        readonly count: OptionType<IntegerType>;
+        readonly selected: import("@elaraai/east").BooleanType;
+        readonly error: OptionType<StringType>;
+    }>>>>;
+    readonly replaces: FunctionType<[StringType], ArrayType<StringType>>;
+    readonly togglePreset: FunctionType<[StringType], import("@elaraai/east").NullType>;
+    readonly setResolution: FunctionType<[OptionType<import("@elaraai/east").VariantType<{
+        readonly auto: import("@elaraai/east").NullType;
+        readonly hour: import("@elaraai/east").NullType;
+        readonly day: import("@elaraai/east").NullType;
+        readonly week: import("@elaraai/east").NullType;
+        readonly month: import("@elaraai/east").NullType;
+        readonly quarter: import("@elaraai/east").NullType;
+        readonly year: import("@elaraai/east").NullType;
+    }>>], import("@elaraai/east").NullType>;
+    readonly retry: FunctionType<[], import("@elaraai/east").NullType>;
+    readonly sourceId: StringType;
+    readonly readEntry: FunctionType<[StringType], OptionType<OptionType<import("@elaraai/east").BlobType>>>;
+    readonly contains: FunctionType<[DictType<StringType, import("@elaraai/east").VariantType<{
+        readonly values: ArrayType<StringType>;
+        readonly range: StructType<{
+            readonly from: StringType;
+            readonly to: StringType;
+        }>;
+        readonly prefix: StringType;
+    }>>, StringType], OptionType<import("@elaraai/east").BooleanType>>;
+}>;
+/** A record Slice over the event record's original key and row types. */
+export type ScheduleRecordSlice<K extends EastType, R extends EastType> = SubtypeExprOrValue<ReturnType<typeof ScheduleRecordSliceType<K, R>>>;
+/**
+ * Read a visible interval or backlog through the same declared Slice paths.
+ * This reads only the chosen result, in bounded pages. Index bounds own all
+ * membership and distinct counts; no row predicate implements narrowing.
+ * @param input - The author's typed Slice handle.
+ * @param key - Original record key type.
+ * @param row - Record row type.
+ * @param start - Interval start field.
+ * @param end - Interval end field (the same field for an instant).
+ * @param optional - Whether the time fields admit backlog rows.
+ * @param backlog - Read Unset starts instead of a scheduled interval.
+ * @param label - Kind name used by authoring errors.
+ * @returns A window reader compatible with the existing Schedule seams.
+ */
+export declare function scheduleRecordWindow(input: unknown, key: EastType, row: EastType, start: string, end: string, optional: boolean, backlog: boolean, label: string): ExprType<FunctionType<[DateTimeType, DateTimeType], OptionType<DictType<EastType, EastType>>>>;
+//# sourceMappingURL=record-window.d.ts.map

package/dist/src/schedule/record-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-window.d.ts","sourceRoot":"","sources":["../../../src/schedule/record-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kEAAkE;AAClE,OAAO,EACH,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAc,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAC/D,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EACrG,MAAM,eAAe,CAAC;AAGvB,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAM7F;AACD,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,QAAQ,IAAI,kBAAkB,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/I;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EACzG,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAgEtJ"}

package/dist/src/schedule/record-window.js

@@ -0,0 +1,95 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Schedule's typed adapter to record Slice's indexed queries. */
+import { ArrayType, DateTimeType, DictType, East, Expr, FunctionType, IntegerType, OptionType, StringType, StructType, isSubtype, isTypeEqual, none, some, variant, } from "@elaraai/east";
+import { RecordSliceBindType, RecordSliceChoiceType, RecordSliceWhereType, recordSliceReadPlatform } from "@elaraai/east-ui/internal";
+/** Minimal typed query reader; additional index-entry fields remain opaque. */
+export function ScheduleRecordSliceType(key, row) {
+    return StructType({ ...RecordSliceBindType.fields,
+        data: StructType({ id: StringType, revision: FunctionType([], OptionType(StringType)) }),
+        pageWhere: FunctionType([RecordSliceWhereType, IntegerType, IntegerType], OptionType(ArrayType(StructType({ key, row: OptionType(row) })))),
+    });
+}
+/**
+ * Read a visible interval or backlog through the same declared Slice paths.
+ * This reads only the chosen result, in bounded pages. Index bounds own all
+ * membership and distinct counts; no row predicate implements narrowing.
+ * @param input - The author's typed Slice handle.
+ * @param key - Original record key type.
+ * @param row - Record row type.
+ * @param start - Interval start field.
+ * @param end - Interval end field (the same field for an instant).
+ * @param optional - Whether the time fields admit backlog rows.
+ * @param backlog - Read Unset starts instead of a scheduled interval.
+ * @param label - Kind name used by authoring errors.
+ * @returns A window reader compatible with the existing Schedule seams.
+ */
+export function scheduleRecordWindow(input, key, row, start, end, optional, backlog, label) {
+    const value = East.value(input);
+    const Type = ScheduleRecordSliceType(key, row);
+    const type = Expr.type(value);
+    const fields = type.type === "Struct" ? type.fields : {};
+    const data = fields.data;
+    const page = fields.pageWhere;
+    const output = page?.type === "Function" ? page.output : undefined;
+    const collection = output?.type === "Variant" ? output.cases.some : undefined;
+    const entry = collection?.type === "Array" ? collection.value : undefined;
+    const fits = page?.type === "Function" && page.inputs.length === Type.fields.pageWhere.inputs.length
+        && page.inputs.every((input, i) => isTypeEqual(input, Type.fields.pageWhere.inputs[i]))
+        && entry?.type === "Struct" && entry.fields.key !== undefined && entry.fields.row !== undefined
+        && isTypeEqual(entry.fields.key, key) && isTypeEqual(entry.fields.row, OptionType(row))
+        && data?.type === "Struct"
+        && Object.entries(Type.fields.data.fields).every(([name, expected]) => data.fields[name] !== undefined && isSubtype(data.fields[name], expected))
+        && Object.entries(RecordSliceBindType.fields).every(([name, expected]) => fields[name] !== undefined && isSubtype(fields[name], expected));
+    if (!fits)
+        throw new Error(`${label}: slice must be Slice.bindRecord over this event record with joined rows`);
+    const source = value;
+    const Held = DictType(key, row);
+    return East.function([DateTimeType, DateTimeType], OptionType(Held), ($, from, to) => {
+        const src = $.const(source);
+        $.if(src.config.range.match({ none: () => true, some: (_$2, field) => field.notEqual(start) }), $2 => {
+            $2.error(`${label}: set the record Slice range to '${start}' so navigation and filters share one window`);
+        });
+        const supported = $.let(false);
+        $.for(src.config.indexes, ($2, index) => {
+            $2.match(index.interval, { some: ($3, interval) => {
+                    $3.if(interval.from.equal(start).and(() => interval.to.equal(end)), $4 => { $4.assign(supported, true); });
+                } });
+        });
+        $.if(supported.not(), $2 => { $2.error(`${label}: declare an interval index for ${start} and ${end} to preserve overlapping events`); });
+        const where = $.let(new Map(), RecordSliceWhereType);
+        const state = $.const(src.read());
+        $.for(state.where, ($2, choice, field) => {
+            $2.if(field.notEqual(start), $3 => { $3(where.insert(field, choice)); });
+        });
+        const time = $.let(backlog ? variant("values", [East.print(East.value(none, OptionType(DateTimeType)))])
+            : variant("range", { from: East.print(optional ? East.value(some(from), OptionType(DateTimeType)) : from),
+                to: East.print(optional ? East.value(some(to), OptionType(DateTimeType)) : to) }), RecordSliceChoiceType);
+        if (!backlog) {
+            $.match(state.where.tryGet(start), { some: ($2, choice) => {
+                    $2.match(choice, { values: ($3, values) => { $3.assign(time, variant("values", values)); } });
+                } });
+        }
+        $(where.insert(start, time));
+        const result = $.let(none, OptionType(Held));
+        // Preserve the actual window's wire type (including its index key and
+        // covering value); only the two validated entry fields are inspected.
+        const Entries = collection;
+        $.match(recordSliceReadPlatform([Entries], src.data.id, src.data.revision, src.countWhere, src.pageWhere, where), {
+            some: ($2, entries) => {
+                const held = $2.let(new Map(), Held);
+                $2.for(entries, ($3, entry) => {
+                    $3.match(entry.row, {
+                        none: $4 => { $4.error(`${label}: slice requires Data.bindPaged with join: true`); },
+                        some: ($4, value) => { $4(held.insert(entry.key, value)); },
+                    });
+                });
+                $2.assign(result, some(held));
+            },
+        });
+        return result;
+    });
+}
+//# sourceMappingURL=record-window.js.map

package/dist/src/schedule/record-window.js.map

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

package/dist/src/schedule/resources.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Schedule.resources(source, config)` (#1218, `Calendar Spec.md` §4.2): one
+ * resource kind — people, presses, sites — read from any `Dict<K, R>`, usually
+ * a record's `read()`, or a window at a time from a paged read of one. A
+ * schedule never writes them: their keys are what an event's resource field
+ * holds.
+ *
+ * Plan's options sit beside the Calendar's (#1190, `Plan Builder Spec.md`
+ * §4.2): the group strip a resource sits under, the resource of its kind it
+ * nests under, its gutter (sub line, value slot and status dot), how a
+ * parent's bands roll up and whether it starts folded, and the read-only
+ * series under each resource (`measures`). The Calendar takes no notice of
+ * them: `build(slot)` is its kind, and `buildPlan(slot)` Plan's.
+ *
+ * A kind given its resources as a paged read — `Data.bindPaged(record)`, told
+ * from a `Dict` by its East type, as the Plan's `data` is (#1199, PB55) — is
+ * paged on a Plan as a paged canvas pages its blocks: its rows come a window
+ * of resources at a time as the canvas scrolls, the key search seeks a
+ * resource by its key, and one resource is read by its key — its name where an
+ * event names it — so its resources are never read whole, and the kind on the
+ * wire lists none. A window comes in the resources' key order, so a group
+ * strip or a parent, which gather resources from anywhere in it, are refused
+ * beside one, and the keys are Strings, as the canvas seeks them. The Calendar
+ * reads a kind's resources whole, and refuses a paged one.
+ *
+ * @packageDocumentation
+ */
+import { BooleanType, DictType, FunctionType, OptionType, StringType, type EastType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import { StatusValueType } from "@elaraai/east-ui";
+import type { PagedValue } from "../bind/data.js";
+import { type PlanSeriesValue } from "../plan/series.js";
+import { PlanRollupType, type PlanAxisKindLiteral, type PlanRollupLiteral } from "../plan/types.js";
+import { PlanResourceRowType, PlanResourcesType, ScheduleResourcesType } from "./types.js";
+/** The key a schedule's definitions carry their sort under. */
+export declare const SCHEDULE_DEF: unique symbol;
+/**
+ * How a resource kind shows.
+ *
+ * @typeParam K - The kind's key type
+ * @typeParam R - Its row type
+ */
+export interface ScheduleResourcesConfig<K extends EastType, R extends EastType> {
+    /** The kind's name: its column and row headers, the timeline's group, the filter. */
+    name: string;
+    /** Its Font Awesome icon. */
+    icon: string;
+    /** A resource's name. */
+    label: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<StringType>;
+    /** A resource's second line. */
+    meta?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<OptionType<StringType>>;
+    /** Plan: the group strip a resource sits under (a hall), which the grain folds to its summary. */
+    group?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<StringType>;
+    /** Plan: the key's text of the resource of its kind it nests under, whose bands roll its events up; `none` at the top. */
+    parent?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<OptionType<StringType>>;
+    /** Plan: the gutter's sub line. */
+    sub?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<OptionType<StringType>>;
+    /** Plan: the gutter's value slot. */
+    value?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<OptionType<StringType>>;
+    /** Plan: the gutter's status dot. */
+    status?: (row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<OptionType<StatusValueType>>;
+    /** Plan: how a parent's bands roll its children's events up, as `Plan.series.span`'s (`"union"`, the default). */
+    rollup?: SubtypeExprOrValue<PlanRollupType> | PlanRollupLiteral;
+    /** Plan: whether a resource with resources under it starts folded — a constant, or per resource. */
+    collapsed?: boolean | ((row: ExprType<R>, key: ExprType<K>) => SubtypeExprOrValue<BooleanType>);
+    /** Plan: the read-only rows under each resource, in order — `Plan.series.heat`, `table` or `chart` over the resources' rows. */
+    measures?: readonly PlanSeriesValue<PlanAxisKindLiteral>[];
+}
+/**
+ * A resource kind, declared: what a builder's `resources` takes, by slot.
+ *
+ * @typeParam K - The kind's key type
+ * @typeParam R - Its row type
+ */
+export interface ScheduleResourceKind<K extends EastType, R extends EastType> {
+    /** What it is. */
+    readonly [SCHEDULE_DEF]: "resources";
+    /** The kind's key type: what an event's resource field must hold. */
+    readonly keyType: K;
+    /** Its row type. */
+    readonly rowType: R;
+    /** Its name. */
+    readonly name: string;
+    /** Its Font Awesome icon: what a builder's library lists the kind with (#1195). */
+    readonly icon: string;
+    /** Plan: the read-only series under each resource, in order. */
+    readonly measures: readonly PlanSeriesValue<PlanAxisKindLiteral>[];
+    /** Plan: the paged read of the resources, its rows a window at a time (#1199); `undefined` when they are read whole. */
+    readonly window: ExprType<EastType> | undefined;
+    /**
+     * Plan: the resources as the kind was given them, a `Dict` of `rowType` by
+     * `keyType` — read again where a Plan draws them (#1192); `undefined` for a
+     * kind paged a window at a time (#1199), whose resources are never read
+     * whole. Its type is erased, as `window`'s is, so a kind of any rows is one
+     * of any other.
+     */
+    readonly source: ExprType<DictType<EastType, EastType>> | undefined;
+    /** Plan: one resource as Plan's builder takes it, from its row and key: its label, group, parent and gutter. Erased, as `source` is. */
+    readonly planRow: ExprType<FunctionType<[EastType, EastType], PlanResourceRowType>>;
+    /** Plan: whether the kind's resources sit under group strips (`group`). */
+    readonly grouped: boolean;
+    /** Plan: whether a resource may nest under another of its kind (`parent`). */
+    readonly nested: boolean;
+    /** Plan: how a parent's bands roll its children's events up. */
+    readonly rollup: ExprType<PlanRollupType>;
+    /**
+     * The kind on the wire, under its slot: the Calendar's.
+     *
+     * @param slot - The builder's slot name for it
+     * @returns The kind, its rows resolved
+     * @throws {Error} For a kind paged a window at a time (#1199): the Calendar reads its resources whole
+     */
+    build(slot: string): ExprType<ScheduleResourcesType>;
+    /**
+     * The kind on the wire as Plan's builder takes it, under its slot.
+     *
+     * @param slot - The builder's slot name for it
+     * @returns The kind, its rows resolved with their groups, parents and gutters
+     */
+    buildPlan(slot: string): ExprType<PlanResourcesType>;
+}
+/**
+ * Declares a resource kind (see the module docs).
+ *
+ * @typeParam K - The kind's key type
+ * @typeParam R - Its row type
+ * @param rows - The resources, keyed: usually a record's `read()`
+ * @param config - Its name, its icon, each resource's label and second line, and Plan's options
+ * @returns The kind, for a builder's `resources`
+ * @throws {Error} When `rows` is not a `Dict`, or a paged read of one (#1199) keyed by anything but a String or
+ *   beside `group` or `parent`; a `window`, which is gone; a `rollup` that is not a way to roll up; and a measure that
+ *   is not a `Plan.series.heat`, `table` or `chart` over the resources' rows written in place, that nests, or whose
+ *   key another measure has
+ * @example
+ * ```tsx
+ * import { DictType, East, StringType, StructType, some } from "@elaraai/east";
+ * import { Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Calendar, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * const PressType = StructType({ name: StringType, hall: StringType });
+ * const presses = e3.record("presses", DictType(StringType, PressType), new Map());
+ *
+ * // Inside a builder's Reactive body: a row per press, its hall under its name.
+ * const press = Schedule.resources(Record.bind(presses, []).read(), {
+ *     name: "Presses", icon: "print", label: (p) => p.name, meta: (p) => some(p.hall),
+ * });
+ * ```
+ */
+export declare function scheduleResources<K extends EastType, R extends EastType>(rows: ExprType<DictType<K, R>>, config: ScheduleResourcesConfig<K, R>): ScheduleResourceKind<K, R>;
+/**
+ * Declares a resource kind paged a window at a time (#1199, see the module
+ * docs): its resources a paged read of their record, keyed by String.
+ *
+ * @typeParam R - Its row type
+ * @param rows - The resources, a window at a time: `Data.bindPaged(record)`
+ * @param config - Its name, its icon, each resource's label and second line, and Plan's options but `group` and `parent`
+ * @returns The kind, for a builder's `resources`
+ * @throws {Error} As the whole form does, naming the paged read
+ */
+export declare function scheduleResources<R extends EastType>(rows: PagedValue<DictType<StringType, R>>, config: ScheduleResourcesConfig<StringType, R>): ScheduleResourceKind<StringType, R>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/src/schedule/resources.d.ts.map

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