@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/ui/components/ui/field.d.ts

@@ -2,43 +2,217 @@ import { VariantProps } from 'class-variance-authority';
 import { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';
 import * as React from 'react';
 /**
- * フォーム内で関連する入力フィールドをグループ化するためのコンテナ。
+ * Groups related form fields using the Base UI fieldset root.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSet composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSet({ className, ...props }: FieldsetPrimitive.Root.Props): React.JSX.Element;
 /**
- * FieldSet グループのタイトル（見出し）を指定するコンポーネント。
+ * Labels the fieldset with legend or compact label styling.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: variant='legend'.
+ * @returns The rendered FieldLegend composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. variant defaults to legend; label selects smaller typography.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldLegend({ className, variant, ...props }: FieldsetPrimitive.Legend.Props & {
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
     variant?: 'legend' | 'label';
 }): React.JSX.Element;
 /**
- * 複数のフィールドをまとめて配置・整理するためのグループコンテナ。
+ * Lays out a vertical group of fields and nested field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldGroup({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+/**
+ * Coordinates one field control, label, description and validation state.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: orientation='vertical'.
+ * @returns The rendered Field composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type. orientation defaults to vertical; horizontal/responsive change layout rather than field validation.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const Field: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldRootProps & VariantProps<(props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 /**
- * フィールド内のコントロールや説明、エラーメッセージを囲むコンテンツ領域。
+ * Groups the textual content adjacent to a field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+/**
+ * Associates a visible label with its Base UI field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldLabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
 /**
- * フィールドのタイトル（ラベル）用のコンポーネント。
+ * Styles label-like title content without creating a label association.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldTitle composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldTitle({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+/**
+ * Provides descriptive text associated with the surrounding field.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldDescription composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldDescription: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 /**
- * フォームセクションやフィールド間を区切るためのセパレーター（区切り線）。
+ * Draws a divider with optional centered text between field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSeparator({ children, className, ...props }: React.ComponentProps<'div'> & {
+    /**
+     * Content rendered in the wrapper's child region.
+     */
     children?: React.ReactNode;
 }): React.JSX.Element;
+/**
+ * Renders supplied children or deduplicated error messages when content exists.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldError composition, or null when it has no visible content.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldError: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldErrorProps & {
+    /**
+     * Explicit validation messages; duplicate message strings are collapsed and missing/empty messages may yield no content.
+     */
     errors?: Array<{
+        /**
+         * Optional error message used for deduplication and display; missing messages do not render a list item.
+         */
         message?: string;
     } | undefined>;
 }, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Exposes the surrounding Base UI field validity state to its child renderer.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldValidity composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldValidity: React.FC<import('@base-ui/react').FieldValidityProps>;
