@cdx-ui/components 0.0.1-beta.79 → 0.0.1-beta.80

package/lib/commonjs/animation/hooks/index.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _useCombinedAnimationDisabledState = require("./useCombinedAnimationDisabledState");
+Object.keys(_useCombinedAnimationDisabledState).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useCombinedAnimationDisabledState[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useCombinedAnimationDisabledState[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/animation/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_useCombinedAnimationDisabledState","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get"],"sourceRoot":"../../../../src","sources":["animation/hooks/index.ts"],"mappings":";;;;;AAAA,IAAAA,kCAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,kCAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,kCAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,kCAAA,CAAAK,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/animation/hooks/useCombinedAnimationDisabledState.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useCombinedAnimationDisabledState = useCombinedAnimationDisabledState;
+var _animationSettings = require("../../providers/animation-settings");
+var _utils = require("../utils");
+/**
+ * Hook to combine global, parent, and own animation disabled states
+ *
+ * @description
+ * This hook combines three sources of animation disabled state:
+ * 1. Global state from GlobalAnimationSettingsProvider
+ * 2. Parent state from AnimationSettingsContext (component tree cascading)
+ * 3. Own state from the component's animation prop
+ *
+ * Priority: Global > Parent > Own (global wins if enabled)
+ *
+ * @param animation - Root animation configuration for the component
+ * @returns Combined isAllAnimationsDisabled value
+ *
+ * @example
+ * ```tsx
+ * const isAllAnimationsDisabled = useCombinedAnimationDisabledState(animation);
+ * ```
+ */
+function useCombinedAnimationDisabledState(animation) {
+  // Get global animation disabled state
+  const {
+    globalIsAllAnimationsDisabled
+  } = (0, _animationSettings.useGlobalAnimationSettings)();
+
+  // Read parent animation disabled state from global context
+  const parentAnimationSettingsContext = (0, _animationSettings.useAnimationSettings)();
+  const parentIsAllAnimationsDisabled = parentAnimationSettingsContext?.isAllAnimationsDisabled;
+
+  // Get own animation disabled state
+  const {
+    isAllAnimationsDisabled: ownIsAllAnimationsDisabled
+  } = (0, _utils.getRootAnimationState)(animation);
+
+  // Combine global, parent, and own disable-all states (global > parent > own)
+  return (0, _utils.getCombinedAnimationDisabledState)({
+    globalIsAllAnimationsDisabled,
+    parentIsAllAnimationsDisabled,
+    ownIsAllAnimationsDisabled
+  });
+}
+//# sourceMappingURL=useCombinedAnimationDisabledState.js.map

package/lib/commonjs/animation/hooks/useCombinedAnimationDisabledState.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_animationSettings","require","_utils","useCombinedAnimationDisabledState","animation","globalIsAllAnimationsDisabled","useGlobalAnimationSettings","parentAnimationSettingsContext","useAnimationSettings","parentIsAllAnimationsDisabled","isAllAnimationsDisabled","ownIsAllAnimationsDisabled","getRootAnimationState","getCombinedAnimationDisabledState"],"sourceRoot":"../../../../src","sources":["animation/hooks/useCombinedAnimationDisabledState.ts"],"mappings":";;;;;;AAAA,IAAAA,kBAAA,GAAAC,OAAA;AAKA,IAAAC,MAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,iCAAiCA,CAC/CC,SAA6C,EACpC;EACT;EACA,MAAM;IAAEC;EAA8B,CAAC,GAAG,IAAAC,6CAA0B,EAAC,CAAC;;EAEtE;EACA,MAAMC,8BAA8B,GAAG,IAAAC,uCAAoB,EAAC,CAAC;EAC7D,MAAMC,6BAA6B,GAAGF,8BAA8B,EAAEG,uBAAuB;;EAE7F;EACA,MAAM;IAAEA,uBAAuB,EAAEC;EAA2B,CAAC,GAAG,IAAAC,4BAAqB,EAACR,SAAS,CAAC;;EAEhG;EACA,OAAO,IAAAS,wCAAiC,EAAC;IACvCR,6BAA6B;IAC7BI,6BAA6B;IAC7BE;EACF,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/commonjs/animation/index.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+var _hooks = require("./hooks");
+Object.keys(_hooks).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _hooks[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _hooks[key];
+    }
+  });
+});
+var _utils = require("./utils");
+Object.keys(_utils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _utils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _utils[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/commonjs/animation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_types","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_hooks","_utils"],"sourceRoot":"../../../src","sources":["animation/index.ts"],"mappings":";;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,MAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,MAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,MAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,MAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,MAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,MAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,MAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,MAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,MAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,MAAA,CAAAN,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/lib/commonjs/animation/types.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=types.js.map

package/lib/commonjs/animation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["animation/types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/animation/utils.js

@@ -0,0 +1,223 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAnimationState = getAnimationState;
+exports.getAnimationValueMergedConfig = getAnimationValueMergedConfig;
+exports.getAnimationValueProperty = getAnimationValueProperty;
+exports.getCombinedAnimationDisabledState = getCombinedAnimationDisabledState;
+exports.getIsAnimationDisabledValue = getIsAnimationDisabledValue;
+exports.getRootAnimationState = getRootAnimationState;
+exports.isAnimationDisabled = isAnimationDisabled;
+exports.shouldDisableAll = shouldDisableAll;
+/**
+ * Check if the entire animation is disabled
+ * @param animation - Animation configuration
+ * @returns true if animation is disabled
+ */
+function isAnimationDisabled(animation) {
+  // Check top-level disabled values
+  if (animation === false || animation === 'disabled') {
+    return true;
+  }
+
+  // Check state property in config objects
+  if (typeof animation === 'object' && animation !== null && 'state' in animation) {
+    const state = animation.state;
+    return state === false || state === 'disabled';
+  }
+  return false;
+}
+
+/**
+ * Check if root animation should cascade disable to all children
+ * @param animation - Root animation configuration
+ * @returns true if all animations should be disabled (including children)
+ */
+function shouldDisableAll(animation) {
+  // Check top-level disable-all value
+  if (animation === 'disable-all') {
+    return true;
+  }
+
+  // Check state property in config objects
+  if (typeof animation === 'object' && animation !== null && 'state' in animation) {
+    const state = animation.state;
+    return state === 'disable-all';
+  }
+  return false;
+}
+
+/**
+ * Get animation state including config and disabled status
+ * @param animation - Animation configuration
+ * @returns Object with animationConfig and isAnimationDisabled
+ */
+function getAnimationState(animation) {
+  const isDisabled = isAnimationDisabled(animation);
+  // Always extract config when it's an object, regardless of disabled state
+  // This allows users to customize colors/properties even when animations are disabled
+  const config = typeof animation === 'object' && animation !== null ? animation : undefined;
+  return {
+    animationConfig: config,
+    isAnimationDisabled: isDisabled
+  };
+}
+
+/**
+ * Get root animation state including config, disabled status, and cascade flag
+ * @param animation - Root animation configuration
+ * @returns Object with animationConfig, isAnimationDisabled, and isAllAnimationsDisabled
+ */
+function getRootAnimationState(animation) {
+  const shouldCascade = shouldDisableAll(animation);
+  const isDisabled = isAnimationDisabled(animation) || shouldCascade;
+  // Always extract config when it's an object, regardless of disabled state
+  // This allows users to customize colors/properties even when animations are disabled
+  const config = typeof animation === 'object' && animation !== null ? animation : undefined;
+  return {
+    animationConfig: config,
+    isAnimationDisabled: isDisabled,
+    isAllAnimationsDisabled: shouldCascade
+  };
+}
+
+/**
+ * Get animation value property or return default
+ * Extracts a property from the animation value config object
+ *
+ * @param options - Object containing animationValue, property, and defaultValue
+ * @param options.animationValue - The animation value configuration
+ * @param options.property - Property name to extract
+ * @param options.defaultValue - Default value if property is not found
+ * @returns The property value or default (never undefined)
+ *
+ * @example
+ * const scaleValue = getAnimationValueProperty({
+ *   animationValue: animation?.scale,
+ *   property: 'value',
+ *   defaultValue: 0.95
+ * });
+ */
+function getAnimationValueProperty(options) {
+  // If animation value is undefined, return default
+  if (options.animationValue === undefined) {
+    return options.defaultValue;
+  }
+
+  // Return the property value if it exists, otherwise return default
+  return options.animationValue[options.property] ?? options.defaultValue;
+}
+
+/**
+ * Get animation value merged config or return default
+ * Merges the animation value config with defaults, useful when you need multiple properties
+ *
+ * @param options - Object containing animationValue, property, and defaultValue
+ * @param options.animationValue - The animation value configuration
+ * @param options.property - Property name to extract from the config
+ * @param options.defaultValue - Default configuration object
+ * @returns The merged config object or default
+ *
+ * @example
+ * const scaleConfig = getAnimationValueMergedConfig({
+ *   animationValue: animation?.scale,
+ *   property: 'timingConfig',
+ *   defaultValue: { duration: 150 }
+ * });
+ */
+function getAnimationValueMergedConfig(options) {
+  // If animation value is undefined, return default
+  if (options.animationValue === undefined) {
+    return options.defaultValue;
+  }
+  const value = options.animationValue[options.property];
+
+  // If the specific property value is undefined or not an object, return default
+  if (value === undefined || typeof value !== 'object') {
+    return options.defaultValue;
+  }
+
+  // Merge with defaults to ensure all properties exist
+  return {
+    ...options.defaultValue,
+    ...value
+  };
+}
+
+/**
+ * Determine if animations should be disabled based on disabled flags
+ * Priority: isAllAnimationsDisabled > isAnimationDisabled
+ *
+ * @param options - Object containing isAnimationDisabled and isAllAnimationsDisabled
+ * @param options.isAnimationDisabled - Whether animation is explicitly disabled
+ * @param options.isAllAnimationsDisabled - Whether all animations should be disabled (cascading from root/global)
+ * @returns true if animations should be disabled, false otherwise
+ *
+ * @example
+ * const isDisabled = getIsAnimationDisabledValue({
+ *   isAnimationDisabled: false,
+ *   isAllAnimationsDisabled: true
+ * });
+ * // Returns: true (all animations disabled takes priority)
+ */
+function getIsAnimationDisabledValue(options) {
+  const {
+    isAnimationDisabled: isDisabled,
+    isAllAnimationsDisabled
+  } = options;
+
+  // First priority: if all animations are disabled, return true
+  if (isAllAnimationsDisabled === true) {
+    return true;
+  }
+
+  // Second priority: if this animation is disabled, return true
+  if (isDisabled) {
+    return true;
+  }
+
+  // Default: animations are enabled
+  return false;
+}
+
+/**
+ * Combine global, parent, and own animation disabled states
+ * Priority: Global > Parent > Own (global wins if enabled)
+ *
+ * @param options - Object containing globalIsAllAnimationsDisabled, parentIsAllAnimationsDisabled, and ownIsAllAnimationsDisabled
+ * @param options.globalIsAllAnimationsDisabled - Whether global provider has disable-all (from GlobalAnimationSettingsProvider)
+ * @param options.parentIsAllAnimationsDisabled - Whether parent context has disable-all (from AnimationSettingsContext)
+ * @param options.ownIsAllAnimationsDisabled - Whether own animation prop has disable-all
+ * @returns Combined isAllAnimationsDisabled value (global || parent || own)
+ *
+ * @example
+ * const combined = getCombinedAnimationDisabledState({
+ *   globalIsAllAnimationsDisabled: true,
+ *   parentIsAllAnimationsDisabled: false,
+ *   ownIsAllAnimationsDisabled: false
+ * });
+ * // Returns: true (global wins)
+ */
+function getCombinedAnimationDisabledState(options) {
+  const {
+    globalIsAllAnimationsDisabled,
+    parentIsAllAnimationsDisabled,
+    ownIsAllAnimationsDisabled
+  } = options;
+
+  // Global always wins if it has disable-all
+  if (globalIsAllAnimationsDisabled === true) {
+    return true;
+  }
+
+  // Parent wins if it has disable-all
+  if (parentIsAllAnimationsDisabled === true) {
+    return true;
+  }
+
+  // Otherwise use own value
+  return ownIsAllAnimationsDisabled;
+}
+//# sourceMappingURL=utils.js.map

package/lib/commonjs/animation/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isAnimationDisabled","animation","state","shouldDisableAll","getAnimationState","isDisabled","config","undefined","animationConfig","getRootAnimationState","shouldCascade","isAllAnimationsDisabled","getAnimationValueProperty","options","animationValue","defaultValue","property","getAnimationValueMergedConfig","value","getIsAnimationDisabledValue","getCombinedAnimationDisabledState","globalIsAllAnimationsDisabled","parentIsAllAnimationsDisabled","ownIsAllAnimationsDisabled"],"sourceRoot":"../../../src","sources":["animation/utils.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/components/CLAUDE.md

@@ -120,7 +120,7 @@ Where: **styled layer.** Pure styling hint with no behavior or a11y semantics
 Each component follows this structure (see `Button/index.tsx`):
 
 1. **Imports** — RN base components, primitive `Root` and `Slot` from `@cdx-ui/primitives`, `cn` + style context from `@cdx-ui/utils`, variant functions from `./styles`
-2. **Scope constant** — `const SCOPE = 'COMPONENT_NAME'` for `withStyleContext` / `useStyleContext` (or a `ParentContext.Provider` wrapper for static variant context)
+2. **Scope constant** — `const SCOPE = 'COMPONENT_NAME'` for `useStyleContext` with a `ParentContext.Provider` wrapper for static variant context
 3. **Root component** — renders the primitive Root (or a host element directly when no primitive exists), spreads `dataAttributes({ slot: '<component>' })`
 4. **Sub-slots** — each accepts `asChild`, renders a host element via `const Comp = asChild ? Slot : DefaultElement`, spreads `dataAttributes({ slot: '<component>-<slot>' })`. Sub-slots **do not** call `useButtonContext()` (or its equivalent) unless their own styling reacts to interaction state.
 5. **Position-aware sub-slots** — icon/spinner-style slots accept `position?: 'leading' | 'trailing'` and emit `data-icon` via `dataAttributes({ icon: '...' })`.

package/lib/commonjs/components/Card/index.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.Card = void 0;
 var _react = require("react");
 var _reactNative = require("react-native");
+var _primitives = require("@cdx-ui/primitives");
 var _utils = require("@cdx-ui/utils");
 var _styles = require("./styles");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -13,25 +14,36 @@ var _jsxRuntime = require("react/jsx-runtime");
 // STYLED ROOT COMPONENT
 // =============================================================================
 const SCOPE = 'CARD';
-const Root = (0, _utils.withStyleContext)(_reactNative.View, SCOPE);
 const useCardStyleContext = () => (0, _utils.useStyleContext)(SCOPE);
 const CardRoot = /*#__PURE__*/(0, _react.forwardRef)(({
+  asChild,
   className,
   children,
   style,
   fullBleed,
   ...props
 }, ref) => {
-  const computedClassName = (0, _utils.cn)((0, _styles.cardRootVariants)(), className);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Root, {
-    ref: ref,
-    className: computedClassName,
-    style: style,
-    context: {
+  const parent = (0, _utils.useParentContext)();
+  const ctx = (0, _react.useMemo)(() => ({
+    ...parent,
+    [SCOPE]: {
       fullBleed
-    },
-    ...props,
-    children: children
+    }
+  }), [parent, fullBleed]);
+  const computedClassName = (0, _utils.cn)((0, _styles.cardRootVariants)(), className);
+  const Comp = asChild ? _primitives.Slot : _reactNative.View;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_utils.ParentContext.Provider, {
+    value: ctx,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Comp, {
+      ref: ref,
+      className: computedClassName,
+      style: style,
+      ...props,
+      ...(0, _primitives.mergeDataAttributes)(props, (0, _primitives.dataAttributes)({
+        slot: 'card'
+      })),
+      children: children
+    })
   });
 });
 CardRoot.displayName = 'Card';
@@ -41,17 +53,22 @@ CardRoot.displayName = 'Card';
 // =============================================================================
 
 const CardHeader = /*#__PURE__*/(0, _react.forwardRef)(({
+  asChild,
   className,
   children,
   style,
   ...props
 }, ref) => {
   const computedClassName = (0, _utils.cn)((0, _styles.cardHeaderVariants)(), className);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+  const Comp = asChild ? _primitives.Slot : _reactNative.View;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Comp, {
     ref: ref,
     className: computedClassName,
     style: style,
     ...props,
+    ...(0, _primitives.mergeDataAttributes)(props, (0, _primitives.dataAttributes)({
+      slot: 'card-header'
+    })),
     children: children
   });
 });
@@ -62,6 +79,7 @@ CardHeader.displayName = 'Card.Header';
 // =============================================================================
 
 const CardContent = /*#__PURE__*/(0, _react.forwardRef)(({
+  asChild,
   className,
   children,
   style,
@@ -74,11 +92,15 @@ const CardContent = /*#__PURE__*/(0, _react.forwardRef)(({
   const computedClassName = (0, _utils.cn)((0, _styles.cardContentVariants)({
     fullBleed: fullBleed ?? fullBleedFromContext
   }), className);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+  const Comp = asChild ? _primitives.Slot : _reactNative.View;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Comp, {
     ref: ref,
     className: computedClassName,
     style: style,
     ...props,
+    ...(0, _primitives.mergeDataAttributes)(props, (0, _primitives.dataAttributes)({
+      slot: 'card-content'
+    })),
     children: children
   });
 });
@@ -89,6 +111,7 @@ CardContent.displayName = 'Card.Content';
 // =============================================================================
 
 const CardFooter = /*#__PURE__*/(0, _react.forwardRef)(({
+  asChild,
   className,
   children,
   style,
@@ -101,11 +124,15 @@ const CardFooter = /*#__PURE__*/(0, _react.forwardRef)(({
   const computedClassName = (0, _utils.cn)((0, _styles.cardFooterVariants)({
     fullBleed: fullBleed ?? fullBleedFromContext
   }), className);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+  const Comp = asChild ? _primitives.Slot : _reactNative.View;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Comp, {
     ref: ref,
     className: computedClassName,
     style: style,
     ...props,
+    ...(0, _primitives.mergeDataAttributes)(props, (0, _primitives.dataAttributes)({
+      slot: 'card-footer'
+    })),
     children: children
   });
 });
@@ -115,8 +142,9 @@ CardFooter.displayName = 'Card.Footer';
 // COMPOUND COMPONENT
 // =============================================================================
 
-const Card = exports.Card = CardRoot;
-Card.Header = CardHeader;
-Card.Content = CardContent;
-Card.Footer = CardFooter;
+const Card = exports.Card = Object.assign(CardRoot, {
+  Header: CardHeader,
+  Content: CardContent,
+  Footer: CardFooter
+});
 //# sourceMappingURL=index.js.map

package/lib/commonjs/components/Card/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","_utils","_styles","_jsxRuntime","SCOPE","Root","withStyleContext","View","useCardStyleContext","useStyleContext","CardRoot","forwardRef","className","children","style","fullBleed","props","ref","computedClassName","cn","cardRootVariants","jsx","context","displayName","CardHeader","cardHeaderVariants","CardContent","fullBleedFromContext","cardContentVariants","CardFooter","cardFooterVariants","Card","exports","Header","Content","Footer"],"sourceRoot":"../../../../src","sources":["components/Card/index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNative","_primitives","_utils","_styles","_jsxRuntime","SCOPE","useCardStyleContext","useStyleContext","CardRoot","forwardRef","asChild","className","children","style","fullBleed","props","ref","parent","useParentContext","ctx","useMemo","computedClassName","cn","cardRootVariants","Comp","Slot","View","jsx","ParentContext","Provider","value","mergeDataAttributes","dataAttributes","slot","displayName","CardHeader","cardHeaderVariants","CardContent","fullBleedFromContext","cardContentVariants","CardFooter","cardFooterVariants","Card","exports","Object","assign","Header","Content","Footer"],"sourceRoot":"../../../../src","sources":["components/Card/index.tsx"],"mappings":"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","ignoreList":[]}