@weasel-js/labkit 1.7.0 → 1.7.1

package/dist/dragdrop/index.d.ts

@@ -1,19 +1,25 @@
-import { n as PaletteItem, o as DragFeedback, q as DragDropCapability } from '../_dts/types-CSm9jgol.js';
+import { l as PaletteItem, m as DragFeedback, n as DragDropCapability } from '../_dts/index-DCMA4Fy1.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 '@weasel-js/ui';
 import '@weasel-js/core';
-import '../_dts/PrefsRow.d-TOZ7BgD9.js';
 import '@weasel-js/theme';
-import '../_dts/types-CRPSGFAp.js';
+import '../_dts/types-BUBSIZuV.js';
+import '@weasel-js/quantity';
+import '@weasel-js/geom';
 import '../_dts/types-DJ79Tg5J.js';
 
+/** A palette drag in progress. `screenPos` is in client pixels; `feedback` is
+ *  the last `onDragOver` answer — `null` off the canvas or without one. */
 interface DragState {
     item: PaletteItem;
     screenPos: Point;
     feedback: DragFeedback | null;
 }
+/** Inputs to `useDragDrop`: the capability, the element that counts as the
+ *  drop target, and the trial state a drop rewrites. */
 interface UseDragDropArgs<TS, TC> {
     capability: DragDropCapability<TS, TC>;
     canvasContainerRef: RefObject<HTMLElement | null>;
@@ -26,27 +32,41 @@ interface UseDragDropArgs<TS, TC> {
     setState: (next: TS | ((prev: TS) => TS)) => void;
     emit: (event: string) => void;
 }
+/** The live drag, and the handler a palette item calls on pointerdown. */
 interface UseDragDropResult {
     drag: DragState | null;
     startDrag: (item: PaletteItem, e: PointerEvent) => void;
 }
+/**
+ * Run palette-to-canvas drags for a `DragDropCapability`. Releasing over the
+ * container converts the pointer to world coordinates, applies `onDrop`'s
+ * state and emits `'canvas.itemAdded'`; releasing anywhere else, or a canceled
+ * gesture, drops nothing. `onDragOver` is probed at most once per frame.
+ */
 declare function useDragDrop<TS, TC>({ capability, canvasContainerRef, view, state, config, setState, emit, worldSpec, }: UseDragDropArgs<TS, TC>): UseDragDropResult;
+/** Props for `DragOverlay`. */
 interface DragOverlayProps {
     drag: DragState | null;
 }
+/** The ghost for `drag`, or nothing when no drag is live. */
 declare function DragOverlay({ drag }: DragOverlayProps): react.JSX.Element | null;
 
+/** Props for `DragGhost`. `screenPos` is in client pixels. */
 interface DragGhostProps {
     item: PaletteItem;
     screenPos: Point;
 }
+/** The dragged item's label, portaled to `document.body` just below-right of
+ *  `screenPos`. Renders nothing until mounted, so it is SSR-safe. */
 declare function DragGhost({ item, screenPos }: DragGhostProps): ReactPortal | null;
 
+/** Props for `Palette`. `onDragStart` is usually `useDragDrop`'s `startDrag`. */
 interface PaletteProps {
     items: PaletteItem[];
     onDragStart: (item: PaletteItem, e: PointerEvent) => void;
     className?: string;
 }
+/** One button per item, each starting a drag on pointerdown. */
 declare function Palette({ items, onDragStart, className }: PaletteProps): react.JSX.Element;
 
 export { DragDropCapability, DragFeedback, DragGhost, DragOverlay, Palette, PaletteItem, useDragDrop };

package/dist/dragdrop/index.js

@@ -1,5 +1,6 @@
-export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-WPLAANH4.js';
-import '../chunk-AWQG7FCC.js';
-import '../chunk-24W5VEJW.js';
+export { DragGhost, DragOverlay, Palette, useDragDrop } from '../chunk-2N7UBSS2.js';
+import '../chunk-FG3EXZDV.js';
+import '../chunk-ULYYNWGP.js';
+import '../chunk-XVUKDSYV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map