html2canvas-pro 2.4.4 → 2.5.0

package/dist/types/core/cache-storage.d.ts

@@ -31,8 +31,11 @@ export declare class Cache {
      * failed (logged). Subsequent cache.match() calls return immediately.
      *
      * @param concurrency - Max concurrent image loads (1–100, default 10).
+     * @param onProgress - Invoked once before loading and after each settled
+     *   batch with (settledCount, totalCount), enabling coarse progress UI.
+     *   Not invoked when there is nothing to load.
      */
-    preloadAll(concurrency?: number): Promise<void>;
+    preloadAll(concurrency?: number, onProgress?: (loaded: number, total: number) => void): Promise<void>;
     addImage(src: string): Promise<void>;
     /**
      * Shared helper: enqueues loading for a single URL with pending-operation

package/dist/types/core/context.d.ts

@@ -10,7 +10,6 @@ export type ContextOptions = {
     onError?: (error: Error) => void;
 } & ResourceOptions;
 export declare class Context {
-    windowBounds: Bounds;
     private readonly instanceName;
     readonly logger: Logger;
     readonly cache: Cache;
@@ -18,5 +17,15 @@ export declare class Context {
     readonly config: Html2CanvasConfig;
     readonly onError?: (error: Error) => void;
     private static instanceCount;
+    private _windowBounds;
     constructor(options: ContextOptions, windowBounds: Bounds, config: Html2CanvasConfig);
+    /** Viewport bounds in page coordinates; added to client rects during bounds parsing. */
+    get windowBounds(): Bounds;
+    /**
+     * Compensate window bounds for a page scroll that the browser performed
+     * underneath us. Used by the document cloner: WebKit's scroll anchoring can
+     * scroll the cloned iframe after `onclone`, and the offset must be applied
+     * to subsequent bounds parsing (the only sanctioned mutation of this value).
+     */
+    adjustWindowBounds(left: number, top: number): void;
 }

package/dist/types/core/render-element.d.ts

@@ -1,3 +1,14 @@
 import { Html2CanvasConfig } from '../config';
 import type { Options } from '../options';
+/**
+ * Progress milestones emitted via `Options.onProgress`.
+ * Phase names are stable API; percentages are coarse estimates.
+ */
+export declare const enum ProgressPhase {
+    CLONE = "clone",
+    PARSE = "parse",
+    PRELOAD = "preload",
+    LAYOUT = "layout",
+    RENDER = "render"
+}
 export declare const renderElement: (element: HTMLElement, opts: Partial<Options>, config: Html2CanvasConfig) => Promise<HTMLCanvasElement>;

package/dist/types/core/util.d.ts

@@ -1 +1,7 @@
 export declare const SMALL_IMAGE = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7";
+/**
+ * Indexed access where the shape/arity is guaranteed by construction (the CSS
+ * grammar or a preceding length check). Throws on the impossible case instead
+ * of silently propagating `undefined`.
+ */
+export declare const at: <T>(items: readonly T[], index: number) => T;

package/dist/types/css/index.d.ts

@@ -1,74 +1,83 @@
-import { backgroundClip } from './property-descriptors/background-clip';
-import { backgroundImage } from './property-descriptors/background-image';
-import { backgroundOrigin } from './property-descriptors/background-origin';
-import { backgroundPosition } from './property-descriptors/background-position';
-import { backgroundRepeat } from './property-descriptors/background-repeat';
-import { backgroundSize } from './property-descriptors/background-size';
-import { borderBottomLeftRadius, borderBottomRightRadius, borderTopLeftRadius, borderTopRightRadius } from './property-descriptors/border-radius';
-import { borderBottomStyle, borderLeftStyle, borderRightStyle, borderTopStyle } from './property-descriptors/border-style';
-import { borderBottomWidth, borderLeftWidth, borderRightWidth, borderTopWidth } from './property-descriptors/border-width';
-import { ClipPathValue } from './property-descriptors/clip-path';
-import { direction } from './property-descriptors/direction';
-import { display } from './property-descriptors/display';
+import { CSSValue } from './syntax/parser';
+import { Color } from './types/color';
 import { float } from './property-descriptors/float';