+/**
+ * Renders a Base UI control bound to its surrounding field context.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldControl composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldControl: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldControlProps, "ref"> & React.RefAttributes<HTMLElement>>;
 export { Field, FieldLabel, FieldControl, FieldError, FieldDescription, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, FieldValidity };

package/dist/ui/components/ui/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","names":["FieldsetPrimitive","React","FieldPrimitive","React$1","Field$1","FieldSet","props","Fieldset","cn","className","FieldLegend","variant","FieldGroup","fieldVariants","cva","Field","orientation","FieldContent","FieldLabel","FieldTitle","FieldDescription","FieldSeparator","children","Separator","FieldError","content","useMemo","errors","uniqueErrors","error","index","FieldValidity","FieldControl"],"sources":["../../../../src/ui/components/ui/field.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useMemo } from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { Field as FieldPrimitive } from '@base-ui/react/field';\nimport { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';\n\nimport { cn } from '../../lib/utils';\nimport { Separator } from './separator';\n\n// ============================================================================\n// FieldSet (Fieldset.Root)\n// ============================================================================\n\n/**\n * フォーム内で関連する入力フィールドをグループ化するためのコンテナ。\n */\nfunction FieldSet({ className, ...props }: FieldsetPrimitive.Root.Props) {\n  return (\n    <FieldsetPrimitive.Root\n      data-slot='field-set'\n      className={cn(\n        'gap-4 has-[>[data-slot=checkbox-group]]:gap-3 has-[>[data-slot=radio-group]]:gap-3 flex flex-col',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldLegend (Fieldset.Legend)\n// ============================================================================\n\n/**\n * FieldSet グループのタイトル（見出し）を指定するコンポーネント。\n */\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: FieldsetPrimitive.Legend.Props & { variant?: 'legend' | 'label' }) {\n  return (\n    <FieldsetPrimitive.Legend\n      data-slot='field-legend'\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldGroup\n// ============================================================================\n\n/**\n * 複数のフィールドをまとめて配置・整理するためのグループコンテナ。\n */\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-group'\n      className={cn(\n        'gap-5 data-[slot=checkbox-group]:gap-3 [&>[data-slot=field-group]]:gap-4 group/field-group @container/field-group flex w-full flex-col',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// Field (Field.Root)\n// Primtive Field Component (was FieldRoot)\n// ============================================================================\n\nconst fieldVariants = cva('data-[invalid]:text-destructive gap-2 group/field flex w-full', {\n  variants: {\n    orientation: {\n      vertical: 'flex-col [&>*]:w-full [&>.sr-only]:w-auto',\n      horizontal:\n        'flex-row items-center [&>[data-slot=field-label]]:w-24 [&>[data-slot=field-label]]:shrink-0 [&>[data-slot=field-label]]:text-right has-[>[data-slot=field-content]]:items-start has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px',\n      responsive:\n        'flex-row items-center [&>[data-slot=field-label]]:w-24 [&>[data-slot=field-label]]:shrink-0 [&>[data-slot=field-label]]:text-right has-[>[data-slot=field-content]]:items-start has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px max-sm:flex-col max-sm:[&>*]:w-full max-sm:[&>[data-slot=field-label]]:w-full max-sm:[&>[data-slot=field-label]]:text-left',\n    },\n  },\n  defaultVariants: {\n    orientation: 'vertical',\n  },\n});\n\nconst Field = React.forwardRef<\n  HTMLDivElement,\n  FieldPrimitive.Root.Props & VariantProps<typeof fieldVariants>\n>(({ className, orientation = 'vertical', ...props }, ref) => {\n  return (\n    <FieldPrimitive.Root\n      ref={ref}\n      data-slot='field'\n      data-orientation={orientation}\n      className={cn(fieldVariants({ orientation }), className)}\n      {...props}\n    />\n  );\n});\nField.displayName = 'Field';\n\n// ============================================================================\n// FieldContent\n// ============================================================================\n\n/**\n * フィールド内のコントロールや説明、エラーメッセージを囲むコンテンツ領域。\n */\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-content'\n      className={cn('gap-0.5 group/field-content flex flex-1 flex-col leading-snug', className)}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldLabel (Field.Label)\n// ============================================================================\n\nconst FieldLabel = React.forwardRef<HTMLLabelElement, FieldPrimitive.Label.Props>(\n  ({ className, ...props }, ref) => {\n    return (\n      <FieldPrimitive.Label\n        ref={ref}\n        data-slot='field-label'\n        className={cn(\n          'has-data-checked:bg-primary/5 has-data-checked:border-primary dark:has-data-checked:bg-primary/10 gap-2 group-data-[disabled]/field:opacity-50 has-[>[data-slot=field]]:rounded-lg has-[>[data-slot=field]]:border [&>*]:data-[slot=field]:p-2.5 group/field-label peer/field-label flex w-fit leading-snug text-sm font-medium',\n          'has-[>[data-slot=field]]:w-full has-[>[data-slot=field]]:flex-col',\n          'data-[invalid]:text-destructive',\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nFieldLabel.displayName = 'FieldLabel';\n\n// ============================================================================\n// FieldTitle\n// ============================================================================\n\n/**\n * フィールドのタイトル（ラベル）用のコンポーネント。\n */\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-label'\n      className={cn(\n        'gap-2 text-sm font-medium group-data-[disabled]/field:opacity-50 flex w-fit items-center leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldDescription (Field.Description)\n// ============================================================================\n\nconst FieldDescription = React.forwardRef<HTMLParagraphElement, FieldPrimitive.Description.Props>(\n  ({ className, ...props }, ref) => {\n    return (\n      <FieldPrimitive.Description\n        ref={ref}\n        data-slot='field-description'\n        className={cn(\n          'text-muted-foreground text-left text-sm [[data-variant=legend]+&]:-mt-1.5 leading-normal font-normal group-has-[[data-orientation=horizontal]]/field:text-balance',\n          'last:mt-0 nth-last-2:-mt-1',\n          '[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nFieldDescription.displayName = 'FieldDescription';\n\n// ============================================================================\n// FieldSeparator\n// ============================================================================\n\n/**\n * フォームセクションやフィールド間を区切るためのセパレーター（区切り線）。\n */\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'> & {\n  children?: React.ReactNode;\n}) {\n  return (\n    <div\n      data-slot='field-separator'\n      data-content={!!children}\n      className={cn(\n        '-my-2 h-5 text-sm group-data-[variant=outline]/field-group:-mb-2 relative',\n        className,\n      )}\n      {...props}\n    >\n      <Separator className='absolute inset-0 top-1/2' />\n      {children && (\n        <span\n          className='text-muted-foreground px-2 bg-background relative mx-auto block w-fit'\n          data-slot='field-separator-content'\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  );\n}\n\n// ============================================================================\n// FieldError (Field.Error)\n// ============================================================================\n\nconst FieldError = React.forwardRef<\n  HTMLDivElement,\n  FieldPrimitive.Error.Props & {\n    errors?: Array<{ message?: string } | undefined>;\n  }\n>(({ className, children, errors, ...props }, ref) => {\n  const content = useMemo(() => {\n    if (children) {\n      return children;\n    }\n\n    if (!errors?.length) {\n      return null;\n    }\n\n    const uniqueErrors = [...new Map(errors.map((error) => [error?.message, error])).values()];\n\n    if (uniqueErrors?.length == 1) {\n      return uniqueErrors[0]?.message;\n    }\n\n    return (\n      <ul className='ml-4 flex list-disc flex-col gap-1'>\n        {uniqueErrors.map((error, index) => error?.message && <li key={index}>{error.message}</li>)}\n      </ul>\n    );\n  }, [children, errors]);\n\n  if (!content) {\n    return null;\n  }\n\n  return (\n    <FieldPrimitive.Error\n      ref={ref}\n      data-slot='field-error'\n      className={cn('text-destructive text-sm font-normal', className)}\n      {...props}\n    >\n      {content}\n    </FieldPrimitive.Error>\n  );\n});\nFieldError.displayName = 'FieldError';\n\n// ============================================================================\n// FieldValidity (Field.Validity)\n// ============================================================================\n\nconst FieldValidity = FieldPrimitive.Validity;\n\n// ============================================================================\n// FieldControl (Helper for Smart Field / Legacy)\n// ============================================================================\n\nconst FieldControl = FieldPrimitive.Control;\n\n\nexport { Field, FieldLabel, FieldControl, FieldError, FieldDescription, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, FieldValidity };\n"],"mappings":"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"}
+{"version":3,"file":"field.js","names":["FieldsetPrimitive","React","FieldPrimitive","React$1","Field$1","FieldSet","props","Fieldset","cn","className","FieldLegend","variant","FieldGroup","fieldVariants","cva","Field","orientation","FieldContent","FieldLabel","FieldTitle","FieldDescription","FieldSeparator","children","Separator","FieldError","content","useMemo","errors","uniqueErrors","error","index","FieldValidity","FieldControl"],"sources":["../../../../src/ui/components/ui/field.tsx"],"sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useMemo } from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { Field as FieldPrimitive } from '@base-ui/react/field';\nimport { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';\n\nimport { cn } from '../../lib/utils';\nimport { Separator } from './separator';\n\n// ============================================================================\n// FieldSet (Fieldset.Root)\n// ============================================================================\n\n/**\n * Groups related form fields using the Base UI fieldset root.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldSet composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldSet({ className, ...props }: FieldsetPrimitive.Root.Props) {\n  return (\n    <FieldsetPrimitive.Root\n      data-slot='field-set'\n      className={cn(\n        'gap-4 has-[>[data-slot=checkbox-group]]:gap-3 has-[>[data-slot=radio-group]]:gap-3 flex flex-col',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldLegend (Fieldset.Legend)\n// ============================================================================\n\n/**\n * Labels the fieldset with legend or compact label styling.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: variant='legend'.\n * @returns The rendered FieldLegend composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. variant defaults to legend; label selects smaller typography.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: FieldsetPrimitive.Legend.Props & { /**\n * Visual treatment from the declared variant union; changing it does not alter host action semantics.\n */\n/**\n * Visual treatment from the declared variant union; changing it does not alter host action semantics.\n */\nvariant?: 'legend' | 'label' }) {\n  return (\n    <FieldsetPrimitive.Legend\n      data-slot='field-legend'\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldGroup\n// ============================================================================\n\n/**\n * Lays out a vertical group of fields and nested field groups.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldGroup composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-group'\n      className={cn(\n        'gap-5 data-[slot=checkbox-group]:gap-3 [&>[data-slot=field-group]]:gap-4 group/field-group @container/field-group flex w-full flex-col',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// Field (Field.Root)\n// Primtive Field Component (was FieldRoot)\n// ============================================================================\n\nconst fieldVariants = cva('data-[invalid]:text-destructive gap-2 group/field flex w-full', {\n  variants: {\n    /**\n     * Axis used to join/group controls or arrange field content.\n     * Accepted values: vertical, horizontal, responsive.\n     * @defaultValue 'vertical'\n     * @see fieldVariants\n     */\n    orientation: {\n      vertical: 'flex-col [&>*]:w-full [&>.sr-only]:w-auto',\n      horizontal:\n        'flex-row items-center [&>[data-slot=field-label]]:w-24 [&>[data-slot=field-label]]:shrink-0 [&>[data-slot=field-label]]:text-right has-[>[data-slot=field-content]]:items-start has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px',\n      responsive:\n        'flex-row items-center [&>[data-slot=field-label]]:w-24 [&>[data-slot=field-label]]:shrink-0 [&>[data-slot=field-label]]:text-right has-[>[data-slot=field-content]]:items-start has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px max-sm:flex-col max-sm:[&>*]:w-full max-sm:[&>[data-slot=field-label]]:w-full max-sm:[&>[data-slot=field-label]]:text-left',\n    },\n  },\n  defaultVariants: {\n    orientation: 'vertical',\n  },\n});\n\n/**\n * Coordinates one field control, label, description and validation state.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: orientation='vertical'.\n * @returns The rendered Field composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type. orientation defaults to vertical; horizontal/responsive change layout rather than field validation.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst Field = React.forwardRef<\n  HTMLDivElement,\n  FieldPrimitive.Root.Props & VariantProps<typeof fieldVariants>\n>(({ className, orientation = 'vertical', ...props }, ref) => {\n  return (\n    <FieldPrimitive.Root\n      ref={ref}\n      data-slot='field'\n      data-orientation={orientation}\n      className={cn(fieldVariants({ orientation }), className)}\n      {...props}\n    />\n  );\n});\nField.displayName = 'Field';\n\n// ============================================================================\n// FieldContent\n// ============================================================================\n\n/**\n * Groups the textual content adjacent to a field control.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldContent composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-content'\n      className={cn('gap-0.5 group/field-content flex flex-1 flex-col leading-snug', className)}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldLabel (Field.Label)\n// ============================================================================\n\n/**\n * Associates a visible label with its Base UI field control.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldLabel composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst FieldLabel = React.forwardRef<HTMLLabelElement, FieldPrimitive.Label.Props>(\n  ({ className, ...props }, ref) => {\n    return (\n      <FieldPrimitive.Label\n        ref={ref}\n        data-slot='field-label'\n        className={cn(\n          'has-data-checked:bg-primary/5 has-data-checked:border-primary dark:has-data-checked:bg-primary/10 gap-2 group-data-[disabled]/field:opacity-50 has-[>[data-slot=field]]:rounded-lg has-[>[data-slot=field]]:border [&>*]:data-[slot=field]:p-2.5 group/field-label peer/field-label flex w-fit leading-snug text-sm font-medium',\n          'has-[>[data-slot=field]]:w-full has-[>[data-slot=field]]:flex-col',\n          'data-[invalid]:text-destructive',\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nFieldLabel.displayName = 'FieldLabel';\n\n// ============================================================================\n// FieldTitle\n// ============================================================================\n\n/**\n * Styles label-like title content without creating a label association.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldTitle composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot='field-label'\n      className={cn(\n        'gap-2 text-sm font-medium group-data-[disabled]/field:opacity-50 flex w-fit items-center leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\n// ============================================================================\n// FieldDescription (Field.Description)\n// ============================================================================\n\n/**\n * Provides descriptive text associated with the surrounding field.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldDescription composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst FieldDescription = React.forwardRef<HTMLParagraphElement, FieldPrimitive.Description.Props>(\n  ({ className, ...props }, ref) => {\n    return (\n      <FieldPrimitive.Description\n        ref={ref}\n        data-slot='field-description'\n        className={cn(\n          'text-muted-foreground text-left text-sm [[data-variant=legend]+&]:-mt-1.5 leading-normal font-normal group-has-[[data-orientation=horizontal]]/field:text-balance',\n          'last:mt-0 nth-last-2:-mt-1',\n          '[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',\n          className,\n        )}\n        {...props}\n      />\n    );\n  },\n);\nFieldDescription.displayName = 'FieldDescription';\n\n// ============================================================================\n// FieldSeparator\n// ============================================================================\n\n/**\n * Draws a divider with optional centered text between field groups.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldSeparator composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'> & {\n  /**\n   * Content rendered in the wrapper's child region.\n   */\n  children?: React.ReactNode;\n}) {\n  return (\n    <div\n      data-slot='field-separator'\n      data-content={!!children}\n      className={cn(\n        '-my-2 h-5 text-sm group-data-[variant=outline]/field-group:-mb-2 relative',\n        className,\n      )}\n      {...props}\n    >\n      <Separator className='absolute inset-0 top-1/2' />\n      {children && (\n        <span\n          className='text-muted-foreground px-2 bg-background relative mx-auto block w-fit'\n          data-slot='field-separator-content'\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  );\n}\n\n// ============================================================================\n// FieldError (Field.Error)\n// ============================================================================\n\n/**\n * Renders supplied children or deduplicated error messages when content exists.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered FieldError composition, or null when it has no visible content.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst FieldError = React.forwardRef<\n  HTMLDivElement,\n  FieldPrimitive.Error.Props & {\n    /**\n     * Explicit validation messages; duplicate message strings are collapsed and missing/empty messages may yield no content.\n     */\n    errors?: Array<{ /**\n * Optional error message used for deduplication and display; missing messages do not render a list item.\n */\n    /**\n     * Optional error message used for deduplication and display; missing messages do not render a list item.\n     */\n    message?: string } | undefined>;\n  }\n>(({ className, children, errors, ...props }, ref) => {\n  const content = useMemo(() => {\n    if (children) {\n      return children;\n    }\n\n    if (!errors?.length) {\n      return null;\n    }\n\n    const uniqueErrors = [...new Map(errors.map((error) => [error?.message, error])).values()];\n\n    if (uniqueErrors?.length == 1) {\n      return uniqueErrors[0]?.message;\n    }\n\n    return (\n      <ul className='ml-4 flex list-disc flex-col gap-1'>\n        {uniqueErrors.map((error, index) => error?.message && <li key={index}>{error.message}</li>)}\n      </ul>\n    );\n  }, [children, errors]);\n\n  if (!content) {\n    return null;\n  }\n\n  return (\n    <FieldPrimitive.Error\n      ref={ref}\n      data-slot='field-error'\n      className={cn('text-destructive text-sm font-normal', className)}\n      {...props}\n    >\n      {content}\n    </FieldPrimitive.Error>\n  );\n});\nFieldError.displayName = 'FieldError';\n\n// ============================================================================\n// FieldValidity (Field.Validity)\n// ============================================================================\n\n/**\n * Exposes the surrounding Base UI field validity state to its child renderer.\n * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.\n * @returns The rendered FieldValidity composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst FieldValidity = FieldPrimitive.Validity;\n\n// ============================================================================\n// FieldControl (Helper for Smart Field / Legacy)\n// ============================================================================\n\n/**\n * Renders a Base UI control bound to its surrounding field context.\n * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.\n * @returns The rendered FieldControl composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.\n * @example\n * ```tsx\n * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name=\"email\"><FieldLabel>Email</FieldLabel><FieldControl type=\"email\" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);\n * }\n * ```\n */\nconst FieldControl = FieldPrimitive.Control;\n\n\nexport { Field, FieldLabel, FieldControl, FieldError, FieldDescription, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, FieldValidity };\n"],"mappings":"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"}

package/dist/ui/components/ui/file-icon.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-icon.cjs","names":["FolderIcon","cn","FileImage","FileVideo","FileAudio","FileText","FileSpreadsheet","FileArchive","FileCode","FileGenericIcon","require_ui_lib_utils","react_jsx_runtime","lucide_react","FileIcon","kind","className","mime","contentType"],"sources":["../../../../src/ui/components/ui/file-icon.tsx"],"sourcesContent":["\nimport {\n  FileIcon as FileGenericIcon,\n  FileText,\n  FileImage,\n  FileVideo,\n  FileAudio,\n  FileArchive,\n  FileCode,\n  FileSpreadsheet,\n  FolderIcon,\n} from 'lucide-react';\nimport { cn } from '../../lib/utils';\n\nexport type FileIconKind = 'file' | 'folder';\n\nexport interface FileIconProps {\n  /** 種類（ファイルまたはフォルダ） */\n  kind: FileIconKind;\n  /** MIMEタイプ */\n  contentType?: string;\n  /** クラス名 */\n  className?: string;\n}\n\n/**\n * ファイルの種類やMIMEタイプに応じたアイコンを表示するコンポーネント\n */\nexport function FileIcon({ kind, contentType, className }: FileIconProps) {\n  if (kind === 'folder') {\n    return <FolderIcon className={cn('text-blue-500 fill-blue-500/20', className)} />;\n  }\n\n  const mime = contentType?.toLowerCase() || '';\n\n  if (mime.includes('image/')) {\n    return <FileImage className={cn('text-orange-500', className)} />;\n  }\n  if (mime.includes('video/')) {\n    return <FileVideo className={cn('text-purple-500', className)} />;\n  }\n  if (mime.includes('audio/')) {\n    return <FileAudio className={cn('text-pink-500', className)} />;\n  }\n  if (mime.includes('pdf')) {\n    return <FileText className={cn('text-red-500', className)} />;\n  }\n  if (mime.includes('spreadsheet') || mime.includes('excel') || mime.includes('csv')) {\n    return <FileSpreadsheet className={cn('text-green-600', className)} />;\n  }\n  if (mime.includes('zip') || mime.includes('archive') || mime.includes('tar')) {\n    return <FileArchive className={cn('text-yellow-600', className)} />;\n  }\n  if (\n    mime.includes('javascript') ||\n    mime.includes('typescript') ||\n    mime.includes('html') ||\n    mime.includes('css') ||\n    mime.includes('json')\n  ) {\n    return <FileCode className={cn('text-blue-600', className)} />;\n  }\n  if (mime.includes('text/')) {\n    return <FileText className={cn('text-gray-500', className)} />;\n  }\n\n  return <FileGenericIcon className={cn('text-gray-400', className)} />;\n}\n"],"mappings":"A,oLA4BA,SAAgBa,EAAS,CAAE,OAAM,cAAa,aAA4B,CACxE,GAAIC,IAAS,SACX,OAAO,EAAAH,EAAA,IAAA,CAACX,EAAAA,WAAD,CAAY,UAAWC,EAAAA,GAAG,iCAAkCc,CAAS,CAAI,CAAA,EAGlF,IAAMC,EAAOC,GAAa,YAAY,GAAK,GAiC3C,OA/BID,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACT,EAAAA,UAAD,CAAW,UAAWD,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAE9DC,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACR,EAAAA,UAAD,CAAW,UAAWF,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAE9DC,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACP,EAAAA,UAAD,CAAW,UAAWH,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,EAE5DC,EAAK,SAAS,KAAK,GACd,EAAAL,EAAA,IAAA,CAACN,EAAAA,SAAD,CAAU,UAAWJ,EAAAA,GAAG,eAAgBc,CAAS,CAAI,CAAA,EAE1DC,EAAK,SAAS,aAAa,GAAKA,EAAK,SAAS,OAAO,GAAKA,EAAK,SAAS,KAAK,GACxE,EAAAL,EAAA,IAAA,CAACL,EAAAA,gBAAD,CAAiB,UAAWL,EAAAA,GAAG,iBAAkBc,CAAS,CAAI,CAAA,EAEnEC,EAAK,SAAS,KAAK,GAAKA,EAAK,SAAS,SAAS,GAAKA,EAAK,SAAS,KAAK,GAClE,EAAAL,EAAA,IAAA,CAACJ,EAAAA,YAAD,CAAa,UAAWN,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAGlEC,EAAK,SAAS,YAAY,GAC1BA,EAAK,SAAS,YAAY,GAC1BA,EAAK,SAAS,MAAM,GACpBA,EAAK,SAAS,KAAK,GACnBA,EAAK,SAAS,MAAM,GAEb,EAAAL,EAAA,IAAA,CAACH,EAAAA,SAAD,CAAU,UAAWP,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,EAE3DC,EAAK,SAAS,OAAO,GAChB,EAAAL,EAAA,IAAA,CAACN,EAAAA,SAAD,CAAU,UAAWJ,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,GAGxD,EAAAJ,EAAA,IAAA,CAACF,EAAAA,SAAD,CAAiB,UAAWR,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,CACtE,C"}
+{"version":3,"file":"file-icon.cjs","names":["FolderIcon","cn","FileImage","FileVideo","FileAudio","FileText","FileSpreadsheet","FileArchive","FileCode","FileGenericIcon","require_ui_lib_utils","react_jsx_runtime","lucide_react","FileIcon","kind","className","mime","contentType"],"sources":["../../../../src/ui/components/ui/file-icon.tsx"],"sourcesContent":["\nimport {\n  FileIcon as FileGenericIcon,\n  FileText,\n  FileImage,\n  FileVideo,\n  FileAudio,\n  FileArchive,\n  FileCode,\n  FileSpreadsheet,\n  FolderIcon,\n} from 'lucide-react';\nimport { cn } from '../../lib/utils';\n\n/**\n * Selects folder treatment or MIME-based file icon treatment.\n * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.\n * @see FileIcon\n */\nexport type FileIconKind = 'file' | 'folder';\n\n/**\n * Visual classification inputs for FileIcon; no file bytes are inspected.\n * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.\n * @see FileIcon\n */\nexport interface FileIconProps {\n  /**\n   * folder always renders the folder icon; file selects by contentType.\n   */\n  kind: FileIconKind;\n  /**\n   * Optional MIME text used for case-insensitive substring matching; missing/unmatched uses a generic file icon.\n   */\n  contentType?: string;\n  /**\n   * Additional classes merged with wrapper styling; see the component for the targeted element.\n   */\n  className?: string;\n}\n\n/**\n * Selects a folder or file-type icon using a lowercase MIME substring match.\n * @param props - Component attributes and children accepted by the declared native/underlying prop type; className customizes wrapper styling.\n * @returns The rendered FileIcon composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. kind=folder takes precedence over contentType. Missing or unrecognized MIME types use the generic file icon. This is visual classification only: it does not validate file contents, read a file or enforce upload restrictions.\n * @example\n * ```tsx\n * import { FileIcon } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FileIcon kind=\"file\" contentType=\"application/pdf\" className=\"size-5\" />);\n * }\n * ```\n */\nexport function FileIcon({ kind, contentType, className }: FileIconProps) {\n  if (kind === 'folder') {\n    return <FolderIcon className={cn('text-blue-500 fill-blue-500/20', className)} />;\n  }\n\n  const mime = contentType?.toLowerCase() || '';\n\n  if (mime.includes('image/')) {\n    return <FileImage className={cn('text-orange-500', className)} />;\n  }\n  if (mime.includes('video/')) {\n    return <FileVideo className={cn('text-purple-500', className)} />;\n  }\n  if (mime.includes('audio/')) {\n    return <FileAudio className={cn('text-pink-500', className)} />;\n  }\n  if (mime.includes('pdf')) {\n    return <FileText className={cn('text-red-500', className)} />;\n  }\n  if (mime.includes('spreadsheet') || mime.includes('excel') || mime.includes('csv')) {\n    return <FileSpreadsheet className={cn('text-green-600', className)} />;\n  }\n  if (mime.includes('zip') || mime.includes('archive') || mime.includes('tar')) {\n    return <FileArchive className={cn('text-yellow-600', className)} />;\n  }\n  if (\n    mime.includes('javascript') ||\n    mime.includes('typescript') ||\n    mime.includes('html') ||\n    mime.includes('css') ||\n    mime.includes('json')\n  ) {\n    return <FileCode className={cn('text-blue-600', className)} />;\n  }\n  if (mime.includes('text/')) {\n    return <FileText className={cn('text-gray-500', className)} />;\n  }\n\n  return <FileGenericIcon className={cn('text-gray-400', className)} />;\n}\n"],"mappings":"A,oLAwDA,SAAgBa,EAAS,CAAE,OAAM,cAAa,aAA4B,CACxE,GAAIC,IAAS,SACX,OAAO,EAAAH,EAAA,IAAA,CAACX,EAAAA,WAAD,CAAY,UAAWC,EAAAA,GAAG,iCAAkCc,CAAS,CAAI,CAAA,EAGlF,IAAMC,EAAOC,GAAa,YAAY,GAAK,GAiC3C,OA/BID,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACT,EAAAA,UAAD,CAAW,UAAWD,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAE9DC,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACR,EAAAA,UAAD,CAAW,UAAWF,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAE9DC,EAAK,SAAS,QAAQ,GACjB,EAAAL,EAAA,IAAA,CAACP,EAAAA,UAAD,CAAW,UAAWH,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,EAE5DC,EAAK,SAAS,KAAK,GACd,EAAAL,EAAA,IAAA,CAACN,EAAAA,SAAD,CAAU,UAAWJ,EAAAA,GAAG,eAAgBc,CAAS,CAAI,CAAA,EAE1DC,EAAK,SAAS,aAAa,GAAKA,EAAK,SAAS,OAAO,GAAKA,EAAK,SAAS,KAAK,GACxE,EAAAL,EAAA,IAAA,CAACL,EAAAA,gBAAD,CAAiB,UAAWL,EAAAA,GAAG,iBAAkBc,CAAS,CAAI,CAAA,EAEnEC,EAAK,SAAS,KAAK,GAAKA,EAAK,SAAS,SAAS,GAAKA,EAAK,SAAS,KAAK,GAClE,EAAAL,EAAA,IAAA,CAACJ,EAAAA,YAAD,CAAa,UAAWN,EAAAA,GAAG,kBAAmBc,CAAS,CAAI,CAAA,EAGlEC,EAAK,SAAS,YAAY,GAC1BA,EAAK,SAAS,YAAY,GAC1BA,EAAK,SAAS,MAAM,GACpBA,EAAK,SAAS,KAAK,GACnBA,EAAK,SAAS,MAAM,GAEb,EAAAL,EAAA,IAAA,CAACH,EAAAA,SAAD,CAAU,UAAWP,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,EAE3DC,EAAK,SAAS,OAAO,GAChB,EAAAL,EAAA,IAAA,CAACN,EAAAA,SAAD,CAAU,UAAWJ,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,GAGxD,EAAAJ,EAAA,IAAA,CAACF,EAAAA,SAAD,CAAiB,UAAWR,EAAAA,GAAG,gBAAiBc,CAAS,CAAI,CAAA,CACtE,C"}

package/dist/ui/components/ui/file-icon.d.cts

@@ -1,13 +1,41 @@
+/**
+ * Selects folder treatment or MIME-based file icon treatment.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FileIcon
+ */
 export type FileIconKind = 'file' | 'folder';
+/**
+ * Visual classification inputs for FileIcon; no file bytes are inspected.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FileIcon
+ */
 export interface FileIconProps {
-    /** 種類（ファイルまたはフォルダ） */
+    /**
+     * folder always renders the folder icon; file selects by contentType.
+     */
     kind: FileIconKind;
-    /** MIMEタイプ */
+    /**
+     * Optional MIME text used for case-insensitive substring matching; missing/unmatched uses a generic file icon.
+     */
     contentType?: string;
-    /** クラス名 */
+    /**
+     * Additional classes merged with wrapper styling; see the component for the targeted element.
+     */
     className?: string;
 }
 /**
- * ファイルの種類やMIMEタイプに応じたアイコンを表示するコンポーネント
+ * Selects a folder or file-type icon using a lowercase MIME substring match.
+ * @param props - Component attributes and children accepted by the declared native/underlying prop type; className customizes wrapper styling.
+ * @returns The rendered FileIcon composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. kind=folder takes precedence over contentType. Missing or unrecognized MIME types use the generic file icon. This is visual classification only: it does not validate file contents, read a file or enforce upload restrictions.
+ * @example
+ * ```tsx
+ * import { FileIcon } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FileIcon kind="file" contentType="application/pdf" className="size-5" />);
+ * }
+ * ```
  */
 export declare function FileIcon({ kind, contentType, className }: FileIconProps): import('react').JSX.Element;

package/dist/ui/components/ui/file-icon.d.ts

@@ -1,13 +1,41 @@
+/**
+ * Selects folder treatment or MIME-based file icon treatment.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FileIcon
+ */
 export type FileIconKind = 'file' | 'folder';
+/**
+ * Visual classification inputs for FileIcon; no file bytes are inspected.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FileIcon
+ */
 export interface FileIconProps {
-    /** 種類（ファイルまたはフォルダ） */
+    /**
+     * folder always renders the folder icon; file selects by contentType.
+     */
     kind: FileIconKind;
-    /** MIMEタイプ */
+    /**
+     * Optional MIME text used for case-insensitive substring matching; missing/unmatched uses a generic file icon.
+     */
     contentType?: string;
-    /** クラス名 */
+    /**
+     * Additional classes merged with wrapper styling; see the component for the targeted element.
+     */
     className?: string;
 }
 /**
- * ファイルの種類やMIMEタイプに応じたアイコンを表示するコンポーネント
+ * Selects a folder or file-type icon using a lowercase MIME substring match.
+ * @param props - Component attributes and children accepted by the declared native/underlying prop type; className customizes wrapper styling.
+ * @returns The rendered FileIcon composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. kind=folder takes precedence over contentType. Missing or unrecognized MIME types use the generic file icon. This is visual classification only: it does not validate file contents, read a file or enforce upload restrictions.
+ * @example
+ * ```tsx
+ * import { FileIcon } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FileIcon kind="file" contentType="application/pdf" className="size-5" />);
+ * }
+ * ```
  */
 export declare function FileIcon({ kind, contentType, className }: FileIconProps): import('react').JSX.Element;

package/dist/ui/components/ui/file-icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-icon.js","names":["FileGenericIcon","FileIcon$1","FileIcon","kind","FolderIcon","cn","className","mime","contentType","FileImage","FileVideo","FileAudio","FileText","FileSpreadsheet","FileArchive","FileCode"],"sources":["../../../../src/ui/components/ui/file-icon.tsx"],"sourcesContent":["\nimport {\n  FileIcon as FileGenericIcon,\n  FileText,\n  FileImage,\n  FileVideo,\n  FileAudio,\n  FileArchive,\n  FileCode,\n  FileSpreadsheet,\n  FolderIcon,\n} from 'lucide-react';\nimport { cn } from '../../lib/utils';\n\nexport type FileIconKind = 'file' | 'folder';\n\nexport interface FileIconProps {\n  /** 種類（ファイルまたはフォルダ） */\n  kind: FileIconKind;\n  /** MIMEタイプ */\n  contentType?: string;\n  /** クラス名 */\n  className?: string;\n}\n\n/**\n * ファイルの種類やMIMEタイプに応じたアイコンを表示するコンポーネント\n */\nexport function FileIcon({ kind, contentType, className }: FileIconProps) {\n  if (kind === 'folder') {\n    return <FolderIcon className={cn('text-blue-500 fill-blue-500/20', className)} />;\n  }\n\n  const mime = contentType?.toLowerCase() || '';\n\n  if (mime.includes('image/')) {\n    return <FileImage className={cn('text-orange-500', className)} />;\n  }\n  if (mime.includes('video/')) {\n    return <FileVideo className={cn('text-purple-500', className)} />;\n  }\n  if (mime.includes('audio/')) {\n    return <FileAudio className={cn('text-pink-500', className)} />;\n  }\n  if (mime.includes('pdf')) {\n    return <FileText className={cn('text-red-500', className)} />;\n  }\n  if (mime.includes('spreadsheet') || mime.includes('excel') || mime.includes('csv')) {\n    return <FileSpreadsheet className={cn('text-green-600', className)} />;\n  }\n  if (mime.includes('zip') || mime.includes('archive') || mime.includes('tar')) {\n    return <FileArchive className={cn('text-yellow-600', className)} />;\n  }\n  if (\n    mime.includes('javascript') ||\n    mime.includes('typescript') ||\n    mime.includes('html') ||\n    mime.includes('css') ||\n    mime.includes('json')\n  ) {\n    return <FileCode className={cn('text-blue-600', className)} />;\n  }\n  if (mime.includes('text/')) {\n    return <FileText className={cn('text-gray-500', className)} />;\n  }\n\n  return <FileGenericIcon className={cn('text-gray-400', className)} />;\n}\n"],"mappings":";;;;;AA4BA,SAAgBE,EAAS,EAAE,SAAM,gBAAa,gBAA4B;CACxE,IAAIC,MAAS,UACX,OAAO,kBAACC,GAAD,EAAY,WAAWC,EAAG,kCAAkCC,CAAS,EAAI,CAAA;CAGlF,IAAMC,IAAOC,GAAa,YAAY,KAAK;CAiC3C,OA/BID,EAAK,SAAS,QAAQ,IACjB,kBAACE,GAAD,EAAW,WAAWJ,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAE9DC,EAAK,SAAS,QAAQ,IACjB,kBAACG,GAAD,EAAW,WAAWL,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAE9DC,EAAK,SAAS,QAAQ,IACjB,kBAACI,GAAD,EAAW,WAAWN,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAE5DC,EAAK,SAAS,KAAK,IACd,kBAACK,GAAD,EAAU,WAAWP,EAAG,gBAAgBC,CAAS,EAAI,CAAA,IAE1DC,EAAK,SAAS,aAAa,KAAKA,EAAK,SAAS,OAAO,KAAKA,EAAK,SAAS,KAAK,IACxE,kBAACM,GAAD,EAAiB,WAAWR,EAAG,kBAAkBC,CAAS,EAAI,CAAA,IAEnEC,EAAK,SAAS,KAAK,KAAKA,EAAK,SAAS,SAAS,KAAKA,EAAK,SAAS,KAAK,IAClE,kBAACO,GAAD,EAAa,WAAWT,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAGlEC,EAAK,SAAS,YAAY,KAC1BA,EAAK,SAAS,YAAY,KAC1BA,EAAK,SAAS,MAAM,KACpBA,EAAK,SAAS,KAAK,KACnBA,EAAK,SAAS,MAAM,IAEb,kBAACQ,GAAD,EAAU,WAAWV,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAE3DC,EAAK,SAAS,OAAO,IAChB,kBAACK,GAAD,EAAU,WAAWP,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAGxD,kBAACN,GAAD,EAAiB,WAAWK,EAAG,iBAAiBC,CAAS,EAAI,CAAA;AACtE"}
+{"version":3,"file":"file-icon.js","names":["FileGenericIcon","FileIcon$1","FileIcon","kind","FolderIcon","cn","className","mime","contentType","FileImage","FileVideo","FileAudio","FileText","FileSpreadsheet","FileArchive","FileCode"],"sources":["../../../../src/ui/components/ui/file-icon.tsx"],"sourcesContent":["\nimport {\n  FileIcon as FileGenericIcon,\n  FileText,\n  FileImage,\n  FileVideo,\n  FileAudio,\n  FileArchive,\n  FileCode,\n  FileSpreadsheet,\n  FolderIcon,\n} from 'lucide-react';\nimport { cn } from '../../lib/utils';\n\n/**\n * Selects folder treatment or MIME-based file icon treatment.\n * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.\n * @see FileIcon\n */\nexport type FileIconKind = 'file' | 'folder';\n\n/**\n * Visual classification inputs for FileIcon; no file bytes are inspected.\n * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.\n * @see FileIcon\n */\nexport interface FileIconProps {\n  /**\n   * folder always renders the folder icon; file selects by contentType.\n   */\n  kind: FileIconKind;\n  /**\n   * Optional MIME text used for case-insensitive substring matching; missing/unmatched uses a generic file icon.\n   */\n  contentType?: string;\n  /**\n   * Additional classes merged with wrapper styling; see the component for the targeted element.\n   */\n  className?: string;\n}\n\n/**\n * Selects a folder or file-type icon using a lowercase MIME substring match.\n * @param props - Component attributes and children accepted by the declared native/underlying prop type; className customizes wrapper styling.\n * @returns The rendered FileIcon composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. kind=folder takes precedence over contentType. Missing or unrecognized MIME types use the generic file icon. This is visual classification only: it does not validate file contents, read a file or enforce upload restrictions.\n * @example\n * ```tsx\n * import { FileIcon } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<FileIcon kind=\"file\" contentType=\"application/pdf\" className=\"size-5\" />);\n * }\n * ```\n */\nexport function FileIcon({ kind, contentType, className }: FileIconProps) {\n  if (kind === 'folder') {\n    return <FolderIcon className={cn('text-blue-500 fill-blue-500/20', className)} />;\n  }\n\n  const mime = contentType?.toLowerCase() || '';\n\n  if (mime.includes('image/')) {\n    return <FileImage className={cn('text-orange-500', className)} />;\n  }\n  if (mime.includes('video/')) {\n    return <FileVideo className={cn('text-purple-500', className)} />;\n  }\n  if (mime.includes('audio/')) {\n    return <FileAudio className={cn('text-pink-500', className)} />;\n  }\n  if (mime.includes('pdf')) {\n    return <FileText className={cn('text-red-500', className)} />;\n  }\n  if (mime.includes('spreadsheet') || mime.includes('excel') || mime.includes('csv')) {\n    return <FileSpreadsheet className={cn('text-green-600', className)} />;\n  }\n  if (mime.includes('zip') || mime.includes('archive') || mime.includes('tar')) {\n    return <FileArchive className={cn('text-yellow-600', className)} />;\n  }\n  if (\n    mime.includes('javascript') ||\n    mime.includes('typescript') ||\n    mime.includes('html') ||\n    mime.includes('css') ||\n    mime.includes('json')\n  ) {\n    return <FileCode className={cn('text-blue-600', className)} />;\n  }\n  if (mime.includes('text/')) {\n    return <FileText className={cn('text-gray-500', className)} />;\n  }\n\n  return <FileGenericIcon className={cn('text-gray-400', className)} />;\n}\n"],"mappings":";;;;;AAwDA,SAAgBE,EAAS,EAAE,SAAM,gBAAa,gBAA4B;CACxE,IAAIC,MAAS,UACX,OAAO,kBAACC,GAAD,EAAY,WAAWC,EAAG,kCAAkCC,CAAS,EAAI,CAAA;CAGlF,IAAMC,IAAOC,GAAa,YAAY,KAAK;CAiC3C,OA/BID,EAAK,SAAS,QAAQ,IACjB,kBAACE,GAAD,EAAW,WAAWJ,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAE9DC,EAAK,SAAS,QAAQ,IACjB,kBAACG,GAAD,EAAW,WAAWL,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAE9DC,EAAK,SAAS,QAAQ,IACjB,kBAACI,GAAD,EAAW,WAAWN,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAE5DC,EAAK,SAAS,KAAK,IACd,kBAACK,GAAD,EAAU,WAAWP,EAAG,gBAAgBC,CAAS,EAAI,CAAA,IAE1DC,EAAK,SAAS,aAAa,KAAKA,EAAK,SAAS,OAAO,KAAKA,EAAK,SAAS,KAAK,IACxE,kBAACM,GAAD,EAAiB,WAAWR,EAAG,kBAAkBC,CAAS,EAAI,CAAA,IAEnEC,EAAK,SAAS,KAAK,KAAKA,EAAK,SAAS,SAAS,KAAKA,EAAK,SAAS,KAAK,IAClE,kBAACO,GAAD,EAAa,WAAWT,EAAG,mBAAmBC,CAAS,EAAI,CAAA,IAGlEC,EAAK,SAAS,YAAY,KAC1BA,EAAK,SAAS,YAAY,KAC1BA,EAAK,SAAS,MAAM,KACpBA,EAAK,SAAS,KAAK,KACnBA,EAAK,SAAS,MAAM,IAEb,kBAACQ,GAAD,EAAU,WAAWV,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAE3DC,EAAK,SAAS,OAAO,IAChB,kBAACK,GAAD,EAAU,WAAWP,EAAG,iBAAiBC,CAAS,EAAI,CAAA,IAGxD,kBAACN,GAAD,EAAiB,WAAWK,EAAG,iBAAiBC,CAAS,EAAI,CAAA;AACtE"}

package/dist/ui/components/ui/hover-card.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hover-card.cjs","names":["PreviewCardPrimitive","cn","require_ui_lib_utils","react_jsx_runtime","_base_ui_react_preview_card","HoverCard","props","HoverCardTrigger","HoverCardContent","className"],"sources":["../../../../src/ui/components/ui/hover-card.tsx"],"sourcesContent":["'use client';\n\nimport { PreviewCard as PreviewCardPrimitive } from '@base-ui/react/preview-card';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * マウスホバーで詳細情報を表示するホバーカードのルートコンポーネント。\n */\nfunction HoverCard({ ...props }: PreviewCardPrimitive.Root.Props) {\n  return <PreviewCardPrimitive.Root data-slot='hover-card' {...props} />;\n}\n\n/**\n * ホバーカードを表示するためのトリガー要素（ホバー対象）。\n */\nfunction HoverCardTrigger({ ...props }: PreviewCardPrimitive.Trigger.Props) {\n  return <PreviewCardPrimitive.Trigger data-slot='hover-card-trigger' {...props} />;\n}\n\n/**\n * ホバー時に表示される詳細情報のコンテンツコンテナ。\n */\nfunction HoverCardContent({\n  className,\n  side = 'bottom',\n  sideOffset = 4,\n  align = 'center',\n  alignOffset = 4,\n  ...props\n}: PreviewCardPrimitive.Popup.Props &\n  Pick<PreviewCardPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>) {\n  return (\n    <PreviewCardPrimitive.Portal data-slot='hover-card-portal'>\n      <PreviewCardPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <PreviewCardPrimitive.Popup\n          data-slot='hover-card-content'\n          className={cn(\n            'data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground w-64 rounded-lg p-2.5 text-sm shadow-md ring-1 duration-100 z-50 origin-(--transform-origin) outline-hidden',\n            className,\n          )}\n          {...props}\n        />\n      </PreviewCardPrimitive.Positioner>\n    </PreviewCardPrimitive.Portal>\n  );\n}\n\nexport { HoverCard, HoverCardTrigger, HoverCardContent };\n"],"mappings":"A,gNASA,SAASK,EAAU,CAAE,GAAGC,GAA0C,CAChE,OAAO,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,KAAtB,CAA2B,YAAU,aAAa,GAAIM,CAAQ,CAAA,CACvE,CAKA,SAASC,EAAiB,CAAE,GAAGD,GAA6C,CAC1E,OAAO,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,QAAtB,CAA8B,YAAU,qBAAqB,GAAIM,CAAQ,CAAA,CAClF,CAKA,SAASE,EAAiB,CACxB,YACA,OAAO,SACP,aAAa,EACb,QAAQ,SACR,cAAc,EACd,GAAGF,GAE2F,CAC9F,OACE,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,OAAtB,CAA6B,YAAU,oBACrC,UAAA,EAAAG,EAAA,IAAA,CAACH,EAAAA,YAAqB,WAAtB,CACS,QACM,cACP,OACM,aACZ,UAAU,eAEV,UAAA,EAAAG,EAAA,IAAA,CAACH,EAAAA,YAAqB,MAAtB,CACE,YAAU,qBACV,UAAWC,EAAAA,GACT,qcACAQ,CACF,EACA,GAAIH,CACL,CAAA,CAC8B,CAAA,CACN,CAAA,CAEjC,C"}
+{"version":3,"file":"hover-card.cjs","names":["PreviewCardPrimitive","cn","require_ui_lib_utils","react_jsx_runtime","_base_ui_react_preview_card","HoverCard","props","HoverCardTrigger","HoverCardContent","className"],"sources":["../../../../src/ui/components/ui/hover-card.tsx"],"sourcesContent":["'use client';\n\nimport { PreviewCard as PreviewCardPrimitive } from '@base-ui/react/preview-card';\n\nimport { cn } from '../../lib/utils';\n\n/**\n * Coordinates a preview card shown for its trigger.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered HoverCard composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.\n * @example\n * ```tsx\n * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<HoverCard><HoverCardTrigger href=\"/profile\">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);\n * }\n * ```\n */\nfunction HoverCard({ ...props }: PreviewCardPrimitive.Root.Props) {\n  return <PreviewCardPrimitive.Root data-slot='hover-card' {...props} />;\n}\n\n/**\n * Renders the interactive target associated with a preview card.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.\n * @returns The rendered HoverCardTrigger composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.\n * @example\n * ```tsx\n * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<HoverCard><HoverCardTrigger href=\"/profile\">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);\n * }\n * ```\n */\nfunction HoverCardTrigger({ ...props }: PreviewCardPrimitive.Trigger.Props) {\n  return <PreviewCardPrimitive.Trigger data-slot='hover-card-trigger' {...props} />;\n}\n\n/**\n * Portals and positions the preview popup relative to its trigger.\n * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='bottom', sideOffset=4, align='center', alignOffset=4.\n * @returns The rendered HoverCardContent composition.\n * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.\n * @example\n * ```tsx\n * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';\n * import '@alneas/appkit-react/styles';\n *\n * export function Example() {\n *   return (<HoverCard><HoverCardTrigger href=\"/profile\">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);\n * }\n * ```\n */\nfunction HoverCardContent({\n  className,\n  side = 'bottom',\n  sideOffset = 4,\n  align = 'center',\n  alignOffset = 4,\n  ...props\n}: PreviewCardPrimitive.Popup.Props &\n  Pick<PreviewCardPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>) {\n  return (\n    <PreviewCardPrimitive.Portal data-slot='hover-card-portal'>\n      <PreviewCardPrimitive.Positioner\n        align={align}\n        alignOffset={alignOffset}\n        side={side}\n        sideOffset={sideOffset}\n        className='isolate z-50'\n      >\n        <PreviewCardPrimitive.Popup\n          data-slot='hover-card-content'\n          className={cn(\n            'data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 bg-popover text-popover-foreground w-64 rounded-lg p-2.5 text-sm shadow-md ring-1 duration-100 z-50 origin-(--transform-origin) outline-hidden',\n            className,\n          )}\n          {...props}\n        />\n      </PreviewCardPrimitive.Positioner>\n    </PreviewCardPrimitive.Portal>\n  );\n}\n\nexport { HoverCard, HoverCardTrigger, HoverCardContent };\n"],"mappings":"A,gNAqBA,SAASK,EAAU,CAAE,GAAGC,GAA0C,CAChE,OAAO,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,KAAtB,CAA2B,YAAU,aAAa,GAAIM,CAAQ,CAAA,CACvE,CAiBA,SAASC,EAAiB,CAAE,GAAGD,GAA6C,CAC1E,OAAO,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,QAAtB,CAA8B,YAAU,qBAAqB,GAAIM,CAAQ,CAAA,CAClF,CAiBA,SAASE,EAAiB,CACxB,YACA,OAAO,SACP,aAAa,EACb,QAAQ,SACR,cAAc,EACd,GAAGF,GAE2F,CAC9F,OACE,EAAAH,EAAA,IAAA,CAACH,EAAAA,YAAqB,OAAtB,CAA6B,YAAU,oBACrC,UAAA,EAAAG,EAAA,IAAA,CAACH,EAAAA,YAAqB,WAAtB,CACS,QACM,cACP,OACM,aACZ,UAAU,eAEV,UAAA,EAAAG,EAAA,IAAA,CAACH,EAAAA,YAAqB,MAAtB,CACE,YAAU,qBACV,UAAWC,EAAAA,GACT,qcACAQ,CACF,EACA,GAAIH,CACL,CAAA,CAC8B,CAAA,CACN,CAAA,CAEjC,C"}

package/dist/ui/components/ui/hover-card.d.cts

@@ -1,14 +1,50 @@
 import { PreviewCard as PreviewCardPrimitive } from '@base-ui/react/preview-card';
 /**
- * マウスホバーで詳細情報を表示するホバーカードのルートコンポーネント。
+ * Coordinates a preview card shown for its trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered HoverCard composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.
+ * @example
+ * ```tsx
+ * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<HoverCard><HoverCardTrigger href="/profile">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);
+ * }
+ * ```
  */
 declare function HoverCard({ ...props }: PreviewCardPrimitive.Root.Props): import('react').JSX.Element;
 /**
- * ホバーカードを表示するためのトリガー要素（ホバー対象）。
+ * Renders the interactive target associated with a preview card.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered HoverCardTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.
+ * @example
+ * ```tsx
+ * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<HoverCard><HoverCardTrigger href="/profile">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);
+ * }
+ * ```
  */
 declare function HoverCardTrigger({ ...props }: PreviewCardPrimitive.Trigger.Props): import('react').JSX.Element;
 /**
- * ホバー時に表示される詳細情報のコンテンツコンテナ。
+ * Portals and positions the preview popup relative to its trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='bottom', sideOffset=4, align='center', alignOffset=4.
+ * @returns The rendered HoverCardContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Trigger and Content require HoverCard context. Content supplies its portal and positioner; Base UI PreviewCard owns timing, open state and interaction behavior.
+ * @example
+ * ```tsx
+ * import { HoverCard, HoverCardTrigger, HoverCardContent } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<HoverCard><HoverCardTrigger href="/profile">Profile</HoverCardTrigger><HoverCardContent>Profile details</HoverCardContent></HoverCard>);
+ * }
+ * ```
  */
 declare function HoverCardContent({ className, side, sideOffset, align, alignOffset, ...props }: PreviewCardPrimitive.Popup.Props & Pick<PreviewCardPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset'>): import('react').JSX.Element;
 export { HoverCard, HoverCardTrigger, HoverCardContent };