@arctura/atomics 0.0.1

package/dist/lib/hooks.d.ts

@@ -0,0 +1,5 @@
+import { useBreakpoints } from './useBreakpoints';
+import type { Breakpoint } from './useBreakpoints';
+export { useBreakpoints };
+export type { Breakpoint };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/lib/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,6 @@
+import { useControlled } from './useControlled';
+import { useBreakpoints } from './useBreakpoints';
+import type { Breakpoint } from './useBreakpoints';
+export { useBreakpoints, useControlled };
+export type { Breakpoint };
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/useBreakpoints.d.ts

@@ -0,0 +1,48 @@
+import tokens from '@/tokens.json';
+/**
+ * Viewport breakpoint names recognized by the app.
+ */
+type Breakpoint = keyof typeof tokens.theme.breakpoints;
+/**
+ * Mapping of breakpoint names to their min-width values.
+ */
+type Breakpoints = Record<Breakpoint, string>;
+/**
+ * React hook that exposes the current breakpoint and convenience guards.
+ *
+ * @returns The active breakpoint, the breakpoint map, and comparison helpers.
+ *
+ * @example
+ * ```tsx
+ * const { breakpoint, isAtLeast } = useBreakpoints();
+ *
+ * if (isAtLeast('lg')) {
+ *   console.log('Desktop layout', breakpoint);
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const { isBelow } = useBreakpoints();
+ *
+ * if (isBelow('md')) {
+ *   console.log('Mobile or tablet layout');
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const { breakpoints } = useBreakpoints();
+ *
+ * console.log(breakpoints.sm);
+ * ```
+ */
+declare function useBreakpoints(): {
+    breakpoint: Breakpoint;
+    breakpoints: Breakpoints;
+    isAtLeast: (target: Breakpoint) => boolean;
+    isBelow: (target: Breakpoint) => boolean;
+};
+export { useBreakpoints };
+export type { Breakpoint };
+//# sourceMappingURL=useBreakpoints.d.ts.map

package/dist/lib/useBreakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpoints.d.ts","sourceRoot":"","sources":["../../lib/useBreakpoints.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,eAAe,CAAC;AAEnC;;GAEG;AACH,KAAK,UAAU,GAAG,MAAM,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;AAExD;;GAEG;AACH,KAAK,WAAW,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAmE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,iBAAS,cAAc,IAAI;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;IAC3C,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC;CAC1C,CAkBA;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/lib/useControlled.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Props for the useControlled hook.
+ *
+ * @template StateType - The type of the state value.
+ * @property {StateType} [defaultValue] - The initial value for uncontrolled mode.
+ * @property {StateType} [value] - The controlled value (if provided, component is controlled).
+ */
+interface useControlledProps<StateType> {
+    defaultValue?: StateType;
+    value?: StateType;
+}
+/**
+ * React hook for managing controlled and uncontrolled component state.
+ *
+ * If a `value` prop is provided, the hook acts as a controlled component (external state).
+ * If no `value` is provided, it manages its own state internally using `defaultValue`.
+ *
+ * @template StateType - The type of the state value.
+ * @param {Object} props - The props object.
+ * @param {StateType} [props.defaultValue] - The initial value for uncontrolled mode.
+ * @param {StateType} [props.value] - The controlled value (if provided, component is controlled).
+ * @returns {[StateType | undefined, (newValue: StateType) => void]} - The current value and a setter function.
+ *
+ * @example
+ * // Uncontrolled usage
+ * const [value, setValue] = useControlled({ defaultValue: 0 });
+ *
+ * @example
+ * // Controlled usage
+ * const [value, setValue] = useControlled({ value: externalValue });
+ *
+ * @see https://reactjs.org/docs/forms.html#controlled-components for more on controlled components.
+ * @see https://reactjs.org/docs/hooks-custom.html#using-a-custom-hook for more on custom hooks.
+ * @see useControlledProps
+ */
+declare function useControlled<StateType>({ defaultValue, value }: useControlledProps<StateType>): readonly [StateType | undefined, (newValue: StateType) => void];
+export { useControlled };
+//# sourceMappingURL=useControlled.d.ts.map

