@vvfx/svg2ir 0.0.1-beta.0 → 0.0.1-beta.11

package/dist/parse-svg/build-element-tree-path.d.ts

@@ -0,0 +1,2 @@
+/** Structural source identity, independent of optional or duplicate SVG IDs. */
+export declare function buildElementTreePath(element: Element): string;

package/dist/svg-rasterizer/prepare-snapshot.d.ts

@@ -0,0 +1,9 @@
+export interface SVGSnapshotContext {
+    root: Element;
+    target: Element;
+    elements: readonly Element[];
+    dependencies: ReadonlySet<Element>;
+    readStyle: (element: Element) => CSSStyleDeclaration;
+}
+/** Preserve selector context until styles are frozen, then isolate the requested paint subtree. */
+export declare function prepareSVGSnapshot(source: string, path: string, size: [number, number], inspect?: (context: SVGSnapshotContext) => void): string;

package/dist/svg-rasterizer/rasterize-svg.d.ts

@@ -0,0 +1,11 @@
+import { type SVGSnapshotContext } from './prepare-snapshot';
+interface RasterizedSVG {
+    url: string;
+    /** Logical viewport pixels, independent of raster resolution. */
+    bbox: [number, number, number, number];
+}
+/** Render an SVG subtree as a cropped PNG, or return null if it has no visible pixels. */
+export declare function rasterizeSVG(source: string, path: string, size: [number, number], scale?: number, inspect?: (context: SVGSnapshotContext) => void): Promise<RasterizedSVG | null>;
+/** No DOM access at module initialization: the Node entry also imports this module. */
+export declare function canRasterizeSVG(): boolean;
+export {};

package/dist/svg2ir/assemble.d.ts

@@ -1,7 +1,9 @@
 import { type IRScene } from '@vvfx/animation-ir';
