{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "knob",
  "title": "Knob",
  "author": "superzero11 <https://github.com/superzero11/uiset>",
  "description": "A rotary control built as a UI SDK primitive: drag, arrow keys, log scales, double-click reset, agent actions.",
  "dependencies": [
    "@ui-sdk/core@0.1.0-beta.5",
    "@ui-sdk/react@0.1.0-beta.5"
  ],
  "registryDependencies": [
    "https://uiset.dev/r/uiset.json"
  ],
  "files": [
    {
      "path": "registry/uiset/ui/knob.tsx",
      "content": "\"use client\"\n\nimport { createParts, type PartProps } from \"@ui-sdk/react/primitive\"\nimport { useId } from \"react\"\nimport { knob, type KnobOptions } from \"./studio/knob\"\nimport \"./studio/knob.css\"\n\nconst parts = createParts(knob, { root: \"div\", indicator: \"span\", value: \"span\" })\n\ntype KnobProps = KnobOptions &\n  Omit<PartProps<\"div\">, \"defaultValue\" | \"onChange\" | \"children\"> & {\n    label: string\n    hideLabel?: boolean\n    hideValue?: boolean\n  }\n\nfunction Knob({\n  label,\n  hideLabel = false,\n  hideValue = false,\n  className,\n  ...props\n}: KnobProps) {\n  const labelId = useId()\n  return (\n    <div className={[\"knob-field\", className].filter(Boolean).join(\" \")}>\n      <span id={labelId} className=\"knob-label\" hidden={hideLabel}>\n        {label}\n      </span>\n      <parts.Root\n        aria-labelledby={hideLabel ? undefined : labelId}\n        aria-label={hideLabel ? label : undefined}\n        {...props}\n      >\n        <parts.Indicator />\n        {!hideValue && <parts.Value>{({ text }) => text}</parts.Value>}\n      </parts.Root>\n    </div>\n  )\n}\n\nconst KnobRoot = parts.Root\nconst KnobIndicator = parts.Indicator\nconst KnobValue = parts.Value\n\nexport { Knob, KnobIndicator, KnobRoot, KnobValue }\nexport type { KnobProps }\n",
      "type": "registry:ui",
      "target": "@ui/knob.tsx"
    },
    {
      "path": "registry/uiset/ui/studio/knob.ts",
      "content": "import {\n  bindDrag,\n  createChange,\n  createCommit,\n  css,\n  definePrimitive,\n  dragThreshold,\n  isRTL,\n  type ChangeDetails,\n  type CommitDetails,\n} from \"@ui-sdk/core\"\nimport {\n  clamp,\n  formatNumber,\n  fractionOf,\n  scrubTo,\n  stepBy,\n  stepFromKey,\n  valueAt,\n} from \"@ui-sdk/core/number\"\n\ntype KnobReason = \"drag\" | \"step-key\" | \"imperative\" | \"double-press\"\ntype KnobScale = \"linear\" | \"log\"\n\ntype KnobOptions = {\n  value?: number\n  defaultValue?: number\n  min?: number\n  max?: number\n  step?: number\n  largeStep?: number\n  scale?: KnobScale\n  disabled?: boolean\n  locale?: string\n  format?: Intl.NumberFormatOptions | ((value: number) => string)\n  onValueChange?: (value: number, details: ChangeDetails<KnobReason>) => void\n  onValueCommit?: (value: number, details: CommitDetails<KnobReason>) => void\n}\n\ntype KnobFormat = KnobOptions[\"format\"]\n\n// Pixels of vertical travel for the full range; Shift makes it six times finer.\nconst travel = 220\n\nfunction textOf(value: number, format: KnobFormat, locale: string | undefined) {\n  if (typeof format === \"function\") return format(value)\n  return formatNumber(value, locale ?? \"en-US\", format ?? { maximumFractionDigits: 2 })\n}\n\n/** @internal Left out of @uiset/web's declarations: its type names UI SDK internals. */\nconst knob = definePrimitive({\n  name: \"knob\",\n  options: {\n    value: \"number\",\n    defaultValue: \"number\",\n    min: \"number\",\n    max: \"number\",\n    step: \"number\",\n    largeStep: \"number\",\n    scale: \"string\",\n    disabled: \"boolean\",\n    locale: \"string\",\n    format: \"value\",\n    onValueChange: \"callback\",\n    onValueCommit: \"callback\",\n  },\n  controlled: [\"value\"],\n  commits: [\"value\"],\n  state: (options: KnobOptions) => {\n    const min = options.min ?? 0\n    const max = options.max ?? 100\n    return {\n      value: clamp(options.value ?? options.defaultValue ?? min, min, max),\n      initial: clamp(options.defaultValue ?? options.value ?? min, min, max),\n      min,\n      max,\n      step: options.step ?? 1,\n      largeStep: options.largeStep,\n      scale: options.scale ?? (\"linear\" as KnobScale),\n      disabled: options.disabled ?? false,\n      format: options.format as KnobFormat,\n      locale: options.locale,\n      dragging: false,\n    }\n  },\n  sync: (options) => ({\n    ...(options.value === undefined ? {} : { value: options.value }),\n    min: options.min ?? 0,\n    max: options.max ?? 100,\n    step: options.step ?? 1,\n    largeStep: options.largeStep,\n    scale: options.scale ?? \"linear\",\n    disabled: options.disabled ?? false,\n    format: options.format,\n    locale: options.locale,\n  }),\n  api: (context) => {\n    const change = createChange(context)\n    const commit = createCommit(context)\n    let stop: (() => void) | undefined\n    context.onDestroy(() => stop?.())\n\n    const range = () => {\n      const { min, max, step, largeStep } = context.store.get()\n      return { min, max, step, largeStep }\n    }\n    const fraction = (value: number) =>\n      fractionOf(value, range(), context.store.get().scale)\n    const valueFrom = (position: number) =>\n      scrubTo(valueAt(clamp(position, 0, 1), range(), context.store.get().scale), range())\n        .value\n    const set = (value: number, reason: KnobReason, event?: Event) => {\n      const next = scrubTo(value, range()).value\n      const changed = change(\"value\", next, { reason, event })\n      commit(\"value\", context.store.get().value, { reason, event })\n      return changed\n    }\n\n    return {\n      fraction,\n      setValue: (value: number) => set(value, \"imperative\"),\n      increment: () =>\n        set(\n          stepBy(context.store.get().value, { direction: 1, size: \"small\" }, range()),\n          \"imperative\",\n        ),\n      decrement: () =>\n        set(\n          stepBy(context.store.get().value, { direction: -1, size: \"small\" }, range()),\n          \"imperative\",\n        ),\n      reset: (event?: Event) => set(context.store.get().initial, \"double-press\", event),\n      keydown(event: KeyboardEvent, el: HTMLElement) {\n        if (context.store.get().disabled) return\n        const move = stepFromKey(event, { dir: isRTL(el) ? \"rtl\" : \"ltr\" })\n        if (!move) return\n        event.preventDefault()\n        set(stepBy(context.store.get().value, move, range()), \"step-key\", event)\n      },\n      pointerdown(event: PointerEvent, el: HTMLElement) {\n        if (event.button !== 0 || context.store.get().disabled) return\n        event.preventDefault()\n        el.focus({ preventScroll: true })\n        const start = context.store.get().value\n        let position = fraction(start)\n        // onMove runs once a frame with the latest event, so movementX/Y would drop the\n        // other events in that frame. Measure from the last position seen instead.\n        let last = { x: event.clientX, y: event.clientY }\n        stop?.()\n        stop = bindDrag(el, event, {\n          threshold: dragThreshold,\n          cancelOnEscape: true,\n          onStart: () => {\n            context.store.set({ dragging: true })\n          },\n          onMove: ({ x, y, event: move }) => {\n            const fine = move.shiftKey ? 6 : 1\n            position = clamp(\n              position + (x - last.x - (y - last.y)) / (travel * fine),\n              0,\n              1,\n            )\n            last = { x, y }\n            change(\"value\", valueFrom(position), { reason: \"drag\", event: move })\n          },\n          onEnd: (end, canceled) => {\n            context.store.set({ dragging: false })\n            if (canceled) change(\"value\", start, { reason: \"drag\", event: end })\n            commit(\"value\", context.store.get().value, { reason: \"drag\", event: end })\n          },\n        })\n      },\n    }\n  },\n  slots: (slot) => ({\n    root: slot<\n      {},\n      {\n        value: number\n        fraction: number\n        text: string\n        dragging: boolean\n        disabled: boolean\n      }\n    >({\n      role: \"slider\",\n      focus: \"tab-stop\",\n      keys: [\n        \"ArrowUp\",\n        \"ArrowDown\",\n        \"ArrowLeft\",\n        \"ArrowRight\",\n        \"PageUp\",\n        \"PageDown\",\n        \"Home\",\n        \"End\",\n      ],\n      state: (state, { api }) => ({\n        value: state.value,\n        fraction: api.fraction(state.value),\n        text: textOf(state.value, state.format, state.locale),\n        dragging: state.dragging,\n        disabled: state.disabled,\n      }),\n      attrs: (state, { api }) => ({\n        tabindex: state.disabled ? \"-1\" : \"0\",\n        \"aria-valuenow\": String(state.value),\n        \"aria-valuemin\": String(state.min),\n        \"aria-valuemax\": String(state.max),\n        \"aria-valuetext\": textOf(state.value, state.format, state.locale),\n        \"aria-disabled\": state.disabled ? \"true\" : undefined,\n        \"data-disabled\": state.disabled ? \"\" : undefined,\n        \"data-dragging\": state.dragging ? \"\" : undefined,\n        style: css({ \"--knob-fraction\": String(api.fraction(state.value)) }),\n      }),\n      on: {\n        keydown: (event, { el, api }) => {\n          if (el) api.keydown(event as KeyboardEvent, el)\n        },\n        pointerdown: (event, { el, api }) => {\n          if (el) api.pointerdown(event as PointerEvent, el)\n        },\n        dblclick: (event, { api, store }) => {\n          if (!store.get().disabled) api.reset(event)\n        },\n      },\n    }),\n    indicator: slot({\n      attrs: () => ({ \"aria-hidden\": \"true\" }),\n    }),\n    value: slot<{}, { text: string }>({\n      state: (state) => ({ text: textOf(state.value, state.format, state.locale) }),\n      attrs: () => ({ \"aria-hidden\": \"true\" }),\n    }),\n  }),\n  agent: { actions: [\"setValue\", \"increment\", \"decrement\", \"reset\"] },\n})\n\nexport { knob }\nexport type { KnobOptions, KnobReason, KnobScale }\n",
      "type": "registry:file",
      "target": "@ui/studio/knob.ts"
    },
    {
      "path": "registry/uiset/ui/studio/knob.css",
      "content": "@layer ui-sdk, uiset.tokens, uiset.base, uiset.skin;\n\n@layer uiset.base {\n  .knob-field {\n    display: inline-grid;\n    justify-items: center;\n    gap: 0.375rem;\n    font-size: var(--ui-font-size, 0.875rem);\n  }\n\n  .knob-label {\n    font-weight: 500;\n  }\n\n  [data-slot=\"knob\"] {\n    --knob-size: 3.5rem;\n    --knob-ring: 4px;\n    --knob-track: var(--ui-muted);\n    --knob-fill: var(--ui-primary);\n    --knob-cap: var(--ui-background);\n    --knob-cap-edge: var(--ui-input);\n    --knob-pointer: var(--ui-foreground);\n    --knob-angle: calc(-135deg + 270deg * var(--knob-fraction, 0));\n\n    display: inline-grid;\n    justify-items: center;\n    gap: 0.25rem;\n    padding: 0.25rem;\n    border-radius: calc(var(--ui-radius, 0px) + 4px);\n    touch-action: none;\n    user-select: none;\n    cursor: ns-resize;\n\n    &[data-disabled] {\n      cursor: not-allowed;\n      opacity: 0.5;\n    }\n  }\n\n  [data-slot=\"knob-indicator\"] {\n    position: relative;\n    display: block;\n    width: var(--knob-size);\n    aspect-ratio: 1;\n    border-radius: 50%;\n    background: conic-gradient(\n      from -135deg,\n      var(--knob-fill) calc(270deg * var(--knob-fraction, 0)),\n      var(--knob-track) 0 270deg,\n      transparent 0\n    );\n    mask: radial-gradient(\n      farthest-side,\n      transparent calc(100% - var(--knob-ring) - 0.5px),\n      #000 calc(100% - var(--knob-ring))\n    );\n  }\n\n  /* The cap and its pointer sit outside the ring's mask, on the root. */\n  [data-slot=\"knob\"] {\n    position: relative;\n  }\n\n  [data-slot=\"knob\"]::after {\n    content: \"\";\n    position: absolute;\n    top: calc(0.25rem + var(--knob-ring) + 6px);\n    left: 50%;\n    width: 2px;\n    height: calc(var(--knob-size) / 2 - var(--knob-ring) - 6px);\n    margin-left: -1px;\n    border-radius: 1px;\n    background: var(--knob-pointer);\n    transform-origin: 50% 100%;\n    rotate: var(--knob-angle);\n    pointer-events: none;\n  }\n\n  [data-slot=\"knob\"]::before {\n    content: \"\";\n    position: absolute;\n    top: calc(0.25rem + var(--knob-ring) + 3px);\n    left: 50%;\n    width: calc(var(--knob-size) - var(--knob-ring) * 2 - 6px);\n    aspect-ratio: 1;\n    translate: -50% 0;\n    border: 1px solid var(--knob-cap-edge);\n    border-radius: 50%;\n    background: var(--knob-cap);\n    pointer-events: none;\n  }\n\n  [data-slot=\"knob-value\"] {\n    min-width: 4ch;\n    font-variant-numeric: tabular-nums;\n    text-align: center;\n    color: var(--ui-muted-foreground);\n  }\n\n  @media (forced-colors: active) {\n    [data-slot=\"knob-indicator\"] {\n      background: conic-gradient(\n        from -135deg,\n        Highlight calc(270deg * var(--knob-fraction, 0)),\n        GrayText 0 270deg,\n        transparent 0\n      );\n      forced-color-adjust: none;\n    }\n\n    [data-slot=\"knob\"]::after {\n      background: CanvasText;\n      forced-color-adjust: none;\n    }\n  }\n}\n",
      "type": "registry:file",
      "target": "@ui/studio/knob.css"
    }
  ],
  "type": "registry:ui"
}