@elaraai/east-ui 1.0.39 → 1.0.41

package/dist/src/runtime/collections/deck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/deck.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAEH,KAAK,UAAU,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,iBAAS,OAAO,CAAC,CAAC,SAAS,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAChE,KAAK,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAC/C,QAAQ,CAAC,eAAe,CAAC,CAG3B;AAED,wEAAwE;AACxE,eAAO,MAAM,IAAI;;;;cAC2zV,CAAC;;;;;;;;;;;;YAAmF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD12V,CAAC"}

package/dist/src/runtime/collections/deck.js

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Deck>` tag — see the export's JSDoc. */
+import { ArrayType, StructType } from "@elaraai/east";
+import { Deck as DeckFactory, } from "../../collections/deck/index.js";
+import { UIComponentType } from "../../component.js";
+/**
+ * `<Deck>` — a declarative grouped card collection: `data` rows rendered
+ * as presentation cards (structured face via the `card` accessor, or a
+ * fully custom face via `render`), grouped by named GROUP BY toolbar
+ * options, filtered by slice chrome, laid out as a wrapping card grid
+ * (desktop rows → one phone column) or a single-column list. Cards are
+ * tap targets (`onCardClick`) — for a drag-and-drop palette use
+ * `<Library>` instead.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Deck, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const surface = East.function([], UIComponentType, _$ => (
+ *     <Deck
+ *         data={[
+ *             { id: "a-201", name: "Line A", state: "RUNNING", team: "Alpha", load: 0.62 },
+ *             { id: "b-114", name: "Line B", state: "DOWN", team: "Beta", load: 0.0 },
+ *         ]}
+ *         card={r => ({
+ *             key: r.id, title: r.name, sublabel: r.team,
+ *             status: Deck.status(r.state, "info"),
+ *             facts: [Deck.meter("Load", r.load.multiply(100.0), 100.0, East.print(r.load))],
+ *         })}
+ *         groupBy={[
+ *             { key: "state", label: "Status", value: r => r.state },
+ *             { key: "team", label: "Team", value: r => r.team },
+ *         ]}
+ *         search={r => r.name}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Deck.status` / `Deck.meter` / `Deck.chips` / `Deck.text` value
+ * constructors and `Deck.Types`. Desugars to `Deck.Root(data, config)`.
+ */
+function DeckTag(props) {
+    const { data, ...config } = props;
+    return DeckFactory.Root(data, config);
+}
+/** The callable `<Deck>` tag carrying the factory namespace statics. */
+export const Deck = Object.assign(DeckTag, DeckFactory);
+//# sourceMappingURL=deck.js.map

package/dist/src/runtime/collections/deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deck.js","sourceRoot":"","sources":["../../../../src/runtime/collections/deck.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAE7C,OAAO,EAA0C,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EACH,IAAI,IAAI,WAAW,GAEtB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAS,OAAO,CACZ,KAA8C;IAE9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAClC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,MAAmC,CAAC,CAAC;AACvE,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC"}

package/dist/src/runtime/collections/index.d.ts

@@ -10,6 +10,8 @@ export { Table } from "./table.js";
 export { Matrix } from "./matrix.js";
 export { Gantt } from "./gantt.js";
 export { Planner } from "./planner.js";
+export { Deck } from "./deck.js";
+export { ValueTree } from "./value-tree.js";
 export { Library } from "./library.js";
 export { Roster } from "./roster.js";
 export { Board } from "./board.js";

package/dist/src/runtime/collections/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/runtime/collections/index.js

@@ -10,6 +10,8 @@ export { Table } from "./table.js";
 export { Matrix } from "./matrix.js";
 export { Gantt } from "./gantt.js";
 export { Planner } from "./planner.js";
+export { Deck } from "./deck.js";
+export { ValueTree } from "./value-tree.js";
 export { Library } from "./library.js";
 export { Roster } from "./roster.js";
 export { Board } from "./board.js";

