@vvfx/ge-ir 0.0.1-beat.2 → 0.0.1-beta.11

package/dist/preserved-data.d.ts

@@ -0,0 +1,66 @@
+import type { IRColor, IRScene } from '@vvfx/animation-ir';
+import { EndBehavior } from '@galacean/effects-specification';
+export declare const GE_PRESERVED_DATA_VERSION = "1.0.0";
+export type EffectsSpriteSplit = [sourceX: number, sourceY: number, width: number, height: number, flip: 0 | 1];
+export interface EffectsTextureSheetAnimation {
+    row: number;
+    col: number;
+    total?: number;
+    animate: boolean;
+    loop?: boolean;
+}
+export type EffectsTextSizeMode = 'auto-width' | 'auto-height' | 'fixed';
+export type GEParticleAuthoringBounds = [x: number, y: number, width: number, height: number];
+interface GEParticleEffectGroupSourceData {
+    id: string;
+    irCompositionId: string;
+    sourcePreviewSize: [width: number, height: number];
+    authoringBounds: GEParticleAuthoringBounds;
+}
+export interface GEParticleSourceLayerData {
+    effectGroupId: string;
+    irCompositionId: string;
+    irLayerId: string;
+    sourceOrder: number;
+}
+export interface GEParticleSourceData {
+    particleEffectGroups: GEParticleEffectGroupSourceData[];
+    layers: GEParticleSourceLayerData[];
+}
+/** GE Layer payloads that normalized Animation IR cannot represent losslessly. */
+export interface EffectsLayerPreservedData {
+    positionOverLifetime?: Record<string, unknown>;
+    rotationOverLifetime?: Record<string, unknown>;
+    sizeOverLifetime?: Record<string, unknown>;
+    colorOverLifetime?: Record<string, unknown>;
+    spriteStartColor?: IRColor;
+    spriteSplits?: EffectsSpriteSplit[];
+    textureSheetAnimation?: EffectsTextureSheetAnimation;
+    textSizeMode?: EffectsTextSizeMode;
+    sourceItemIds?: string[];
+    itemAnchorById?: Record<string, [x: number, y: number]>;
+    itemEulerHintById?: Record<string, [x: number, y: number, z: number]>;
+    sourceComponentId?: string;
+    mask?: Record<string, unknown>;
+    precompContent?: Record<string, unknown>;
+    /** GE ParticleSystem payload excluding identity and generic mask fields; normalized IR fields override it on export. */
+    particleContent?: Record<string, unknown>;
+    /** Activation clip behavior retained independently from the normalized GE Item behavior. */
+    timelineEndBehavior?: EndBehavior;
+    sourceHierarchy?: 'single-item' | 'null-sprite-pair';
+}
+export interface GECompositionSourceBinding {
+    sourceCompositionId: string;
+    sourceItemOrder: string[];
+    layerDataById: Record<string, EffectsLayerPreservedData>;
+}
+/** GE-owned data retained outside the source-neutral Animation IR contract. */
+export interface GEToIRPreservedData {
+    version: typeof GE_PRESERVED_DATA_VERSION;
+    sourceScene?: Record<string, unknown>;
+    compositionBindings: Record<string, GECompositionSourceBinding>;
+    particleSourceData: GEParticleSourceData;
+}
+/** Reject preserved data whose version or Composition bindings do not match the supplied IR Scene. */
+export declare function assertGEToIRPreservedDataMatchesScene(scene: IRScene, preservedData: GEToIRPreservedData): void;
+export {};

package/dist/update-preserved-data.d.ts

