@embedpdf/plugin-commands 2.0.0-next.0

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"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"],defaultConfig:{enabled:!0,commands:{}}},o=class extends e.BasePlugin{constructor(t,s,o){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.previousStates=new Map;const i=s.getPlugin("i18n");this.i18n=(null==i?void 0:i.provides())??null,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.commands.clear(),this.shortcutMap.clear(),this.previousStates.clear(),super.destroy()}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),onCommandExecuted:this.commandExecuted$.on,onCommandStateChanged:this.commandStateChanged$.on,onShortcutExecuted:this.shortcutExecuted$.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(),n=this.resolveLabel(o,i,s),a=o.shortcuts?Array.isArray(o.shortcuts)?o.shortcuts:[o.shortcuts]:void 0;return{id:o.id,label:n,icon:this.resolveDynamic(o.icon,i,s),iconProps:this.resolveDynamic(o.iconProps,i,s),active:this.resolveDynamic(o.active,i,s)??!1,disabled:this.resolveDynamic(o.disabled,i,s)??!1,visible:this.resolveDynamic(o.visible,i,s)??!0,shortcuts:a,shortcutLabel:o.shortcutLabel,category:o.category,description:o.description,execute:()=>o.action({registry:this.registry,state:i,documentId:s})}}resolveLabel(e,t,s){if(e.labelKey&&this.i18n){const o=this.resolveDynamic(e.labelParams,t,s);return this.i18n.t(e.labelKey,{params:o,documentId:s})}return e.label?e.label:e.id}resolveDynamic(e,t,s){if(void 0!==e)return"function"==typeof e?e({state:t,documentId:s}):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=>t.category===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=this.previousStates.get(t)??new Map;this.commands.forEach((s,i)=>{const n=this.resolve(i,t),a=o.get(i);if(!a)return void o.set(i,n);const r={};a.active!==n.active&&(r.active=n.active),a.disabled!==n.disabled&&(r.disabled=n.disabled),a.visible!==n.visible&&(r.visible=n.visible),a.label!==n.label&&(r.label=n.label),e.arePropsEqual(a.iconProps,n.iconProps)||(r.iconProps=n.iconProps),Object.keys(r).length>0&&(o.set(i,n),this.commandStateChanged$.emit({commandId:i,documentId:t,changes:r}))}),this.previousStates.set(t,o)}};o.id="commands";let i=o;const n={changedCommands:new Set},a={manifest:s,create:(e,s)=>new i(t,e,s),reducer:(e=n,t)=>{switch(t.type){case"COMMANDS/MARK_CHANGED":{const s=new Set(e.changedCommands);return t.payload.forEach(e=>s.add(e)),{...e,changedCommands:s}}case"COMMANDS/CLEAR_CHANGED":return{...e,changedCommands:new Set};default:return e}},initialState:n};exports.COMMANDS_PLUGIN_ID=t,exports.CommandsPlugin=i,exports.CommandsPluginPackage=a,exports.manifest=s;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/lib/manifest.ts","../src/lib/commands-plugin.ts","../src/lib/actions.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'],\n  defaultConfig: {\n    enabled: true,\n    commands: {},\n  },\n};\n","import {\n  BasePlugin,\n  PluginRegistry,\n  StoreState,\n  createEmitter,\n  Listener,\n  arePropsEqual,\n} from '@embedpdf/core';\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  CommandScope,\n  Dynamic,\n} from './types';\nimport { CommandsAction } 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\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    // 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.commands.clear();\n    this.shortcutMap.clear();\n    this.previousStates.clear();\n    super.destroy();\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      onCommandExecuted: this.commandExecuted$.on,\n      onCommandStateChanged: this.commandStateChanged$.on,\n      onShortcutExecuted: this.shortcutExecuted$.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    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: this.resolveDynamic(command.disabled, state, resolvedDocId) ?? false,\n      visible: this.resolveDynamic(command.visible, state, resolvedDocId) ?? true,\n      shortcuts,\n      shortcutLabel: command.shortcutLabel,\n      category: command.category,\n      description: command.description,\n      execute: () => command.action({ registry: this.registry, state, documentId: resolvedDocId }),\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    if (command.labelKey && this.i18n) {\n      const params = this.resolveDynamic(command.labelParams, state, documentId);\n      return this.i18n.t(command.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 (value as (context: { state: StoreState<any>; documentId: string }) => T)({\n        state,\n        documentId,\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.category === 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    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 (!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 { Action } from '@embedpdf/core';\n\nexport const REGISTER_COMMAND = 'COMMANDS/REGISTER';\nexport const UNREGISTER_COMMAND = 'COMMANDS/UNREGISTER';\nexport const MARK_COMMANDS_CHANGED = 'COMMANDS/MARK_CHANGED';\nexport const CLEAR_CHANGED_COMMANDS = 'COMMANDS/CLEAR_CHANGED';\n\nexport interface RegisterCommandAction extends Action {\n  type: typeof REGISTER_COMMAND;\n  payload: string; // commandId\n}\n\nexport interface UnregisterCommandAction extends Action {\n  type: typeof UNREGISTER_COMMAND;\n  payload: string; // commandId\n}\n\nexport interface MarkCommandsChangedAction extends Action {\n  type: typeof MARK_COMMANDS_CHANGED;\n  payload: string[]; // commandIds\n}\n\nexport interface ClearChangedCommandsAction extends Action {\n  type: typeof CLEAR_CHANGED_COMMANDS;\n}\n\nexport type CommandsAction =\n  | RegisterCommandAction\n  | UnregisterCommandAction\n  | MarkCommandsChangedAction\n  | ClearChangedCommandsAction;\n\nexport const registerCommand = (commandId: string): RegisterCommandAction => ({\n  type: REGISTER_COMMAND,\n  payload: commandId,\n});\n\nexport const unregisterCommand = (commandId: string): UnregisterCommandAction => ({\n  type: UNREGISTER_COMMAND,\n  payload: commandId,\n});\n\nexport const markCommandsChanged = (commandIds: string[]): MarkCommandsChangedAction => ({\n  type: MARK_COMMANDS_CHANGED,\n  payload: commandIds,\n});\n\nexport const clearChangedCommands = (): ClearChangedCommandsAction => ({\n  type: CLEAR_CHANGED_COMMANDS,\n});\n","import { Reducer } from '@embedpdf/core';\nimport { CommandsState } from './types';\nimport { CommandsAction, MARK_COMMANDS_CHANGED, CLEAR_CHANGED_COMMANDS } from './actions';\n\nexport const initialState: CommandsState = {\n  changedCommands: new Set(),\n};\n\nexport const commandsReducer: Reducer<CommandsState, CommandsAction> = (\n  state = initialState,\n  action,\n) => {\n  switch (action.type) {\n    case MARK_COMMANDS_CHANGED: {\n      const newSet = new Set(state.changedCommands);\n      action.payload.forEach((id) => newSet.add(id));\n      return {\n        ...state,\n        changedCommands: newSet,\n      };\n    }\n\n    case CLEAR_CHANGED_COMMANDS: {\n      return {\n        ...state,\n        changedCommands: new Set(),\n      };\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","enabled","commands","_CommandsPlugin","BasePlugin","constructor","registry","config","super","this","Map","i18n","shortcutMap","commandExecuted$","createEmitter","commandStateChanged$","shortcutExecuted$","previousStates","i18nPlugin","getPlugin","Object","values","forEach","command","registerCommand","getStore","subscribe","_action","newState","onGlobalStoreChange","onDocumentClosed","documentId","delete","logger","debug","initialize","info","destroy","clear","buildCapability","resolve","commandId","execute","source","getAllCommands","getCommandsByCategory","category","getCommandByShortcut","shortcut","getAllShortcuts","forDocument","createCommandScope","unregisterCommand","onCommandExecuted","on","onCommandStateChanged","onShortcutExecuted","listener","event","_","rest","resolvedDocId","getActiveDocumentId","get","Error","state","getState","label","resolveLabel","shortcuts","Array","isArray","icon","resolveDynamic","iconProps","active","disabled","visible","shortcutLabel","description","action","labelKey","params","labelParams","t","value","resolved","warn","emit","has","set","normalized","normalizeShortcut","toLowerCase","split","sort","join","from","keys","map","filter","cmd","core","documents","detectCommandChanges","previousCache","newResolved","prevResolved","changes","arePropsEqual","length","CommandsPlugin","initialState","changedCommands","Set","CommandsPluginPackage","create","reducer","type","newSet","payload","add"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/dist/index.js

