@almadar/ui 5.122.14 → 5.124.0

package/dist/components/index.d.cts

@@ -1104,7 +1104,8 @@ declare const TextHighlight: React__default.FC<TextHighlightProps>;
  */
 
 type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "heading" | "subheading" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
-type TypographySize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
+/** `none` = no size override — the variant's baked size applies. */
+type TypographySize = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
 interface TypographyProps {
     /** Typography variant */
     variant?: TypographyVariant;
@@ -1114,8 +1115,8 @@ interface TypographyProps {
     color?: "primary" | "secondary" | "muted" | "error" | "success" | "warning" | "inherit";
     /** Text alignment */
     align?: "left" | "center" | "right";
-    /** Font weight override */
-    weight?: "light" | "normal" | "medium" | "semibold" | "bold";
+    /** Font weight override — `none` = no override, the variant's baked weight applies */
+    weight?: "none" | "light" | "normal" | "medium" | "semibold" | "bold";
     /** Font size override */
     size?: TypographySize;
     /** Truncate with ellipsis (single line) */
@@ -4005,6 +4006,10 @@ interface FilterGroupProps {
     isLoading?: boolean;
     /** Layer 2 visual treatment — orthogonal to the semantic variant. */
     look?: FilterGroupLook;
+    /** Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER) */
+    event?: EventKey;
+    /** Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS) */
+    clearEvent?: EventKey;
 }
 /**
  * FilterGroup - Renders filter controls for entity data
@@ -4683,11 +4688,8 @@ interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLI
      * Additional CSS classes
      */
     className?: string;
-    /**
-     * Event name to dispatch on search (schema metadata, wired by trait)
-     * This is metadata used by the trait generator, not by the component.
-     */
-    event?: string;
+    /** Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH) */
+    event?: EventKey;
     /**
      * Entity type for context-aware search.
      * When provided, search events include entity context.
@@ -6321,8 +6323,12 @@ interface DataGridField {
 interface DataGridItemAction {
     /** Button label */
     label: string;
-    /** Event name to emit (dispatched as UI:{event} with { row: itemData }) */
-    event: EventKey;
+    /** Event name to emit (dispatched as UI:{event} with { row: itemData }).
+     *  Optional when `navigatesTo` is set — a navigating action never emits. */
+    event?: EventKey;
+    /** Route to navigate to instead of emitting — `{{row.field}}`
+     *  placeholders interpolate from the item row (CardGrid's contract). */
+    navigatesTo?: string;
     /** Lucide icon name or component */
     icon?: IconInput;
     /** Button variant */
@@ -6379,8 +6385,8 @@ interface DataGridProps extends DataDndProps {
     loadMoreEvent?: EventKey;
     /** Whether more items are available for infinite scroll */
     hasMore?: boolean;
-    /** Render prop for custom per-card content. When provided, `fields` and
-     *  `itemActions` are ignored. */
+    /** Render prop for custom per-card content. When provided, `fields` are
+     *  ignored; `itemActions` render as a footer beneath the custom content. */
     children?: (item: EntityRow, index: number) => React__default.ReactNode;
     /**
      * Per-item render function (schema-level alias for children render prop).

package/dist/components/index.d.ts

@@ -1104,7 +1104,8 @@ declare const TextHighlight: React__default.FC<TextHighlightProps>;
  */
 
 type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "heading" | "subheading" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
-type TypographySize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
+/** `none` = no size override — the variant's baked size applies. */
+type TypographySize = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
 interface TypographyProps {
     /** Typography variant */
     variant?: TypographyVariant;
@@ -1114,8 +1115,8 @@ interface TypographyProps {
     color?: "primary" | "secondary" | "muted" | "error" | "success" | "warning" | "inherit";
     /** Text alignment */
     align?: "left" | "center" | "right";
-    /** Font weight override */
-    weight?: "light" | "normal" | "medium" | "semibold" | "bold";
+    /** Font weight override — `none` = no override, the variant's baked weight applies */
+    weight?: "none" | "light" | "normal" | "medium" | "semibold" | "bold";
     /** Font size override */
     size?: TypographySize;
     /** Truncate with ellipsis (single line) */
@@ -4005,6 +4006,10 @@ interface FilterGroupProps {
     isLoading?: boolean;
     /** Layer 2 visual treatment — orthogonal to the semantic variant. */
     look?: FilterGroupLook;
+    /** Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER) */
+    event?: EventKey;
+    /** Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS) */
+    clearEvent?: EventKey;
 }
 /**
  * FilterGroup - Renders filter controls for entity data
@@ -4683,11 +4688,8 @@ interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLI
      * Additional CSS classes
      */
     className?: string;
-    /**
-     * Event name to dispatch on search (schema metadata, wired by trait)
-     * This is metadata used by the trait generator, not by the component.
-     */
-    event?: string;
+    /** Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH) */
+    event?: EventKey;
     /**
      * Entity type for context-aware search.
      * When provided, search events include entity context.
@@ -6321,8 +6323,12 @@ interface DataGridField {
 interface DataGridItemAction {
     /** Button label */
     label: string;
-    /** Event name to emit (dispatched as UI:{event} with { row: itemData }) */
-    event: EventKey;
+    /** Event name to emit (dispatched as UI:{event} with { row: itemData }).
+     *  Optional when `navigatesTo` is set — a navigating action never emits. */
+    event?: EventKey;
+    /** Route to navigate to instead of emitting — `{{row.field}}`
+     *  placeholders interpolate from the item row (CardGrid's contract). */
+    navigatesTo?: string;
     /** Lucide icon name or component */
     icon?: IconInput;
     /** Button variant */
@@ -6379,8 +6385,8 @@ interface DataGridProps extends DataDndProps {
     loadMoreEvent?: EventKey;
     /** Whether more items are available for infinite scroll */
     hasMore?: boolean;
-    /** Render prop for custom per-card content. When provided, `fields` and
-     *  `itemActions` are ignored. */
+    /** Render prop for custom per-card content. When provided, `fields` are
+     *  ignored; `itemActions` render as a footer beneath the custom content. */
     children?: (item: EntityRow, index: number) => React__default.ReactNode;
     /**
      * Per-item render function (schema-level alias for children render prop).