@epilot/spark-ui 0.10.1 → 0.11.1

package/dist/components/field.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"field.cjs","names":["React","useTheme","Separator"],"sources":["../../src/components/field.tsx"],"sourcesContent":["'use client'\n\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport { useId } from 'react'\nimport type {\n  SparkInputColor,\n  SparkInputStyle,\n  SparkLabelPosition,\n} from '../lib/theme-types'\nimport { cn } from '../utils/cn'\nimport { Separator } from './separator'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  labelPosition: SparkLabelPosition\n  inputStyle: SparkInputStyle\n  inputColor: SparkInputColor\n}\n\nconst FieldContext = React.createContext<FieldContextValue | null>(null)\n\nexport function useFieldContext() {\n  return React.useContext(FieldContext)\n}\n\n// Field→Theme→default resolution + id/aria-describedby wiring, shared by every\n// control that can sit inside a Field (Input, SelectTrigger, …) so they can't\n// drift on how a style/color/id resolves. `variant` is the control's own\n// per-instance override (already normalized — e.g. Input maps its 'none' to\n// undefined before calling this).\nexport function useFieldControl(options?: {\n  id?: string\n  ariaDescribedBy?: string\n  variant?: SparkInputStyle\n}) {\n  const field = useFieldContext()\n  const theme = useTheme()\n  const id = options?.id ?? field?.id\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  const ariaDescribedBy =\n    [descriptionId, options?.ariaDescribedBy].filter(Boolean).join(' ') ||\n    undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  return { field, id, ariaDescribedBy, inputStyle, inputColor }\n}\n\nfunction FieldSet({ className, ...props }: React.ComponentProps<'fieldset'>) {\n  return (\n    <fieldset\n      data-slot=\"field-set\"\n      className={cn(\n        'flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  return (\n    <legend\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-group\"\n      className={cn(\n        'group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldVariants = cva(\n  'group/field relative flex w-full flex-col data-[invalid=true]:text-error-active',\n  {\n    variants: {\n      labelPosition: {\n        // inset puts label + input inside one shell, so the shell is the box\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-lg px-4 py-3',\n        outset: 'gap-y-2',\n      },\n      inputStyle: { soft: '', surface: '', outlined: '', ghost: '' },\n      inputColor: { brand: '', gray: '' },\n    },\n    compoundVariants: [\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'brand',\n        class:\n          'bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'gray',\n        class:\n          'bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'brand',\n        class: 'border border-input bg-base-accent-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'gray',\n        class: 'border border-input-gray bg-base-gray-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'brand',\n        class: 'border border-input',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'gray',\n        class: 'border border-input-gray',\n      },\n      // ghost inset = bare label + underlined input; the input carries the line\n      {\n        labelPosition: 'inset',\n        inputStyle: 'ghost',\n        class: 'rounded-none px-0',\n      },\n      // shared inset states: filled shells swap bg, bordered shells swap border\n      // invalid hover deepens the error tint instead of falling back to accent\n      {\n        labelPosition: 'inset',\n        inputStyle: ['soft', 'surface'],\n        class:\n          'data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: ['surface', 'outlined'],\n        class:\n          'data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid',\n      },\n    ],\n  },\n)\n\ninterface FieldProps extends React.ComponentProps<'div'> {\n  labelPosition?: SparkLabelPosition\n  inputStyle?: SparkInputStyle\n  inputColor?: SparkInputColor\n}\n\nfunction Field({\n  className,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = React.useState(false)\n  // knobs are structural (they move the label / pick the box carrier), so they\n  // resolve here via the <Theme> context; props override per instance\n  const theme = useTheme()\n  const labelPosition = labelPositionProp ?? theme.labelPosition ?? 'inset'\n  const inputStyle = inputStyleProp ?? theme.inputStyle ?? 'soft'\n  const inputColor = inputColorProp ?? theme.inputColor ?? 'brand'\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: `field-${id}`,\n      descriptionId: `field-${id}-description`,\n      hasDescription,\n      setHasDescription,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [id, hasDescription, labelPosition, inputStyle, inputColor],\n  )\n\n  return (\n    <FieldContext.Provider value={value}>\n      <div\n        role=\"group\"\n        data-slot=\"field\"\n        data-label-position={labelPosition}\n        data-input-style={inputStyle}\n        data-input-color={inputColor}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      />\n    </FieldContext.Provider>\n  )\n}\n\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-content\"\n      className={cn(\n        'flex min-w-0 flex-1 flex-col gap-0.5 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={cn(\n        // labels stay full-contrast even when disabled — the control itself\n        // (dimmed text, gray shell) signals the state\n        'text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none',\n        // visually hidden but kept in the a11y tree (still names + focuses the control)\n        srOnly && 'sr-only',\n        className,\n      )}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    />\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={id ?? field?.id}\n      // truncated string values keep the full text reachable on hover\n      title={\n        title ??\n        (truncate && typeof children === 'string' ? children : undefined)\n      }\n      className={cn(\n        // values are content, not controls — disabled dims but stays ≥4.5:1\n        'min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70',\n        truncate\n          ? 'block truncate leading-8'\n          : 'inline-flex items-center wrap-anywhere whitespace-pre-wrap',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-title\"\n      className={cn(\n        'flex w-fit items-center gap-2 text-sm font-medium text-gray',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldDescription({\n  className,\n  id,\n  ...props\n}: React.ComponentProps<'div'>) {\n  const field = useFieldContext()\n  const setHasDescription = field?.setHasDescription\n\n  React.useEffect(() => {\n    if (!setHasDescription) return\n    setHasDescription(true)\n    return () => setHasDescription(false)\n  }, [setHasDescription])\n\n  return (\n    <div\n      data-slot=\"field-description\"\n      id={id ?? field?.descriptionId}\n      className={cn('mt-0.5 text-sm leading-normal text-gray-light', className)}\n      {...props}\n    />\n  )\n}\n\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-separator\"\n      data-content={!!children}\n      className={cn('relative -my-2 h-5 text-sm', className)}\n      {...props}\n    >\n      <Separator className=\"absolute inset-0 top-1/2\" />\n      {children && (\n        <span\n          className=\"relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light\"\n          data-slot=\"field-separator-content\"\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  )\n}\n\nfunction FieldError({\n  className,\n  children,\n  errors,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const content = React.useMemo(() => {\n    if (children) return children\n    if (!errors?.length) return null\n    const unique = [\n      ...new Map(errors.map((error) => [error?.message, error])).values(),\n    ]\n    if (unique.length === 1) return unique[0]?.message\n    return (\n      <ul className=\"ml-4 flex list-disc flex-col gap-1\">\n        {unique.map(\n          (error, index) =>\n            error?.message && <li key={index}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      className={cn('mt-0.5 text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}
+{"version":3,"file":"field.cjs","names":["React","useTheme","Skeleton","Separator"],"sources":["../../src/components/field.tsx"],"sourcesContent":["'use client'\n\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport { useId } from 'react'\nimport type {\n  SparkInputColor,\n  SparkInputStyle,\n  SparkLabelPosition,\n} from '../lib/theme-types'\nimport { cn } from '../utils/cn'\nimport { Separator } from './separator'\nimport { Skeleton } from './skeleton'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  labelId: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  readOnly: boolean\n  labelPosition: SparkLabelPosition\n  inputStyle: SparkInputStyle\n  inputColor: SparkInputColor\n}\n\nconst FieldContext = React.createContext<FieldContextValue | null>(null)\n\nexport function useFieldContext() {\n  return React.useContext(FieldContext)\n}\n\n// Field→Theme→default resolution + id/aria-describedby wiring, shared by every\n// control that can sit inside a Field (Input, SelectTrigger, …) so they can't\n// drift on how a style/color/id resolves. `variant` is the control's own\n// per-instance override (already normalized — e.g. Input maps its 'none' to\n// undefined before calling this).\nexport function useFieldControl(options?: {\n  id?: string\n  ariaDescribedBy?: string\n  variant?: SparkInputStyle\n}) {\n  const field = useFieldContext()\n  const theme = useTheme()\n  const id = options?.id ?? field?.id\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  const ariaDescribedBy =\n    [descriptionId, options?.ariaDescribedBy].filter(Boolean).join(' ') ||\n    undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  return { field, id, ariaDescribedBy, inputStyle, inputColor }\n}\n\nfunction FieldSet({ className, ...props }: React.ComponentProps<'fieldset'>) {\n  return (\n    <fieldset\n      data-slot=\"field-set\"\n      className={cn(\n        'flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  return (\n    <legend\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-group\"\n      className={cn(\n        'group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldVariants = cva(\n  'group/field relative flex w-full flex-col data-[invalid=true]:text-error-active',\n  {\n    variants: {\n      labelPosition: {\n        // inset puts label + input inside one shell, so the shell is the box\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-lg px-4 py-3',\n        outset: 'gap-y-2',\n      },\n      inputStyle: { soft: '', surface: '', outlined: '', ghost: '' },\n      inputColor: { brand: '', gray: '' },\n    },\n    compoundVariants: [\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'brand',\n        class:\n          'bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'gray',\n        class:\n          'bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'brand',\n        class: 'border border-input bg-base-accent-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'gray',\n        class: 'border border-input-gray bg-base-gray-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'brand',\n        class: 'border border-input',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'gray',\n        class: 'border border-input-gray',\n      },\n      // ghost inset = bare label + underlined input; the input carries the line\n      {\n        labelPosition: 'inset',\n        inputStyle: 'ghost',\n        class: 'rounded-none px-0',\n      },\n      // shared inset states: filled shells swap bg, bordered shells swap border\n      // invalid hover deepens the error tint instead of falling back to accent\n      {\n        labelPosition: 'inset',\n        inputStyle: ['soft', 'surface'],\n        class:\n          'data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: ['surface', 'outlined'],\n        class:\n          'data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid',\n      },\n    ],\n  },\n)\n\ninterface FieldProps extends React.ComponentProps<'div'> {\n  labelPosition?: SparkLabelPosition\n  inputStyle?: SparkInputStyle\n  inputColor?: SparkInputColor\n  readOnly?: boolean\n}\n\nfunction Field({\n  className,\n  children,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  readOnly = false,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = React.useState(false)\n  // knobs are structural (they move the label / pick the box carrier), so they\n  // resolve here via the <Theme> context; props override per instance\n  const theme = useTheme()\n  const labelPosition = labelPositionProp ?? theme.labelPosition ?? 'inset'\n  const inputStyle = inputStyleProp ?? theme.inputStyle ?? 'soft'\n  const inputColor = inputColorProp ?? theme.inputColor ?? 'brand'\n  const fieldId = `field-${id}`\n  const labelId = `${fieldId}-label`\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: fieldId,\n      labelId,\n      descriptionId: `${fieldId}-description`,\n      hasDescription,\n      setHasDescription,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [\n      fieldId,\n      labelId,\n      hasDescription,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    ],\n  )\n\n  return (\n    <FieldContext.Provider value={value}>\n      <div\n        role=\"group\"\n        data-slot=\"field\"\n        data-label-position={labelPosition}\n        data-input-style={inputStyle}\n        data-input-color={inputColor}\n        aria-labelledby={readOnly ? labelId : undefined}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\n    </FieldContext.Provider>\n  )\n}\n\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-content\"\n      className={cn(\n        'flex min-w-0 flex-1 flex-col gap-0.5 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldLabelClassName =\n  'text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none'\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  children,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  const classNames = cn(\n    // labels stay full-contrast even when disabled — the control itself\n    // (dimmed text, gray shell) signals the state\n    fieldLabelClassName,\n    // visually hidden but kept in the a11y tree (still names + focuses the control)\n    srOnly && 'sr-only',\n    className,\n  )\n\n  if (field?.readOnly) {\n    return (\n      <div data-slot=\"field-label\" id={field.labelId} className={classNames}>\n        {children}\n      </div>\n    )\n  }\n\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={classNames}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    >\n      {children}\n    </label>\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={id}\n      // truncated string values keep the full text reachable on hover\n      title={\n        title ??\n        (truncate && typeof children === 'string' ? children : undefined)\n      }\n      className={cn(\n        // values are content, not controls — disabled dims but stays ≥4.5:1\n        'min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70',\n        truncate\n          ? 'block truncate leading-8'\n          : 'inline-flex items-center wrap-anywhere whitespace-pre-wrap',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction FieldSkeleton({\n  className,\n  labelClassName,\n  valueClassName,\n  truncate,\n  ...props\n}: React.ComponentProps<'div'> & {\n  truncate?: boolean\n  labelClassName?: string\n  valueClassName?: string\n}) {\n  return (\n    <div\n      data-slot=\"field-skeleton\"\n      aria-hidden=\"true\"\n      className={cn('flex w-full flex-col gap-y-1', className)}\n      {...props}\n    >\n      <Skeleton\n        data-slot=\"field-skeleton-label\"\n        className={cn('h-5 w-24', labelClassName)}\n      />\n      <Skeleton\n        data-slot=\"field-skeleton-value\"\n        className={cn(\n          'h-8 min-h-8 w-full',\n          truncate && 'max-w-full truncate',\n          valueClassName,\n        )}\n      />\n    </div>\n  )\n}\n\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-title\"\n      className={cn(\n        'flex w-fit items-center gap-2 text-sm font-medium text-gray',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldDescription({\n  className,\n  id,\n  ...props\n}: React.ComponentProps<'div'>) {\n  const field = useFieldContext()\n  const setHasDescription = field?.setHasDescription\n\n  React.useEffect(() => {\n    if (!setHasDescription) return\n    setHasDescription(true)\n    return () => setHasDescription(false)\n  }, [setHasDescription])\n\n  return (\n    <div\n      data-slot=\"field-description\"\n      id={id ?? field?.descriptionId}\n      className={cn('mt-0.5 text-sm leading-normal text-gray-light', className)}\n      {...props}\n    />\n  )\n}\n\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-separator\"\n      data-content={!!children}\n      className={cn('relative -my-2 h-5 text-sm', className)}\n      {...props}\n    >\n      <Separator className=\"absolute inset-0 top-1/2\" />\n      {children && (\n        <span\n          className=\"relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light\"\n          data-slot=\"field-separator-content\"\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  )\n}\n\nfunction FieldError({\n  className,\n  children,\n  errors,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const content = React.useMemo(() => {\n    if (children) return children\n    if (!errors?.length) return null\n    const unique = [\n      ...new Map(errors.map((error) => [error?.message, error])).values(),\n    ]\n    if (unique.length === 1) return unique[0]?.message\n    return (\n      <ul className=\"ml-4 flex list-disc flex-col gap-1\">\n        {unique.map(\n          (error, index) =>\n            error?.message && <li key={index}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      className={cn('mt-0.5 text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldSkeleton,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}

package/dist/components/field.d.cts

@@ -1,14 +1,16 @@
 "use client";
 
-import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-8wjgiNA_.cjs";
+import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-1yB0d8mp.cjs";
 import * as React$1 from "react";
 
 //#region src/components/field.d.ts
 type FieldContextValue = {
   id: string;
+  labelId: string;
   descriptionId: string;
   hasDescription: boolean;
   setHasDescription: (has: boolean) => void;
+  readOnly: boolean;
   labelPosition: SparkLabelPosition;
   inputStyle: SparkInputStyle;
   inputColor: SparkInputColor;
@@ -44,12 +46,15 @@ interface FieldProps extends React$1.ComponentProps<'div'> {
   labelPosition?: SparkLabelPosition;
   inputStyle?: SparkInputStyle;
   inputColor?: SparkInputColor;
+  readOnly?: boolean;
 }
 declare function Field({
   className,
+  children,
   labelPosition: labelPositionProp,
   inputStyle: inputStyleProp,
   inputColor: inputColorProp,
+  readOnly,
   ...props
 }: FieldProps): import("react/jsx-runtime").JSX.Element;
 declare function FieldContent({
@@ -60,6 +65,7 @@ declare function FieldLabel({
   className,
   htmlFor,
   srOnly,
+  children,
   ...props
 }: React$1.ComponentProps<'label'> & {
   srOnly?: boolean;
@@ -74,6 +80,17 @@ declare function FieldValue({
 }: React$1.ComponentProps<'div'> & {
   truncate?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
+declare function FieldSkeleton({
+  className,
+  labelClassName,
+  valueClassName,
+  truncate,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  truncate?: boolean;
+  labelClassName?: string;
+  valueClassName?: string;
+}): import("react/jsx-runtime").JSX.Element;
 declare function FieldTitle({
   className,
   ...props
@@ -99,5 +116,5 @@ declare function FieldError({
   } | undefined>;
 }): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl };
 //# sourceMappingURL=field.d.cts.map

package/dist/components/field.d.ts

@@ -1,14 +1,16 @@
 "use client";
 
-import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-8wjgiNA_.js";
+import { a as SparkLabelPosition, i as SparkInputStyle, r as SparkInputColor } from "../theme-types-1yB0d8mp.js";
 import * as React$1 from "react";
 
 //#region src/components/field.d.ts
 type FieldContextValue = {
   id: string;
+  labelId: string;
   descriptionId: string;
   hasDescription: boolean;
   setHasDescription: (has: boolean) => void;
+  readOnly: boolean;
   labelPosition: SparkLabelPosition;
   inputStyle: SparkInputStyle;
   inputColor: SparkInputColor;
@@ -44,12 +46,15 @@ interface FieldProps extends React$1.ComponentProps<'div'> {
   labelPosition?: SparkLabelPosition;
   inputStyle?: SparkInputStyle;
   inputColor?: SparkInputColor;
+  readOnly?: boolean;
 }
 declare function Field({
   className,
+  children,
   labelPosition: labelPositionProp,
   inputStyle: inputStyleProp,
   inputColor: inputColorProp,
+  readOnly,
   ...props
 }: FieldProps): import("react/jsx-runtime").JSX.Element;
 declare function FieldContent({
@@ -60,6 +65,7 @@ declare function FieldLabel({
   className,
   htmlFor,
   srOnly,
+  children,
   ...props
 }: React$1.ComponentProps<'label'> & {
   srOnly?: boolean;
@@ -74,6 +80,17 @@ declare function FieldValue({
 }: React$1.ComponentProps<'div'> & {
   truncate?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
+declare function FieldSkeleton({
+  className,
+  labelClassName,
+  valueClassName,
+  truncate,
+  ...props
+}: React$1.ComponentProps<'div'> & {
+  truncate?: boolean;
+  labelClassName?: string;
+  valueClassName?: string;
+}): import("react/jsx-runtime").JSX.Element;
 declare function FieldTitle({
   className,
   ...props
@@ -99,5 +116,5 @@ declare function FieldError({
   } | undefined>;
 }): import("react/jsx-runtime").JSX.Element | null;
 //#endregion
-export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl };
 //# sourceMappingURL=field.d.ts.map

package/dist/components/field.js

@@ -2,6 +2,7 @@
 "use client";
 import { cn } from "../utils/cn.js";
 import { Separator } from "./separator.js";
+import { Skeleton } from "./skeleton.js";
 import { useTheme } from "./theme.js";
 import * as React$1 from "react";
 import { useId } from "react";
@@ -116,24 +117,30 @@ const fieldVariants = cva("group/field relative flex w-full flex-col data-[inval
 		}
 	]
 });
-function Field({ className, labelPosition: labelPositionProp, inputStyle: inputStyleProp, inputColor: inputColorProp, ...props }) {
+function Field({ className, children, labelPosition: labelPositionProp, inputStyle: inputStyleProp, inputColor: inputColorProp, readOnly = false, ...props }) {
 	const id = useId();
 	const [hasDescription, setHasDescription] = React$1.useState(false);
 	const theme = useTheme();
 	const labelPosition = labelPositionProp ?? theme.labelPosition ?? "inset";
 	const inputStyle = inputStyleProp ?? theme.inputStyle ?? "soft";
 	const inputColor = inputColorProp ?? theme.inputColor ?? "brand";
+	const fieldId = `field-${id}`;
+	const labelId = `${fieldId}-label`;
 	const value = React$1.useMemo(() => ({
-		id: `field-${id}`,
-		descriptionId: `field-${id}-description`,
+		id: fieldId,
+		labelId,
+		descriptionId: `${fieldId}-description`,
 		hasDescription,
 		setHasDescription,
+		readOnly,
 		labelPosition,
 		inputStyle,
 		inputColor
 	}), [
-		id,
+		fieldId,
+		labelId,
 		hasDescription,
+		readOnly,
 		labelPosition,
 		inputStyle,
 		inputColor
@@ -146,12 +153,14 @@ function Field({ className, labelPosition: labelPositionProp, inputStyle: inputS
 			"data-label-position": labelPosition,
 			"data-input-style": inputStyle,
 			"data-input-color": inputColor,
+			"aria-labelledby": readOnly ? labelId : void 0,
 			className: cn(fieldVariants({
 				labelPosition,
 				inputStyle,
 				inputColor
 			}), className),
-			...props
+			...props,
+			children
 		})
 	});
 }
@@ -162,26 +171,49 @@ function FieldContent({ className, ...props }) {
 		...props
 	});
 }
-function FieldLabel({ className, htmlFor, srOnly, ...props }) {
+const fieldLabelClassName = "text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none";
+function FieldLabel({ className, htmlFor, srOnly, children, ...props }) {
 	const field = useFieldContext();
+	const classNames = cn(fieldLabelClassName, srOnly && "sr-only", className);
+	if (field?.readOnly) return /* @__PURE__ */ jsx("div", {
+		"data-slot": "field-label",
+		id: field.labelId,
+		className: classNames,
+		children
+	});
 	return /* @__PURE__ */ jsx("label", {
 		"data-slot": "field-label",
-		className: cn("text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none", srOnly && "sr-only", className),
+		className: classNames,
 		htmlFor: htmlFor ?? field?.id,
-		...props
+		...props,
+		children
 	});
 }
 function FieldValue({ className, id, title, truncate, children, ...props }) {
-	const field = useFieldContext();
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "field-value",
-		id: id ?? field?.id,
+		id,
 		title: title ?? (truncate && typeof children === "string" ? children : void 0),
 		className: cn("min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70", truncate ? "block truncate leading-8" : "inline-flex items-center wrap-anywhere whitespace-pre-wrap", className),
 		...props,
 		children
 	});
 }
+function FieldSkeleton({ className, labelClassName, valueClassName, truncate, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		"data-slot": "field-skeleton",
+		"aria-hidden": "true",
+		className: cn("flex w-full flex-col gap-y-1", className),
+		...props,
+		children: [/* @__PURE__ */ jsx(Skeleton, {
+			"data-slot": "field-skeleton-label",
+			className: cn("h-5 w-24", labelClassName)
+		}), /* @__PURE__ */ jsx(Skeleton, {
+			"data-slot": "field-skeleton-value",
+			className: cn("h-8 min-h-8 w-full", truncate && "max-w-full truncate", valueClassName)
+		})]
+	});
+}
 function FieldTitle({ className, ...props }) {
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "field-title",
@@ -238,6 +270,6 @@ function FieldError({ className, children, errors, ...props }) {
 	});
 }
 //#endregion
-export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FieldValue, useFieldContext, useFieldControl };
+export { Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldSkeleton, FieldTitle, FieldValue, useFieldContext, useFieldControl };
 
 //# sourceMappingURL=field.js.map

package/dist/components/field.js.map

@@ -1 +1 @@
-{"version":3,"file":"field.js","names":["React"],"sources":["../../src/components/field.tsx"],"sourcesContent":["'use client'\n\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport { useId } from 'react'\nimport type {\n  SparkInputColor,\n  SparkInputStyle,\n  SparkLabelPosition,\n} from '../lib/theme-types'\nimport { cn } from '../utils/cn'\nimport { Separator } from './separator'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  labelPosition: SparkLabelPosition\n  inputStyle: SparkInputStyle\n  inputColor: SparkInputColor\n}\n\nconst FieldContext = React.createContext<FieldContextValue | null>(null)\n\nexport function useFieldContext() {\n  return React.useContext(FieldContext)\n}\n\n// Field→Theme→default resolution + id/aria-describedby wiring, shared by every\n// control that can sit inside a Field (Input, SelectTrigger, …) so they can't\n// drift on how a style/color/id resolves. `variant` is the control's own\n// per-instance override (already normalized — e.g. Input maps its 'none' to\n// undefined before calling this).\nexport function useFieldControl(options?: {\n  id?: string\n  ariaDescribedBy?: string\n  variant?: SparkInputStyle\n}) {\n  const field = useFieldContext()\n  const theme = useTheme()\n  const id = options?.id ?? field?.id\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  const ariaDescribedBy =\n    [descriptionId, options?.ariaDescribedBy].filter(Boolean).join(' ') ||\n    undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  return { field, id, ariaDescribedBy, inputStyle, inputColor }\n}\n\nfunction FieldSet({ className, ...props }: React.ComponentProps<'fieldset'>) {\n  return (\n    <fieldset\n      data-slot=\"field-set\"\n      className={cn(\n        'flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  return (\n    <legend\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-group\"\n      className={cn(\n        'group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldVariants = cva(\n  'group/field relative flex w-full flex-col data-[invalid=true]:text-error-active',\n  {\n    variants: {\n      labelPosition: {\n        // inset puts label + input inside one shell, so the shell is the box\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-lg px-4 py-3',\n        outset: 'gap-y-2',\n      },\n      inputStyle: { soft: '', surface: '', outlined: '', ghost: '' },\n      inputColor: { brand: '', gray: '' },\n    },\n    compoundVariants: [\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'brand',\n        class:\n          'bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'gray',\n        class:\n          'bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'brand',\n        class: 'border border-input bg-base-accent-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'gray',\n        class: 'border border-input-gray bg-base-gray-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'brand',\n        class: 'border border-input',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'gray',\n        class: 'border border-input-gray',\n      },\n      // ghost inset = bare label + underlined input; the input carries the line\n      {\n        labelPosition: 'inset',\n        inputStyle: 'ghost',\n        class: 'rounded-none px-0',\n      },\n      // shared inset states: filled shells swap bg, bordered shells swap border\n      // invalid hover deepens the error tint instead of falling back to accent\n      {\n        labelPosition: 'inset',\n        inputStyle: ['soft', 'surface'],\n        class:\n          'data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: ['surface', 'outlined'],\n        class:\n          'data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid',\n      },\n    ],\n  },\n)\n\ninterface FieldProps extends React.ComponentProps<'div'> {\n  labelPosition?: SparkLabelPosition\n  inputStyle?: SparkInputStyle\n  inputColor?: SparkInputColor\n}\n\nfunction Field({\n  className,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = React.useState(false)\n  // knobs are structural (they move the label / pick the box carrier), so they\n  // resolve here via the <Theme> context; props override per instance\n  const theme = useTheme()\n  const labelPosition = labelPositionProp ?? theme.labelPosition ?? 'inset'\n  const inputStyle = inputStyleProp ?? theme.inputStyle ?? 'soft'\n  const inputColor = inputColorProp ?? theme.inputColor ?? 'brand'\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: `field-${id}`,\n      descriptionId: `field-${id}-description`,\n      hasDescription,\n      setHasDescription,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [id, hasDescription, labelPosition, inputStyle, inputColor],\n  )\n\n  return (\n    <FieldContext.Provider value={value}>\n      <div\n        role=\"group\"\n        data-slot=\"field\"\n        data-label-position={labelPosition}\n        data-input-style={inputStyle}\n        data-input-color={inputColor}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      />\n    </FieldContext.Provider>\n  )\n}\n\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-content\"\n      className={cn(\n        'flex min-w-0 flex-1 flex-col gap-0.5 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={cn(\n        // labels stay full-contrast even when disabled — the control itself\n        // (dimmed text, gray shell) signals the state\n        'text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none',\n        // visually hidden but kept in the a11y tree (still names + focuses the control)\n        srOnly && 'sr-only',\n        className,\n      )}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    />\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  const field = useFieldContext()\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={id ?? field?.id}\n      // truncated string values keep the full text reachable on hover\n      title={\n        title ??\n        (truncate && typeof children === 'string' ? children : undefined)\n      }\n      className={cn(\n        // values are content, not controls — disabled dims but stays ≥4.5:1\n        'min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70',\n        truncate\n          ? 'block truncate leading-8'\n          : 'inline-flex items-center wrap-anywhere whitespace-pre-wrap',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-title\"\n      className={cn(\n        'flex w-fit items-center gap-2 text-sm font-medium text-gray',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldDescription({\n  className,\n  id,\n  ...props\n}: React.ComponentProps<'div'>) {\n  const field = useFieldContext()\n  const setHasDescription = field?.setHasDescription\n\n  React.useEffect(() => {\n    if (!setHasDescription) return\n    setHasDescription(true)\n    return () => setHasDescription(false)\n  }, [setHasDescription])\n\n  return (\n    <div\n      data-slot=\"field-description\"\n      id={id ?? field?.descriptionId}\n      className={cn('mt-0.5 text-sm leading-normal text-gray-light', className)}\n      {...props}\n    />\n  )\n}\n\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-separator\"\n      data-content={!!children}\n      className={cn('relative -my-2 h-5 text-sm', className)}\n      {...props}\n    >\n      <Separator className=\"absolute inset-0 top-1/2\" />\n      {children && (\n        <span\n          className=\"relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light\"\n          data-slot=\"field-separator-content\"\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  )\n}\n\nfunction FieldError({\n  className,\n  children,\n  errors,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const content = React.useMemo(() => {\n    if (children) return children\n    if (!errors?.length) return null\n    const unique = [\n      ...new Map(errors.map((error) => [error?.message, error])).values(),\n    ]\n    if (unique.length === 1) return unique[0]?.message\n    return (\n      <ul className=\"ml-4 flex list-disc flex-col gap-1\">\n        {unique.map(\n          (error, index) =>\n            error?.message && <li key={index}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      className={cn('mt-0.5 text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}
+{"version":3,"file":"field.js","names":["React"],"sources":["../../src/components/field.tsx"],"sourcesContent":["'use client'\n\nimport { cva } from 'class-variance-authority'\nimport * as React from 'react'\nimport { useId } from 'react'\nimport type {\n  SparkInputColor,\n  SparkInputStyle,\n  SparkLabelPosition,\n} from '../lib/theme-types'\nimport { cn } from '../utils/cn'\nimport { Separator } from './separator'\nimport { Skeleton } from './skeleton'\nimport { useTheme } from './theme'\n\ntype FieldContextValue = {\n  id: string\n  labelId: string\n  descriptionId: string\n  hasDescription: boolean\n  setHasDescription: (has: boolean) => void\n  readOnly: boolean\n  labelPosition: SparkLabelPosition\n  inputStyle: SparkInputStyle\n  inputColor: SparkInputColor\n}\n\nconst FieldContext = React.createContext<FieldContextValue | null>(null)\n\nexport function useFieldContext() {\n  return React.useContext(FieldContext)\n}\n\n// Field→Theme→default resolution + id/aria-describedby wiring, shared by every\n// control that can sit inside a Field (Input, SelectTrigger, …) so they can't\n// drift on how a style/color/id resolves. `variant` is the control's own\n// per-instance override (already normalized — e.g. Input maps its 'none' to\n// undefined before calling this).\nexport function useFieldControl(options?: {\n  id?: string\n  ariaDescribedBy?: string\n  variant?: SparkInputStyle\n}) {\n  const field = useFieldContext()\n  const theme = useTheme()\n  const id = options?.id ?? field?.id\n  const descriptionId = field?.hasDescription ? field.descriptionId : undefined\n  const ariaDescribedBy =\n    [descriptionId, options?.ariaDescribedBy].filter(Boolean).join(' ') ||\n    undefined\n  const inputStyle =\n    options?.variant ?? field?.inputStyle ?? theme.inputStyle ?? 'soft'\n  const inputColor = field?.inputColor ?? theme.inputColor ?? 'brand'\n  return { field, id, ariaDescribedBy, inputStyle, inputColor }\n}\n\nfunction FieldSet({ className, ...props }: React.ComponentProps<'fieldset'>) {\n  return (\n    <fieldset\n      data-slot=\"field-set\"\n      className={cn(\n        'flex flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldLegend({\n  className,\n  variant = 'legend',\n  ...props\n}: React.ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {\n  return (\n    <legend\n      data-slot=\"field-legend\"\n      data-variant={variant}\n      className={cn(\n        'mb-1.5 font-medium text-gray data-[variant=label]:text-sm data-[variant=legend]:text-base',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldGroup({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-group\"\n      className={cn(\n        'group/field-group flex w-full flex-col gap-[calc(var(--spark-layout-gap)*4)]',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldVariants = cva(\n  'group/field relative flex w-full flex-col data-[invalid=true]:text-error-active',\n  {\n    variants: {\n      labelPosition: {\n        // inset puts label + input inside one shell, so the shell is the box\n        // focus inside inset is the classic underline cue, not a shell ring\n        inset: 'gap-y-1 rounded-lg px-4 py-3',\n        outset: 'gap-y-2',\n      },\n      inputStyle: { soft: '', surface: '', outlined: '', ghost: '' },\n      inputColor: { brand: '', gray: '' },\n    },\n    compoundVariants: [\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'brand',\n        class:\n          'bg-input-base has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-input-base-hover',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'soft',\n        inputColor: 'gray',\n        class:\n          'bg-base-gray-soft has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-gray-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'brand',\n        class: 'border border-input bg-base-accent-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'surface',\n        inputColor: 'gray',\n        class: 'border border-input-gray bg-base-gray-surface',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'brand',\n        class: 'border border-input',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: 'outlined',\n        inputColor: 'gray',\n        class: 'border border-input-gray',\n      },\n      // ghost inset = bare label + underlined input; the input carries the line\n      {\n        labelPosition: 'inset',\n        inputStyle: 'ghost',\n        class: 'rounded-none px-0',\n      },\n      // shared inset states: filled shells swap bg, bordered shells swap border\n      // invalid hover deepens the error tint instead of falling back to accent\n      {\n        labelPosition: 'inset',\n        inputStyle: ['soft', 'surface'],\n        class:\n          'data-[disabled=true]:bg-base-gray-soft data-[invalid=true]:bg-base-error-soft data-[invalid=true]:has-[:is(input,textarea,[data-slot=select-trigger]):not(:disabled)]:hover:bg-red-a4',\n      },\n      {\n        labelPosition: 'inset',\n        inputStyle: ['surface', 'outlined'],\n        class:\n          'data-[disabled=true]:border-input-disabled data-[invalid=true]:border-input-invalid',\n      },\n    ],\n  },\n)\n\ninterface FieldProps extends React.ComponentProps<'div'> {\n  labelPosition?: SparkLabelPosition\n  inputStyle?: SparkInputStyle\n  inputColor?: SparkInputColor\n  readOnly?: boolean\n}\n\nfunction Field({\n  className,\n  children,\n  labelPosition: labelPositionProp,\n  inputStyle: inputStyleProp,\n  inputColor: inputColorProp,\n  readOnly = false,\n  ...props\n}: FieldProps) {\n  const id = useId()\n  const [hasDescription, setHasDescription] = React.useState(false)\n  // knobs are structural (they move the label / pick the box carrier), so they\n  // resolve here via the <Theme> context; props override per instance\n  const theme = useTheme()\n  const labelPosition = labelPositionProp ?? theme.labelPosition ?? 'inset'\n  const inputStyle = inputStyleProp ?? theme.inputStyle ?? 'soft'\n  const inputColor = inputColorProp ?? theme.inputColor ?? 'brand'\n  const fieldId = `field-${id}`\n  const labelId = `${fieldId}-label`\n  const value = React.useMemo<FieldContextValue>(\n    () => ({\n      id: fieldId,\n      labelId,\n      descriptionId: `${fieldId}-description`,\n      hasDescription,\n      setHasDescription,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    }),\n    [\n      fieldId,\n      labelId,\n      hasDescription,\n      readOnly,\n      labelPosition,\n      inputStyle,\n      inputColor,\n    ],\n  )\n\n  return (\n    <FieldContext.Provider value={value}>\n      <div\n        role=\"group\"\n        data-slot=\"field\"\n        data-label-position={labelPosition}\n        data-input-style={inputStyle}\n        data-input-color={inputColor}\n        aria-labelledby={readOnly ? labelId : undefined}\n        className={cn(\n          fieldVariants({ labelPosition, inputStyle, inputColor }),\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </div>\n    </FieldContext.Provider>\n  )\n}\n\nfunction FieldContent({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-content\"\n      className={cn(\n        'flex min-w-0 flex-1 flex-col gap-0.5 leading-snug',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nconst fieldLabelClassName =\n  'text-sm leading-5 font-normal text-gray-light transition-all group-data-[invalid=true]/field:text-error-active! motion-reduce:transition-none'\n\nfunction FieldLabel({\n  className,\n  htmlFor,\n  srOnly,\n  children,\n  ...props\n}: React.ComponentProps<'label'> & { srOnly?: boolean }) {\n  const field = useFieldContext()\n  const classNames = cn(\n    // labels stay full-contrast even when disabled — the control itself\n    // (dimmed text, gray shell) signals the state\n    fieldLabelClassName,\n    // visually hidden but kept in the a11y tree (still names + focuses the control)\n    srOnly && 'sr-only',\n    className,\n  )\n\n  if (field?.readOnly) {\n    return (\n      <div data-slot=\"field-label\" id={field.labelId} className={classNames}>\n        {children}\n      </div>\n    )\n  }\n\n  return (\n    <label\n      data-slot=\"field-label\"\n      className={classNames}\n      htmlFor={htmlFor ?? field?.id}\n      {...props}\n    >\n      {children}\n    </label>\n  )\n}\n\nfunction FieldValue({\n  className,\n  id,\n  title,\n  truncate,\n  children,\n  ...props\n}: React.ComponentProps<'div'> & { truncate?: boolean }) {\n  return (\n    <div\n      data-slot=\"field-value\"\n      id={id}\n      // truncated string values keep the full text reachable on hover\n      title={\n        title ??\n        (truncate && typeof children === 'string' ? children : undefined)\n      }\n      className={cn(\n        // values are content, not controls — disabled dims but stays ≥4.5:1\n        'min-h-8 w-full text-base text-gray tabular-nums group-data-[disabled=true]/field:opacity-70',\n        truncate\n          ? 'block truncate leading-8'\n          : 'inline-flex items-center wrap-anywhere whitespace-pre-wrap',\n        className,\n      )}\n      {...props}\n    >\n      {children}\n    </div>\n  )\n}\n\nfunction FieldSkeleton({\n  className,\n  labelClassName,\n  valueClassName,\n  truncate,\n  ...props\n}: React.ComponentProps<'div'> & {\n  truncate?: boolean\n  labelClassName?: string\n  valueClassName?: string\n}) {\n  return (\n    <div\n      data-slot=\"field-skeleton\"\n      aria-hidden=\"true\"\n      className={cn('flex w-full flex-col gap-y-1', className)}\n      {...props}\n    >\n      <Skeleton\n        data-slot=\"field-skeleton-label\"\n        className={cn('h-5 w-24', labelClassName)}\n      />\n      <Skeleton\n        data-slot=\"field-skeleton-value\"\n        className={cn(\n          'h-8 min-h-8 w-full',\n          truncate && 'max-w-full truncate',\n          valueClassName,\n        )}\n      />\n    </div>\n  )\n}\n\nfunction FieldTitle({ className, ...props }: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-title\"\n      className={cn(\n        'flex w-fit items-center gap-2 text-sm font-medium text-gray',\n        className,\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction FieldDescription({\n  className,\n  id,\n  ...props\n}: React.ComponentProps<'div'>) {\n  const field = useFieldContext()\n  const setHasDescription = field?.setHasDescription\n\n  React.useEffect(() => {\n    if (!setHasDescription) return\n    setHasDescription(true)\n    return () => setHasDescription(false)\n  }, [setHasDescription])\n\n  return (\n    <div\n      data-slot=\"field-description\"\n      id={id ?? field?.descriptionId}\n      className={cn('mt-0.5 text-sm leading-normal text-gray-light', className)}\n      {...props}\n    />\n  )\n}\n\nfunction FieldSeparator({\n  children,\n  className,\n  ...props\n}: React.ComponentProps<'div'>) {\n  return (\n    <div\n      data-slot=\"field-separator\"\n      data-content={!!children}\n      className={cn('relative -my-2 h-5 text-sm', className)}\n      {...props}\n    >\n      <Separator className=\"absolute inset-0 top-1/2\" />\n      {children && (\n        <span\n          className=\"relative mx-auto block w-fit bg-(--spark-background) px-2 text-gray-light\"\n          data-slot=\"field-separator-content\"\n        >\n          {children}\n        </span>\n      )}\n    </div>\n  )\n}\n\nfunction FieldError({\n  className,\n  children,\n  errors,\n  ...props\n}: React.ComponentProps<'div'> & {\n  errors?: Array<{ message?: string } | undefined>\n}) {\n  const content = React.useMemo(() => {\n    if (children) return children\n    if (!errors?.length) return null\n    const unique = [\n      ...new Map(errors.map((error) => [error?.message, error])).values(),\n    ]\n    if (unique.length === 1) return unique[0]?.message\n    return (\n      <ul className=\"ml-4 flex list-disc flex-col gap-1\">\n        {unique.map(\n          (error, index) =>\n            error?.message && <li key={index}>{error.message}</li>,\n        )}\n      </ul>\n    )\n  }, [children, errors])\n\n  if (!content) return null\n\n  return (\n    <div\n      role=\"alert\"\n      data-slot=\"field-error\"\n      className={cn('mt-0.5 text-sm font-normal text-error', className)}\n      {...props}\n    >\n      {content}\n    </div>\n  )\n}\n\nexport {\n  Field,\n  FieldContent,\n  FieldDescription,\n  FieldError,\n  FieldGroup,\n  FieldLabel,\n  FieldLegend,\n  FieldSeparator,\n  FieldSet,\n  FieldSkeleton,\n  FieldTitle,\n  FieldValue,\n}\nexport type { FieldProps }\n"],"mappings":"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"}

package/dist/components/icon.cjs

@@ -1,6 +1,7 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../chunk-DY84GLCh.cjs");
+const require_lib_accent_colors = require("../lib/accent-colors.cjs");
 const require_icons_material_symbol = require("../icons/material-symbol.cjs");
 let react = require("react");
 react = require_chunk.__toESM(react);
@@ -8,22 +9,24 @@ let react_jsx_runtime = require("react/jsx-runtime");
 let cnfast = require("cnfast");
 //#region src/components/icon.tsx
 const variantClasses = {
-	soft: "bg-[var(--color-gray-a3)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]",
-	surface: "border border-[color:var(--icon-bd,var(--color-gray-a6))] bg-[var(--color-gray-a2)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]",
-	solid: "bg-[var(--color-gray-12)] text-[color:var(--color-gray-1)]",
-	ghost: "[[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]",
-	outline: "border border-[color:var(--icon-bd,var(--color-gray-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]"
+	soft: "bg-(--icon-bg,var(--spark-a3)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]",
+	surface: "border border-[color:var(--icon-bd,var(--spark-a6))] bg-(--icon-bg,var(--spark-a2)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]",
+	solid: "bg-(--icon-bg,var(--spark-9)) text-(--icon-ink,var(--spark-contrast)) [[data-high-contrast]_&]:[--icon-bg:var(--spark-12)] [[data-high-contrast]_&]:[--icon-ink:var(--spark-1)]",
+	ghost: "[[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]",
+	outline: "border border-[color:var(--icon-bd,var(--spark-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]"
 };
 const sizeClasses = {
 	small: "size-6 [--spark-icon-size:calc(var(--spacing)*4)]",
-	default: "size-8 [--spark-icon-size:calc(var(--spacing)*5)]",
-	medium: "size-10 [--spark-icon-size:calc(var(--spacing)*6)]"
+	medium: "size-8 [--spark-icon-size:calc(var(--spacing)*5)]",
+	large: "size-10 [--spark-icon-size:calc(var(--spacing)*6)]",
+	xl: "size-12 [--spark-icon-size:calc(var(--spacing)*7)]"
 };
-function Icon({ className, name, children, variant = "soft", size = "default", ...props }) {
+function Icon({ className, name, children, variant = "soft", color = "neutral", size = "medium", ...props }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		"data-accent-color": require_lib_accent_colors.accentByColor[color],
 		"data-slot": "icon",
 		role: "aria-label" in props ? "img" : void 0,
-		className: (0, cnfast.cn)("box-border inline-flex shrink-0 items-center justify-center", "rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]", "text-[color:var(--icon-ink,var(--color-gray-a11))]", variantClasses[variant], sizeClasses[size], className),
+		className: (0, cnfast.cn)("box-border inline-flex shrink-0 items-center justify-center", "rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]", "text-[color:var(--icon-ink,var(--spark-a11))]", variantClasses[variant], sizeClasses[size], className),
 		...props,
 		children: children ?? (name ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_material_symbol.MaterialSymbol, { name }) : null)
 	});

package/dist/components/icon.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"icon.cjs","names":["MaterialSymbol"],"sources":["../../src/components/icon.tsx"],"sourcesContent":["import * as React from 'react'\nimport {\n  MaterialSymbol,\n  type MaterialSymbolIconName,\n} from '../icons/material-symbol'\nimport { cn } from '../utils/cn'\n\ninterface IconProps extends React.HTMLAttributes<HTMLSpanElement> {\n  name?: MaterialSymbolIconName\n  /** Fill treatment. Neutral (gray) by default; colour is opt-in via className. */\n  variant?: 'soft' | 'surface' | 'solid' | 'ghost' | 'outline'\n  size?: 'small' | 'default' | 'medium'\n}\n\n// Icon is a display element, so it is colour-INDEPENDENT: every variant paints with the\n// neutral gray scale (tracks the neutral knob, not the accent). Colour is a per-instance\n// className override (e.g. bg-base-error-soft text-error), which wins over the base via\n// tailwind-merge. Ink flows through --icon-ink so that override still wins under high\n// contrast, which only re-points the var: data-high-contrast (on the icon or an ancestor)\n// darkens the glyph a11→a12 and strengthens the surface/outline border →a11. solid is\n// already max-contrast, so HC leaves it unchanged. border-box keeps the frame size\n// constant when surface/outline add their 1px edge.\nconst variantClasses = {\n  soft: 'bg-[var(--color-gray-a3)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]',\n  surface:\n    'border border-[color:var(--icon-bd,var(--color-gray-a6))] bg-[var(--color-gray-a2)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]',\n  solid: 'bg-[var(--color-gray-12)] text-[color:var(--color-gray-1)]',\n  ghost: '[[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]',\n  outline:\n    'border border-[color:var(--icon-bd,var(--color-gray-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]',\n}\n\n// Frame + glyph sizes are spacing-derived so both track the scaling/spacing knobs.\nconst sizeClasses = {\n  small: 'size-6 [--spark-icon-size:calc(var(--spacing)*4)]',\n  default: 'size-8 [--spark-icon-size:calc(var(--spacing)*5)]',\n  medium: 'size-10 [--spark-icon-size:calc(var(--spacing)*6)]',\n}\n\nfunction Icon({\n  className,\n  name,\n  children,\n  variant = 'soft',\n  size = 'default',\n  ...props\n}: IconProps) {\n  return (\n    <span\n      data-slot=\"icon\"\n      // labeled = meaningful image; otherwise decorative (the glyph is aria-hidden)\n      role={'aria-label' in props ? 'img' : undefined}\n      className={cn(\n        'box-border inline-flex shrink-0 items-center justify-center',\n        // Button's pill idiom: radius=full → circle, other radii → rounded square\n        'rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]',\n        'text-[color:var(--icon-ink,var(--color-gray-a11))]',\n        variantClasses[variant],\n        sizeClasses[size],\n        className,\n      )}\n      {...props}\n    >\n      {children ?? (name ? <MaterialSymbol name={name} /> : null)}\n    </span>\n  )\n}\n\nIcon.displayName = 'Icon'\n\nexport { Icon }\nexport type { IconProps }\n"],"mappings":";;;;;;;;;AAsBA,MAAM,iBAAiB;CACrB,MAAM;CACN,SACE;CACF,OAAO;CACP,OAAO;CACP,SACE;AACJ;AAGA,MAAM,cAAc;CAClB,OAAO;CACP,SAAS;CACT,QAAQ;AACV;AAEA,SAAS,KAAK,EACZ,WACA,MACA,UACA,UAAU,QACV,OAAO,WACP,GAAG,SACS;CACZ,OACE,iBAAA,GAAA,kBAAA,KAAC,QAAD;EACE,aAAU;EAEV,MAAM,gBAAgB,QAAQ,QAAQ,KAAA;EACtC,YAAA,GAAA,OAAA,IACE,+DAEA,oEACA,sDACA,eAAe,UACf,YAAY,OACZ,SACF;EACA,GAAI;YAEH,aAAa,OAAO,iBAAA,GAAA,kBAAA,KAACA,8BAAAA,gBAAD,EAAsB,KAAO,CAAA,IAAI;CAClD,CAAA;AAEV;AAEA,KAAK,cAAc"}
+{"version":3,"file":"icon.cjs","names":["accentByColor","MaterialSymbol"],"sources":["../../src/components/icon.tsx"],"sourcesContent":["import * as React from 'react'\nimport {\n  MaterialSymbol,\n  type MaterialSymbolIconName,\n} from '../icons/material-symbol'\nimport { accentByColor, type SparkAccentColor } from '../lib/accent-colors'\nimport { cn } from '../utils/cn'\n\ninterface IconProps extends React.HTMLAttributes<HTMLSpanElement> {\n  name?: MaterialSymbolIconName\n  /** Fill treatment. */\n  variant?: 'soft' | 'surface' | 'solid' | 'ghost' | 'outline'\n  /** Colour axis, matching Button/Pill/Avatar. Neutral (gray) by default. */\n  color?: SparkAccentColor\n  size?: 'small' | 'medium' | 'large' | 'xl'\n}\n\n// Every variant reads its fill/ink/border off the accent scale (--spark-*), the same\n// indirection Button/Pill/Avatar use for their `color` prop — data-accent-color re-points\n// --spark-* to gray/red/green/orange, so `color` recolours all five variants without any\n// icon-specific colour plumbing. --icon-bg/--icon-ink/--icon-bd stay the outer override\n// (a consumer className still wins via tailwind-merge over either). data-high-contrast\n// (on the icon or an ancestor) darkens the glyph a11→a12 and strengthens the\n// surface/outline border →a11. solid pairs --spark-9 with --spark-contrast, the same\n// default pair every other `data-style='solid'` consumer uses (Button's own recipe is\n// literally `bg-(--spark-style-bg,var(--spark-9)) text-(--spark-style-fg,var(--spark-contrast))`)\n// — and boosts to --spark-12/--spark-1 under HC, spark-default.css's own designated\n// `[data-high-contrast] [data-style='solid']` pair, so solid gets the same HC step-up as\n// every other variant instead of statically sitting at what used to be *only* the HC value.\n// border-box keeps the frame size constant when surface/outline add their 1px edge.\nconst variantClasses = {\n  soft: 'bg-(--icon-bg,var(--spark-a3)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]',\n  surface:\n    'border border-[color:var(--icon-bd,var(--spark-a6))] bg-(--icon-bg,var(--spark-a2)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]',\n  solid:\n    'bg-(--icon-bg,var(--spark-9)) text-(--icon-ink,var(--spark-contrast)) [[data-high-contrast]_&]:[--icon-bg:var(--spark-12)] [[data-high-contrast]_&]:[--icon-ink:var(--spark-1)]',\n  ghost: '[[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]',\n  outline:\n    'border border-[color:var(--icon-bd,var(--spark-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]',\n}\n\n// Frame + glyph sizes are spacing-derived so both track the scaling/spacing knobs.\nconst sizeClasses = {\n  small: 'size-6 [--spark-icon-size:calc(var(--spacing)*4)]',\n  medium: 'size-8 [--spark-icon-size:calc(var(--spacing)*5)]',\n  large: 'size-10 [--spark-icon-size:calc(var(--spacing)*6)]',\n  xl: 'size-12 [--spark-icon-size:calc(var(--spacing)*7)]',\n}\n\nfunction Icon({\n  className,\n  name,\n  children,\n  variant = 'soft',\n  color = 'neutral',\n  size = 'medium',\n  ...props\n}: IconProps) {\n  return (\n    <span\n      data-accent-color={accentByColor[color]}\n      data-slot=\"icon\"\n      // labeled = meaningful image; otherwise decorative (the glyph is aria-hidden)\n      role={'aria-label' in props ? 'img' : undefined}\n      className={cn(\n        'box-border inline-flex shrink-0 items-center justify-center',\n        // Button's pill idiom: radius=full → circle, other radii → rounded square\n        'rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]',\n        'text-[color:var(--icon-ink,var(--spark-a11))]',\n        variantClasses[variant],\n        sizeClasses[size],\n        className,\n      )}\n      {...props}\n    >\n      {children ?? (name ? <MaterialSymbol name={name} /> : null)}\n    </span>\n  )\n}\n\nIcon.displayName = 'Icon'\n\nexport { Icon }\nexport type { IconProps }\n"],"mappings":";;;;;;;;;;AA8BA,MAAM,iBAAiB;CACrB,MAAM;CACN,SACE;CACF,OACE;CACF,OAAO;CACP,SACE;AACJ;AAGA,MAAM,cAAc;CAClB,OAAO;CACP,QAAQ;CACR,OAAO;CACP,IAAI;AACN;AAEA,SAAS,KAAK,EACZ,WACA,MACA,UACA,UAAU,QACV,QAAQ,WACR,OAAO,UACP,GAAG,SACS;CACZ,OACE,iBAAA,GAAA,kBAAA,KAAC,QAAD;EACE,qBAAmBA,0BAAAA,cAAc;EACjC,aAAU;EAEV,MAAM,gBAAgB,QAAQ,QAAQ,KAAA;EACtC,YAAA,GAAA,OAAA,IACE,+DAEA,oEACA,iDACA,eAAe,UACf,YAAY,OACZ,SACF;EACA,GAAI;YAEH,aAAa,OAAO,iBAAA,GAAA,kBAAA,KAACC,8BAAAA,gBAAD,EAAsB,KAAO,CAAA,IAAI;CAClD,CAAA;AAEV;AAEA,KAAK,cAAc"}

package/dist/components/icon.d.cts

@@ -1,20 +1,24 @@
 "use client";
 
+import { SparkAccentColor } from "../lib/accent-colors.cjs";
 import { MaterialSymbolIconName } from "../icons/material-symbol.cjs";
 import * as React$1 from "react";
 
 //#region src/components/icon.d.ts
 interface IconProps extends React$1.HTMLAttributes<HTMLSpanElement> {
   name?: MaterialSymbolIconName;
-  /** Fill treatment. Neutral (gray) by default; colour is opt-in via className. */
+  /** Fill treatment. */
   variant?: 'soft' | 'surface' | 'solid' | 'ghost' | 'outline';
-  size?: 'small' | 'default' | 'medium';
+  /** Colour axis, matching Button/Pill/Avatar. Neutral (gray) by default. */
+  color?: SparkAccentColor;
+  size?: 'small' | 'medium' | 'large' | 'xl';
 }
 declare function Icon({
   className,
   name,
   children,
   variant,
+  color,
   size,
   ...props
 }: IconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/icon.d.ts

@@ -1,20 +1,24 @@
 "use client";
 
+import { SparkAccentColor } from "../lib/accent-colors.js";
 import { MaterialSymbolIconName } from "../icons/material-symbol.js";
 import * as React$1 from "react";
 
 //#region src/components/icon.d.ts
 interface IconProps extends React$1.HTMLAttributes<HTMLSpanElement> {
   name?: MaterialSymbolIconName;
-  /** Fill treatment. Neutral (gray) by default; colour is opt-in via className. */
+  /** Fill treatment. */
   variant?: 'soft' | 'surface' | 'solid' | 'ghost' | 'outline';
-  size?: 'small' | 'default' | 'medium';
+  /** Colour axis, matching Button/Pill/Avatar. Neutral (gray) by default. */
+  color?: SparkAccentColor;
+  size?: 'small' | 'medium' | 'large' | 'xl';
 }
 declare function Icon({
   className,
   name,
   children,
   variant,
+  color,
   size,
   ...props
 }: IconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/icon.js

@@ -1,26 +1,29 @@
 "use client";
 import { cn } from "../utils/cn.js";
+import { accentByColor } from "../lib/accent-colors.js";
 import { MaterialSymbol } from "../icons/material-symbol.js";
 import "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/icon.tsx
 const variantClasses = {
-	soft: "bg-[var(--color-gray-a3)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]",
-	surface: "border border-[color:var(--icon-bd,var(--color-gray-a6))] bg-[var(--color-gray-a2)] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]",
-	solid: "bg-[var(--color-gray-12)] text-[color:var(--color-gray-1)]",
-	ghost: "[[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)]",
-	outline: "border border-[color:var(--icon-bd,var(--color-gray-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--color-gray-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--color-gray-a11)]"
+	soft: "bg-(--icon-bg,var(--spark-a3)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]",
+	surface: "border border-[color:var(--icon-bd,var(--spark-a6))] bg-(--icon-bg,var(--spark-a2)) [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]",
+	solid: "bg-(--icon-bg,var(--spark-9)) text-(--icon-ink,var(--spark-contrast)) [[data-high-contrast]_&]:[--icon-bg:var(--spark-12)] [[data-high-contrast]_&]:[--icon-ink:var(--spark-1)]",
+	ghost: "[[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)]",
+	outline: "border border-[color:var(--icon-bd,var(--spark-a8))] [[data-high-contrast]_&]:[--icon-ink:var(--spark-a12)] [[data-high-contrast]_&]:[--icon-bd:var(--spark-a11)]"
 };
 const sizeClasses = {
 	small: "size-6 [--spark-icon-size:calc(var(--spacing)*4)]",
-	default: "size-8 [--spark-icon-size:calc(var(--spacing)*5)]",
-	medium: "size-10 [--spark-icon-size:calc(var(--spacing)*6)]"
+	medium: "size-8 [--spark-icon-size:calc(var(--spacing)*5)]",
+	large: "size-10 [--spark-icon-size:calc(var(--spacing)*6)]",
+	xl: "size-12 [--spark-icon-size:calc(var(--spacing)*7)]"
 };
-function Icon({ className, name, children, variant = "soft", size = "default", ...props }) {
+function Icon({ className, name, children, variant = "soft", color = "neutral", size = "medium", ...props }) {
 	return /* @__PURE__ */ jsx("span", {
+		"data-accent-color": accentByColor[color],
 		"data-slot": "icon",
 		role: "aria-label" in props ? "img" : void 0,
-		className: cn("box-border inline-flex shrink-0 items-center justify-center", "rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]", "text-[color:var(--icon-ink,var(--color-gray-a11))]", variantClasses[variant], sizeClasses[size], className),
+		className: cn("box-border inline-flex shrink-0 items-center justify-center", "rounded-[max(var(--spark-rounded-lg),var(--spark-rounded-full))]", "text-[color:var(--icon-ink,var(--spark-a11))]", variantClasses[variant], sizeClasses[size], className),
 		...props,
 		children: children ?? (name ? /* @__PURE__ */ jsx(MaterialSymbol, { name }) : null)
 	});