@weasel-js/modes 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 orochi235
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @weasel-js/modes
+
+App-level modality primitives: capability tags, mode definitions, mode registry, and decoration layer.
+
+Part of [weasel](https://github.com/orochi235/weasel), a domain-agnostic 2D
+scene-graph canvas kit for React. See the
+[API reference](https://orochi235.github.io/weasel/api/).
+
+## Install
+
+```sh
+npm install @weasel-js/modes
+```
+
+## Usage
+
+```ts
+import { /* … */ } from '@weasel-js/modes';
+import { /* … */ } from '@weasel-js/modes/presets/default';
+```
+
+## License
+
+MIT

package/dist/chunk-KILROWYB.js

@@ -0,0 +1,88 @@
+// src/presets/default.ts
+var NORMAL = {
+  id: "normal",
+  kind: "soft",
+  allows: [
+    "creates-selection",
+    "transforms-selection",
+    "creates-paths",
+    "creates-shapes",
+    "creates-text",
+    "samples-color",
+    "applies-fill",
+    "edits-page"
+  ],
+  scoping: false
+};
+var PATH_EDIT = {
+  id: "path-edit",
+  kind: "soft",
+  allows: ["edits-anchors"],
+  scoping: true,
+  workspace: { tint: "#3b82f6", gradient: "bottom-up", intensity: 0.12 },
+  entry: { trigger: "double-click-target", shortcut: "Enter" },
+  exit: { shortcut: "Escape" }
+};
+var ISOLATION = {
+  id: "isolation",
+  kind: "soft",
+  allows: [
+    "creates-selection",
+    "transforms-selection",
+    "creates-paths",
+    "creates-shapes",
+    "creates-text",
+    "samples-color",
+    "applies-fill"
+  ],
+  scoping: true,
+  workspace: { tint: "#8b5cf6", gradient: "bottom-up", intensity: 0.12 },
+  entry: { trigger: "double-click-target" },
+  exit: { shortcut: "Escape" }
+};
+var FREE_TRANSFORM = {
+  id: "free-transform",
+  kind: "strict",
+  allows: ["transforms-selection"],
+  scoping: false,
+  workspace: { tint: "#f59e0b", gradient: "bottom-up", intensity: 0.12 },
+  entry: { shortcut: "Meta+T" },
+  commit: { shortcut: "Enter" },
+  cancel: { shortcut: "Escape" }
+};
+var TEXT_EDIT = {
+  id: "text-edit",
+  kind: "soft",
+  allows: ["edits-text"],
+  scoping: false,
+  workspace: { tint: "#10b981", gradient: "bottom-up", intensity: 0.12 },
+  entry: { trigger: "double-click-target" },
+  exit: { shortcut: "Escape" }
+};
+var CROP = {
+  id: "crop",
+  kind: "strict",
+  allows: ["edits-page"],
+  scoping: false,
+  workspace: { tint: "#ef4444", gradient: "bottom-up", intensity: 0.12 },
+  entry: { shortcut: "C" },
+  commit: { shortcut: "Enter" },
+  cancel: { shortcut: "Escape" }
+};
+var DEFAULT_MODES = [
+  NORMAL,
+  PATH_EDIT,
+  ISOLATION,
+  FREE_TRANSFORM,
+  TEXT_EDIT,
+  CROP
+];
+function byId(id) {
+  const m = DEFAULT_MODES.find((m2) => m2.id === id);
+  if (!m) throw new Error(`Unknown mode id: ${id}`);
+  return m;
+}
+
+export { CROP, DEFAULT_MODES, FREE_TRANSFORM, ISOLATION, NORMAL, PATH_EDIT, TEXT_EDIT, byId };
+//# sourceMappingURL=chunk-KILROWYB.js.map
+//# sourceMappingURL=chunk-KILROWYB.js.map

package/dist/chunk-KILROWYB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presets/default.ts"],"names":["m"],"mappings":"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","file":"chunk-KILROWYB.js","sourcesContent":["import type { ModeDefinition } from '../modeDefinition';\n\nexport const NORMAL: ModeDefinition = {\n  id: 'normal',\n  kind: 'soft',\n  allows: [\n    'creates-selection',\n    'transforms-selection',\n    'creates-paths',\n    'creates-shapes',\n    'creates-text',\n    'samples-color',\n    'applies-fill',\n    'edits-page',\n  ],\n  scoping: false,\n};\n\nexport const PATH_EDIT: ModeDefinition = {\n  id: 'path-edit',\n  kind: 'soft',\n  allows: ['edits-anchors'],\n  scoping: true,\n  workspace: { tint: '#3b82f6', gradient: 'bottom-up', intensity: 0.12 },\n  entry: { trigger: 'double-click-target', shortcut: 'Enter' },\n  exit: { shortcut: 'Escape' },\n};\n\nexport const ISOLATION: ModeDefinition = {\n  id: 'isolation',\n  kind: 'soft',\n  allows: [\n    'creates-selection',\n    'transforms-selection',\n    'creates-paths',\n    'creates-shapes',\n    'creates-text',\n    'samples-color',\n    'applies-fill',\n  ],\n  scoping: true,\n  workspace: { tint: '#8b5cf6', gradient: 'bottom-up', intensity: 0.12 },\n  entry: { trigger: 'double-click-target' },\n  exit: { shortcut: 'Escape' },\n};\n\nexport const FREE_TRANSFORM: ModeDefinition = {\n  id: 'free-transform',\n  kind: 'strict',\n  allows: ['transforms-selection'],\n  scoping: false,\n  workspace: { tint: '#f59e0b', gradient: 'bottom-up', intensity: 0.12 },\n  entry: { shortcut: 'Meta+T' },\n  commit: { shortcut: 'Enter' },\n  cancel: { shortcut: 'Escape' },\n};\n\nexport const TEXT_EDIT: ModeDefinition = {\n  id: 'text-edit',\n  kind: 'soft',\n  allows: ['edits-text'],\n  scoping: false,\n  workspace: { tint: '#10b981', gradient: 'bottom-up', intensity: 0.12 },\n  entry: { trigger: 'double-click-target' },\n  exit: { shortcut: 'Escape' },\n};\n\nexport const CROP: ModeDefinition = {\n  id: 'crop',\n  kind: 'strict',\n  allows: ['edits-page'],\n  scoping: false,\n  workspace: { tint: '#ef4444', gradient: 'bottom-up', intensity: 0.12 },\n  entry: { shortcut: 'C' },\n  commit: { shortcut: 'Enter' },\n  cancel: { shortcut: 'Escape' },\n};\n\nexport const DEFAULT_MODES: readonly ModeDefinition[] = [\n  NORMAL,\n  PATH_EDIT,\n  ISOLATION,\n  FREE_TRANSFORM,\n  TEXT_EDIT,\n  CROP,\n];\n\nexport function byId(id: string): ModeDefinition {\n  const m = DEFAULT_MODES.find((m) => m.id === id);\n  if (!m) throw new Error(`Unknown mode id: ${id}`);\n  return m;\n}\n"]}

package/dist/default-CdTM_d8s.d.ts

@@ -0,0 +1,50 @@
+/** The full vocabulary of capability tags shipped in the default preset.
+ *  Apps and other consumers can add their own tags; this list is what
+ *  `weasel-modes` itself uses. */
+declare const ALL_TAGS: readonly ["navigation", "creates-selection", "creates-paths", "creates-shapes", "creates-text", "edits-anchors", "edits-text", "transforms-selection", "samples-color", "applies-fill", "edits-page"];
+type CapabilityTag = (typeof ALL_TAGS)[number] | (string & {});
+/** Tags that are implicitly allowed in every mode — never listed per-mode.
+ *  A tool tagged with any of these is always eligible. */
+declare const IMPLICIT_TAGS: readonly CapabilityTag[];
+declare function isCapabilityTag(value: string): value is CapabilityTag;
+
+interface WorkspaceVisual {
+    tint?: string;
+    gradient?: 'top-down' | 'bottom-up';
+    intensity?: number;
+}
+interface ModeDefinition {
+    id: string;
+    kind: 'soft' | 'strict';
+    /** Capability tags this mode allows beyond IMPLICIT_TAGS. */
+    allows: CapabilityTag[];
+    /** When true, out-of-target objects dim at the renderer layer. */
+    scoping: boolean;
+    workspace?: WorkspaceVisual;
+    entry?: {
+        shortcut?: string;
+        trigger?: 'double-click-target';
+    };
+    exit?: {
+        shortcut?: string;
+    };
+    commit?: {
+        shortcut?: string;
+    };
+    cancel?: {
+        shortcut?: string;
+    };
+}
+/** True iff a tool carrying `toolTags` is eligible for `mode`. */
+declare function eligibleForMode(mode: ModeDefinition, toolTags: readonly CapabilityTag[]): boolean;
+
+declare const NORMAL: ModeDefinition;
+declare const PATH_EDIT: ModeDefinition;
+declare const ISOLATION: ModeDefinition;
+declare const FREE_TRANSFORM: ModeDefinition;
+declare const TEXT_EDIT: ModeDefinition;
+declare const CROP: ModeDefinition;
+declare const DEFAULT_MODES: readonly ModeDefinition[];
+declare function byId(id: string): ModeDefinition;
+
+export { ALL_TAGS as A, type CapabilityTag as C, DEFAULT_MODES as D, FREE_TRANSFORM as F, IMPLICIT_TAGS as I, type ModeDefinition as M, NORMAL as N, PATH_EDIT as P, TEXT_EDIT as T, type WorkspaceVisual as W, CROP as a, ISOLATION as b, byId as c, eligibleForMode as e, isCapabilityTag as i };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { M as ModeDefinition, C as CapabilityTag } from './default-CdTM_d8s.js';
+export { A as ALL_TAGS, a as CROP, D as DEFAULT_MODES, F as FREE_TRANSFORM, I as IMPLICIT_TAGS, b as ISOLATION, N as NORMAL, P as PATH_EDIT, T as TEXT_EDIT, W as WorkspaceVisual, c as byId, e as eligibleForMode, i as isCapabilityTag } from './default-CdTM_d8s.js';
+
+interface CreateModeRegistryOptions {
+    modes: readonly ModeDefinition[];
+    initial: string;
+}
+interface ModeRegistry {
+    current(): ModeDefinition;
+    setMode(id: string): void;
+    byId(id: string): ModeDefinition;
+    getVersion(): number;
+    subscribe(listener: () => void): () => void;
+}
+declare function createModeRegistry(opts: CreateModeRegistryOptions): ModeRegistry;
+
+/** Loose draw-command type — the kit's `DrawCommand` union shape is over in
+ *  `src/renderer`. We keep this opaque to avoid a cross-package import in
+ *  the type surface; consumers cast to the real DrawCommand at use site. */
+type ModeDrawCommand = unknown;
+type ModeDecorationPainter = () => ModeDrawCommand[];
+interface CreateModeDecorationsOptions {
+    registry: ModeRegistry;
+}
+interface ModeDecorations {
+    /** Register (or replace) the painter for a mode id. */
+    register(modeId: string, painter: ModeDecorationPainter): void;
+    /** Paint the active mode's decorations. Returns an empty array if no
+     *  painter is registered for the active mode. */
+    paint(): ModeDrawCommand[];
+    /** Monotonic version. Bumps on mode change or painter registration. */
+    getVersion(): number;
+}
+declare function createModeDecorations(opts: CreateModeDecorationsOptions): ModeDecorations;
+
+interface ToolLike {
+    id: string;
+    capabilities?: readonly CapabilityTag[];
+}
+/** True iff `tool` is usable in the registry's currently active mode. */
+declare function eligibleTool(reg: ModeRegistry, tool: ToolLike): boolean;
+/** Same predicate against an explicit mode + tag list. Useful for palette
+ *  preview ("if I were in mode X, would this tool be available?"). */
+declare function eligibleToolByCapabilities(mode: ModeDefinition, capabilities: readonly CapabilityTag[]): boolean;
+
+interface CreateScopingDimOptions {
+    registry: ModeRegistry;
+    /** Returns the set of node ids that are *in* scope for the current mode.
+     *  The app computes this — typically: selection-only for path-edit,
+     *  isolated subtree for isolation, empty for non-scoping modes. */
+    getTargetIds: () => ReadonlySet<string>;
+    /** Alpha for out-of-scope nodes. Default 0.3 (spec). */
+    dimAlpha?: number;
+}
+interface ScopingDim {
+    /** Multiplier in [0, 1] to apply to a node's render alpha. */
+    alphaFor(id: string): number;
+    /** Whether the node should respond to pointer hits. */
+    isPointerInteractive(id: string): boolean;
+}
+declare function createScopingDim(opts: CreateScopingDimOptions): ScopingDim;
+
+export { CapabilityTag, type CreateModeDecorationsOptions, type CreateModeRegistryOptions, type CreateScopingDimOptions, type ModeDecorationPainter, type ModeDecorations, ModeDefinition, type ModeDrawCommand, type ModeRegistry, type ScopingDim, type ToolLike, createModeDecorations, createModeRegistry, createScopingDim, eligibleTool, eligibleToolByCapabilities };

package/dist/index.js

@@ -0,0 +1,117 @@
+export { CROP, DEFAULT_MODES, FREE_TRANSFORM, ISOLATION, NORMAL, PATH_EDIT, TEXT_EDIT, byId } from './chunk-KILROWYB.js';
+
+// src/capabilities.ts
+var ALL_TAGS = [
+  "navigation",
+  "creates-selection",
+  "creates-paths",
+  "creates-shapes",
+  "creates-text",
+  "edits-anchors",
+  "edits-text",
+  "transforms-selection",
+  "samples-color",
+  "applies-fill",
+  "edits-page"
+];
+var IMPLICIT_TAGS = ["navigation"];
+function isCapabilityTag(value) {
+  return ALL_TAGS.includes(value);
+}
+
+// src/modeDefinition.ts
+function eligibleForMode(mode, toolTags) {
+  if (toolTags.length === 0) return false;
+  const allowed = /* @__PURE__ */ new Set([...mode.allows, ...IMPLICIT_TAGS]);
+  for (const t of toolTags) {
+    if (allowed.has(t)) return true;
+  }
+  return false;
+}
+
+// src/registry.ts
+function createModeRegistry(opts) {
+  const byIdMap = new Map(opts.modes.map((m) => [m.id, m]));
+  const initial = byIdMap.get(opts.initial);
+  if (!initial) throw new Error(`Initial mode "${opts.initial}" not in modes list`);
+  let active = initial;
+  let version = 0;
+  const listeners = /* @__PURE__ */ new Set();
+  function bump() {
+    version++;
+    for (const l of listeners) l();
+  }
+  return {
+    current: () => active,
+    setMode(id) {
+      const next = byIdMap.get(id);
+      if (!next) throw new Error(`Unknown mode id: ${id}`);
+      if (next === active) return;
+      active = next;
+      bump();
+    },
+    byId(id) {
+      const m = byIdMap.get(id);
+      if (!m) throw new Error(`Unknown mode id: ${id}`);
+      return m;
+    },
+    getVersion: () => version,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+
+// src/decorations.ts
+function createModeDecorations(opts) {
+  const { registry } = opts;
+  const painters = /* @__PURE__ */ new Map();
+  let ver = 0;
+  registry.subscribe(() => {
+    ver++;
+  });
+  return {
+    register(modeId, painter) {
+      painters.set(modeId, painter);
+      ver++;
+    },
+    paint() {
+      const painter = painters.get(registry.current().id);
+      if (!painter) return [];
+      return painter();
+    },
+    getVersion: () => ver
+  };
+}
+
+// src/eligibility.ts
+function eligibleTool(reg, tool) {
+  return eligibleForMode(reg.current(), tool.capabilities ?? []);
+}
+function eligibleToolByCapabilities(mode, capabilities) {
+  return eligibleForMode(mode, capabilities);
+}
+
+// src/scopingLayer.ts
+function createScopingDim(opts) {
+  const dim = opts.dimAlpha ?? 0.3;
+  return {
+    alphaFor(id) {
+      const mode = opts.registry.current();
+      if (!mode.scoping) return 1;
+      return opts.getTargetIds().has(id) ? 1 : dim;
+    },
+    isPointerInteractive(id) {
+      const mode = opts.registry.current();
+      if (!mode.scoping) return true;
+      return opts.getTargetIds().has(id);
+    }
+  };
+}
+
+export { ALL_TAGS, IMPLICIT_TAGS, createModeDecorations, createModeRegistry, createScopingDim, eligibleForMode, eligibleTool, eligibleToolByCapabilities, isCapabilityTag };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capabilities.ts","../src/modeDefinition.ts","../src/registry.ts","../src/decorations.ts","../src/eligibility.ts","../src/scopingLayer.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** The full vocabulary of capability tags shipped in the default preset.\n *  Apps and other consumers can add their own tags; this list is what\n *  `weasel-modes` itself uses. */\nexport const ALL_TAGS = [\n  'navigation',\n  'creates-selection',\n  'creates-paths',\n  'creates-shapes',\n  'creates-text',\n  'edits-anchors',\n  'edits-text',\n  'transforms-selection',\n  'samples-color',\n  'applies-fill',\n  'edits-page',\n] as const;\n\nexport type CapabilityTag = (typeof ALL_TAGS)[number] | (string & {});\n\n/** Tags that are implicitly allowed in every mode — never listed per-mode.\n *  A tool tagged with any of these is always eligible. */\nexport const IMPLICIT_TAGS: readonly CapabilityTag[] = ['navigation'];\n\nexport function isCapabilityTag(value: string): value is CapabilityTag {\n  return (ALL_TAGS as readonly string[]).includes(value);\n}\n","import { IMPLICIT_TAGS, type CapabilityTag } from './capabilities';\n\nexport interface WorkspaceVisual {\n  tint?: string;\n  gradient?: 'top-down' | 'bottom-up';\n  intensity?: number;\n}\n\nexport interface ModeDefinition {\n  id: string;\n  kind: 'soft' | 'strict';\n  /** Capability tags this mode allows beyond IMPLICIT_TAGS. */\n  allows: CapabilityTag[];\n  /** When true, out-of-target objects dim at the renderer layer. */\n  scoping: boolean;\n  workspace?: WorkspaceVisual;\n  entry?: { shortcut?: string; trigger?: 'double-click-target' };\n  exit?: { shortcut?: string };\n  commit?: { shortcut?: string };\n  cancel?: { shortcut?: string };\n}\n\n/** True iff a tool carrying `toolTags` is eligible for `mode`. */\nexport function eligibleForMode(mode: ModeDefinition, toolTags: readonly CapabilityTag[]): boolean {\n  if (toolTags.length === 0) return false;\n  const allowed = new Set<CapabilityTag>([...mode.allows, ...IMPLICIT_TAGS]);\n  for (const t of toolTags) {\n    if (allowed.has(t)) return true;\n  }\n  return false;\n}\n","import type { ModeDefinition } from './modeDefinition';\n\nexport interface CreateModeRegistryOptions {\n  modes: readonly ModeDefinition[];\n  initial: string;\n}\n\nexport interface ModeRegistry {\n  current(): ModeDefinition;\n  setMode(id: string): void;\n  byId(id: string): ModeDefinition;\n  getVersion(): number;\n  subscribe(listener: () => void): () => void;\n}\n\nexport function createModeRegistry(opts: CreateModeRegistryOptions): ModeRegistry {\n  const byIdMap = new Map(opts.modes.map((m) => [m.id, m]));\n  const initial = byIdMap.get(opts.initial);\n  if (!initial) throw new Error(`Initial mode \"${opts.initial}\" not in modes list`);\n\n  let active: ModeDefinition = initial;\n  let version = 0;\n  const listeners = new Set<() => void>();\n\n  function bump(): void {\n    version++;\n    for (const l of listeners) l();\n  }\n\n  return {\n    current: () => active,\n    setMode(id: string): void {\n      const next = byIdMap.get(id);\n      if (!next) throw new Error(`Unknown mode id: ${id}`);\n      if (next === active) return;\n      active = next;\n      bump();\n    },\n    byId(id: string): ModeDefinition {\n      const m = byIdMap.get(id);\n      if (!m) throw new Error(`Unknown mode id: ${id}`);\n      return m;\n    },\n    getVersion: () => version,\n    subscribe(listener: () => void): () => void {\n      listeners.add(listener);\n      return () => { listeners.delete(listener); };\n    },\n  };\n}\n","import type { ModeRegistry } from './registry';\n\n/** Loose draw-command type — the kit's `DrawCommand` union shape is over in\n *  `src/renderer`. We keep this opaque to avoid a cross-package import in\n *  the type surface; consumers cast to the real DrawCommand at use site. */\nexport type ModeDrawCommand = unknown;\n\nexport type ModeDecorationPainter = () => ModeDrawCommand[];\n\nexport interface CreateModeDecorationsOptions {\n  registry: ModeRegistry;\n}\n\nexport interface ModeDecorations {\n  /** Register (or replace) the painter for a mode id. */\n  register(modeId: string, painter: ModeDecorationPainter): void;\n  /** Paint the active mode's decorations. Returns an empty array if no\n   *  painter is registered for the active mode. */\n  paint(): ModeDrawCommand[];\n  /** Monotonic version. Bumps on mode change or painter registration. */\n  getVersion(): number;\n}\n\nexport function createModeDecorations(opts: CreateModeDecorationsOptions): ModeDecorations {\n  const { registry } = opts;\n  const painters = new Map<string, ModeDecorationPainter>();\n  let ver = 0;\n\n  registry.subscribe(() => {\n    ver++;\n  });\n\n  return {\n    register(modeId: string, painter: ModeDecorationPainter): void {\n      painters.set(modeId, painter);\n      ver++;\n    },\n    paint(): ModeDrawCommand[] {\n      const painter = painters.get(registry.current().id);\n      if (!painter) return [];\n      return painter();\n    },\n    getVersion: () => ver,\n  };\n}\n","import type { ModeRegistry } from './registry';\nimport type { ModeDefinition } from './modeDefinition';\nimport type { CapabilityTag } from './capabilities';\nimport { eligibleForMode } from './modeDefinition';\n\nexport interface ToolLike {\n  id: string;\n  capabilities?: readonly CapabilityTag[];\n}\n\n/** True iff `tool` is usable in the registry's currently active mode. */\nexport function eligibleTool(reg: ModeRegistry, tool: ToolLike): boolean {\n  return eligibleForMode(reg.current(), tool.capabilities ?? []);\n}\n\n/** Same predicate against an explicit mode + tag list. Useful for palette\n *  preview (\"if I were in mode X, would this tool be available?\"). */\nexport function eligibleToolByCapabilities(\n  mode: ModeDefinition,\n  capabilities: readonly CapabilityTag[],\n): boolean {\n  return eligibleForMode(mode, capabilities);\n}\n","import type { ModeRegistry } from './registry';\n\nexport interface CreateScopingDimOptions {\n  registry: ModeRegistry;\n  /** Returns the set of node ids that are *in* scope for the current mode.\n   *  The app computes this — typically: selection-only for path-edit,\n   *  isolated subtree for isolation, empty for non-scoping modes. */\n  getTargetIds: () => ReadonlySet<string>;\n  /** Alpha for out-of-scope nodes. Default 0.3 (spec). */\n  dimAlpha?: number;\n}\n\nexport interface ScopingDim {\n  /** Multiplier in [0, 1] to apply to a node's render alpha. */\n  alphaFor(id: string): number;\n  /** Whether the node should respond to pointer hits. */\n  isPointerInteractive(id: string): boolean;\n}\n\nexport function createScopingDim(opts: CreateScopingDimOptions): ScopingDim {\n  const dim = opts.dimAlpha ?? 0.3;\n  return {\n    alphaFor(id) {\n      const mode = opts.registry.current();\n      if (!mode.scoping) return 1;\n      return opts.getTargetIds().has(id) ? 1 : dim;\n    },\n    isPointerInteractive(id) {\n      const mode = opts.registry.current();\n      if (!mode.scoping) return true;\n      return opts.getTargetIds().has(id);\n    },\n  };\n}\n"]}

package/dist/presets/default.d.ts

@@ -0,0 +1 @@
+export { a as CROP, D as DEFAULT_MODES, F as FREE_TRANSFORM, b as ISOLATION, N as NORMAL, P as PATH_EDIT, T as TEXT_EDIT, c as byId } from '../default-CdTM_d8s.js';

package/dist/presets/default.js

@@ -0,0 +1,3 @@
+export { CROP, DEFAULT_MODES, FREE_TRANSFORM, ISOLATION, NORMAL, PATH_EDIT, TEXT_EDIT, byId } from '../chunk-KILROWYB.js';
+//# sourceMappingURL=default.js.map
+//# sourceMappingURL=default.js.map

package/dist/presets/default.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"default.js"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@weasel-js/modes",
+  "version": "0.5.0",
+  "description": "App-level modality primitives: capability tags, mode definitions, mode registry, and decoration layer.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./presets/default": {
+      "import": "./dist/presets/default.js",
+      "types": "./dist/presets/default.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "author": "orochi235",
+  "homepage": "https://orochi235.github.io/weasel/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orochi235/weasel.git",
+    "directory": "packages/modes"
+  },
+  "bugs": {
+    "url": "https://github.com/orochi235/weasel/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}