@onodocs/canvas 0.2.0

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@onodocs/canvas",
+  "version": "0.2.0",
+  "private": false,
+  "description": "OnoDocs canvas viewer, selection and HTML attachments for prepared Word document pages.",
+  "homepage": "https://onodocs.com/developers/",
+  "keywords": [
+    "docx",
+    "word",
+    "document",
+    "rendering",
+    "onodocs"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "access": "public"
+  },
+  "onodocsReleaseDate": "2026-10-07",
+  "onodocsEnvironment": "live",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./index.js",
+  "types": "./types/canvas/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/canvas/index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "dependencies": {},
+  "files": [
+    "*.js",
+    "types",
+    "README.md",
+    "SDK.md",
+    "LICENSING.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/onodocs/onodocs.git"
+  },
+  "gitHead": "95967333a361ecd96d5cb764a619c07a8ab2bddf"
+}

package/types/canvas/canvas-axis-aligned-transform.d.ts

@@ -0,0 +1,12 @@
+/** Spec: `spec/pipeline/render/canvas/_index.md#axis-aligned-device-rectangle-projection`. */
+import type { CanvasPaintTarget } from "../render-api/index.js";
+type AxisAlignedTransform = ReturnType<CanvasPaintTarget["getTransform"]>;
+export declare function positiveAxisAlignedTransform(target: CanvasPaintTarget): AxisAlignedTransform | undefined;
+export declare function rectangleForDeviceBounds(transform: AxisAlignedTransform, left: number, top: number, deviceWidth: number, deviceHeight: number): Readonly<{
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}> | undefined;
+export {};
+//# sourceMappingURL=canvas-axis-aligned-transform.d.ts.map

package/types/canvas/canvas-effect-surface.d.ts

@@ -0,0 +1,9 @@
+/** Spec: pipeline.render.canvas.effect-surfaces */
+import type { CanvasPaintTarget } from "../render-api/index.js";
+interface EffectSurface {
+    readonly canvas: HTMLCanvasElement;
+    readonly context: CanvasRenderingContext2D;
+}
+export declare function effectSurfaceFor(target: CanvasPaintTarget, width: number, height: number): EffectSurface;
+export {};
+//# sourceMappingURL=canvas-effect-surface.d.ts.map

package/types/canvas/canvas-materializer.d.ts

@@ -0,0 +1,9 @@
+import { type CanvasImageResourceMaterializer, type CanvasPaintTarget, type PageDisplayList } from "../render-api/index.js";
+/**
+ * Spec: `spec/pipeline/render/canvas/_index.md#canvas-materialization`; `spec/document/body/section/pagination-and-paint.md#section-local-pagination-and-paint`; `spec/pipeline/render/page-display-list/authored-section-page-identity.md#authored-section-page-identity`.
+ * Spec: `spec/document/body/text/paragraph/shading/_index.md#visible-body-paragraph-shading`; `spec/pipeline/render/canvas/paragraph-border-paint-replay.md#mechanical-display-list-and-canvas-replay`; `spec/pipeline/render/page-display-list/positioned-text/authored-bar-tab.md#mechanical-authored-bar-replay`.
+ * Spec: `spec/document/body/table/fixed-grid/border/device-replay.md#device-minimum-representation-and-replay`; `spec/pipeline/render/canvas/section-column-separator-device-minimum-replay.md#section-column-separator-device-minimum-replay`.
+ * Spec: `spec/pipeline/render/vector-graphics/_index.md`; `spec/pipeline/render/vector-graphics/preset-shape/transport-and-publication.md#direct-preset-shape-display-list-command`.
+ */
+export declare function materializePageDisplayListToCanvas(displayList: PageDisplayList, target: CanvasPaintTarget, resources?: CanvasImageResourceMaterializer): void;
+//# sourceMappingURL=canvas-materializer.d.ts.map

package/types/canvas/canvas-native-text.d.ts

@@ -0,0 +1,6 @@
+/** Specs: `spec/pipeline/layout/text/font/browser-native-text-realization.md`; `spec/pipeline/layout/text/font/actual-font-shaped-geometry.md`. */
+/** Spec: `spec/pipeline/render/canvas/_index.md#scratch-raster-reuse`. */
+import type { BrowserTextOperation } from "../foundation/index.js";
+import type { CanvasPaintTarget } from "../render-api/index.js";
+export declare function drawNativeText(target: CanvasPaintTarget, operation: BrowserTextOperation, color: string): void;
+//# sourceMappingURL=canvas-native-text.d.ts.map

package/types/canvas/canvas-physical-clips.d.ts

@@ -0,0 +1,4 @@
+/** Spec: spec/document/body/drawing/group/wordprocessing-group.md */
+import type { CanvasPaintTarget, PaintPositionedTextCommand } from "../render-api/index.js";
+export declare function replayPhysicalClips(target: CanvasPaintTarget, clips: PaintPositionedTextCommand["physicalClips"]): void;
+//# sourceMappingURL=canvas-physical-clips.d.ts.map

package/types/canvas/canvas-positioned-text-replay.d.ts

