@elaraai/east-ui 1.0.67 → 1.0.69

package/dist/src/collections/plan/root.js

@@ -0,0 +1,146 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The Plan root — `Plan.Root`, which assembles the whole canvas value against
+ * the `component.ts` arm.
+ *
+ * @packageDocumentation
+ */
+import { East, ArrayType, BooleanType, DictType, FunctionType, NullType, OptionType, StringType, StructType, variant, some, none, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import { StatusValueType } from "../../feedback/status/types.js";
+import { DensityType } from "../../style/interaction.js";
+import { buildReview } from "../../contracts/review.js";
+import { DragEventType } from "../../contracts/drag.js";
+import { SliceBindType, SliceChromeType } from "../../platform/slice/index.js";
+import { SliceAffordanceType } from "../../contracts/slice-affordances.js";
+import { PlanAxisType, PlanGrainType, PlanLinkType, PlanRowRefType, PlanRunClickEventType, PlanEventClickEventType, PlanMarkClickEventType, PlanChipClickEventType, PlanCellClickEventType, PlanGroupToggleEventType, PlanFooterItemType, PlanStyleType, PlanElementRefType, PlanRowsCollectionType, PlanRowsType, } from "./types.js";
+import { PlanReviewType } from "./ir.js";
+import { resolveTag } from "./builders.js";
+import { applySeries, PlanSeriesType } from "./series.js";
+import { seriesSignature } from "./pick.js";
+import { pickActive, PickBindType } from "../../contracts/pick.js";
+import { resolveRowSource, buildRowSource } from "../../contracts/source.js";
+// ============================================================================
+// Root
+// ============================================================================
+/** The default slice affordance list (§1 toolbar). */
+const DEFAULT_PLAN_AFFORDANCES = ["cohort", "filter", "search", "range", "resolution", "brush", "summary"];
+/**
+ * Creates the Plan root — the whole canvas.
+ *
+ * @typeParam K - The canvas's axis kind, inferred from `config.axis`; every series must lie within it
+ * @param config - The Plan configuration ({@link PlanConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @remarks
+ * Window and resolution have no callbacks by design: they are slice writes
+ * (`setRange` / `setResolution`) — hosts observe the slice. Dragging a
+ * proposal is a Modify on its decision, not a free edit — host semantics
+ * behind `onDrag`; the surface only reports.
+ */
+export function createPlanRoot(config) {
+    // 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.
+    if (config.data === undefined) {
+        throw new Error("Plan: `data` is required — a canvas is its data plus the series over it");
+    }
+    if ((config.series === undefined) === (config.pick === undefined)) {
+        throw new Error("Plan: give exactly one of `series` or `pick` — `series` for a fixed canvas, " +
+            "`pick` for a pickable one. A `Plan.pick` handle already carries the series list, " +
+            "so passing both says it twice and lets the two disagree.");
+    }
+    // A pick feeds the canvas its SURVIVING series; everything downstream —
+    // application, the paged signature — sees one series input either way.
+    const seriesInput = config.pick !== undefined
+        ? pickActive(config.pick)
+        : config.series;
+    // 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 domain
+    // rows into canvas rows (the single R-erasure point).
+    const resolved = resolveRowSource(config.data, "Plan");
+    // The canvas is KEYED, so its source must be: a leaf row's key is its data
+    // key, which is what keeps the canvas addressable by the keys the source is
+    // searched and windowed by (#568). Refuse anything else here rather than
+    // inventing keys the source does not have.
+    const keyType = resolved.keyType?.type;
+    if (keyType !== "String") {
+        const got = resolved.collectionType.type;
+        const keyed = keyType !== undefined ? ` keyed by ${keyType}` : "";
+        throw new Error("Plan: `data` must be a keyed collection (`Dict<String, R>`) — its keys become the " +
+            "canvas row keys, so the canvas is ordered and addressed the same way the source is " +
+            "(the row space a paged source windows and seeks). " +
+            `Got a ${got}${keyed}; key it at the call site, e.g. ` +
+            "`data={rows.toDict((_$, r) => r.id)}`.");
+    }
+    const rowsValue = buildRowSource(resolved, PlanRowsCollectionType, (source) => applySeries(seriesInput, source), 
+    // The paged source's rows depend on WHICH series are active — a pick
+    // narrows the list — so the derived id has to say which. Without it a
+    // toggle leaves resident windows serving rows nobody asked for.
+    seriesSignature(seriesInput));
+    const style = config.style;
+    const styleValue = style !== undefined
+        ? some(East.value({
+            height: style.height !== undefined ? some(style.height) : none,
+            maxHeight: style.maxHeight !== undefined ? some(style.maxHeight) : none,
+            density: style.density !== undefined ? some(resolveTag(style.density, DensityType)) : none,
+            gutterWidth: style.gutterWidth !== undefined ? some(style.gutterWidth) : none,
+        }, PlanStyleType))
+        : none;
+    const sliceChrome = config.slice !== undefined
+        ? some(East.value({
+            slice: config.slice.slice,
+            affordances: East.value((config.slice.affordances ?? DEFAULT_PLAN_AFFORDANCES).map(a => variant(a, null)), ArrayType(SliceAffordanceType)),
+        }, SliceChromeType))
+        : none;
+    return East.value(variant("Plan", {
+        rows: rowsValue,
+        links: East.value(config.links ?? [], ArrayType(PlanLinkType)),
+        axis: config.axis,
+        grain: config.grain !== undefined ? some(resolveTag(config.grain, PlanGrainType)) : none,
+        // East.value pins the exact function type (the Schematic `itemHover`
+        // pattern) so the arm's recursion-marker slots unify.
+        popover: config.popover !== undefined
+            ? some(East.value(config.popover, FunctionType([PlanElementRefType], OptionType(UIComponentType))))
+            : none,
+        hover: config.hover !== undefined
+            ? some(East.value(config.hover, FunctionType([PlanElementRefType], OptionType(UIComponentType))))
+            : none,
+        expandRender: config.expandRender !== undefined
+            ? some(East.value(config.expandRender, FunctionType([PlanRowRefType], UIComponentType)))
+            : none,
+        expandGutter: config.expandGutter !== undefined
+            ? some(East.value(config.expandGutter, FunctionType([PlanRowRefType], UIComponentType)))
+            : none,
+        review: config.review !== undefined ? some(buildReview(config.review, PlanReviewType)) : none,
+        // The library rides as chrome, like the slice rail: the non-generic
+        // contract only, since the arm must stay a closed East type.
+        pick: config.pick !== undefined
+            ? some(East.value(config.pick.pick, PickBindType))
+            : none,
+        slice: sliceChrome,
+        footer: (config.footer ?? []).map(f => East.value({
+            text: f.text,
+            tone: f.tone !== undefined ? some(resolveTag(f.tone, StatusValueType)) : none,
+            end: f.end !== undefined ? some(f.end) : none,
+        }, PlanFooterItemType)),
+        id: config.id ?? "",
+        sources: East.value(config.sources ?? [], ArrayType(StringType)),
+        onDrag: config.onDrag !== undefined ? some(config.onDrag) : none,
+        canDrop: config.canDrop !== undefined ? some(config.canDrop) : none,
+        onSelect: config.onSelect !== undefined ? some(config.onSelect) : none,
+        onRunClick: config.onRunClick !== undefined ? some(config.onRunClick) : none,
+        onEventClick: config.onEventClick !== undefined ? some(config.onEventClick) : none,
+        onMarkClick: config.onMarkClick !== undefined ? some(config.onMarkClick) : none,
+        onChipClick: config.onChipClick !== undefined ? some(config.onChipClick) : none,
+        onCellClick: config.onCellClick !== undefined ? some(config.onCellClick) : none,
+        onGroupToggle: config.onGroupToggle !== undefined ? some(config.onGroupToggle) : none,
+        onGrainChange: config.onGrainChange !== undefined ? some(config.onGrainChange) : none,
+        style: styleValue,
+    }), UIComponentType);
+}
+//# sourceMappingURL=root.js.map

package/dist/src/collections/plan/root.js.map

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