@weasel-js/labkit 1.6.1 → 1.7.1

package/dist/chunk-WPLAANH4.js.map

@@ -1 +0,0 @@
-{"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/src/primitives/useRovingTabIndex.test.ts

@@ -1,48 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { nextIndex } from './useRovingTabIndex';
-
-describe('nextIndex', () => {
-  it('steps forward and wraps', () => {
-    expect(nextIndex(0, 'ArrowRight', 3)).toBe(1);
-    expect(nextIndex(2, 'ArrowRight', 3)).toBe(0);
-  });
-
-  it('steps back and wraps', () => {
-    expect(nextIndex(1, 'ArrowLeft', 3)).toBe(0);
-    expect(nextIndex(0, 'ArrowLeft', 3)).toBe(2);
-  });
-
-  it('jumps to the ends', () => {
-    expect(nextIndex(1, 'Home', 3)).toBe(0);
-    expect(nextIndex(1, 'End', 3)).toBe(2);
-  });
-
-  it('returns null for a key it does not handle', () => {
-    expect(nextIndex(1, 'Enter', 3)).toBeNull();
-  });
-
-  it('returns null when there is nothing to move to', () => {
-    expect(nextIndex(0, 'ArrowRight', 0)).toBeNull();
-  });
-});
-
-describe('nextIndex — vertical', () => {
-  it('walks the down/up arrows', () => {
-    expect(nextIndex(0, 'ArrowDown', 3, 'vertical')).toBe(1);
-    expect(nextIndex(2, 'ArrowDown', 3, 'vertical')).toBe(0);
-    expect(nextIndex(1, 'ArrowUp', 3, 'vertical')).toBe(0);
-    expect(nextIndex(0, 'ArrowUp', 3, 'vertical')).toBe(2);
-  });
-
-  it('leaves the cross-axis arrows to the page', () => {
-    expect(nextIndex(0, 'ArrowRight', 3, 'vertical')).toBeNull();
-    expect(nextIndex(0, 'ArrowLeft', 3, 'vertical')).toBeNull();
-    expect(nextIndex(0, 'ArrowDown', 3)).toBeNull();
-    expect(nextIndex(0, 'ArrowUp', 3)).toBeNull();
-  });
-
-  it('still jumps to the ends', () => {
-    expect(nextIndex(1, 'Home', 3, 'vertical')).toBe(0);
-    expect(nextIndex(1, 'End', 3, 'vertical')).toBe(2);
-  });
-});

package/src/primitives/useRovingTabIndex.ts

@@ -1,88 +0,0 @@
-import { type KeyboardEvent, useCallback, useEffect, useRef } from 'react';
-
-/** Which axis a toolbar's arrow keys walk. Matches `aria-orientation`. */
-export type RovingOrientation = 'horizontal' | 'vertical';
-
-/** Where a key takes focus within `count` items, or null if it does not move it.
- *
- *  Only the arrows on the toolbar's own axis move focus — APG leaves the
- *  cross-axis arrows to the page, so a vertical strip does not swallow
- *  ArrowLeft. `Home` / `End` work on both. */
-export function nextIndex(
-  current: number,
-  key: string,
-  count: number,
-  orientation: RovingOrientation = 'horizontal',
-): number | null {
-  if (count === 0) return null;
-  const forward = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';
-  const back = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';
-  if (key === forward) return (current + 1) % count;
-  if (key === back) return (current - 1 + count) % count;
-  if (key === 'Home') return 0;
-  if (key === 'End') return count - 1;
-  return null;
-}
-
-/**
- * The APG roving-tabindex contract: exactly one item in the tab order, arrows
- * moving focus within. `tabIndex` is written onto the DOM nodes rather than
- * threaded through props, because the items are arbitrary children — the
- * container never sees them as a list it could index.
- */
-export function useRovingTabIndex<T extends HTMLElement>(
-  orientation: RovingOrientation = 'horizontal',
-) {
-  const ref = useRef<T | null>(null);
-  const stop = useRef(0);
-
-  const items = useCallback(
-    (): HTMLElement[] =>
-      ref.current
-        ? Array.from(
-            ref.current.querySelectorAll<HTMLElement>('button:not([disabled]), [role="button"]'),
-          )
-        : [],
-    [],
-  );
-
-  const setTabStop = useCallback(
-    (index: number) => {
-      const found = items();
-      const at = Math.min(Math.max(index, 0), Math.max(found.length - 1, 0));
-      stop.current = at;
-      for (const [i, el] of found.entries()) el.tabIndex = i === at ? 0 : -1;
-    },
-    [items],
-  );
-
-  // Re-establish the tab stop whenever the item set changes — a trial's toolbar
-  // contributions are dynamic, and `disabled` moves a button in and out of the
-  // set without touching the child list. The focused item keeps the stop.
-  useEffect(() => {
-    const resync = () => {
-      const focused = items().indexOf(document.activeElement as HTMLElement);
-      setTabStop(focused === -1 ? stop.current : focused);
-    };
-    resync();
-    if (!ref.current) return;
-    const mo = new MutationObserver(resync);
-    mo.observe(ref.current, { childList: true, subtree: true, attributeFilter: ['disabled'] });
-    return () => mo.disconnect();
-  }, [items, setTabStop]);
-
-  const onKeyDown = useCallback(
-    (e: KeyboardEvent<T>) => {
-      const found = items();
-      const current = found.indexOf(document.activeElement as HTMLElement);
-      const next = nextIndex(current === -1 ? 0 : current, e.key, found.length, orientation);
-      if (next === null) return;
-      e.preventDefault();
-      found[next]?.focus();
-      setTabStop(next);
-    },
-    [items, setTabStop, orientation],
-  );
-
-  return { ref, onKeyDown };
-}

package/src/state/Persistence.stories.tsx

@@ -1,75 +0,0 @@
-import type { Meta, StoryObj } from '@weasel-js/forge';
-import { expect, userEvent, waitFor, within } from '@weasel-js/forge/play';
-import { useState } from 'react';
-import { createIndexedDbAdapter } from './adapters';
-import { Persistence } from './Persistence';
-import { usePersistedState } from './usePersistedState';
-
-// jsdom only has fake-indexeddb, an imitation. This round-trips a value through
-// the browser's own IndexedDB: write it, unmount the provider so it closes,
-// mount a fresh one, and read it back.
-
-function Tab() {
-  const [tab, setTab] = usePersistedState('tab', 'shape');
-  return (
-    <p>
-      <output aria-label="tab">{tab}</output>
-      <button type="button" onClick={() => setTab('color')}>
-        choose color
-      </button>
-    </p>
-  );
-}
-
-function Remountable({ database }: { database: string }) {
-  const [generation, setGeneration] = useState(0);
-  const [shown, setShown] = useState(true);
-  const storage = useState(() => createIndexedDbAdapter({ database }))[0];
-  return (
-    <div>
-      <button
-        type="button"
-        onClick={() => {
-          setShown(false);
-          // Past the provider's deferred close, which sends the queued write.
-          setTimeout(() => {
-            setGeneration((g) => g + 1);
-            setShown(true);
-          }, 100);
-        }}
-      >
-        remount
-      </button>
-      {shown ? (
-        <Persistence
-          key={generation}
-          storageKey="story"
-          storage={storage}
-          fallback={<p>loading</p>}
-        >
-          <Tab />
-        </Persistence>
-      ) : null}
-    </div>
-  );
-}
-
-const meta: Meta<typeof Remountable> = {
-  title: 'labkit/State/Persistence',
-  component: Remountable,
-};
-export default meta;
-
-export const SurvivesARemountInIndexedDb: StoryObj<typeof Remountable> = {
-  args: { database: `labkit-story-${Date.now()}` },
-  play: async ({ canvasElement }) => {
-    const canvas = within(canvasElement);
-    await waitFor(() => expect(canvas.getByLabelText('tab').textContent).toBe('shape'));
-    await userEvent.click(canvas.getByText('choose color'));
-    await userEvent.click(canvas.getByText('remount'));
-    await waitFor(() => expect(canvas.queryByLabelText('tab')).toBeNull());
-    await waitFor(() => expect(canvas.getByLabelText('tab').textContent).toBe('color'), {
-      timeout: 3000,
-    });
-  },
-};