package/dist/lib/useControlled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlled.d.ts","sourceRoot":"","sources":["../../lib/useControlled.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,UAAU,kBAAkB,CAAC,SAAS;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,aAAa,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,kBAAkB,CAAC,SAAS,CAAC,+CAO1D,SAAS,WAOtC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/badge/Badge.d.ts

@@ -0,0 +1,116 @@
+import type { AnchorHTMLAttributes, JSX, HTMLAttributes, ReactNode, Ref } from 'react';
+import type { IconDefinition } from '@fortawesome/free-solid-svg-icons';
+/**
+ * Supported color schemes for the Badge component.
+ *
+ * - 'primary': Main brand color
+ * - 'secondary': Secondary color
+ * - 'subtle': Neutral/subtle color
+ * - 'accent': Accent color
+ * - 'success': Success/positive color
+ * - 'danger': Error/negative color
+ * - 'warning': Warning/alert color
+ * - 'info': Informational color
+ */
+type BadgeColor = 'primary' | 'secondary' | 'subtle' | 'accent' | 'success' | 'danger' | 'warning' | 'info';
+/**
+ * Position of the icon relative to the badge content.
+ *
+ * - 'start': Icon appears before the content
+ * - 'end': Icon appears after the content
+ */
+type IconPosition = 'start' | 'end';
+/**
+ * Supported size options for the Badge component.
+ *
+ * - 'xs': Extra small
+ * - 'sm': Small
+ * - 'md': Medium (default)
+ * - 'lg': Large
+ */
+type BadgeSize = 'xs' | 'sm' | 'md' | 'lg';
+/**
+ * Visual style variants for the Badge component.
+ *
+ * - 'filled': Solid background and border
+ * - 'outline': Transparent background with border
+ * - 'ghost': Transparent background, no border
+ */
+type BadgeVariant = 'filled' | 'outline' | 'ghost';
+/**
+ * Common props for the Badge component, shared by both div and anchor variants.
+ *
+ * @property {ReactNode} [children] - Content to display inside the badge.
+ * @property {string} [className] - Additional CSS classes for the badge.
+ * @property {BadgeColor} [color] - Color scheme for the badge.
+ * @property {IconDefinition} [icon] - FontAwesome icon to display in the badge.
+ * @property {IconPosition} [iconPosition] - Position of the icon relative to the content ('start' or 'end').
+ * @property {BadgeSize} [size] - Size of the badge ('xs', 'sm', 'md', 'lg').
+ * @property {BadgeVariant} [variant] - Visual style variant ('filled', 'outline', 'ghost').
+ */
+interface BaseProps {
+    children?: ReactNode;
+    className?: string;
+    color?: BadgeColor;
+    icon?: IconDefinition;
+    iconPosition?: IconPosition;
+    size?: BadgeSize;
+    variant?: BadgeVariant;
+}
+/**
+ * Props for a Badge rendered as a <div> (non-link).
+ *
+ * @property {never} [href] - Disallowed for div variant.
+ * @property {Ref<HTMLDivElement>} [ref] - Ref for the div element.
+ * @property {never} [target] - Disallowed for div variant.
+ */
+interface DivProps extends HTMLAttributes<HTMLDivElement> {
+    href?: never;
+    ref?: Ref<HTMLDivElement>;
+    target?: never;
+}
+/**
+ * Props for a Badge rendered as an <a> (link).
+ *
+ * @property {string} href - URL for the anchor element.
+ * @property {Ref<HTMLAnchorElement>} [ref] - Ref for the anchor element.
+ * @property {string} [target] - Target attribute for the anchor (e.g., '_blank').
+ */
+interface AnchorProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+    ref?: Ref<HTMLAnchorElement>;
+    target?: string;
+}
+/**
+ * Badge component for displaying status, labels, or links with optional icon and color styling.
+ *
+ * Renders as either a <div> or <a> element depending on the presence of the 'href' prop. Supports different color schemes, sizes, variants, and icon positions.
+ *
+ * @param {BadgeProps} props - Props for configuring the badge appearance and behavior.
+ * @returns {JSX.Element} The rendered badge component.
+ *
+ * @example
+ * ```tsx
+ * import { Badge } from '@/src';
+ * import { faCheck } from '@fortawesome/free-solid-svg-icons';
+ *
+ * const MyBadge = () => (
+ *  <Badge
+ *   color="success"
+ *   icon={faCheck}
+ *   iconPosition="start"
+ *   size="sm"
+ *   variant="outline"
+ *  >
+ *    Active
+ *  </Badge>
+ * );
+ * ```
+ */
+declare function Badge(props: DivProps & BaseProps): JSX.Element;
+declare function Badge(props: AnchorProps & BaseProps): JSX.Element;
+declare namespace Badge {
+    var displayName: string;
+}
+export { Badge };
+//# sourceMappingURL=Badge.d.ts.map

