@weasel-js/core 1.15.0 → 1.15.2

package/dist/tools/toolOptions.js

@@ -1,7 +1,8 @@
 import { useEffect } from "react";
+import { toolOptionParams } from "@weasel-js/routing";
 import { useDepSource, useOptionalDepRegistry } from "@weasel-js/routing/react";
 
-//#region src/tools/toolOptions.ts
+// src/tools/toolOptions.ts
 /**
 * The canvas side of tool options (`ToolDef.options`): publishing where their
 * values live, and tuning each tool's action from them.
@@ -17,16 +18,29 @@ function heldOptions(toolId, options, values) {
 	for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === "number") out[key] = held[key];
 	return out;
 }
+/** Write each of `toolId`'s options that `params` sets to a new value into `values`. */
+function keepOptions(toolId, options, values, params) {
+	if (!values) return;
+	const now = toolOptionParams(toolId, options, values);
+	for (const key of Object.keys(options.prefs.children)) {
+		const v = params[key];
+		if (typeof v === "number" && Number.isFinite(v) && v !== now[key]) values.set(toolId, key, v);
+	}
+}
 /** Tune each tool's options action with the values the `toolOptionValues` dep
 *  holds, read on every invocation: only those it holds, so an option it does
 *  not leaves the action's own default, or another tuning's value, in place.
-*  Returns a release. */
+*  The options and the action's last-operation panel are one setting: a value
+*  the panel sets is written back to the dep. Returns a release. */
 function tuneToolOptions(registry, deps, tools) {
 	const releases = [];
 	for (const tool of tools) {
 		const options = tool.options;
 		if (!options) continue;
-		releases.push(registry.tune(options.actionId, { params: () => heldOptions(tool.id, options, deps?.get("toolOptionValues")) }));
+		releases.push(registry.tune(options.actionId, {
+			params: () => heldOptions(tool.id, options, deps?.get("toolOptionValues")),
+			keep: (params) => keepOptions(tool.id, options, deps?.get("toolOptionValues"), params)
+		}));
 	}
 	return () => {
 		for (const r of releases) r();
@@ -42,6 +56,5 @@ function useToolOptionTunings(registry, tools) {
 	]);
 }
 
-//#endregion
 export { tuneToolOptions, useToolOptionTunings, useToolOptionValues };
 //# sourceMappingURL=toolOptions.js.map

