@stll/folio-core 0.61.0 → 0.63.0

package/dist/utils/colorResolver.d.ts

@@ -7,7 +7,7 @@ import { ThemeColor } from "@stll/docx-core/model";
  * which bypasses the CSSOM's own value validation) and must reject it
  * before storing it as editor state.
  */
-declare function isValidHexColor(value: string | undefined | null): boolean;
+export declare function isValidHexColor(value: string | undefined | null): boolean;
 /**
  * Resolve a ColorValue to a CSS color string
  *
@@ -16,7 +16,7 @@ declare function isValidHexColor(value: string | undefined | null): boolean;
  * @param defaultColor - Default color if auto or undefined (default: black)
  * @returns CSS color string (e.g., "#FF0000" or "inherit")
  */
-declare function resolveColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, defaultColor?: string): string;
+export declare function resolveColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, defaultColor?: string): string;
 /**
  * Resolve a highlight color name to CSS
  *
@@ -29,8 +29,8 @@ declare function resolveColor(color: document_d_exports.ColorValue | undefined |
  * document theme; explicit `rgb` values are upper-cased. Used by adapters that
  * need a normalized hex (e.g. comparing a cell fill against a swatch).
  */
-declare function resolveColorToHex(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string | undefined;
-declare function resolveHighlightColor(highlight: string | undefined): string;
+export declare function resolveColorToHex(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string | undefined;
+export declare function resolveHighlightColor(highlight: string | undefined): string;
 /**
  * Resolve a shading fill or pattern color to CSS
  *
@@ -38,7 +38,7 @@ declare function resolveHighlightColor(highlight: string | undefined): string;
  * @param theme - Theme for resolving theme colors
  * @returns CSS color string
  */
-declare function resolveShadingColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
+export declare function resolveShadingColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
 /**
  * Check if a color is effectively black
  *
@@ -46,7 +46,7 @@ declare function resolveShadingColor(color: document_d_exports.ColorValue | unde
  * @param theme - Theme for resolving theme colors
  * @returns True if color resolves to black or very dark
  */
-declare function isBlack(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+export declare function isBlack(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
 /**
  * Check if a color is effectively white
  *
@@ -54,7 +54,7 @@ declare function isBlack(color: document_d_exports.ColorValue | undefined | null
  * @param theme - Theme for resolving theme colors
  * @returns True if color resolves to white or very light
  */
-declare function isWhite(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+export declare function isWhite(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
 /**
  * Get contrasting text color for a background
  *
@@ -62,14 +62,14 @@ declare function isWhite(color: document_d_exports.ColorValue | undefined | null
  * @param theme - Theme for resolving theme colors
  * @returns Black or white hex color for best contrast
  */
-declare function getContrastingColor(backgroundColor: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
+export declare function getContrastingColor(backgroundColor: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string;
 /**
  * Parse a color string (various formats) to ColorValue
  *
  * @param colorString - Color string like "FF0000", "auto", or theme color name
  * @returns ColorValue object
  */
-declare function parseColorString(colorString: string | undefined): document_d_exports.ColorValue | undefined;
+export declare function parseColorString(colorString: string | undefined): document_d_exports.ColorValue | undefined;
 /**
  * Create a ColorValue from theme color reference
  *
@@ -78,14 +78,14 @@ declare function parseColorString(colorString: string | undefined): document_d_e
  * @param shade - Optional shade modifier
  * @returns ColorValue object
  */
-declare function createThemeColor(themeColor: ThemeColor, tint?: number, shade?: number): document_d_exports.ColorValue;
+export declare function createThemeColor(themeColor: ThemeColor, tint?: number, shade?: number): document_d_exports.ColorValue;
 /**
  * Create a ColorValue from RGB hex
  *
  * @param hex - 6-character hex color (no #)
  * @returns ColorValue object
  */
-declare function createRgbColor(hex: string): document_d_exports.ColorValue;
+export declare function createRgbColor(hex: string): document_d_exports.ColorValue;
 /**
  * Darken a color by a percentage
  *
@@ -94,7 +94,7 @@ declare function createRgbColor(hex: string): document_d_exports.ColorValue;
  * @param percent - Percentage to darken (0-100)
  * @returns CSS color string
  */
-declare function darkenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
+export declare function darkenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
 /**
  * Lighten a color by a percentage
  *
@@ -103,7 +103,7 @@ declare function darkenColor(color: document_d_exports.ColorValue | undefined |
  * @param percent - Percentage to lighten (0-100)
  * @returns CSS color string
  */
-declare function lightenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
+export declare function lightenColor(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined, percent: number): string;
 /**
  * Blend two colors together
  *
@@ -113,20 +113,20 @@ declare function lightenColor(color: document_d_exports.ColorValue | undefined |
  * @param theme - Theme for resolving
  * @returns CSS color string
  */
-declare function blendColors(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, ratio: number, theme: document_d_exports.Theme | null | undefined): string;
+export declare function blendColors(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, ratio: number, theme: document_d_exports.Theme | null | undefined): string;
 /**
  * Ensure a hex color string has a '#' prefix.
  */
-declare function ensureHexPrefix(hex: string): string;
+export declare function ensureHexPrefix(hex: string): string;
 /**
  * Resolve a highlight color value to a CSS-ready string.
  * Tries OOXML named highlight first, then ensures hex prefix.
  */
-declare function resolveHighlightToCss(value: string): string;
+export declare function resolveHighlightToCss(value: string): string;
 /**
  * Theme color matrix cell
  */
-type ThemeMatrixCell = {
+export type ThemeMatrixCell = {
   /** Resolved hex color (6 chars, no #) */
   hex: string;
   /** The `w:themeColor` token this swatch writes */
@@ -141,7 +141,7 @@ type ThemeMatrixCell = {
 /**
  * Standard colors row matching Word's color picker (below the theme matrix).
  */
-declare const STANDARD_TEXT_COLORS: {
+export declare const STANDARD_TEXT_COLORS: {
   name: string;
   hex: string;
 }[];
@@ -153,7 +153,7 @@ declare const STANDARD_TEXT_COLORS: {
  * @param fraction - Amount (0-1). For tint: 0=no change, 1=white. For shade: 0=black, 1=no change.
  * @returns 6-character hex color (no #)
  */
-declare function getThemeTintShadeHex(baseHex: string, type: "tint" | "shade", fraction: number): string;
+export declare function getThemeTintShadeHex(baseHex: string, type: "tint" | "shade", fraction: number): string;
 /**
  * Generate the 10×6 theme color matrix for an advanced color picker.
  *
@@ -163,7 +163,7 @@ declare function getThemeTintShadeHex(baseHex: string, type: "tint" | "shade", f
  * @param colorScheme - Theme color scheme (falls back to Office 2016 defaults)
  * @returns 6 rows × 10 columns of ThemeMatrixCell
  */
-declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.ThemeColorScheme | null): ThemeMatrixCell[][];
+export declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.ThemeColorScheme | null): ThemeMatrixCell[][];
 /**
  * Check if two colors are equal
  *
@@ -172,6 +172,5 @@ declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.T
  * @param theme - Theme for resolving
  * @returns True if colors resolve to the same value
  */
-declare function colorsEqual(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
-//#endregion
-export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isValidHexColor, isWhite, lightenColor, parseColorString, resolveColor, resolveColorToHex, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };
+export declare function colorsEqual(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
+//#endregion

package/dist/utils/colorResolver.js

@@ -2,26 +2,6 @@ import { sliceText } from "./sliceText.js";
 import { THEME_COLOR_BY_SCHEME_COLOR_VALUE, isSchemeColorValue, isThemeColor, themeColorSlot } from "@stll/docx-core/model";
 //#region src/utils/colorResolver.ts
 /**
-* Color Resolver - Convert OOXML colors to CSS
-*
-* Handles:
-* - Theme color references (accent1, dk1, etc.)
-* - RGB hex values
-* - "auto" colors (context-dependent)
-* - Tint/shade modifications
-*
-* OOXML Color References:
-* - w:color/@w:val - RGB hex or "auto"
-* - w:color/@w:themeColor - Theme color slot
-* - w:color/@w:themeTint - Tint modifier (0-255, hex)
-* - w:color/@w:themeShade - Shade modifier (0-255, hex)
-*
-* Tint/Shade Calculations:
-* - Tint makes color lighter (blend with white)
-* - Shade makes color darker (blend with black)
-* - Value is in hex (00-FF), converted to 0-1 for calculation
-*/
-/**
 * Strict hex-color validator shared by every OOXML → CSS color path in this
 * module. OOXML readers are lenient about `w:val`/`w:fill` attribute content
 * and theme swatch text, so a crafted `<w:color>`, table shading, or

package/dist/utils/createDocument.d.ts

@@ -31,7 +31,7 @@ type CreateEmptyDocumentStyleOptions = {
   preset: DocumentPreset;
   styleSet?: never;
 };
-type CreateEmptyDocumentOptions = CreateEmptyDocumentBaseOptions & CreateEmptyDocumentStyleOptions;
+export type CreateEmptyDocumentOptions = CreateEmptyDocumentBaseOptions & CreateEmptyDocumentStyleOptions;
 type CreateDocumentWithTextOptions = Omit<CreateEmptyDocumentBaseOptions, "initialText"> & CreateEmptyDocumentStyleOptions;
 /**
  * Create an empty document with a single paragraph
@@ -56,7 +56,7 @@ type CreateDocumentWithTextOptions = Omit<CreateEmptyDocumentBaseOptions, "initi
  * });
  * ```
  */
-declare function createEmptyDocument(options?: CreateEmptyDocumentOptions): document_d_exports.Document;
+export declare function createEmptyDocument(options?: CreateEmptyDocumentOptions): document_d_exports.Document;
 /**
  * Create a document with a single paragraph containing the given text
  *
@@ -64,6 +64,6 @@ declare function createEmptyDocument(options?: CreateEmptyDocumentOptions): docu
  * @param options - Optional configuration for the document
  * @returns A new Document object with the specified text
  */
-declare function createDocumentWithText(text: string, options?: CreateDocumentWithTextOptions): document_d_exports.Document;
+export declare function createDocumentWithText(text: string, options?: CreateDocumentWithTextOptions): document_d_exports.Document;
 //#endregion
-export { CreateEmptyDocumentOptions, createDocumentWithText, createEmptyDocument };
+export {};

package/dist/utils/cursiveJoining.d.ts

@@ -18,24 +18,24 @@
  * see {@link joiningTypes.gen} for why they are generated rather than authored.
  */
 /** Joining_Type D, L or C: this code point can connect to the one after it. */
-declare const joinsToFollowing: (cp: number) => boolean;
+export declare const joinsToFollowing: (cp: number) => boolean;
 /** Joining_Type D, R or C: this code point can connect to the one before it. */
-declare const joinsToPreceding: (cp: number) => boolean;
+export declare const joinsToPreceding: (cp: number) => boolean;
 /**
  * Joining_Type T: invisible to joining. Combining marks (harakat, Syriac
  * vowels) sit between two letters without breaking their connection, so they
  * must be skipped when looking for a joining neighbour.
  */
-declare const isJoiningTransparent: (cp: number) => boolean;
+export declare const isJoiningTransparent: (cp: number) => boolean;
 /** Joining_Type D, L or R: a cursive letter, as opposed to ZWJ or punctuation. */
-declare const isCursiveLetter: (cp: number) => boolean;
+export declare const isCursiveLetter: (cp: number) => boolean;
 /**
  * Whether the text contains any cursive letter at all.
  *
  * Callers gate on this so the all-Latin hot path never pays for joining
  * analysis, mirroring how `hasCjk` gates script segmentation.
  */
-declare function hasCursiveLetter(text: string): boolean;
+export declare function hasCursiveLetter(text: string): boolean;
 /**
  * Whether `before` and `after` were cursively connected before something split
  * them apart.
@@ -44,6 +44,5 @@ declare function hasCursiveLetter(text: string): boolean;
  * means the split is harmless: a space, a non-joining letter such as alef on
  * the left of the cut, punctuation, or a script that does not join at all.
  */
-declare function joinsAcrossBoundary(before: string, after: string): boolean;
-//#endregion
-export { hasCursiveLetter, isCursiveLetter, isJoiningTransparent, joinsAcrossBoundary, joinsToFollowing, joinsToPreceding };
+export declare function joinsAcrossBoundary(before: string, after: string): boolean;
+//#endregion

package/dist/utils/documentLoaderBehavior.d.ts

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

package/dist/utils/documentPointerDown.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/documentPointerDown.d.ts
+type PointerDownListener = (event: PointerEvent) => void;
+export declare const onDocumentPointerDown: (ownerDocument: Document, listener: PointerDownListener) => () => void;
+//#endregion
+export {};

package/dist/utils/documentPointerDown.js

@@ -0,0 +1,28 @@
+//#region src/utils/documentPointerDown.ts
+const registrations = /* @__PURE__ */ new WeakMap();
+const onDocumentPointerDown = (ownerDocument, listener) => {
+	let existing = registrations.get(ownerDocument);
+	if (!existing) {
+		const listeners = /* @__PURE__ */ new Set();
+		const handle = (event) => {
+			for (const callback of Array.from(listeners)) if (listeners.has(callback)) callback(event);
+		};
+		ownerDocument.addEventListener("pointerdown", handle, true);
+		existing = {
+			listeners,
+			detach: () => ownerDocument.removeEventListener("pointerdown", handle, true)
+		};
+		registrations.set(ownerDocument, existing);
+	}
+	const registration = existing;
+	const callback = (event) => listener(event);
+	registration.listeners.add(callback);
+	return () => {
+		if (!registration.listeners.delete(callback)) return;
+		if (registration.listeners.size > 0) return;
+		registration.detach();
+		registrations.delete(ownerDocument);
+	};
+};
+//#endregion
+export { onDocumentPointerDown };

package/dist/utils/docxInput.d.ts

@@ -13,10 +13,9 @@
  * - `Blob` — from drag-and-drop or `<input type="file">`
  * - `File` — subclass of Blob, from `<input type="file">`
  */
-type DocxInput = ArrayBuffer | Uint8Array | Blob | File;
+export type DocxInput = ArrayBuffer | Uint8Array | Blob | File;
 /**
  * Normalize any {@link DocxInput} into an `ArrayBuffer` for internal use.
  */
-declare function toArrayBuffer(input: DocxInput): Promise<ArrayBuffer>;
-//#endregion
-export { DocxInput, toArrayBuffer };
+export declare function toArrayBuffer(input: DocxInput): Promise<ArrayBuffer>;
+//#endregion

package/dist/utils/domGuards.d.ts

@@ -16,7 +16,7 @@
  * Find the first element in `elements` that is an HTMLElement and
  * matches the predicate. Returns `null` if no match.
  */
-declare const findHtmlElement: (elements: readonly Element[], predicate: (el: HTMLElement) => boolean) => HTMLElement | null;
+export declare const findHtmlElement: (elements: readonly Element[], predicate: (el: HTMLElement) => boolean) => HTMLElement | null;
 /**
  * Query a single descendant element matching `selector` and return
  * it only if it's an HTMLElement; null otherwise.
@@ -25,17 +25,17 @@ declare const findHtmlElement: (elements: readonly Element[], predicate: (el: HT
  * a runtime instanceof check (querySelector's generic does not
  * actually validate at runtime).
  */
-declare const queryHtmlElement: (root: ParentNode, selector: string) => HTMLElement | null;
+export declare const queryHtmlElement: (root: ParentNode, selector: string) => HTMLElement | null;
 /**
  * Walk ancestors of `node` and return the nearest one matching
  * `selector` that is an HTMLElement.
  */
-declare const closestHtmlElement: (node: Element | null, selector: string) => HTMLElement | null;
+export declare const closestHtmlElement: (node: Element | null, selector: string) => HTMLElement | null;
 /**
  * Return `el.children[index]` only if it is an HTMLElement;
  * `undefined` otherwise.
  */
-declare const childHtmlElement: (el: Element, index: number) => HTMLElement | undefined;
+export declare const childHtmlElement: (el: Element, index: number) => HTMLElement | undefined;
 /**
  * `querySelectorAll` that returns only HTMLElements.
  *
@@ -45,7 +45,7 @@ declare const childHtmlElement: (el: Element, index: number) => HTMLElement | un
  * The instanceof filter runs once at the source so downstream
  * iteration is statically-typed and pays zero per-element cost.
  */
-declare const htmlQueryAll: (root: ParentNode, selector: string) => HTMLElement[];
+export declare const htmlQueryAll: (root: ParentNode, selector: string) => HTMLElement[];
 /**
  * Assert that `node` is an HTMLElement, throwing if not.
  *
@@ -54,6 +54,5 @@ declare const htmlQueryAll: (root: ParentNode, selector: string) => HTMLElement[
  * after `pagesContainerRef.current` is null-checked). Downstream
  * code reads from the asserted variable with zero runtime cost.
  */
-declare const assertHtmlElement: (node: Node | null | undefined, description?: string) => HTMLElement;
-//#endregion
-export { assertHtmlElement, childHtmlElement, closestHtmlElement, findHtmlElement, htmlQueryAll, queryHtmlElement };
+export declare const assertHtmlElement: (node: Node | null | undefined, description?: string) => HTMLElement;
+//#endregion

package/dist/utils/findMatchView.d.ts

@@ -0,0 +1,32 @@
+import { document_d_exports } from "../types/document.js";
+import { Layout } from "../layout-engine/types.js";
+import { FindMatch } from "./findReplace.js";
+import { FindMatchRange } from "../prosemirror/findReplaceSelection.js";
+import { Node } from "prosemirror-model";
+import { OpStory } from "@stll/docx-core/ops";
+//#region src/utils/findMatchView.d.ts
+/** The same page variant selection used by the painter, including unmounted pages. */
+export declare const getRenderedSearchStories: (layout: Layout | null) => OpStory[];
+type ResolvedMatch = FindMatchRange & {
+  index: number;
+  story: OpStory;
+};
+type FindMatchViewOptions = {
+  container: HTMLElement;
+  document: document_d_exports.Document;
+  bodyDoc?: Node | undefined;
+  matches: readonly FindMatch[];
+  commentRoot?: HTMLElement | undefined;
+  layout?: Layout | null | undefined;
+};
+/** Resolve each story once; box positions are local to their parent story. */
+export declare const resolveDocumentFindRanges: ({ document, bodyDoc, matches }: Omit<FindMatchViewOptions, "container" | "commentRoot" | "layout">) => ResolvedMatch[];
+/** Paint search geometry over the existing page DOM, without changing editor state. */
+export declare const createFindMatchView: (options: FindMatchViewOptions) => {
+  paint: (index: number) => void;
+  reveal: (index: number) => boolean;
+  navigate: (index: number, activateComment?: (commentId: number) => void) => void;
+  destroy: () => void;
+};
+//#endregion
+export {};