@lofcz/embedpdf-plugin-commands 2.15.0 → 3.0.0-next.7

package/dist/index.js

@@ -1,381 +1,191 @@
-import { BasePlugin, createEmitter, createBehaviorEmitter, arePropsEqual } from "@embedpdf/core";
-const COMMANDS_PLUGIN_ID = "commands";
-const manifest = {
-  id: COMMANDS_PLUGIN_ID,
-  name: "Commands Plugin",
-  version: "1.0.0",
-  provides: ["commands"],
-  requires: [],
-  optional: ["i18n", "ui"],
-  defaultConfig: {
-    commands: {}
-  }
+import { createCapabilityToken, definePlugin } from "@embedpdf/core";
+import { I18nToken } from "@embedpdf/plugin-i18n";
+import { ShellToken } from "@embedpdf/plugin-shell";
+import { matchShortcut, parseShortcut } from "@embedpdf/core-ui";
+//#region src/capability.ts
+function registerCommand(registry, def) {
+	if (registry.has(def.id)) throw new Error(`[commands] duplicate command: ${def.id}`);
+	const shortcuts = def.shortcut === void 0 ? [] : [].concat(def.shortcut);
+	registry.set(def.id, {
+		def,
+		shortcuts,
+		parsed: shortcuts.map(parseShortcut)
+	});
+}
+const panelTarget = (def) => def.panel === void 0 ? null : typeof def.panel === "string" ? { id: def.panel } : def.panel;
+function createCommandsCapability(ctx, registry) {
+	/** Bind capability resolution to the command's target document. The kernel
+	*  resolves workspace tokens regardless of the document argument, so one
+	*  code path serves both scopes. */
+	const commandCtx = (documentId) => {
+		const target = documentId ?? ctx.core().activeId;
+		const get = (token) => target ? ctx.forDocument(token, target) : ctx.get(token);
+		return {
+			documentId: target,
+			core: ctx.core,
+			get,
+			tryGet: (token) => {
+				try {
+					return get(token);
+				} catch {
+					return null;
+				}
+			}
+		};
+	};
+	/** Derivations run against live state; a derivation that throws (e.g. it
+	*  needs a document and none is open) falls back to the safe default —
+	*  the button renders, disabled, exactly like v2's empty state. */
+	const derive = (fn, c, fallback) => {
+		if (!fn) return fallback;
+		try {
+			return fn(c);
+		} catch {
+			return fallback;
+		}
+	};
+	/** Same guard as `derive`, for the icon-accent derivation: a throw (no
+	*  document, provider missing) means "no accent" — the icon renders plain. */
+	const deriveAccent = (fn, c) => {
+		if (!fn) return void 0;
+		try {
+			return fn(c) ?? void 0;
+		} catch {
+			return;
+		}
+	};
+	const resolve = (id, documentId) => {
+		const entry = registry.get(id);
+		if (!entry) return null;
+		const { def } = entry;
+		const c = commandCtx(documentId);
+		const disabled = ctx.getState().disabledCategories;
+		const categoryHidden = (def.categories ?? []).some((cat) => disabled.includes(cat));
+		const i18n = c.tryGet(I18nToken);
+		const label = i18n ? i18n.t(def.labelKey) : def.labelKey;
+		let active;
+		if (def.active) active = derive(def.active, c, false);
+		else {
+			const shell = c.tryGet(ShellToken);
+			const panel = panelTarget(def);
+			active = shell ? def.menu ? shell.isMenuOpen(def.menu) : panel ? shell.isOpen(panel.id) : def.modal ? shell.isOpen(def.modal) : false : false;
+		}
+		return {
+			id: def.id,
+			label,
+			icon: def.icon,
+			iconAccent: deriveAccent(def.iconAccent, c),
+			shortcuts: entry.shortcuts,
+			menu: def.menu,
+			enabled: derive(def.enabled, c, true) && !categoryHidden,
+			active,
+			visible: derive(def.visible, c, true) && !categoryHidden,
+			categories: def.categories ?? []
+		};
+	};
+	const execute = (id, documentId) => {
+		const entry = registry.get(id);
+		if (!entry) return;
+		const resolved = resolve(id, documentId);
+		if (!resolved || !resolved.enabled || !resolved.visible) return;
+		const c = commandCtx(documentId);
+		if (entry.def.run) {
+			entry.def.run(c);
+			return;
+		}
+		const shell = c.tryGet(ShellToken);
+		if (!shell) return;
+		const panel = panelTarget(entry.def);
+		if (entry.def.menu) shell.toggleMenu(entry.def.menu);
+		else if (panel) shell.toggle(panel.id, { exclusive: panel.exclusive });
+		else if (entry.def.modal) shell.toggle(entry.def.modal, { exclusive: "modal" });
+	};
+	return {
+		register: (def) => registerCommand(registry, def),
+		unregister: (id) => void registry.delete(id),
+		has: (id) => registry.has(id),
+		ids: () => [...registry.keys()],
+		resolve,
+		search: (query, documentId) => {
+			const q = query.trim().toLowerCase();
+			const hits = [];
+			for (const id of registry.keys()) {
+				const r = resolve(id, documentId);
+				if (!r || !r.visible) continue;
+				if (q === "" || r.label.toLowerCase().includes(q) || r.id.includes(q)) hits.push(r);
+			}
+			return hits;
+		},
+		menuTarget: (id) => {
+			const entry = registry.get(id);
+			return entry ? { menu: entry.def.menu } : null;
+		},
+		execute,
+		matchStroke: (stroke, opts) => {
+			for (const [id, entry] of registry) if (entry.parsed.some((p) => matchShortcut(p, stroke, opts))) return id;
+			return null;
+		},
+		disabledCategories: () => ctx.getState().disabledCategories,
+		isCategoryDisabled: (category) => ctx.getState().disabledCategories.includes(category),
+		disableCategory: (category) => ctx.dispatch({
+			type: "COMMANDS/DISABLE_CATEGORY",
+			category
+		}),
+		enableCategory: (category) => ctx.dispatch({
+			type: "COMMANDS/ENABLE_CATEGORY",
+			category
+		}),
+		setDisabledCategories: (categories) => ctx.dispatch({
+			type: "COMMANDS/SET_DISABLED_CATEGORIES",
+			categories
+		})
+	};
+}
+//#endregion
+//#region src/reducer.ts
+const initialCommandsState = { disabledCategories: [] };
+function commandsReducer(state, action) {
+	switch (action.type) {
+		case "COMMANDS/DISABLE_CATEGORY": return state.disabledCategories.includes(action.category) ? state : { disabledCategories: [...state.disabledCategories, action.category] };
+		case "COMMANDS/ENABLE_CATEGORY": return state.disabledCategories.includes(action.category) ? { disabledCategories: state.disabledCategories.filter((c) => c !== action.category) } : state;
+		case "COMMANDS/SET_DISABLED_CATEGORIES": return { disabledCategories: [...action.categories] };
+		default: return state;
+	}
+}
+//#endregion
+//#region src/types.ts
+/** Value equality over resolved commands — `resolve()` mints a fresh object
+*  per read, so reactive bindings memo by value to re-render on real change. */
+const resolvedCommandsEqual = (a, b) => {
+	if (a === b) return true;
+	if (!a || !b) return false;
+	return a.id === b.id && a.label === b.label && a.icon === b.icon && a.iconAccent?.primary === b.iconAccent?.primary && a.iconAccent?.secondary === b.iconAccent?.secondary && a.menu === b.menu && a.enabled === b.enabled && a.active === b.active && a.visible === b.visible && a.shortcuts.length === b.shortcuts.length && a.shortcuts.every((s, i) => s === b.shortcuts[i]);
 };
-const SET_DISABLED_CATEGORIES = "COMMANDS/SET_DISABLED_CATEGORIES";
-const setDisabledCategories = (categories) => ({
-  type: SET_DISABLED_CATEGORIES,
-  payload: categories
-});
-const _CommandsPlugin = class _CommandsPlugin extends BasePlugin {
-  constructor(id, registry, config) {
-    var _a;
-    super(id, registry);
-    this.commands = /* @__PURE__ */ new Map();
-    this.i18n = null;
-    this.shortcutMap = /* @__PURE__ */ new Map();
-    this.commandExecuted$ = createEmitter();
-    this.commandStateChanged$ = createEmitter();
-    this.shortcutExecuted$ = createEmitter();
-    this.categoryChanged$ = createBehaviorEmitter();
-    this.previousStates = /* @__PURE__ */ new Map();
-    const i18nPlugin = registry.getPlugin("i18n");
-    this.i18n = (i18nPlugin == null ? void 0 : i18nPlugin.provides()) ?? null;
-    if ((_a = config.disabledCategories) == null ? void 0 : _a.length) {
-      this.dispatch(setDisabledCategories(config.disabledCategories));
-    }
-    Object.values(config.commands).forEach((command) => {
-      this.registerCommand(command);
-    });
-    this.registry.getStore().subscribe((_action, newState) => {
-      this.onGlobalStoreChange(newState);
-    });
-  }
-  onDocumentClosed(documentId) {
-    this.previousStates.delete(documentId);
-    this.logger.debug(
-      "CommandsPlugin",
-      "DocumentClosed",
-      `Cleaned up command state cache for document: ${documentId}`
-    );
-  }
-  async initialize() {
-    this.logger.info("CommandsPlugin", "Initialize", "Commands plugin initialized");
-  }
-  async destroy() {
-    this.commandExecuted$.clear();
-    this.commandStateChanged$.clear();
-    this.shortcutExecuted$.clear();
-    this.categoryChanged$.clear();
-    this.commands.clear();
-    this.shortcutMap.clear();
-    this.previousStates.clear();
-    super.destroy();
-  }
-  // ─────────────────────────────────────────────────────────
-  // Category Management
-  // ─────────────────────────────────────────────────────────
-  disableCategoryImpl(category) {
-    const current = new Set(this.state.disabledCategories);
-    if (!current.has(category)) {
-      current.add(category);
-      this.dispatch(setDisabledCategories(Array.from(current)));
-      this.categoryChanged$.emit({ disabledCategories: Array.from(current) });
-    }
-  }
-  enableCategoryImpl(category) {
-    const current = new Set(this.state.disabledCategories);
-    if (current.has(category)) {
-      current.delete(category);
-      this.dispatch(setDisabledCategories(Array.from(current)));
-      this.categoryChanged$.emit({ disabledCategories: Array.from(current) });
-    }
-  }
-  toggleCategoryImpl(category) {
-    if (this.state.disabledCategories.includes(category)) {
-      this.enableCategoryImpl(category);
-    } else {
-      this.disableCategoryImpl(category);
-    }
-  }
-  setDisabledCategoriesImpl(categories) {
-    this.dispatch(setDisabledCategories(categories));
-    this.categoryChanged$.emit({ disabledCategories: categories });
-  }
-  /**
-   * Check if command has any disabled category
-   */
-  isCommandCategoryDisabled(command) {
-    var _a;
-    if (!((_a = command.categories) == null ? void 0 : _a.length)) return false;
-    return command.categories.some((cat) => this.state.disabledCategories.includes(cat));
-  }
-  // ─────────────────────────────────────────────────────────
-  // Capability
-  // ─────────────────────────────────────────────────────────
-  buildCapability() {
-    return {
-      resolve: (commandId, documentId) => this.resolve(commandId, documentId),
-      execute: (commandId, documentId, source = "ui") => this.execute(commandId, documentId, source),
-      getAllCommands: (documentId) => this.getAllCommands(documentId),
-      getCommandsByCategory: (category, documentId) => this.getCommandsByCategory(category, documentId),
-      getCommandByShortcut: (shortcut) => this.getCommandByShortcut(shortcut),
-      getAllShortcuts: () => new Map(this.shortcutMap),
-      forDocument: (documentId) => this.createCommandScope(documentId),
-      registerCommand: (command) => this.registerCommand(command),
-      unregisterCommand: (commandId) => this.unregisterCommand(commandId),
-      // Category management
-      disableCategory: (category) => this.disableCategoryImpl(category),
-      enableCategory: (category) => this.enableCategoryImpl(category),
-      toggleCategory: (category) => this.toggleCategoryImpl(category),
-      setDisabledCategories: (categories) => this.setDisabledCategoriesImpl(categories),
-      getDisabledCategories: () => this.state.disabledCategories,
-      isCategoryDisabled: (category) => this.state.disabledCategories.includes(category),
-      // Events
-      onCommandExecuted: this.commandExecuted$.on,
-      onCommandStateChanged: this.commandStateChanged$.on,
-      onShortcutExecuted: this.shortcutExecuted$.on,
-      onCategoryChanged: this.categoryChanged$.on
-    };
-  }
-  // ─────────────────────────────────────────────────────────
-  // Document Scoping
-  // ─────────────────────────────────────────────────────────
-  createCommandScope(documentId) {
-    return {
-      resolve: (commandId) => this.resolve(commandId, documentId),
-      execute: (commandId, source = "ui") => this.execute(commandId, documentId, source),
-      getAllCommands: () => this.getAllCommands(documentId),
-      getCommandsByCategory: (category) => this.getCommandsByCategory(category, documentId),
-      onCommandStateChanged: (listener) => this.commandStateChanged$.on((event) => {
-        if (event.documentId === documentId) {
-          const { documentId: _, ...rest } = event;
-          listener(rest);
-        }
-      })
-    };
-  }
-  // ─────────────────────────────────────────────────────────
-  // Command Resolution
-  // ─────────────────────────────────────────────────────────
-  resolve(commandId, documentId) {
-    const resolvedDocId = documentId ?? this.getActiveDocumentId();
-    const command = this.commands.get(commandId);
-    if (!command) {
-      throw new Error(`Command not found: ${commandId}`);
-    }
-    const state = this.registry.getStore().getState();
-    const label = this.resolveLabel(command, state, resolvedDocId);
-    const shortcuts = command.shortcuts ? Array.isArray(command.shortcuts) ? command.shortcuts : [command.shortcuts] : void 0;
-    const explicitDisabled = this.resolveDynamic(command.disabled, state, resolvedDocId) ?? false;
-    const categoryDisabled = this.isCommandCategoryDisabled(command);
-    const isDisabled = explicitDisabled || categoryDisabled;
-    return {
-      id: command.id,
-      label,
-      icon: this.resolveDynamic(command.icon, state, resolvedDocId),
-      iconProps: this.resolveDynamic(command.iconProps, state, resolvedDocId),
-      active: this.resolveDynamic(command.active, state, resolvedDocId) ?? false,
-      disabled: isDisabled,
-      visible: this.resolveDynamic(command.visible, state, resolvedDocId) ?? true,
-      shortcuts,
-      shortcutLabel: command.shortcutLabel,
-      categories: command.categories,
-      description: command.description,
-      execute: () => command.action({
-        registry: this.registry,
-        state,
-        documentId: resolvedDocId,
-        logger: this.logger
-      })
-    };
-  }
-  resolveLabel(command, state, documentId) {
-    const labelKey = this.resolveDynamic(command.labelKey, state, documentId);
-    if (labelKey && this.i18n) {
-      const params = this.resolveDynamic(command.labelParams, state, documentId);
-      return this.i18n.t(labelKey, { params, documentId });
-    }
-    if (command.label) {
-      return command.label;
-    }
-    return command.id;
-  }
-  resolveDynamic(value, state, documentId) {
-    if (value === void 0) return void 0;
-    if (typeof value === "function") {
-      return value({
-        registry: this.registry,
-        state,
-        documentId,
-        logger: this.logger
-      });
-    }
-    return value;
-  }
-  // ─────────────────────────────────────────────────────────
-  // Command Execution
-  // ─────────────────────────────────────────────────────────
-  execute(commandId, documentId, source = "ui") {
-    const resolvedDocId = documentId ?? this.getActiveDocumentId();
-    const resolved = this.resolve(commandId, resolvedDocId);
-    if (resolved.disabled) {
-      this.logger.warn(
-        "CommandsPlugin",
-        "ExecutionBlocked",
-        `Command '${commandId}' is disabled for document '${resolvedDocId}'`
-      );
-      return;
-    }
-    if (!resolved.visible) {
-      this.logger.warn(
-        "CommandsPlugin",
-        "ExecutionBlocked",
-        `Command '${commandId}' is not visible for document '${resolvedDocId}'`
-      );
-      return;
-    }
-    resolved.execute();
-    this.commandExecuted$.emit({
-      commandId,
-      documentId: resolvedDocId,
-      source
-    });
-    this.logger.debug(
-      "CommandsPlugin",
-      "CommandExecuted",
-      `Command '${commandId}' executed for document '${resolvedDocId}' (source: ${source})`
-    );
-  }
-  // ─────────────────────────────────────────────────────────
-  // Command Registration
-  // ─────────────────────────────────────────────────────────
-  registerCommand(command) {
-    if (this.commands.has(command.id)) {
-      this.logger.warn(
-        "CommandsPlugin",
-        "CommandOverwrite",
-        `Command '${command.id}' already exists and will be overwritten`
-      );
-    }
-    this.commands.set(command.id, command);
-    if (command.shortcuts) {
-      const shortcuts = Array.isArray(command.shortcuts) ? command.shortcuts : [command.shortcuts];
-      shortcuts.forEach((shortcut) => {
-        const normalized = this.normalizeShortcut(shortcut);
-        this.shortcutMap.set(normalized, command.id);
-      });
-    }
-    this.logger.debug("CommandsPlugin", "CommandRegistered", `Command '${command.id}' registered`);
-  }
-  unregisterCommand(commandId) {
-    const command = this.commands.get(commandId);
-    if (!command) return;
-    if (command.shortcuts) {
-      const shortcuts = Array.isArray(command.shortcuts) ? command.shortcuts : [command.shortcuts];
-      shortcuts.forEach((shortcut) => {
-        const normalized = this.normalizeShortcut(shortcut);
-        this.shortcutMap.delete(normalized);
-      });
-    }
-    this.commands.delete(commandId);
-    this.logger.debug(
-      "CommandsPlugin",
-      "CommandUnregistered",
-      `Command '${commandId}' unregistered`
-    );
-  }
-  // ─────────────────────────────────────────────────────────
-  // Shortcuts
-  // ─────────────────────────────────────────────────────────
-  getCommandByShortcut(shortcut) {
-    const normalized = this.normalizeShortcut(shortcut);
-    const commandId = this.shortcutMap.get(normalized);
-    return commandId ? this.commands.get(commandId) ?? null : null;
-  }
-  normalizeShortcut(shortcut) {
-    return shortcut.toLowerCase().split("+").sort().join("+");
-  }
-  // ─────────────────────────────────────────────────────────
-  // Query Methods
-  // ─────────────────────────────────────────────────────────
-  getAllCommands(documentId) {
-    const resolvedDocId = documentId ?? this.getActiveDocumentId();
-    return Array.from(this.commands.keys()).map((id) => this.resolve(id, resolvedDocId));
-  }
-  getCommandsByCategory(category, documentId) {
-    const resolvedDocId = documentId ?? this.getActiveDocumentId();
-    return Array.from(this.commands.values()).filter((cmd) => {
-      var _a;
-      return (_a = cmd.categories) == null ? void 0 : _a.includes(category);
-    }).map((cmd) => this.resolve(cmd.id, resolvedDocId));
-  }
-  // ─────────────────────────────────────────────────────────
-  // State Change Detection
-  // ─────────────────────────────────────────────────────────
-  onGlobalStoreChange(newState) {
-    const documentIds = Object.keys(newState.core.documents);
-    documentIds.forEach((documentId) => {
-      this.detectCommandChanges(documentId, newState);
-    });
-  }
-  detectCommandChanges(documentId, newState) {
-    const coreDoc = newState.core.documents[documentId];
-    if (!coreDoc || coreDoc.status !== "loaded") return;
-    const previousCache = this.previousStates.get(documentId) ?? /* @__PURE__ */ new Map();
-    this.commands.forEach((command, commandId) => {
-      const newResolved = this.resolve(commandId, documentId);
-      const prevResolved = previousCache.get(commandId);
-      if (!prevResolved) {
-        previousCache.set(commandId, newResolved);
-        return;
-      }
-      const changes = {};
-      if (prevResolved.active !== newResolved.active) {
-        changes.active = newResolved.active;
-      }
-      if (prevResolved.disabled !== newResolved.disabled) {
-        changes.disabled = newResolved.disabled;
-      }
-      if (prevResolved.visible !== newResolved.visible) {
-        changes.visible = newResolved.visible;
-      }
-      if (prevResolved.label !== newResolved.label) {
-        changes.label = newResolved.label;
-      }
-      if (prevResolved.icon !== newResolved.icon) {
-        changes.icon = newResolved.icon;
-      }
-      if (!arePropsEqual(prevResolved.iconProps, newResolved.iconProps)) {
-        changes.iconProps = newResolved.iconProps;
-      }
-      if (Object.keys(changes).length > 0) {
-        previousCache.set(commandId, newResolved);
-        this.commandStateChanged$.emit({
-          commandId,
-          documentId,
-          changes
-        });
-      }
-    });
-    this.previousStates.set(documentId, previousCache);
-  }
+const CommandsToken = createCapabilityToken("commands");
+//#endregion
+//#region src/commands.plugin.ts
+/**
+* The commands plugin: workspace-scoped (one vocabulary for the whole
+* workspace; resolution/execution bind to a target document per call).
+* Definitions live in this closure — never in the store (they hold
+* functions); the store slice holds only `disabledCategories`.
+*/
+const commandsPlugin = (config) => {
+	const registry = /* @__PURE__ */ new Map();
+	for (const def of config?.commands ?? []) registerCommand(registry, def);
+	return definePlugin({
+		id: "commands",
+		scope: "workspace",
+		token: CommandsToken,
+		initialState: {
+			...initialCommandsState,
+			disabledCategories: [...config?.disabledCategories ?? []]
+		},
+		reduce: commandsReducer,
+		capability: (ctx) => createCommandsCapability(ctx, registry)
+	});
 };
-_CommandsPlugin.id = "commands";
-let CommandsPlugin = _CommandsPlugin;
-const initialState = {
-  disabledCategories: []
-};
-const commandsReducer = (state = initialState, action) => {
-  switch (action.type) {
-    case SET_DISABLED_CATEGORIES:
-      return {
-        ...state,
-        disabledCategories: action.payload
-      };
-    default:
-      return state;
-  }
-};
-const CommandsPluginPackage = {
-  manifest,
-  create: (registry, config) => new CommandsPlugin(COMMANDS_PLUGIN_ID, registry, config),
-  reducer: commandsReducer,
-  initialState
-};
-export {
-  COMMANDS_PLUGIN_ID,
-  CommandsPlugin,
-  CommandsPluginPackage,
-  manifest
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { CommandsToken, commandsPlugin, commandsReducer, initialCommandsState, resolvedCommandsEqual };
+
+//# sourceMappingURL=index.js.map