@weasel-js/labkit 1.2.0 → 1.3.0-pre.0

package/dist/_dts/index-JFAYj5Tv.d.ts

@@ -1,144 +0,0 @@
-import { ReactNode } from 'react';
-import { C as ConfigField } from './types-x92Kfeme.js';
-import { J as JobHandle, a as JobCapability } from './types-DJ79Tg5J.js';
-
-/** What an instrument's `render` is handed: its state and config, the setters
- *  for both, the trial it is mounted in, and a way to emit named events. */
-interface RenderContext<TS = unknown, TC = unknown> {
-    state: TS;
-    config: TC;
-    setState: (next: TS | ((prev: TS) => TS)) => void;
-    setConfig: (key: keyof TC, value: unknown) => void;
-    trial: {
-        id: string;
-        /** The trial's view, in whatever shape this instrument chose. labkit persists
-         *  it and restores it on Reset without ever reading into it. */
-        view: unknown;
-        setView: (next: unknown) => void;
-        /** 2D convenience over `view`. Reads 1 and writes nothing when the trial holds
-         *  a view that is not the 2D one. */
-        zoom: number;
-        setZoom: (z: number) => void;
-    };
-    emit: (event: string) => void;
-    /** Present only when the instrument declares a `job`. */
-    job?: JobHandle;
-}
-/** One 2D canvas layer of an instrument, drawn in declaration order.
- *
- *  `draw` is called with the camera already applied, so it works in world
- *  coordinates. `zoom` is passed for the things that must not scale with it —
- *  set `ctx.lineWidth = 1 / zoom` to keep a hairline hairline. */
-interface CanvasLayer<TS = unknown, TC = unknown> {
-    id: string;
-    draw: (ctx: CanvasRenderingContext2D, args: {
-        state: TS;
-        config: TC;
-        zoom: number;
-    }) => void;
-}
-/** Declares that an instrument draws to a canvas: its layers, and where the
- *  view starts. */
-interface CanvasCapability<TS = unknown, TC = unknown> {
-    layers: CanvasLayer<TS, TC>[];
-    initialView?: {
-        zoom: number;
-        pan: {
-            x: number;
-            y: number;
-        };
-    };
-}
-/** Declares which of an instrument's layers the trial should offer
- *  show/hide controls for. */
-interface LayerCapability {
-    ids: string[];
-}
-/** Declares that an instrument accepts items dragged from a palette: what the
- *  palette offers, what a drop does to the state, and — optionally — live
- *  feedback during the drag and the ability to drag existing items back out. */
-interface DragDropCapability<TS = unknown, TC = unknown> {
-    palette: PaletteItem[] | ((state: TS, config: TC) => PaletteItem[]);
-    onDrop: (worldPos: Point, item: PaletteItem, state: TS, config: TC) => TS;
-    onDragOver?: (worldPos: Point, item: PaletteItem, state: TS, config: TC) => DragFeedback | null;
-    pickUp?: (hit: HitResult, state: TS, config: TC) => {
-        item: PaletteItem;
-        state: TS;
-    } | null;
-}
-/** Declares that an instrument's state is undoable: which emitted events
- *  snapshot it, and how many snapshots to keep. */
-interface UndoCapability {
-    snapshotOn?: string[];
-    maxDepth?: number;
-}
-/** The name of an event an instrument emits through `RenderContext.emit`. */
-type SystemEvent = string;
-/** A point in world coordinates. */
-type Point = {
-    x: number;
-    y: number;
-};
-/** What a hit-test found, and where. */
-type HitResult = {
-    hit: boolean;
-    layerId?: string;
-    pointId?: string;
-};
-/** A trial's camera. */
-type ViewTransform = {
-    zoom: number;
-    pan: Point;
-};
-/** A layer as the layer list shows it. `alwaysOn` layers cannot be hidden. */
-type LayerDescriptor = {
-    id: string;
-    label: string;
-    alwaysOn?: boolean;
-};
-/** One draggable entry in an instrument's palette. */
-type PaletteItem = {
-    id: string;
-    label: string;
-    data?: unknown;
-};
-/** Whether a drop would be accepted at the current position, and why not if
- *  it would not. */
-type DragFeedback = {
-    ok: boolean;
-    reason?: string;
-};
-/**
- * An instrument: one self-contained interactive experiment a lab can host.
- *
- * It owns two pieces of data — `config`, the settings the control panel edits,
- * and `state`, what the experiment is currently doing — and renders from both.
- * The optional capability fields declare what else it wants from the runtime:
- * a canvas, a layer list, palette drag-and-drop, undo. Declaring a capability
- * is what makes the trial provide the corresponding chrome.
- */
-interface Instrument<TS = unknown, TC = unknown> {
-    name: string;
-    defaultConfig: () => TC;
-    initialState: (config: TC) => TS;
-    configSchema?: () => ConfigField[];
-    /** The instrument's DOM. With `canvas`, this renders as an overlay above the
-     *  layers rather than instead of them; return `null` for canvas only. */
-    render: (ctx: RenderContext<TS, TC>) => ReactNode;
-    onConfigChange?: (config: TC, prev: TC, state: TS) => TS;
-    serialize?: (state: TS) => unknown;
-    deserialize?: (data: unknown, config: TC) => TS;
-    canvas?: CanvasCapability<TS, TC>;
-    layers?: LayerCapability;
-    dragDrop?: DragDropCapability<TS, TC>;
-    undo?: UndoCapability;
-    /** Work too slow to do during a render. The runtime starts it, aborts it on
-     *  unmount and on a `key` change, and renders progress into the trial. */
-    job?: JobCapability<TS, TC, never>;
-}
-/** Instruments as a lab receives them. `any` rather than `unknown` because
- *  parameter contravariance keeps a `defineInstrument<TS, TC>` result out of
- *  an `Instrument<unknown, unknown>[]`; it is contained to this alias. */
-type InstrumentList = readonly Instrument<any, any>[];
-
-export type { CanvasCapability as C, DragDropCapability as D, HitResult as H, Instrument as I, LayerCapability as L, PaletteItem as P, RenderContext as R, SystemEvent as S, UndoCapability as U, ViewTransform as V, InstrumentList as a, CanvasLayer as b, DragFeedback as c, LayerDescriptor as d, Point as e };

