@weasel-js/labkit 1.5.2 → 1.6.1

package/dist/{chunk-RS3HRQWU.js → chunk-WPLAANH4.js}

@@ -1,4 +1,5 @@
-import { resolveFrame, screenToWorld } from './chunk-2AYGEN57.js';
+import { screenToWorld } from './chunk-AWQG7FCC.js';
+import { resolveFrame } from './chunk-24W5VEJW.js';
 import { useState, useEffect, useRef, useCallback } from 'react';
 import { createPortal } from 'react-dom';
 import { jsx } from 'react/jsx-runtime';
@@ -138,5 +139,5 @@ function Palette({ items, onDragStart, className }) {
 }
 
 export { DragGhost, DragOverlay, Palette, useDragDrop };
-//# sourceMappingURL=chunk-RS3HRQWU.js.map
-//# sourceMappingURL=chunk-RS3HRQWU.js.map
+//# sourceMappingURL=chunk-WPLAANH4.js.map
+//# sourceMappingURL=chunk-WPLAANH4.js.map

package/dist/chunk-WPLAANH4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dragdrop/DragGhost.tsx","../src/dragdrop/DragDropRuntime.tsx","../src/dragdrop/Palette.tsx"],"names":["useState","useEffect","jsx"],"mappings":"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","file":"chunk-WPLAANH4.js","sourcesContent":["import { type ReactPortal, useEffect, useState } from 'react';\nimport { createPortal } from 'react-dom';\nimport type { PaletteItem, Point } from '../instrument/types';\n\nexport interface DragGhostProps {\n  item: PaletteItem;\n  screenPos: Point;\n}\n\nexport function DragGhost({ item, screenPos }: DragGhostProps): ReactPortal | null {\n  const [mounted, setMounted] = useState(false);\n  useEffect(() => setMounted(true), []);\n  if (!mounted || typeof document === 'undefined') return null;\n  const style = {\n    left: `${screenPos.x + 12}px`,\n    top: `${screenPos.y + 12}px`,\n  };\n  return createPortal(\n    <div className=\"lk-drag-ghost\" style={style}>\n      <span className=\"lk-drag-ghost__label\">{item.label}</span>\n    </div>,\n    document.body,\n  );\n}\n","import { openPointerSession, type PointerSession, useVisibleRaf } from '@weasel-js/core';\nimport {\n  type PointerEvent as ReactPointerEvent,\n  type RefObject,\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n} from 'react';\nimport { screenToWorld } from '../canvas/canvasCoords';\nimport { resolveFrame, type WorldSpec } from '../canvas/worldSpec';\nimport type {\n  DragDropCapability,\n  DragFeedback,\n  PaletteItem,\n  Point,\n  ViewTransform,\n} from '../instrument/types';\nimport { DragGhost } from './DragGhost';\n\nexport interface DragState {\n  item: PaletteItem;\n  screenPos: Point;\n  feedback: DragFeedback | null;\n}\n\nexport interface UseDragDropArgs<TS, TC> {\n  capability: DragDropCapability<TS, TC>;\n  canvasContainerRef: RefObject<HTMLElement | null>;\n  view: ViewTransform;\n  /** The instrument's coordinate system, resolved against the container each\n   *  time a screen point is converted — the container is what knows its size. */\n  worldSpec?: WorldSpec;\n  state: TS;\n  config: TC;\n  setState: (next: TS | ((prev: TS) => TS)) => void;\n  emit: (event: string) => void;\n}\n\nexport interface UseDragDropResult {\n  drag: DragState | null;\n  startDrag: (item: PaletteItem, e: ReactPointerEvent) => void;\n}\n\nexport function useDragDrop<TS, TC>({\n  capability,\n  canvasContainerRef,\n  view,\n  state,\n  config,\n  setState,\n  emit,\n  worldSpec,\n}: UseDragDropArgs<TS, TC>): UseDragDropResult {\n  const [drag, setDrag] = useState<DragState | null>(null);\n  const dragRef = useRef<DragState | null>(null);\n  dragRef.current = drag;\n  /** The move the next frame will resolve. Doubles as the throttle's flag:\n   *  non-null means a frame is already queued. */\n  const pendingPos = useRef<Point | null>(null);\n  const sessionRef = useRef<PointerSession | null>(null);\n\n  /** A session keeps the closure it was opened with, so everything the drop\n   *  reads has to come from here rather than from that closure. */\n  const liveRef = useRef({ capability, state, config, setState, emit, view, worldSpec });\n  liveRef.current = { capability, state, config, setState, emit, view, worldSpec };\n\n  const isOverCanvas = useCallback(\n    (screenPos: Point): boolean => {\n      const el = canvasContainerRef.current;\n      if (!el) return false;\n      const r = el.getBoundingClientRect();\n      return (\n        screenPos.x >= r.left &&\n        screenPos.x <= r.right &&\n        screenPos.y >= r.top &&\n        screenPos.y <= r.bottom\n      );\n    },\n    [canvasContainerRef],\n  );\n\n  const screenToWorldFromContainer = useCallback(\n    (screenPos: Point): Point | null => {\n      const el = canvasContainerRef.current;\n      if (!el) return null;\n      const r = el.getBoundingClientRect();\n      const frame = resolveFrame(liveRef.current.worldSpec, { width: r.width, height: r.height });\n      return screenToWorld(\n        { x: screenPos.x - r.left, y: screenPos.y - r.top },\n        liveRef.current.view,\n        frame,\n      );\n    },\n    [canvasContainerRef],\n  );\n\n  const frameLoop = useVisibleRaf(() => {\n    const screenPos = pendingPos.current;\n    pendingPos.current = null;\n    const active = dragRef.current;\n    if (!active || !screenPos) return;\n    const live = liveRef.current;\n    let feedback: DragFeedback | null = null;\n    if (live.capability.onDragOver && isOverCanvas(screenPos)) {\n      const world = screenToWorldFromContainer(screenPos);\n      if (world) feedback = live.capability.onDragOver(world, active.item, live.state, live.config);\n    }\n    setDrag({ ...active, screenPos, feedback });\n  });\n\n  const clearDrag = useCallback(() => {\n    pendingPos.current = null;\n    frameLoop.cancel();\n    sessionRef.current = null;\n    dragRef.current = null;\n    setDrag(null);\n  }, [frameLoop]);\n\n  const startDrag = useCallback(\n    (item: PaletteItem, e: ReactPointerEvent) => {\n      if (sessionRef.current) return;\n      const next: DragState = { item, screenPos: { x: e.clientX, y: e.clientY }, feedback: null };\n      dragRef.current = next;\n      setDrag(next);\n      sessionRef.current = openPointerSession(e.currentTarget, e, {\n        onMove: (ev) => {\n          const screenPos = { x: ev.clientX, y: ev.clientY };\n          const current = dragRef.current;\n          if (!current) return;\n          if (pendingPos.current !== null) {\n            // A frame is already queued: keep the ghost under the cursor and\n            // let that frame probe the drop target from the newest position.\n            pendingPos.current = screenPos;\n            dragRef.current = { ...current, screenPos };\n            setDrag(dragRef.current);\n            return;\n          }\n          pendingPos.current = screenPos;\n          frameLoop.request();\n        },\n        onEnd: (ev) => {\n          const screenPos = { x: ev.clientX, y: ev.clientY };\n          const active = dragRef.current;\n          clearDrag();\n          if (!active || !isOverCanvas(screenPos)) return;\n          const world = screenToWorldFromContainer(screenPos);\n          if (!world) return;\n          const live = liveRef.current;\n          live.setState(live.capability.onDrop(world, active.item, live.state, live.config));\n          live.emit('canvas.itemAdded');\n        },\n        // An interrupted gesture never named a destination, so it drops nothing.\n        onCancel: clearDrag,\n      });\n    },\n    [clearDrag, frameLoop, isOverCanvas, screenToWorldFromContainer],\n  );\n\n  useEffect(() => () => sessionRef.current?.cancel(), []);\n\n  return { drag, startDrag };\n}\n\nexport interface DragOverlayProps {\n  drag: DragState | null;\n}\n\nexport function DragOverlay({ drag }: DragOverlayProps) {\n  if (!drag) return null;\n  return <DragGhost item={drag.item} screenPos={drag.screenPos} />;\n}\n","import type { PointerEvent as ReactPointerEvent } from 'react';\nimport type { PaletteItem } from '../instrument/types';\n\nexport interface PaletteProps {\n  items: PaletteItem[];\n  onDragStart: (item: PaletteItem, e: ReactPointerEvent) => void;\n  className?: string;\n}\n\nexport function Palette({ items, onDragStart, className }: PaletteProps) {\n  return (\n    <div className={className ? `lk-palette ${className}` : 'lk-palette'}>\n      {items.map((item) => (\n        <button\n          type=\"button\"\n          key={item.id}\n          className=\"lk-palette__item\"\n          onPointerDown={(e) => {\n            e.preventDefault();\n            onDragStart(item, e);\n          }}\n        >\n          <span className=\"lk-palette__label\">{item.label}</span>\n        </button>\n      ))}\n    </div>\n  );\n}\n"]}