+import { OVERFLOW } from './property-descriptors/overflow';
+import { textDecorationLine } from './property-descriptors/text-decoration-line';
+import { content } from './property-descriptors/content';
+import { quotes } from './property-descriptors/quotes';
+import { counterIncrement } from './property-descriptors/counter-increment';
+import { counterReset } from './property-descriptors/counter-reset';
+import { Context } from '../core/context';
+import { BorderStyles } from './grouped/border-styles';
+import { BackgroundStyles } from './grouped/background-styles';
+import { FontStyles } from './grouped/font-styles';
+import { LayoutStyles } from './grouped/layout-styles';
+import { position } from './property-descriptors/position';
+import { visibility } from './property-descriptors/visibility';
 import { letterSpacing } from './property-descriptors/letter-spacing';
 import { lineBreak } from './property-descriptors/line-break';
 import { listStyleImage } from './property-descriptors/list-style-image';
 import { listStylePosition } from './property-descriptors/list-style-position';
 import { listStyleType } from './property-descriptors/list-style-type';
-import { OVERFLOW } from './property-descriptors/overflow';
-import { overflowWrap } from './property-descriptors/overflow-wrap';
-import { textAlign } from './property-descriptors/text-align';
-import { position } from './property-descriptors/position';
+import { opacity } from './property-descriptors/opacity';
 import { textShadow } from './property-descriptors/text-shadow';
 import { textTransform } from './property-descriptors/text-transform';
-import { transform } from './property-descriptors/transform';
-import { transformOrigin } from './property-descriptors/transform-origin';
-import { rotate } from './property-descriptors/rotate';
-import { visibility } from './property-descriptors/visibility';
+import { textDecorationStyle } from './property-descriptors/text-decoration-style';
+import { textDecorationThickness } from './property-descriptors/text-decoration-thickness';
+import { textUnderlineOffset } from './property-descriptors/text-underline-offset';
+import { paintOrder } from './property-descriptors/paint-order';
+import { webkitLineClamp } from './property-descriptors/webkit-line-clamp';
 import { wordBreak } from './property-descriptors/word-break';
 import { whiteSpace } from './property-descriptors/white-space';
 import { writingMode } from './property-descriptors/writing-mode';
 import { zIndex } from './property-descriptors/z-index';
-import { CSSValue } from './syntax/parser';
-import { Color } from './types/color';
-import { opacity } from './property-descriptors/opacity';
-import { textDecorationLine } from './property-descriptors/text-decoration-line';
-import { textDecorationStyle } from './property-descriptors/text-decoration-style';
-import { textDecorationThickness } from './property-descriptors/text-decoration-thickness';
-import { textUnderlineOffset } from './property-descriptors/text-underline-offset';
-import { LengthPercentage } from './types/length-percentage';
+import { MixBlendMode } from './property-descriptors/mix-blend-mode';
+import { filter } from './property-descriptors/filter';
+import { zoom } from './property-descriptors/zoom';
+import { ClipPathValue } from './property-descriptors/clip-path';
+import { borderBottomLeftRadius, borderBottomRightRadius, borderTopLeftRadius, borderTopRightRadius } from './property-descriptors/border-radius';
+import { borderBottomStyle, borderLeftStyle, borderRightStyle, borderTopStyle } from './property-descriptors/border-style';
+import { borderBottomWidth, borderLeftWidth, borderRightWidth, borderTopWidth } from './property-descriptors/border-width';
+import { backgroundClip } from './property-descriptors/background-clip';
+import { backgroundImage } from './property-descriptors/background-image';
+import { backgroundOrigin } from './property-descriptors/background-origin';
+import { backgroundPosition } from './property-descriptors/background-position';
+import { backgroundRepeat } from './property-descriptors/background-repeat';
+import { backgroundSize } from './property-descriptors/background-size';
+import { boxShadow } from './property-descriptors/box-shadow';
+import { direction } from './property-descriptors/direction';
+import { display } from './property-descriptors/display';
 import { fontFamily } from './property-descriptors/font-family';
-import { fontWeight } from './property-descriptors/font-weight';
-import { fontVariant } from './property-descriptors/font-variant';
 import { fontStyle } from './property-descriptors/font-style';
-import { content } from './property-descriptors/content';
-import { counterIncrement } from './property-descriptors/counter-increment';
-import { counterReset } from './property-descriptors/counter-reset';
+import { fontVariant } from './property-descriptors/font-variant';
+import { fontWeight } from './property-descriptors/font-weight';
 import { duration } from './property-descriptors/duration';
