@ecsplico/editor 3.6.0 → 4.0.0

package/dist/core/properties.js

@@ -0,0 +1,17 @@
+//#region src/core/properties.ts
+/** The value types of a Block property. */
+const PROPERTY_TYPES = [
+	"text",
+	"textarea",
+	"date",
+	"number",
+	"select",
+	"multiselect",
+	"reference",
+	"bibliography",
+	"derivation"
+];
+//#endregion
+export { PROPERTY_TYPES };
+
+//# sourceMappingURL=properties.js.map

package/dist/core/properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","names":[],"sources":["../../src/core/properties.ts"],"sourcesContent":["// Framework-free and server-importable: the one Property definition type. Block types (`properties` capability config), the\n// inspector, the AI context (`AiContextBlockType.fields`) and the server's request schemas all describe a Block property with it.\n\n/** The value types of a Block property. */\nexport const PROPERTY_TYPES = ['text', 'textarea', 'date', 'number', 'select', 'multiselect', 'reference', 'bibliography', 'derivation'] as const\n\n/** One Property definition: a Block property stored under `key` in the block's `meta` attribute. */\nexport interface PropertyDefinition {\n  key: string\n  label: string\n  /**\n   * `bibliography`: CSL-JSON item under `meta.bib`; `derivation`: read-only Derivation of a Derived block; `reference`: block id of another Typed block;\n   * `multiselect`: several of `options`, stored as `string[]` (the key is removed when none is chosen).\n   */\n  type: typeof PROPERTY_TYPES[number]\n  /** Choices of a `select` or `multiselect` property (required for `multiselect`). */\n  options?: { value: string, label: string }[]\n  /** `reference`: Block type ids the property may point to; absent = any Typed block. */\n  targets?: readonly string[]\n}\n"],"mappings":";;AAIA,MAAa,iBAAiB;CAAC;CAAQ;CAAY;CAAQ;CAAU;CAAU;CAAe;CAAa;CAAgB;AAAY"}

package/dist/core/schema/block-ids.js

@@ -20,10 +20,10 @@ const BLOCK_ID_TYPES = [
 	"file",
 	"horizontalRule",
 	"transcriptSegment",
-	"composite"
+	"typedBlock"
 ];
 /** The node types among `extensions` that carry a block ID: `editorBlock` declared, else built-in (same rule as `NodeFlags`). */
-const blockTypesOf = (extensions) => splitExtensions(extensions).nodeExtensions.filter((ext) => getExtensionField(ext, "editorBlock") ?? BLOCK_ID_TYPES.includes(ext.name)).map((ext) => ext.name);
+const nodeTypeNamesOf = (extensions) => splitExtensions(extensions).nodeExtensions.filter((ext) => getExtensionField(ext, "editorBlock") ?? BLOCK_ID_TYPES.includes(ext.name)).map((ext) => ext.name);
 const carriesId = (node) => node.type.spec.editorBlock === true;
 /** A fresh block ID (UUID v4; unlike `crypto.randomUUID()` also available outside secure contexts). */
 const newBlockId = () => v4();