package/dist/config/index.d.ts

@@ -1,11 +1,14 @@
-import { a0 as Auto, K as Instrument } from '../_dts/frac-B4hFJMiN.js';
-export { ax as auto, aD as isAuto } from '../_dts/frac-B4hFJMiN.js';
-import { R as ResolvedConfig, l as ConfigNode, A as Annotations, N as NodeOptions, v as SectionOption, d as ControlRenderer, n as ConfigOption, p as ConfigShape, h as ConfigBranch, B as BranchAnnotations, e as BranchOptions, b as ConfigSchema, I as InferConfig, i as ConfigEntry, a as ConfigField, c as ConfigRule, L as LeafPatch, o as ConfigRuleContext } from '../_dts/types-Db-3NNk1.js';
-export { m as ConfigOf, C as ConfigPath, E as EntryValue, q as NodeValue, S as SectionSpec, V as ValueAtPath } from '../_dts/types-Db-3NNk1.js';
+import { a5 as Auto } from '../_dts/types-B7yBTTF9.js';
+import { Instrument } from '../index.js';
+export { aC as auto, aI as isAuto } from '../_dts/types-B7yBTTF9.js';
+import { R as ResolvedConfig, l as ConfigNode, A as Annotations, N as NodeOptions, S as SectionOption, d as ControlRenderer, I as InDialogOptions, n as ConfigOption, p as ConfigShape, h as ConfigBranch, B as BranchAnnotations, e as BranchOptions, b as ConfigSchema, q as InferConfig, i as ConfigEntry, c as ConfigRule, L as LeafPatch, o as ConfigRuleContext } from '../_dts/types-DTuViBvc.js';
+import { ConfigField } from '../controls/index.js';
+export { m as ConfigOf, C as ConfigPath, D as DialogSpec, E as EntryValue, r as NodeValue, t as SectionSpec, V as ValueAtPath } from '../_dts/types-DTuViBvc.js';
 import { ToolPrefNumberFormat, ToolPrefNumberUnit, ToolPrefLeaf, ToolPrefGroup } from '@weasel-js/core';
 import 'react';