package/dist/src/badge/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/badge/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,GACX,SAAS,GACT,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX;;;;;GAKG;AACH,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;AAEpC;;;;;;;GAOG;AACH,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,KAAK,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,UAAU,SAAS;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;GAMG;AACH,UAAU,QAAS,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvD,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED;;;;;;GAMG;AACH,UAAU,WAAY,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;AACzD,iBAAS,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;kBAAnD,KAAK;;;AA0Id,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/src/badge/index.d.ts

@@ -0,0 +1,3 @@
+import { Badge } from './Badge';
+export { Badge };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/badge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/badge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/src/buttons/Button.d.ts

@@ -0,0 +1,126 @@
+import type { AnchorHTMLAttributes, ButtonHTMLAttributes, JSX, ReactNode, Ref } from 'react';
+import type { IconDefinition } from '@fortawesome/free-solid-svg-icons';
+/**
+ * Supported adornments for the Button component: either a FontAwesome icon or an image.
+ */
+type ButtonAdornment = IconDefinition | ButtonImage;
+interface ButtonClasses {
+    adornment?: string;
+    button?: string;
+}
+/**
+ * Image object for use as a button adornment.
+ *
+ * @property {string} [src] - Image source URL.
+ * @property {string} [alt] - Alternative text for the image.
+ */
+interface ButtonImage {
+    src?: string;
+    alt?: string;
+}
+/**
+ * Supported button types for the native button element.
+ *
+ * - 'button': Standard button (default)
+ * - 'submit': Submits a form
+ * - 'reset': Resets a form
+ */
+type ButtonType = 'button' | 'submit' | 'reset';
+/**
+ * Size options for the Button component.
+ *
+ * - 'sm': Small
+ * - 'md': Medium
+ * - 'lg': Large
+ */
+type ButtonSize = 'sm' | 'md' | 'lg';
+/**
+ * Visual style variants for the Button component.
+ *
+ * - 'primary': Main action button
+ * - 'secondary': Secondary action button
+ * - 'text': Text-only button
+ * - 'outline': Outlined button
+ */
+type ButtonVariant = 'primary' | 'secondary' | 'text' | 'outline';
+/**
+ * Common props for the Button component, shared by both anchor and button variants.
+ */
+interface BaseProps {
+    children?: ReactNode;
+    classes?: ButtonClasses;
+    endAdornment?: ButtonAdornment;
+    fullWidth?: boolean;
+    responsive?: boolean;
+    size?: ButtonSize;
+    startAdornment?: ButtonAdornment;
+    ref?: Ref<HTMLAnchorElement>;
+    variant?: ButtonVariant;
+}
+/**
+ * Props for the anchor variant of the Button component.
+ *
+ * @property {ReactNode} [children] - The content of the anchor.
+ * @property {string} href - The URL to link to (required for anchor usage).
+ * @property {'sm' | 'md' | 'lg'} [size] - The size of the anchor button.
+ * @property {never} [type] - Not allowed for anchor usage.
+ * @property {Ref<HTMLAnchorElement>} [ref] - Ref for the anchor element.
+ * @property {'primary' | 'secondary' | 'text' | 'outline'} [variant] - The visual style of the anchor button.
+ */
+interface AnchorProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'className'> {
+    href: string;
+    ref?: Ref<HTMLAnchorElement>;
+    target?: string;
+    type?: never;
+}
+/**
+ * Props for the button variant of the Button component.
+ *
+ * @property {ReactNode} [children] - The content of the button.
+ * @property {never} [href] - Not allowed for button usage.
+ * @property {'sm' | 'md' | 'lg'} [size] - The size of the button.
+ * @property {ButtonType} [type] - The button type attribute.
+ * @property {Ref<HTMLButtonElement>} [ref] - Ref for the button element.
+ * @property {'primary' | 'secondary' | 'text' | 'outline'} [variant] - The visual style of the button.
+ */
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'className'> {
+    href?: never;
+    ref?: Ref<HTMLButtonElement>;
+    target?: never;
+    type?: ButtonType;
+}
+/**
+ * Button component supporting both anchor (<a>) and button (<button>) variants.
+ *
+ * Renders a styled button or anchor element with optional start/end adornments (icon or image),
+ * supporting multiple visual variants and sizes. The element type is determined by the presence of the 'href' prop:
+ * - If 'href' is provided, renders an anchor (<a>).
+ * - Otherwise, renders a native button (<button>).
+ *
+ * @param {ButtonComponentProps} props - Button or anchor props.
+ * @returns {JSX.Element} The rendered button or anchor element.
+ *
+ * @example
+ * ```tsx
+ * import { Button } from '@/src';
+ * import { faCoffee } from '@fortawesome/free-solid-svg-icons';
+ *
+ * const MyButton = () => (
+ *  <Button
+ *    variant="primary"
+ *    size="md"
+ *    startAdornment={faCoffee}
+ *  >
+ *    Click Me
+ *  </Button>
+ * );
+ * ```
+ */
+declare function Button(props: AnchorProps & BaseProps): JSX.Element;
+declare function Button(props: ButtonProps & BaseProps): JSX.Element;
+declare namespace Button {
+    var displayName: string;
+}
+export { Button };
+export type { ButtonAdornment, ButtonClasses, ButtonVariant };
+//# sourceMappingURL=Button.d.ts.map

