@elaraai/east-ui 1.0.4 → 1.0.6

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

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Table>` tag — see the export's JSDoc.
+ */
+import type { SubtypeExprOrValue, ArrayType, StructType } from "@elaraai/east";
+import { Table as TableFactory, type ColumnSpec, type DataFieldKeys, type TableOptions } from "../../collections/table/index.js";
+import type { UIElement } from "../runtime.js";
+/**
+ * `<Table data={rows} columns={["name", "age"]} striped />` — schema-typed
+ * table. Maps to `Table.Root`. `columns` is typed directly as `ColumnSpec<T>`
+ * (not an inferred generic) so an object-form column map gets excess-property
+ * checked — a key that is not a data field is a type error.
+ */
+declare function TableTag<T extends SubtypeExprOrValue<ArrayType<StructType>>>(props: {
+    data: T;
+    columns: ColumnSpec<T>;
+} & TableOptions<DataFieldKeys<T>>): UIElement;
+/**
+ * Schema-typed data table — renders an array of struct rows as columns. The
+ * row type drives everything: `columns` is a key list or a per-key config map
+ * ({@link ColumnSpec}, with `header` / `width` / `value` sort-key / `render`
+ * cell renderer), and the remaining display props (striped, density, frozen
+ * columns, row status, selection, pagination, expandable rows, footer rows,
+ * column groups, interaction callbacks) are flat ({@link TableOptions}). Reach
+ * for it whenever tabular records need sorting, selection, or rich cells.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Badge, Table, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const users = East.function([], UIComponentType, _$ => (
+ *     <Table
+ *         variant="line"
+ *         striped={true}
+ *         data={[
+ *             { name: "Alice", email: "alice@example.com", status: "Active" },
+ *             { name: "Bob", email: "bob@example.com", status: "Active" },
+ *         ]}
+ *         columns={{
+ *             name: { header: "Name" },
+ *             email: { header: "Email" },
+ *             status: {
+ *                 header: "Status",
+ *                 render: East.function([Table.Types.CellRenderContext], UIComponentType, (_$2, ctx) => (
+ *                     <Badge variant="solid" colorPalette="blue">{ctx.cellValue.match({ String: (_$3, v) => v }, _$3 => "")}</Badge>
+ *                 )),
+ *             },
+ *         }}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Table.Types` — the cell `render` callback takes a
+ * `Table.Types.CellRenderContext` (row index, cell value, sort state), and the
+ * interaction callbacks consume the matching event types
+ * (`Table.Types.RowClickEvent`, `Table.Types.CellClickEvent`,
+ * `Table.Types.RowSelectionEvent`, `Table.Types.SortEvent`, …). Desugars to
+ * `Table.Root(data, columns, options)`.
+ */
+export declare const Table: typeof TableTag & {
+    Types: typeof TableFactory.Types;
+};
+export {};
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EACH,KAAK,IAAI,YAAY,EACrB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,CAAC,SAAS,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EACjE,KAAK,EAAE;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAC5E,SAAS,CAOX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,KAAK,EAAE,OAAO,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,CAAA;CACd,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { Table as TableFactory, } from "../../collections/table/index.js";
+import { hasKeys } from "../combinators.js";
+/**
+ * `<Table data={rows} columns={["name", "age"]} striped />` — schema-typed
+ * table. Maps to `Table.Root`. `columns` is typed directly as `ColumnSpec<T>`
+ * (not an inferred generic) so an object-form column map gets excess-property
+ * checked — a key that is not a data field is a type error.
+ */
+function TableTag(props) {
+    const { data, columns, ...options } = props;
+    return TableFactory.Root(data, columns, (hasKeys(options) ? options : undefined));
+}
+/**
+ * Schema-typed data table — renders an array of struct rows as columns. The
+ * row type drives everything: `columns` is a key list or a per-key config map
+ * ({@link ColumnSpec}, with `header` / `width` / `value` sort-key / `render`
+ * cell renderer), and the remaining display props (striped, density, frozen
+ * columns, row status, selection, pagination, expandable rows, footer rows,
+ * column groups, interaction callbacks) are flat ({@link TableOptions}). Reach
+ * for it whenever tabular records need sorting, selection, or rich cells.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Badge, Table, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const users = East.function([], UIComponentType, _$ => (
+ *     <Table
+ *         variant="line"
+ *         striped={true}
+ *         data={[
+ *             { name: "Alice", email: "alice@example.com", status: "Active" },
+ *             { name: "Bob", email: "bob@example.com", status: "Active" },
+ *         ]}
+ *         columns={{
+ *             name: { header: "Name" },
+ *             email: { header: "Email" },
+ *             status: {
+ *                 header: "Status",
+ *                 render: East.function([Table.Types.CellRenderContext], UIComponentType, (_$2, ctx) => (
+ *                     <Badge variant="solid" colorPalette="blue">{ctx.cellValue.match({ String: (_$3, v) => v }, _$3 => "")}</Badge>
+ *                 )),
+ *             },
+ *         }}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Table.Types` — the cell `render` callback takes a
+ * `Table.Types.CellRenderContext` (row index, cell value, sort state), and the
+ * interaction callbacks consume the matching event types
+ * (`Table.Types.RowClickEvent`, `Table.Types.CellClickEvent`,
+ * `Table.Types.RowSelectionEvent`, `Table.Types.SortEvent`, …). Desugars to
+ * `Table.Root(data, columns, options)`.
+ */
+export const Table = Object.assign(TableTag, { Types: TableFactory.Types });
+//# sourceMappingURL=table.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../../src/runtime/collections/table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EACH,KAAK,IAAI,YAAY,GAIxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;;;;GAKG;AACH,SAAS,QAAQ,CACb,KAA2E;IAE3E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,KAAsE,CAAC;IAC7G,OAAO,YAAY,CAAC,IAAI,CACpB,IAAI,EACJ,OAAO,EACP,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAmC,CAC7E,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,KAAK,GACd,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<TreeView>` tag — see the export's JSDoc.
+ */
+import { TreeView as TreeViewFactory } from "../../collections/tree-view/index.js";
+import { type ValueProps, type JsxTag } from "../combinators.js";
+/** Node + type builders carried alongside the `<TreeView>` tag. */
+type TreeViewBuilders = {
+    Item: typeof TreeViewFactory.Item;
+    Branch: typeof TreeViewFactory.Branch;
+    Types: typeof TreeViewFactory.Types;
+};
+/**
+ * Hierarchical tree — collapsible nodes for file trees, org charts, category
+ * navigation, and any nested structure. The `nodes` prop is the tree: build it
+ * with the carried `TreeView.Item` (a leaf) and `TreeView.Branch` (an
+ * expandable parent), each taking an id, a label, and an optional icon. The
+ * remaining display props (`variant`, `size`, `selectionMode`,
+ * `defaultExpandedValue`, colour overrides, selection / expansion / focus
+ * callbacks) are flat ({@link TreeViewStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { TreeView, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const fileTree = East.function([], UIComponentType, _$ => (
+ *     <TreeView nodes={[
+ *         TreeView.Branch("src", "src", [
+ *             TreeView.Item("src-index", "index.ts"),
+ *             TreeView.Item("src-utils", "utils.ts"),
+ *         ]),
+ *         TreeView.Item("package-json", "package.json"),
+ *     ]} />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `TreeView.Item` (leaf node), `TreeView.Branch` (expandable node), and
+ * `TreeView.Types` for the node / event IR types. Desugars to
+ * `TreeView.Root(nodes, options)`.
+ */
+export declare const TreeView: JsxTag<ValueProps<typeof TreeViewFactory.Root, "nodes">> & TreeViewBuilders;
+export {};
+//# sourceMappingURL=tree-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view.d.ts","sourceRoot":"","sources":["../../../../src/runtime/collections/tree-view.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvE,mEAAmE;AACnE,KAAK,gBAAgB,GAAG;IACpB,IAAI,EAAE,OAAO,eAAe,CAAC,IAAI,CAAC;IAClC,MAAM,EAAE,OAAO,eAAe,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,OAAO,eAAe,CAAC,KAAK,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,gBAK5E,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<TreeView>` tag — see the export's JSDoc.
+ */
+import { TreeView as TreeViewFactory } from "../../collections/tree-view/index.js";
+import { leaf } from "../combinators.js";
+/**
+ * Hierarchical tree — collapsible nodes for file trees, org charts, category
+ * navigation, and any nested structure. The `nodes` prop is the tree: build it
+ * with the carried `TreeView.Item` (a leaf) and `TreeView.Branch` (an
+ * expandable parent), each taking an id, a label, and an optional icon. The
+ * remaining display props (`variant`, `size`, `selectionMode`,
+ * `defaultExpandedValue`, colour overrides, selection / expansion / focus
+ * callbacks) are flat ({@link TreeViewStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { TreeView, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const fileTree = East.function([], UIComponentType, _$ => (
+ *     <TreeView nodes={[
+ *         TreeView.Branch("src", "src", [
+ *             TreeView.Item("src-index", "index.ts"),
+ *             TreeView.Item("src-utils", "utils.ts"),
+ *         ]),
+ *         TreeView.Item("package-json", "package.json"),
+ *     ]} />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `TreeView.Item` (leaf node), `TreeView.Branch` (expandable node), and
+ * `TreeView.Types` for the node / event IR types. Desugars to
+ * `TreeView.Root(nodes, options)`.
+ */
+export const TreeView = Object.assign(leaf(TreeViewFactory.Root, "nodes"), {
+    Item: TreeViewFactory.Item,
+    Branch: TreeViewFactory.Branch,
+    Types: TreeViewFactory.Types,
+});
+//# sourceMappingURL=tree-view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree-view.js","sourceRoot":"","sources":["../../../../src/runtime/collections/tree-view.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,IAAI,EAAgC,MAAM,mBAAmB,CAAC;AASvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,QAAQ,GACjB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;IAC/C,IAAI,EAAE,eAAe,CAAC,IAAI;IAC1B,MAAM,EAAE,eAAe,CAAC,MAAM;IAC9B,KAAK,EAAE,eAAe,CAAC,KAAK;CAC/B,CAAC,CAAC"}

