html2pdf-accessible 0.0.0-stage → 0.1.5

package/lib/types/pdf/pdf-export.d.ts

@@ -0,0 +1,29 @@
+import { CanvasKit, PDFTag } from "@html2pdf-skia/canvaskit-pdf";
+import { Context } from "../core/context";
+import { IFontCollection } from "../fonts/interfaces";
+export declare const defaultUserToPdfScale = 0.5;
+export interface IPageSize {
+    width: number;
+    height: number;
+}
+export interface IPdfInputProvider {
+    getDocumentTitle(): string;
+    getDocumentStructure(): PDFTag;
+    getNextPageElement(): Promise<HTMLElement | null>;
+}
+export interface IPdfOptions {
+    title: string;
+    author: string;
+    subject: string;
+    keywords: string;
+    creator: string;
+    producer: string;
+    language?: string;
+    userToPdfScale?: number;
+    pageSize: {
+        width: number;
+        height: number;
+    };
+    fontCollection?: IFontCollection;
+}
+export declare function exportToPdf(canvasKit: CanvasKit, context: Context, inputProvider: IPdfInputProvider, pdfOptions?: Partial<IPdfOptions>): Promise<Blob>;

package/lib/types/pdf/single-html-multi-page.d.ts

@@ -0,0 +1,14 @@
+import { PDFTag, CanvasKit } from "@html2pdf-skia/canvaskit-pdf";
+import { IPageSize, IPdfInputProvider, IPdfOptions } from "./pdf-export";
+import { ContextOptions } from "../core/context";
+export declare class SingleHtmlMultiPageProvider implements IPdfInputProvider {
+    private document;
+    private currentPageIndex;
+    private htmlPageBreak;
+    constructor(document: Document, pageSize: IPageSize);
+    getDocumentStructure(): PDFTag;
+    getNextPageElement(): Promise<HTMLElement | null>;
+    getDocumentTitle(): string;
+}
+export type ExportPdfOptions = ContextOptions & IPdfOptions;
+export declare function exportHTMLDocumentToPdf(canvasKit: CanvasKit, document: Document, options: Partial<ExportPdfOptions>): Promise<Blob>;

package/lib/types/pdf/table-headers.d.ts

@@ -0,0 +1,6 @@
+/** Header relationships are resolved in the DOM, before pagination changes it. */
+export interface TableHeaderInfo {
+    scope?: "Column" | "Row" | "Both";
+    headers: Element[];
+}
+export declare function resolveTableHeaders(root: Element): Map<Element, TableHeaderInfo>;

package/lib/types/pdf/xmp-metadata.d.ts

@@ -0,0 +1,5 @@
+import { PDFDocument } from "pdf-lib";
+/** Mirror the existing document information into a real XMP metadata stream.
+ * The PDF/UA-1 identifier states the target standard; validation is still needed.
+ */
+export declare function addXmpMetadata(pdf: PDFDocument): void;

package/lib/types/render/background.d.ts

@@ -0,0 +1,16 @@
+import { Bounds } from "../css/layout/bounds";
+import { BACKGROUND_ORIGIN } from "../css/property-descriptors/background-origin";
+import { ElementContainer } from "../dom/element-container";
+import { BackgroundSizeInfo } from "../css/property-descriptors/background-size";
+import { Vector } from "./vector";
+import { BACKGROUND_REPEAT } from "../css/property-descriptors/background-repeat";
+import { CSSValue } from "../css/syntax/parser";
+import { Path } from "./path";
+import { BACKGROUND_CLIP } from "../css/property-descriptors/background-clip";
+export declare const calculateBackgroundPositioningArea: (backgroundOrigin: BACKGROUND_ORIGIN, element: ElementContainer) => Bounds;
+export declare const calculateBackgroundPaintingArea: (backgroundClip: BACKGROUND_CLIP, element: ElementContainer) => Bounds;
+export declare const calculateBackgroundRendering: (container: ElementContainer, index: number, intrinsicSize: [number | null, number | null, number | null]) => [Path[], number, number, number, number];
+export declare const isAuto: (token: CSSValue) => boolean;
+export declare const calculateBackgroundSize: (size: BackgroundSizeInfo[], [intrinsicWidth, intrinsicHeight, intrinsicProportion]: [number | null, number | null, number | null], bounds: Bounds) => [number, number];
+export declare const getBackgroundValueForIndex: <T>(values: T[], index: number) => T;
+export declare const calculateBackgroundRepeatPath: (repeat: BACKGROUND_REPEAT, [x, y]: [number, number], [width, height]: [number, number], backgroundPositioningArea: Bounds, backgroundPaintingArea: Bounds) => [Vector, Vector, Vector, Vector];

