@almadar/ui 6.51.2 → 6.52.0

package/dist/ssr/index.js

@@ -1,5 +1,5 @@
-import * as React15 from 'react';
-import React15__default, { createContext, useCallback, useState, useRef, useEffect, useContext, useMemo, useSyncExternalStore, useLayoutEffect, useId } from 'react';
+import * as React16 from 'react';
+import React16__default, { createContext, useCallback, useState, useRef, useEffect, useContext, useMemo, useSyncExternalStore, useLayoutEffect, useId } from 'react';
 import { createLogger } from '@almadar/logger';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as LucideIcons2 from 'lucide-react';
@@ -2862,7 +2862,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React15__default.forwardRef(
+var Box = React16__default.forwardRef(
   ({
     padding,
     paddingX,
@@ -2931,7 +2931,7 @@ var Box = React15__default.forwardRef(
     }, [hoverEvent, tapReveal, triggerProps, onPointerDown]);
     const isClickable = action || onClick;
     const actionControl = action && rest.role === void 0 && rest.tabIndex === void 0 ? pressableProps(handleClick) : {};
-    return React15__default.createElement(
+    return React16__default.createElement(
       Component,
       {
         ref,
@@ -2970,10 +2970,11 @@ var Box = React15__default.forwardRef(
 Box.displayName = "Box";
 
 // lib/domPassthrough.ts
+var GLOBAL_ATTRIBUTES = /* @__PURE__ */ new Set(["role", "id", "lang", "dir", "tabIndex"]);
 function domPassthrough(props) {
   const out = {};
   for (const [key, value] of Object.entries(props)) {
-    if (key.startsWith("aria-") || key.startsWith("data-") || key === "role" || key === "id") {
+    if (key.startsWith("aria-") || key.startsWith("data-") || GLOBAL_ATTRIBUTES.has(key)) {
       if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === void 0) {
         out[key] = value;
       }
@@ -3035,7 +3036,7 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  return React15__default.createElement(
+  return React16__default.createElement(
     Component,
     {
       ...domPassthrough(rest),
@@ -4214,7 +4215,37 @@ var en_default = {
   "flowCanvas.presetSize": "{{label}} ({{width}}px)",
   "avl.breadcrumb.transitionNumber": "Transition #{{n}}",
   "orbInspector.pattern": "Pattern",
-  "orbInspector.slotLabel": "slot: {{slot}}"
+  "orbInspector.slotLabel": "slot: {{slot}}",
+  "detailPanel.section.activity": "Activity",
+  "detailPanel.section.lineItems": "Line items",
+  "detailPanel.tab.overview": "Overview",
+  "detailPanel.thread.empty": "No messages yet",
+  "detailPanel.openImage": "Open image",
+  "detailPanel.showImage": "Show image {{index}}",
+  "aria.clearSelection": "Clear selection",
+  "aria.searchOptions": "Search options",
+  "aria.zoomIn": "Zoom in",
+  "aria.zoomOut": "Zoom out",
+  "aria.previousPage": "Previous page",
+  "aria.nextPage": "Next page",
+  "aria.downloadDocument": "Download document",
+  "aria.printDocument": "Print document",
+  "aria.wrapLines": "Wrap lines",
+  "aria.copyCode": "Copy code",
+  "aria.clearInput": "Clear input",
+  "aria.skipToContent": "Skip to content",
+  "aria.mainNavigation": "Main navigation",
+  "aria.carouselSlides": "Slides",
+  "aria.minimap": "Minimap",
+  "aria.canvasScene": "Game scene",
+  "aria.learningCanvas": "Interactive diagram",
+  "aria.scene3d": "3D scene",
+  "aria.graphCanvas": "Graph",
+  "aria.positionedCanvas": "Floor plan",
+  "aria.walkTraitDone": "completed",
+  "aria.walkTraitPending": "pending",
+  "aria.walkGraph": "State graph for {{trait}}: {{from}} to {{to}}",
+  "aria.loading": "Loading"
 };
 
 // lib/format.ts
@@ -4292,7 +4323,6 @@ var I18nContext = createContext({
   }
 });
 I18nContext.displayName = "I18nContext";
-I18nContext.Provider;
 function useTranslate() {
   return useContext(I18nContext);
 }
@@ -4404,7 +4434,7 @@ var Typography = ({
   if (format !== void 0 && format !== "none" && (typeof body === "string" || typeof body === "number" || body instanceof Date)) {
     body = formatValue(body, format, fmt);
   }
-  return React15__default.createElement(
+  return React16__default.createElement(
     Component,
     {
       ...domPassthrough(rest),
@@ -4436,6 +4466,50 @@ var Typography = ({
   );
 };
 Typography.displayName = "Typography";
+var counts = /* @__PURE__ */ new Map();
+var keyListeners = /* @__PURE__ */ new Map();
+var seq = 0;
+function newPendingKey() {
+  seq += 1;
+  return `pending-${seq}`;
+}
+function isPending(key) {
+  return (counts.get(key) ?? 0) > 0;
+}
+function subscribePending(key, cb) {
+  let set = keyListeners.get(key);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    keyListeners.set(key, set);
+  }
+  set.add(cb);
+  return () => {
+    set?.delete(cb);
+    if (set && set.size === 0) keyListeners.delete(key);
+  };
+}
+var PendingScopeContext = createContext(null);
+function usePendingAction() {
+  const scope = useContext(PendingScopeContext);
+  const [key, setKey] = useState(null);
+  const pending = useSyncExternalStore(
+    useCallback((cb) => key ? subscribePending(key, cb) : () => {
+    }, [key]),
+    () => key ? isPending(key) : false,
+    () => false
+  );
+  useEffect(() => {
+    if (key && !pending) setKey(null);
+  }, [key, pending]);
+  const activate = useCallback((emit) => {
+    const k = newPendingKey();
+    emit(k);
+    if (!isPending(k)) return;
+    scope?.track(k);
+    setKey(k);
+  }, [scope]);
+  return { pending, activate };
+}
 var DEFAULT_FAMILY = "lucide";
 var VALID_FAMILIES = [DEFAULT_FAMILY];
 function themeIconFamily() {
@@ -4566,7 +4640,7 @@ function resolveLucide(name) {
 }
 function makeLucideAdapter(name) {
   const LucideComp = resolveLucide(name);
-  const Adapter = React15__default.forwardRef((props, ref) => /* @__PURE__ */ jsx(
+  const Adapter = React16__default.forwardRef((props, ref) => /* @__PURE__ */ jsx(
     LucideComp,
     {
       ref,
@@ -4647,15 +4721,16 @@ var Icon = ({
   animation = "none",
   className,
   strokeWidth,
-  style
+  style,
+  ...rest
 }) => {
   const directIcon = typeof icon === "string" ? void 0 : icon;
   const effectiveName = typeof icon === "string" && icon !== "" ? icon : name;
   const effectiveStrokeWidth = strokeWidth != null && strokeWidth > 0 ? strokeWidth : void 0;
   const family = useIconFamily();
-  const svgRef = React15__default.useRef(null);
+  const svgRef = React16__default.useRef(null);
   const themeStroke = useThemeIconStrokeApplies(svgRef);
-  const RenderedComponent = React15__default.useMemo(() => {
+  const RenderedComponent = React16__default.useMemo(() => {
     if (directIcon) return null;
     return effectiveName ? resolveIconForFamily(effectiveName) : null;
   }, [directIcon, effectiveName, family]);
@@ -4678,7 +4753,8 @@ var Icon = ({
         ref: svgRef,
         className: composedClassName,
         strokeWidth: effectiveStrokeWidth,
-        style: inlineStyle
+        style: inlineStyle,
+        ...domPassthrough(rest)
       }
     );
   }
@@ -4689,7 +4765,8 @@ var Icon = ({
         ref: svgRef,
         className: composedClassName,
         strokeWidth: effectiveStrokeWidth,
-        style: inlineStyle
+        style: inlineStyle,
+        ...domPassthrough(rest)
       }
     );
   }
@@ -4700,7 +4777,8 @@ var Icon = ({
       ref: svgRef,
       className: composedClassName,
       strokeWidth: effectiveStrokeWidth,
-      style: inlineStyle
+      style: inlineStyle,
+      ...domPassthrough(rest)
     }
   );
 };
@@ -4791,15 +4869,16 @@ function AtlasImage({
   alt,
   className,
   style,
-  "aria-hidden": ariaHidden
+  "aria-hidden": ariaHidden,
+  ...rest
 }) {
-  const [, bump] = React15.useReducer((x) => x + 1, 0);
-  const canvasRef = React15.useRef(null);
+  const [, bump] = React16.useReducer((x) => x + 1, 0);
+  const canvasRef = React16.useRef(null);
   const sliced = isAtlasAsset(asset);
   const atlas = sliced ? getAtlas(asset.atlas, bump) : void 0;
   const img = sliced && asset?.url ? getSheetImage(asset.url, bump) : null;
   const rect = sliced && atlas ? subRectFor(atlas, asset.sprite) : null;
-  React15.useEffect(() => {
+  React16.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas || !img || !rect) return;
     canvas.width = rect.sw;
@@ -4832,6 +4911,7 @@ function AtlasImage({
         role: ariaHidden ? void 0 : "img",
         "aria-hidden": ariaHidden,
         "aria-label": ariaHidden ? void 0 : alt ?? asset.name ?? asset.category ?? "",
+        ...domPassthrough(rest),
         className: cn("flex-shrink-0", className),
         style: boxStyle
       }
@@ -4843,6 +4923,7 @@ function AtlasImage({
       src: asset.url,
       alt: alt ?? asset.name ?? asset.category ?? "",
       "aria-hidden": ariaHidden,
+      ...domPassthrough(rest),
       ...typeof w === "number" ? { width: w } : {},
       ...typeof h === "number" ? { height: h } : {},
       className: cn("flex-shrink-0", className),
@@ -4859,7 +4940,8 @@ var INERT_API = {
   beginNavigate: () => void 0,
   back: () => void 0,
   goTo: () => void 0,
-  setCurrentLabel: () => void 0
+  setCurrentLabel: () => void 0,
+  registerNavItems: () => void 0
 };
 var NavStackContext = createContext(INERT_API);
 function isInertNavStack(api) {
@@ -4875,7 +4957,9 @@ function isAbsoluteHref(href) {
 }
 function followHref(href, navStack) {
   if (href.startsWith("#")) {
-    document.getElementById(decodeURIComponent(href.slice(1)))?.scrollIntoView({ behavior: "smooth" });
+    const target = document.getElementById(decodeURIComponent(href.slice(1)));
+    target?.scrollIntoView({ behavior: "smooth" });
+    target?.focus({ preventScroll: true });
   } else if (isAbsoluteHref(href) || isInertNavStack(navStack)) {
     window.location.assign(href);
   } else {
@@ -4959,7 +5043,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React15__default.isValidElement(value)) {
+  if (React16__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && isIconLike(value)) {
@@ -4968,7 +5052,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React15__default.forwardRef(
+var Button = React16__default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -4986,22 +5070,42 @@ var Button = React15__default.forwardRef(
     href,
     children,
     onClick,
+    onFocus,
+    onBlur,
     "data-testid": dataTestId,
     ...props
   }, ref) => {
     const eventBus = useEventBus();
     const navStack = useNavStack();
+    const { pending, activate } = usePendingAction();
+    const busy = isLoading || pending;
+    const [focused, setFocused] = React16__default.useState(false);
+    const inert = Boolean(disabled) || busy;
+    const emitAction = () => {
+      if (!action) return;
+      activate((pendingKey) => eventBus.emit(`UI:${action}`, actionPayload ?? {}, { pendingKey }));
+    };
     const leftIconValue = leftIcon || iconProp;
     const rightIconValue = rightIcon || iconRightProp;
     const px = size === "sm" ? 16 : size === "lg" ? 20 : 16;
     const resolvedLeftIcon = iconAsset?.url ? /* @__PURE__ */ jsx(AtlasImage, { asset: iconAsset, size: px, alt: iconAsset.name ?? iconAsset.category ?? "", className: "flex-shrink-0" }) : resolveIconProp(leftIconValue, iconSizeStyles[size]);
     const resolvedRightIcon = resolveIconProp(rightIconValue, iconSizeStyles[size]);
     const handleClick = (e) => {
-      if (action) {
-        eventBus.emit(`UI:${action}`, actionPayload ?? {});
+      if (inert) {
+        e.preventDefault();
+        return;
       }
+      emitAction();
       onClick?.(e);
     };
+    const handleFocus = (e) => {
+      setFocused(true);
+      onFocus?.(e);
+    };
+    const handleBlur = (e) => {
+      setFocused(false);
+      onBlur?.(e);
+    };
     const classes = cn(
       "relative inline-flex items-center justify-center gap-2",
       "font-medium",
@@ -5013,23 +5117,26 @@ var Button = React15__default.forwardRef(
       "disabled:opacity-50 disabled:cursor-not-allowed",
       variantStyles2[variant],
       variant === "link" ? "h-auto px-0 text-sm" : sizeStyles[size],
+      busy && "cursor-progress",
+      disabled && focused && "opacity-50 cursor-not-allowed",
       className
     );
     const testId = dataTestId ?? (action ? `action-${action}` : void 0);
     const content = /* @__PURE__ */ jsxs(Fragment, { children: [
-      isLoading ? /* @__PURE__ */ jsx(Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
-      (Array.isArray(children) ? children.length > 0 : Boolean(children)) ? children : label ? /* @__PURE__ */ jsx("span", { ...{ [INLINE_TEXT_ATTR]: "label" }, children: label }) : label,
-      resolvedRightIcon && !isLoading && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedRightIcon })
+      busy && /* @__PURE__ */ jsx("span", { className: "almadar-busy-indicator absolute inset-0 flex items-center justify-center", "aria-hidden": "true", children: /* @__PURE__ */ jsx(Loader2, { className: "h-icon-default w-icon-default animate-spin" }) }),
+      /* @__PURE__ */ jsxs("span", { className: cn("inline-flex items-center justify-center gap-2", busy && "almadar-busy-content"), children: [
+        resolvedLeftIcon && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
+        (Array.isArray(children) ? children.length > 0 : Boolean(children)) ? children : label ? /* @__PURE__ */ jsx("span", { ...{ [INLINE_TEXT_ATTR]: "label" }, children: label }) : label,
+        resolvedRightIcon && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedRightIcon })
+      ] })
     ] });
     if (href !== void 0 && href !== "") {
       const handleLinkClick = (e) => {
-        if (disabled || isLoading) {
+        if (disabled || busy) {
           e.preventDefault();
           return;
         }
-        if (action) {
-          eventBus.emit(`UI:${action}`, actionPayload ?? {});
-        }
+        emitAction();
         if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || e.button !== 0) return;
         if (!href.startsWith("#") && isInertNavStack(navStack)) return;
         e.preventDefault();
@@ -5044,7 +5151,8 @@ var Button = React15__default.forwardRef(
           title: props.title,
           style: props.style,
           "aria-label": props["aria-label"],
-          "aria-disabled": disabled || isLoading || void 0,
+          "aria-disabled": disabled || busy || void 0,
+          "aria-busy": busy || void 0,
           className: classes,
           onClick: handleLinkClick,
           "data-testid": testId,
@@ -5057,9 +5165,13 @@ var Button = React15__default.forwardRef(
       {
         ref,
         type: "button",
-        disabled: disabled || isLoading,
+        disabled: Boolean(disabled) && !focused,
+        "aria-disabled": inert || void 0,
+        "aria-busy": busy || void 0,
         className: classes,
         onClick: handleClick,
+        onFocus: handleFocus,
+        onBlur: handleBlur,
         ...props,
         "data-testid": testId,
         children: content
@@ -5105,8 +5217,8 @@ var sizeStyles2 = {
   md: "px-2.5 py-1 text-sm",
   lg: "px-3 py-1.5 text-base"
 };
-var Badge = React15__default.forwardRef(
-  ({ className, variant = "default", size = "sm", amount, label, icon, iconAsset, children, onRemove, removeLabel, ...props }, ref) => {
+var Badge = React16__default.forwardRef(
+  ({ className, variant = "default", size = "sm", amount, label, icon, iconAsset, children, onRemove, removeLabel, onClick, ...props }, ref) => {
     const { t } = useTranslate();
     const iconSizes = {
       sm: "h-icon-default w-icon-default",
@@ -5117,6 +5229,12 @@ var Badge = React15__default.forwardRef(
     const resolvedIcon = iconAsset?.url ? /* @__PURE__ */ jsx(AtlasImage, { asset: iconAsset, size: iconPx, alt: iconAsset.name ?? iconAsset.category ?? "", className: "flex-shrink-0" }) : typeof icon === "string" ? /* @__PURE__ */ jsx(Icon, { name: icon, className: iconSizes[size] }) : icon ? /* @__PURE__ */ jsx(Icon, { icon, className: iconSizes[size] }) : null;
     const hasText = Boolean(children) || amount != null || label !== void 0 && label !== null && label !== "";
     if (!hasText && !resolvedIcon && !onRemove) return null;
+    const text = typeof children === "string" || typeof children === "number" ? String(children) : amount != null ? `${label ? `${label} ` : ""}${amount}` : label !== void 0 && label !== null ? String(label) : "";
+    const removeName = removeLabel ?? `${t("common.remove")}${text ? `: ${text}` : ""}`;
+    const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+      resolvedIcon,
+      children || (amount != null ? `${label ? `${label} ` : ""}${amount}` : label ? /* @__PURE__ */ jsx("span", { ...{ [INLINE_TEXT_ATTR]: "label" }, children: label }) : label)
+    ] });
     return /* @__PURE__ */ jsxs(
       "span",
       {
@@ -5130,13 +5248,20 @@ var Badge = React15__default.forwardRef(
         ),
         ...props,
         children: [
-          resolvedIcon,
-          children || (amount != null ? `${label ? `${label} ` : ""}${amount}` : label ? /* @__PURE__ */ jsx("span", { ...{ [INLINE_TEXT_ATTR]: "label" }, children: label }) : label),
+          onClick ? /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick,
+              className: "inline-flex items-center gap-1 rounded-pill focus:outline-none focus-visible:ring-1 focus-visible:ring-ring",
+              children: body
+            }
+          ) : body,
           onRemove ? /* @__PURE__ */ jsx(
             "button",
             {
               type: "button",
-              "aria-label": removeLabel ?? t("common.remove"),
+              "aria-label": removeName,
               onClick: (e) => {
                 e.stopPropagation();
                 onRemove();
@@ -5162,13 +5287,16 @@ var sizeStyles3 = {
   md: "h-6 w-6",
   lg: "h-8 w-8"
 };
-var Spinner = React15__default.forwardRef(
+var Spinner = React16__default.forwardRef(
   ({ className, size = "md", overlay, ...props }, ref) => {
+    const { t } = useTranslate();
     if (overlay) {
       return /* @__PURE__ */ jsx(
         "div",
         {
           ref,
+          role: "status",
+          "aria-label": t("aria.loading"),
           ...{ [LOADING_STATE_MARKER]: "" },
           className: cn(
             "absolute inset-0 z-10 flex items-center justify-center",
@@ -5184,6 +5312,8 @@ var Spinner = React15__default.forwardRef(
       "div",
       {
         ref,
+        role: "status",
+        "aria-label": t("aria.loading"),
         ...{ [LOADING_STATE_MARKER]: "" },
         className: cn("text-foreground", className),
         ...props,
@@ -5246,7 +5376,7 @@ var lookStyles = {
   chip: "shadow-none rounded-pill border-[length:var(--border-width)] border-border",
   "tile-image-first": "p-0 overflow-hidden"
 };
-var Card = React15__default.forwardRef(
+var Card = React16__default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -5296,9 +5426,9 @@ var Card = React15__default.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React15__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React16__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React15__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardTitle = React16__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "h3",
   {
     ref,
@@ -5311,11 +5441,11 @@ var CardTitle = React15__default.forwardRef(({ className, ...props }, ref) => /*
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React15__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React16__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React15__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardFooter = React16__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "div",
   {
     ref,
@@ -5333,7 +5463,8 @@ var Divider = ({
   orientation = "horizontal",
   label,
   variant = "solid",
-  className
+  className,
+  ...rest
 }) => {
   if (orientation === "vertical") {
     return /* @__PURE__ */ jsx(
@@ -5344,6 +5475,7 @@ var Divider = ({
           variantStyles5[variant],
           className
         ),
+        ...domPassthrough(rest),
         role: "separator",
         "aria-orientation": "vertical"
       }
@@ -5354,8 +5486,9 @@ var Divider = ({
       "div",
       {
         className: cn("flex items-center gap-3 my-4", className),
+        ...domPassthrough(rest),
         role: "separator",
-        "aria-label": label,
+        "aria-label": rest["aria-label"] ?? label,
         children: [
           /* @__PURE__ */ jsx(
             "div",
@@ -5388,6 +5521,7 @@ var Divider = ({
         variantStyles5[variant],
         className
       ),
+      ...domPassthrough(rest),
       role: "separator",
       "aria-orientation": "horizontal"
     }
@@ -5404,10 +5538,12 @@ var Center = ({
   className,
   style,
   children,
-  as: Component = "div"
+  as: Component = "div",
+  ...rest
 }) => {
   const mergedStyle = minHeight ? { minHeight, ...style } : style;
-  return React15__default.createElement(Component, {
+  return React16__default.createElement(Component, {
+    ...domPassthrough(rest),
     className: cn(
       inline ? "inline-flex" : "flex",
       horizontal && "justify-center",
@@ -5439,16 +5575,18 @@ var verticalSizes = {
 var Spacer = ({
   size = "auto",
   axis = "horizontal",
-  className
+  className,
+  ...rest
 }) => {
   if (size === "auto") {
-    return /* @__PURE__ */ jsx("div", { className: cn("flex-1", className), "aria-hidden": "true" });
+    return /* @__PURE__ */ jsx("div", { className: cn("flex-1", className), ...domPassthrough(rest), "aria-hidden": "true" });
   }
   const sizeClass = axis === "horizontal" ? horizontalSizes[size] : verticalSizes[size];
   return /* @__PURE__ */ jsx(
     "div",
     {
       className: cn("flex-shrink-0", sizeClass, className),
+      ...domPassthrough(rest),
       "aria-hidden": "true"
     }
   );
@@ -5506,12 +5644,13 @@ var Avatar = ({
   className,
   onClick,
   action,
-  actionPayload
+  actionPayload,
+  ...rest
 }) => {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [imgFailed, setImgFailed] = React15__default.useState(false);
-  React15__default.useEffect(() => {
+  const [imgFailed, setImgFailed] = React16__default.useState(false);
+  React16__default.useEffect(() => {
     setImgFailed(false);
   }, [src]);
   const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -5527,7 +5666,7 @@ var Avatar = ({
     onClick?.();
   };
   const press = pressableProps(isClickable ? handleClick : void 0);
-  return /* @__PURE__ */ jsxs("div", { className: "relative inline-block", children: [
+  return /* @__PURE__ */ jsxs("div", { className: "relative inline-block", ...domPassthrough(rest), children: [
     /* @__PURE__ */ jsx(
       "div",
       {
@@ -5636,7 +5775,8 @@ var Image2 = ({
   rounded = "md",
   bordered = false,
   loading = "lazy",
-  className
+  className,
+  ...rest
 }) => {
   if (!src) return null;
   return /* @__PURE__ */ jsx(
@@ -5644,7 +5784,8 @@ var Image2 = ({
     {
       src,
       alt,
-      role: alt === "" ? "presentation" : void 0,
+      ...domPassthrough(rest),
+      role: alt === "" ? "presentation" : rest.role,
       loading,
       decoding: "async",
       className: cn(
@@ -5674,7 +5815,7 @@ var alignToStack = {
   left: "start",
   right: "end"
 };
-var SectionHeader = ({ title, subtitle, align = "center", level = 2, className }) => {
+var SectionHeader = ({ title, subtitle, align = "center", level = 2, className, ...rest }) => {
   const variant = levelToVariant[level];
   return /* @__PURE__ */ jsxs(
     VStack,
@@ -5682,6 +5823,7 @@ var SectionHeader = ({ title, subtitle, align = "center", level = 2, className }
       gap: "sm",
       align: alignToStack[align],
       className: cn(alignClasses[align], className),
+      ...domPassthrough(rest),
       children: [
         /* @__PURE__ */ jsx(Typography, { variant, weight: "bold", children: title }),
         subtitle ? /* @__PURE__ */ jsx(Typography, { variant: "body", color: "muted", children: subtitle }) : null
@@ -5708,7 +5850,8 @@ var FeatureCard = ({
   linkLabel,
   variant = "bordered",
   size = "md",
-  className
+  className,
+  ...rest
 }) => {
   const { t } = useTranslate();
   const renderIcon = () => {
@@ -5731,6 +5874,7 @@ var FeatureCard = ({
   return /* @__PURE__ */ jsx(
     Card,
     {
+      ...domPassthrough(rest),
       variant,
       padding: size,
       className: cn(
@@ -5765,6 +5909,14 @@ var gapStyles2 = {
   lg: "gap-6",
   xl: "gap-8"
 };
+var gapLengths = {
+  none: "0px",
+  xs: "0.25rem",
+  sm: "0.5rem",
+  md: "1rem",
+  lg: "1.5rem",
+  xl: "2rem"
+};
 var colStyles = {
   1: "grid-cols-1",
   2: "grid-cols-1 sm:grid-cols-2 @max-sm:!grid-cols-1",
@@ -5779,22 +5931,22 @@ var SimpleGrid = ({
   cols,
   gap = "md",
   className,
-  children
+  children,
+  ...rest
 }) => {
+  const passthrough = domPassthrough(rest);
   if (cols) {
-    return /* @__PURE__ */ jsx(Box, { className: cn("grid", colStyles[cols], gapStyles2[gap], className), children });
+    return /* @__PURE__ */ jsx(Box, { className: cn("grid", colStyles[cols], gapStyles2[gap], className), ...passthrough, children });
   }
   const minWidth = typeof minChildWidth === "number" ? `${minChildWidth}px` : minChildWidth;
-  const templateColumns = maxCols ? `repeat(auto-fit, minmax(min(${minWidth}, 100%), 1fr))` : `repeat(auto-fit, minmax(${minWidth}, 1fr))`;
+  const templateColumns = maxCols ? `repeat(auto-fit, minmax(max(min(${minWidth}, 100%), calc((100% - ${maxCols - 1} * ${gapLengths[gap]}) / ${maxCols})), 1fr))` : `repeat(auto-fit, minmax(${minWidth}, 1fr))`;
   return /* @__PURE__ */ jsx(
     Box,
     {
+      ...domPassthrough(rest),
       className: cn("grid", gapStyles2[gap], className),
-      style: {
-        gridTemplateColumns: templateColumns,
-        // Limit max columns if specified
-        ...maxCols && { maxWidth: `calc(${maxCols} * (${minWidth} + var(--gap, 1rem)))` }
-      },
+      style: { gridTemplateColumns: templateColumns },
+      ...passthrough,
       children
     }
   );
@@ -5804,11 +5956,13 @@ var FeatureGrid = ({
   items,
   columns = 3,
   gap = "md",
-  className
+  className,
+  ...rest
 }) => {
   return /* @__PURE__ */ jsx(
     SimpleGrid,
     {
+      ...domPassthrough(rest),
       cols: columns,
       gap,
       className: cn(className),
@@ -5848,12 +6002,14 @@ var Container = ({
   center = true,
   className,
   children,
-  as: Component = "div"
+  as: Component = "div",
+  ...rest
 }) => {
   const resolvedSize = maxWidth ?? size ?? "lg";
-  return React15__default.createElement(
+  return React16__default.createElement(
     Component,
     {
+      ...domPassthrough(rest),
       className: cn(
         "w-full",
         sizeStyles4[resolvedSize],
@@ -5881,7 +6037,8 @@ var Sparkline = ({
   height = 32,
   strokeWidth = 2,
   fill = false,
-  className
+  className,
+  ...rest
 }) => {
   if (data.length < 2) return null;
   const pad = 2;
@@ -5902,7 +6059,8 @@ var Sparkline = ({
       height,
       viewBox: `0 0 ${width} ${height}`,
       className: cn("flex-shrink-0", className),
-      "aria-hidden": "true",
+      ...domPassthrough(rest),
+      "aria-hidden": rest["aria-hidden"] ?? true,
       children: [
         areaPath && /* @__PURE__ */ jsx("path", { d: areaPath, fill: resolvedColor, opacity: 0.15 }),
         /* @__PURE__ */ jsx(
@@ -5963,7 +6121,8 @@ var StatDisplay = ({
   look = "elevated",
   className,
   isLoading = false,
-  error = null
+  error = null,
+  ...rest
 }) => {
   const eventBus = useEventBus();
   const fmt = useFormatContext();
@@ -5985,10 +6144,10 @@ var StatDisplay = ({
   const trendSuffix = trendFormat === "percent" ? "%" : "";
   const trendLabel = showTrend ? `${trendUp ? "\u2191" : "\u2193"} ${trendMagnitude}${trendSuffix}` : "";
   if (error) {
-    return /* @__PURE__ */ jsx(Card, { className: cn(padSizes[size], className), children: /* @__PURE__ */ jsx(Typography, { variant: "small", color: "error", children: error.message }) });
+    return /* @__PURE__ */ jsx(Card, { ...domPassthrough(rest), className: cn(padSizes[size], className), children: /* @__PURE__ */ jsx(Typography, { variant: "small", color: "error", children: error.message }) });
   }
   if (isLoading) {
-    return /* @__PURE__ */ jsx(Card, { className: cn(padSizes[size], className), children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", className: "animate-pulse", children: [
+    return /* @__PURE__ */ jsx(Card, { ...domPassthrough(rest), className: cn(padSizes[size], className), children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", className: "animate-pulse", children: [
       /* @__PURE__ */ jsx(Box, { className: "h-3 bg-muted rounded w-16" }),
       /* @__PURE__ */ jsx(Box, { className: "h-6 bg-muted rounded w-12" })
     ] }) });
@@ -5997,6 +6156,7 @@ var StatDisplay = ({
     return /* @__PURE__ */ jsxs(
       HStack,
       {
+        ...domPassthrough(rest),
         gap: "sm",
         className: cn("items-center", clickEvent && "cursor-pointer hover:opacity-80", className),
         ...pressableProps(clickEvent ? handleClick : void 0),
@@ -6013,6 +6173,7 @@ var StatDisplay = ({
   return /* @__PURE__ */ jsx(
     Card,
     {
+      ...domPassthrough(rest),
       className: cn(padSizes[size], lookStyles2[look], clickEvent && "cursor-pointer hover:shadow-elevation-dialog transition-shadow", className),
       ...pressableProps(clickEvent ? handleClick : void 0),
       children: /* @__PURE__ */ jsxs(HStack, { align: "start", justify: "between", children: [
@@ -6056,12 +6217,14 @@ var colorTokenVars = {
 };
 var GradientDivider = ({
   color,
-  className
+  className,
+  ...rest
 }) => {
   const centerColor = color ? color in colorTokenVars ? colorTokenVars[color] : color : "var(--color-primary)";
   return /* @__PURE__ */ jsx(
     Box,
     {
+      ...domPassthrough(rest),
       className: cn("w-full h-px", className),
       style: {
         background: `linear-gradient(to right, transparent, ${centerColor}, transparent)`
@@ -6112,7 +6275,8 @@ var AnimatedCounter = ({
   prefix,
   suffix,
   format,
-  className
+  className,
+  ...rest
 }) => {
   const fmt = useFormatContext();
   const ref = useRef(null);
@@ -6164,7 +6328,7 @@ var AnimatedCounter = ({
     };
   }, [visible, target, duration]);
   const text = parsed.num === null ? parsed.suffix : `${prefix ?? ""}${parsed.prefix}${formatNumber(display, format, parsed.decimals, fmt)}${parsed.suffix}${suffix ?? ""}`;
-  return /* @__PURE__ */ jsxs(Box, { ref, className: cn("flex flex-col items-center gap-1", className), children: [
+  return /* @__PURE__ */ jsxs(Box, { ...domPassthrough(rest), ref, className: cn("flex flex-col items-center gap-1", className), children: [
     /* @__PURE__ */ jsx(Typography, { variant: "h2", className: "text-primary tabular-nums", children: text }),
     label ? /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "muted", className: "text-center", children: label }) : null
   ] });
@@ -6190,7 +6354,7 @@ var animatedStyles = {
   "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
   "none": {}
 };
-var AnimatedReveal = React15__default.forwardRef(
+var AnimatedReveal = React16__default.forwardRef(
   ({
     trigger = "scroll",
     animation = "fade-up",
@@ -6343,7 +6507,7 @@ function applyMorphAnimation(container, animate, duration, delay, easing) {
     el.style.opacity = animate ? "1" : "0";
   });
 }
-var AnimatedGraphic = React15__default.forwardRef(
+var AnimatedGraphic = React16__default.forwardRef(
   ({
     src,
     svgContent,
@@ -6366,7 +6530,7 @@ var AnimatedGraphic = React15__default.forwardRef(
     const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
     const resolvedSvg = svgContent ?? fetchedSvg;
     const prevAnimateRef = useRef(animate);
-    const setRef = React15__default.useCallback(
+    const setRef = React16__default.useCallback(
       (node) => {
         containerRef.current = node;
         if (typeof ref === "function") ref(node);
@@ -6917,10 +7081,11 @@ var PatternTile = ({
   size = 60,
   color = "var(--color-primary)",
   strokeWidth = 0.5,
-  className
+  className,
+  ...rest
 }) => {
   const Variant = VARIANT_MAP[variant];
-  return /* @__PURE__ */ jsx("g", { className, children: /* @__PURE__ */ jsx(Variant, { size, color, strokeWidth }) });
+  return /* @__PURE__ */ jsx("g", { className, ...domPassthrough(rest), children: /* @__PURE__ */ jsx(Variant, { size, color, strokeWidth }) });
 };
 PatternTile.displayName = "PatternTile";
 function getTileDimensions(variant, size) {