@elaraai/east-ui 1.0.3 → 1.0.5

package/dist/src/overlays/menu/types.js

@@ -4,6 +4,7 @@
  */
 import { OptionType, StructType, StringType, NullType, BooleanType, VariantType, } from "@elaraai/east";
 import { PlacementType } from "../tooltip/types.js";
+import {} from "../../display/icon/types.js";
 // Re-export PlacementType for convenience
 export { PlacementType } from "../tooltip/types.js";
 // ============================================================================
@@ -13,9 +14,13 @@ export { PlacementType } from "../tooltip/types.js";
  * Menu item variant type.
  *
  * @remarks
- * Menu items can be either an Item (clickable menu entry) or a Separator (visual divider).
+ * Menu items can be an Item (clickable menu entry), a GroupLabel (uppercase
+ * mono eyebrow naming the section below it), or a Separator (visual divider).
+ * Destructive items render in the negative ink and belong at the bottom of
+ * the menu, after a separator.
  *
- * @property Item - A clickable menu item with value, label, and optional disabled state
+ * @property Item - A clickable menu item with value, label, and optional icon / accelerator / disabled / destructive state
+ * @property GroupLabel - An uppercase eyebrow heading for the items that follow
  * @property Separator - A visual separator between menu items
  */
 export const MenuItemType = VariantType({
@@ -27,8 +32,17 @@ export const MenuItemType = VariantType({
         label: StringType,
         /** Whether the item is disabled */
         disabled: OptionType(BooleanType),
-        /** Callback function when the item is selected */
-        // onClick: FunctionType([], NullType, null),
+        /** Font Awesome solid icon name rendered before the label (e.g. `"pen"`, `"copy"`) */
+        icon: OptionType(StringType),
+        /** Keyboard accelerator shown right-aligned in mono (e.g. `"⌘D"`) */
+        command: OptionType(StringType),
+        /** Whether the action is destructive — renders in the negative ink */
+        destructive: OptionType(BooleanType),
+    }),
+    /** An uppercase eyebrow heading for the items that follow */
+    GroupLabel: StructType({
+        /** Heading text — rendered uppercase in the mono eyebrow style */
+        label: StringType,
     }),
     /** A visual separator between items */
     Separator: NullType,

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/overlays/menu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEH,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAyB,MAAM,qBAAqB,CAAC;AAE3E,0CAA0C;AAC1C,OAAO,EAAE,aAAa,EAAyB,MAAM,qBAAqB,CAAC;AAE3E,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,4BAA4B;IAC5B,IAAI,EAAE,UAAU,CAAC;QACb,qCAAqC;QACrC,KAAK,EAAE,UAAU;QACjB,gCAAgC;QAChC,KAAK,EAAE,UAAU;QACjB,mCAAmC;QACnC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;QACjC,kDAAkD;QAClD,6CAA6C;KAChD,CAAC;IACF,uCAAuC;IACvC,SAAS,EAAE,QAAQ;CACtB,CAAC,CAAC;AAOH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACpC,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC;CACvC,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/overlays/menu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAyB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAiB,MAAM,6BAA6B,CAAC;AAE5D,0CAA0C;AAC1C,OAAO,EAAE,aAAa,EAAyB,MAAM,qBAAqB,CAAC;AAE3E,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,4BAA4B;IAC5B,IAAI,EAAE,UAAU,CAAC;QACb,qCAAqC;QACrC,KAAK,EAAE,UAAU;QACjB,gCAAgC;QAChC,KAAK,EAAE,UAAU;QACjB,mCAAmC;QACnC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;QACjC,sFAAsF;QACtF,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;QAC5B,qEAAqE;QACrE,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;QAC/B,sEAAsE;QACtE,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;KACvC,CAAC;IACF,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;QACnB,kEAAkE;QAClE,KAAK,EAAE,UAAU;KACpB,CAAC;IACF,uCAAuC;IACvC,SAAS,EAAE,QAAQ;CACtB,CAAC,CAAC;AA0BH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACpC,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC;CACvC,CAAC,CAAC"}

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

@@ -34,9 +34,8 @@ export type PopoverType = typeof PopoverType;
 /**
  * Creates a Popover component with a trigger and body content.
  *
- * @param trigger - The UI component that opens the popover
  * @param body - Array of UI components for popover content
- * @param style - Optional styling configuration
+ * @param options - Required `trigger` + optional `title` / `description` / visual style fields
  * @returns An East expression representing the popover component
  *
  * @remarks
@@ -49,28 +48,30 @@ export type PopoverType = typeof PopoverType;
  * import { Popover, Button, Text, UIComponentType } from "@elaraai/east-ui";
  *
  * const example = East.function([], UIComponentType, $ => {
- *     return Popover.Root(
- *         Button.Root("Edit"),
- *         [Text.Root("Edit your profile")],
- *         { title: "Edit Profile" }
- *     );
+ *     return Popover.Root([Text.Root("Edit your profile")], {
+ *         trigger: Button.Root("Edit"),
+ *         title: "Edit Profile",
+ *     });
  * });
  * ```
  */
-declare function createPopover(trigger: SubtypeExprOrValue<UIComponentType>, body: SubtypeExprOrValue<ArrayType<UIComponentType>>, style?: PopoverStyle): ExprType<UIComponentType>;
+export interface PopoverOptions extends PopoverStyle {
+    /** The UI component that opens the popover — required. */
+    trigger: SubtypeExprOrValue<UIComponentType>;
+}
+declare function createPopover(body: SubtypeExprOrValue<ArrayType<UIComponentType>>, options: PopoverOptions): ExprType<UIComponentType>;
 /**
  * Popover component for floating interactive content.
  *
  * @remarks
- * Use `Popover.Root(trigger, body, style)` to create a popover, or access `Popover.Types` for East types.
+ * Use `Popover.Root(body, { trigger, ... })` to create a popover, or access `Popover.Types` for East types.
  */
 export declare const Popover: {
     /**
      * Creates a Popover component with a trigger and body content.
      *
-     * @param trigger - The UI component that opens the popover
      * @param body - Array of UI components for popover content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional `title` / `description` / visual style fields
      * @returns An East expression representing the popover component
      *
      * @remarks
@@ -83,11 +84,10 @@ export declare const Popover: {
      * import { Popover, Button, Text, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return Popover.Root(
-     *         Button.Root("Show Info"),
-     *         [Text.Root("Popover content here")],
-     *         { title: "Information" }
-     *     );
+     *     return Popover.Root([Text.Root("Popover content here")], {
+     *         trigger: Button.Root("Show Info"),
+     *         title: "Information",
+     *     });
      * });
      * ```
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/popover/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAAE,UAAU,EACtB,UAAU,EACV,SAAS,EAEZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,gBAAgB,EAChB,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,eAAe,EACf,gBAAgB,EAChB,KAAK,YAAY,EACjB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMvE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACjC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9B,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;CACvC,CAMC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAM7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,aAAa,CAClB,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACpD,KAAK,CAAC,EAAE,YAAY,GACrB,QAAQ,CAAC,eAAe,CAAC,CA+B3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;;;QAGC;;;;;;;;;;;;;WAaG;;qBArIE,eAAe;kBAClB,SAAS,CAAC,eAAe,CAAC;mBACzB,UAAU,CAAC,UAAU,CAAC;yBAChB,UAAU,CAAC,UAAU,CAAC;mBAC5B,UAAU,CAAC,gBAAgB,CAAC;;QAmI/B;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;WAWG;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/popover/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAAE,UAAU,EACtB,UAAU,EACV,SAAS,EAIZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,gBAAgB,EAChB,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,eAAe,EACf,gBAAgB,EAChB,KAAK,YAAY,EACjB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMvE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACjC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9B,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;CACvC,CAMC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAM7C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAChD,0DAA0D;IAC1D,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAChD;AAED,iBAAS,aAAa,CAClB,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACpD,OAAO,EAAE,cAAc,GACxB,QAAQ,CAAC,eAAe,CAAC,CAiC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;;QAGC;;;;;;;;;;;;;WAaG;;qBAvIE,eAAe;kBAClB,SAAS,CAAC,eAAe,CAAC;mBACzB,UAAU,CAAC,UAAU,CAAC;yBAChB,UAAU,CAAC,UAAU,CAAC;mBAC5B,UAAU,CAAC,gBAAgB,CAAC;;QAqI/B;;;;;;;;;;;WAWG;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;WAWG;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}

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

@@ -2,7 +2,7 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { East, StringType, OptionType, StructType, ArrayType, variant } from "@elaraai/east";
+import { East, StringType, OptionType, StructType, ArrayType, variant, some, none, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { PopoverSizeType, PopoverStyleType, PlacementType } from "./types.js";
 // Re-export types
@@ -30,77 +30,48 @@ export const PopoverType = StructType({
     description: OptionType(StringType),
     style: OptionType(PopoverStyleType),
 });
-// ============================================================================
-// Popover Function
-// ============================================================================
-/**
- * Creates a Popover component with a trigger and body content.
- *
- * @param trigger - The UI component that opens the popover
- * @param body - Array of UI components for popover content
- * @param style - Optional styling configuration
- * @returns An East expression representing the popover component
- *
- * @remarks
- * Popover displays rich interactive content in a floating panel.
- * Unlike Tooltip, it's controlled via click and can contain form elements.
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { Popover, Button, Text, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, $ => {
- *     return Popover.Root(
- *         Button.Root("Edit"),
- *         [Text.Root("Edit your profile")],
- *         { title: "Edit Profile" }
- *     );
- * });
- * ```
- */
-function createPopover(trigger, body, style) {
-    const sizeValue = style?.size
+function createPopover(body, options) {
+    const { trigger, ...style } = options;
+    const sizeValue = style.size
         ? (typeof style.size === "string"
             ? East.value(variant(style.size, null), PopoverSizeType)
             : style.size)
         : undefined;
-    const placementValue = style?.placement
+    const placementValue = style.placement
         ? (typeof style.placement === "string"
             ? East.value(variant(style.placement, null), PlacementType)
             : style.placement)
         : undefined;
-    const hasStyle = sizeValue || placementValue || style?.hasArrow !== undefined ||
-        style?.gutter !== undefined || style?.onOpenChange !== undefined;
+    const hasStyle = sizeValue || placementValue || style.hasArrow !== undefined ||
+        style.gutter !== undefined || style.onOpenChange !== undefined;
     return East.value(variant("Popover", {
         trigger: trigger,
         body: body,
-        title: style?.title !== undefined ? variant("some", style.title) : variant("none", null),
-        description: style?.description !== undefined ? variant("some", style.description) : variant("none", null),
+        title: style.title !== undefined ? some(style.title) : none,
+        description: style.description !== undefined ? some(style.description) : none,
         style: hasStyle
-            ? variant("some", East.value({
-                size: sizeValue ? variant("some", sizeValue) : variant("none", null),
-                placement: placementValue ? variant("some", placementValue) : variant("none", null),
-                hasArrow: style?.hasArrow !== undefined ? variant("some", style.hasArrow) : variant("none", null),
-                gutter: style?.gutter !== undefined ? variant("some", style.gutter) : variant("none", null),
-                onOpenChange: style?.onOpenChange !== undefined ? variant("some", style.onOpenChange) : variant("none", null),
+            ? some(East.value({
+                size: sizeValue ? some(sizeValue) : none,
+                placement: placementValue ? some(placementValue) : none,
+                hasArrow: style.hasArrow !== undefined ? some(style.hasArrow) : none,
+                gutter: style.gutter !== undefined ? some(style.gutter) : none,
+                onOpenChange: style.onOpenChange !== undefined ? some(style.onOpenChange) : none,
             }, PopoverStyleType))
-            : variant("none", null),
+            : none,
     }), UIComponentType);
 }
 /**
  * Popover component for floating interactive content.
  *
  * @remarks
- * Use `Popover.Root(trigger, body, style)` to create a popover, or access `Popover.Types` for East types.
+ * Use `Popover.Root(body, { trigger, ... })` to create a popover, or access `Popover.Types` for East types.
  */
 export const Popover = {
     /**
      * Creates a Popover component with a trigger and body content.
      *
-     * @param trigger - The UI component that opens the popover
      * @param body - Array of UI components for popover content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional `title` / `description` / visual style fields
      * @returns An East expression representing the popover component
      *
      * @remarks
@@ -113,11 +84,10 @@ export const Popover = {
      * import { Popover, Button, Text, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return Popover.Root(
-     *         Button.Root("Show Info"),
-     *         [Text.Root("Popover content here")],
-     *         { title: "Information" }
-     *     );
+     *     return Popover.Root([Text.Root("Popover content here")], {
+     *         trigger: Button.Root("Show Info"),
+     *         title: "Information",
+     *     });
      * });
      * ```
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/popover/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/popover/index.ts"],"names":[],"mappings":"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"}

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

@@ -30,9 +30,8 @@ export type ToggleTipType = typeof ToggleTipType;
 /**
  * Creates a ToggleTip component with a trigger and content.
  *
- * @param trigger - The UI component that toggles the tip
  * @param content - The text content of the tip
- * @param style - Optional styling configuration
+ * @param options - Required `trigger` + optional visual style fields
  * @returns An East expression representing the toggle tip component
  *
  * @remarks
@@ -45,27 +44,29 @@ export type ToggleTipType = typeof ToggleTipType;
  * import { ToggleTip, Button, UIComponentType } from "@elaraai/east-ui";
  *
  * const example = East.function([], UIComponentType, $ => {
- *     return ToggleTip.Root(
- *         Button.Root("?", { variant: "ghost", size: "sm" }),
- *         "Click to learn more about this feature"
- *     );
+ *     return ToggleTip.Root("Click to learn more about this feature", {
+ *         trigger: Button.Root("?", { variant: "ghost", size: "sm" }),
+ *     });
  * });
  * ```
  */
-declare function createToggleTip(trigger: SubtypeExprOrValue<UIComponentType>, content: SubtypeExprOrValue<StringType>, style?: ToggleTipStyle): ExprType<UIComponentType>;
+export interface ToggleTipOptions extends ToggleTipStyle {
+    /** The UI component that toggles the tip — required. */
+    trigger: SubtypeExprOrValue<UIComponentType>;
+}
+declare function createToggleTip(content: SubtypeExprOrValue<StringType>, options: ToggleTipOptions): ExprType<UIComponentType>;
 /**
  * ToggleTip component for click-activated tips.
  *
  * @remarks
- * Use `ToggleTip.Root(trigger, content, style)` to create a toggle tip, or access `ToggleTip.Types` for East types.
+ * Use `ToggleTip.Root(content, { trigger, ... })` to create a toggle tip, or access `ToggleTip.Types` for East types.
  */
 export declare const ToggleTip: {
     /**
      * Creates a ToggleTip component with a trigger and content.
      *
-     * @param trigger - The UI component that toggles the tip
      * @param content - The text content of the tip
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional visual style fields
      * @returns An East expression representing the toggle tip component
      *
      * @remarks
@@ -78,10 +79,9 @@ export declare const ToggleTip: {
      * import { ToggleTip, IconButton, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return ToggleTip.Root(
-     *         IconButton.Root("fas", "circle-info"),
-     *         "Click for more information about this feature"
-     *     );
+     *     return ToggleTip.Root("Click for more information about this feature", {
+     *         trigger: IconButton.Root({ prefix: "fas", name: "circle-info", label: "Info" }),
+     *     });
      * });
      * ```
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/toggle-tip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAAE,UAAU,EACtB,UAAU,EAEb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAClB,KAAK,cAAc,EAEtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,kBAAkB,EAClB,KAAK,cAAc,EACnB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;CACzC,CAIC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,eAAe,CACpB,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACvC,KAAK,CAAC,EAAE,cAAc,GACvB,QAAQ,CAAC,eAAe,CAAC,CAoB3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IAClB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;;;QAGC;;;;;;;;;;;WAWG;;qBAlHE,eAAe;qBACf,UAAU;mBACZ,UAAU,CAAC,kBAAkB,CAAC;;QAkHjC;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/toggle-tip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EAAE,UAAU,EACtB,UAAU,EAIb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAClB,KAAK,cAAc,EAEtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,kBAAkB,EAClB,KAAK,cAAc,EACnB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;CACzC,CAIC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,wDAAwD;IACxD,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAChD;AAED,iBAAS,eAAe,CACpB,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACvC,OAAO,EAAE,gBAAgB,GAC1B,QAAQ,CAAC,eAAe,CAAC,CAsB3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IAClB;;;;;;;;;;;;;;;;;;;;;;OAsBG;;;QAGC;;;;;;;;;;;WAWG;;qBApHE,eAAe;qBACf,UAAU;mBACZ,UAAU,CAAC,kBAAkB,CAAC;;QAoHjC;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}

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

@@ -2,7 +2,7 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
-import { East, StringType, OptionType, StructType, variant } from "@elaraai/east";
+import { East, StringType, OptionType, StructType, variant, some, none, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { ToggleTipStyleType, PlacementType } from "./types.js";
 // Re-export types
@@ -26,66 +26,38 @@ export const ToggleTipType = StructType({
     content: StringType,
     style: OptionType(ToggleTipStyleType),
 });
-// ============================================================================
-// ToggleTip Function
-// ============================================================================
-/**
- * Creates a ToggleTip component with a trigger and content.
- *
- * @param trigger - The UI component that toggles the tip
- * @param content - The text content of the tip
- * @param style - Optional styling configuration
- * @returns An East expression representing the toggle tip component
- *
- * @remarks
- * ToggleTip provides an accessible alternative to hover-based tooltips.
- * It's activated by clicking, making it accessible to keyboard and touch users.
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { ToggleTip, Button, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, $ => {
- *     return ToggleTip.Root(
- *         Button.Root("?", { variant: "ghost", size: "sm" }),
- *         "Click to learn more about this feature"
- *     );
- * });
- * ```
- */
-function createToggleTip(trigger, content, style) {
-    const placementValue = style?.placement
-        ? (typeof style.placement === "string"
-            ? East.value(variant(style.placement, null), PlacementType)
-            : style.placement)
+function createToggleTip(content, options) {
+    const { trigger, ...visual } = options;
+    const placementValue = visual.placement
+        ? (typeof visual.placement === "string"
+            ? East.value(variant(visual.placement, null), PlacementType)
+            : visual.placement)
         : undefined;
-    const hasStyle = placementValue || style?.hasArrow !== undefined || style?.onOpenChange !== undefined;
+    const hasStyle = placementValue || visual.hasArrow !== undefined || visual.onOpenChange !== undefined;
     return East.value(variant("ToggleTip", {
         trigger: trigger,
         content: content,
         style: hasStyle
-            ? variant("some", East.value({
-                placement: placementValue ? variant("some", placementValue) : variant("none", null),
-                hasArrow: style?.hasArrow !== undefined ? variant("some", style.hasArrow) : variant("none", null),
-                onOpenChange: style?.onOpenChange !== undefined ? variant("some", style.onOpenChange) : variant("none", null),
+            ? some(East.value({
+                placement: placementValue ? some(placementValue) : none,
+                hasArrow: visual.hasArrow !== undefined ? some(visual.hasArrow) : none,
+                onOpenChange: visual.onOpenChange !== undefined ? some(visual.onOpenChange) : none,
             }, ToggleTipStyleType))
-            : variant("none", null),
+            : none,
     }), UIComponentType);
 }
 /**
  * ToggleTip component for click-activated tips.
  *
  * @remarks
- * Use `ToggleTip.Root(trigger, content, style)` to create a toggle tip, or access `ToggleTip.Types` for East types.
+ * Use `ToggleTip.Root(content, { trigger, ... })` to create a toggle tip, or access `ToggleTip.Types` for East types.
  */
 export const ToggleTip = {
     /**
      * Creates a ToggleTip component with a trigger and content.
      *
-     * @param trigger - The UI component that toggles the tip
      * @param content - The text content of the tip
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional visual style fields
      * @returns An East expression representing the toggle tip component
      *
      * @remarks
@@ -98,10 +70,9 @@ export const ToggleTip = {
      * import { ToggleTip, IconButton, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return ToggleTip.Root(
-     *         IconButton.Root("fas", "circle-info"),
-     *         "Click for more information about this feature"
-     *     );
+     *     return ToggleTip.Root("Click for more information about this feature", {
+     *         trigger: IconButton.Root({ prefix: "fas", name: "circle-info", label: "Info" }),
+     *     });
      * });
      * ```
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/toggle-tip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EAAE,UAAU,EACtB,UAAU,EACV,OAAO,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAElB,aAAa,EAChB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,kBAAkB,EAElB,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAIrB,UAAU,CAAC;IACZ,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC;CACxC,CAAC,CAAC;AAOH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAS,eAAe,CACpB,OAA4C,EAC5C,OAAuC,EACvC,KAAsB;IAEtB,MAAM,cAAc,GAAG,KAAK,EAAE,SAAS;QACnC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC;YAC3D,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QACtB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,QAAQ,GAAG,cAAc,IAAI,KAAK,EAAE,QAAQ,KAAK,SAAS,IAAI,KAAK,EAAE,YAAY,KAAK,SAAS,CAAC;IAEtG,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,QAAQ;YACX,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC;gBACzB,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBACnF,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBACjG,YAAY,EAAE,KAAK,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;aAChH,EAAE,kBAAkB,CAAC,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;KAC9B,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE;QACH;;;;;;;;;;;WAWG;QACH,SAAS,EAAE,aAAa;QACxB;;;;;;;;;WASG;QACH,KAAK,EAAE,kBAAkB;QACzB;;;;;;;;;;;;;;;;;;;WAmBG;QACH,SAAS,EAAE,aAAa;KAC3B;CACK,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/toggle-tip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EACJ,UAAU,EAAE,UAAU,EACtB,UAAU,EACV,OAAO,EACP,IAAI,EACJ,IAAI,GACP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,kBAAkB,EAElB,aAAa,EAChB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,kBAAkB,EAElB,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAIrB,UAAU,CAAC;IACZ,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC;CACxC,CAAC,CAAC;AAuCH,SAAS,eAAe,CACpB,OAAuC,EACvC,OAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAEvC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS;QACnC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC;YAC5D,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,QAAQ,GAAG,cAAc,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC;IAEtG,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,QAAQ;YACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;gBACd,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvD,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtE,YAAY,EAAE,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;aACrF,EAAE,kBAAkB,CAAC,CAAC;YACvB,CAAC,CAAC,IAAI;KACb,CAAC,EAAE,eAAe,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE;QACH;;;;;;;;;;;WAWG;QACH,SAAS,EAAE,aAAa;QACxB;;;;;;;;;WASG;QACH,KAAK,EAAE,kBAAkB;QACzB;;;;;;;;;;;;;;;;;;;WAmBG;QACH,SAAS,EAAE,aAAa;KAC3B;CACK,CAAC"}

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

@@ -27,12 +27,22 @@ export declare const TooltipType: StructType<{
  * Type alias for TooltipType.
  */
 export type TooltipType = typeof TooltipType;
+/**
+ * TypeScript options bag for `Tooltip.Root`.
+ *
+ * @property trigger - The UI component that triggers the tooltip on hover
+ * @property placement - Where the tooltip appears relative to the trigger
+ * @property hasArrow - Show an arrow pointing to the trigger
+ */
+export interface TooltipOptions extends TooltipStyle {
+    /** The UI component that triggers the tooltip on hover — required. */
+    trigger: SubtypeExprOrValue<UIComponentType>;
+}
 /**
  * Creates a Tooltip component with a trigger element and content.
  *
- * @param trigger - The UI component that triggers the tooltip on hover
  * @param content - The tooltip text content
- * @param style - Optional styling configuration
+ * @param options - Required `trigger` + optional visual style fields
  * @returns An East expression representing the tooltip component
  *
  * @remarks
@@ -45,27 +55,23 @@ export type TooltipType = typeof TooltipType;
  * import { Tooltip, Button, UIComponentType } from "@elaraai/east-ui";
  *
  * const example = East.function([], UIComponentType, $ => {
- *     return Tooltip.Root(
- *         Button.Root("Hover me"),
- *         "This is a helpful tip"
- *     );
+ *     return Tooltip.Root("This is a helpful tip", { trigger: Button.Root("Hover me") });
  * });
  * ```
  */
-declare function createTooltip(trigger: SubtypeExprOrValue<UIComponentType>, content: SubtypeExprOrValue<StringType>, style?: TooltipStyle): ExprType<UIComponentType>;
+declare function createTooltip(content: SubtypeExprOrValue<StringType>, options: TooltipOptions): ExprType<UIComponentType>;
 /**
  * Tooltip component for displaying additional information on hover.
  *
  * @remarks
- * Use `Tooltip.Root(trigger, content, style)` to create a tooltip, or access `Tooltip.Types` for East types.
+ * Use `Tooltip.Root(content, { trigger, ... })` to create a tooltip, or access `Tooltip.Types` for East types.
  */
 export declare const Tooltip: {
     /**
      * Creates a Tooltip component with a trigger and content text.
      *
-     * @param trigger - The UI component that triggers the tooltip on hover
      * @param content - The tooltip text content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional visual style fields
      * @returns An East expression representing the tooltip component
      *
      * @remarks
@@ -78,11 +84,10 @@ export declare const Tooltip: {
      * import { Tooltip, Button, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return Tooltip.Root(
-     *         Button.Root("Hover me"),
-     *         "This is a helpful tooltip",
-     *         { placement: "top" }
-     *     );
+     *     return Tooltip.Root("This is a helpful tooltip", {
+     *         trigger: Button.Root("Hover me"),
+     *         placement: "top",
+     *     });
      * });
      * ```
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/tooltip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,UAAU,EACV,UAAU,EAEb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,SAAS,EACT,gBAAgB,EAChB,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;CACvC,CAIC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAM7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,aAAa,CAClB,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACvC,KAAK,CAAC,EAAE,YAAY,GACrB,QAAQ,CAAC,eAAe,CAAC,CAwB3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;;IAEH;;;;;;;;;OASG;;;QAGC;;;;;;;;;;;WAWG;;qBAlIE,eAAe;qBACf,UAAU;mBACZ,UAAU,CAAC,gBAAgB,CAAC;;QAkI/B;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/tooltip/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAEvB,UAAU,EACV,UAAU,EACV,UAAU,EAIb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,SAAS,EACT,gBAAgB,EAChB,KAAK,YAAY,EACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;CACvC,CAIC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAM7C;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAChD,sEAAsE;IACtE,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,aAAa,CAClB,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,EACvC,OAAO,EAAE,cAAc,GACxB,QAAQ,CAAC,eAAe,CAAC,CAuB3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO;IAChB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;IAEH;;;;;;;;;OASG;;;QAGC;;;;;;;;;;;WAWG;;qBAtIE,eAAe;qBACf,UAAU;mBACZ,UAAU,CAAC,gBAAgB,CAAC;;QAsI/B;;;;;;;;;WASG;;;;;;;;;;;;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}