@elaraai/east-ui 1.0.3 → 1.0.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/menu.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.
+ */
+/** `<Menu>` tag — see the export's JSDoc. */
+import { Menu as MenuFactory, type MenuOptions } from "../../overlays/menu/index.js";
+import { type JsxTag } from "../combinators.js";
+/** Item + group label + separator builders carried alongside the `<Menu>` tag. */
+type MenuBuilders = {
+    Item: typeof MenuFactory.Item;
+    GroupLabel: typeof MenuFactory.GroupLabel;
+    Separator: typeof MenuFactory.Separator;
+    Types: typeof MenuFactory.Types;
+};
+/**
+ * Menu — a dropdown of discrete actions opened from a `trigger`. Reach for it as
+ * the canonical row-end "kebab" overflow or an account menu: a short list of
+ * commands, with optional disabled entries and `Menu.Separator` dividers between
+ * groups. The `items` array and `placement` are flat props ({@link MenuOptions});
+ * unlike {@link Popover} the body is a fixed list of items, not arbitrary UI.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { IconButton, Menu, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const overflow = East.function([], UIComponentType, _$ => (
+ *     <Menu
+ *         trigger={<IconButton prefix="fas" name="ellipsis" label="More" variant="ghost" size="sm" />}
+ *         items={[
+ *             Menu.GroupLabel("Actions"),
+ *             Menu.Item("edit", "Edit · rename", { icon: "pen" }),
+ *             Menu.Item("duplicate", "Duplicate", { icon: "copy", command: "⌘D" }),
+ *             Menu.Separator(),
+ *             Menu.Item("archive", "Archive", { icon: "trash", destructive: true }),
+ *         ]}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Menu.Types` and the `Menu.Item(value, label, options?)` /
+ * `Menu.GroupLabel(label)` / `Menu.Separator()` item builders for the
+ * `items` array. Desugars to `Menu.Root(options)`.
+ */
+export declare const Menu: JsxTag<MenuOptions> & MenuBuilders;
+export {};
+//# sourceMappingURL=menu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/menu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5D,kFAAkF;AAClF,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,OAAO,WAAW,CAAC,IAAI,CAAC;IAC9B,UAAU,EAAE,OAAO,WAAW,CAAC,UAAU,CAAC;IAC1C,SAAS,EAAE,OAAO,WAAW,CAAC,SAAS,CAAC;IACxC,KAAK,EAAE,OAAO,WAAW,CAAC,KAAK,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,YAKvC,CAAC"}

