@weasel-js/svg 1.9.3 → 1.9.4

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Mat3 } from '@weasel-js/geom';
-import { Path, FillStyle, ScreenLength, StrokeAlign, MarkerRef, StyledRun, TextStyle, TextVerticalAlign, Stroke, MarkerEntry, RenderNeeds, TilePatternSpec, ImageNodeData, IngestCtx } from '@weasel-js/core';
+import { Path, FillStyle, ScreenLength, StrokeAlign, MarkerRef, StyledRun, TextStyle, TextVerticalAlign, Stroke, PoseLinear, MarkerEntry, RenderNeeds, TilePatternSpec, ImageNodeData, IngestCtx } from '@weasel-js/core';
 
 /**
  * Media Queries 4 evaluation against a fixed environment.
@@ -235,6 +235,11 @@ interface SvgTextNode {
      *  AABB center `(x + width/2, y + height/2)`. Emitted as SVG
      *  `transform="rotate(angleDegrees cx cy)"`. */
     rotation?: number;
+    /** The skew or per-axis scale the box, `rotation`, and flips cannot hold,
+     *  applied about the box center inside the rotation; see `PoseLinear`.
+     *  With one, the element is written with its whole frame as a
+     *  `transform="matrix(...)"`. */
+    transform?: PoseLinear;
     /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
     meta?: NamespaceMeta;
 }
@@ -279,6 +284,11 @@ interface SvgImageNode {
      *  AABB center `(x + width/2, y + height/2)`. Emitted as SVG
      *  `transform="rotate(angleDegrees cx cy)"`. */
     rotation?: number;
+    /** The skew or per-axis scale the box, `rotation`, and flips cannot hold,
+     *  applied about the box center inside the rotation; see `PoseLinear`.
+     *  With one, the element is written with its whole frame as a
+     *  `transform="matrix(...)"`. */
+    transform?: PoseLinear;
     /** Opaque per-element bag for declared namespaces. See `NamespaceMeta`. */
     meta?: NamespaceMeta;
 }
@@ -321,9 +331,9 @@ interface ParseResult {
         width: number;
         height: number;
     };
-    /** Root `width` attribute, parsed as a unitless number when present. */
+    /** Root `width` attribute in user units when present, an absolute CSS unit converted at 96 per inch. */
     width?: number;
-    /** Root `height` attribute, parsed as a unitless number when present. */
+    /** Root `height` attribute in user units when present, converted as `width` is. */
     height?: number;
     /** Text content of the first `<title>` child of `<svg>`, when present. */
     title?: string;
@@ -473,6 +483,7 @@ declare function tilePreviewCssUrl(spec: TilePatternSpec, background?: string):
  * honor the declaration ({@link isDeclarationHonored}), not whether a browser
  * could parse it — the answer decides whether the guarded rules apply here.
  */
+/** Options for evaluating a `@supports` condition. */
 interface SupportsOptions {
     /** Answers `selector(…)`; without it every selector test is false. */
     readonly selector?: (selector: string) => boolean;
@@ -500,6 +511,8 @@ interface SvgKitPose {
     width: number;
     height: number;
     rotation?: number;
+    /** Read for text and image leaves only; a path leaf's is not written. */
+    transform?: PoseLinear;
 }
 /** The leaf data the kit's path, text and image painters read — what
  *  `svgNodesToKitDrafts` writes. */
@@ -574,6 +587,7 @@ interface SvgDraftBounds {
 }
 type DraftPose = SvgDraftBounds & {
     rotation?: number;
+    transform?: PoseLinear;
 };
 /**
  * One node the unpack wants the scene to materialize, in parent-before-child