@stll/folio-core 0.37.2 → 0.37.4

package/dist/prosemirror/extensions/features/ParaIdAllocatorExtension.js

@@ -1,7 +1,8 @@
-import { recreateProseNodeWithParagraphPropertySource, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource } from "../../../docx/paragraphPropertySource.js";
+import { PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR, getExplicitParagraphPropertySourceTransfers, getProseDocumentParagraphPropertySourceContract, getProseParagraphPropertySourceToken, paragraphPropertySourceTokenMatchesContract, recreateProseNodeWithParagraphPropertySource, setProseParagraphMarkupWithPropertySource, transferProseParagraphPropertySource } from "../../../docx/paragraphPropertySource.js";
 import { deterministicHexId, generateHexId } from "../../../utils/hexId.js";
 import { createExtension } from "../create.js";
 import { ignoreTrackedChanges } from "./ParagraphChangeTrackerExtension.js";
+import { panic } from "better-result";
 import { Fragment } from "prosemirror-model";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
@@ -73,61 +74,100 @@ const mintParaId = (taken, seed, pos) => {
 	return id;
 };
 const isUsableParaId = (value) => typeof value === "string" && value.length > 0 && value !== "00000000";
-/**
-* For every valid paraId in the pre-transaction doc, the position its
-* paragraph ends up at after `transactions` — the occurrence that
-* rightfully keeps the id when the new doc holds duplicates. Ids whose
-* paragraph start was deleted by the steps are left out.
-*/
-const mapKeeperPositions = (oldDoc, transactions) => {
-	const keepers = /* @__PURE__ */ new Map();
+const collectParagraphPropertySourceSeed = (doc) => {
+	const contract = getProseDocumentParagraphPropertySourceContract(doc);
+	if (!contract) return {
+		contract: null,
+		tokens: /* @__PURE__ */ new Set()
+	};
+	const counts = /* @__PURE__ */ new Map();
+	doc.descendants((node) => {
+		if (node.type.name !== "paragraph") return true;
+		const token = getProseParagraphPropertySourceToken(node);
+		if (paragraphPropertySourceTokenMatchesContract(token, contract)) counts.set(token, (counts.get(token) ?? 0) + 1);
+		return false;
+	});
+	return {
+		contract,
+		tokens: new Set([...counts].filter(([, count]) => count === 1).map(([token]) => token))
+	};
+};
+const mapParagraphKeepers = (oldDoc, transactions, sourceSeed) => {
+	const paraIds = /* @__PURE__ */ new Map();
+	const sourceTokens = /* @__PURE__ */ new Map();
 	oldDoc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
 		const id = node.attrs["paraId"];
-		if (!isUsableParaId(id) || keepers.has(id)) return false;
+		const token = getProseParagraphPropertySourceToken(node);
+		const mapsParaId = isUsableParaId(id) && !paraIds.has(id);
+		const mapsSourceToken = typeof token === "string" && sourceSeed.tokens.has(token);
+		if (!mapsParaId && !mapsSourceToken) return false;
 		let mapped = pos;
+		let mappedInterior = pos + 1;
 		let deleted = false;
-		for (const tr of transactions) {
-			const result = tr.mapping.mapResult(mapped);
-			if (result.deleted) {
-				deleted = true;
-				break;
-			}
-			mapped = result.pos;
+		for (const transaction of transactions) {
+			const ownerResult = transaction.mapping.mapResult(mapped);
+			const interiorResult = transaction.mapping.mapResult(mappedInterior, -1);
+			deleted ||= interiorResult.deletedAcross;
+			mapped = ownerResult.pos;
+			mappedInterior = interiorResult.pos;
 		}
-		if (!deleted) keepers.set(id, mapped);
+		if (mapsParaId && !deleted) paraIds.set(id, mapped);
+		if (mapsSourceToken) sourceTokens.set(token, sourceTokens.has(token) ? { status: "ambiguous" } : {
+			pos: mapped,
+			status: deleted ? "deleted" : "mapped"
+		});
 		return false;
 	});
-	return keepers;
+	return {
+		paraIds,
+		sourceTokens
+	};
 };
