@almadar/ui 3.5.0 → 3.5.1

package/dist/avl/index.cjs

@@ -11041,38 +11041,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsxRuntime.jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/avl/index.js

@@ -10995,38 +10995,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/components/index.cjs

@@ -6398,38 +6398,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    exports.Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsxRuntime.jsx(exports.Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsxRuntime.jsx(exports.Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/components/index.js

@@ -6353,38 +6353,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/components/organisms/ComponentPatterns.d.ts

@@ -9,7 +9,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type ButtonVariant, type ButtonSize } from '../atoms/Button';
+import type { EventKey, EventPayload } from '@almadar/core';
+import { type ButtonProps } from '../atoms/Button';
 import { type BadgeVariant } from '../atoms/Badge';
 import { type AlertVariant } from '../molecules/Alert';
 import { type MapViewProps } from '../molecules/MapView';
@@ -22,36 +23,54 @@ interface ClosedCircuitProps {
     error?: Error | null;
     entity?: string;
 }
-export interface ButtonPatternProps extends ClosedCircuitProps {
-    label: string;
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    disabled?: boolean;
-    onClick?: string;
-    event?: string;
-    icon?: string;
+/**
+ * Props for {@link ButtonPattern}. A thin pass-through over the Button
+ * atom: accepts every Button prop plus wrapper-level aliases for the
+ * `.orb` schema convention (`action`/`event`/`onClick` as string
+ * event names, `iconPosition` for left/right icon placement).
+ *
+ * Anything not explicitly named is forwarded to `<Button>` via rest-spread,
+ * so a future Button prop lands automatically without needing a wrapper
+ * edit. This is the contract that fixes VG17: `action: EventKey` flows
+ * through to Button, which owns both `UI:{action}` emit AND the
+ * `data-testid="action-{NAME}"` attribute the verifier selects on.
+ */
+export interface ButtonPatternProps extends Omit<ButtonProps, 'onClick'>, ClosedCircuitProps {
+    /** Legacy alias for {@link ButtonProps.action} (string event name). */
+    onClick?: EventKey;
+    /** Legacy alias for {@link ButtonProps.action}. */
+    event?: EventKey;
+    /** Icon placement — maps to Button's `icon` (left) or `iconRight` (right). */
     iconPosition?: 'left' | 'right';
-    className?: string;
 }
 /**
- * Button pattern that emits events via the event bus.
+ * Button pattern — thin pass-through to the Button atom.
+ *
+ * Prior to VG17 this wrapper owned a local event-bus emit and
+ * hand-enumerated only a narrow slice of props, silently dropping
+ * every prop outside that list (including the Pre-Phase `action:
+ * EventKey`). The atom already handles emit + data-testid via its
+ * `action` prop, so the wrapper simply forwards everything.
  */
-export declare function ButtonPattern({ label, variant, size, disabled, onClick, event, icon, iconPosition, className, }: ButtonPatternProps): React.ReactElement;
+export declare function ButtonPattern({ action, onClick, event, icon, iconPosition, ...rest }: ButtonPatternProps): React.ReactElement;
 export declare namespace ButtonPattern {
     var displayName: string;
 }
-export interface IconButtonPatternProps extends ClosedCircuitProps {
+export interface IconButtonPatternProps extends Omit<ButtonProps, 'onClick'>, ClosedCircuitProps {
     icon: string;
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    onClick?: string;
     ariaLabel?: string;
-    className?: string;
+    /** Legacy alias for {@link ButtonProps.action}. */
+    onClick?: EventKey;
+    /** Legacy alias for {@link ButtonProps.action}. */
+    event?: EventKey;
 }
 /**
- * Icon-only button pattern.
+ * Icon-only button pattern — pass-through to the Button atom with a
+ * mandatory icon and optional aria-label. Same VG17 fix as
+ * {@link ButtonPattern}: `action` forwards to the atom, which owns the
+ * emit + data-testid.
  */
-export declare function IconButtonPattern({ icon, variant, size, onClick, ariaLabel, className, }: IconButtonPatternProps): React.ReactElement;
+export declare function IconButtonPattern({ action, onClick, event, icon, ariaLabel, variant, ...rest }: IconButtonPatternProps): React.ReactElement;
 export declare namespace IconButtonPattern {
     var displayName: string;
 }
@@ -59,13 +78,24 @@ export interface LinkPatternProps extends ClosedCircuitProps {
     label: string;
     href?: string;
     external?: boolean;
-    onClick?: string;
+    /** Event key emitted on click (intercepts native navigation when set). */
+    action?: EventKey;
+    /** Legacy alias for action. */
+    onClick?: EventKey;
+    /** Legacy alias for action. */
+    event?: EventKey;
+    /** Payload for the dispatched event. */
+    actionPayload?: EventPayload;
     className?: string;
 }
 /**
- * Link pattern for navigation.
+ * Link pattern for navigation. When an event key is provided via
+ * `action` / `onClick` / `event`, intercepts the native `<a>`
+ * navigation and emits `UI:{action}` with the `href` in the payload.
+ * Sets `data-testid="action-{NAME}"` so the verifier's click-path
+ * gate can select it symmetrically with Button.
  */
-export declare function LinkPattern({ label, href, external, onClick, className, }: LinkPatternProps): React.ReactElement;
+export declare function LinkPattern({ label, href, external, action, onClick, event, actionPayload, className, }: LinkPatternProps): React.ReactElement;
 export declare namespace LinkPattern {
     var displayName: string;
 }

package/dist/providers/index.cjs

@@ -8029,38 +8029,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsxRuntime.jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/providers/index.js

@@ -7984,38 +7984,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/runtime/index.cjs

@@ -8166,38 +8166,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxRuntime.jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsxRuntime.jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/dist/runtime/index.js

@@ -8121,38 +8121,16 @@ var init_MapView = __esm({
   }
 });
 function ButtonPattern({
-  label,
-  variant = "primary",
-  size = "md",
-  disabled = false,
+  action,
   onClick,
   event,
   icon,
-  iconPosition = "left",
-  className
+  iconPosition,
+  ...rest
 }) {
-  const { emit } = useEventBus();
-  const eventName = onClick ?? event;
-  const handleClick = () => {
-    if (eventName && !disabled) {
-      emit(`UI:${eventName}`, {});
-    }
-  };
-  return /* @__PURE__ */ jsxs(
-    Button,
-    {
-      variant,
-      size,
-      disabled,
-      onClick: handleClick,
-      className,
-      children: [
-        icon && iconPosition === "left" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" }),
-        label,
-        icon && iconPosition === "right" && /* @__PURE__ */ jsx(Icon, { name: icon, size: "sm" })
-      ]
-    }
-  );
+  const resolvedAction = action ?? onClick ?? event;
+  const iconProps = iconPosition === "right" ? { iconRight: icon } : { icon };
+  return /* @__PURE__ */ jsx(Button, { ...rest, action: resolvedAction, ...iconProps });
 }
 function TextPattern({
   content,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -152,6 +152,8 @@
   },
   "devDependencies": {
     "@almadar/eslint-plugin": ">=2.3.0",
+    "@react-three/drei": "^10.7.7",
+    "@react-three/fiber": "^9.6.0",
     "@react-three/postprocessing": "3.0.4",
     "@storybook/addon-docs": "^10.2.6",
     "@storybook/addon-links": "^10.2.6",
@@ -185,6 +187,7 @@
     "react-router-dom": "^7.13.0",
     "storybook": "^10.2.6",
     "tailwindcss": "^3.4.0",
+    "three": "^0.160.1",
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",
     "typescript": "^5.4.0",