@almadar/ui 6.51.2 → 6.53.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 React17 from 'react';
+import React17__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 = React17__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 React17__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 React17__default.createElement(
     Component,
     {
       ...domPassthrough(rest),
@@ -3178,6 +3179,7 @@ var en_default = {
   "aria.removeFilter": "Remove filter",
   "aria.closeDrawer": "Close drawer",
   "aria.closePanel": "Close panel",
+  "aria.dockPanel": "Side panel",
   "aria.previousImage": "Previous image",
   "aria.nextImage": "Next image",
   "aria.dismiss": "Dismiss",
@@ -3199,6 +3201,7 @@ var en_default = {
   "aria.openMenu": "Open menu",
   "aria.closeMenu": "Close menu",
   "aria.openSidebar": "Open sidebar",
+  "aria.openRow": "Open item {{position}}",
   "sidebar.expand": "Expand sidebar",
   "sidebar.collapse": "Collapse sidebar",
   "sidebar.close": "Close sidebar",
@@ -4214,7 +4217,81 @@ 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",
+  "agentActivity.toolCall": "Called {{tool}}",
+  "agentActivity.toolResult": "{{tool}} returned",
+  "agentActivity.toolRows": "{{count}} rows",
+  "agentActivity.thinking": "Thinking\u2026",
+  "agentActivity.analyzed": "Analyzed your request \u2014 {{organism}}",
+  "agentActivity.renamed": "Rename {{from}} \u2192 {{to}}",
+  "agentActivity.deleted": "Remove {{orbitalName}}",
+  "agentActivity.roster": "Planning {{count}} orbitals",
+  "agentActivity.orbitalStarted": "Working on {{orbitalName}}\u2026",
+  "agentActivity.orbitalStartedSettled": "Started {{orbitalName}}",
+  "agentActivity.orbitalDone": "{{orbitalName}} ready",
+  "agentActivity.orbitalCounts": "{{traitCount}} traits, {{transitionCount}} transitions",
+  "agentActivity.change.orbital-added": "Added {{orbitalName}}",
+  "agentActivity.change.orbital-removed": "Removed {{orbitalName}}",
+  "agentActivity.change.entity-fields-changed": "Changed the data fields of {{orbitalName}}",
+  "agentActivity.change.trait-added": "Added a behavior to {{orbitalName}}",
+  "agentActivity.change.trait-removed": "Removed a behavior from {{orbitalName}}",
+  "agentActivity.change.state-machine-changed": "Changed the flow of {{orbitalName}}",
+  "agentActivity.change.guard-changed": "Changed a rule in {{orbitalName}}",
+  "agentActivity.change.effect-changed": "Changed what {{orbitalName}} does",
+  "agentActivity.change.render-ui-changed": "Changed the design of {{orbitalName}}",
+  "agentActivity.change.event-wiring-changed": "Changed the connections of {{orbitalName}}",
+  "agentActivity.change.page-changed": "Changed the pages of {{orbitalName}}",
+  "agentActivity.change.behavior-composed": "Composed a behavior into {{orbitalName}}",
+  "agentActivity.done": "Done \u2014 {{count}} orbitals ready",
+  "agentActivity.cancelled": "Cancelled",
+  "agentActivity.jump": "Show",
+  "agentActivity.emptyTitle": "No activity yet",
+  "agentActivity.emptyDescription": "Send a message and the agent's work shows up here.",
+  "agentActivity.fileOperation": "{{operation}}",
+  "agentActivity.schemaDiff": "Edited {{filePath}}",
+  "agentActivity.coordinatorDecision": "Chose {{organism}}",
+  "agentActivity.change.trait-config-changed": "Changed the settings of {{orbitalName}}",
+  "agentActivity.change.theme-changed": "Changed the theme of {{orbitalName}}",
+  "agentActivity.llmResponse": "Raw LLM response",
+  "agentActivity.llmDuration": "{{seconds}}s",
+  "agentActivity.llmTokens": "{{prompt}} in / {{completion}} out tokens",
+  "agentActivity.llmResponseLabel": "Response",
+  "agentActivity.llmSystemPrompt": "System prompt",
+  "agentActivity.llmUserPrompt": "User prompt",
+  "agentActivity.llmToolCalls": "Tool calls",
+  "agentActivity.showRawLlm": "Raw LLM",
+  "agentActivity.earlierConversations": "Earlier conversations ({{count}})",
+  "agentActivity.earlierActivity": "Earlier activity"
 };
 
 // lib/format.ts
@@ -4292,7 +4369,6 @@ var I18nContext = createContext({
   }
 });
 I18nContext.displayName = "I18nContext";
-I18nContext.Provider;
 function useTranslate() {
   return useContext(I18nContext);
 }
@@ -4404,7 +4480,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 React17__default.createElement(
     Component,
     {
       ...domPassthrough(rest),
@@ -4436,6 +4512,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 +4686,7 @@ function resolveLucide(name) {
 }
 function makeLucideAdapter(name) {
   const LucideComp = resolveLucide(name);
-  const Adapter = React15__default.forwardRef((props, ref) => /* @__PURE__ */ jsx(
+  const Adapter = React17__default.forwardRef((props, ref) => /* @__PURE__ */ jsx(
     LucideComp,
     {
       ref,
@@ -4647,15 +4767,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 = React17__default.useRef(null);
   const themeStroke = useThemeIconStrokeApplies(svgRef);
-  const RenderedComponent = React15__default.useMemo(() => {
+  const RenderedComponent = React17__default.useMemo(() => {
     if (directIcon) return null;
     return effectiveName ? resolveIconForFamily(effectiveName) : null;
   }, [directIcon, effectiveName, family]);
@@ -4678,7 +4799,8 @@ var Icon = ({
         ref: svgRef,
         className: composedClassName,
         strokeWidth: effectiveStrokeWidth,
-        style: inlineStyle
+        style: inlineStyle,
+        ...domPassthrough(rest)
       }
     );
   }
@@ -4689,7 +4811,8 @@ var Icon = ({
         ref: svgRef,
         className: composedClassName,
         strokeWidth: effectiveStrokeWidth,
-        style: inlineStyle
+        style: inlineStyle,
+        ...domPassthrough(rest)
       }
     );
   }
@@ -4700,7 +4823,8 @@ var Icon = ({
       ref: svgRef,
       className: composedClassName,
       strokeWidth: effectiveStrokeWidth,
-      style: inlineStyle
+      style: inlineStyle,
+      ...domPassthrough(rest)
     }
   );
 };
@@ -4791,15 +4915,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] = React17.useReducer((x) => x + 1, 0);
+  const canvasRef = React17.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(() => {
+  React17.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas || !img || !rect) return;
     canvas.width = rect.sw;
@@ -4832,6 +4957,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 +4969,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 +4986,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 +5003,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 +5089,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React15__default.isValidElement(value)) {
+  if (React17__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && isIconLike(value)) {
@@ -4968,7 +5098,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React15__default.forwardRef(
+var Button = React17__default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -4986,22 +5116,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] = React17__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 +5163,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 +5197,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 +5211,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 +5263,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 = React17__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 +5275,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 +5294,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();
@@ -5156,19 +5327,34 @@ var Badge = React15__default.forwardRef(
   }
 );
 Badge.displayName = "Badge";
+var SurfaceContext = React17__default.createContext(false);
+function SurfaceBoundary({ children }) {
+  return /* @__PURE__ */ jsx(SurfaceContext.Provider, { value: true, children });
+}
+function useContentSurface(surface = "auto") {
+  const onSurface = React17__default.useContext(SurfaceContext);
+  const paints = surface === "auto" && !onSurface;
+  return {
+    className: paints ? "surface-content" : void 0,
+    provide: (node) => paints ? /* @__PURE__ */ jsx(SurfaceBoundary, { children: node }) : /* @__PURE__ */ jsx(Fragment, { children: node })
+  };
+}
 var sizeStyles3 = {
   xs: "h-3 w-3",
   sm: "h-icon-default w-icon-default",
   md: "h-6 w-6",
   lg: "h-8 w-8"
 };
-var Spinner = React15__default.forwardRef(
+var Spinner = React17__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 +5370,8 @@ var Spinner = React15__default.forwardRef(
       "div",
       {
         ref,
+        role: "status",
+        "aria-label": t("aria.loading"),
         ...{ [LOADING_STATE_MARKER]: "" },
         className: cn("text-foreground", className),
         ...props,
@@ -5195,16 +5383,12 @@ var Spinner = React15__default.forwardRef(
 Spinner.displayName = "Spinner";
 var variantStyles4 = {
   default: [
-    "bg-card surface-material",
-    "border-[length:var(--border-width)] border-border",
-    "shadow-elevation-card",
+    "surface-content",
     "transition-all duration-normal",
     "hover:shadow-elevation-dialog hover:translate-y-[var(--hover-translate-y)]"
   ].join(" "),
   bordered: [
-    "bg-card surface-material",
-    "border-[length:var(--border-width)] border-border",
-    "shadow-elevation-card",
+    "surface-content",
     "transition-all duration-normal",
     "hover:shadow-elevation-dialog hover:translate-y-[var(--hover-translate-y)]"
   ].join(" "),
@@ -5246,7 +5430,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 = React17__default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -5289,16 +5473,16 @@ var Card = React15__default.forwardRef(
             title && /* @__PURE__ */ jsx("h3", { className: "text-lg text-card-foreground heading-voice", children: title }),
             subtitle && /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground mt-1", children: subtitle })
           ] }),
-          children
+          /* @__PURE__ */ jsx(SurfaceBoundary, { children })
         ]
       }
     );
   }
 );
 Card.displayName = "Card";
-var CardHeader = React15__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React17__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 = React17__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "h3",
   {
     ref,
@@ -5311,11 +5495,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 = React17__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 = React17__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "div",
   {
     ref,
@@ -5333,7 +5517,8 @@ var Divider = ({
   orientation = "horizontal",
   label,
   variant = "solid",
-  className
+  className,
+  ...rest
 }) => {
   if (orientation === "vertical") {
     return /* @__PURE__ */ jsx(
@@ -5344,6 +5529,7 @@ var Divider = ({
           variantStyles5[variant],
           className
         ),
+        ...domPassthrough(rest),
         role: "separator",
         "aria-orientation": "vertical"
       }
@@ -5354,8 +5540,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 +5575,7 @@ var Divider = ({
         variantStyles5[variant],
         className
       ),
+      ...domPassthrough(rest),
       role: "separator",
       "aria-orientation": "horizontal"
     }
@@ -5404,10 +5592,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 React17__default.createElement(Component, {
+    ...domPassthrough(rest),
     className: cn(
       inline ? "inline-flex" : "flex",
       horizontal && "justify-center",
@@ -5439,16 +5629,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 +5698,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] = React17__default.useState(false);
+  React17__default.useEffect(() => {
     setImgFailed(false);
   }, [src]);
   const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -5527,7 +5720,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 +5829,8 @@ var Image2 = ({
   rounded = "md",
   bordered = false,
   loading = "lazy",
-  className
+  className,
+  ...rest
 }) => {
   if (!src) return null;
   return /* @__PURE__ */ jsx(
@@ -5644,7 +5838,8 @@ var Image2 = ({
     {
       src,
       alt,
-      role: alt === "" ? "presentation" : void 0,
+      ...domPassthrough(rest),
+      role: alt === "" ? "presentation" : rest.role,
       loading,
       decoding: "async",
       className: cn(
@@ -5674,7 +5869,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 +5877,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 +5904,8 @@ var FeatureCard = ({
   linkLabel,
   variant = "bordered",
   size = "md",
-  className
+  className,
+  ...rest
 }) => {
   const { t } = useTranslate();
   const renderIcon = () => {
@@ -5731,6 +5928,7 @@ var FeatureCard = ({
   return /* @__PURE__ */ jsx(
     Card,
     {
+      ...domPassthrough(rest),
       variant,
       padding: size,
       className: cn(
@@ -5765,6 +5963,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 +5985,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 +6010,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 +6056,14 @@ var Container = ({
   center = true,
   className,
   children,
-  as: Component = "div"
+  as: Component = "div",
+  ...rest
 }) => {
   const resolvedSize = maxWidth ?? size ?? "lg";
-  return React15__default.createElement(
+  return React17__default.createElement(
     Component,
     {
+      ...domPassthrough(rest),
       className: cn(
         "w-full",
         sizeStyles4[resolvedSize],
@@ -5866,6 +6076,186 @@ var Container = ({
   );
 };
 Container.displayName = "Container";
+var pulseClass = "almadar-shimmer animate-shimmer rounded-container";
+function SkeletonLine({ className }) {
+  return /* @__PURE__ */ jsx(Box, { className: cn(pulseClass, "h-4", className) });
+}
+function SkeletonBlock({ className }) {
+  return /* @__PURE__ */ jsx(Box, { className: cn(pulseClass, className) });
+}
+function HeaderSkeleton({ className }) {
+  return /* @__PURE__ */ jsxs(HStack, { className: cn("items-center justify-between px-6 py-5", className), children: [
+    /* @__PURE__ */ jsxs(VStack, { gap: "sm", className: "flex-1", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-7 w-48" }),
+      /* @__PURE__ */ jsx(SkeletonLine, { className: "w-64" })
+    ] }),
+    /* @__PURE__ */ jsxs(HStack, { gap: "sm", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-9 w-24 rounded-interactive" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-9 w-32 rounded-interactive" })
+    ] })
+  ] });
+}
+function TableSkeleton({ rows = 5, columns = 4, className }) {
+  return /* @__PURE__ */ jsxs(VStack, { gap: "none", className: cn("border border-border rounded-container overflow-hidden", className), children: [
+    /* @__PURE__ */ jsx(HStack, { className: "px-4 py-3 bg-muted/30 border-b border-border", children: Array.from({ length: columns }).map((_, i) => /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-4 flex-1 mx-2" }, i)) }),
+    Array.from({ length: rows }).map((_, rowIdx) => /* @__PURE__ */ jsx(
+      HStack,
+      {
+        className: cn(
+          "px-4 py-3",
+          rowIdx < rows - 1 && "border-b border-border"
+        ),
+        children: Array.from({ length: columns }).map((_2, colIdx) => /* @__PURE__ */ jsx(SkeletonLine, { className: "flex-1 mx-2" }, colIdx))
+      },
+      rowIdx
+    ))
+  ] });
+}
+function FormSkeleton({ fields = 4, className }) {
+  return /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: cn("p-6", className), children: [
+    /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-6 w-40" }),
+    Array.from({ length: fields }).map((_, i) => /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-4 w-24" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-full rounded-interactive" })
+    ] }, i)),
+    /* @__PURE__ */ jsxs(HStack, { gap: "md", className: "justify-end pt-2", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-20 rounded-interactive" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-24 rounded-interactive" })
+    ] })
+  ] });
+}
+function CardSkeleton({ className }) {
+  return /* @__PURE__ */ jsxs(
+    VStack,
+    {
+      gap: "md",
+      className: cn(
+        "p-5 border border-border rounded-container",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxs(HStack, { className: "items-center", gap: "md", children: [
+          /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-10 rounded-full" }),
+          /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "flex-1", children: [
+            /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-5 w-32" }),
+            /* @__PURE__ */ jsx(SkeletonLine, { className: "w-48" })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx(SkeletonLine, { className: "w-full" }),
+        /* @__PURE__ */ jsx(SkeletonLine, { className: "w-3/4" }),
+        /* @__PURE__ */ jsxs(HStack, { gap: "sm", className: "pt-2", children: [
+          /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-6 w-16 rounded-full" }),
+          /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-6 w-20 rounded-full" })
+        ] })
+      ]
+    }
+  );
+}
+function TextSkeleton({ rows = 3, className }) {
+  return /* @__PURE__ */ jsx(VStack, { gap: "sm", className, children: Array.from({ length: rows }).map((_, i) => /* @__PURE__ */ jsx(
+    SkeletonLine,
+    {
+      className: i === rows - 1 ? "w-2/3" : "w-full"
+    },
+    i
+  )) });
+}
+function ListSkeleton({ rows = 5, className }) {
+  return /* @__PURE__ */ jsx(VStack, { gap: "none", className: cn("border border-border rounded-container overflow-hidden", className), children: Array.from({ length: rows }).map((_, i) => /* @__PURE__ */ jsxs(HStack, { gap: "md", className: cn("items-center px-4 py-3", i < rows - 1 && "border-b border-border"), children: [
+    /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-10 w-10 rounded-full shrink-0" }),
+    /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "flex-1 min-w-0", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-4 w-1/3" }),
+      /* @__PURE__ */ jsx(SkeletonLine, { className: "w-2/3 h-3" })
+    ] }),
+    /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-6 w-16 rounded-full" })
+  ] }, i)) });
+}
+function GridSkeleton({ rows = 6, className }) {
+  return /* @__PURE__ */ jsx(SimpleGrid, { minChildWidth: "260px", gap: "md", className, children: Array.from({ length: rows }).map((_, i) => /* @__PURE__ */ jsx(CardSkeleton, {}, i)) });
+}
+function StatsSkeleton({ columns = 4, className }) {
+  return /* @__PURE__ */ jsx(SimpleGrid, { minChildWidth: "180px", gap: "md", className, children: Array.from({ length: columns }).map((_, i) => /* @__PURE__ */ jsxs(VStack, { gap: "sm", className: "p-4 border border-border rounded-container", children: [
+    /* @__PURE__ */ jsx(SkeletonLine, { className: "w-1/2 h-3" }),
+    /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-7 w-2/3" })
+  ] }, i)) });
+}
+function DetailSkeleton({ rows = 6, className }) {
+  return /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: cn("p-6 border border-border rounded-container", className), children: [
+    /* @__PURE__ */ jsxs(HStack, { className: "items-start justify-between", gap: "md", children: [
+      /* @__PURE__ */ jsxs(HStack, { gap: "sm", className: "items-center", children: [
+        /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-8 w-56" }),
+        /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-6 w-20 rounded-full" })
+      ] }),
+      /* @__PURE__ */ jsxs(HStack, { gap: "sm", children: [
+        /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-9 w-24 rounded-interactive" }),
+        /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-9 w-9 rounded-interactive" })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs(HStack, { gap: "md", children: [
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-20 flex-1" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-20 flex-1" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-20 flex-1" })
+    ] }),
+    /* @__PURE__ */ jsx(SimpleGrid, { minChildWidth: "200px", maxCols: 3, gap: "md", children: Array.from({ length: rows }).map((_, i) => /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
+      /* @__PURE__ */ jsx(SkeletonLine, { className: "w-1/3 h-3" }),
+      /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-5 w-2/3" })
+    ] }, i)) }),
+    /* @__PURE__ */ jsx(TextSkeleton, { rows: 3 })
+  ] });
+}
+function Skeleton({
+  variant = "text",
+  spec,
+  rows,
+  columns,
+  fields,
+  className,
+  ...rest
+}) {
+  const { t } = useTranslate();
+  const shape = spec !== void 0 ? shapeOfSpec(spec) : { variant, rows, columns, fields };
+  if (shape === null) return null;
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      ...domPassthrough(rest),
+      role: "status",
+      "aria-busy": "true",
+      "aria-label": rest["aria-label"] ?? t("common.loading"),
+      "data-skeleton": shape.variant,
+      ...{ [LOADING_STATE_MARKER]: "" },
+      className: "w-full",
+      children: renderVariant(shape.variant, shape.rows, shape.columns, shape.fields, className)
+    }
+  );
+}
+function shapeOfSpec(spec) {
+  if (spec === "none") return null;
+  return typeof spec === "string" ? { variant: spec } : spec;
+}
+function renderVariant(variant, rows, columns, fields, className) {
+  switch (variant) {
+    case "header":
+      return /* @__PURE__ */ jsx(HeaderSkeleton, { className });
+    case "table":
+      return /* @__PURE__ */ jsx(TableSkeleton, { rows, columns, className });
+    case "list":
+      return /* @__PURE__ */ jsx(ListSkeleton, { rows, className });
+    case "grid":
+      return /* @__PURE__ */ jsx(GridSkeleton, { rows, className });
+    case "detail":
+      return /* @__PURE__ */ jsx(DetailSkeleton, { rows, className });
+    case "stats":
+      return /* @__PURE__ */ jsx(StatsSkeleton, { columns, className });
+    case "form":
+      return /* @__PURE__ */ jsx(FormSkeleton, { fields, className });
+    case "card":
+      return /* @__PURE__ */ jsx(CardSkeleton, { className });
+    case "text":
+      return /* @__PURE__ */ jsx(TextSkeleton, { rows, className });
+  }
+}
+Skeleton.displayName = "Skeleton";
 var COLOR_VAR = {
   primary: "var(--color-primary)",
   success: "var(--color-success)",
@@ -5881,7 +6271,8 @@ var Sparkline = ({
   height = 32,
   strokeWidth = 2,
   fill = false,
-  className
+  className,
+  ...rest
 }) => {
   if (data.length < 2) return null;
   const pad = 2;
@@ -5902,7 +6293,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(
@@ -5923,7 +6315,7 @@ var Sparkline = ({
 Sparkline.displayName = "Sparkline";
 var lookStyles2 = {
   elevated: "",
-  flat: "shadow-none border-[length:var(--border-width)] border-border",
+  flat: "shadow-none",
   "progress-backed": "",
   gauge: "",
   sparkline: ""
@@ -5963,8 +6355,12 @@ var StatDisplay = ({
   look = "elevated",
   className,
   isLoading = false,
-  error = null
+  skeleton = { variant: "stats", columns: 1 },
+  error = null,
+  surface = "auto",
+  ...rest
 }) => {
+  const contentSurface = useContentSurface(surface);
   const eventBus = useEventBus();
   const fmt = useFormatContext();
   const handleClick = useCallback(() => {
@@ -5985,18 +6381,18 @@ 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 contentSurface.provide(
+      /* @__PURE__ */ jsx(Box, { ...domPassthrough(rest), className: cn(contentSurface.className, "rounded-container", 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: [
-      /* @__PURE__ */ jsx(Box, { className: "h-3 bg-muted rounded w-16" }),
-      /* @__PURE__ */ jsx(Box, { className: "h-6 bg-muted rounded w-12" })
-    ] }) });
+    return /* @__PURE__ */ jsx(Skeleton, { spec: skeleton, className });
   }
   if (compact) {
     return /* @__PURE__ */ jsxs(
       HStack,
       {
+        ...domPassthrough(rest),
         gap: "sm",
         className: cn("items-center", clickEvent && "cursor-pointer hover:opacity-80", className),
         ...pressableProps(clickEvent ? handleClick : void 0),
@@ -6010,39 +6406,42 @@ var StatDisplay = ({
       }
     );
   }
-  return /* @__PURE__ */ jsx(
-    Card,
-    {
-      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: [
-        /* @__PURE__ */ jsxs(VStack, { gap: "none", className: "space-y-1 flex-1", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "overline", color: "secondary", children: label }),
-          /* @__PURE__ */ jsxs(HStack, { gap: "sm", align: "end", children: [
-            /* @__PURE__ */ jsx(Typography, { variant: "h4", className: cn("", valueSizes[size], variantColor[variant]), children: displayValue }),
-            showTrend && /* @__PURE__ */ jsx(
-              Typography,
+  return contentSurface.provide(
+    /* @__PURE__ */ jsx(
+      Box,
+      {
+        ...domPassthrough(rest),
+        className: cn(contentSurface.className, "rounded-container", 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: [
+          /* @__PURE__ */ jsxs(VStack, { gap: "none", className: "space-y-1 flex-1", children: [
+            /* @__PURE__ */ jsx(Typography, { variant: "overline", color: "secondary", children: label }),
+            /* @__PURE__ */ jsxs(HStack, { gap: "sm", align: "end", children: [
+              /* @__PURE__ */ jsx(Typography, { variant: "h4", className: cn("", valueSizes[size], variantColor[variant]), children: displayValue }),
+              showTrend && /* @__PURE__ */ jsx(
+                Typography,
+                {
+                  variant: "caption",
+                  className: cn("font-semibold pb-1", trendIsGood ? "text-success" : "text-error"),
+                  children: trendLabel
+                }
+              )
+            ] }),
+            showTarget && /* @__PURE__ */ jsx(Box, { className: "mt-2 h-1.5 w-full bg-muted rounded-full overflow-hidden", children: /* @__PURE__ */ jsx(
+              Box,
               {
-                variant: "caption",
-                className: cn("font-semibold pb-1", trendIsGood ? "text-success" : "text-error"),
-                children: trendLabel
+                className: cn("h-full rounded-full transition-all", `bg-${variant === "default" ? "primary" : variant}`),
+                style: { width: `${targetPct}%` }
               }
-            )
+            ) })
           ] }),
-          showTarget && /* @__PURE__ */ jsx(Box, { className: "mt-2 h-1.5 w-full bg-muted rounded-full overflow-hidden", children: /* @__PURE__ */ jsx(
-            Box,
-            {
-              className: cn("h-full rounded-full transition-all", `bg-${variant === "default" ? "primary" : variant}`),
-              style: { width: `${targetPct}%` }
-            }
-          ) })
-        ] }),
-        /* @__PURE__ */ jsxs(VStack, { gap: "xs", align: "end", children: [
-          ResolvedIcon && /* @__PURE__ */ jsx(Box, { className: cn("p-3 rounded-container", iconBg), children: /* @__PURE__ */ jsx(ResolvedIcon, { className: cn(iconSizes[size], iconColor) }) }),
-          sparklineData && sparklineData.length > 1 && /* @__PURE__ */ jsx(Sparkline, { data: sparklineData, color: "auto" })
+          /* @__PURE__ */ jsxs(VStack, { gap: "xs", align: "end", children: [
+            ResolvedIcon && /* @__PURE__ */ jsx(Box, { className: cn("p-3 rounded-container", iconBg), children: /* @__PURE__ */ jsx(ResolvedIcon, { className: cn(iconSizes[size], iconColor) }) }),
+            sparklineData && sparklineData.length > 1 && /* @__PURE__ */ jsx(Sparkline, { data: sparklineData, color: "auto" })
+          ] })
         ] })
-      ] })
-    }
+      }
+    )
   );
 };
 StatDisplay.displayName = "StatDisplay";
@@ -6056,12 +6455,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 +6513,8 @@ var AnimatedCounter = ({
   prefix,
   suffix,
   format,
-  className
+  className,
+  ...rest
 }) => {
   const fmt = useFormatContext();
   const ref = useRef(null);
@@ -6164,7 +6566,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 +6592,7 @@ var animatedStyles = {
   "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
   "none": {}
 };
-var AnimatedReveal = React15__default.forwardRef(
+var AnimatedReveal = React17__default.forwardRef(
   ({
     trigger = "scroll",
     animation = "fade-up",
@@ -6343,7 +6745,7 @@ function applyMorphAnimation(container, animate, duration, delay, easing) {
     el.style.opacity = animate ? "1" : "0";
   });
 }
-var AnimatedGraphic = React15__default.forwardRef(
+var AnimatedGraphic = React17__default.forwardRef(
   ({
     src,
     svgContent,
@@ -6366,7 +6768,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 = React17__default.useCallback(
       (node) => {
         containerRef.current = node;
         if (typeof ref === "function") ref(node);
@@ -6917,10 +7319,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) {