package/dist/src/runtime/collections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/runtime/collections/value-tree.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ValueTree>` tag — see the export's JSDoc. */
+import { type EastType, type Expr, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
+import { type ValueTreeOptions } from "../../collections/value-tree/index.js";
+import { UIComponentType } from "../../component.js";
+/**
+ * `<ValueTree>` — the editable tree of any East value: the `value` prop's
+ * STATIC East type is walked at authoring time and materialized into a
+ * fixed recursive node IR (structs, arrays, string-keyed dicts, options
+ * and variants become branches; primitives become typed editable leaves;
+ * everything else summarizes read-only). Pass `onUpdate` (and optionally
+ * `at` scopes built with `ValueTree.at`) to receive the whole rebuilt
+ * value — or subtree — after every edit; the raw path callbacks
+ * (`onEdit` / `onInsert` / `onRemove` / `onTag`) remain for hosts with a
+ * finer-grained store. Omit all callbacks for a read-only inspector.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { ValueTree, UIComponentType } from "@elaraai/east-ui";
+ *
+ * // Read-only inspector — any value materializes automatically.
+ * const surface = East.function([], UIComponentType, _$ => (
+ *     <ValueTree
+ *         value={{
+ *             rate: 0.15,
+ *             label: "Base",
+ *             tags: ["a", "b"],
+ *         }}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ValueTree.at` (scoped subtree handlers), `ValueTree.zero`
+ * (host-side default element for raw `onInsert` handlers) and
+ * `ValueTree.Types`. Desugars to `ValueTree.Root(value, options)`.
+ */
+declare function ValueTreeTag<T extends EastType>(props: {
+    value: SubtypeExprOrValue<T> | Expr;
+} & ValueTreeOptions<T>): ExprType<UIComponentType>;
+/** The callable `<ValueTree>` tag carrying the factory namespace statics. */
+export declare const ValueTree: typeof ValueTreeTag & {
+    readonly Root: <T extends EastType>(value: SubtypeExprOrValue<T> | Expr, options?: ValueTreeOptions<T>) => ExprType<UIComponentType>;
+    readonly at: <T extends EastType, S extends EastType>(root: T, path: (probe: import("../../collections/value-tree/index.js").ValueTreeProbe<T>) => {
+        readonly __vt?: S;
+    }, onUpdate: SubtypeExprOrValue<import("@elaraai/east").FunctionType<[S], import("@elaraai/east").NullType>> | SubtypeExprOrValue<import("@elaraai/east").AsyncFunctionType<[S], import("@elaraai/east").NullType>>) => import("../../collections/value-tree/index.js").ValueTreeScope;
+    readonly zero: <T extends EastType>(t: T) => import("@elaraai/east").ValueTypeOf<T>;
+    readonly materialize: typeof import("../../collections/value-tree/materialize.js").materialize;
+    readonly applyEdit: typeof import("../../collections/value-tree/materialize.js").applyEdit;
+    readonly Types: {
+        readonly Root: import("@elaraai/east").StructType<{
+            readonly root: import("@elaraai/east").RecursiveType<import("@elaraai/east").VariantType<{
+                readonly struct: import("@elaraai/east").StructType<{
+                    readonly fields: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                        readonly name: import("@elaraai/east").StringType;
+                        readonly node: import("@elaraai/east").RecursiveTypeMarker;
+                    }>>;
+                }>;
+                readonly array: import("@elaraai/east").StructType<{
+                    readonly items: import("@elaraai/east").ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+                }>;
+                readonly dict: import("@elaraai/east").StructType<{
+                    readonly entries: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                        readonly key: import("@elaraai/east").StringType;
+                        readonly node: import("@elaraai/east").RecursiveTypeMarker;
+                    }>>;
+                    readonly editable: import("@elaraai/east").BooleanType;
+                }>;
+                readonly option: import("@elaraai/east").StructType<{
+                    readonly value: import("@elaraai/east").OptionType<import("@elaraai/east").RecursiveTypeMarker>;
+                }>;
+                readonly variant: import("@elaraai/east").StructType<{
+                    readonly tag: import("@elaraai/east").StringType;
+                    readonly tags: import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>;
+                    readonly value: import("@elaraai/east").RecursiveTypeMarker;
+                }>;
+                readonly leaf: import("@elaraai/east").VariantType<{
+                    readonly string: import("@elaraai/east").StringType;
+                    readonly integer: import("@elaraai/east").IntegerType;
+                    readonly float: import("@elaraai/east").FloatType;
+                    readonly boolean: import("@elaraai/east").BooleanType;
+                    readonly datetime: import("@elaraai/east").DateTimeType;
+                    readonly null: import("@elaraai/east").NullType;
+                }>;
+                readonly opaque: import("@elaraai/east").StringType;
+            }>>;
+            readonly onEdit: import("@elaraai/east").OptionType<import("@elaraai/east").AsyncFunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly append: import("@elaraai/east").NullType;
+                readonly field: import("@elaraai/east").StringType;
+                readonly index: import("@elaraai/east").IntegerType;
+                readonly key: import("@elaraai/east").StringType;
+                readonly some: import("@elaraai/east").NullType;
+                readonly tag: import("@elaraai/east").NullType;
+            }>>, import("@elaraai/east").VariantType<{
+                readonly string: import("@elaraai/east").StringType;
+                readonly integer: import("@elaraai/east").IntegerType;
+                readonly float: import("@elaraai/east").FloatType;
+                readonly boolean: import("@elaraai/east").BooleanType;
+                readonly datetime: import("@elaraai/east").DateTimeType;
+                readonly null: import("@elaraai/east").NullType;
+            }>], import("@elaraai/east").NullType>>;
+            readonly onInsert: import("@elaraai/east").OptionType<import("@elaraai/east").AsyncFunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly append: import("@elaraai/east").NullType;
+                readonly field: import("@elaraai/east").StringType;
+                readonly index: import("@elaraai/east").IntegerType;
+                readonly key: import("@elaraai/east").StringType;
+                readonly some: import("@elaraai/east").NullType;
+                readonly tag: import("@elaraai/east").NullType;
+            }>>], import("@elaraai/east").NullType>>;
+            readonly onRemove: import("@elaraai/east").OptionType<import("@elaraai/east").AsyncFunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly append: import("@elaraai/east").NullType;
+                readonly field: import("@elaraai/east").StringType;
+                readonly index: import("@elaraai/east").IntegerType;
+                readonly key: import("@elaraai/east").StringType;
+                readonly some: import("@elaraai/east").NullType;
+                readonly tag: import("@elaraai/east").NullType;
+            }>>], import("@elaraai/east").NullType>>;
+            readonly onTag: import("@elaraai/east").OptionType<import("@elaraai/east").AsyncFunctionType<[import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+                readonly append: import("@elaraai/east").NullType;
+                readonly field: import("@elaraai/east").StringType;
+                readonly index: import("@elaraai/east").IntegerType;
+                readonly key: import("@elaraai/east").StringType;
+                readonly some: import("@elaraai/east").NullType;
+                readonly tag: import("@elaraai/east").NullType;
+            }>>, import("@elaraai/east").StringType], import("@elaraai/east").NullType>>;
+            readonly style: import("@elaraai/east").OptionType<import("@elaraai/east").StructType<{
+                readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+                readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+            }>>;
+        }>;
+        readonly Node: import("@elaraai/east").RecursiveType<import("@elaraai/east").VariantType<{
+            readonly struct: import("@elaraai/east").StructType<{
+                readonly fields: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                    readonly name: import("@elaraai/east").StringType;
+                    readonly node: import("@elaraai/east").RecursiveTypeMarker;
+                }>>;
+            }>;
+            readonly array: import("@elaraai/east").StructType<{
+                readonly items: import("@elaraai/east").ArrayType<import("@elaraai/east").RecursiveTypeMarker>;
+            }>;
+            readonly dict: import("@elaraai/east").StructType<{
+                readonly entries: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+                    readonly key: import("@elaraai/east").StringType;
+                    readonly node: import("@elaraai/east").RecursiveTypeMarker;
+                }>>;
+                readonly editable: import("@elaraai/east").BooleanType;
+            }>;
+            readonly option: import("@elaraai/east").StructType<{
+                readonly value: import("@elaraai/east").OptionType<import("@elaraai/east").RecursiveTypeMarker>;
+            }>;
+            readonly variant: import("@elaraai/east").StructType<{
+                readonly tag: import("@elaraai/east").StringType;
+                readonly tags: import("@elaraai/east").ArrayType<import("@elaraai/east").StringType>;
+                readonly value: import("@elaraai/east").RecursiveTypeMarker;
+            }>;
+            readonly leaf: import("@elaraai/east").VariantType<{
+                readonly string: import("@elaraai/east").StringType;
+                readonly integer: import("@elaraai/east").IntegerType;
+                readonly float: import("@elaraai/east").FloatType;
+                readonly boolean: import("@elaraai/east").BooleanType;
+                readonly datetime: import("@elaraai/east").DateTimeType;
+                readonly null: import("@elaraai/east").NullType;
+            }>;
+            readonly opaque: import("@elaraai/east").StringType;
+        }>>;
+        readonly Path: import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+            readonly append: import("@elaraai/east").NullType;
+            readonly field: import("@elaraai/east").StringType;
+            readonly index: import("@elaraai/east").IntegerType;
+            readonly key: import("@elaraai/east").StringType;
+            readonly some: import("@elaraai/east").NullType;
+            readonly tag: import("@elaraai/east").NullType;
+        }>>;
+        readonly Step: import("@elaraai/east").VariantType<{
+            readonly append: import("@elaraai/east").NullType;
+            readonly field: import("@elaraai/east").StringType;
+            readonly index: import("@elaraai/east").IntegerType;
+            readonly key: import("@elaraai/east").StringType;
+            readonly some: import("@elaraai/east").NullType;
+            readonly tag: import("@elaraai/east").NullType;
+        }>;
+        readonly Leaf: import("@elaraai/east").VariantType<{
+            readonly string: import("@elaraai/east").StringType;
+            readonly integer: import("@elaraai/east").IntegerType;
+            readonly float: import("@elaraai/east").FloatType;
+            readonly boolean: import("@elaraai/east").BooleanType;
+            readonly datetime: import("@elaraai/east").DateTimeType;
+            readonly null: import("@elaraai/east").NullType;
+        }>;
+        readonly Style: import("@elaraai/east").StructType<{
+            readonly height: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+            readonly maxHeight: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+        }>;
+    };
+};
+export {};
+//# sourceMappingURL=value-tree.d.ts.map