package/dist/tools/toolOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolOptions.js","names":[],"sources":["../../src/tools/toolOptions.ts"],"sourcesContent":["/**\n * The canvas side of tool options (`ToolDef.options`): publishing where their\n * values live, and tuning each tool's action from them.\n */\nimport { useEffect } from 'react';\nimport type { ToolOptions, ToolOptionValues } from '@weasel-js/routing';\nimport { useDepSource, useOptionalDepRegistry, type DepRegistry } from '@weasel-js/routing/react';\nimport type { ActionsRegistry } from '@weasel-js/routing';\nimport type { Tool } from './overlayBinding';\n\n/** Publish where the host keeps its tools' option values, as the `toolOptionValues`\n *  dep. Silently does nothing outside a `<DepRegistryProvider>`. */\nexport function useToolOptionValues(values: ToolOptionValues): void {\n  useDepSource('toolOptionValues', () => values);\n}\n\nfunction heldOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined): Record<string, number> {\n  const held = values?.get(toolId) ?? {};\n  const out: Record<string, number> = {};\n  for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === 'number') out[key] = held[key];\n  return out;\n}\n\n/** Tune each tool's options action with the values the `toolOptionValues` dep\n *  holds, read on every invocation: only those it holds, so an option it does\n *  not leaves the action's own default, or another tuning's value, in place.\n *  Returns a release. */\nexport function tuneToolOptions(\n  registry: Pick<ActionsRegistry, 'tune'>,\n  deps: Pick<DepRegistry, 'get'> | null,\n  tools: Iterable<Tool>,\n): () => void {\n  const releases: Array<() => void> = [];\n  for (const tool of tools) {\n    const options = tool.options;\n    if (!options) continue;\n    releases.push(registry.tune(options.actionId, {\n      params: () => heldOptions(tool.id, options, deps?.get('toolOptionValues')),\n    }));\n  }\n  return () => { for (const r of releases) r(); };\n}\n\n/** {@link tuneToolOptions} for as long as the component is mounted. */\nexport function useToolOptionTunings(registry: Pick<ActionsRegistry, 'tune'> | null, tools: Readonly<Record<string, Tool>>): void {\n  const deps = useOptionalDepRegistry();\n  useEffect(() => (registry ? tuneToolOptions(registry, deps, Object.values(tools)) : undefined), [registry, deps, tools]);\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,oBAAoB,QAAgC;CAClE,aAAa,0BAA0B,MAAM;AAC/C;AAEA,SAAS,YAAY,QAAgB,SAAsB,QAA8D;CACvH,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,CAAC;CACrC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG,IAAI,OAAO,KAAK,SAAS,UAAU,IAAI,OAAO,KAAK;CAC1G,OAAO;AACT;;;;;AAMA,SAAgB,gBACd,UACA,MACA,OACY;CACZ,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;EACd,SAAS,KAAK,SAAS,KAAK,QAAQ,UAAU,EAC5C,cAAc,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,CAAC,EAC3E,CAAC,CAAC;CACJ;CACA,aAAa;EAAE,KAAK,MAAM,KAAK,UAAU,EAAE;CAAG;AAChD;;AAGA,SAAgB,qBAAqB,UAAgD,OAA6C;CAChI,MAAM,OAAO,uBAAuB;CACpC,gBAAiB,WAAW,gBAAgB,UAAU,MAAM,OAAO,OAAO,KAAK,CAAC,IAAI,QAAY;EAAC;EAAU;EAAM;CAAK,CAAC;AACzH"}
+{"version":3,"file":"toolOptions.js","names":[],"sources":["../../src/tools/toolOptions.ts"],"sourcesContent":["/**\n * The canvas side of tool options (`ToolDef.options`): publishing where their\n * values live, and tuning each tool's action from them.\n */\nimport { useEffect } from 'react';\nimport { toolOptionParams, type ToolOptions, type ToolOptionValues } from '@weasel-js/routing';\nimport { useDepSource, useOptionalDepRegistry, type DepRegistry } from '@weasel-js/routing/react';\nimport type { ActionsRegistry } from '@weasel-js/routing';\nimport type { Tool } from './overlayBinding';\n\n/** Publish where the host keeps its tools' option values, as the `toolOptionValues`\n *  dep. Silently does nothing outside a `<DepRegistryProvider>`. */\nexport function useToolOptionValues(values: ToolOptionValues): void {\n  useDepSource('toolOptionValues', () => values);\n}\n\nfunction heldOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined): Record<string, number> {\n  const held = values?.get(toolId) ?? {};\n  const out: Record<string, number> = {};\n  for (const key of Object.keys(options.prefs.children)) if (typeof held[key] === 'number') out[key] = held[key];\n  return out;\n}\n\n/** Write each of `toolId`'s options that `params` sets to a new value into `values`. */\nfunction keepOptions(toolId: string, options: ToolOptions, values: ToolOptionValues | undefined, params: Readonly<Record<string, unknown>>): void {\n  if (!values) return;\n  const now = toolOptionParams(toolId, options, values);\n  for (const key of Object.keys(options.prefs.children)) {\n    const v = params[key];\n    if (typeof v === 'number' && Number.isFinite(v) && v !== now[key]) values.set(toolId, key, v);\n  }\n}\n\n/** Tune each tool's options action with the values the `toolOptionValues` dep\n *  holds, read on every invocation: only those it holds, so an option it does\n *  not leaves the action's own default, or another tuning's value, in place.\n *  The options and the action's last-operation panel are one setting: a value\n *  the panel sets is written back to the dep. Returns a release. */\nexport function tuneToolOptions(\n  registry: Pick<ActionsRegistry, 'tune'>,\n  deps: Pick<DepRegistry, 'get'> | null,\n  tools: Iterable<Tool>,\n): () => void {\n  const releases: Array<() => void> = [];\n  for (const tool of tools) {\n    const options = tool.options;\n    if (!options) continue;\n    releases.push(registry.tune(options.actionId, {\n      params: () => heldOptions(tool.id, options, deps?.get('toolOptionValues')),\n      keep: (params) => keepOptions(tool.id, options, deps?.get('toolOptionValues'), params),\n    }));\n  }\n  return () => { for (const r of releases) r(); };\n}\n\n/** {@link tuneToolOptions} for as long as the component is mounted. */\nexport function useToolOptionTunings(registry: Pick<ActionsRegistry, 'tune'> | null, tools: Readonly<Record<string, Tool>>): void {\n  const deps = useOptionalDepRegistry();\n  useEffect(() => (registry ? tuneToolOptions(registry, deps, Object.values(tools)) : undefined), [registry, deps, tools]);\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,oBAAoB,QAAgC;CAClE,aAAa,0BAA0B,MAAM;AAC/C;AAEA,SAAS,YAAY,QAAgB,SAAsB,QAA8D;CACvH,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,CAAC;CACrC,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG,IAAI,OAAO,KAAK,SAAS,UAAU,IAAI,OAAO,KAAK;CAC1G,OAAO;AACT;;AAGA,SAAS,YAAY,QAAgB,SAAsB,QAAsC,QAAiD;CAChJ,IAAI,CAAC,QAAQ;CACb,MAAM,MAAM,iBAAiB,QAAQ,SAAS,MAAM;CACpD,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,QAAQ,GAAG;EACrD,MAAM,IAAI,OAAO;EACjB,IAAI,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,KAAK,MAAM,IAAI,MAAM,OAAO,IAAI,QAAQ,KAAK,CAAC;CAC9F;AACF;;;;;;AAOA,SAAgB,gBACd,UACA,MACA,OACY;CACZ,MAAM,WAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;EACd,SAAS,KAAK,SAAS,KAAK,QAAQ,UAAU;GAC5C,cAAc,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,CAAC;GACzE,OAAO,WAAW,YAAY,KAAK,IAAI,SAAS,MAAM,IAAI,kBAAkB,GAAG,MAAM;EACvF,CAAC,CAAC;CACJ;CACA,aAAa;EAAE,KAAK,MAAM,KAAK,UAAU,EAAE;CAAG;AAChD;;AAGA,SAAgB,qBAAqB,UAAgD,OAA6C;CAChI,MAAM,OAAO,uBAAuB;CACpC,gBAAiB,WAAW,gBAAgB,UAAU,MAAM,OAAO,OAAO,KAAK,CAAC,IAAI,QAAY;EAAC;EAAU;EAAM;CAAK,CAAC;AACzH"}

package/dist/tools/useKeybindings.js

@@ -5,7 +5,7 @@ import { useLatest } from "@weasel-js/react";
 import { useActionsRegistry } from "@weasel-js/routing/react";
 import { eligibleForMode } from "@weasel-js/modes";
 
-//#region src/tools/useKeybindings.ts
+// src/tools/useKeybindings.ts
 /** Wire the single-key tool-activation shortcuts (V, P, T, …) and Escape to
 *  return to the default tool. Activation is gated on what the active mode
 *  allows, so a key cannot reach a tool the palette greys out. */
@@ -67,6 +67,5 @@ function useKeybindings(tools, options = {}) {
 	]);
 }
 