package/dist/src/runtime/overlays/menu.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.
+ */
+/** `<Menu>` tag — see the export's JSDoc. */
+import { Menu as MenuFactory } from "../../overlays/menu/index.js";
+import { optionsTag } from "../combinators.js";
+/**
+ * Menu — a dropdown of discrete actions opened from a `trigger`. Reach for it as
+ * the canonical row-end "kebab" overflow or an account menu: a short list of
+ * commands, with optional disabled entries and `Menu.Separator` dividers between
+ * groups. The `items` array and `placement` are flat props ({@link MenuOptions});
+ * unlike {@link Popover} the body is a fixed list of items, not arbitrary UI.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { IconButton, Menu, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const overflow = East.function([], UIComponentType, _$ => (
+ *     <Menu
+ *         trigger={<IconButton prefix="fas" name="ellipsis" label="More" variant="ghost" size="sm" />}
+ *         items={[
+ *             Menu.GroupLabel("Actions"),
+ *             Menu.Item("edit", "Edit · rename", { icon: "pen" }),
+ *             Menu.Item("duplicate", "Duplicate", { icon: "copy", command: "⌘D" }),
+ *             Menu.Separator(),
+ *             Menu.Item("archive", "Archive", { icon: "trash", destructive: true }),
+ *         ]}
+ *     />
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Menu.Types` and the `Menu.Item(value, label, options?)` /
+ * `Menu.GroupLabel(label)` / `Menu.Separator()` item builders for the
+ * `items` array. Desugars to `Menu.Root(options)`.
+ */
+export const Menu = Object.assign(optionsTag(MenuFactory.Root), {
+    Item: MenuFactory.Item,
+    GroupLabel: MenuFactory.GroupLabel,
+    Separator: MenuFactory.Separator,
+    Types: MenuFactory.Types,
+});
+//# sourceMappingURL=menu.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/menu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,IAAI,IAAI,WAAW,EAAoB,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAU5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,IAAI,GAAuC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;IAChG,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,UAAU,EAAE,WAAW,CAAC,UAAU;IAClC,SAAS,EAAE,WAAW,CAAC,SAAS;IAChC,KAAK,EAAE,WAAW,CAAC,KAAK;CAC3B,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Popover>` tag — see the export's JSDoc. */
+import { Popover as PopoverFactory } from "../../overlays/popover/index.js";
+import { type ContainerProps, type JsxTag } from "../combinators.js";
+/**
+ * Popover — a non-modal floating panel anchored to a `trigger` and opened by
+ * click. Unlike a {@link Dialog} it does not capture the page; use it for an
+ * inline edit form, a small chart, or a details panel that should sit next to
+ * its trigger. The body is the children (any UI components); an optional title
+ * and description render as a header. Placement, a pointing arrow, and an
+ * `onOpenChange` callback are flat props ({@link PopoverOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Popover, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Popover trigger={<Button>Open Popover</Button>} title="Popover Title" description="A helpful description">
+ *         <Text>This is the popover content. You can put any UI components here.</Text>
+ *     </Popover>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Popover.Types` — the East data type and the style struct. The panel
+ * body is the children; the anchoring element is the `trigger` prop. Desugars
+ * to `Popover.Root(body, options)`.
+ */
+export declare const Popover: JsxTag<ContainerProps<typeof PopoverFactory.Root>> & {
+    Types: typeof PopoverFactory.Types;
+};
+//# sourceMappingURL=popover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/popover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gDAAgD;AAEhD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,cAAc,CAAC,KAAK,CAAA;CAC7B,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Popover>` tag — see the export's JSDoc. */
+import { Popover as PopoverFactory } from "../../overlays/popover/index.js";
+import { container } from "../combinators.js";
+/**
+ * Popover — a non-modal floating panel anchored to a `trigger` and opened by
+ * click. Unlike a {@link Dialog} it does not capture the page; use it for an
+ * inline edit form, a small chart, or a details panel that should sit next to
+ * its trigger. The body is the children (any UI components); an optional title
+ * and description render as a header. Placement, a pointing arrow, and an
+ * `onOpenChange` callback are flat props ({@link PopoverOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Popover, Text, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const panel = East.function([], UIComponentType, _$ => (
+ *     <Popover trigger={<Button>Open Popover</Button>} title="Popover Title" description="A helpful description">
+ *         <Text>This is the popover content. You can put any UI components here.</Text>
+ *     </Popover>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Popover.Types` — the East data type and the style struct. The panel
+ * body is the children; the anchoring element is the `trigger` prop. Desugars
+ * to `Popover.Root(body, options)`.
+ */
+export const Popover = Object.assign(container(PopoverFactory.Root), { Types: PopoverFactory.Types });
+//# sourceMappingURL=popover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"popover.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/popover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gDAAgD;AAEhD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAoC,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,OAAO,GAChB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/src/runtime/overlays/toggle-tip.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ToggleTip>` tag — see the export's JSDoc. */
+import { ToggleTip as ToggleTipFactory } from "../../overlays/toggle-tip/index.js";
+import { type ContentProps, type JsxTag } from "../combinators.js";
+/**
+ * Click-activated tip — an accessible alternative to the hover {@link Tooltip}.
+ * Tapping or focusing the `trigger` toggles a small floating panel, so it works
+ * for touch and keyboard users where a hover tip never appears. Pair it with an
+ * info `IconButton` next to a label to offer an optional "what is this?"
+ * explanation. Placement, a pointing arrow, and an `onOpenChange` callback are
+ * flat props ({@link ToggleTipOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { HStack, IconButton, Text, ToggleTip, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const help = East.function([], UIComponentType, _$ => (
+ *     <HStack gap="2" align="center">
+ *         <Text>What is this?</Text>
+ *         <ToggleTip
+ *             trigger={<IconButton prefix="fas" name="circle-info" label="What is this" variant="ghost" size="xs" />}
+ *             placement="top"
+ *             hasArrow={true}
+ *         >
+ *             An accessible alternative to hover tooltips. Click to toggle!
+ *         </ToggleTip>
+ *     </HStack>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ToggleTip.Types` — the East data type and the style struct. The tip
+ * text is the child; the activating element is the `trigger` prop. Desugars to
+ * `ToggleTip.Root(content, options)`.
+ */
+export declare const ToggleTip: JsxTag<ContentProps<typeof ToggleTipFactory.Root>> & {
+    Types: typeof ToggleTipFactory.Types;
+};
+//# sourceMappingURL=toggle-tip.d.ts.map

