@elaraai/east-ui 1.0.4 → 1.0.6

package/dist/src/runtime/navigation/nav-list.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.
+ */
+/** Navigation `<NavList>` tag — a sectioned list of navigation links. */
+import { NavList as NavListFactory } from "../../navigation/nav-list/index.js";
+import { type ValueProps, type JsxTag } from "../combinators.js";
+/**
+ * Sectioned navigation list — a vertical menu grouped into labelled sections,
+ * the kind that sits in a side rail. Each item carries a stable `key`, a
+ * `label`, an optional leading `icon`, an optional `badge`, and an optional
+ * `active` flag for the current selection. The groups are the `sections` prop;
+ * the `onSelect` callback fires with the clicked item's key. Options are flat
+ * props ({@link NavListStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType, StringType } from "@elaraai/east";
+ * import { NavList, State, Reactive, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const rail = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const activeBind = $.let(State.bind([StringType], "nav.active", "profile"));
+ *         const active = $.let(activeBind.read(), StringType);
+ *         const onSelect = $.const(East.function([StringType], NullType, ($, key) => {
+ *             $(activeBind.write(key));
+ *         }));
+ *         return (
+ *             <NavList
+ *                 sections={[
+ *                     {
+ *                         label: "Settings",
+ *                         items: [
+ *                             { key: "profile", label: "Profile", active: active.equals("profile") },
+ *                             { key: "security", label: "Security", active: active.equals("security") },
+ *                         ],
+ *                     },
+ *                 ]}
+ *                 onSelect={onSelect}
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `NavList.Types` — the East data type, the section struct, and the
+ * item struct. Desugars to `NavList.Root(sections, options)`.
+ */
+export declare const NavList: JsxTag<ValueProps<typeof NavListFactory.Root, "sections">> & {
+    Types: typeof NavListFactory.Types;
+};
+//# sourceMappingURL=nav-list.d.ts.map

package/dist/src/runtime/navigation/nav-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-list.d.ts","sourceRoot":"","sources":["../../../../src/runtime/navigation/nav-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AAEzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,cAAc,CAAC,KAAK,CAAA;CAC9B,CAAC"}

package/dist/src/runtime/navigation/nav-list.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Navigation `<NavList>` tag — a sectioned list of navigation links. */
+import { NavList as NavListFactory } from "../../navigation/nav-list/index.js";
+import { leaf } from "../combinators.js";
+/**
+ * Sectioned navigation list — a vertical menu grouped into labelled sections,
+ * the kind that sits in a side rail. Each item carries a stable `key`, a
+ * `label`, an optional leading `icon`, an optional `badge`, and an optional
+ * `active` flag for the current selection. The groups are the `sections` prop;
+ * the `onSelect` callback fires with the clicked item's key. Options are flat
+ * props ({@link NavListStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType, StringType } from "@elaraai/east";
+ * import { NavList, State, Reactive, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const rail = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const activeBind = $.let(State.bind([StringType], "nav.active", "profile"));
+ *         const active = $.let(activeBind.read(), StringType);
+ *         const onSelect = $.const(East.function([StringType], NullType, ($, key) => {
+ *             $(activeBind.write(key));
+ *         }));
+ *         return (
+ *             <NavList
+ *                 sections={[
+ *                     {
+ *                         label: "Settings",
+ *                         items: [
+ *                             { key: "profile", label: "Profile", active: active.equals("profile") },
+ *                             { key: "security", label: "Security", active: active.equals("security") },
+ *                         ],
+ *                     },
+ *                 ]}
+ *                 onSelect={onSelect}
+ *             />
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `NavList.Types` — the East data type, the section struct, and the
+ * item struct. Desugars to `NavList.Root(sections, options)`.
+ */
+export const NavList = Object.assign(leaf(NavListFactory.Root, "sections"), { Types: NavListFactory.Types });
+//# sourceMappingURL=nav-list.js.map