@@ -0,0 +1,12 @@
+import type { IRScene } from '@vvfx/animation-ir';
+import { type GEToIRPreservedData } from './preserved-data';
+export interface GEToIRPreservedDataChange {
+    compositionId: string;
+    layerId: string;
+    field: string;
+}
+export interface UpdateGEToIRPreservedDataOptions {
+    onChange?: (change: GEToIRPreservedDataChange) => void;
+}
+/** Update a cloned GE preservation bundle to match edits made to normalized Animation IR. */
+export declare function updateGEToIRPreservedData(baselineScene: IRScene, updatedScene: IRScene, preservedData: GEToIRPreservedData, options?: UpdateGEToIRPreservedDataOptions): GEToIRPreservedData;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vvfx/ge-ir",
-  "version": "0.0.1-beat.2",
-  "description": "Galacean Effects and animation IR bidirectional conversion package",
+  "version": "0.0.1-beta.11",
+  "description": "Bidirectional Galacean Effects and Animation IR conversion with GE fidelity preservation",
   "module": "./dist/index.mjs",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,9 +16,9 @@
     }
   },
   "dependencies": {
-    "@galacean/effects-specification": "^2.8.0",
+    "@galacean/effects-specification": "2.7.2",
     "uuid": "^13.0.0",
-    "@vvfx/animation-ir": "0.0.1-beat.2"
+    "@vvfx/animation-ir": "0.0.1-beta.11"
   },
   "contributors": [
     {
@@ -31,6 +31,21 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "repository": "https://github.com/galacean/design-bridge",
+  "bugs": {
+    "url": "https://github.com/galacean/design-bridge/issues"
+  },
+  "homepage": "https://github.com/galacean/design-bridge/tree/main/packages/ge-ir#readme",
+  "keywords": [
+    "animation",
+    "animation-ir",
+    "galacean-effects",
+    "jsonscene",
+    "converter"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
     "prebuild": "pnpm clean",
     "build": "pnpm build:declaration && pnpm build:module",

package/dist/ge2ir/converter.d.ts

@@ -1,3 +0,0 @@
-import type { IRComposition } from '@vvfx/animation-ir';
-import type { GE2IROptions } from './types';
-export declare function convertGEToIR(scene: Record<string, unknown>, options: GE2IROptions): IRComposition;

package/dist/ge2ir/index.d.ts

@@ -1,2 +0,0 @@
-export { convertGEToIR } from './converter';
-export type { GE2IROptions } from './types';

package/dist/ge2ir/parsers/component-parser.d.ts

@@ -1,16 +0,0 @@
-import type { IRAssetReference, IRBlendMode, IRColor, IRShapeData, IRTextData } from '@vvfx/animation-ir';
-import type { GESceneContext } from '../types';
-export interface ComponentData {
-    type: 'image' | 'solid' | 'text' | 'shape';
-    asset?: IRAssetReference;
-    solidColor?: IRColor;
-    text?: IRTextData;
-    shapes?: IRShapeData[];
-    blendMode?: IRBlendMode;
-    anchorScale?: [number, number];
-    /** Original GE component id — rendezvous key for cross-component references (masks). */
-    geComponentId?: string;
-    /** Raw GE component-level `mask` object (source: {isMask:true,...}, target: {isMask:false,reference,inverted}). */
-    rawMask?: Record<string, unknown>;
-}
-export declare function parseComponent(item: Record<string, unknown>, ctx: GESceneContext): ComponentData | undefined;

package/dist/ge2ir/parsers/transform-parser.d.ts

@@ -1,3 +0,0 @@
-import type { IRTransformChannels } from '@vvfx/animation-ir';
-import type { GESceneContext } from '../types';
-export declare function parseStaticTransform(itemTransform: Record<string, unknown>, ctx: GESceneContext): Partial<IRTransformChannels>;

package/dist/ge2ir/pool/pool.d.ts

@@ -1,4 +0,0 @@
-import type { GEPoolIndex, GERecord } from '../../shared/types';
-export declare function buildPoolIndex(pool: GERecord[] | undefined): GEPoolIndex;
-export declare function resolveDataPath(pool: GEPoolIndex, ref: unknown): GERecord | undefined;
-export declare function resolveDataPathId(ref: unknown): string | undefined;

package/dist/ge2ir/reverse/blend-mode.d.ts

@@ -1,2 +0,0 @@
-import type { IRBlendMode as IRBlendModeType } from '@vvfx/animation-ir';
-export declare function reverseBlendMode(geCode: number | undefined): IRBlendModeType | undefined;

package/dist/ge2ir/reverse/coordinate.d.ts

@@ -1 +0,0 @@
-export declare function convert3dTo2dPoint(x: number, y: number, z: number, width: number, height: number): [number, number, number];

package/dist/ge2ir/reverse/end-behavior.d.ts

@@ -1,3 +0,0 @@
-import type { IREndBehavior as IREndBehaviorType } from '@vvfx/animation-ir';
-export declare function reverseEndBehavior(geBehavior: number | undefined): IREndBehaviorType | undefined;
-export declare function reverseCompositionEndBehavior(geBehavior: number | undefined): IREndBehaviorType | undefined;

package/dist/ge2ir/reverse/timing.d.ts

@@ -1,2 +0,0 @@
-import type { IRTimeContext } from '@vvfx/animation-ir';
-export declare function reverseLayerTiming(delay: number, duration: number, frameRate: number): IRTimeContext;

package/dist/ge2ir/scene-reader.d.ts

@@ -1,3 +0,0 @@
-import type { GE2IROptions, GESceneContext } from './types';
-export declare function buildSceneContext(scene: Record<string, unknown>, options: GE2IROptions): GESceneContext;
-export declare function getCompositionItemIds(scene: Record<string, unknown>): string[];

package/dist/ir2ge/assembly/generator.d.ts

@@ -1,23 +0,0 @@
-/**
- * Unified IR → GE scene generation pipeline. All IR sources (lottie, dsl2ge,
- * future) are processed here. Source-specific features are gated by data
- * existence (e.g. mask, precomp, shape layers are absent in dsl IR and
- * naturally skipped); `ir.source` branches are used only for B-class real
- * semantic differences that cannot be expressed via data existence.
- */
-import type { IRComposition } from '@vvfx/animation-ir';
-import type { JSONScene } from '@galacean/effects-specification';
-/**
- * Convert an IR composition to a GE JSONScene.
- *
- * All IR sources (lottie, dsl2ge, future) go through this single unified
- * pipeline. Source-specific features are gated by data existence (e.g. mask,
- * precomp, shape layers are absent in dsl IR and naturally skipped);
- * `ir.source` branches are used only for B-class real semantic differences
- * that cannot be expressed via data existence.
- *
- * The optional `duration` arg is a caller override; lottie2ge currently passes
- * the duration computed from the raw json upstream. When omitted, the
- * canonical assembler derives it from `(outPoint - inPoint) / frameRate`.
- */
-export declare function convertIRToGE(ir: IRComposition, duration?: number): JSONScene;

package/dist/ir2ge/assembly/scene-assembly.d.ts

@@ -1,11 +0,0 @@
-import { type IRComposition } from '@vvfx/animation-ir';
-import { type JSONScene } from '@galacean/effects-specification';
-import type { ECSCollector, ProcessedItem } from '../types';
-/**
- * Assemble the top-level GE JSONScene wrapper from a populated collector.
- *
- * Reads composition-level properties (`name`, `width`/`height`, `endBehavior`,
- * `backgroundColor`) directly from the IR. The optional `duration` arg is a
- * caller override — when omitted, derived from `(outPoint - inPoint) / frameRate`.
- */
-export declare function assembleScene(ir: IRComposition, collector: ECSCollector, processedItems: ProcessedItem[], duration?: number): JSONScene;

package/dist/ir2ge/builders/animation.d.ts

@@ -1,4 +0,0 @@
-import type { IRComposition, IRLayerNode } from '@vvfx/animation-ir';
-import type { LayerProcessingContext, TransformAnimation } from '../types';
-export declare function buildTransformAnimation(layer: IRLayerNode, ctx: LayerProcessingContext): TransformAnimation;
-export declare function buildColorAnimation(layer: IRLayerNode, ir: IRComposition): Record<string, unknown> | undefined;

package/dist/ir2ge/builders/bezier.d.ts

@@ -1,44 +0,0 @@
-/**
- * Converts IR keyframe-based animation data to GE BezierKeyframeValue format.
- *
- * GE BezierKeyframeValue format per keyframe:
- * - First:  [EASE_OUT(3), [t, v, out_cp_x, out_cp_y]]
- * - Middle: [EASE(1),     [in_cp_x, in_cp_y, t, v, out_cp_x, out_cp_y]]
- * - Last:   [EASE_IN(2),  [in_cp_x, in_cp_y, t, v]]
- *
- * Time is normalized to [0, 1] based on the layer's visible frame range (ip → op).
- */
-import type { IRAnimatedProperty, IRVec3 } from '@vvfx/animation-ir';
-import { type BezierKeyframeValue } from '@galacean/effects-specification';
-export interface IRToGETimeContext {
-    /** Layer visible start frame. */
-    startFrame: number;
-    /** Layer visible end frame. */
-    endFrame: number;
-}
-export interface IRPositionGEResult {
-    /** Timing curves in BezierKeyframeValue format (1D, time-domain only). */
-    curves: BezierKeyframeValue[][];
-    /** Path points per segment: [[start_x, start_y], [end_x, end_y]]. */
-    pathPoints: [[number, number], [number, number]][];
-    /** Spatial control points per segment: [[to_x, to_y], [ti_x, ti_y]]. */
-    controlPoints: [[number, number], [number, number]][];
-}
-/**
- * Convert a 1D animated property (opacity / rotation) to GE BezierKeyframeValue[][].
- * Returns a single-element outer array with the full curve.
- */
-export declare function irScalarKeyframesToGE(property: IRAnimatedProperty<number>, timeContext: IRToGETimeContext): BezierKeyframeValue[][] | undefined;
-/**
- * Convert a multi-dimensional animated property (scale / anchor) to GE BezierKeyframeValue[][].
- * Returns one curve per dimension in the outer array.
- */
-export declare function irVectorKeyframesToGE(property: IRAnimatedProperty<IRVec3>, timeContext: IRToGETimeContext): BezierKeyframeValue[][] | undefined;
-/**
- * Convert position keyframes to GE path animation format (pp/cp + timing curves).
- */
-export declare function irPositionKeyframesToGE(property: IRAnimatedProperty<IRVec3>, timeContext: IRToGETimeContext): IRPositionGEResult | undefined;
-/**
- * Determine if a property has enough keyframes to warrant keyframe mode (pkf/skf/rkf/okf).
- */
-export declare function shouldUseKeyframeMode(property: IRAnimatedProperty): boolean;

package/dist/ir2ge/builders/component.d.ts

@@ -1,13 +0,0 @@
-import type { IRComposition, IRLayerNode, IRShapeData } from '@vvfx/animation-ir';
-import type { LayerProcessingContext } from '../types';
-export declare function buildComponent(layer: IRLayerNode, itemId: string, anchorScaleX: number, anchorScaleY: number, ctx: LayerProcessingContext): string | undefined;
-/**
- * Copy the raw GE mask object (from ge2ir passthrough metadata) onto a freshly
- * built component, as a top-level `mask` field matching GE's structure. For a
- * mask SOURCE this carries `{isMask:true, alphaMaskEnabled}`; for a TARGET it
- * carries `{isMask:false, reference, inverted}` where `reference.id` is still
- * the stale GE1 component id — `applyGeMaskRemap` rewrites it in post-process.
- * No-op for non-ge sources (Lottie masks go through the IRLayerNode.mask path).
- */
-export declare function applyGeMask(ir: IRComposition, layer: IRLayerNode, component: Record<string, unknown>): void;
-export declare function buildShapeOptions(shapeData: IRShapeData, ratio: number, ctx?: LayerProcessingContext): Record<string, unknown>;

package/dist/ir2ge/builders/effects.d.ts

@@ -1,9 +0,0 @@
-import { type IRBlendMode } from '@vvfx/animation-ir';
-import type { DataPath } from '@galacean/effects-specification';
-import type { ECSCollector, GETransform } from '../types';
-export { estimateTextWidth } from '../utils';
-export declare function buildGETransform(position: [number, number, number], eulerHint: [number, number, number], scale: [number, number, number]): GETransform;
-export declare function getGEItemType(type: string): string;
-export declare function getGEItemTypeCode(type: string): string;
-export declare function registerTexture(collector: ECSCollector, imageUrl: string, cache: Map<string, DataPath>): DataPath;
-export declare function mapBlendingMode(blendMode: IRBlendMode | undefined): number | undefined;

package/dist/ir2ge/builders/layer.d.ts

@@ -1,5 +0,0 @@
-import type { IRLayerNode } from '@vvfx/animation-ir';
-import type { LayerProcessingContext } from '../types';
-export declare function processNullLayer(layer: IRLayerNode, ctx: LayerProcessingContext): void;
-export declare function processParentLayer(layer: IRLayerNode, ctx: LayerProcessingContext): void;
-export declare function processVisualLayer(layer: IRLayerNode, ctx: LayerProcessingContext): void;

package/dist/ir2ge/builders/timeline.d.ts

@@ -1,9 +0,0 @@
-import type { ECSCollector, TransformAnimation } from '../types';
-/**
- * Build the ObjectBindingTrack + Activation/Transform/SpriteColor child tracks
- * for one VFX item. Shared by lottie2ge and dsl2ge generators.
- *
- * The SpriteColor track is omitted for null layers (itemType `'null'` or
- * the GE numeric code `'3'`).
- */
-export declare function buildTimelineTracks(collector: ECSCollector, delay: number, duration: number, endBehavior: number, animation: TransformAnimation, itemType: string): string;

package/dist/ir2ge/builders/timing.d.ts

@@ -1,17 +0,0 @@
-import type { IRLayerNode } from '@vvfx/animation-ir';
-/**
- * Map an IR layer's time range to GE delay/duration in seconds, applying
- * the time-stretch and offset semantics from `IRTimeContext`.
- *
- * dsl-source IRs leave `stretch` and `offsetFrame` undefined, in which case
- * this collapses to `delay = startFrame / fr` and
- * `duration = (endFrame - startFrame) / fr` — exactly what dsl2ge used to
- * compute inline.
- *
- * Zero/negative durations are clamped to a 0.0001 epsilon so GE keeps the
- * activation track alive for the (degenerate) layer.
- */
-export declare function computeLayerTiming(layer: IRLayerNode, frameRate: number): {
-    delay: number;
-    layerDuration: number;
-};

package/dist/ir2ge/index.d.ts

@@ -1,14 +0,0 @@
-export { convertIRToGE } from './assembly/generator';
-export type { DataPath, JSONScene } from '@galacean/effects-specification';
-export { readLottieSpecific } from './ir/specific';
-export type { LottieLayerSpecific } from './ir/specific';
-export { isTransformOnlyParentLink } from './ir/parent-link';
-export type { ECSCollector, GEDataPath, GEItem, GEPoolIndex, GERecord, GETransform } from '../shared/types';
-export type { ProcessedItem, TransformAnimation } from './types';
-export { assembleScene } from './assembly/scene-assembly';
-export { estimateTextWidth, roundNumber, lerp, createId, toDataPath } from './utils';
-export { DEFAULT_CLIP_MODE, DEFAULT_CAMERA_FOV, DEFAULT_CAMERA_Z, get2dTo3dRatio, convert2dTo3dPoint, } from '../shared/coordinate';
-export { irScalarKeyframesToGE, irVectorKeyframesToGE, irPositionKeyframesToGE, shouldUseKeyframeMode, } from './builders/bezier';
-export type { IRToGETimeContext, IRPositionGEResult } from './builders/bezier';
-export { buildTimelineTracks } from './builders/timeline';
-export { normalizeChildVisibilityByParentDelays } from './post-process/visibility';

package/dist/ir2ge/ir/anchor-strategy.d.ts

@@ -1,24 +0,0 @@
-import type { IRComposition, IRLayerNode } from '@vvfx/animation-ir';
-/**
- * How the generator should handle a layer's anchor offset.
- *
- * - `inline-anchor` — emit one VFX item with `renderer.anchor` baked into the
- *   GE renderer and `anchorOffset` shifted into `transform.position`. Centered
- *   layers also use this kind with `anchorScale = [0.5, 0.5]` and
- *   `anchorOffset = [0, 0]`.
- * - `split-null-sprite` — emit a null+sprite hierarchy so the transform pivot
- *   sits at the anchor; the sprite carries the visual content and is parented
- *   to the null with an anchor-relative position.
- *
- * The split decision is read from `IRLayerNode.transformSplit` when set by the
- * producer; for lottie IR without that flag the accessor falls back to
- * runtime geometry checks (rotation/scale animation + off-center anchor).
- */
-export type AnchorStrategy = {
-    kind: 'inline-anchor';
-    anchorScale: [number, number];
-    anchorOffset: [number, number];
-} | {
-    kind: 'split-null-sprite';
-};
-export declare function getStaticAnchorBehavior(ir: IRComposition, layer: IRLayerNode): AnchorStrategy;

package/dist/ir2ge/ir/layer-dimensions.d.ts

@@ -1,13 +0,0 @@
-import type { IRLayerNode } from '@vvfx/animation-ir';
-/**
- * Read the producer-baked display size from an IR layer. When the producer
- * did not resolve one, returns `fallback` (defaults to `{ 1, 1 }` — the
- * value every existing call site was using inline).
- */
-export declare function getLayerDisplaySize(layer: IRLayerNode, fallback?: {
-    width: number;
-    height: number;
-}): {
-    width: number;
-    height: number;
-};

package/dist/ir2ge/ir/layer-utils.d.ts

@@ -1,14 +0,0 @@
-import type { IRLayerNode } from '@vvfx/animation-ir';
-import type { IRToGETimeContext } from '../builders/bezier';
-import type { LayerProcessingContext } from '../types';
-export { computeLayerTiming } from '../builders/timing';
-export declare function computeStaticPosition(layer: IRLayerNode, ctx: LayerProcessingContext, anchorOffsetX?: number, anchorOffsetY?: number): [number, number, number];
-export declare function getStaticAnchor(layer: IRLayerNode): [number, number];
-export declare function applyScalePositionAdjust(position: [number, number, number], layer: IRLayerNode, layerWidth: number, layerHeight: number, ratio: number): [number, number, number];
-export declare function computeAnchorInfo(layer: IRLayerNode, layerWidth: number, layerHeight: number): {
-    anchorScaleX: number;
-    anchorScaleY: number;
-    anchorOffsetX: number;
-    anchorOffsetY: number;
-};
-export declare function getTimeContext(layer: IRLayerNode): IRToGETimeContext;

package/dist/ir2ge/ir/parent-link.d.ts

@@ -1,15 +0,0 @@
-import type { IRLayerNode } from '@vvfx/animation-ir';
-/**
- * True when the layer's parent only inherits transform — visibility and
- * lifetime are independent of the parent's window.
- *
- * Reads `IRLayerReference.linkKind` directly. Producers that don't set the
- * field (e.g. dsl2ge) effectively get `false` here, which is the correct
- * default for "full" parent containment.
- *
- * Lottie's parser sets `linkKind: 'transform-only'` when a child's parent
- * relationship comes from `layer.parent` rather than precomp expansion;
- * `applyPostProcess` consumes this to decide whether to advance the parent's
- * activation track when the child starts earlier.
- */
-export declare function isTransformOnlyParentLink(layer: IRLayerNode): boolean;

package/dist/ir2ge/ir/specific.d.ts

@@ -1,14 +0,0 @@
-/**
- * Read-side accessors for the `IRLayerNode.specific.lottie` slot.
- *
- * The shared generator must not branch on lottie semantics directly — every
- * lottie-specific read goes through these helpers so the rest of `ir2ge` stays
- * agnostic to the producing tool.
- *
- * `isTransformOnlyParentLink` used to live here, reading
- * `specific.lottie.explicitParent`. It was promoted to a generic IR field
- * (`IRLayerReference.linkKind`); the accessor now lives at `./parent-link.ts`.
- */
-import type { IRLayerNode, LottieLayerSpecific } from '@vvfx/animation-ir';
-export type { LottieLayerSpecific };
-export declare function readLottieSpecific(layer: IRLayerNode): LottieLayerSpecific | undefined;

package/dist/ir2ge/post-process/index.d.ts

@@ -1,31 +0,0 @@
-import type { IRComposition } from '@vvfx/animation-ir';
-import type { ECSCollector, ProcessedItem } from '../types';
-import { type MaskLayerLookup } from './mask';
-export type { MaskLayerLookup } from './mask';
-/**
- * Post-emit state populated by the unified pipeline's per-layer walk.
- * All fields beyond `collector` + `processedItems` are optional — each
- * post-process step is gated on the presence of the data it needs, not
- * on `ir.source`. Steps that only apply to certain sources naturally
- * no-op when the relevant data is absent (e.g. dsl IR has no masks).
- */
-export interface PostProcessState {
-    collector: ECSCollector;
-    processedItems: ProcessedItem[];
-    /** Per-layer lookups consumed by the shared mask post-process. */
-    maskLookup?: MaskLayerLookup;
-    layerToItemId?: Record<number, string>;
-    parentIndexSet?: Set<number>;
-    ratio?: number;
-    width?: number;
-    height?: number;
-    frameRate?: number;
-    /** GE1→GE2 component-id map for remapping ge2ir mask passthrough references. */
-    geComponentIdToNewId?: Record<string, string>;
-}
-/**
- * Run post-emit mutations on the collector before `assembleScene`.
- * Order: parenting → mask → visibility. Each step is gated on whether
- * the pipeline supplied the required tracking state.
- */
-export declare function applyPostProcess(ir: IRComposition, state: PostProcessState): void;

package/dist/ir2ge/utils.d.ts

@@ -1,14 +0,0 @@
-import type { DataPath } from '@galacean/effects-specification';
-/** Generate a 32-char hex GE entity id (UUID v4 with dashes stripped). */
-export declare function createId(): string;
-/** Wrap an id into a `{ id }` GE DataPath reference. */
-export declare function toDataPath(id: string): DataPath;
-/** Round a number to the given decimal precision (default 4). */
-export declare function roundNumber(value: number, precision?: number): number;
-/** Linear interpolation between `a` and `b` by `factor` ∈ [0, 1]. */
-export declare function lerp(a: number, b: number, factor: number): number;
-/**
- * Rough text width estimate used when the IR layer does not record a
- * measured width. Average character width ≈ 0.6 × fontSize.
- */
-export declare function estimateTextWidth(text: string, fontSize: number, letterSpacing?: number): number;

package/dist/shared/coordinate.d.ts

@@ -1,11 +0,0 @@
-export declare const DEFAULT_CAMERA_Z = 8;
-export declare const DEFAULT_CAMERA_FOV = 60;
-export declare const DEFAULT_CLIP_MODE = 1;
-/** 2D pixel space -> GE 3D world unit ratio for a given canvas size. */
-export declare function get2dTo3dRatio(width: number, height: number): number;
-/**
- * Convert a 2D point in canvas pixel space (origin top-left) to a GE 3D world
- * point (origin centered, Y flipped). The `z` parameter applies the GE camera
- * adapter to stay perspective-correct for non-zero Z layers.
- */
-export declare function convert2dTo3dPoint(x: number, y: number, z: number, width: number, height: number): [number, number, number];

package/dist/shared/ge2ir-metadata.d.ts

@@ -1,17 +0,0 @@
-import type { IRComposition, IRLayerNode } from '@vvfx/animation-ir';
-/**
- * Round-trip passthrough contract written by ge2ir and consumed by ir2ge.
- *
- * Supported keys:
- * positionOverLifetime, rotationOverLifetime, sizeOverLifetime,
- * colorOverLifetime, geComponentId, geMask.
- */
-export interface GE2IRPassthroughMetadata {
-    positionOverLifetime?: Record<string, unknown>;
-    rotationOverLifetime?: Record<string, unknown>;
-    sizeOverLifetime?: Record<string, unknown>;
-    colorOverLifetime?: Record<string, unknown>;
-    geComponentId?: string;
-    geMask?: Record<string, unknown>;
-}
-export declare function readGE2IRMetadata(ir: IRComposition, layer: IRLayerNode): GE2IRPassthroughMetadata | undefined;

package/dist/shared/types.d.ts

@@ -1,60 +0,0 @@
-import type { DataPath } from '@galacean/effects-specification';
-export type GERecord = Record<string, unknown>;
-export type GEDataPath = DataPath;
-export type GEPoolIndex = Map<string, GERecord>;
-/** GE transform block emitted on every VFX item. */
-export interface GETransform {
-    position: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    eulerHint: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    scale: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    anchor?: {
-        x: number;
-        y: number;
-    };
-    size?: {
-        x: number;
-        y: number;
-    };
-}
-/** A single VFXItemData entry in a GE scene. */
-export interface GEItem {
-    id: string;
-    dataType: string;
-    name: string;
-    duration: number;
-    type: string;
-    visible: boolean;
-    endBehavior: number;
-    delay: number;
-    renderLevel: string;
-    content?: GERecord;
-    components: GEDataPath[];
-    transform: GETransform;
-    parentId?: string;
-}
-/**
- * Build-time accumulators shared by every generator. Each pool maps to a
- * top-level array on the emitted JSONScene.
- */
-export interface ECSCollector {
-    images: Array<{
-        id: string;
-        url: string;
-    }>;
-    components: GERecord[];
-    items: GEItem[];
-    textures: GERecord[];
-    miscs: GERecord[];
-}