package/dist/_dts/types-x92Kfeme.d.ts

@@ -1,62 +0,0 @@
-/** Which control a config field is edited with. */
-type ConfigFieldType = 'slider' | 'checkbox' | 'select' | 'number' | 'text' | 'color';
-/** What every config field carries: the config key it writes, the label shown
- *  beside it, and which control renders it. */
-interface ConfigFieldBase {
-    key: string;
-    label: string;
-    type: ConfigFieldType;
-}
-/** A bounded number edited by dragging. */
-interface SliderField extends ConfigFieldBase {
-    type: 'slider';
-    default: number;
-    min: number;
-    max: number;
-    step?: number;
-}
-/** A boolean. */
-interface CheckboxField extends ConfigFieldBase {
-    type: 'checkbox';
-    default: boolean;
-}
-/** One choice in a select field. */
-interface SelectOption {
-    value: string;
-    label: string;
-}
-/** A fixed set of labeled choices. */
-interface SelectField extends ConfigFieldBase {
-    type: 'select';
-    default: string;
-    options: SelectOption[];
-}
-/** A number typed directly, optionally bounded. Use a slider field instead
- *  when the range matters more than the exact value. */
-interface NumberField extends ConfigFieldBase {
-    type: 'number';
-    default: number;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-/** A free-text string. Writes are debounced so typing does not re-run the
- *  instrument on every keystroke. */
-interface TextField extends ConfigFieldBase {
-    type: 'text';
-    default: string;
-    placeholder?: string;
-    maxLength?: number;
-    /** Milliseconds to debounce live setConfig calls. Default 150 ms. Set to 0 to disable. */
-    debounceMs?: number;
-}
-/** A color, as a CSS color string. */
-interface ColorField extends ConfigFieldBase {
-    type: 'color';
-    default: string;
-}
-/** One field of an instrument's config schema. The schema is what the control
- *  panel renders, and what `validateConfigSchema` checks. */
-type ConfigField = SliderField | CheckboxField | SelectField | NumberField | TextField | ColorField;
-
-export type { ConfigField as C, NumberField as N, SelectField as S, TextField as T, CheckboxField as a, ColorField as b, ConfigFieldBase as c, ConfigFieldType as d, SelectOption as e, SliderField as f };

package/dist/chunk-574LJAV4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/canvas/canvasCoords.ts","../src/canvas/useLayerScheduler.ts","../src/canvas/usePanZoom.ts","../src/canvas/CanvasStack.tsx"],"names":["useRef","useEffect"],"mappings":"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","file":"chunk-574LJAV4.js","sourcesContent":["import type { Point, ViewTransform } from '../instrument/types';\n\n/** Project a world point into screen coordinates under a view. */\nexport function worldToScreen(world: Point, view: ViewTransform): Point {\n  return {\n    x: world.x * view.zoom + view.pan.x,\n    y: world.y * view.zoom + view.pan.y,\n  };\n}\n\n/** Unproject a screen point back to world coordinates under a view. */\nexport function screenToWorld(screen: Point, view: ViewTransform): Point {\n  return {\n    x: (screen.x - view.pan.x) / view.zoom,\n    y: (screen.y - view.pan.y) / view.zoom,\n  };\n}\n","import { type RefObject, useEffect, useRef } from 'react';\nimport type { ViewTransform } from '../instrument/types';\n\n/** One layer of a canvas stack: its id, whether it is currently shown, and how\n *  it paints itself. */\nexport interface CanvasLayerDescriptor {\n  id: string;\n  visible: boolean;\n  render: (ctx: CanvasRenderingContext2D, view: ViewTransform) => void;\n}\n\ninterface SchedulerOptions {\n  layers: CanvasLayerDescriptor[];\n  view: ViewTransform;\n  canvasRefs: RefObject<Map<string, HTMLCanvasElement>>;\n  size: { width: number; height: number; dpr: number };\n}\n\nexport function useLayerScheduler({ layers, view, canvasRefs, size }: SchedulerOptions): void {\n  const dirty = useRef<Set<string>>(new Set());\n  const rafId = useRef<number | null>(null);\n  const lastRenderRef = useRef<Map<string, CanvasLayerDescriptor['render']>>(new Map());\n\n  useEffect(() => {\n    for (const layer of layers) {\n      const prev = lastRenderRef.current.get(layer.id);\n      if (prev !== layer.render) dirty.current.add(layer.id);\n      lastRenderRef.current.set(layer.id, layer.render);\n    }\n    for (const id of [...lastRenderRef.current.keys()]) {\n      if (!layers.find((l) => l.id === id)) lastRenderRef.current.delete(id);\n    }\n  }, [layers]);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: re-mark dirty when view or size changes\n  useEffect(() => {\n    for (const layer of layers) dirty.current.add(layer.id);\n  }, [view, size, layers]);\n\n  useEffect(() => {\n    const tick = () => {\n      rafId.current = null;\n      if (dirty.current.size === 0) return;\n      const map = canvasRefs.current;\n      if (!map) {\n        dirty.current.clear();\n        return;\n      }\n      for (const layer of layers) {\n        if (!dirty.current.has(layer.id)) continue;\n        if (!layer.visible) continue;\n        const canvas = map.get(layer.id);\n        if (!canvas) continue;\n        const ctx = canvas.getContext('2d');\n        if (!ctx) continue;\n        ctx.save();\n        ctx.setTransform(size.dpr, 0, 0, size.dpr, 0, 0);\n        ctx.clearRect(0, 0, size.width, size.height);\n        layer.render(ctx, view);\n        ctx.restore();\n      }\n      dirty.current.clear();\n    };\n    if (dirty.current.size > 0 && rafId.current === null) {\n      rafId.current = requestAnimationFrame(tick);\n    }\n    return () => {\n      if (rafId.current !== null) {\n        cancelAnimationFrame(rafId.current);\n        rafId.current = null;\n      }\n    };\n  });\n}\n","import { type PointerEvent, useCallback, useRef, type WheelEvent } from 'react';\nimport type { ViewTransform } from '../instrument/types';\n\nexport interface UsePanZoomOptions {\n  view: ViewTransform;\n  onViewChange: (v: ViewTransform) => void;\n  minZoom?: number;\n  maxZoom?: number;\n}\n\nexport interface PanZoomHandlers {\n  onWheel: (e: WheelEvent<HTMLElement>) => void;\n  onPointerDown: (e: PointerEvent<HTMLElement>) => void;\n  onPointerMove: (e: PointerEvent<HTMLElement>) => void;\n  onPointerUp: (e: PointerEvent<HTMLElement>) => void;\n  isDragging: () => boolean;\n}\n\ninterface DragState {\n  pointerId: number;\n  startScreenX: number;\n  startScreenY: number;\n  startPan: { x: number; y: number };\n  moved: boolean;\n}\n\nconst DRAG_THRESHOLD = 3;\n\nexport function usePanZoom({\n  view,\n  onViewChange,\n  minZoom = 0.1,\n  maxZoom = 32,\n}: UsePanZoomOptions): PanZoomHandlers {\n  const dragRef = useRef<DragState | null>(null);\n  const viewRef = useRef(view);\n  viewRef.current = view;\n\n  const onWheel = useCallback(\n    (e: WheelEvent<HTMLElement>) => {\n      e.preventDefault();\n      const rect = e.currentTarget.getBoundingClientRect();\n      const cursorX = e.clientX - rect.left;\n      const cursorY = e.clientY - rect.top;\n      const v = viewRef.current;\n      const factor = Math.exp(-e.deltaY * 0.001);\n      const nextZoom = Math.min(maxZoom, Math.max(minZoom, v.zoom * factor));\n      const ratio = nextZoom / v.zoom;\n      const nextPan = {\n        x: cursorX - (cursorX - v.pan.x) * ratio,\n        y: cursorY - (cursorY - v.pan.y) * ratio,\n      };\n      onViewChange({ zoom: nextZoom, pan: nextPan });\n    },\n    [onViewChange, minZoom, maxZoom],\n  );\n\n  const onPointerDown = useCallback((e: PointerEvent<HTMLElement>) => {\n    if (e.button !== 0) return;\n    e.currentTarget.setPointerCapture(e.pointerId);\n    dragRef.current = {\n      pointerId: e.pointerId,\n      startScreenX: e.clientX,\n      startScreenY: e.clientY,\n      startPan: { ...viewRef.current.pan },\n      moved: false,\n    };\n  }, []);\n\n  const onPointerMove = useCallback(\n    (e: PointerEvent<HTMLElement>) => {\n      const drag = dragRef.current;\n      if (!drag || drag.pointerId !== e.pointerId) return;\n      const dx = e.clientX - drag.startScreenX;\n      const dy = e.clientY - drag.startScreenY;\n      if (!drag.moved && Math.hypot(dx, dy) < DRAG_THRESHOLD) return;\n      drag.moved = true;\n      onViewChange({\n        zoom: viewRef.current.zoom,\n        pan: { x: drag.startPan.x + dx, y: drag.startPan.y + dy },\n      });\n    },\n    [onViewChange],\n  );\n\n  const onPointerUp = useCallback((e: PointerEvent<HTMLElement>) => {\n    const drag = dragRef.current;\n    if (!drag || drag.pointerId !== e.pointerId) return;\n    if (e.currentTarget.hasPointerCapture(e.pointerId)) {\n      e.currentTarget.releasePointerCapture(e.pointerId);\n    }\n    dragRef.current = null;\n  }, []);\n\n  const isDragging = useCallback(() => dragRef.current?.moved === true, []);\n\n  return { onWheel, onPointerDown, onPointerMove, onPointerUp, isDragging };\n}\n","import { type CSSProperties, type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\nimport type { Point, ViewTransform } from '../instrument/types';\nimport { CanvasStackContext } from './CanvasStackContext';\nimport { screenToWorld } from './canvasCoords';\nimport { type CanvasLayerDescriptor, useLayerScheduler } from './useLayerScheduler';\nimport { usePanZoom } from './usePanZoom';\n\n/** Props for `<CanvasStack>`. */\nexport interface CanvasStackProps {\n  layers: CanvasLayerDescriptor[];\n  view: ViewTransform;\n  onViewChange: (v: ViewTransform) => void;\n  width?: number | string;\n  height?: number | string;\n  className?: string;\n  onHitTest?: (worldPos: Point) => void;\n  children?: ReactNode;\n}\n\n/** Stacks one `<canvas>` per layer and drives them from a shared view, so a\n *  layer that changes rarely is not redrawn with one that changes every frame.\n *  Handles sizing, device pixel ratio, and pan/zoom. */\nexport function CanvasStack({\n  layers,\n  view,\n  onViewChange,\n  width = '100%',\n  height = '100%',\n  className,\n  onHitTest,\n  children,\n}: CanvasStackProps) {\n  const containerRef = useRef<HTMLDivElement | null>(null);\n  const canvasMap = useRef<Map<string, HTMLCanvasElement>>(new Map());\n  const [size, setSize] = useState({ width: 0, height: 0, dpr: 1 });\n\n  const setCanvasRef = (id: string, el: HTMLCanvasElement | null): void => {\n    if (el) canvasMap.current.set(id, el);\n    else canvasMap.current.delete(id);\n  };\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n    const update = () => {\n      const rect = el.getBoundingClientRect();\n      const dpr = window.devicePixelRatio ?? 1;\n      setSize((prev) => {\n        if (prev.width === rect.width && prev.height === rect.height && prev.dpr === dpr) {\n          return prev;\n        }\n        return { width: rect.width, height: rect.height, dpr };\n      });\n    };\n    update();\n    if (typeof ResizeObserver === 'undefined') return;\n    const ro = new ResizeObserver(update);\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, []);\n\n  const handlers = usePanZoom({ view, onViewChange });\n  useLayerScheduler({ layers, view, canvasRefs: canvasMap, size });\n\n  const ctxValue = useMemo(() => ({ view }), [view]);\n\n  const containerStyle: CSSProperties = { width, height };\n  const canvasPx = {\n    width: Math.max(0, Math.round(size.width * size.dpr)),\n    height: Math.max(0, Math.round(size.height * size.dpr)),\n  };\n  const canvasCss: CSSProperties = {\n    width: size.width,\n    height: size.height,\n  };\n\n  const handlePointerUp = (e: React.PointerEvent<HTMLDivElement>) => {\n    const wasDragging = handlers.isDragging();\n    handlers.onPointerUp(e);\n    if (!wasDragging && onHitTest && containerRef.current) {\n      const rect = containerRef.current.getBoundingClientRect();\n      const screen = { x: e.clientX - rect.left, y: e.clientY - rect.top };\n      onHitTest(screenToWorld(screen, view));\n    }\n  };\n\n  return (\n    <CanvasStackContext.Provider value={ctxValue}>\n      <div\n        ref={containerRef}\n        className={className ? `lk-canvas-stack ${className}` : 'lk-canvas-stack'}\n        style={containerStyle}\n        onWheel={handlers.onWheel}\n        onPointerDown={handlers.onPointerDown}\n        onPointerMove={handlers.onPointerMove}\n        onPointerUp={handlePointerUp}\n      >\n        {layers.map((layer) => (\n          <canvas\n            key={layer.id}\n            ref={(el) => setCanvasRef(layer.id, el)}\n            className=\"lk-canvas-stack__canvas\"\n            width={canvasPx.width}\n            height={canvasPx.height}\n            style={{ ...canvasCss, display: layer.visible ? 'block' : 'none' }}\n          />\n        ))}\n        <div className=\"lk-canvas-stack__overlay\">{children}</div>\n      </div>\n    </CanvasStackContext.Provider>\n  );\n}\n"]}

package/dist/chunk-5R2ATYPJ.js

@@ -1,201 +0,0 @@
-import { useState, useRef, useEffect } from 'react';
-import { jsx, jsxs } from 'react/jsx-runtime';
-
-// src/controls/ControlPanel.tsx
-function ControlPanel({
-  fields,
-  config,
-  setConfig,
-  className
-}) {
-  return /* @__PURE__ */ jsx("div", { className: className ? `lk-control-panel ${className}` : "lk-control-panel", children: fields.map((field) => /* @__PURE__ */ jsx(ControlRow, { field, config, setConfig }, field.key)) });
-}
-function ControlRow({
-  field,
-  config,
-  setConfig
-}) {
-  switch (field.type) {
-    case "slider":
-      return /* @__PURE__ */ jsx(SliderRow, { field, config, setConfig });
-    case "checkbox":
-      return /* @__PURE__ */ jsx(CheckboxRow, { field, config, setConfig });
-    case "select":
-      return /* @__PURE__ */ jsx(SelectRow, { field, config, setConfig });
-    case "number":
-      return /* @__PURE__ */ jsx(NumberRow, { field, config, setConfig });
-    case "text":
-      return /* @__PURE__ */ jsx(TextRow, { field, config, setConfig });
-    case "color":
-      return /* @__PURE__ */ jsx(ColorRow, { field, config, setConfig });
-    default:
-      return null;
-  }
-}
-function SliderRow({
-  field,
-  config,
-  setConfig
-}) {
-  const value = config[field.key] ?? field.default;
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row", children: [
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label }),
-    /* @__PURE__ */ jsxs("div", { className: "lk-control-slider-row", children: [
-      /* @__PURE__ */ jsx(
-        "input",
-        {
-          id: `lk-ctrl-${field.key}`,
-          className: "lk-control-input lk-control-input--range",
-          type: "range",
-          min: field.min,
-          max: field.max,
-          step: field.step ?? 1,
-          value,
-          onChange: (e) => setConfig(field.key, Number(e.target.value))
-        }
-      ),
-      /* @__PURE__ */ jsx("span", { className: "lk-control-slider-value", children: value })
-    ] })
-  ] });
-}
-function CheckboxRow({
-  field,
-  config,
-  setConfig
-}) {
-  const value = config[field.key] ?? field.default;
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row lk-control-row--inline", children: [
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        id: `lk-ctrl-${field.key}`,
-        className: "lk-control-input lk-control-input--checkbox",
-        type: "checkbox",
-        checked: value,
-        onChange: (e) => setConfig(field.key, e.target.checked)
-      }
-    ),
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label })
-  ] });
-}
-function SelectRow({
-  field,
-  config,
-  setConfig
-}) {
-  const value = config[field.key] ?? field.default;
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row", children: [
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label }),
-    /* @__PURE__ */ jsx(
-      "select",
-      {
-        id: `lk-ctrl-${field.key}`,
-        className: "lk-control-input",
-        value,
-        onChange: (e) => setConfig(field.key, e.target.value),
-        children: field.options.map((opt) => /* @__PURE__ */ jsx("option", { value: opt.value, children: opt.label }, opt.value))
-      }
-    )
-  ] });
-}
-function NumberRow({
-  field,
-  config,
-  setConfig
-}) {
-  const value = config[field.key] ?? field.default;
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row", children: [
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label }),
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        id: `lk-ctrl-${field.key}`,
-        className: "lk-control-input",
-        type: "number",
-        value,
-        min: field.min,
-        max: field.max,
-        step: field.step,
-        onChange: (e) => setConfig(field.key, Number(e.target.value)),
-        onBlur: (e) => {
-          const n = Number(e.target.value);
-          if (!Number.isFinite(n)) return;
-          let clamped = n;
-          if (field.min !== void 0 && clamped < field.min) clamped = field.min;
-          if (field.max !== void 0 && clamped > field.max) clamped = field.max;
-          if (clamped !== n) setConfig(field.key, clamped);
-        }
-      }
-    )
-  ] });
-}
-function TextRow({
-  field,
-  config,
-  setConfig
-}) {
-  const debounceMs = field.debounceMs ?? 150;
-  const initial = config[field.key] ?? field.default;
-  const [local, setLocal] = useState(initial);
-  const timer = useRef(null);
-  const lastExternal = useRef(initial);
-  useEffect(() => {
-    const ext = config[field.key] ?? field.default;
-    if (ext !== lastExternal.current) {
-      lastExternal.current = ext;
-      setLocal(ext);
-    }
-  }, [config, field.key, field.default]);
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row", children: [
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label }),
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        id: `lk-ctrl-${field.key}`,
-        className: "lk-control-input",
-        type: "text",
-        value: local,
-        placeholder: field.placeholder,
-        maxLength: field.maxLength,
-        onChange: (e) => {
-          const next = e.target.value;
-          setLocal(next);
-          if (timer.current) clearTimeout(timer.current);
-          if (debounceMs === 0) {
-            lastExternal.current = next;
-            setConfig(field.key, next);
-          } else {
-            timer.current = setTimeout(() => {
-              lastExternal.current = next;
-              setConfig(field.key, next);
-            }, debounceMs);
-          }
-        }
-      }
-    )
-  ] });
-}
-function ColorRow({
-  field,
-  config,
-  setConfig
-}) {
-  const value = config[field.key] ?? field.default;
-  return /* @__PURE__ */ jsxs("div", { className: "lk-control-row lk-control-row--inline", children: [
-    /* @__PURE__ */ jsx("label", { className: "lk-control-label", htmlFor: `lk-ctrl-${field.key}`, children: field.label }),
-    /* @__PURE__ */ jsx(
-      "input",
-      {
-        id: `lk-ctrl-${field.key}`,
-        className: "lk-control-input lk-control-input--color",
-        type: "color",
-        value,
-        onChange: (e) => setConfig(field.key, e.target.value)
-      }
-    )
-  ] });
-}
-
-export { ControlPanel };
-//# sourceMappingURL=chunk-5R2ATYPJ.js.map
-//# sourceMappingURL=chunk-5R2ATYPJ.js.map