package/dist/src/runtime/collections/value-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-tree.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/value-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EAEH,KAAK,gBAAgB,EACxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,QAAQ,EACpC,KAAK,EAAE;IAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;CAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,GACrE,QAAQ,CAAC,eAAe,CAAC,CAG3B;AAED,6EAA6E;AAC7E,eAAO,MAAM,SAAS;;;qBAC02uB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD3zuB,CAAC"}

package/dist/src/runtime/collections/value-tree.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ValueTree>` tag — see the export's JSDoc. */
+import {} from "@elaraai/east";
+import { ValueTree as ValueTreeFactory, } from "../../collections/value-tree/index.js";
+import { UIComponentType } from "../../component.js";
+/**
+ * `<ValueTree>` — the editable tree of any East value: the `value` prop's
+ * STATIC East type is walked at authoring time and materialized into a
+ * fixed recursive node IR (structs, arrays, string-keyed dicts, options
+ * and variants become branches; primitives become typed editable leaves;
+ * everything else summarizes read-only). Pass `onUpdate` (and optionally
+ * `at` scopes built with `ValueTree.at`) to receive the whole rebuilt
+ * value — or subtree — after every edit; the raw path callbacks
+ * (`onEdit` / `onInsert` / `onRemove` / `onTag`) remain for hosts with a
+ * finer-grained store. Omit all callbacks for a read-only inspector.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { ValueTree, UIComponentType } from "@elaraai/east-ui";
+ *
+ * // Read-only inspector — any value materializes automatically.
+ * const surface = East.function([], UIComponentType, _$ => (
+ *     <ValueTree
+ *         value={{
+ *             rate: 0.15,
+ *             label: "Base",
+ *             tags: ["a", "b"],
+ *         }}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ValueTree.at` (scoped subtree handlers), `ValueTree.zero`
+ * (host-side default element for raw `onInsert` handlers) and
+ * `ValueTree.Types`. Desugars to `ValueTree.Root(value, options)`.
+ */
+function ValueTreeTag(props) {
+    const { value, ...options } = props;
+    return ValueTreeFactory.Root(value, options);
+}
+/** The callable `<ValueTree>` tag carrying the factory namespace statics. */
+export const ValueTree = Object.assign(ValueTreeTag, ValueTreeFactory);
+//# sourceMappingURL=value-tree.js.map

