@elaraai/e3-ui 1.0.0

package/dist/test/data.examples.js

@@ -0,0 +1,156 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { East, FloatType, FunctionType, IntegerType, NullType, StringType, PatchType, variant, example } from "@elaraai/east";
+import { Reactive, Slider, Stack, Stat, Text, Input, Button, UIComponentType } from "@elaraai/east-ui";
+import { Data } from "@elaraai/e3-ui";
+import * as e3 from "@elaraai/e3";
+export const thresholdInput = e3.input('threshold', FloatType, 50.0);
+export const thresholdPatchInput = e3.input('threshold_patch', PatchType(FloatType), variant("unchanged", null));
+export const countInput = e3.input('count', IntegerType, 0n);
+export const nameInput = e3.input('name', StringType, '');
+export const dataBindFloat = example({
+    keywords: ["Data", "bind", "Reactive", "Float", "dataset", "read"],
+    description: "Bind to a Float dataset and display its current value",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path));
+            const value = $.let(thresh.read());
+            return Stat.Root("Threshold", value);
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindSliderWriteback = example({
+    keywords: ["Data", "bind", "Reactive", "Slider", "onChange", "write", "interactive"],
+    description: "Slider whose value is bound to a dataset — onChange writes back",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path));
+            const value = $.let(thresh.read());
+            return Slider.Root(value, {
+                min: 0,
+                max: 100,
+                onChangeEnd: thresh.writeAndStart,
+                disabled: thresh.status().hasTag('stale')
+            });
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindInteger = example({
+    keywords: ["Data", "bind", "Integer", "Input", "write", "interactive"],
+    description: "Integer dataset bound to a number input with writeback",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const count = $.let(Data.bind([IntegerType], countInput.path));
+            const value = $.let(count.read());
+            return Input.Integer(value, { onChange: count.write });
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindStringReset = example({
+    keywords: ["Data", "bind", "String", "callback", "Button", "reset", "write"],
+    description: "String dataset with a reset button that writes an empty string",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const name = $.let(Data.bind([StringType], nameInput.path));
+            const value = $.let(name.read());
+            const reset = $.const(East.function([], NullType, $ => {
+                $(name.write(""));
+            }));
+            return Stack.VStack([
+                Stat.Root("Name", value),
+                Button.Root("Reset", { style: { variant: "outline" }, onClick: reset }),
+            ], { gap: "3", align: "stretch" });
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindHasGuard = example({
+    keywords: ["Data", "bind", "has", "guard", "conditional", "Reactive"],
+    description: "Use has() to gate UI on whether a dataset has been written",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path));
+            const ready = $.let(thresh.has());
+            const message = $.let("(no data)");
+            $.if(ready, $ => {
+                $.assign(message, East.print(thresh.read()));
+            });
+            return Text.Root(message);
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindStagedFloat = example({
+    keywords: ["Data", "bindStaged", "Reactive", "Float", "buffered", "transactional"],
+    description: "Stage edits to a Float dataset; read returns overlay (buffered or server)",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path, { mode: "staged" }));
+            const value = $.let(thresh.read(), FloatType);
+            return Stat.Root("Threshold (live)", value);
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindStagedSliderWrite = example({
+    keywords: ["Data", "bindStaged", "Slider", "write", "buffer", "interactive"],
+    description: "Slider whose onChange writes to the staged buffer instead of the server",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path, { mode: "staged" }));
+            const value = $.let(thresh.read(), FloatType);
+            return Slider.Root(value, {
+                min: 0,
+                max: 100,
+                onChange: thresh.write,
+            });
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindStagedCommitDiscard = example({
+    keywords: ["Data", "bindStaged", "commit", "discard", "pending", "transactional"],
+    description: "Two buttons that commit or discard the staged buffer for a path",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path, { mode: "staged" }));
+            const commit = $.const(East.function([], NullType, $ => {
+                $(thresh.commit());
+            }), FunctionType([], NullType));
+            const discard = $.const(East.function([], NullType, $ => {
+                $(thresh.discard());
+            }), FunctionType([], NullType));
+            return Stack.VStack([
+                Text.Root("Pending edits"),
+                Button.Root("Commit", { onClick: commit }),
+                Button.Root("Discard", {
+                    style: { variant: "outline" },
+                    onClick: discard,
+                }),
+            ], { gap: "3", align: "stretch" });
+        }));
+    }),
+    inputs: [],
+});
+export const dataBindStagedOriginalVsRead = example({
+    keywords: ["Data", "bindStaged", "original", "read", "overlay", "diff"],
+    description: "Show server snapshot (original) and overlay (read) side by side",
+    fn: East.function([], UIComponentType, (_$) => {
+        return Reactive.Root(East.function([], UIComponentType, $ => {
+            const thresh = $.let(Data.bind([FloatType], thresholdInput.path, { mode: "staged", patch: thresholdPatchInput.path }));
+            const live = $.let(thresh.read(), FloatType);
+            const server = $.let(thresh.source(), FloatType);
+            return Stack.VStack([
+                Stat.Root("Server", server),
+                Stat.Root("Live (with stage)", live),
+            ], { gap: "3", align: "stretch" });
+        }));
+    }),
+    inputs: [],
+});
+//# sourceMappingURL=data.examples.js.map