-//#endregion
 export { useKeybindings };
 //# sourceMappingURL=useKeybindings.js.map

package/dist/{types-DW14eu9B.d.ts → types-BUvUXZe5.d.ts}

@@ -861,9 +861,9 @@ interface NodeBase<TData, TLayer extends string, TPose> {
      *  undo entry as the change. A drag reads it too: it is the layout `move`
      *  reflows and drops against. */
     layout?: LayoutStrategy<TPose>;
-    /** The units its children are shown, typed and snapped in (their poses stay
-     *  in world units), and what one base unit is worth in the enclosing scope's.
-     *  It covers the children, not the node; `sceneUnitScopes` reads the chain. */
+    /** The units its children are shown, typed and snapped in (poses stay in the root's base units), their
+     *  worth in the enclosing scope's, and the magnification they are drawn at (`drawnAt`). It covers the
+     *  children, not the node; `sceneUnitScopes` reads the chain. */
     units?: UnitScope;
 }
 /** A node that is drawn and picked as one thing — a shape, a label, an image.

package/dist/util/color.js

@@ -1,6 +1,6 @@
 import { tryNormalizeHex } from "@weasel-js/paint";
 
-//#region src/util/color.ts
+// src/util/color.ts
 /** Color hex8 helpers. All stored colors are `#rrggbbaa`. `<input type="color">`
 *  only round-trips the 6-char form, so call-sites pad the saved alpha back on
 *  when the user picks via the native widget. */
@@ -40,6 +40,5 @@ function mergeAlphaFromPrev(picked, prev) {
 	return withAlpha01(picked, getAlpha01(prev));
 }
 
-//#endregion
 export { getAlpha01, mergeAlphaFromPrev, toHex8, withAlpha01 };
 //# sourceMappingURL=color.js.map

package/dist/util/paint.js

@@ -1,7 +1,7 @@
 import { getAlpha01 } from "./color.js";
 import { colorLiteralToHex, hexToColorLiteral, resolvePaletteColor } from "@weasel-js/paint";
 