package/dist/chunk-5R2ATYPJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/controls/ControlPanel.tsx"],"names":[],"mappings":"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","file":"chunk-5R2ATYPJ.js","sourcesContent":["import { useEffect, useRef, useState } from 'react';\nimport type {\n  CheckboxField,\n  ColorField,\n  ConfigField,\n  NumberField,\n  SelectField,\n  SliderField,\n  TextField,\n} from './types';\n\nexport interface ControlPanelProps<TC extends Record<string, unknown>> {\n  fields: ConfigField[];\n  config: TC;\n  setConfig: (key: keyof TC, value: unknown) => void;\n  className?: string;\n}\n\n/** Render an instrument's config schema as a stack of controls, each writing\n *  back through `setConfig`. */\nexport function ControlPanel<TC extends Record<string, unknown>>({\n  fields,\n  config,\n  setConfig,\n  className,\n}: ControlPanelProps<TC>) {\n  return (\n    <div className={className ? `lk-control-panel ${className}` : 'lk-control-panel'}>\n      {fields.map((field) => (\n        <ControlRow key={field.key} field={field} config={config} setConfig={setConfig} />\n      ))}\n    </div>\n  );\n}\n\ninterface ControlRowProps<TC extends Record<string, unknown>> {\n  field: ConfigField;\n  config: TC;\n  setConfig: (key: keyof TC, value: unknown) => void;\n}\n\nfunction ControlRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: ControlRowProps<TC>) {\n  switch (field.type) {\n    case 'slider':\n      return <SliderRow field={field} config={config} setConfig={setConfig} />;\n    case 'checkbox':\n      return <CheckboxRow field={field} config={config} setConfig={setConfig} />;\n    case 'select':\n      return <SelectRow field={field} config={config} setConfig={setConfig} />;\n    case 'number':\n      return <NumberRow field={field} config={config} setConfig={setConfig} />;\n    case 'text':\n      return <TextRow field={field} config={config} setConfig={setConfig} />;\n    case 'color':\n      return <ColorRow field={field} config={config} setConfig={setConfig} />;\n    default:\n      return null;\n  }\n}\n\ntype RowProps<F extends ConfigField, TC extends Record<string, unknown>> = {\n  field: F;\n  config: TC;\n  setConfig: (key: keyof TC, value: unknown) => void;\n};\n\nfunction SliderRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<SliderField, TC>) {\n  const value = (config[field.key] as number | undefined) ?? field.default;\n  return (\n    <div className=\"lk-control-row\">\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n      <div className=\"lk-control-slider-row\">\n        <input\n          id={`lk-ctrl-${field.key}`}\n          className=\"lk-control-input lk-control-input--range\"\n          type=\"range\"\n          min={field.min}\n          max={field.max}\n          step={field.step ?? 1}\n          value={value}\n          onChange={(e) => setConfig(field.key as keyof TC, Number(e.target.value))}\n        />\n        <span className=\"lk-control-slider-value\">{value}</span>\n      </div>\n    </div>\n  );\n}\n\nfunction CheckboxRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<CheckboxField, TC>) {\n  const value = (config[field.key] as boolean | undefined) ?? field.default;\n  return (\n    <div className=\"lk-control-row lk-control-row--inline\">\n      <input\n        id={`lk-ctrl-${field.key}`}\n        className=\"lk-control-input lk-control-input--checkbox\"\n        type=\"checkbox\"\n        checked={value}\n        onChange={(e) => setConfig(field.key as keyof TC, e.target.checked)}\n      />\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n    </div>\n  );\n}\n\nfunction SelectRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<SelectField, TC>) {\n  const value = (config[field.key] as string | undefined) ?? field.default;\n  return (\n    <div className=\"lk-control-row\">\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n      <select\n        id={`lk-ctrl-${field.key}`}\n        className=\"lk-control-input\"\n        value={value}\n        onChange={(e) => setConfig(field.key as keyof TC, e.target.value)}\n      >\n        {field.options.map((opt) => (\n          <option key={opt.value} value={opt.value}>\n            {opt.label}\n          </option>\n        ))}\n      </select>\n    </div>\n  );\n}\n\nfunction NumberRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<NumberField, TC>) {\n  const value = (config[field.key] as number | undefined) ?? field.default;\n  return (\n    <div className=\"lk-control-row\">\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n      <input\n        id={`lk-ctrl-${field.key}`}\n        className=\"lk-control-input\"\n        type=\"number\"\n        value={value}\n        min={field.min}\n        max={field.max}\n        step={field.step}\n        onChange={(e) => setConfig(field.key as keyof TC, Number(e.target.value))}\n        onBlur={(e) => {\n          const n = Number(e.target.value);\n          if (!Number.isFinite(n)) return;\n          let clamped = n;\n          if (field.min !== undefined && clamped < field.min) clamped = field.min;\n          if (field.max !== undefined && clamped > field.max) clamped = field.max;\n          if (clamped !== n) setConfig(field.key as keyof TC, clamped);\n        }}\n      />\n    </div>\n  );\n}\n\nfunction TextRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<TextField, TC>) {\n  const debounceMs = field.debounceMs ?? 150;\n  const initial = (config[field.key] as string | undefined) ?? field.default;\n  const [local, setLocal] = useState(initial);\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastExternal = useRef(initial);\n\n  useEffect(() => {\n    const ext = (config[field.key] as string | undefined) ?? field.default;\n    if (ext !== lastExternal.current) {\n      lastExternal.current = ext;\n      setLocal(ext);\n    }\n  }, [config, field.key, field.default]);\n\n  return (\n    <div className=\"lk-control-row\">\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n      <input\n        id={`lk-ctrl-${field.key}`}\n        className=\"lk-control-input\"\n        type=\"text\"\n        value={local}\n        placeholder={field.placeholder}\n        maxLength={field.maxLength}\n        onChange={(e) => {\n          const next = e.target.value;\n          setLocal(next);\n          if (timer.current) clearTimeout(timer.current);\n          if (debounceMs === 0) {\n            lastExternal.current = next;\n            setConfig(field.key as keyof TC, next);\n          } else {\n            timer.current = setTimeout(() => {\n              lastExternal.current = next;\n              setConfig(field.key as keyof TC, next);\n            }, debounceMs);\n          }\n        }}\n      />\n    </div>\n  );\n}\n\nfunction ColorRow<TC extends Record<string, unknown>>({\n  field,\n  config,\n  setConfig,\n}: RowProps<ColorField, TC>) {\n  const value = (config[field.key] as string | undefined) ?? field.default;\n  return (\n    <div className=\"lk-control-row lk-control-row--inline\">\n      <label className=\"lk-control-label\" htmlFor={`lk-ctrl-${field.key}`}>\n        {field.label}\n      </label>\n      <input\n        id={`lk-ctrl-${field.key}`}\n        className=\"lk-control-input lk-control-input--color\"\n        type=\"color\"\n        value={value}\n        onChange={(e) => setConfig(field.key as keyof TC, e.target.value)}\n      />\n    </div>\n  );\n}\n"]}