package/dist/src/runtime/navigation/nav-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-list.js","sourceRoot":"","sources":["../../../../src/runtime/navigation/nav-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AAEzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAgC,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,CAAC,MAAM,OAAO,GAChB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/src/runtime/overlays/action-bar.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ActionBar>` tag — see the export's JSDoc. */
+import { ActionBar as ActionBarFactory } from "../../overlays/action-bar/index.js";
+import { type ValueProps, type JsxTag } from "../combinators.js";
+/**
+ * ActionBar — a floating bar of batch actions that appears when rows are
+ * selected. Use it above a multi-select table or list to offer "delete N",
+ * "archive N", "export N" without taking the user out of context. The `items`
+ * array is the value prop; a selection count and label, plus `onSelect` /
+ * `onOpenChange` callbacks, are flat props ({@link ActionBarStyle}). Build the
+ * items with the `ActionBar.Action` / `ActionBar.Separator` factories from
+ * `@elaraai/east-ui/internal`.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { ActionBar, UIComponentType } from "@elaraai/east-ui";
+ * import { ActionBar as ActionBarItems } from "@elaraai/east-ui/internal";
+ *
+ * const bar = East.function([], UIComponentType, _$ => (
+ *     <ActionBar
+ *         selectionCount={5n}
+ *         selectionLabel="items selected"
+ *         items={[
+ *             ActionBarItems.Action("delete", "Delete"),
+ *             ActionBarItems.Separator(),
+ *             ActionBarItems.Action("archive", "Archive"),
+ *         ]}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ActionBar.Types` — the East data type, the style struct, and
+ * `ActionBar.Types.Item` (the action/separator variant). The `items` array is
+ * the value prop. Desugars to `ActionBar.Root(items, options)`.
+ */
+export declare const ActionBar: JsxTag<ValueProps<typeof ActionBarFactory.Root, "items">> & {
+    Types: typeof ActionBarFactory.Types;
+};
+//# sourceMappingURL=action-bar.d.ts.map

package/dist/src/runtime/overlays/action-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bar.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/action-bar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,gBAAgB,CAAC,KAAK,CAAA;CAChC,CAAC"}

package/dist/src/runtime/overlays/action-bar.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ActionBar>` tag — see the export's JSDoc. */
+import { ActionBar as ActionBarFactory } from "../../overlays/action-bar/index.js";
+import { leaf } from "../combinators.js";
+/**
+ * ActionBar — a floating bar of batch actions that appears when rows are
+ * selected. Use it above a multi-select table or list to offer "delete N",
+ * "archive N", "export N" without taking the user out of context. The `items`
+ * array is the value prop; a selection count and label, plus `onSelect` /
+ * `onOpenChange` callbacks, are flat props ({@link ActionBarStyle}). Build the
+ * items with the `ActionBar.Action` / `ActionBar.Separator` factories from
+ * `@elaraai/east-ui/internal`.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { ActionBar, UIComponentType } from "@elaraai/east-ui";
+ * import { ActionBar as ActionBarItems } from "@elaraai/east-ui/internal";
+ *
+ * const bar = East.function([], UIComponentType, _$ => (
+ *     <ActionBar
+ *         selectionCount={5n}
+ *         selectionLabel="items selected"
+ *         items={[
+ *             ActionBarItems.Action("delete", "Delete"),
+ *             ActionBarItems.Separator(),
+ *             ActionBarItems.Action("archive", "Archive"),
+ *         ]}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ActionBar.Types` — the East data type, the style struct, and
+ * `ActionBar.Types.Item` (the action/separator variant). The `items` array is
+ * the value prop. Desugars to `ActionBar.Root(items, options)`.
+ */
+export const ActionBar = Object.assign(leaf(ActionBarFactory.Root, "items"), { Types: ActionBarFactory.Types });
+//# sourceMappingURL=action-bar.js.map

