@elaraai/e3-ui 1.0.86 → 1.0.88

package/dist/src/plan/over.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Plan.over(data, [series…])` (#1191, `Plan Builder Spec.md` PB9): series
+ * over a dataset, read only, for a Plan's `rows` — a dataset's rows beside the
+ * event kinds, laid out as `data` and `series` lay a canvas out.
+ *
+ * A Plan's edits go through its event kinds' records, so a series here that
+ * declares `edit` is refused.
+ *
+ * @packageDocumentation
+ */
+import { type DictType, type EastType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import { PlanBlocksType, type PlanAxisKindLiteral, type PlanKinded } from "./types.js";
+import { type PlanSeriesFacts, type PlanSeriesValue } from "./series.js";
+import type { PlanBindHandle } from "./root.js";
+/**
+ * One series a `Plan.over` was given: what it is, and the keys its rows carry.
+ *
+ * @internal
+ */
+export interface PlanOverSeries {
+    /** Its facts: kind, key and title. */
+    readonly facts: PlanSeriesFacts;
+    /** The keys of its rows: its own, and every series' nested in it. */
+    readonly keys: readonly string[];
+}
+/**
+ * The series a `Plan.over` was given, in order — what a Plan's library lists
+ * in its Series tab, an eye apiece, and what hiding each hides (#1195).
+ *
+ * @param rows - One of a Plan's `rows`
+ * @returns The series; `undefined` for anything `Plan.over` did not return
+ * @internal
+ */
+export declare function overSeries(rows: unknown): readonly PlanOverSeries[] | undefined;
+/**
+ * The keys of the series a `Plan.over` laid out — what a Plan holds the keys
+ * it gives its own rows apart from (#1192).
+ *
+ * @param rows - One of a Plan's `rows`
+ * @returns Its series' keys, the series nested in them included; `undefined` for anything `Plan.over` did not return
+ * @internal
+ */
+export declare function overSeriesKeys(rows: unknown): readonly string[] | undefined;
+/**
+ * The blocks `Plan.over` makes: series over a dataset, read only, for a Plan's
+ * `rows` — branded with the axis kind its series ride.
+ *
+ * @typeParam K - The axis kind the series ride
+ */
+export type PlanOverRows<K extends PlanAxisKindLiteral = never> = PlanKinded<ExprType<PlanBlocksType>, K>;
+/**
+ * Lays series out over a dataset, read only, for a Plan's `rows`.
+ *
+ * @typeParam K - The axis kind the series ride
+ * @param data - The dataset: a keyed collection (`Data.bind(d).read()`), or a bind handle over one
+ * @param series - The `Plan.series.*` values over its entries, written in place — the list is the layout
+ * @returns The blocks, for a Plan's `rows`
+ * @throws {Error} When `data` is not a keyed collection; no series is given; a series is not a `Plan.series.*` value
+ *   written in place, is built over entries of another type, or declares `edit`; or two series share a key
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { ArrayType, DateTimeType, DictType, East, FloatType, NullType, OptionType, StringType, StructType, VariantType, some, variant } from "@elaraai/east";
+ * import { EventStateType, Format, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Data, Plan, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * export const PrintPress = StructType({ name: StringType, hall: StringType, sheets_per_hour: FloatType });
+ * export const PrintJob = StructType({
+ *     title: StringType,
+ *     start: OptionType(DateTimeType),
+ *     end: OptionType(DateTimeType),
+ *     press: OptionType(StringType),
+ *     state: EventStateType,
+ *     sheets: FloatType,
+ *     customer: StringType,
+ *     stock: VariantType({ coated: NullType, uncoated: NullType, board: NullType }),
+ *     due: OptionType(DateTimeType),
+ * });
+ * export const PrintStock = StructType({ name: StringType, weekly: ArrayType(FloatType) });
+ * export const PrintCentre = StructType({ name: StringType });
+ * export const PrintPlates = StructType({ title: StringType, at: DateTimeType, setter: StringType });
+ * export const PrintBinding = StructType({ title: StringType, start: DateTimeType, end: DateTimeType, line: StringType, state: EventStateType });
+ * export const PrintDelivery = StructType({ title: StringType, at: DateTimeType, bay: StringType });
+ * export const planPrintPresses = e3.record("plan_print_presses", DictType(StringType, PrintPress), new Map([
+ *     ["a1", { name: "Press A1", hall: "Hall A", sheets_per_hour: 12000.0 }],
+ *     ["a2", { name: "Press A2", hall: "Hall A", sheets_per_hour: 10000.0 }],
+ *     ["a3", { name: "Press A3", hall: "Hall A", sheets_per_hour: 8000.0 }],
+ *     ["b1", { name: "Press B1", hall: "Hall B", sheets_per_hour: 15000.0 }],
+ *     ["b2", { name: "Press B2", hall: "Hall B", sheets_per_hour: 12000.0 }],
+ *     ["b3", { name: "Press B3", hall: "Hall B", sheets_per_hour: 6000.0 }],
+ * ]));
+ * export const planLinkStock = e3.input("plan_link_stock", DictType(StringType, PrintStock), variant("value", new Map([
+ *     ["board", { name: "Board", weekly: [40.0, 22.0, 31.0, 18.0] }],
+ *     ["coated", { name: "Coated", weekly: [520.0, 410.0, 460.0, 380.0] }],
+ *     ["uncoated", { name: "Uncoated", weekly: [300.0, 260.0, 280.0, 240.0] }],
+ * ])));
+ * export const planLinkSetters = e3.record("plan_link_setters", DictType(StringType, PrintCentre), new Map([
+ *     ["ps", { name: "Platesetter" }],
+ * ]));
+ * export const planLinkLines = e3.record("plan_link_lines", DictType(StringType, PrintCentre), new Map([
+ *     ["fold", { name: "Folder" }],
+ *     ["bind", { name: "Binder" }],
+ * ]));
+ * export const planLinkBays = e3.record("plan_link_bays", DictType(StringType, PrintCentre), new Map([
+ *     ["bay", { name: "Dispatch bay" }],
+ * ]));
+ * export const planLinkPlates = e3.record("plan_link_plates", DictType(StringType, PrintPlates), new Map([
+ *     ["P-01", { title: "Catalogue plates", at: new Date("2026-10-05T12:00:00Z"), setter: "ps" }],
+ * ]));
+ * export const planLinkPlatesPatch = e3.mutation.patch(planLinkPlates);
+ * export const planLinkCaseJobs = e3.record("plan_link_case_jobs", DictType(StringType, PrintJob), new Map([
+ *     ["J-2001", { title: "Catalogue covers", start: some(new Date("2026-10-08T06:00:00Z")), end: some(new Date("2026-10-08T08:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 12000.0, customer: "Larkspur Home", stock: variant("board", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-2002", { title: "Shop posters", start: some(new Date("2026-10-10T06:00:00Z")), end: some(new Date("2026-10-11T06:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 24000.0, customer: "Orchard Street Market", stock: variant("uncoated", null), due: some(new Date("2026-10-20T00:00:00Z")) }],
+ *     ["J-2003", { title: "Catalogue inserts", start: some(new Date("2026-10-15T06:00:00Z")), end: some(new Date("2026-10-17T18:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 96000.0, customer: "Larkspur Home", stock: variant("coated", null), due: some(new Date("2026-10-19T00:00:00Z")) }],
+ *     ["J-2004", { title: "Price lists", start: some(new Date("2026-10-07T12:00:00Z")), end: some(new Date("2026-10-08T18:00:00Z")), press: some("a2"), state: variant("confirmed", null), sheets: 16000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-2005", { title: "Menu cards", start: some(new Date("2026-10-11T06:00:00Z")), end: some(new Date("2026-10-11T18:00:00Z")), press: some("a2"), state: variant("confirmed", null), sheets: 30000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-13T00:00:00Z")) }],
+ *     ["J-2006", { title: "Gift tags", start: some(new Date("2026-10-25T06:00:00Z")), end: some(new Date("2026-10-25T18:00:00Z")), press: some("a2"), state: variant("proposed", variant("recommended", null)), sheets: 20000.0, customer: "Juniper Toys", stock: variant("board", null), due: some(new Date("2026-10-28T00:00:00Z")) }],
+ *     ["J-2007", { title: "Gift boxes", start: some(new Date("2026-10-27T06:00:00Z")), end: some(new Date("2026-10-27T14:00:00Z")), press: some("a2"), state: variant("proposed", variant("recommended", null)), sheets: 48000.0, customer: "Juniper Toys", stock: variant("board", null), due: some(new Date("2026-10-30T00:00:00Z")) }],
+ *     ["J-2008", { title: "Proof run", start: some(new Date("2026-10-02T06:00:00Z")), end: some(new Date("2026-10-05T18:00:00Z")), press: some("a3"), state: variant("actual", null), sheets: 16000.0, customer: "Meridian Monthly", stock: variant("coated", null), due: some(new Date("2026-10-06T00:00:00Z")) }],
+ *     ["J-2009", { title: "Annual report", start: some(new Date("2026-10-19T18:00:00Z")), end: some(new Date("2026-10-21T06:00:00Z")), press: some("a3"), state: variant("confirmed", null), sheets: 48000.0, customer: "Harbour Arts Society", stock: variant("coated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-2010", { title: "Desk calendars", start: some(new Date("2026-10-28T06:00:00Z")), end: some(new Date("2026-10-29T06:00:00Z")), press: some("a3"), state: variant("proposed", variant("added", null)), sheets: 36000.0, customer: "Foxglove Gardens", stock: variant("board", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2011", { title: "Calendar pads", start: some(new Date("2026-10-29T06:00:00Z")), end: some(new Date("2026-10-30T18:00:00Z")), press: some("a3"), state: variant("proposed", variant("added", null)), sheets: 72000.0, customer: "Foxglove Gardens", stock: variant("uncoated", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2012", { title: "Proof sheets", start: some(new Date("2026-09-28T06:00:00Z")), end: some(new Date("2026-09-30T18:00:00Z")), press: some("b1"), state: variant("actual", null), sheets: 8000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-01T00:00:00Z")) }],
+ *     ["J-2013", { title: "Catalogue", start: some(new Date("2026-10-12T06:00:00Z")), end: some(new Date("2026-10-13T18:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 144000.0, customer: "Larkspur Home", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-2014", { title: "Seed catalogue", start: some(new Date("2026-10-22T06:00:00Z")), end: some(new Date("2026-10-23T12:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 100000.0, customer: "Foxglove Gardens", stock: variant("coated", null), due: some(new Date("2026-10-26T00:00:00Z")) }],
+ *     ["J-2015", { title: "Night run", start: some(new Date("2026-10-05T00:00:00Z")), end: some(new Date("2026-10-05T08:00:00Z")), press: some("b2"), state: variant("actual", null), sheets: 16000.0, customer: "Meridian Monthly", stock: variant("coated", null), due: some(new Date("2026-10-06T00:00:00Z")) }],
+ *     ["J-2016", { title: "Store flyers", start: some(new Date("2026-10-16T06:00:00Z")), end: some(new Date("2026-10-16T20:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 96000.0, customer: "Larkspur Home", stock: variant("uncoated", null), due: some(new Date("2026-10-19T00:00:00Z")) }],
+ *     ["J-2017", { title: "Seed packets", start: some(new Date("2026-10-23T06:00:00Z")), end: some(new Date("2026-10-24T06:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 72000.0, customer: "Foxglove Gardens", stock: variant("board", null), due: some(new Date("2026-10-27T00:00:00Z")) }],
+ *     ["J-2018", { title: "Exhibition book", start: some(new Date("2026-10-26T06:00:00Z")), end: some(new Date("2026-10-27T18:00:00Z")), press: some("b2"), state: variant("proposed", variant("recommended", null)), sheets: 54000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-30T00:00:00Z")) }],
+ *     ["J-2019", { title: "Ticket books", start: some(new Date("2026-10-29T06:00:00Z")), end: some(new Date("2026-10-30T06:00:00Z")), press: some("b2"), state: variant("estimated", null), sheets: 60000.0, customer: "Heathfield Theatre", stock: variant("uncoated", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2020", { title: "Card stock", start: some(new Date("2026-10-06T06:00:00Z")), end: some(new Date("2026-10-06T14:00:00Z")), press: some("b3"), state: variant("actual", null), sheets: 30000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-08T00:00:00Z")) }],
+ *     ["J-2021", { title: "Book sections", start: some(new Date("2026-10-11T06:00:00Z")), end: some(new Date("2026-10-12T12:00:00Z")), press: some("b3"), state: variant("confirmed", null), sheets: 84000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-14T00:00:00Z")) }],
+ *     ["J-2022", { title: "Report covers", start: some(new Date("2026-10-19T06:00:00Z")), end: some(new Date("2026-10-20T18:00:00Z")), press: some("b3"), state: variant("confirmed", null), sheets: 48000.0, customer: "Harbour Arts Society", stock: variant("board", null), due: some(new Date("2026-10-21T00:00:00Z")) }],
+ *     ["J-2023", { title: "Spring brochure", start: some(new Date("2026-11-03T06:00:00Z")), end: some(new Date("2026-11-04T18:00:00Z")), press: some("b3"), state: variant("estimated", null), sheets: 60000.0, customer: "Heathfield Theatre", stock: variant("coated", null), due: some(new Date("2026-11-09T00:00:00Z")) }],
+ * ]));
+ * export const planLinkCaseJobsPatch = e3.mutation.patch(planLinkCaseJobs);
+ * export const planLinkBindings = e3.record("plan_link_bindings", DictType(StringType, PrintBinding), new Map([
+ *     ["B-01", { title: "Fold sections", start: new Date("2026-10-15T06:00:00Z"), end: new Date("2026-10-16T06:00:00Z"), line: "fold", state: variant("confirmed", null) }],
+ *     ["B-02", { title: "Fold sections", start: new Date("2026-10-17T06:00:00Z"), end: new Date("2026-10-18T06:00:00Z"), line: "fold", state: variant("confirmed", null) }],
+ *     ["B-03", { title: "Bind books", start: new Date("2026-10-20T18:00:00Z"), end: new Date("2026-10-21T18:00:00Z"), line: "bind", state: variant("confirmed", null) }],
+ *     ["B-04", { title: "Bind exhibition book", start: new Date("2026-10-25T06:00:00Z"), end: new Date("2026-10-26T06:00:00Z"), line: "bind", state: variant("proposed", variant("recommended", null)) }],
+ * ]));
+ * export const planLinkBindingsPatch = e3.mutation.patch(planLinkBindings);
+ * export const planLinkDeliveries = e3.record("plan_link_deliveries", DictType(StringType, PrintDelivery), new Map([
+ *     ["D-01", { title: "Books", at: new Date("2026-10-28T10:00:00Z"), bay: "bay" }],
+ *     ["D-02", { title: "Posters", at: new Date("2026-10-20T10:00:00Z"), bay: "bay" }],
+ * ]));
+ * export const planLinkDeliveriesPatch = e3.mutation.patch(planLinkDeliveries);
+ *
+ * const planEventLinks = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const setters = $.let(Record.bind(planLinkSetters, []));
+ *         const presses = $.let(Record.bind(planPrintPresses, []));
+ *         const lines = $.let(Record.bind(planLinkLines, []));
+ *         const bays = $.let(Record.bind(planLinkBays, []));
+ *         const plates = $.let(Record.bind(planLinkPlates, [planLinkPlatesPatch]));
+ *         const jobs = $.let(Record.bind(planLinkCaseJobs, [planLinkCaseJobsPatch]));
+ *         const bindings = $.let(Record.bind(planLinkBindings, [planLinkBindingsPatch]));
+ *         const deliveries = $.let(Record.bind(planLinkDeliveries, [planLinkDeliveriesPatch]));
+ *         const stock = $.let(Data.bind(planLinkStock));
+ *         // The window's first Monday: each stock reading runs from it, a week apiece.
+ *         const first = $.const(new Date("2026-10-05T00:00:00Z"), DateTimeType);
+ *         const StockWeek = StructType({ at: DateTimeType, value: OptionType(FloatType) });
+ *         const weekly = $.const(East.function([ArrayType(FloatType)], ArrayType(StockWeek), (_$2, readings) =>
+ *             East.Array.generate(readings.size(), StockWeek, (_$3, i) => ({ at: first.addWeeks(i), value: some(readings.get(i)) }))));
+ *         const axis = $.let(Plan.axis({
+ *             window: { min: new Date("2026-10-05T00:00:00Z"), max: new Date("2026-11-02T00:00:00Z") },
+ *             resolution: "week", now: new Date("2026-10-14T09:00:00Z"),
+ *         }));
+ *         return (
+ *             <Plan
+ *                 axis={axis}
+ *                 resources={{
+ *                     setters: Schedule.resources(setters.read(), { name: "Plate room", icon: "layer-group", label: s => s.name }),
+ *                     presses: Schedule.resources(presses.read(), { name: "Presses", icon: "print", label: p => p.name, group: p => p.hall }),
+ *                     lines: Schedule.resources(lines.read(), { name: "Bindery", icon: "book", label: l => l.name }),
+ *                     bays: Schedule.resources(bays.read(), { name: "Dispatch", icon: "warehouse", label: b => b.name }),
+ *                 }}
+ *                 events={{
+ *                     plate: Schedule.events(plates, {
+ *                         name: "Plates", icon: "clone",
+ *                         title: "title", at: "at",
+ *                         resource: { field: "setter", of: "setters" },
+ *                     }),
+ *                     job: Schedule.events(jobs, {
+ *                         name: "Print job", icon: "file-lines",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "press", of: "presses" },
+ *                         state: "state", quantity: { field: "sheets", unit: "sheets" },
+ *                     }),
+ *                     binding: Schedule.events(bindings, {
+ *                         name: "Bindery job", icon: "book-open", draw: "cards",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "line", of: "lines" }, state: "state",
+ *                     }),
+ *                     delivery: Schedule.events(deliveries, {
+ *                         name: "Delivery", icon: "truck", draw: "buckets",
+ *                         title: "title", at: "at",
+ *                         resource: { field: "bay", of: "bays" },
+ *                     }),
+ *                 }}
+ *                 // The paper in stock: a table over a dataset, read only.
+ *                 rows={[
+ *                     Plan.over(stock, [
+ *                         Plan.series.table(PrintStock, {
+ *                             key: "stock", title: "Paper stock", label: s => s.name,
+ *                             cells: s => Plan.tableCells(weekly(s.weekly)),
+ *                             format: Format.Number({ maximumFractionDigits: 0n }),
+ *                         }),
+ *                     ]),
+ *                 ]}
+ *                 // Each quantity in thousands of sheets, its third of the family's largest setting the link's
+ *                 // weight; the plates' link carries none.
+ *                 links={[
+ *                     Plan.link({ key: "plates", from: Plan.eventRef("plate", "P-01"), to: Plan.eventRef("job", "J-2001") }),
+ *                     Plan.link({ key: "covers", from: Plan.eventRef("job", "J-2001"), to: Plan.eventRef("job", "J-2013"), quantity: Plan.quantity(12, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "card", from: Plan.eventRef("job", "J-2020"), to: Plan.eventRef("job", "J-2005"), quantity: Plan.quantity(30, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "inserts", from: Plan.eventRef("job", "J-2003"), to: Plan.eventRef("job", "J-2016"), quantity: Plan.quantity(96, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "report-covers", from: Plan.eventRef("job", "J-2022"), to: Plan.eventRef("job", "J-2009"), quantity: Plan.quantity(48, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "seed-prints", from: Plan.eventRef("job", "J-2014"), to: Plan.eventRef("job", "J-2017"), quantity: Plan.quantity(72, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "tags", from: Plan.eventRef("job", "J-2006"), to: Plan.eventRef("job", "J-2007"), quantity: Plan.quantity(20, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "pads", from: Plan.eventRef("job", "J-2010"), to: Plan.eventRef("job", "J-2011"), quantity: Plan.quantity(36, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "proofs", from: Plan.eventRef("job", "J-2008"), to: Plan.eventRef("job", "J-2015"), quantity: Plan.quantity(16, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "proof-sheets", from: Plan.eventRef("job", "J-2012"), to: Plan.eventRef("job", "J-2004"), quantity: Plan.quantity(8, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "tickets", from: Plan.eventRef("job", "J-2019"), to: Plan.eventRef("job", "J-2023"), quantity: Plan.quantity(60, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "sections", from: Plan.eventRef("job", "J-2021"), to: Plan.eventRef("binding", "B-01"), quantity: Plan.quantity(40, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "sections-more", from: Plan.eventRef("job", "J-2021"), to: Plan.eventRef("binding", "B-02"), quantity: Plan.quantity(44, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "folded", from: Plan.eventRef("binding", "B-02"), to: Plan.eventRef("binding", "B-03"), quantity: Plan.quantity(40, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "books", from: Plan.eventRef("binding", "B-03"), to: Plan.eventRef("delivery", "D-01"), quantity: Plan.quantity(36, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "posters", from: Plan.eventRef("job", "J-2002"), to: Plan.eventRef("delivery", "D-02"), quantity: Plan.quantity(24, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "book-blocks", from: Plan.eventRef("job", "J-2018"), to: Plan.eventRef("binding", "B-04"), quantity: Plan.quantity(54, { unit: "k sheets" }) }),
+ *                 ]}
+ *                 style={{ height: "400px" }}
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export declare function createOver<K extends PlanAxisKindLiteral = never>(data: SubtypeExprOrValue<DictType<EastType, EastType>> | PlanBindHandle, series: PlanSeriesValue<K>[]): PlanOverRows<K>;
+//# sourceMappingURL=over.d.ts.map

package/dist/src/plan/over.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"over.d.ts","sourceRoot":"","sources":["../../../src/plan/over.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC5H,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAA6D,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACpI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAKD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAE/E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAE3E;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,mBAAmB,GAAG,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8LG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,mBAAmB,GAAG,KAAK,EAC5D,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,cAAc,EACvE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,GAC7B,YAAY,CAAC,CAAC,CAAC,CA6BjB"}

package/dist/src/plan/over.js

@@ -0,0 +1,266 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Plan.over(data, [series…])` (#1191, `Plan Builder Spec.md` PB9): series
+ * over a dataset, read only, for a Plan's `rows` — a dataset's rows beside the
+ * event kinds, laid out as `data` and `series` lay a canvas out.
+ *
+ * A Plan's edits go through its event kinds' records, so a series here that
+ * declares `edit` is refused.
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, printType } from "@elaraai/east";
+import { PlanBlocksType } from "./types.js";
+import { applySeries, checkSeries, planSeriesFacts, planSeriesKeys } from "./series.js";
+/** The keys of the series each `Plan.over` laid out, by the blocks it returned. */
+const OVER_KEYS = new WeakMap();
+/** The series each `Plan.over` was given, in order, by the blocks it returned. */
+const OVER_SERIES = new WeakMap();
+/**
+ * The series a `Plan.over` was given, in order — what a Plan's library lists
+ * in its Series tab, an eye apiece, and what hiding each hides (#1195).
+ *
+ * @param rows - One of a Plan's `rows`
+ * @returns The series; `undefined` for anything `Plan.over` did not return
+ * @internal
+ */
+export function overSeries(rows) {
+    return typeof rows === "object" && rows !== null ? OVER_SERIES.get(rows) : undefined;
+}
+/**
+ * The keys of the series a `Plan.over` laid out — what a Plan holds the keys
+ * it gives its own rows apart from (#1192).
+ *
+ * @param rows - One of a Plan's `rows`
+ * @returns Its series' keys, the series nested in them included; `undefined` for anything `Plan.over` did not return
+ * @internal
+ */
+export function overSeriesKeys(rows) {
+    return typeof rows === "object" && rows !== null ? OVER_KEYS.get(rows) : undefined;
+}
+/**
+ * Lays series out over a dataset, read only, for a Plan's `rows`.
+ *
+ * @typeParam K - The axis kind the series ride
+ * @param data - The dataset: a keyed collection (`Data.bind(d).read()`), or a bind handle over one
+ * @param series - The `Plan.series.*` values over its entries, written in place — the list is the layout
+ * @returns The blocks, for a Plan's `rows`
+ * @throws {Error} When `data` is not a keyed collection; no series is given; a series is not a `Plan.series.*` value
+ *   written in place, is built over entries of another type, or declares `edit`; or two series share a key
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { ArrayType, DateTimeType, DictType, East, FloatType, NullType, OptionType, StringType, StructType, VariantType, some, variant } from "@elaraai/east";
+ * import { EventStateType, Format, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Data, Plan, Record, Schedule } from "@elaraai/e3-ui";
+ * import e3 from "@elaraai/e3";
+ *
+ * export const PrintPress = StructType({ name: StringType, hall: StringType, sheets_per_hour: FloatType });
+ * export const PrintJob = StructType({
+ *     title: StringType,
+ *     start: OptionType(DateTimeType),
+ *     end: OptionType(DateTimeType),
+ *     press: OptionType(StringType),
+ *     state: EventStateType,
+ *     sheets: FloatType,
+ *     customer: StringType,
+ *     stock: VariantType({ coated: NullType, uncoated: NullType, board: NullType }),
+ *     due: OptionType(DateTimeType),
+ * });
+ * export const PrintStock = StructType({ name: StringType, weekly: ArrayType(FloatType) });
+ * export const PrintCentre = StructType({ name: StringType });
+ * export const PrintPlates = StructType({ title: StringType, at: DateTimeType, setter: StringType });
+ * export const PrintBinding = StructType({ title: StringType, start: DateTimeType, end: DateTimeType, line: StringType, state: EventStateType });
+ * export const PrintDelivery = StructType({ title: StringType, at: DateTimeType, bay: StringType });
+ * export const planPrintPresses = e3.record("plan_print_presses", DictType(StringType, PrintPress), new Map([
+ *     ["a1", { name: "Press A1", hall: "Hall A", sheets_per_hour: 12000.0 }],
+ *     ["a2", { name: "Press A2", hall: "Hall A", sheets_per_hour: 10000.0 }],
+ *     ["a3", { name: "Press A3", hall: "Hall A", sheets_per_hour: 8000.0 }],
+ *     ["b1", { name: "Press B1", hall: "Hall B", sheets_per_hour: 15000.0 }],
+ *     ["b2", { name: "Press B2", hall: "Hall B", sheets_per_hour: 12000.0 }],
+ *     ["b3", { name: "Press B3", hall: "Hall B", sheets_per_hour: 6000.0 }],
+ * ]));
+ * export const planLinkStock = e3.input("plan_link_stock", DictType(StringType, PrintStock), variant("value", new Map([
+ *     ["board", { name: "Board", weekly: [40.0, 22.0, 31.0, 18.0] }],
+ *     ["coated", { name: "Coated", weekly: [520.0, 410.0, 460.0, 380.0] }],
+ *     ["uncoated", { name: "Uncoated", weekly: [300.0, 260.0, 280.0, 240.0] }],
+ * ])));
+ * export const planLinkSetters = e3.record("plan_link_setters", DictType(StringType, PrintCentre), new Map([
+ *     ["ps", { name: "Platesetter" }],
+ * ]));
+ * export const planLinkLines = e3.record("plan_link_lines", DictType(StringType, PrintCentre), new Map([
+ *     ["fold", { name: "Folder" }],
+ *     ["bind", { name: "Binder" }],
+ * ]));
+ * export const planLinkBays = e3.record("plan_link_bays", DictType(StringType, PrintCentre), new Map([
+ *     ["bay", { name: "Dispatch bay" }],
+ * ]));
+ * export const planLinkPlates = e3.record("plan_link_plates", DictType(StringType, PrintPlates), new Map([
+ *     ["P-01", { title: "Catalogue plates", at: new Date("2026-10-05T12:00:00Z"), setter: "ps" }],
+ * ]));
+ * export const planLinkPlatesPatch = e3.mutation.patch(planLinkPlates);
+ * export const planLinkCaseJobs = e3.record("plan_link_case_jobs", DictType(StringType, PrintJob), new Map([
+ *     ["J-2001", { title: "Catalogue covers", start: some(new Date("2026-10-08T06:00:00Z")), end: some(new Date("2026-10-08T08:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 12000.0, customer: "Larkspur Home", stock: variant("board", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-2002", { title: "Shop posters", start: some(new Date("2026-10-10T06:00:00Z")), end: some(new Date("2026-10-11T06:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 24000.0, customer: "Orchard Street Market", stock: variant("uncoated", null), due: some(new Date("2026-10-20T00:00:00Z")) }],
+ *     ["J-2003", { title: "Catalogue inserts", start: some(new Date("2026-10-15T06:00:00Z")), end: some(new Date("2026-10-17T18:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 96000.0, customer: "Larkspur Home", stock: variant("coated", null), due: some(new Date("2026-10-19T00:00:00Z")) }],
+ *     ["J-2004", { title: "Price lists", start: some(new Date("2026-10-07T12:00:00Z")), end: some(new Date("2026-10-08T18:00:00Z")), press: some("a2"), state: variant("confirmed", null), sheets: 16000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-2005", { title: "Menu cards", start: some(new Date("2026-10-11T06:00:00Z")), end: some(new Date("2026-10-11T18:00:00Z")), press: some("a2"), state: variant("confirmed", null), sheets: 30000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-13T00:00:00Z")) }],
+ *     ["J-2006", { title: "Gift tags", start: some(new Date("2026-10-25T06:00:00Z")), end: some(new Date("2026-10-25T18:00:00Z")), press: some("a2"), state: variant("proposed", variant("recommended", null)), sheets: 20000.0, customer: "Juniper Toys", stock: variant("board", null), due: some(new Date("2026-10-28T00:00:00Z")) }],
+ *     ["J-2007", { title: "Gift boxes", start: some(new Date("2026-10-27T06:00:00Z")), end: some(new Date("2026-10-27T14:00:00Z")), press: some("a2"), state: variant("proposed", variant("recommended", null)), sheets: 48000.0, customer: "Juniper Toys", stock: variant("board", null), due: some(new Date("2026-10-30T00:00:00Z")) }],
+ *     ["J-2008", { title: "Proof run", start: some(new Date("2026-10-02T06:00:00Z")), end: some(new Date("2026-10-05T18:00:00Z")), press: some("a3"), state: variant("actual", null), sheets: 16000.0, customer: "Meridian Monthly", stock: variant("coated", null), due: some(new Date("2026-10-06T00:00:00Z")) }],
+ *     ["J-2009", { title: "Annual report", start: some(new Date("2026-10-19T18:00:00Z")), end: some(new Date("2026-10-21T06:00:00Z")), press: some("a3"), state: variant("confirmed", null), sheets: 48000.0, customer: "Harbour Arts Society", stock: variant("coated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-2010", { title: "Desk calendars", start: some(new Date("2026-10-28T06:00:00Z")), end: some(new Date("2026-10-29T06:00:00Z")), press: some("a3"), state: variant("proposed", variant("added", null)), sheets: 36000.0, customer: "Foxglove Gardens", stock: variant("board", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2011", { title: "Calendar pads", start: some(new Date("2026-10-29T06:00:00Z")), end: some(new Date("2026-10-30T18:00:00Z")), press: some("a3"), state: variant("proposed", variant("added", null)), sheets: 72000.0, customer: "Foxglove Gardens", stock: variant("uncoated", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2012", { title: "Proof sheets", start: some(new Date("2026-09-28T06:00:00Z")), end: some(new Date("2026-09-30T18:00:00Z")), press: some("b1"), state: variant("actual", null), sheets: 8000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-01T00:00:00Z")) }],
+ *     ["J-2013", { title: "Catalogue", start: some(new Date("2026-10-12T06:00:00Z")), end: some(new Date("2026-10-13T18:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 144000.0, customer: "Larkspur Home", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-2014", { title: "Seed catalogue", start: some(new Date("2026-10-22T06:00:00Z")), end: some(new Date("2026-10-23T12:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 100000.0, customer: "Foxglove Gardens", stock: variant("coated", null), due: some(new Date("2026-10-26T00:00:00Z")) }],
+ *     ["J-2015", { title: "Night run", start: some(new Date("2026-10-05T00:00:00Z")), end: some(new Date("2026-10-05T08:00:00Z")), press: some("b2"), state: variant("actual", null), sheets: 16000.0, customer: "Meridian Monthly", stock: variant("coated", null), due: some(new Date("2026-10-06T00:00:00Z")) }],
+ *     ["J-2016", { title: "Store flyers", start: some(new Date("2026-10-16T06:00:00Z")), end: some(new Date("2026-10-16T20:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 96000.0, customer: "Larkspur Home", stock: variant("uncoated", null), due: some(new Date("2026-10-19T00:00:00Z")) }],
+ *     ["J-2017", { title: "Seed packets", start: some(new Date("2026-10-23T06:00:00Z")), end: some(new Date("2026-10-24T06:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 72000.0, customer: "Foxglove Gardens", stock: variant("board", null), due: some(new Date("2026-10-27T00:00:00Z")) }],
+ *     ["J-2018", { title: "Exhibition book", start: some(new Date("2026-10-26T06:00:00Z")), end: some(new Date("2026-10-27T18:00:00Z")), press: some("b2"), state: variant("proposed", variant("recommended", null)), sheets: 54000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-30T00:00:00Z")) }],
+ *     ["J-2019", { title: "Ticket books", start: some(new Date("2026-10-29T06:00:00Z")), end: some(new Date("2026-10-30T06:00:00Z")), press: some("b2"), state: variant("estimated", null), sheets: 60000.0, customer: "Heathfield Theatre", stock: variant("uncoated", null), due: some(new Date("2026-11-02T00:00:00Z")) }],
+ *     ["J-2020", { title: "Card stock", start: some(new Date("2026-10-06T06:00:00Z")), end: some(new Date("2026-10-06T14:00:00Z")), press: some("b3"), state: variant("actual", null), sheets: 30000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-08T00:00:00Z")) }],
+ *     ["J-2021", { title: "Book sections", start: some(new Date("2026-10-11T06:00:00Z")), end: some(new Date("2026-10-12T12:00:00Z")), press: some("b3"), state: variant("confirmed", null), sheets: 84000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-14T00:00:00Z")) }],
+ *     ["J-2022", { title: "Report covers", start: some(new Date("2026-10-19T06:00:00Z")), end: some(new Date("2026-10-20T18:00:00Z")), press: some("b3"), state: variant("confirmed", null), sheets: 48000.0, customer: "Harbour Arts Society", stock: variant("board", null), due: some(new Date("2026-10-21T00:00:00Z")) }],
+ *     ["J-2023", { title: "Spring brochure", start: some(new Date("2026-11-03T06:00:00Z")), end: some(new Date("2026-11-04T18:00:00Z")), press: some("b3"), state: variant("estimated", null), sheets: 60000.0, customer: "Heathfield Theatre", stock: variant("coated", null), due: some(new Date("2026-11-09T00:00:00Z")) }],
+ * ]));
+ * export const planLinkCaseJobsPatch = e3.mutation.patch(planLinkCaseJobs);
+ * export const planLinkBindings = e3.record("plan_link_bindings", DictType(StringType, PrintBinding), new Map([
+ *     ["B-01", { title: "Fold sections", start: new Date("2026-10-15T06:00:00Z"), end: new Date("2026-10-16T06:00:00Z"), line: "fold", state: variant("confirmed", null) }],
+ *     ["B-02", { title: "Fold sections", start: new Date("2026-10-17T06:00:00Z"), end: new Date("2026-10-18T06:00:00Z"), line: "fold", state: variant("confirmed", null) }],
+ *     ["B-03", { title: "Bind books", start: new Date("2026-10-20T18:00:00Z"), end: new Date("2026-10-21T18:00:00Z"), line: "bind", state: variant("confirmed", null) }],
+ *     ["B-04", { title: "Bind exhibition book", start: new Date("2026-10-25T06:00:00Z"), end: new Date("2026-10-26T06:00:00Z"), line: "bind", state: variant("proposed", variant("recommended", null)) }],
+ * ]));
+ * export const planLinkBindingsPatch = e3.mutation.patch(planLinkBindings);
+ * export const planLinkDeliveries = e3.record("plan_link_deliveries", DictType(StringType, PrintDelivery), new Map([
+ *     ["D-01", { title: "Books", at: new Date("2026-10-28T10:00:00Z"), bay: "bay" }],
+ *     ["D-02", { title: "Posters", at: new Date("2026-10-20T10:00:00Z"), bay: "bay" }],
+ * ]));
+ * export const planLinkDeliveriesPatch = e3.mutation.patch(planLinkDeliveries);
+ *
+ * const planEventLinks = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const setters = $.let(Record.bind(planLinkSetters, []));
+ *         const presses = $.let(Record.bind(planPrintPresses, []));
+ *         const lines = $.let(Record.bind(planLinkLines, []));
+ *         const bays = $.let(Record.bind(planLinkBays, []));
+ *         const plates = $.let(Record.bind(planLinkPlates, [planLinkPlatesPatch]));
+ *         const jobs = $.let(Record.bind(planLinkCaseJobs, [planLinkCaseJobsPatch]));
+ *         const bindings = $.let(Record.bind(planLinkBindings, [planLinkBindingsPatch]));
+ *         const deliveries = $.let(Record.bind(planLinkDeliveries, [planLinkDeliveriesPatch]));
+ *         const stock = $.let(Data.bind(planLinkStock));
+ *         // The window's first Monday: each stock reading runs from it, a week apiece.
+ *         const first = $.const(new Date("2026-10-05T00:00:00Z"), DateTimeType);
+ *         const StockWeek = StructType({ at: DateTimeType, value: OptionType(FloatType) });
+ *         const weekly = $.const(East.function([ArrayType(FloatType)], ArrayType(StockWeek), (_$2, readings) =>
+ *             East.Array.generate(readings.size(), StockWeek, (_$3, i) => ({ at: first.addWeeks(i), value: some(readings.get(i)) }))));
+ *         const axis = $.let(Plan.axis({
+ *             window: { min: new Date("2026-10-05T00:00:00Z"), max: new Date("2026-11-02T00:00:00Z") },
+ *             resolution: "week", now: new Date("2026-10-14T09:00:00Z"),
+ *         }));
+ *         return (
+ *             <Plan
+ *                 axis={axis}
+ *                 resources={{
+ *                     setters: Schedule.resources(setters.read(), { name: "Plate room", icon: "layer-group", label: s => s.name }),
+ *                     presses: Schedule.resources(presses.read(), { name: "Presses", icon: "print", label: p => p.name, group: p => p.hall }),
+ *                     lines: Schedule.resources(lines.read(), { name: "Bindery", icon: "book", label: l => l.name }),
+ *                     bays: Schedule.resources(bays.read(), { name: "Dispatch", icon: "warehouse", label: b => b.name }),
+ *                 }}
+ *                 events={{
+ *                     plate: Schedule.events(plates, {
+ *                         name: "Plates", icon: "clone",
+ *                         title: "title", at: "at",
+ *                         resource: { field: "setter", of: "setters" },
+ *                     }),
+ *                     job: Schedule.events(jobs, {
+ *                         name: "Print job", icon: "file-lines",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "press", of: "presses" },
+ *                         state: "state", quantity: { field: "sheets", unit: "sheets" },
+ *                     }),
+ *                     binding: Schedule.events(bindings, {
+ *                         name: "Bindery job", icon: "book-open", draw: "cards",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "line", of: "lines" }, state: "state",
+ *                     }),
+ *                     delivery: Schedule.events(deliveries, {
+ *                         name: "Delivery", icon: "truck", draw: "buckets",
+ *                         title: "title", at: "at",
+ *                         resource: { field: "bay", of: "bays" },
+ *                     }),
+ *                 }}
+ *                 // The paper in stock: a table over a dataset, read only.
+ *                 rows={[
+ *                     Plan.over(stock, [
+ *                         Plan.series.table(PrintStock, {
+ *                             key: "stock", title: "Paper stock", label: s => s.name,
+ *                             cells: s => Plan.tableCells(weekly(s.weekly)),
+ *                             format: Format.Number({ maximumFractionDigits: 0n }),
+ *                         }),
+ *                     ]),
+ *                 ]}
+ *                 // Each quantity in thousands of sheets, its third of the family's largest setting the link's
+ *                 // weight; the plates' link carries none.
+ *                 links={[
+ *                     Plan.link({ key: "plates", from: Plan.eventRef("plate", "P-01"), to: Plan.eventRef("job", "J-2001") }),
+ *                     Plan.link({ key: "covers", from: Plan.eventRef("job", "J-2001"), to: Plan.eventRef("job", "J-2013"), quantity: Plan.quantity(12, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "card", from: Plan.eventRef("job", "J-2020"), to: Plan.eventRef("job", "J-2005"), quantity: Plan.quantity(30, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "inserts", from: Plan.eventRef("job", "J-2003"), to: Plan.eventRef("job", "J-2016"), quantity: Plan.quantity(96, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "report-covers", from: Plan.eventRef("job", "J-2022"), to: Plan.eventRef("job", "J-2009"), quantity: Plan.quantity(48, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "seed-prints", from: Plan.eventRef("job", "J-2014"), to: Plan.eventRef("job", "J-2017"), quantity: Plan.quantity(72, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "tags", from: Plan.eventRef("job", "J-2006"), to: Plan.eventRef("job", "J-2007"), quantity: Plan.quantity(20, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "pads", from: Plan.eventRef("job", "J-2010"), to: Plan.eventRef("job", "J-2011"), quantity: Plan.quantity(36, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "proofs", from: Plan.eventRef("job", "J-2008"), to: Plan.eventRef("job", "J-2015"), quantity: Plan.quantity(16, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "proof-sheets", from: Plan.eventRef("job", "J-2012"), to: Plan.eventRef("job", "J-2004"), quantity: Plan.quantity(8, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "tickets", from: Plan.eventRef("job", "J-2019"), to: Plan.eventRef("job", "J-2023"), quantity: Plan.quantity(60, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "sections", from: Plan.eventRef("job", "J-2021"), to: Plan.eventRef("binding", "B-01"), quantity: Plan.quantity(40, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "sections-more", from: Plan.eventRef("job", "J-2021"), to: Plan.eventRef("binding", "B-02"), quantity: Plan.quantity(44, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "folded", from: Plan.eventRef("binding", "B-02"), to: Plan.eventRef("binding", "B-03"), quantity: Plan.quantity(40, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "books", from: Plan.eventRef("binding", "B-03"), to: Plan.eventRef("delivery", "D-01"), quantity: Plan.quantity(36, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "posters", from: Plan.eventRef("job", "J-2002"), to: Plan.eventRef("delivery", "D-02"), quantity: Plan.quantity(24, { unit: "k sheets" }) }),
+ *                     Plan.link({ key: "book-blocks", from: Plan.eventRef("job", "J-2018"), to: Plan.eventRef("binding", "B-04"), quantity: Plan.quantity(54, { unit: "k sheets" }) }),
+ *                 ]}
+ *                 style={{ height: "400px" }}
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export function createOver(data, series) {
+    const value = East.value(data);
+    const valueType = Expr.type(value);
+    const read = valueType.type === "Struct" ? valueType.fields["read"] : undefined;
+    const source = read !== undefined && read.type === "Function" ? value.read() : value;
+    const type = Expr.type(source);
+    if (type.type !== "Dict") {
+        throw new Error(`Plan.over: \`data\` is a keyed collection — a Dict, or a bind handle over one (Data.bind) — and this one is ${printType(type)}`);
+    }
+    if (series.length === 0) {
+        throw new Error("Plan.over: lays series over the dataset — give at least one `Plan.series.*`");
+    }
+    const given = series.map((one, i) => {
+        const facts = planSeriesFacts(one, type, `Plan.over › series[${i}]`);
+        if (facts === undefined) {
+            throw new Error(`Plan.over: series[${i}] is a Plan.series.* value written in place — a series bound or stored elsewhere cannot be checked to be read only`);
+        }
+        if (facts.writes) {
+            throw new Error(`Plan.over: series[${i}], ${facts.arm} "${facts.title}", declares \`edit\` — a Plan's rows over a dataset are read only, and its edits go through its event kinds (Schedule.events)`);
+        }
+        // Written in place, so its keys are known: its own and its nested series'.
+        return { facts, keys: planSeriesKeys([one]) ?? [facts.key] };
+    });
+    checkSeries(series, "Plan.over");
+    const blocks = applySeries(series, source);
+    const keys = planSeriesKeys(series);
+    if (keys !== undefined)
+        OVER_KEYS.set(blocks, keys);
+    OVER_SERIES.set(blocks, given);
+    return blocks;
+}
+//# sourceMappingURL=over.js.map

package/dist/src/plan/over.js.map

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