@stll/folio-core 0.62.0 → 0.63.0

package/dist/utils/borderCss.d.ts

@@ -1,9 +1,9 @@
 import { BorderStyleValue, PresetLineDashVal, PresetLineDashValue } from "@stll/docx-core/model";
 //#region src/utils/borderCss.d.ts
 /** The CSS `border-style` keywords folio paints a border with, in one tuple. */
-declare const CSS_BORDER_STYLE_VALUES: readonly ["none", "solid", "double", "dotted", "dashed", "groove", "ridge", "inset", "outset"];
+export declare const CSS_BORDER_STYLE_VALUES: readonly ["none", "solid", "double", "dotted", "dashed", "groove", "ridge", "inset", "outset"];
 /** The CSS `border-style` keywords folio paints a border with. */
-type CssBorderStyle = (typeof CSS_BORDER_STYLE_VALUES)[number];
+export type CssBorderStyle = (typeof CSS_BORDER_STYLE_VALUES)[number];
 /**
  * Read the CSS keyword an editor attribute carries into the union folio paints.
  *
@@ -11,7 +11,7 @@ type CssBorderStyle = (typeof CSS_BORDER_STYLE_VALUES)[number];
  * into it. A keyword folio does not paint is not guessed at: the caller gets
  * `undefined` and applies its own default.
  */
-declare const cssBorderStyleOf: (value: string | undefined) => CssBorderStyle | undefined;
+export declare const cssBorderStyleOf: (value: string | undefined) => CssBorderStyle | undefined;
 /**
  * Every `ST_Border` member's CSS rendering.
  *
@@ -21,7 +21,7 @@ declare const cssBorderStyleOf: (value: string | undefined) => CssBorderStyle |
  * round-trips the member. `custom` names art supplied by a relationship, so it
  * degrades the same way.
  */
