@elaraai/e3-ui 1.0.12 → 1.0.14

package/dist/test/bind/record/record.examples.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@elaraai/e3-ui/jsx-runtime";
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** @jsxImportSource @elaraai/e3-ui */
+import { East, IntegerType, NullType, example } from "@elaraai/east";
+import { Button, HStack, Reactive, Stat, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+import { Record } from "@elaraai/e3-ui";
+import e3 from "@elaraai/e3";
+// The package-side record + mutation definitions. `Record.bind` takes the
+// record def + its mutations — the state type, mutation names and arg types
+// all come from them, so the binding can never drift from the deployed record.
+export const counter = e3.record("counter", IntegerType, 0n);
+export const increment = e3.mutation("increment", counter, East.function([IntegerType, IntegerType], IntegerType, ($, state, by) => state.add(by)));
+export const reset = e3.mutation("reset", counter, East.function([IntegerType], IntegerType, (_$, _state) => 0n));
+export const recordBindMutate = example({
+    keywords: ["Record", "bind", "mutate", "Reactive", "Button", "read", "pending", "status", "system of record"],
+    description: "Bind an e3.record + its mutations; buttons apply typed mutations, a stat shows the current state, and the mutate lifecycle status is rendered",
+    fn: East.function([], UIComponentType, (_$) => (_jsx(Reactive, { children: $ => {
+            const r = $.let(Record.bind(counter, [increment, reset]));
+            const status = $.let(r.mutate.status().getTag().upperCase());
+            // Surface the failure detail so a failed mutation shows WHY, not just
+            // that it failed.
+            const detail = $.let(r.mutate.error().match({
+                some: (_$, e) => e.message,
+                none: _$ => East.str ``,
+            }));
+            const bump = $.const(East.function([], NullType, $ => {
+                $(r.mutate.increment(1n));
+            }));
+            const clear = $.const(East.function([], NullType, $ => {
+                $(r.mutate.reset());
+            }));
+            // A mutation commits the record but does not propagate; `start`
+            // launches the workspace dataflow so tasks consuming the record
+            // recompute. Queued behind any in-flight mutation.
+            const run = $.const(East.function([], NullType, $ => {
+                $(r.start());
+            }));
+            return (_jsxs(VStack, { gap: "3", align: "stretch", children: [_jsx(Stat, { label: "Counter", value: East.print(r.read()) }), _jsxs(HStack, { gap: "2", children: [_jsx(Button, { onClick: bump, loading: r.mutate.pending(), children: "Increment" }), _jsx(Button, { variant: "outline", onClick: clear, children: "Reset" }), _jsx(Button, { variant: "ghost", onClick: run, children: "Run downstream" })] }), _jsx(Text.MonoLabel, { children: status }), _jsx(Text, { color: "fg.muted", children: detail })] }));
+        } }))),
+    inputs: [],
+});
+export const recordBindStatus = example({
+    keywords: ["Record", "bind", "status", "error", "lifecycle", "mutate"],
+    description: "Render the mutation lifecycle (idle / running / committed / failed / cancelled) and any failure",
+    fn: East.function([], UIComponentType, (_$) => (_jsx(Reactive, { children: $ => {
+            const r = $.let(Record.bind(counter, [increment]));
+            const bump = $.const(East.function([], NullType, $ => { $(r.mutate.increment(1n)); }));
+            const statusLine = $.let(r.mutate.status().getTag().upperCase());
+            const detail = $.let(r.mutate.error().match({
+                some: (_$, e) => e.message,
+                none: _$ => East.print(r.read()),
+            }));
+            return (_jsxs(VStack, { gap: "3", align: "stretch", children: [_jsx(Button, { onClick: bump, loading: r.mutate.pending(), children: "Increment" }), _jsx(Text.MonoLabel, { children: statusLine }), _jsx(Text, { color: "fg.muted", children: detail })] }));
+        } }))),
+    inputs: [],
+});
+export const recordBindHistory = example({
+    keywords: ["Record", "bind", "history", "audit", "commit", "chain"],
+    description: "Read the record's commit history (the audit trail) alongside its current value",
+    fn: East.function([], UIComponentType, (_$) => (_jsx(Reactive, { children: $ => {
+            const r = $.let(Record.bind(counter, [increment]));
+            const count = $.let(r.history().match({
+                some: (_$, commits) => commits.size(),
+                none: _$ => 0n,
+            }));
+            return (_jsxs(VStack, { gap: "3", align: "stretch", children: [_jsx(Stat, { label: "Counter", value: East.print(r.read()) }), _jsx(Text.MonoLabel, { children: East.str `${count} COMMITS` })] }));
+        } }))),
+    inputs: [],
+});
+//# sourceMappingURL=record.examples.js.map

package/dist/test/bind/record/record.examples.js.map

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