@elaraai/e3-ui 1.0.98 → 1.0.99

package/dist/src/plan/refs.js

@@ -29,7 +29,7 @@ const EVENT_REFS = new WeakMap();
  * @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 { DateTimeType, DictType, East, FloatType, NullType, OptionType, SortedMap, StringType, StructType, VariantType, compareFor, 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";
@@ -46,76 +46,117 @@ const EVENT_REFS = new WeakMap();
  *     stock: VariantType({ coated: NullType, uncoated: NullType, board: NullType }),
  *     due: OptionType(DateTimeType),
  * });
- * export const PrintStock = StructType({ name: StringType, weekly: ArrayType(FloatType) });
+ * export const PrintStock = StructType({ name: StringType, weekly: DictType(DateTimeType, 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 planPrintPresses = e3.record("plan_print_presses", DictType(StringType, PrintPress), {
+ *     initial: 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 }],
+ *     ]),
+ *     indexes: (index) => ({
+ *         plan_print_presses_by_hall: index.on(["hall"]),
+ *     }),
+ *     mutations: (mutation) => ({
+ *         // The presses' patch door: the works edits its presses elsewhere, and a Plan reads them live.
+ *         patch: mutation.patch(),
+ *     }),
+ * });
  * 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] }],
+ *     ["board", { name: "Board", weekly: new SortedMap([
+ *         [new Date("2026-10-05T00:00:00Z"), 40.0], [new Date("2026-10-12T00:00:00Z"), 22.0], [new Date("2026-10-19T00:00:00Z"), 31.0], [new Date("2026-10-26T00:00:00Z"), 18.0],
+ *     ], compareFor(DateTimeType)) }],
+ *     ["coated", { name: "Coated", weekly: new SortedMap([
+ *         [new Date("2026-10-05T00:00:00Z"), 520.0], [new Date("2026-10-12T00:00:00Z"), 410.0], [new Date("2026-10-19T00:00:00Z"), 460.0], [new Date("2026-10-26T00:00:00Z"), 380.0],
+ *     ], compareFor(DateTimeType)) }],
+ *     ["uncoated", { name: "Uncoated", weekly: new SortedMap([
+ *         [new Date("2026-10-05T00:00:00Z"), 300.0], [new Date("2026-10-12T00:00:00Z"), 260.0], [new Date("2026-10-19T00:00:00Z"), 280.0], [new Date("2026-10-26T00:00:00Z"), 240.0],
+ *     ], compareFor(DateTimeType)) }],
  * ])));
