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

package/LICENSE

@@ -1,21 +1,192 @@
-MIT License
-
-Copyright (c) 2025 CloudPDF
-
-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.
+Copyright 2026 CloudPDF LTD
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use files in this distribution except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-----------------------------------------------------------------------
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/dist/index.cjs

@@ -1,2 +1,196 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core"),t="commands",s={id:t,name:"Commands Plugin",version:"1.0.0",provides:["commands"],requires:[],optional:["i18n","ui"],defaultConfig:{commands:{}}},o="COMMANDS/SET_DISABLED_CATEGORIES",i=e=>({type:o,payload:e}),a=class extends e.BasePlugin{constructor(t,s,o){var a;super(t,s),this.commands=new Map,this.i18n=null,this.shortcutMap=new Map,this.commandExecuted$=e.createEmitter(),this.commandStateChanged$=e.createEmitter(),this.shortcutExecuted$=e.createEmitter(),this.categoryChanged$=e.createBehaviorEmitter(),this.previousStates=new Map;const r=s.getPlugin("i18n");this.i18n=(null==r?void 0:r.provides())??null,(null==(a=o.disabledCategories)?void 0:a.length)&&this.dispatch(i(o.disabledCategories)),Object.values(o.commands).forEach(e=>{this.registerCommand(e)}),this.registry.getStore().subscribe((e,t)=>{this.onGlobalStoreChange(t)})}onDocumentClosed(e){this.previousStates.delete(e),this.logger.debug("CommandsPlugin","DocumentClosed",`Cleaned up command state cache for document: ${e}`)}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()}disableCategoryImpl(e){const t=new Set(this.state.disabledCategories);t.has(e)||(t.add(e),this.dispatch(i(Array.from(t))),this.categoryChanged$.emit({disabledCategories:Array.from(t)}))}enableCategoryImpl(e){const t=new Set(this.state.disabledCategories);t.has(e)&&(t.delete(e),this.dispatch(i(Array.from(t))),this.categoryChanged$.emit({disabledCategories:Array.from(t)}))}toggleCategoryImpl(e){this.state.disabledCategories.includes(e)?this.enableCategoryImpl(e):this.disableCategoryImpl(e)}setDisabledCategoriesImpl(e){this.dispatch(i(e)),this.categoryChanged$.emit({disabledCategories:e})}isCommandCategoryDisabled(e){var t;return!!(null==(t=e.categories)?void 0:t.length)&&e.categories.some(e=>this.state.disabledCategories.includes(e))}buildCapability(){return{resolve:(e,t)=>this.resolve(e,t),execute:(e,t,s="ui")=>this.execute(e,t,s),getAllCommands:e=>this.getAllCommands(e),getCommandsByCategory:(e,t)=>this.getCommandsByCategory(e,t),getCommandByShortcut:e=>this.getCommandByShortcut(e),getAllShortcuts:()=>new Map(this.shortcutMap),forDocument:e=>this.createCommandScope(e),registerCommand:e=>this.registerCommand(e),unregisterCommand:e=>this.unregisterCommand(e),disableCategory:e=>this.disableCategoryImpl(e),enableCategory:e=>this.enableCategoryImpl(e),toggleCategory:e=>this.toggleCategoryImpl(e),setDisabledCategories:e=>this.setDisabledCategoriesImpl(e),getDisabledCategories:()=>this.state.disabledCategories,isCategoryDisabled:e=>this.state.disabledCategories.includes(e),onCommandExecuted:this.commandExecuted$.on,onCommandStateChanged:this.commandStateChanged$.on,onShortcutExecuted:this.shortcutExecuted$.on,onCategoryChanged:this.categoryChanged$.on}}createCommandScope(e){return{resolve:t=>this.resolve(t,e),execute:(t,s="ui")=>this.execute(t,e,s),getAllCommands:()=>this.getAllCommands(e),getCommandsByCategory:t=>this.getCommandsByCategory(t,e),onCommandStateChanged:t=>this.commandStateChanged$.on(s=>{if(s.documentId===e){const{documentId:e,...o}=s;t(o)}})}}resolve(e,t){const s=t??this.getActiveDocumentId(),o=this.commands.get(e);if(!o)throw new Error(`Command not found: ${e}`);const i=this.registry.getStore().getState(),a=this.resolveLabel(o,i,s),r=o.shortcuts?Array.isArray(o.shortcuts)?o.shortcuts:[o.shortcuts]:void 0,n=this.resolveDynamic(o.disabled,i,s)??!1,d=this.isCommandCategoryDisabled(o),m=n||d;return{id:o.id,label:a,icon:this.resolveDynamic(o.icon,i,s),iconProps:this.resolveDynamic(o.iconProps,i,s),active:this.resolveDynamic(o.active,i,s)??!1,disabled:m,visible:this.resolveDynamic(o.visible,i,s)??!0,shortcuts:r,shortcutLabel:o.shortcutLabel,categories:o.categories,description:o.description,execute:()=>o.action({registry:this.registry,state:i,documentId:s,logger:this.logger})}}resolveLabel(e,t,s){const o=this.resolveDynamic(e.labelKey,t,s);if(o&&this.i18n){const i=this.resolveDynamic(e.labelParams,t,s);return this.i18n.t(o,{params:i,documentId:s})}return e.label?e.label:e.id}resolveDynamic(e,t,s){if(void 0!==e)return"function"==typeof e?e({registry:this.registry,state:t,documentId:s,logger:this.logger}):e}execute(e,t,s="ui"){const o=t??this.getActiveDocumentId(),i=this.resolve(e,o);i.disabled?this.logger.warn("CommandsPlugin","ExecutionBlocked",`Command '${e}' is disabled for document '${o}'`):i.visible?(i.execute(),this.commandExecuted$.emit({commandId:e,documentId:o,source:s}),this.logger.debug("CommandsPlugin","CommandExecuted",`Command '${e}' executed for document '${o}' (source: ${s})`)):this.logger.warn("CommandsPlugin","ExecutionBlocked",`Command '${e}' is not visible for document '${o}'`)}registerCommand(e){if(this.commands.has(e.id)&&this.logger.warn("CommandsPlugin","CommandOverwrite",`Command '${e.id}' already exists and will be overwritten`),this.commands.set(e.id,e),e.shortcuts){(Array.isArray(e.shortcuts)?e.shortcuts:[e.shortcuts]).forEach(t=>{const s=this.normalizeShortcut(t);this.shortcutMap.set(s,e.id)})}this.logger.debug("CommandsPlugin","CommandRegistered",`Command '${e.id}' registered`)}unregisterCommand(e){const t=this.commands.get(e);if(t){if(t.shortcuts){(Array.isArray(t.shortcuts)?t.shortcuts:[t.shortcuts]).forEach(e=>{const t=this.normalizeShortcut(e);this.shortcutMap.delete(t)})}this.commands.delete(e),this.logger.debug("CommandsPlugin","CommandUnregistered",`Command '${e}' unregistered`)}}getCommandByShortcut(e){const t=this.normalizeShortcut(e),s=this.shortcutMap.get(t);return s?this.commands.get(s)??null:null}normalizeShortcut(e){return e.toLowerCase().split("+").sort().join("+")}getAllCommands(e){const t=e??this.getActiveDocumentId();return Array.from(this.commands.keys()).map(e=>this.resolve(e,t))}getCommandsByCategory(e,t){const s=t??this.getActiveDocumentId();return Array.from(this.commands.values()).filter(t=>{var s;return null==(s=t.categories)?void 0:s.includes(e)}).map(e=>this.resolve(e.id,s))}onGlobalStoreChange(e){Object.keys(e.core.documents).forEach(t=>{this.detectCommandChanges(t,e)})}detectCommandChanges(t,s){const o=s.core.documents[t];if(!o||"loaded"!==o.status)return;const i=this.previousStates.get(t)??new Map;this.commands.forEach((s,o)=>{const a=this.resolve(o,t),r=i.get(o);if(!r)return void i.set(o,a);const n={};r.active!==a.active&&(n.active=a.active),r.disabled!==a.disabled&&(n.disabled=a.disabled),r.visible!==a.visible&&(n.visible=a.visible),r.label!==a.label&&(n.label=a.label),r.icon!==a.icon&&(n.icon=a.icon),e.arePropsEqual(r.iconProps,a.iconProps)||(n.iconProps=a.iconProps),Object.keys(n).length>0&&(i.set(o,a),this.commandStateChanged$.emit({commandId:o,documentId:t,changes:n}))}),this.previousStates.set(t,i)}};a.id="commands";let r=a;const n={disabledCategories:[]},d={manifest:s,create:(e,s)=>new r(t,e,s),reducer:(e=n,t)=>t.type===o?{...e,disabledCategories:t.payload}:e,initialState:n};exports.COMMANDS_PLUGIN_ID=t,exports.CommandsPlugin=r,exports.CommandsPluginPackage=d,exports.manifest=s;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _embedpdf_core = require("@embedpdf/core");
+let _embedpdf_plugin_i18n = require("@embedpdf/plugin-i18n");
+let _embedpdf_plugin_shell = require("@embedpdf/plugin-shell");
+let _embedpdf_core_ui = require("@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(_embedpdf_core_ui.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(_embedpdf_plugin_i18n.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(_embedpdf_plugin_shell.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(_embedpdf_plugin_shell.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) => (0, _embedpdf_core_ui.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 CommandsToken = (0, _embedpdf_core.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 (0, _embedpdf_core.definePlugin)({
+		id: "commands",
+		scope: "workspace",
+		token: CommandsToken,
+		initialState: {
+			...initialCommandsState,
+			disabledCategories: [...config?.disabledCategories ?? []]
+		},
+		reduce: commandsReducer,
+		capability: (ctx) => createCommandsCapability(ctx, registry)
+	});
+};
+//#endregion
+exports.CommandsToken = CommandsToken;
+exports.commandsPlugin = commandsPlugin;
+exports.commandsReducer = commandsReducer;
+exports.initialCommandsState = initialCommandsState;
+exports.resolvedCommandsEqual = resolvedCommandsEqual;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/lib/manifest.ts","../src/lib/actions.ts","../src/lib/commands-plugin.ts","../src/lib/reducer.ts","../src/lib/index.ts"],"sourcesContent":["import { PluginManifest } from '@embedpdf/core';\nimport { CommandsPluginConfig } from './types';\n\nexport const COMMANDS_PLUGIN_ID = 'commands';\n\nexport const manifest: PluginManifest<CommandsPluginConfig> = {\n  id: COMMANDS_PLUGIN_ID,\n  name: 'Commands Plugin',\n  version: '1.0.0',\n  provides: ['commands'],\n  requires: [],\n  optional: ['i18n', 'ui'],\n  defaultConfig: {\n    commands: {},\n  },\n};\n","import { Action } from '@embedpdf/core';\n\nexport const SET_DISABLED_CATEGORIES = 'COMMANDS/SET_DISABLED_CATEGORIES';\n\nexport interface SetDisabledCategoriesAction extends Action {\n  type: typeof SET_DISABLED_CATEGORIES;\n  payload: string[];\n}\n\nexport type CommandsAction = SetDisabledCategoriesAction;\n\nexport const setDisabledCategories = (categories: string[]): SetDisabledCategoriesAction => ({\n  type: SET_DISABLED_CATEGORIES,\n  payload: categories,\n});\n","import {\n  BasePlugin,\n  PluginRegistry,\n  StoreState,\n  createEmitter,\n  createBehaviorEmitter,\n  Listener,\n  arePropsEqual,\n} from '@embedpdf/core';\nimport { Logger } from '@embedpdf/models';\nimport { I18nCapability, I18nPlugin } from '@embedpdf/plugin-i18n';\nimport {\n  CommandsCapability,\n  CommandsPluginConfig,\n  CommandsState,\n  Command,\n  ResolvedCommand,\n  CommandExecutedEvent,\n  CommandStateChangedEvent,\n  ShortcutExecutedEvent,\n  CategoryChangedEvent,\n  CommandScope,\n  Dynamic,\n} from './types';\nimport { CommandsAction, setDisabledCategories } from './actions';\n\nexport class CommandsPlugin extends BasePlugin<\n  CommandsPluginConfig,\n  CommandsCapability,\n  CommandsState,\n  CommandsAction\n> {\n  static readonly id = 'commands' as const;\n\n  private commands = new Map<string, Command>();\n  private i18n: I18nCapability | null = null;\n  private shortcutMap = new Map<string, string>(); // shortcut -> commandId\n\n  private readonly commandExecuted$ = createEmitter<CommandExecutedEvent>();\n  private readonly commandStateChanged$ = createEmitter<CommandStateChangedEvent>();\n  private readonly shortcutExecuted$ = createEmitter<ShortcutExecutedEvent>();\n  private readonly categoryChanged$ = createBehaviorEmitter<CategoryChangedEvent>();\n\n  // Cache previous resolved states per document to detect changes\n  private previousStates = new Map<string, Map<string, ResolvedCommand>>();\n\n  constructor(id: string, registry: PluginRegistry, config: CommandsPluginConfig) {\n    super(id, registry);\n\n    // Check if i18n plugin is available (optional dependency)\n    const i18nPlugin = registry.getPlugin<I18nPlugin>('i18n');\n    this.i18n = i18nPlugin?.provides() ?? null;\n\n    // Initialize disabled categories from config\n    if (config.disabledCategories?.length) {\n      this.dispatch(setDisabledCategories(config.disabledCategories));\n    }\n\n    // Register all commands from config\n    Object.values(config.commands).forEach((command) => {\n      this.registerCommand(command);\n    });\n\n    // Subscribe to global store changes\n    this.registry.getStore().subscribe((_action, newState) => {\n      this.onGlobalStoreChange(newState);\n    });\n  }\n\n  protected override onDocumentClosed(documentId: string): void {\n    // Cleanup previous states cache\n    this.previousStates.delete(documentId);\n\n    this.logger.debug(\n      'CommandsPlugin',\n      'DocumentClosed',\n      `Cleaned up command state cache for document: ${documentId}`,\n    );\n  }\n\n  async initialize(): Promise<void> {\n    this.logger.info('CommandsPlugin', 'Initialize', 'Commands plugin initialized');\n  }\n\n  async destroy(): Promise<void> {\n    this.commandExecuted$.clear();\n    this.commandStateChanged$.clear();\n    this.shortcutExecuted$.clear();\n    this.categoryChanged$.clear();\n    this.commands.clear();\n    this.shortcutMap.clear();\n    this.previousStates.clear();\n    super.destroy();\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Category Management\n  // ─────────────────────────────────────────────────────────\n\n  private disableCategoryImpl(category: string): void {\n    const current = new Set(this.state.disabledCategories);\n    if (!current.has(category)) {\n      current.add(category);\n      this.dispatch(setDisabledCategories(Array.from(current)));\n      this.categoryChanged$.emit({ disabledCategories: Array.from(current) });\n    }\n  }\n\n  private enableCategoryImpl(category: string): void {\n    const current = new Set(this.state.disabledCategories);\n    if (current.has(category)) {\n      current.delete(category);\n      this.dispatch(setDisabledCategories(Array.from(current)));\n      this.categoryChanged$.emit({ disabledCategories: Array.from(current) });\n    }\n  }\n\n  private toggleCategoryImpl(category: string): void {\n    if (this.state.disabledCategories.includes(category)) {\n      this.enableCategoryImpl(category);\n    } else {\n      this.disableCategoryImpl(category);\n    }\n  }\n\n  private setDisabledCategoriesImpl(categories: string[]): void {\n    this.dispatch(setDisabledCategories(categories));\n    this.categoryChanged$.emit({ disabledCategories: categories });\n  }\n\n  /**\n   * Check if command has any disabled category\n   */\n  private isCommandCategoryDisabled(command: Command): boolean {\n    if (!command.categories?.length) return false;\n    return command.categories.some((cat) => this.state.disabledCategories.includes(cat));\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Capability\n  // ─────────────────────────────────────────────────────────\n\n  protected buildCapability(): CommandsCapability {\n    return {\n      resolve: (commandId, documentId) => this.resolve(commandId, documentId),\n      execute: (commandId, documentId, source = 'ui') =>\n        this.execute(commandId, documentId, source),\n      getAllCommands: (documentId) => this.getAllCommands(documentId),\n      getCommandsByCategory: (category, documentId) =>\n        this.getCommandsByCategory(category, documentId),\n      getCommandByShortcut: (shortcut) => this.getCommandByShortcut(shortcut),\n      getAllShortcuts: () => new Map(this.shortcutMap),\n      forDocument: (documentId) => this.createCommandScope(documentId),\n      registerCommand: (command) => this.registerCommand(command),\n      unregisterCommand: (commandId) => this.unregisterCommand(commandId),\n\n      // Category management\n      disableCategory: (category) => this.disableCategoryImpl(category),\n      enableCategory: (category) => this.enableCategoryImpl(category),\n      toggleCategory: (category) => this.toggleCategoryImpl(category),\n      setDisabledCategories: (categories) => this.setDisabledCategoriesImpl(categories),\n      getDisabledCategories: () => this.state.disabledCategories,\n      isCategoryDisabled: (category) => this.state.disabledCategories.includes(category),\n\n      // Events\n      onCommandExecuted: this.commandExecuted$.on,\n      onCommandStateChanged: this.commandStateChanged$.on,\n      onShortcutExecuted: this.shortcutExecuted$.on,\n      onCategoryChanged: this.categoryChanged$.on,\n    };\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Document Scoping\n  // ─────────────────────────────────────────────────────────\n\n  private createCommandScope(documentId: string): CommandScope {\n    return {\n      resolve: (commandId) => this.resolve(commandId, documentId),\n      execute: (commandId, source = 'ui') => this.execute(commandId, documentId, source),\n      getAllCommands: () => this.getAllCommands(documentId),\n      getCommandsByCategory: (category) => this.getCommandsByCategory(category, documentId),\n      onCommandStateChanged: (listener: Listener<Omit<CommandStateChangedEvent, 'documentId'>>) =>\n        this.commandStateChanged$.on((event) => {\n          if (event.documentId === documentId) {\n            const { documentId: _, ...rest } = event;\n            listener(rest);\n          }\n        }),\n    };\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Command Resolution\n  // ─────────────────────────────────────────────────────────\n\n  private resolve(commandId: string, documentId?: string): ResolvedCommand {\n    const resolvedDocId = documentId ?? this.getActiveDocumentId();\n\n    const command = this.commands.get(commandId);\n    if (!command) {\n      throw new Error(`Command not found: ${commandId}`);\n    }\n\n    const state = this.registry.getStore().getState();\n\n    // Resolve label with i18n if available\n    const label = this.resolveLabel(command, state, resolvedDocId);\n\n    // Resolve shortcuts\n    const shortcuts = command.shortcuts\n      ? Array.isArray(command.shortcuts)\n        ? command.shortcuts\n        : [command.shortcuts]\n      : undefined;\n\n    // Check if disabled via categories OR explicit disabled predicate\n    const explicitDisabled = this.resolveDynamic(command.disabled, state, resolvedDocId) ?? false;\n    const categoryDisabled = this.isCommandCategoryDisabled(command);\n    const isDisabled = explicitDisabled || categoryDisabled;\n\n    return {\n      id: command.id,\n      label,\n      icon: this.resolveDynamic(command.icon, state, resolvedDocId),\n      iconProps: this.resolveDynamic(command.iconProps, state, resolvedDocId),\n      active: this.resolveDynamic(command.active, state, resolvedDocId) ?? false,\n      disabled: isDisabled,\n      visible: this.resolveDynamic(command.visible, state, resolvedDocId) ?? true,\n      shortcuts,\n      shortcutLabel: command.shortcutLabel,\n      categories: command.categories,\n      description: command.description,\n      execute: () =>\n        command.action({\n          registry: this.registry,\n          state,\n          documentId: resolvedDocId,\n          logger: this.logger,\n        }),\n    };\n  }\n\n  private resolveLabel(command: Command, state: StoreState<any>, documentId: string): string {\n    // Priority: labelKey (with i18n) > label (plain string) > id (fallback)\n    const labelKey = this.resolveDynamic(command.labelKey, state, documentId);\n    if (labelKey && this.i18n) {\n      const params = this.resolveDynamic(command.labelParams, state, documentId);\n      return this.i18n.t(labelKey, { params, documentId });\n    }\n\n    if (command.label) {\n      return command.label;\n    }\n\n    return command.id; // Fallback to ID\n  }\n\n  private resolveDynamic<T>(\n    value: Dynamic<any, T> | undefined,\n    state: StoreState<any>,\n    documentId: string,\n  ): T | undefined {\n    if (value === undefined) return undefined;\n\n    // Check if it's a function (the dynamic evaluator)\n    if (typeof value === 'function') {\n      return (\n        value as (context: {\n          registry: PluginRegistry;\n          state: StoreState<any>;\n          documentId: string;\n          logger: Logger;\n        }) => T\n      )({\n        registry: this.registry,\n        state,\n        documentId,\n        logger: this.logger,\n      });\n    }\n\n    // Otherwise it's the static value\n    return value as T;\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Command Execution\n  // ─────────────────────────────────────────────────────────\n\n  private execute(\n    commandId: string,\n    documentId?: string,\n    source: 'keyboard' | 'ui' | 'api' = 'ui',\n  ): void {\n    const resolvedDocId = documentId ?? this.getActiveDocumentId();\n    const resolved = this.resolve(commandId, resolvedDocId);\n\n    if (resolved.disabled) {\n      this.logger.warn(\n        'CommandsPlugin',\n        'ExecutionBlocked',\n        `Command '${commandId}' is disabled for document '${resolvedDocId}'`,\n      );\n      return;\n    }\n\n    if (!resolved.visible) {\n      this.logger.warn(\n        'CommandsPlugin',\n        'ExecutionBlocked',\n        `Command '${commandId}' is not visible for document '${resolvedDocId}'`,\n      );\n      return;\n    }\n\n    resolved.execute();\n\n    this.commandExecuted$.emit({\n      commandId,\n      documentId: resolvedDocId,\n      source,\n    });\n\n    this.logger.debug(\n      'CommandsPlugin',\n      'CommandExecuted',\n      `Command '${commandId}' executed for document '${resolvedDocId}' (source: ${source})`,\n    );\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Command Registration\n  // ─────────────────────────────────────────────────────────\n\n  private registerCommand(command: Command): void {\n    if (this.commands.has(command.id)) {\n      this.logger.warn(\n        'CommandsPlugin',\n        'CommandOverwrite',\n        `Command '${command.id}' already exists and will be overwritten`,\n      );\n    }\n\n    this.commands.set(command.id, command);\n\n    // Register shortcuts\n    if (command.shortcuts) {\n      const shortcuts = Array.isArray(command.shortcuts) ? command.shortcuts : [command.shortcuts];\n\n      shortcuts.forEach((shortcut) => {\n        const normalized = this.normalizeShortcut(shortcut);\n        this.shortcutMap.set(normalized, command.id);\n      });\n    }\n\n    this.logger.debug('CommandsPlugin', 'CommandRegistered', `Command '${command.id}' registered`);\n  }\n\n  private unregisterCommand(commandId: string): void {\n    const command = this.commands.get(commandId);\n    if (!command) return;\n\n    // Remove shortcuts\n    if (command.shortcuts) {\n      const shortcuts = Array.isArray(command.shortcuts) ? command.shortcuts : [command.shortcuts];\n\n      shortcuts.forEach((shortcut) => {\n        const normalized = this.normalizeShortcut(shortcut);\n        this.shortcutMap.delete(normalized);\n      });\n    }\n\n    this.commands.delete(commandId);\n    this.logger.debug(\n      'CommandsPlugin',\n      'CommandUnregistered',\n      `Command '${commandId}' unregistered`,\n    );\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Shortcuts\n  // ─────────────────────────────────────────────────────────\n\n  private getCommandByShortcut(shortcut: string): Command | null {\n    const normalized = this.normalizeShortcut(shortcut);\n    const commandId = this.shortcutMap.get(normalized);\n    return commandId ? (this.commands.get(commandId) ?? null) : null;\n  }\n\n  private normalizeShortcut(shortcut: string): string {\n    // Normalize: \"Ctrl+Shift+A\" -> \"ctrl+shift+a\"\n    return shortcut.toLowerCase().split('+').sort().join('+');\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // Query Methods\n  // ─────────────────────────────────────────────────────────\n\n  private getAllCommands(documentId?: string): ResolvedCommand[] {\n    const resolvedDocId = documentId ?? this.getActiveDocumentId();\n    return Array.from(this.commands.keys()).map((id) => this.resolve(id, resolvedDocId));\n  }\n\n  private getCommandsByCategory(category: string, documentId?: string): ResolvedCommand[] {\n    const resolvedDocId = documentId ?? this.getActiveDocumentId();\n    return Array.from(this.commands.values())\n      .filter((cmd) => cmd.categories?.includes(category))\n      .map((cmd) => this.resolve(cmd.id, resolvedDocId));\n  }\n\n  // ─────────────────────────────────────────────────────────\n  // State Change Detection\n  // ─────────────────────────────────────────────────────────\n\n  private onGlobalStoreChange(newState: StoreState<any>): void {\n    // Get all documents from core state\n    const documentIds = Object.keys(newState.core.documents);\n\n    // Check each document for command state changes\n    documentIds.forEach((documentId) => {\n      this.detectCommandChanges(documentId, newState);\n    });\n  }\n\n  private detectCommandChanges(documentId: string, newState: StoreState<any>): void {\n    // Skip if document isn't fully loaded yet\n    const coreDoc = newState.core.documents[documentId];\n    if (!coreDoc || coreDoc.status !== 'loaded') return;\n\n    const previousCache = this.previousStates.get(documentId) ?? new Map();\n    const changedCommandIds: string[] = [];\n\n    this.commands.forEach((command, commandId) => {\n      const newResolved = this.resolve(commandId, documentId);\n      const prevResolved = previousCache.get(commandId);\n\n      if (!prevResolved) {\n        // First time resolving for this document\n        previousCache.set(commandId, newResolved);\n        return;\n      }\n\n      // Check for changes\n      const changes: CommandStateChangedEvent['changes'] = {};\n\n      if (prevResolved.active !== newResolved.active) {\n        changes.active = newResolved.active;\n      }\n      if (prevResolved.disabled !== newResolved.disabled) {\n        changes.disabled = newResolved.disabled;\n      }\n      if (prevResolved.visible !== newResolved.visible) {\n        changes.visible = newResolved.visible;\n      }\n      if (prevResolved.label !== newResolved.label) {\n        changes.label = newResolved.label;\n      }\n      if (prevResolved.icon !== newResolved.icon) {\n        changes.icon = newResolved.icon;\n      }\n      if (!arePropsEqual(prevResolved.iconProps, newResolved.iconProps)) {\n        changes.iconProps = newResolved.iconProps;\n      }\n\n      if (Object.keys(changes).length > 0) {\n        changedCommandIds.push(commandId);\n        previousCache.set(commandId, newResolved);\n\n        this.commandStateChanged$.emit({\n          commandId,\n          documentId,\n          changes,\n        });\n      }\n    });\n\n    this.previousStates.set(documentId, previousCache);\n  }\n}\n","import { Reducer } from '@embedpdf/core';\nimport { CommandsState } from './types';\nimport { CommandsAction, SET_DISABLED_CATEGORIES } from './actions';\n\nexport const initialState: CommandsState = {\n  disabledCategories: [],\n};\n\nexport const commandsReducer: Reducer<CommandsState, CommandsAction> = (\n  state = initialState,\n  action,\n) => {\n  switch (action.type) {\n    case SET_DISABLED_CATEGORIES:\n      return {\n        ...state,\n        disabledCategories: action.payload,\n      };\n\n    default:\n      return state;\n  }\n};\n","import { PluginPackage } from '@embedpdf/core';\nimport { manifest, COMMANDS_PLUGIN_ID } from './manifest';\nimport { CommandsPluginConfig, CommandsState } from './types';\nimport { CommandsPlugin } from './commands-plugin';\nimport { CommandsAction } from './actions';\nimport { commandsReducer, initialState } from './reducer';\n\nexport const CommandsPluginPackage: PluginPackage<\n  CommandsPlugin,\n  CommandsPluginConfig,\n  CommandsState,\n  CommandsAction\n> = {\n  manifest,\n  create: (registry, config) => new CommandsPlugin(COMMANDS_PLUGIN_ID, registry, config),\n  reducer: commandsReducer,\n  initialState,\n};\n\nexport * from './commands-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"names":["COMMANDS_PLUGIN_ID","manifest","id","name","version","provides","requires","optional","defaultConfig","commands","SET_DISABLED_CATEGORIES","setDisabledCategories","categories","type","payload","_CommandsPlugin","BasePlugin","constructor","registry","config","super","this","Map","i18n","shortcutMap","commandExecuted$","createEmitter","commandStateChanged$","shortcutExecuted$","categoryChanged$","createBehaviorEmitter","previousStates","i18nPlugin","getPlugin","_a","disabledCategories","length","dispatch","Object","values","forEach","command","registerCommand","getStore","subscribe","_action","newState","onGlobalStoreChange","onDocumentClosed","documentId","delete","logger","debug","initialize","info","destroy","clear","disableCategoryImpl","category","current","Set","state","has","add","Array","from","emit","enableCategoryImpl","toggleCategoryImpl","includes","setDisabledCategoriesImpl","isCommandCategoryDisabled","some","cat","buildCapability","resolve","commandId","execute","source","getAllCommands","getCommandsByCategory","getCommandByShortcut","shortcut","getAllShortcuts","forDocument","createCommandScope","unregisterCommand","disableCategory","enableCategory","toggleCategory","getDisabledCategories","isCategoryDisabled","onCommandExecuted","on","onCommandStateChanged","onShortcutExecuted","onCategoryChanged","listener","event","_","rest","resolvedDocId","getActiveDocumentId","get","Error","getState","label","resolveLabel","shortcuts","isArray","explicitDisabled","resolveDynamic","disabled","categoryDisabled","isDisabled","icon","iconProps","active","visible","shortcutLabel","description","action","labelKey","params","labelParams","t","value","resolved","warn","set","normalized","normalizeShortcut","toLowerCase","split","sort","join","keys","map","filter","cmd","core","documents","detectCommandChanges","coreDoc","status","previousCache","newResolved","prevResolved","changes","arePropsEqual","CommandsPlugin","initialState","CommandsPluginPackage","create","reducer"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["parseShortcut","I18nToken","ShellToken"],"sources":["../src/capability.ts","../src/reducer.ts","../src/types.ts","../src/commands.plugin.ts"],"sourcesContent":["import type { CapabilityToken, PluginContext } from '@embedpdf/core';\nimport { I18nToken } from '@embedpdf/plugin-i18n';\nimport { ShellToken } from '@embedpdf/plugin-shell';\nimport { matchShortcut, parseShortcut } from '@embedpdf/core-ui';\nimport type { KeyStroke, ParsedShortcut } from '@embedpdf/core-ui';\nimport type {\n  CommandCtx,\n  CommandDef,\n  CommandsAction,\n  CommandsCapability,\n  CommandsState,\n  IconAccent,\n  ResolvedCommand,\n} from './types';\n\n/** A registered command: the definition plus its pre-parsed shortcuts. */\nexport interface RegisteredCommand {\n  readonly def: CommandDef;\n  readonly shortcuts: readonly string[];\n  readonly parsed: readonly ParsedShortcut[];\n}\n\nexport type CommandRegistry = Map<string, RegisteredCommand>;\n\nexport function registerCommand(registry: CommandRegistry, def: CommandDef): void {\n  if (registry.has(def.id)) throw new Error(`[commands] duplicate command: ${def.id}`);\n  const shortcuts = def.shortcut === undefined ? [] : ([] as string[]).concat(def.shortcut);\n  registry.set(def.id, { def, shortcuts, parsed: shortcuts.map(parseShortcut) });\n}\n\nconst panelTarget = (def: CommandDef): { id: string; exclusive?: string } | null =>\n  def.panel === undefined ? null : typeof def.panel === 'string' ? { id: def.panel } : def.panel;\n\nexport function createCommandsCapability(\n  ctx: PluginContext<CommandsState, CommandsAction>,\n  registry: CommandRegistry,\n): CommandsCapability {\n  /** Bind capability resolution to the command's target document. The kernel\n   *  resolves workspace tokens regardless of the document argument, so one\n   *  code path serves both scopes. */\n  const commandCtx = (documentId?: string): CommandCtx => {\n    const target = documentId ?? ctx.core().activeId;\n    const get = <T>(token: CapabilityToken<T>): T =>\n      target ? ctx.forDocument(token, target) : ctx.get(token);\n    return {\n      documentId: target,\n      core: ctx.core,\n      get,\n      tryGet: <T>(token: CapabilityToken<T>): T | null => {\n        try {\n          return get(token);\n        } catch {\n          return null;\n        }\n      },\n    };\n  };\n\n  /** Derivations run against live state; a derivation that throws (e.g. it\n   *  needs a document and none is open) falls back to the safe default —\n   *  the button renders, disabled, exactly like v2's empty state. */\n  const derive = (\n    fn: ((c: CommandCtx) => boolean) | undefined,\n    c: CommandCtx,\n    fallback: boolean,\n  ): boolean => {\n    if (!fn) return fallback;\n    try {\n      return fn(c);\n    } catch {\n      return fallback;\n    }\n  };\n\n  /** Same guard as `derive`, for the icon-accent derivation: a throw (no\n   *  document, provider missing) means \"no accent\" — the icon renders plain. */\n  const deriveAccent = (\n    fn: ((c: CommandCtx) => IconAccent | null) | undefined,\n    c: CommandCtx,\n  ): IconAccent | undefined => {\n    if (!fn) return undefined;\n    try {\n      return fn(c) ?? undefined;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const resolve = (id: string, documentId?: string): ResolvedCommand | null => {\n    const entry = registry.get(id);\n    if (!entry) return null;\n    const { def } = entry;\n    const c = commandCtx(documentId);\n\n    const disabled = ctx.getState().disabledCategories;\n    const categoryHidden = (def.categories ?? []).some((cat) => disabled.includes(cat));\n\n    const i18n = c.tryGet(I18nToken);\n    const label = i18n ? i18n.t(def.labelKey) : def.labelKey;\n\n    // Surface-target commands derive `active` from the surface's open state\n    // unless the definition overrides it.\n    let active: boolean;\n    if (def.active) {\n      active = derive(def.active, c, false);\n    } else {\n      const shell = c.tryGet(ShellToken);\n      const panel = panelTarget(def);\n      active = shell\n        ? def.menu\n          ? shell.isMenuOpen(def.menu)\n          : panel\n            ? shell.isOpen(panel.id)\n            : def.modal\n              ? shell.isOpen(def.modal)\n              : false\n        : false;\n    }\n\n    return {\n      id: def.id,\n      label,\n      icon: def.icon,\n      iconAccent: deriveAccent(def.iconAccent, c),\n      shortcuts: entry.shortcuts,\n      menu: def.menu,\n      enabled: derive(def.enabled, c, true) && !categoryHidden,\n      active,\n      visible: derive(def.visible, c, true) && !categoryHidden,\n      categories: def.categories ?? [],\n    };\n  };\n\n  const execute = (id: string, documentId?: string): void => {\n    const entry = registry.get(id);\n    if (!entry) return;\n    const resolved = resolve(id, documentId);\n    if (!resolved || !resolved.enabled || !resolved.visible) return;\n    const c = commandCtx(documentId);\n\n    if (entry.def.run) {\n      entry.def.run(c);\n      return;\n    }\n    // Default routing for declarative surface targets.\n    const shell = c.tryGet(ShellToken);\n    if (!shell) return;\n    const panel = panelTarget(entry.def);\n    if (entry.def.menu) shell.toggleMenu(entry.def.menu);\n    else if (panel) shell.toggle(panel.id, { exclusive: panel.exclusive });\n    else if (entry.def.modal) shell.toggle(entry.def.modal, { exclusive: 'modal' });\n  };\n\n  return {\n    register: (def) => registerCommand(registry, def),\n    unregister: (id) => void registry.delete(id),\n    has: (id) => registry.has(id),\n    ids: () => [...registry.keys()],\n\n    resolve,\n    search: (query, documentId) => {\n      const q = query.trim().toLowerCase();\n      const hits: ResolvedCommand[] = [];\n      for (const id of registry.keys()) {\n        const r = resolve(id, documentId);\n        if (!r || !r.visible) continue;\n        if (q === '' || r.label.toLowerCase().includes(q) || r.id.includes(q)) hits.push(r);\n      }\n      return hits;\n    },\n    menuTarget: (id) => {\n      const entry = registry.get(id);\n      return entry ? { menu: entry.def.menu } : null;\n    },\n\n    execute,\n    matchStroke: (stroke: KeyStroke, opts) => {\n      for (const [id, entry] of registry) {\n        if (entry.parsed.some((p) => matchShortcut(p, stroke, opts))) return id;\n      }\n      return null;\n    },\n\n    disabledCategories: () => ctx.getState().disabledCategories,\n    isCategoryDisabled: (category) => ctx.getState().disabledCategories.includes(category),\n    disableCategory: (category) => ctx.dispatch({ type: 'COMMANDS/DISABLE_CATEGORY', category }),\n    enableCategory: (category) => ctx.dispatch({ type: 'COMMANDS/ENABLE_CATEGORY', category }),\n    setDisabledCategories: (categories) =>\n      ctx.dispatch({ type: 'COMMANDS/SET_DISABLED_CATEGORIES', categories }),\n  };\n}\n","import type { CommandsAction, CommandsState } from './types';\n\nexport const initialCommandsState: CommandsState = {\n  disabledCategories: [],\n};\n\nexport function commandsReducer(state: CommandsState, action: CommandsAction): CommandsState {\n  switch (action.type) {\n    case 'COMMANDS/DISABLE_CATEGORY':\n      return state.disabledCategories.includes(action.category)\n        ? state\n        : { disabledCategories: [...state.disabledCategories, action.category] };\n    case 'COMMANDS/ENABLE_CATEGORY':\n      return state.disabledCategories.includes(action.category)\n        ? { disabledCategories: state.disabledCategories.filter((c) => c !== action.category) }\n        : state;\n    case 'COMMANDS/SET_DISABLED_CATEGORIES':\n      return { disabledCategories: [...action.categories] };\n    default:\n      return state;\n  }\n}\n","import { createCapabilityToken } from '@embedpdf/core';\nimport type { CapabilityToken, CoreState } from '@embedpdf/core';\nimport type { KeyStroke } from '@embedpdf/core-ui';\n\n/**\n * @embedpdf/plugin-commands — the contract.\n *\n * Commands are the single vocabulary of verbs: toolbars, menus, contextual\n * strips, shortcuts, and the palette are all projections of this registry.\n * The plugin ships ZERO commands (mechanism here, definitions in the product\n * — same split as plugin-i18n's locale packs).\n *\n * Command state is a pure DERIVATION over the store: `resolve()` reads other\n * capabilities' selectors at call time, so any store change is reflected on\n * the next read and the framework binding's one change stream makes every\n * consumer reactive. There is no CommandStateChangedEvent, no diffing, no\n * cache — v2's entire notification apparatus has no v3 equivalent because\n * the reactive store subsumes it.\n *\n * Definitions hold functions, so they live in the plugin's registry (config\n * + `register()`), never in the store; store state is only the serializable\n * `disabledCategories`.\n */\n\n/** What a derivation or `run` sees: capability resolution bound to the\n *  command's target document (explicit, else the active one). */\nexport interface CommandCtx {\n  /** The target document, or null when no document is open. */\n  readonly documentId: string | null;\n  core(): CoreState;\n  /** Resolve a capability; document-scoped tokens bind to the target document. */\n  get<T>(token: CapabilityToken<T>): T;\n  /** Like `get`, but null when unavailable (no provider / no document). */\n  tryGet<T>(token: CapabilityToken<T>): T | null;\n}\n\n/**\n * Up to two theme colors accompanying a command's icon — typed FACTS any\n * renderer can interpret (tint a glyph's slots, show a swatch), never\n * renderer props. The registry carries it the way it carries `icon`: as\n * data it doesn't interpret. Deliberately NOT v2's `iconProps` bag —\n * renderer-specific needs live app-side, joined by command id.\n */\nexport interface IconAccent {\n  /** The mark: stroke / markup / font color. */\n  readonly primary?: string;\n  /** The fill, when there is one. */\n  readonly secondary?: string;\n}\n\nexport interface CommandDef {\n  /** Convention: 'domain:verb' — 'zoom:in', 'mode:annotate', 'panel:search'. */\n  readonly id: string;\n  /** i18n key, resolved through I18nToken when present (else shown verbatim). */\n  readonly labelKey: string;\n  readonly icon?: string;\n  /** Live color accent for the icon (a tool previewing its drawing defaults).\n   *  A pure derivation over the store, exactly like `active`/`enabled`. */\n  readonly iconAccent?: (ctx: CommandCtx) => IconAccent | null;\n  /** 'Mod+K' style (ui-core grammar). Multiple bindings allowed. */\n  readonly shortcut?: string | readonly string[];\n  /** Feature-gating tags: a disabled category hides its commands everywhere. */\n  readonly categories?: readonly string[];\n\n  // ── declarative surface targets ──────────────────────────────────────────\n  // A command that opens chrome DECLARES what it opens instead of doing it\n  // imperatively. This is load-bearing: buttons render carets/aria-haspopup,\n  // `active` derives automatically from the surface's open state, and the\n  // overflow projection renders `menu` targets as nested submenus.\n  /** Toggles a named dropdown menu (a MenuSchema id in the app's chrome). */\n  readonly menu?: string;\n  /** Toggles a named shell surface, optionally exclusive within a tag ('left'…). */\n  readonly panel?: string | { readonly id: string; readonly exclusive?: string };\n  /** Toggles a modal surface (exclusive within the built-in 'modal' tag). */\n  readonly modal?: string;\n\n  // ── pure derivations over the store ──────────────────────────────────────\n  readonly enabled?: (ctx: CommandCtx) => boolean;\n  readonly active?: (ctx: CommandCtx) => boolean;\n  readonly visible?: (ctx: CommandCtx) => boolean;\n\n  /** The verb. Optional for pure surface-target commands. Runs before the\n   *  default target routing when both are present. */\n  readonly run?: (ctx: CommandCtx) => void;\n}\n\n/** A command as a renderer sees it — everything resolved for the target document. */\nexport interface ResolvedCommand {\n  readonly id: string;\n  readonly label: string;\n  readonly icon?: string;\n  readonly iconAccent?: IconAccent;\n  readonly shortcuts: readonly string[];\n  readonly menu?: string;\n  readonly enabled: boolean;\n  readonly active: boolean;\n  readonly visible: boolean;\n  readonly categories: readonly string[];\n}\n\n/** Value equality over resolved commands — `resolve()` mints a fresh object\n *  per read, so reactive bindings memo by value to re-render on real change. */\nexport const resolvedCommandsEqual = (\n  a: ResolvedCommand | null,\n  b: ResolvedCommand | null,\n): boolean => {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.id === b.id &&\n    a.label === b.label &&\n    a.icon === b.icon &&\n    // by value: resolve() mints a fresh accent object each read\n    a.iconAccent?.primary === b.iconAccent?.primary &&\n    a.iconAccent?.secondary === b.iconAccent?.secondary &&\n    a.menu === b.menu &&\n    a.enabled === b.enabled &&\n    a.active === b.active &&\n    a.visible === b.visible &&\n    a.shortcuts.length === b.shortcuts.length &&\n    a.shortcuts.every((s, i) => s === b.shortcuts[i])\n  );\n};\n\nexport interface CommandsState {\n  readonly disabledCategories: readonly string[];\n}\n\nexport type CommandsAction =\n  | { type: 'COMMANDS/DISABLE_CATEGORY'; category: string }\n  | { type: 'COMMANDS/ENABLE_CATEGORY'; category: string }\n  | { type: 'COMMANDS/SET_DISABLED_CATEGORIES'; categories: readonly string[] };\n\nexport interface CommandsConfig {\n  /** The app's command definitions (content — the plugin ships none). */\n  commands?: readonly CommandDef[];\n  /** Categories disabled at startup (host feature-gating). */\n  disabledCategories?: readonly string[];\n}\n\nexport interface CommandsCapability {\n  // ── registry ──\n  register(def: CommandDef): void;\n  unregister(id: string): void;\n  has(id: string): boolean;\n  ids(): string[];\n\n  // ── resolution (pure reads; reactive through the store) ──\n  resolve(id: string, documentId?: string): ResolvedCommand | null;\n  /** Palette query: visible commands whose resolved label matches. */\n  search(query: string, documentId?: string): ResolvedCommand[];\n  /** The one fact the overflow projection needs (ResolveMenuTarget-shaped). */\n  menuTarget(id: string): { menu?: string } | null;\n\n  // ── execution (the ONLY path; guarded by enabled/visible) ──\n  execute(id: string, documentId?: string): void;\n  /** Match a keystroke against every registered shortcut → command id or null. */\n  matchStroke(stroke: KeyStroke, opts: { isMac: boolean }): string | null;\n\n  // ── category gating ──\n  disabledCategories(): readonly string[];\n  isCategoryDisabled(category: string): boolean;\n  disableCategory(category: string): void;\n  enableCategory(category: string): void;\n  setDisabledCategories(categories: readonly string[]): void;\n}\n\nexport const CommandsToken = createCapabilityToken<CommandsCapability>('commands');\n","import { definePlugin } from '@embedpdf/core';\nimport { createCommandsCapability, registerCommand } from './capability';\nimport type { CommandRegistry } from './capability';\nimport { commandsReducer, initialCommandsState } from './reducer';\nimport { CommandsToken } from './types';\nimport type { CommandsAction, CommandsCapability, CommandsConfig, CommandsState } from './types';\n\n/**\n * The commands plugin: workspace-scoped (one vocabulary for the whole\n * workspace; resolution/execution bind to a target document per call).\n * Definitions live in this closure — never in the store (they hold\n * functions); the store slice holds only `disabledCategories`.\n */\nexport const commandsPlugin = (config?: CommandsConfig) => {\n  const registry: CommandRegistry = new Map();\n  for (const def of config?.commands ?? []) registerCommand(registry, def);\n\n  return definePlugin<CommandsState, CommandsAction, CommandsCapability>({\n    id: 'commands',\n    scope: 'workspace',\n    token: CommandsToken,\n    initialState: {\n      ...initialCommandsState,\n      disabledCategories: [...(config?.disabledCategories ?? [])],\n    },\n    reduce: commandsReducer,\n    capability: (ctx) => createCommandsCapability(ctx, registry),\n  });\n};\n"],"mappings":"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"}