package/dist/src/runtime/collections/value-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-tree.js","sourceRoot":"","sources":["../../../../src/runtime/collections/value-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAoE,MAAM,eAAe,CAAC;AACjG,OAAO,EACH,SAAS,IAAI,gBAAgB,GAEhC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAS,YAAY,CACjB,KAAoE;IAEpE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;IACpC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/src/runtime/navigation/app.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Navigation `<App>` tag — the application shell (#367). */
+import { type AppInput } from "../../navigation/app/index.js";
+import type { NavRoutes } from "../../navigation/pages/types.js";
+import type { UIElement } from "../runtime.js";
+/**
+ * The application shell — a collapsible nav rail, a breadcrumb app bar, an
+ * optional brand logo, app-bar slots and the routed page body, all driven by one
+ * `Navigation.bind` handle. Author it **inside** the enclosing `<Reactive>` that
+ * binds `nav`, and pass the same `Navigation.config` as `config` (the handle
+ * carries no labels/icons — the config is the single source of truth for the
+ * rail and breadcrumb).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType, UIComponentType } from "@elaraai/east";
+ * import { App, Navigation, Reactive, Image, Text } from "@elaraai/east-ui";
+ *
+ * const app = East.function([], UIComponentType, _$ => {
+ *     const routes = Navigation.config({
+ *         overview: { value: NullType, label: "Overview", section: "Analyse", icon: { prefix: "fas", name: "gauge-high" } },
+ *         audit: { value: NullType, label: "Audit", section: "Manage", icon: { prefix: "fas", name: "list-check" } },
+ *     });
+ *     return (
+ *         <Reactive>{$ => {
+ *             const nav = $.let(Navigation.bind(routes, "app.route", [routes.Page.overview()]));
+ *             return (
+ *                 <App nav={nav} config={routes} title="Acme Ops" logo={Image.dataUri("data:image/svg+xml,<svg/>")}
+ *                     pages={{ overview: () => <Text>Overview</Text>, audit: () => <Text>Audit</Text> }} />
+ *             );
+ *         }}</Reactive>
+ *     );
+ * });
+ * ```
+ *
+ * @remarks
+ * Desugars to `App.Root({ nav, config, pages, … })`. A generic function
+ * declaration (merged with the `App` namespace) so it is a valid generic JSX
+ * component.
+ */
+export declare function App<R extends NavRoutes>(props: AppInput<R>): UIElement;
+export declare namespace App {
+    /** The underlying factory: `App.Root({ nav, config, pages, … })`. */
+    const Root: <R extends NavRoutes>(input: AppInput<R>) => import("@elaraai/east").ExprType<import("../../component.js").UIComponentType>;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/src/runtime/navigation/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/runtime/navigation/app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAE7D,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAEtE;AAGD,yBAAiB,GAAG,CAAC;IACjB,qEAAqE;IAC9D,MAAM,IAAI,6HAAkB,CAAC;CACvC"}

package/dist/src/runtime/navigation/app.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Navigation `<App>` tag — the application shell (#367). */
+import { App as AppFactory } from "../../navigation/app/index.js";
+/**
+ * The application shell — a collapsible nav rail, a breadcrumb app bar, an
+ * optional brand logo, app-bar slots and the routed page body, all driven by one
+ * `Navigation.bind` handle. Author it **inside** the enclosing `<Reactive>` that
+ * binds `nav`, and pass the same `Navigation.config` as `config` (the handle
+ * carries no labels/icons — the config is the single source of truth for the
+ * rail and breadcrumb).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType, UIComponentType } from "@elaraai/east";
+ * import { App, Navigation, Reactive, Image, Text } from "@elaraai/east-ui";
+ *
+ * const app = East.function([], UIComponentType, _$ => {
+ *     const routes = Navigation.config({
+ *         overview: { value: NullType, label: "Overview", section: "Analyse", icon: { prefix: "fas", name: "gauge-high" } },
+ *         audit: { value: NullType, label: "Audit", section: "Manage", icon: { prefix: "fas", name: "list-check" } },
+ *     });
+ *     return (
+ *         <Reactive>{$ => {
+ *             const nav = $.let(Navigation.bind(routes, "app.route", [routes.Page.overview()]));
+ *             return (
+ *                 <App nav={nav} config={routes} title="Acme Ops" logo={Image.dataUri("data:image/svg+xml,<svg/>")}
+ *                     pages={{ overview: () => <Text>Overview</Text>, audit: () => <Text>Audit</Text> }} />
+ *             );
+ *         }}</Reactive>
+ *     );
+ * });
+ * ```
+ *
+ * @remarks
+ * Desugars to `App.Root({ nav, config, pages, … })`. A generic function
+ * declaration (merged with the `App` namespace) so it is a valid generic JSX
+ * component.
+ */
+export function App(props) {
+    return AppFactory.Root(props);
+}
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (App) {
+    /** The underlying factory: `App.Root({ nav, config, pages, … })`. */
+    App.Root = AppFactory.Root;
+})(App || (App = {}));
+//# sourceMappingURL=app.js.map

package/dist/src/runtime/navigation/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/runtime/navigation/app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAE7D,OAAO,EAAE,GAAG,IAAI,UAAU,EAAiB,MAAM,+BAA+B,CAAC;AAIjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,GAAG,CAAsB,KAAkB;IACvD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAc,CAAC;AAC/C,CAAC;AAED,2DAA2D;AAC3D,WAAiB,GAAG;IAChB,qEAAqE;IACxD,QAAI,GAAG,UAAU,CAAC,IAAI,CAAC;AACxC,CAAC,EAHgB,GAAG,KAAH,GAAG,QAGnB"}

package/dist/src/runtime/navigation/index.d.ts

@@ -3,6 +3,7 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 /** Navigation JSX tags. Mirrors `src/navigation/`. */
+export { App } from "./app.js";
 export { Breadcrumb } from "./breadcrumb.js";
 export { NavList } from "./nav-list.js";
 export { Pages } from "./pages.js";

package/dist/src/runtime/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/navigation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/navigation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/runtime/navigation/index.js

@@ -3,6 +3,7 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 /** Navigation JSX tags. Mirrors `src/navigation/`. */
+export { App } from "./app.js";
 export { Breadcrumb } from "./breadcrumb.js";
 export { NavList } from "./nav-list.js";
 export { Pages } from "./pages.js";

package/dist/src/runtime/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/navigation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/navigation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/test/collections/calendar.examples.d.ts

@@ -1,5 +1,7 @@
 export declare const calendarDemand: import("@elaraai/east").ExampleDef<[], any>;
 export declare const calendarMinimal: import("@elaraai/east").ExampleDef<[], any>;
+export declare const calendarValuesOff: import("@elaraai/east").ExampleDef<[], any>;
+export declare const calendarTotals: import("@elaraai/east").ExampleDef<[], any>;
 export declare const calendarDensity: import("@elaraai/east").ExampleDef<[], any>;
 export declare const calendarInteractive: import("@elaraai/east").ExampleDef<[], any>;
 export declare const calendarScroll: import("@elaraai/east").ExampleDef<[], any>;

package/dist/test/collections/calendar.examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.examples.d.ts","sourceRoot":"","sources":["../../../test/collections/calendar.examples.tsx"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,6CA+CzB,CAAC;AAEH,eAAO,MAAM,eAAe,6CAmB1B,CAAC;AAEH,eAAO,MAAM,eAAe,6CAsB1B,CAAC;AAEH,eAAO,MAAM,mBAAmB,6CA2B9B,CAAC;AAGH,eAAO,MAAM,cAAc,6CAuCzB,CAAC;AAEH,eAAO,MAAM,YAAY,6CAoBvB,CAAC"}
+{"version":3,"file":"calendar.examples.d.ts","sourceRoot":"","sources":["../../../test/collections/calendar.examples.tsx"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,6CAyCzB,CAAC;AAEH,eAAO,MAAM,eAAe,6CAmB1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,6CAuB5B,CAAC;AAEH,eAAO,MAAM,cAAc,6CAsBzB,CAAC;AAEH,eAAO,MAAM,eAAe,6CAsB1B,CAAC;AAEH,eAAO,MAAM,mBAAmB,6CAoC9B,CAAC;AAGH,eAAO,MAAM,cAAc,6CAuCzB,CAAC;AAEH,eAAO,MAAM,YAAY,6CAoBvB,CAAC"}