@stll/folio-core 0.59.0 → 0.60.0

package/dist/prosemirror/plugins/aiCitationDecorations.js

@@ -1,7 +1,20 @@
-import { Plugin, PluginKey } from "prosemirror-state";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
+import { Plugin } from "prosemirror-state";
 import { Decoration, DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/plugins/aiCitationDecorations.ts
-const aiCitationDecorationsKey = new PluginKey("aiCitationDecorations");
+/**
+* AI Citation Decorations Plugin
+*
+* Renders pointer-back-to-source highlights on Folio (DOCX) ranges
+* cited by an AI answer. Distinct from the suggestion-decoration
+* plugin: citations are read-only pointers (no edit semantics) and
+* usually appear briefly when the user clicks a citation chip in the
+* thread.
+*
+* The host pushes updates via the `setAICitationsMeta` /
+* `setActiveCitationMeta` helpers below.
+*/
+const aiCitationDecorationsKey = createPluginKeyOwner("aiCitationDecorations");
 const SET_META = "set";
 const ACTIVE_META = "active";
 function buildDecorationSet(doc, citations, activeId) {
@@ -31,7 +44,7 @@ function buildDecorationSet(doc, citations, activeId) {
 */
 function createAICitationDecorationsPlugin() {
 	return new Plugin({
-		key: aiCitationDecorationsKey,
+		key: aiCitationDecorationsKey.createKey(),
 		state: {
 			init(_, state) {
 				return {

package/dist/prosemirror/plugins/aiSuggestionDecorations.d.ts

@@ -1,8 +1,15 @@
 import { AISuggestion, AISuggestionSeverity } from "../../ai-suggestions/types.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { PluginKeyOwner } from "../pluginKeyOwner.js";
+import { Plugin } from "prosemirror-state";
 import { DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/plugins/aiSuggestionDecorations.d.ts
-declare const aiSuggestionDecorationsKey: PluginKey<AISuggestionDecorationState>;
+declare const aiSuggestionDecorationsKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<AISuggestionDecorationState>;
+  owns: (plugin: Plugin<AISuggestionDecorationState>) => boolean;
+  get: (state: import("prosemirror-state").EditorState) => Plugin<AISuggestionDecorationState> | undefined;
+  getState: (state: import("prosemirror-state").EditorState) => AISuggestionDecorationState | undefined;
+}>;
 declare const SET_META = "set";
 declare const FOCUS_META = "focus";
 type AISuggestionDecorationState = {
@@ -24,14 +31,14 @@ declare const AI_SUGGESTION_SEVERITY_CLASS: Record<AISuggestionSeverity, string>
  */
 declare function createAISuggestionDecorationsPlugin(): Plugin<AISuggestionDecorationState>;
 declare function setAISuggestionsMeta(suggestions: AISuggestion[]): {
-  key: PluginKey<AISuggestionDecorationState>;
+  key: PluginKeyOwner<AISuggestionDecorationState>;
   payload: {
     type: typeof SET_META;
     suggestions: AISuggestion[];
   };
 };
 declare function setFocusedSuggestionMeta(focusedId: string | null): {
-  key: PluginKey<AISuggestionDecorationState>;
+  key: PluginKeyOwner<AISuggestionDecorationState>;
   payload: {
     type: typeof FOCUS_META;
     focusedId: string | null;

package/dist/prosemirror/plugins/aiSuggestionDecorations.js

@@ -1,7 +1,22 @@
-import { Plugin, PluginKey } from "prosemirror-state";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
+import { Plugin } from "prosemirror-state";
 import { Decoration, DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/plugins/aiSuggestionDecorations.ts
-const aiSuggestionDecorationsKey = new PluginKey("aiSuggestionDecorations");
+/**
+* AI Suggestion Decorations Plugin
+*
+* Renders pending AI suggestions as non-mutating ProseMirror decorations
+* — subtle dotted underlines on the suggested ranges. The focused
+* suggestion additionally previews its change in the text: the original
+* range is struck through and the suggested text is injected after it
+* as a widget. The document itself is never modified by the suggestion
+* queue; decorations live purely in the view layer.
+*
+* The plugin keeps a `DecorationSet` derived from the suggestion list.
+* Updates are pushed via the `setAISuggestions` meta key, which the
+* Folio editor wires up whenever the suggestion list changes.
+*/
+const aiSuggestionDecorationsKey = createPluginKeyOwner("aiSuggestionDecorations");
 const SET_META = "set";
 const FOCUS_META = "focus";
 /**
@@ -69,7 +84,7 @@ function buildDecorationSet(doc, suggestions, focusedId) {
 */
 function createAISuggestionDecorationsPlugin() {
 	return new Plugin({
-		key: aiSuggestionDecorationsKey,
+		key: aiSuggestionDecorationsKey.createKey(),
 		state: {
 			init(_, state) {
 				return {

package/dist/prosemirror/plugins/anonymizationDecorations.d.ts

@@ -1,4 +1,5 @@
-import { EditorState, Plugin, PluginKey } from "prosemirror-state";
+import { PluginKeyOwner } from "../pluginKeyOwner.js";
+import { EditorState, Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/anonymizationDecorations.d.ts
 type AnonymizationTerm = {
   /** Canonical surface form, displayed in tooltips. */
@@ -21,7 +22,13 @@ type AnonymizationDecorationState = {
   terms: readonly AnonymizationTerm[];
   matches: readonly AnonymizationMatch[];
 };
-declare const anonymizationDecorationsKey: PluginKey<AnonymizationDecorationState>;
+declare const anonymizationDecorationsKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<AnonymizationDecorationState>;
+  owns: (plugin: Plugin<AnonymizationDecorationState>) => boolean;
+  get: (state: EditorState) => Plugin<AnonymizationDecorationState> | undefined;
+  getState: (state: EditorState) => AnonymizationDecorationState | undefined;
+}>;
 declare const slugAnonymizationLabel: (label: string) => string;
 /**
  * Plugin that keeps a list of anonymization-term match ranges
@@ -43,20 +50,13 @@ type AnonymizationPluginOptions = {
 };
 declare const createAnonymizationDecorationsPlugin: ({ onMatchesChange }?: AnonymizationPluginOptions) => Plugin<AnonymizationDecorationState>;
 declare const setAnonymizationTermsMeta: (terms: readonly AnonymizationTerm[]) => {
-  key: PluginKey<AnonymizationDecorationState>;
+  key: PluginKeyOwner<AnonymizationDecorationState>;
   payload: {
     type: typeof SET_META;
     terms: readonly AnonymizationTerm[];
   };
 };
-/**
- * Read the plugin's current match list out of a Folio editor
- * view. Lives inside the same module as the plugin key so a host
- * that imports it via `@stll/folio` gets the *same* key instance
- * as the plugin registration — bypassing the dev-HMR hazard
- * where re-evaluating the plugin module would create a second
- * PluginKey and break key-based lookups.
- */
+/** Read anonymization matches owned by this editor state. */
 declare const getAnonymizationMatches: (state: EditorState) => readonly AnonymizationMatch[];
 //#endregion
 export { AnonymizationMatch, AnonymizationPluginOptions, AnonymizationTerm, anonymizationDecorationsKey, createAnonymizationDecorationsPlugin, getAnonymizationMatches, setAnonymizationTermsMeta, slugAnonymizationLabel };

package/dist/prosemirror/plugins/anonymizationDecorations.js

@@ -1,10 +1,27 @@
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { collectBlockChunks, joinChunks, offsetToDocPos } from "./pmTextScan.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/anonymizationDecorations.ts
+/**
+* Anonymization Match Plugin
+*
+* Owns the "what to highlight" half of the anonymization
+* overlay: the host pushes a list of terms via the
+* `setAnonymizationTermsMeta` meta, this plugin scans text
+* nodes for each surface form, and exposes the resulting
+* match ranges through its state.
+*
+* The plugin does **not** produce ProseMirror decorations.
+* Folio's editor lives off-screen (HiddenProseMirror) and PM
+* decorations never reach the visible paged DOM. The visible
+* highlights are painted by {@link AnonymizationRectsOverlay},
+* which reads the match ranges from this plugin's state and
+* projects them through `selectionToRects` to coordinates on
+* the paged canvas. Single source of truth for the ranges,
+* one painter.
+*/
 const SET_META = "set";
-const KEY_HOLDER_SYMBOL = Symbol.for("stll.folio.anonymizationDecorationsKey");
-const keyHolder = globalThis;
-const anonymizationDecorationsKey = keyHolder[KEY_HOLDER_SYMBOL] ?? (keyHolder[KEY_HOLDER_SYMBOL] = new PluginKey("anonymizationDecorations"));
+const anonymizationDecorationsKey = createPluginKeyOwner("anonymizationDecorations");
 const slugAnonymizationLabel = (label) => label.toLowerCase().replace(/[^a-z0-9]+/gu, "-");
 const buildMatcher = (terms) => {
 	const escapeChar = (value) => value.replaceAll(/[\\^$.*+?()[\]{}|]/gu, "\\$&").replaceAll(/\s+/gu, "\\s+");
@@ -60,7 +77,7 @@ const buildMatches = (doc, terms) => {
 };
 const createAnonymizationDecorationsPlugin = ({ onMatchesChange } = {}) => {
 	const spec = {
-		key: anonymizationDecorationsKey,
+		key: anonymizationDecorationsKey.createKey(),
 		state: {
 			init() {
 				return {
@@ -107,14 +124,7 @@ const setAnonymizationTermsMeta = (terms) => ({
 		terms
 	}
 });
-/**
-* Read the plugin's current match list out of a Folio editor
-* view. Lives inside the same module as the plugin key so a host
-* that imports it via `@stll/folio` gets the *same* key instance
-* as the plugin registration — bypassing the dev-HMR hazard
-* where re-evaluating the plugin module would create a second
-* PluginKey and break key-based lookups.
-*/
+/** Read anonymization matches owned by this editor state. */
 const getAnonymizationMatches = (state) => anonymizationDecorationsKey.getState(state)?.matches ?? [];
 //#endregion
 export { anonymizationDecorationsKey, createAnonymizationDecorationsPlugin, getAnonymizationMatches, setAnonymizationTermsMeta, slugAnonymizationLabel };

package/dist/prosemirror/plugins/autocompleteSuggestion.d.ts

@@ -1,4 +1,4 @@
-import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/plugins/autocompleteSuggestion.d.ts
 type AutocompleteSuggestionStatus = "idle" | "streaming" | "shown";
@@ -13,7 +13,13 @@ type AutocompleteSuggestionState = {
   text: string;
   requestId: string;
 };
-declare const autocompleteSuggestionKey: PluginKey<AutocompleteSuggestionPluginState>;
+declare const autocompleteSuggestionKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<AutocompleteSuggestionPluginState>;
+  owns: (plugin: Plugin<AutocompleteSuggestionPluginState>) => boolean;
+  get: (state: EditorState) => Plugin<AutocompleteSuggestionPluginState> | undefined;
+  getState: (state: EditorState) => AutocompleteSuggestionPluginState | undefined;
+}>;
 type AutocompleteSuggestionPluginState = {
   suggestion: AutocompleteSuggestionState;
   decorations: DecorationSet;

package/dist/prosemirror/plugins/autocompleteSuggestion.js

@@ -1,15 +1,37 @@
-import { Plugin, PluginKey } from "prosemirror-state";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
+import { Plugin } from "prosemirror-state";
 import { Decoration, DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/plugins/autocompleteSuggestion.ts
+/**
+* Autocomplete Suggestion Plugin
+*
+* Headless ProseMirror plugin for inline ghost-text autocomplete.
+* Mirrors the anonymization plugin shape: this module owns the
+* "what" (a single in-flight suggestion anchored at a doc
+* position) and {@link AutocompleteCaretOverlay} owns the paint.
+*
+* Lifecycle:
+*   idle ──setSuggestionStart──▶ streaming ──appendToken*──▶ shown
+*      ◀──clearSuggestion──────────────────────────────────────┘
+*
+* The document is never mutated while the suggestion is shown;
+* the ghost text and "stella" caret are projected onto the page
+* via {@link AutocompleteCaretOverlay} reading this plugin's
+* state and a single inline widget decoration carrying the
+* anchor position.
+*
+* On accept (Tab/⌘→), call {@link acceptAutocompleteSuggestion}
+* to commit the suggestion as a real text insertion in a single
+* transaction. On dismiss (Esc, edit, blur), call
+* {@link clearAutocompleteSuggestion}.
+*/
 const IDLE = {
 	status: "idle",
 	anchor: null,
 	text: "",
 	requestId: null
 };
-const KEY_HOLDER_SYMBOL = Symbol.for("stll.folio.autocompleteSuggestionKey");
-const keyHolder = globalThis;
-const autocompleteSuggestionKey = keyHolder[KEY_HOLDER_SYMBOL] ?? (keyHolder[KEY_HOLDER_SYMBOL] = new PluginKey("autocompleteSuggestion"));
+const autocompleteSuggestionKey = createPluginKeyOwner("autocompleteSuggestion");
 const buildAnchorWidget = () => {
 	const el = document.createElement("span");
 	el.dataset["folioAutocompleteAnchor"] = "true";
@@ -76,7 +98,7 @@ const autocompleteSuggestionPlugin = (options = {}) => {
 		keymap: options.keymap ?? false
 	};
 	return new Plugin({
-		key: autocompleteSuggestionKey,
+		key: autocompleteSuggestionKey.createKey(),
 		state: {
 			init: (_config, instance) => ({
 				suggestion: IDLE,

package/dist/prosemirror/plugins/contentControlWidgets.d.ts

@@ -1,6 +1,6 @@
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "../../content-controls/errors.js";
 import "../../content-controls/index.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/contentControlWidgets.d.ts
 type ContentControlWidgetAnchor = {
@@ -47,7 +47,13 @@ type HandleContentControlWidgetClickOptions = {
   onEvent: ContentControlWidgetCallback;
   view: ContentControlWidgetView;
 };
-declare const contentControlWidgetsPluginKey: PluginKey<unknown>;
+declare const contentControlWidgetsPluginKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<unknown>;
+  owns: (plugin: Plugin<unknown>) => boolean;
+  get: (state: import("prosemirror-state").EditorState) => Plugin<unknown> | undefined;
+  getState: (state: import("prosemirror-state").EditorState) => unknown;
+}>;
 /**
  * CustomEvent name dispatched on the editor view DOM whenever the plugin
  * needs to surface a `ContentControlWidgetEvent` to an adapter shell. The

package/dist/prosemirror/plugins/contentControlWidgets.js

@@ -1,6 +1,7 @@
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "../../content-controls/errors.js";
 import { findBlockSdtMatch, setContentControlValueTr } from "../commands/contentControls.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/contentControlWidgets.ts
 /**
 * Interactive content-control widget delegation.
@@ -16,7 +17,7 @@ import { Plugin, PluginKey } from "prosemirror-state";
 * higher-level UI (a popover menu / date picker rendered by the editor
 * shell) can subscribe; the plugin does not own the menu/picker chrome.
 */
-const contentControlWidgetsPluginKey = new PluginKey("contentControlWidgets");
+const contentControlWidgetsPluginKey = createPluginKeyOwner("contentControlWidgets");
 /**
 * CustomEvent name dispatched on the editor view DOM whenever the plugin
 * needs to surface a `ContentControlWidgetEvent` to an adapter shell. The
@@ -151,7 +152,7 @@ function createContentControlWidgetsPlugin(onEvent = () => void 0) {
 		}));
 	};
 	return new Plugin({
-		key: contentControlWidgetsPluginKey,
+		key: contentControlWidgetsPluginKey.createKey(),
 		props: { handleDOMEvents: { click(view, event) {
 			return handleContentControlWidgetClick({
 				view,

package/dist/prosemirror/plugins/createDocScanPlugin.d.ts

@@ -1,5 +1,6 @@
+import { PluginKeyOwner } from "../pluginKeyOwner.js";
 import { Node } from "prosemirror-model";
-import { EditorState, Plugin, PluginKey } from "prosemirror-state";
+import { EditorState, Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/createDocScanPlugin.d.ts
 declare const SET_META = "set";
 type DocScanState<TConfig, TRange> = {
@@ -7,7 +8,7 @@ type DocScanState<TConfig, TRange> = {
   ranges: readonly TRange[];
 };
 type DocScanPluginOptions<TConfig, TRange> = {
-  key: PluginKey<DocScanState<TConfig, TRange>>;
+  key: PluginKeyOwner<DocScanState<TConfig, TRange>>;
   initialConfig: TConfig;
   /** Recompute the ranges from the current doc + config. */
   scan: (doc: Node, config: TConfig) => TRange[];
@@ -20,13 +21,13 @@ type DocScanPluginOptions<TConfig, TRange> = {
   onRangesChange?: (ranges: readonly TRange[]) => void;
 };
 declare const createDocScanPlugin: <TConfig, TRange>({ key, initialConfig, scan, onRangesChange }: DocScanPluginOptions<TConfig, TRange>) => Plugin<DocScanState<TConfig, TRange>>;
-declare const setDocScanConfigMeta: <TConfig, TRange>(key: PluginKey<DocScanState<TConfig, TRange>>, config: TConfig) => {
-  key: PluginKey<DocScanState<TConfig, TRange>>;
+declare const setDocScanConfigMeta: <TConfig, TRange>(key: PluginKeyOwner<DocScanState<TConfig, TRange>>, config: TConfig) => {
+  key: PluginKeyOwner<DocScanState<TConfig, TRange>>;
   payload: {
     type: typeof SET_META;
     config: TConfig;
   };
 };
-declare const getDocScanRanges: <TConfig, TRange>(key: PluginKey<DocScanState<TConfig, TRange>>, state: EditorState) => readonly TRange[];
+declare const getDocScanRanges: <TConfig, TRange>(key: PluginKeyOwner<DocScanState<TConfig, TRange>>, state: EditorState) => readonly TRange[];
 //#endregion
 export { DocScanPluginOptions, DocScanState, createDocScanPlugin, getDocScanRanges, setDocScanConfigMeta };

package/dist/prosemirror/plugins/createDocScanPlugin.js

@@ -3,7 +3,7 @@ import { Plugin } from "prosemirror-state";
 const SET_META = "set";
 const createDocScanPlugin = ({ key, initialConfig, scan, onRangesChange }) => {
 	const spec = {
-		key,
+		key: key.createKey(),
 		state: {
 			init(_config, instance) {
 				return {

package/dist/prosemirror/plugins/documentNumbering.js

@@ -1,9 +1,11 @@
 import { getCachedNumberingMap } from "../../docx/numberingParser.js";
 import { completeNumberingForDoc, paragraphListReferences } from "../listInstanceReferences.js";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { AddMarkStep, DocAttrStep, RemoveMarkStep, ReplaceAroundStep, ReplaceStep } from "prosemirror-transform";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/documentNumbering.ts
-const documentNumberingKey = new PluginKey("documentNumbering");
+/** Document-scoped numbering definitions for list-editing commands. */
+const documentNumberingKey = createPluginKeyOwner("documentNumbering");
 const completedState = (definitions, doc) => {
 	const completed = completeNumberingForDoc(definitions ?? void 0, doc);
 	return {
@@ -49,7 +51,7 @@ const mayReferenceUnknownInstance = (tr, map) => {
 	});
 };
 const createDocumentNumberingPlugin = (definitions) => new Plugin({
-	key: documentNumberingKey,
+	key: documentNumberingKey.createKey(),
 	state: {
 		init: (_config, state) => completedState(definitions ?? null, state.doc),
 		apply: (tr, current, _oldState, state) => tr.docChanged && mayReferenceUnknownInstance(tr, current.map) ? completedState(current.definitions, state.doc) : current

package/dist/prosemirror/plugins/documentStyleState.d.ts

@@ -1,9 +1,15 @@
 import { document_d_exports } from "../../types/document.js";
 import { BuiltInStyleIndex } from "../../docx/builtInStyles.js";
 import { StyleResolver } from "../styles/styleResolver.js";
-import { EditorState, PluginKey } from "prosemirror-state";
+import { EditorState } from "prosemirror-state";
 //#region src/prosemirror/plugins/documentStyleState.d.ts
-declare const documentStylesKey: PluginKey<StyleResolver | null>;
+declare const documentStylesKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<StyleResolver | null>;
+  owns: (plugin: import("prosemirror-state").Plugin<StyleResolver | null>) => boolean;
+  get: (state: EditorState) => import("prosemirror-state").Plugin<StyleResolver | null> | undefined;
+  getState: (state: EditorState) => StyleResolver | null | undefined;
+}>;
 /** Read the document's StyleResolver, or null when the plugin isn't installed. */
 declare function getDocumentStyleResolver(state: EditorState): StyleResolver | null;
 /**

package/dist/prosemirror/plugins/documentStyleState.js

@@ -1,7 +1,7 @@
 import { EMPTY_BUILT_IN_STYLE_INDEX } from "../../docx/builtInStyles.js";
-import { PluginKey } from "prosemirror-state";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 //#region src/prosemirror/plugins/documentStyleState.ts
-const documentStylesKey = new PluginKey("documentStyles");
+const documentStylesKey = createPluginKeyOwner("documentStyles");
 /** Read the document's StyleResolver, or null when the plugin isn't installed. */
 function getDocumentStyleResolver(state) {
 	return documentStylesKey.getState(state) ?? null;

package/dist/prosemirror/plugins/documentStyles.js

@@ -82,7 +82,7 @@ const documentStyleContextSpec = (styles) => {
 	else if (styles) resolver = createStyleResolver(styles);
 	else resolver = null;
 	return {
-		key: documentStylesKey,
+		key: documentStylesKey.createKey(),
 		state: {
 			init: () => resolver,
 			apply: (_tr, value) => value

package/dist/prosemirror/plugins/selectionTracker.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../../types/document.js";
 import { ListState } from "../listState.js";
-import { EditorState, Plugin, PluginKey } from "prosemirror-state";
+import { EditorState, Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/selectionTracker.d.ts
 /**
  * Selection context for toolbar state
@@ -30,7 +30,13 @@ type SelectionContext = {
 /**
  * Plugin key for accessing selection tracker state
  */
-declare const selectionTrackerKey: PluginKey<SelectionContext>;
+declare const selectionTrackerKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<SelectionContext>;
+  owns: (plugin: Plugin<SelectionContext>) => boolean;
+  get: (state: EditorState) => Plugin<SelectionContext> | undefined;
+  getState: (state: EditorState) => SelectionContext | undefined;
+}>;
 /**
  * Callback type for selection changes
  */

package/dist/prosemirror/plugins/selectionTracker.js

@@ -1,7 +1,8 @@
 import { expectCommentMarkAttrs, expectTrackedChangeMarkAttrs } from "../attrs/index.js";
 import { sameListState } from "../listState.js";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { extractSelectionSnapshot } from "../selectionState.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/selectionTracker.ts
 /**
 * Selection Tracker Plugin
@@ -15,7 +16,7 @@ import { Plugin, PluginKey } from "prosemirror-state";
 /**
 * Plugin key for accessing selection tracker state
 */
-const selectionTrackerKey = new PluginKey("selectionTracker");
+const selectionTrackerKey = createPluginKeyOwner("selectionTracker");
 /**
 * Extract selection context from editor state
 */
@@ -60,7 +61,7 @@ function extractSelectionContext(state) {
 */
 function createSelectionTrackerPlugin(onSelectionChange) {
 	return new Plugin({
-		key: selectionTrackerKey,
+		key: selectionTrackerKey.createKey(),
 		state: {
 			init(_, state) {
 				return extractSelectionContext(state);

package/dist/prosemirror/plugins/suggestionMode.d.ts

@@ -1,8 +1,14 @@
 import { Slice } from "prosemirror-model";
-import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/suggestionMode.d.ts
-declare const suggestionModeKey: PluginKey<SuggestionModeState>;
+declare const suggestionModeKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<SuggestionModeState>;
+  owns: (plugin: Plugin<SuggestionModeState>) => boolean;
+  get: (state: EditorState) => Plugin<SuggestionModeState> | undefined;
+  getState: (state: EditorState) => SuggestionModeState | undefined;
+}>;
 declare const SUGGESTION_META = "suggestionModeApplied";
 declare const SUGGESTION_BYPASS_META = "suggestionModeBypass";
 /**

package/dist/prosemirror/plugins/suggestionMode.js

@@ -8,6 +8,7 @@ import { splitBlockClearBorders } from "../extensions/features/BaseKeymapExtensi
 import { JOINED_RUNS_RESTYLED_META } from "../extensions/features/JoinedRunStyleExtension.js";
 import { expandNoteReferenceDeletionRange } from "../extensions/marks/noteReferenceDeletion.js";
 import { carryParagraphProperties, paragraphLeftAfter, recordReplacedParagraphProperties } from "../paragraphPropertyCarry.js";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { rebaseParagraphRuns } from "../rebaseParagraphRunFormatting.js";
 import { RUN_FORMATTING_MARK_NAMES } from "../runFormattingMarkNames.js";
 import { paragraphRunStyleContext } from "../runStyleFormatting.js";
@@ -20,7 +21,7 @@ import { mintRevisionId, seedRevisionIdsFromDoc } from "./revisionIds.js";
 import { Slice } from "prosemirror-model";
 import { CellSelection } from "prosemirror-tables";
 import { Mapping, ReplaceStep } from "prosemirror-transform";
-import { AllSelection, EditorState, Plugin, PluginKey, Selection, TextSelection } from "prosemirror-state";
+import { AllSelection, EditorState, Plugin, Selection, TextSelection } from "prosemirror-state";
 import { joinBackward, joinForward, selectNodeBackward, selectNodeForward } from "prosemirror-commands";
 import { isHistoryTransaction } from "prosemirror-history";
 import { undoInputRule } from "prosemirror-inputrules";
@@ -37,7 +38,7 @@ import { undoInputRule } from "prosemirror-inputrules";
 * - Text already marked as insertion by the current author is deleted normally
 *   (retracting your own suggestion)
 */
-const suggestionModeKey = new PluginKey("suggestionMode");
+const suggestionModeKey = createPluginKeyOwner("suggestionMode");
 const SUGGESTION_META = "suggestionModeApplied";
 const SUGGESTION_BYPASS_META = "suggestionModeBypass";
 /**
@@ -939,7 +940,7 @@ function createSuggestionModePlugin(initialActive = false, author = "User") {
 	let compositionReplaced = null;
 	let compositionId = null;
 	return new Plugin({
-		key: suggestionModeKey,
+		key: suggestionModeKey.createKey(),
 		state: {
 			init(_config, instance) {
 				seedRevisionIdsFromDoc(instance.doc);

package/dist/prosemirror/plugins/templateDirectives.d.ts

@@ -1,6 +1,6 @@
 import { DocScanState } from "./createDocScanPlugin.js";
 import { Node } from "prosemirror-model";
-import { EditorState, PluginKey } from "prosemirror-state";
+import { EditorState } from "prosemirror-state";
 import { DirectiveKind } from "@stll/template-conditions";
 //#region src/prosemirror/plugins/templateDirectives.d.ts
 type DirectiveRange = {
@@ -50,7 +50,13 @@ type DirectiveRange = {
  */
 declare const computeBlockDepths: (ranges: readonly DirectiveRange[]) => Map<number, number>;
 declare const scanDirectives: (doc: Node) => DirectiveRange[];
-declare const templateDirectivesKey: PluginKey<DocScanState<undefined, DirectiveRange>>;
+declare const templateDirectivesKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<DocScanState<undefined, DirectiveRange>>;
+  owns: (plugin: import("prosemirror-state").Plugin<DocScanState<undefined, DirectiveRange>>) => boolean;
+  get: (state: EditorState) => import("prosemirror-state").Plugin<DocScanState<undefined, DirectiveRange>> | undefined;
+  getState: (state: EditorState) => DocScanState<undefined, DirectiveRange> | undefined;
+}>;
 type TemplateDirectivesPluginOptions = {
   onRangesChange?: (ranges: readonly DirectiveRange[]) => void;
 };

package/dist/prosemirror/plugins/templateDirectives.js

@@ -1,9 +1,26 @@
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { createDocScanPlugin, getDocScanRanges } from "./createDocScanPlugin.js";
 import { collectBlockChunks, joinChunks, offsetToDocPos } from "./pmTextScan.js";
-import { PluginKey } from "prosemirror-state";
 import { assertNever, isBlockDirectiveKind, scanMarkers } from "@stll/template-conditions";
 //#region src/prosemirror/plugins/templateDirectives.ts
 /**
+* Template-directives scan plugin.
+*
+* Scans the document for legal-template markers and exposes their
+* PM ranges so the paged-canvas overlay can paint rich widgets
+* (field chips, conditional/loop bands) in place of the raw
+* `{{ ... }}` / `{% ... %}` text. Mirrors the anonymization plugin's
+* shape via the shared {@link createDocScanPlugin} factory; the
+* document text is the only input, so there is no host-pushed config.
+*
+* The grammar itself is NOT defined here: the kinds and the marker
+* parser come from `@stll/template-conditions` ({@link scanMarkers}),
+* the docxtpl dialect of Jinja the fill pipeline uses. This file only
+* maps the scanner's text offsets onto ProseMirror positions, so a new
+* directive added to the shared grammar is highlighted here
+* automatically.
+*/
+/**
 * The body of an `if` / `elif` tag as authored: its inner text after the
 * keyword. The grammar reads a body that is one path plus a filter chain as
 * that path, with the chain in `filters`; the document still holds the whole
@@ -113,9 +130,7 @@ const scanDirectives = (doc) => {
 	}
 	return ranges;
 };
-const KEY_HOLDER_SYMBOL = Symbol.for("stll.folio.templateDirectivesKey");
-const keyHolder = globalThis;
-const templateDirectivesKey = keyHolder[KEY_HOLDER_SYMBOL] ?? (keyHolder[KEY_HOLDER_SYMBOL] = new PluginKey("templateDirectives"));
+const templateDirectivesKey = createPluginKeyOwner("templateDirectives");
 const createTemplateDirectivesPlugin = ({ onRangesChange } = {}) => createDocScanPlugin({
 	key: templateDirectivesKey,
 	initialConfig: void 0,

package/dist/prosemirror/plugins/templatePreviewValues.d.ts

@@ -1,4 +1,4 @@
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 import { DecorationSet, EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/templatePreviewValues.d.ts
 /** One formatted span of a rich preview value. The flags layer over the
@@ -87,7 +87,13 @@ type TemplatePreviewState = {
   hidden: TemplatePreviewHiddenRange[];
   decorationSet: DecorationSet;
 };
-declare const templatePreviewValuesKey: PluginKey<TemplatePreviewState>;
+declare const templatePreviewValuesKey: Readonly<{
+  key: string;
+  createKey: () => import("prosemirror-state").PluginKey<TemplatePreviewState>;
+  owns: (plugin: Plugin<TemplatePreviewState>) => boolean;
+  get: (state: import("prosemirror-state").EditorState) => Plugin<TemplatePreviewState> | undefined;
+  getState: (state: import("prosemirror-state").EditorState) => TemplatePreviewState | undefined;
+}>;
 declare function createTemplatePreviewValuesPlugin(): Plugin<TemplatePreviewState>;
 /** Push (or clear, with `null`) the live fill preview into the editor. */
 declare const setTemplatePreviewValues: (view: EditorView, preview: TemplatePreviewValues | null) => void;