@pixerate/editor 0.172.0 → 0.174.0

package/dist/chunk-NZ3CTY7K.js

@@ -0,0 +1,260 @@
+// ../markdown-conformance/manifest.json
+var manifest_default = {
+  $schema: "./schema/manifest.schema.json",
+  commands: [
+    {
+      id: "format.bold",
+      label: "Bold",
+      group: "Format",
+      shortcut: "Mod+B",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.italic",
+      label: "Italic",
+      group: "Format",
+      shortcut: "Mod+I",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.strikethrough",
+      label: "Strikethrough",
+      group: "Format",
+      shortcut: "Mod+Shift+X",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.code",
+      label: "Inline Code",
+      group: "Format",
+      shortcut: "Mod+E",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.link",
+      label: "Link\u2026",
+      group: "Format",
+      shortcut: "Mod+K",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          url: { type: ["string", "null"] }
+        }
+      }
+    },
+    {
+      id: "format.heading",
+      label: "Heading",
+      group: "Block",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          level: { type: "integer", minimum: 1, maximum: 6 }
+        },
+        required: ["level"]
+      },
+      shortcuts: {
+        "level=1": "Mod+Alt+1",
+        "level=2": "Mod+Alt+2",
+        "level=3": "Mod+Alt+3"
+      }
+    },
+    {
+      id: "format.paragraph",
+      label: "Paragraph",
+      group: "Block",
+      shortcut: "Mod+Alt+0",
+      surfaces: ["menu"]
+    },
+    {
+      id: "format.bulletList",
+      label: "Bullet List",
+      group: "Block",
+      shortcut: "Mod+Shift+8",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.numberedList",
+      label: "Numbered List",
+      group: "Block",
+      shortcut: "Mod+Shift+7",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.taskList",
+      label: "To-do List",
+      group: "Block",
+      shortcut: "Mod+Shift+9",
+      surfaces: ["menu"]
+    },
+    {
+      id: "format.quote",
+      label: "Quote",
+      group: "Block",
+      shortcut: "Mod+Shift+.",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.codeBlock",
+      label: "Code Block",
+      group: "Block",
+      shortcut: "Mod+Alt+C",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          language: { type: ["string", "null"] }
+        }
+      }
+    },
+    {
+      id: "format.table",
+      label: "Table",
+      group: "Insert",
+      surfaces: ["bubble"],
+      enabledWhen: ["inTable"]
+    }
+  ],
+  codeLanguages: [
+    { id: "javascript", label: "JavaScript", shortLabel: "JS" },
+    { id: "swift", label: "Swift" },
+    { id: "python", label: "Python" },
+    { id: "html", label: "HTML" },
+    { id: "css", label: "CSS" },
+    { id: "json", label: "JSON" },
+    { id: "bash", label: "Bash" }
+  ]
+};
+
+// src/commands/format.ts
+function formatCommandsFor(surface, manifest = manifest_default) {
+  return manifest.commands.filter((cmd) => cmd.surfaces?.includes(surface));
+}
+function createFormatCommands(editor, options = {}) {
+  const manifest = options.manifest ?? manifest_default;
+  const prefix = options.prefix ?? "format.";
+  const scope = options.scope ? { scope: options.scope } : {};
+  const shouldFocus = options.focus ?? true;
+  const withFocus = () => {
+    return shouldFocus ? editor.chain().focus() : editor.chain();
+  };
+  return manifest.commands.map((cmdDef) => {
+    const canonicalId = cmdDef.id.startsWith("format.") ? cmdDef.id.slice("format.".length) : cmdDef.id;
+    const id = `${prefix}${canonicalId}`;
+    let run;
+    let enabled;
+    switch (canonicalId) {
+      case "bold":
+        enabled = () => editor.can().toggleBold() ? true : "Cannot toggle bold at current selection.";
+        run = () => withFocus().toggleBold().run();
+        break;
+      case "italic":
+        enabled = () => editor.can().toggleItalic() ? true : "Cannot toggle italic at current selection.";
+        run = () => withFocus().toggleItalic().run();
+        break;
+      case "strikethrough":
+        enabled = () => editor.can().toggleStrike() ? true : "Cannot toggle strikethrough at current selection.";
+        run = () => withFocus().toggleStrike().run();
+        break;
+      case "code":
+        enabled = () => editor.can().toggleCode() ? true : "Cannot toggle inline code at current selection.";
+        run = () => withFocus().toggleCode().run();
+        break;
+      case "link":
+        enabled = (_ctx, p) => {
+          if (p?.url) {
+            return editor.can().setLink({ href: p.url }) ? true : "Cannot set link at current selection.";
+          }
+          return editor.can().unsetLink() || editor.can().setLink({ href: "https://example.com" }) ? true : "Cannot modify link at current selection.";
+        };
+        run = (_ctx, p) => {
+          if (p?.url) {
+            return withFocus().setLink({ href: p.url }).run();
+          }
+          return withFocus().unsetLink().run();
+        };
+        break;
+      case "heading":
+        enabled = (_ctx, p) => {
+          const level = p?.level;
+          if (level) {
+            return editor.can().toggleHeading({ level }) ? true : `Cannot toggle heading level ${level}.`;
+          }
+          return true;
+        };
+        run = (_ctx, p) => {
+          return withFocus().toggleHeading({ level: p.level }).run();
+        };
+        break;
+      case "paragraph":
+        enabled = () => editor.can().setParagraph() ? true : "Cannot set paragraph at current selection.";
+        run = () => withFocus().setParagraph().run();
+        break;
+      case "bulletList":
+        enabled = () => editor.can().toggleBulletList() ? true : "Cannot toggle bullet list at current selection.";
+        run = () => withFocus().toggleBulletList().run();
+        break;
+      case "numberedList":
+        enabled = () => editor.can().toggleOrderedList() ? true : "Cannot toggle numbered list at current selection.";
+        run = () => withFocus().toggleOrderedList().run();
+        break;
+      case "taskList":
+        enabled = () => editor.can().toggleTaskList() ? true : "Cannot toggle task list at current selection.";
+        run = () => withFocus().toggleTaskList().run();
+        break;
+      case "quote":
+        enabled = () => editor.can().toggleBlockquote() ? true : "Cannot toggle blockquote at current selection.";
+        run = () => withFocus().toggleBlockquote().run();
+        break;
+      case "codeBlock":
+        enabled = (_ctx, p) => {
+          const lang = p?.language;
+          if (editor.isActive("codeBlock")) {
+            return true;
+          }
+          return editor.can().toggleCodeBlock(lang ? { language: lang } : void 0) ? true : "Cannot toggle code block at current selection.";
+        };
+        run = (_ctx, p) => {
+          const lang = p?.language;
+          if (editor.isActive("codeBlock")) {
+            if (p !== void 0 && "language" in p) {
+              return withFocus().updateAttributes("codeBlock", { language: lang ?? null }).run();
+            }
+            return withFocus().toggleCodeBlock().run();
+          }
+          return withFocus().toggleCodeBlock(lang ? { language: lang } : void 0).run();
+        };
+        break;
+      case "table":
+        enabled = () => editor.isActive("table") ? true : "Not inside a table.";
+        run = () => {
+          return true;
+        };
+        break;
+      default:
+        enabled = () => true;
+        run = () => true;
+        break;
+    }
+    return {
+      id,
+      label: cmdDef.label,
+      group: cmdDef.group,
+      shortcut: cmdDef.shortcut,
+      ...cmdDef.params ? { params: cmdDef.params } : {},
+      ...scope,
+      enabled,
+      run
+    };
+  });
+}
+
+export {
+  formatCommandsFor,
+  createFormatCommands
+};

