asheeui 0.6.2 → 0.6.5

package/dist/components/button/button-config.d.ts

@@ -1,10 +1,4 @@
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
-import { Color, Variant } from '../../shared/variant';
-/** Padding and font-size scale of the button. */
-export type ButtonSizeKey = Size;
-/** Corner rounding scale of the button. */
-export type ButtonRadiusKey = Radius;
+import { Color, Radius, Size, Variant } from '../../shared';
 /**
  * Theme configuration options for the Button component.
  *
@@ -12,32 +6,44 @@ export type ButtonRadiusKey = Radius;
  * component-level fallback tier of the theme cascade.
  */
 export interface ButtonConfig {
-    /** Visual style variant.
+    /**
+     * Visual style variant.
+     * Controls the background, border, and hover treatment.
      *
      * @default "bordered"
      */
     variant?: Variant;
-    /** Theme accent color.
+    /**
+     * Theme accent color.
+     * Controls the color of the button's primary visual elements.
      *
      * @default "primary"
      */
     color?: Color;
-    /** Padding and font-size scale.
+    /**
+     * Padding and font-size scale.
+     * Controls the density and text size of the button.
      *
      * @default "md"
      */
-    size?: ButtonSizeKey;
-    /** Corner rounding.
+    size?: Size;
+    /**
+     * Corner rounding.
+     * Controls the border-radius of the button.
      *
      * @default "md"
      */
-    radius?: ButtonRadiusKey;
-    /** Enables the press-down scale animation.
+    radius?: Radius;
+    /**
+     * Enables the press-down scale animation.
+     * When true, the button scales down slightly on click.
      *
      * @default true
      */
     animate?: boolean;
-    /** Makes the button stretch to fill its parent width.
+    /**
+     * Makes the button stretch to fill its parent width.
+     * When true, the button expands to 100% of its container width.
      *
      * @default false
      */
@@ -58,6 +64,8 @@ declare module "../../libs/registry" {
 }
 /**
  * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
  */
 export declare const FALLBACK_BUTTON_CONFIG: Required<ButtonConfig>;
 //# sourceMappingURL=button-config.d.ts.map

package/dist/components/button/button-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button-config.d.ts","sourceRoot":"","sources":["../../../src/components/button/button-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE3D,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC;AAEjC,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAOhD,CAAC"}
+{"version":3,"file":"button-config.d.ts","sourceRoot":"","sources":["../../../src/components/button/button-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,MAAM,EAAE,YAAY,CAAC;KACtB;CACF;AAID;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,YAAY,CAOhD,CAAC"}

package/dist/components/button/button-styles.d.ts

@@ -1,4 +1,14 @@
-import { Size } from '../../shared/size';
+import { Size } from '../../shared';
+/**
+ * CSS classes for standard button sizes.
+ * Maps size keys to Tailwind classes that control padding, height,
+ * font size, and spacing between elements.
+ */
 export declare const BUTTON_SIZE_CLASS: Record<Size, string>;
+/**
+ * CSS classes for icon-only button sizes.
+ * Maps size keys to Tailwind classes that create square buttons
+ * with consistent dimensions for icons.
+ */
 export declare const BUTTON_ICON_SIZE_CLASS: Record<Size, string>;
 //# sourceMappingURL=button-styles.d.ts.map

package/dist/components/button/button-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button-styles.d.ts","sourceRoot":"","sources":["../../../src/components/button/button-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIvD,CAAC"}
+{"version":3,"file":"button-styles.d.ts","sourceRoot":"","sources":["../../../src/components/button/button-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIlD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAIvD,CAAC"}

package/dist/components/card/Card.d.ts

@@ -1,88 +1,108 @@
 import { ElementType, HTMLAttributes, ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
 import { ImageFit, ImageRatioKey } from '../image/image-config';
-import { CardImageLoading, CardImagePosition, CardVariant } from './card-config';
+import { CardConfig, CardImageLoading, CardImagePosition } from './card-config';
+type BaseCardProps = CardConfig & Omit<HTMLAttributes<HTMLDivElement>, "title" | "children">;
 /**
  * Configuration options for the Card component.
  */
-export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "children"> {
-    /** Visual style variant.
-     *
-     * @default "bordered"
-     */
-    variant?: CardVariant;
-    /** Padding and spacing scale for inner content.
-     *
-     * @default "md"
-     */
-    size?: Size;
-    /** Corner rounding applied to the card border.
-     *
-     * @default "md"
-     */
-    radius?: Radius;
-    /** Enables the press-down scale animation when clickable.
-     *
-     * @default true
-     */
-    animate?: boolean;
-    /** Enables interactive hover effects and keyboard accessibility.
+export interface CardProps extends BaseCardProps {
+    /**
+     * Whether the card is clickable.
+     * When true, the card becomes interactive with hover and focus states.
+     * This is automatically enabled when href or onClick is provided.
      *
      * @default false
      */
     isClickable?: boolean;
-    /** Disables interactive states and dims card opacity.
+    /**
+     * Disables interactive states and dims card opacity.
+     * Disabled cards cannot be clicked or focused.
      *
      * @default false
      */
     isDisabled?: boolean;
-    /** Renders the card as a link when provided with `isClickable`. */
+    /**
+     * Renders the card as a link when provided with `isClickable`.
+     * Clicking the card navigates to this URL.
+     */
     href?: string;
-    /** Heading content rendered above the body. */
+    /**
+     * Heading content rendered above the body.
+     * Typically a string or React element.
+     */
     title?: ReactNode;
-    /** Supporting text rendered under the title. */
+    /**
+     * Supporting text rendered under the title.
+     * Typically a string providing additional context.
+     */
     description?: ReactNode;
-    /** Custom header node rendered above the title. */
+    /**
+     * Custom header node rendered above the title.
+     * Useful for adding icons, badges, or metadata.
+     */
     header?: ReactNode;
-    /** Explicit body content; falls back to `children`. */
+    /**
+     * Explicit body content; falls back to `children`.
+     * Use this when you need to explicitly set the body content.
+     */
     body?: ReactNode;
-    /** Footer node rendered at the bottom of the content column. */
+    /**
+     * Footer node rendered at the bottom of the content column.
+     * Typically used for actions or additional metadata.
+     */
     footer?: ReactNode;
-    /** Source URL of the card image. */
+    /**
+     * Source URL of the card image.
+     * When provided, displays an image in the card.
+     */
     imageSrc?: string;
-    /** Alternative text for the card image.
+    /**
+     * Alternative text for the card image.
+     * Important for accessibility.
      *
      * @default ""
      */
     imageAlt?: string;
-    /** Placement of the image relative to the content.
+    /**
+     * Placement of the image relative to the content.
+     * Determines whether the image appears at the top, bottom, or as a background.
      *
      * @default "top"
      */
     imagePosition?: CardImagePosition;
-    /** Aspect ratio of the positioned image.
+    /**
+     * Aspect ratio of the positioned image.
+     * Controls the proportional dimensions of the image container.
      *
      * @default "video"
      */
     imageRatio?: ImageRatioKey;
-    /** Object-fit strategy of the positioned image.
+    /**
+     * Object-fit strategy of the positioned image.
+     * Controls how the image fills its container.
      *
      * @default "cover"
      */
     imageFit?: ImageFit;
-    /** Native loading strategy of the positioned image.
+    /**
+     * Native loading strategy of the positioned image.
      *
      * @default "lazy"
      */
     imageLoading?: CardImageLoading;
-    /** Custom image component to render the card image with instead of
-     * the native `<img>` tag (e.g. `next/image`). */
+    /**
+     * Custom image component to render the card image with instead of
+     * the native `<img>` tag (e.g. `next/image`).
+     */
     imageComponent?: ElementType;
-    /** Additional props forwarded to `imageComponent`
-     * (e.g. `{ priority: true, sizes: "..." }`). */
+    /**
+     * Additional props forwarded to `imageComponent`
+     * (e.g. `{ priority: true, sizes: "..." }`).
+     */
     imageProps?: Record<string, unknown>;
-    /** Card body content, used when `body` is not provided. */
+    /**
+     * Card body content, used when `body` is not provided.
+     */
     children?: ReactNode;
 }
 /**
@@ -95,6 +115,10 @@ export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"
  * cascade. When `isClickable` is enabled, the card becomes keyboard
  * accessible and adopts link or button semantics based on `href`.
  *
+ * The component automatically handles accessibility attributes including
+ * role, tabIndex, aria-disabled, and proper keyboard interaction with
+ * Enter and Space keys.
+ *
  * @param props - Card configuration options and HTML div element props.
  * @param props.variant - Visual style variant. Defaults to "bordered".
  * @param props.size - Content density scale. Defaults to "md".
@@ -117,6 +141,7 @@ export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"
  * @param props.imageComponent - Custom image component.
  * @param props.imageProps - Props forwarded to the image component.
  * @param props.children - Card body content.
+ * @param props.className - Extra CSS classes for the card.
  *
  * @example
  * ```tsx
@@ -136,6 +161,23 @@ export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"
  *   );
  * }
  * ```
+ *
+ * @example
+ * ```tsx
+ * // Clickable card with image
+ * <Card
+ *   isClickable
+ *   href="/blog/post-1"
+ *   imageSrc="/images/post-1.jpg"
+ *   imageAlt="Blog post cover"
+ *   title="Blog Post Title"
+ *   description="A brief description of the blog post."
+ * />
+ * ```
+ *
+ * @see CardConfig - The configuration type for component defaults.
+ * @see useAsheeConfig - Hook for accessing the global configuration.
  */
 export declare const Card: import('react').ForwardRefExoticComponent<CardProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};
 //# sourceMappingURL=Card.d.ts.map

package/dist/components/card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EAGnB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAS9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAQvB;;GAEG;AACH,MAAM,WAAW,SACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,mDAAmD;IACnD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;qDACiD;IACjD,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B;oDACgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,IAAI,sGAkThB,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/card/Card.tsx"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,cAAc,EAGnB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAYf,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAC;AAQvB,KAAK,aAAa,GAAG,UAAU,GAC7B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AACH,eAAO,MAAM,IAAI,sGA8ShB,CAAC"}

package/dist/components/card/Card.js

@@ -1,27 +1,27 @@
 "use client";
-import { jsxs as b, jsx as l } from "react/jsx-runtime";
+import { jsxs as I, jsx as s } from "react/jsx-runtime";
 import { forwardRef as ie, useId as de } from "react";
 import { useAsheeConfig as ce } from "../../libs/context.js";
-import { RADIUS_CLASS as ue } from "../../shared/radius.js";
-import { resolveCascade as v, resolveRadiusKey as fe, resolveAnimate as me, resolveClassKey as y } from "../../utils/resolve-token.js";
-import { Image as ve } from "../image/Image.js";
+import { resolveCascade as v, resolveRadiusKey as ue, resolveAnimate as fe, resolveClassKey as y } from "../../utils/resolve-token.js";
+import { Image as me } from "../image/Image.js";
 import { FALLBACK_CARD_CONFIG as a } from "./card-config.js";
-import { CARD_PADDING_CLASS as ye, CARD_GAP_CLASS as he, CARD_HEADER_GAP_CLASS as xe, CARD_VARIANT_CLASS as G } from "./card-styles.js";
+import { CARD_PADDING_CLASS as ve, CARD_GAP_CLASS as ye, CARD_HEADER_GAP_CLASS as he, CARD_VARIANT_CLASS as G } from "./card-styles.js";
+import { RADIUS_CLASS as xe } from "../../shared/radius.js";
 import { cn as h } from "../../utils/cn.js";
-const Ae = ie(
+const ge = ie(
   ({
     variant: j,
-    size: B,
-    radius: D,
-    animate: E,
-    isClickable: K,
+    size: K,
+    radius: B,
+    animate: D,
+    isClickable: E,
     isDisabled: o = !1,
     href: d,
     title: x,
-    description: A,
-    header: I,
+    description: g,
+    header: N,
     body: V,
-    footer: N,
+    footer: b,
     imageSrc: c,
     imageAlt: w = "",
     imagePosition: F,
@@ -35,12 +35,12 @@ const Ae = ie(
     onClick: f,
     id: q,
     style: J,
-    onKeyDown: g,
+    onKeyDown: A,
     ...M
   }, Q) => {
     var k;
     const z = ce(), e = (k = z.components) == null ? void 0 : k.card, W = de(), X = q ?? W, p = v(
-      B,
+      K,
       e == null ? void 0 : e.size,
       void 0,
       a.size
@@ -49,8 +49,8 @@ const Ae = ie(
       e == null ? void 0 : e.variant,
       z.defaultVariant,
       a.variant
-    ), Z = fe(
-      D,
+    ), Z = ue(
+      B,
       e == null ? void 0 : e.radius,
       z.defaultRadius,
       a.radius
@@ -59,25 +59,25 @@ const Ae = ie(
       e == null ? void 0 : e.imagePosition,
       void 0,
       a.imagePosition
-    ), i = K ?? !!(d || f) ?? (e == null ? void 0 : e.isClickable) ?? a.isClickable, P = me(
-      E,
+    ), i = E ?? !!(d || f), P = fe(
+      D,
       e == null ? void 0 : e.animate,
       a.animate
     ), ee = y(
       p,
-      ye,
+      ve,
       a.size
     ), L = y(
       p,
-      he,
+      ye,
       a.size
     ), re = y(
       p,
-      xe,
+      he,
       a.size
     ), te = y(
       Z,
-      ue,
+      xe,
       a.radius
     ), ae = v(
       O,
@@ -91,18 +91,18 @@ const Ae = ie(
       }
       f == null || f(t), d && !t.defaultPrevented && (window.location.href = d);
     }, ne = (t) => {
-      g == null || g(t), i && !o && (t.key === "Enter" || t.key === " ") && (t.preventDefault(), R(t));
+      A == null || A(t), i && !o && (t.key === "Enter" || t.key === " ") && (t.preventDefault(), R(t));
     }, _ = (t) => {
       if (!c || C !== t) return null;
-      const s = {
+      const l = {
         top: "w-full shrink-0 rounded-b-none",
         bottom: "w-full shrink-0 order-last rounded-t-none",
         background: ""
       }[t];
       let n = { ...r ?? {} };
       if (u) {
-        const m = (r == null ? void 0 : r.loading) === "lazy", se = (r == null ? void 0 : r.priority) === !0;
-        (m || se) && console.warn(
+        const m = (r == null ? void 0 : r.loading) === "lazy", le = (r == null ? void 0 : r.priority) === !0;
+        (m || le) && console.warn(
           `[Card] ${m ? '`loading="lazy"`' : "`priority={true}`"} with custom image component may cause rendering issues. Consider using \`loading="eager"\` and removing \`priority\` for card images.`
         ), n = {
           ...n,
@@ -111,44 +111,44 @@ const Ae = ie(
           ...n.priority !== void 0 && { priority: !1 }
         };
       }
-      return /* @__PURE__ */ l(
-        ve,
+      return /* @__PURE__ */ s(
+        me,
         {
           src: c,
           alt: w,
           ratio: $ ?? "video",
           fit: H ?? "cover",
-          className: s,
+          className: l,
           imageComponent: u,
           imageProps: n,
           loading: ae
         }
       );
-    }, le = () => {
+    }, se = () => {
       if (!c || C !== "background") return null;
       const t = u || "img";
-      let s = { ...r ?? {} };
+      let l = { ...r ?? {} };
       if (u) {
         const n = (r == null ? void 0 : r.loading) === "lazy", m = (r == null ? void 0 : r.priority) === !0;
         (n || m) && console.warn(
           `[Card] ${n ? '`loading="lazy"`' : "`priority={true}`"} with custom image component may cause rendering issues. Consider using \`loading="eager"\` and removing \`priority\` for card images.`
-        ), s = {
-          ...s,
+        ), l = {
+          ...l,
           loading: "eager",
-          ...s.priority !== void 0 && { priority: !1 }
+          ...l.priority !== void 0 && { priority: !1 }
         };
       }
-      return /* @__PURE__ */ l("div", { className: "absolute inset-0 z-0 pointer-events-none", children: /* @__PURE__ */ l(
+      return /* @__PURE__ */ s("div", { className: "absolute inset-0 z-0 pointer-events-none", children: /* @__PURE__ */ s(
         t,
         {
           src: c,
           alt: w,
           className: "h-full w-full object-cover",
-          ...s
+          ...l
         }
       ) });
     }, S = V ?? U;
-    return /* @__PURE__ */ b(
+    return /* @__PURE__ */ I(
       "div",
       {
         ref: Q,
@@ -171,8 +171,8 @@ const Ae = ie(
         ...M,
         children: [
           _("top"),
-          le(),
-          /* @__PURE__ */ b(
+          se(),
+          /* @__PURE__ */ I(
             "div",
             {
               className: h(
@@ -181,20 +181,20 @@ const Ae = ie(
                 L
               ),
               children: [
-                (I || x || A) && /* @__PURE__ */ b("div", { className: h("flex flex-col z-10", re), children: [
-                  I,
-                  x && /* @__PURE__ */ l("h3", { className: "font-semibold leading-tight tracking-tight text-foreground text-lg md:text-xl", children: x }),
-                  A && /* @__PURE__ */ l("p", { className: "text-sm text-muted-foreground leading-relaxed", children: A })
+                (N || x || g) && /* @__PURE__ */ I("div", { className: h("flex flex-col z-10", re), children: [
+                  N,
+                  x && /* @__PURE__ */ s("h3", { className: "font-semibold leading-tight tracking-tight text-foreground text-lg md:text-xl", children: x }),
+                  g && /* @__PURE__ */ s("p", { className: "text-sm text-muted-foreground leading-relaxed", children: g })
                 ] }),
-                S && /* @__PURE__ */ l("div", { className: "flex-1 z-10 text-sm leading-relaxed", children: S }),
-                N && /* @__PURE__ */ l(
+                S && /* @__PURE__ */ s("div", { className: "flex-1 z-10 text-sm leading-relaxed", children: S }),
+                b && /* @__PURE__ */ s(
                   "div",
                   {
                     className: h(
                       "flex items-center justify-between z-10 mt-auto pt-2",
                       L
                     ),
-                    children: N
+                    children: b
                   }
                 )
               ]
@@ -206,7 +206,7 @@ const Ae = ie(
     );
   }
 );
-Ae.displayName = "Card";
+ge.displayName = "Card";
 export {
-  Ae as Card
+  ge as Card
 };

package/dist/components/card/card-config.d.ts

@@ -1,5 +1,4 @@
-import { Radius } from '../../shared/radius';
-import { Size } from '../../shared/size';
+import { Radius, Size } from '../../shared';
 import { ImageFit, ImageRatioKey } from '../image/image-config';
 /**
  * Visual style of the card.
@@ -10,9 +9,16 @@ import { ImageFit, ImageRatioKey } from '../image/image-config';
  * - `ghost`: Transparent background without a border.
  */
 export type CardVariant = "elevated" | "bordered" | "flat" | "ghost";
-/** Placement of the card image relative to the content. */
+/**
+ * Placement of the card image relative to the content.
+ * "top" and "bottom" place the image above or below the content.
+ * "background" places the image as a full-bleed background layer.
+ */
 export type CardImagePosition = "top" | "bottom" | "background";
-/** Native image loading strategy. */
+/**
+ * Native image loading strategy.
+ * Controls when the browser loads the image resource.
+ */
 export type CardImageLoading = "lazy" | "eager";
 /**
  * Theme configuration options for the Card component.
@@ -21,47 +27,57 @@ export type CardImageLoading = "lazy" | "eager";
  * component-level fallback tier of the theme cascade.
  */
 export interface CardConfig {
-    /** Visual style variant.
+    /**
+     * Visual style variant.
+     * Controls the card's background, border, and shadow treatment.
      *
      * @default "bordered"
      */
     variant?: CardVariant;
-    /** Content padding and spacing scale.
+    /**
+     * Content padding and spacing scale.
+     * Controls the density of the card's internal spacing.
      *
      * @default "md"
      */
     size?: Size;
-    /** Corner rounding.
+    /**
+     * Corner rounding.
+     * Controls the border-radius of the card.
      *
      * @default "md"
      */
     radius?: Radius;
-    /** Placement of the card image.
+    /**
+     * Placement of the card image.
+     * Determines where the image appears relative to the content.
      *
      * @default "top"
      */
     imagePosition?: CardImagePosition;
-    /** Aspect ratio of the positioned image.
+    /**
+     * Aspect ratio of the positioned image.
+     * Controls the proportional dimensions of the image container.
      *
      * @default "video"
      */
     imageRatio?: ImageRatioKey;
-    /** Object-fit strategy of the positioned image.
+    /**
+     * Object-fit strategy of the positioned image.
+     * Controls how the image fills its container.
      *
      * @default "cover"
      */
     imageFit?: ImageFit;
-    /** Native loading strategy of the positioned image.
+    /**
+     * Native loading strategy of the positioned image.
      *
      * @default "lazy"
      */
     imageLoading?: CardImageLoading;
-    /** Enables interactive hover and keyboard behaviour.
-     *
-     * @default false
-     */
-    isClickable?: boolean;
-    /** Enables the press animation when clickable.
+    /**
+     * Enables the press animation when clickable.
+     * When true, the card scales down slightly on click.
      *
      * @default true
      */
@@ -81,6 +97,8 @@ declare module "../../libs/registry" {
 }
 /**
  * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
  */
 export declare const FALLBACK_CARD_CONFIG: {
     readonly size: "md";
@@ -90,7 +108,6 @@ export declare const FALLBACK_CARD_CONFIG: {
     readonly imageRatio: "video";
     readonly imageFit: "cover";
     readonly imageLoading: "lazy";
-    readonly isClickable: false;
     readonly animate: true;
 };
 //# sourceMappingURL=card-config.d.ts.map

package/dist/components/card/card-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-config.d.ts","sourceRoot":"","sources":["../../../src/components/card/card-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEhE,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAO/B,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,IAAI,EAAE,UAAU,CAAC;KAClB;CACF;AAID;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;CAUvB,CAAC"}
+{"version":3,"file":"card-config.d.ts","sourceRoot":"","sources":["../../../src/components/card/card-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAM/B,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,IAAI,EAAE,UAAU,CAAC;KAClB;CACF;AAID;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CASvB,CAAC"}