+import '../_dts/PrefsRow.d-DFpPIeIC.js';
+import '@weasel-js/theme';
 import '../_dts/types-DJ79Tg5J.js';
-import '../_dts/PrefsForm.d-DPy9I8It.js';
 
 /** The dotted paths a schema declares as starting auto — every leaf that said
  *  `.initial(auto)`. This is what seeds a new trial's unpinned set. */
@@ -52,6 +55,9 @@ declare abstract class BaseNode<T> implements ConfigNode<T> {
     showIf(predicate: (config: Record<string, unknown>) => boolean): this;
     /** Draw this one row yourself, keeping the kind, default and validation. */
     render(renderer: ControlRenderer): this;
+    /** Draw this row as a button that opens a dialog, with `body` as the
+     *  dialog's content — for an editor too big for the row. */
+    dialog(body: ControlRenderer, opts?: InDialogOptions): this;
     /**
      * Compute this leaf's value while it is auto, instead of leaving it
      * `undefined`. The resolver is given the config with every other auto path
@@ -75,7 +81,7 @@ declare class NumberNode extends BaseNode<number> {
     /** A display suffix for the value — `'px'`, `'ms'`, `'°'`. Presentation only:
      *  it is never parsed, and the stored value stays a plain number. */
     suffix(suffix: string): this;
-    /** Show the value in a named format — `'compact'` reads `2.0M`. Presentation
+    /** Show the value in a named format — `'compact'` reads `2.00M`. Presentation
      *  only: the stored value stays a plain number, and a typed `2.5m` reads back. */
     format(format: ToolPrefNumberFormat): this;
     /**
@@ -102,6 +108,11 @@ declare class StringNode extends BaseNode<string> {
     /** Milliseconds to debounce live writes. 0 commits every keystroke. */
     debounce(debounceMs: number): this;
 }
