@stll/folio-core 0.56.0 → 0.58.0

package/dist/types/canonicalCapabilities.js

@@ -3,15 +3,15 @@
 const CANONICAL_GAP = {
 	authorityRouting: "authority-routing",
 	commands: "command-descriptors",
-	suggesting: "adapter-suggesting",
 	trackedHyperlinkResolution: "tracked-hyperlink-resolution",
+	storyContentProjection: "story-content-projection",
 	comments: "comment-model-edits",
 	modelEdits: "direct-model-edits",
 	sectionProperties: "section-properties",
 	watermark: "watermark-model-edits",
-	secondaryStories: "secondary-story-routing",
 	collaboration: "collaboration-session",
 	dispatch: "unclassified-transactions",
+	tableActivation: "table-session-activation",
 	save: "pm-save-projection",
 	resourceReplacement: "canonical-resource-replacement",
 	history: "pm-history",
@@ -47,19 +47,19 @@ const CANONICAL_CAPABILITIES = {
 		owner: "controller",
 		kind: "refusal",
 		adapters: ["react", "vue"],
-		summary: "Hyperlink and TOC suggestions require serializable wrapper review provenance."
+		summary: "Hyperlink and TOC suggestions and edits intersecting review identities require serializable wrapper review provenance."
 	},
-	[CANONICAL_GAP.suggesting]: {
-		owner: "adapters",
+	[CANONICAL_GAP.storyContentProjection]: {
+		owner: "controller",
 		kind: "refusal",
 		adapters: ["react", "vue"],
-		summary: "Adapter suggesting controls and tracked secondary-story edits remain gated."
+		summary: "Unsupported inline, field and review content cannot be projected after canonical edits."
 	},
 	[CANONICAL_GAP.comments]: {
 		owner: "adapters",
-		kind: "refusal",
+		kind: "routing",
 		adapters: ["react", "vue"],
-		summary: "Comment mutations still use direct model changes."
+		summary: "Default sessions retain comment model edits; canonical comments use semantic operations."
 	},
 	[CANONICAL_GAP.modelEdits]: {
 		owner: "adapters",
@@ -68,10 +68,10 @@ const CANONICAL_CAPABILITIES = {
 		summary: "Direct model and pending-suggestion snapshots bypass the canonical journal."
 	},
 	[CANONICAL_GAP.sectionProperties]: {
-		owner: "adapters",
+		owner: "controller",
 		kind: "routing",
 		adapters: ["react", "vue"],
-		summary: "Section properties select canonical operations or legacy model changes."
+		summary: "The shared controller journals section properties; default sessions keep model changes."
 	},
 	[CANONICAL_GAP.watermark]: {
 		owner: "adapters",
@@ -79,12 +79,6 @@ const CANONICAL_CAPABILITIES = {
 		adapters: ["vue"],
 		summary: "Vue watermark mutations still change the model directly."
 	},
-	[CANONICAL_GAP.secondaryStories]: {
-		owner: "controller",
-		kind: "routing",
-		adapters: ["react", "vue"],
-		summary: "Secondary-story creation, views and history still select their session authority."
-	},
 	[CANONICAL_GAP.collaboration]: {
 		owner: "controller",
 		kind: "refusal",
@@ -97,6 +91,12 @@ const CANONICAL_CAPABILITIES = {
 		adapters: ["react", "vue"],
 		summary: "Unclassified native and plugin mutations are refused at the projection boundary."
 	},
+	[CANONICAL_GAP.tableActivation]: {
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Canonical session activation requires table projection and cell addressing."
+	},
 	[CANONICAL_GAP.save]: {
 		owner: "controller",
 		kind: "routing",
@@ -149,9 +149,9 @@ const CANONICAL_CAPABILITIES = {
 	[CANONICAL_GAP.publicComments]: {
 		owner: "document-operations",
 		defaultSessionMutation: "pm-public-operations",
-		kind: "refusal",
+		kind: "routing",
 		adapters: ["react", "vue"],
-		summary: "Public comment operations refuse in canonical sessions; legacy sessions retain PM comments."
+		summary: "Canonical public comments compile to semantic operations; default sessions retain PM comments."
 	},
 	[CANONICAL_GAP.publicSuggestedMode]: {
 		owner: "document-operations",

package/dist/types/canonicalComments.d.ts

@@ -0,0 +1,51 @@
+import { CanonicalGap } from "./canonicalCapabilities.js";
+import { Comment } from "./content.js";
+import { OpStory } from "@stll/docx-core/ops";
+//#region src/types/canonicalComments.d.ts
+/** Requests name their anchor; comment metadata never creates an unanchored root. */
+type CanonicalCommentRequest = {
+  type: "create";
+  text: string;
+  author: string;
+  date?: string;
+  anchor: {
+    kind: "selection";
+    from: number;
+    to: number;
+    story: OpStory;
+  } | {
+    kind: "reply";
+    parentId: number;
+  } | {
+    kind: "revision";
+    story: OpStory;
+    revisionId: number;
+  };
+} | {
+  type: "update";
+  id: number;
+  content: Comment["content"];
+} | {
+  type: "resolve";
+  id: number;
+  status: "open" | "resolved";
+} | {
+  type: "delete";
+  id: number;
+} | {
+  type: "replace";
+  comments: readonly Comment[];
+};
+type CanonicalCommentResult = {
+  status: "applied";
+  comments: Comment[];
+  commentId?: number;
+} | {
+  status: "refused";
+  gap: CanonicalGap;
+  message: string;
+  /** Whether the same request can succeed once a pending composition settles. */
+  retry: "afterComposition" | "never";
+};
+//#endregion
+export { CanonicalCommentRequest, CanonicalCommentResult };

package/dist/types/canonicalSections.d.ts

@@ -0,0 +1,12 @@
+import { CANONICAL_GAP } from "./canonicalCapabilities.js";
+//#region src/types/canonicalSections.d.ts
+type CanonicalSectionPropertiesResult = {
+  status: "applied";
+  version: number;
+} | {
+  status: "refused";
+  gap: typeof CANONICAL_GAP.sectionProperties;
+  message: string;
+};
+//#endregion
+export { CanonicalSectionPropertiesResult };

package/dist/utils/headingCollector.js

@@ -1,6 +1,50 @@
 import { resolveHeadingLevel } from "../docx/builtInStyles.js";
 import { readOutlineLevelAttr } from "../prosemirror/outlineLevelAttr.js";
 //#region src/utils/headingCollector.ts
+const RUN_IN_TITLE_MARKS = /* @__PURE__ */ new Set([
+	"bold",
+	"italic",
+	"underline"
+]);
+const runInTitleFormat = (child) => {
+	const marks = child.marks.map(({ type }) => type.name).filter((name) => RUN_IN_TITLE_MARKS.has(name)).sort();
+	return marks.length > 0 ? marks.join("+") : void 0;
+};
+const headingText = (paragraph) => {
+	let text = "";
+	let capture = { status: "searching" };
+	for (let childIndex = 0; childIndex < paragraph.childCount; childIndex += 1) {
+		const child = paragraph.child(childIndex);
+		if (!child.isText) {
+			if (capture.status === "collecting") capture = {
+				status: "complete",
+				text: capture.text
+			};
+			continue;
+		}
+		const childText = child.text || "";
+		text += childText;
+		const format = runInTitleFormat(child);
+		if (capture.status === "searching" && format !== void 0) {
+			capture = {
+				status: "collecting",
+				format,
+				text: childText
+			};
+			continue;
+		}
+		if (capture.status !== "collecting") continue;
+		capture = format === capture.format ? {
+			status: "collecting",
+			format: capture.format,
+			text: capture.text + childText
+		} : {
+			status: "complete",
+			text: capture.text
+		};
+	}
+	return ((capture.status === "searching" ? "" : capture.text.trim()) || text).trim();
+};
 /**
 * Collect all headings from a ProseMirror document, in document order.
 *
@@ -19,10 +63,7 @@ function collectHeadings(doc, styles) {
 			styleId: typeof node.attrs["styleId"] === "string" ? node.attrs["styleId"] : null
 		}, styles);
 		if (level === void 0) return;
-		let text = "";
-		node.forEach((child) => {
-			if (child.isText) text += child.text || "";
-		});
+		const text = headingText(node);
 		if (text.trim()) headings.push({
 			text: text.trim(),
 			level,

package/dist/utils/outlineDepth.d.ts

@@ -0,0 +1,9 @@
+import { HeadingInfo } from "./headingCollector.js";
+//#region src/utils/outlineDepth.d.ts
+/** Maximum heading depth displayed in the document outline. */
+type OutlineDepth = 2 | 3 | "all";
+declare const DEFAULT_OUTLINE_DEPTH = 2;
+/** Filter headings for the outline without changing their document order. */
+declare const filterHeadingsByDepth: (headings: readonly HeadingInfo[], depth: OutlineDepth) => HeadingInfo[];
+//#endregion
+export { DEFAULT_OUTLINE_DEPTH, OutlineDepth, filterHeadingsByDepth };

package/dist/utils/outlineDepth.js

@@ -0,0 +1,9 @@
+//#region src/utils/outlineDepth.ts
+const DEFAULT_OUTLINE_DEPTH = 2;
+/** Filter headings for the outline without changing their document order. */
+const filterHeadingsByDepth = (headings, depth) => {
+	if (depth === "all") return [...headings];
+	return headings.filter((heading) => heading.level < depth);
+};
+//#endregion
+export { DEFAULT_OUTLINE_DEPTH, filterHeadingsByDepth };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.56.0",
+  "version": "0.58.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -146,7 +146,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.32.0",
+    "@stll/docx-core": "^0.34.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.6.2",
     "better-result": "3.0.1",

package/dist/prosemirror/conversion/listRenderingDefinition.d.ts

@@ -1,6 +0,0 @@
-import { document_d_exports } from "../../types/document.js";
-//#region src/prosemirror/conversion/listRenderingDefinition.d.ts
-/** Compare scalar fields directly; only nested records need canonical ordering. */
-declare const listRenderingDefinitionsMatch: (left: document_d_exports.ListRendering, right: document_d_exports.ListRendering) => boolean;
-//#endregion
-export { listRenderingDefinitionsMatch };