@weasel-js/labkit 1.3.0 → 1.4.0-pre.1

package/dist/chunk-T66HU3HX.js

@@ -1,17 +0,0 @@
-// src/canvas/canvasCoords.ts
-function worldToScreen(world, view) {
-  return {
-    x: world.x * view.zoom + view.pan.x,
-    y: world.y * view.zoom + view.pan.y
-  };
-}
-function screenToWorld(screen, view) {
-  return {
-    x: (screen.x - view.pan.x) / view.zoom,
-    y: (screen.y - view.pan.y) / view.zoom
-  };
-}
-
-export { screenToWorld, worldToScreen };
-//# sourceMappingURL=chunk-T66HU3HX.js.map
-//# sourceMappingURL=chunk-T66HU3HX.js.map

package/dist/chunk-T66HU3HX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/canvas/canvasCoords.ts"],"names":[],"mappings":";AAGO,SAAS,aAAA,CAAc,OAAc,IAAA,EAA4B;AACtE,EAAA,OAAO;AAAA,IACL,GAAG,KAAA,CAAM,CAAA,GAAI,IAAA,CAAK,IAAA,GAAO,KAAK,GAAA,CAAI,CAAA;AAAA,IAClC,GAAG,KAAA,CAAM,CAAA,GAAI,IAAA,CAAK,IAAA,GAAO,KAAK,GAAA,CAAI;AAAA,GACpC;AACF;AAGO,SAAS,aAAA,CAAc,QAAe,IAAA,EAA4B;AACvE,EAAA,OAAO;AAAA,IACL,IAAI,MAAA,CAAO,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK,IAAA;AAAA,IAClC,IAAI,MAAA,CAAO,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,KAAK,IAAA,CAAK;AAAA,GACpC;AACF","file":"chunk-T66HU3HX.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"]}

