@stll/folio-core 0.15.0 → 0.15.2

package/dist/utils/colorResolver.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/colorResolver.d.ts
 /**
  * Public form of the same hex-color check, for callers that read a color
@@ -127,10 +126,15 @@ declare function resolveHighlightToCss(value: string): string;
  * Theme color matrix cell
  */
 type ThemeMatrixCell = {
-  /** Resolved hex color (6 chars, no #) */hex: string; /** Theme color slot */
-  themeSlot: document_d_exports.ThemeColorSlot; /** Tint hex modifier if applicable (e.g., "CC") */
-  tint?: string; /** Shade hex modifier if applicable (e.g., "BF") */
-  shade?: string; /** Human-readable label (e.g., "Accent 1, Lighter 60%") */
+  /** Resolved hex color (6 chars, no #) */
+  hex: string;
+  /** Theme color slot */
+  themeSlot: document_d_exports.ThemeColorSlot;
+  /** Tint hex modifier if applicable (e.g., "CC") */
+  tint?: string;
+  /** Shade hex modifier if applicable (e.g., "BF") */
+  shade?: string;
+  /** Human-readable label (e.g., "Accent 1, Lighter 60%") */
   label: string;
 };
 /**

package/dist/utils/createDocument.d.ts

@@ -1,25 +1,34 @@
 import { document_d_exports } from "../types/document.js";
 import { DocumentPreset, DocumentStyleSet } from "../style-sets/types.js";
-
 //#region src/utils/createDocument.d.ts
 /**
  * Options for creating an empty document
  */
 type CreateEmptyDocumentBaseOptions = {
-  /** Page width in twips (default: 12240 = 8.5 inches) */pageWidth?: number; /** Page height in twips (default: 15840 = 11 inches) */
-  pageHeight?: number; /** Page orientation (default: 'portrait') */
-  orientation?: "portrait" | "landscape"; /** Top margin in twips (default: 1440 = 1 inch) */
-  marginTop?: number; /** Bottom margin in twips (default: 1440 = 1 inch) */
-  marginBottom?: number; /** Left margin in twips (default: 1440 = 1 inch) */
-  marginLeft?: number; /** Right margin in twips (default: 1440 = 1 inch) */
-  marginRight?: number; /** Initial text content (default: empty string) */
+  /** Page width in twips (default: 12240 = 8.5 inches) */
+  pageWidth?: number;
+  /** Page height in twips (default: 15840 = 11 inches) */
+  pageHeight?: number;
+  /** Page orientation (default: 'portrait') */
+  orientation?: "portrait" | "landscape";
+  /** Top margin in twips (default: 1440 = 1 inch) */
+  marginTop?: number;
+  /** Bottom margin in twips (default: 1440 = 1 inch) */
+  marginBottom?: number;
+  /** Left margin in twips (default: 1440 = 1 inch) */
+  marginLeft?: number;
+  /** Right margin in twips (default: 1440 = 1 inch) */
+  marginRight?: number;
+  /** Initial text content (default: empty string) */
   initialText?: string;
 };
 type CreateEmptyDocumentStyleOptions = {
-  /** Reusable formatting resources for the new document. */styleSet?: DocumentStyleSet;
+  /** Reusable formatting resources for the new document. */
+  styleSet?: DocumentStyleSet;
   preset?: never;
 } | {
-  /** Style resources plus page-level defaults for the new document. */preset: DocumentPreset;
+  /** Style resources plus page-level defaults for the new document. */
+  preset: DocumentPreset;
   styleSet?: never;
 };
 type CreateEmptyDocumentOptions = CreateEmptyDocumentBaseOptions & CreateEmptyDocumentStyleOptions;

