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

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>;
@@ -12,9 +14,10 @@ interface SVGPreservedDataCollectors {
  */
 export declare function convertSVGToIR(source: SVGSource, options?: ConvertOptions): ConvertResult;
 export type SplitSVGOptions = ConvertOptions;
-export interface SplitSVGResult extends ConvertResult {
+export interface SVGConversionContext extends ConvertResult {
     preservedData: SVGPreservedData;
 }
+export type SplitSVGResult = SVGConversionContext;
 /** Convert SVG to IR and retain the GE-side data needed for source-specific lowering. */
 export declare function splitSVG(source: SVGSource, options?: SplitSVGOptions): SplitSVGResult;
 export declare function parseSVGToIRWithPreservedData(source: SVGSource, options?: ConvertOptions, collectors?: SVGPreservedDataCollectors): ConvertResult;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vvfx/svg2ir",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.12",
   "description": "SVG to Animation IR and Galacean Effects conversion engine",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
@@ -21,11 +21,11 @@
     }
   },
   "dependencies": {
-    "@galacean/effects-specification": "2.7.2",
+    "@galacean/effects-specification": "2.8.1",
     "@svgdotjs/svg.js": "3.2.7",
     "svgdom": "0.1.14",
-    "@vvfx/animation-ir": "0.0.1-beta.11",
-    "@vvfx/ge-ir": "0.0.1-beta.11"
+    "@vvfx/ge-ir": "0.0.1-beta.12",
+    "@vvfx/animation-ir": "0.0.1-beta.12"
   },
   "contributors": [
     {
@@ -51,7 +51,7 @@
     "converter"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "scripts": {
     "prebuild": "pnpm clean",

package/dist/convert.d.ts

@@ -1,19 +0,0 @@
-import type { ConvertOptions, SVGSource } from './common/types';
-import type { SVGPreservedData } from './svg-preserved-data';
-import type { SVGImageResourceLoader, SVGToLayersResult } from './svg2layers-adapter/types';
-import type { SVGToGEOptions, SVGToGEResult } from './svg2ge-adapter/types';
-export interface SVGConversionOptions extends ConvertOptions {
-    outputFormat?: 'ge' | 'layers';
-    fonts?: SVGToGEOptions['fonts'];
-    /** layers 图片读取回调；默认使用 fetch，已有 data URL 无需读取。 */
-    loadImage?: SVGImageResourceLoader;
-}
-export interface SVGToLayersOptions extends SVGConversionOptions {
-    outputFormat: 'layers';
-}
-/** SVG 多格式输出入口，默认返回 GE 场景。 */
-export declare function convertSVG(source: SVGSource, options: SVGToLayersOptions, preservedData?: SVGPreservedData): Promise<SVGToLayersResult>;
-export declare function convertSVG(source: SVGSource, options?: SVGToGEOptions & {
-    outputFormat?: 'ge';
-}, preservedData?: SVGPreservedData): SVGToGEResult;
-export declare function convertSVG(source: SVGSource, options?: SVGConversionOptions, preservedData?: SVGPreservedData): SVGToGEResult | Promise<SVGToLayersResult>;

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

@@ -1,5 +0,0 @@
-import type { SVGSource } from '../common/types';
-import type { SVGPreservedData } from '../svg-preserved-data';
-import type { SVGToGEOptions, SVGToGEResult } from './types';
-/** SVG→GE 显式入口。传入 preservedData 时应用 SVG 专属后处理。 */
-export declare function convertSVGToGE(source: SVGSource, options?: SVGToGEOptions, preservedData?: SVGPreservedData): SVGToGEResult;

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

@@ -1,8 +0,0 @@
-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): {
-    size: [number, number];
-    data: SVGStaticLayer[];
-};

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

@@ -1,4 +0,0 @@
-import type { ConvertOptions, 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>;