package/dist/{chunk-YN4AYYBJ.js → chunk-OZSA5YEJ.js}

@@ -7,7 +7,7 @@ import {
   EffectsSlot,
   createEffectPixels,
   effectValueErrors
-} from "./chunk-7KWJEYIK.js";
+} from "./chunk-6G2NLMVK.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";

package/dist/chunk-VCL7CB56.cjs

@@ -0,0 +1,260 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// ../markdown-conformance/manifest.json
+var manifest_default = {
+  $schema: "./schema/manifest.schema.json",
+  commands: [
+    {
+      id: "format.bold",
+      label: "Bold",
+      group: "Format",
+      shortcut: "Mod+B",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.italic",
+      label: "Italic",
+      group: "Format",
+      shortcut: "Mod+I",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.strikethrough",
+      label: "Strikethrough",
+      group: "Format",
+      shortcut: "Mod+Shift+X",
+      surfaces: ["bubble", "menu"],
+      enabledWhen: ["notInCode"]
+    },
+    {
+      id: "format.code",
+      label: "Inline Code",
+      group: "Format",
+      shortcut: "Mod+E",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.link",
+      label: "Link\u2026",
+      group: "Format",
+      shortcut: "Mod+K",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          url: { type: ["string", "null"] }
+        }
+      }
+    },
+    {
+      id: "format.heading",
+      label: "Heading",
+      group: "Block",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          level: { type: "integer", minimum: 1, maximum: 6 }
+        },
+        required: ["level"]
+      },
+      shortcuts: {
+        "level=1": "Mod+Alt+1",
+        "level=2": "Mod+Alt+2",
+        "level=3": "Mod+Alt+3"
+      }
+    },
+    {
+      id: "format.paragraph",
+      label: "Paragraph",
+      group: "Block",
+      shortcut: "Mod+Alt+0",
+      surfaces: ["menu"]
+    },
+    {
+      id: "format.bulletList",
+      label: "Bullet List",
+      group: "Block",
+      shortcut: "Mod+Shift+8",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.numberedList",
+      label: "Numbered List",
+      group: "Block",
+      shortcut: "Mod+Shift+7",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.taskList",
+      label: "To-do List",
+      group: "Block",
+      shortcut: "Mod+Shift+9",
+      surfaces: ["menu"]
+    },
+    {
+      id: "format.quote",
+      label: "Quote",
+      group: "Block",
+      shortcut: "Mod+Shift+.",
+      surfaces: ["bubble", "menu"]
+    },
+    {
+      id: "format.codeBlock",
+      label: "Code Block",
+      group: "Block",
+      shortcut: "Mod+Alt+C",
+      surfaces: ["bubble", "menu"],
+      params: {
+        type: "object",
+        properties: {
+          language: { type: ["string", "null"] }
+        }
+      }
+    },
+    {
+      id: "format.table",
+      label: "Table",
+      group: "Insert",
+      surfaces: ["bubble"],
+      enabledWhen: ["inTable"]
+    }
+  ],
+  codeLanguages: [
+    { id: "javascript", label: "JavaScript", shortLabel: "JS" },
+    { id: "swift", label: "Swift" },
+    { id: "python", label: "Python" },
+    { id: "html", label: "HTML" },
+    { id: "css", label: "CSS" },
+    { id: "json", label: "JSON" },
+    { id: "bash", label: "Bash" }
+  ]
+};
+
+// src/commands/format.ts
+function formatCommandsFor(surface, manifest = manifest_default) {
+  return manifest.commands.filter((cmd) => _optionalChain([cmd, 'access', _ => _.surfaces, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3(surface)]));
+}
+function createFormatCommands(editor, options = {}) {
+  const manifest = _nullishCoalesce(options.manifest, () => ( manifest_default));
+  const prefix = _nullishCoalesce(options.prefix, () => ( "format."));
+  const scope = options.scope ? { scope: options.scope } : {};
+  const shouldFocus = _nullishCoalesce(options.focus, () => ( true));
+  const withFocus = () => {
+    return shouldFocus ? editor.chain().focus() : editor.chain();
+  };
+  return manifest.commands.map((cmdDef) => {
+    const canonicalId = cmdDef.id.startsWith("format.") ? cmdDef.id.slice("format.".length) : cmdDef.id;
+    const id = `${prefix}${canonicalId}`;
+    let run;
+    let enabled;
+    switch (canonicalId) {
+      case "bold":
+        enabled = () => editor.can().toggleBold() ? true : "Cannot toggle bold at current selection.";
+        run = () => withFocus().toggleBold().run();
+        break;
+      case "italic":
+        enabled = () => editor.can().toggleItalic() ? true : "Cannot toggle italic at current selection.";
+        run = () => withFocus().toggleItalic().run();
+        break;
+      case "strikethrough":
+        enabled = () => editor.can().toggleStrike() ? true : "Cannot toggle strikethrough at current selection.";
+        run = () => withFocus().toggleStrike().run();
+        break;
+      case "code":
+        enabled = () => editor.can().toggleCode() ? true : "Cannot toggle inline code at current selection.";
+        run = () => withFocus().toggleCode().run();
+        break;
+      case "link":
+        enabled = (_ctx, p) => {
+          if (_optionalChain([p, 'optionalAccess', _4 => _4.url])) {
+            return editor.can().setLink({ href: p.url }) ? true : "Cannot set link at current selection.";
+          }
+          return editor.can().unsetLink() || editor.can().setLink({ href: "https://example.com" }) ? true : "Cannot modify link at current selection.";
+        };
+        run = (_ctx, p) => {
+          if (_optionalChain([p, 'optionalAccess', _5 => _5.url])) {
+            return withFocus().setLink({ href: p.url }).run();
+          }
+          return withFocus().unsetLink().run();
+        };
+        break;
+      case "heading":
+        enabled = (_ctx, p) => {
+          const level = _optionalChain([p, 'optionalAccess', _6 => _6.level]);
+          if (level) {
+            return editor.can().toggleHeading({ level }) ? true : `Cannot toggle heading level ${level}.`;
+          }
+          return true;
+        };
+        run = (_ctx, p) => {
+          return withFocus().toggleHeading({ level: p.level }).run();
+        };
+        break;
+      case "paragraph":
+        enabled = () => editor.can().setParagraph() ? true : "Cannot set paragraph at current selection.";
+        run = () => withFocus().setParagraph().run();
+        break;
+      case "bulletList":
+        enabled = () => editor.can().toggleBulletList() ? true : "Cannot toggle bullet list at current selection.";
+        run = () => withFocus().toggleBulletList().run();
+        break;
+      case "numberedList":
+        enabled = () => editor.can().toggleOrderedList() ? true : "Cannot toggle numbered list at current selection.";
+        run = () => withFocus().toggleOrderedList().run();
+        break;
+      case "taskList":
+        enabled = () => editor.can().toggleTaskList() ? true : "Cannot toggle task list at current selection.";
+        run = () => withFocus().toggleTaskList().run();
+        break;
+      case "quote":
+        enabled = () => editor.can().toggleBlockquote() ? true : "Cannot toggle blockquote at current selection.";
+        run = () => withFocus().toggleBlockquote().run();
+        break;
+      case "codeBlock":
+        enabled = (_ctx, p) => {
+          const lang = _optionalChain([p, 'optionalAccess', _7 => _7.language]);
+          if (editor.isActive("codeBlock")) {
+            return true;
+          }
+          return editor.can().toggleCodeBlock(lang ? { language: lang } : void 0) ? true : "Cannot toggle code block at current selection.";
+        };
+        run = (_ctx, p) => {
+          const lang = _optionalChain([p, 'optionalAccess', _8 => _8.language]);
+          if (editor.isActive("codeBlock")) {
+            if (p !== void 0 && "language" in p) {
+              return withFocus().updateAttributes("codeBlock", { language: _nullishCoalesce(lang, () => ( null)) }).run();
+            }
+            return withFocus().toggleCodeBlock().run();
+          }
+          return withFocus().toggleCodeBlock(lang ? { language: lang } : void 0).run();
+        };
+        break;
+      case "table":
+        enabled = () => editor.isActive("table") ? true : "Not inside a table.";
+        run = () => {
+          return true;
+        };
+        break;
+      default:
+        enabled = () => true;
+        run = () => true;
+        break;
+    }
+    return {
+      id,
+      label: cmdDef.label,
+      group: cmdDef.group,
+      shortcut: cmdDef.shortcut,
+      ...cmdDef.params ? { params: cmdDef.params } : {},
+      ...scope,
+      enabled,
+      run
+    };
+  });
+}
+
+
+
+
+exports.formatCommandsFor = formatCommandsFor; exports.createFormatCommands = createFormatCommands;