package/dist/src/runtime/overlays/toggle-tip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-tip.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/toggle-tip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAElD,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAW,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,gBAAgB,CAAC,KAAK,CAAA;CAC/B,CAAC"}

package/dist/src/runtime/overlays/toggle-tip.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<ToggleTip>` tag — see the export's JSDoc. */
+import { ToggleTip as ToggleTipFactory } from "../../overlays/toggle-tip/index.js";
+import { content } from "../combinators.js";
+/**
+ * Click-activated tip — an accessible alternative to the hover {@link Tooltip}.
+ * Tapping or focusing the `trigger` toggles a small floating panel, so it works
+ * for touch and keyboard users where a hover tip never appears. Pair it with an
+ * info `IconButton` next to a label to offer an optional "what is this?"
+ * explanation. Placement, a pointing arrow, and an `onOpenChange` callback are
+ * flat props ({@link ToggleTipOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { HStack, IconButton, Text, ToggleTip, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const help = East.function([], UIComponentType, _$ => (
+ *     <HStack gap="2" align="center">
+ *         <Text>What is this?</Text>
+ *         <ToggleTip
+ *             trigger={<IconButton prefix="fas" name="circle-info" label="What is this" variant="ghost" size="xs" />}
+ *             placement="top"
+ *             hasArrow={true}
+ *         >
+ *             An accessible alternative to hover tooltips. Click to toggle!
+ *         </ToggleTip>
+ *     </HStack>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `ToggleTip.Types` — the East data type and the style struct. The tip
+ * text is the child; the activating element is the `trigger` prop. Desugars to
+ * `ToggleTip.Root(content, options)`.
+ */
+export const ToggleTip = Object.assign(content(ToggleTipFactory.Root), { Types: ToggleTipFactory.Types });
+//# sourceMappingURL=toggle-tip.js.map

package/dist/src/runtime/overlays/toggle-tip.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Tooltip>` tag — see the export's JSDoc. */
+import { Tooltip as TooltipFactory } from "../../overlays/tooltip/index.js";
+import { type ContentProps, type JsxTag } from "../combinators.js";
+/**
+ * Hover tooltip — a small floating label that explains the element it wraps.
+ * The `trigger` is the element you hover; the tip text is the child. Reach for
+ * it to clarify an icon, abbreviate a long label, or surface a keyboard
+ * shortcut; for click-activated or touch-friendly hints use {@link ToggleTip},
+ * and for rich previews use {@link HoverCard}. Placement, an optional pointing
+ * arrow, and open/close delays are flat props ({@link TooltipOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Tooltip, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const tip = East.function([], UIComponentType, _$ => (
+ *     <Tooltip trigger={<Button variant="solid">With Arrow</Button>} hasArrow={true}>
+ *         This tooltip has an arrow
+ *     </Tooltip>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Tooltip.Types` — the East data type and the style struct. The tip
+ * text is the child; the hovered element is the `trigger` prop. Desugars to
+ * `Tooltip.Root(content, options)`.
+ */
+export declare const Tooltip: JsxTag<ContentProps<typeof TooltipFactory.Root>> & {
+    Types: typeof TooltipFactory.Types;
+};
+//# sourceMappingURL=tooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../src/runtime/overlays/tooltip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gDAAgD;AAEhD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAW,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,cAAc,CAAC,KAAK,CAAA;CAC7B,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Tooltip>` tag — see the export's JSDoc. */
+import { Tooltip as TooltipFactory } from "../../overlays/tooltip/index.js";
+import { content } from "../combinators.js";
+/**
+ * Hover tooltip — a small floating label that explains the element it wraps.
+ * The `trigger` is the element you hover; the tip text is the child. Reach for
+ * it to clarify an icon, abbreviate a long label, or surface a keyboard
+ * shortcut; for click-activated or touch-friendly hints use {@link ToggleTip},
+ * and for rich previews use {@link HoverCard}. Placement, an optional pointing
+ * arrow, and open/close delays are flat props ({@link TooltipOptions}).
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East } from "@elaraai/east";
+ * import { Button, Tooltip, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const tip = East.function([], UIComponentType, _$ => (
+ *     <Tooltip trigger={<Button variant="solid">With Arrow</Button>} hasArrow={true}>
+ *         This tooltip has an arrow
+ *     </Tooltip>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Carries `Tooltip.Types` — the East data type and the style struct. The tip
+ * text is the child; the hovered element is the `trigger` prop. Desugars to
+ * `Tooltip.Root(content, options)`.
+ */
+export const Tooltip = Object.assign(content(TooltipFactory.Root), { Types: TooltipFactory.Types });
+//# sourceMappingURL=tooltip.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../../../src/runtime/overlays/tooltip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gDAAgD;AAEhD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAkC,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,OAAO,GAChB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC"}

