@colorffy/ui 1.0.0

package/dist/types/alert.d.ts

@@ -0,0 +1,46 @@
+export type AlertType = 'banner' | 'tonal' | 'snackbar';
+export type AlertVariant = 'primary' | 'secondary' | 'accent' | 'neutral' | 'success' | 'warning' | 'danger' | 'transparent' | 'default';
+export type AlertSize = 'sm';
+export type AlertClassName = string | string[] | Record<string, boolean>;
+export interface IToastOptions {
+    message?: string;
+    variant?: AlertVariant;
+}
+/**
+ * Interface props for the Alert component.
+ * Notes:
+ * - Prefer optional props over explicit null unions.
+ * - `type` controls surface (banner | tonal | snackbar), `variant` controls intent (primary | success | warning | danger | etc.).
+ * - Use `size` for scalable sizing ('sm').
+ */
+export interface IAlertProps {
+    /**
+     * Optional title of the alert.
+     */
+    title?: string;
+    /**
+     * Optional message of the alert.
+     */
+    message?: string;
+    /**
+     * Surface style of the alert.
+     */
+    type?: AlertType;
+    /**
+     * Variant color of the alert.
+     */
+    variant?: AlertVariant;
+    /**
+     * Scalable size of the alert. Only 'sm' is supported.
+     */
+    size?: AlertSize | undefined;
+    /**
+     * Marks the alert as critical.
+     */
+    critical?: boolean;
+    /**
+     * Custom classes to apply to the root element.
+     */
+    customClass?: AlertClassName;
+}
+//# sourceMappingURL=alert.d.ts.map

package/dist/types/alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/types/alert.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;AACvD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAA;AACxI,MAAM,MAAM,SAAS,GAAG,IAAI,CAAA;AAC5B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACxE,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,CAAA;CAC7B"}

package/dist/types/avatar.d.ts