package/dist/{chunk-HCC2LBCW.js → chunk-WMVEYSOA.js}

@@ -3,7 +3,7 @@ import {
   EffectDisposedError,
   EffectUnsupportedError,
   effectValueErrors
-} from "./chunk-7KWJEYIK.js";
+} from "./chunk-6G2NLMVK.js";
 import {
   HistoryManager
 } from "./chunk-RNSANXPT.js";

package/dist/{chunk-3OSXHLIT.cjs → chunk-Z64NRDEH.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkRUZQMYXHcjs = require('./chunk-RUZQMYXH.cjs');
+var _chunkA3A5TI6Rcjs = require('./chunk-A3A5TI6R.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1307,12 +1307,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkRUZQMYXHcjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkA3A5TI6Rcjs.createEffectPixels.call(void 0, a.width, a.height);
   for (let i = 0; i < out.data.length; i++) out.data[i] = a.data[i] + (b.data[i] - a.data[i]) * k;
   return out;
 }
 function overEffectPixels(base, top, opacity = 1) {
-  const out = _chunkRUZQMYXHcjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkA3A5TI6Rcjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1357,7 +1357,7 @@ var VideoEffectsEngine = (_class2 = class {
   __init10() {this.generation = 0}
   
   constructor(options = {}) {;_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);
-    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkRUZQMYXHcjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkA3A5TI6Rcjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1499,7 +1499,7 @@ function checkVideoEffectPlace(d, place) {
   if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
     const where = place === "clip" ? "on a clip" : place === "transition" ? "as a transition" : "as an effect clip";
     const instead = d.uses.includes("transition") ? "set_video_effect_transition" : d.uses.some((u) => VIDEO_EFFECT_PLACES.generator.includes(u)) ? "add_video_effect_clip" : d.uses.some((u) => u === "filter") ? "apply_effect" : null;
-    throw new (0, _chunkRUZQMYXHcjs.EffectUnsupportedError)(
+    throw new (0, _chunkA3A5TI6Rcjs.EffectUnsupportedError)(
       `"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be used ${where}, which takes ${allowed.join(" or ")} effects${instead ? `; use ${instead} instead` : ""}. search_effects with use "${allowed[0]}" lists ones that fit.`,
       d.id
     );
@@ -1520,12 +1520,12 @@ function checkVideoEffectValues(d, values, options = {}) {
     else if (type !== "number" && type !== "integer") errors.push({ path: `/${k}`, message: "only number controls can be keyframed." });
     else for (const [i, key] of v.keys.entries()) for (const e of _chunkWOFXZ3XUcjs.validateJsonSchema.call(void 0, key.v, schema)) errors.push({ path: `/${k}/keys/${i}/v`, message: e.message });
   }
-  for (const e of _chunkRUZQMYXHcjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkA3A5TI6Rcjs.effectValueErrors.call(void 0, d, plain)) {
     const name = e.path.split("/")[1];
     const about = name && _optionalChain([d, 'access', _46 => _46.controls, 'access', _47 => _47.properties, 'access', _48 => _48[name], 'optionalAccess', _49 => _49.description]);
     errors.push(about ? { path: e.path, message: `${e.message} (${about})` } : e);
   }
-  if (errors.length) throw new (0, _chunkRUZQMYXHcjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkA3A5TI6Rcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/commands/format.d.cts

@@ -0,0 +1,43 @@
+import type { Editor } from '@tiptap/core';
+import type { CommandParamsSchema, CommandSpec } from './registry.cjs';
+import type { ShortcutInput } from './shortcuts.cjs';
+export interface FormatManifestCommand {
+    id: string;
+    label: string;
+    group?: string;
+    shortcut?: ShortcutInput;
+    shortcuts?: Record<string, string>;
+    surfaces?: readonly string[];
+    params?: CommandParamsSchema;
+    enabledWhen?: readonly string[];
+}
+export interface CodeLanguageOption {
+    id: string;
+    label: string;
+    shortLabel?: string;
+}
+export interface FormatManifest {
+    $schema?: string;
+    commands: readonly FormatManifestCommand[];
+    codeLanguages?: readonly CodeLanguageOption[];
+}
+export interface FormatCommandOptions {
+    /** Custom manifest or subset; defaults to the full manifest from `@pixerate/markdown-conformance`. */
+    manifest?: FormatManifest;
+    /** Id prefix (default `format.`). Commands in manifest matching this prefix will be stripped/remapped appropriately. */
+    prefix?: string;
+    /** Scope the commands belong to, e.g. `editor`. */
+    scope?: string;
+    /** Focus the editor when a command runs (default `true`). */
+    focus?: boolean;
+}
+/**
+ * Returns commands from a format manifest filtered for a specific UI surface
+ * (e.g. `'bubble'`, `'menu'`, `'palette'`, or `'keyboardBar'`).
+ */
+export declare function formatCommandsFor(surface: 'bubble' | 'menu' | 'palette' | 'keyboardBar' | string, manifest?: FormatManifest): FormatManifestCommand[];
+/**
+ * Creates format commands (`format.*`) registered from the format manifest in `@pixerate/markdown-conformance`.
+ * Commands can be placed in bubble menus, menus, keyboard bars, or palettes, or called programmatically by agent tools.
+ */
+export declare function createFormatCommands(editor: Editor, options?: FormatCommandOptions): CommandSpec[];

package/dist/commands/format.d.ts

@@ -0,0 +1,43 @@
+import type { Editor } from '@tiptap/core';
+import type { CommandParamsSchema, CommandSpec } from './registry.js';
+import type { ShortcutInput } from './shortcuts.js';
+export interface FormatManifestCommand {
+    id: string;
+    label: string;
+    group?: string;
+    shortcut?: ShortcutInput;
+    shortcuts?: Record<string, string>;
+    surfaces?: readonly string[];
+    params?: CommandParamsSchema;
+    enabledWhen?: readonly string[];
+}
+export interface CodeLanguageOption {
+    id: string;
+    label: string;
+    shortLabel?: string;
+}
+export interface FormatManifest {
+    $schema?: string;
+    commands: readonly FormatManifestCommand[];
+    codeLanguages?: readonly CodeLanguageOption[];
+}
+export interface FormatCommandOptions {
+    /** Custom manifest or subset; defaults to the full manifest from `@pixerate/markdown-conformance`. */
+    manifest?: FormatManifest;
+    /** Id prefix (default `format.`). Commands in manifest matching this prefix will be stripped/remapped appropriately. */
+    prefix?: string;
+    /** Scope the commands belong to, e.g. `editor`. */
+    scope?: string;
+    /** Focus the editor when a command runs (default `true`). */
+    focus?: boolean;
+}
+/**
+ * Returns commands from a format manifest filtered for a specific UI surface
+ * (e.g. `'bubble'`, `'menu'`, `'palette'`, or `'keyboardBar'`).
+ */
+export declare function formatCommandsFor(surface: 'bubble' | 'menu' | 'palette' | 'keyboardBar' | string, manifest?: FormatManifest): FormatManifestCommand[];
+/**
+ * Creates format commands (`format.*`) registered from the format manifest in `@pixerate/markdown-conformance`.
+ * Commands can be placed in bubble menus, menus, keyboard bars, or palettes, or called programmatically by agent tools.
+ */
+export declare function createFormatCommands(editor: Editor, options?: FormatCommandOptions): CommandSpec[];