@fpkit/acss 0.5.13 → 0.6.1

package/libs/index.d.cts

@@ -1,22 +1,24 @@
 export { Button, ButtonProps } from './components/button.cjs';
 export { Card, Content as CardContent, Footer as CardFooter, CardProps, Title as CardTitle } from './components/card.cjs';
 export { default as Field, FieldProps } from './components/form/fields.cjs';
-export { F as Box, F as FP, I as Input, a as InputProps } from './inputs-f3a216db.js';
+export { default as Input } from './components/form/inputs.cjs';
 export { default as Icon, IconProps } from './components/icons/icon.cjs';
-import React__default, { ReactNode } from 'react';
-export { default as Link, LinkProps, default as To } from './components/link/link.cjs';
-export { default as List, ListItemProps } from './components/list/list.cjs';
+import React, { ReactNode } from 'react';
+export { L as Link, a as LinkProps, L as To } from './link-5192f411.js';
+export { List } from './components/list/list.cjs';
 export { Modal, ModalProps } from './components/modal.cjs';
 export { default as Popover, PopoverProps } from './components/popover/popover.cjs';
 export { RenderTable as TBL, TableProps } from './components/tables/table.cjs';
 export { Dialog } from './components/dialog/dialog.cjs';
-import { U as UI } from './ui-645f95b5.js';
-export { default as Nav, NavItem, NavItemProps, NavList, NavListProps, NavProps } from './components/nav/nav.cjs';
+import { U as UI } from './ui-d01b50d4.js';
+export { Nav, NavComponent, NavItem, NavItemProps, NavList, NavListProps, NavProps } from './components/nav/nav.cjs';
 export { default as Text, TextProps } from './components/text/text.cjs';
-export { b as Heading, H as HeadingLevel, T as Title, a as TitleProps } from './heading-3648c538.js';
-export { default as Textarea, TextareaProps } from './components/form/textarea.cjs';
-import { C as ComponentProps$1 } from './component-props-a8a2f97e.js';
+export { b as Heading, H as HeadingLevel, T as Title, a as TitleProps } from './heading-7446cb46.js';
+export { default as Textarea } from './components/form/textarea.cjs';
+import { C as ComponentProps$1 } from './component-props-67d978a2.js';
 export { default as Breadcrumb, BreadcrumbProps, CustomRoute, useBreadcrumbSegments } from './components/breadcrumbs/breadcrumb.cjs';
+export { I as InputProps, T as TextareaProps } from './form.types-d25ebfac.js';
+export { L as ListItemProps } from './list.types-d26de310.js';
 
 /**
  * Props for the Img component.
@@ -63,7 +65,7 @@ export { default as Breadcrumb, BreadcrumbProps, CustomRoute, useBreadcrumbSegme
  *
  * @see https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html
  */