-import { quotes } from './property-descriptors/quotes';
-import { boxShadow } from './property-descriptors/box-shadow';
-import { paintOrder } from './property-descriptors/paint-order';
+import { overflowWrap } from './property-descriptors/overflow-wrap';
+import { textAlign } from './property-descriptors/text-align';
+import { transform } from './property-descriptors/transform';
+import { transformOrigin } from './property-descriptors/transform-origin';
+import { rotate } from './property-descriptors/rotate';
+import { LengthPercentage } from './types/length-percentage';
 import { webkitTextStrokeWidth } from './property-descriptors/webkit-text-stroke-width';
-import { webkitLineClamp } from './property-descriptors/webkit-line-clamp';
-import { Context } from '../core/context';
 import { objectFit } from './property-descriptors/object-fit';
 import { textOverflow } from './property-descriptors/text-overflow';
 import { imageRendering } from './property-descriptors/image-rendering';
-import { MixBlendMode } from './property-descriptors/mix-blend-mode';
-import { filter } from './property-descriptors/filter';
 import { fontVariantLigatures } from './property-descriptors/font-variant-ligatures';
-import { zoom } from './property-descriptors/zoom';
 import { objectPosition } from './property-descriptors/object-position';
 import { backgroundBlendMode } from './property-descriptors/background-blend-mode';
 import { borderImageSource } from './property-descriptors/border-image-source';
 import { borderImageSlice } from './property-descriptors/border-image-slice';
 import { borderImageRepeat } from './property-descriptors/border-image-repeat';
 import { boxDecorationBreak } from './property-descriptors/box-decoration-break';