package/dist/utils/documentLoaderBehavior.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { DocxInput } from "./docxInput.js";
-
 //#region src/utils/documentLoaderBehavior.d.ts
 type DocumentLoadSource = {
   type: "buffer";
@@ -11,10 +10,7 @@ type DocumentLoadSource = {
 } | {
   type: "none";
 };
-declare const getDocumentLoadSource: ({
-  documentBuffer,
-  initialDocument
-}: {
+declare const getDocumentLoadSource: ({ documentBuffer, initialDocument }: {
   documentBuffer: DocxInput | null | undefined;
   initialDocument: document_d_exports.Document | null | undefined;
 }) => DocumentLoadSource;

package/dist/utils/docxInput.js

@@ -5,6 +5,7 @@
 function toArrayBuffer(input) {
 	if (input instanceof ArrayBuffer) return Promise.resolve(input);
 	if (input instanceof Uint8Array) {
+		if (input.buffer instanceof ArrayBuffer && input.byteOffset === 0 && input.byteLength === input.buffer.byteLength) return Promise.resolve(input.buffer);
 		const copy = new ArrayBuffer(input.byteLength);
 		new Uint8Array(copy).set(input);
 		return Promise.resolve(copy);

package/dist/utils/findReplace.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { Paragraph } from "../types/content.js";
-
 //#region src/utils/findReplace.d.ts
 type FindMatch = {
   paragraphIndex: number;

package/dist/utils/fontFamilyMerge.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/fontFamilyMerge.d.ts
 type FontFamily = NonNullable<document_d_exports.TextFormatting["fontFamily"]>;
 declare function mergeFontFamily(target: FontFamily | undefined, source: FontFamily): FontFamily;

package/dist/utils/fontResolver.d.ts

@@ -1,13 +1,19 @@
 import { document_d_exports } from "../types/document.js";
+import "../types/index.js";
 //#region src/utils/fontResolver.d.ts
 /**
  * Result of resolving a font family
  */
 type ResolvedFont = {
-  /** Google Font name to load (null if no mapping available) */googleFont: string | null; /** CSS font-family value with proper fallback stack */
-  cssFallback: string; /** Original font name from the DOCX */
-  originalFont: string; /** Whether this font has a Google Fonts equivalent */
-  hasGoogleEquivalent: boolean; /** Single-line height ratio (single-line height ÷ font size). See `FontLineHeight`. */
+  /** Google Font name to load (null if no mapping available) */
+  googleFont: string | null;
+  /** CSS font-family value with proper fallback stack */
+  cssFallback: string;
+  /** Original font name from the DOCX */
+  originalFont: string;
+  /** Whether this font has a Google Fonts equivalent */
+  hasGoogleEquivalent: boolean;
+  /** Single-line height ratio (single-line height ÷ font size). See `FontLineHeight`. */
   singleLineRatio: number;
 };
 /**

package/dist/utils/formatToStyle.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { ColorValue } from "../types/colors.js";
 import { Properties } from "csstype";
-
 //#region src/utils/formatToStyle.d.ts
 type CSSProperties = Properties<string | number>;
 /**

package/dist/utils/headerFooter.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/headerFooter.d.ts
 type HeaderFooterPosition = "header" | "footer";
 /**
@@ -39,8 +38,10 @@ declare const createEmptyHeaderFooter: (document: document_d_exports.Document, p
 type SaveHeaderFooterArgs = {
   document: document_d_exports.Document;
   position: HeaderFooterPosition;
-  isFirstPage: boolean; /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
-  activeRId: string; /** The serialised header/footer body (from the live PM doc). */
+  isFirstPage: boolean;
+  /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
+  activeRId: string;
+  /** The serialised header/footer body (from the live PM doc). */
   blocks: document_d_exports.BlockContent[];
 };
 /**
@@ -49,26 +50,17 @@ type SaveHeaderFooterArgs = {
  * Document untouched so undo can step back to the pre-edit state. Returns null
  * when the target header/footer cannot be found.
  */
-declare const saveHeaderFooterContent: ({
-  document,
-  position,
-  isFirstPage,
-  activeRId,
-  blocks
-}: SaveHeaderFooterArgs) => document_d_exports.Document | null;
+declare const saveHeaderFooterContent: ({ document, position, isFirstPage, activeRId, blocks }: SaveHeaderFooterArgs) => document_d_exports.Document | null;
 type RemoveHeaderFooterArgs = {
   document: document_d_exports.Document;
-  position: HeaderFooterPosition; /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
+  position: HeaderFooterPosition;
+  /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
   activeRId: string;
 };
 /**
  * Remove a header/footer and drop its reference from every section that points
  * at it, returning the new Document.
  */
-declare const removeHeaderFooter: ({
-  document,
-  position,
-  activeRId
-}: RemoveHeaderFooterArgs) => document_d_exports.Document;
+declare const removeHeaderFooter: ({ document, position, activeRId }: RemoveHeaderFooterArgs) => document_d_exports.Document;
 //#endregion
 export { HeaderFooterPosition, HeaderFooterResolution, RemoveHeaderFooterArgs, SaveHeaderFooterArgs, createEmptyHeaderFooter, pickActiveHeaderFooterRId, removeHeaderFooter, resolveEffectiveSectionProperties, resolveHeaderFooterContent, saveHeaderFooterContent };

package/dist/utils/headingCollector.d.ts

@@ -1,13 +1,16 @@
 import { Node } from "prosemirror-model";
-
 //#region src/utils/headingCollector.d.ts
 /**
  * Information about a heading found in the document.
  */
 type HeadingInfo = {
-  /** The text content of the heading */text: string; /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
-  level: number; /** ProseMirror document position of the paragraph node */
-  pmPos: number; /** 1-indexed page number, filled in by the editor once layout is known. */
+  /** The text content of the heading */
+  text: string;
+  /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
+  level: number;
+  /** ProseMirror document position of the paragraph node */
+  pmPos: number;
+  /** 1-indexed page number, filled in by the editor once layout is known. */
   pageNumber?: number | null;
 };
 /**

package/dist/utils/mergeDocumentContent.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/mergeDocumentContent.d.ts
 /**
  * Append `source`'s body content onto `target`'s. Both documents keep their

package/dist/utils/paragraphFormattingMerge.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/paragraphFormattingMerge.d.ts
 /**
  * Merge custom tab stops across OOXML paragraph-property layers.

package/dist/utils/replaceText.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/replaceText.d.ts
 type ReplaceRange = {
   start: {

package/dist/utils/rotationBoundingBox.d.ts

@@ -1,5 +1,4 @@
 import { ImageRun } from "../layout-engine/types.js";
-
 //#region src/utils/rotationBoundingBox.d.ts
 type BoundingBox = {
   width: number;

package/dist/utils/tableOperations.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/tableOperations.d.ts
 type TableAction = "addRowAbove" | "addRowBelow" | "addColumnLeft" | "addColumnRight" | "deleteRow" | "deleteColumn" | "mergeCells" | "splitCell" | "deleteTable" | "selectTable" | "selectRow" | "selectColumn" | "borderAll" | "borderOutside" | "borderInside" | "borderNone" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | {
   type: "cellFillColor";

package/dist/utils/textFormattingMerge.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/utils/textFormattingMerge.d.ts
 declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
 //#endregion

package/dist/version-comparison.d.ts

@@ -2,7 +2,6 @@ import { FolioAIBlock } from "./ai-edits/types.js";
 import { FolioDocumentStoryHandle } from "./ai-edits/headless.js";
 import { WordDiffSegment } from "./ai-edits/word-diff.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FolioDocumentMetadataProperty, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform } from "./docx/metadataPrivacy.js";
-
 //#region src/version-comparison.d.ts
 /** One word-level diff segment within a `modified` block. Mirrors {@link WordDiffSegment}. */
 type FolioVersionDiffSegment = WordDiffSegment;
@@ -11,7 +10,9 @@ declare const FOLIO_VERSION_COMPARISON_SCOPES: readonly ["text", "formatting", "
 type FolioVersionComparisonScope = (typeof FOLIO_VERSION_COMPARISON_SCOPES)[number];
 declare const isFolioVersionComparisonScope: (value: unknown) => value is FolioVersionComparisonScope;
 type FolioCompareDocxVersionsOptions = {
-  /** Selected scopes; defaults to text and formatting. */include?: readonly FolioVersionComparisonScope[]; /** Optional output-only privacy transforms. Source buffers are never mutated. */
+  /** Selected scopes; defaults to text and formatting. */
+  include?: readonly FolioVersionComparisonScope[];
+  /** Optional output-only privacy transforms. Source buffers are never mutated. */
   privacy?: FolioVersionDiffPrivacyOptions;
 };
 declare const InvalidFolioVersionComparisonOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioVersionComparisonOptionsError", {
@@ -101,10 +102,15 @@ type FolioStoryDiff = {
 };
 /** Result of {@link compareDocxVersions}. */
 type FolioVersionDiff = {
-  /** Every changed block, in revised-side document order (deletions and move sources slotted where they sat). */changes: FolioBlockDiff[]; /** Per-story results in base order followed by stories added in the revised document. */
-  stories: FolioStoryDiff[]; /** Changed package metadata fields in stable property order. */
-  metadataChanges: FolioMetadataDiff[]; /** Applied privacy policy and the fields it removed from this result. */
-  privacyReport: FolioVersionDiffPrivacyReport; /** Counts across every paired/unpaired block, including the unchanged blocks `changes` omits. `moved` counts pairs, not entries. */
+  /** Every changed block, in revised-side document order (deletions and move sources slotted where they sat). */
+  changes: FolioBlockDiff[];
+  /** Per-story results in base order followed by stories added in the revised document. */
+  stories: FolioStoryDiff[];
+  /** Changed package metadata fields in stable property order. */
+  metadataChanges: FolioMetadataDiff[];
+  /** Applied privacy policy and the fields it removed from this result. */
+  privacyReport: FolioVersionDiffPrivacyReport;
+  /** Counts across every paired/unpaired block, including the unchanged blocks `changes` omits. `moved` counts pairs, not entries. */
   summaryCounts: FolioVersionDiffSummaryCounts;
 };
 /** True when an `unpairedBaseCount * unpairedRevisedCount` LCS table would exceed {@link MAX_LCS_CELLS}. */

package/dist/watermark/index.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/watermark/index.d.ts
 /**
  * Whether `target` is safe to save as a watermark picture's external image

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -107,10 +107,10 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.5.0",
+    "@stll/docx-core": "^0.5.2",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
-    "better-result": "2.9.2",
+    "better-result": "2.10.0",
     "csstype": "^3.1.3",
     "dompurify": "^3.4.12",
     "fast-xml-parser": "^5.9.3",