package/dist/src/runtime/overlays/action-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bar.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/action-bar.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,IAAI,EAAgC,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,SAAS,GAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/src/runtime/overlays/command-palette.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<CommandPalette>` tag — see the export's JSDoc. */
+import { CommandPalette as CommandPaletteFactory } from "../../overlays/command-palette/index.js";
+import { type ValueProps, type JsxTag } from "../combinators.js";
+/**
+ * CommandPalette — a ⌘K-style searchable launcher overlaying a fuzzy-filtered
+ * list of commands. Use it as a fast keyboard-first way to jump anywhere or run
+ * any action in an application. Each command carries a `label`, an optional
+ * `shortcut`, a `group` heading, extra `keywords` for synonym search, and an
+ * `action` to run on select; the array is the `commands` prop. The opening
+ * chord (`triggerKey`), placeholder text, controlled `open` / `onOpenChange`,
+ * and colour overrides are flat props ({@link CommandPaletteStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType } from "@elaraai/east";
+ * import { CommandPalette, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const launcher = East.function([], UIComponentType, $ => {
+ *     const run = $.const(East.function([], NullType, (_$) => { }));
+ *     return (
+ *         <CommandPalette placeholder="Search commands…" commands={[
+ *             { id: "go.home", label: "Go to Home", shortcut: "G H", group: "Navigate", action: run },
+ *             { id: "act.run", label: "Run scenario", shortcut: "⌘↵", group: "Actions", action: run },
+ *             { id: "set.theme", label: "Toggle theme", group: "Settings", action: run },
+ *         ]} />
+ *     );
+ * });
+ * ```
+ *
+ * @remarks
+ * Carries `CommandPalette.Types` — the East data type, the style struct, and
+ * `CommandPalette.Types.Command` (the per-command struct). The `commands` array
+ * is the value prop. For a controlled ⌘K open, pair `open` / `onOpenChange`
+ * with a `Hotkey` inside `<Reactive>`. Desugars to
+ * `CommandPalette.Root(commands, options)`.
+ */
+export declare const CommandPalette: JsxTag<ValueProps<typeof CommandPaletteFactory.Root, "commands">> & {
+    Types: typeof CommandPaletteFactory.Types;
+};
+//# sourceMappingURL=command-palette.d.ts.map

package/dist/src/runtime/overlays/command-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/command-palette.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAQ,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,qBAAqB,CAAC,KAAK,CAAA;CACrC,CAAC"}

package/dist/src/runtime/overlays/command-palette.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<CommandPalette>` tag — see the export's JSDoc. */
+import { CommandPalette as CommandPaletteFactory } from "../../overlays/command-palette/index.js";
+import { leaf } from "../combinators.js";
+/**
+ * CommandPalette — a ⌘K-style searchable launcher overlaying a fuzzy-filtered
+ * list of commands. Use it as a fast keyboard-first way to jump anywhere or run
+ * any action in an application. Each command carries a `label`, an optional
+ * `shortcut`, a `group` heading, extra `keywords` for synonym search, and an
+ * `action` to run on select; the array is the `commands` prop. The opening
+ * chord (`triggerKey`), placeholder text, controlled `open` / `onOpenChange`,
+ * and colour overrides are flat props ({@link CommandPaletteStyle}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType } from "@elaraai/east";
+ * import { CommandPalette, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const launcher = East.function([], UIComponentType, $ => {
+ *     const run = $.const(East.function([], NullType, (_$) => { }));
+ *     return (
+ *         <CommandPalette placeholder="Search commands…" commands={[
+ *             { id: "go.home", label: "Go to Home", shortcut: "G H", group: "Navigate", action: run },
+ *             { id: "act.run", label: "Run scenario", shortcut: "⌘↵", group: "Actions", action: run },
+ *             { id: "set.theme", label: "Toggle theme", group: "Settings", action: run },
+ *         ]} />
+ *     );
+ * });
+ * ```
+ *
+ * @remarks
+ * Carries `CommandPalette.Types` — the East data type, the style struct, and
+ * `CommandPalette.Types.Command` (the per-command struct). The `commands` array
+ * is the value prop. For a controlled ⌘K open, pair `open` / `onOpenChange`
+ * with a `Hotkey` inside `<Reactive>`. Desugars to
+ * `CommandPalette.Root(commands, options)`.
+ */
+export const CommandPalette = Object.assign(leaf(CommandPaletteFactory.Root, "commands"), { Types: CommandPaletteFactory.Types });
+//# sourceMappingURL=command-palette.js.map