package/dist/src/runtime/platform-hotkey.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Hotkey>` tag — see the export's JSDoc. */
+import { type ExprType, type SubtypeExprOrValue, type FunctionType, type NullType, StringType } from "@elaraai/east";
+import { Hotkey as HotkeyFactory } from "../platform/hotkey/index.js";
+import { UIComponentType } from "../component.js";
+/**
+ * `<Hotkey>` — a renderless keyboard-chord listener. Mounts a global
+ * handler for `chord` (e.g. `"mod+k"`) and fires `onTrigger` when pressed;
+ * renders nothing.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType } from "@elaraai/east";
+ * import { Hotkey, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const palette = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const trigger = $.const(East.function([], NullType, ($) => {
+ *             // open the palette
+ *         }));
+ *         return <Hotkey chord="mod+k" onTrigger={trigger} />;
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Desugars to `Hotkey.Root(chord, onTrigger)`.
+ */
+declare function HotkeyTag(props: {
+    chord: SubtypeExprOrValue<StringType>;
+    onTrigger: SubtypeExprOrValue<FunctionType<[], NullType>>;
+}): ExprType<UIComponentType>;
+export declare const Hotkey: typeof HotkeyTag & {
+    Types: typeof HotkeyFactory.Types;
+};
+export {};
+//# sourceMappingURL=platform-hotkey.d.ts.map

package/dist/src/runtime/platform-hotkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-hotkey.d.ts","sourceRoot":"","sources":["../../../src/runtime/platform-hotkey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrH,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE;IACtB,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACtC,SAAS,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;CAC7D,GAAG,QAAQ,CAAC,eAAe,CAAC,CAE5B;AAED,eAAO,MAAM,MAAM,EAAE,OAAO,SAAS,GAAG;IACpC,KAAK,EAAE,OAAO,aAAa,CAAC,KAAK,CAAC;CAGpC,CAAC"}

package/dist/src/runtime/platform-hotkey.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** `<Hotkey>` tag — see the export's JSDoc. */
+import { StringType } from "@elaraai/east";
+import { Hotkey as HotkeyFactory } from "../platform/hotkey/index.js";
+import { UIComponentType } from "../component.js";
+/**
+ * `<Hotkey>` — a renderless keyboard-chord listener. Mounts a global
+ * handler for `chord` (e.g. `"mod+k"`) and fires `onTrigger` when pressed;
+ * renders nothing.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, NullType } from "@elaraai/east";
+ * import { Hotkey, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const palette = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const trigger = $.const(East.function([], NullType, ($) => {
+ *             // open the palette
+ *         }));
+ *         return <Hotkey chord="mod+k" onTrigger={trigger} />;
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * Desugars to `Hotkey.Root(chord, onTrigger)`.
+ */
+function HotkeyTag(props) {
+    return HotkeyFactory.Root(props.chord, props.onTrigger);
+}
+export const Hotkey = Object.assign(HotkeyTag, {
+    Types: HotkeyFactory.Types,
+});
+//# sourceMappingURL=platform-hotkey.js.map

package/dist/src/runtime/platform-hotkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-hotkey.js","sourceRoot":"","sources":["../../../src/runtime/platform-hotkey.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+CAA+C;AAE/C,OAAO,EAA4E,UAAU,EAAE,MAAM,eAAe,CAAC;AACrH,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,SAAS,CAAC,KAGlB;IACG,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAEf,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;IACzB,KAAK,EAAE,aAAa,CAAC,KAAK;CAC7B,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/reactive/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/src/runtime/reactive/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.
+ */
+/** Reactive JSX tag. Mirrors `src/reactive/`. */
+export { Reactive } from "./reactive.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/reactive/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The `<Reactive>` selective-rerender tag.
+ */
+import { type BlockBuilder, type SubtypeExprOrValue } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import type { UIElement } from "../runtime.js";
+/**
+ * The builder body of a `<Reactive>` tag — an East block whose `$` reads
+ * State/Data, binds locals, and returns the subtree to render. The set of
+ * State/Data reads it touches becomes the reactive subscription.
+ */
+export type ReactiveRender = ($: BlockBuilder<typeof UIComponentType>) => SubtypeExprOrValue<typeof UIComponentType> | void;
+/**
+ * Reactive boundary — re-renders only this subtree when the State or Data it
+ * reads changes, leaving the rest of the surface untouched. Use it to wrap
+ * any interactive region (a counter, a form, a filtered list) so that
+ * updating its backing State does not re-render the whole page. The child is
+ * a builder closure `{$ => …}`: inside it you bind State/Data with
+ * `State.bind` / `Data.bind`, read and write through the returned closures,
+ * and return the rendered components.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, IntegerType, NullType } from "@elaraai/east";
+ * import { Button, Reactive, State, Text, VStack, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const counter = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const countBind = $.let(State.bind([IntegerType], "demo.counter", 0n));
+ *         const count = $.let(countBind.read());
+ *         const increment = $.const(East.function([], NullType, $ => {
+ *             const current = $.let(countBind.read());
+ *             $(countBind.write(current.add(1n)));
+ *         }));
+ *         return (
+ *             <VStack gap="2" align="stretch">
+ *                 <Text>{East.str`Count: ${count}`}</Text>
+ *                 <Button onClick={increment}>+1</Button>
+ *             </VStack>
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * The child is a {@link ReactiveRender} block-builder, not a UI sub-tag. The
+ * tag lifts it into the zero-input `East.function([], UIComponentType, …)`
+ * that the factory expects, so authors write the `$` block directly. Desugars
+ * to `Reactive.Root(East.function([], UIComponentType, children))`.
+ */
+export declare function Reactive(props: {
+    children: ReactiveRender;
+}): UIElement;
+//# sourceMappingURL=reactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../../../src/runtime/reactive/reactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAQ,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CACzB,CAAC,EAAE,YAAY,CAAC,OAAO,eAAe,CAAC,KACtC,kBAAkB,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,GAAG,SAAS,CAEvE"}

package/dist/src/runtime/reactive/reactive.js

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The `<Reactive>` selective-rerender tag.
+ */
+import { East } from "@elaraai/east";
+import { Reactive as ReactiveFactory } from "../../reactive/index.js";
+import { UIComponentType } from "../../component.js";
+/**
+ * Reactive boundary — re-renders only this subtree when the State or Data it
+ * reads changes, leaving the rest of the surface untouched. Use it to wrap
+ * any interactive region (a counter, a form, a filtered list) so that
+ * updating its backing State does not re-render the whole page. The child is
+ * a builder closure `{$ => …}`: inside it you bind State/Data with
+ * `State.bind` / `Data.bind`, read and write through the returned closures,
+ * and return the rendered components.
+ *
+ * @example
+ * ```tsx
+ * // .tsx file with the `@jsxImportSource @elaraai/east-ui` pragma
+ * import { East, IntegerType, NullType } from "@elaraai/east";
+ * import { Button, Reactive, State, Text, VStack, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const counter = East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const countBind = $.let(State.bind([IntegerType], "demo.counter", 0n));
+ *         const count = $.let(countBind.read());
+ *         const increment = $.const(East.function([], NullType, $ => {
+ *             const current = $.let(countBind.read());
+ *             $(countBind.write(current.add(1n)));
+ *         }));
+ *         return (
+ *             <VStack gap="2" align="stretch">
+ *                 <Text>{East.str`Count: ${count}`}</Text>
+ *                 <Button onClick={increment}>+1</Button>
+ *             </VStack>
+ *         );
+ *     }}</Reactive>
+ * ));
+ * ```
+ *
+ * @remarks
+ * The child is a {@link ReactiveRender} block-builder, not a UI sub-tag. The
+ * tag lifts it into the zero-input `East.function([], UIComponentType, …)`
+ * that the factory expects, so authors write the `$` block directly. Desugars
+ * to `Reactive.Root(East.function([], UIComponentType, children))`.
+ */
+export function Reactive(props) {
+    return ReactiveFactory.Root(East.function([], UIComponentType, props.children));
+}
+//# sourceMappingURL=reactive.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../../../src/runtime/reactive/reactive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,IAAI,EAA8C,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAYrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAmC;IACxD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpF,CAAC"}