-interface ImgProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElement>, 'placeholder'> {
+interface ImgProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'placeholder'> {
     /**
      * The image source URL.
      * @default '//'
@@ -97,7 +99,7 @@ interface ImgProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElemen
     /**
      * Inline styles to apply to the image.
      */
-    styles?: React__default.CSSProperties;
+    styles?: React.CSSProperties;
     /**
      * Loading behavior for the image.
      * - `"lazy"` (default): Defers loading until near viewport
@@ -197,7 +199,7 @@ interface ImgProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElemen
      * />
      * ```
      */
-    onError?: (event: React__default.SyntheticEvent<HTMLImageElement, Event>) => void;
+    onError?: (event: React.SyntheticEvent<HTMLImageElement, Event>) => void;
     /**
      * Callback fired when the image successfully loads.
      *
@@ -212,7 +214,7 @@ interface ImgProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElemen
      * />
      * ```
      */
-    onLoad?: (event: React__default.SyntheticEvent<HTMLImageElement, Event>) => void;
+    onLoad?: (event: React.SyntheticEvent<HTMLImageElement, Event>) => void;
 }
 
 /**
@@ -322,7 +324,7 @@ interface ImgProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElemen
  * @see https://www.w3.org/WAI/WCAG21/Understanding/non-text-content.html
  */
 declare const Img: {
-    ({ src, alt, width, height, styles, loading, placeholder, fetchpriority, decoding, srcSet, sizes, onError, onLoad, ...props }: ImgProps): React__default.JSX.Element;
+    ({ src, alt, width, height, styles, loading, placeholder, fetchpriority, decoding, srcSet, sizes, onError, onLoad, ...props }: ImgProps): React.JSX.Element;
     displayName: string;
 };
 
@@ -344,7 +346,7 @@ interface TextToSpeechComponentProps {
     /** The language to be used for speech synthesis. */
     language?: string;
     /** Player label */
-    label?: string | React__default.ReactNode;
+    label?: string | React.ReactNode;
     /** Callback function to be called when speech ends. */
     onEnd?: () => void;
 }
@@ -353,22 +355,22 @@ interface TextToSpeechComponentProps {
  * @param {TextToSpeechComponentProps} props - The props for the component.
  * @returns {JSX.Element} The rendered TextToSpeechComponent.
  */
-declare const TextToSpeech: React__default.FC<TextToSpeechComponentProps>;
+declare const TextToSpeech: React.FC<TextToSpeechComponentProps>;
 
-type ComponentProps = React__default.ComponentProps<typeof UI>;
+type ComponentProps = React.ComponentProps<typeof UI>;
 /**
  * Renders children elements without any wrapping component.
  * Can be used as a placeholder when no semantic landmark is needed.
  */
 declare const Landmarks: {
-    (children?: React__default.FC): React__default.JSX.Element;
+    (children?: React.FC): React.JSX.Element;
     displayName: string;
-    Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React__default.JSX.Element;
-    Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
-    Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React__default.JSX.Element;
-    Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
-    Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
-    Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
+    Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React.JSX.Element;
+    Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
+    Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React.JSX.Element;
+    Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
+    Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
+    Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
 };
 type HeaderProps = {
     headerBackground?: ReactNode;
@@ -382,7 +384,7 @@ type HeaderProps = {
  * @param styles - Optional styles object.
  * @param props - Other props.
  */
-declare const Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React__default.JSX.Element;
+declare const Header: ({ id, children, headerBackground, styles, classes, ...props }: HeaderProps) => React.JSX.Element;
 /**
  * Main component.
  *
@@ -392,7 +394,7 @@ declare const Header: ({ id, children, headerBackground, styles, classes, ...pro
  * @param styles - Optional styles object.
  * @param props - Other props.
  */
-declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
+declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
 /**
  * Footer component that renders a footer element with a section element inside.
  * @param {ReactNode} children - Child elements to render inside the section element.
@@ -400,8 +402,8 @@ declare const Main: ({ id, children, styles, classes, ...props }: ComponentProps
  * @param props - Additional props to pass to the footer element.
  * @returns A React component that renders a footer element with a section element inside.
  */
-declare const Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React__default.JSX.Element;
-declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
+declare const Footer: ({ id, classes, children, styles, ...props }: ComponentProps) => React.JSX.Element;
+declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
 /**
  * Section component that renders a section element.
  *
@@ -409,7 +411,7 @@ declare const Aside: ({ id, children, styles, classes, ...props }: ComponentProp
  * @param styles - CSS styles to apply to the section.
  * @param props - Other props.
  */
-declare const Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
+declare const Section: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
 /**
  * Article component renders an HTML <article> element.
  *
@@ -417,7 +419,7 @@ declare const Section: ({ id, children, styles, classes, ...props }: ComponentPr
  * @param styles - CSS styles to apply to the article.
  * @param props - Additional props to pass to the article element.
  */
-declare const Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React__default.JSX.Element;
+declare const Article: ({ id, children, styles, classes, ...props }: ComponentProps) => React.JSX.Element;
 
 /**
  * Props for the Badge component
@@ -434,13 +436,13 @@ type BadgeProps = {
     /**
      * Content to display inside the badge (typically numbers or short text)
      */
-    children?: React__default.ReactNode;
+    children?: React.ReactNode;
     /**
      * Visual variant of the badge
      * - 'rounded': Circular badge style
      */
     variant?: 'rounded';
-} & React__default.ComponentProps<typeof UI>;
+} & React.ComponentProps<typeof UI>;
 /**
  * Badge - A small label component for displaying status, counts, or notifications
  *
@@ -505,43 +507,229 @@ type BadgeProps = {
  * <Badge>12</Badge>
  */
 declare const Badge: {
-    ({ id, styles, classes, children, variant, ...props }: BadgeProps): React__default.JSX.Element;
+    ({ id, styles, classes, children, variant, ...props }: BadgeProps): React.JSX.Element;
     displayName: string;
 };
 
+/**
+ * Available visual variants for the Tag component
+ *
+ * Each variant applies predefined color schemes and styling through CSS custom properties:
+ * - `alpha`: Early development stage indicator (warning colors)
+ * - `beta`: Pre-release version indicator (warning colors)
+ * - `stable`: Production-ready release indicator (success colors)
+ * - `production`: Live production environment indicator (primary colors)
+ *
+ * @example
+ * ```tsx
+ * <Tag variant="beta">Beta Feature</Tag>
+ * <Tag variant="stable">v2.0</Tag>
+ * ```
+ */
+type TagVariant = 'alpha' | 'beta' | 'stable' | 'production';
+/**
+ * Props for the Tag component
+ *
+ * @property {React.ReactNode} children - REQUIRED - Content to display inside the tag (typically short text or version numbers)
+ * @property {'span' | 'p'} [elm='span'] - HTML element to render the tag as. Use 'p' for block-level tags, 'span' for inline
+ * @property {'note' | 'status'} [role='note'] - ARIA role for semantic meaning and screen reader announcements
+ * @property {TagVariant} [variant] - Visual variant that applies predefined color schemes (alpha, beta, stable, production)
+ * @property {string} [id] - Optional HTML id attribute for the tag element
+ * @property {React.CSSProperties} [styles] - Inline styles to apply to the tag
+ * @property {string} [classes] - CSS class names to apply to the tag
+ * @property {string} [aria-label] - Accessible label for screen readers. Recommended when tag content needs additional context
+ * @property {string} [aria-labelledby] - Reference to element(s) that label the tag for additional context
+ * @property {string} [aria-describedby] - Reference to element(s) that describe the tag for additional context
+ * @property {'off' | 'polite' | 'assertive'} [aria-live] - ARIA live region politeness setting for dynamic content (use with role="status")
+ *
+ * @example
+ * ```tsx
+ * // Basic tag with variant
+ * <Tag variant="beta">Beta</Tag>
+ *
+ * // Tag with custom element and role
+ * <Tag elm="p" role="status" variant="stable">v1.0 Released</Tag>
+ *
+ * // Tag with accessibility label
+ * <Tag variant="production" aria-label="Currently in production environment">
+ *   Production
+ * </Tag>
+ * ```
+ */
 type TagProps = {
-    /** HTML element to display the badge as span or p */
+    /**
+     * HTML element to display the tag as
+     * - 'span': Inline tag (default) - use for inline placement within text flow
+     * - 'p': Block-level tag - use when tag should appear as a distinct block element
+     */
     elm?: 'span' | 'p';
-    /**  Aria role for the component - conditional */
-    role: 'note' | 'status';
-} & React__default.ComponentProps<typeof UI>;
+    /**
+     * ARIA role for semantic meaning and screen reader behavior
+     * - 'note': For static, informational tags (default) - screen readers read once
+     * - 'status': For dynamic tags that update - screen readers announce changes to users
+     *
+     * Choose 'status' when tag content changes dynamically (e.g., real-time status updates).
+     * Choose 'note' for static tags that provide contextual information.
+     */
+    role?: 'note' | 'status';
+    /**
+     * Visual variant that applies predefined color schemes
+     * - 'alpha': Early development stage (amber background with warning symbol ⚠)
+     * - 'beta': Pre-release version (amber background with warning symbol ⚠)
+     * - 'stable': Production-ready release (green background with checkmark ✓)
+     * - 'production': Live production environment (blue background with live indicator ●)
+     *
+     * Each variant includes both color AND visual symbols for accessibility (WCAG 1.4.1).
+     */
+    variant?: TagVariant;
+    /**
+     * Content to display inside the tag
+     * REQUIRED - Ensures tag has meaningful content for all users including screen reader users
+     * Typically short text, version numbers, or status labels
+     */
+    children: React.ReactNode;
+    /**
+     * Accessible label for screen readers
+     * Provides additional context beyond visible text
+     */
+    'aria-label'?: string;
+    /**
+     * Reference to element(s) that label the tag
+     * Alternative to aria-label for programmatic labeling
+     */
+    'aria-labelledby'?: string;
+    /**
+     * Reference to element(s) that describe the tag
+     * Provides additional descriptive context
+     */
+    'aria-describedby'?: string;
+    /**
+     * ARIA live region politeness setting
+     * - 'off': Updates not announced (default)
+     * - 'polite': Announces when user is idle (recommended for role="status")
+     * - 'assertive': Announces immediately (use sparingly for critical updates)
+     */
+    'aria-live'?: 'off' | 'polite' | 'assertive';
+} & Omit<React.ComponentProps<typeof UI>, 'as' | 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-live'>;
+
+/**
+ * Tag - A small inline label component for displaying status, versions, or environment indicators
+ *
+ * The Tag component is used to highlight supplementary information such as release stages
+ * (alpha, beta, stable), environment indicators (production), or version labels. It renders
+ * as either a `<span>` (inline) or `<p>` (block) element with semantic ARIA roles.
+ *
+ * ## Design Philosophy
+ *
+ * Tags serve as visual and semantic indicators that:
+ * - Communicate the state or stage of features, releases, or environments
+ * - Provide quick visual scanning through color-coded variants
+ * - Maintain accessibility through proper ARIA roles and labels
+ *
+ * ## Styling Architecture
+ *
+ * The Tag component uses CSS custom properties (CSS variables) for theming and styling,
+ * allowing for easy customization through the `data-tag` attribute. Each variant
+ * (alpha, beta, stable, production) applies predefined color schemes defined in SCSS.
+ *
+ * ## Accessibility Considerations (WCAG 2.1 AA Compliance)
+ *
+ * - **Semantic Roles**: Uses `role="note"` for static tags or `role="status"` for dynamic content
+ *   - `role="note"`: Read once by screen readers, suitable for static labels (default)
+ *   - `role="status"`: Announces updates to screen readers, use for changing status indicators
+ * - **Color Independence**: Don't rely solely on color to convey meaning - include text labels
+ * - **Text Alternatives**: For icon-only tags, provide `aria-label` for screen reader context
+ * - **Contrast Ratios**: All variants meet WCAG AA contrast requirements (4.5:1 for normal text)
+ * - **Live Regions**: When using `role="status"`, tag becomes a live region for accessibility
+ *
+ * ## When to Use Each Role
+ *
+ * **Use `role="note"` (default) when:**
+ * - Displaying static version numbers (e.g., "v2.1.0")
+ * - Showing fixed environment indicators (e.g., "Beta Feature")
+ * - Labeling unchanging content categories
+ *
+ * **Use `role="status"` when:**
+ * - Indicating real-time status that may change (e.g., "Processing" → "Complete")
+ * - Displaying live build/deployment states
+ * - Showing dynamic feature flags that toggle
+ *
+ * @param {TagProps} props - Component props
+ * @returns {React.ReactElement} A Tag component
+ *
+ * @example
+ * // Basic tag with beta variant (default inline span)
+ * <Tag variant="beta">Beta</Tag>
+ *
+ * @example
+ * // Production environment indicator as block element
+ * <Tag elm="p" variant="production">Production Environment</Tag>
+ *
+ * @example
+ * // Dynamic status tag with live updates
+ * <Tag role="status" variant="stable">
+ *   {isDeployed ? 'Deployed' : 'Deploying...'}
+ * </Tag>
+ *
+ * @example
+ * // Tag with custom styling and accessibility label
+ * <Tag
+ *   variant="alpha"
+ *   aria-label="Alpha version - may contain bugs"
+ *   styles={{ fontSize: '0.75rem' }}
+ * >
+ *   Alpha
+ * </Tag>
+ *
+ * @example
+ * // ✅ GOOD: Clear text content with variant for visual enhancement
+ * <Tag variant="stable">v2.0 Stable</Tag>
+ *
+ * @example
+ * // ✅ GOOD: Dynamic status with proper role
+ * <Tag role="status" variant="production">{deploymentStatus}</Tag>
+ *
+ * @example
+ * // ✅ GOOD: Accessible tag with descriptive label
+ * <Tag variant="beta" aria-label="Beta feature - feedback welcome">
+ *   Beta
+ * </Tag>
+ *
+ * @example
+ * // ❌ BAD: Relying only on color without text
+ * <Tag variant="production" aria-label="Production" />
+ *
+ * @example
+ * // ❌ BAD: Using status role for static content
+ * <Tag role="status" variant="stable">v1.0</Tag>
+ */
 declare const Tag: {
-    ({ elm, role, children, styles, ...props }: TagProps): React__default.JSX.Element;
+    ({ elm, role, variant, children, styles, ...props }: TagProps): React.JSX.Element;
     displayName: string;
 };
 
 declare const Caption: {
-    ({ children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 declare const Thead: {
-    ({ children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 declare const Tbody: {
-    ({ children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 declare const Tr: {
-    ({ children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 declare const Td: {
-    ({ children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 declare const Table: {
-    ({ id, dataStyle, children, ...props }: ComponentProps$1): React__default.JSX.Element;
+    ({ id, dataStyle, children, ...props }: ComponentProps$1): React.JSX.Element;
     displayName: string;
 };
 
@@ -576,7 +764,7 @@ type DetailsProps = {
      * summary={<><Icon /> Shipping Information</>}
      * ```
      */
-    summary: React__default.ReactNode;
+    summary: React.ReactNode;
     /**
      * Optional icon displayed before the summary text.
      * Commonly used for chevron/arrow indicators.
@@ -586,7 +774,7 @@ type DetailsProps = {
      * icon={<ChevronDownIcon />}
      * ```
      */
-    icon?: React__default.ReactNode;
+    icon?: React.ReactNode;
     /**
      * Accessible label for screen readers.
      * If not provided, the native `<details>` semantic will be used.
@@ -613,7 +801,7 @@ type DetailsProps = {
      * ```
      */
     name?: string;
-} & React__default.ComponentProps<"details"> & Partial<React__default.ComponentProps<typeof UI>>;
+} & React.ComponentProps<"details"> & Partial<React.ComponentProps<typeof UI>>;
 
 /**
  * Details - A progressive disclosure component using native HTML `<details>` element.
@@ -664,6 +852,107 @@ type DetailsProps = {
  * <Details name="faq" summary="Question 3">Answer 3</Details>
  * ```
  */
-declare const Details: React__default.ForwardRefExoticComponent<Omit<DetailsProps, "ref"> & React__default.RefAttributes<HTMLDetailsElement>>;
+declare const Details: React.ForwardRefExoticComponent<Omit<DetailsProps, "ref"> & React.RefAttributes<HTMLDetailsElement>>;
+
+/**
+ * @deprecated This type is deprecated. Use `PolymorphicRef` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type PolymorphicRef<C extends React.ElementType> = React.Ref<React.ElementRef<C>>;
+/**
+ * @deprecated This type is deprecated. Use `AsProp` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type AsProp<C extends React.ElementType> = {
+    as?: C;
+};
+/**
+ * @deprecated This type is deprecated. Use `PropsToOmit` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type PropsToOmit<C extends React.ElementType, P> = keyof (AsProp<C> & P);
+/**
+ * @deprecated This type is deprecated. Use `PolymorphicComponentProp` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type PolymorphicComponentProp<C extends React.ElementType, Props = {}> = React.PropsWithChildren<Props & AsProp<C>> & Omit<React.ComponentPropsWithoutRef<C>, PropsToOmit<C, Props>>;
+/**
+ * @deprecated This type is deprecated. Use `PolymorphicComponentPropWithRef` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type PolymorphicComponentPropWithRef<C extends React.ElementType, Props = {}> = PolymorphicComponentProp<C, Props> & {
+    ref?: PolymorphicRef<C> | React.ForwardedRef<React.ElementRef<C>>;
+};
+/**
+ * @deprecated This type is deprecated. Use `UIProps` from './ui.tsx' instead.
+ * The UI component provides better type safety and accessibility features.
+ */
+type FPProps<C extends React.ElementType> = PolymorphicComponentPropWithRef<C, {
+    renderStyles?: boolean;
+    styles?: React.CSSProperties;
+    classes?: string;
+}>;
+/**
+ * FPComponent type definition
+ *
+ * @deprecated This type is deprecated. Use the `UI` component from './ui.tsx' instead.
+ * The UI component provides enhanced accessibility documentation, better type safety,
+ * and comprehensive WCAG 2.1 AA compliance guidance.
+ *
+ * @typeParam C - The HTML element type to render
+ * @param props - The component props
+ * @returns React component
+ *
+ * @example
+ * ```typescript
+ * // Migration from FP to UI
+ * // Before:
+ * import FP from '@fpkit/acss/components/fp';
+ * <FP as="button" styles={{ padding: '1rem' }}>Click me</FP>
+ *
+ * // After:
+ * import UI from '@fpkit/acss/components/ui';
+ * <UI as="button" styles={{ padding: '1rem' }}>Click me</UI>
+ * ```
+ */
+type FPComponent = {
+    <C extends React.ElementType = 'span'>(props: FPProps<C>): React.ReactElement | null;
+    displayName?: string;
+};
+/**
+ * @deprecated **DEPRECATED:** This component is deprecated and will be removed in a future version.
+ * Please use the `UI` component from `./ui.tsx` instead.
+ *
+ * The UI component is a drop-in replacement with the same API but provides:
+ * - Enhanced accessibility documentation and WCAG 2.1 AA compliance guidance
+ * - Better TypeScript type safety with detailed JSDoc comments
+ * - Comprehensive examples for accessible component patterns
+ * - More robust style merging with defaultStyles support
+ *
+ * @example
+ * ```typescript
+ * // Migration Guide
+ * // Before:
+ * import FP from '@fpkit/acss/components/fp';
+ * <FP as="button" styles={{ padding: '1rem' }} classes="btn">
+ *   Click me
+ * </FP>
+ *
+ * // After:
+ * import UI from '@fpkit/acss/components/ui';
+ * <UI as="button" styles={{ padding: '1rem' }} classes="btn">
+ *   Click me
+ * </UI>
+ * ```
+ *
+ * @param {Object} props - Component props
+ * @param {React.ElementType} props.as - The HTML element to render. Defaults to 'div'.
+ * @param {boolean} props.renderStyles - Whether to render styles or not. Defaults to true.
+ * @param {Object} props.styles - The styles to apply to the component.
+ * @param {Object} props.defaultStyles - The default styles to apply to the component.
+ * @param {React.ReactNode} props.children - The children to render inside the component.
+ * @returns {React.ReactElement} - A React component that renders an HTML element with optional styles.
+ */
+declare const FP: FPComponent;
 
-export { Article, Aside, Badge, BadgeProps, Caption, ComponentProps$1 as ComponentProps, Details, Footer, Header, Img, ImgProps, Landmarks, Main, Section, Table, Tag, TagProps, Tbody, Td, TextToSpeech, Thead, Tr };
+export { Article, Aside, Badge, BadgeProps, FP as Box, Caption, ComponentProps$1 as ComponentProps, Details, FP, Footer, Header, Img, ImgProps, Landmarks, Main, Section, Table, Tag, TagProps, TagVariant, Tbody, Td, TextToSpeech, Thead, Tr };