+declare class ListNode extends BaseNode<string[]> {
+    readonly kind = "list";
+    /** Shown in an empty entry. */
+    placeholder(placeholder: string): this;
+}
 declare class ColorNode extends BaseNode<string> {
     readonly kind = "color";
     /** The value carries alpha as `#rrggbbaa`, and the row gets an opacity
@@ -166,6 +177,9 @@ declare const f: {
     boolean: (def: boolean) => BooleanNode;
     string: (def: string) => StringNode;
     color: (def: string) => ColorNode;
+    /** A list of strings. Its row summarizes the list, and opens a dialog to
+     *  edit it one entry per field. */
+    list: (def: readonly string[]) => ListNode;
     /** A fixed set of choices. The default's literal type flows into the config
      *  type, so `f.enum('fast', ['fast', 'accurate'])` gives
      *  `'fast' | 'accurate'` with no `as const`. */
@@ -243,6 +257,35 @@ declare const builtinRules: readonly ConfigRule[];
  */
 declare function applyRules(seed: LeafPatch, ctx: Omit<ConfigRuleContext, 'leaf'>, rules: readonly ConfigRule[]): LeafPatch;
 
+/**
+ * A resolved schema rearranged so its sections are groups.
+ *
+ * `PrefsForm`'s rail navigates the schema tree — top-level groups are its
+ * items, their group children indent under them. A resolved schema keeps its
+ * sections beside the tree instead, so a flat schema's rail comes out as one
+ * unnamed item however many headings the panel draws. This puts the sections
+ * where the rail looks for them.
+ */
+interface SectionTree {
+    /** The rail's schema. Top-level children are the schema's root sections,
+     *  followed by any root node no section claimed. */
+    group: ToolPrefGroup;
+    /** `config` renested to mirror `group` — the value tree `PrefsForm` takes. */
+    values: Record<string, unknown>;
+    /** The config path a path within `group` stands for. */
+    pathAt: (railPath: string) => string;
+}
+/**
+ * Turn a resolved schema's root sections into the top level of a `PrefGroup`,
+ * for `PrefsForm`'s rail layout.
+ *
+ * A section naming a group brings that group in whole, so it lands as an
+ * indented rail item; a section naming a leaf drops it loose into the
+ * section's own pane. Sections nested under a group are left alone — they
+ * bucket rows inside a pane, which is the panel's job and not the rail's.
+ */
+declare function sectionTree(resolved: ResolvedConfig, config: Record<string, unknown>, showHidden?: boolean): SectionTree;
+
 /**
  * An instrument's controls, resolved against the surrounding lab's rules.
  *
@@ -272,4 +315,5 @@ declare function useResolvedConfig<TC>(schema: ResolvedConfig | undefined, confi
  */
 declare function isLeafVisible(resolved: ResolvedConfig, path: string, config: Record<string, unknown>, showHidden?: boolean): boolean;
 
-export { Annotations, Auto, BaseNode, BooleanNode, BranchAnnotations, BranchOptions, ColorNode, ConfigBranch, ConfigEntry, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ConfigShape, ControlRenderer, CustomNode, EnumNode, GroupNode, InferConfig, LeafPatch, NodeOptions, NumberNode, ResolvedConfig, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, titleCase, useConfigSchema, useResolvedConfig, valueAtPath, withValueAtPath };
+export { Annotations, Auto, BaseNode, BooleanNode, BranchAnnotations, BranchOptions, ColorNode, ConfigBranch, ConfigEntry, ConfigNode, ConfigOption, ConfigRule, ConfigRuleContext, ConfigSchema, ConfigShape, ControlRenderer, CustomNode, EnumNode, GroupNode, InDialogOptions, InferConfig, LeafPatch, ListNode, NodeOptions, NumberNode, ResolvedConfig, SectionOption, StringNode, ValueNode, applyRules, autoPathsOf, builtinRules, f, fillConfigDefaults, fromConfigFields, hasConfigPath, isConfigBranch, isLeafVisible, resolveAutoConfig, resolveConfigSchema, schemaNodeAtPath, sectionTree, titleCase, useConfigSchema, useResolvedConfig, valueAtPath, withValueAtPath };
+export type { SectionTree };

package/dist/config/index.js

@@ -1,8 +1,7 @@
-export { useConfigSchema } from '../chunk-6BUQ77ZV.js';
+export { sectionTree, useConfigSchema } from '../chunk-GHGO52SO.js';
 import '../chunk-Z76KEZAX.js';
-export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig } from '../chunk-A2ACAGW6.js';
-export { fromConfigFields, isLeafVisible } from '../chunk-EMXAIRUJ.js';
-export { auto, autoPathsOf, fillConfigDefaults, hasConfigPath, isAuto, resolveAutoConfig, schemaNodeAtPath, valueAtPath, withValueAtPath } from '../chunk-REOBGYMC.js';
-import '../chunk-LASCBWW7.js';
+export { BaseNode, BooleanNode, ColorNode, CustomNode, EnumNode, GroupNode, ListNode, NumberNode, StringNode, ValueNode, applyRules, builtinRules, f, isConfigBranch, resolveConfigSchema, titleCase, useResolvedConfig } from '../chunk-O6FFFOHS.js';
+export { fromConfigFields, isLeafVisible } from '../chunk-IRTGUQ5O.js';
+export { auto, autoPathsOf, fillConfigDefaults, hasConfigPath, isAuto, resolveAutoConfig, schemaNodeAtPath, valueAtPath, withValueAtPath } from '../chunk-TJ77A4A3.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/controls/index.d.ts