-import type { ConvertOptions } from '../common/types';
+import type { ConvertOptions, SVG2IRWarning } from '../common/types';
 import type { SVGPreservedPaintAnimation, SVGPreservedShapeAnimation, SVGPreservedTextData } from '../svg-preserved-data';
 export interface ParseSVGToIROptions extends ConvertOptions {
+    layerSourceCollector?: Map<string, string>;
+    warningSourceCollector?: Map<SVG2IRWarning, string>;
     textDataCollector?: Map<string, SVGPreservedTextData>;
     paintAnimationsCollector?: Map<string, SVGPreservedPaintAnimation[]>;
     shapeAnimationCollector?: Map<string, SVGPreservedShapeAnimation>;

package/dist/svg2ir/convert.d.ts

@@ -1,6 +1,8 @@
-import type { ConvertOptions, ConvertResult, SVGSource } from '../common/types';
+import type { ConvertOptions, ConvertResult, SVG2IRWarning, SVGSource } from '../common/types';
 import type { SVGPreservedData, SVGPreservedPaintAnimation, SVGPreservedShapeAnimation, SVGPreservedTextData } from '../svg-preserved-data';
 interface SVGPreservedDataCollectors {
+    layerSourceCollector?: Map<string, string>;
+    warningSourceCollector?: Map<SVG2IRWarning, string>;
     textDataByLayerId: Map<string, SVGPreservedTextData>;
     paintAnimationsByLayerId: Map<string, SVGPreservedPaintAnimation[]>;
     shapeAnimationsByLayerId: Map<string, SVGPreservedShapeAnimation>;

package/dist/svg2ir/converter/layers/conversion-session.d.ts

@@ -5,6 +5,8 @@ import type { SVG2IRWarning } from '../../../common/types';
 import type { SVGPreservedPaintAnimation, SVGPreservedShapeAnimation, SVGPreservedTextData } from '../../../svg-preserved-data';
 /** 构造 layer 转换会话所需的输入。 */
 export interface SVGLayerBuildOptions {
+    layerSourceCollector?: Map<string, string>;
+    warningSourceCollector?: Map<SVG2IRWarning, string>;
     frameRate: number;
     durationSeconds: number;
     emit: (warning: SVG2IRWarning) => void;

package/dist/svg2ir/converter/text/font-metrics.d.ts

@@ -44,6 +44,8 @@ export declare function greedySpaceForDx(target: number, table: Array<{
     ch: string;
     w: number;
 }>): string;
+/** 去除单个字体族名的 CSS 字符串引号。 */
+export declare function normalizeFontFamilyName(fontFamily: string): string;
 /** 构造与 Effects Runtime getFontDesc 一致的 CSS font 简写字符串,用于 Canvas measureText。 */
 export declare function buildCanvasFontDesc(fontSize: number, fontFamily: string, fontWeight: IRFontWeight, fontStyle: string): string;
 /** 文本宽度估算。优先使用调用方提供的 Canvas measureText，否则使用字符级启发式系数。 */

package/dist/svg2layers-adapter/assemble.d.ts

@@ -1,8 +1,21 @@
 import type { IRScene } from '@vvfx/animation-ir';
 import { type ConvertOptions, type SVG2IRWarning } from '../common/types';
 import type { SVGPreservedData } from '../svg-preserved-data';
-import type { SVGStaticLayer } from './types';
-export declare function assembleSVGStaticLayers(scene: IRScene, options: ConvertOptions, warnings: SVG2IRWarning[], preservedData?: SVGPreservedData): {
+import type { BakedLayersResult } from './baking/build-baked-layers';
+import type { SVGStaticLayer, SVGToLayersResult } from './types';
+export declare function assembleSVGStaticLayers(scene: IRScene, options: ConvertOptions, warnings: SVG2IRWarning[], preservedData?: SVGPreservedData, sourceIds?: Map<SVGStaticLayer, string>): {
     size: [number, number];
     data: SVGStaticLayer[];
 };
+interface SVGLayerAssemblyInput {
+    scene: IRScene;
+    options: ConvertOptions;
+    warnings: SVG2IRWarning[];
+    preservedData: SVGPreservedData;
+    layerSources: ReadonlyMap<string, string>;
+    warningSources: ReadonlyMap<SVG2IRWarning, string>;
+    baking: BakedLayersResult;
+}
+/** Replace baked sources, combine native and raster layers in painter order, then report final diagnostics. */
+export declare function assembleSVGLayers(input: SVGLayerAssemblyInput): SVGToLayersResult;
+export {};

package/dist/svg2layers-adapter/baking/build-baked-layers.d.ts

@@ -0,0 +1,13 @@
+import { type ConvertOptions, type SVG2IRWarning } from '../../common/types';
+import type { SVGImageLayer } from '../types';
+export interface BakedLayersResult {
+    layers: Array<{
+        path: string;
+        layer: SVGImageLayer;
+    }>;
+    warnings: SVG2IRWarning[];
+    replacesSource: (path: string | undefined) => boolean;
+    resolvesWarning: (warning: SVG2IRWarning, path: string | undefined) => boolean;
+}
+/** Rasterize graphics and track the source layers and warnings they replace. */
+export declare function buildBakedLayers(source: string, size: [number, number], options: ConvertOptions, rasterScale: number): Promise<BakedLayersResult>;

package/dist/svg2layers-adapter/baking/normalize-layer-blending.d.ts

@@ -0,0 +1,10 @@
+interface BlendDowngrade {
+    mode: string;
+    selector: string;
+}
+/** Replace non-normal mix-blend-mode declarations with normal and report each downgrade. */
+export declare function normalizeLayerBlending(source: string): {
+    source: string;
+    downgrades: BlendDowngrade[];
+};
+export {};

package/dist/svg2layers-adapter/baking/plan-graphic-baking.d.ts

@@ -0,0 +1,18 @@
+import type { SVGSnapshotContext } from '../../svg-rasterizer/prepare-snapshot';
+interface GraphicBakeScope {
+    path: string;
+    selector: string;
+    isGroup: boolean;
+}
+interface GraphicBakingPlan {
+    scopes: GraphicBakeScope[];
+    warnings: Array<{
+        message: string;
+        selector: string;
+    }>;
+}
+/** Select graphic-only subtrees; keep native text and images as separate layers. */
+export declare function planGraphicBaking(source: string): GraphicBakingPlan;
+/** Reject text/image dependencies and effects that cannot be rendered independently. */
+export declare function validateGraphicSnapshot(context: SVGSnapshotContext): void;
+export {};

package/dist/svg2layers-adapter/baking/resolve-baking-warnings.d.ts

@@ -0,0 +1,4 @@
+/** Mask and clipPath definitions do not produce visible layers. */
+export declare function collectNonRenderingDeclarationPaths(source: string): Set<string>;
+/** A stylesheet diagnostic is resolved only when every element it can affect was baked. */
+export declare function collectBakedStylesheetPaths(source: string, isBaked: (path: string) => boolean): Set<string>;

package/dist/svg2layers-adapter/convert.d.ts

@@ -1,4 +1,4 @@
-import type { ConvertOptions, SVGSource } from '../common/types';
+import { type ConvertOptions, type SVGSource } from '../common/types';
 import type { SVGPreservedData } from '../svg-preserved-data';
 import type { SVGImageResourceLoader, SVGToLayersResult } from './types';
-export declare function convertSVGToLayers(source: SVGSource, options: ConvertOptions, loadImage?: SVGImageResourceLoader, preservedData?: SVGPreservedData): Promise<SVGToLayersResult>;
+export declare function convertSVGToLayers(source: SVGSource, options: ConvertOptions, loadImage?: SVGImageResourceLoader, preservedData?: SVGPreservedData, rasterScale?: number): Promise<SVGToLayersResult>;

package/dist/svg2layers-adapter/converter/image/inspect-mask.d.ts

@@ -0,0 +1,3 @@
+import type { IRLocalBounds, IRMask } from '@vvfx/animation-ir';
+/** 完全覆盖图片的直边矩形 mask 不改变可见内容。 */
+export declare function maskCoversImage(mask: IRMask, bounds: IRLocalBounds): boolean;

package/dist/svg2layers-adapter/converter/layers/build-layers.d.ts

@@ -1,3 +1,3 @@
 import type { SVGStaticLayer } from '../../types';
 import type { LayerConversionSession } from './conversion-session';
-export declare function buildIRStaticLayers(session: LayerConversionSession): SVGStaticLayer[];
+export declare function buildIRStaticLayers(session: LayerConversionSession, sourceIds?: Map<SVGStaticLayer, string>): SVGStaticLayer[];

package/dist/svg2layers-adapter/strip-layer-animation.d.ts

@@ -0,0 +1,5 @@
+/** Static layers cannot sample animation; drop SMIL nodes so elements keep their authored state. */
+export declare function stripLayerAnimation(source: string): {
+    source: string;
+    removed: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vvfx/svg2ir",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.11",
   "description": "SVG to Animation IR and Galacean Effects conversion engine",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",