-const collectParaIdUpdates = (doc, keeperPositions, deterministicSeed = null) => {
-	const missing = [];
-	const occurrencesById = /* @__PURE__ */ new Map();
+const collectParagraphCensus = (doc, sourceSeed) => {
+	const census = {
+		invalidSourceTokens: [],
+		missingParaIds: [],
+		paragraphs: /* @__PURE__ */ new Map(),
+		paraIds: /* @__PURE__ */ new Map(),
+		sourceTokens: /* @__PURE__ */ new Map()
+	};
+	const contractMatchesSeed = sourceSeed?.contract !== null && sourceSeed?.contract !== void 0 && getProseDocumentParagraphPropertySourceContract(doc) === sourceSeed.contract;
 	doc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
-		const id = node.attrs["paraId"];
-		if (!isUsableParaId(id)) missing.push({
+		const occurrence = {
 			pos,
 			attrs: node.attrs
-		});
-		else {
-			const occurrences = occurrencesById.get(id) ?? [];
-			occurrences.push({
-				pos,
-				attrs: node.attrs
-			});
-			occurrencesById.set(id, occurrences);
+		};
+		census.paragraphs.set(pos, occurrence);
+		const id = node.attrs["paraId"];
+		if (isUsableParaId(id)) {
+			const occurrences = census.paraIds.get(id) ?? [];
+			occurrences.push(occurrence);
+			census.paraIds.set(id, occurrences);
+		} else census.missingParaIds.push(occurrence);
+		if (sourceSeed) {
+			const token = getProseParagraphPropertySourceToken(node);
+			if (token !== null && token !== void 0) if (typeof token !== "string" || !contractMatchesSeed || !sourceSeed.contract || !sourceSeed.tokens.has(token) || !paragraphPropertySourceTokenMatchesContract(token, sourceSeed.contract)) census.invalidSourceTokens.push(occurrence);
+			else {
+				const occurrences = census.sourceTokens.get(token) ?? [];
+				occurrences.push(occurrence);
+				census.sourceTokens.set(token, occurrences);
+			}
 		}
 		return false;
 	});
-	const needFreshId = [...missing];
-	for (const [id, occurrences] of occurrencesById) {
+	return census;
+};
+const collectParaIdUpdatesFromCensus = (census, keeperPositions, deterministicSeed = null) => {
+	const needFreshId = [...census.missingParaIds];
+	for (const [id, occurrences] of census.paraIds) {
 		if (occurrences.length === 1) continue;
 		const keeperPos = keeperPositions?.get(id);
-		const keeper = occurrences.find((occurrence) => occurrence.pos === keeperPos) ?? occurrences[0];
+		const keeper = occurrences.find(({ pos }) => pos === keeperPos) ?? occurrences[0];
 		for (const occurrence of occurrences) if (occurrence !== keeper) needFreshId.push(occurrence);
 	}
-	const taken = new Set(occurrencesById.keys());
+	const taken = new Set(census.paraIds.keys());
 	const updates = [];
 	for (const { pos, attrs } of needFreshId) {
 		const newId = mintParaId(taken, deterministicSeed, pos);
@@ -140,9 +180,39 @@ const collectParaIdUpdates = (doc, keeperPositions, deterministicSeed = null) =>
 			}
 		});
 	}
-	updates.sort((a, b) => a.pos - b.pos);
+	updates.sort((left, right) => left.pos - right.pos);
 	return updates;
 };
