@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/core/feature.d.ts

@@ -0,0 +1,234 @@
+import { ToolbarGroup } from "./toolbar.js";
+import { AbilitiesOptions, BlockAction, SlashCommandItem } from "./extension-points.js";
+import { ConvertTarget } from "./convert.js";
+import { Locale, Translate } from "../i18n/index.js";
+import { EditorSettings } from "../settings/index.js";
+import { Notifier } from "./notify.js";
+import { Store } from "./store.js";
+import { EditorAiConfig, EditorContext } from "./context.js";
+import { EditorUi } from "./editor-ui.js";
+import { EditorMetadata } from "./metadata-types.js";
+import { MetadataRegistry } from "./metadata.js";
+import { AnyExtension, Editor, JSONContent } from "@tiptap/core";
+import { EditorState, Transaction } from "@tiptap/pm/state";
+import { Node as Node$1, ResolvedPos } from "@tiptap/pm/model";
+import { $Fetch } from "ofetch";
+import * as Y from "yjs";
+import { HocuspocusProvider } from "@hocuspocus/provider";
+//#region src/core/feature.d.ts
+/** Stores an uploaded file and returns its URL (media feature). */
+export type UploadFn = (file: File) => Promise<{
+  url: string;
+}>;
+/**
+ * The user writing in an editor: the collaboration session's `user`, labelled on remote carets, and (authors and comments
+ * features) copied into the author mark of every text run and into every comment the user writes.
+ */
+export interface AuthorIdentity {
+  id: string;
+  name: string;
+  color: string;
+}
+/** A host-owned collaboration session handed to the surface; only the collab feature turns it into extensions. */
+export interface CollaborationSession {
+  ydoc: Y.Doc;
+  provider?: HocuspocusProvider;
+  user?: AuthorIdentity;
+  /**
+   * Token the collaboration server's `EditorAdapter.authenticate` receives (`{ headers, token }`), for clients without
+   * the session cookie of the server's origin (scripts, agents, cross-origin hosts). A string, or a function called
+   * every time the socket opens (so it can refresh an expired token). Applied to `provider`'s configuration when the
+   * surface is set up, which the provider reads when its socket opens: create the provider and mount the surface in the
+   * same tick, or give the provider its own `token` option instead.
+   */
+  token?: string | (() => string) | (() => Promise<string>);
+}
+/**
+ * A mapping between document positions and positions that survive collaborative edits. The collab feature supplies
+ * the Yjs implementation; without one, `DocAnchors` maps positions through local transactions only.
+ */
+export interface AnchorResolver {
+  /** The transaction applies a Yjs change to the document: remote edits and Yjs undo/redo. */
+  isYSync: (tr: Transaction) => boolean;
+  /** The transaction applies an edit of another client (excludes Yjs undo/redo). */
+  isRemoteChange: (tr: Transaction) => boolean;
+  /** Opaque token of `range` that `resolve` can turn back into positions after remote changes; null when unavailable. */
+  capture: (state: EditorState, range: {
+    from: number;
+    to: number;
+  }, startInside: boolean) => unknown | null;
+  resolve: (state: EditorState, token: unknown) => {
+    from: number;
+    to: number;
+  } | null;
+  /** Stops undo capturing around a programmatic change; true iff a Yjs undo manager exists. */
+  stopUndoCapture: (state: EditorState) => boolean;
+}
+/** Per-surface dependencies of a feature's factories. Created when a surface is set up; never shared between editors. */
+export interface FeatureContext {
+  /** The app context the surface belongs to (shared by all editors of the app): app-level models key on it. */
+  readonly app: EditorContext;
+  /** The app's shared settings (see `createEditorContext`): read with `get()`, write with `update()`, observe with `subscribe()`. */
+  readonly settings: Store<EditorSettings>;
+  readonly metadata: MetadataRegistry;
+  /** Chrome of the editor this context belongs to (settings, sidebar). */
+  readonly ui: EditorUi;
+  /** Shows a notice through the surface's framework (Nuxt UI toast, sonner). */
+  readonly notify: Notifier;
+  /** The app's UI language (`createEditorContext({ locale })`). */
+  readonly locale: Locale;
+  /** Renders a catalog message in the app's language; every label a feature contributes goes through it. */
+  readonly t: Translate;
+  readonly fetch: $Fetch;
+  /** Inert public AI configuration of the app context; absent when none was supplied. */
+  readonly ai: EditorAiConfig | undefined;
+  /** Document whose package stores uploads (media feature). */
+  readonly documentId: string | undefined;
+  readonly upload: UploadFn | undefined;
+  readonly collaboration: CollaborationSession | undefined;
+  /** The collaboration-aware position mapping of the preset's `anchorResolver` feature; null means local mapping only. */
+  readonly anchorResolver: AnchorResolver | null;
+  /** Host options for the ability extension (`abilities` prop). */
+  readonly abilities: Partial<AbilitiesOptions>;
+  /** The final `/` menu (features' commands run through the host's `slashCommands` transformer). */
+  readonly slashCommands: () => SlashCommandItem[];
+  /** Undefined while extensions are constructed; set once the editor exists. Use it in event handlers. */
+  getEditor: () => Editor | undefined;
+}
+/** A tab of the settings panel/modal, contributed by the feature that owns those settings. */
+export interface SettingsTab<C = unknown> {
+  id: string;
+  /** Already translated (`ctx.t(...)` in the feature's `settingsTabs` factory). */
+  label: string;
+  icon?: string;
+  component: C;
+  /** Props handed to `component`, e.g. the configured composite kinds. */
+  props?: Record<string, unknown>;
+}
+/** The stages `parseBlocks` and the import/AI insertion paths run; features replace stages, defaults are identity/Markdown. */
+export interface BlockPipeline {
+  parseMarkdown: (editor: Editor, markdown: string) => JSONContent[];
+  normalize: (editor: Editor, blocks: JSONContent[]) => JSONContent[];
+  segment: (editor: Editor, blocks: JSONContent[]) => JSONContent[];
+  structure: (editor: Editor, blocks: JSONContent[]) => JSONContent[];
+  wrapImport: (editor: Editor, file: File, blocks: JSONContent[]) => JSONContent[];
+  migrateContent: (content: JSONContent) => JSONContent;
+}
+/** Pipeline hooks that allow a single contributor; `normalize` chains instead. */
+export declare const SINGLETON_PIPELINE_HOOKS: readonly ["parseMarkdown", "segment", "structure", "wrapImport", "migrateContent"];
+/**
+ * A feature's block conversions. Targets keep the inert `ConvertTarget` shapes; the provider that parses a target id
+ * owns that target (labels, execution). `handlesSource` claims all conversions of source blocks it understands.
+ */
+export interface ConversionProvider {
+  /** Source blocks this provider converts to any target it can; the first provider claiming a node executes. */
+  handlesSource?: (node: Node$1) => boolean;
+  /** Targets offered for `node` in menus (excluding its current type). */
+  targets: (editor: Editor, node: Node$1) => ConvertTarget[];
+  /** The target of `id` when this provider owns it, else null. */
+  parseTarget: (id: string) => ConvertTarget | null;
+  /** Menu label (in the language of `t`) and icon of a target this provider owns. */
+  label: (target: ConvertTarget, t: Translate) => {
+    label: string;
+    icon: string;
+  } | null;
+  /** The conversion of the block after `start` into `target` (absolute range replaced and the converted blocks), or null. */
+  convert: (state: EditorState, start: ResolvedPos, target: ConvertTarget) => {
+    from: number;
+    to: number;
+    blocks: Node$1[];
+  } | null;
+}
+/**
+ * Inert public data AI reads about the editor's document model. A kind's `fields` carry what the model needs to write
+ * them (`type`, and the choices of a `select`).
+ */
+export interface AiContextKind {
+  id: string;
+  label: string;
+  fields: readonly {
+    key: string;
+    label: string;
+    type?: 'text' | 'textarea' | 'date' | 'number' | 'select';
+    options?: readonly {
+      value: string;
+      label: string;
+    }[];
+  }[];
+  /** The kind's `ai.purpose`, when configured. */
+  purpose?: string;
+}
+/** A host block as AI learns it: what it is for, its Markdown form and one example. `id` is the node type name and the `convert` target id. */
+export interface AiBlock {
+  id: string;
+  label: string;
+  /** One or two German sentences: purpose and what it may contain. */
+  description: string;
+  /** The Markdown form, placeholders in angle brackets, e.g. `!!! <info|warning|success>\n<Inhalt>`. */
+  syntax: string;
+  /** One complete Markdown example of the block. */
+  example: string;
+}
+export interface AiContext {
+  kinds?: readonly AiContextKind[];
+  blocks?: readonly AiBlock[];
+  structure?: 'flat' | 'composite';
+}
+/** One piece of material a feature fetched for a block before the model fills it (a host's examples, a record). */
+export interface AiBlockDatum {
+  label: string;
+  text: string;
+}
+export interface AiBlockDataRequest {
+  editor: Editor;
+  node: Node$1;
+  pos: number;
+  signal: AbortSignal;
+}
+/** Material for one block; `signal` aborts when the editor is destroyed or the run is cancelled. */
+export type AiBlockDataProvider = (request: AiBlockDataRequest) => Promise<readonly AiBlockDatum[]> | readonly AiBlockDatum[];
+/** One independently importable capability. Every member is optional; identity and ordering come from the feature list. */
+export interface EditorFeature<C = unknown> {
+  id: string;
+  /** Ids of features that must also be installed (`defineEditor` does not install them). */
+  requires?: readonly string[];
+  extensions?: (ctx: FeatureContext) => AnyExtension[];
+  toolbar?: (ctx: FeatureContext) => ToolbarGroup<C>[];
+  blockActions?: (ctx: FeatureContext) => BlockAction[];
+  slashCommands?: (ctx: FeatureContext) => SlashCommandItem[];
+  /** Components mounted beside the editor content; they receive `{ editor }`. `C` is the component type of the framework layer that renders them. */
+  overlays?: readonly C[];
+  /**
+   * Runs once when a surface mounts (per-app side effects, e.g. a theme runtime; dedupe inside). Returns the teardown,
+   * called when the surface unmounts; it must be idempotent (React StrictMode mounts twice).
+   */
+  setup?: (ctx: FeatureContext) => void | (() => void);
+  /** The feature's settings tabs. A factory over the app context, so labels render in the context's language. */
+  settingsTabs?: (ctx: EditorContext) => readonly SettingsTab<C>[];
+  /** Built-in metadata lists (`mentions`, `hashtags`, `speakers`, …) used for every list name the host does not supply; searched only when a suggestion uses them. */
+  metadataDefaults?: (ctx: FeatureContext) => EditorMetadata;
+  blocks?: Partial<BlockPipeline>;
+  conversions?: readonly ConversionProvider[];
+  /** At most one contributor: supplies the collaboration-aware position mapping to `DocAnchors`. */
+  anchorResolver?: (ctx: FeatureContext) => AnchorResolver;
+  /** Additive: the contributions of all features are merged (`kinds` and `blocks` concatenated in feature order; `structure` may be set by one feature only). Reads AI's view of the document model. */
+  aiContext?: (editor: Editor) => AiContext;
+  /** Additive: every contributor runs for the block (in parallel), their data concatenate in feature order; one rejection fails the whole fill. Read by „Baustein füllen (KI)“. */
+  aiBlockData?: AiBlockDataProvider;
+  /** At most one contributor: formats an AI result's markdown before the generic pipeline. */
+  formatAiResult?: (editor: Editor, markdown: string, heading?: string) => string;
+}
+/** An immutable, validated feature list with its resolved pipeline, conversion providers and AI hooks. */
+export interface EditorPreset<C = unknown> {
+  readonly features: readonly EditorFeature<C>[];
+  readonly pipeline: BlockPipeline;
+  readonly conversions: readonly ConversionProvider[];
+  /** All `aiContext` contributions merged (`aiContextOf`). */
+  readonly aiContext?: EditorFeature['aiContext'];
+  /** All `aiBlockData` contributions merged (`aiBlockDataOf`). */
+  readonly aiBlockData?: AiBlockDataProvider;
+  /** The single `formatAiResult` contributor, if any. */
+  readonly formatAiResult?: EditorFeature['formatAiResult'];
+}
+//#endregion
+//# sourceMappingURL=feature.d.ts.map