@@ -0,0 +1,10 @@
+/** Spec: pipeline.layout.text.font.browser-native-text-realization */
+/** Spec: document.body.drawing.vml.textboxes */
+import type { CanvasPaintTarget, PaintPositionedTextCommand } from "../render-api/index.js";
+/**
+ * Spec: `spec/pipeline/render/canvas/_index.md#mechanical-positioned-glyph-replay`; `spec/pipeline/render/canvas/run-effects.md`; `spec/pipeline/render/canvas/run-shading-replay.md#run-shading-replay`.
+ * Spec: `spec/pipeline/render/canvas/run-highlight-replay.md#target-pixel-aligned-highlight-replay`; `spec/document/body/text/run/border/paint-publication.md#sealed-display-list-and-canvas-replay`; `spec/pipeline/render/canvas/text-decoration-replay.md#mechanical-underline-and-strike-replay`.
+ * Spec: `spec/pipeline/render/canvas/emphasis-marks.md#canvas-emphasis-mark-replay`; `spec/pipeline/render/page-display-list/positioned-text/ruby.md#canvas-glyph-path-replay`; `spec/pipeline/render/page-display-list/direct-run-revision-markup.md#mechanical-canvas-replay`.
+ */
+export declare function drawPositionedText(target: CanvasPaintTarget, command: PaintPositionedTextCommand): void;
+//# sourceMappingURL=canvas-positioned-text-replay.d.ts.map

package/types/canvas/canvas-raster-replay.d.ts

@@ -0,0 +1,7 @@
+/** Spec: spec/document/body/drawing/group/wordprocessing-group.md */
+import { type CanvasImageResourceMaterializer, type CanvasPaintTarget, type PaintCommand } from "../render-api/index.js";
+/** Spec: `spec/pipeline/render/page-display-list/inline-raster-image.md#inline-raster-image-command`; `spec/pipeline/render/canvas/raster-sampling/_index.md#mechanical-raster-sampling-replay`; `spec/pipeline/render/canvas/raster-alpha-replay.md#drawingml-raster-alpha-replay`; `spec/document/body/drawing/vector-image/_index.md#svg-first-native-image-realization`. */
+export declare function drawInlineRasterImage(target: CanvasPaintTarget, command: Extract<PaintCommand, {
+    readonly kind: "inlineRasterImage";
+}>, resources: CanvasImageResourceMaterializer): void;
+//# sourceMappingURL=canvas-raster-replay.d.ts.map

package/types/canvas/canvas-shadow-replay.d.ts

@@ -0,0 +1,19 @@
+/** Spec: document.body.drawing.shape.outer-shadow */
+import type { PositionedVectorShapeShadow } from "../foundation/index.js";
+import type { CanvasPaintTarget, PaintInlineRasterImageClip, PaintRasterImageTransform } from "../render-api/index.js";
+/** Spec: pipeline.render.canvas.effect-surfaces */
+export declare class ShadowBounds {
+    #private;
+    readonly device: PaintRasterImageTransform;
+    readonly transform?: PaintRasterImageTransform | undefined;
+    constructor(device: PaintRasterImageTransform, transform?: PaintRasterImageTransform | undefined);
+    includeRectangle(left: number, top: number, width: number, height: number, padding?: number): void;
+    get rectangle(): Readonly<{
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }> | undefined;
+}
+export declare function drawShadowedContent(target: CanvasPaintTarget, shadow: PositionedVectorShapeShadow, bounds: ShadowBounds, clip: PaintInlineRasterImageClip | null, paint: (target: CanvasPaintTarget) => void): void;
+//# sourceMappingURL=canvas-shadow-replay.d.ts.map

package/types/canvas/canvas-soft-edge-replay.d.ts

@@ -0,0 +1,9 @@
+/** Spec: document.body.drawing.picture-soft-edges */
+import type { CanvasPaintTarget } from "../render-api/index.js";
+export declare function drawSoftEdgeRaster(target: CanvasPaintTarget, rectangle: Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>, radius: number, paint: (target: CanvasPaintTarget) => void): void;
+//# sourceMappingURL=canvas-soft-edge-replay.d.ts.map

package/types/canvas/canvas-table-border-replay.d.ts

@@ -0,0 +1,7 @@
+/** Spec: document.body.table.fixed-grid.border.patterned#dash-endpoint-coverage */
+import type { CanvasPaintTarget, PaintCommand } from "../render-api/index.js";
+/** Spec: `spec/document/body/table/fixed-grid/border/device-replay.md#device-minimum-representation-and-replay`; `spec/pipeline/render/canvas/table-border-device-minimum-replay.md#table-border-device-minimum-replay`. */
+export declare function fillTableBorderRectangle(target: CanvasPaintTarget, command: Extract<PaintCommand, {
+    readonly kind: "fillRectangle";
+}>): void;
+//# sourceMappingURL=canvas-table-border-replay.d.ts.map

package/types/canvas/canvas-target-pixel-alignment.d.ts

@@ -0,0 +1,9 @@
+import type { CanvasPaintTarget } from "../render-api/index.js";
+/** Spec: `spec/pipeline/render/canvas/run-highlight-replay.md#target-pixel-aligned-highlight-replay`; `spec/pipeline/render/canvas/_index.md#target-pixel-aligned-rectangle-replay`. */
+export declare function fillTargetPixelAlignedRectangle(target: CanvasPaintTarget, rectangle: Readonly<{
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}>): void;
+//# sourceMappingURL=canvas-target-pixel-alignment.d.ts.map