package/dist/src/runtime/overlays/command-palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/command-palette.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uDAAuD;AAEvD,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,IAAI,EAAgC,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,cAAc,GACvB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,qBAAqB,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/src/runtime/overlays/dialog.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Dialog>` tag — see the export's JSDoc. */
+import { Dialog as DialogFactory } from "../../overlays/dialog/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/** Imperative `open` + types carried alongside the `<Dialog>` tag. */
+type DialogBuilders = {
+    open: typeof DialogFactory.open;
+    Types: typeof DialogFactory.Types;
+};
+/**
+ * Dialog — a modal window that overlays the page and captures focus until it is
+ * dismissed. Use it for a focused task or a confirmation that must interrupt the
+ * flow (a settings form, "are you sure?"); for a non-blocking inline panel reach
+ * for {@link Popover}, and for an edge-anchored panel use {@link Drawer}. The
+ * body is the children; an optional eyebrow, title, and description form the
+ * header, and `size` controls its width. Placement of those, plus an
+ * `onOpenChange` callback, are flat props ({@link DialogOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Dialog, HStack, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const confirm = East.function([], UIComponentType, _$ => (
+ *     <Dialog trigger={<Button>Open Dialog</Button>} title="Confirm Action" description="Are you sure you want to proceed?">
+ *         <Text>This is a dialog. It appears as a modal overlay and captures focus.</Text>
+ *         <HStack gap="2" justify="flex-end">
+ *             <Button variant="outline">Cancel</Button>
+ *             <Button variant="solid">Confirm</Button>
+ *         </HStack>
+ *     </Dialog>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Dialog.Types` and the imperative `Dialog.open(input)` — a
+ * trigger-less programmatic open, called from an `onClick` to raise a dialog
+ * built from a `Dialog.Types.OpenInput` value. Desugars to
+ * `Dialog.Root(body, options)`.
+ */
+export declare const Dialog: JsxTag<ContainerProps<typeof DialogFactory.Root>> & DialogBuilders;
+export {};
+//# sourceMappingURL=dialog.d.ts.map

package/dist/src/runtime/overlays/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/dialog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF,sEAAsE;AACtE,KAAK,cAAc,GAAG;IAClB,IAAI,EAAE,OAAO,aAAa,CAAC,IAAI,CAAC;IAChC,KAAK,EAAE,OAAO,aAAa,CAAC,KAAK,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,cAInE,CAAC"}

package/dist/src/runtime/overlays/dialog.js

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Dialog>` tag — see the export's JSDoc. */
+import { Dialog as DialogFactory } from "../../overlays/dialog/index.js";
+import { container } from "../combinators.js";
+/**
+ * Dialog — a modal window that overlays the page and captures focus until it is
+ * dismissed. Use it for a focused task or a confirmation that must interrupt the
+ * flow (a settings form, "are you sure?"); for a non-blocking inline panel reach
+ * for {@link Popover}, and for an edge-anchored panel use {@link Drawer}. The
+ * body is the children; an optional eyebrow, title, and description form the
+ * header, and `size` controls its width. Placement of those, plus an
+ * `onOpenChange` callback, are flat props ({@link DialogOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Dialog, HStack, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const confirm = East.function([], UIComponentType, _$ => (
+ *     <Dialog trigger={<Button>Open Dialog</Button>} title="Confirm Action" description="Are you sure you want to proceed?">
+ *         <Text>This is a dialog. It appears as a modal overlay and captures focus.</Text>
+ *         <HStack gap="2" justify="flex-end">
+ *             <Button variant="outline">Cancel</Button>
+ *             <Button variant="solid">Confirm</Button>
+ *         </HStack>
+ *     </Dialog>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Dialog.Types` and the imperative `Dialog.open(input)` — a
+ * trigger-less programmatic open, called from an `onClick` to raise a dialog
+ * built from a `Dialog.Types.OpenInput` value. Desugars to
+ * `Dialog.Root(body, options)`.
+ */
+export const Dialog = Object.assign(container(DialogFactory.Root), {
+    open: DialogFactory.open,
+    Types: DialogFactory.Types,
+});
+//# sourceMappingURL=dialog.js.map

package/dist/src/runtime/overlays/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/dialog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAQhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,MAAM,GACf,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE;IACzC,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,KAAK,EAAE,aAAa,CAAC,KAAK;CAC7B,CAAC,CAAC"}

