@weasel-js/routing 1.13.0-rc.0 → 1.14.0

package/dist/react.js

@@ -1,7 +1,10 @@
-import { createDepRegistry, createKeymapStack, createDispatchTrace, createDispatcher, describeKeymap, assembleEntries, liveScope, offhandKeyFor, makeToolOffhandAction, buildToolOffhandBindings, dlog, NO_OVERRIDES, reportRouteConflicts, ScopeNode, overrideActionBindings, tuneAction, resolveBindingOverrides, createMenuHost, pushOwner, evaluateEnabled, tunedParams, validateActionId, validateActionDefaultBinding, isTool, depNodeOf, DepNode, buildDepsFromRequires, clientToCanvas, LONG_PRESS_HAPTIC_MS, multiTouchGestureId, openPointerSession, addCarrySurface, carryGestureId, anyBinding, isEditableTarget, focusedControlOwnsKey, itemsFromClipboardData, itemsFromDataTransfer, itemTypesFromDataTransfer, actionCursor } from './chunk-CRF3ROBB.js';
-import { createContext, useState, useContext, useEffect, useMemo, useRef, useCallback, useSyncExternalStore } from 'react';
+import { createKeymapStack, createDispatchTrace, createDispatcher, describeKeymap, assembleEntries, liveScope, offhandKeyFor, makeToolOffhandAction, buildToolOffhandBindings, dlog, reportRouteConflicts, isTool, clientToCanvas, LONG_PRESS_HAPTIC_MS, multiTouchGestureId, openPointerSession, addCarrySurface, carryGestureId, anyBinding, isEditableTarget, focusedControlOwnsKey, itemsFromClipboardData, itemsFromDataTransfer, itemTypesFromDataTransfer, immediateParams } from './chunk-HR5F4LBX.js';
+import { useDepRegistry, actionsNodeOf, useAction, useActionsRegistry, useOptionalDepRegistry, ActionsNode, MenuHostContext, DepRegistryContext, ActionsContext } from './chunk-INZ63QGX.js';
+export { ActionsProvider, DepRegistryProvider, useAction, useActionsRegistry, useDepRegistry, useDepSource, useMenuHost, useMenus, useOptionalDepRegistry } from './chunk-INZ63QGX.js';
+import { NO_OVERRIDES, ScopeNode, depNodeOf, DepNode, actionCursor, buildDepsFromRequires } from './chunk-EUCNVGJV.js';
+import { createContext, useState, useContext, useEffect, useRef, useMemo, useCallback, useSyncExternalStore } from 'react';
 import { isApplePlatform, heldPointers, createPointerRecognizer, isInControlWithin, longPressEvents, stylusOf } from '@weasel-js/gestures';
-import { isDev, useLatest, useKitSettings, useStableByContent, sameList } from '@weasel-js/react';
+import { useLatest, useKitSettings, useStableByContent, sameList, isDev } from '@weasel-js/react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 import { createCursorSink, resolveCursorTier } from '@weasel-js/cursor';
 import { deepEqual, createEmitter } from '@weasel-js/registry';