-import { BorderStyles } from './grouped/border-styles';
-import { BackgroundStyles } from './grouped/background-styles';
-import { FontStyles } from './grouped/font-styles';
-import { LayoutStyles } from './grouped/layout-styles';
+import { type AccentColor } from './property-descriptors/accent-color';
+import { type WebkitTextFillColor } from './property-descriptors/webkit-text-fill-color';
+import { type ISOLATION } from './property-descriptors/isolation';
+import { type OUTLINE_STYLE, type OutlineColor } from './property-descriptors/outline';
+import { type FilterValue } from './property-descriptors/filter';
+import { type MaskImage, type MaskPosition, type MaskRepeat, type MaskSize } from './property-descriptors/mask';
+import { type TextEmphasisColor, type TextEmphasisPosition as TextEmphasisPositionValue, type TextEmphasisStyle } from './property-descriptors/text-emphasis';
+import { type BorderImageOutset, type BorderImageWidthSide } from './property-descriptors/border-image-width';
+import { type BoxReflectValue } from './property-descriptors/webkit-box-reflect';
 export declare class CSSParsedDeclaration {
     animationDuration: ReturnType<typeof duration.parse>;
     backgroundClip: ReturnType<typeof backgroundClip.parse>;
@@ -157,6 +166,29 @@ export declare class CSSParsedDeclaration {
     borderImageSlice: ReturnType<typeof borderImageSlice.parse>;
     borderImageRepeat: ReturnType<typeof borderImageRepeat.parse>;
     boxDecorationBreak: ReturnType<typeof boxDecorationBreak.parse>;
+    accentColor: AccentColor;
+    webkitTextFillColor: WebkitTextFillColor;
+    isolation: ISOLATION;
+    outlineColor: OutlineColor;
+    outlineStyle: OUTLINE_STYLE;
+    outlineWidth: number;
+    outlineOffset: number;
+    backdropFilter: FilterValue;
+    maskImage: MaskImage;
+    maskPosition: MaskPosition;
+    maskRepeat: MaskRepeat;
+    maskSize: MaskSize;
+    textEmphasisStyle: TextEmphasisStyle;
+    textEmphasisColor: TextEmphasisColor;
+    textEmphasisPosition: TextEmphasisPositionValue;
+    borderImageWidth: {
+        top: BorderImageWidthSide;
+        right: BorderImageWidthSide;
+        bottom: BorderImageWidthSide;
+        left: BorderImageWidthSide;
+    };
+    borderImageOutset: BorderImageOutset;
+    webkitBoxReflect: BoxReflectValue;
     private _border?;
     private _background?;
     private _font?;
@@ -165,7 +197,6 @@ export declare class CSSParsedDeclaration {
     get background(): BackgroundStyles;
     get font(): FontStyles;
     get layout(): LayoutStyles;
-    private static readonly standardProps;
     constructor(context: Context, declaration: CSSStyleDeclaration);
     isVisible(): boolean;
     isTransparent(): boolean;

package/dist/types/css/parse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CSS property registry and value parser.
+ *
+ * Owns the canonical list of parsed standard properties (the single place to
+ * register a new CSS property: add the descriptor import and one table row)
+ * and the shared LRU parse cache that turns computed style strings into
+ * strongly-typed values.
+ *
+ * Extracted from css/index.ts so the declaration data class stays free of
+ * parsing machinery.
+ */
+import { CSSPropertyDescriptor } from './property-descriptor';
+import { Context } from '../core/context';
+export declare const STANDARD_PROPERTIES: [string, CSSPropertyDescriptor<unknown>, string][];
+export declare const parse: (context: Context, descriptor: CSSPropertyDescriptor<any>, style?: string | null) => any;

package/dist/types/css/property-descriptors/accent-color.d.ts

@@ -0,0 +1,5 @@
+import { IPropertyValueDescriptor } from '../property-descriptor';
+import { type Color } from '../types/color';
+/** `null` represents the `auto` keyword: browser-default control colour. */
+export type AccentColor = Color | null;
+export declare const accentColor: IPropertyValueDescriptor<AccentColor>;

package/dist/types/css/property-descriptors/backdrop-filter.d.ts

@@ -0,0 +1,9 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+import { type FilterValue } from './filter';
+/**
+ * backdrop-filter shares the filter value grammar and canvas filter string
+ * reconstruction. Rendering captures the already-painted backdrop region and
+ * applies the filter surface pipeline to it.
+ */
+export type BackdropFilter = FilterValue;
+export declare const backdropFilter: IPropertyListDescriptor<BackdropFilter>;

package/dist/types/css/property-descriptors/background-blend-mode.d.ts

@@ -1,21 +1,21 @@
 import { IPropertyListDescriptor } from '../property-descriptor';
 export declare const MIX_BLEND_MODE: {
-    readonly NORMAL: "normal";
-    readonly MULTIPLY: "multiply";
-    readonly SCREEN: "screen";
-    readonly OVERLAY: "overlay";
-    readonly DARKEN: "darken";
-    readonly LIGHTEN: "lighten";
-    readonly COLOR_DODGE: "color-dodge";
-    readonly COLOR_BURN: "color-burn";
-    readonly HARD_LIGHT: "hard-light";
-    readonly SOFT_LIGHT: "soft-light";
-    readonly DIFFERENCE: "difference";
-    readonly EXCLUSION: "exclusion";
-    readonly HUE: "hue";
-    readonly SATURATION: "saturation";
-    readonly COLOR: "color";
-    readonly LUMINOSITY: "luminosity";
+    readonly NORMAL: 'normal';
+    readonly MULTIPLY: 'multiply';
+    readonly SCREEN: 'screen';
+    readonly OVERLAY: 'overlay';
+    readonly DARKEN: 'darken';
+    readonly LIGHTEN: 'lighten';
+    readonly COLOR_DODGE: 'color-dodge';
+    readonly COLOR_BURN: 'color-burn';
+    readonly HARD_LIGHT: 'hard-light';
+    readonly SOFT_LIGHT: 'soft-light';
+    readonly DIFFERENCE: 'difference';
+    readonly EXCLUSION: 'exclusion';
+    readonly HUE: 'hue';
+    readonly SATURATION: 'saturation';
+    readonly COLOR: 'color';
+    readonly LUMINOSITY: 'luminosity';
 };
 export type BackgroundBlendMode = BlendModeValue[];
 type BlendModeValue = (typeof MIX_BLEND_MODE)[keyof typeof MIX_BLEND_MODE];

package/dist/types/css/property-descriptors/border-image-width.d.ts

@@ -0,0 +1,36 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+export type BorderImageWidthSide = {
+    kind: 'auto';
+} | {
+    kind: 'length';
+    value: number;
+} | {
+    kind: 'percentage';
+    value: number;
+} | {
+    kind: 'number';
+    value: number;
+};
+/**
+ * border-image-width controls the width of the nine-slice border areas.
+ * `auto` (= the corresponding border width), `number` (multiples of the
+ * border width), lengths and percentages of the border image area are all
+ * resolved against the border widths at render time.
+ */
+export declare const borderImageWidth: IPropertyListDescriptor<{
+    top: BorderImageWidthSide;
+    right: BorderImageWidthSide;
+    bottom: BorderImageWidthSide;
+    left: BorderImageWidthSide;
+}>;
+export interface BorderImageOutset {
+    top: BorderImageWidthSide;
+    right: BorderImageWidthSide;
+    bottom: BorderImageWidthSide;
+    left: BorderImageWidthSide;
+}
+/**
+ * border-image-outset pushes the border image area outside the border box.
+ * Only lengths and numbers (multiples of the border width) are valid here.
+ */
+export declare const borderImageOutset: IPropertyListDescriptor<BorderImageOutset>;

package/dist/types/css/property-descriptors/clip-path.d.ts

@@ -6,7 +6,8 @@ export declare const enum CLIP_PATH_TYPE {
     CIRCLE = 2,
     ELLIPSE = 3,
     POLYGON = 4,
-    PATH = 5
+    PATH = 5,
+    XYWH = 6
 }
 /** Radius keyword or length-percentage for circle/ellipse. */
 export type ShapeRadius = LengthPercentage | 'closest-side' | 'farthest-side';
@@ -58,5 +59,18 @@ export interface PathClipPath {
     type: CLIP_PATH_TYPE.PATH;
     d: string;
 }
-export type ClipPathValue = NoneClipPath | InsetClipPath | CircleClipPath | EllipseClipPath | PolygonClipPath | PathClipPath;
+/**
+ * xywh( <length-percentage>{2} <length-percentage>{2} [ round <'border-radius'> ]? )
+ * A rectangle at (x, y) with the given width and height, from the top-left
+ * corner of the reference box. The optional round clause is parsed but
+ * ignored (same as inset).
+ */
+export interface XywhClipPath {
+    type: CLIP_PATH_TYPE.XYWH;
+    x: LengthPercentage;
+    y: LengthPercentage;
+    width: LengthPercentage;
+    height: LengthPercentage;
+}
+export type ClipPathValue = NoneClipPath | InsetClipPath | CircleClipPath | EllipseClipPath | PolygonClipPath | PathClipPath | XywhClipPath;
 export declare const clipPath: IPropertyValueDescriptor<ClipPathValue>;

package/dist/types/css/property-descriptors/isolation.d.ts

@@ -0,0 +1,6 @@
+import { IPropertyIdentValueDescriptor } from '../property-descriptor';
+export declare const enum ISOLATION {
+    AUTO = 0,
+    ISOLATE = 1
+}
+export declare const isolation: IPropertyIdentValueDescriptor<ISOLATION>;

package/dist/types/css/property-descriptors/mask.d.ts

@@ -0,0 +1,25 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+import { type BackgroundPosition } from './background-position';
+import { type BackgroundRepeat } from './background-repeat';
+import { type BackgroundSize } from './background-size';
+import { ICSSImage } from '../types/image';
+/**
+ * CSS Masking (mask-image / mask-position / mask-repeat / mask-size).
+ *
+ * Value grammars are identical to their background counterparts, so the
+ * background parsers are reused verbatim — including the addImage side
+ * effect that requires `skipCache` on mask-image. -webkit-mask-* aliases
+ * resolve to these properties in computed style.
+ *
+ * mask-mode/mask-clip/mask-origin/mask-composite are accepted by the browser
+ * but not parsed here; rendering assumes the default alpha masking with
+ * `add` layer compositing.
+ */
+export type MaskImage = ICSSImage[];
+export type MaskPosition = BackgroundPosition;
+export type MaskRepeat = BackgroundRepeat;
+export type MaskSize = BackgroundSize;
+export declare const maskImage: IPropertyListDescriptor<MaskImage>;
+export declare const maskPosition: IPropertyListDescriptor<MaskPosition>;
+export declare const maskRepeat: IPropertyListDescriptor<MaskRepeat>;
+export declare const maskSize: IPropertyListDescriptor<MaskSize>;

package/dist/types/css/property-descriptors/mix-blend-mode.d.ts

@@ -1,21 +1,21 @@
 import { IPropertyIdentValueDescriptor } from '../property-descriptor';
 export declare const MIX_BLEND_MODE: {
-    readonly NORMAL: "normal";
-    readonly MULTIPLY: "multiply";
-    readonly SCREEN: "screen";
-    readonly OVERLAY: "overlay";
-    readonly DARKEN: "darken";
-    readonly LIGHTEN: "lighten";
-    readonly COLOR_DODGE: "color-dodge";
-    readonly COLOR_BURN: "color-burn";
-    readonly HARD_LIGHT: "hard-light";
-    readonly SOFT_LIGHT: "soft-light";
-    readonly DIFFERENCE: "difference";
-    readonly EXCLUSION: "exclusion";
-    readonly HUE: "hue";
-    readonly SATURATION: "saturation";
-    readonly COLOR: "color";
-    readonly LUMINOSITY: "luminosity";
+    readonly NORMAL: 'normal';
+    readonly MULTIPLY: 'multiply';
+    readonly SCREEN: 'screen';
+    readonly OVERLAY: 'overlay';
+    readonly DARKEN: 'darken';
+    readonly LIGHTEN: 'lighten';
+    readonly COLOR_DODGE: 'color-dodge';
+    readonly COLOR_BURN: 'color-burn';
+    readonly HARD_LIGHT: 'hard-light';
+    readonly SOFT_LIGHT: 'soft-light';
+    readonly DIFFERENCE: 'difference';
+    readonly EXCLUSION: 'exclusion';
+    readonly HUE: 'hue';
+    readonly SATURATION: 'saturation';
+    readonly COLOR: 'color';
+    readonly LUMINOSITY: 'luminosity';
 };
 export type MixBlendMode = (typeof MIX_BLEND_MODE)[keyof typeof MIX_BLEND_MODE];
 export declare const mixBlendMode: IPropertyIdentValueDescriptor<MixBlendMode>;

package/dist/types/css/property-descriptors/outline.d.ts

@@ -0,0 +1,15 @@
+import { IPropertyValueDescriptor, IPropertyIdentValueDescriptor } from '../property-descriptor';
+import { type Color } from '../types/color';
+export declare const enum OUTLINE_STYLE {
+    NONE = 0,
+    AUTO = 1,
+    SOLID = 2,
+    DASHED = 3,
+    DOTTED = 4,
+    DOUBLE = 5
+}
+export type OutlineColor = Color | null;
+export declare const outlineStyle: IPropertyIdentValueDescriptor<OUTLINE_STYLE>;
+export declare const outlineColor: IPropertyValueDescriptor<OutlineColor>;
+export declare const outlineWidth: IPropertyValueDescriptor<number>;
+export declare const outlineOffset: IPropertyValueDescriptor<number>;

package/dist/types/css/property-descriptors/text-emphasis.d.ts

@@ -0,0 +1,22 @@
+import { IPropertyListDescriptor, IPropertyValueDescriptor } from '../property-descriptor';
+import { type Color } from '../types/color';
+export type TextEmphasisShape = 'dot' | 'circle' | 'double-circle' | 'triangle' | 'sesame';
+/**
+ * `null` — `none`. A string — custom mark character(s). Otherwise the keyword
+ * pair resolved from the computed value (e.g. "filled circle").
+ */
+export type TextEmphasisStyle = {
+    fill: boolean;
+    shape: TextEmphasisShape;
+} | string | null;
+export declare const textEmphasisStyle: IPropertyListDescriptor<TextEmphasisStyle>;
+/** `null` = currentcolor; the renderer falls back to the text colour. */
+export type TextEmphasisColor = Color | null;
+export declare const textEmphasisColor: IPropertyValueDescriptor<TextEmphasisColor>;
+export interface TextEmphasisPosition {
+    /** Marks above the text (over) or below (under). */
+    over: boolean;
+    /** Vertical-writing side for horizontal default; kept for completeness. */
+    right: boolean;
+}
+export declare const textEmphasisPosition: IPropertyListDescriptor<TextEmphasisPosition>;

package/dist/types/css/property-descriptors/text-shadow.d.ts

@@ -1,5 +1,5 @@
 import { IPropertyListDescriptor } from '../property-descriptor';
-import { Color } from '../types/color';
+import { type Color } from '../types/color';
 import { Length } from '../types/length';
 export type TextShadow = TextShadowItem[];
 interface TextShadowItem {

package/dist/types/css/property-descriptors/webkit-box-reflect.d.ts

@@ -0,0 +1,19 @@
+import { IPropertyListDescriptor } from '../property-descriptor';
+import { ICSSImage } from '../types/image';
+export type BoxReflectDirection = 'below' | 'above' | 'left' | 'right';
+export interface BoxReflect {
+    direction: BoxReflectDirection;
+    /** Gap between the element and its reflection, in pixels. */
+    offset: number;
+    /** Optional mask applied to the reflection (element coordinate space). */
+    mask: ICSSImage | null;
+}
+export type BoxReflectValue = BoxReflect | null;
+/**
+ * -webkit-box-reflect: <direction> <offset>? <mask-image>?
+ *
+ * Chrome serialises the computed value with the mask's border-image
+ * bookkeeping appended (e.g. "... linear-gradient(...) 0 fill / auto /
+ * 0 stretch"), so tokens after the image are parsed and ignored.
+ */
+export declare const webkitBoxReflect: IPropertyListDescriptor<BoxReflectValue>;

package/dist/types/css/property-descriptors/webkit-text-fill-color.d.ts

@@ -0,0 +1,9 @@
+import { IPropertyValueDescriptor } from '../property-descriptor';
+import { type Color } from '../types/color';
+/**
+ * `null` represents `currentcolor`: the text renderer falls back to `color`.
+ * Computed styles resolve currentcolor in browsers, but jsdom and older
+ * engines may hand us the keyword verbatim.
+ */
+export type WebkitTextFillColor = Color | null;
+export declare const webkitTextFillColor: IPropertyValueDescriptor<WebkitTextFillColor>;

package/dist/types/css/syntax/token-constants.d.ts

@@ -19,7 +19,7 @@ declare const GREATER_THAN_SIGN = 62;
 declare const COMMERCIAL_AT = 64;
 declare const LEFT_SQUARE_BRACKET = 91;
 declare const RIGHT_SQUARE_BRACKET = 93;
-declare const CIRCUMFLEX_ACCENT = 61;
+declare const CIRCUMFLEX_ACCENT = 94;
 declare const LEFT_CURLY_BRACKET = 123;
 declare const QUESTION_MARK = 63;
 declare const RIGHT_CURLY_BRACKET = 125;

package/dist/types/css/types/color-math.d.ts

@@ -6,7 +6,13 @@
  * Clamp a value between min and max
  */
 export declare const clamp: (value: number, min: number, max: number) => number;
+/** An RGB triple. */
+export type RGB3 = [number, number, number];
+/** An RGBA color as separate components. */
+export type RGBA4 = [number, number, number, number];
+/** A 3x3 matrix stored row-major as nine numbers. */
+export type Matrix3x3 = [number, number, number, number, number, number, number, number, number];
 /**
  * Multiply two 3x3 matrices
  */
-export declare const multiplyMatrices: (A: number[], B: number[]) => [number, number, number];
+export declare const multiplyMatrices: (A: Matrix3x3, B: RGB3) => RGB3;

package/dist/types/css/types/color-spaces/a98.d.ts

@@ -1,6 +1,7 @@
 /**
  * A98-RGB related functions
  */
+import { RGBA4 } from '../color-math';
 /**
  * Convert XYZ to a98 linear
  *
@@ -36,4 +37,4 @@ export declare const a98FromXYZ: (args: [number, number, number, number]) => [nu
  *
  * @param args
  */
-export declare const convertA98rgb: (args: number[]) => number;
+export declare const convertA98rgb: (args: RGBA4) => number;

package/dist/types/css/types/color-spaces/p3.d.ts

@@ -1,6 +1,7 @@
 /**
  * Display-P3 related functions
  */
+import { RGB3, RGBA4 } from '../color-math';
 /**
  * Convert P3 Linear to xyz
  *
@@ -18,19 +19,19 @@ export declare const xyzToP3Linear: (xyz: [number, number, number]) => [number,
  *
  * @param p3
  */
-export declare const p32p3Linear: (p3: [number, number, number]) => number[];
+export declare const p32p3Linear: (p3: RGB3) => RGB3;
 /**
  * Convert P3 Linear to P3
  *
  * @param p3l
  */
-export declare const p3Linear2p3: (p3l: [number, number, number]) => number[];
+export declare const p3Linear2p3: (p3l: RGB3) => RGB3;
 /**
  * Convert P3 to XYZ
  *
  * @param args
  */
-export declare const p3ToXYZ: (args: number[]) => number[];
+export declare const p3ToXYZ: (args: RGB3) => RGB3;
 /**
  * Convert XYZ to P3
  *
@@ -42,4 +43,4 @@ export declare const p3FromXYZ: (args: [number, number, number, number]) => [num
  *
  * @param args
  */
-export declare const convertP3: (args: number[]) => number;
+export declare const convertP3: (args: RGBA4) => number;