package/types/canvas/canvas-vector-shape-replay.d.ts

@@ -0,0 +1,4 @@
+import type { CanvasPaintTarget, PaintVectorShapeCommand } from "../render-api/index.js";
+/** Specs: `spec/pipeline/render/vector-graphics/preset-shape/transport-and-publication.md#direct-preset-shape-display-list-command`; `spec/pipeline/render/vector-graphics/preset-shape/contours-and-record-order.md#ordered-records-with-independent-paint-gates`; `spec/document/body/drawing/vml/gradient-fills.md`. */
+export declare function drawVectorShape(target: CanvasPaintTarget, command: PaintVectorShapeCommand): void;
+//# sourceMappingURL=canvas-vector-shape-replay.d.ts.map

package/types/canvas/evaluation-watermark.d.ts

@@ -0,0 +1,3 @@
+/** Spec: pipeline.sdk.licensing */
+export declare function paintEvaluationWatermark(context: CanvasRenderingContext2D, width: number, height: number): void;
+//# sourceMappingURL=evaluation-watermark.d.ts.map

package/types/canvas/index.d.ts

@@ -0,0 +1,30 @@
+/** Spec: pipeline.sdk.page-source */
+import { type PageInteraction } from "../foundation/index.js";
+import type { DocumentSource, PageSize } from "../render-api/index.js";
+import type { DocumentView, ViewOptions } from "./presentation.js";
+export { materializePageDisplayListToCanvas } from "./canvas-materializer.js";
+export { encode, decode } from "./transport.js";
+export type * from "../render-api/index.js";
+export type { DocumentView, ViewOptions, ViewAnchor, DocumentAttachment, AttachmentOptions, AttachmentPlacement } from "./presentation.js";
+export interface DocumentPage {
+    readonly index: number;
+    readonly size: PageSize;
+    readonly interaction: PageInteraction;
+    render(canvas: HTMLCanvasElement, options?: Readonly<{
+        dpi?: number;
+        signal?: AbortSignal;
+    }>): Promise<void>;
+}
+export interface CanvasDocument {
+    readonly pages: readonly DocumentPage[];
+    readonly disposed: boolean;
+    readonly view: DocumentView | undefined;
+    mount(container: HTMLElement, options?: ViewOptions): DocumentView;
+    refresh(): void;
+    dispose(): void;
+}
+export declare function createDocument(source: DocumentSource, options?: Readonly<{
+    container?: HTMLElement;
+    viewOptions?: ViewOptions;
+}>): CanvasDocument;
+//# sourceMappingURL=index.d.ts.map

package/types/canvas/presentation.d.ts

@@ -0,0 +1,54 @@
+/** Spec: pipeline.semantic.document-update */
+/** Spec: pipeline.sdk.presentation */
+import type { DocumentFragment, DocumentHit, DocumentPoint } from "../render-api/index.js";
+import type { DocumentPage, PageSize } from "./index.js";
+export interface ViewOptions {
+    readonly zoom?: number | "fit-width";
+    readonly gap?: number;
+    readonly title?: string;
+}
+export interface DocumentAttachment {
+    readonly element: HTMLElement;
+    readonly disposed: boolean;
+    dispose(): void;
+}
+export type ViewAnchor = DocumentFragment | Pick<DocumentPage, "index" | "size">;
+export type AttachmentPlacement = "overlay" | `inside-${"top" | "center" | "bottom"}-${"left" | "center" | "right"}` | `outside-${"top" | "right" | "bottom" | "left"}`;
+export type AttachmentOptions = Readonly<{
+    anchor: ViewAnchor;
+    offset?: DocumentPoint;
+    size?: PageSize;
+}> & (Readonly<{
+    placement?: "overlay";
+    inset?: never;
+    gap?: never;
+}> | Readonly<{
+    placement: Extract<AttachmentPlacement, `inside-${string}`>;
+    inset?: number;
+    gap?: never;
+}> | Readonly<{
+    placement: Extract<AttachmentPlacement, `outside-${string}`>;
+    gap?: number;
+    inset?: never;
+}>);
+export interface DocumentView {
+    readonly element: HTMLElement;
+    readonly disposed: boolean;
+    whenRendered(): Promise<void>;
+    setZoom(zoom: number | "fit-width"): void;
+    toClient(pageIndex: number, point: DocumentPoint): DocumentPoint;
+    fromClient(point: DocumentPoint): Readonly<{
+        pageIndex: number;
+        point: DocumentPoint;
+    }> | undefined;
+    hitTest(point: DocumentPoint): DocumentHit | undefined;
+    scrollTo(anchor: ViewAnchor, options?: ScrollIntoViewOptions): boolean;
+    attach(element: HTMLElement, options: AttachmentOptions): DocumentAttachment;
+    dispose(): void;
+}
+export declare function mountDocument(document: Readonly<{
+    pages: readonly DocumentPage[];
+}>, container: HTMLElement, options: ViewOptions | undefined, onDispose: () => void): DocumentView & {
+    refresh(): void;
+};
+//# sourceMappingURL=presentation.d.ts.map

package/types/canvas/text-selection.d.ts