package/dist/test/data.examples.js.map

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

package/dist/test/diff.examples.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Diff component examples — realistic editing scenes that combine
+ * `Data.bindStaged` with east-ui form components and a `Diff` panel
+ * surfacing the pending changes for sign-off.
+ *
+ * Coverage:
+ *   1. Slider-driven editor    → workforcePolicyEditor
+ *   2. Heterogeneous inputs    → serviceConfigForm
+ *   3. Editable Table cells    → rosterTableEditor
+ *   4. Mixed sliders + inputs  → pricingRulesEditor (side-by-side mode)
+ *   5. Minimal call site       → diffDefaults (IR-roundtrip)
+ *
+ * Pattern:
+ *   1. Declare an `e3.input(name, type, default)` per editable scalar.
+ *   2. Inside `Reactive.Root`, bind each via `Data.bindStaged`.
+ *   3. Wire form components — `read()` for the current value,
+ *      `write()` on change.
+ *   4. Close the scene with `Diff.Root({ staged: [...inputs.path] })` —
+ *      Apply commits the merged batch; Discard drops the buffer.
+ */
+import { FloatType, IntegerType, StringType, BooleanType, DateTimeType, ArrayType, StructType, SetType, DictType, VariantType, NullType, variant } from "@elaraai/east";
+import * as e3 from "@elaraai/e3";
+export declare const maxWeeklyHoursInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "max_weekly_hours">]>;
+export declare const overtimeThresholdInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "overtime_threshold_hours">]>;
+export declare const restGapHoursInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "mandatory_rest_gap_hours">]>;
+export declare const holidayPenaltyInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "public_holiday_penalty">]>;
+export declare const serviceNameInput: e3.DatasetDef<StringType, [variant<"field", "inputs">, variant<"field", "service_name">]>;
+export declare const replicasInput: e3.DatasetDef<IntegerType, [variant<"field", "inputs">, variant<"field", "replicas">]>;
+export declare const autoScaleInput: e3.DatasetDef<BooleanType, [variant<"field", "inputs">, variant<"field", "auto_scale">]>;
+export declare const regionInput: e3.DatasetDef<StringType, [variant<"field", "inputs">, variant<"field", "region">]>;
+export declare const deployAfterInput: e3.DatasetDef<DateTimeType, [variant<"field", "inputs">, variant<"field", "deploy_after">]>;
+export declare const rosterInput: e3.DatasetDef<ArrayType<StructType<{
+    readonly id: StringType;
+    readonly name: StringType;
+    readonly rate: FloatType;
+    readonly shiftLength: IntegerType;
+}>>, [variant<"field", "inputs">, variant<"field", "roster">]>;
+export declare const mergeDemoHoursInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "merge_demo_hours">]>;
+export declare const listPriceInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "list_price">]>;
+export declare const discountPctInput: e3.DatasetDef<FloatType, [variant<"field", "inputs">, variant<"field", "discount_pct">]>;
+export declare const minOrderQtyInput: e3.DatasetDef<IntegerType, [variant<"field", "inputs">, variant<"field", "min_order_qty">]>;
+export declare const currencyCodeInput: e3.DatasetDef<StringType, [variant<"field", "inputs">, variant<"field", "currency_code">]>;
+export declare const featureFlagsInput: e3.DatasetDef<SetType<StringType>, [variant<"field", "inputs">, variant<"field", "feature_flags">]>;
+export declare const regionalPricesInput: e3.DatasetDef<DictType<StringType, FloatType>, [variant<"field", "inputs">, variant<"field", "regional_prices">]>;
+export declare const deploymentStatusInput: e3.DatasetDef<VariantType<{
+    readonly pending: NullType;
+    readonly in_progress: NullType;
+    readonly complete: NullType;
+    readonly failed: NullType;
+}>, [variant<"field", "inputs">, variant<"field", "deployment_status">]>;
+export declare const workforcePolicyEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const serviceConfigForm: import("@elaraai/east").ExampleDef<[], any>;
+export declare const rosterTableEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const pricingRulesEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const featureFlagsEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const regionalPricingEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const deploymentStatusEditor: import("@elaraai/east").ExampleDef<[], any>;
+export declare const diffDefaults: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Demonstrates the staged-mode merge tool / orange chooser. Workflow:
+ *
+ *   1. Drag the slider — your edit gets staged (snapshot pinned in StagedStore).
+ *   2. Click "Simulate concurrent edit" — `Data.bind.write(42.0)` writes 42 to
+ *      the same path through the live cache, mimicking another session
+ *      committing while you have edits open. Server view is now 42; your
+ *      pinned snapshot is still 38; your buffer is whatever you dragged to.
+ *   3. Click Apply — `detectConflictsFor(userPatch, serverPatch)` finds both
+ *      sides touching the root, switches the renderer to conflict mode, and
+ *      shows the orange chooser row: keep yours (your dragged value), keep
+ *      theirs (42), or manual (type a fresh number).
+ */
+export declare const mergeConflictDemo: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Pricing-rules editor at `compact` density — tighter row padding and smaller
+ * type scale than the default `comfortable`. Suited to data-dense pages where
+ * the Diff card is one of several panels competing for vertical space.
+ */
+export declare const pricingRulesEditorCompact: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Pricing-rules editor at `condensed` density — mission-control sizing.
+ * Tightest row padding and smallest type scale; pairs with status dashboards
+ * and other read-heavy contexts where a diff list is reference data, not the
+ * main interaction surface.
+ */
+export declare const pricingRulesEditorCondensed: import("@elaraai/east").ExampleDef<[], any>;
+export declare const maxWeeklyHoursPatchInput: e3.DatasetDef<import("@elaraai/east").EastType, [variant<"field", "inputs">, variant<"field", "max_weekly_hours_patch">]>;
+export declare const regionalPricesPatchInput: e3.DatasetDef<import("@elaraai/east").EastType, [variant<"field", "inputs">, variant<"field", "regional_prices_patch">]>;
+export declare const rosterPatchInput: e3.DatasetDef<import("@elaraai/east").EastType, [variant<"field", "inputs">, variant<"field", "roster_patch">]>;
+export declare const regionalPricesDriftPatchInput: e3.DatasetDef<import("@elaraai/east").EastType, [variant<"field", "inputs">, variant<"field", "regional_prices_drift_patch">]>;
+export declare const rosterDriftPatchInput: e3.DatasetDef<import("@elaraai/east").EastType, [variant<"field", "inputs">, variant<"field", "roster_drift_patch">]>;
+/**
+ * Single-Float overlay editor — Slider edits go to `max_weekly_hours_patch`,
+ * the Diff card surfaces the patch against the source.
+ */
+export declare const policyOverlayEditor: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Overlay binding whose patch input *starts* with a non-trivial patch that
+ * is stale relative to the source. Demonstrates what the Diff card displays
+ * when a server-stored patch was authored against an older revision of its
+ * source — stale delete, stale insert, stale replace.
+ *
+ * No form components: `view.read()` calls `apply(source, patch)`, which
+ * throws `ConflictError` on the stale ops. The Diff card walks the patch IR
+ * directly from cache bytes (no apply) so it renders cleanly. The
+ * `bindOverlay` call is kept so the renderer's overlay-type registry knows
+ * how to decode the patch bytes for this binding.
+ */
+export declare const regionalPricingOverlayDrift: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Roster overlay drift — array-of-structs patch surfaced by the Diff card,
+ * exercising nested grouping (binding → `[index]` → struct field). The patch
+ * touches only `rate` on the first two entries, so the card renders
+ * `ROSTER → [0] → rate`, `[1] → rate`.
+ */
+export declare const rosterOverlayDrift: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Roster table editor in overlay mode — patches stored in `roster_patch`,
+ * survive page reload and are visible to other workspace sessions.
+ */
+export declare const rosterTableEditorOverlay: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Single-Float staged-with-patch editor — buffered Slider edits publish to
+ * `max_weekly_hours_patch` on Apply. The source `max_weekly_hours` stays
+ * untouched until a separate apply-patch-to-source step.
+ */
+export declare const policyStagedPatchEditor: import("@elaraai/east").ExampleDef<[], any>;
+/**
+ * Roster table editor in staged + patch mode. Cell edits buffer in
+ * IndexedDB until Apply, which publishes a fresh patch to `roster_patch`.
+ * Survives reload as a draft; multi-session reviewers see the patch only
+ * after the author commits.
+ */
+export declare const rosterStagedPatchEditor: import("@elaraai/east").ExampleDef<[], any>;
+//# sourceMappingURL=diff.examples.d.ts.map