package/dist/src/runtime/combinators.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Combinators that turn an east-ui component factory into a JSX tag. Every
+ * factory is `(primaryValue?, options?)` with a **flat** options bag (no nested
+ * `style`), so the combinator just forwards the prop bag as `options` — props are
+ * never re-typed into JS/TS junk unions, never split, never coerced. (Enum props
+ * carry their `XxxLiteral` proxy, but that lives on the factory's option
+ * interface, not here.)
+ *
+ * - {@link container} wraps a `(children, options?)` factory: children are the
+ *   JSX children-collection (see `./children.js`), lowered to the factory's
+ *   `SubtypeExprOrValue<ArrayType<UIComponentType>>`; options sit flat.
+ * - {@link content} wraps a `(value, options?)` factory whose single value is the
+ *   JSX child — a text leaf (`Text`/`Badge`, value `SubtypeExprOrValue<StringType>`)
+ *   or a single-content slot (`ScrollArea`/`Sticky`, value
+ *   `SubtypeExprOrValue<UIComponentType>`) — forwarded verbatim.
+ * - {@link leaf} wraps a `(value, options?)` factory whose value is a named prop.
+ * - {@link optionsTag} wraps an `(options?)` factory with no value/children.
+ */
+import { ArrayType, type SubtypeExprOrValue } from "@elaraai/east";
+import { UIComponentType } from "../component.js";
+import { type ContainerChildrenType } from "./children.js";
+import type { UIElement } from "./runtime.js";
+/** A JSX tag: a function from a single props object to a built east-ui element. */
+export type JsxTag<P> = (props: P) => UIElement;
+/** Props for a container tag wrapping `F`: its style props (flat) + children. */
+export type ContainerProps<F extends (...a: never[]) => UIElement> = NonNullable<Parameters<F>[1]> & {
+    children?: ContainerChildrenType;
+};
+/**
+ * Props for a text-leaf tag wrapping `F`: its style props (flat) + the value as
+ * `children`, typed exactly as the factory's value arg
+ * (`SubtypeExprOrValue<StringType>`). Interpolate with `East.str` — text is a
+ * single string value, not a join of mixed children.
+ */
+export type ContentProps<F extends (...a: never[]) => UIElement> = NonNullable<Parameters<F>[1]> & {
+    children: Parameters<F>[0];
+};
+/**
+ * Props for a value-leaf tag wrapping `F` (signature `(value, style?)`): the
+ * factory's value arg surfaced under the prop name `K`, plus its style props
+ * (flat). E.g. `ValueProps<typeof Checkbox.Root, "checked">`.
+ */
+export type ValueProps<F extends (...a: never[]) => UIElement, K extends string> = Record<K, Parameters<F>[0]> & NonNullable<Parameters<F>[1]>;
+/**
+ * Props for an options-only tag wrapping `F` (signature `(options?)`, no
+ * value/children — e.g. `<CloseButton onClick=… variant=…/>`): the factory's
+ * flat options bag. Built by {@link optionsTag}.
+ */
+export type OptionsProps<F extends (...a: never[]) => UIElement> = NonNullable<Parameters<F>[0]>;
+/** True when an object has at least one own enumerable key. */
+declare function hasKeys(o: object): boolean;
+/**
+ * Build a JSX tag for a container factory (signature `(children, style?)`).
+ * Style props are top-level; `children` are coalesced into the factory's real
+ * `SubtypeExprOrValue<ArrayType<UIComponentType>>` children arg.
+ *
+ * @example
+ * ```ts
+ * import { Flex } from "@elaraai/east-ui";
+ * export const FlexTag = container(Flex.Root);
+ * // <FlexTag gap="2"><Text>hi</Text></FlexTag>
+ * ```
+ */
+export declare function container<S>(factory: (children: SubtypeExprOrValue<ArrayType<UIComponentType>>, style: S) => UIElement): JsxTag<S & {
+    children?: ContainerChildrenType;
+}>;
+/**
+ * Build a JSX tag for a text-leaf factory (signature `(value, style?)`) whose
+ * value is the text children — forwarded verbatim as the factory's value type.
+ *
+ * @example
+ * ```ts
+ * import { Code } from "@elaraai/east-ui";
+ * export const CodeTag = content(Code.Root);
+ * // <CodeTag>{"const x = 1"}</CodeTag>
+ * ```
+ */
+export declare function content<V, S>(factory: (value: V, style: S) => UIElement): JsxTag<NonNullable<S> & {
+    children: V;
+}>;
+/**
+ * Build a JSX tag for a value-leaf factory (signature `(value, style?)`) whose
+ * value is a typed datum exposed as the prop named `key` (its natural name —
+ * `checked`, `value`, …); the rest of the options sit flat.
+ *
+ * @example
+ * ```ts
+ * import { Slider } from "@elaraai/east-ui";
+ * export const SliderTag = leaf(Slider.Root, "value");
+ * // <SliderTag value={v} min={0} max={100} onChange={set} />
+ * ```
+ */
+export declare function leaf<V, S, K extends string>(factory: (value: V, style: S) => UIElement, key: K): JsxTag<Record<K, V> & NonNullable<S>>;
+/**
+ * Build a JSX tag for an options-only factory (signature `(options?)`) — no value
+ * and no children. The flat props **are** the factory's options (Principle 6).
+ *
+ * @example
+ * ```ts
+ * import { CloseButton } from "@elaraai/east-ui";
+ * export const CloseButtonTag = optionsTag(CloseButton.Root);
+ * // <CloseButtonTag onClick={f} variant="ghost" />
+ * ```
+ */
+export declare function optionsTag<O>(factory: (options: O) => UIElement): JsxTag<NonNullable<O>>;
+export { hasKeys };
+//# sourceMappingURL=combinators.d.ts.map