@@ -1,6 +1,93 @@
-export { e as ControlPanel } from '../_dts/index-8LiKe3A-.js';
-export { f as CheckboxField, g as ColorField, a as ConfigField, k as ConfigFieldType, r as NumberField, s as SelectField, t as SelectOption, u as SliderField, T as TextField } from '../_dts/types-Db-3NNk1.js';
-import 'react/jsx-runtime';
-import 'react';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { StanceProps } from '../passthrough/weasel-ui.js';
+import { PropertyRowLayout } from '../index.js';
+import { PropertyDensity, PropertyAlign } from '../passthrough/weasel-ui.js';
+import { a as ConfigField, I as InDialogOptions } from '../_dts/types-DTuViBvc.js';
+import { ResolvedConfig, ControlRenderer } from '../config/index.js';
+export { f as CheckboxField, g as ColorField, k as ConfigFieldType, s as NumberField, u as SelectField, v as SelectOption, w as SliderField, T as TextField } from '../_dts/types-DTuViBvc.js';
+import '@weasel-js/theme';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DPy9I8It.js';
+
+/** How a panel packs its rows into the two-column property grid.
+ *   - `'auto'`: narrow controls (numbers, checkboxes, dropdowns, colors) sit
+ *     two per row; the ones that need the width — text, sliders, segmented
+ *     toggles — span it.
+ *   - `'pairs'`: every row pairs. A control that needs the full width says so
+ *     itself, with `<PropertyRow span>`.
+ *   - `'one-up'`: one control per row, colors excepted.
+ */
+type ControlPack = 'auto' | 'pairs' | 'one-up';
+interface ControlPanelProps<TC extends Record<string, unknown>> extends StanceProps {
+    /** The instrument's resolved config schema. */
+    schema?: ResolvedConfig;
+    /** @deprecated Pass `schema`. A field list is adapted into one internally. */
+    fields?: ConfigField[];
+    config: TC;
+    /** Writes one value. The path is dotted for a leaf inside an `f.group`, and
+     *  the bare key for one at the root. */
+    setConfig: (path: string, value: unknown) => void;
+    /**
+     * Control overrides and app-defined kinds, PrefsForm-style. Keys are config
+     * paths (checked first) or leaf kinds. A renderer returning `null` collapses
+     * the row; entries override the built-in rows on collision.
+     */
+    renderers?: Record<string, ControlRenderer>;
+    /** How rows pack into the two-column grid. Defaults to `'pairs'`. */
+    pack?: ControlPack;
+    /**
+     * Where a row's label sits relative to its control. Unset takes each row's
+     * own orientation — `block` (label above, which is what leaves a paired row
+     * room for its value) for most, `inline` for colors and checkboxes.
+     */
+    layout?: PropertyRowLayout;
+    /** Room the rows get. Passed straight to the property list. */
+    density?: PropertyDensity;
+    /** Cross-axis alignment of an inline row's label and control. */
+    align?: PropertyAlign;
+    /**
+     * Fold each section away behind a twisty, starting `'open'` or `'closed'`.
+     * Unset draws the heading alone, as the panel always has — unless a section
+     * in the schema declares how it opens, which makes that section foldable on
+     * its own and outranks this for that one section.
+     */
+    collapse?: 'open' | 'closed';
+    /**
+     * Which sections are folded, keyed as `onCollapse` reports them. Given, the
+     * panel keeps no state of its own: every toggle arrives at `onCollapse`
+     * instead, which is where a lab that remembers a trial's sections writes
+     * them.
+     */
+    collapsed?: Readonly<Record<string, boolean>>;
+    /** A fold moved. The key is a section's label — prefixed by its group's
+     *  dotted path when the section sits inside one — or a group's own path. */
+    onCollapse?: (key: string, collapsed: boolean) => void;
+    /** Dotted paths currently unpinned. A row in this set hides its control and
+     *  reads out `auto`, and clicking its label writes the sentinel back through
+     *  `setConfig`. Omitted, the panel keeps the set itself: the labels still
+     *  toggle and the sentinel never reaches `setConfig`, which would otherwise
+     *  store it as the row's value. */
+    auto?: ReadonlySet<string>;
+    /** Draw leaves marked `hidden`. */
+    showHidden?: boolean;
+    /** Heads the panel. With `title`, `stance` or `tone` given, the rows sit in a
+     *  `<PropertyPanel>` carrying them; with none, they are the bare list. */
+    title?: ReactNode;
+    className?: string;
+}
+/** Render an instrument's config schema as a stack of controls, each writing
+ *  back through `setConfig`. Built on the property rows, so a lab's controls
+ *  are the same aligned, themed rows the rest of the kit uses. */
+declare function ControlPanel<TC extends Record<string, unknown>>({ schema, fields, config, setConfig, renderers, pack, layout, density, align, collapse, collapsed, onCollapse, auto: given, showHidden, title, stance, tone, className, }: ControlPanelProps<TC>): react.JSX.Element;
+
+/** The one-line summary a dialog row shows when it is given none. */
+declare function summarizeValue(value: unknown): string;
+/**
+ * Moves a control into a modal: the row becomes a button showing a summary of
+ * the value, and the button opens a dialog whose body is `body`, handed the
+ * same context a row renderer gets. For a leaf whose editor will never fit a
+ * sidebar row.
+ */
+declare function inDialog(body: ControlRenderer, opts?: InDialogOptions): ControlRenderer;
+
+export { ConfigField, ControlPanel, InDialogOptions, inDialog, summarizeValue };

