@elaraai/e3-ui 1.0.86 → 1.0.87

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

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

package/dist/src/plan/library.js

@@ -0,0 +1,424 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Plan.library` — the Plan's library pane, the author's (#1195,
+ * `Plan Builder Spec.md` §4.3, §8, §9.6, PB26–PB30, PB61, PB62). `library`
+ * lists the pane's tabs, in order, each built here:
+ *
+ * - `Plan.library.events()`: every event kind's templates, by kind;
+ * - `Plan.library.backlog()`: every event kind's unscheduled events, by when
+ *   they are due;
+ * - `Plan.library.series()`: what the canvas shows that a viewer can hide,
+ *   each with an eye — the resource kinds and their measures, the event
+ *   kinds, `data`'s series when they are picked (`pick`), and the Plan's
+ *   `rows`;
+ * - `Plan.library.tab(rows, { … })`: cards of the author's own.
+ *
+ * Left out, or empty, the Plan has no library pane.
+ *
+ * An author's tab reads its rows as `Schedule.resources` does: a `Dict<K, R>`,
+ * usually a record's `read()`, its accessors `(row, key) => …` reified once
+ * into a describe function the map then calls, each card keyed by its row's
+ * key as text. Its cards drag onto the rows of `data` whose series makes an
+ * item of a dropped card (`edit.create`, #1259), as a Library's card beside
+ * the Plan does — the Plan takes its own panel's cards with no `id` or
+ * `sources`. Its `drop` returns what a card dropped on an event sets:
+ * `Schedule.patch` over one event kind's row type, whose type names that kind.
+ * The patch crosses the closed payload as that kind's field writes — each
+ * field it sets, its path and its value as bytes — which a drop writes through
+ * the kind's own `write` (#1196).
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, DictType, East, NullType, StringType, StructType, VariantType, none, some, variant, } from "@elaraai/east";
+import { PickItemType } from "@elaraai/east-ui";
+import { ScheduleAuthorTabType, buildScheduleTab } from "../schedule/library.js";
+export { ScheduleLibraryCardType as PlanLibraryCardType } from "../schedule/library.js";
+import { overSeries } from "./over.js";
+import { KIND_ICONS } from "./pick.js";
+import { planSeriesFacts } from "./series.js";
+import { PlanRowsCollectionType } from "./types.js";
+// ============================================================================
+// The wire
+// ============================================================================
+/**
+ * One card of an author's tab on the wire.
+ *
+ * @property key - Its row's key, as text
+ * @property label - Its name
+ * @property meta - The line under its name
+ * @property group - The tab's group the card sits under
+ * @property sets - What a drop writes into the event it lands on: each field the tab's `drop` patch sets; empty without a `drop`
+ */
+/**
+ * The id the Series tab lists a thing by, and a viewer's hidden set holds it by
+ * (PB29): one namespace per source, so no two collide — a resource kind and an
+ * event kind by slot, a measure, a hand-built row and a `Plan.over` series by
+ * key. `data`'s picked series are the pick's own, by their bare keys.
+ *
+ * @internal
+ */
+export const planHideId = {
+    /** A resource kind, by slot: hiding it hides its rows. */
+    resources: (slot) => `resources.${slot}`,
+    /** An event kind, by slot: hiding it hides its elements everywhere. */
+    events: (slot) => `events.${slot}`,
+    /** A measure, by key: hiding it hides its row under each resource. */
+    measures: (key) => `measures.${key}`,
+    /** A hand-built row, by key: hiding it hides it and the rows under it. */
+    rows: (key) => `rows.${key}`,
+    /** A `Plan.over` series, by key: hiding it hides its rows and its nested series'. */
+    series: (key) => `series.${key}`,
+};
+/**
+ * What hiding one of a Plan's `rows` hides on the canvas: a `Plan.over`
+ * series' rows, by the keys they carry — its own and every series' nested in
+ * it — or a hand-built row and the rows under it, by its key, the first step
+ * of their ids' paths.
+ */
+export const PlanLibraryHidesType = VariantType({
+    series: ArrayType(StringType),
+    rows: StringType,
+});
+/**
+ * One of a Plan's `rows` as the Series tab lists it.
+ *
+ * @property item - Its line in the tab, an eye beside it
+ * @property hides - What hiding it hides
+ */
+export const PlanLibraryRowsItemType = StructType({
+    item: PickItemType,
+    hides: PlanLibraryHidesType,
+});
+/**
+ * What the Series tab lists (PB29), each a pick item with its eye, in the
+ * order the canvas draws them. `data`'s series, when they are picked, sit
+ * between the two lists: they are the pick's own (the root's `pick`).
+ *
+ * @property kinds - The resource kinds, each followed by its measures, then the event kinds
+ * @property rows - The Plan's `rows`: a hand-built row by its key, each series of a `Plan.over` by its own
+ */
+export const PlanLibrarySeriesType = StructType({
+    kinds: ArrayType(PickItemType),
+    rows: ArrayType(PlanLibraryRowsItemType),
+});
+/**
+ * One tab of the library pane on the wire, in the order `library` lists them.
+ *
+ * - `events` — every event kind's templates, read off the kinds;
+ * - `backlog` — every event kind's unscheduled events, read off the kinds;
+ * - `series` — what the canvas shows that a viewer can hide;
+ * - `tab` — the author's own: its name, its icon, the event kind its cards
+ *   land on, and its cards.
+ */
+export const PlanLibraryTabType = VariantType({
+    events: NullType,
+    backlog: NullType,
+    series: PlanLibrarySeriesType,
+    tab: ScheduleAuthorTabType,
+});
+/**
+ * The library's Events tab — `Plan.library.events()`: every event kind's
+ * templates, under the kind's name and icon, then by a template's `group`
+ * (PB27). A card dropped on a resource's row creates an event of its kind
+ * (#1196).
+ *
+ * @returns The tab
+ */
+export function libraryEvents() {
+    return { kind: "events" };
+}
+/**
+ * The library's Backlog tab — `Plan.library.backlog()`: every event kind's
+ * unscheduled events (a kind whose times are Options), by when they are due:
+ * this week, next week, later, or no date (PB28). A card dropped on a
+ * resource's row schedules it (#1196).
+ *
+ * @returns The tab
+ */
+export function libraryBacklog() {
+    return { kind: "backlog" };
+}
+/**
+ * The library's Series tab — `Plan.library.series()`: what the canvas shows
+ * that a viewer can hide, each with an eye (PB29). Hiding an event kind hides
+ * its elements everywhere, a resource kind its rows, a measure or one of the
+ * Plan's `rows` that row; `data`'s series show and hide through their `pick`.
+ * What a viewer hides is kept for them.
+ *
+ * @returns The tab
+ */
+export function librarySeries() {
+    return { kind: "series" };
+}
+/**
+ * A tab of the author's own cards — `Plan.library.tab(rows, { … })` (PB62):
+ * one card per row, its label and meta, grouped by its `group`, searched by
+ * its key, label and meta. Each card drags onto the rows of `data` whose
+ * series makes an item of it (`edit.create`, #1259) — the drop's `from.key`
+ * its row's key as text, so `canDrop` and `create` read it as a Library card's
+ * — and, given a `drop`, onto an event (#1196), setting the fields the patch
+ * sets.
+ *
+ * @typeParam K - The rows' key type
+ * @typeParam R - Their row type
+ * @typeParam P - The patch `drop` returns
+ * @param rows - The rows — a `Dict<K, R>` value or expression, usually a record's `read()`
+ * @param config - The tab's name and icon, and the accessors ({@link PlanLibraryTabConfig})
+ * @returns The tab
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/e3-ui` pragma
+ * import { DateTimeType, DictType, East, FloatType, NullType, OptionType, StringType, StructType, VariantType, none, some, variant } from "@elaraai/east";
+ * import { EventStateType, Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { 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 PrintCustomer = StructType({ name: StringType, district: StringType, trade: 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 planPrintCustomers = e3.record("plan_print_customers", DictType(StringType, PrintCustomer), new Map([
+ *     ["alder-finch", { name: "Alder & Finch", district: "Old Town", trade: "Retail" }],
+ *     ["bluewater-tours", { name: "Bluewater Tours", district: "North Quay", trade: "Travel" }],
+ *     ["copperleaf-cafe", { name: "Copperleaf Cafe", district: "Old Town", trade: "Hospitality" }],
+ *     ["driftwood-museum", { name: "Driftwood Museum", district: "North Quay", trade: "Arts" }],
+ *     ["elmway-college", { name: "Elmway College", district: "Riverside", trade: "Education" }],
+ *     ["foxglove-gardens", { name: "Foxglove Gardens", district: "Riverside", trade: "Retail" }],
+ *     ["granite-hall", { name: "Granite Hall", district: "Old Town", trade: "Events" }],
+ *     ["harbour-arts", { name: "Harbour Arts Society", district: "North Quay", trade: "Arts" }],
+ *     ["heathfield", { name: "Heathfield Theatre", district: "Old Town", trade: "Arts" }],
+ *     ["ivy-lane", { name: "Ivy Lane Studio", district: "Riverside", trade: "Design" }],
+ *     ["juniper-toys", { name: "Juniper Toys", district: "Riverside", trade: "Retail" }],
+ *     ["kestrel-cycling", { name: "Kestrel Cycling Club", district: "Riverside", trade: "Sport" }],
+ *     ["larkspur-home", { name: "Larkspur Home", district: "Old Town", trade: "Retail" }],
+ *     ["meridian-monthly", { name: "Meridian Monthly", district: "North Quay", trade: "Publishing" }],
+ *     ["northwind", { name: "Northwind Outfitters", district: "North Quay", trade: "Retail" }],
+ *     ["orchard-market", { name: "Orchard Street Market", district: "Old Town", trade: "Markets" }],
+ * ]));
+ * export const planEventJobs = e3.record("plan_event_jobs", DictType(StringType, PrintJob), new Map([
+ *     ["J-3001", { title: "Spring catalogue", start: some(new Date("2026-10-06T06:00:00Z")), end: some(new Date("2026-10-06T14:00:00Z")), press: some("a1"), state: variant("actual", null), sheets: 96000.0, customer: "Alder & Finch", stock: variant("coated", null), due: some(new Date("2026-10-08T00:00:00Z")) }],
+ *     ["J-3002", { title: "Course handbook", start: some(new Date("2026-10-19T06:00:00Z")), end: some(new Date("2026-10-19T18:00:00Z")), press: some("a1"), state: variant("confirmed", null), sheets: 144000.0, customer: "Elmway College", stock: variant("uncoated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3003", { title: "Annual report", start: some(new Date("2026-10-14T06:00:00Z")), end: some(new Date("2026-10-14T12:00:00Z")), press: some("a2"), state: variant("in-progress", null), sheets: 60000.0, customer: "Harbour Arts Society", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3004", { title: "Club newsletter", start: some(new Date("2026-10-08T06:00:00Z")), end: some(new Date("2026-10-08T08:00:00Z")), press: some("a3"), state: variant("actual", null), sheets: 16000.0, customer: "Kestrel Cycling Club", stock: variant("uncoated", null), due: some(new Date("2026-10-09T00:00:00Z")) }],
+ *     ["J-3005", { title: "Store flyers", start: some(new Date("2026-10-15T06:00:00Z")), end: some(new Date("2026-10-15T16:00:00Z")), press: some("b1"), state: variant("confirmed", null), sheets: 150000.0, customer: "Northwind Outfitters", stock: variant("uncoated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3006", { title: "Market posters", start: some(new Date("2026-10-20T06:00:00Z")), end: some(new Date("2026-10-20T12:00:00Z")), press: some("b2"), state: variant("confirmed", null), sheets: 72000.0, customer: "Orchard Street Market", stock: variant("coated", null), due: some(new Date("2026-10-22T00:00:00Z")) }],
+ *     ["J-3007", { title: "Loyalty cards", start: some(new Date("2026-10-20T10:00:00Z")), end: some(new Date("2026-10-20T13:00:00Z")), press: some("b2"), state: variant("proposed", variant("added", null)), sheets: 36000.0, customer: "Copperleaf Cafe", stock: variant("board", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3008", { title: "Gift boxes", start: some(new Date("2026-10-27T06:00:00Z")), end: some(new Date("2026-10-27T12:00:00Z")), press: some("b3"), 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-3009", { title: "Ticket books", start: some(new Date("2026-10-22T06:00:00Z")), end: some(new Date("2026-10-22T09:00:00Z")), press: none, state: variant("proposed", variant("added", null)), sheets: 24000.0, customer: "Heathfield Theatre", stock: variant("uncoated", null), due: some(new Date("2026-10-26T00:00:00Z")) }],
+ *     ["J-3010", { title: "Guide reprint", start: none, end: none, press: none, state: variant("estimated", null), sheets: 24000.0, customer: "Driftwood Museum", stock: variant("coated", null), due: some(new Date("2026-10-16T00:00:00Z")) }],
+ *     ["J-3011", { title: "Wall calendars", start: none, end: none, press: none, state: variant("estimated", null), sheets: 50000.0, customer: "Foxglove Gardens", stock: variant("coated", null), due: some(new Date("2026-10-23T00:00:00Z")) }],
+ *     ["J-3012", { title: "Spare covers", start: none, end: none, press: none, state: variant("estimated", null), sheets: 8000.0, customer: "Meridian Monthly", stock: variant("board", null), due: none }],
+ * ]));
+ * export const planEventJobsPatch = e3.mutation.patch(planEventJobs);
+ *
+ * const planEvents = East.function([], UIComponentType, (_$) => (
+ *     <Reactive>{$ => {
+ *         const presses = $.let(Record.bind(planPrintPresses, []));
+ *         const jobs = $.let(Record.bind(planEventJobs, [planEventJobsPatch]));
+ *         const customers = $.let(Record.bind(planPrintCustomers, []));
+ *         const axis = $.let(Plan.axis({
+ *             window: { min: new Date("2026-10-05T00:00:00Z"), max: new Date("2026-11-02T00:00:00Z") },
+ *             resolution: "day", now: new Date("2026-10-14T09:00:00Z"),
+ *         }));
+ *         return (
+ *             <Plan
+ *                 id="jobs"
+ *                 axis={axis}
+ *                 resources={{
+ *                     presses: Schedule.resources(presses.read(), { name: "Presses", icon: "print", label: p => p.name }),
+ *                 }}
+ *                 events={{
+ *                     job: Schedule.events(jobs, {
+ *                         name: "Print job", icon: "file-lines",
+ *                         title: "title", start: "start", end: "end",
+ *                         resource: { field: "press", of: "presses" },
+ *                         state: "state",
+ *                         // A job with no start waits in the backlog: placed, it runs as long as its sheets take at
+ *                         // 8,000 an hour.
+ *                         backlog: { duration: j => variant("hours", j.sheets.divide(8000.0)), due: j => j.due },
+ *                         fields: {
+ *                             customer: Schedule.field.text({ label: "Customer" }),
+ *                             stock: Schedule.field.select({ labels: { coated: "Coated", uncoated: "Uncoated", board: "Board" } }),
+ *                         },
+ *                     }),
+ *                 }}
+ *                 library={[
+ *                     Plan.library.backlog(),
+ *                     // The customers, by district: a card dropped on a job sets its customer.
+ *                     Plan.library.tab(customers.read(), {
+ *                         name: "Customers", icon: "building",
+ *                         label: c => c.name, meta: c => some(c.trade), group: c => c.district,
+ *                         drop: c => Schedule.patch(PrintJob, { customer: c.name }),
+ *                     }),
+ *                 ]}
+ *                 inspector
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ */
+export function libraryTab(rows, config) {
+    return { kind: "tab", rows, config: config };
+}
+/** How a tab names itself in a refusal. */
+function tabName(tab) {
+    return tab.kind === "tab" ? `the "${tab.config.name}" tab` : `Plan.library.${tab.kind}()`;
+}
+/** A pick item of the Series tab, known at build. */
+function item(id, title, subtitle, icon) {
+    return East.value({
+        id,
+        title,
+        subtitle: subtitle === undefined ? none : some(subtitle),
+        icon: some({ name: icon, prefix: "fas", label: none, style: none }),
+        count: none,
+        narrowed: false,
+    }, PickItemType);
+}
+/** The glyph a hand-built row's kind is listed with: its series kind's (`Plan.pick`'s). */
+const ROW_ICONS = {
+    group: KIND_ICONS.group,
+    span: KIND_ICONS.span,
+    buckets: KIND_ICONS.buckets,
+    chart: KIND_ICONS.chart,
+    heat: KIND_ICONS.heat,
+    table: KIND_ICONS.table,
+    cards: KIND_ICONS.cards,
+    events: KIND_ICONS.events,
+};
+/**
+ * A hand-built row stream's Series items: each row at its top by its key, the
+ * one step of its id's path (`Plan.chart({ key })`), and its name.
+ */
+const handItems = East.function([PlanRowsCollectionType], ArrayType(PlanLibraryRowsItemType), ($, rows) => {
+    const out = $.let([], ArrayType(PlanLibraryRowsItemType));
+    $.for(rows, ($2, row) => {
+        const path = $2.let(row.id.match({
+            entry: (_$3, at) => at.path,
+            section: (_$3, at) => at.path,
+        }), ArrayType(StringType));
+        $2.if(row.parent.hasTag("none").and(() => path.size().greater(0n)), ($3) => {
+            const key = $3.let(path.get(0n), StringType);
+            const icon = $3.let(row.kind.match({
+                group: () => ROW_ICONS.group,
+                span: () => ROW_ICONS.span,
+                buckets: () => ROW_ICONS.buckets,
+                chart: () => ROW_ICONS.chart,
+                heat: () => ROW_ICONS.heat,
+                table: () => ROW_ICONS.table,
+                cards: () => ROW_ICONS.cards,
+                events: () => ROW_ICONS.events,
+            }), StringType);
+            $3(out.pushLast({
+                item: {
+                    id: East.str `rows.${key}`,
+                    title: row.gutter.label,
+                    subtitle: none,
+                    icon: some({ name: icon, prefix: "fas", label: none, style: none }),
+                    count: none,
+                    narrowed: false,
+                },
+                hides: variant("rows", key),
+            }));
+        });
+    });
+    return out;
+});
+/**
+ * The Series tab on the wire (PB29): the resource kinds, each followed by its
+ * measures, then the event kinds; and the Plan's `rows`.
+ *
+ * @param ctx - What the library is built against
+ * @returns The tab's wire value
+ */
+function seriesTab(ctx) {
+    const kinds = [];
+    for (const [slot, kind] of ctx.resources) {
+        kinds.push(item(planHideId.resources(slot), kind.name, undefined, kind.icon));
+        const collection = DictType(kind.keyType, kind.rowType);
+        kind.measures.forEach((measure, i) => {
+            // Checked when the kind was declared: a measure is a series written in place.
+            const facts = planSeriesFacts(measure, collection, `Plan: resources.${slot}.measures[${i}]`);
+            kinds.push(item(planHideId.measures(facts.key), facts.title, kind.name, KIND_ICONS[facts.arm]));
+        });
+    }
+    for (const [slot, kind] of ctx.events)
+        kinds.push(item(planHideId.events(slot), kind.name, undefined, kind.icon));
+    const rows = (ctx.rows ?? []).map((one) => {
+        const over = overSeries(one);
+        if (over !== undefined) {
+            return East.value(over.map(({ facts, keys }) => East.value({
+                item: item(planHideId.series(facts.key), facts.title, undefined, KIND_ICONS[facts.arm]),
+                hides: variant("series", [...keys]),
+            }, PlanLibraryRowsItemType)), ArrayType(PlanLibraryRowsItemType));
+        }
+        return handItems(East.value(one, PlanRowsCollectionType));
+    }).reduce((all, part) => all.concat(part), East.value([], ArrayType(PlanLibraryRowsItemType)));
+    return East.value(variant("series", { kinds: East.value(kinds, ArrayType(PickItemType)), rows }), PlanLibraryTabType);
+}
+/**
+ * Builds the library pane on the wire (PB26, PB61, PB62): its tabs in the
+ * order `library` lists them; none when it is left out.
+ *
+ * @param tabs - The tabs, each a `Plan.library.*` call
+ * @param ctx - What the library is built against
+ * @returns The tabs on the wire
+ * @throws {Error} Naming the tab: a tab listed twice (an author's tab by its name); the Events or Backlog tab on a Plan
+ *   with no event kinds; the Series tab on a Plan with nothing a viewer can hide; and each of an author's tab's refusals
+ * @internal
+ */
+export function buildLibrary(tabs, ctx) {
+    const seen = new Set();
+    for (const tab of tabs ?? []) {
+        const id = tab.kind === "tab" ? `tab:${tab.config.name}` : tab.kind;
+        if (seen.has(id)) {
+            throw new Error(tab.kind === "tab"
+                ? `Plan: the library lists two tabs named "${tab.config.name}" — each tab's name is its own`
+                : `Plan: the library lists ${tabName(tab)} twice — each tab once`);
+        }
+        seen.add(id);
+        if ((tab.kind === "events" || tab.kind === "backlog") && ctx.events.length === 0) {
+            throw new Error(`Plan: the library lists ${tabName(tab)}, and this Plan has no event kinds — ` +
+                `its ${tab.kind === "events" ? "templates" : "unscheduled events"} are its event kinds' (Schedule.events)`);
+        }
+        if (tab.kind === "series" && ctx.resources.length === 0 && ctx.events.length === 0 && (ctx.rows ?? []).length === 0 && !ctx.picked) {
+            throw new Error("Plan: the library lists Plan.library.series(), and this Plan has nothing a viewer can hide — it lists " +
+                "event kinds, resource kinds and their measures, `rows`, and `data`'s series when they are picked (`pick`)");
+        }
+    }
+    const wires = (tabs ?? []).map((tab) => {
+        switch (tab.kind) {
+            case "events":
+            case "backlog":
+                return East.value(variant(tab.kind, null), PlanLibraryTabType);
+            case "series":
+                return seriesTab(ctx);
+            case "tab":
+                return East.value(variant("tab", buildScheduleTab(tab, ctx.events, "Plan")), PlanLibraryTabType);
+        }
+    });
+    return East.value(wires, ArrayType(PlanLibraryTabType));
+}
+//# sourceMappingURL=library.js.map

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

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

package/dist/src/plan/ordered-source.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Preserve index order while the existing Plan series and editing use primary keys. */
+import { type EastType, type ExprType, type StructType } from "@elaraai/east";
+import { type ResolvedRowSource } from "@elaraai/east-ui/internal";
+import { PlanBlocksType, PlanEditingType } from "./types.js";
+import { type PlanSeriesInput } from "./series.js";
+type Ordered = Extract<ResolvedRowSource, {
+    kind: "ordered";
+}>;
+/** Build one bounded window adapter; its primary-key map is never a predicate. */
+export declare function orderedPlanSource(source: Ordered): {
+    resolved: {
+        kind: "paged";
+        source: ExprType<StructType>;
+        collectionType: EastType;
+        elementType: EastType;
+        keyType: EastType | undefined;
+        pinned: boolean;
+    };
+    make: (series: PlanSeriesInput, values: ExprType<EastType>) => ExprType<PlanBlocksType>;
+    editing: (input: ExprType<PlanEditingType>) => ExprType<PlanEditingType>;
+};
+export {};
+//# sourceMappingURL=ordered-source.d.ts.map

package/dist/src/plan/ordered-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordered-source.d.ts","sourceRoot":"","sources":["../../../src/plan/ordered-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wFAAwF;AACxF,OAAO,EAA4E,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAc,MAAM,eAAe,CAAC;AACpK,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AACrF,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,KAAK,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAE/D,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO;;;;;;;;;mBAcvB,eAAe,UAAU,QAAQ,CAAC,QAAQ,CAAC,KAAG,QAAQ,CAAC,cAAc,CAAC;qBAIpE,QAAQ,CAAC,eAAe,CAAC,KAAG,QAAQ,CAAC,eAAe,CAAC;EAkBhF"}

package/dist/src/plan/ordered-source.js

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Preserve index order while the existing Plan series and editing use primary keys. */
+import { ArrayType, BlobType, DictType, East, IntegerType, OptionType, StringType, none, some } from "@elaraai/east";
+import {} from "@elaraai/east-ui/internal";
+import { orderedRowSource } from "../utils/ordered-source.js";
+import { PlanBlocksType, PlanEditingType, PlanRowsCollectionType } from "./types.js";
+import { applySeries } from "./series.js";
+/** Build one bounded window adapter; its primary-key map is never a predicate. */
+export function orderedPlanSource(source) {
+    const { resolved, entries: _entries, window, rows, keys } = orderedRowSource(source, "Plan");
+    // Group each root's complete subtree once, then visit roots in index order.
+    // Fixed section/header blocks retain their position. This is O(rows log rows),
+    // without a scan per entry or re-deriving each series once per record.
+    const order = East.function([PlanBlocksType, ArrayType(StringType)], PlanBlocksType, (_$, blocks, ids) => blocks.map((_$2, block) => ({
+        fixed: block.fixed, parent: block.parent, rows: block.fixed.ifElse(() => block.rows, ($3) => {
+            const grouped = $3.const(block.rows.groupToArrays((_$4, r) => r.id.match({
+                entry: (_$5, id) => id.path.get(0n), section: (_$5, id) => id.path.get(0n),
+            })));
+            return ids.flatMap((_$4, id) => grouped.get(id, () => East.value([], PlanRowsCollectionType)));
+        }),
+    })));
+    const make = (series, values) => {
+        const input = values;
+        return order(applySeries(series, rows(input)), keys(input));
+    };
+    const editing = (input) => {
+        const entryIds = East.function([IntegerType, IntegerType], OptionType(ArrayType(StringType)), ($, offset, limit) => {
+            const read = $.const(window);
+            const ids = $.const(keys);
+            return read(offset, limit).match({ some: (_$2, values) => East.value(some(ids(values)), OptionType(ArrayType(StringType))), none: () => East.value(none, OptionType(ArrayType(StringType))) });
+        });
+        const derive = East.function([IntegerType, IntegerType, DictType(StringType, BlobType)], OptionType(PlanBlocksType), ($, offset, limit, drafts) => {
+            const read = $.const(entryIds);
+            const sort = $.const(order);
+            const build = $.const(input.derive);
+            return read(offset, limit).match({
+                some: (_$2, ids) => build(offset, limit, drafts).match({ some: (_$3, blocks) => East.value(some(sort(blocks, ids)), OptionType(PlanBlocksType)), none: () => East.value(none, OptionType(PlanBlocksType)) }),
+                none: () => East.value(none, OptionType(PlanBlocksType)),
+            });
+        });
+        return East.value(Object.fromEntries(Object.keys(PlanEditingType.fields).map(field => [field, field === "entryIds" ? entryIds : field === "derive" ? derive : input[field]])), PlanEditingType);
+    };
+    return { resolved, make, editing };
+}
+//# sourceMappingURL=ordered-source.js.map

package/dist/src/plan/ordered-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordered-source.js","sourceRoot":"","sources":["../../../src/plan/ordered-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wFAAwF;AACxF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAiD,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACpK,OAAO,EAA0B,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,WAAW,EAAwB,MAAM,aAAa,CAAC;AAIhE,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC7C,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7F,4EAA4E;IAC5E,+EAA+E;IAC/E,uEAAuE;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClI,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;YACxF,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;gBACrE,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;aAC7E,CAAC,CAAC,CAAC,CAAC;YACL,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACnG,CAAC,CAAC;KACL,CAAC,CAAC,CAAC,CAAC;IACL,MAAM,IAAI,GAAG,CAAC,MAAuB,EAAE,MAA0B,EAA4B,EAAE;QAC3F,MAAM,KAAK,GAAG,MAAmC,CAAC;QAClD,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,KAAgC,EAA6B,EAAE;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;YAC/G,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnM,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC9I,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC;gBAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;gBAC5M,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;aAC3D,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,KAAyC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAU,EAAE,eAAe,CAAC,CAAC;IAClP,CAAC,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC"}