@@ -109,17 +109,17 @@ const dedupeInserted = () => new Plugin({
 */
 const BlockId = UniqueID.extend({
 	addGlobalAttributes() {
-		this.options.types = blockTypesOf(this.extensions);
+		this.options.types = nodeTypeNamesOf(this.extensions);
 		return this.parent?.() ?? [];
 	},
 	onCreate(event) {
 		const { extensions } = this.editor.extensionManager;
 		if (extensions.some((ext) => ext.name === "collaboration")) return;
-		this.options.types = blockTypesOf(extensions);
+		this.options.types = nodeTypeNamesOf(extensions);
 		this.parent?.(event);
 	},
 	addProseMirrorPlugins() {
-		this.options.types = blockTypesOf(this.editor.extensionManager.extensions);
+		this.options.types = nodeTypeNamesOf(this.editor.extensionManager.extensions);
 		const plugins = this.parent?.() ?? [];
 		this.storage.needsInitialIdGeneration = false;
 		return [...plugins, dedupeInserted()];

package/dist/core/schema/block-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-ids.js","names":["uuidv4"],"sources":["../../../src/core/schema/block-ids.ts"],"sourcesContent":["import { combineTransactionSteps, findChildrenInRange, getChangedRanges, getExtensionField, splitExtensions } from '@tiptap/core'\nimport type { Extensions } from '@tiptap/core'\nimport { UniqueID } from '@tiptap/extension-unique-id'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { Transform } from '@tiptap/pm/transform'\nimport { v4 as uuidv4 } from 'uuid'\n\n/** Node attribute holding a block's stable ID; rendered as `data-id`. */\nexport const BLOCK_ID_ATTR = 'id'\n\n/** The built-in block types: every type that can be a top-level block (paragraphs nested in lists and quotes get one too). Other nodes opt in with `editorBlock: true`. */\nexport const BLOCK_ID_TYPES: readonly string[] = ['paragraph', 'heading', 'bulletList', 'orderedList', 'blockquote', 'codeBlock', 'image', 'audio', 'video', 'file', 'horizontalRule', 'transcriptSegment', 'composite']\n\n/** The node types among `extensions` that carry a block ID: `editorBlock` declared, else built-in (same rule as `NodeFlags`). */\nconst blockTypesOf = (extensions: Extensions): string[] => splitExtensions(extensions).nodeExtensions\n  .filter(ext => getExtensionField<boolean | undefined>(ext, 'editorBlock') ?? BLOCK_ID_TYPES.includes(ext.name))\n  .map(ext => ext.name)\n\n// `NodeFlags` copies `editorBlock` onto the spec; read it there (no import of node-flags: it imports this module).\nconst carriesId = (node: PMNode) => node.type.spec.editorBlock === true\n\n/** A fresh block ID (UUID v4; unlike `crypto.randomUUID()` also available outside secure contexts). */\nexport const newBlockId = (): string => uuidv4()\n\n/** The block ID of `node`; `null` for node types without IDs and for blocks that have none yet. */\nexport function blockIdOf(node: PMNode): string | null {\n  const id: unknown = carriesId(node) ? node.attrs[BLOCK_ID_ATTR] : null\n  return typeof id === 'string' && id ? id : null\n}\n\n/** The block with ID `id` (top-level or nested) and its position in `doc`, or `null`. */\nexport function findBlockById(doc: PMNode, id: string): { node: PMNode, pos: number } | null {\n  let found: { node: PMNode, pos: number } | null = null\n  doc.descendants((node, pos) => {\n    if (found) return false\n    if (blockIdOf(node) === id) found = { node, pos }\n    // Inline content never carries block IDs.\n    return !found && !node.isTextblock\n  })\n  return found\n}\n\n/**\n * `doc` with a fresh ID on every block that has none or repeats an earlier block's ID, or `null` when all IDs are\n * present and unique. For content no editor has touched: JSON seeds, Yjs state from before block IDs, server inserts.\n */\nexport function assignBlockIds(doc: PMNode): PMNode | null {\n  const tr = new Transform(doc)\n  const seen = new Set<string>()\n  doc.descendants((node, pos) => {\n    if (carriesId(node)) {\n      const id = blockIdOf(node)\n      if (id && !seen.has(id)) seen.add(id)\n      else tr.setNodeAttribute(pos, BLOCK_ID_ATTR, newBlockId()) // attribute steps keep all positions valid\n    }\n    return !node.isTextblock\n  })\n  return tr.docChanged ? tr.doc : null\n}\n\n/**\n * UniqueID only compares IDs within the changed ranges, so a block inserted with an ID that exists elsewhere in the\n * document (Alt-drop of a drag-handle drag, `insertContent` of a copied block's JSON) would keep the duplicate. This\n * gives such inserted blocks a fresh ID; the block that was already there keeps its own.\n */\nconst dedupeInserted = () => new Plugin({\n  key: new PluginKey('blockIdDedupe'),\n  appendTransaction(transactions, oldState, newState) {\n    // Remote Yjs changes carry the IDs their author assigned; rewriting them here would make clients diverge.\n    if (!transactions.some(tr => tr.docChanged) || transactions.some(tr => tr.getMeta('y-sync$'))) return\n    const transform = combineTransactionSteps(oldState.doc, [...transactions])\n    const inverse = transform.mapping.invert()\n    // Blocks that did not exist before (their start maps into content these transactions inserted), by position.\n    const inserted = new Map<number, string>()\n    for (const { newRange } of getChangedRanges(transform)) {\n      for (const { node, pos } of findChildrenInRange(newState.doc, newRange, carriesId)) {\n        const id = blockIdOf(node)\n        if (id && inverse.mapResult(pos).deleted) inserted.set(pos, id)\n      }\n    }\n    if (!inserted.size) return // typing and formatting end here, without walking the document\n    const total = new Map<string, number>()\n    const ofInserted = new Map<string, number>()\n    for (const id of inserted.values()) ofInserted.set(id, (ofInserted.get(id) ?? 0) + 1)\n    newState.doc.descendants((node) => {\n      const id = blockIdOf(node)\n      if (id && ofInserted.has(id)) total.set(id, (total.get(id) ?? 0) + 1)\n      return !node.isTextblock\n    })\n    const tr = newState.tr\n    const kept = new Set<string>()\n    for (const [pos, id] of [...inserted].sort(([a], [b]) => a - b)) {\n      if ((total.get(id) ?? 0) < 2) continue\n      // Only inserted copies of this ID (e.g. pasted twice in one go): the first one keeps it.\n      if (total.get(id) === ofInserted.get(id) && !kept.has(id)) {\n        kept.add(id)\n        continue\n      }\n      tr.setNodeAttribute(pos, BLOCK_ID_ATTR, newBlockId())\n    }\n    if (!tr.docChanged) return\n    // Steps reset the stored marks; UniqueID's meta keeps TrailingNode from reacting to this transaction.\n    return tr.setStoredMarks(newState.storedMarks).setMeta('__uniqueIDTransaction', true)\n  },\n})\n\n/**\n * Stable block IDs. `@tiptap/extension-unique-id` assigns IDs only in the local user's transactions: it skips\n * `y-sync$` (remote Yjs) transactions, gives the new half of a split a fresh ID (also the speaker segment's own Enter,\n * whose new half starts without an ID) and strips IDs from pasted and copy-dropped content. Part of\n * `schemaExtensions()`, so the server schema, the JSON mirror and the Yjs state carry the attribute.\n */\nexport const BlockId = UniqueID.extend({\n  // The ID-carrying types are the installed node extensions declaring `editorBlock` (built-ins default true).\n  // Upstream reads `options.types` synchronously in each hook below, so each hook resolves them from its own\n  // editor's extensions right before delegating: the configured options object is shared by every editor on the page.\n  addGlobalAttributes() {\n    this.options.types = blockTypesOf(this.extensions)\n    return this.parent?.() ?? []\n  },\n  onCreate(event) {\n    // Upstream backfills missing IDs on every client once the provider syncs, so two clients would race to give the\n    // same blocks different IDs. The server backfills in `onLoadDocument` instead, before any client syncs.\n    // A standalone editor (no Collaboration, content from JSON) is the only writer: upstream's immediate backfill.\n    const { extensions } = this.editor.extensionManager\n    if (extensions.some(ext => ext.name === 'collaboration')) return\n    this.options.types = blockTypesOf(extensions)\n    this.parent?.(event)\n  },\n  addProseMirrorPlugins() {\n    this.options.types = blockTypesOf(this.editor.extensionManager.extensions)\n    const plugins = this.parent?.() ?? []\n    // Same client-side backfill, for a Collaboration setup without a provider (on the first Yjs sync).\n    this.storage.needsInitialIdGeneration = false\n    return [...plugins, dedupeInserted()]\n  },\n}).configure({ attributeName: BLOCK_ID_ATTR, generateID: newBlockId })\n"],"mappings":"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"}
+{"version":3,"file":"block-ids.js","names":["uuidv4"],"sources":["../../../src/core/schema/block-ids.ts"],"sourcesContent":["import { combineTransactionSteps, findChildrenInRange, getChangedRanges, getExtensionField, splitExtensions } from '@tiptap/core'\nimport type { Extensions } from '@tiptap/core'\nimport { UniqueID } from '@tiptap/extension-unique-id'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { Transform } from '@tiptap/pm/transform'\nimport { v4 as uuidv4 } from 'uuid'\n\n/** Node attribute holding a block's stable ID; rendered as `data-id`. */\nexport const BLOCK_ID_ATTR = 'id'\n\n/** The built-in block types: every type that can be a top-level block (paragraphs nested in lists and quotes get one too). Other nodes opt in with `editorBlock: true`. */\nexport const BLOCK_ID_TYPES: readonly string[] = ['paragraph', 'heading', 'bulletList', 'orderedList', 'blockquote', 'codeBlock', 'image', 'audio', 'video', 'file', 'horizontalRule', 'transcriptSegment', 'typedBlock']\n\n/** The node types among `extensions` that carry a block ID: `editorBlock` declared, else built-in (same rule as `NodeFlags`). */\nconst nodeTypeNamesOf = (extensions: Extensions): string[] => splitExtensions(extensions).nodeExtensions\n  .filter(ext => getExtensionField<boolean | undefined>(ext, 'editorBlock') ?? BLOCK_ID_TYPES.includes(ext.name))\n  .map(ext => ext.name)\n\n// `NodeFlags` copies `editorBlock` onto the spec; read it there (no import of node-flags: it imports this module).\nconst carriesId = (node: PMNode) => node.type.spec.editorBlock === true\n\n/** A fresh block ID (UUID v4; unlike `crypto.randomUUID()` also available outside secure contexts). */\nexport const newBlockId = (): string => uuidv4()\n\n/** The block ID of `node`; `null` for node types without IDs and for blocks that have none yet. */\nexport function blockIdOf(node: PMNode): string | null {\n  const id: unknown = carriesId(node) ? node.attrs[BLOCK_ID_ATTR] : null\n  return typeof id === 'string' && id ? id : null\n}\n\n/** The block with ID `id` (top-level or nested) and its position in `doc`, or `null`. */\nexport function findBlockById(doc: PMNode, id: string): { node: PMNode, pos: number } | null {\n  let found: { node: PMNode, pos: number } | null = null\n  doc.descendants((node, pos) => {\n    if (found) return false\n    if (blockIdOf(node) === id) found = { node, pos }\n    // Inline content never carries block IDs.\n    return !found && !node.isTextblock\n  })\n  return found\n}\n\n/**\n * `doc` with a fresh ID on every block that has none or repeats an earlier block's ID, or `null` when all IDs are\n * present and unique. For content no editor has touched: JSON seeds, Yjs state from before block IDs, server inserts.\n */\nexport function assignBlockIds(doc: PMNode): PMNode | null {\n  const tr = new Transform(doc)\n  const seen = new Set<string>()\n  doc.descendants((node, pos) => {\n    if (carriesId(node)) {\n      const id = blockIdOf(node)\n      if (id && !seen.has(id)) seen.add(id)\n      else tr.setNodeAttribute(pos, BLOCK_ID_ATTR, newBlockId()) // attribute steps keep all positions valid\n    }\n    return !node.isTextblock\n  })\n  return tr.docChanged ? tr.doc : null\n}\n\n/**\n * UniqueID only compares IDs within the changed ranges, so a block inserted with an ID that exists elsewhere in the\n * document (Alt-drop of a drag-handle drag, `insertContent` of a copied block's JSON) would keep the duplicate. This\n * gives such inserted blocks a fresh ID; the block that was already there keeps its own.\n */\nconst dedupeInserted = () => new Plugin({\n  key: new PluginKey('blockIdDedupe'),\n  appendTransaction(transactions, oldState, newState) {\n    // Remote Yjs changes carry the IDs their author assigned; rewriting them here would make clients diverge.\n    if (!transactions.some(tr => tr.docChanged) || transactions.some(tr => tr.getMeta('y-sync$'))) return\n    const transform = combineTransactionSteps(oldState.doc, [...transactions])\n    const inverse = transform.mapping.invert()\n    // Blocks that did not exist before (their start maps into content these transactions inserted), by position.\n    const inserted = new Map<number, string>()\n    for (const { newRange } of getChangedRanges(transform)) {\n      for (const { node, pos } of findChildrenInRange(newState.doc, newRange, carriesId)) {\n        const id = blockIdOf(node)\n        if (id && inverse.mapResult(pos).deleted) inserted.set(pos, id)\n      }\n    }\n    if (!inserted.size) return // typing and formatting end here, without walking the document\n    const total = new Map<string, number>()\n    const ofInserted = new Map<string, number>()\n    for (const id of inserted.values()) ofInserted.set(id, (ofInserted.get(id) ?? 0) + 1)\n    newState.doc.descendants((node) => {\n      const id = blockIdOf(node)\n      if (id && ofInserted.has(id)) total.set(id, (total.get(id) ?? 0) + 1)\n      return !node.isTextblock\n    })\n    const tr = newState.tr\n    const kept = new Set<string>()\n    for (const [pos, id] of [...inserted].sort(([a], [b]) => a - b)) {\n      if ((total.get(id) ?? 0) < 2) continue\n      // Only inserted copies of this ID (e.g. pasted twice in one go): the first one keeps it.\n      if (total.get(id) === ofInserted.get(id) && !kept.has(id)) {\n        kept.add(id)\n        continue\n      }\n      tr.setNodeAttribute(pos, BLOCK_ID_ATTR, newBlockId())\n    }\n    if (!tr.docChanged) return\n    // Steps reset the stored marks; UniqueID's meta keeps TrailingNode from reacting to this transaction.\n    return tr.setStoredMarks(newState.storedMarks).setMeta('__uniqueIDTransaction', true)\n  },\n})\n\n/**\n * Stable block IDs. `@tiptap/extension-unique-id` assigns IDs only in the local user's transactions: it skips\n * `y-sync$` (remote Yjs) transactions, gives the new half of a split a fresh ID (also the speaker segment's own Enter,\n * whose new half starts without an ID) and strips IDs from pasted and copy-dropped content. Part of\n * `schemaExtensions()`, so the server schema, the JSON mirror and the Yjs state carry the attribute.\n */\nexport const BlockId = UniqueID.extend({\n  // The ID-carrying types are the installed node extensions declaring `editorBlock` (built-ins default true).\n  // Upstream reads `options.types` synchronously in each hook below, so each hook resolves them from its own\n  // editor's extensions right before delegating: the configured options object is shared by every editor on the page.\n  addGlobalAttributes() {\n    this.options.types = nodeTypeNamesOf(this.extensions)\n    return this.parent?.() ?? []\n  },\n  onCreate(event) {\n    // Upstream backfills missing IDs on every client once the provider syncs, so two clients would race to give the\n    // same blocks different IDs. The server backfills in `onLoadDocument` instead, before any client syncs.\n    // A standalone editor (no Collaboration, content from JSON) is the only writer: upstream's immediate backfill.\n    const { extensions } = this.editor.extensionManager\n    if (extensions.some(ext => ext.name === 'collaboration')) return\n    this.options.types = nodeTypeNamesOf(extensions)\n    this.parent?.(event)\n  },\n  addProseMirrorPlugins() {\n    this.options.types = nodeTypeNamesOf(this.editor.extensionManager.extensions)\n    const plugins = this.parent?.() ?? []\n    // Same client-side backfill, for a Collaboration setup without a provider (on the first Yjs sync).\n    this.storage.needsInitialIdGeneration = false\n    return [...plugins, dedupeInserted()]\n  },\n}).configure({ attributeName: BLOCK_ID_ATTR, generateID: newBlockId })\n"],"mappings":"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"}

package/dist/core/schema/index.d.ts

@@ -3,6 +3,7 @@ import { BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, assignBlockIds, blockIdOf, find
 import { HEX_COLOR } from "./hex-color.js";
 import "./mark-flags.js";
 import { NodeFlags, isBlockContainer, isChromeNode, isEditorBlock } from "./node-flags.js";
+import { BLOCK_TYPE_ATTR, OLD_HTML, PersistedNamesOptions, TYPED_BLOCK, TYPED_BLOCK_CLASS, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE, isOldPersistedNode, migratePersistedNames } from "./persisted-names.js";
 import { OpaqueFence } from "./opaque-fence.js";
 import { StrikeX } from "./strike.js";
 import { schemaExtensionsOf } from "./of-features.js";
@@ -44,5 +45,5 @@ export declare const coreSchemaExtensions: () => AnyExtension[];
 /** Content of a fresh, empty document. */
 export declare const EMPTY_EDITOR_CONTENT: JSONContent;
 //#endregion
-export { ABILITY, Ability, AbilityRule, AbilityRuleSource, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities, schemaExtensionsOf };
+export { ABILITY, Ability, AbilityRule, AbilityRuleSource, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BLOCK_TYPE_ATTR, BlockId, HEX_COLOR, NodeFlags, OLD_HTML, OpaqueFence, PersistedNamesOptions, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPED_BLOCK, TYPED_BLOCK_CLASS, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE, TYPE_ABILITIES, assignBlockIds, blockIdOf, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, isOldPersistedNode, migratePersistedNames, newBlockId, resolveAbilities, schemaExtensionsOf };
 //# sourceMappingURL=index.d.ts.map

package/dist/core/schema/index.js

@@ -1,6 +1,7 @@
 import { ABILITY, ROOT_ABILITIES, TEXT_ABILITIES, TYPE_ABILITIES, resolveAbilities } from "./abilities.js";
 import { BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, assignBlockIds, blockIdOf, findBlockById, newBlockId } from "./block-ids.js";
 import { NodeFlags, isBlockContainer, isChromeNode, isEditorBlock } from "./node-flags.js";
+import { BLOCK_TYPE_ATTR, OLD_HTML, TYPED_BLOCK, TYPED_BLOCK_CLASS, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE, isOldPersistedNode, migratePersistedNames } from "./persisted-names.js";
 import { OpaqueFence } from "./opaque-fence.js";
 import { StrikeX } from "./strike.js";
 import { HEX_COLOR } from "./hex-color.js";
@@ -50,6 +51,6 @@ const EMPTY_EDITOR_CONTENT = {
 	content: [{ type: "paragraph" }]
 };
 //#endregion
-export { ABILITY, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, EMPTY_EDITOR_CONTENT, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, coreContentSchemaExtensions, coreSchemaExtensions, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities, schemaExtensionsOf, starterKitOf };
+export { ABILITY, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BLOCK_TYPE_ATTR, BlockId, EMPTY_EDITOR_CONTENT, HEX_COLOR, NodeFlags, OLD_HTML, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPED_BLOCK, TYPED_BLOCK_CLASS, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE, TYPE_ABILITIES, assignBlockIds, blockIdOf, coreContentSchemaExtensions, coreSchemaExtensions, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, isOldPersistedNode, migratePersistedNames, newBlockId, resolveAbilities, schemaExtensionsOf, starterKitOf };
 
 //# sourceMappingURL=index.js.map

package/dist/core/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/core/schema/index.ts"],"sourcesContent":["import type { AnyExtension, JSONContent } from '@tiptap/core'\nimport StarterKit, { type StarterKitOptions } from '@tiptap/starter-kit'\nimport { BlockId } from './block-ids'\nimport { NodeFlags } from './node-flags'\nimport { OpaqueFence } from './opaque-fence'\nimport { StrikeX } from './strike'\n\nexport * from './abilities'\nexport * from './block-ids'\nexport * from './hex-color'\nexport * from './mark-flags'\nexport * from './node-flags'\nexport { OpaqueFence } from './opaque-fence'\nexport { StrikeX } from './strike'\nexport { schemaExtensionsOf } from './of-features'\n\n/**\n * Which optional StarterKit structures the content base installs; everything is on by default. A structure that is off\n * is not in the schema, in the editor and on the server alike (one options object feeds both).\n */\nexport interface CoreContentOptions {\n  /** `false`: no headings; `{ levels }`: only these heading levels. */\n  headings?: false | { levels: (1 | 2 | 3 | 4 | 5 | 6)[] }\n  /** `false`: no bullet or ordered lists (and list items). */\n  lists?: false\n  /** `false`: no blockquote. */\n  blockquote?: false\n  /** `false`: no code block. */\n  codeBlock?: false\n  /** `false`: no horizontal rule. */\n  rule?: false\n}\n\n/** The StarterKit options `options` stand for: the one mapping the editor feature and the schema-extension list share, so schemas cannot drift. */\nexport function starterKitOf(options: CoreContentOptions = {}): Partial<StarterKitOptions> {\n  const kit: Partial<StarterKitOptions> = {}\n  if (options.headings === false) kit.heading = false\n  else if (options.headings) kit.heading = { levels: options.headings.levels }\n  if (options.lists === false) Object.assign(kit, { bulletList: false, orderedList: false, listItem: false, listKeymap: false })\n  if (options.blockquote === false) kit.blockquote = false\n  if (options.codeBlock === false) kit.codeBlock = false\n  if (options.rule === false) kit.horizontalRule = false\n  return kit\n}\n\n/**\n * The Vue-free nodes and marks of the content base (`core-content` feature): StarterKit (history off: the surface enables\n * it for standalone editors, collaboration brings its own), StrikeX, the node-flags extension and `OpaqueFence` (Markdown\n * fences of unknown kinds, kept verbatim). `options` drop optional StarterKit structures. Without `BlockId`: `schemaExtensionsOf` appends it last.\n */\nexport const coreContentSchemaExtensions = (options: CoreContentOptions = {}): AnyExtension[] => [StarterKit.configure({ strike: false, undoRedo: false, ...starterKitOf(options) }), StrikeX, NodeFlags, OpaqueFence]\n\n/**\n * Base Vue-free nodes and marks of every editor: `coreContentSchemaExtensions()` and `BlockId`, which adds the `id`\n * attribute to every block type (its ID-assigning plugins only run in an editor). The server builds its schema from\n * these as well (`getSchema(...)`).\n */\nexport const coreSchemaExtensions = (): AnyExtension[] => [...coreContentSchemaExtensions(), BlockId]\n\n/** Content of a fresh, empty document. */\nexport const EMPTY_EDITOR_CONTENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,aAAa,UAA8B,CAAC,GAA+B;CACzF,MAAM,MAAkC,CAAC;CACzC,IAAI,QAAQ,aAAa,OAAO,IAAI,UAAU;MACzC,IAAI,QAAQ,UAAU,IAAI,UAAU,EAAE,QAAQ,QAAQ,SAAS,OAAO;CAC3E,IAAI,QAAQ,UAAU,OAAO,OAAO,OAAO,KAAK;EAAE,YAAY;EAAO,aAAa;EAAO,UAAU;EAAO,YAAY;CAAM,CAAC;CAC7H,IAAI,QAAQ,eAAe,OAAO,IAAI,aAAa;CACnD,IAAI,QAAQ,cAAc,OAAO,IAAI,YAAY;CACjD,IAAI,QAAQ,SAAS,OAAO,IAAI,iBAAiB;CACjD,OAAO;AACT;;;;;;AAOA,MAAa,+BAA+B,UAA8B,CAAC,MAAsB;CAAC,WAAW,UAAU;EAAE,QAAQ;EAAO,UAAU;EAAO,GAAG,aAAa,OAAO;CAAE,CAAC;CAAG;CAAS;CAAW;AAAW;;;;;;AAOrN,MAAa,6BAA6C,CAAC,GAAG,4BAA4B,GAAG,OAAO;;AAGpG,MAAa,uBAAoC;CAAE,MAAM;CAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;AAAE"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/core/schema/index.ts"],"sourcesContent":["import type { AnyExtension, JSONContent } from '@tiptap/core'\nimport StarterKit, { type StarterKitOptions } from '@tiptap/starter-kit'\nimport { BlockId } from './block-ids'\nimport { NodeFlags } from './node-flags'\nimport { OpaqueFence } from './opaque-fence'\nimport { StrikeX } from './strike'\n\nexport * from './abilities'\nexport * from './block-ids'\nexport * from './hex-color'\nexport * from './mark-flags'\nexport * from './node-flags'\nexport * from './persisted-names'\nexport { OpaqueFence } from './opaque-fence'\nexport { StrikeX } from './strike'\nexport { schemaExtensionsOf } from './of-features'\n\n/**\n * Which optional StarterKit structures the content base installs; everything is on by default. A structure that is off\n * is not in the schema, in the editor and on the server alike (one options object feeds both).\n */\nexport interface CoreContentOptions {\n  /** `false`: no headings; `{ levels }`: only these heading levels. */\n  headings?: false | { levels: (1 | 2 | 3 | 4 | 5 | 6)[] }\n  /** `false`: no bullet or ordered lists (and list items). */\n  lists?: false\n  /** `false`: no blockquote. */\n  blockquote?: false\n  /** `false`: no code block. */\n  codeBlock?: false\n  /** `false`: no horizontal rule. */\n  rule?: false\n}\n\n/** The StarterKit options `options` stand for: the one mapping the editor feature and the schema-extension list share, so schemas cannot drift. */\nexport function starterKitOf(options: CoreContentOptions = {}): Partial<StarterKitOptions> {\n  const kit: Partial<StarterKitOptions> = {}\n  if (options.headings === false) kit.heading = false\n  else if (options.headings) kit.heading = { levels: options.headings.levels }\n  if (options.lists === false) Object.assign(kit, { bulletList: false, orderedList: false, listItem: false, listKeymap: false })\n  if (options.blockquote === false) kit.blockquote = false\n  if (options.codeBlock === false) kit.codeBlock = false\n  if (options.rule === false) kit.horizontalRule = false\n  return kit\n}\n\n/**\n * The Vue-free nodes and marks of the content base (`core-content` feature): StarterKit (history off: the surface enables\n * it for standalone editors, collaboration brings its own), StrikeX, the node-flags extension and `OpaqueFence` (Markdown\n * fences of unknown kinds, kept verbatim). `options` drop optional StarterKit structures. Without `BlockId`: `schemaExtensionsOf` appends it last.\n */\nexport const coreContentSchemaExtensions = (options: CoreContentOptions = {}): AnyExtension[] => [StarterKit.configure({ strike: false, undoRedo: false, ...starterKitOf(options) }), StrikeX, NodeFlags, OpaqueFence]\n\n/**\n * Base Vue-free nodes and marks of every editor: `coreContentSchemaExtensions()` and `BlockId`, which adds the `id`\n * attribute to every block type (its ID-assigning plugins only run in an editor). The server builds its schema from\n * these as well (`getSchema(...)`).\n */\nexport const coreSchemaExtensions = (): AnyExtension[] => [...coreContentSchemaExtensions(), BlockId]\n\n/** Content of a fresh, empty document. */\nexport const EMPTY_EDITOR_CONTENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n"],"mappings":";;;;;;;;;;;AAmCA,SAAgB,aAAa,UAA8B,CAAC,GAA+B;CACzF,MAAM,MAAkC,CAAC;CACzC,IAAI,QAAQ,aAAa,OAAO,IAAI,UAAU;MACzC,IAAI,QAAQ,UAAU,IAAI,UAAU,EAAE,QAAQ,QAAQ,SAAS,OAAO;CAC3E,IAAI,QAAQ,UAAU,OAAO,OAAO,OAAO,KAAK;EAAE,YAAY;EAAO,aAAa;EAAO,UAAU;EAAO,YAAY;CAAM,CAAC;CAC7H,IAAI,QAAQ,eAAe,OAAO,IAAI,aAAa;CACnD,IAAI,QAAQ,cAAc,OAAO,IAAI,YAAY;CACjD,IAAI,QAAQ,SAAS,OAAO,IAAI,iBAAiB;CACjD,OAAO;AACT;;;;;;AAOA,MAAa,+BAA+B,UAA8B,CAAC,MAAsB;CAAC,WAAW,UAAU;EAAE,QAAQ;EAAO,UAAU;EAAO,GAAG,aAAa,OAAO;CAAE,CAAC;CAAG;CAAS;CAAW;AAAW;;;;;;AAOrN,MAAa,6BAA6C,CAAC,GAAG,4BAA4B,GAAG,OAAO;;AAGpG,MAAa,uBAAoC;CAAE,MAAM;CAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;AAAE"}

package/dist/core/schema/opaque-fence.d.ts

@@ -1,10 +1,10 @@
 import { Node } from "@tiptap/core";
 //#region src/core/schema/opaque-fence.d.ts
 /**
- * A `::: kind` … `:::` fence of a kind the editor has no node for (kinds a composite feature registers parse into
- * composites first). The fence's source text is kept in `raw` and written back byte for byte, so documents with fences
- * of other tools survive a round trip; the editor shows it as read-only text block, and source mode edits it. `kind`
- * is the word after the opening colons.
+ * A `::: <block type id>` … `:::` fence of a Block type the editor has no node for (Block types a typed-block feature
+ * registers parse into Typed blocks first). The fence's source text is kept in `raw` and written back byte for byte, so
+ * documents with fences of other tools survive a round trip; the editor shows it as read-only text block, and source mode
+ * edits it. `blockType` is the word after the opening colons.
  */
 export declare const OpaqueFence: Node<any, any>;
 //#endregion

package/dist/core/schema/opaque-fence.js

@@ -1,10 +1,10 @@
 import { Node } from "@tiptap/core";
 //#region src/core/schema/opaque-fence.ts
 /**
-* A `::: kind` … `:::` fence of a kind the editor has no node for (kinds a composite feature registers parse into
-* composites first). The fence's source text is kept in `raw` and written back byte for byte, so documents with fences
-* of other tools survive a round trip; the editor shows it as read-only text block, and source mode edits it. `kind`
-* is the word after the opening colons.
+* A `::: <block type id>` … `:::` fence of a Block type the editor has no node for (Block types a typed-block feature
+* registers parse into Typed blocks first). The fence's source text is kept in `raw` and written back byte for byte, so
+* documents with fences of other tools survive a round trip; the editor shows it as read-only text block, and source mode
+* edits it. `blockType` is the word after the opening colons.
 */
 const OpaqueFence = Node.create({
 	name: "opaqueFence",
@@ -19,7 +19,7 @@ const OpaqueFence = Node.create({
 				default: "",
 				rendered: false
 			},
-			kind: {
+			blockType: {
 				default: null,
 				rendered: false
 			}
@@ -31,7 +31,7 @@ const OpaqueFence = Node.create({
 			priority: 60,
 			getAttrs: (element) => ({
 				raw: element.textContent ?? "",
-				kind: element.getAttribute("data-opaque-fence") || null
+				blockType: element.getAttribute("data-opaque-fence") || null
 			})
 		}];
 	},
@@ -39,7 +39,7 @@ const OpaqueFence = Node.create({
 		return [
 			"pre",
 			{
-				"data-opaque-fence": node.attrs.kind ?? "",
+				"data-opaque-fence": node.attrs.blockType ?? "",
 				class: "sk-opaque-fence"
 			},
 			[

package/dist/core/schema/opaque-fence.js.map

@@ -1 +1 @@
-{"version":3,"file":"opaque-fence.js","names":[],"sources":["../../../src/core/schema/opaque-fence.ts"],"sourcesContent":["import { Node } from '@tiptap/core'\n\n/**\n * A `::: kind` … `:::` fence of a kind the editor has no node for (kinds a composite feature registers parse into\n * composites first). The fence's source text is kept in `raw` and written back byte for byte, so documents with fences\n * of other tools survive a round trip; the editor shows it as read-only text block, and source mode edits it. `kind`\n * is the word after the opening colons.\n */\nexport const OpaqueFence = Node.create({\n  name: 'opaqueFence',\n  group: 'block',\n  atom: true,\n  selectable: true,\n  draggable: true,\n  editorBlock: true,\n\n  addAttributes() {\n    return {\n      raw: { default: '', rendered: false },\n      kind: { default: null, rendered: false },\n    }\n  },\n\n  parseHTML() {\n    return [{\n      tag: 'pre[data-opaque-fence]',\n      priority: 60,\n      getAttrs: element => ({ raw: element.textContent ?? '', kind: element.getAttribute('data-opaque-fence') || null }),\n    }]\n  },\n\n  renderHTML({ node }) {\n    // The text sits in a `code` child: ProseMirror's own sheet sets `white-space: normal` on every non-editable element, which a rule on the `pre` cannot beat.\n    return ['pre', { 'data-opaque-fence': node.attrs.kind ?? '', class: 'sk-opaque-fence' }, ['code', {}, String(node.attrs.raw ?? '')]]\n  },\n\n  renderMarkdown: node => String(node.attrs?.raw ?? ''),\n})\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAc,KAAK,OAAO;CACrC,MAAM;CACN,OAAO;CACP,MAAM;CACN,YAAY;CACZ,WAAW;CACX,aAAa;CAEb,gBAAgB;EACd,OAAO;GACL,KAAK;IAAE,SAAS;IAAI,UAAU;GAAM;GACpC,MAAM;IAAE,SAAS;IAAM,UAAU;GAAM;EACzC;CACF;CAEA,YAAY;EACV,OAAO,CAAC;GACN,KAAK;GACL,UAAU;GACV,WAAU,aAAY;IAAE,KAAK,QAAQ,eAAe;IAAI,MAAM,QAAQ,aAAa,mBAAmB,KAAK;GAAK;EAClH,CAAC;CACH;CAEA,WAAW,EAAE,QAAQ;EAEnB,OAAO;GAAC;GAAO;IAAE,qBAAqB,KAAK,MAAM,QAAQ;IAAI,OAAO;GAAkB;GAAG;IAAC;IAAQ,CAAC;IAAG,OAAO,KAAK,MAAM,OAAO,EAAE;GAAC;EAAC;CACrI;CAEA,iBAAgB,SAAQ,OAAO,KAAK,OAAO,OAAO,EAAE;AACtD,CAAC"}
+{"version":3,"file":"opaque-fence.js","names":[],"sources":["../../../src/core/schema/opaque-fence.ts"],"sourcesContent":["import { Node } from '@tiptap/core'\n\n/**\n * A `::: <block type id>` … `:::` fence of a Block type the editor has no node for (Block types a typed-block feature\n * registers parse into Typed blocks first). The fence's source text is kept in `raw` and written back byte for byte, so\n * documents with fences of other tools survive a round trip; the editor shows it as read-only text block, and source mode\n * edits it. `blockType` is the word after the opening colons.\n */\nexport const OpaqueFence = Node.create({\n  name: 'opaqueFence',\n  group: 'block',\n  atom: true,\n  selectable: true,\n  draggable: true,\n  editorBlock: true,\n\n  addAttributes() {\n    return {\n      raw: { default: '', rendered: false },\n      blockType: { default: null, rendered: false },\n    }\n  },\n\n  parseHTML() {\n    return [{\n      tag: 'pre[data-opaque-fence]',\n      priority: 60,\n      getAttrs: element => ({ raw: element.textContent ?? '', blockType: element.getAttribute('data-opaque-fence') || null }),\n    }]\n  },\n\n  renderHTML({ node }) {\n    // The text sits in a `code` child: ProseMirror's own sheet sets `white-space: normal` on every non-editable element, which a rule on the `pre` cannot beat.\n    return ['pre', { 'data-opaque-fence': node.attrs.blockType ?? '', class: 'sk-opaque-fence' }, ['code', {}, String(node.attrs.raw ?? '')]]\n  },\n\n  renderMarkdown: node => String(node.attrs?.raw ?? ''),\n})\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAc,KAAK,OAAO;CACrC,MAAM;CACN,OAAO;CACP,MAAM;CACN,YAAY;CACZ,WAAW;CACX,aAAa;CAEb,gBAAgB;EACd,OAAO;GACL,KAAK;IAAE,SAAS;IAAI,UAAU;GAAM;GACpC,WAAW;IAAE,SAAS;IAAM,UAAU;GAAM;EAC9C;CACF;CAEA,YAAY;EACV,OAAO,CAAC;GACN,KAAK;GACL,UAAU;GACV,WAAU,aAAY;IAAE,KAAK,QAAQ,eAAe;IAAI,WAAW,QAAQ,aAAa,mBAAmB,KAAK;GAAK;EACvH,CAAC;CACH;CAEA,WAAW,EAAE,QAAQ;EAEnB,OAAO;GAAC;GAAO;IAAE,qBAAqB,KAAK,MAAM,aAAa;IAAI,OAAO;GAAkB;GAAG;IAAC;IAAQ,CAAC;IAAG,OAAO,KAAK,MAAM,OAAO,EAAE;GAAC;EAAC;CAC1I;CAEA,iBAAgB,SAAQ,OAAO,KAAK,OAAO,OAAO,EAAE;AACtD,CAAC"}

package/dist/core/schema/persisted-names.d.ts

@@ -0,0 +1,58 @@
+import { JSONContent } from "@tiptap/core";
+//#region src/core/schema/persisted-names.d.ts
+/**
+ * The persisted names of Typed blocks before the vocabulary of `CONTEXT.md` (Typed block, Block type) replaced them, and
+ * the one load-time migration that maps them to the current names. Stored documents (JSON store, Yjs state, `.cdoc`
+ * packages, Markdown-free clipboard and drag payloads) written by earlier releases carry them; the rule is: old names are
+ * READ wherever content enters and never written. Nothing else in the code base spells them.
+ *
+ * Nodes: `composite` -> `typedBlock`, with the chrome nodes `compositeTitle`/`compositeDescription`/`compositeTags` ->
+ * `typedBlockTitle`/`typedBlockDescription`/`typedBlockTags`; with `options.earliest` also the single-purpose `section`
+ * family of the earliest dev releases (`section`, `sectionTitle`, `sectionSummary`, `sectionTags`), which maps to the same
+ * targets (a `section` becomes a Typed block of Block type `section`). Attribute: `kind` -> `blockType` on a Typed block and on an `opaqueFence`.
+ */
+/** Node name of a Typed block. */
+export declare const TYPED_BLOCK = "typedBlock";
+export declare const TYPED_BLOCK_TITLE = "typedBlockTitle";
+export declare const TYPED_BLOCK_DESCRIPTION = "typedBlockDescription";
+export declare const TYPED_BLOCK_TAGS = "typedBlockTags";
+/**
+ * CSS class of a Typed block's node view root (`section.composite`). Styling, not a persisted name: the shipped sheets, the
+ * chrome anchors (`compositeSectionOf`) and host themes select `.composite`, as they did before the rename. It is spelled
+ * here because `legacy-names` lets this file (and only this file) quote the word; the BEM children `composite__toggle` and
+ * `composite__content` and the title class `composite-title` are no bare quoted name and need no entry. The HTML node
+ * name stays `data-type="typedBlock"`.
+ */
+export declare const TYPED_BLOCK_CLASS = "composite";
+/** Attribute that holds the id of a Typed block's (and an opaque fence's) Block type. */
+export declare const BLOCK_TYPE_ATTR = "blockType";
+export interface PersistedNamesOptions {
+  /** Also map the earliest `section` family (content of an editor with Typed blocks). Default `false`. */
+  earliest?: boolean;
+}
+/** The HTML names markup written before the rename carries; the node parse rules read them, nothing writes them (the Markdown fence needs no entry: its keyword is a Block type id and did not change). */
+export declare const OLD_HTML: {
+  readonly typedBlock: "composite";
+  readonly title: "composite-title";
+  readonly description: "composite-description";
+  readonly tags: "composite-tags";
+  /** The earliest dev releases' single-purpose `section` family: element `data-type`s of the block and its title, summary and tags. */
+  readonly earliestBlock: "section";
+  readonly earliestTitle: "section-title";
+  readonly earliestDescription: "section-summary";
+  readonly earliestTags: "section-tags";
+  /** Attribute of the Block type id on the Typed block's element. */
+  readonly blockTypeAttr: "data-kind";
+};
+/**
+ * Whether stored content with a node (or Yjs element) named `nodeName` and these `attributes` still uses an old persisted
+ * name: the node name itself, or a Typed block / opaque fence that still has the `kind` attribute.
+ */
+export declare function isOldPersistedNode(nodeName: string, attributes: Readonly<Record<string, unknown>>, options?: PersistedNamesOptions): boolean;
+/**
+ * `json` with every old persisted name replaced by the current one; recursive, returns a copy. Idempotent (current names
+ * pass unchanged) and lossless: block IDs and every other attribute stay, an existing `blockType` wins over a stale `kind`.
+ */
+export declare function migratePersistedNames(json: JSONContent, options?: PersistedNamesOptions): JSONContent;
+//#endregion
+//# sourceMappingURL=persisted-names.d.ts.map

package/dist/core/schema/persisted-names.js

@@ -0,0 +1,96 @@
+//#region src/core/schema/persisted-names.ts
+/**
+* The persisted names of Typed blocks before the vocabulary of `CONTEXT.md` (Typed block, Block type) replaced them, and
+* the one load-time migration that maps them to the current names. Stored documents (JSON store, Yjs state, `.cdoc`
+* packages, Markdown-free clipboard and drag payloads) written by earlier releases carry them; the rule is: old names are
+* READ wherever content enters and never written. Nothing else in the code base spells them.
+*
+* Nodes: `composite` -> `typedBlock`, with the chrome nodes `compositeTitle`/`compositeDescription`/`compositeTags` ->
+* `typedBlockTitle`/`typedBlockDescription`/`typedBlockTags`; with `options.earliest` also the single-purpose `section`
+* family of the earliest dev releases (`section`, `sectionTitle`, `sectionSummary`, `sectionTags`), which maps to the same
+* targets (a `section` becomes a Typed block of Block type `section`). Attribute: `kind` -> `blockType` on a Typed block and on an `opaqueFence`.
+*/
+/** Node name of a Typed block. */
+const TYPED_BLOCK = "typedBlock";
+const TYPED_BLOCK_TITLE = "typedBlockTitle";
+const TYPED_BLOCK_DESCRIPTION = "typedBlockDescription";
+const TYPED_BLOCK_TAGS = "typedBlockTags";
+/**
+* CSS class of a Typed block's node view root (`section.composite`). Styling, not a persisted name: the shipped sheets, the
+* chrome anchors (`compositeSectionOf`) and host themes select `.composite`, as they did before the rename. It is spelled
+* here because `legacy-names` lets this file (and only this file) quote the word; the BEM children `composite__toggle` and
+* `composite__content` and the title class `composite-title` are no bare quoted name and need no entry. The HTML node
+* name stays `data-type="typedBlock"`.
+*/
+const TYPED_BLOCK_CLASS = "composite";
+/** Attribute that holds the id of a Typed block's (and an opaque fence's) Block type. */
+const BLOCK_TYPE_ATTR = "blockType";
+/** Node name stored before -> current node name. */
+const RENAMED_NODES = {
+	composite: TYPED_BLOCK,
+	compositeTitle: TYPED_BLOCK_TITLE,
+	compositeDescription: TYPED_BLOCK_DESCRIPTION,
+	compositeTags: TYPED_BLOCK_TAGS
+};
+/**
+* The single-purpose `section` family of the earliest dev releases -> current node name. Only for content of editors
+* with Typed blocks (`options.earliest`): a host may have a node of its own named `section`.
+*/
+const EARLIEST_NODES = {
+	section: TYPED_BLOCK,
+	sectionTitle: TYPED_BLOCK_TITLE,
+	sectionSummary: TYPED_BLOCK_DESCRIPTION,
+	sectionTags: TYPED_BLOCK_TAGS
+};
+const renamedNode = (nodeName, options) => Object.hasOwn(RENAMED_NODES, nodeName) ? RENAMED_NODES[nodeName] : options.earliest && Object.hasOwn(EARLIEST_NODES, nodeName) ? EARLIEST_NODES[nodeName] : void 0;
+/** The HTML names markup written before the rename carries; the node parse rules read them, nothing writes them (the Markdown fence needs no entry: its keyword is a Block type id and did not change). */
+const OLD_HTML = {
+	typedBlock: "composite",
+	title: "composite-title",
+	description: "composite-description",
+	tags: "composite-tags",
+	/** The earliest dev releases' single-purpose `section` family: element `data-type`s of the block and its title, summary and tags. */
+	earliestBlock: "section",
+	earliestTitle: "section-title",
+	earliestDescription: "section-summary",
+	earliestTags: "section-tags",
+	/** Attribute of the Block type id on the Typed block's element. */
+	blockTypeAttr: "data-kind"
+};
+/** The former attribute name of the Block type id. */
+const OLD_BLOCK_TYPE_ATTR = "kind";
+/** The former node name of the earliest single-purpose block: it had no type attribute, its Block type is `section`. */
+const EARLIEST_BLOCK = "section";
+/** Node names that carry their Block type id in the attribute `kind` was. */
+const BLOCK_TYPE_NODES = [TYPED_BLOCK, "opaqueFence"];
+/**
+* Whether stored content with a node (or Yjs element) named `nodeName` and these `attributes` still uses an old persisted
+* name: the node name itself, or a Typed block / opaque fence that still has the `kind` attribute.
+*/
+function isOldPersistedNode(nodeName, attributes, options = {}) {
+	return renamedNode(nodeName, options) !== void 0 || BLOCK_TYPE_NODES.includes(nodeName) && Object.hasOwn(attributes, OLD_BLOCK_TYPE_ATTR);
+}
+/**
+* `json` with every old persisted name replaced by the current one; recursive, returns a copy. Idempotent (current names
+* pass unchanged) and lossless: block IDs and every other attribute stay, an existing `blockType` wins over a stale `kind`.
+*/
+function migratePersistedNames(json, options = {}) {
+	const result = { ...json };
+	const type = json.type;
+	const current = type ? renamedNode(type, options) ?? type : void 0;
+	if (current && current !== type) result.type = current;
+	if (current && BLOCK_TYPE_NODES.includes(current) && (json.attrs || type === EARLIEST_BLOCK)) {
+		const { [OLD_BLOCK_TYPE_ATTR]: kind, ...rest } = json.attrs ?? {};
+		const blockType = rest["blockType"] ?? kind ?? (type === EARLIEST_BLOCK && options.earliest ? EARLIEST_BLOCK : void 0);
+		result.attrs = blockType === void 0 ? rest : {
+			...rest,
+			[BLOCK_TYPE_ATTR]: blockType
+		};
+	}
+	if (json.content) result.content = json.content.map((child) => migratePersistedNames(child, options));
+	return result;
+}
+//#endregion
+export { BLOCK_TYPE_ATTR, OLD_HTML, TYPED_BLOCK, TYPED_BLOCK_CLASS, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE, isOldPersistedNode, migratePersistedNames };
+
+//# sourceMappingURL=persisted-names.js.map

package/dist/core/schema/persisted-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-names.js","names":[],"sources":["../../../src/core/schema/persisted-names.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\n\n/**\n * The persisted names of Typed blocks before the vocabulary of `CONTEXT.md` (Typed block, Block type) replaced them, and\n * the one load-time migration that maps them to the current names. Stored documents (JSON store, Yjs state, `.cdoc`\n * packages, Markdown-free clipboard and drag payloads) written by earlier releases carry them; the rule is: old names are\n * READ wherever content enters and never written. Nothing else in the code base spells them.\n *\n * Nodes: `composite` -> `typedBlock`, with the chrome nodes `compositeTitle`/`compositeDescription`/`compositeTags` ->\n * `typedBlockTitle`/`typedBlockDescription`/`typedBlockTags`; with `options.earliest` also the single-purpose `section`\n * family of the earliest dev releases (`section`, `sectionTitle`, `sectionSummary`, `sectionTags`), which maps to the same\n * targets (a `section` becomes a Typed block of Block type `section`). Attribute: `kind` -> `blockType` on a Typed block and on an `opaqueFence`.\n */\n\n/** Node name of a Typed block. */\nexport const TYPED_BLOCK = 'typedBlock'\nexport const TYPED_BLOCK_TITLE = 'typedBlockTitle'\nexport const TYPED_BLOCK_DESCRIPTION = 'typedBlockDescription'\nexport const TYPED_BLOCK_TAGS = 'typedBlockTags'\n\n/**\n * CSS class of a Typed block's node view root (`section.composite`). Styling, not a persisted name: the shipped sheets, the\n * chrome anchors (`compositeSectionOf`) and host themes select `.composite`, as they did before the rename. It is spelled\n * here because `legacy-names` lets this file (and only this file) quote the word; the BEM children `composite__toggle` and\n * `composite__content` and the title class `composite-title` are no bare quoted name and need no entry. The HTML node\n * name stays `data-type=\"typedBlock\"`.\n */\nexport const TYPED_BLOCK_CLASS = 'composite'\n\n/** Attribute that holds the id of a Typed block's (and an opaque fence's) Block type. */\nexport const BLOCK_TYPE_ATTR = 'blockType'\n\n/** Node name stored before -> current node name. */\nconst RENAMED_NODES: Readonly<Record<string, string>> = {\n  composite: TYPED_BLOCK,\n  compositeTitle: TYPED_BLOCK_TITLE,\n  compositeDescription: TYPED_BLOCK_DESCRIPTION,\n  compositeTags: TYPED_BLOCK_TAGS,\n}\n\n/**\n * The single-purpose `section` family of the earliest dev releases -> current node name. Only for content of editors\n * with Typed blocks (`options.earliest`): a host may have a node of its own named `section`.\n */\nconst EARLIEST_NODES: Readonly<Record<string, string>> = {\n  section: TYPED_BLOCK,\n  sectionTitle: TYPED_BLOCK_TITLE,\n  sectionSummary: TYPED_BLOCK_DESCRIPTION,\n  sectionTags: TYPED_BLOCK_TAGS,\n}\n\nexport interface PersistedNamesOptions {\n  /** Also map the earliest `section` family (content of an editor with Typed blocks). Default `false`. */\n  earliest?: boolean\n}\n\nconst renamedNode = (nodeName: string, options: PersistedNamesOptions): string | undefined =>\n  Object.hasOwn(RENAMED_NODES, nodeName) ? RENAMED_NODES[nodeName] : options.earliest && Object.hasOwn(EARLIEST_NODES, nodeName) ? EARLIEST_NODES[nodeName] : undefined\n\n/** The HTML names markup written before the rename carries; the node parse rules read them, nothing writes them (the Markdown fence needs no entry: its keyword is a Block type id and did not change). */\nexport const OLD_HTML = {\n  typedBlock: 'composite',\n  // i18n-ignore: HTML data-type of stored markup, not UI text\n  title: 'composite-title',\n  // i18n-ignore: HTML data-type of stored markup, not UI text\n  description: 'composite-description',\n  tags: 'composite-tags',\n  /** The earliest dev releases' single-purpose `section` family: element `data-type`s of the block and its title, summary and tags. */\n  earliestBlock: 'section',\n  // i18n-ignore: HTML data-type of stored markup, not UI text\n  earliestTitle: 'section-title',\n  // i18n-ignore: HTML data-type of stored markup, not UI text\n  earliestDescription: 'section-summary',\n  // i18n-ignore: HTML data-type of stored markup, not UI text\n  earliestTags: 'section-tags',\n  /** Attribute of the Block type id on the Typed block's element. */\n  blockTypeAttr: 'data-kind',\n} as const\n\n/** The former attribute name of the Block type id. */\nconst OLD_BLOCK_TYPE_ATTR = 'kind'\n\n/** The former node name of the earliest single-purpose block: it had no type attribute, its Block type is `section`. */\nconst EARLIEST_BLOCK = 'section'\n\n/** Node names that carry their Block type id in the attribute `kind` was. */\nconst BLOCK_TYPE_NODES: readonly string[] = [TYPED_BLOCK, 'opaqueFence']\n\n/**\n * Whether stored content with a node (or Yjs element) named `nodeName` and these `attributes` still uses an old persisted\n * name: the node name itself, or a Typed block / opaque fence that still has the `kind` attribute.\n */\nexport function isOldPersistedNode(nodeName: string, attributes: Readonly<Record<string, unknown>>, options: PersistedNamesOptions = {}): boolean {\n  return renamedNode(nodeName, options) !== undefined || (BLOCK_TYPE_NODES.includes(nodeName) && Object.hasOwn(attributes, OLD_BLOCK_TYPE_ATTR))\n}\n\n/**\n * `json` with every old persisted name replaced by the current one; recursive, returns a copy. Idempotent (current names\n * pass unchanged) and lossless: block IDs and every other attribute stay, an existing `blockType` wins over a stale `kind`.\n */\nexport function migratePersistedNames(json: JSONContent, options: PersistedNamesOptions = {}): JSONContent {\n  const result: JSONContent = { ...json }\n  const type = json.type\n  const current = type ? (renamedNode(type, options) ?? type) : undefined\n  if (current && current !== type) result.type = current\n  if (current && BLOCK_TYPE_NODES.includes(current) && (json.attrs || type === EARLIEST_BLOCK)) {\n    const { [OLD_BLOCK_TYPE_ATTR]: kind, ...rest } = json.attrs ?? {}\n    const blockType = rest[BLOCK_TYPE_ATTR] ?? kind ?? (type === EARLIEST_BLOCK && options.earliest ? EARLIEST_BLOCK : undefined)\n    result.attrs = blockType === undefined ? rest : { ...rest, [BLOCK_TYPE_ATTR]: blockType }\n  }\n  if (json.content) result.content = json.content.map(child => migratePersistedNames(child, options))\n  return result\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,MAAa,cAAc;AAC3B,MAAa,oBAAoB;AACjC,MAAa,0BAA0B;AACvC,MAAa,mBAAmB;;;;;;;;AAShC,MAAa,oBAAoB;;AAGjC,MAAa,kBAAkB;;AAG/B,MAAM,gBAAkD;CACtD,WAAW;CACX,gBAAgB;CAChB,sBAAsB;CACtB,eAAe;AACjB;;;;;AAMA,MAAM,iBAAmD;CACvD,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf;AAOA,MAAM,eAAe,UAAkB,YACrC,OAAO,OAAO,eAAe,QAAQ,IAAI,cAAc,YAAY,QAAQ,YAAY,OAAO,OAAO,gBAAgB,QAAQ,IAAI,eAAe,YAAY,KAAA;;AAG9J,MAAa,WAAW;CACtB,YAAY;CAEZ,OAAO;CAEP,aAAa;CACb,MAAM;;CAEN,eAAe;CAEf,eAAe;CAEf,qBAAqB;CAErB,cAAc;;CAEd,eAAe;AACjB;;AAGA,MAAM,sBAAsB;;AAG5B,MAAM,iBAAiB;;AAGvB,MAAM,mBAAsC,CAAC,aAAa,aAAa;;;;;AAMvE,SAAgB,mBAAmB,UAAkB,YAA+C,UAAiC,CAAC,GAAY;CAChJ,OAAO,YAAY,UAAU,OAAO,MAAM,KAAA,KAAc,iBAAiB,SAAS,QAAQ,KAAK,OAAO,OAAO,YAAY,mBAAmB;AAC9I;;;;;AAMA,SAAgB,sBAAsB,MAAmB,UAAiC,CAAC,GAAgB;CACzG,MAAM,SAAsB,EAAE,GAAG,KAAK;CACtC,MAAM,OAAO,KAAK;CAClB,MAAM,UAAU,OAAQ,YAAY,MAAM,OAAO,KAAK,OAAQ,KAAA;CAC9D,IAAI,WAAW,YAAY,MAAM,OAAO,OAAO;CAC/C,IAAI,WAAW,iBAAiB,SAAS,OAAO,MAAM,KAAK,SAAS,SAAS,iBAAiB;EAC5F,MAAM,GAAG,sBAAsB,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC;EAChE,MAAM,YAAY,KAAA,gBAAyB,SAAS,SAAS,kBAAkB,QAAQ,WAAW,iBAAiB,KAAA;EACnH,OAAO,QAAQ,cAAc,KAAA,IAAY,OAAO;GAAE,GAAG;IAAO,kBAAkB;EAAU;CAC1F;CACA,IAAI,KAAK,SAAS,OAAO,UAAU,KAAK,QAAQ,KAAI,UAAS,sBAAsB,OAAO,OAAO,CAAC;CAClG,OAAO;AACT"}

package/dist/core/toolbar-items.js

@@ -43,7 +43,7 @@ const CORE_TOOLBAR_GROUPS = [
 * types (headings, lists, quote, code block, rule) are also in the `/` menu.
 */
 function coreCommands(ctx) {
-	const headingsShown = (editor) => ctx.settings.get().blocks.structure === "flat" || !editor.schema.nodes.composite;
+	const headingsShown = (editor) => ctx.settings.get().blocks.structure === "flat" || !editor.schema.nodes.typedBlock;
 	return [
 		command({
 			id: "undo",

package/dist/core/toolbar-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar-items.js","names":[],"sources":["../../src/core/toolbar-items.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { CommandDef, ToolbarGroupDef } from './command-types'\nimport type { FeatureContext } from './feature'\nimport { ABILITY } from './schema/abilities'\nimport { command } from './commands'\n\n/**\n * The toolbar groups of the core UI (undo/redo, paragraph and headings, text marks, lists/quote/code block/rule) and the\n * two groups other features' commands name: `inserts` (media, transcript, …) and `collaboration` (comments, authors).\n * Orders leave room for the groups features contribute (composites and tables 60, AI 1000).\n */\nexport const CORE_TOOLBAR_GROUPS: ToolbarGroupDef[] = [\n  { id: 'history', order: 10, labelKey: 'palette.group.history' },\n  { id: 'block-type', order: 20, labelKey: 'palette.group.blockType' },\n  { id: 'marks', order: 30, labelKey: 'palette.group.marks' },\n  { id: 'blocks', order: 40, labelKey: 'palette.group.blocks' },\n  { id: 'inserts', order: 50, labelKey: 'palette.group.inserts' },\n  { id: 'collaboration', order: 1010, labelKey: 'palette.group.collaboration' },\n]\n\n/**\n * The core commands: undo/redo, paragraph and headings, text marks, lists, quote, code block and rule. The five block\n * types (headings, lists, quote, code block, rule) are also in the `/` menu.\n */\nexport function coreCommands(ctx: FeatureContext): CommandDef<never>[] {\n  // Headings are the document structure in the flat setting, and always where the schema has no composites to structure with.\n  const headingsShown = (editor: Editor) => ctx.settings.get().blocks.structure === 'flat' || !editor.schema.nodes.composite\n  return [\n    command({ id: 'undo', toolbar: { group: 'history', order: 10 }, icon: 'i-lucide-undo-2', label: ctx.t('toolbar.undo'), kbds: ['meta', 'z'], command: c => c.undo() }),\n    command({ id: 'redo', toolbar: { group: 'history', order: 20 }, icon: 'i-lucide-redo-2', label: ctx.t('toolbar.redo'), kbds: ['meta', 'shift', 'z'], command: c => c.redo() }),\n    command({ id: 'paragraph', toolbar: { group: 'block-type', order: 10 }, icon: 'i-lucide-pilcrow', label: ctx.t('toolbar.paragraph'), kbds: ['meta', 'alt', '0'], command: c => c.setParagraph(), active: e => e.isActive('paragraph') }),\n    // With composites in the schema, the 'composite' structure shows Bausteine instead of H1–H3.\n    ...([1, 2, 3] as const).map(level => command({\n      id: `heading${level}`,\n      toolbar: { group: 'block-type', order: 20 + level },\n      slash: { id: `h${level}` },\n      creates: { type: 'heading', attrs: { level } },\n      icon: `i-lucide-heading-${level}`,\n      label: ctx.t('toolbar.heading', { level }),\n      kbds: ['meta', 'alt', String(level)],\n      ability: ABILITY.headings,\n      command: c => c.toggleHeading({ level }),\n      active: e => e.isActive('heading', { level }),\n      // `coreContent: { headings: { levels } }` limits the levels; the heading extension holds the allowed ones.\n      visible: editor => headingsShown(editor) && ((editor.extensionManager.extensions.find(extension => extension.name === 'heading')?.options.levels as number[] | undefined)?.includes(level) ?? true),\n    })),\n    command({ id: 'bold', toolbar: { group: 'marks', order: 10 }, icon: 'i-lucide-bold', label: ctx.t('toolbar.bold'), kbds: ['meta', 'b'], ability: ABILITY.marks, command: c => c.toggleBold(), active: e => e.isActive('bold') }),\n    command({ id: 'italic', toolbar: { group: 'marks', order: 20 }, icon: 'i-lucide-italic', label: ctx.t('toolbar.italic'), kbds: ['meta', 'i'], ability: ABILITY.marks, command: c => c.toggleItalic(), active: e => e.isActive('italic') }),\n    command({ id: 'underline', toolbar: { group: 'marks', order: 30 }, icon: 'i-lucide-underline', label: ctx.t('toolbar.underline'), kbds: ['meta', 'u'], ability: ABILITY.marks, command: c => c.toggleUnderline(), active: e => e.isActive('underline') }),\n    // Mod-Shift-s is the speaker segment, so strike is rebound to Mod-Shift-x (StrikeX).\n    command({ id: 'strike', toolbar: { group: 'marks', order: 40 }, icon: 'i-lucide-strikethrough', label: ctx.t('toolbar.strike'), kbds: ['meta', 'shift', 'x'], ability: ABILITY.marks, command: c => c.toggleStrike(), active: e => e.isActive('strike') }),\n    command({ id: 'code', toolbar: { group: 'marks', order: 50 }, icon: 'i-lucide-code', label: ctx.t('toolbar.code'), kbds: ['meta', 'e'], ability: ABILITY.marks, command: c => c.toggleCode(), active: e => e.isActive('code') }),\n    command({ id: 'bulletList', toolbar: { group: 'blocks', order: 10 }, slash: { id: 'liste' }, creates: { type: 'bulletList' }, icon: 'i-lucide-list', label: ctx.t('toolbar.bulletList'), kbds: ['meta', 'shift', '8'], ability: ABILITY.lists, command: c => c.toggleBulletList(), active: e => e.isActive('bulletList') }),\n    command({ id: 'orderedList', toolbar: { group: 'blocks', order: 20 }, slash: { id: 'nummerierung' }, creates: { type: 'orderedList' }, icon: 'i-lucide-list-ordered', label: ctx.t('toolbar.orderedList'), kbds: ['meta', 'shift', '7'], ability: ABILITY.lists, command: c => c.toggleOrderedList(), active: e => e.isActive('orderedList') }),\n    command({ id: 'blockquote', toolbar: { group: 'blocks', order: 30 }, slash: { id: 'zitat' }, creates: { type: 'blockquote' }, icon: 'i-lucide-text-quote', label: ctx.t('toolbar.blockquote'), kbds: ['meta', 'shift', 'b'], ability: ABILITY.blockquote, command: c => c.toggleBlockquote(), active: e => e.isActive('blockquote') }),\n    command({ id: 'codeBlock', toolbar: { group: 'blocks', order: 40 }, slash: { id: 'codeblock' }, creates: { type: 'codeBlock' }, icon: 'i-lucide-square-code', label: ctx.t('toolbar.codeBlock'), kbds: ['meta', 'alt', 'c'], ability: ABILITY.codeBlock, command: c => c.toggleCodeBlock(), active: e => e.isActive('codeBlock') }),\n    command({ id: 'rule', toolbar: { group: 'blocks', order: 50 }, slash: { id: 'trennlinie' }, creates: { type: 'horizontalRule' }, icon: 'i-lucide-minus', label: ctx.t('toolbar.rule'), ability: ABILITY.rule, command: c => c.setHorizontalRule() }),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"toolbar-items.js","names":[],"sources":["../../src/core/toolbar-items.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { CommandDef, ToolbarGroupDef } from './command-types'\nimport type { FeatureContext } from './feature'\nimport { ABILITY } from './schema/abilities'\nimport { command } from './commands'\n\n/**\n * The toolbar groups of the core UI (undo/redo, paragraph and headings, text marks, lists/quote/code block/rule) and the\n * two groups other features' commands name: `inserts` (media, transcript, …) and `collaboration` (comments, authors).\n * Orders leave room for the groups features contribute (composites and tables 60, AI 1000).\n */\nexport const CORE_TOOLBAR_GROUPS: ToolbarGroupDef[] = [\n  { id: 'history', order: 10, labelKey: 'palette.group.history' },\n  { id: 'block-type', order: 20, labelKey: 'palette.group.blockType' },\n  { id: 'marks', order: 30, labelKey: 'palette.group.marks' },\n  { id: 'blocks', order: 40, labelKey: 'palette.group.blocks' },\n  { id: 'inserts', order: 50, labelKey: 'palette.group.inserts' },\n  { id: 'collaboration', order: 1010, labelKey: 'palette.group.collaboration' },\n]\n\n/**\n * The core commands: undo/redo, paragraph and headings, text marks, lists, quote, code block and rule. The five block\n * types (headings, lists, quote, code block, rule) are also in the `/` menu.\n */\nexport function coreCommands(ctx: FeatureContext): CommandDef<never>[] {\n  // Headings are the document structure in the flat setting, and always where the schema has no composites to structure with.\n  const headingsShown = (editor: Editor) => ctx.settings.get().blocks.structure === 'flat' || !editor.schema.nodes.typedBlock\n  return [\n    command({ id: 'undo', toolbar: { group: 'history', order: 10 }, icon: 'i-lucide-undo-2', label: ctx.t('toolbar.undo'), kbds: ['meta', 'z'], command: c => c.undo() }),\n    command({ id: 'redo', toolbar: { group: 'history', order: 20 }, icon: 'i-lucide-redo-2', label: ctx.t('toolbar.redo'), kbds: ['meta', 'shift', 'z'], command: c => c.redo() }),\n    command({ id: 'paragraph', toolbar: { group: 'block-type', order: 10 }, icon: 'i-lucide-pilcrow', label: ctx.t('toolbar.paragraph'), kbds: ['meta', 'alt', '0'], command: c => c.setParagraph(), active: e => e.isActive('paragraph') }),\n    // With composites in the schema, the 'structured' structure shows Typed blocks instead of H1–H3.\n    ...([1, 2, 3] as const).map(level => command({\n      id: `heading${level}`,\n      toolbar: { group: 'block-type', order: 20 + level },\n      slash: { id: `h${level}` },\n      creates: { type: 'heading', attrs: { level } },\n      icon: `i-lucide-heading-${level}`,\n      label: ctx.t('toolbar.heading', { level }),\n      kbds: ['meta', 'alt', String(level)],\n      ability: ABILITY.headings,\n      command: c => c.toggleHeading({ level }),\n      active: e => e.isActive('heading', { level }),\n      // `coreContent: { headings: { levels } }` limits the levels; the heading extension holds the allowed ones.\n      visible: editor => headingsShown(editor) && ((editor.extensionManager.extensions.find(extension => extension.name === 'heading')?.options.levels as number[] | undefined)?.includes(level) ?? true),\n    })),\n    command({ id: 'bold', toolbar: { group: 'marks', order: 10 }, icon: 'i-lucide-bold', label: ctx.t('toolbar.bold'), kbds: ['meta', 'b'], ability: ABILITY.marks, command: c => c.toggleBold(), active: e => e.isActive('bold') }),\n    command({ id: 'italic', toolbar: { group: 'marks', order: 20 }, icon: 'i-lucide-italic', label: ctx.t('toolbar.italic'), kbds: ['meta', 'i'], ability: ABILITY.marks, command: c => c.toggleItalic(), active: e => e.isActive('italic') }),\n    command({ id: 'underline', toolbar: { group: 'marks', order: 30 }, icon: 'i-lucide-underline', label: ctx.t('toolbar.underline'), kbds: ['meta', 'u'], ability: ABILITY.marks, command: c => c.toggleUnderline(), active: e => e.isActive('underline') }),\n    // Mod-Shift-s is the speaker segment, so strike is rebound to Mod-Shift-x (StrikeX).\n    command({ id: 'strike', toolbar: { group: 'marks', order: 40 }, icon: 'i-lucide-strikethrough', label: ctx.t('toolbar.strike'), kbds: ['meta', 'shift', 'x'], ability: ABILITY.marks, command: c => c.toggleStrike(), active: e => e.isActive('strike') }),\n    command({ id: 'code', toolbar: { group: 'marks', order: 50 }, icon: 'i-lucide-code', label: ctx.t('toolbar.code'), kbds: ['meta', 'e'], ability: ABILITY.marks, command: c => c.toggleCode(), active: e => e.isActive('code') }),\n    command({ id: 'bulletList', toolbar: { group: 'blocks', order: 10 }, slash: { id: 'liste' }, creates: { type: 'bulletList' }, icon: 'i-lucide-list', label: ctx.t('toolbar.bulletList'), kbds: ['meta', 'shift', '8'], ability: ABILITY.lists, command: c => c.toggleBulletList(), active: e => e.isActive('bulletList') }),\n    command({ id: 'orderedList', toolbar: { group: 'blocks', order: 20 }, slash: { id: 'nummerierung' }, creates: { type: 'orderedList' }, icon: 'i-lucide-list-ordered', label: ctx.t('toolbar.orderedList'), kbds: ['meta', 'shift', '7'], ability: ABILITY.lists, command: c => c.toggleOrderedList(), active: e => e.isActive('orderedList') }),\n    command({ id: 'blockquote', toolbar: { group: 'blocks', order: 30 }, slash: { id: 'zitat' }, creates: { type: 'blockquote' }, icon: 'i-lucide-text-quote', label: ctx.t('toolbar.blockquote'), kbds: ['meta', 'shift', 'b'], ability: ABILITY.blockquote, command: c => c.toggleBlockquote(), active: e => e.isActive('blockquote') }),\n    command({ id: 'codeBlock', toolbar: { group: 'blocks', order: 40 }, slash: { id: 'codeblock' }, creates: { type: 'codeBlock' }, icon: 'i-lucide-square-code', label: ctx.t('toolbar.codeBlock'), kbds: ['meta', 'alt', 'c'], ability: ABILITY.codeBlock, command: c => c.toggleCodeBlock(), active: e => e.isActive('codeBlock') }),\n    command({ id: 'rule', toolbar: { group: 'blocks', order: 50 }, slash: { id: 'trennlinie' }, creates: { type: 'horizontalRule' }, icon: 'i-lucide-minus', label: ctx.t('toolbar.rule'), ability: ABILITY.rule, command: c => c.setHorizontalRule() }),\n  ]\n}\n"],"mappings":";;;;;;;;AAWA,MAAa,sBAAyC;CACpD;EAAE,IAAI;EAAW,OAAO;EAAI,UAAU;CAAwB;CAC9D;EAAE,IAAI;EAAc,OAAO;EAAI,UAAU;CAA0B;CACnE;EAAE,IAAI;EAAS,OAAO;EAAI,UAAU;CAAsB;CAC1D;EAAE,IAAI;EAAU,OAAO;EAAI,UAAU;CAAuB;CAC5D;EAAE,IAAI;EAAW,OAAO;EAAI,UAAU;CAAwB;CAC9D;EAAE,IAAI;EAAiB,OAAO;EAAM,UAAU;CAA8B;AAC9E;;;;;AAMA,SAAgB,aAAa,KAA0C;CAErE,MAAM,iBAAiB,WAAmB,IAAI,SAAS,IAAI,CAAC,CAAC,OAAO,cAAc,UAAU,CAAC,OAAO,OAAO,MAAM;CACjH,OAAO;EACL,QAAQ;GAAE,IAAI;GAAQ,SAAS;IAAE,OAAO;IAAW,OAAO;GAAG;GAAG,MAAM;GAAmB,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM,CAAC,QAAQ,GAAG;GAAG,UAAS,MAAK,EAAE,KAAK;EAAE,CAAC;EACpK,QAAQ;GAAE,IAAI;GAAQ,SAAS;IAAE,OAAO;IAAW,OAAO;GAAG;GAAG,MAAM;GAAmB,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM;IAAC;IAAQ;IAAS;GAAG;GAAG,UAAS,MAAK,EAAE,KAAK;EAAE,CAAC;EAC7K,QAAQ;GAAE,IAAI;GAAa,SAAS;IAAE,OAAO;IAAc,OAAO;GAAG;GAAG,MAAM;GAAoB,OAAO,IAAI,EAAE,mBAAmB;GAAG,MAAM;IAAC;IAAQ;IAAO;GAAG;GAAG,UAAS,MAAK,EAAE,aAAa;GAAG,SAAQ,MAAK,EAAE,SAAS,WAAW;EAAE,CAAC;EAEvO,GAAI;GAAC;GAAG;GAAG;EAAC,CAAC,CAAW,KAAI,UAAS,QAAQ;GAC3C,IAAI,UAAU;GACd,SAAS;IAAE,OAAO;IAAc,OAAO,KAAK;GAAM;GAClD,OAAO,EAAE,IAAI,IAAI,QAAQ;GACzB,SAAS;IAAE,MAAM;IAAW,OAAO,EAAE,MAAM;GAAE;GAC7C,MAAM,oBAAoB;GAC1B,OAAO,IAAI,EAAE,mBAAmB,EAAE,MAAM,CAAC;GACzC,MAAM;IAAC;IAAQ;IAAO,OAAO,KAAK;GAAC;GACnC,SAAS,QAAQ;GACjB,UAAS,MAAK,EAAE,cAAc,EAAE,MAAM,CAAC;GACvC,SAAQ,MAAK,EAAE,SAAS,WAAW,EAAE,MAAM,CAAC;GAE5C,UAAS,WAAU,cAAc,MAAM,OAAO,OAAO,iBAAiB,WAAW,MAAK,cAAa,UAAU,SAAS,SAAS,CAAC,EAAE,QAAQ,OAAA,EAAiC,SAAS,KAAK,KAAK;EAChM,CAAC,CAAC;EACF,QAAQ;GAAE,IAAI;GAAQ,SAAS;IAAE,OAAO;IAAS,OAAO;GAAG;GAAG,MAAM;GAAiB,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM,CAAC,QAAQ,GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,WAAW;GAAG,SAAQ,MAAK,EAAE,SAAS,MAAM;EAAE,CAAC;EAC/N,QAAQ;GAAE,IAAI;GAAU,SAAS;IAAE,OAAO;IAAS,OAAO;GAAG;GAAG,MAAM;GAAmB,OAAO,IAAI,EAAE,gBAAgB;GAAG,MAAM,CAAC,QAAQ,GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,aAAa;GAAG,SAAQ,MAAK,EAAE,SAAS,QAAQ;EAAE,CAAC;EACzO,QAAQ;GAAE,IAAI;GAAa,SAAS;IAAE,OAAO;IAAS,OAAO;GAAG;GAAG,MAAM;GAAsB,OAAO,IAAI,EAAE,mBAAmB;GAAG,MAAM,CAAC,QAAQ,GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,gBAAgB;GAAG,SAAQ,MAAK,EAAE,SAAS,WAAW;EAAE,CAAC;EAExP,QAAQ;GAAE,IAAI;GAAU,SAAS;IAAE,OAAO;IAAS,OAAO;GAAG;GAAG,MAAM;GAA0B,OAAO,IAAI,EAAE,gBAAgB;GAAG,MAAM;IAAC;IAAQ;IAAS;GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,aAAa;GAAG,SAAQ,MAAK,EAAE,SAAS,QAAQ;EAAE,CAAC;EACzP,QAAQ;GAAE,IAAI;GAAQ,SAAS;IAAE,OAAO;IAAS,OAAO;GAAG;GAAG,MAAM;GAAiB,OAAO,IAAI,EAAE,cAAc;GAAG,MAAM,CAAC,QAAQ,GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,WAAW;GAAG,SAAQ,MAAK,EAAE,SAAS,MAAM;EAAE,CAAC;EAC/N,QAAQ;GAAE,IAAI;GAAc,SAAS;IAAE,OAAO;IAAU,OAAO;GAAG;GAAG,OAAO,EAAE,IAAI,QAAQ;GAAG,SAAS,EAAE,MAAM,aAAa;GAAG,MAAM;GAAiB,OAAO,IAAI,EAAE,oBAAoB;GAAG,MAAM;IAAC;IAAQ;IAAS;GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,iBAAiB;GAAG,SAAQ,MAAK,EAAE,SAAS,YAAY;EAAE,CAAC;EAC1T,QAAQ;GAAE,IAAI;GAAe,SAAS;IAAE,OAAO;IAAU,OAAO;GAAG;GAAG,OAAO,EAAE,IAAI,eAAe;GAAG,SAAS,EAAE,MAAM,cAAc;GAAG,MAAM;GAAyB,OAAO,IAAI,EAAE,qBAAqB;GAAG,MAAM;IAAC;IAAQ;IAAS;GAAG;GAAG,SAAS,QAAQ;GAAO,UAAS,MAAK,EAAE,kBAAkB;GAAG,SAAQ,MAAK,EAAE,SAAS,aAAa;EAAE,CAAC;EAC9U,QAAQ;GAAE,IAAI;GAAc,SAAS;IAAE,OAAO;IAAU,OAAO;GAAG;GAAG,OAAO,EAAE,IAAI,QAAQ;GAAG,SAAS,EAAE,MAAM,aAAa;GAAG,MAAM;GAAuB,OAAO,IAAI,EAAE,oBAAoB;GAAG,MAAM;IAAC;IAAQ;IAAS;GAAG;GAAG,SAAS,QAAQ;GAAY,UAAS,MAAK,EAAE,iBAAiB;GAAG,SAAQ,MAAK,EAAE,SAAS,YAAY;EAAE,CAAC;EACrU,QAAQ;GAAE,IAAI;GAAa,SAAS;IAAE,OAAO;IAAU,OAAO;GAAG;GAAG,OAAO,EAAE,IAAI,YAAY;GAAG,SAAS,EAAE,MAAM,YAAY;GAAG,MAAM;GAAwB,OAAO,IAAI,EAAE,mBAAmB;GAAG,MAAM;IAAC;IAAQ;IAAO;GAAG;GAAG,SAAS,QAAQ;GAAW,UAAS,MAAK,EAAE,gBAAgB;GAAG,SAAQ,MAAK,EAAE,SAAS,WAAW;EAAE,CAAC;EAClU,QAAQ;GAAE,IAAI;GAAQ,SAAS;IAAE,OAAO;IAAU,OAAO;GAAG;GAAG,OAAO,EAAE,IAAI,aAAa;GAAG,SAAS,EAAE,MAAM,iBAAiB;GAAG,MAAM;GAAkB,OAAO,IAAI,EAAE,cAAc;GAAG,SAAS,QAAQ;GAAM,UAAS,MAAK,EAAE,kBAAkB;EAAE,CAAC;CACrP;AACF"}

package/dist/core/util.js

@@ -5,7 +5,11 @@ function fail(message, scope) {
 }
 /** Sort comparator for `{ order?: number }` entries (ascending, unset = 0); `Array.prototype.sort` is stable, so ties keep declaration order. */
 const byOrder = (a, b) => (a.order ?? 0) - (b.order ?? 0);
+/** `definitions[0].type` for a zod issue path. */
+const pathText = (path) => path.map((part, position) => typeof part === "number" ? `[${part}]` : `${position ? "." : ""}${String(part)}`).join("");
+/** The node that starts at `pos` in `doc`; null when `pos` lies outside the document or no node starts there. */
+const nodeAtPos = (doc, pos) => pos >= 0 && pos <= doc.content.size ? doc.nodeAt(pos) : null;
 //#endregion
-export { byOrder, fail };
+export { byOrder, fail, nodeAtPos, pathText };
 
 //# sourceMappingURL=util.js.map

package/dist/core/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","names":[],"sources":["../../src/core/util.ts"],"sourcesContent":["/** Throws the library's error: `@ecsplico/editor: [<scope>: ]<message>`. */\nexport function fail(message: string, scope?: string): never {\n  throw new Error(`@ecsplico/editor: ${scope ? `${scope}: ` : ''}${message}`)\n}\n\n/** Sort comparator for `{ order?: number }` entries (ascending, unset = 0); `Array.prototype.sort` is stable, so ties keep declaration order. */\nexport const byOrder = <T extends { order?: number }>(a: T, b: T) => (a.order ?? 0) - (b.order ?? 0)\n"],"mappings":";;AACA,SAAgB,KAAK,SAAiB,OAAuB;CAC3D,MAAM,IAAI,MAAM,qBAAqB,QAAQ,GAAG,MAAM,MAAM,KAAK,SAAS;AAC5E;;AAGA,MAAa,WAAyC,GAAM,OAAU,EAAE,SAAS,MAAM,EAAE,SAAS"}
+{"version":3,"file":"util.js","names":[],"sources":["../../src/core/util.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\n\n/** Throws the library's error: `@ecsplico/editor: [<scope>: ]<message>`. */\nexport function fail(message: string, scope?: string): never {\n  throw new Error(`@ecsplico/editor: ${scope ? `${scope}: ` : ''}${message}`)\n}\n\n/** Sort comparator for `{ order?: number }` entries (ascending, unset = 0); `Array.prototype.sort` is stable, so ties keep declaration order. */\nexport const byOrder = <T extends { order?: number }>(a: T, b: T) => (a.order ?? 0) - (b.order ?? 0)\n\n/** `definitions[0].type` for a zod issue path. */\nexport const pathText = (path: readonly PropertyKey[]): string =>\n  path.map((part, position) => typeof part === 'number' ? `[${part}]` : `${position ? '.' : ''}${String(part)}`).join('')\n\n/** The node that starts at `pos` in `doc`; null when `pos` lies outside the document or no node starts there. */\nexport const nodeAtPos = (doc: PMNode, pos: number): PMNode | null => pos >= 0 && pos <= doc.content.size ? doc.nodeAt(pos) : null\n"],"mappings":";;AAGA,SAAgB,KAAK,SAAiB,OAAuB;CAC3D,MAAM,IAAI,MAAM,qBAAqB,QAAQ,GAAG,MAAM,MAAM,KAAK,SAAS;AAC5E;;AAGA,MAAa,WAAyC,GAAM,OAAU,EAAE,SAAS,MAAM,EAAE,SAAS;;AAGlG,MAAa,YAAY,SACvB,KAAK,KAAK,MAAM,aAAa,OAAO,SAAS,WAAW,IAAI,KAAK,KAAK,GAAG,WAAW,MAAM,KAAK,OAAO,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE;;AAGxH,MAAa,aAAa,KAAa,QAA+B,OAAO,KAAK,OAAO,IAAI,QAAQ,OAAO,IAAI,OAAO,GAAG,IAAI"}

package/dist/features/ai/agent-ops.js

@@ -1,8 +1,8 @@
 import { stripListMarkerEcho } from "./protocol/block-lines.js";
 import { agentOpTarget } from "./protocol/agent-ops.js";
-import { conversionsOf, parseBlocks } from "../../core/pipeline.js";
 import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
 import { isBlockContainer, isChromeNode } from "../../core/schema/node-flags.js";
+import { conversionsOf, parseBlocks } from "../../core/pipeline.js";
 import { isWrapperBlock } from "../../core/convert.js";
 import { blockConversion, parseConversionTarget } from "../../core/block-convert.js";
 import { captureRange } from "../../core/doc-anchors.js";

package/dist/features/ai/ai-review.js

@@ -1,5 +1,5 @@
-import { parseBlocks, structureBlocks } from "../../core/pipeline.js";
 import "../../core/schema/block-ids.js";
+import { parseBlocks, structureBlocks } from "../../core/pipeline.js";
 import { anchorResolverOf, captureRange, docAnchorsKey, resolveRange } from "../../core/doc-anchors.js";
 import { inlineReplacement, replaceRangeWithBlocks } from "./ai-apply.js";
 import { Extension } from "@tiptap/core";

package/dist/features/ai/assistant.d.ts

@@ -1,6 +1,6 @@
 import { ReadonlyStore } from "../../core/store.js";
 import { Translate } from "../../i18n/index.js";
-import { AiLanguage, ModelSlot } from "../../settings/values.js";
+import { AiLanguage, ModelRole } from "../../settings/values.js";
 import "../../settings/index.js";
 import { EditorBackend } from "../../core/backend.js";
 import { Notifier } from "../../core/notify.js";
@@ -27,11 +27,11 @@ export interface AiAssistantState {
   output: string;
   error: string | null;
 }
-/** What `createAiAssistant` needs from the app: the AI port, the model of a slot, the notifier and translator for the 429 notice and failures. */
+/** What `createAiAssistant` needs from the app: the AI port, the model of a Model role, the notifier and translator for the 429 notice and failures. */
 export interface AiAssistantOptions {
   /** `EditorContext.backend.ai`; without it every run ends in the error state (501), like a server without AI. */
   ai: EditorBackend['ai'];
-  modelRef: (slot: ModelSlot) => ModelRef;
+  modelRef: (slot: ModelRole) => ModelRef;
   /** Receives the 429 notice. */
   notify: Notifier;
   /** The app's translator (`EditorContext.t`). */
@@ -48,7 +48,7 @@ export interface AiAssistant {
   /** Clears the error message; the status stays. */
   clearError: () => void;
 }
-/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's model slot. */
+/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's Model role. */
 export declare function createAiAssistant({ ai, modelRef, notify, t }: AiAssistantOptions): AiAssistant;
 //#endregion
 //# sourceMappingURL=assistant.d.ts.map

package/dist/features/ai/assistant.js

@@ -8,7 +8,7 @@ const IDLE = {
 	output: "",
 	error: null
 };
-/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's model slot. */
+/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's Model role. */
 function createAiAssistant({ ai, modelRef, notify, t }) {
 	const store = createStore(IDLE);
 	let controller = null;

package/dist/features/ai/assistant.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.js","names":[],"sources":["../../../src/features/ai/assistant.ts"],"sourcesContent":["import type { EditorBackend } from '../../core/backend'\nimport type { AiBlock } from '../../core/feature'\nimport type { Notifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport type { AiLanguage, ModelSlot } from '../../settings'\nimport { postAiSse } from './ai-sse'\nimport { AI_TASKS, type AiBlockInput, type AiTaskId, type ModelRef } from './protocol'\nimport { notifyAiRateLimited } from './rate-limit'\n\nexport type AiStatus = 'idle' | 'streaming' | 'done' | 'error'\n\nexport interface AiRunBody {\n  task: AiTaskId\n  prompt: string\n  selection: string\n  context: string\n  language?: AiLanguage\n  /** The editor's host blocks (`aiContextOf(editor).blocks`), listed in the task's system prompt. */\n  blocks?: readonly AiBlock[]\n  /** The block of a `needsBlock` task (`fill-block`): its brief and material. */\n  block?: AiBlockInput\n}\n\n/** Snapshot of the running or last request: its status, the streamed text so far and the error message. */\nexport interface AiAssistantState {\n  status: AiStatus\n  output: string\n  error: string | null\n}\n\n/** What `createAiAssistant` needs from the app: the AI port, the model of a slot, the notifier and translator for the 429 notice and failures. */\nexport interface AiAssistantOptions {\n  /** `EditorContext.backend.ai`; without it every run ends in the error state (501), like a server without AI. */\n  ai: EditorBackend['ai']\n  modelRef: (slot: ModelSlot) => ModelRef\n  /** Receives the 429 notice. */\n  notify: Notifier\n  /** The app's translator (`EditorContext.t`). */\n  t: Translate\n}\n\n/** The streaming assistant: observe `state`, `run` a task, `abort`/`reset` it. */\nexport interface AiAssistant {\n  state: ReadonlyStore<AiAssistantState>\n  run: (body: AiRunBody) => Promise<void>\n  /** Stops the running request (its outcome is `idle`). */\n  abort: () => void\n  /** Aborts and returns to the empty `idle` state. */\n  reset: () => void\n  /** Clears the error message; the status stays. */\n  clearError: () => void\n}\n\nconst IDLE: AiAssistantState = { status: 'idle', output: '', error: null }\n\n/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's model slot. */\nexport function createAiAssistant({ ai, modelRef, notify, t }: AiAssistantOptions): AiAssistant {\n  const store = createStore<AiAssistantState>(IDLE)\n  let controller: AbortController | null = null\n\n  function abort() {\n    controller?.abort()\n  }\n\n  function reset() {\n    abort()\n    controller = null\n    store.set(IDLE)\n  }\n\n  function clearError() {\n    const state = store.get()\n    if (state.error !== null) store.set({ ...state, error: null })\n  }\n\n  async function run(body: AiRunBody): Promise<void> {\n    reset()\n    const own = new AbortController()\n    controller = own\n    store.set({ status: 'streaming', output: '', error: null })\n    const outcome = await postAiSse(ai, 'generate', { ...body, model: modelRef(AI_TASKS[body.task].slot) }, {\n      signal: own.signal,\n      t,\n      onDelta: (text) => {\n        if (controller === own) store.set({ ...store.get(), output: store.get().output + text })\n      },\n    })\n    if (controller !== own) return // superseded by reset()/another run\n    controller = null\n    if (outcome.status === 'done') {\n      store.set({ ...store.get(), status: 'done' })\n    }\n    else if (outcome.status === 'error') {\n      store.set({ ...store.get(), status: 'error', error: outcome.message })\n    }\n    else {\n      // Notice instead of the error state on 429, so the caller stays ready for another try.\n      if (outcome.status === 'rate-limited') notifyAiRateLimited(notify, t)\n      store.set({ ...store.get(), status: 'idle' })\n    }\n  }\n\n  return { state: store, run, abort, reset, clearError }\n}\n"],"mappings":";;;;;AAsDA,MAAM,OAAyB;CAAE,QAAQ;CAAQ,QAAQ;CAAI,OAAO;AAAK;;AAGzE,SAAgB,kBAAkB,EAAE,IAAI,UAAU,QAAQ,KAAsC;CAC9F,MAAM,QAAQ,YAA8B,IAAI;CAChD,IAAI,aAAqC;CAEzC,SAAS,QAAQ;EACf,YAAY,MAAM;CACpB;CAEA,SAAS,QAAQ;EACf,MAAM;EACN,aAAa;EACb,MAAM,IAAI,IAAI;CAChB;CAEA,SAAS,aAAa;EACpB,MAAM,QAAQ,MAAM,IAAI;EACxB,IAAI,MAAM,UAAU,MAAM,MAAM,IAAI;GAAE,GAAG;GAAO,OAAO;EAAK,CAAC;CAC/D;CAEA,eAAe,IAAI,MAAgC;EACjD,MAAM;EACN,MAAM,MAAM,IAAI,gBAAgB;EAChC,aAAa;EACb,MAAM,IAAI;GAAE,QAAQ;GAAa,QAAQ;GAAI,OAAO;EAAK,CAAC;EAC1D,MAAM,UAAU,MAAM,UAAU,IAAI,YAAY;GAAE,GAAG;GAAM,OAAO,SAAS,SAAS,KAAK,KAAK,CAAC,IAAI;EAAE,GAAG;GACtG,QAAQ,IAAI;GACZ;GACA,UAAU,SAAS;IACjB,IAAI,eAAe,KAAK,MAAM,IAAI;KAAE,GAAG,MAAM,IAAI;KAAG,QAAQ,MAAM,IAAI,CAAC,CAAC,SAAS;IAAK,CAAC;GACzF;EACF,CAAC;EACD,IAAI,eAAe,KAAK;EACxB,aAAa;EACb,IAAI,QAAQ,WAAW,QACrB,MAAM,IAAI;GAAE,GAAG,MAAM,IAAI;GAAG,QAAQ;EAAO,CAAC;OAEzC,IAAI,QAAQ,WAAW,SAC1B,MAAM,IAAI;GAAE,GAAG,MAAM,IAAI;GAAG,QAAQ;GAAS,OAAO,QAAQ;EAAQ,CAAC;OAElE;GAEH,IAAI,QAAQ,WAAW,gBAAgB,oBAAoB,QAAQ,CAAC;GACpE,MAAM,IAAI;IAAE,GAAG,MAAM,IAAI;IAAG,QAAQ;GAAO,CAAC;EAC9C;CACF;CAEA,OAAO;EAAE,OAAO;EAAO;EAAK;EAAO;EAAO;CAAW;AACvD"}
+{"version":3,"file":"assistant.js","names":[],"sources":["../../../src/features/ai/assistant.ts"],"sourcesContent":["import type { EditorBackend } from '../../core/backend'\nimport type { AiBlock } from '../../core/feature'\nimport type { Notifier } from '../../core/notify'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport type { Translate } from '../../i18n'\nimport type { AiLanguage, ModelRole } from '../../settings'\nimport { postAiSse } from './ai-sse'\nimport { AI_TASKS, type AiBlockInput, type AiTaskId, type ModelRef } from './protocol'\nimport { notifyAiRateLimited } from './rate-limit'\n\nexport type AiStatus = 'idle' | 'streaming' | 'done' | 'error'\n\nexport interface AiRunBody {\n  task: AiTaskId\n  prompt: string\n  selection: string\n  context: string\n  language?: AiLanguage\n  /** The editor's host blocks (`aiContextOf(editor).blocks`), listed in the task's system prompt. */\n  blocks?: readonly AiBlock[]\n  /** The block of a `needsBlock` task (`fill-block`): its brief and material. */\n  block?: AiBlockInput\n}\n\n/** Snapshot of the running or last request: its status, the streamed text so far and the error message. */\nexport interface AiAssistantState {\n  status: AiStatus\n  output: string\n  error: string | null\n}\n\n/** What `createAiAssistant` needs from the app: the AI port, the model of a Model role, the notifier and translator for the 429 notice and failures. */\nexport interface AiAssistantOptions {\n  /** `EditorContext.backend.ai`; without it every run ends in the error state (501), like a server without AI. */\n  ai: EditorBackend['ai']\n  modelRef: (slot: ModelRole) => ModelRef\n  /** Receives the 429 notice. */\n  notify: Notifier\n  /** The app's translator (`EditorContext.t`). */\n  t: Translate\n}\n\n/** The streaming assistant: observe `state`, `run` a task, `abort`/`reset` it. */\nexport interface AiAssistant {\n  state: ReadonlyStore<AiAssistantState>\n  run: (body: AiRunBody) => Promise<void>\n  /** Stops the running request (its outcome is `idle`). */\n  abort: () => void\n  /** Aborts and returns to the empty `idle` state. */\n  reset: () => void\n  /** Clears the error message; the status stays. */\n  clearError: () => void\n}\n\nconst IDLE: AiAssistantState = { status: 'idle', output: '', error: null }\n\n/** Streams the backend's `generate` (SSE: `delta` / `done` / `error` events) into a store, on the task's Model role. */\nexport function createAiAssistant({ ai, modelRef, notify, t }: AiAssistantOptions): AiAssistant {\n  const store = createStore<AiAssistantState>(IDLE)\n  let controller: AbortController | null = null\n\n  function abort() {\n    controller?.abort()\n  }\n\n  function reset() {\n    abort()\n    controller = null\n    store.set(IDLE)\n  }\n\n  function clearError() {\n    const state = store.get()\n    if (state.error !== null) store.set({ ...state, error: null })\n  }\n\n  async function run(body: AiRunBody): Promise<void> {\n    reset()\n    const own = new AbortController()\n    controller = own\n    store.set({ status: 'streaming', output: '', error: null })\n    const outcome = await postAiSse(ai, 'generate', { ...body, model: modelRef(AI_TASKS[body.task].slot) }, {\n      signal: own.signal,\n      t,\n      onDelta: (text) => {\n        if (controller === own) store.set({ ...store.get(), output: store.get().output + text })\n      },\n    })\n    if (controller !== own) return // superseded by reset()/another run\n    controller = null\n    if (outcome.status === 'done') {\n      store.set({ ...store.get(), status: 'done' })\n    }\n    else if (outcome.status === 'error') {\n      store.set({ ...store.get(), status: 'error', error: outcome.message })\n    }\n    else {\n      // Notice instead of the error state on 429, so the caller stays ready for another try.\n      if (outcome.status === 'rate-limited') notifyAiRateLimited(notify, t)\n      store.set({ ...store.get(), status: 'idle' })\n    }\n  }\n\n  return { state: store, run, abort, reset, clearError }\n}\n"],"mappings":";;;;;AAsDA,MAAM,OAAyB;CAAE,QAAQ;CAAQ,QAAQ;CAAI,OAAO;AAAK;;AAGzE,SAAgB,kBAAkB,EAAE,IAAI,UAAU,QAAQ,KAAsC;CAC9F,MAAM,QAAQ,YAA8B,IAAI;CAChD,IAAI,aAAqC;CAEzC,SAAS,QAAQ;EACf,YAAY,MAAM;CACpB;CAEA,SAAS,QAAQ;EACf,MAAM;EACN,aAAa;EACb,MAAM,IAAI,IAAI;CAChB;CAEA,SAAS,aAAa;EACpB,MAAM,QAAQ,MAAM,IAAI;EACxB,IAAI,MAAM,UAAU,MAAM,MAAM,IAAI;GAAE,GAAG;GAAO,OAAO;EAAK,CAAC;CAC/D;CAEA,eAAe,IAAI,MAAgC;EACjD,MAAM;EACN,MAAM,MAAM,IAAI,gBAAgB;EAChC,aAAa;EACb,MAAM,IAAI;GAAE,QAAQ;GAAa,QAAQ;GAAI,OAAO;EAAK,CAAC;EAC1D,MAAM,UAAU,MAAM,UAAU,IAAI,YAAY;GAAE,GAAG;GAAM,OAAO,SAAS,SAAS,KAAK,KAAK,CAAC,IAAI;EAAE,GAAG;GACtG,QAAQ,IAAI;GACZ;GACA,UAAU,SAAS;IACjB,IAAI,eAAe,KAAK,MAAM,IAAI;KAAE,GAAG,MAAM,IAAI;KAAG,QAAQ,MAAM,IAAI,CAAC,CAAC,SAAS;IAAK,CAAC;GACzF;EACF,CAAC;EACD,IAAI,eAAe,KAAK;EACxB,aAAa;EACb,IAAI,QAAQ,WAAW,QACrB,MAAM,IAAI;GAAE,GAAG,MAAM,IAAI;GAAG,QAAQ;EAAO,CAAC;OAEzC,IAAI,QAAQ,WAAW,SAC1B,MAAM,IAAI;GAAE,GAAG,MAAM,IAAI;GAAG,QAAQ;GAAS,OAAO,QAAQ;EAAQ,CAAC;OAElE;GAEH,IAAI,QAAQ,WAAW,gBAAgB,oBAAoB,QAAQ,CAAC;GACpE,MAAM,IAAI;IAAE,GAAG,MAAM,IAAI;IAAG,QAAQ;GAAO,CAAC;EAC9C;CACF;CAEA,OAAO;EAAE,OAAO;EAAO;EAAK;EAAO;EAAO;CAAW;AACvD"}