package/dist/src/runtime/overlays/drawer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Drawer>` tag — see the export's JSDoc. */
+import { Drawer as DrawerFactory } from "../../overlays/drawer/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/** Imperative `open` + types carried alongside the `<Drawer>` tag. */
+type DrawerBuilders = {
+    open: typeof DrawerFactory.open;
+    Types: typeof DrawerFactory.Types;
+};
+/**
+ * Drawer — a modal panel that slides in from an edge of the screen. Use it for
+ * navigation, filters, settings, or a detail view that benefits from more room
+ * than a {@link Popover} yet should not take over the page like a centred
+ * {@link Dialog}. The body is the children; `placement` chooses the edge it
+ * enters from and `size` its extent. An optional title and description form the
+ * header; placement, size, and an `onOpenChange` callback are flat props
+ * ({@link DrawerOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Drawer, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Drawer trigger={<Button>Open Drawer</Button>} title="Drawer Title" description="Slide-in panel" placement="end" size="md">
+ *         <VStack gap="4">
+ *             <Text>This is a drawer panel that slides in from the side.</Text>
+ *             <Text color="fg.muted">Great for navigation, settings, or detailed content.</Text>
+ *         </VStack>
+ *     </Drawer>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Drawer.Types` and the imperative `Drawer.open(input)` — a
+ * trigger-less programmatic open, called from an `onClick` to raise a drawer
+ * built from a `Drawer.Types.OpenInput` value. Desugars to
+ * `Drawer.Root(body, options)`.
+ */
+export declare const Drawer: JsxTag<ContainerProps<typeof DrawerFactory.Root>> & DrawerBuilders;
+export {};
+//# sourceMappingURL=drawer.d.ts.map

package/dist/src/runtime/overlays/drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/drawer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF,sEAAsE;AACtE,KAAK,cAAc,GAAG;IAClB,IAAI,EAAE,OAAO,aAAa,CAAC,IAAI,CAAC;IAChC,KAAK,EAAE,OAAO,aAAa,CAAC,KAAK,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,cAInE,CAAC"}

package/dist/src/runtime/overlays/drawer.js

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Drawer>` tag — see the export's JSDoc. */
+import { Drawer as DrawerFactory } from "../../overlays/drawer/index.js";
+import { container } from "../combinators.js";
+/**
+ * Drawer — a modal panel that slides in from an edge of the screen. Use it for
+ * navigation, filters, settings, or a detail view that benefits from more room
+ * than a {@link Popover} yet should not take over the page like a centred
+ * {@link Dialog}. The body is the children; `placement` chooses the edge it
+ * enters from and `size` its extent. An optional title and description form the
+ * header; placement, size, and an `onOpenChange` callback are flat props
+ * ({@link DrawerOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Drawer, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Drawer trigger={<Button>Open Drawer</Button>} title="Drawer Title" description="Slide-in panel" placement="end" size="md">
+ *         <VStack gap="4">
+ *             <Text>This is a drawer panel that slides in from the side.</Text>
+ *             <Text color="fg.muted">Great for navigation, settings, or detailed content.</Text>
+ *         </VStack>
+ *     </Drawer>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Drawer.Types` and the imperative `Drawer.open(input)` — a
+ * trigger-less programmatic open, called from an `onClick` to raise a drawer
+ * built from a `Drawer.Types.OpenInput` value. Desugars to
+ * `Drawer.Root(body, options)`.
+ */
+export const Drawer = Object.assign(container(DrawerFactory.Root), {
+    open: DrawerFactory.open,
+    Types: DrawerFactory.Types,
+});
+//# sourceMappingURL=drawer.js.map

package/dist/src/runtime/overlays/drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawer.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/drawer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAQhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,MAAM,GACf,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE;IACzC,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,KAAK,EAAE,aAAa,CAAC,KAAK;CAC7B,CAAC,CAAC"}