package/lib/types/render/bezier-curve.d.ts

@@ -0,0 +1,14 @@
+import { Vector } from "./vector";
+import { IPath, PathType, Path } from "./path";
+export declare class BezierCurve implements IPath {
+    type: PathType;
+    start: Vector;
+    startControl: Vector;
+    endControl: Vector;
+    end: Vector;
+    constructor(start: Vector, startControl: Vector, endControl: Vector, end: Vector);
+    subdivide(t: number, firstHalf: boolean): BezierCurve;
+    add(deltaX: number, deltaY: number): BezierCurve;
+    reverse(): BezierCurve;
+}
+export declare const isBezierCurve: (path: Path) => path is BezierCurve;

package/lib/types/render/border.d.ts

@@ -0,0 +1,6 @@
+import { Path } from "./path";
+import { BoundCurves } from "./bound-curves";
+export declare const parsePathForBorder: (curves: BoundCurves, borderSide: number) => Path[];
+export declare const parsePathForBorderDoubleOuter: (curves: BoundCurves, borderSide: number) => Path[];
+export declare const parsePathForBorderDoubleInner: (curves: BoundCurves, borderSide: number) => Path[];
+export declare const parsePathForBorderStroke: (curves: BoundCurves, borderSide: number) => Path[];

package/lib/types/render/bound-curves.d.ts

@@ -0,0 +1,32 @@
+import { ElementContainer } from "../dom/element-container";
+import { Path } from "./path";
+export declare class BoundCurves {
+    readonly topLeftBorderDoubleOuterBox: Path;
+    readonly topRightBorderDoubleOuterBox: Path;
+    readonly bottomRightBorderDoubleOuterBox: Path;
+    readonly bottomLeftBorderDoubleOuterBox: Path;
+    readonly topLeftBorderDoubleInnerBox: Path;
+    readonly topRightBorderDoubleInnerBox: Path;
+    readonly bottomRightBorderDoubleInnerBox: Path;
+    readonly bottomLeftBorderDoubleInnerBox: Path;
+    readonly topLeftBorderStroke: Path;
+    readonly topRightBorderStroke: Path;
+    readonly bottomRightBorderStroke: Path;
+    readonly bottomLeftBorderStroke: Path;
+    readonly topLeftBorderBox: Path;
+    readonly topRightBorderBox: Path;
+    readonly bottomRightBorderBox: Path;
+    readonly bottomLeftBorderBox: Path;
+    readonly topLeftPaddingBox: Path;
+    readonly topRightPaddingBox: Path;
+    readonly bottomRightPaddingBox: Path;
+    readonly bottomLeftPaddingBox: Path;
+    readonly topLeftContentBox: Path;
+    readonly topRightContentBox: Path;
+    readonly bottomRightContentBox: Path;
+    readonly bottomLeftContentBox: Path;
+    constructor(element: ElementContainer);
+}
+export declare const calculateBorderBoxPath: (curves: BoundCurves) => Path[];
+export declare const calculateContentBoxPath: (curves: BoundCurves) => Path[];
+export declare const calculatePaddingBoxPath: (curves: BoundCurves) => Path[];

package/lib/types/render/box-sizing.d.ts

@@ -0,0 +1,4 @@
+import { Bounds } from "../css/layout/bounds";
+import { ElementContainer } from "../dom/element-container";
+export declare const paddingBox: (element: ElementContainer) => Bounds;
+export declare const contentBox: (element: ElementContainer) => Bounds;