package/dist/chunk-WTI26YTM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/fromConfigField.ts","../src/config/visible.ts","../src/controls/ControlPanel.tsx"],"names":["S","b","value"],"mappings":"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","file":"chunk-WTI26YTM.js","sourcesContent":["import type { PrefLeaf } from '@weasel-js/ui';\nimport type { ConfigField } from '../controls/types';\nimport type { LeafPatch, ResolvedConfig } from './types';\n\n/** One `ConfigField` as the `Pref*` vocabulary spells it. The two describe the\n *  same thing; `ConfigField` just keys on the control where `PrefLeaf`\n *  separates the value's kind from how it is presented. */\nfunction toLeaf(field: ConfigField): LeafPatch {\n  const base = { name: field.label, description: '' };\n  switch (field.type) {\n    case 'slider':\n      return {\n        ...base,\n        kind: 'number',\n        control: 'slider',\n        min: field.min,\n        max: field.max,\n        step: field.step,\n      };\n    case 'number':\n      return {\n        ...base,\n        kind: 'number',\n        control: 'input',\n        min: field.min,\n        max: field.max,\n        step: field.step,\n      };\n    case 'checkbox':\n      return { ...base, kind: 'boolean', control: 'checkbox' };\n    case 'select':\n      return { ...base, kind: 'enum', options: field.options };\n    case 'text':\n      return {\n        ...base,\n        kind: 'string',\n        placeholder: field.placeholder,\n        maxLength: field.maxLength,\n        debounceMs: field.debounceMs,\n      };\n    case 'color':\n      return { ...base, kind: 'color' };\n    default:\n      // A schema can arrive from outside TypeScript. Carry the kind through\n      // so a lab-supplied renderer can still claim it.\n      return { ...base, kind: (field as ConfigField).type };\n  }\n}\n\n/**\n * Adapt a legacy `configSchema(): ConfigField[]` into the resolved shape, so\n * both instrument paths reach one renderer.\n *\n * Rules do not run here: a hand-written `ConfigField` already states its label\n * and control, which is everything the rule chain would have inferred.\n */\nexport function fromConfigFields(fields: readonly ConfigField[]): ResolvedConfig {\n  const children: Record<string, PrefLeaf> = {};\n  for (const field of fields) {\n    const patch = toLeaf(field);\n    for (const key of Object.keys(patch)) {\n      if ((patch as Record<string, unknown>)[key] === undefined) {\n        delete (patch as Record<string, unknown>)[key];\n      }\n    }\n    children[field.key] = { ...patch, default: field.default } as PrefLeaf;\n  }\n  return {\n    group: { name: '', children },\n    sections: [],\n    showIf: new Map(),\n    renderers: {},\n  };\n}\n","import type { ResolvedConfig } from './types';\n\n/**\n * Whether a leaf's row should be drawn right now.\n *\n * `hidden` is the leaf's own static flag; `showIf` is the schema's predicate\n * over the live config. Both are presentational — a hidden leaf keeps its\n * value and the instrument still reads it.\n */\nexport function isLeafVisible(\n  resolved: ResolvedConfig,\n  path: string,\n  config: Record<string, unknown>,\n  showHidden = false,\n): boolean {\n  const leaf = resolved.group.children[path];\n  if (leaf && 'hidden' in leaf && leaf.hidden === true && !showHidden) return false;\n  const predicate = resolved.showIf.get(path);\n  return predicate ? predicate(config) : true;\n}\n","import { isBuiltinToolPref } from '@weasel-js/core';\nimport {\n  CheckboxRow,\n  ColorRow,\n  NumberRow,\n  type PrefLeaf,\n  PropertyGroup,\n  PropertyList,\n  PropertyRow,\n  SelectRow,\n  SliderRow,\n  TextRow,\n  ToggleRow,\n} from '@weasel-js/ui';\nimport { type ReactNode, useEffect, useMemo, useRef, useState } from 'react';\nimport { fromConfigFields } from '../config/fromConfigField';\nimport type { ControlRenderer, ResolvedConfig } from '../config/types';\nimport { isLeafVisible } from '../config/visible';\nimport type { ConfigField } from './types';\n\nexport interface ControlPanelProps<TC extends Record<string, unknown>> {\n  /** The instrument's resolved config schema. */\n  schema?: ResolvedConfig;\n  /** @deprecated Pass `schema`. A field list is adapted into one internally. */\n  fields?: ConfigField[];\n  config: TC;\n  setConfig: (key: keyof TC, value: unknown) => void;\n  /**\n   * Control overrides and app-defined kinds, PrefsForm-style. Keys are config\n   * paths (checked first) or leaf kinds. A renderer returning `null` collapses\n   * the row; entries override the built-in rows on collision.\n   */\n  renderers?: Record<string, ControlRenderer>;\n  /** Draw leaves marked `hidden`. */\n  showHidden?: boolean;\n  className?: string;\n}\n\n/** Render an instrument's config schema as a stack of controls, each writing\n *  back through `setConfig`. Built on the property rows, so a lab's controls\n *  are the same aligned, themed rows the rest of the kit uses. */\nexport function ControlPanel<TC extends Record<string, unknown>>({\n  schema,\n  fields,\n  config,\n  setConfig,\n  renderers,\n  showHidden = false,\n  className,\n}: ControlPanelProps<TC>) {\n  const resolved = useMemo(() => schema ?? fromConfigFields(fields ?? []), [schema, fields]);\n\n  const paths = Object.keys(resolved.group.children);\n  const sectioned = new Set(resolved.sections.flatMap((s) => s.paths));\n  const loose = paths.filter((p) => !sectioned.has(p));\n\n  const row = (path: string): ReactNode => (\n    <ControlRow\n      key={path}\n      path={path}\n      resolved={resolved}\n      config={config}\n      setConfig={setConfig}\n      renderers={renderers}\n      showHidden={showHidden}\n    />\n  );\n\n  return (\n    <PropertyList className={className ? `lk-control-panel ${className}` : 'lk-control-panel'}>\n      {loose.map(row)}\n      {resolved.sections.map((section) => (\n        <PropertyGroup key={section.label} title={section.label}>\n          {section.paths.map(row)}\n        </PropertyGroup>\n      ))}\n    </PropertyList>\n  );\n}\n\ninterface ControlRowProps<TC extends Record<string, unknown>> {\n  path: string;\n  resolved: ResolvedConfig;\n  config: TC;\n  setConfig: (key: keyof TC, value: unknown) => void;\n  renderers?: Record<string, ControlRenderer>;\n  showHidden: boolean;\n}\n\n/** Reads a labkit-only extra off a leaf. `PrefLeaf` has no field for these,\n *  and extra keys survive the resolve pass at runtime. */\nfunction extra<T>(leaf: PrefLeaf, key: string): T | undefined {\n  return (leaf as unknown as Record<string, T | undefined>)[key];\n}\n\nfunction ControlRow<TC extends Record<string, unknown>>({\n  path,\n  resolved,\n  config,\n  setConfig,\n  renderers,\n  showHidden,\n}: ControlRowProps<TC>) {\n  const leaf = resolved.group.children[path] as PrefLeaf | undefined;\n  if (!leaf || !('kind' in leaf)) return null;\n  if (!isLeafVisible(resolved, path, config as Record<string, unknown>, showHidden)) return null;\n\n  const write = (value: unknown): void => setConfig(path as keyof TC, value);\n  const fallback = extra<unknown>(leaf, 'default');\n  const value = config[path] ?? fallback;\n\n  // Most specific wins, and within a tier the lab's entry beats the\n  // instrument's: controls[path] -> node .render -> controls[kind] -> built-in.\n  const custom = renderers?.[path] ?? resolved.renderers[path] ?? renderers?.[leaf.kind];\n  if (custom) return custom({ path, pref: leaf, value, setValue: write });\n\n  const label = leaf.name;\n  const description = leaf.description;\n  const read = <T,>(): T => value as T;\n\n  if (!isBuiltinToolPref(leaf))\n    return <UnwiredRow label={label} kind={leaf.kind} description={description} />;\n\n  switch (leaf.kind) {\n    case 'number': {\n      const min = extra<number>(leaf, 'min');\n      const max = extra<number>(leaf, 'max');\n      const step = extra<number>(leaf, 'step');\n      if (extra<string>(leaf, 'control') === 'slider' && min !== undefined && max !== undefined) {\n        return (\n          <SliderRow\n            label={label}\n            value={read<number>()}\n            min={min}\n            max={max}\n            step={step}\n            onChange={write}\n            description={description}\n          />\n        );\n      }\n      // NumberRow commits every keystroke and does not clamp, so the bounds a\n      // schema declares are enforced here — an instrument should never be\n      // handed a config value outside the range it asked for.\n      const lo = min ?? Number.NEGATIVE_INFINITY;\n      const hi = max ?? Number.POSITIVE_INFINITY;\n      return (\n        <NumberRow\n          label={label}\n          value={read<number>()}\n          min={min}\n          max={max}\n          step={step}\n          onChange={(n) => write(Math.min(hi, Math.max(lo, n)))}\n          description={description}\n        />\n      );\n    }\n    case 'boolean':\n      return (\n        <CheckboxRow\n          label={label}\n          value={read<boolean>()}\n          onChange={write}\n          description={description}\n        />\n      );\n    case 'enum': {\n      const options = extra<readonly { value: string; label: string }[]>(leaf, 'options') ?? [];\n      const Row = extra<string>(leaf, 'control') === 'radio' ? ToggleRow : SelectRow;\n      return (\n        <Row\n          label={label}\n          value={read<string>()}\n          options={options}\n          onChange={write}\n          description={description}\n        />\n      );\n    }\n    case 'string':\n      return (\n        <DebouncedTextRow\n          leaf={leaf}\n          label={label}\n          value={read<string>()}\n          write={write}\n          description={description}\n        />\n      );\n    case 'color':\n      return (\n        <ColorRow label={label} value={read<string>()} onChange={write} description={description} />\n      );\n    case 'paint':\n    case 'object':\n      // Declined: a hex swatch would write a solid over a gradient, and a flat\n      // row would write one field into a half-built object. Override with\n      // `render` to edit either.\n      return <UnwiredRow label={label} kind={leaf.kind} description={description} />;\n    default: {\n      // Not reachable while every built-in kind has an arm — and a new kind\n      // that lacks one is a compile error here, never a blank row.\n      const _exhaustive: never = leaf;\n      throw new Error(\n        `ControlPanel: no control for built-in pref kind \"${(_exhaustive as { kind: string }).kind}\"`,\n      );\n    }\n  }\n}\n\n/** A leaf this panel has no control for is named rather than dropped: a silent\n *  gap reads as \"this control does not exist\". */\nfunction UnwiredRow({\n  label,\n  kind,\n  description,\n}: {\n  label: string;\n  kind: string;\n  description?: string;\n}) {\n  return (\n    <PropertyRow label={label} description={description}>\n      <span className=\"lk-control-panel__unknown\">no control for “{kind}”</span>\n    </PropertyRow>\n  );\n}\n\n/** Text writes are debounced so typing does not re-run the instrument on every\n *  keystroke, which means the row is locally controlled between commits and has\n *  to notice when the config changes underneath it. */\nfunction DebouncedTextRow({\n  leaf,\n  label,\n  value,\n  write,\n  description,\n}: {\n  leaf: PrefLeaf;\n  label: string;\n  value: string;\n  write: (value: unknown) => void;\n  description?: string;\n}) {\n  const debounceMs = extra<number>(leaf, 'debounceMs') ?? 150;\n  const [local, setLocal] = useState(value);\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastExternal = useRef(value);\n\n  useEffect(() => {\n    if (value !== lastExternal.current) {\n      lastExternal.current = value;\n      setLocal(value);\n    }\n  }, [value]);\n\n  useEffect(\n    () => () => {\n      if (timer.current) clearTimeout(timer.current);\n    },\n    [],\n  );\n\n  return (\n    <TextRow\n      label={label}\n      description={description}\n      value={local}\n      placeholder={extra<string>(leaf, 'placeholder')}\n      maxLength={extra<number>(leaf, 'maxLength')}\n      onChange={(next) => {\n        setLocal(next);\n        if (timer.current) clearTimeout(timer.current);\n        const commit = () => {\n          lastExternal.current = next;\n          write(next);\n        };\n        if (debounceMs === 0) commit();\n        else timer.current = setTimeout(commit, debounceMs);\n      }}\n    />\n  );\n}\n"]}