@embedpdf/plugin-commands 3.0.0-next.13 → 3.0.0-next.15

package/dist/standard.js

@@ -0,0 +1,242 @@
+import { DocumentsToken } from "@embedpdf/core";
+import { ActionsToken } from "@embedpdf/plugin-actions/contract";
+import { AnnotationToken } from "@embedpdf/plugin-annotation/contract";
+import { InteractionToken } from "@embedpdf/plugin-interaction/contract";
+import { SelectionToken } from "@embedpdf/plugin-selection/contract";
+import { StageToken } from "@embedpdf/plugin-stage/contract";
+//#region src/standard.ts
+/**
+* @embedpdf/plugin-commands/standard — the commands every viewer has: zoom,
+* pages, view rotation, a command for every tool, copy, delete, download and
+* print, with shortcuts, and labels in EmbedPDF's eight languages (the i18n
+* plugin has the strings). Three of them reach the browser (the clipboard, a
+* file download, the print dialog), which plugins never touch, so each
+* framework's `/commands` builds them with its platform: that is the
+* `standardCommands` an app imports.
+*/
+const stageOf = (context) => context.tryGet(StageToken);
+const interactionOf = (context) => context.tryGet(InteractionToken);
+/** Enabled while the document has a Stage. */
+const hasStage = (context) => stageOf(context) !== null;
+/** The ids of a tool list, made once per list, which keeps its identity while the tools don't change. */
+const toolIds = /* @__PURE__ */ new WeakMap();
+const idsOf = (tools) => {
+	let ids = toolIds.get(tools);
+	if (!ids) {
+		ids = tools.map((tool) => tool.id);
+		toolIds.set(tools, ids);
+	}
+	return ids;
+};
+/**
+* Whether the user may use a tool: one that draws annotations needs permission to create them.
+* A tool another plugin owns asks nothing here; that plugin refuses its own gesture.
+*/
+const mayUseTool = (context, toolId) => {
+	const annotation = context.tryGet(AnnotationToken);
+	return !annotation?.tools.get(toolId) || annotation.canCreate();
+};
+/** Switching to a tool: active while it's the tool, there only when the document has it. */
+const toolCommand = (toolId) => ({
+	labelKey: `commands.tool.${toolId}`,
+	label: toolId,
+	icon: toolId,
+	categories: ["tool"],
+	run: (context) => interactionOf(context)?.activateTool(toolId),
+	active: (context) => interactionOf(context)?.getActiveToolId() === toolId,
+	visible: (context) => interactionOf(context)?.hasTool(toolId) ?? false,
+	enabled: (context) => mayUseTool(context, toolId)
+});
+/** `tool:<id>` for every tool the document has. */
+const toolCommands = {
+	prefix: "tool:",
+	names: (context) => {
+		const interaction = interactionOf(context);
+		return interaction ? idsOf(interaction.listTools()) : [];
+	},
+	command: toolCommand
+};
+/** The standard commands, with the browser's part from `platform`. */
+function createStandardCommands(platform) {
+	return [
+		{
+			id: "zoom:in",
+			labelKey: "commands.zoom.in",
+			label: "Zoom in",
+			icon: "zoom-in",
+			shortcut: ["Mod+=", "Mod+NumpadAdd"],
+			categories: ["zoom"],
+			run: (context) => stageOf(context)?.zoomIn(),
+			enabled: hasStage
+		},
+		{
+			id: "zoom:out",
+			labelKey: "commands.zoom.out",
+			label: "Zoom out",
+			icon: "zoom-out",
+			shortcut: ["Mod+-", "Mod+NumpadSubtract"],
+			categories: ["zoom"],
+			run: (context) => stageOf(context)?.zoomOut(),
+			enabled: hasStage
+		},
+		{
+			id: "zoom:fit-width",
+			labelKey: "commands.zoom.fitWidth",
+			label: "Fit width",
+			icon: "fit-width",
+			categories: ["zoom"],
+			run: (context) => stageOf(context)?.fitWidth(),
+			active: (context) => stageOf(context)?.getZoomMode() === "fit-width",
+			enabled: hasStage
+		},
+		{
+			id: "zoom:fit-page",
+			labelKey: "commands.zoom.fitPage",
+			label: "Fit page",
+			icon: "fit-page",
+			categories: ["zoom"],
+			run: (context) => stageOf(context)?.fitPage(),
+			active: (context) => stageOf(context)?.getZoomMode() === "fit-page",
+			enabled: hasStage
+		},
+		{
+			id: "page:next",
+			labelKey: "commands.page.next",
+			label: "Next page",
+			icon: "next-page",
+			shortcut: "ArrowRight",
+			categories: ["page"],
+			run: (context) => stageOf(context)?.nextPage(),
+			enabled: (context) => stageOf(context)?.canGoNext() ?? false
+		},
+		{
+			id: "page:previous",
+			labelKey: "commands.page.previous",
+			label: "Previous page",
+			icon: "previous-page",
+			shortcut: "ArrowLeft",
+			categories: ["page"],
+			run: (context) => stageOf(context)?.previousPage(),
+			enabled: (context) => stageOf(context)?.canGoPrevious() ?? false
+		},
+		{
+			id: "page:first",
+			labelKey: "commands.page.first",
+			label: "First page",
+			icon: "first-page",
+			shortcut: "Home",
+			categories: ["page"],
+			run: (context) => stageOf(context)?.goToFirstPage(),
+			enabled: (context) => stageOf(context)?.canGoPrevious() ?? false
+		},
+		{
+			id: "page:last",
+			labelKey: "commands.page.last",
+			label: "Last page",
+			icon: "last-page",
+			shortcut: "End",
+			categories: ["page"],
+			run: (context) => stageOf(context)?.goToLastPage(),
+			enabled: (context) => stageOf(context)?.canGoNext() ?? false
+		},
+		{
+			id: "view:rotate-clockwise",
+			labelKey: "commands.view.rotateClockwise",
+			label: "Rotate clockwise",
+			icon: "rotate-clockwise",
+			categories: ["view"],
+			run: (context) => stageOf(context)?.rotateViewBy(90),
+			enabled: hasStage
+		},
+		{
+			id: "view:rotate-counterclockwise",
+			labelKey: "commands.view.rotateCounterclockwise",
+			label: "Rotate counterclockwise",
+			icon: "rotate-counterclockwise",
+			categories: ["view"],
+			run: (context) => stageOf(context)?.rotateViewBy(-90),
+			enabled: hasStage
+		},
+		{
+			...toolCommand("pointer"),
+			id: "tool:pointer",
+			shortcut: "V"
+		},
+		{
+			...toolCommand("pan"),
+			id: "tool:pan",
+			shortcut: "H"
+		},
+		toolCommands,
+		{
+			id: "selection:copy",
+			labelKey: "commands.selection.copy",
+			label: "Copy",
+			icon: "copy",
+			shortcut: "Mod+C",
+			categories: ["selection"],
+			run: (context) => platform.copySelection(context.get(SelectionToken)),
+			enabled: (context) => {
+				const selection = context.tryGet(SelectionToken);
+				return !!selection && selection.hasSelection() && selection.canCopy();
+			}
+		},
+		{
+			id: "annotation:delete",
+			labelKey: "commands.annotation.delete",
+			label: "Delete",
+			icon: "delete",
+			shortcut: ["Delete", "Backspace"],
+			categories: ["annotation"],
+			run: (context) => context.get(AnnotationToken).selection.delete({ signal: context.signal }),
+			enabled: (context) => {
+				const annotation = context.tryGet(AnnotationToken);
+				if (!annotation) return false;
+				const selected = annotation.selection.list();
+				return selected.length > 0 && selected.every(({ ref }) => annotation.canDelete(ref) && annotation.isEditable(ref));
+			}
+		},
+		{
+			id: "document:download",
+			labelKey: "commands.document.download",
+			label: "Download",
+			icon: "download",
+			shortcut: "Mod+S",
+			categories: ["document"],
+			allowed: (context) => context.tryGet(DocumentsToken)?.canDownload() ?? true,
+			notAllowedKey: "commands.notAllowed.doc-download",
+			run: async (context) => {
+				const documents = context.get(DocumentsToken);
+				const id = context.documentId ?? void 0;
+				const bytes = await documents.download(id, { signal: context.signal });
+				platform.saveFile(bytes, fileNameOf(documents.get(id)?.name));
+			},
+			enabled: (context) => context.documentId !== null
+		},
+		{
+			id: "document:print",
+			labelKey: "commands.document.print",
+			label: "Print",
+			icon: "print",
+			shortcut: "Mod+P",
+			categories: ["document"],
+			allowed: (context) => context.tryGet(DocumentsToken)?.canPrint() ?? true,
+			notAllowedKey: "commands.notAllowed.doc-print",
+			run: (context) => {
+				const actions = context.tryGet(ActionsToken);
+				if (actions) return actions.runDocumentVerb("print", () => platform.print());
+				platform.print();
+			},
+			enabled: (context) => context.documentId !== null
+		}
+	];
+}
+/** The download's file name: the document's name, ending in `.pdf`. */
+function fileNameOf(name) {
+	if (!name) return "document.pdf";
+	return /\.pdf$/i.test(name) ? name : `${name}.pdf`;
+}
+//#endregion
+export { createStandardCommands };
+
+//# sourceMappingURL=standard.js.map