package/dist/src/buttons/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/buttons/Button.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAI7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE;;GAEG;AACH,KAAK,eAAe,GAAG,cAAc,GAAG,WAAW,CAAC;AAEpD,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,KAAK,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhD;;;;;;GAMG;AACH,KAAK,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,KAAK,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAqBlE;;GAEG;AACH,UAAU,SAAS;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,UAAU,WAAY,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,UAAU,WAAY,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;IACtF,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAoCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;AAC7D,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;kBAApD,MAAM;;;AA4Ef,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/buttons/Fab.d.ts

@@ -0,0 +1,114 @@
+import type { AnchorHTMLAttributes, ButtonHTMLAttributes, JSX, MouseEvent, ReactNode, Ref } from 'react';
+import type { IconDefinition } from '@fortawesome/free-solid-svg-icons';
+/**
+ * Adornment used by the Fab. Can be a Font Awesome `IconDefinition`
+ * (rendered via `FontAwesomeIcon`) or an image payload (`FabImage`).
+ */
+type FabAdornment = IconDefinition | FabImage;
+interface FabClasses {
+    adornment?: string;
+    button?: string;
+}
+/**
+ * Allowed color theme names for the Fab component.
+ */
+type FabColor = 'primary' | 'secondary' | 'accent' | 'error' | 'info' | 'success' | 'warning';
+/**
+ * Image payload for a Fab adornment.
+ * @property {string} src - Image source URL or path.
+ * @property {string} [alt] - Optional alt text for the image.
+ */
+type FabImage = {
+    alt?: string;
+    src: string;
+};
+/**
+ * Variant of the Fab component.
+ * - 'circular': round icon-only floating action button.
+ * - 'extended': pill-shaped button that can contain text and icons.
+ */
+type FabVariant = 'circular' | 'extended';
+/**
+ * Common props shared between anchor and button variants of `Fab`.
+ */
+interface BaseProps {
+    /** Content placed inside the button. */
+    children?: ReactNode;
+    /** Additional CSS classes to apply. */
+    classes?: FabClasses;
+    /** Color theme for the Fab. */
+    color?: FabColor;
+    /** Adornment rendered after the children. */
+    endAdornment?: FabAdornment;
+    /** Size variant for the Fab: 'sm' | 'md' | 'lg'. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Adornment rendered before the children. */
+    startAdornment?: FabAdornment;
+    /** Visual variant of the Fab: 'circular' or 'extended'. */
+    variant?: FabVariant;
+}
+/**
+ * Props when the `Fab` is rendered as an anchor (`<a>`).
+ * Extends native anchor attributes but disallows `type`.
+ */
+interface AnchorProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'className'> {
+    /** Destination URL for the anchor. */
+    href?: string;
+    /** Click handler when rendered as an anchor. */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+    /** Ref forwarded to the anchor element. */
+    ref?: Ref<HTMLAnchorElement>;
+    /** Link target (for example, '_blank'). */
+    target?: string;
+    /** Explicitly disallowed on the anchor variant. */
+    type?: never;
+}
+/**
+ * Props when the `Fab` is rendered as a button (`<button>`).
+ * Extends native button attributes but disallows `href` and `target`.
+ */
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'className'> {
+    /** Explicitly disallowed on the button variant. */
+    href?: never;
+    /** Click handler when rendered as a button. */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /** Ref forwarded to the button element. */
+    ref?: Ref<HTMLButtonElement>;
+    /** Target is not applicable for button elements. */
+    target?: never;
+    /** Button `type` attribute (e.g. 'button' | 'submit' | 'reset'). */
+    type?: ButtonHTMLAttributes<HTMLButtonElement>['type'];
+}
+/**
+ * Floating Action Button (`Fab`) component.
+ * Renders either an anchor (`<a>`) when `href` is provided, or a native
+ * button (`<button>`) otherwise. Supports start/end adornments and
+ * multiple visual variants and sizes.
+ * @param {FabProps} props - Props for the Fab component (anchor or button variant).
+ * @returns {JSX.Element} The rendered Fab element.
+ *
+ * @example
+ * ```tsx
+ * import { Fab } from  '@/src';
+ * import { faPlus } from '@fortawesome/free-solid-svg-icons';
+ *
+ * const MyComponent = () => (
+ *  <Fab
+ *     color="primary"
+ *      variant="extended"
+ *    startAdornment={faPlus}
+ *    onClick={() => console.log('Fab clicked!')}
+ *  >
+ *   Add Item
+ *. </Fab>
+ * );
+ * ```
+ */
+declare function Fab(props: AnchorProps & BaseProps): JSX.Element;
+declare function Fab(props: ButtonProps & BaseProps): JSX.Element;
+declare namespace Fab {
+    var displayName: string;
+}
+export { Fab };
+export type { FabClasses };
+//# sourceMappingURL=Fab.d.ts.map