package/dist/core/feature.js

@@ -0,0 +1,13 @@
+//#region src/core/feature.ts
+/** Pipeline hooks that allow a single contributor; `normalize` chains instead. */
+const SINGLETON_PIPELINE_HOOKS = [
+	"parseMarkdown",
+	"segment",
+	"structure",
+	"wrapImport",
+	"migrateContent"
+];
+//#endregion
+export { SINGLETON_PIPELINE_HOOKS };
+
+//# sourceMappingURL=feature.js.map

package/dist/core/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","names":[],"sources":["../../src/core/feature.ts"],"sourcesContent":["import type { HocuspocusProvider } from '@hocuspocus/provider'\nimport type { AnyExtension, Editor, JSONContent } from '@tiptap/core'\nimport type { Node as PMNode, ResolvedPos } from '@tiptap/pm/model'\nimport type { EditorState, Transaction } from '@tiptap/pm/state'\nimport type { $Fetch } from 'ofetch'\nimport type * as Y from 'yjs'\nimport type { Locale, Translate } from '../i18n'\nimport type { EditorSettings } from '../settings'\nimport type { EditorAiConfig, EditorContext } from './context'\nimport type { ConvertTarget } from './convert'\nimport type { EditorUi } from './editor-ui'\nimport type { AbilitiesOptions, BlockAction, SlashCommandItem } from './extension-points'\nimport type { MetadataRegistry } from './metadata'\nimport type { Notifier } from './notify'\nimport type { EditorMetadata } from './metadata-types'\nimport type { Store } from './store'\nimport type { ToolbarGroup } from './toolbar'\n\n// The composition contracts: an `EditorFeature` contributes extensions and descriptors, `defineEditor` validates a\n// feature list into an immutable `EditorPreset`, and `EditorSurface` mounts one. Everything here is inert data and\n// types; features only differ by which of these seams they fill.\n\n/** Stores an uploaded file and returns its URL (media feature). */\nexport type UploadFn = (file: File) => Promise<{ url: string }>\n\n/**\n * The user writing in an editor: the collaboration session's `user`, labelled on remote carets, and (authors and comments\n * features) copied into the author mark of every text run and into every comment the user writes.\n */\nexport interface AuthorIdentity {\n  id: string\n  name: string\n  color: string\n}\n\n/** A host-owned collaboration session handed to the surface; only the collab feature turns it into extensions. */\nexport interface CollaborationSession {\n  ydoc: Y.Doc\n  provider?: HocuspocusProvider\n  user?: AuthorIdentity\n  /**\n   * Token the collaboration server's `EditorAdapter.authenticate` receives (`{ headers, token }`), for clients without\n   * the session cookie of the server's origin (scripts, agents, cross-origin hosts). A string, or a function called\n   * every time the socket opens (so it can refresh an expired token). Applied to `provider`'s configuration when the\n   * surface is set up, which the provider reads when its socket opens: create the provider and mount the surface in the\n   * same tick, or give the provider its own `token` option instead.\n   */\n  token?: string | (() => string) | (() => Promise<string>)\n}\n\n/**\n * A mapping between document positions and positions that survive collaborative edits. The collab feature supplies\n * the Yjs implementation; without one, `DocAnchors` maps positions through local transactions only.\n */\nexport interface AnchorResolver {\n  /** The transaction applies a Yjs change to the document: remote edits and Yjs undo/redo. */\n  isYSync: (tr: Transaction) => boolean\n  /** The transaction applies an edit of another client (excludes Yjs undo/redo). */\n  isRemoteChange: (tr: Transaction) => boolean\n  /** Opaque token of `range` that `resolve` can turn back into positions after remote changes; null when unavailable. */\n  capture: (state: EditorState, range: { from: number, to: number }, startInside: boolean) => unknown | null\n  resolve: (state: EditorState, token: unknown) => { from: number, to: number } | null\n  /** Stops undo capturing around a programmatic change; true iff a Yjs undo manager exists. */\n  stopUndoCapture: (state: EditorState) => boolean\n}\n\n/** Per-surface dependencies of a feature's factories. Created when a surface is set up; never shared between editors. */\nexport interface FeatureContext {\n  /** The app context the surface belongs to (shared by all editors of the app): app-level models key on it. */\n  readonly app: EditorContext\n  /** The app's shared settings (see `createEditorContext`): read with `get()`, write with `update()`, observe with `subscribe()`. */\n  readonly settings: Store<EditorSettings>\n  readonly metadata: MetadataRegistry\n  /** Chrome of the editor this context belongs to (settings, sidebar). */\n  readonly ui: EditorUi\n  /** Shows a notice through the surface's framework (Nuxt UI toast, sonner). */\n  readonly notify: Notifier\n  /** The app's UI language (`createEditorContext({ locale })`). */\n  readonly locale: Locale\n  /** Renders a catalog message in the app's language; every label a feature contributes goes through it. */\n  readonly t: Translate\n  readonly fetch: $Fetch\n  /** Inert public AI configuration of the app context; absent when none was supplied. */\n  readonly ai: EditorAiConfig | undefined\n  /** Document whose package stores uploads (media feature). */\n  readonly documentId: string | undefined\n  readonly upload: UploadFn | undefined\n  readonly collaboration: CollaborationSession | undefined\n  /** The collaboration-aware position mapping of the preset's `anchorResolver` feature; null means local mapping only. */\n  readonly anchorResolver: AnchorResolver | null\n  /** Host options for the ability extension (`abilities` prop). */\n  readonly abilities: Partial<AbilitiesOptions>\n  /** The final `/` menu (features' commands run through the host's `slashCommands` transformer). */\n  readonly slashCommands: () => SlashCommandItem[]\n  /** Undefined while extensions are constructed; set once the editor exists. Use it in event handlers. */\n  getEditor: () => Editor | undefined\n}\n\n/** A tab of the settings panel/modal, contributed by the feature that owns those settings. */\nexport interface SettingsTab<C = unknown> {\n  id: string\n  /** Already translated (`ctx.t(...)` in the feature's `settingsTabs` factory). */\n  label: string\n  icon?: string\n  component: C\n  /** Props handed to `component`, e.g. the configured composite kinds. */\n  props?: Record<string, unknown>\n}\n\n/** The stages `parseBlocks` and the import/AI insertion paths run; features replace stages, defaults are identity/Markdown. */\nexport interface BlockPipeline {\n  parseMarkdown: (editor: Editor, markdown: string) => JSONContent[]\n  normalize: (editor: Editor, blocks: JSONContent[]) => JSONContent[]\n  segment: (editor: Editor, blocks: JSONContent[]) => JSONContent[]\n  structure: (editor: Editor, blocks: JSONContent[]) => JSONContent[]\n  wrapImport: (editor: Editor, file: File, blocks: JSONContent[]) => JSONContent[]\n  migrateContent: (content: JSONContent) => JSONContent\n}\n\n/** Pipeline hooks that allow a single contributor; `normalize` chains instead. */\nexport const SINGLETON_PIPELINE_HOOKS = ['parseMarkdown', 'segment', 'structure', 'wrapImport', 'migrateContent'] as const satisfies readonly (keyof BlockPipeline)[]\n\n/**\n * A feature's block conversions. Targets keep the inert `ConvertTarget` shapes; the provider that parses a target id\n * owns that target (labels, execution). `handlesSource` claims all conversions of source blocks it understands.\n */\nexport interface ConversionProvider {\n  /** Source blocks this provider converts to any target it can; the first provider claiming a node executes. */\n  handlesSource?: (node: PMNode) => boolean\n  /** Targets offered for `node` in menus (excluding its current type). */\n  targets: (editor: Editor, node: PMNode) => ConvertTarget[]\n  /** The target of `id` when this provider owns it, else null. */\n  parseTarget: (id: string) => ConvertTarget | null\n  /** Menu label (in the language of `t`) and icon of a target this provider owns. */\n  label: (target: ConvertTarget, t: Translate) => { label: string, icon: string } | null\n  /** The conversion of the block after `start` into `target` (absolute range replaced and the converted blocks), or null. */\n  convert: (state: EditorState, start: ResolvedPos, target: ConvertTarget) => { from: number, to: number, blocks: PMNode[] } | null\n}\n\n/**\n * Inert public data AI reads about the editor's document model. A kind's `fields` carry what the model needs to write\n * them (`type`, and the choices of a `select`).\n */\nexport interface AiContextKind {\n  id: string\n  label: string\n  fields: readonly { key: string, label: string, type?: 'text' | 'textarea' | 'date' | 'number' | 'select', options?: readonly { value: string, label: string }[] }[]\n  /** The kind's `ai.purpose`, when configured. */\n  purpose?: string\n}\n\n/** A host block as AI learns it: what it is for, its Markdown form and one example. `id` is the node type name and the `convert` target id. */\nexport interface AiBlock {\n  id: string\n  label: string\n  /** One or two German sentences: purpose and what it may contain. */\n  description: string\n  /** The Markdown form, placeholders in angle brackets, e.g. `!!! <info|warning|success>\\n<Inhalt>`. */\n  syntax: string\n  /** One complete Markdown example of the block. */\n  example: string\n}\n\nexport interface AiContext {\n  kinds?: readonly AiContextKind[]\n  blocks?: readonly AiBlock[]\n  structure?: 'flat' | 'composite'\n}\n\n/** One piece of material a feature fetched for a block before the model fills it (a host's examples, a record). */\nexport interface AiBlockDatum { label: string, text: string }\nexport interface AiBlockDataRequest { editor: Editor, node: PMNode, pos: number, signal: AbortSignal }\n/** Material for one block; `signal` aborts when the editor is destroyed or the run is cancelled. */\nexport type AiBlockDataProvider = (request: AiBlockDataRequest) => Promise<readonly AiBlockDatum[]> | readonly AiBlockDatum[]\n\n/** One independently importable capability. Every member is optional; identity and ordering come from the feature list. */\nexport interface EditorFeature<C = unknown> {\n  id: string\n  /** Ids of features that must also be installed (`defineEditor` does not install them). */\n  requires?: readonly string[]\n  extensions?: (ctx: FeatureContext) => AnyExtension[]\n  toolbar?: (ctx: FeatureContext) => ToolbarGroup<C>[]\n  blockActions?: (ctx: FeatureContext) => BlockAction[]\n  slashCommands?: (ctx: FeatureContext) => SlashCommandItem[]\n  /** Components mounted beside the editor content; they receive `{ editor }`. `C` is the component type of the framework layer that renders them. */\n  overlays?: readonly C[]\n  /**\n   * Runs once when a surface mounts (per-app side effects, e.g. a theme runtime; dedupe inside). Returns the teardown,\n   * called when the surface unmounts; it must be idempotent (React StrictMode mounts twice).\n   */\n  setup?: (ctx: FeatureContext) => void | (() => void)\n  /** The feature's settings tabs. A factory over the app context, so labels render in the context's language. */\n  settingsTabs?: (ctx: EditorContext) => readonly SettingsTab<C>[]\n  /** Built-in metadata lists (`mentions`, `hashtags`, `speakers`, …) used for every list name the host does not supply; searched only when a suggestion uses them. */\n  metadataDefaults?: (ctx: FeatureContext) => EditorMetadata\n  blocks?: Partial<BlockPipeline>\n  conversions?: readonly ConversionProvider[]\n  /** At most one contributor: supplies the collaboration-aware position mapping to `DocAnchors`. */\n  anchorResolver?: (ctx: FeatureContext) => AnchorResolver\n  /** Additive: the contributions of all features are merged (`kinds` and `blocks` concatenated in feature order; `structure` may be set by one feature only). Reads AI's view of the document model. */\n  aiContext?: (editor: Editor) => AiContext\n  /** Additive: every contributor runs for the block (in parallel), their data concatenate in feature order; one rejection fails the whole fill. Read by „Baustein füllen (KI)“. */\n  aiBlockData?: AiBlockDataProvider\n  /** At most one contributor: formats an AI result's markdown before the generic pipeline. */\n  formatAiResult?: (editor: Editor, markdown: string, heading?: string) => string\n}\n\n/** An immutable, validated feature list with its resolved pipeline, conversion providers and AI hooks. */\nexport interface EditorPreset<C = unknown> {\n  readonly features: readonly EditorFeature<C>[]\n  readonly pipeline: BlockPipeline\n  readonly conversions: readonly ConversionProvider[]\n  /** All `aiContext` contributions merged (`aiContextOf`). */\n  readonly aiContext?: EditorFeature['aiContext']\n  /** All `aiBlockData` contributions merged (`aiBlockDataOf`). */\n  readonly aiBlockData?: AiBlockDataProvider\n  /** The single `formatAiResult` contributor, if any. */\n  readonly formatAiResult?: EditorFeature['formatAiResult']\n}\n"],"mappings":";;AAwHA,MAAa,2BAA2B;CAAC;CAAiB;CAAW;CAAa;CAAc;AAAgB"}