package/dist/standard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard.js","names":[],"sources":["../src/standard.ts"],"sourcesContent":["/**\n * @embedpdf/plugin-commands/standard — the commands every viewer has: zoom,\n * pages, view rotation, a command for every tool, copy, delete, download and\n * print, with shortcuts, and labels in EmbedPDF's eight languages (the i18n\n * plugin has the strings). Three of them reach the browser (the clipboard, a\n * file download, the print dialog), which plugins never touch, so each\n * framework's `/commands` builds them with its platform: that is the\n * `standardCommands` an app imports.\n */\nimport { DocumentsToken } from '@embedpdf/core';\nimport { ActionsToken } from '@embedpdf/plugin-actions/contract';\nimport { AnnotationToken } from '@embedpdf/plugin-annotation/contract';\nimport { InteractionToken, type Tool } from '@embedpdf/plugin-interaction/contract';\nimport { SelectionToken, type SelectionCapability } from '@embedpdf/plugin-selection/contract';\nimport { StageToken } from '@embedpdf/plugin-stage/contract';\n\nimport type { CommandContext, CommandDef, CommandFamily } from './contract';\n\n/** What the standard commands need from the browser. */\nexport interface StandardCommandsPlatform {\n  /** Copy the selected text to the clipboard. */\n  copySelection(selection: SelectionCapability): Promise<unknown>;\n  /** Give the user the bytes as a file download. */\n  saveFile(bytes: Uint8Array, fileName: string): void;\n  /** Open the print dialog. */\n  print(): void;\n}\n\nconst stageOf = (context: CommandContext) => context.tryGet(StageToken);\nconst interactionOf = (context: CommandContext) => context.tryGet(InteractionToken);\n\n/** Enabled while the document has a Stage. */\nconst hasStage = (context: CommandContext): boolean => stageOf(context) !== null;\n\n/** The ids of a tool list, made once per list, which keeps its identity while the tools don't change. */\nconst toolIds = new WeakMap<readonly Tool[], readonly string[]>();\nconst idsOf = (tools: readonly Tool[]): readonly string[] => {\n  let ids = toolIds.get(tools);\n  if (!ids) {\n    ids = tools.map((tool) => tool.id);\n    toolIds.set(tools, ids);\n  }\n  return ids;\n};\n\n/**\n * Whether the user may use a tool: one that draws annotations needs permission to create them.\n * A tool another plugin owns asks nothing here; that plugin refuses its own gesture.\n */\nconst mayUseTool = (context: CommandContext, toolId: string): boolean => {\n  const annotation = context.tryGet(AnnotationToken);\n  return !annotation?.tools.get(toolId) || annotation.canCreate();\n};\n\n/** Switching to a tool: active while it's the tool, there only when the document has it. */\nconst toolCommand = (toolId: string): Omit<CommandDef, 'id' | 'shortcut'> => ({\n  labelKey: `commands.tool.${toolId}`,\n  label: toolId,\n  icon: toolId,\n  categories: ['tool'],\n  run: (context) => interactionOf(context)?.activateTool(toolId),\n  active: (context) => interactionOf(context)?.getActiveToolId() === toolId,\n  visible: (context) => interactionOf(context)?.hasTool(toolId) ?? false,\n  enabled: (context) => mayUseTool(context, toolId),\n});\n\n/** `tool:<id>` for every tool the document has. */\nconst toolCommands: CommandFamily = {\n  prefix: 'tool:',\n  names: (context) => {\n    const interaction = interactionOf(context);\n    return interaction ? idsOf(interaction.listTools()) : [];\n  },\n  command: toolCommand,\n};\n\n/** The standard commands, with the browser's part from `platform`. */\nexport function createStandardCommands(\n  platform: StandardCommandsPlatform,\n): readonly (CommandDef | CommandFamily)[] {\n  return [\n    // ── zoom ──\n    {\n      id: 'zoom:in',\n      labelKey: 'commands.zoom.in',\n      label: 'Zoom in',\n      icon: 'zoom-in',\n      shortcut: ['Mod+=', 'Mod+NumpadAdd'],\n      categories: ['zoom'],\n      run: (context) => stageOf(context)?.zoomIn(),\n      enabled: hasStage,\n    },\n    {\n      id: 'zoom:out',\n      labelKey: 'commands.zoom.out',\n      label: 'Zoom out',\n      icon: 'zoom-out',\n      shortcut: ['Mod+-', 'Mod+NumpadSubtract'],\n      categories: ['zoom'],\n      run: (context) => stageOf(context)?.zoomOut(),\n      enabled: hasStage,\n    },\n    {\n      id: 'zoom:fit-width',\n      labelKey: 'commands.zoom.fitWidth',\n      label: 'Fit width',\n      icon: 'fit-width',\n      categories: ['zoom'],\n      run: (context) => stageOf(context)?.fitWidth(),\n      active: (context) => stageOf(context)?.getZoomMode() === 'fit-width',\n      enabled: hasStage,\n    },\n    {\n      id: 'zoom:fit-page',\n      labelKey: 'commands.zoom.fitPage',\n      label: 'Fit page',\n      icon: 'fit-page',\n      categories: ['zoom'],\n      run: (context) => stageOf(context)?.fitPage(),\n      active: (context) => stageOf(context)?.getZoomMode() === 'fit-page',\n      enabled: hasStage,\n    },\n\n    // ── pages ──\n    {\n      id: 'page:next',\n      labelKey: 'commands.page.next',\n      label: 'Next page',\n      icon: 'next-page',\n      shortcut: 'ArrowRight',\n      categories: ['page'],\n      run: (context) => stageOf(context)?.nextPage(),\n      enabled: (context) => stageOf(context)?.canGoNext() ?? false,\n    },\n    {\n      id: 'page:previous',\n      labelKey: 'commands.page.previous',\n      label: 'Previous page',\n      icon: 'previous-page',\n      shortcut: 'ArrowLeft',\n      categories: ['page'],\n      run: (context) => stageOf(context)?.previousPage(),\n      enabled: (context) => stageOf(context)?.canGoPrevious() ?? false,\n    },\n    {\n      id: 'page:first',\n      labelKey: 'commands.page.first',\n      label: 'First page',\n      icon: 'first-page',\n      shortcut: 'Home',\n      categories: ['page'],\n      run: (context) => stageOf(context)?.goToFirstPage(),\n      enabled: (context) => stageOf(context)?.canGoPrevious() ?? false,\n    },\n    {\n      id: 'page:last',\n      labelKey: 'commands.page.last',\n      label: 'Last page',\n      icon: 'last-page',\n      shortcut: 'End',\n      categories: ['page'],\n      run: (context) => stageOf(context)?.goToLastPage(),\n      enabled: (context) => stageOf(context)?.canGoNext() ?? false,\n    },\n\n    // ── view rotation: how the pages show, nothing written to the PDF ──\n    {\n      id: 'view:rotate-clockwise',\n      labelKey: 'commands.view.rotateClockwise',\n      label: 'Rotate clockwise',\n      icon: 'rotate-clockwise',\n      categories: ['view'],\n      run: (context) => stageOf(context)?.rotateViewBy(90),\n      enabled: hasStage,\n    },\n    {\n      id: 'view:rotate-counterclockwise',\n      labelKey: 'commands.view.rotateCounterclockwise',\n      label: 'Rotate counterclockwise',\n      icon: 'rotate-counterclockwise',\n      categories: ['view'],\n      run: (context) => stageOf(context)?.rotateViewBy(-90),\n      enabled: hasStage,\n    },\n\n    // ── tools: the two built-in ones have shortcuts; the family covers every other ──\n    { ...toolCommand('pointer'), id: 'tool:pointer', shortcut: 'V' },\n    { ...toolCommand('pan'), id: 'tool:pan', shortcut: 'H' },\n    toolCommands,\n\n    // ── selections ──\n    {\n      id: 'selection:copy',\n      labelKey: 'commands.selection.copy',\n      label: 'Copy',\n      icon: 'copy',\n      shortcut: 'Mod+C',\n      categories: ['selection'],\n      run: (context) => platform.copySelection(context.get(SelectionToken)),\n      // `canCopy()` in `enabled`, not `allowed`: a refused command keeps its keys, and Mod+C\n      // with nothing selected in the viewer belongs to the page. The clipboard wiring says\n      // when a selection may not be copied.\n      enabled: (context) => {\n        const selection = context.tryGet(SelectionToken);\n        return !!selection && selection.hasSelection() && selection.canCopy();\n      },\n    },\n    {\n      id: 'annotation:delete',\n      labelKey: 'commands.annotation.delete',\n      label: 'Delete',\n      icon: 'delete',\n      shortcut: ['Delete', 'Backspace'],\n      categories: ['annotation'],\n      run: (context) => context.get(AnnotationToken).selection.delete({ signal: context.signal }),\n      enabled: (context) => {\n        const annotation = context.tryGet(AnnotationToken);\n        if (!annotation) return false;\n        const selected = annotation.selection.list();\n        // `isEditable`: the annotation plugin's `editable` setting lets people change it by hand.\n        return (\n          selected.length > 0 &&\n          selected.every(({ ref }) => annotation.canDelete(ref) && annotation.isEditable(ref))\n        );\n      },\n    },\n\n    // ── the document ──\n    {\n      id: 'document:download',\n      labelKey: 'commands.document.download',\n      label: 'Download',\n      icon: 'download',\n      shortcut: 'Mod+S',\n      categories: ['document'],\n      allowed: (context) => context.tryGet(DocumentsToken)?.canDownload() ?? true,\n      notAllowedKey: 'commands.notAllowed.doc-download',\n      run: async (context) => {\n        const documents = context.get(DocumentsToken);\n        const id = context.documentId ?? undefined;\n        const bytes = await documents.download(id, { signal: context.signal });\n        platform.saveFile(bytes, fileNameOf(documents.get(id)?.name));\n      },\n      enabled: (context) => context.documentId !== null,\n    },\n    {\n      id: 'document:print',\n      labelKey: 'commands.document.print',\n      label: 'Print',\n      icon: 'print',\n      shortcut: 'Mod+P',\n      categories: ['document'],\n      allowed: (context) => context.tryGet(DocumentsToken)?.canPrint() ?? true,\n      notAllowedKey: 'commands.notAllowed.doc-print',\n      // The document's own print actions run around the dialog when the\n      // actions plugin is there.\n      run: (context) => {\n        const actions = context.tryGet(ActionsToken);\n        if (actions) return actions.runDocumentVerb('print', () => platform.print());\n        platform.print();\n      },\n      enabled: (context) => context.documentId !== null,\n    },\n  ];\n}\n\n/** The download's file name: the document's name, ending in `.pdf`. */\nfunction fileNameOf(name: string | undefined): string {\n  if (!name) return 'document.pdf';\n  return /\\.pdf$/i.test(name) ? name : `${name}.pdf`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA4BA,MAAM,WAAW,YAA4B,QAAQ,OAAO,UAAU;AACtE,MAAM,iBAAiB,YAA4B,QAAQ,OAAO,gBAAgB;;AAGlF,MAAM,YAAY,YAAqC,QAAQ,OAAO,MAAM;;AAG5E,MAAM,0BAAU,IAAI,QAA4C;AAChE,MAAM,SAAS,UAA8C;CAC3D,IAAI,MAAM,QAAQ,IAAI,KAAK;CAC3B,IAAI,CAAC,KAAK;EACR,MAAM,MAAM,KAAK,SAAS,KAAK,EAAE;EACjC,QAAQ,IAAI,OAAO,GAAG;CACxB;CACA,OAAO;AACT;;;;;AAMA,MAAM,cAAc,SAAyB,WAA4B;CACvE,MAAM,aAAa,QAAQ,OAAO,eAAe;CACjD,OAAO,CAAC,YAAY,MAAM,IAAI,MAAM,KAAK,WAAW,UAAU;AAChE;;AAGA,MAAM,eAAe,YAAyD;CAC5E,UAAU,iBAAiB;CAC3B,OAAO;CACP,MAAM;CACN,YAAY,CAAC,MAAM;CACnB,MAAM,YAAY,cAAc,OAAO,CAAC,EAAE,aAAa,MAAM;CAC7D,SAAS,YAAY,cAAc,OAAO,CAAC,EAAE,gBAAgB,MAAM;CACnE,UAAU,YAAY,cAAc,OAAO,CAAC,EAAE,QAAQ,MAAM,KAAK;CACjE,UAAU,YAAY,WAAW,SAAS,MAAM;AAClD;;AAGA,MAAM,eAA8B;CAClC,QAAQ;CACR,QAAQ,YAAY;EAClB,MAAM,cAAc,cAAc,OAAO;EACzC,OAAO,cAAc,MAAM,YAAY,UAAU,CAAC,IAAI,CAAC;CACzD;CACA,SAAS;AACX;;AAGA,SAAgB,uBACd,UACyC;CACzC,OAAO;EAEL;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU,CAAC,SAAS,eAAe;GACnC,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,OAAO;GAC3C,SAAS;EACX;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU,CAAC,SAAS,oBAAoB;GACxC,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,QAAQ;GAC5C,SAAS;EACX;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,SAAS;GAC7C,SAAS,YAAY,QAAQ,OAAO,CAAC,EAAE,YAAY,MAAM;GACzD,SAAS;EACX;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,QAAQ;GAC5C,SAAS,YAAY,QAAQ,OAAO,CAAC,EAAE,YAAY,MAAM;GACzD,SAAS;EACX;EAGA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,SAAS;GAC7C,UAAU,YAAY,QAAQ,OAAO,CAAC,EAAE,UAAU,KAAK;EACzD;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,aAAa;GACjD,UAAU,YAAY,QAAQ,OAAO,CAAC,EAAE,cAAc,KAAK;EAC7D;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,cAAc;GAClD,UAAU,YAAY,QAAQ,OAAO,CAAC,EAAE,cAAc,KAAK;EAC7D;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,aAAa;GACjD,UAAU,YAAY,QAAQ,OAAO,CAAC,EAAE,UAAU,KAAK;EACzD;EAGA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,aAAa,EAAE;GACnD,SAAS;EACX;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,YAAY,CAAC,MAAM;GACnB,MAAM,YAAY,QAAQ,OAAO,CAAC,EAAE,aAAa,GAAG;GACpD,SAAS;EACX;EAGA;GAAE,GAAG,YAAY,SAAS;GAAG,IAAI;GAAgB,UAAU;EAAI;EAC/D;GAAE,GAAG,YAAY,KAAK;GAAG,IAAI;GAAY,UAAU;EAAI;EACvD;EAGA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,WAAW;GACxB,MAAM,YAAY,SAAS,cAAc,QAAQ,IAAI,cAAc,CAAC;GAIpE,UAAU,YAAY;IACpB,MAAM,YAAY,QAAQ,OAAO,cAAc;IAC/C,OAAO,CAAC,CAAC,aAAa,UAAU,aAAa,KAAK,UAAU,QAAQ;GACtE;EACF;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU,CAAC,UAAU,WAAW;GAChC,YAAY,CAAC,YAAY;GACzB,MAAM,YAAY,QAAQ,IAAI,eAAe,CAAC,CAAC,UAAU,OAAO,EAAE,QAAQ,QAAQ,OAAO,CAAC;GAC1F,UAAU,YAAY;IACpB,MAAM,aAAa,QAAQ,OAAO,eAAe;IACjD,IAAI,CAAC,YAAY,OAAO;IACxB,MAAM,WAAW,WAAW,UAAU,KAAK;IAE3C,OACE,SAAS,SAAS,KAClB,SAAS,OAAO,EAAE,UAAU,WAAW,UAAU,GAAG,KAAK,WAAW,WAAW,GAAG,CAAC;GAEvF;EACF;EAGA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,UAAU;GACvB,UAAU,YAAY,QAAQ,OAAO,cAAc,CAAC,EAAE,YAAY,KAAK;GACvE,eAAe;GACf,KAAK,OAAO,YAAY;IACtB,MAAM,YAAY,QAAQ,IAAI,cAAc;IAC5C,MAAM,KAAK,QAAQ,cAAc,KAAA;IACjC,MAAM,QAAQ,MAAM,UAAU,SAAS,IAAI,EAAE,QAAQ,QAAQ,OAAO,CAAC;IACrE,SAAS,SAAS,OAAO,WAAW,UAAU,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;GAC9D;GACA,UAAU,YAAY,QAAQ,eAAe;EAC/C;EACA;GACE,IAAI;GACJ,UAAU;GACV,OAAO;GACP,MAAM;GACN,UAAU;GACV,YAAY,CAAC,UAAU;GACvB,UAAU,YAAY,QAAQ,OAAO,cAAc,CAAC,EAAE,SAAS,KAAK;GACpE,eAAe;GAGf,MAAM,YAAY;IAChB,MAAM,UAAU,QAAQ,OAAO,YAAY;IAC3C,IAAI,SAAS,OAAO,QAAQ,gBAAgB,eAAe,SAAS,MAAM,CAAC;IAC3E,SAAS,MAAM;GACjB;GACA,UAAU,YAAY,QAAQ,eAAe;EAC/C;CACF;AACF;;AAGA,SAAS,WAAW,MAAkC;CACpD,IAAI,CAAC,MAAM,OAAO;CAClB,OAAO,UAAU,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK;AAC/C"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@embedpdf/plugin-commands",
-  "version": "3.0.0-next.13",
+  "version": "3.0.0-next.15",
   "private": false,
-  "description": "The command registry: the single vocabulary of verbs. Definitions are app content (mechanism/content split); state (label · icon · enabled · active · visible) derives purely from other capabilities, so every consumer is reactive through the kernel's one change stream — no events, no diffing.",
+  "description": "The commands: one name per action of the viewer, with its label, icon, state and shortcut, which toolbars, menus, a command palette and the keyboard all show and run. A command's state is read from live state, so every reader follows the kernel's one change stream. `/standard` has the commands every viewer has.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -16,16 +16,29 @@
       "import": "./dist/contract.js",
       "require": "./dist/contract.cjs"
     },
+    "./contract/host": {
+      "import": "./dist/contract/host.js",
+      "require": "./dist/contract/host.cjs"
+    },
+    "./standard": {
+      "import": "./dist/standard.js",
+      "require": "./dist/standard.cjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@embedpdf/core": "3.0.0-next.13",
-    "@embedpdf/plugin-shell": "3.0.0-next.13",
-    "@embedpdf/plugin-i18n": "3.0.0-next.13",
-    "@embedpdf/core-ui": "3.0.0-next.13"
+    "@embedpdf/core": "3.0.0-next.15",
+    "@embedpdf/core-ui": "3.0.0-next.15",
+    "@embedpdf/plugin-actions": "3.0.0-next.15",
+    "@embedpdf/plugin-annotation": "3.0.0-next.15",
+    "@embedpdf/plugin-i18n": "3.0.0-next.15",
+    "@embedpdf/plugin-interaction": "3.0.0-next.15",
+    "@embedpdf/plugin-shell": "3.0.0-next.15",
+    "@embedpdf/plugin-stage": "3.0.0-next.15",
+    "@embedpdf/plugin-selection": "3.0.0-next.15"
   },
   "devDependencies": {
     "typescript": "^5.0.0",

package/dist/contract-CSIfF6wC.d.cts

@@ -1,137 +0,0 @@
-import { CapabilityToken, CoreState } from "@embedpdf/core";
-import { KeyStroke } from "@embedpdf/core-ui";
-//#region src/types.d.ts
-/**
- * @embedpdf/plugin-commands — the contract.
- *
- * Commands are the single vocabulary of verbs: toolbars, menus, contextual
- * strips, shortcuts, and the palette are all projections of this registry.
- * The plugin ships ZERO commands (mechanism here, definitions in the product
- * — same split as plugin-i18n's locale packs).
- *
- * Command state is a pure DERIVATION over the store: `resolve()` reads other
- * capabilities' selectors at call time, so any store change is reflected on
- * the next read and the framework binding's one change stream makes every
- * consumer reactive. There is no CommandStateChangedEvent, no diffing, no
- * cache — v2's entire notification apparatus has no v3 equivalent because
- * the reactive store subsumes it.
- *
- * Definitions hold functions, so they live in the plugin's registry (config
- * + `register()`), never in the store; store state is only the serializable
- * `disabledCategories`.
- */
-/** What a derivation or `run` sees: capability resolution bound to the
- *  command's target document (explicit, else the active one). */
-interface CommandCtx {
-  /** The target document, or null when no document is open. */
-  readonly documentId: string | null;
-  core(): CoreState;
-  /** Resolve a capability; document-scoped tokens bind to the target document. */
-  get<T>(token: CapabilityToken<T>): T;
-  /** Like `get`, but null when unavailable (no provider / no document). */
-  tryGet<T>(token: CapabilityToken<T>): T | null;
-}
-/**
- * Up to two theme colors accompanying a command's icon — typed FACTS any
- * renderer can interpret (tint a glyph's slots, show a swatch), never
- * renderer props. The registry carries it the way it carries `icon`: as
- * data it doesn't interpret. Deliberately NOT v2's `iconProps` bag —
- * renderer-specific needs live app-side, joined by command id.
- */
-interface IconAccent {
-  /** The mark: stroke / markup / font color. */
-  readonly primary?: string;
-  /** The fill, when there is one. */
-  readonly secondary?: string;
-}
-interface CommandDef {
-  /** Convention: 'domain:verb' — 'zoom:in', 'mode:annotate', 'panel:search'. */
-  readonly id: string;
-  /** i18n key, resolved through I18nToken when present (else shown verbatim). */
-  readonly labelKey: string;
-  readonly icon?: string;
-  /** Live color accent for the icon (a tool previewing its drawing defaults).
-   *  A pure derivation over the store, exactly like `active`/`enabled`. */
-  readonly iconAccent?: (ctx: CommandCtx) => IconAccent | null;
-  /** 'Mod+K' style (ui-core grammar). Multiple bindings allowed. */
-  readonly shortcut?: string | readonly string[];
-  /** Feature-gating tags: a disabled category hides its commands everywhere. */
-  readonly categories?: readonly string[];
-  /** Toggles a named dropdown menu (a MenuSchema id in the app's chrome). */
-  readonly menu?: string;
-  /** Toggles a named shell surface, optionally exclusive within a tag ('left'…). */
-  readonly panel?: string | {
-    readonly id: string;
-    readonly exclusive?: string;
-  };
-  /** Toggles a modal surface (exclusive within the built-in 'modal' tag). */
-  readonly modal?: string;
-  readonly enabled?: (ctx: CommandCtx) => boolean;
-  readonly active?: (ctx: CommandCtx) => boolean;
-  readonly visible?: (ctx: CommandCtx) => boolean;
-  /** The verb. Optional for pure surface-target commands. Runs before the
-   *  default target routing when both are present. */
-  readonly run?: (ctx: CommandCtx) => void;
-}
-/** A command as a renderer sees it — everything resolved for the target document. */
-interface ResolvedCommand {
-  readonly id: string;
-  readonly label: string;
-  readonly icon?: string;
-  readonly iconAccent?: IconAccent;
-  readonly shortcuts: readonly string[];
-  readonly menu?: string;
-  readonly enabled: boolean;
-  readonly active: boolean;
-  readonly visible: boolean;
-  readonly categories: readonly string[];
-}
-/** Value equality over resolved commands — `resolve()` mints a fresh object
- *  per read, so reactive bindings memo by value to re-render on real change. */
-declare const resolvedCommandsEqual: (a: ResolvedCommand | null, b: ResolvedCommand | null) => boolean;
-interface CommandsState {
-  readonly disabledCategories: readonly string[];
-}
-type CommandsAction = {
-  type: 'COMMANDS/DISABLE_CATEGORY';
-  category: string;
-} | {
-  type: 'COMMANDS/ENABLE_CATEGORY';
-  category: string;
-} | {
-  type: 'COMMANDS/SET_DISABLED_CATEGORIES';
-  categories: readonly string[];
-};
-interface CommandsConfig {
-  /** The app's command definitions (content — the plugin ships none). */
-  commands?: readonly CommandDef[];
-  /** Categories disabled at startup (host feature-gating). */
-  disabledCategories?: readonly string[];
-}
-interface CommandsCapability {
-  register(def: CommandDef): void;
-  unregister(id: string): void;
-  has(id: string): boolean;
-  ids(): string[];
-  resolve(id: string, documentId?: string): ResolvedCommand | null;
-  /** Palette query: visible commands whose resolved label matches. */
-  search(query: string, documentId?: string): ResolvedCommand[];
-  /** The one fact the overflow projection needs (ResolveMenuTarget-shaped). */
-  menuTarget(id: string): {
-    menu?: string;
-  } | null;
-  execute(id: string, documentId?: string): void;
-  /** Match a keystroke against every registered shortcut → command id or null. */
-  matchStroke(stroke: KeyStroke, opts: {
-    isMac: boolean;
-  }): string | null;
-  disabledCategories(): readonly string[];
-  isCategoryDisabled(category: string): boolean;
-  disableCategory(category: string): void;
-  enableCategory(category: string): void;
-  setDisabledCategories(categories: readonly string[]): void;
-}
-declare const CommandsToken: CapabilityToken<CommandsCapability>;
-//#endregion
-export { CommandsConfig as a, IconAccent as c, CommandsCapability as i, ResolvedCommand as l, CommandDef as n, CommandsState as o, CommandsAction as r, CommandsToken as s, CommandCtx as t, resolvedCommandsEqual as u };
-//# sourceMappingURL=contract-CSIfF6wC.d.cts.map

package/dist/contract-CSIfF6wC.d.ts

@@ -1,137 +0,0 @@
-import { CapabilityToken, CoreState } from "@embedpdf/core";
-import { KeyStroke } from "@embedpdf/core-ui";
-//#region src/types.d.ts
-/**
- * @embedpdf/plugin-commands — the contract.
- *
- * Commands are the single vocabulary of verbs: toolbars, menus, contextual
- * strips, shortcuts, and the palette are all projections of this registry.
- * The plugin ships ZERO commands (mechanism here, definitions in the product
- * — same split as plugin-i18n's locale packs).
- *
- * Command state is a pure DERIVATION over the store: `resolve()` reads other
- * capabilities' selectors at call time, so any store change is reflected on
- * the next read and the framework binding's one change stream makes every
- * consumer reactive. There is no CommandStateChangedEvent, no diffing, no
- * cache — v2's entire notification apparatus has no v3 equivalent because
- * the reactive store subsumes it.
- *
- * Definitions hold functions, so they live in the plugin's registry (config
- * + `register()`), never in the store; store state is only the serializable
- * `disabledCategories`.
- */
-/** What a derivation or `run` sees: capability resolution bound to the
- *  command's target document (explicit, else the active one). */
-interface CommandCtx {
-  /** The target document, or null when no document is open. */
-  readonly documentId: string | null;
-  core(): CoreState;
-  /** Resolve a capability; document-scoped tokens bind to the target document. */
-  get<T>(token: CapabilityToken<T>): T;
-  /** Like `get`, but null when unavailable (no provider / no document). */
-  tryGet<T>(token: CapabilityToken<T>): T | null;
-}
-/**
- * Up to two theme colors accompanying a command's icon — typed FACTS any
- * renderer can interpret (tint a glyph's slots, show a swatch), never
- * renderer props. The registry carries it the way it carries `icon`: as
- * data it doesn't interpret. Deliberately NOT v2's `iconProps` bag —
- * renderer-specific needs live app-side, joined by command id.
- */
-interface IconAccent {
-  /** The mark: stroke / markup / font color. */
-  readonly primary?: string;
-  /** The fill, when there is one. */
-  readonly secondary?: string;
-}
-interface CommandDef {
-  /** Convention: 'domain:verb' — 'zoom:in', 'mode:annotate', 'panel:search'. */
-  readonly id: string;
-  /** i18n key, resolved through I18nToken when present (else shown verbatim). */
-  readonly labelKey: string;
-  readonly icon?: string;
-  /** Live color accent for the icon (a tool previewing its drawing defaults).
-   *  A pure derivation over the store, exactly like `active`/`enabled`. */
-  readonly iconAccent?: (ctx: CommandCtx) => IconAccent | null;
-  /** 'Mod+K' style (ui-core grammar). Multiple bindings allowed. */
-  readonly shortcut?: string | readonly string[];
-  /** Feature-gating tags: a disabled category hides its commands everywhere. */
-  readonly categories?: readonly string[];
-  /** Toggles a named dropdown menu (a MenuSchema id in the app's chrome). */
-  readonly menu?: string;
-  /** Toggles a named shell surface, optionally exclusive within a tag ('left'…). */
-  readonly panel?: string | {
-    readonly id: string;
-    readonly exclusive?: string;
-  };
-  /** Toggles a modal surface (exclusive within the built-in 'modal' tag). */
-  readonly modal?: string;
-  readonly enabled?: (ctx: CommandCtx) => boolean;
-  readonly active?: (ctx: CommandCtx) => boolean;
-  readonly visible?: (ctx: CommandCtx) => boolean;
-  /** The verb. Optional for pure surface-target commands. Runs before the
-   *  default target routing when both are present. */
-  readonly run?: (ctx: CommandCtx) => void;
-}
-/** A command as a renderer sees it — everything resolved for the target document. */
-interface ResolvedCommand {
-  readonly id: string;
-  readonly label: string;
-  readonly icon?: string;
-  readonly iconAccent?: IconAccent;
-  readonly shortcuts: readonly string[];
-  readonly menu?: string;
-  readonly enabled: boolean;
-  readonly active: boolean;
-  readonly visible: boolean;
-  readonly categories: readonly string[];
-}
-/** Value equality over resolved commands — `resolve()` mints a fresh object
- *  per read, so reactive bindings memo by value to re-render on real change. */
-declare const resolvedCommandsEqual: (a: ResolvedCommand | null, b: ResolvedCommand | null) => boolean;
-interface CommandsState {
-  readonly disabledCategories: readonly string[];
-}
-type CommandsAction = {
-  type: 'COMMANDS/DISABLE_CATEGORY';
-  category: string;
-} | {
-  type: 'COMMANDS/ENABLE_CATEGORY';
-  category: string;
-} | {
-  type: 'COMMANDS/SET_DISABLED_CATEGORIES';
-  categories: readonly string[];
-};
-interface CommandsConfig {
-  /** The app's command definitions (content — the plugin ships none). */
-  commands?: readonly CommandDef[];
-  /** Categories disabled at startup (host feature-gating). */
-  disabledCategories?: readonly string[];
-}
-interface CommandsCapability {
-  register(def: CommandDef): void;
-  unregister(id: string): void;
-  has(id: string): boolean;
-  ids(): string[];
-  resolve(id: string, documentId?: string): ResolvedCommand | null;
-  /** Palette query: visible commands whose resolved label matches. */
-  search(query: string, documentId?: string): ResolvedCommand[];
-  /** The one fact the overflow projection needs (ResolveMenuTarget-shaped). */
-  menuTarget(id: string): {
-    menu?: string;
-  } | null;
-  execute(id: string, documentId?: string): void;
-  /** Match a keystroke against every registered shortcut → command id or null. */
-  matchStroke(stroke: KeyStroke, opts: {
-    isMac: boolean;
-  }): string | null;
-  disabledCategories(): readonly string[];
-  isCategoryDisabled(category: string): boolean;
-  disableCategory(category: string): void;
-  enableCategory(category: string): void;
-  setDisabledCategories(categories: readonly string[]): void;
-}
-declare const CommandsToken: CapabilityToken<CommandsCapability>;
-//#endregion
-export { CommandsConfig as a, IconAccent as c, CommandsCapability as i, ResolvedCommand as l, CommandDef as n, CommandsState as o, CommandsAction as r, CommandsToken as s, CommandCtx as t, resolvedCommandsEqual as u };
-//# sourceMappingURL=contract-CSIfF6wC.d.ts.map

package/dist/contract-DYlaVyVk.cjs

@@ -1,25 +0,0 @@
-let _embedpdf_core = require("@embedpdf/core");
-//#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
-Object.defineProperty(exports, "CommandsToken", {
-	enumerable: true,
-	get: function() {
-		return CommandsToken;
-	}
-});
-Object.defineProperty(exports, "resolvedCommandsEqual", {
-	enumerable: true,
-	get: function() {
-		return resolvedCommandsEqual;
-	}
-});
-
-//# sourceMappingURL=contract-DYlaVyVk.cjs.map

package/dist/contract-DYlaVyVk.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract-DYlaVyVk.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["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"],"mappings":";;;;AAsGA,MAAa,yBACX,GACA,MACY;CACZ,IAAI,MAAM,GAAG,OAAO;CACpB,IAAI,CAAC,KAAK,CAAC,GAAG,OAAO;CACrB,OACE,EAAE,OAAO,EAAE,MACX,EAAE,UAAU,EAAE,SACd,EAAE,SAAS,EAAE,QAEb,EAAE,YAAY,YAAY,EAAE,YAAY,WACxC,EAAE,YAAY,cAAc,EAAE,YAAY,aAC1C,EAAE,SAAS,EAAE,QACb,EAAE,YAAY,EAAE,WAChB,EAAE,WAAW,EAAE,UACf,EAAE,YAAY,EAAE,WAChB,EAAE,UAAU,WAAW,EAAE,UAAU,UACnC,EAAE,UAAU,OAAO,GAAG,MAAM,MAAM,EAAE,UAAU,EAAE;AAEpD;AA6CA,MAAa,iBAAA,GAAA,eAAA,sBAAA,CAA0D,UAAU"}

package/dist/contract-UFgXphIQ.js

@@ -1,14 +0,0 @@
-import { createCapabilityToken } from "@embedpdf/core";
-//#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 = createCapabilityToken("commands");
-//#endregion
-export { resolvedCommandsEqual as n, CommandsToken as t };
-
-//# sourceMappingURL=contract-UFgXphIQ.js.map