package/dist/src/runtime/combinators.d.ts.map

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

package/dist/src/runtime/combinators.js

@@ -0,0 +1,106 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Combinators that turn an east-ui component factory into a JSX tag. Every
+ * factory is `(primaryValue?, options?)` with a **flat** options bag (no nested
+ * `style`), so the combinator just forwards the prop bag as `options` — props are
+ * never re-typed into JS/TS junk unions, never split, never coerced. (Enum props
+ * carry their `XxxLiteral` proxy, but that lives on the factory's option
+ * interface, not here.)
+ *
+ * - {@link container} wraps a `(children, options?)` factory: children are the
+ *   JSX children-collection (see `./children.js`), lowered to the factory's
+ *   `SubtypeExprOrValue<ArrayType<UIComponentType>>`; options sit flat.
+ * - {@link content} wraps a `(value, options?)` factory whose single value is the
+ *   JSX child — a text leaf (`Text`/`Badge`, value `SubtypeExprOrValue<StringType>`)
+ *   or a single-content slot (`ScrollArea`/`Sticky`, value
+ *   `SubtypeExprOrValue<UIComponentType>`) — forwarded verbatim.
+ * - {@link leaf} wraps a `(value, options?)` factory whose value is a named prop.
+ * - {@link optionsTag} wraps an `(options?)` factory with no value/children.
+ */
+import { ArrayType } from "@elaraai/east";
+import { UIComponentType } from "../component.js";
+import { coalesceChildren } from "./children.js";
+/** True when an object has at least one own enumerable key. */
+function hasKeys(o) {
+    for (const _ in o)
+        return true;
+    return false;
+}
+/**
+ * Build a JSX tag for a container factory (signature `(children, style?)`).
+ * Style props are top-level; `children` are coalesced into the factory's real
+ * `SubtypeExprOrValue<ArrayType<UIComponentType>>` children arg.
+ *
+ * @example
+ * ```ts
+ * import { Flex } from "@elaraai/east-ui";
+ * export const FlexTag = container(Flex.Root);
+ * // <FlexTag gap="2"><Text>hi</Text></FlexTag>
+ * ```
+ */
+export function container(factory) {
+    return (props) => {
+        const { children, ...style } = props;
+        return factory(coalesceChildren(children), (hasKeys(style) ? style : undefined));
+    };
+}
+/**
+ * Build a JSX tag for a text-leaf factory (signature `(value, style?)`) whose
+ * value is the text children — forwarded verbatim as the factory's value type.
+ *
+ * @example
+ * ```ts
+ * import { Code } from "@elaraai/east-ui";
+ * export const CodeTag = content(Code.Root);
+ * // <CodeTag>{"const x = 1"}</CodeTag>
+ * ```
+ */
+export function content(factory) {
+    return (props) => {
+        const { children, ...style } = props;
+        return factory(children, (hasKeys(style) ? style : undefined));
+    };
+}
+/**
+ * Build a JSX tag for a value-leaf factory (signature `(value, style?)`) whose
+ * value is a typed datum exposed as the prop named `key` (its natural name —
+ * `checked`, `value`, …); the rest of the options sit flat.
+ *
+ * @example
+ * ```ts
+ * import { Slider } from "@elaraai/east-ui";
+ * export const SliderTag = leaf(Slider.Root, "value");
+ * // <SliderTag value={v} min={0} max={100} onChange={set} />
+ * ```
+ */
+export function leaf(factory, key) {
+    return (props) => {
+        const bag = props;
+        const value = bag[key];
+        const style = {};
+        for (const k of Object.keys(bag)) {
+            if (k !== key)
+                style[k] = bag[k];
+        }
+        return factory(value, (hasKeys(style) ? style : undefined));
+    };
+}
+/**
+ * Build a JSX tag for an options-only factory (signature `(options?)`) — no value
+ * and no children. The flat props **are** the factory's options (Principle 6).
+ *
+ * @example
+ * ```ts
+ * import { CloseButton } from "@elaraai/east-ui";
+ * export const CloseButtonTag = optionsTag(CloseButton.Root);
+ * // <CloseButtonTag onClick={f} variant="ghost" />
+ * ```
+ */
+export function optionsTag(factory) {
+    return (props) => factory((hasKeys(props) ? props : undefined));
+}
+export { hasKeys };
+//# sourceMappingURL=combinators.js.map