package/dist/controls/index.js

@@ -1,6 +1,7 @@
-export { ControlPanel } from '../chunk-FKLT3ITC.js';
-import '../chunk-EMXAIRUJ.js';
-import '../chunk-REOBGYMC.js';
-import '../chunk-LASCBWW7.js';
+export { ControlPanel, inDialog, summarizeValue } from '../chunk-ASOK76ZH.js';
+import '../chunk-IRTGUQ5O.js';
+import '../chunk-TJ77A4A3.js';
+import '../chunk-TYN6MLXX.js';
+import '../chunk-QGMOA2YE.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/dragdrop/index.d.ts

@@ -1,9 +1,12 @@
-import { P as PaletteItem, l as Point, m as DragFeedback, n as DragDropCapability, k as ViewTransform, a as WorldSpec } from '../_dts/frac-B4hFJMiN.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import { n as PaletteItem, o as DragFeedback, q as DragDropCapability } from '../_dts/types-B7yBTTF9.js';
+import { WorldSpec } from '../canvas/index.js';
+import { Point, ViewTransform } from '../index.js';
+import * as react from 'react';
 import { RefObject, PointerEvent, ReactPortal } from 'react';
-import '../_dts/types-Db-3NNk1.js';
 import '@weasel-js/core';
-import '../_dts/PrefsForm.d-DPy9I8It.js';
+import '../_dts/PrefsRow.d-DFpPIeIC.js';
+import '@weasel-js/theme';
+import '../_dts/types-DTuViBvc.js';
 import '../_dts/types-DJ79Tg5J.js';
 
 interface DragState {
@@ -31,7 +34,7 @@ declare function useDragDrop<TS, TC>({ capability, canvasContainerRef, view, sta
 interface DragOverlayProps {
     drag: DragState | null;
 }
-declare function DragOverlay({ drag }: DragOverlayProps): react_jsx_runtime.JSX.Element | null;
+declare function DragOverlay({ drag }: DragOverlayProps): react.JSX.Element | null;
 
 interface DragGhostProps {
     item: PaletteItem;
@@ -44,7 +47,7 @@ interface PaletteProps {
     onDragStart: (item: PaletteItem, e: PointerEvent) => void;
     className?: string;
 }
-declare function Palette({ items, onDragStart, className }: PaletteProps): react_jsx_runtime.JSX.Element;
+declare function Palette({ items, onDragStart, className }: PaletteProps): react.JSX.Element;
 
 export { DragDropCapability, DragFeedback, DragGhost, DragOverlay, Palette, PaletteItem, useDragDrop };
 export type { DragGhostProps, DragOverlayProps, DragState, PaletteProps, UseDragDropArgs, UseDragDropResult };

package/dist/dragdrop/index.js

@@ -1,4 +1,5 @@
-export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-RS3HRQWU.js';
-import '../chunk-2AYGEN57.js';
+export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-WPLAANH4.js';
+import '../chunk-AWQG7FCC.js';
+import '../chunk-24W5VEJW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map