package/dist/test/diff.examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.examples.d.ts","sourceRoot":"","sources":["../../test/diff.examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEH,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,WAAW,EACX,QAAQ,EAIR,OAAO,EAEV,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAQlC,eAAO,MAAM,mBAAmB,8FAA6D,CAAC;AAC9F,eAAO,MAAM,sBAAsB,sGAA0D,CAAC;AAC9F,eAAO,MAAM,iBAAiB,sGAA+D,CAAC;AAC9F,eAAO,MAAM,mBAAmB,oGAA4D,CAAC;AAG7F,eAAO,MAAM,gBAAgB,2FAAwD,CAAC;AACtF,eAAO,MAAM,aAAa,wFAAmD,CAAC;AAC9E,eAAO,MAAM,cAAc,0FAAqD,CAAC;AACjF,eAAO,MAAM,WAAW,qFAAmE,CAAC;AAC5F,eAAO,MAAM,gBAAgB,6FAA8E,CAAC;AAU5G,eAAO,MAAM,WAAW;;;;;8DAKtB,CAAC;AAMH,eAAO,MAAM,mBAAmB,8FAAgD,CAAC;AAGjF,eAAO,MAAM,cAAc,wFAAyD,CAAC;AACrF,eAAO,MAAM,gBAAgB,0FAAsD,CAAC;AACpF,eAAO,MAAM,gBAAgB,6FAAoD,CAAC;AAClF,eAAO,MAAM,iBAAiB,4FAAsD,CAAC;AAGrF,eAAO,MAAM,iBAAiB,qGAI7B,CAAC;AAGF,eAAO,MAAM,mBAAmB,mHAS/B,CAAC;AASF,eAAO,MAAM,qBAAqB;;;;;wEAIjC,CAAC;AAMF,eAAO,MAAM,qBAAqB,6CAmDhC,CAAC;AAOH,eAAO,MAAM,iBAAiB,6CAsE5B,CAAC;AAQH,eAAO,MAAM,iBAAiB,6CAyE5B,CAAC;AAOH,eAAO,MAAM,kBAAkB,6CAmD7B,CAAC;AAOH,eAAO,MAAM,kBAAkB,6CAuE7B,CAAC;AAOH,eAAO,MAAM,qBAAqB,6CAiEhC,CAAC;AAOH,eAAO,MAAM,sBAAsB,6CAoCjC,CAAC;AAMH,eAAO,MAAM,YAAY,6CAUvB,CAAC;AAUH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,6CAgD5B,CAAC;AAQH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,6CAsCpC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,6CAsCtC,CAAC;AASH,eAAO,MAAM,wBAAwB,2HAIpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,0HAIpC,CAAC;AAEF,eAAO,MAAM,gBAAgB,iHAI5B,CAAC;AAWF,eAAO,MAAM,6BAA6B,gIASzC,CAAC;AAkBF,eAAO,MAAM,qBAAqB,uHAIjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,6CA0B9B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,6CA8BtC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,6CA2B7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,6CAyEnC,CAAC;AAUH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,6CA2BlC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,6CAuElC,CAAC"}