-//#region src/util/paint.ts
+// src/util/paint.ts
 /** Kit-shipped default paint constants.
 *
 *  Single source of truth for the colors the built-in tools and the default
@@ -120,6 +120,5 @@ function paintWithColor(paint, color) {
 	};
 }
 
-//#endregion
 export { DEFAULT_FILL_COLOR, DEFAULT_PALETTE, DEFAULT_STROKE_COLOR, GHOST_STROKE, cycleFill, paintAlpha, paintWithAlpha, paintWithColor, solid, strokeOf, strokeWith };
 //# sourceMappingURL=paint.js.map

package/dist/version.js

@@ -1,4 +1,4 @@
-//#region src/version.ts
+// src/version.ts
 /**
 * Semver of `@weasel-js/core` as of the build.
 *
@@ -7,8 +7,7 @@
 * throwing, since nothing about version reporting should be able to break a
 * consumer's build.
 */
-var VERSION = "1.15.0";
+var VERSION = "1.15.2";
 
-//#endregion
 export { VERSION };
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/core",
-  "version": "1.15.0",
+  "version": "1.15.2",
   "description": "A 2D scene-graph engine for React, rendered on WebGL2: the scene tree, viewport math, pointer and keyboard input, layered rendering, and op-based undo.",
   "weasel": {
     "needs": ["webgl2"]
@@ -110,32 +110,32 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "peerDependencies": {
-    "@weasel-js/font": "1.15.0",
+    "@weasel-js/font": "1.15.2",
     "react": ">=18"
   },
   "dependencies": {
-    "@msb235/blits": "0.12.0",
-    "@weasel-js/animator": "1.15.0",
-    "@weasel-js/cursor": "1.15.0",
-    "@weasel-js/geom": "1.15.0",
-    "@weasel-js/gestures": "1.15.0",
-    "@weasel-js/headless": "1.15.0",
-    "@weasel-js/history": "1.15.0",
-    "@weasel-js/icons": "1.15.0",
-    "@weasel-js/modes": "1.15.0",
-    "@weasel-js/paint": "1.15.0",
-    "@weasel-js/prefs": "1.15.0",
-    "@weasel-js/quantity": "1.15.0",
-    "@weasel-js/react": "1.15.0",
-    "@weasel-js/registry": "1.15.0",
-    "@weasel-js/renderer": "1.15.0",
-    "@weasel-js/routing": "1.15.0",
-    "@weasel-js/select": "1.15.0",
-    "@weasel-js/simulation": "1.15.0",
-    "@weasel-js/stroke": "1.15.0",
-    "@weasel-js/text": "1.15.0",
-    "@weasel-js/text-dom": "1.15.0",
-    "earcut": "3.2.3",
+    "@msb235/blits": "0.16.1",
+    "@weasel-js/animator": "1.15.2",
+    "@weasel-js/cursor": "1.15.2",
+    "@weasel-js/geom": "1.15.2",
+    "@weasel-js/gestures": "1.15.2",
+    "@weasel-js/ui-logic": "1.15.2",
+    "@weasel-js/history": "1.15.2",
+    "@weasel-js/icons": "1.15.2",
+    "@weasel-js/modes": "1.15.2",
+    "@weasel-js/paint": "1.15.2",
+    "@weasel-js/prefs": "1.15.2",
+    "@weasel-js/quantity": "1.15.2",
+    "@weasel-js/react": "1.15.2",
+    "@weasel-js/registry": "1.15.2",
+    "@weasel-js/renderer": "1.15.2",
+    "@weasel-js/routing": "1.15.2",
+    "@weasel-js/select": "1.15.2",
+    "@weasel-js/simulation": "1.15.2",
+    "@weasel-js/stroke": "1.15.2",
+    "@weasel-js/text": "1.15.2",
+    "@weasel-js/text-dom": "1.15.2",
+    "earcut": "3.2.4",
     "polygon-clipping": "^0.15.7"
   },
   "publishConfig": {
@@ -152,8 +152,8 @@
     "2d"
   ],
   "devDependencies": {
-    "@weasel-js/icons-plugin": "1.15.0",
-    "@weasel-js/modes": "1.15.0",
-    "@weasel-js/theme": "1.15.0"
+    "@weasel-js/icons-plugin": "1.15.2",
+    "@weasel-js/modes": "1.15.2",
+    "@weasel-js/theme": "1.15.2"
   }
 }