- * 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);
+ * export const planLinkSetters = e3.record("plan_link_setters", DictType(StringType, PrintCentre), {
+ *     initial: new Map([
+ *         ["ps", { name: "Platesetter" }],
+ *     ]),
+ * });
+ * export const planLinkLines = e3.record("plan_link_lines", DictType(StringType, PrintCentre), {
+ *     initial: new Map([
+ *         ["fold", { name: "Folder" }],
+ *         ["bind", { name: "Binder" }],
+ *     ]),
+ * });
+ * export const planLinkBays = e3.record("plan_link_bays", DictType(StringType, PrintCentre), {
+ *     initial: new Map([
+ *         ["bay", { name: "Dispatch bay" }],
+ *     ]),
+ * });
+ * export const planLinkPlates = e3.record("plan_link_plates", DictType(StringType, PrintPlates), {
+ *     initial: new Map([
+ *         ["P-01", { title: "Catalogue plates", at: new Date("2026-10-05T12:00:00Z"), setter: "ps" }],
+ *     ]),
+ *     mutations: (mutation) => ({
+ *         // The plates' patch door.
+ *         patch: mutation.patch(),
+ *     }),
+ * });
+ * export const planLinkCaseJobs = e3.record("plan_link_case_jobs", DictType(StringType, PrintJob), {
+ *     initial: 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")) }],
+ *     ]),
+ *     mutations: (mutation) => ({
+ *         // The jobs' patch door.
+ *         patch: mutation.patch(),
+ *     }),
+ * });
+ * export const planLinkBindings = e3.record("plan_link_bindings", DictType(StringType, PrintBinding), {
+ *     initial: 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)) }],
+ *     ]),
+ *     mutations: (mutation) => ({
+ *         // The bindery's patch door.
+ *         patch: mutation.patch(),
+ *     }),
+ * });
+ * export const planLinkDeliveries = e3.record("plan_link_deliveries", DictType(StringType, PrintDelivery), {
+ *     initial: 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" }],
+ *     ]),
+ *     mutations: (mutation) => ({
+ *         // The deliveries' patch door.
+ *         patch: mutation.patch(),
+ *     }),
+ * });
  *
  * const planEventLinks = East.function([], UIComponentType, (_$) => (
  *     <Reactive>{$ => {
@@ -123,16 +164,11 @@ const EVENT_REFS = new WeakMap();
  *         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 plates = $.let(Record.bind(planLinkPlates));
+ *         const jobs = $.let(Record.bind(planLinkCaseJobs));
+ *         const bindings = $.let(Record.bind(planLinkBindings));
+ *         const deliveries = $.let(Record.bind(planLinkDeliveries));
  *         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"),
@@ -174,7 +210,7 @@ const EVENT_REFS = new WeakMap();
  *                     Plan.over(stock, [
  *                         Plan.series.table(PrintStock, {
  *                             key: "stock", title: "Paper stock", label: s => s.name,
- *                             cells: s => Plan.tableCells(weekly(s.weekly)),
+ *                             cells: Plan.tableCells(Plan.values("weekly", (level) => ({ value: level }))),
  *                             format: Format.Number({ maximumFractionDigits: 0n }),
  *                         }),
  *                     ]),

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

@@ -1 +1 @@
-{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../src/plan/refs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAA2D,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,2EAA2E;AAC3E,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2LG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAmC;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACxG,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC"}
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../src/plan/refs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAA2D,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,2EAA2E;AAC3E,MAAM,UAAU,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+NG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAmC;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IACxG,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC"}

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

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { type EastType, type ExprType, type SubtypeExprOrValue, Expr, ArrayType, BooleanType, DictType, FunctionType, NullType, OptionType, StringType, type option } from "@elaraai/east";
+import { type EastType, type ExprType, type SubtypeExprOrValue, Expr, ArrayType, BooleanType, DictType, FunctionType, NullType, OptionType, StringType, StructType, type option } from "@elaraai/east";
 import { DensityType, DragEventType, StatusValueType, UIComponentType, type DensityLiteral, type PagedSourceLike, type PickHandle, type StatusValueLiteral } from "@elaraai/east-ui";
 import { type RecordSlicesChromeType } from "@elaraai/east-ui/internal";
 import { PlanGrainType, type PlanGrainLiteral, PlanLinkType, PlanRowIdType, PlanGroupToggleEventType, PlanElementRefType, PlanBlocksType, PlanUiBindType, type PlanAxisKindLiteral, type PlanAxisInput } from "./types.js";
@@ -190,9 +190,9 @@ export interface PlanConfig<K extends PlanAxisKindLiteral = PlanAxisKindLiteral>
     /** DnD target identity — names the Plan in drag-grammar cell refs, which is how a Library beside the Plan
      *  reaches it: its cards land only on a Plan with an `id` whose `sources` lists it. The Plan's own library
      *  panel needs neither — an author's tab's cards land without them (#1259). A card lands only on a row whose
-     *  series declares `edit.create` (where it lands and how it becomes an item). The canvas's own elements
-     *  move whether or not it has an `id` — where their series declares a move's fields (`edit.key` and
-     *  `start` / `end`, or `at`, #825). Each is a draft of the root's `editing` session. */
+     *  series declares `edit: { create }` (how it becomes an item, under the id the canvas mints, #1436). The
+     *  canvas's own elements move whether or not it has an `id` — where their series declares `edit`, its elements
+     *  read with `Plan.items` (#825, #1436). Each is a draft of the root's `editing` session. */
     id?: string;
     /** The ids of the Libraries beside the Plan whose cards it takes (`add`), reached by its `id` — its own
      *  library panel's need none (omit = no Library beside it). */
@@ -279,10 +279,15 @@ export type PlanCanvasOptions = Omit<PlanConfig, "data"> & {
  * @param config - The canvas's configuration, `data` optional
  * @param extra - The fixed blocks after `data`'s: a Plan's `rows`
  * @param chrome - The chrome of the Plan's `Slice.bindRecords`; `none` with no slice
+ * @param rowsNested - The nested part of the Slice's `rows` source, where it gives the canvas its rows
+ * @param rowsBinding - The binding the Slice's `rows` source narrows, there: what its nested index is read through
+ * @param pickHeld - The pick, held in a variable of the block the root is built in: what the root's reads of its
+ *   series read. `config.pick` still says which series it lists; written out at each read, it would copy every series'
+ *   code into each
  * @returns An East expression of {@link PlanRootType}
  * @throws {Error} As {@link createPlanRoot} does — an axis stating no window is taken beside a slice, a source of which
  *   holds the window in its `range`; and with no `data`, a `series`, `pick` or `editing`, each of which reads it
  * @internal
  */
-export declare function buildPlanRoot(config: PlanCanvasOptions, extra: ExprType<PlanBlocksType> | undefined, chrome: option<ExprType<RecordSlicesChromeType>>): ExprType<PlanRootType>;
+export declare function buildPlanRoot(config: PlanCanvasOptions, extra: ExprType<PlanBlocksType> | undefined, chrome: option<ExprType<RecordSlicesChromeType>>, rowsNested?: EastType, rowsBinding?: ExprType<StructType>, pickHeld?: ExprType<StructType>): ExprType<PlanRootType>;
 //# sourceMappingURL=root.d.ts.map

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

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

package/dist/src/plan/root.js

@@ -16,7 +16,11 @@ import { EditingApplyResultType, EditingChangeSetTypeFor, EditingDraftFieldType,
 import { PlanAxisType, PlanGrainType, PlanLinkType, PlanRowIdType, PlanGroupToggleEventType, PlanFooterItemType, PlanStyleType, PlanElementRefType, PlanBlocksType, PlanRowsType, PlanUiBindType, PlanEditingType, PlanReadyEntryType, PlanWriteRequestType, PLAN_PAGE_SIZE, } from "./types.js";
 import { orderedPlanSource } from "./ordered-source.js";
 import { PlanRootType } from "./ir.js";
-import { WINDOWLESS_AXES } from "./builders.js";
+import { WINDOWLESS_AXES, axisKindOf, axisResolutionsOf } from "./builders.js";
+import { checkPlanNested, nestedPartOf, planNestedIndex } from "./nested-checks.js";
+import { planNestedRestatement } from "./nested-patch.js";
+import { PlanNestedType, planNestedUses } from "./nested-read.js";
+import { pickedSeriesOf } from "./pick.js";
 import { applySeries, checkSeries, seriesWriteFn, PlanCarriedType, PlanSeriesType } from "./series.js";
 /** The source collection a series list's East type reads — its `derive`'s input, when the list's element is a series variant. */
 function seriesSourceOf(list) {
@@ -56,12 +60,17 @@ export function createPlanRoot(config) {
  * @param config - The canvas's configuration, `data` optional
  * @param extra - The fixed blocks after `data`'s: a Plan's `rows`
  * @param chrome - The chrome of the Plan's `Slice.bindRecords`; `none` with no slice
+ * @param rowsNested - The nested part of the Slice's `rows` source, where it gives the canvas its rows
+ * @param rowsBinding - The binding the Slice's `rows` source narrows, there: what its nested index is read through
+ * @param pickHeld - The pick, held in a variable of the block the root is built in: what the root's reads of its
+ *   series read. `config.pick` still says which series it lists; written out at each read, it would copy every series'
+ *   code into each
  * @returns An East expression of {@link PlanRootType}
  * @throws {Error} As {@link createPlanRoot} does — an axis stating no window is taken beside a slice, a source of which
  *   holds the window in its `range`; and with no `data`, a `series`, `pick` or `editing`, each of which reads it
  * @internal
  */
-export function buildPlanRoot(config, extra, chrome) {
+export function buildPlanRoot(config, extra, chrome, rowsNested, rowsBinding, pickHeld) {
     // A canvas is DEFINED as data + series (+ the root resolvers) — there
     // is no rows-authoring channel; the IR's inline arm is what inline
     // application collapses to. A Plan of event kinds or `rows` alone has no data.
@@ -72,7 +81,7 @@ export function buildPlanRoot(config, extra, chrome) {
     // lose them silently.
     if ("onDrag" in config) {
         throw new Error("Plan: `onDrag` is removed (#880) — a card dropped on a row is a draft of the `editing` session: declare " +
-            "`edit: { items, create }` on the series it lands on, and commit with `editing.onApply` (or `onUpdate`)");
+            "`edit: { create }` on the series it lands on, and commit with `editing.onApply` (or `onUpdate`)");
     }
     if ("review" in config) {
         throw new Error("Plan: `review` is removed (#1260) — a Plan approves and rejects nothing: its changes are drafts of the " +
@@ -99,16 +108,43 @@ export function buildPlanRoot(config, extra, chrome) {
             "an event kind's, or a tab's: slice={{ slice: Slice.bindRecords(key, { <kind>: { source, range } }) }}. " +
             "A canvas never fits its axis to the data, so it reads the same inline and paged.");
     }
+    // Over a record's paged rows, each series is held to the rows' nested series index first (#1435): where its slice's
+    // `rows` source gives them, or `data` is the record's indexed binding, whose type carries its nested part. Rows paged
+    // whole (`Data.bindPaged(dataset)`) are read as #1436 reads them.
+    const nested = config.data === undefined ? undefined
+        : rowsNested ?? nestedPartOf(Expr.type(East.value(config.data)));
+    let reads = [];
+    if (nested !== undefined) {
+        // What each series reads is known as the Plan is built: from the list it was given, or the one its pick was. A pick
+        // read through an East variable is an expression whose series the build cannot see.
+        const declared = config.pick !== undefined ? pickedSeriesOf(config.pick) : config.series;
+        const index = planNestedIndex(nested);
+        if (index !== undefined && !Array.isArray(declared)) {
+            throw new Error(config.pick !== undefined
+                ? "Plan: its rows are read through a nested series index, a cell at a time, by what each series reads — known as the Plan is " +
+                    "built — and its pick is an East expression whose series it cannot see. Give `pick` Plan.pick(key, [Plan.series.span(…), …]) " +
+                    "as it returns it: its series a list, and the pick held in no East variable ($.let)"
+                : "Plan: its rows are read through a nested series index, a cell at a time, by what each series reads — known as the Plan is " +
+                    "built — and its `series` are an East expression of a list. Give `series` the list itself: [Plan.series.span(…), …]");
+        }
+        reads = checkPlanNested(declared, { index, axisKind: axisKindOf(config.axis), resolutions: axisResolutionsOf(config.axis) });
+    }
     if (config.series !== undefined)
-        checkSeries(config.series, "Plan");
+        checkSeries(config.series, "Plan", axisKindOf(config.axis));
     const data = config.data;
     if (data === undefined)
-        return rootOf(config, East.value(variant("inline", extra), PlanRowsType), undefined, chrome);
+        return rootOf(config, East.value(variant("inline", extra), PlanRowsType), undefined, chrome, undefined);
     // A pick feeds the canvas its SURVIVING series; everything downstream sees
     // one series input either way.
-    const seriesInput = config.pick !== undefined
-        ? pickActive(config.pick)
+    const pick = pickHeld ?? config.pick;
+    const seriesInput = pick !== undefined
+        ? pickActive(pick)
         : config.series;
+    // A gesture writes the data, whichever series show (#1440): the editing session is built over every series a pick
+    // holds, so a number written as its series is switched off — its field leaving with its row — lands, never refused.
+    const editSeries = pick !== undefined
+        ? pick.all
+        : seriesInput;
     // The shared row-source resolution (#567): inline collection, paged
     // source, or a whole-value bind handle — one dispatch, one vocabulary,
     // and the series pipeline is the `make` that turns each window's entries
@@ -144,8 +180,21 @@ export function buildPlanRoot(config, extra, chrome) {
         const blocks = ordered === undefined ? applySeries(seriesInput, source) : ordered.make(seriesInput, source);
         return extra === undefined ? blocks : blocks.concat(extra);
     });
-    const editing = config.editing === undefined ? undefined : buildPlanEditing(resolved, seriesInput, config.editing);
-    return rootOf(config, rowsValue, editing === undefined ? undefined : ordered?.editing(editing) ?? editing, chrome);
+    const editing = config.editing === undefined ? undefined : buildPlanEditing(resolved, editSeries, config.editing, planNestedIndex(nested));
+    // Paged beside their nested series index (#1438): the seam the reader reads the index's cells through, and the window
+    // its rows are drawn from with what it read — the binding's, or the one the Slice's `rows` source narrows.
+    const index = planNestedIndex(nested);
+    const binding = (rowsBinding ?? config.data);
+    const uses = index === undefined ? [] : planNestedUses(reads, index);
+    const nestedSeam = index === undefined || ordered === undefined ? undefined : East.value({
+        index: index.name,
+        source: binding.id,
+        tile: variant(index.tile, null),
+        summary: index.summary === undefined ? none : some(variant(index.summary, null)),
+        uses,
+        rows: ordered.nestedRows(seriesInput, binding.fill.unwrap(), new Set(uses.filter((use) => use.shade.type === "booked").map((use) => use.series))),
+    }, PlanNestedType);
+    return rootOf(pick === config.pick ? config : { ...config, pick }, rowsValue, editing === undefined ? undefined : ordered?.editing(editing) ?? editing, chrome, nestedSeam);
 }
 /**
  * The canvas's root around its rows, its editing session and its narrowing's chrome.
@@ -154,9 +203,10 @@ export function buildPlanRoot(config, extra, chrome) {
  * @param rowsValue - Its rows: inline blocks, or a paged source of them
  * @param editing - Its editing session over `data`, if it has one
  * @param chrome - The chrome of the Plan's `Slice.bindRecords`; `none` with no slice
+ * @param nested - What its paged rows' reader reads of their nested series index, if it reads it (#1438)
  * @returns An East expression of {@link PlanRootType}
  */
-function rootOf(config, rowsValue, editing, chrome) {
+function rootOf(config, rowsValue, editing, chrome, nested) {
     const style = config.style;
     const styleValue = style !== undefined
         ? some(East.value({
@@ -192,6 +242,7 @@ function rootOf(config, rowsValue, editing, chrome) {
             ? some(East.value(config.pick.pick, PickBindType))
             : none,
         slice: chrome,
+        nested: nested !== undefined ? some(nested) : none,
         footer: (config.footer ?? []).map(f => East.value({
             text: f.text,
             tone: f.tone !== undefined ? some(resolveTag(f.tone, StatusValueType)) : none,
@@ -231,7 +282,7 @@ function rootOf(config, rowsValue, editing, chrome) {
  * @returns The editing declaration, on the wire
  * @throws {Error} When the declaration is inconsistent, or a callback has another signature
  */
-function buildPlanEditing(resolved, series, input) {
+function buildPlanEditing(resolved, series, input, nested) {
     const sourceType = resolved.collectionType;
     const entryType = sourceType.value;
     const keyType = sourceType.key;
@@ -413,18 +464,30 @@ function buildPlanEditing(resolved, series, input) {
     }
     else if (authorApply !== undefined) {
         const typedBatch = batchType;
+        // Over rows read beside their nested series index (#1438), each change's patch restated by key before the author's
+        // apply: a collection's whole `replace` the operations it stands for, so a commit names only what it changed.
+        const restatement = nested === undefined ? undefined
+            : planNestedRestatement(entryType, keyType, nested);
         if (Expr.type(authorApply).type === "AsyncFunction") {
             const fn = authorApply;
             onApply = East.value(variant("async", East.asyncFunction([BlobType], EditingApplyResultType, ($, blob) => {
                 const apply = $.const(fn);
-                return apply(blob.decodeBeast(typedBatch, "v2"));
+                const batch = $.let(blob.decodeBeast(typedBatch, "v2"));
+                if (restatement === undefined)
+                    return apply(batch);
+                const restate = $.const(restatement);
+                return apply(restate(batch));
             })), EditingWireApplyType);
         }
         else {
             const fn = authorApply;
             onApply = East.value(variant("sync", East.function([BlobType], EditingApplyResultType, ($, blob) => {
                 const apply = $.const(fn);
-                return apply(blob.decodeBeast(typedBatch, "v2"));
+                const batch = $.let(blob.decodeBeast(typedBatch, "v2"));
+                if (restatement === undefined)
+                    return apply(batch);
+                const restate = $.const(restatement);
+                return apply(restate(batch));
             })), EditingWireApplyType);
         }
     }