package/dist/core/fences.d.ts

@@ -0,0 +1,16 @@
+import { JSONContent } from "@tiptap/core";
+//#region src/core/fences.d.ts
+/** A well-formed fence: its kind, JSON meta, inner text and the exact source text, opener line through closer line. */
+export interface CompositeFence {
+  kind: string;
+  meta: Record<string, unknown>;
+  inner: string;
+  raw: string;
+}
+export type FenceSegment = {
+  markdown: string;
+} | CompositeFence;
+/** The fences of `markdown` (see `splitFences`) without the problem report. */
+export declare const splitCompositeFences: (markdown: string) => FenceSegment[];
+//#endregion
+//# sourceMappingURL=fences.d.ts.map

package/dist/core/fences.js

@@ -0,0 +1,105 @@
+//#region src/core/fences.ts
+const OPENER = /^\s*:::[ \t]*([\p{L}\p{N}_-]+)[ \t]*(\{.*\})?[ \t]*$/u;
+const CLOSER = /^\s*:::\s*$/;
+const CODE_FENCE = /^ {0,3}(`{3,}|~{3,})/;
+function parseMeta(json) {
+	if (!json) return {};
+	try {
+		const value = JSON.parse(json);
+		return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+	} catch {
+		return null;
+	}
+}
+/** For every line whether it is part of a ``` / ~~~ code fence (the fence lines included). */
+function codeLines(lines) {
+	const inside = [];
+	let open = null;
+	for (const line of lines) {
+		const match = CODE_FENCE.exec(line);
+		if (!open) {
+			if (match) open = {
+				char: match[1][0],
+				length: match[1].length
+			};
+			inside.push(open !== null);
+			continue;
+		}
+		inside.push(true);
+		const closing = /^ {0,3}(`{3,}|~{3,})\s*$/.exec(line);
+		if (closing && closing[1][0] === open.char && closing[1].length >= open.length) open = null;
+	}
+	return inside;
+}
+/** Splits `::: kind {json}` … `:::` fences (nestable) into segments; text outside fences stays markdown. `problems` lists the opener lines that stayed plain text. */
+function splitFences(markdown) {
+	const lines = markdown.split("\n");
+	const code = codeLines(lines);
+	const segments = [];
+	const problems = [];
+	let plain = [];
+	const flush = () => {
+		if (plain.join("").trim()) segments.push({ markdown: plain.join("\n") });
+		plain = [];
+	};
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		const match = code[i] ? null : OPENER.exec(line);
+		const meta = match ? parseMeta(match[2]) : null;
+		if (!match || !meta) {
+			if (match) problems.push({
+				code: "invalid-fence-meta",
+				line: i + 1,
+				kind: match[1]
+			});
+			plain.push(line);
+			i++;
+			continue;
+		}
+		let depth = 1;
+		let end = i + 1;
+		for (; end < lines.length; end++) {
+			if (code[end]) continue;
+			if (OPENER.test(lines[end])) depth++;
+			else if (CLOSER.test(lines[end]) && --depth === 0) break;
+		}
+		if (depth) {
+			problems.push({
+				code: "unclosed-fence",
+				line: i + 1,
+				kind: match[1]
+			});
+			plain.push(line);
+			i++;
+			continue;
+		}
+		flush();
+		segments.push({
+			kind: match[1],
+			meta,
+			inner: lines.slice(i + 1, end).join("\n"),
+			raw: lines.slice(i, end + 1).join("\n")
+		});
+		i = end + 1;
+	}
+	flush();
+	return {
+		segments,
+		problems
+	};
+}
+/** The fences of `markdown` (see `splitFences`) without the problem report. */
+const splitCompositeFences = (markdown) => splitFences(markdown).segments;
+/** An opaque fence node: `raw` is the fence's source text, written back verbatim by the Markdown serializer. */
+const opaqueFenceJSON = (fence) => ({
+	type: "opaqueFence",
+	attrs: {
+		kind: fence.kind,
+		raw: fence.raw
+	}
+});
+//#endregion
+export { opaqueFenceJSON, splitCompositeFences, splitFences };
+
+//# sourceMappingURL=fences.js.map

package/dist/core/fences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fences.js","names":[],"sources":["../../src/core/fences.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\n\n// The `::: kind {meta}` … `:::` fence grammar of Markdown documents, shared by the composite feature (registered kinds\n// become composites) and the Markdown entry (every other kind stays an `opaqueFence`). Nested fences close with the\n// same bare `:::`, so a closer always ends the innermost open fence. Lines inside ``` / ~~~ code fences are never fence\n// syntax.\n\n/** A well-formed fence: its kind, JSON meta, inner text and the exact source text, opener line through closer line. */\nexport interface CompositeFence { kind: string, meta: Record<string, unknown>, inner: string, raw: string }\nexport type FenceSegment = { markdown: string } | CompositeFence\n\n/** A fence-like construct that did not become a fence: `invalid-fence-meta` (the `{…}` after the kind is no JSON object) or `unclosed-fence` (no matching `:::`). `line` is 1-based. */\nexport interface FenceProblem { code: 'invalid-fence-meta' | 'unclosed-fence', line: number, kind: string }\n\nconst OPENER = /^\\s*:::[ \\t]*([\\p{L}\\p{N}_-]+)[ \\t]*(\\{.*\\})?[ \\t]*$/u\nconst CLOSER = /^\\s*:::\\s*$/\nconst CODE_FENCE = /^ {0,3}(`{3,}|~{3,})/\n\nfunction parseMeta(json: string | undefined): Record<string, unknown> | null {\n  if (!json) return {}\n  try {\n    const value: unknown = JSON.parse(json)\n    return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : null\n  }\n  catch {\n    return null\n  }\n}\n\n/** For every line whether it is part of a ``` / ~~~ code fence (the fence lines included). */\nfunction codeLines(lines: readonly string[]): boolean[] {\n  const inside: boolean[] = []\n  let open: { char: string, length: number } | null = null\n  for (const line of lines) {\n    const match = CODE_FENCE.exec(line)\n    if (!open) {\n      if (match) open = { char: match[1]![0]!, length: match[1]!.length }\n      inside.push(open !== null)\n      continue\n    }\n    inside.push(true)\n    const closing = /^ {0,3}(`{3,}|~{3,})\\s*$/.exec(line)\n    if (closing && closing[1]![0] === open.char && closing[1]!.length >= open.length) open = null\n  }\n  return inside\n}\n\n/** Splits `::: kind {json}` … `:::` fences (nestable) into segments; text outside fences stays markdown. `problems` lists the opener lines that stayed plain text. */\nexport function splitFences(markdown: string): { segments: FenceSegment[], problems: FenceProblem[] } {\n  const lines = markdown.split('\\n')\n  const code = codeLines(lines)\n  const segments: FenceSegment[] = []\n  const problems: FenceProblem[] = []\n  let plain: string[] = []\n  const flush = () => {\n    if (plain.join('').trim()) segments.push({ markdown: plain.join('\\n') })\n    plain = []\n  }\n  let i = 0\n  while (i < lines.length) {\n    const line = lines[i]!\n    const match = code[i] ? null : OPENER.exec(line)\n    const meta = match ? parseMeta(match[2]) : null\n    if (!match || !meta) {\n      if (match) problems.push({ code: 'invalid-fence-meta', line: i + 1, kind: match[1]! })\n      plain.push(line)\n      i++\n      continue\n    }\n    // Find the matching closer, counting nested openers; none → the opener line stays plain text.\n    let depth = 1\n    let end = i + 1\n    for (; end < lines.length; end++) {\n      if (code[end]) continue\n      if (OPENER.test(lines[end]!)) depth++\n      else if (CLOSER.test(lines[end]!) && --depth === 0) break\n    }\n    if (depth) {\n      problems.push({ code: 'unclosed-fence', line: i + 1, kind: match[1]! })\n      plain.push(line)\n      i++\n      continue\n    }\n    flush()\n    segments.push({ kind: match[1]!, meta, inner: lines.slice(i + 1, end).join('\\n'), raw: lines.slice(i, end + 1).join('\\n') })\n    i = end + 1\n  }\n  flush()\n  return { segments, problems }\n}\n\n/** The fences of `markdown` (see `splitFences`) without the problem report. */\nexport const splitCompositeFences = (markdown: string): FenceSegment[] => splitFences(markdown).segments\n\n/** An opaque fence node: `raw` is the fence's source text, written back verbatim by the Markdown serializer. */\nexport const opaqueFenceJSON = (fence: CompositeFence): JSONContent => ({ type: 'opaqueFence', attrs: { kind: fence.kind, raw: fence.raw } })\n"],"mappings":";AAcA,MAAM,SAAS;AACf,MAAM,SAAS;AACf,MAAM,aAAa;AAEnB,SAAS,UAAU,MAA0D;CAC3E,IAAI,CAAC,MAAM,OAAO,CAAC;CACnB,IAAI;EACF,MAAM,QAAiB,KAAK,MAAM,IAAI;EACtC,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAI,QAAmC;CAC1G,QACM;EACJ,OAAO;CACT;AACF;;AAGA,SAAS,UAAU,OAAqC;CACtD,MAAM,SAAoB,CAAC;CAC3B,IAAI,OAAgD;CACpD,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,WAAW,KAAK,IAAI;EAClC,IAAI,CAAC,MAAM;GACT,IAAI,OAAO,OAAO;IAAE,MAAM,MAAM,EAAE,CAAE;IAAK,QAAQ,MAAM,EAAE,CAAE;GAAO;GAClE,OAAO,KAAK,SAAS,IAAI;GACzB;EACF;EACA,OAAO,KAAK,IAAI;EAChB,MAAM,UAAU,2BAA2B,KAAK,IAAI;EACpD,IAAI,WAAW,QAAQ,EAAE,CAAE,OAAO,KAAK,QAAQ,QAAQ,EAAE,CAAE,UAAU,KAAK,QAAQ,OAAO;CAC3F;CACA,OAAO;AACT;;AAGA,SAAgB,YAAY,UAA0E;CACpG,MAAM,QAAQ,SAAS,MAAM,IAAI;CACjC,MAAM,OAAO,UAAU,KAAK;CAC5B,MAAM,WAA2B,CAAC;CAClC,MAAM,WAA2B,CAAC;CAClC,IAAI,QAAkB,CAAC;CACvB,MAAM,cAAc;EAClB,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,SAAS,KAAK,EAAE,UAAU,MAAM,KAAK,IAAI,EAAE,CAAC;EACvE,QAAQ,CAAC;CACX;CACA,IAAI,IAAI;CACR,OAAO,IAAI,MAAM,QAAQ;EACvB,MAAM,OAAO,MAAM;EACnB,MAAM,QAAQ,KAAK,KAAK,OAAO,OAAO,KAAK,IAAI;EAC/C,MAAM,OAAO,QAAQ,UAAU,MAAM,EAAE,IAAI;EAC3C,IAAI,CAAC,SAAS,CAAC,MAAM;GACnB,IAAI,OAAO,SAAS,KAAK;IAAE,MAAM;IAAsB,MAAM,IAAI;IAAG,MAAM,MAAM;GAAI,CAAC;GACrF,MAAM,KAAK,IAAI;GACf;GACA;EACF;EAEA,IAAI,QAAQ;EACZ,IAAI,MAAM,IAAI;EACd,OAAO,MAAM,MAAM,QAAQ,OAAO;GAChC,IAAI,KAAK,MAAM;GACf,IAAI,OAAO,KAAK,MAAM,IAAK,GAAG;QACzB,IAAI,OAAO,KAAK,MAAM,IAAK,KAAK,EAAE,UAAU,GAAG;EACtD;EACA,IAAI,OAAO;GACT,SAAS,KAAK;IAAE,MAAM;IAAkB,MAAM,IAAI;IAAG,MAAM,MAAM;GAAI,CAAC;GACtE,MAAM,KAAK,IAAI;GACf;GACA;EACF;EACA,MAAM;EACN,SAAS,KAAK;GAAE,MAAM,MAAM;GAAK;GAAM,OAAO,MAAM,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI;GAAG,KAAK,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;EAAE,CAAC;EAC3H,IAAI,MAAM;CACZ;CACA,MAAM;CACN,OAAO;EAAE;EAAU;CAAS;AAC9B;;AAGA,MAAa,wBAAwB,aAAqC,YAAY,QAAQ,CAAC,CAAC;;AAGhG,MAAa,mBAAmB,WAAwC;CAAE,MAAM;CAAe,OAAO;EAAE,MAAM,MAAM;EAAM,KAAK,MAAM;CAAI;AAAE"}

package/dist/core/fetch-error.d.ts

@@ -0,0 +1,5 @@
+//#region src/core/fetch-error.d.ts
+/** Human-readable message for a failed HTTP request: the server's error message if it sent one. */
+export declare function fetchErrorMessage(error: unknown): string;
+//#endregion
+//# sourceMappingURL=fetch-error.d.ts.map

package/dist/core/fetch-error.js

@@ -0,0 +1,11 @@
+//#region src/core/fetch-error.ts
+/** Human-readable message for a failed HTTP request: the server's error message if it sent one. */
+function fetchErrorMessage(error) {
+	const serverMessage = error?.data?.message;
+	if (typeof serverMessage === "string" && serverMessage) return serverMessage;
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+export { fetchErrorMessage };
+
+//# sourceMappingURL=fetch-error.js.map

package/dist/core/fetch-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-error.js","names":[],"sources":["../../src/core/fetch-error.ts"],"sourcesContent":["/** Human-readable message for a failed HTTP request: the server's error message if it sent one. */\nexport function fetchErrorMessage(error: unknown): string {\n  const serverMessage = (error as { data?: { message?: unknown } } | null)?.data?.message\n  if (typeof serverMessage === 'string' && serverMessage) return serverMessage\n  return error instanceof Error ? error.message : String(error)\n}\n"],"mappings":";;AACA,SAAgB,kBAAkB,OAAwB;CACxD,MAAM,gBAAiB,OAAmD,MAAM;CAChF,IAAI,OAAO,kBAAkB,YAAY,eAAe,OAAO;CAC/D,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D"}

package/dist/core/index.d.ts

@@ -0,0 +1,28 @@
+import { MenuItem, ToolbarGroup, ToolbarItem, commandItem, mergeToolbarGroups } from "./toolbar.js";
+import { AbilitiesOptions, BlockAction, BlockActionContext, BlockTarget, SlashCommandItem } from "./extension-points.js";
+import { Abilities, AbilitiesStorage, DEFAULT_ABILITY_RULES, abilitiesAt, abilitiesAtSelection, hasAbility } from "./abilities.js";
+import { CORE_TARGET_IDS, ConvertTarget, Converter, ForeignBlocks, TextblockSpec, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
+import { CATALOGS, DEFAULT_LOCALE, LOCALES, Locale, MessageKey, MessageParams, Messages, Translate, createTranslator, isLocale } from "../i18n/index.js";
+import { Notice, Notifier, silentNotifier } from "./notify.js";
+import { ReadonlyStore, Store, createStore, derived } from "./store.js";
+import { EditorAiConfig, EditorContext, EditorContextOptions, createEditorContext } from "./context.js";
+import { EditorEntry, EditorUi, editorEntryOf, notifierOf, registerEditor } from "./editor-ui.js";
+import { EditorMetadata, METADATA_LIST, MetadataItem, MetadataQuery, MetadataSource } from "./metadata-types.js";
+import { Metadata, MetadataRegistry, createMetadataRegistry, filterMetadataItems, metadataOf } from "./metadata.js";
+import { AiBlock, AiBlockDataProvider, AiBlockDataRequest, AiBlockDatum, AiContext, AiContextKind, AnchorResolver, AuthorIdentity, BlockPipeline, CollaborationSession, ConversionProvider, EditorFeature, EditorPreset, FeatureContext, SINGLETON_PIPELINE_HOOKS, SettingsTab, UploadFn } from "./feature.js";
+import { BlockConvert, blockConversion, conversionLabel, conversionTargetGroups, convertMenuItems, coreConversions, parseConversionTarget, targetOwner } from "./block-convert.js";
+import { startBlockDrag } from "./block-drag.js";
+import { BlockFlash } from "./block-flash.js";
+import { coreBlockActions, coreFeature } from "./core-feature.js";
+import { contributions, defineEditor, settingsTabsOf } from "./define-editor.js";
+import { DocumentMarkdown } from "./document-markdown.js";
+import { downloadText } from "./download.js";
+import { DocAnchor, DocAnchors, DocAnchorsMeta, DocAnchorsOptions, anchorResolverOf, captureRange, docAnchorsKey, releaseRanges, resolveRange } from "./doc-anchors.js";
+import { FeatureContextOptions, blockActionsOf, createFeatureContext } from "./feature-context.js";
+import { fetchErrorMessage } from "./fetch-error.js";
+import { DEFAULT_BLOCK_PIPELINE, PresetStorage, aiBlockDataOf, aiContextOf, conversionsOf, formatAiResultOf, parseBlocks, pipelineOf, presetExtension, structureBlocks, wrapImportBlocks } from "./pipeline.js";
+import { selectionRange } from "./selection-range.js";
+import { SlashCommand, SlashCommandOptions, SlashCommandPluginKey } from "./slash.js";
+import { SuggestionDisplay, SuggestionListProps, SuggestionPopup, SuggestionPopupHandle, SuggestionPopupRenderer, createSuggestionRender, suggestionPopupOf } from "./suggestion-popup.js";
+import { coreToolbarGroups } from "./toolbar-items.js";
+export { Abilities, type AbilitiesOptions, type AbilitiesStorage, type AiBlock, type AiBlockDataProvider, type AiBlockDataRequest, type AiBlockDatum, type AiContext, type AiContextKind, type AnchorResolver, type AuthorIdentity, type BlockAction, type BlockActionContext, BlockConvert, BlockFlash, type BlockPipeline, type BlockTarget, CATALOGS, CORE_TARGET_IDS, type CollaborationSession, type ConversionProvider, type ConvertTarget, type Converter, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, type DocAnchor, DocAnchors, type DocAnchorsMeta, type DocAnchorsOptions, DocumentMarkdown, type EditorAiConfig, type EditorContext, type EditorContextOptions, type EditorEntry, type EditorFeature, type EditorMetadata, type EditorPreset, type EditorUi, type FeatureContext, type FeatureContextOptions, type ForeignBlocks, LOCALES, type Locale, METADATA_LIST, type MenuItem, type MessageKey, type MessageParams, type Messages, Metadata, type MetadataItem, type MetadataQuery, type MetadataRegistry, type MetadataSource, type Notice, type Notifier, type PresetStorage, type ReadonlyStore, SINGLETON_PIPELINE_HOOKS, type SettingsTab, SlashCommand, type SlashCommandItem, type SlashCommandOptions, SlashCommandPluginKey, type Store, type SuggestionDisplay, type SuggestionListProps, SuggestionPopup, type SuggestionPopupHandle, type SuggestionPopupRenderer, type TextblockSpec, type ToolbarGroup, type ToolbarItem, type Translate, type UploadFn, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, captureRange, childrenOf, commandItem, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreConversionTargets, coreConversions, coreFeature, coreToolbarGroups, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, finishConversion, formatAiResultOf, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, mergeToolbarGroups, metadataOf, notifierOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, wrapImportBlocks };

package/dist/core/index.js

@@ -0,0 +1,27 @@
+import { Abilities, DEFAULT_ABILITY_RULES, abilitiesAt, abilitiesAtSelection, hasAbility } from "./abilities.js";
+import { CORE_TARGET_IDS, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
+import { DEFAULT_BLOCK_PIPELINE, aiBlockDataOf, aiContextOf, conversionsOf, formatAiResultOf, parseBlocks, pipelineOf, presetExtension, structureBlocks, wrapImportBlocks } from "./pipeline.js";
+import { BlockConvert, blockConversion, conversionLabel, conversionTargetGroups, convertMenuItems, coreConversions, parseConversionTarget, targetOwner } from "./block-convert.js";
+import { startBlockDrag } from "./block-drag.js";
+import { BlockFlash } from "./block-flash.js";
+import { CATALOGS, DEFAULT_LOCALE, LOCALES, createTranslator, isLocale } from "../i18n/index.js";
+import { silentNotifier } from "./notify.js";
+import { createStore, derived } from "./store.js";
+import { createEditorContext } from "./context.js";
+import { DocAnchors, anchorResolverOf, captureRange, docAnchorsKey, releaseRanges, resolveRange } from "./doc-anchors.js";
+import { DocumentMarkdown } from "./document-markdown.js";
+import { Metadata, createMetadataRegistry, filterMetadataItems, metadataOf } from "./metadata.js";
+import { SuggestionPopup, createSuggestionRender, suggestionPopupOf } from "./suggestion-popup.js";
+import { SlashCommand, SlashCommandPluginKey } from "./slash.js";
+import { commandItem, mergeToolbarGroups } from "./toolbar.js";
+import { coreToolbarGroups } from "./toolbar-items.js";
+import { coreBlockActions, coreFeature } from "./core-feature.js";
+import { SINGLETON_PIPELINE_HOOKS } from "./feature.js";
+import { contributions, defineEditor, settingsTabsOf } from "./define-editor.js";
+import { downloadText } from "./download.js";
+import { editorEntryOf, notifierOf, registerEditor } from "./editor-ui.js";
+import { blockActionsOf, createFeatureContext } from "./feature-context.js";
+import { fetchErrorMessage } from "./fetch-error.js";
+import { METADATA_LIST } from "./metadata-types.js";
+import { selectionRange } from "./selection-range.js";
+export { Abilities, BlockConvert, BlockFlash, CATALOGS, CORE_TARGET_IDS, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, DocAnchors, DocumentMarkdown, LOCALES, METADATA_LIST, Metadata, SINGLETON_PIPELINE_HOOKS, SlashCommand, SlashCommandPluginKey, SuggestionPopup, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, captureRange, childrenOf, commandItem, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreConversionTargets, coreConversions, coreFeature, coreToolbarGroups, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, finishConversion, formatAiResultOf, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, mergeToolbarGroups, metadataOf, notifierOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, wrapImportBlocks };

package/dist/core/metadata-types.d.ts

@@ -0,0 +1,27 @@
+import { Editor } from "@tiptap/core";
+//#region src/core/metadata-types.d.ts
+/** One entry of a metadata list (`@` person, `#` tag, speaker, …). */
+export interface MetadataItem {
+  id: string;
+  label: string;
+  color?: string | null;
+  icon?: string;
+  description?: string;
+}
+/** Arguments of a function source: the typed query, the asking editor and an abort signal for superseded searches. */
+export interface MetadataQuery {
+  query: string;
+  editor: Editor;
+  signal?: AbortSignal;
+}
+/** A list is either a static array (filtered client-side) or a (possibly remote) search function. */
+export type MetadataSource = readonly MetadataItem[] | ((q: MetadataQuery) => readonly MetadataItem[] | Promise<readonly MetadataItem[]>);
+/** Host-supplied metadata lists by name (see `METADATA_LIST` for the built-in ones). */
+export type EditorMetadata = Record<string, MetadataSource>;
+export declare const METADATA_LIST: {
+  readonly mentions: "mentions";
+  readonly hashtags: "hashtags";
+  readonly speakers: "speakers";
+};
+//#endregion
+//# sourceMappingURL=metadata-types.d.ts.map

package/dist/core/metadata-types.js

@@ -0,0 +1,10 @@
+//#region src/core/metadata-types.ts
+const METADATA_LIST = {
+	mentions: "mentions",
+	hashtags: "hashtags",
+	speakers: "speakers"
+};
+//#endregion
+export { METADATA_LIST };
+
+//# sourceMappingURL=metadata-types.js.map

package/dist/core/metadata-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-types.js","names":[],"sources":["../../src/core/metadata-types.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\n\n/** One entry of a metadata list (`@` person, `#` tag, speaker, …). */\nexport interface MetadataItem { id: string, label: string, color?: string | null, icon?: string, description?: string }\n\n/** Arguments of a function source: the typed query, the asking editor and an abort signal for superseded searches. */\nexport interface MetadataQuery { query: string, editor: Editor, signal?: AbortSignal }\n\n/** A list is either a static array (filtered client-side) or a (possibly remote) search function. */\nexport type MetadataSource = readonly MetadataItem[] | ((q: MetadataQuery) => readonly MetadataItem[] | Promise<readonly MetadataItem[]>)\n\n/** Host-supplied metadata lists by name (see `METADATA_LIST` for the built-in ones). */\nexport type EditorMetadata = Record<string, MetadataSource>\n\nexport const METADATA_LIST = { mentions: 'mentions', hashtags: 'hashtags', speakers: 'speakers' } as const\n"],"mappings":";AAcA,MAAa,gBAAgB;CAAE,UAAU;CAAY,UAAU;CAAY,UAAU;AAAW"}

package/dist/core/metadata.d.ts

@@ -0,0 +1,39 @@
+import { EditorMetadata, MetadataItem, MetadataQuery, MetadataSource } from "./metadata-types.js";
+import { Editor, Extension } from "@tiptap/core";
+//#region src/core/metadata.d.ts
+export interface MetadataRegistry {
+  /** Current sources by list name; one object mutated in place on `replace`/`defaults` (not observable). */
+  readonly lists: Readonly<Record<string, MetadataSource>>;
+  /** Sets the host's lists; lists the host does not supply fall back to `defaults`. */
+  replace(metadata: EditorMetadata): void;
+  /** Adds fallback lists (features' built-in sources) used for every list name the host does not supply. */
+  defaults(metadata: EditorMetadata): void;
+  has(list: string): boolean;
+  /** Array source → `filterMetadataItems`; function source → its awaited result; unknown list → `[]`. */
+  search(list: string, q: MetadataQuery): Promise<MetadataItem[]>;
+  /** Array source: the array; function source: union (by id) of everything searches returned so far, plus created items. */
+  known(list: string): readonly MetadataItem[];
+  /** Adds `item` to `known(list)`, then reports it via `onCreate`. */
+  create(list: string, item: MetadataItem): void;
+}
+export declare function createMetadataRegistry(options?: {
+  onCreate?: (list: string, item: MetadataItem) => void;
+}): MetadataRegistry;
+/** Case-insensitive; label-prefix matches first, then substring (same order as server/api/editor/users.get.ts); max `limit`. */
+export declare function filterMetadataItems(items: readonly MetadataItem[], query: string, limit?: number): MetadataItem[];
+/** Makes the host's metadata registry reachable as `editor.storage.metadata.registry` (see `metadataOf`). */
+export declare const Metadata: Extension<{
+  registry: MetadataRegistry | null;
+}, {
+  registry: MetadataRegistry;
+}>;
+declare module '@tiptap/core' {
+  interface Storage {
+    metadata: {
+      registry: MetadataRegistry;
+    };
+  }
+}
+export declare const metadataOf: (editor: Editor) => MetadataRegistry;
+//#endregion
+//# sourceMappingURL=metadata.d.ts.map