package/dist/src/buttons/Fab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fab.d.ts","sourceRoot":"","sources":["../../../src/buttons/Fab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,GAAG,EACH,UAAU,EACV,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAKxE;;;GAGG;AACH,KAAK,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE9C,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,KAAK,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9F;;;;GAIG;AACH,KAAK,QAAQ,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;;;;GAIG;AACH,KAAK,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAE1C;;GAEG;AACH,UAAU,SAAS;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oDAAoD;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;GAGG;AACH,UAAU,WAAY,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;IACtF,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACzD,2CAA2C;IAC3C,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;GAGG;AACH,UAAU,WAAY,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC;IACtF,mDAAmD;IACnD,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACzD,2CAA2C;IAC3C,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,oDAAoD;IACpD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;CACxD;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,iBAAS,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;AAC1D,iBAAS,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;kBAAjD,GAAG;;;AAuFZ,OAAO,EAAE,GAAG,EAAE,CAAC;AACf,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/buttons/IconButton.d.ts

@@ -0,0 +1,105 @@
+import type { AnchorHTMLAttributes, ButtonHTMLAttributes, JSX, MouseEvent, ReactElement, Ref } from 'react';
+import type { IconDefinition } from '@fortawesome/free-solid-svg-icons';
+/** Child content supported by the icon button. */
+type IconButtonChildren = IconDefinition | ReactElement;
+/** Optional class name hooks for the icon button internals. */
+interface IconButtonClasses {
+    /** Class names applied to the rendered child icon or image. */
+    children?: string;
+    /** Class names applied to the outer button or anchor element. */
+    iconButton?: string;
+}
+/**
+ * Color options for the IconButton component.
+ *
+ * - 'primary': Primary color style
+ * - 'secondary': Secondary color style
+ * - 'accent': Accent color style
+ */
+type IconButtonColor = 'primary' | 'secondary' | 'accent';
+/**
+ * Size options for the IconButton component.
+ *
+ * - 'sm': Small
+ * - 'md': Medium
+ * - 'lg': Large
+ */
+type IconButtonSize = 'sm' | 'md' | 'lg';
+/**
+ * Visual style variants for the IconButton component.
+ *
+ * - 'outline': Bordered, transparent background
+ * - 'filled': Solid background
+ */
+type IconButtonVariant = 'outline' | 'filled';
+/** Shared props for both anchor and button variants. */
+interface BaseProps {
+    /** Icon or custom element rendered inside the control. */
+    children?: IconButtonChildren;
+    /** Optional class name hooks for inner and outer styling. */
+    classes?: IconButtonClasses;
+    /** Color token for the button styling. */
+    color?: IconButtonColor;
+    /** Size token controlling the visual scale of the control. */
+    size?: IconButtonSize;
+    /** Visual style variant for the control. */
+    variant?: IconButtonVariant;
+}
+/** Props for the anchor variant of the IconButton component. */
+interface AnchorProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'className'> {
+    /** Destination URL for the anchor variant. */
+    href?: string;
+    /** Click handler for the anchor variant. */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+    /** Optional ref forwarded to the anchor element. */
+    ref?: Ref<HTMLAnchorElement>;
+    /** Optional target for the anchor element. */
+    target?: string;
+}
+/** Props for the button variant of the IconButton component. */
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'className'> {
+    /** Disallowed for the button variant. */
+    href?: never;
+    /** Click handler for the button variant. */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /** Optional ref forwarded to the button element. */
+    ref?: Ref<HTMLButtonElement>;
+    /** Disallowed for the button variant. */
+    target?: never;
+}
+/**
+ * IconButton component.
+ *
+ * Renders a styled button or anchor containing a FontAwesome icon, supporting different sizes, variants, and color styles.
+ * The element type is determined by the presence of the 'href' prop:
+ * - If 'href' is provided, renders an anchor (<a>).
+ * - Otherwise, renders a native button (<button>).
+ *
+ * @param {AnchorProps | ButtonProps} props - Props for the anchor or button variant.
+ * @returns {JSX.Element} The rendered icon button element.
+ *
+ * @example
+ * ```tsx
+ * import { IconButton } from '@/src';
+ * import { faCoffee } from '@fortawesome/free-solid-svg-icons';
+ *
+ * const MyIconButton = () => (
+ *  <IconButton
+ *    color="primary"
+ *    size="md"
+ *    variant="outline"
+ *    onClick={() => alert('Icon button clicked!')}
+ *  >
+ *    faCoffee
+ *  </IconButton>
+ * );
+ * ```
+ */
+declare function IconButton(props: AnchorProps & BaseProps): JSX.Element;
+declare function IconButton(props: ButtonProps & BaseProps): JSX.Element;
+declare namespace IconButton {
+    var displayName: string;
+}
+export { IconButton };
+export type { IconButtonClasses, IconButtonVariant };
+//# sourceMappingURL=IconButton.d.ts.map