package/dist/src/runtime/combinators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.js","sourceRoot":"","sources":["../../../src/runtime/combinators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAA2B,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAA8B,MAAM,eAAe,CAAC;AAmC7E,+DAA+D;AAC/D,SAAS,OAAO,CAAC,CAAS;IACtB,KAAK,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CACrB,OAGc;IAEd,OAAO,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,KACJ,CAAC;QAC5B,OAAO,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC;IAC1F,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CACnB,OAA0C;IAE1C,OAAO,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,KAAkD,CAAC;QAClF,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC;IACxE,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAChB,OAA0C,EAC1C,GAAM;IAEN,OAAO,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAM,CAAC;QAC5B,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACtB,OAAkC;IAElC,OAAO,CAAC,KAAK,EAAE,EAAE,CACb,OAAO,CAAC,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC,CAAC;AACtF,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/src/runtime/container/card.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Card>` tag — see the export's JSDoc.
+ */
+import { Card as CardFactory } from "../../container/card/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/** Compound builders surfaced on the `<Card>` tag (mirrors the `Card` factory namespace). */
+type CardBuilders = {
+    Section: typeof CardFactory.Section;
+    Header: typeof CardFactory.Header;
+    Types: typeof CardFactory.Types;
+};
+/**
+ * Card — a bordered container that groups related content under an optional
+ * header and footer. Use it to frame a self-contained unit (a summary, a
+ * record, a decision panel) with a consistent surface. Body content is the
+ * children; the header strip, footer, runtime `state`, and the visual style
+ * fields are all flat props ({@link CardOptions}). `header` takes a
+ * {@link CardHeaderOptions} object (`{ eyebrow, title, meta, description }`)
+ * and `footer` a `{ content, actions }` object — the factory composes both
+ * into the framed surface. `state` swaps the body for a loading / empty /
+ * error / permission-denied fallback.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Card, Button, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Card
+ *         header={{ eyebrow: "Forecast · SE region", title: "Per plan week", meta: "14s ago" }}
+ *         footer={{ actions: [<Button variant="subtle">Export</Button>] }}
+ *     >
+ *         <Text>Scenario vs baseline — per-plan week comparison.</Text>
+ *     </Card>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Card.Types` (the East data type and style struct) plus two
+ * body-content builders mirrored from the factory namespace:
+ * - `Card.Section(children, options?)` — a hairline-separated body section
+ *   with its own optional title; place its result among the children.
+ * - `Card.Header(options)` — composes a standalone header strip, for when a
+ *   header is built outside the `header` prop.
+ * Desugars to `Card.Root(body, options)`.
+ */
+export declare const Card: JsxTag<ContainerProps<typeof CardFactory.Root>> & CardBuilders;
+export {};
+//# sourceMappingURL=card.d.ts.map