-declare const CSS_BORDER_STYLES: {
+export declare const CSS_BORDER_STYLES: {
   readonly nil: "none";
   readonly none: "none";
   readonly single: "solid";
@@ -224,14 +224,14 @@ declare const CSS_BORDER_STYLES: {
  * always assumed. The argument is a CSS keyword, never an `ST_Border` member —
  * `nil` cannot reach here, which is what typing `BorderStyle.style` bought.
  */
-declare const paintsCssBorder: (style: CssBorderStyle | undefined) => boolean;
+export declare const paintsCssBorder: (style: CssBorderStyle | undefined) => boolean;
 /**
  * The CSS `border-style` for a parsed `w:val`.
  *
  * A token the schema does not declare paints as a plain line: the member is
  * kept for the round trip, but nothing can be inferred about how it draws.
  */
-declare const cssBorderStyle: (style: BorderStyleValue | undefined) => CssBorderStyle;
+export declare const cssBorderStyle: (style: BorderStyleValue | undefined) => CssBorderStyle;
 /**
  * The CSS `border-style` for a parsed `a:prstDash@val`.
  *
@@ -239,8 +239,7 @@ declare const cssBorderStyle: (style: BorderStyleValue | undefined) => CssBorder
  * undeclared `ST_Border` member does: the member is kept for the round trip,
  * but nothing can be inferred about how it draws.
  */
-declare const cssBorderStyleForDash: (dash: PresetLineDashValue | undefined) => CssBorderStyle;
+export declare const cssBorderStyleForDash: (dash: PresetLineDashValue | undefined) => CssBorderStyle;
 /** The preset dash an authored CSS border style serializes to. */
-declare const presetDashForCssBorderStyle: (style: string | undefined) => PresetLineDashVal;
-//#endregion
-export { CSS_BORDER_STYLES, CSS_BORDER_STYLE_VALUES, CssBorderStyle, cssBorderStyle, cssBorderStyleForDash, cssBorderStyleOf, paintsCssBorder, presetDashForCssBorderStyle };
+export declare const presetDashForCssBorderStyle: (style: string | undefined) => PresetLineDashVal;
+//#endregion

package/dist/utils/boundedContentIdentity.d.ts

@@ -0,0 +1,13 @@
+//#region src/utils/boundedContentIdentity.d.ts
+type ContentIdentityLimits = {
+  maxBytes: number;
+  maxEntries: number;
+};
+export declare class BoundedContentIdentityCache {
+  #private;
+  constructor(limits: ContentIdentityLimits);
+  intern(content: string): string;
+}
+export declare const boundedContentIdentity: (content: string) => string;
+//#endregion
+export {};

package/dist/utils/boundedContentIdentity.js

@@ -0,0 +1,42 @@
+import { panic } from "better-result";
+//#region src/utils/boundedContentIdentity.ts
+let nextIdentity = 0;
+var BoundedContentIdentityCache = class {
+	#limits;
+	#identities = /* @__PURE__ */ new Map();
+	#bytes = 0;
+	constructor(limits) {
+		if (!Number.isSafeInteger(limits.maxBytes) || limits.maxBytes <= 0 || !Number.isSafeInteger(limits.maxEntries) || limits.maxEntries <= 0) panic("Content identity cache limits must be positive safe integers.");
+		this.#limits = { ...limits };
+	}
+	intern(content) {
+		const existing = this.#identities.get(content);
+		if (existing !== void 0) {
+			this.#identities.delete(content);
+			this.#identities.set(content, existing);
+			return existing;
+		}
+		if (nextIdentity === Number.MAX_SAFE_INTEGER) panic("Content identity space exhausted.");
+		nextIdentity += 1;
+		const identity = `c${nextIdentity.toString(36)}`;
+		const bytes = (content.length + identity.length) * 2;
+		if (bytes > this.#limits.maxBytes) return identity;
+		while (this.#identities.size >= this.#limits.maxEntries || this.#bytes + bytes > this.#limits.maxBytes) {
+			const oldest = this.#identities.entries().next().value;
+			if (oldest === void 0) panic("Content identity cache accounting must match retained entries.");
+			const [oldContent, oldIdentity] = oldest;
+			this.#identities.delete(oldContent);
+			this.#bytes -= (oldContent.length + oldIdentity.length) * 2;
+		}
+		this.#identities.set(content, identity);
+		this.#bytes += bytes;
+		return identity;
+	}
+};
+const identities = new BoundedContentIdentityCache({
+	maxBytes: 1048576,
+	maxEntries: 128
+});
+const boundedContentIdentity = (content) => identities.intern(content);
+//#endregion
+export { BoundedContentIdentityCache, boundedContentIdentity };

package/dist/utils/canonicalJson.d.ts

@@ -9,6 +9,5 @@
  * rebuilt one. `undefined` members are omitted, so an absent property and one
  * explicitly set to `undefined` read alike.
  */
-declare const canonicalJson: (value: unknown) => string;
-//#endregion
-export { canonicalJson };
+export declare const canonicalJson: (value: unknown) => string;
+//#endregion

package/dist/utils/clipboard.d.ts

@@ -3,7 +3,7 @@ import { document_d_exports } from "../types/document.js";
 /**
  * Clipboard content format
  */
-type ClipboardContent = {
+export type ClipboardContent = {
   /** Plain text representation */
   plainText: string;
   /** HTML representation */
@@ -14,7 +14,7 @@ type ClipboardContent = {
 /**
  * Parsed clipboard content
  */
-type ParsedClipboardContent = {
+export type ParsedClipboardContent = {
   /** Runs parsed from clipboard */
   runs: document_d_exports.Run[];
   /** Whether content came from Word */
@@ -27,7 +27,7 @@ type ParsedClipboardContent = {
 /**
  * Options for clipboard operations
  */
-type ClipboardOptions = {
+export type ClipboardOptions = {
   /** Whether to include formatting in copy */
   includeFormatting?: boolean;
   /** Whether to clean Word-specific formatting */
@@ -38,11 +38,11 @@ type ClipboardOptions = {
 /**
  * Custom MIME type for internal clipboard format
  */
-declare const INTERNAL_CLIPBOARD_TYPE = "application/x-stella-folio";
+export declare const INTERNAL_CLIPBOARD_TYPE = "application/x-stella-folio";
 /**
  * Standard clipboard MIME types
  */
-declare const CLIPBOARD_TYPES: {
+export declare const CLIPBOARD_TYPES: {
   readonly HTML: "text/html";
   readonly PLAIN: "text/plain";
 };
@@ -55,53 +55,53 @@ type ClipboardDataLike = {
   items?: DataTransferItemList | readonly DataTransferItem[] | undefined;
   types?: ArrayLike<string> | undefined;
 };
-declare function getClipboardImageFiles(clipboardData: ClipboardDataLike | null): File[];
+export declare function getClipboardImageFiles(clipboardData: ClipboardDataLike | null): File[];
 /**
  * Return image files only when the clipboard has no readable editor content.
  * Rich HTML, internal payloads, and plain text must stay on the normal paste
  * path; some applications include a rendered image beside that content.
  */
-declare function getStandaloneClipboardImageFiles(clipboardData: ClipboardDataLike | null): File[];
+export declare function getStandaloneClipboardImageFiles(clipboardData: ClipboardDataLike | null): File[];
 /**
  * Copy runs to clipboard with formatting
  */
-declare function copyRuns(runs: document_d_exports.Run[], options?: ClipboardOptions): Promise<boolean>;
+export declare function copyRuns(runs: document_d_exports.Run[], options?: ClipboardOptions): Promise<boolean>;
 /**
  * Copy paragraphs to clipboard with formatting
  */
-declare function copyParagraphs(paragraphs: document_d_exports.Paragraph[], options?: ClipboardOptions): Promise<boolean>;
+export declare function copyParagraphs(paragraphs: document_d_exports.Paragraph[], options?: ClipboardOptions): Promise<boolean>;
 /**
  * Convert runs to clipboard content (HTML and plain text)
  */
-declare function runsToClipboardContent(runs: document_d_exports.Run[], includeFormatting?: boolean): ClipboardContent;
+export declare function runsToClipboardContent(runs: document_d_exports.Run[], includeFormatting?: boolean): ClipboardContent;
 /**
  * Convert paragraphs to clipboard content
  */
-declare function paragraphsToClipboardContent(paragraphs: document_d_exports.Paragraph[], includeFormatting?: boolean): ClipboardContent;
+export declare function paragraphsToClipboardContent(paragraphs: document_d_exports.Paragraph[], includeFormatting?: boolean): ClipboardContent;
 /**
  * Write content to clipboard
  */
-declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
+export declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
 /**
  * Read content from clipboard
  */
-declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
+export declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
 /**
  * Handle paste event
  */
-declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
+export declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
 /**
  * Parse HTML from clipboard
  */
-declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
+export declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
 /**
  * Check if HTML is from Microsoft Word
  */
-declare function isWordHtml(html: string): boolean;
+export declare function isWordHtml(html: string): boolean;
 /**
  * Check if HTML is from our editor
  */
-declare function isEditorHtml(html: string): boolean;
+export declare function isEditorHtml(html: string): boolean;
 /**
  * Sanitize inbound clipboard HTML at the paste trust boundary.
  *
@@ -110,19 +110,19 @@ declare function isEditorHtml(html: string): boolean;
  * and dangerous URLs before any DOM walk. Without a window (unit stubs / SSR)
  * the linear cleaners still run; the live editor path always has `window`.
  */
-declare function sanitizeInboundClipboardHtml(html: string): string;
+export declare function sanitizeInboundClipboardHtml(html: string): string;
 /**
  * Clean Microsoft Word HTML
  */
-declare function cleanWordHtml(html: string): string;
+export declare function cleanWordHtml(html: string): string;
 /**
  * Convert HTML to runs
  */
-declare function htmlToRuns(html: string, plainTextFallback: string): document_d_exports.Run[];
+export declare function htmlToRuns(html: string, plainTextFallback: string): document_d_exports.Run[];
 /**
  * Create clipboard keyboard handlers for an editor
  */
-declare function createClipboardHandlers(options: {
+export declare function createClipboardHandlers(options: {
   onCopy?: () => {
     runs: document_d_exports.Run[];
   } | null;
@@ -149,4 +149,4 @@ declare const _default: {
   createClipboardHandlers: typeof createClipboardHandlers;
 };
 //#endregion
-export { CLIPBOARD_TYPES, ClipboardContent, ClipboardOptions, INTERNAL_CLIPBOARD_TYPE, ParsedClipboardContent, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, _default as default, getClipboardImageFiles, getStandaloneClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, sanitizeInboundClipboardHtml, writeToClipboard };
+export { _default as default };

package/dist/utils/clipboard.js

@@ -223,8 +223,14 @@ async function parseClipboardItems(items, cleanWordFormatting) {
 	let html = "";
 	let plainText = "";
 	for (const item of items) {
-		if (item.types.includes(CLIPBOARD_TYPES.HTML)) html = await readBlobText(await item.getType(CLIPBOARD_TYPES.HTML));
-		if (item.types.includes(CLIPBOARD_TYPES.PLAIN)) plainText = await readBlobText(await item.getType(CLIPBOARD_TYPES.PLAIN));
+		if (item.types.includes(CLIPBOARD_TYPES.HTML)) {
+			const blob = await item.getType(CLIPBOARD_TYPES.HTML);
+			html = await readBlobText(blob);
+		}
+		if (item.types.includes(CLIPBOARD_TYPES.PLAIN)) {
+			const blob = await item.getType(CLIPBOARD_TYPES.PLAIN);
+			plainText = await readBlobText(blob);
+		}
 	}
 	return parseClipboardHtml(html, plainText, cleanWordFormatting);
 }
@@ -457,10 +463,7 @@ function processNode(node, runs, inheritedFormatting) {
 			formatting.vertAlign = "subscript";
 			break;
 		case "code":
-		case "pre":
-			formatting.fontFamily = { ascii: "Courier New" };
-			break;
-		default: break;
+		case "pre": formatting.fontFamily = { ascii: "Courier New" };
 	}
 	for (const child of element.childNodes) processNode(child, runs, formatting);
 }

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