@@ -0,0 +1,7 @@
+import type { PageTextLine } from "../render-api/index.js";
+import type { DocumentPage } from "./index.js";
+/** Spec: pipeline.sdk.presentation */
+export declare function mountTextSelection(pageText: readonly PageTextLine[], viewport: HTMLElement, shells: readonly HTMLElement[], pageBounds: readonly DocumentPage["size"][], nearby: ReadonlySet<number>, signal: AbortSignal): {
+    paint: () => void;
+};
+//# sourceMappingURL=text-selection.d.ts.map

package/types/canvas/transport.d.ts

@@ -0,0 +1,5 @@
+/** Spec: pipeline.sdk.page-source */
+import type { PageDisplayList, DocumentManifest } from "../render-api/index.js";
+export declare function encode(page: PageDisplayList | DocumentManifest): string;
+export declare function decode<T extends PageDisplayList | DocumentManifest>(value: string): T;
+//# sourceMappingURL=transport.d.ts.map

package/types/foundation/bounded-number-representation-cjk.d.ts

@@ -0,0 +1,17 @@
+import type { BoundedNumberRepresentation } from "./bounded-number-representation.js";
+import { type BoundedNumberRepresentationCheckpoint, type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+export declare const chineseCountingDigits: readonly ["零", "一", "二", "三", "四", "五", "六", "七", "八", "九"];
+export declare const chineseCountingLargeUnits: readonly ["万", "亿", "兆", "京", "垓", "秭", "穰", "沟", "涧", "正", "载"];
+export declare const simplifiedLegalDigits: readonly ["零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"];
+export declare const simplifiedLegalLargeUnits: readonly ["万", "亿"];
+export declare const traditionalLegalDigits: readonly ["零", "壹", "貳", "參", "肆", "伍", "陸", "柒", "捌", "玖"];
+export declare const traditionalLegalLargeUnits: readonly ["萬", "億"];
+export declare const japaneseLegalDigits: readonly ["零", "壱", "弐", "参", "四", "伍", "六", "七", "八", "九"];
+type CjkIdeographicRepresentation = "chineseCounting" | "chineseCountingThousand" | "ideographDigital" | "japaneseCounting" | "taiwaneseCounting" | "taiwaneseCountingThousand" | "chineseLegalSimplified" | "ideographLegalTraditional" | "japaneseLegal";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/cjk.md#writer-cjk-ideographic-representations`. */
+export declare function isCjkIdeographicRepresentation(representation: BoundedNumberRepresentation): representation is CjkIdeographicRepresentation;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/cjk.md#writer-cjk-ideographic-representations`. */
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/cjk.md#writer-cjk-ideographic-representations`. */
+export declare function formatCjkIdeographicNumber(value: bigint, representation: CjkIdeographicRepresentation, checkpoint: BoundedNumberRepresentationCheckpoint | undefined): BoundedNumberRepresentationResult;
+export {};
+//# sourceMappingURL=bounded-number-representation-cjk.d.ts.map

package/types/foundation/bounded-number-representation-decimal-roman-latin.d.ts

@@ -0,0 +1,6 @@
+import { type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+type DecimalRomanLatinRepresentation = "decimal" | "decimalZero" | "decimalFullWidth" | "decimalFullWidth2" | "upperRoman" | "lowerRoman" | "upperLatin" | "lowerLatin";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/decimal-roman-latin.md#decimal-roman-and-latin-representations`. */
+export declare function formatDecimalRomanLatinNumber(value: bigint, representation: DecimalRomanLatinRepresentation): BoundedNumberRepresentationResult;
+export {};
+//# sourceMappingURL=bounded-number-representation-decimal-roman-latin.d.ts.map

package/types/foundation/bounded-number-representation-hebrew.d.ts

@@ -0,0 +1,5 @@
+import { type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/hebrew.md#writer-hebrew-numeral-representation`. */
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/hebrew.md#writer-hebrew-numeral-representation`. */
+export declare function formatWriterHebrewNumber(value: bigint): BoundedNumberRepresentationResult;
+//# sourceMappingURL=bounded-number-representation-hebrew.d.ts.map

package/types/foundation/bounded-number-representation-korean.d.ts

@@ -0,0 +1,15 @@
+import type { BoundedNumberRepresentation } from "./bounded-number-representation.js";
+import { type BoundedNumberRepresentationCheckpoint, type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+export declare const koreanDigital: readonly ["영", "일", "이", "삼", "사", "오", "육", "칠", "팔", "구"];
+export declare const koreanDigital2: readonly ["零", "一", "二", "三", "四", "五", "六", "七", "八", "九"];
+export declare const koreanCountingDigits: readonly ["일", "이", "삼", "사", "오", "육", "칠", "팔", "구"];
+export declare const koreanLegalOnes: readonly ["하나", "둘", "셋", "넷", "다섯", "여섯", "일곱", "여덟", "아홉"];
+export declare const koreanLegalTens: readonly ["열", "스물", "서른", "마흔", "쉰", "예순", "일흔", "여든", "아흔"];
+type KoreanRepresentation = "koreanDigital" | "koreanDigital2" | "koreanCounting" | "koreanLegal";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/korean.md#writer-korean-digital-counting-and-legal-representations`. */
+export declare function isKoreanRepresentation(representation: BoundedNumberRepresentation): representation is KoreanRepresentation;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/korean.md#writer-korean-digital-counting-and-legal-representations`. */
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/korean.md#writer-korean-digital-counting-and-legal-representations`. */
+export declare function formatKoreanNumber(value: bigint, representation: KoreanRepresentation, checkpoint: BoundedNumberRepresentationCheckpoint | undefined): BoundedNumberRepresentationResult;
+export {};
+//# sourceMappingURL=bounded-number-representation-korean.d.ts.map

package/types/foundation/bounded-number-representation-mechanics.d.ts

@@ -0,0 +1,17 @@
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/shared-mechanics.md#shared-bounded-representation-mechanics`. */
+export type BoundedNumberRepresentationResult = Readonly<{
+    readonly kind: "formatted";
+    readonly text: string;
+}> | Readonly<{
+    readonly kind: "invalid" | "out-of-range";
+}>;
+export type BoundedNumberRepresentationCheckpoint = () => void;
+export type BoundedNumberRepresentationFailure = Exclude<BoundedNumberRepresentationResult, Readonly<{
+    readonly kind: "formatted";
+    readonly text: string;
+}>>;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/shared-mechanics.md#shared-bounded-representation-mechanics`. */
+export declare function formattedResult(text: string): BoundedNumberRepresentationResult;
+export declare function invalidResult(): BoundedNumberRepresentationFailure;
+export declare function outOfRangeResult(): BoundedNumberRepresentationFailure;
+//# sourceMappingURL=bounded-number-representation-mechanics.d.ts.map

package/types/foundation/bounded-number-representation-writer-alphabets.d.ts

@@ -0,0 +1,22 @@
+import type { BoundedNumberRepresentation } from "./bounded-number-representation.js";
+export declare const russianLower: readonly ["а", "б", "в", "г", "д", "е", "ж", "з", "и", "к", "л", "м", "н", "о", "п", "р", "с", "т", "у", "ф", "х", "ц", "ч", "ш", "щ", "ы", "э", "ю", "я"];
+export declare const russianUpper: readonly ["А", "Б", "В", "Г", "Д", "Е", "Ж", "З", "И", "К", "Л", "М", "Н", "О", "П", "Р", "С", "Т", "У", "Ф", "Х", "Ц", "Ч", "Ш", "Щ", "Ы", "Э", "Ю", "Я"];
+export declare const arabicAlpha: readonly ["أ", "ب", "ت", "ث", "ج", "ح", "خ", "د", "ذ", "ر", "ز", "س", "ش", "ص", "ض", "ط", "ظ", "ع", "غ", "ف", "ق", "ك", "ل", "م", "ن", "ه", "و", "ى"];
+export declare const arabicAbjad: readonly ["ا", "ب", "ج", "د", "ه", "و", "ز", "ح", "ط", "ي", "ك", "ل", "م", "ن", "س", "ع", "ف", "ص", "ق", "ر", "ش", "ت", "ث", "خ", "ذ", "ض", "ظ", "غ"];
+export declare const hebrew2: readonly ["א", "ב", "ג", "ד", "ה", "ו", "ז", "ח", "ט", "י", "כ", "ל", "מ", "נ", "ס", "ע", "פ", "צ", "ק", "ר", "ש", "ת"];
+export declare const thaiLetters: readonly ["ก", "ข", "ค", "ง", "จ", "ฉ", "ช", "ซ", "ฌ", "ญ", "ฎ", "ฏ", "ฐ", "ฑ", "ฒ", "ณ", "ด", "ต", "ถ", "ท", "ธ", "น", "บ", "ป", "ผ", "ฝ", "พ", "ฟ", "ภ", "ม", "ย", "ร", "ฤ", "ล", "ฦ", "ว", "ศ", "ษ", "ส", "ห", "ฬ", "อ", "ฮ"];
+export declare const hindiVowels: readonly ["क", "ख", "ग", "घ", "ङ", "च", "छ", "ज", "झ", "ञ", "ट", "ठ", "ड", "ढ", "ण", "त", "थ", "द", "ध", "न", "प", "फ", "ब", "भ", "म", "य", "र", "ल", "व", "श", "ष", "स", "ह"];
+export declare const aiueo: readonly ["ｱ", "ｲ", "ｳ", "ｴ", "ｵ", "ｶ", "ｷ", "ｸ", "ｹ", "ｺ", "ｻ", "ｼ", "ｽ", "ｾ", "ｿ", "ﾀ", "ﾁ", "ﾂ", "ﾃ", "ﾄ", "ﾅ", "ﾆ", "ﾇ", "ﾈ", "ﾉ", "ﾊ", "ﾋ", "ﾌ", "ﾍ", "ﾎ", "ﾏ", "ﾐ", "ﾑ", "ﾒ", "ﾓ", "ﾔ", "ﾕ", "ﾖ", "ﾗ", "ﾘ", "ﾙ", "ﾚ", "ﾛ", "ﾜ", "ｦ", "ﾝ"];
+export declare const aiueoFullWidth: readonly ["ア", "イ", "ウ", "エ", "オ", "カ", "キ", "ク", "ケ", "コ", "サ", "シ", "ス", "セ", "ソ", "タ", "チ", "ツ", "テ", "ト", "ナ", "ニ", "ヌ", "ネ", "ノ", "ハ", "ヒ", "フ", "ヘ", "ホ", "マ", "ミ", "ム", "メ", "モ", "ヤ", "ユ", "ヨ", "ラ", "リ", "ル", "レ", "ロ", "ワ", "ヲ", "ン"];
+export declare const iroha: readonly ["ｲ", "ﾛ", "ﾊ", "ﾆ", "ﾎ", "ﾍ", "ﾄ", "ﾁ", "ﾘ", "ﾇ", "ﾙ", "ｦ", "ﾜ", "ｶ", "ﾖ", "ﾀ", "ﾚ", "ｿ", "ﾂ", "ﾈ", "ﾅ", "ﾗ", "ﾑ", "ｳ", "ヰ", "ﾉ", "ｵ", "ｸ", "ﾔ", "ﾏ", "ｹ", "ﾌ", "ｺ", "ｴ", "ﾃ", "ｱ", "ｻ", "ｷ", "ﾕ", "ﾒ", "ﾐ", "ｼ", "ヱ", "ﾋ", "ﾓ", "ｾ", "ｽ", "ﾝ"];
+export declare const irohaFullWidth: readonly ["イ", "ロ", "ハ", "ニ", "ホ", "ヘ", "ト", "チ", "リ", "ヌ", "ル", "ヲ", "ワ", "カ", "ヨ", "タ", "レ", "ソ", "ツ", "ネ", "ナ", "ラ", "ム", "ウ", "ヰ", "ノ", "オ", "ク", "ヤ", "マ", "ケ", "フ", "コ", "エ", "テ", "ア", "サ", "キ", "ユ", "メ", "ミ", "シ", "ヱ", "ヒ", "モ", "セ", "ス", "ン"];
+export declare const ganada: readonly ["가", "나", "다", "라", "마", "바", "사", "아", "자", "차", "카", "타", "파", "하"];
+export declare const chosung: readonly ["ㄱ", "ㄴ", "ㄷ", "ㄹ", "ㅁ", "ㅂ", "ㅅ", "ㅇ", "ㅈ", "ㅊ", "ㅋ", "ㅌ", "ㅍ", "ㅎ"];
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/_index.md#writer-alphabet-representations`. */
+type WriterAlphabetRepresentation = "upperAlphabetic" | "lowerAlphabetic" | "russianLower" | "russianUpper" | "arabicAlpha" | "arabicAbjad" | "hebrew2" | "thaiLetters" | "hindiVowels" | "aiueo" | "aiueoFullWidth" | "iroha" | "irohaFullWidth" | "ganada" | "chosung";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/bijective.md#writer-bijective-representations`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/hindi-vowels.md#writer-hindi-vowel-representation`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/kana-recycled-symbols.md#writer-kana-recycled-symbols`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/korean-recycled-symbols.md#writer-korean-recycled-symbols`. */
+export declare function isWriterAlphabetRepresentation(representation: BoundedNumberRepresentation): representation is WriterAlphabetRepresentation;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/bijective.md#writer-bijective-representations`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/hindi-vowels.md#writer-hindi-vowel-representation`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/kana-recycled-symbols.md#writer-kana-recycled-symbols`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/korean-recycled-symbols.md#writer-korean-recycled-symbols`. */
+export declare function formatWriterAlphabetNumber(value: bigint, representation: WriterAlphabetRepresentation): import("./bounded-number-representation-mechanics.js").BoundedNumberRepresentationResult;
+export {};
+//# sourceMappingURL=bounded-number-representation-writer-alphabets.d.ts.map

package/types/foundation/bounded-number-representation-writer-tables.d.ts

@@ -0,0 +1,13 @@
+import type { BoundedNumberRepresentation } from "./bounded-number-representation.js";
+import { type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+export declare const writerCircledNumbers: readonly ["①", "②", "③", "④", "⑤", "⑥", "⑦", "⑧", "⑨", "⑩", "⑪", "⑫", "⑬", "⑭", "⑮", "⑯", "⑰", "⑱", "⑲", "⑳", "㉑", "㉒", "㉓", "㉔", "㉕", "㉖", "㉗", "㉘", "㉙", "㉚", "㉛", "㉜", "㉝", "㉞", "㉟", "㊱", "㊲", "㊳", "㊴", "㊵", "㊶", "㊷", "㊸", "㊹", "㊺", "㊻", "㊼", "㊽", "㊾", "㊿"];
+export declare const ideographTraditional: readonly ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"];
+export declare const ideographZodiac: readonly ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"];
+type WriterTableRepresentation = "decimalEnclosedCircle" | "decimalEnclosedCircleChinese" | "ideographEnclosedCircle" | "ideographTraditional" | "ideographZodiac";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-tables.md#writer-circled-stem-and-branch-representations`. */
+export declare function isWriterTableRepresentation(representation: BoundedNumberRepresentation): representation is WriterTableRepresentation;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-tables.md#writer-circled-stem-and-branch-representations`. */
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/writer-tables.md#writer-circled-stem-and-branch-representations`. */
+export declare function formatWriterTableNumber(value: bigint, representation: WriterTableRepresentation): BoundedNumberRepresentationResult;
+export {};
+//# sourceMappingURL=bounded-number-representation-writer-tables.d.ts.map

package/types/foundation/bounded-number-representation.d.ts

@@ -0,0 +1,18 @@
+import { type BoundedNumberRepresentationCheckpoint, type BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/_index.md#bounded-number-representation`; `spec/pipeline/foundation/bounded-number-representation/decimal-roman-latin.md#decimal-roman-and-latin-representations`; `spec/pipeline/foundation/bounded-number-representation/writer-tables.md#writer-circled-stem-and-branch-representations`; `spec/pipeline/foundation/bounded-number-representation/hebrew.md#writer-hebrew-numeral-representation`; `spec/pipeline/foundation/bounded-number-representation/cjk.md#writer-cjk-ideographic-representations`; `spec/pipeline/foundation/bounded-number-representation/korean.md#writer-korean-digital-counting-and-legal-representations`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/bijective.md#writer-bijective-representations`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/hindi-vowels.md#writer-hindi-vowel-representation`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/kana-recycled-symbols.md#writer-kana-recycled-symbols`; `spec/pipeline/foundation/bounded-number-representation/writer-alphabets/korean-recycled-symbols.md#writer-korean-recycled-symbols`. */
+export type BoundedNumberRepresentation = "decimal" | "decimalZero" | "decimalFullWidth" | "decimalFullWidth2" | "decimalEnclosedCircle" | "decimalEnclosedCircleChinese" | "ideographEnclosedCircle" | "ideographTraditional" | "ideographZodiac" | "chineseCounting" | "chineseCountingThousand" | "ideographDigital" | "japaneseCounting" | "taiwaneseCounting" | "taiwaneseCountingThousand" | "chineseLegalSimplified" | "ideographLegalTraditional" | "japaneseLegal" | "koreanDigital" | "koreanDigital2" | "koreanCounting" | "koreanLegal" | "upperRoman" | "lowerRoman" | "upperLatin" | "lowerLatin" | "upperAlphabetic" | "lowerAlphabetic" | "russianLower" | "russianUpper" | "arabicAlpha" | "arabicAbjad" | "hebrew1" | "hebrew2" | "thaiLetters" | "hindiVowels" | "aiueo" | "aiueoFullWidth" | "iroha" | "irohaFullWidth" | "ganada" | "chosung";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/_index.md#bounded-number-representation`. */
+export type PageNumberingFormat = BoundedNumberRepresentation | "unsupported";
+export type { BoundedNumberRepresentationCheckpoint, BoundedNumberRepresentationResult } from "./bounded-number-representation-mechanics.js";
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/sequence-display.md#sequence-display-conversion`. */
+export type SequenceNumberRepresentation = Extract<BoundedNumberRepresentation, "decimal" | "upperRoman" | "lowerRoman" | "upperAlphabetic" | "lowerAlphabetic">;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/sequence-display.md#sequence-display-conversion`. */
+export declare function formatSequenceNumber(value: bigint, representation: SequenceNumberRepresentation): string;
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/_index.md#bounded-number-representation`. */
+/** Spec: `spec/pipeline/foundation/bounded-number-representation/_index.md#bounded-number-representation`. */
+export declare function formatBoundedNumberRepresentation(value: bigint, representation: BoundedNumberRepresentation, checkpoint?: BoundedNumberRepresentationCheckpoint): BoundedNumberRepresentationResult;
+export { russianLower, russianUpper, arabicAlpha, arabicAbjad, hebrew2, thaiLetters, hindiVowels, aiueo, aiueoFullWidth, iroha, irohaFullWidth, ganada, chosung } from "./bounded-number-representation-writer-alphabets.js";
+export { koreanDigital, koreanDigital2, koreanCountingDigits, koreanLegalOnes, koreanLegalTens } from "./bounded-number-representation-korean.js";
+export { chineseCountingDigits, chineseCountingLargeUnits, simplifiedLegalDigits, simplifiedLegalLargeUnits, traditionalLegalDigits, traditionalLegalLargeUnits, japaneseLegalDigits } from "./bounded-number-representation-cjk.js";
+export { writerCircledNumbers, ideographTraditional, ideographZodiac } from "./bounded-number-representation-writer-tables.js";
+//# sourceMappingURL=bounded-number-representation.d.ts.map

package/types/foundation/browser-text.d.ts

@@ -0,0 +1,23 @@
+/** Spec: `spec/pipeline/layout/text/font/browser-native-text-realization.md`. */
+export interface BrowserTextOperation {
+    readonly kind: "nativeText";
+    readonly text: string;
+    readonly font: string;
+    readonly direction: "ltr" | "rtl";
+    readonly kerning: CanvasFontKerning;
+    readonly letterSpacing: string;
+    readonly language: string;
+    readonly x: number;
+    readonly y: number;
+    readonly a: number;
+    readonly b: number;
+    readonly c: number;
+    readonly d: number;
+    readonly width: number;
+    readonly inkLeft: number;
+    readonly inkRight: number;
+    readonly ascent: number;
+    readonly descent: number;
+    readonly strokeWidth?: number;
+}
+//# sourceMappingURL=browser-text.d.ts.map

package/types/foundation/chart-number-format.d.ts

@@ -0,0 +1,3 @@
+/** Spec: document.body.drawing.chart.axis-number-format */
+export declare function chartAxisNumberLabel(tick: string, formatCode: string | null): string;
+//# sourceMappingURL=chart-number-format.d.ts.map

package/types/foundation/device-rounding.d.ts

@@ -0,0 +1,3 @@
+/** Spec: pipeline.sdk.page-source */
+export declare function roundHalfAwayFromZero(value: number): number;
+//# sourceMappingURL=device-rounding.d.ts.map

package/types/foundation/font-resources.d.ts

@@ -0,0 +1,14 @@
+/** Spec: pipeline.render.resources */
+export interface FontFaceResource {
+    readonly family: string;
+    readonly source: string | Uint8Array;
+    readonly descriptors: Readonly<{
+        weight: string;
+        style: string;
+        stretch: string;
+        ascentOverride: string;
+        descentOverride: string;
+        lineGapOverride: string;
+    }>;
+}
+//# sourceMappingURL=font-resources.d.ts.map

package/types/foundation/geometry-path.d.ts

@@ -0,0 +1,27 @@
+/** Spec: `spec/pipeline/layout/publication/layout-document/positioned-text.md#native-text-and-decoration-contracts`. */
+export type GeometryPathOperation = Readonly<{
+    readonly kind: "moveTo";
+    readonly x: number;
+    readonly y: number;
+}> | Readonly<{
+    readonly kind: "lineTo";
+    readonly x: number;
+    readonly y: number;
+}> | Readonly<{
+    readonly kind: "quadraticCurveTo";
+    readonly controlX: number;
+    readonly controlY: number;
+    readonly x: number;
+    readonly y: number;
+}> | Readonly<{
+    readonly kind: "bezierCurveTo";
+    readonly control1X: number;
+    readonly control1Y: number;
+    readonly control2X: number;
+    readonly control2Y: number;
+    readonly x: number;
+    readonly y: number;
+}> | Readonly<{
+    readonly kind: "closePath";
+}>;
+//# sourceMappingURL=geometry-path.d.ts.map

package/types/foundation/host-task.d.ts

@@ -0,0 +1,3 @@
+/** Spec: `spec/pipeline/host-task.md#cooperative-host-tasks`. */
+export declare function yieldToHost(): Promise<void>;
+//# sourceMappingURL=host-task.d.ts.map

package/types/foundation/image-resources.d.ts

@@ -0,0 +1,39 @@
+/** Spec: pipeline.render.resources */
+import type { RasterColorEffectPlan } from "./raster-color-effect.js";
+export interface ImageResourceId {
+    readonly type: "ResourceId";
+    readonly serialized: `r_${string}`;
+}
+export type ImageResourceReference = ImageResourceId | Readonly<{
+    type: "SvgImageResourceChoice";
+    svgResourceId: ImageResourceId;
+    rasterFallbackResourceId?: ImageResourceId;
+}>;
+export interface ImagePixelSize {
+    readonly width: number;
+    readonly height: number;
+}
+export interface ImageResourceSource {
+    readonly bytes: Uint8Array;
+    readonly mediaType: "image/bmp" | "image/gif" | "image/jpeg" | "image/png" | "image/svg+xml";
+}
+export interface ImageResourceSelection {
+    readonly resource: ImageResourceReference;
+    readonly rasterFallbackOnly: boolean;
+    readonly optional?: boolean;
+}
+export interface ImageResourceData {
+    readonly sources: readonly Readonly<{
+        id: string;
+        source: ImageResourceSource;
+    }>[];
+    readonly selections: readonly ImageResourceSelection[];
+}
+export interface RasterImageMaterializer {
+    resolveRasterImage(resource: ImageResourceReference, colorEffect?: RasterColorEffectPlan): CanvasImageSource | undefined;
+    resolveRasterImageIntrinsicPixelSize(resource: ImageResourceReference, colorEffect?: RasterColorEffectPlan): ImagePixelSize | undefined;
+    resolvePreparedRasterImage(resource: ImageResourceReference, size: ImagePixelSize, colorEffect?: RasterColorEffectPlan, flipHorizontal?: boolean, flipVertical?: boolean): CanvasImageSource | undefined;
+    dispose(): void;
+}
+export declare function materializeImageResources(data: ImageResourceData, signal?: AbortSignal, onDispose?: () => void): Promise<RasterImageMaterializer>;
+//# sourceMappingURL=image-resources.d.ts.map

package/types/foundation/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./raster-source-rectangle.js";
+export * from "./raster-color-effect.js";
+export * from "./bounded-number-representation.js";
+export * from "./writer-unmapped-ooxml-number-format.js";
+export * from "./vector-shape-fill.js";
+export * from "./vector-shape-shadow.js";
+export * from "./vector-shape.js";
+export * from "./host-task.js";
+export * from "./path-bounds.js";
+export * from "./geometry-path.js";
+export * from "./browser-text.js";
+export * from "./device-rounding.js";
+export * from "./font-resources.js";
+export * from "./page-interaction.js";
+export * from "./image-resources.js";
+export * from "./chart-number-format.js";
+//# sourceMappingURL=index.d.ts.map