@@ -0,0 +1,316 @@
+import { BasePlugin, createEmitter, 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"],
+  defaultConfig: {
+    enabled: true,
+    commands: {}
+  }
+};
+const _CommandsPlugin = class _CommandsPlugin extends BasePlugin {
+  constructor(id, registry, config) {
+    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.previousStates = /* @__PURE__ */ new Map();
+    const i18nPlugin = registry.getPlugin("i18n");
+    this.i18n = (i18nPlugin == null ? void 0 : i18nPlugin.provides()) ?? null;
+    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.commands.clear();
+    this.shortcutMap.clear();
+    this.previousStates.clear();
+    super.destroy();
+  }
+  // ─────────────────────────────────────────────────────────
+  // 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),
+      onCommandExecuted: this.commandExecuted$.on,
+      onCommandStateChanged: this.commandStateChanged$.on,
+      onShortcutExecuted: this.shortcutExecuted$.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;
+    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: this.resolveDynamic(command.disabled, state, resolvedDocId) ?? false,
+      visible: this.resolveDynamic(command.visible, state, resolvedDocId) ?? true,
+      shortcuts,
+      shortcutLabel: command.shortcutLabel,
+      category: command.category,
+      description: command.description,
+      execute: () => command.action({ registry: this.registry, state, documentId: resolvedDocId })
+    };
+  }
+  resolveLabel(command, state, documentId) {
+    if (command.labelKey && this.i18n) {
+      const params = this.resolveDynamic(command.labelParams, state, documentId);
+      return this.i18n.t(command.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({
+        state,
+        documentId
+      });
+    }
+    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) => cmd.category === 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 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 (!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);
+  }
+};
+_CommandsPlugin.id = "commands";
+let CommandsPlugin = _CommandsPlugin;
+const MARK_COMMANDS_CHANGED = "COMMANDS/MARK_CHANGED";
+const CLEAR_CHANGED_COMMANDS = "COMMANDS/CLEAR_CHANGED";
+const initialState = {
+  changedCommands: /* @__PURE__ */ new Set()
+};
+const commandsReducer = (state = initialState, action) => {
+  switch (action.type) {
+    case MARK_COMMANDS_CHANGED: {
+      const newSet = new Set(state.changedCommands);
+      action.payload.forEach((id) => newSet.add(id));
+      return {
+        ...state,
+        changedCommands: newSet
+      };
+    }
+    case CLEAR_CHANGED_COMMANDS: {
+      return {
+        ...state,
+        changedCommands: /* @__PURE__ */ new Set()
+      };
+    }
+    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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/lib/manifest.ts","../src/lib/commands-plugin.ts","../src/lib/actions.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'],\n  defaultConfig: {\n    enabled: true,\n    commands: {},\n  },\n};\n","import {\n  BasePlugin,\n  PluginRegistry,\n  StoreState,\n  createEmitter,\n  Listener,\n  arePropsEqual,\n} from '@embedpdf/core';\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  CommandScope,\n  Dynamic,\n} from './types';\nimport { CommandsAction } 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\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    // 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.commands.clear();\n    this.shortcutMap.clear();\n    this.previousStates.clear();\n    super.destroy();\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      onCommandExecuted: this.commandExecuted$.on,\n      onCommandStateChanged: this.commandStateChanged$.on,\n      onShortcutExecuted: this.shortcutExecuted$.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    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: this.resolveDynamic(command.disabled, state, resolvedDocId) ?? false,\n      visible: this.resolveDynamic(command.visible, state, resolvedDocId) ?? true,\n      shortcuts,\n      shortcutLabel: command.shortcutLabel,\n      category: command.category,\n      description: command.description,\n      execute: () => command.action({ registry: this.registry, state, documentId: resolvedDocId }),\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    if (command.labelKey && this.i18n) {\n      const params = this.resolveDynamic(command.labelParams, state, documentId);\n      return this.i18n.t(command.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 (value as (context: { state: StoreState<any>; documentId: string }) => T)({\n        state,\n        documentId,\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.category === 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    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 (!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 { Action } from '@embedpdf/core';\n\nexport const REGISTER_COMMAND = 'COMMANDS/REGISTER';\nexport const UNREGISTER_COMMAND = 'COMMANDS/UNREGISTER';\nexport const MARK_COMMANDS_CHANGED = 'COMMANDS/MARK_CHANGED';\nexport const CLEAR_CHANGED_COMMANDS = 'COMMANDS/CLEAR_CHANGED';\n\nexport interface RegisterCommandAction extends Action {\n  type: typeof REGISTER_COMMAND;\n  payload: string; // commandId\n}\n\nexport interface UnregisterCommandAction extends Action {\n  type: typeof UNREGISTER_COMMAND;\n  payload: string; // commandId\n}\n\nexport interface MarkCommandsChangedAction extends Action {\n  type: typeof MARK_COMMANDS_CHANGED;\n  payload: string[]; // commandIds\n}\n\nexport interface ClearChangedCommandsAction extends Action {\n  type: typeof CLEAR_CHANGED_COMMANDS;\n}\n\nexport type CommandsAction =\n  | RegisterCommandAction\n  | UnregisterCommandAction\n  | MarkCommandsChangedAction\n  | ClearChangedCommandsAction;\n\nexport const registerCommand = (commandId: string): RegisterCommandAction => ({\n  type: REGISTER_COMMAND,\n  payload: commandId,\n});\n\nexport const unregisterCommand = (commandId: string): UnregisterCommandAction => ({\n  type: UNREGISTER_COMMAND,\n  payload: commandId,\n});\n\nexport const markCommandsChanged = (commandIds: string[]): MarkCommandsChangedAction => ({\n  type: MARK_COMMANDS_CHANGED,\n  payload: commandIds,\n});\n\nexport const clearChangedCommands = (): ClearChangedCommandsAction => ({\n  type: CLEAR_CHANGED_COMMANDS,\n});\n","import { Reducer } from '@embedpdf/core';\nimport { CommandsState } from './types';\nimport { CommandsAction, MARK_COMMANDS_CHANGED, CLEAR_CHANGED_COMMANDS } from './actions';\n\nexport const initialState: CommandsState = {\n  changedCommands: new Set(),\n};\n\nexport const commandsReducer: Reducer<CommandsState, CommandsAction> = (\n  state = initialState,\n  action,\n) => {\n  switch (action.type) {\n    case MARK_COMMANDS_CHANGED: {\n      const newSet = new Set(state.changedCommands);\n      action.payload.forEach((id) => newSet.add(id));\n      return {\n        ...state,\n        changedCommands: newSet,\n      };\n    }\n\n    case CLEAR_CHANGED_COMMANDS: {\n      return {\n        ...state,\n        changedCommands: new Set(),\n      };\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":[],"mappings":"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"}

package/dist/lib/actions.d.ts

@@ -0,0 +1,25 @@
+import { Action } from '@embedpdf/core';
+export declare const REGISTER_COMMAND = "COMMANDS/REGISTER";
+export declare const UNREGISTER_COMMAND = "COMMANDS/UNREGISTER";
+export declare const MARK_COMMANDS_CHANGED = "COMMANDS/MARK_CHANGED";
+export declare const CLEAR_CHANGED_COMMANDS = "COMMANDS/CLEAR_CHANGED";
+export interface RegisterCommandAction extends Action {
+    type: typeof REGISTER_COMMAND;
+    payload: string;
+}
+export interface UnregisterCommandAction extends Action {
+    type: typeof UNREGISTER_COMMAND;
+    payload: string;
+}
+export interface MarkCommandsChangedAction extends Action {
+    type: typeof MARK_COMMANDS_CHANGED;
+    payload: string[];
+}
+export interface ClearChangedCommandsAction extends Action {
+    type: typeof CLEAR_CHANGED_COMMANDS;
+}
+export type CommandsAction = RegisterCommandAction | UnregisterCommandAction | MarkCommandsChangedAction | ClearChangedCommandsAction;
+export declare const registerCommand: (commandId: string) => RegisterCommandAction;
+export declare const unregisterCommand: (commandId: string) => UnregisterCommandAction;
+export declare const markCommandsChanged: (commandIds: string[]) => MarkCommandsChangedAction;
+export declare const clearChangedCommands: () => ClearChangedCommandsAction;

package/dist/lib/commands-plugin.d.ts

@@ -0,0 +1,31 @@
+import { BasePlugin, PluginRegistry } from '@embedpdf/core';
+import { CommandsCapability, CommandsPluginConfig, CommandsState } from './types';
+import { CommandsAction } from './actions';
+export declare class CommandsPlugin extends BasePlugin<CommandsPluginConfig, CommandsCapability, CommandsState, CommandsAction> {
+    static readonly id: "commands";
+    private commands;
+    private i18n;
+    private shortcutMap;
+    private readonly commandExecuted$;
+    private readonly commandStateChanged$;
+    private readonly shortcutExecuted$;
+    private previousStates;
+    constructor(id: string, registry: PluginRegistry, config: CommandsPluginConfig);
+    protected onDocumentClosed(documentId: string): void;
+    initialize(): Promise<void>;
+    destroy(): Promise<void>;
+    protected buildCapability(): CommandsCapability;
+    private createCommandScope;
+    private resolve;
+    private resolveLabel;
+    private resolveDynamic;
+    private execute;
+    private registerCommand;
+    private unregisterCommand;
+    private getCommandByShortcut;
+    private normalizeShortcut;
+    private getAllCommands;
+    private getCommandsByCategory;
+    private onGlobalStoreChange;
+    private detectCommandChanges;
+}

package/dist/lib/index.d.ts

@@ -0,0 +1,8 @@
+import { PluginPackage } from '@embedpdf/core';
+import { CommandsPluginConfig, CommandsState } from './types';
+import { CommandsPlugin } from './commands-plugin';
+import { CommandsAction } from './actions';
+export declare const CommandsPluginPackage: PluginPackage<CommandsPlugin, CommandsPluginConfig, CommandsState, CommandsAction>;
+export * from './commands-plugin';
+export * from './types';
+export * from './manifest';

package/dist/lib/manifest.d.ts

@@ -0,0 +1,4 @@
+import { PluginManifest } from '@embedpdf/core';
+import { CommandsPluginConfig } from './types';
+export declare const COMMANDS_PLUGIN_ID = "commands";
+export declare const manifest: PluginManifest<CommandsPluginConfig>;

package/dist/lib/reducer.d.ts

@@ -0,0 +1,5 @@
+import { Reducer } from '@embedpdf/core';
+import { CommandsState } from './types';
+import { CommandsAction } from './actions';
+export declare const initialState: CommandsState;
+export declare const commandsReducer: Reducer<CommandsState, CommandsAction>;