@alfadocs/ui-kit-debug 1.55.0 → 1.56.0

package/dist/_chunks/position-grid-CBB88EaH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-grid-CBB88EaH.js","sources":["../../src/components/position-grid/position-grid.agent.ts","../../src/components/position-grid/position-grid.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — PositionGrid.                                          */\n/*                                                                        */\n/* See `src/docs/26-agent-readiness.mdx` for the contract.                */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { PositionGridHandle } from './position-grid';\n\nexport const positionGridAgent: AgentAdapter<PositionGridHandle> = {\n  id: 'position-grid',\n  capabilities: ['select_single'],\n  state: {\n    value: {\n      type: 'string',\n      descriptionKey: 'ui.agent.positionGrid.state.value',\n      description:\n        'Currently selected position value (e.g. \"top-start\"), 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      argsSchema: {\n        type: 'object',\n        properties: { value: { type: 'string' } },\n        required: ['value'],\n      },\n      idempotent: true,\n      descriptionKey: 'ui.agent.positionGrid.actions.setValue',\n      description: 'Select the cell with the given position value.',\n      examples: [\n        {\n          args: { value: 'center' },\n          note: 'Selects the centre cell of the default 3×3 grid.',\n        },\n      ],\n      invoke: (handle, args: { value: string }) => {\n        handle.setValue(args.value);\n      },\n    },\n  },\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'position-grid',\n      description: 'Marks the PositionGrid 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: 'Position value emitted on each rendered cell.',\n    },\n  },\n};\n","import { forwardRef, useMemo, useRef, useState } from 'react';\nimport * as RadixRadioGroup from '@radix-ui/react-radio-group';\nimport { cva } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { useDirection } from '../_shared/use-direction';\nimport { composeRefs } from '../_shared/compose-refs';\nimport { useSelectOnArrow } from '../_shared/use-select-on-arrow';\nimport { useAgentRegistration } from '../../agent';\nimport { positionGridAgent } from './position-grid.agent';\n\n/** Agent-readiness curated handle for PositionGrid. */\nexport interface PositionGridHandle {\n  getValue: () => string;\n  setValue: (value: string) => void;\n  focus: () => void;\n}\n\n/** One selectable cell in the grid. */\nexport interface PositionGridOption {\n  /** Stable value emitted on selection (logical, e.g. `top-start`). */\n  value: string;\n  /** Accessible name for the cell — sighted users read the dot's position. */\n  label: string;\n}\n\nexport interface PositionGridProps {\n  /** Controlled selected value. Pair with onChange. */\n  value?: string;\n  /** Uncontrolled initial value. */\n  defaultValue?: string;\n  /** Fires with the newly-selected value. */\n  onChange?: (value: string) => void;\n  /**\n   * Override the default 9-cell set. When omitted, the default 3×3 anchor grid\n   * renders with bundled `positionGrid.*` labels. Cells flow in array order\n   * across the three columns.\n   */\n  positions?: PositionGridOption[];\n  /** Native form name for the underlying radio group. */\n  name?: string;\n  /** Disables every cell. */\n  disabled?: boolean;\n  id?: string;\n  className?: string;\n  /** Group accessible name. Defaults to the bundled `positionGrid.groupLabel`. */\n  'aria-label'?: string;\n}\n\n/** Default 3×3 anchor set. `labelKey` resolves against the bundled\n *  `positionGrid` i18n root; values use logical start/end naming (never\n *  left/right), so the layout mirrors correctly under `dir=\"rtl\"`. */\nconst DEFAULT_POSITIONS: ReadonlyArray<{ value: string; labelKey: string }> = [\n  { value: 'top-start', labelKey: 'topStart' },\n  { value: 'top', labelKey: 'top' },\n  { value: 'top-end', labelKey: 'topEnd' },\n  { value: 'start', labelKey: 'start' },\n  { value: 'center', labelKey: 'center' },\n  { value: 'end', labelKey: 'end' },\n  { value: 'bottom-start', labelKey: 'bottomStart' },\n  { value: 'bottom', labelKey: 'bottom' },\n  { value: 'bottom-end', labelKey: 'bottomEnd' },\n];\n\n// grid-cols-3 is intentional: the picker is a fixed-column anchor grid; custom\n// `positions` flow across the same three columns in array order.\nconst gridVariants = cva(\n  'ds:grid ds:grid-cols-3 ds:gap-[var(--spacing-2xs)] ds:w-fit',\n);\n\nconst cellVariants = cva(\n  [\n    'ds:group ds:relative ds:inline-flex ds:items-center ds:justify-center ds:shrink-0',\n    'ds:aspect-square ds:min-h-[var(--min-target-size)] ds:min-w-[var(--min-target-size)]',\n    'ds:rounded-[var(--radius-md)] ds:border ds:border-border ds:bg-background',\n    'ds:cursor-pointer',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:hover:border-ring',\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]:border-primary',\n    'ds:data-[state=checked]:bg-[color-mix(in_srgb,var(--accent)_8%,transparent)]',\n    'ds:data-[disabled]:border-muted',\n  ].join(' '),\n);\n\nconst markerVariants = cva(\n  [\n    'ds:size-2.5 ds:rounded-full ds:bg-muted-foreground',\n    'ds:transition-colors ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n    'ds:group-data-[state=checked]:bg-primary',\n    'ds:group-data-[disabled]:bg-muted',\n  ].join(' '),\n);\n\nexport const PositionGrid = forwardRef<HTMLDivElement, PositionGridProps>(\n  function PositionGrid(\n    {\n      value,\n      defaultValue,\n      onChange,\n      positions,\n      name,\n      disabled,\n      id,\n      className,\n      'aria-label': ariaLabel,\n    },\n    ref,\n  ) {\n    const { t } = useTranslation('ui');\n\n    const rootRef = useRef<HTMLDivElement>(null);\n    const composedRef = composeRefs(ref, rootRef);\n    // Pass the resolved direction to Radix so arrow-key navigation (and the\n    // CSS grid's inline flow) mirror correctly under dir=\"rtl\".\n    const dir = useDirection(rootRef);\n    const selectOnArrow = useSelectOnArrow();\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 items = useMemo<PositionGridOption[]>(\n      () =>\n        positions ??\n        DEFAULT_POSITIONS.map((p) => ({\n          value: p.value,\n          label: t(`positionGrid.${p.labelKey}`),\n        })),\n      [positions, t],\n    );\n\n    const groupLabel = ariaLabel ?? t('positionGrid.groupLabel');\n\n    const handleValueChange = (next: string) => {\n      selectOnArrow.noteSelection();\n      if (!isControlled) setInternalValue(next);\n      onChange?.(next);\n    };\n\n    const agentHandle = useMemo<PositionGridHandle>(\n      () => ({\n        getValue: () => currentValueRef.current,\n        setValue: (next) => handleValueChange(next),\n        focus: () => {\n          const root = rootRef.current;\n          if (!root) return;\n          const checked = root.querySelector<HTMLElement>(\n            '[role=\"radio\"][aria-checked=\"true\"]',\n          );\n          const target =\n            checked ?? root.querySelector<HTMLElement>('[role=\"radio\"]');\n          target?.focus();\n        },\n      }),\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n      [isControlled, onChange],\n    );\n    useAgentRegistration(positionGridAgent, agentHandle, id);\n\n    return (\n      <RadixRadioGroup.Root\n        ref={composedRef}\n        id={id}\n        name={name}\n        dir={dir}\n        disabled={disabled}\n        value={isControlled ? value : undefined}\n        defaultValue={!isControlled ? defaultValue : undefined}\n        onValueChange={handleValueChange}\n        onKeyDown={selectOnArrow.onKeyDown}\n        aria-label={groupLabel}\n        className={gridVariants({ className })}\n        data-component=\"position-grid\"\n        data-component-id={id}\n      >\n        {items.map((pos) => (\n          <RadixRadioGroup.Item\n            key={pos.value}\n            value={pos.value}\n            aria-label={pos.label}\n            data-option-id={pos.value}\n            className={cellVariants()}\n          >\n            <span aria-hidden=\"true\" className={markerVariants()} />\n          </RadixRadioGroup.Item>\n        ))}\n      </RadixRadioGroup.Root>\n    );\n  },\n);\n\nPositionGrid.displayName = 'PositionGrid';\n\nexport { gridVariants as positionGridVariants };\n"],"names":["positionGridAgent","handle","args","DEFAULT_POSITIONS","gridVariants","cva","cellVariants","markerVariants","PositionGrid","forwardRef","value","defaultValue","onChange","positions","name","disabled","id","className","ariaLabel","ref","t","useTranslation","rootRef","useRef","composedRef","composeRefs","dir","useDirection","selectOnArrow","useSelectOnArrow","isControlled","internalValue","setInternalValue","useState","currentValue","currentValueRef","items","useMemo","p","groupLabel","handleValueChange","next","agentHandle","root","target","useAgentRegistration","jsx","RadixRadioGroup","pos"],"mappings":"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"}

package/dist/_chunks/{practice-results-DxOgbPDy.js → practice-results-Dhbo-fc_.js}

@@ -9,7 +9,7 @@ import { D } from "./dropdown-menu-BQSNVp4x.js";
 import { E as st } from "./empty-state-gNG3qYCX.js";
 import { M as it } from "./map-view-CO2v0hfp.js";
 import { R as Ne } from "./rating-C1Vrmpsi.js";
-import { S as I } from "./sheet-CNFW8mYZ.js";
+import { S as I } from "./sheet-C7SwIxwB.js";
 import { S as rt } from "./skeleton-B1KTdJ4N.js";
 import { S as ot } from "./spinner-CoflYlEx.js";
 import { B as $ } from "./badge-hnBt8o7n.js";
@@ -1742,4 +1742,4 @@ export {
   Ot as P,
   bt as p
 };
-//# sourceMappingURL=practice-results-DxOgbPDy.js.map
+//# sourceMappingURL=practice-results-Dhbo-fc_.js.map