package/lib/types/render/canvas/canvas-renderer.d.ts

@@ -0,0 +1,53 @@
+import { ElementPaint, StackingContext } from "../stacking-context";
+import { Color } from "../../css/types/color";
+import { ElementContainer } from "../../dom/element-container";
+import { BORDER_STYLE } from "../../css/property-descriptors/border-style";
+import { CSSParsedDeclaration } from "../../css";
+import { TextContainer } from "../../dom/text-container";
+import { Path } from "../path";
+import { BoundCurves } from "../bound-curves";
+import { TextBounds } from "../../css/layout/text";
+import { ReplacedElementContainer } from "../../dom/replaced-elements";
+import { IElementEffect } from "../effects";
+import { Renderer } from "../renderer";
+import { Context } from "../../core/context";
+export type RenderConfigurations = RenderOptions & {
+    backgroundColor: Color | null;
+};
+export interface RenderOptions {
+    scale: number;
+    canvas?: HTMLCanvasElement;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare class CanvasRenderer extends Renderer {
+    canvas: HTMLCanvasElement;
+    ctx: CanvasRenderingContext2D;
+    private readonly _activeEffects;
+    private readonly fontMetrics;
+    constructor(context: Context, options: RenderConfigurations);
+    applyEffects(effects: IElementEffect[]): void;
+    applyEffect(effect: IElementEffect): void;
+    popEffect(): void;
+    renderStack(stack: StackingContext): Promise<void>;
+    renderNode(paint: ElementPaint): Promise<void>;
+    renderTextWithLetterSpacing(text: TextBounds, letterSpacing: number, baseline: number): void;
+    private createFontStyle;
+    renderTextNode(text: TextContainer, styles: CSSParsedDeclaration): Promise<void>;
+    renderReplacedElement(container: ReplacedElementContainer, curves: BoundCurves, image: HTMLImageElement | HTMLCanvasElement): void;
+    renderNodeContent(paint: ElementPaint): Promise<void>;
+    renderStackContent(stack: StackingContext): Promise<void>;
+    mask(paths: Path[]): void;
+    path(paths: Path[]): void;
+    formatPath(paths: Path[]): void;
+    renderRepeat(path: Path[], pattern: CanvasPattern | CanvasGradient, offsetX: number, offsetY: number): void;
+    resizeImage(image: HTMLImageElement, width: number, height: number): HTMLCanvasElement | HTMLImageElement;
+    renderBackgroundImage(container: ElementContainer): Promise<void>;
+    renderSolidBorder(color: Color, side: number, curvePoints: BoundCurves): Promise<void>;
+    renderDoubleBorder(color: Color, width: number, side: number, curvePoints: BoundCurves): Promise<void>;
+    renderNodeBackgroundAndBorders(paint: ElementPaint): Promise<void>;
+    renderDashedDottedBorder(color: Color, width: number, side: number, curvePoints: BoundCurves, style: BORDER_STYLE): Promise<void>;
+    render(element: ElementContainer): Promise<HTMLCanvasElement>;
+}

package/lib/types/render/canvas/foreignobject-renderer.d.ts

@@ -0,0 +1,11 @@
+import { RenderConfigurations } from "./canvas-renderer";
+import { Renderer } from "../renderer";
+import { Context } from "../../core/context";
+export declare class ForeignObjectRenderer extends Renderer {
+    canvas: HTMLCanvasElement;
+    ctx: CanvasRenderingContext2D;
+    options: RenderConfigurations;
+    constructor(context: Context, options: RenderConfigurations);
+    render(element: HTMLElement): Promise<HTMLCanvasElement>;
+}
+export declare const loadSerializedSVG: (svg: Node) => Promise<HTMLImageElement>;

package/lib/types/render/effects.d.ts

@@ -0,0 +1,38 @@
+import { Matrix } from "../css/property-descriptors/transform";
+import { Path } from "./path";
+export declare const enum EffectType {
+    TRANSFORM = 0,
+    CLIP = 1,
+    OPACITY = 2
+}
+export declare const enum EffectTarget {
+    BACKGROUND_BORDERS = 2,
+    CONTENT = 4
+}
+export interface IElementEffect {
+    readonly type: EffectType;
+    readonly target: number;
+}
+export declare class TransformEffect implements IElementEffect {
+    readonly offsetX: number;
+    readonly offsetY: number;
+    readonly matrix: Matrix;
+    readonly type: EffectType;
+    readonly target: number;
+    constructor(offsetX: number, offsetY: number, matrix: Matrix);
+}
+export declare class ClipEffect implements IElementEffect {
+    readonly path: Path[];
+    readonly target: EffectTarget;
+    readonly type: EffectType;
+    constructor(path: Path[], target: EffectTarget);
+}
+export declare class OpacityEffect implements IElementEffect {
+    readonly opacity: number;
+    readonly type: EffectType;
+    readonly target: number;
+    constructor(opacity: number);
+}
+export declare const isTransformEffect: (effect: IElementEffect) => effect is TransformEffect;
+export declare const isClipEffect: (effect: IElementEffect) => effect is ClipEffect;
+export declare const isOpacityEffect: (effect: IElementEffect) => effect is OpacityEffect;

package/lib/types/render/font-metrics.d.ts

@@ -0,0 +1,11 @@
+export interface FontMetric {
+    baseline: number;
+    middle: number;
+}
+export declare class FontMetrics {
+    private readonly _data;
+    private readonly _document;
+    constructor(document: Document);
+    private parseMetrics;
+    getMetrics(fontFamily: string, fontSize: string): FontMetric;
+}

package/lib/types/render/path.d.ts

@@ -0,0 +1,13 @@
+import { BezierCurve } from "./bezier-curve";
+import { Vector } from "./vector";
+export declare const enum PathType {
+    VECTOR = 0,
+    BEZIER_CURVE = 1
+}
+export interface IPath {
+    type: PathType;
+    add(deltaX: number, deltaY: number): IPath;
+}
+export declare const equalPath: (a: Path[], b: Path[]) => boolean;
+export declare const transformPath: (path: Path[], deltaX: number, deltaY: number, deltaW: number, deltaH: number) => Path[];
+export type Path = Vector | BezierCurve;

package/lib/types/render/renderer.d.ts

@@ -0,0 +1,7 @@
+import { Context } from "../core/context";
+import { RenderConfigurations } from "./canvas/canvas-renderer";
+export declare class Renderer {
+    protected readonly context: Context;
+    protected readonly options: RenderConfigurations;
+    constructor(context: Context, options: RenderConfigurations);
+}

package/lib/types/render/skia/skia-font.d.ts

@@ -0,0 +1,27 @@
+import { Font } from "@html2pdf-skia/canvaskit-pdf";
+import { SkiaFontCollection } from "../../fonts/font-collection";
+import { FontStylePojo } from "../../fonts/interfaces";
+import { CSSParsedDeclaration } from "../../css";
+/**
+ * Parsed font information from CSS styles
+ */
+export interface ParsedFontInfo {
+    fontFamily: string[];
+    fontSize: number;
+    fontStyle: FontStylePojo;
+    fontVariant: string;
+}
+export declare function createSkiaFont(styles: CSSParsedDeclaration, fontCollection: SkiaFontCollection): Font;
+/**
+ * Parse CSS font styles into Skia-compatible font information
+ */
+export declare function parseFontStyle(styles: CSSParsedDeclaration): ParsedFontInfo;
+/**
+ * Map CSS font-weight values to Skia FontWeight
+ */
+export declare function mapCSSFontWeightToSkia(fontWeight: string | number): number;
+/**
+ * Map CSS font-style values to Skia FontSlant
+ */
+export declare function mapCSSFontStyleToSkia(fontStyle: string): number;
+export declare function getFinalFont(text: string, styles: CSSParsedDeclaration, originalFont: Font, fontCollection: SkiaFontCollection): Font;

package/lib/types/render/skia/skia-renderer.d.ts

@@ -0,0 +1,69 @@
+import { CanvasKit, Canvas as SkiaCanvas, Paint as SkiaPaint, Path as SkiaPath, PathBuilder, Shader as SkiaShader, Image as SkiaImage, Font as SkiaFont } from "@html2pdf-skia/canvaskit-pdf";
+import { ElementPaint, StackingContext } from "../stacking-context";
+import { Color } from "../../css/types/color";
+import { ElementContainer } from "../../dom/element-container";
+import { BORDER_STYLE } from "../../css/property-descriptors/border-style";
+import { CSSParsedDeclaration } from "../../css";
+import { TextContainer } from "../../dom/text-container";
+import { Path } from "../path";
+import { BoundCurves } from "../bound-curves";
+import { TextBounds } from "../../css/layout/text";
+import { ReplacedElementContainer } from "../../dom/replaced-elements";
+import { IElementEffect } from "../effects";
+import { Context } from "../../core/context";
+import { SkiaFontCollection } from "../../fonts/font-collection";
+export interface CanvasKitConfig {
+    canvasKit: CanvasKit;
+    canvas: SkiaCanvas;
+}
+export interface SkiaRenderOptions {
+    scale: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    backgroundColor: Color | null;
+    fontCollection: SkiaFontCollection;
+    document?: Document;
+    onElementContent?: (tagId: number, corners: number[]) => void;
+}
+export declare class SkiaRenderer {
+    private context;
+    private options;
+    canvas: SkiaCanvas;
+    canvasKit: CanvasKit;
+    private readonly _activeEffects;
+    private readonly fontMetrics;
+    private readonly globalAlpha;
+    constructor(context: Context, ckConfig: CanvasKitConfig, options: SkiaRenderOptions);
+    private parseColor;
+    /**
+     * Parse a color and apply the current global alpha value
+     */
+    private parseColorWithAlpha;
+    private createPaint;
+    applyEffects(effects: IElementEffect[]): void;
+    applyEffect(effect: IElementEffect): void;
+    popEffect(): void;
+    renderStack(stack: StackingContext): Promise<void>;
+    renderNode(paint: ElementPaint): Promise<void>;
+    renderTextWithLetterSpacing(text: TextBounds, letterSpacing: number, baseline: number, paint: SkiaPaint, font: SkiaFont): void;
+    renderTextNode(text: TextContainer, styles: CSSParsedDeclaration): void;
+    renderReplacedElement(container: ReplacedElementContainer, curves: BoundCurves, image: SkiaImage): void;
+    private createSkiaPath;
+    renderNodeContent(paint: ElementPaint): Promise<void>;
+    renderStackContent(stack: StackingContext): Promise<void>;
+    mask(paths: Path[]): void;
+    path(paths: Path[]): SkiaPath;
+    formatSkiaPath(skiaPath: PathBuilder, paths: Path[]): void;
+    renderRepeat(path: Path[], shader: SkiaShader, offsetX: number, offsetY: number): void;
+    renderBackgroundImage(container: ElementContainer): Promise<void>;
+    renderSolidBorder(color: Color, side: number, curvePoints: BoundCurves): void;
+    renderDoubleBorder(color: Color, width: number, side: number, curvePoints: BoundCurves): Promise<void>;
+    renderNodeBackgroundAndBorders(paint: ElementPaint): Promise<void>;
+    renderDashedDottedBorder(color: Color, width: number, side: number, curvePoints: BoundCurves, style: BORDER_STYLE): void;
+    private convertCanvasImageSourceToSkia;
+    private convertSvgToSkia;
+    render(element: ElementContainer): Promise<void>;
+    resizeImage(image: HTMLImageElement, width: number, height: number): HTMLCanvasElement | HTMLImageElement;
+}

package/lib/types/render/stacking-context.d.ts

@@ -0,0 +1,24 @@
+import { ElementContainer } from "../dom/element-container";
+import { BoundCurves } from "./bound-curves";
+import { EffectTarget, IElementEffect } from "./effects";
+export declare class StackingContext {
+    element: ElementPaint;
+    negativeZIndex: StackingContext[];
+    zeroOrAutoZIndexOrTransformedOrOpacity: StackingContext[];
+    positiveZIndex: StackingContext[];
+    nonPositionedFloats: StackingContext[];
+    nonPositionedInlineLevel: StackingContext[];
+    inlineLevel: ElementPaint[];
+    nonInlineLevel: ElementPaint[];
+    constructor(container: ElementPaint);
+}
+export declare class ElementPaint {
+    readonly container: ElementContainer;
+    readonly parent: ElementPaint | null;
+    readonly effects: IElementEffect[];
+    readonly curves: BoundCurves;
+    listValue?: string;
+    constructor(container: ElementContainer, parent: ElementPaint | null);
+    getEffects(target: EffectTarget): IElementEffect[];
+}
+export declare const parseStackingContexts: (container: ElementContainer) => StackingContext;

package/lib/types/render/vector.d.ts

@@ -0,0 +1,9 @@
+import { IPath, Path, PathType } from "./path";
+export declare class Vector implements IPath {
+    type: PathType;
+    x: number;
+    y: number;
+    constructor(x: number, y: number);
+    add(deltaX: number, deltaY: number): Vector;
+}
+export declare const isVector: (path: Path) => path is Vector;

package/node_modules/@html2pdf-skia/canvaskit-pdf/CHROMIUM-LICENSE

@@ -0,0 +1,27 @@
+// Copyright 2015 The Chromium Authors
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google LLC nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/@html2pdf-skia/canvaskit-pdf/LICENSE

@@ -0,0 +1,29 @@
+// Copyright (c) 2011 Google Inc. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+--------------------------------------------------------------------------------

package/node_modules/@html2pdf-skia/canvaskit-pdf/README.md

@@ -0,0 +1,35 @@
+# CanvasKit PDF source build
+
+This package uses Google's BSD-3-Clause Skia CanvasKit 0.42.0 from
+https://skia.googlesource.com/skia.git at
+`e2def78fa232884d4aedcf3ad92d4a0dd673b898`.
+The only additional native implementation is `pdf_bindings.cpp` (MIT).
+It calls SkPDF and exposes `MakePDFDocument`, `SetPDFTagId` and `GetTypefaceId`.
+PDF structure names and numeric attributes are checked before serialization.
+
+The builder enables SkPDF in Google's CanvasKit build, adds the bridge, and uses
+CPU rendering, paragraph/font providers and client Unicode (plus SkPDF's
+ICU bidi subset). GPU, Skottie,
+embedded fonts, WOFF2 and tracing are disabled. Consumers supply fonts.
+The upstream mutable Path API became PathBuilder; the library adapts this
+internally without changing PDF export options. Direct CanvasKit consumers
+receive Google's 0.42 API.
+
+From the repository root, run `npm run build:canvaskit` to rebuild using Docker.
+`npm run test:canvaskit:rebuild` compares the rebuilt artifacts without replacing
+them. `scripts/canvaskit/build.py` runs inside the pinned Emscripten image;
+Python is not a host requirement. `scripts/canvaskit/build.cjs` starts that image.
+The build overlays two pinned Google build files; it rejects other source edits
+and verifies all selected dependency checkouts against Google's DEPS revisions.
+
+`provenance.json` records source and dependency revisions, compiler image digest,
+bridge/build-script hashes and artifact hashes. Hashes alone do not prove trust:
+CI additionally recompiles the source and compares the actual output.
+`LICENSE`, `CHROMIUM-LICENSE` and `THIRD_PARTY_LICENSES.txt` cover upstream code.
+PartitionAlloc's exported repository omits Chromium's root license; the pinned
+primary source URL and digest of that license are recorded separately.
+
+The bridge supplies SkPDF tags. The library still finalizes table header links,
+figure bounds, annotation structure, metadata and outlines with pdf-lib.
+Automated fixture results do not establish conformance for every document;
+manual PAC and screen-reader testing remain release checks.