package/dist/src/runtime/container/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../../src/runtime/container/card.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF,6FAA6F;AAC7F,KAAK,YAAY,GAAG;IAChB,OAAO,EAAE,OAAO,WAAW,CAAC,OAAO,CAAC;IACpC,MAAM,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,OAAO,WAAW,CAAC,KAAK,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,YAK/D,CAAC"}

package/dist/src/runtime/container/card.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.
+ */
+/**
+ * `<Card>` tag — see the export's JSDoc.
+ */
+import { Card as CardFactory } from "../../container/card/index.js";
+import { container } from "../combinators.js";
+/**
+ * Card — a bordered container that groups related content under an optional
+ * header and footer. Use it to frame a self-contained unit (a summary, a
+ * record, a decision panel) with a consistent surface. Body content is the
+ * children; the header strip, footer, runtime `state`, and the visual style
+ * fields are all flat props ({@link CardOptions}). `header` takes a
+ * {@link CardHeaderOptions} object (`{ eyebrow, title, meta, description }`)
+ * and `footer` a `{ content, actions }` object — the factory composes both
+ * into the framed surface. `state` swaps the body for a loading / empty /
+ * error / permission-denied fallback.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Card, Button, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Card
+ *         header={{ eyebrow: "Forecast · SE region", title: "Per plan week", meta: "14s ago" }}
+ *         footer={{ actions: [<Button variant="subtle">Export</Button>] }}
+ *     >
+ *         <Text>Scenario vs baseline — per-plan week comparison.</Text>
+ *     </Card>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Card.Types` (the East data type and style struct) plus two
+ * body-content builders mirrored from the factory namespace:
+ * - `Card.Section(children, options?)` — a hairline-separated body section
+ *   with its own optional title; place its result among the children.
+ * - `Card.Header(options)` — composes a standalone header strip, for when a
+ *   header is built outside the `header` prop.
+ * Desugars to `Card.Root(body, options)`.
+ */
+export const Card = Object.assign(container(CardFactory.Root), {
+    Section: CardFactory.Section,
+    Header: CardFactory.Header,
+    Types: CardFactory.Types,
+});
+//# sourceMappingURL=card.js.map

package/dist/src/runtime/container/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../../../../src/runtime/container/card.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAShF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,MAAM,IAAI,GACb,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;IACvC,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,MAAM,EAAE,WAAW,CAAC,MAAM;IAC1B,KAAK,EAAE,WAAW,CAAC,KAAK;CAC3B,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Container JSX tags. Mirrors `src/container/`. */
+export { Card } from "./card.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/container/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Container JSX tags. Mirrors `src/container/`. */
+export { Card } from "./card.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/container/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}