package/dist/src/buttons/IconButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconButton.d.ts","sourceRoot":"","sources":["../../../src/buttons/IconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,GAAG,EACH,UAAU,EACV,YAAY,EACZ,GAAG,EACJ,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAKxE,kDAAkD;AAClD,KAAK,kBAAkB,GAAG,cAAc,GAAG,YAAY,CAAC;AAExD,+DAA+D;AAC/D,UAAU,iBAAiB;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,KAAK,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;;;;;GAMG;AACH,KAAK,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC;;;;;GAKG;AACH,KAAK,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAU9C,wDAAwD;AACxD,UAAU,SAAS;IACjB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,gEAAgE;AAChE,UAAU,WAAY,SAAQ,IAAI,CAChC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,GAAG,WAAW,CACzB;IACC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACzD,oDAAoD;IACpD,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,UAAU,WAAY,SAAQ,IAAI,CAChC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,UAAU,GAAG,WAAW,CACzB;IACC,yCAAyC;IACzC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACzD,oDAAoD;IACpD,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAoCD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;AACjE,iBAAS,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;kBAAxD,UAAU;;;AAyEnB,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/src/buttons/index.d.ts

@@ -0,0 +1,9 @@
+import { Button } from './Button';
+import type { ButtonAdornment, ButtonClasses, ButtonVariant } from './Button';
+import { IconButton } from './IconButton';
+import type { IconButtonClasses, IconButtonVariant } from './IconButton';
+import { Fab } from './Fab';
+import type { FabClasses } from './Fab';
+export { Button, Fab, IconButton };
+export type { ButtonAdornment, ButtonClasses, ButtonVariant, FabClasses, IconButtonClasses, IconButtonVariant, };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/buttons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/buttons/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AACnC,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,iBAAiB,GAClB,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { FC, HTMLAttributes, ReactNode, Ref } from 'react';
+/**
+ * Props for the Card component.
+ *
+ * @property {ReactNode} [children] - Card content, typically Header, Media, and Footer components.
+ * @property {Ref<HTMLDivElement>} [ref] - Ref for the card container div.
+ */
+interface CardProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Card component for displaying content with optional Header, Media, and Footer slots.
+ *
+ * Automatically detects and arranges Header, Media, and Footer children. If Media is present without Header or Footer, it adds headerless/footerless props for styling.
+ *
+ * @param {CardProps} props - Props for configuring the card container and its children.
+ * @returns {JSX.Element} The rendered card component.
+ *
+ * @example
+ * ```tsx
+ * import { Card, Header, Media, Footer } from '@/src';
+ *
+ * const MyCard = () => (
+ *  <Card>
+ *    <Header title="Card Title" subtitle="Card Subtitle" />
+ *    <Media src="/path/to/image.jpg" alt="Card Image" />
+ *    <Footer actions={[{ label: 'Action', onClick: () => { console.log('Action clicked'); } }]} />
+ *  </Card>
+ * );
+ * ```
+ */
+declare const Card: FC<CardProps>;
+export { Card };
+//# sourceMappingURL=Card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,EAAE,EAAE,cAAc,EAAgB,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAM9F;;;;;GAKG;AACH,UAAU,SAAU,SAAQ,cAAc,CAAC,cAAc,CAAC;IACxD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA0CvB,CAAC;AAIF,OAAO,EAAE,IAAI,EAAE,CAAC"}