@alfadocs/ui-kit 0.6.0 → 0.6.1

package/dist/_chunks/radio-group-Cz1a4QCA.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"radio-group-Cz1a4QCA.js","sources":["../../src/components/radio-group/radio-group.agent.ts","../../src/components/radio-group/radio-group.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — RadioGroup.                                            */\n/*                                                                        */\n/* See `src/docs/26-agent-readiness.mdx` for the contract.                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { RadioGroupHandle } from './radio-group';\n\nexport const radioGroupAgent: AgentAdapter<RadioGroupHandle> = {\n  id: 'radio-group',\n  capabilities: ['select_single'],\n  state: {\n    value: {\n      type: 'string',\n      descriptionKey: 'ui.agent.radioGroup.state.value',\n      description: 'Currently selected radio value, or empty string when none.',\n      read: (handle) => handle.getValue(),\n    },\n  },\n  actions: {\n    set_value: {\n      safety: 'write',\n      argsType: '{ value: string }',\n      descriptionKey: 'ui.agent.radioGroup.actions.setValue',\n      description: 'Select the radio with the given value.',\n      invoke: (handle, args: { value: string }) => {\n        handle.setValue(args.value);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'radio-group',\n      description: 'Marks the RadioGroup root.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n    item: {\n      attr: 'data-option-id',\n      description: 'Stable opaque value emitted on each rendered Radio child.',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n} from 'react';\nimport * as RadixRadioGroup from '@radix-ui/react-radio-group';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { AlertCircle } from 'lucide-react';\nimport {\n  RadioGroupInternalContext,\n  type RadioGroupInternalContextShape,\n  type RadioGroupVariant,\n} from './radio-group-context';\nimport { useDirection } from '../_shared/use-direction';\nimport { composeRefs } from '../_shared/compose-refs';\nimport { useAgentRegistration } from '../../agent';\nimport { radioGroupAgent } from './radio-group.agent';\n\n/** Agent-readiness curated handle for RadioGroup. */\nexport interface RadioGroupHandle {\n  getValue: () => string;\n  setValue: (value: string) => void;\n}\n\nconst radioGroupVariants = cva('ds:flex', {\n  variants: {\n    variant: {\n      vertical: 'ds:flex-col ds:gap-[var(--spacing-sm)]',\n      horizontal: 'ds:flex-row ds:flex-wrap ds:gap-[var(--spacing-md)]',\n      card: 'ds:flex-col ds:gap-[var(--spacing-md)]',\n    },\n  },\n  defaultVariants: {\n    variant: 'vertical',\n  },\n});\n\ntype RadixRootProps = ComponentPropsWithoutRef<typeof RadixRadioGroup.Root>;\n\nexport interface RadioGroupProps\n  extends\n    Omit<RadixRootProps, 'children' | 'orientation'>,\n    VariantProps<typeof radioGroupVariants> {\n  children: React.ReactNode;\n  variant?: RadioGroupVariant;\n  label?: string;\n  description?: string;\n  error?: string;\n  required?: boolean;\n}\n\nexport const RadioGroup = forwardRef<HTMLDivElement, RadioGroupProps>(\n  (\n    {\n      children,\n      variant = 'vertical',\n      label,\n      description,\n      error,\n      required,\n      disabled,\n      className,\n      id,\n      value,\n      defaultValue,\n      onValueChange,\n      ...props\n    },\n    ref,\n  ) => {\n    const baseId = useId();\n    const descriptionId = `${baseId}-description`;\n    const errorId = `${baseId}-error`;\n\n    const describedBy =\n      [description ? descriptionId : null, error ? errorId : null]\n        .filter(Boolean)\n        .join(' ') || undefined;\n\n    const orientation: 'vertical' | 'horizontal' =\n      variant === 'horizontal' ? 'horizontal' : 'vertical';\n\n    const ctxValue: RadioGroupInternalContextShape = useMemo(\n      () => ({ variant }),\n      [variant],\n    );\n\n    const descriptionNode = description ? (\n      <p id={descriptionId} className=\"type-body-sm ds:text-muted-foreground\">\n        {description}\n      </p>\n    ) : null;\n\n    const errorNode = error ? (\n      <p\n        id={errorId}\n        role=\"alert\"\n        className=\"ds:inline-flex ds:items-center ds:gap-[var(--spacing-xs)] type-body-sm ds:text-destructive\"\n      >\n        <AlertCircle aria-hidden=\"true\" className=\"ds:size-4 ds:shrink-0\" />\n        <span>{error}</span>\n      </p>\n    ) : null;\n\n    const rootRef = useRef<HTMLDivElement>(null);\n    const composedRef = composeRefs(ref, rootRef);\n    const dir = useDirection(rootRef);\n\n    const isControlled = value !== undefined;\n    const [internalValue, setInternalValue] = useState<string>(\n      defaultValue ?? '',\n    );\n    const currentValue = isControlled ? (value ?? '') : internalValue;\n    const currentValueRef = useRef<string>(currentValue);\n    currentValueRef.current = currentValue;\n\n    const handleValueChange = (next: string) => {\n      if (!isControlled) setInternalValue(next);\n      onValueChange?.(next);\n    };\n\n    const agentHandle = useMemo<RadioGroupHandle>(\n      () => ({\n        getValue: () => currentValueRef.current,\n        setValue: (next) => handleValueChange(next),\n      }),\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n      [isControlled, onValueChange],\n    );\n    useAgentRegistration(radioGroupAgent, agentHandle, id);\n\n    const root = (\n      <RadixRadioGroup.Root\n        ref={composedRef}\n        id={id}\n        orientation={orientation}\n        dir={dir}\n        disabled={disabled}\n        required={required}\n        value={isControlled ? value : undefined}\n        defaultValue={!isControlled ? defaultValue : undefined}\n        onValueChange={handleValueChange}\n        aria-describedby={describedBy}\n        aria-invalid={Boolean(error) || undefined}\n        aria-required={required || undefined}\n        className={radioGroupVariants({ variant, className })}\n        data-component=\"radio-group\"\n        data-component-id={id}\n        {...props}\n      >\n        {children}\n      </RadixRadioGroup.Root>\n    );\n\n    const outerClasses =\n      'ds:flex ds:flex-col ds:gap-[var(--spacing-xs)] ds:min-w-0';\n\n    if (label) {\n      return (\n        <RadioGroupInternalContext.Provider value={ctxValue}>\n          <fieldset className={`${outerClasses} ds:border-0 ds:p-0 ds:m-0`}>\n            <legend className=\"type-label ds:text-foreground ds:p-0\">\n              {label}\n              {required ? (\n                <span\n                  aria-hidden=\"true\"\n                  className=\"ds:text-destructive ds:ms-[var(--spacing-xs)]\"\n                >\n                  *\n                </span>\n              ) : null}\n            </legend>\n            {descriptionNode}\n            {root}\n            {errorNode}\n          </fieldset>\n        </RadioGroupInternalContext.Provider>\n      );\n    }\n\n    return (\n      <RadioGroupInternalContext.Provider value={ctxValue}>\n        <div className={outerClasses}>\n          {descriptionNode}\n          {root}\n          {errorNode}\n        </div>\n      </RadioGroupInternalContext.Provider>\n    );\n  },\n);\n\nRadioGroup.displayName = 'RadioGroup';\n"],"names":["radioGroupAgent","handle","args","radioGroupVariants","cva","RadioGroup","forwardRef","children","variant","label","description","error","required","disabled","className","id","value","defaultValue","onValueChange","props","ref","baseId","useId","descriptionId","errorId","describedBy","orientation","ctxValue","useMemo","descriptionNode","jsx","errorNode","jsxs","AlertCircle","rootRef","useRef","composedRef","composeRefs","dir","useDirection","isControlled","internalValue","setInternalValue","useState","currentValue","currentValueRef","handleValueChange","next","agentHandle","useAgentRegistration","root","RadixRadioGroup","outerClasses","RadioGroupInternalContext"],"mappings":"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"}