@elaraai/east-ui 1.0.4 → 1.0.6

package/dist/src/overlays/drawer/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, NullType } from "@elaraai/east";
+import { East, StringType, OptionType, StructType, ArrayType, variant, some, none, NullType } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { DrawerSizeType, DrawerPlacementType, DrawerStyleType } from "./types.js";
 // Re-export types
@@ -19,6 +19,7 @@ export { DrawerSizeType, DrawerPlacementType, DrawerStyleType, } from "./types.j
  *
  * @property trigger - The UI component that opens the drawer
  * @property body - Array of UI components for drawer content
+ * @property eyebrow - Optional mono uppercase eyebrow above the title
  * @property title - Optional drawer title
  * @property description - Optional drawer description
  * @property style - Optional style configuration
@@ -26,6 +27,7 @@ export { DrawerSizeType, DrawerPlacementType, DrawerStyleType, } from "./types.j
 export const DrawerType = StructType({
     trigger: UIComponentType,
     body: ArrayType(UIComponentType),
+    eyebrow: OptionType(StringType),
     title: OptionType(StringType),
     description: OptionType(StringType),
     style: OptionType(DrawerStyleType),
@@ -42,72 +44,47 @@ export const DrawerType = StructType({
  * a trigger property.
  *
  * @property body - Array of UI components for drawer content
+ * @property eyebrow - Optional mono uppercase eyebrow above the title
  * @property title - Optional drawer title
  * @property description - Optional drawer description
  * @property style - Optional style configuration
  */
 export const DrawerOpenInputType = StructType({
     body: ArrayType(UIComponentType),
+    eyebrow: OptionType(StringType),
     title: OptionType(StringType),
     description: OptionType(StringType),
     style: OptionType(DrawerStyleType),
 });
-// ============================================================================
-// Drawer Function
-// ============================================================================
-/**
- * Creates a Drawer component with a trigger and body content.
- *
- * @param trigger - The UI component that opens the drawer
- * @param body - Array of UI components for drawer content
- * @param style - Optional styling configuration
- * @returns An East expression representing the drawer component
- *
- * @remarks
- * Drawer is a panel that slides in from the edge of the viewport.
- * It's typically used for navigation, settings, or detailed content.
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { Drawer, Button, Text, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, $ => {
- *     return Drawer.Root(
- *         Button.Root("Open Menu"),
- *         [Text.Root("Menu content")],
- *         { title: "Navigation", placement: "start" }
- *     );
- * });
- * ```
- */
-function createDrawer(trigger, body, style) {
-    const sizeValue = style?.size
+function createDrawer(body, options) {
+    const { trigger, ...style } = options;
+    const sizeValue = style.size
         ? (typeof style.size === "string"
             ? East.value(variant(style.size, null), DrawerSizeType)
             : style.size)
         : undefined;
-    const placementValue = style?.placement
+    const placementValue = style.placement
         ? (typeof style.placement === "string"
             ? East.value(variant(style.placement, null), DrawerPlacementType)
             : style.placement)
         : undefined;
-    const hasStyle = sizeValue || placementValue || style?.contained !== undefined ||
-        style?.onOpenChange !== undefined || style?.onExitComplete !== undefined;
+    const hasStyle = sizeValue || placementValue || style.contained !== undefined ||
+        style.onOpenChange !== undefined || style.onExitComplete !== undefined;
     return East.value(variant("Drawer", {
         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),
+        eyebrow: style.eyebrow !== undefined ? some(style.eyebrow) : none,
+        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),
-                contained: style?.contained !== undefined ? variant("some", style.contained) : variant("none", null),
-                onOpenChange: style?.onOpenChange !== undefined ? variant("some", style.onOpenChange) : variant("none", null),
-                onExitComplete: style?.onExitComplete !== undefined ? variant("some", style.onExitComplete) : variant("none", null),
+            ? some(East.value({
+                size: sizeValue ? some(sizeValue) : none,
+                placement: placementValue ? some(placementValue) : none,
+                contained: style.contained !== undefined ? some(style.contained) : none,
+                onOpenChange: style.onOpenChange !== undefined ? some(style.onOpenChange) : none,
+                onExitComplete: style.onExitComplete !== undefined ? some(style.onExitComplete) : none,
             }, DrawerStyleType))
-            : variant("none", null),
+            : none,
     }), UIComponentType);
 }
 // ============================================================================
@@ -146,15 +123,14 @@ export const drawer_open = East.platform("drawer_open", [DrawerOpenInputType], N
  * Drawer component for slide-in panels.
  *
  * @remarks
- * Use `Drawer.Root(trigger, body, style)` to create a drawer, or access `Drawer.Types` for East types.
+ * Use `Drawer.Root(body, { trigger, ... })` to create a drawer, or access `Drawer.Types` for East types.
  */
 export const Drawer = {
     /**
      * Creates a Drawer component with a trigger and body content.
      *
-     * @param trigger - The UI component that opens the drawer
      * @param body - Array of UI components for drawer content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional `title` / `description` / visual style fields
      * @returns An East expression representing the drawer component
      *
      * @remarks
@@ -167,11 +143,11 @@ export const Drawer = {
      * import { Drawer, Button, Text, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return Drawer.Root(
-     *         Button.Root("Open Drawer"),
-     *         [Text.Root("Drawer content")],
-     *         { title: "Settings", placement: "end" }
-     *     );
+     *     return Drawer.Root([Text.Root("Drawer content")], {
+     *         trigger: Button.Root("Open Drawer"),
+     *         title: "Settings",
+     *         placement: "end",
+     *     });
      * });
      * ```
      */

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

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

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

@@ -76,6 +76,7 @@ export type DrawerStyleType = typeof DrawerStyleType;
  * @property size - Drawer size variant
  * @property placement - Edge placement
  * @property contained - Render within parent container
+ * @property eyebrow - Mono uppercase eyebrow above the title
  * @property title - Drawer title
  * @property description - Drawer description
  * @property open - Controlled open state
@@ -94,6 +95,8 @@ export interface DrawerStyle {
     placement?: SubtypeExprOrValue<DrawerPlacementType> | DrawerPlacementLiteral;
     /** Render within parent container */
     contained?: SubtypeExprOrValue<BooleanType>;
+    /** Mono uppercase eyebrow above the title (e.g. the surface or section name) */
+    eyebrow?: SubtypeExprOrValue<StringType>;
     /** Drawer title */
     title?: SubtypeExprOrValue<StringType>;
     /** Drawer description */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACf,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAM1E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMxE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;IAIxB,iDAAiD;;IAEjD,uDAAuD;;EAEzD,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAMrD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAAC;IAC9D,qBAAqB;IACrB,SAAS,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAAC;IAC7E,qCAAqC;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,mBAAmB;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,kCAAkC;IAClC,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,uDAAuD;IACvD,cAAc,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;CACnE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/overlays/drawer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,kBAAkB,EACvB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,YAAY,EACf,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAM1E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAMxE;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;IAIxB,iDAAiD;;IAEjD,uDAAuD;;EAEzD,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAMrD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAAC;IAC9D,qBAAqB;IACrB,SAAS,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAAC;IAC7E,qCAAqC;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,gFAAgF;IAChF,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACzC,mBAAmB;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC9C,kCAAkC;IAClC,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzD,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,0BAA0B;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,iDAAiD;IACjD,YAAY,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,uDAAuD;IACvD,cAAc,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;CACnE"}

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

@@ -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 { type ExprType, type SubtypeExprOrValue, OptionType, StructType, ArrayType } from "@elaraai/east";
+import { type ExprType, type SubtypeExprOrValue, OptionType, StringType, StructType, ArrayType } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { HoverCardStyleType, type HoverCardStyle } from "./types.js";
 export { HoverCardSizeType, HoverCardStyleType, type HoverCardStyle, PlacementType, } from "./types.js";
@@ -11,16 +11,20 @@ export type { HoverCardSizeLiteral, PlacementLiteral } from "./types.js";
  * East StructType for HoverCard component.
  *
  * @remarks
- * HoverCard displays rich content when hovering over a trigger element.
- * Similar to Tooltip but with more structured content (e.g., user profiles).
+ * HoverCard displays rich content when hovering over a trigger element —
+ * the same visual as Popover, opened on hover/focus instead of click.
  *
  * @property trigger - The UI component that shows the hover card on hover
  * @property body - Array of UI components for hover card content
+ * @property title - Optional hover card title (mono uppercase eyebrow)
+ * @property description - Optional hover card description
  * @property style - Optional style configuration
  */
 export declare const HoverCardType: StructType<{
     trigger: UIComponentType;
     body: ArrayType<UIComponentType>;
+    title: OptionType<StringType>;
+    description: OptionType<StringType>;
     style: OptionType<HoverCardStyleType>;
 }>;
 /**
@@ -30,9 +34,8 @@ export type HoverCardType = typeof HoverCardType;
 /**
  * Creates a HoverCard component with a trigger and body content.
  *
- * @param trigger - The UI component that shows the hover card on hover
  * @param body - Array of UI components for hover card content
- * @param style - Optional styling configuration
+ * @param options - Required `trigger` + optional visual style fields
  * @returns An East expression representing the hover card component
  *
  * @remarks
@@ -45,31 +48,34 @@ export type HoverCardType = typeof HoverCardType;
  * import { HoverCard, Text, Avatar, UIComponentType } from "@elaraai/east-ui";
  *
  * const example = East.function([], UIComponentType, $ => {
- *     return HoverCard.Root(
- *         Text.Root("@username"),
- *         [
- *             Avatar.Root({ name: "John Doe" }),
- *             Text.Root("Software Engineer"),
- *         ],
- *         { openDelay: 200n }
- *     );
+ *     return HoverCard.Root([
+ *         Avatar.Root({ name: "John Doe" }),
+ *         Text.Root("Software Engineer"),
+ *     ], { trigger: Text.Root("@username"), openDelay: 200n });
  * });
  * ```
  */
-declare function createHoverCard(trigger: SubtypeExprOrValue<UIComponentType>, body: SubtypeExprOrValue<ArrayType<UIComponentType>>, style?: HoverCardStyle): ExprType<UIComponentType>;
+export interface HoverCardOptions extends HoverCardStyle {
+    /** The UI component that shows the hover card on hover — required. */
+    trigger: SubtypeExprOrValue<UIComponentType>;
+    /** Optional title — rendered as the mono uppercase eyebrow, same as Popover. */
+    title?: SubtypeExprOrValue<StringType>;
+    /** Optional description shown under the title. */
+    description?: SubtypeExprOrValue<StringType>;
+}
+declare function createHoverCard(body: SubtypeExprOrValue<ArrayType<UIComponentType>>, options: HoverCardOptions): ExprType<UIComponentType>;
 /**
  * HoverCard component for rich hover previews.
  *
  * @remarks
- * Use `HoverCard.Root(trigger, body, style)` to create a hover card, or access `HoverCard.Types` for East types.
+ * Use `HoverCard.Root(body, { trigger, ... })` to create a hover card, or access `HoverCard.Types` for East types.
  */
 export declare const HoverCard: {
     /**
      * Creates a HoverCard component with a trigger and body content.
      *
-     * @param trigger - The UI component that shows the hover card on hover
      * @param body - Array of UI components for hover card content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional visual style fields
      * @returns An East expression representing the hover card component
      *
      * @remarks
@@ -82,14 +88,10 @@ export declare const HoverCard: {
      * import { HoverCard, Text, Avatar, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return HoverCard.Root(
-     *         Text.Root("@username"),
-     *         [
-     *             Avatar.Root({ name: "John Doe" }),
-     *             Text.Root("Software Engineer"),
-     *         ],
-     *         { openDelay: 200n }
-     *     );
+     *     return HoverCard.Root([
+     *         Avatar.Root({ name: "John Doe" }),
+     *         Text.Root("Software Engineer"),
+     *     ], { trigger: Text.Root("@username"), openDelay: 200n });
      * });
      * ```
      */
@@ -99,16 +101,20 @@ export declare const HoverCard: {
          * East StructType for HoverCard component.
          *
          * @remarks
-         * HoverCard displays rich content when hovering over a trigger element.
-         * Similar to Tooltip but with more structured content (e.g., user profiles).
+         * HoverCard displays rich content when hovering over a trigger element —
+         * the same visual as Popover, opened on hover/focus instead of click.
          *
          * @property trigger - The UI component that shows the hover card on hover
          * @property body - Array of UI components for hover card content
+         * @property title - Optional hover card title (mono uppercase eyebrow)
+         * @property description - Optional hover card description
          * @property style - Optional style configuration
          */
         readonly HoverCard: StructType<{
             trigger: UIComponentType;
             body: ArrayType<UIComponentType>;
+            title: OptionType<StringType>;
+            description: OptionType<StringType>;
             style: OptionType<HoverCardStyleType>;
         }>;
         /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/hover-card/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACjB,UAAU,EAChB,UAAU,EACV,SAAS,EAEZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,kBAAkB,EAClB,KAAK,cAAc,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,cAAc,EACnB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC;IACnC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACjC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;CACzC,CAIC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAS,eAAe,CACpB,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,EAC5C,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACpD,KAAK,CAAC,EAAE,cAAc,GACvB,QAAQ,CAAC,eAAe,CAAC,CA8B3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IAClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;;;QAGC;;;;;;;;;;WAUG;;qBAnIE,eAAe;kBAClB,SAAS,CAAC,eAAe,CAAC;mBACzB,UAAU,CAAC,kBAAkB,CAAC;;QAmIjC;;;;;;;;WAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;WAOG;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overlays/hover-card/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACjB,UAAU,EAChB,UAAU,EACV,UAAU,EACV,SAAS,EAIZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEH,kBAAkB,EAClB,KAAK,cAAc,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,cAAc,EACnB,aAAa,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC;IACnC,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,kBAAkB,CAAC,CAAC;CACzC,CAMC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,sEAAsE;IACtE,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC7C,gFAAgF;IAChF,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,kDAAkD;IAClD,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAChD;AAED,iBAAS,eAAe,CACpB,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,EACpD,OAAO,EAAE,gBAAgB,GAC1B,QAAQ,CAAC,eAAe,CAAC,CAkC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IAClB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;;QAGC;;;;;;;;;;;;WAYG;;qBA3IE,eAAe;kBAClB,SAAS,CAAC,eAAe,CAAC;mBACzB,UAAU,CAAC,UAAU,CAAC;yBAChB,UAAU,CAAC,UAAU,CAAC;mBAC5B,UAAU,CAAC,kBAAkB,CAAC;;QAyIjC;;;;;;;;WAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEH;;;;;;;WAOG;;;;;;;QAEH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;;;;;;CAGD,CAAC"}

package/dist/src/overlays/hover-card/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, OptionType, StructType, ArrayType, variant } from "@elaraai/east";
+import { East, OptionType, StringType, StructType, ArrayType, variant, some, none, } from "@elaraai/east";
 import { UIComponentType } from "../../component.js";
 import { HoverCardSizeType, HoverCardStyleType, PlacementType } from "./types.js";
 // Re-export types
@@ -14,91 +14,65 @@ export { HoverCardSizeType, HoverCardStyleType, PlacementType, } from "./types.j
  * East StructType for HoverCard component.
  *
  * @remarks
- * HoverCard displays rich content when hovering over a trigger element.
- * Similar to Tooltip but with more structured content (e.g., user profiles).
+ * HoverCard displays rich content when hovering over a trigger element —
+ * the same visual as Popover, opened on hover/focus instead of click.
  *
  * @property trigger - The UI component that shows the hover card on hover
  * @property body - Array of UI components for hover card content
+ * @property title - Optional hover card title (mono uppercase eyebrow)
+ * @property description - Optional hover card description
  * @property style - Optional style configuration
  */
 export const HoverCardType = StructType({
     trigger: UIComponentType,
     body: ArrayType(UIComponentType),
+    title: OptionType(StringType),
+    description: OptionType(StringType),
     style: OptionType(HoverCardStyleType),
 });
-// ============================================================================
-// HoverCard Function
-// ============================================================================
-/**
- * Creates a HoverCard component with a trigger and body content.
- *
- * @param trigger - The UI component that shows the hover card on hover
- * @param body - Array of UI components for hover card content
- * @param style - Optional styling configuration
- * @returns An East expression representing the hover card component
- *
- * @remarks
- * HoverCard displays rich preview content when hovering over an element.
- * Ideal for user profile previews, link previews, or contextual information.
- *
- * @example
- * ```ts
- * import { East } from "@elaraai/east";
- * import { HoverCard, Text, Avatar, UIComponentType } from "@elaraai/east-ui";
- *
- * const example = East.function([], UIComponentType, $ => {
- *     return HoverCard.Root(
- *         Text.Root("@username"),
- *         [
- *             Avatar.Root({ name: "John Doe" }),
- *             Text.Root("Software Engineer"),
- *         ],
- *         { openDelay: 200n }
- *     );
- * });
- * ```
- */
-function createHoverCard(trigger, body, style) {
-    const sizeValue = style?.size
+function createHoverCard(body, options) {
+    const { trigger, title, description, ...style } = options;
+    const sizeValue = style.size
         ? (typeof style.size === "string"
             ? East.value(variant(style.size, null), HoverCardSizeType)
             : 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?.openDelay !== undefined || style?.closeDelay !== undefined || style?.onOpenChange !== undefined;
+    const hasStyle = sizeValue || placementValue || style.hasArrow !== undefined ||
+        style.openDelay !== undefined || style.closeDelay !== undefined || style.onOpenChange !== undefined;
     return East.value(variant("HoverCard", {
         trigger: trigger,
         body: body,
+        title: title !== undefined ? some(title) : none,
+        description: description !== undefined ? some(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),
-                openDelay: style?.openDelay !== undefined ? variant("some", style.openDelay) : variant("none", null),
-                closeDelay: style?.closeDelay !== undefined ? variant("some", style.closeDelay) : 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,
+                openDelay: style.openDelay !== undefined ? some(style.openDelay) : none,
+                closeDelay: style.closeDelay !== undefined ? some(style.closeDelay) : none,
+                onOpenChange: style.onOpenChange !== undefined ? some(style.onOpenChange) : none,
             }, HoverCardStyleType))
-            : variant("none", null),
+            : none,
     }), UIComponentType);
 }
 /**
  * HoverCard component for rich hover previews.
  *
  * @remarks
- * Use `HoverCard.Root(trigger, body, style)` to create a hover card, or access `HoverCard.Types` for East types.
+ * Use `HoverCard.Root(body, { trigger, ... })` to create a hover card, or access `HoverCard.Types` for East types.
  */
 export const HoverCard = {
     /**
      * Creates a HoverCard component with a trigger and body content.
      *
-     * @param trigger - The UI component that shows the hover card on hover
      * @param body - Array of UI components for hover card content
-     * @param style - Optional styling configuration
+     * @param options - Required `trigger` + optional visual style fields
      * @returns An East expression representing the hover card component
      *
      * @remarks
@@ -111,14 +85,10 @@ export const HoverCard = {
      * import { HoverCard, Text, Avatar, UIComponentType } from "@elaraai/east-ui";
      *
      * const example = East.function([], UIComponentType, $ => {
-     *     return HoverCard.Root(
-     *         Text.Root("@username"),
-     *         [
-     *             Avatar.Root({ name: "John Doe" }),
-     *             Text.Root("Software Engineer"),
-     *         ],
-     *         { openDelay: 200n }
-     *     );
+     *     return HoverCard.Root([
+     *         Avatar.Root({ name: "John Doe" }),
+     *         Text.Root("Software Engineer"),
+     *     ], { trigger: Text.Root("@username"), openDelay: 200n });
      * });
      * ```
      */
@@ -128,11 +98,13 @@ export const HoverCard = {
          * East StructType for HoverCard component.
          *
          * @remarks
-         * HoverCard displays rich content when hovering over a trigger element.
-         * Similar to Tooltip but with more structured content (e.g., user profiles).
+         * HoverCard displays rich content when hovering over a trigger element —
+         * the same visual as Popover, opened on hover/focus instead of click.
          *
          * @property trigger - The UI component that shows the hover card on hover
          * @property body - Array of UI components for hover card content
+         * @property title - Optional hover card title (mono uppercase eyebrow)
+         * @property description - Optional hover card description
          * @property style - Optional style configuration
          */
         HoverCard: HoverCardType,

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/hover-card/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/overlays/hover-card/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGH,IAAI,EAAE,UAAU,EAChB,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,EACP,IAAI,EACJ,IAAI,GACP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EACG,aAAa,EACrC,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAElB,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAMrB,UAAU,CAAC;IACZ,OAAO,EAAE,eAAe;IACxB,IAAI,EAAE,SAAS,CAAC,eAAe,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;IAC7B,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;IACnC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC;CACxC,CAAC,CAAC;AA4CH,SAAS,eAAe,CACpB,IAAoD,EACpD,OAAyB;IAEzB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;QACxB,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,iBAAiB,CAAC;YAC1D,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS;QAClC,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,SAAS,IAAI,cAAc,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QACxE,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC;IAExG,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/C,WAAW,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;QACjE,KAAK,EAAE,QAAQ;YACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;gBACd,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;gBACxC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvD,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;gBACpE,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvE,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC1E,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;aACnF,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;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE;QACH;;;;;;;;;;;;WAYG;QACH,SAAS,EAAE,aAAa;QACxB;;;;;;;;WAQG;QACH,KAAK,EAAE,kBAAkB;QACzB;;;;;;;WAOG;QACH,IAAI,EAAE,iBAAiB;QACvB;;;;;;;;;;;;;;;;;;;WAmBG;QACH,SAAS,EAAE,aAAa;KAC3B;CACK,CAAC"}