package/dist/src/runtime/overlays/hover-card.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<HoverCard>` tag — see the export's JSDoc. */
+import { HoverCard as HoverCardFactory } from "../../overlays/hover-card/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/**
+ * HoverCard — a rich preview panel that opens on hover, after a short delay.
+ * Use it for context that is helpful but optional: a profile card behind a
+ * @-mention, a link preview, or a summary behind an entity name. It carries
+ * arbitrary UI children (avatars, badges, text), which distinguishes it from
+ * the text-only {@link Tooltip}. Placement, open/close delays, and a pointing
+ * arrow are flat props ({@link HoverCardOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Avatar, HoverCard, HStack, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+ *
+ * const profile = East.function([], UIComponentType, _$ => (
+ *     <HoverCard trigger={<Text color="link" fontWeight="medium">@johndoe</Text>} placement="bottom" openDelay={200n}>
+ *         <HStack gap="3">
+ *             <Avatar name="John Doe" size="lg" />
+ *             <VStack gap="1" align="flex-start">
+ *                 <Text fontWeight="semibold">John Doe</Text>
+ *                 <Text textStyle="body-sm" color="gray.500">Software Engineer</Text>
+ *             </VStack>
+ *         </HStack>
+ *     </HoverCard>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `HoverCard.Types` — the East data type and the style struct. The
+ * preview body is the children; the hovered element is the `trigger` prop.
+ * Desugars to `HoverCard.Root(body, options)`.
+ */
+export declare const HoverCard: JsxTag<ContainerProps<typeof HoverCardFactory.Root>> & {
+    Types: typeof HoverCardFactory.Types;
+};
+//# sourceMappingURL=hover-card.d.ts.map

package/dist/src/runtime/overlays/hover-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-card.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/hover-card.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,gBAAgB,CAAC,KAAK,CAAA;CAC/B,CAAC"}

package/dist/src/runtime/overlays/hover-card.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<HoverCard>` tag — see the export's JSDoc. */
+import { HoverCard as HoverCardFactory } from "../../overlays/hover-card/index.js";
+import { container } from "../combinators.js";
+/**
+ * HoverCard — a rich preview panel that opens on hover, after a short delay.
+ * Use it for context that is helpful but optional: a profile card behind a
+ * @-mention, a link preview, or a summary behind an entity name. It carries
+ * arbitrary UI children (avatars, badges, text), which distinguishes it from
+ * the text-only {@link Tooltip}. Placement, open/close delays, and a pointing
+ * arrow are flat props ({@link HoverCardOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Avatar, HoverCard, HStack, Text, UIComponentType, VStack } from "@elaraai/east-ui";
+ *
+ * const profile = East.function([], UIComponentType, _$ => (
+ *     <HoverCard trigger={<Text color="link" fontWeight="medium">@johndoe</Text>} placement="bottom" openDelay={200n}>
+ *         <HStack gap="3">
+ *             <Avatar name="John Doe" size="lg" />
+ *             <VStack gap="1" align="flex-start">
+ *                 <Text fontWeight="semibold">John Doe</Text>
+ *                 <Text textStyle="body-sm" color="gray.500">Software Engineer</Text>
+ *             </VStack>
+ *         </HStack>
+ *     </HoverCard>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `HoverCard.Types` — the East data type and the style struct. The
+ * preview body is the children; the hovered element is the `trigger` prop.
+ * Desugars to `HoverCard.Root(body, options)`.
+ */
+export const HoverCard = Object.assign(container(HoverCardFactory.Root), { Types: HoverCardFactory.Types });
+//# sourceMappingURL=hover-card.js.map

package/dist/src/runtime/overlays/hover-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover-card.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/hover-card.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,SAAS,GAClB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Overlay JSX tags. Mirrors `src/overlays/`. */
+export { Tooltip } from "./tooltip.js";
+export { ToggleTip } from "./toggle-tip.js";
+export { Popover } from "./popover.js";
+export { HoverCard } from "./hover-card.js";
+export { Dialog } from "./dialog.js";
+export { Drawer } from "./drawer.js";
+export { CommandPalette } from "./command-palette.js";
+export { ActionBar } from "./action-bar.js";
+export { Menu } from "./menu.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Overlay JSX tags. Mirrors `src/overlays/`. */
+export { Tooltip } from "./tooltip.js";
+export { ToggleTip } from "./toggle-tip.js";
+export { Popover } from "./popover.js";
+export { HoverCard } from "./hover-card.js";
+export { Dialog } from "./dialog.js";
+export { Drawer } from "./drawer.js";
+export { CommandPalette } from "./command-palette.js";
+export { ActionBar } from "./action-bar.js";
+export { Menu } from "./menu.js";
+//# sourceMappingURL=index.js.map