@alfadocs/ui-kit-debug 0.4.2 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit-debug",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe. (debug build — identical runtime to @alfadocs/ui-kit, ships source maps for symbolication).",
   "license": "BUSL-1.1",

package/dist/_chunks/checkbox-CtPM6Rup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkbox-CtPM6Rup.js","sources":["../../src/components/checkbox/checkbox-group-context.ts","../../src/components/checkbox/checkbox.agent.ts","../../src/components/checkbox/checkbox.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport interface CheckboxGroupContextShape {\n  name?: string;\n  value: Set<string>;\n  toggle: (itemValue: string) => void;\n  disabled: boolean;\n}\n\nexport const CheckboxGroupContext =\n  createContext<CheckboxGroupContextShape | null>(null);\n\nexport function useCheckboxGroup(): CheckboxGroupContextShape | null {\n  return useContext(CheckboxGroupContext);\n}\n","/* -------------------------------------------------------------------- */\n/* Agent adapter — Checkbox.                                              */\n/*                                                                        */\n/* See `src/docs/26-agent-readiness.mdx` for the contract.                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { CheckboxHandle } from './checkbox';\n\nexport const checkboxAgent: AgentAdapter<CheckboxHandle> = {\n  id: 'checkbox',\n  capabilities: ['select_single'],\n  state: {\n    checked: {\n      type: 'boolean | \"indeterminate\"',\n      descriptionKey: 'ui.agent.checkbox.state.checked',\n      description: 'Current checked state.',\n      read: (handle) => handle.getChecked(),\n    },\n  },\n  actions: {\n    set_checked: {\n      safety: 'write',\n      argsType: '{ checked: boolean | \"indeterminate\" }',\n      descriptionKey: 'ui.agent.checkbox.actions.setChecked',\n      description: 'Set the checked state to a specific value.',\n      invoke: (handle, args: { checked: boolean | 'indeterminate' }) => {\n        handle.setChecked(args.checked);\n      },\n    },\n    toggle: {\n      safety: 'write',\n      descriptionKey: 'ui.agent.checkbox.actions.toggle',\n      description: 'Flip the checked state between checked and unchecked.',\n      invoke: (handle) => {\n        handle.toggle();\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'checkbox',\n      description: 'Marks the Checkbox wrapper.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description: 'Sourced from the id prop.',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n} from 'react';\nimport * as RadixCheckbox from '@radix-ui/react-checkbox';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useCheckboxGroup } from './checkbox-group-context';\nimport { Tooltip } from '../tooltip';\nimport { useAgentRegistration } from '../../agent';\nimport { checkboxAgent } from './checkbox.agent';\n\n/** Agent-readiness curated handle for Checkbox. */\nexport interface CheckboxHandle {\n  getChecked: () => boolean | 'indeterminate';\n  setChecked: (checked: boolean | 'indeterminate') => void;\n  toggle: () => void;\n}\n\nconst drawClasses = [\n  'ds:[stroke-dasharray:1] ds:[stroke-dashoffset:1]',\n  'ds:animate-[checkbox-indicator-draw_var(--animation-duration)_ease-out_forwards]',\n].join(' ');\n\nfunction CheckIcon({ className }: { className?: string }) {\n  return (\n    <svg\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      strokeLinejoin=\"round\"\n      aria-hidden=\"true\"\n      data-slot=\"checkbox-check-icon\"\n      className={className}\n    >\n      <path pathLength=\"1\" d=\"M5 12l5 5L20 7\" className={drawClasses} />\n    </svg>\n  );\n}\n\nfunction IndeterminateIcon({ className }: { className?: string }) {\n  return (\n    <svg\n      viewBox=\"0 0 24 24\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      strokeWidth=\"3\"\n      strokeLinecap=\"round\"\n      aria-hidden=\"true\"\n      data-slot=\"checkbox-indeterminate-icon\"\n      className={className}\n    >\n      <path pathLength=\"1\" d=\"M5 12h14\" className={drawClasses} />\n    </svg>\n  );\n}\n\nconst checkboxVariants = cva(\n  [\n    'ds:inline-flex ds:items-center ds:justify-center ds:shrink-0',\n    'ds:border ds:border-border ds:rounded-[var(--radius-sm)] ds:bg-background',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid',\n    'ds:focus-visible:outline-ring ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]',\n    'ds:disabled:cursor-not-allowed ds:disabled:opacity-50',\n    'ds:data-[state=checked]:bg-primary ds:data-[state=checked]:border-primary ds:data-[state=checked]:text-primary-foreground',\n    'ds:data-[state=indeterminate]:bg-primary ds:data-[state=indeterminate]:border-primary ds:data-[state=indeterminate]:text-primary-foreground',\n    'ds:relative ds:before:absolute ds:before:inset-[calc((var(--min-target-size)-100%)/-2)] ds:before:content-[\"\"]',\n  ].join(' '),\n  {\n    variants: {\n      size: {\n        sm: 'ds:size-3.5',\n        md: 'ds:size-4',\n        lg: 'ds:size-5',\n      },\n    },\n    defaultVariants: {\n      size: 'md',\n    },\n  },\n);\n\ntype RadixRootProps = ComponentPropsWithoutRef<typeof RadixCheckbox.Root>;\n\nexport interface CheckboxProps\n  extends\n    Omit<RadixRootProps, 'checked' | 'onCheckedChange' | 'children'>,\n    VariantProps<typeof checkboxVariants> {\n  label: string;\n  checked?: boolean | 'indeterminate';\n  onCheckedChange?: (checked: boolean | 'indeterminate') => void;\n  size?: 'sm' | 'md' | 'lg';\n  disabledReason?: string;\n  value?: string;\n}\n\nexport const Checkbox = forwardRef<HTMLButtonElement, CheckboxProps>(\n  (\n    {\n      label,\n      checked,\n      onCheckedChange,\n      size = 'md',\n      disabled,\n      disabledReason,\n      name,\n      value,\n      id,\n      className,\n      ...props\n    },\n    ref,\n  ) => {\n    const generatedId = useId();\n    const checkboxId = id ?? generatedId;\n    const group = useCheckboxGroup();\n\n    const inGroup = group !== null && value !== undefined;\n    const [internalChecked, setInternalChecked] = useState<\n      boolean | 'indeterminate'\n    >(checked ?? false);\n    const isControlled = checked !== undefined;\n    const ownChecked = isControlled ? checked : internalChecked;\n    const effectiveChecked = inGroup ? group.value.has(value) : ownChecked;\n    const effectiveOnChange = inGroup\n      ? () => group.toggle(value)\n      : (next: boolean | 'indeterminate') => {\n          if (!isControlled) setInternalChecked(next);\n          onCheckedChange?.(next);\n        };\n    const effectiveName = group?.name ?? name;\n    const effectiveDisabled = group?.disabled || disabled;\n\n    const checkedRef = useRef<boolean | 'indeterminate'>(\n      effectiveChecked ?? false,\n    );\n    checkedRef.current = effectiveChecked ?? false;\n\n    const agentHandle = useMemo<CheckboxHandle>(\n      () => ({\n        getChecked: () => checkedRef.current,\n        setChecked: (next) => {\n          if (inGroup) {\n            // Inside a group: toggle implements set via the group context.\n            const isOn =\n              checkedRef.current === true ||\n              checkedRef.current === 'indeterminate';\n            const want = next === true || next === 'indeterminate';\n            if (isOn !== want) group.toggle(value);\n            return;\n          }\n          if (!isControlled) setInternalChecked(next);\n          onCheckedChange?.(next);\n        },\n        toggle: () => {\n          if (inGroup) {\n            group.toggle(value);\n            return;\n          }\n          const next =\n            checkedRef.current === true ||\n            checkedRef.current === 'indeterminate'\n              ? false\n              : true;\n          if (!isControlled) setInternalChecked(next);\n          onCheckedChange?.(next);\n        },\n      }),\n      [inGroup, group, value, isControlled, onCheckedChange],\n    );\n    useAgentRegistration(checkboxAgent, agentHandle, id);\n\n    const iconSizeClass =\n      size === 'sm' ? 'ds:size-3' : size === 'lg' ? 'ds:size-4' : 'ds:size-3.5';\n\n    const labelClasses = [\n      'type-label ds:text-foreground ds:select-none',\n      effectiveDisabled\n        ? 'ds:cursor-not-allowed ds:opacity-50'\n        : 'ds:cursor-pointer',\n    ].join(' ');\n\n    const content = (\n      <div\n        data-component=\"checkbox\"\n        data-component-id={id}\n        data-option-id={value}\n        className=\"ds:inline-flex ds:items-center ds:gap-[var(--spacing-sm)]\"\n      >\n        <RadixCheckbox.Root\n          ref={ref}\n          id={checkboxId}\n          checked={effectiveChecked}\n          onCheckedChange={effectiveOnChange}\n          disabled={effectiveDisabled}\n          aria-disabled={effectiveDisabled || undefined}\n          name={effectiveName}\n          value={value}\n          className={checkboxVariants({ size, className })}\n          {...props}\n        >\n          <RadixCheckbox.Indicator>\n            {effectiveChecked === 'indeterminate' ? (\n              <IndeterminateIcon className={iconSizeClass} />\n            ) : (\n              <CheckIcon className={iconSizeClass} />\n            )}\n          </RadixCheckbox.Indicator>\n        </RadixCheckbox.Root>\n        <label htmlFor={checkboxId} className={labelClasses}>\n          {label}\n        </label>\n      </div>\n    );\n\n    if (effectiveDisabled && disabledReason) {\n      return <Tooltip label={disabledReason}>{content}</Tooltip>;\n    }\n\n    return content;\n  },\n);\n\nCheckbox.displayName = 'Checkbox';\n"],"names":["CheckboxGroupContext","createContext","useCheckboxGroup","useContext","checkboxAgent","handle","args","drawClasses","CheckIcon","className","jsx","IndeterminateIcon","checkboxVariants","cva","Checkbox","forwardRef","label","checked","onCheckedChange","size","disabled","disabledReason","name","value","id","props","ref","generatedId","useId","checkboxId","group","inGroup","internalChecked","setInternalChecked","useState","isControlled","effectiveChecked","effectiveOnChange","next","effectiveName","effectiveDisabled","checkedRef","useRef","agentHandle","useMemo","useAgentRegistration","iconSizeClass","labelClasses","content","jsxs","RadixCheckbox","Tooltip"],"mappings":";;;;;;AASO,MAAMA,IACXC,EAAgD,IAAI;AAE/C,SAASC,IAAqD;AACnE,SAAOC,EAAWH,CAAoB;AACxC;ACLO,MAAMI,IAA8C;AAAA,EACzD,IAAI;AAAA,EACJ,cAAc,CAAC,eAAe;AAAA,EAC9B,OAAO;AAAA,IACL,SAAS;AAAA,MACP,MAAM;AAAA,MACN,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,MAAM,CAACC,MAAWA,EAAO,WAAA;AAAA,IAAW;AAAA,EACtC;AAAA,EAEF,SAAS;AAAA,IACP,aAAa;AAAA,MACX,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,QAAQ,CAACA,GAAQC,MAAiD;AAChE,QAAAD,EAAO,WAAWC,EAAK,OAAO;AAAA,MAChC;AAAA,IAAA;AAAA,IAEF,QAAQ;AAAA,MACN,QAAQ;AAAA,MACR,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,QAAQ,CAACD,MAAW;AAClB,QAAAA,EAAO,OAAA;AAAA,MACT;AAAA,IAAA;AAAA,EACF;AAAA,EAEF,UAAU;AAAA,IACR,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IAAA;AAAA,IAEf,YAAY;AAAA,MACV,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,aAAa;AAAA,IAAA;AAAA,EACf;AAEJ,GC7BME,IAAc;AAAA,EAClB;AAAA,EACA;AACF,EAAE,KAAK,GAAG;AAEV,SAASC,EAAU,EAAE,WAAAC,KAAqC;AACxD,SACE,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,QAAO;AAAA,MACP,aAAY;AAAA,MACZ,eAAc;AAAA,MACd,gBAAe;AAAA,MACf,eAAY;AAAA,MACZ,aAAU;AAAA,MACV,WAAAD;AAAA,MAEA,4BAAC,QAAA,EAAK,YAAW,KAAI,GAAE,kBAAiB,WAAWF,EAAA,CAAa;AAAA,IAAA;AAAA,EAAA;AAGtE;AAEA,SAASI,EAAkB,EAAE,WAAAF,KAAqC;AAChE,SACE,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,QAAO;AAAA,MACP,aAAY;AAAA,MACZ,eAAc;AAAA,MACd,eAAY;AAAA,MACZ,aAAU;AAAA,MACV,WAAAD;AAAA,MAEA,4BAAC,QAAA,EAAK,YAAW,KAAI,GAAE,YAAW,WAAWF,EAAA,CAAa;AAAA,IAAA;AAAA,EAAA;AAGhE;AAEA,MAAMK,IAAmBC;AAAA,EACvB;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,EACA,KAAK,GAAG;AAAA,EACV;AAAA,IACE,UAAU;AAAA,MACR,MAAM;AAAA,QACJ,IAAI;AAAA,QACJ,IAAI;AAAA,QACJ,IAAI;AAAA,MAAA;AAAA,IACN;AAAA,IAEF,iBAAiB;AAAA,MACf,MAAM;AAAA,IAAA;AAAA,EACR;AAEJ,GAgBaC,IAAWC;AAAA,EACtB,CACE;AAAA,IACE,OAAAC;AAAA,IACA,SAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,MAAAC,IAAO;AAAA,IACP,UAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,MAAAC;AAAA,IACA,OAAAC;AAAA,IACA,IAAAC;AAAA,IACA,WAAAf;AAAA,IACA,GAAGgB;AAAA,EAAA,GAELC,MACG;AACH,UAAMC,IAAcC,EAAA,GACdC,IAAaL,KAAMG,GACnBG,IAAQ5B,EAAA,GAER6B,IAAUD,MAAU,QAAQP,MAAU,QACtC,CAACS,GAAiBC,CAAkB,IAAIC,EAE5CjB,KAAW,EAAK,GACZkB,IAAelB,MAAY,QAE3BmB,IAAmBL,IAAUD,EAAM,MAAM,IAAIP,CAAK,IADrCY,IAAelB,IAAUe,GAEtCK,IAAoBN,IACtB,MAAMD,EAAM,OAAOP,CAAK,IACxB,CAACe,MAAoC;AACnC,MAAKH,KAAcF,EAAmBK,CAAI,GAC1CpB,KAAA,QAAAA,EAAkBoB;AAAA,IACpB,GACEC,KAAgBT,KAAA,gBAAAA,EAAO,SAAQR,GAC/BkB,KAAoBV,KAAA,gBAAAA,EAAO,aAAYV,GAEvCqB,IAAaC;AAAA,MACjBN,KAAoB;AAAA,IAAA;AAEtB,IAAAK,EAAW,UAAUL,KAAoB;AAEzC,UAAMO,IAAcC;AAAA,MAClB,OAAO;AAAA,QACL,YAAY,MAAMH,EAAW;AAAA,QAC7B,YAAY,CAACH,MAAS;AACpB,cAAIP,GAAS;AAMX,aAHEU,EAAW,YAAY,MACvBA,EAAW,YAAY,sBACZH,MAAS,MAAQA,MAAS,oBACpBR,EAAM,OAAOP,CAAK;AACrC;AAAA,UACF;AACA,UAAKY,KAAcF,EAAmBK,CAAI,GAC1CpB,KAAA,QAAAA,EAAkBoB;AAAA,QACpB;AAAA,QACA,QAAQ,MAAM;AACZ,cAAIP,GAAS;AACX,YAAAD,EAAM,OAAOP,CAAK;AAClB;AAAA,UACF;AACA,gBAAMe,IACJ,EAAAG,EAAW,YAAY,MACvBA,EAAW,YAAY;AAGzB,UAAKN,KAAcF,EAAmBK,CAAI,GAC1CpB,KAAA,QAAAA,EAAkBoB;AAAA,QACpB;AAAA,MAAA;AAAA,MAEF,CAACP,GAASD,GAAOP,GAAOY,GAAcjB,CAAe;AAAA,IAAA;AAEvD,IAAA2B,EAAqBzC,GAAeuC,GAAanB,CAAE;AAEnD,UAAMsB,IACJ3B,MAAS,OAAO,cAAcA,MAAS,OAAO,cAAc,eAExD4B,IAAe;AAAA,MACnB;AAAA,MACAP,IACI,wCACA;AAAA,IAAA,EACJ,KAAK,GAAG,GAEJQ,IACJ,gBAAAC;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,kBAAe;AAAA,QACf,qBAAmBzB;AAAA,QACnB,kBAAgBD;AAAA,QAChB,WAAU;AAAA,QAEV,UAAA;AAAA,UAAA,gBAAAb;AAAA,YAACwC,EAAc;AAAA,YAAd;AAAA,cACC,KAAAxB;AAAA,cACA,IAAIG;AAAA,cACJ,SAASO;AAAA,cACT,iBAAiBC;AAAA,cACjB,UAAUG;AAAA,cACV,iBAAeA,KAAqB;AAAA,cACpC,MAAMD;AAAA,cACN,OAAAhB;AAAA,cACA,WAAWX,EAAiB,EAAE,MAAAO,GAAM,WAAAV,GAAW;AAAA,cAC9C,GAAGgB;AAAA,cAEJ,UAAA,gBAAAf,EAACwC,EAAc,WAAd,EACE,gBAAqB,kBACpB,gBAAAxC,EAACC,GAAA,EAAkB,WAAWmC,GAAe,IAE7C,gBAAApC,EAACF,GAAA,EAAU,WAAWsC,GAAe,EAAA,CAEzC;AAAA,YAAA;AAAA,UAAA;AAAA,4BAED,SAAA,EAAM,SAASjB,GAAY,WAAWkB,GACpC,UAAA/B,EAAA,CACH;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAIJ,WAAIwB,KAAqBnB,IAChB,gBAAAX,EAACyC,GAAA,EAAQ,OAAO9B,GAAiB,UAAA2B,GAAQ,IAG3CA;AAAA,EACT;AACF;AAEAlC,EAAS,cAAc;"}