@@ -89,323 +92,6 @@ function ActiveToolContextProviderIfRoot({
   if (parent !== null) return /* @__PURE__ */ jsx(Fragment, { children });
   return /* @__PURE__ */ jsx(ActiveToolContextProvider, { children });
 }
-var DepRegistryContext = createContext(null);
-function DepRegistryProvider({ children }) {
-  const [registry] = useState(createDepRegistry);
-  return /* @__PURE__ */ jsx(DepRegistryContext.Provider, { value: registry, children });
-}
-function useDepRegistry() {
-  const r = useContext(DepRegistryContext);
-  if (r === null) {
-    throw new Error("useDepRegistry: no DepRegistryProvider in scope. Wrap your tree with <DepRegistryProvider> (typically inside <SceneCanvas>).");
-  }
-  return r;
-}
-function useOptionalDepRegistry() {
-  return useContext(DepRegistryContext);
-}
-function useDepSource(name, source) {
-  const registry = useDepRegistry();
-  const sourceRef = useLatest(source);
-  useEffect(() => {
-    return registry.register(name, (below) => sourceRef.current(below));
-  }, [name, registry, sourceRef]);
-}
-var MenuHostContext = createContext(null);
-function useMenuHost() {
-  return useContext(MenuHostContext);
-}
-function useMenus(defs, owner = null) {
-  const host = useMenuHost();
-  useEffect(() => {
-    if (!host) return;
-    const releases = defs.map((d) => host.define(d, owner));
-    return () => {
-      for (const r of releases) r();
-    };
-  }, [host, defs, owner]);
-}
-var ActionsContext = createContext(null);
-function depsFor(a, r) {
-  if (!r) return {};
-  if (a.requires) return buildDepsFromRequires(a, r);
-  return {
-    selection: r.get("selection"),
-    scene: r.get("scene"),
-    history: r.get("history"),
-    view: r.get("view"),
-    activeTool: r.get("activeTool"),
-    booleansAdapter: r.get("booleansAdapter")
-  };
-}
-var ActionsNode = class extends ScopeNode {
-  constructor(parent, descends, contextDeps) {
-    super(parent, descends);
-    this.contextDeps = contextDeps;
-    NODES.set(this.registry, this);
-  }
-  contextDeps;
-  actions = /* @__PURE__ */ new Map();
-  muted = /* @__PURE__ */ new Map();
-  tunings = /* @__PURE__ */ new Map();
-  overrides = [];
-  overrideCache = null;
-  dispatchers = [];
-  cache = null;
-  host = null;
-  /** Called on `activate`, so a scope's dep and tool nodes move with it. */
-  onActivate = [];
-  resolve(id) {
-    for (const n of this.chain()) {
-      if (n.muted.has(id)) return void 0;
-      const a = n.actions.get(id)?.at(-1);
-      if (a) return this.tuned(a);
-    }
-    return void 0;
-  }
-  /** Every tuning for `id` from the root down to here, root first. */
-  tuningsOf(id) {
-    const tunings = [];
-    for (const n of this.chain()) {
-      const stack = n.tunings.get(id);
-      if (stack) tunings.unshift(...stack);
-    }
-    return tunings;
-  }
-  /** `a` under every tuning for its id from the root down to here. */
-  tuned(a) {
-    const tunings = this.tuningsOf(a.id);
-    return overrideActionBindings(tunings.length ? tuneAction(a, tunings) : a, this.overridesHere());
-  }
-  /** Every binding override from the root down to here, read into specs. */
-  overridesHere() {
-    const cached = this.overrideCache;
-    if (cached && cached.version === this.tree.version) return cached.resolved;
-    const maps = [];
-    for (const n of this.chain()) maps.unshift(...n.overrides);
-    const resolved = resolveBindingOverrides(maps);
-    this.overrideCache = { version: this.tree.version, resolved };
-    return resolved;
-  }
-  snapshot() {
-    const leaf = this.start();
-    const cached = this.cache;
-    if (cached && cached.version === this.tree.version && cached.leaf === leaf) return cached.list;
-    const ids = /* @__PURE__ */ new Set();
-    for (const n of leaf.chain()) for (const id of n.actions.keys()) ids.add(id);
-    const out = [];
-    for (const id of ids) {
-      const a = leaf.resolve(id);
-      if (a) out.push(a);
-    }
-    const list = Object.freeze(out);
-    this.cache = { version: this.tree.version, leaf, list };
-    return list;
-  }
-  deps() {
-    for (const n of this.chain()) {
-      const r = n.contextDeps();
-      if (r) return r;
-    }
-    return null;
-  }
-  /** The actions registered at this node itself, live, unmuted and tuned —
-   *  none from the scopes below it. */
-  ownActions() {
-    const out = [];
-    for (const [id, stack] of this.actions) {
-      if (stack.length > 0 && !this.muted.has(id)) out.push(this.tuned(stack.at(-1)));
-    }
-    return out;
-  }
-  /** The deps `a` is invoked with from here: the active scope's, which is
-   *  what `trigger` and `begin` run it with. */
-  depsOf(a) {
-    return depsFor(a, this.start().deps());
-  }
-  /** The menu host of this node's tree, made by its root on first ask. Rows
-   *  resolve and run against the active scope, as chrome's `trigger` does. */
-  menuHost() {
-    const root = [...this.chain()].at(-1);
-    return root.host ??= createMenuHost({
-      actions: () => root.registry.list(),
-      depsFor: (a) => root.depsOf(a),
-      trigger: (id, params) => root.registry.trigger(id, params),
-      activeTool: () => root.start().deps()?.get("activeTool")?.active ?? null
-    });
-  }
-  dispatcher() {
-    for (const n of this.chain()) {
-      const d = n.dispatchers.at(-1);
-      if (d) return d;
-    }
-    return null;
-  }
-  activate() {
-    keyHolder = this;
-    super.activate();
-    for (const f of this.onActivate) f();
-  }
-  registry = {
-    register: (action) => {
-      validateActionId(action.id);
-      validateActionDefaultBinding(action);
-      const stack = this.actions.get(action.id);
-      if (stack) stack.push(action);
-      else this.actions.set(action.id, [action]);
-      this.changed();
-      let released = false;
-      return () => {
-        if (released) return;
-        released = true;
-        const cur = this.actions.get(action.id);
-        if (!cur) return;
-        const i = cur.lastIndexOf(action);
-        if (i === -1) return;
-        cur.splice(i, 1);
-        if (cur.length === 0) {
-          queueMicrotask(() => {
-            if (cur.length === 0 && this.actions.get(action.id) === cur) this.actions.delete(action.id);
-          });
-        }
-        this.changed();
-      };
-    },
-    unregister: (id) => {
-      if (this.actions.delete(id)) this.changed();
-    },
-    mute: (id) => {
-      this.muted.set(id, (this.muted.get(id) ?? 0) + 1);
-      this.changed();
-      let released = false;
-      return () => {
-        if (released) return;
-        released = true;
-        const held = this.muted.get(id);
-        if (held === void 0) return;
-        if (held > 1) this.muted.set(id, held - 1);
-        else this.muted.delete(id);
-        this.changed();
-      };
-    },
-    tune: (id, tuning) => {
-      let stack = this.tunings.get(id);
-      if (!stack) this.tunings.set(id, stack = []);
-      const release = pushOwner(stack, tuning);
-      this.changed();
-      let released = false;
-      return () => {
-        if (released) return;
-        released = true;
-        release();
-        if (stack.length === 0) this.tunings.delete(id);
-        this.changed();
-      };
-    },
-    paramsOf: (id, given) => tunedParams(this.tuningsOf(id), given),
-    overrideBindings: (overrides) => {
-      const release = pushOwner(this.overrides, overrides);
-      this.changed();
-      let released = false;
-      return () => {
-        if (released) return;
-        released = true;
-        release();
-        this.changed();
-      };
-    },
-    bindingOverrides: () => this.start().overridesHere(),
-    list: () => this.snapshot(),
-    trigger: (id, params) => {
-      const leaf = this.start();
-      const a = leaf.resolve(id);
-      if (!a?.invoker || a.invoker.timing !== "immediate") return false;
-      const deps = leaf.depsOf(a);
-      if (!evaluateEnabled(a, deps, pointOf(params)).enabled) return false;
-      try {
-        a.invoker.run(deps, params);
-      } catch (err) {
-        console.error(`weasel ActionsRegistry: action "${id}" threw`, err);
-      }
-      return true;
-    },
-    preview: (id, params) => {
-      const leaf = this.start();
-      const a = leaf.resolve(id);
-      if (!a?.preview) return NO_PREVIEW;
-      const deps = leaf.depsOf(a);
-      if (!evaluateEnabled(a, deps, pointOf(params)).enabled) return NO_PREVIEW;
-      let stop;
-      try {
-        stop = a.preview(deps, params);
-      } catch (err) {
-        console.error(`weasel ActionsRegistry: preview of "${id}" threw`, err);
-        return NO_PREVIEW;
-      }
-      if (typeof stop !== "function") return NO_PREVIEW;
-      let down = false;
-      return () => {
-        if (down) return;
-        down = true;
-        try {
-          stop();
-        } catch (err) {
-          console.error(`weasel ActionsRegistry: preview of "${id}" threw as it ended`, err);
-        }
-      };
-    },
-    subscribe: (listener) => this.tree.listeners.subscribe(listener),
-    setDispatcher: (d) => pushOwner(this.dispatchers, d),
-    begin: (id, params) => {
-      const leaf = this.start();
-      const a = leaf.resolve(id);
-      const disp = leaf.dispatcher();
-      if (!a || !disp) return null;
-      return disp.beginUiOngoing(id, leaf.depsOf(a), params);
-    },
-    activate: () => this.activate(),
-    isActive: () => this.isActive(),
-    holdsKeys: () => keyHolder === this,
-    dropKeys: () => {
-      if (keyHolder === this) keyHolder = null;
-    }
-  };
-};
-var NO_PREVIEW = () => {
-};
-function pointOf(params) {
-  const { worldX: x, worldY: y } = params ?? {};
-  return typeof x === "number" && typeof y === "number" ? { x, y } : void 0;
-}
-var keyHolder = null;
-var NODES = /* @__PURE__ */ new WeakMap();
-function actionsNodeOf(registry) {
-  return registry ? NODES.get(registry) ?? null : null;
-}
-function ActionsProvider({ children }) {
-  const depReg = useOptionalDepRegistry();
-  const depRegRef = useLatest(depReg);
-  const node = useMemo(() => new ActionsNode(null, true, () => depRegRef.current), [depRegRef]);
-  return /* @__PURE__ */ jsx(ActionsContext.Provider, { value: node.registry, children: /* @__PURE__ */ jsx(MenuHostContext.Provider, { value: node.menuHost(), children }) });
-}
-var IS_DEV = isDev();
-function useActionsRegistry() {
-  return useContext(ActionsContext);
-}
-function useAction(action) {
-  const reg = useActionsRegistry();
-  useEffect(() => {
-    if (!reg) {
-      if (IS_DEV) {
-        console.warn(
-          `useAction("${action.id}"): no <ActionsProvider> is in scope, so the action was not registered and its bindings will never fire.`
-        );
-      }
-      return;
-    }
-    return reg.register(action);
-  }, [reg, action]);
-}
 function useToolLifecycle(opts) {
   const { active, hotkeyStack } = opts;
   const liveRef = useRef(/* @__PURE__ */ new Set());
@@ -455,12 +141,16 @@ function createDispatchCore(src) {
     const keymaps = src.context().keymaps;
     return keymaps ? keymaps.batch(fn) : fn();
   };
-  const ctxNow = () => ({
-    ...src.context(),
-    depRegistry: routedDeps,
-    getRuleCtx: routedRuleCtx,
-    viewId: target().id
-  });
+  const ctxNow = () => {
+    const toLocal = src.clientToLocal();
+    return {
+      ...src.context(),
+      depRegistry: routedDeps,
+      getRuleCtx: routedRuleCtx,
+      viewId: target().id,
+      ...toLocal ? { toLocal } : {}
+    };
+  };
   return {
     canvas,
     target,
@@ -743,16 +433,57 @@ function hoverCursorInput(core, paintedCursor, pointersHeld, cursorSink = () =>
   };
 }
 
+// src/interactions/dispatcher/channels/dropPreview.ts
+function keyOf(event, winner) {
+  const mods = [event.altKey, event.ctrlKey, event.metaKey, event.shiftKey].map(Number).join("");
+  const mimes = event.items.map((it) => it.mime).join(",");
+  return `${winner.actionId}|${event.x},${event.y}|${mods}|${mimes}`;
+}
+function dropPreview() {
+  let key = null;
+  let stop = null;
+  const end = () => {
+    key = null;
+    const s = stop;
+    stop = null;
+    if (!s) return;
+    try {
+      s();
+    } catch (err) {
+      console.error("weasel dispatcher: a drop preview threw as it ended", err);
+    }
+  };
+  const show = (event, winner, ctx) => {
+    const next = keyOf(event, winner);
+    if (next === key) return;
+    end();
+    key = next;
+    const { action } = winner;
+    if (!action.preview) return;
+    try {
+      const out = action.preview(buildDepsFromRequires(action, ctx.depRegistry), immediateParams(event, winner.params));
+      stop = typeof out === "function" ? out : null;
+    } catch (err) {
+      console.error(`weasel dispatcher: preview of "${action.id}" threw`, err);
+    }
+  };
+  return { show, end };
+}
+
 // src/interactions/dispatcher/channels/ingest.ts
 var DROPOVER_CLASS = "weasel-dropover";
 function ingestInput(core) {
   const { canvas, routeAt, toWorld, dispatch } = core;
+  const preview = dropPreview();
   const onDragOver = (e) => {
     const dt = e.dataTransfer;
-    if (!dt) return;
+    if (!dt) {
+      preview.end();
+      return;
+    }
     routeAt(null, e.clientX, e.clientY);
     const w = toWorld(e.clientX, e.clientY);
-    const wanted = core.dispatcherNow().resolveOnly({
+    const event = {
       kind: "drop",
       items: itemTypesFromDataTransfer(dt),
       x: w.x,
@@ -763,17 +494,25 @@ function ingestInput(core) {
       ctrlKey: e.ctrlKey,
       metaKey: e.metaKey,
       shiftKey: e.shiftKey
-    }, core.ctxNow()) !== null;
-    canvas?.classList.toggle(DROPOVER_CLASS, wanted);
-    if (!wanted) return;
+    };
+    const ctx = core.ctxNow();
+    const winner = core.dispatcherNow().resolveOnly(event, ctx);
+    canvas?.classList.toggle(DROPOVER_CLASS, winner !== null);
+    if (!winner) {
+      preview.end();
+      return;
+    }
+    preview.show(event, winner, ctx);
     e.preventDefault();
     dt.dropEffect = "copy";
   };
   const onDragLeave = () => {
     canvas?.classList.remove(DROPOVER_CLASS);
+    preview.end();
   };
   const onDrop = (e) => {
     canvas?.classList.remove(DROPOVER_CLASS);
+    preview.end();
     const dt = e.dataTransfer;
     if (!dt) return;
     e.preventDefault();
@@ -824,7 +563,7 @@ function ingestInput(core) {
     });
     if (result === "handled") e.preventDefault();
   };
-  return { onDragOver, onDragLeave, onDrop, onPaste };
+  return { onDragOver, onDragLeave, onDrop, onPaste, endPreview: preview.end };
 }
 
 // src/interactions/dispatcher/channels/keymapKeys.ts
@@ -984,7 +723,7 @@ function holdPublisher(core, longPress) {
       pointerType: pending.pointerType,
       client: { x: press.clientX, y: press.clientY },
       local: core.toCanvasLocal(press.clientX, press.clientY),
-      world: { x: press.worldX, y: press.worldY },
+      world: { ...press.world },
       viewId: core.target().id,
       startedAt: pending.startedAt,
       duration: pending.duration,
@@ -1203,6 +942,8 @@ function wheelInput(core, pinchLive) {
       deltaY: e.deltaY * toPx,
       clientX: local.x,
       clientY: local.y,
+      x: hitPoint.x,
+      y: hitPoint.y,
       ...underPointer(target(), e, hitPoint)
     };
     const result = dispatch(ev);
@@ -1305,6 +1046,7 @@ function attachInput(canvas, src, channels) {
     listeners.removeAll();
     offCarry?.();
     canvas?.classList.remove(DROPOVER_CLASS);
+    ingest.endPreview();
     src.actions().dropKeys();
     hover.clear();
     disposed = true;
@@ -1581,7 +1323,7 @@ function useOpenKeymap() {
 }
 function samePos(a, b) {
   if (a === null || b === null) return a === b;
-  return a.worldX === b.worldX && a.worldY === b.worldY && a.viewId === b.viewId;
+  return a.world.x === b.world.x && a.world.y === b.world.y && a.viewId === b.viewId;
 }
 function createPointerStore() {
   let current = null;
@@ -1867,6 +1609,6 @@ function useTools(opts) {
   );
 }
 
-export { ActionsProvider, ActiveToolContextProvider, ActiveToolContextProviderIfRoot, DepRegistryProvider, InputScope, PointerContextProvider, SelectionContextProvider, SelectionContextProviderIfRoot, Yoke, createPointerStore, useAction, useActionsRegistry, useActiveToolContext, useCommand, useContributions, useDepRegistry, useDepSource, useGestureDispatcher, useMenuHost, useMenus, useOffhandAction, useOngoingAction, useOpenKeymap, useOptionalActiveToolContext, useOptionalDepRegistry, usePointerContext, usePointerPosition, usePublishSelection, useSelectionContext, useTools, useYoke };
+export { ActiveToolContextProvider, ActiveToolContextProviderIfRoot, InputScope, PointerContextProvider, SelectionContextProvider, SelectionContextProviderIfRoot, Yoke, createPointerStore, useActiveToolContext, useCommand, useContributions, useGestureDispatcher, useOffhandAction, useOngoingAction, useOpenKeymap, useOptionalActiveToolContext, usePointerContext, usePointerPosition, usePublishSelection, useSelectionContext, useTools, useYoke };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map