+const collectParaIdUpdates = (doc) => collectParaIdUpdatesFromCensus(collectParagraphCensus(doc));
+const collectParagraphPropertySourceUpdates = (census, keeperPositions, transactions) => {
+	const updates = /* @__PURE__ */ new Map();
+	for (const { pos } of census.invalidSourceTokens) updates.set(pos, null);
+	const explicitTransfers = transactions.flatMap((transaction) => [...getExplicitParagraphPropertySourceTransfers(transaction)]);
+	const explicitlySelected = new Set(explicitTransfers.map(({ selectedToken }) => selectedToken).filter((token) => token !== null));
+	const explicitlyDisplaced = new Set(explicitTransfers.map(({ displacedToken }) => displacedToken).filter((token) => token !== null));
+	const keptPositions = /* @__PURE__ */ new Set();
+	const keptTokens = /* @__PURE__ */ new Set();
+	for (const [token, occurrences] of census.sourceTokens) {
+		const mappedOwner = keeperPositions.get(token);
+		const mappedKeeper = mappedOwner?.status === "mapped" ? occurrences.find(({ pos }) => pos === mappedOwner.pos) : void 0;
+		const transferredKeeper = !mappedKeeper && explicitlySelected.has(token) && occurrences.length === 1 ? occurrences.at(0) : void 0;
+		const detachedKeeper = !mappedKeeper && !transferredKeeper && occurrences.length === 1 && (mappedOwner === void 0 || mappedOwner.status === "deleted" && mappedOwner.pos === occurrences.at(0)?.pos) ? occurrences.at(0) : void 0;
+		const keeper = mappedKeeper ?? transferredKeeper ?? detachedKeeper;
+		if (keeper) {
+			keptPositions.add(keeper.pos);
+			keptTokens.add(token);
+		}
+		for (const occurrence of occurrences) if (occurrence !== keeper) updates.set(occurrence.pos, null);
+	}
+	for (const [token, mappedOwner] of keeperPositions) {
+		if (mappedOwner.status !== "mapped" || keptTokens.has(token) || explicitlyDisplaced.has(token) || keptPositions.has(mappedOwner.pos) || !census.paragraphs.has(mappedOwner.pos)) continue;
+		updates.set(mappedOwner.pos, token);
+	}
+	return [...updates].map(([pos, token]) => ({
+		pos,
+		token
+	})).sort((left, right) => left.pos - right.pos);
+};
 const collectInitialParaIds = (doc) => {
 	let needsRewrite = false;
 	const taken = /* @__PURE__ */ new Set();
@@ -215,12 +285,20 @@ const ensureParaIdsInState = (state) => {
 };
 const createParaIdAllocatorPlugin = () => new Plugin({
 	key: paraIdAllocatorKey,
+	state: {
+		init: (_config, state) => collectParagraphPropertySourceSeed(state.doc),
+		apply: (_transaction, seed) => seed
+	},
 	appendTransaction(transactions, oldState, newState) {
 		if (!transactions.some((t) => t.docChanged)) return null;
-		const keeperPositions = mapKeeperPositions(oldState.doc, transactions);
-		const seed = transactions.map((transaction) => transaction.getMeta(deterministicParaIdSeedKey)).find((value) => typeof value === "string") ?? null;
-		const updates = collectParaIdUpdates(newState.doc, keeperPositions, seed);
-		if (updates.length === 0) return null;
+		const paragraphSourceSeed = paraIdAllocatorKey.getState(oldState);
+		if (!paragraphSourceSeed) panic("ParaId allocator lost its paragraph-property source seed");
+		const keeperPositions = mapParagraphKeepers(oldState.doc, transactions, paragraphSourceSeed);
+		const deterministicSeed = transactions.map((transaction) => transaction.getMeta(deterministicParaIdSeedKey)).find((value) => typeof value === "string") ?? null;
+		const census = collectParagraphCensus(newState.doc, paragraphSourceSeed);
+		const updates = collectParaIdUpdatesFromCensus(census, keeperPositions.paraIds, deterministicSeed);
+		const paragraphSourceUpdates = collectParagraphPropertySourceUpdates(census, keeperPositions.sourceTokens, transactions);
+		if (updates.length === 0 && paragraphSourceUpdates.length === 0) return null;
 		const tr = newState.tr;
 		for (const u of updates) setProseParagraphMarkupWithPropertySource({
 			attrs: u.attrs,
@@ -228,6 +306,19 @@ const createParaIdAllocatorPlugin = () => new Plugin({
 			pos: u.pos,
 			transaction: tr
 		});
+		for (const { pos, token } of paragraphSourceUpdates) {
+			const paragraph = tr.doc.nodeAt(pos);
+			if (!paragraph || paragraph.type.name !== "paragraph") panic("Paragraph-property token update lost its paragraph");
+			setProseParagraphMarkupWithPropertySource({
+				attrs: {
+					...paragraph.attrs,
+					[PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR]: token
+				},
+				ownership: "preserve",
+				pos,
+				transaction: tr
+			});
+		}
 		ignoreTrackedChanges(tr);
 		tr.setMeta(paraIdAllocatorKey, "allocated");
 		tr.setMeta("addToHistory", false);

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -1,66 +1,7 @@
-import { document_d_exports } from "../../../types/document.js";
-import { OutlineStyleAttr } from "../../../types/documentEnumValues.js";
-import { ImagePositionAttrs, TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
+import { TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
-type TextBoxAttrs = {
-  /** Width in pixels */
-  width?: number;
-  /** Height in pixels */
-  height?: number;
-  /** Text fitting behavior */
-  autoFit?: document_d_exports.ShapeTextBody["autoFit"];
-  /** Horizontal text wrapping inside the box */
-  textWrap?: document_d_exports.ShapeTextBody["textWrap"];
-  /** Unique identifier */
-  textBoxId?: string;
-  /** Fill color as CSS color */
-  fillColor?: string;
-  /** Outline width in pixels */
-  outlineWidth?: number;
-  /** Outline color as CSS color */
-  outlineColor?: string;
-  /** Outline dash style, or `"none"` for an explicit no-outline. */
-  outlineStyle?: OutlineStyleAttr;
-  /** Internal margin top in pixels */
-  marginTop?: number;
-  /** Internal margin bottom in pixels */
-  marginBottom?: number;
-  /** Internal margin left in pixels */
-  marginLeft?: number;
-  /** Internal margin right in pixels */
-  marginRight?: number;
-  /** Vertical text alignment */
-  verticalAlign?: string;
-  /** Display mode */
-  displayMode?: "inline" | "float" | "block";
-  /** CSS float direction */
-  cssFloat?: "left" | "right" | "none";
-  /** Wrap type */
-  wrapType?: document_d_exports.ImageWrap["type"];
-  /** OOXML wrapText direction for anchored text boxes (eigenpal #474). */
-  wrapText?: "bothSides" | "left" | "right" | "largest";
-  /** Wrap distance from top edge, in pixels (OOXML distT, EMU-converted). */
-  distTop?: number;
-  /** Wrap distance from bottom edge, in pixels. */
-  distBottom?: number;
-  /** Wrap distance from left edge, in pixels. */
-  distLeft?: number;
-  /** Wrap distance from right edge, in pixels. */
-  distRight?: number;
-  /** Position for floating/anchored text boxes. */
-  position?: ImagePositionAttrs;
-  /** Original DOCX placement hint for save-path reconstruction. */
-  _docxPlacement?: "standalone" | "inlineWithPrevious";
-  /** Original DOCX paragraph group for standalone text-box reconstruction. */
-  _docxGroupId?: string;
-  /** Inline anchor linking this block node to its source run position. */
-  _docxAnchorId?: string;
-  /** Original run-level revision wrapper for save-path reconstruction. */
-  _docxTrackedChange?: TextBoxAttrs$1["_docxTrackedChange"];
-  /** Original inline content-control ancestry for save-path reconstruction. */
-  _docxInlineSdts?: TextBoxAttrs$1["_docxInlineSdts"];
-};
+type TextBoxAttrs = TextBoxAttrs$1;
 declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion
 export { TextBoxAttrs, TextBoxExtension };

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -2,6 +2,13 @@ import { IMAGE_WRAP_TYPE_VALUES, normalizeShapeTextAnchor } from "../../../types
 import { expectTextBoxAttrs } from "../../attrs/index.js";
 import { createNodeExtension } from "../create.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.ts
+/**
+* TextBox Extension — editable text box node
+*
+* An isolating block node that contains paragraphs (and tables).
+* Rendered as a positioned container with optional fill, outline, and margins.
+* Supports inline and floating positioning.
+*/
 function parseTextBoxPosition(raw) {
 	if (!raw) return;
 	try {
@@ -42,6 +49,7 @@ const TextBoxExtension = createNodeExtension({
 			outlineWidth: { default: null },
 			outlineColor: { default: null },
 			outlineStyle: { default: null },
+			transform: { default: null },
 			marginTop: { default: 4 },
 			marginBottom: { default: 4 },
 			marginLeft: { default: 7 },
@@ -59,6 +67,7 @@ const TextBoxExtension = createNodeExtension({
 			_docxPlacement: { default: null },
 			_docxGroupId: { default: null },
 			_docxAnchorId: { default: null },
+			_docxTextBodyContentState: { default: { type: "authored" } },
 			_docxTrackedChange: { default: null },
 			_docxInlineSdts: { default: null }
 		},
@@ -73,6 +82,7 @@ const TextBoxExtension = createNodeExtension({
 				const textWrap = parseTextBoxTextWrap(d["textWrap"]);
 				const verticalAlign = parseTextBoxVerticalAlign(d["verticalAlign"]);
 				return {
+					_docxTextBodyContentState: { type: "authored" },
 					...d["width"] ? { width: Number(d["width"]) } : {},
 					...d["height"] ? { height: Number(d["height"]) } : {},
 					...autoFit ? { autoFit } : {},
@@ -82,6 +92,7 @@ const TextBoxExtension = createNodeExtension({
 					...d["outlineWidth"] ? { outlineWidth: Number(d["outlineWidth"]) } : {},
 					...d["outlineColor"] ? { outlineColor: d["outlineColor"] } : {},
 					...d["outlineStyle"] ? { outlineStyle: d["outlineStyle"] } : {},
+					...d["transform"] ? { transform: d["transform"] } : {},
 					...d["marginTop"] ? { marginTop: Number(d["marginTop"]) } : {},
 					...d["marginBottom"] ? { marginBottom: Number(d["marginBottom"]) } : {},
 					...d["marginLeft"] ? { marginLeft: Number(d["marginLeft"]) } : {},
@@ -111,6 +122,7 @@ const TextBoxExtension = createNodeExtension({
 			if (attrs.outlineWidth) domAttrs["data-outline-width"] = String(attrs.outlineWidth);
 			if (attrs.outlineColor) domAttrs["data-outline-color"] = attrs.outlineColor;
 			if (attrs.outlineStyle) domAttrs["data-outline-style"] = attrs.outlineStyle;
+			if (attrs.transform) domAttrs["data-transform"] = attrs.transform;
 			if (typeof attrs.marginTop === "number") domAttrs["data-margin-top"] = String(attrs.marginTop);
 			if (typeof attrs.marginBottom === "number") domAttrs["data-margin-bottom"] = String(attrs.marginBottom);
 			if (typeof attrs.marginLeft === "number") domAttrs["data-margin-left"] = String(attrs.marginLeft);
@@ -158,6 +170,10 @@ const TextBoxExtension = createNodeExtension({
 			styles.push("box-sizing: border-box");
 			styles.push("overflow: hidden");
 			styles.push("position: relative");
+			if (attrs.transform) {
+				styles.push(`transform: ${attrs.transform}`);
+				styles.push("transform-origin: center center");
+			}
 			domAttrs["style"] = styles.join("; ");
 			return [
 				"div",

package/dist/prosemirror/schema/nodes.d.ts

@@ -488,6 +488,10 @@ type ShapeAttrs = {
 /**
  * Text box node attributes
  */
+declare const TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES: readonly ["source-empty", "authored"];
+type TextBoxTextBodyContentState = { [Type in (typeof TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES)[number]]: {
+  readonly type: Type;
+}; }[(typeof TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES)[number]];
 type TextBoxAttrs = {
   /** Width in pixels */
   width?: number;
@@ -507,6 +511,8 @@ type TextBoxAttrs = {
   outlineColor?: string;
   /** Outline dash style, or `"none"` for an explicit no-outline. */
   outlineStyle?: OutlineStyleAttr;
+  /** DrawingML rotation and/or flips, serialized as CSS transform functions. */
+  transform?: string;
   /** Internal margin top in pixels */
   marginTop?: number;
   /** Internal margin bottom in pixels */
@@ -541,6 +547,12 @@ type TextBoxAttrs = {
   _docxGroupId?: string;
   /** Inline anchor linking this block node to its source run position. */
   _docxAnchorId?: string;
+  /**
+   * Ownership of the schema-required placeholder paragraph. A source text
+   * body with no children needs one paragraph while it is editable, but that
+   * paragraph is not authored document content.
+   */
+  _docxTextBodyContentState: TextBoxTextBodyContentState;
   /** Original run-level revision wrapper for save-path reconstruction. */
   _docxTrackedChange?: {
     type: "insertion";
@@ -765,7 +777,7 @@ type TableCellAttrs = {
   /** Preserve a DOCX vMerge restart even when PM cannot model it as a rowspan. */
   _preserveVMergeRestart?: boolean;
   /** Original DOCX vMerge continuation cells skipped into this PM rowspan. */
-  _docxVMergeContinuationCells?: document_d_exports.TableCell[];
+  _docxVMergeContinuationCells?: unknown;
 };
 //#endregion
-export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };
+export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };

package/dist/prosemirror/schema/nodes.js

@@ -0,0 +1,7 @@
+//#region src/prosemirror/schema/nodes.ts
+/**
+* Text box node attributes
+*/
+const TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES = Object.freeze(["source-empty", "authored"]);
+//#endregion
+export { TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES };

package/dist/prosemirror/yjsParagraphSourceContract.d.ts

@@ -0,0 +1,9 @@
+import { Node } from "prosemirror-model";
+import * as Y from "yjs";
+//#region src/prosemirror/yjsParagraphSourceContract.d.ts
+declare const proseDocumentParagraphSourceContract: (document: Node) => string | null;
+declare const writeYjsParagraphSourceContract: (ydoc: Y.Doc, document: Node) => void;
+declare const readYjsParagraphSourceContract: (ydoc: Y.Doc) => string | null;
+declare const withParagraphSourceContract: (document: Node, contract: string) => Node;
+//#endregion
+export { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract };

package/dist/prosemirror/yjsParagraphSourceContract.js

@@ -0,0 +1,26 @@
+import { PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR, getProseDocumentParagraphPropertySourceContract } from "../docx/paragraphPropertySource.js";
+import { panic } from "better-result";
+//#region src/prosemirror/yjsParagraphSourceContract.ts
+const FOLIO_YJS_METADATA_MAP_NAME = "folio:document-metadata";
+const PARAGRAPH_SOURCE_CONTRACT_KEY = "paragraphSourceContract";
+const proseDocumentParagraphSourceContract = (document) => {
+	return getProseDocumentParagraphPropertySourceContract(document);
+};
+const writeYjsParagraphSourceContract = (ydoc, document) => {
+	const contract = proseDocumentParagraphSourceContract(document);
+	if (!contract) panic("Cannot seed collaboration without a paragraph-property source contract");
+	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(PARAGRAPH_SOURCE_CONTRACT_KEY, contract);
+};
+const readYjsParagraphSourceContract = (ydoc) => {
+	const contract = ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).get(PARAGRAPH_SOURCE_CONTRACT_KEY);
+	return typeof contract === "string" ? contract : null;
+};
+const withParagraphSourceContract = (document, contract) => {
+	if (document.type.name !== "doc") panic("A paragraph-property source contract can only attach to a document node");
+	return document.type.create({
+		...document.attrs,
+		[PROSE_PARAGRAPH_SOURCE_CONTRACT_ATTR]: contract
+	}, document.content, document.marks);
+};
+//#endregion
+export { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract };

package/dist/utils/rotationBoundingBox.d.ts

@@ -5,7 +5,11 @@ type BoundingBox = {
   height: number;
 };
 declare function parseRotationDegrees(transform: string | undefined): number;
+/** Whether a DrawingML/CSS transform reflects around the vertical centre line. */
+declare function hasHorizontalFlip(transform: string | undefined): boolean;
+/** Whether a DrawingML/CSS transform reflects around the horizontal centre line. */
+declare function hasVerticalFlip(transform: string | undefined): boolean;
 declare function rotatedBoundingBox(w: number, h: number, deg: number): BoundingBox;
 declare function inlineImageBoundingBox(run: ImageRun): BoundingBox;
 //#endregion
-export { BoundingBox, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };
+export { BoundingBox, hasHorizontalFlip, hasVerticalFlip, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };

package/dist/utils/rotationBoundingBox.js

@@ -7,6 +7,14 @@ function parseRotationDegrees(transform) {
 	if (!Number.isFinite(raw)) return 0;
 	return (raw % 360 + 360) % 360;
 }
+/** Whether a DrawingML/CSS transform reflects around the vertical centre line. */
+function hasHorizontalFlip(transform) {
+	return /scaleX\(\s*-1\s*\)/iu.test(transform ?? "");
+}
+/** Whether a DrawingML/CSS transform reflects around the horizontal centre line. */
+function hasVerticalFlip(transform) {
+	return /scaleY\(\s*-1\s*\)/iu.test(transform ?? "");
+}
 function rotatedBoundingBox(w, h, deg) {
 	if (deg === 0 || deg === 180) return {
 		width: w,
@@ -33,4 +41,4 @@ function inlineImageBoundingBox(run) {
 	return rotatedBoundingBox(run.width, run.height, rotation);
 }
 //#endregion
-export { inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };
+export { hasHorizontalFlip, hasVerticalFlip, inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.37.2",
+  "version": "0.37.4",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -121,7 +121,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.19.3",
+    "@stll/docx-core": "^0.19.4",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": ">=0.4.0 <1.0.0",
     "better-result": "3.0.1",