@@ -0,0 +1,16 @@
+export type AvatarMaskShape = 'arch' | 'pill' | 'sunny' | 'gem' | 'cookie-6' | 'cookie-9' | 'cookie-12' | 'clover-4' | 'clover-8' | 'bum';
+export interface IAvatarProps {
+    src?: string;
+    size?: 'sm' | 'md' | 'lg' | 'navbar' | 'menu';
+    initials?: string | null;
+    /**
+     * Apply a mask shape to the avatar
+     */
+    maskShape?: AvatarMaskShape | null;
+    /**
+     * Stretch the mask size to 115%
+     * @default false
+     */
+    maskStretch?: boolean;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/types/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/types/avatar.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,KAAK,GACL,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,GACV,UAAU,GACV,KAAK,CAAA;AAEX,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB"}

package/dist/types/badge.d.ts

@@ -0,0 +1,47 @@
+export type BadgeClassName = string | string[] | Record<string, boolean>;
+export type BadgeVariant = 'primary' | 'secondary' | 'accent' | 'neutral' | 'success' | 'warning' | 'danger' | 'gradient' | 'default' | 'outline' | `tonal tonal-${'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'danger'}` | string;
+export type BadgeSize = 'sm';
+/**
+ * Interface props for the Badge component.
+ * Notes:
+ * - Prefer intent-like variants; legacy strings stay supported.
+ * - Use `size` for scalable sizing ('sm').
+ * - Use `pill` to enable fully rounded capsule style.
+ */
+export interface IBadgeProps {
+    /**
+     * Optional text of the badge. Can be a string or null.
+     */
+    text?: string | null;
+    /**
+     * Variant/style preset.
+     * Prefer intent names (primary/secondary/accent/neutral/success/warning/danger)
+     * or documented tonal forms. Legacy strings still supported.
+     */
+    variant?: BadgeVariant | undefined;
+    /**
+     * Optional icon of the badge. Can be a string or null.
+     */
+    iconCode?: string | null;
+    /**
+     * Optional custom class for the icon within the badge. Accepts string, array, or object map.
+     */
+    iconClass?: BadgeClassName | null;
+    /**
+     * Optional inline styles for the icon within the badge.
+     */
+    iconStyle?: string | Record<string, any> | null;
+    /**
+     * Scalable size of the badge. Only 'sm' is supported.
+     */
+    size?: BadgeSize | string | undefined;
+    /**
+     * Fully rounded capsule style.
+     */
+    pill?: boolean | null;
+    /**
+     * Optional custom class for the badge. Accepts string, array, or object map.
+     */
+    customClass?: BadgeClassName | null;
+}
+//# sourceMappingURL=badge.d.ts.map

package/dist/types/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/types/badge.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACxE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,eAAe,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAA;AACnP,MAAM,MAAM,SAAS,GAAG,IAAI,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;IAE/C;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;IAErC;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CACpC"}

package/dist/types/button.d.ts

@@ -0,0 +1,115 @@
+export type ButtonClassName = string | string[] | Record<string, boolean>;
+export type ButtonVariant = 'filled' | 'tonal' | 'outline' | 'text' | 'link' | 'chip' | 'cta' | 'gradient' | 'frosted';
+export type ButtonColor = 'primary' | 'secondary' | 'accent' | 'neutral' | 'success' | 'warning' | 'danger' | 'transparent';
+export type ButtonSizeLevel = 'sm' | 'md' | 'lg';
+/**
+ * Interface props for the Button component.
+ * Notes:
+ * - Use `variant` (filled | tonal | outline | text | link | chip | cta | gradient | frosted) for style and `color` (primary | warning | etc.) for intent.
+ * - Preferred size prop: `size` ('sm' | 'md' | 'lg').
+ * - Legacy composite `variant` strings remain accepted as a fallback; `sizeLevel` is kept for backward compatibility.
+ */
+export interface IButtonProps {
+    /**
+     * Optional ID of the button. Can be a string or null.
+     */
+    id?: string | null;
+    /**
+     * Optional text of the button. Can be a string or null.
+     */
+    text?: string | null;
+    /**
+     * Optional title of the button. Can be a string or null.
+     */
+    title?: string | null;
+    /**
+     * Visual style. Prefer simple values like 'filled' | 'tonal' | 'outline'.
+     * Legacy composite strings are still accepted for backward compatibility.
+     */
+    variant: ButtonVariant | string | undefined;
+    /**
+     * Semantic color used with certain variants (e.g., 'filled' or 'tonal').
+     */
+    color?: ButtonColor | string | undefined;
+    /**
+     * Preferred size alias.
+     * Accepts logical sizes ('sm' | 'md' | 'lg'). Legacy class strings are also accepted for compatibility.
+     */
+    size?: ButtonSizeLevel | string | undefined;
+    /**
+     * Optional icon variant of the button. Can be 'shape-sm', 'shape-md', 'compact-sm', 'compact', or undefined.
+     */
+    iconVariant?: 'shape-sm' | 'shape-md' | 'compact-sm' | 'compact' | undefined;
+    /**
+     * Icon-only mode toggle. When true, renders the button with icon styles (no label required).
+     */
+    icon?: boolean;
+    /**
+     * Places the icon on the trailing side when true. Defaults to leading when false.
+     */
+    iconTrailing?: boolean;
+    /**
+     * Optional disabled state of the button. Can be a boolean.
+     */
+    disabled?: boolean;
+    /**
+     * Optional loading state of the button. Can be a boolean. When true, shows a loading spinner.
+     */
+    loading?: boolean;
+    /**
+     * Optional tooltip text of the button. Can be a string or null.
+     */
+    tooltipText?: string | null;
+    /**
+     * Optional custom class for the button. Can be an array or null.
+     */
+    customClass?: ButtonClassName | null;
+    /**
+     * Optional rounded style. When true, applies a fully rounded button style.
+     */
+    rounded?: boolean;
+}
+/**
+ * Interface props for the ButtonGroup component.
+ */
+export interface IButtonGroupProps {
+    /**
+     * Applies connected button styling with rounded outer corners.
+     * When true, buttons will have reduced gap and only first/last buttons have rounded corners.
+     */
+    connected?: boolean;
+    /**
+     * Removes gap completely between buttons. Only works when `connected` is also true.
+     * Creates a seamless joined button group with no spacing.
+     */
+    joined?: boolean;
+    /**
+     * Arranges buttons vertically instead of horizontally.
+     * Changes which corners are rounded (top corners for first, bottom for last).
+     */
+    vertical?: boolean;
+    /**
+     * Optional custom CSS classes to apply to the button group container.
+     */
+    customClass?: string | null;
+}
+/**
+ * Interface props for the ButtonFabGroup component (Floating Action Button Group).
+ */
+export interface IButtonFabGroupProps {
+    /**
+     * Positions the FAB group at the top of the viewport instead of bottom.
+     * Default position is bottom-right. Combine with `start` for top-left.
+     */
+    top?: boolean;
+    /**
+     * Positions the FAB group at the start (left) of the viewport instead of end (right).
+     * Default position is bottom-right. Combine with `top` for top-left.
+     */
+    start?: boolean;
+    /**
+     * Optional custom CSS classes to apply to the FAB group container.
+     */
+    customClass?: string | null;
+}
+//# sourceMappingURL=button.d.ts.map

package/dist/types/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/types/button.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACzE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAA;AACtH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAA;AAC3H,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB;;;OAGG;IACH,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAAA;IAE3C;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;IAExC;;;OAGG;IACH,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAAA;IAE3C;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAA;IAE5E;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B"}

package/dist/types/card.d.ts

@@ -0,0 +1,37 @@
+export type CardClassName = string | string[] | Record<string, boolean>;
+export type CardVariant = 'outline' | 'elevated' | 'pane';
+export type CardSize = 'xs' | 'sm' | 'md';
+/**
+ * Interface props for the Card component.
+ * Notes:
+ * - Use `variant` to control surface (outline | elevated | pane).
+ * - Use `size` for scalable sizing ('xs' | 'sm' | 'md').
+ * - Use `selectable` to enable interactive/selectable affordances (adds `card-selectable`).
+ */
+export interface ICardProps {
+    /**
+     * Optional ID of the card. Can be a string or null.
+     */
+    id?: string | null;
+    /**
+     * Optional title of the card. Can be a string or null.
+     */
+    title?: string | null;
+    /**
+     * Optional variant of the card. Can be 'outline', 'elevated', any other string, or undefined.
+     */
+    variant?: CardVariant | string | undefined;
+    /**
+     * Scalable size of the card. Prefer 'sm' | 'md'.
+     */
+    size?: CardSize | undefined;
+    /**
+     * Optional custom class for the card.
+     */
+    customClass?: CardClassName | null;
+    /**
+     * When true, adds the `card-selectable` class to enable selectable styles.
+     */
+    selectable?: boolean | undefined;
+}
+//# sourceMappingURL=card.d.ts.map

package/dist/types/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/types/card.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACvE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;AACzD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;IAE1C;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAElC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjC"}

package/dist/types/dialog.d.ts

@@ -0,0 +1,89 @@
+export type DialogClassName = string | string[] | Record<string, boolean>;
+export type DialogMode = 'modal' | 'side-sheet' | 'headless';
+export type DialogSize = 'sm' | 'md' | 'lg';
+export type DialogVariant = 'danger' | 'warning' | 'success' | 'primary';
+/**
+ * Interface props for the Dialog component
+ * Notes:
+ * - Keep existing flags for backward compatibility.
+ * - New additive prop `mode` is preferred going forward.
+ */
+export interface IDialogProps {
+    /**
+     * Optional dialogModal property of the Dialog component.
+     * Can be a boolean indicating if the dialog is modal or not, or null.
+     */
+    showAsModal?: boolean | null;
+    /**
+     * Legacy flag: when true, treat as a modal dialog.
+     * Only applied when `mode` is not provided.
+     */
+    isModal?: boolean | null;
+    /**
+     * Legacy flag: when true, render dialog as a side sheet.
+     * Only applied when `mode` is not provided.
+     */
+    isSideSheet?: boolean | null;
+    /**
+     * Optional isHeadless property of the Dialog component.
+     * Can be a boolean indicating if the dialog is customizable or not, or null.
+     */
+    isHeadless?: boolean | null;
+    /**
+     * Preferred way to describe the dialog shape.
+     * When provided, it takes precedence over `isModal`, `isSideSheet`, and `isHeadless`.
+     */
+    mode?: DialogMode;
+    /**
+     * Preferred size for the Dialog component.
+     * When provided, it takes precedence over legacy `isSmall` and `isLarge` flags.
+     */
+    size?: DialogSize | null;
+    /**
+     * Deprecated: use `size` instead.
+     * Optional isSmall property of the Dialog component.
+     * Can be a boolean indicating if the dialog is small or not, or null.
+     */
+    isSmall?: boolean | null;
+    /**
+     * Deprecated: use `size` instead.
+     * Optional isLarge property of the Dialog component.
+     * Can be a boolean indicating if the dialog is large or not, or null.
+     */
+    isLarge?: boolean | null;
+    /**
+     * Optional title text shown in the dialog header (if used by the template).
+     */
+    title?: string | null;
+    /**
+     * Optional message text shown in the dialog body.
+     */
+    message?: string | null;
+    /**
+     * Optional label for the primary confirm action (used by confirm-style dialogs).
+     */
+    confirmLabel?: string | null;
+    /**
+     * Visual intent of the dialog; may affect colors and icons in specific implementations.
+     */
+    variant?: DialogVariant | null;
+    /**
+     * Optional custom class for the dialog root.
+     */
+    customClass?: DialogClassName | null;
+    /**
+     * Optional custom class for the dialog body element.
+     */
+    bodyDialogClass?: DialogClassName | null;
+}
+export interface IDialogDisplay {
+    /**
+     * Open the dialog function
+     */
+    showDialog: () => void;
+    /**
+     * Close the dialog function
+     */
+    closeDialog: () => void;
+}
+//# sourceMappingURL=dialog.d.ts.map

package/dist/types/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/types/dialog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AACzE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAA;AAC5D,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAC3C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAExE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAE5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAE3B;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;OAEG;IAEH,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;OAEG;IACH,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB"}

package/dist/types/icon.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Supported visual sets for the icon wrapper component.
+ * Used by the icon wrapper to select the icon family.
+ */
+export type IconSet = 'material' | 'shapes' | 'tool' | 'brand';
+/**
+ * Semantic size tokens that map to CSS utility classes.
+ * Used for scalable icon sizing.
+ */
+export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Base props shared by all icon families.
+ * Notes:
+ * - `size` accepts a size token or a numeric value in px/em.
+ * - `color` overrides the default (currentColor).
+ * - `decorative` marks the icon as decorative (default true).
+ * - `ariaLabel` is required if not decorative.
+ */
+export interface IIconBaseProps {
+    /**
+     * Size token or numeric value in pixels/em remapped in the components.
+     * Can be a string token or a number, or null.
+     */
+    size?: IconSize | number | null;
+    /**
+     * Optional override color; defaults to inheriting `currentColor`.
+     * Can be a string or null.
+     */
+    color?: string | null;
+    /**
+     * Marks the icon as purely decorative, defaulting to `true`.
+     */
+    decorative?: boolean;
+    /**
+     * Required when `decorative` is false so screen readers can announce it.
+     * Can be a string or null.
+     */
+    ariaLabel?: string | null;
+}
+/**
+ * Literal names available in the UiIconShapes component.
+ * Expanded to match the concrete variants implemented in Shapes.vue.
+ * Used for shape-based SVGs.
+ */
+export type IconShape = 'lighting-1' | 'shape-1' | 'shape-2' | 'shape-3' | 'shape-4' | 'circle-1' | 'circle-2' | 'circle-3' | 'circle-4' | 'blob-1' | 'blob-2' | 'blob-3' | 'blob-4' | 'blob-5' | 'blob-6' | 'blob-7' | 'star-1' | 'star-2' | 'star-3' | 'star-4' | 'star-5' | 'star-6' | 'star-7' | 'star-8';
+/**
+ * Literal tool names rendered in UiIconTool.
+ * Used for tool glyphs.
+ */
+export type IconToolName = 'Stripe' | 'Buy Sell Ads' | 'Firebase Console' | 'Search Console' | 'Hotjar Insights' | 'Plausible Analytics' | 'Google Ads' | 'Google Analytics';
+/**
+ * Literal brand icons rendered in UiIconBrand.
+ * Used for brand glyphs.
+ */
+export type IconBrandName = 'youtube' | 'github' | 'codepen' | 'twitter' | 'instagram' | 'discord' | 'coffee' | 'stripe' | 'buy-coffee' | 'apple' | 'google';
+/**
+ * Interface props for the Material Symbol implementation.
+ * Notes:
+ * - `iconCode` expects a Material Symbols HTML entity (e.g., ``).
+ * - Inherits base icon props.
+ */
+export interface IMaterialIconProps extends IIconBaseProps {
+    /**
+     * The symbol entity code (e.g. `''`).
+     */
+    iconCode: string;
+}
+/**
+ * Interface props for shape-based SVGs.
+ * Notes:
+ * - `shape` is required and must match a literal in IconShape.
+ * - `title` is optional and exposed when informative.
+ * - Inherits base icon props.
+ */
+export interface IShapeIconProps extends IIconBaseProps {
+    /**
+     * The shape literal to render.
+     * Must match a value in IconShape.
+     */
+    shape: IconShape;
+    /**
+     * Optional `title` element exposed when informative.
+     * Can be a string or null.
+     */
+    title?: string | null;
+}
+/**
+ * Interface props for tool glyphs.
+ * Notes:
+ * - `tool` is required and must match a literal in IconToolName.
+ * - Inherits base icon props.
+ */
+export interface IToolIconProps extends IIconBaseProps {
+    /**
+     * The tool literal to render.
+     * Must match a value in IconToolName.
+     */
+    tool: IconToolName;
+}
+/**
+ * Interface props for brand glyphs.
+ * Notes:
+ * - `brand` is required and must match a literal in IconBrandName.
+ * - Inherits base icon props.
+ */
+export interface IBrandIconProps extends IIconBaseProps {
+    /**
+     * The brand literal to render.
+     * Must match a value in IconBrandName.
+     */
+    brand: IconBrandName;
+}
+/**
+ * Discriminated union used by the icon wrapper.
+ * Notes:
+ * - `set` selects the icon family.
+ * - Only one of `iconCode`, `shape`, `tool`, or `brand` should be provided.
+ * - Inherits base icon props.
+ */
+export interface IUiIconProps extends IIconBaseProps {
+    /**
+     * Icon set to use (material, shapes, tool, brand).
+     */
+    set?: IconSet;
+    /**
+     * Material Symbols entity code (if set = 'material').
+     */
+    iconCode?: string | null;
+    /**
+     * Shape literal (if set = 'shapes').
+     */
+    shape?: IconShape | null;
+    /**
+     * Tool literal (if set = 'tool').
+     */
+    tool?: IconToolName | null;
+    /**
+     * Brand literal (if set = 'brand').
+     */
+    brand?: IconBrandName | null;
+}
+//# sourceMappingURL=icon.d.ts.map

package/dist/types/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/types/icon.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,OAAO,GACb,UAAU,GACV,QAAQ,GACR,MAAM,GACN,OAAO,CAAA;AAEb;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAA;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACf,YAAY,GACZ,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAA;AAEd;;;GAGG;AACH,MAAM,MAAM,YAAY,GAClB,QAAQ,GACR,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,YAAY,GACZ,kBAAkB,CAAA;AAExB;;;GAGG;AACH,MAAM,MAAM,aAAa,GACnB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,QAAQ,CAAA;AAEd;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;;OAGG;IACH,KAAK,EAAE,SAAS,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD;;;OAGG;IACH,IAAI,EAAE,YAAY,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;;OAGG;IACH,KAAK,EAAE,aAAa,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAE1B;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CAC7B"}

package/dist/types/list.d.ts

@@ -0,0 +1,70 @@
+export type ListClassName = string | string[] | Record<string, boolean>;
+export type ListVariant = 'flush' | 'low-contrast';
+export type ListSize = 'sm' | 'md';
+/**
+ * Interface props for the List group component.
+ * Notes:
+ * - Use `variant` to switch surface style ('flush' | 'low-contrast').
+ * - Use `size` for scalable sizing ('sm' | 'md').
+ * - `isInteractive` enables hover/active styles provided by the design system.
+ * - Prefer optional props over explicit null checks; `customClass` supports string, array, or object maps.
+ */
+export interface IListGroupProps {
+    /**
+     * Surface variant for the list group.
+     * Accepts documented variants or a custom string. Can be null.
+     */
+    variant?: ListVariant | string | null;
+    /**
+     * Scalable size for list items.
+     * Accepts documented sizes ('sm' | 'md') or a custom string. Can be null.
+     */
+    size?: ListSize | string | null;
+    /**
+     * Enables interactive styles like hover/active.
+     */
+    isInteractive?: boolean;
+    /**
+     * Optional custom classes for the root element.
+     * Accepts a string, an array of strings, or a map of class names to booleans.
+     */
+    customClass?: ListClassName | null;
+}
+/**
+ * Interface props for the List item component.
+ * Notes:
+ * - Prefer slots for custom content; `title` and `text` are convenience props.
+ * - `icon` expects a Material Symbols HTML entity (e.g., `&#xe88e;`).
+ * - Use `active` and `disabled` to reflect item state; styling is handled by the design system.
+ */
+export interface IListItemProps {
+    /**
+     * Optional title text displayed prominently.
+     * Can be a string or null.
+     */
+    title?: string | null;
+    /**
+     * Optional supporting text.
+     * Can be a string or null.
+     */
+    text?: string | null;
+    /**
+     * Optional Material Symbols icon code (HTML entity).
+     * Can be a string or null.
+     */
+    icon?: string | null;
+    /**
+     * Marks the item as active.
+     */
+    active?: boolean;
+    /**
+     * Disables the item.
+     */
+    disabled?: boolean;
+    /**
+     * Optional custom classes for the li element.
+     * Accepts a string, an array of strings, or a map of class names to booleans.
+     */
+    customClass?: ListClassName | null;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/types/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/types/list.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEvE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,cAAc,CAAA;AAClD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAA;AAElC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAA;IAErC;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAA;IAE/B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CACnC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CACnC"}