@fps-games/vfx 0.1.1 → 0.3.3

package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-tuning-report.json

@@ -1,40 +0,0 @@
-{
-  "schemaVersion": "vfx-preview-tuning-report/1.0",
-  "stage": "preview-tuning",
-  "generatedAt": "2026-05-19T04:06:57.379Z",
-  "effectId": "build.particle.golden_upgrade_starburst",
-  "sourcePackage": "build.particle.golden_upgrade_starburst",
-  "inputEffectFile": "effect.json",
-  "outputPackage": "build.particle.golden_upgrade_starburst.stage4-package.zip",
-  "packageFiles": {
-    "tunedEffect": "effect.json",
-    "overrides": "04-preview-overrides.json",
-    "report": "04-preview-tuning-report.json"
-  },
-  "emitters": [
-    {
-      "name": "effect_dian",
-      "enabled": true,
-      "capacity": 100,
-      "emitRate": 0,
-      "particleTexturePath": "assets/textures/effect_guangdian.png",
-      "materialSourcePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl",
-      "shader": null,
-      "meshEffect": null,
-      "shape": "Box",
-      "runtime": {
-        "adapter": "particleEmitter/v1"
-      },
-      "renderColor": {
-        "color": {
-          "r": 1,
-          "g": 1,
-          "b": 1,
-          "a": 1
-        },
-        "colorIntensity": 1,
-        "alphaIntensity": 1
-      }
-    }
-  ]
-}

package/packages/build.particle.golden_upgrade_starburst/provenance/asset-map.json

@@ -1,115 +0,0 @@
-{
-  "schemaVersion": "vfx-asset-map/1.0",
-  "generatedAt": "2026-05-19T04:06:57.387Z",
-  "sourcePackage": "build.particle.golden_upgrade_starburst",
-  "policy": {
-    "runtimeAssetsRoot": "assets/",
-    "sourceAssetsRoot": "source/",
-    "note": "assets/ contains files loaded by Babylon runtime. source/cocos/assets/ preserves the original Cocos asset tree for traceability and reconversion."
-  },
-  "entries": [
-    {
-      "id": "effect_guangdian",
-      "kind": "texture",
-      "group": "textures",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/textures/effect_guangdian.png",
-      "sourcePackagePath": "assets/textures/effect_guangdian.png",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/tex/effect_guangdian.png",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/tex/effect_guangdian.png",
-      "sourceId": "3841c09a-7102-4785-869a-81d7c2209501@6c48a",
-      "usedBy": [
-        "emitters.effect_dian.texture"
-      ],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Up1/tex/effect_guangdian.png"
-    },
-    {
-      "id": "effect_guangdian",
-      "kind": "material",
-      "group": "materials",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl",
-      "sourcePackagePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl",
-      "sourceId": "a347f6f0-a285-414a-8a8b-04dc48b8a688",
-      "usedBy": [
-        "emitters.effect_dian.material"
-      ],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Up1/mat/effect_guangdian.mtl"
-    },
-    {
-      "id": "particle_emitter_v1",
-      "kind": "script",
-      "group": "scripts",
-      "role": "babylon-runtime",
-      "runtimeUse": true,
-      "packagePath": "assets/runtime/particleEmitter.v1.js",
-      "sourcePackagePath": "assets/runtime/particleEmitter.v1.js",
-      "sourceArchivePath": null,
-      "sourcePath": null,
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "02-normalized-vfx",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/02-normalized-vfx.json",
-      "sourcePackagePath": "source/02-normalized-vfx.json",
-      "sourceArchivePath": null,
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/02-normalized-vfx.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "01-source-dump",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/01-source-dump.json",
-      "sourcePackagePath": "source/01-source-dump.json",
-      "sourceArchivePath": null,
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/01-source-dump.json",
-      "sourceId": null,
-      "usedBy": []
-    },
-    {
-      "id": "effect_build_up1",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/Effect_Build_Up1.prefab",
-      "sourcePackagePath": "source/raw/Effect_Build_Up1.prefab",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab",
-      "sourceId": "f4b9b9eb-a0d0-43aa-ae18-8b702f2d2dec",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab"
-    },
-    {
-      "id": "effect_build_up1.meta",
-      "kind": "raw",
-      "group": "raw",
-      "role": "source-evidence",
-      "runtimeUse": false,
-      "packagePath": "source/raw/Effect_Build_Up1.prefab.meta",
-      "sourcePackagePath": "source/raw/Effect_Build_Up1.prefab.meta",
-      "sourceArchivePath": "source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab.meta",
-      "sourcePath": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source/cocos/assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab.meta",
-      "sourceId": "f4b9b9eb-a0d0-43aa-ae18-8b702f2d2dec",
-      "usedBy": [],
-      "originalProjectPath": "assets/ArtResources/Effect/Effect_Build_Up1/prefab/Effect_Build_Up1.prefab.meta"
-    }
-  ],
-  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source",
-  "fullProvenancePrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/provenance",
-  "canonicalSource": "gcs"
-}

package/packages/build.particle.golden_upgrade_starburst/provenance/lineage.json

@@ -1,40 +0,0 @@
-{
-  "schemaVersion": "vfx-library-lineage/1.0",
-  "savedAt": "2026-05-19T04:06:57.392Z",
-  "sourcePackage": "build.particle.golden_upgrade_starburst",
-  "sourceEffect": "effect.json",
-  "libraryPackage": "packages/build.particle.golden_upgrade_starburst",
-  "effectId": "build.particle.golden_upgrade_starburst",
-  "media": {
-    "previewVideo": "media/preview.webm",
-    "previewWebm": "media/preview.webm",
-    "previewMp4": "media/preview.mp4",
-    "previewGif": "media/preview.gif",
-    "thumbnail": "media/thumbnail.png",
-    "contactSheet": "media/contact-sheet.png",
-    "gcsUri": null
-  },
-  "recording": {
-    "provider": "browser-mediarecorder",
-    "recordedAt": "2026-05-18T14:25:05.850Z",
-    "mimeType": "video/webm;codecs=vp9",
-    "durationSec": 3,
-    "fps": 30,
-    "media": {
-      "previewVideo": "media/preview.webm",
-      "previewWebm": "media/preview.webm",
-      "previewMp4": "media/preview.mp4",
-      "previewGif": "media/preview.gif",
-      "thumbnail": "media/thumbnail.png",
-      "contactSheet": "media/contact-sheet.png",
-      "gcsUri": null
-    }
-  },
-  "description": {
-    "provider": "gemini",
-    "status": "pending_description"
-  },
-  "gcsPrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst",
-  "sourceArchivePrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/source",
-  "fullProvenancePrefix": "gs://fps-vfx-library/packages/build.particle.golden_upgrade_starburst/provenance"
-}

package/packages/build.particle.orange_upgrade_transform_sparks/assets/runtime/particleEmitter.v1.js

@@ -1,210 +0,0 @@
-export const runtimeId = "particleEmitter/v1";
-
-export const runtimeContract = {
-  runtimeId,
-  kind: "particleEmitter",
-  emitterFields: {
-    capacity: "Maximum Babylon particle capacity.",
-    particleTexturePath: "Package-relative particle texture path used to load the Babylon ParticleSystem.particleTexture.",
-    blendMode: "Babylon particle blend mode label: ADD, STANDARD, MULTIPLY, or ONEONE.",
-    shape: "Emitter shape definition generated by the Cocos conversion stage.",
-    renderColor: "Converted particle color inputs: one base color plus RGB/alpha intensity before writing Babylon color1/color2/colorDead.",
-    alphaKeys: "Color alpha gradients sampled over normalized particle lifetime.",
-    sizeKeys: "Size gradients sampled over normalized particle lifetime.",
-  },
-  runtimeBindings: {
-    "ParticleSystem.particleTexture": "Texture loaded from emitter.particleTexturePath through urlForPackagePath.",
-    "ParticleSystem.blendMode": "Mapped from emitter.blendMode.",
-    "ParticleSystem.manualEmitCount": "emitter.manualEmitCount when emitRate is 0.",
-    "ParticleSystem.emitRate": "emitter.emitRate for sustained emitters.",
-    "ParticleSystem.shape": "Mapped from emitter.shape.type and shape parameters.",
-    "ParticleSystem.colorGradient": "emitter.alphaKeys applied to the final ParticleSystem.color1.",
-    "ParticleSystem.sizeGradient": "emitter.sizeKeys multiplied by emitter.maxSize.",
-  },
-};
-
-const BABYLON_PARTICLE_UPDATE_SPEED_UNIT = 0.01;
-
-function num(value, fallback = 0) {
-  const next = Number(value);
-  return Number.isFinite(next) ? next : fallback;
-}
-
-function readColor(BABYLON, value, fallback = new BABYLON.Color4(1, 1, 1, 1)) {
-  if (!value) return fallback;
-  return new BABYLON.Color4(num(value.r, fallback.r), num(value.g, fallback.g), num(value.b, fallback.b), num(value.a, fallback.a));
-}
-
-function applyRenderColorIntensity(BABYLON, color, renderColor = {}) {
-  const colorIntensity = Math.max(0, num(renderColor.colorIntensity, 1));
-  const alphaIntensity = Math.max(0, num(renderColor.alphaIntensity, colorIntensity));
-  return new BABYLON.Color4(
-    color.r * colorIntensity,
-    color.g * colorIntensity,
-    color.b * colorIntensity,
-    Math.min(1, color.a * alphaIntensity)
-  );
-}
-
-function particleColors(BABYLON, emitter) {
-  const renderColor = emitter.renderColor;
-  const baseColor = readColor(BABYLON, renderColor?.color, new BABYLON.Color4(1, 1, 1, 1));
-  const color1 = applyRenderColorIntensity(BABYLON, baseColor, renderColor);
-  return {
-    color1,
-    color2: color1,
-    colorDead: new BABYLON.Color4(color1.r, color1.g, color1.b, 0),
-  };
-}
-
-function readVec(BABYLON, value, fallback = new BABYLON.Vector3(0, 0, 0)) {
-  if (!value) return fallback;
-  return new BABYLON.Vector3(num(value.x, fallback.x), num(value.y, fallback.y), num(value.z, fallback.z));
-}
-
-function blendMode(BABYLON, value) {
-  if (value === "STANDARD") return BABYLON.ParticleSystem.BLENDMODE_STANDARD;
-  if (value === "MULTIPLY") return BABYLON.ParticleSystem.BLENDMODE_MULTIPLY;
-  if (value === "ONEONE") return BABYLON.ParticleSystem.BLENDMODE_ONEONE;
-  return BABYLON.ParticleSystem.BLENDMODE_ADD;
-}
-
-function billboardMode(BABYLON, value) {
-  if (!value || BABYLON.ParticleSystem[value] === undefined) return undefined;
-  return BABYLON.ParticleSystem[value];
-}
-
-function applyCocosConeEmitFunctions(BABYLON, system, radius, angle, radiusRange) {
-  const safeRadius = Math.max(0, radius);
-  const innerSq = (safeRadius * Math.max(0, 1 - radiusRange)) ** 2;
-  const outerSq = safeRadius * safeRadius;
-  const halfAngle = Math.min(Math.PI, Math.max(0, angle));
-  const cosAngle = Math.cos(halfAngle);
-
-  system.startPositionFunction = (worldMatrix, positionToUpdate, _particle, isLocal) => {
-    const s = Math.random() * Math.PI * 2;
-    const r2 = innerSq + Math.random() * (outerSq - innerSq);
-    const r = Math.sqrt(Math.max(0, r2));
-    const lx = r * Math.cos(s);
-    const lz = r * Math.sin(s);
-    if (isLocal) positionToUpdate.set(lx, 0, lz);
-    else BABYLON.Vector3.TransformCoordinatesFromFloatsToRef(lx, 0, lz, worldMatrix, positionToUpdate);
-  };
-
-  system.startDirectionFunction = (worldMatrix, directionToUpdate, _particle, isLocal) => {
-    const phi = Math.random() * Math.PI * 2;
-    const cosTheta = 1 - Math.random() * (1 - cosAngle);
-    const sinTheta = Math.sqrt(Math.max(0, 1 - cosTheta * cosTheta));
-    const dx = sinTheta * Math.cos(phi);
-    const dy = cosTheta;
-    const dz = sinTheta * Math.sin(phi);
-    if (isLocal) directionToUpdate.set(dx, dy, dz);
-    else BABYLON.Vector3.TransformNormalFromFloatsToRef(dx, dy, dz, worldMatrix, directionToUpdate);
-  };
-}
-
-function applyEmitterShape(BABYLON, system, emitter) {
-  const shape = emitter.shape || {};
-  const type = shape.type;
-  const radius = num(shape.radius, 1);
-  const radiusRange = Math.min(1, Math.max(0, num(shape.radiusRange, 1)));
-  const angle = num(shape.angle, Math.PI / 4);
-  const direction1 = readVec(BABYLON, shape.direction1, new BABYLON.Vector3(0, 1, 0));
-  const direction2 = readVec(BABYLON, shape.direction2, new BABYLON.Vector3(0, 1, 0));
-  const boxMin = readVec(BABYLON, shape.minEmitBox, new BABYLON.Vector3(-radius * 0.5, -radius * 0.5, -radius * 0.5));
-  const boxMax = readVec(BABYLON, shape.maxEmitBox, new BABYLON.Vector3(radius * 0.5, radius * 0.5, radius * 0.5));
-
-  if (type === "Box") {
-    system.createBoxEmitter(direction1, direction2, boxMin, boxMax);
-  } else if (type === "SphereDirected") {
-    system.createDirectedSphereEmitter(radius, direction1, direction2);
-  } else if (type === "Sphere") {
-    system.createSphereEmitter(radius, radiusRange);
-  } else if (type === "Hemisphere") {
-    system.createHemisphericEmitter(radius, radiusRange);
-  } else if (type === "Cone") {
-    const dirSpread = direction1.subtract(direction2).lengthSquared();
-    if (dirSpread < 1e-4) {
-      system.createConeEmitter(Math.max(0.001, radius), angle);
-      applyCocosConeEmitFunctions(BABYLON, system, radius, angle, radiusRange);
-    } else {
-      system.createDirectedConeEmitter(Math.max(0.001, radius), angle, direction1, direction2);
-    }
-  }
-}
-
-function addGradients(BABYLON, system, emitter, color1) {
-  for (const key of emitter.alphaKeys || []) {
-    const time = Math.min(1, Math.max(0, num(key.time, 0)));
-    const alpha = Math.min(1, Math.max(0, num(key.alpha, 1)));
-    system.addColorGradient?.(time, new BABYLON.Color4(color1.r, color1.g, color1.b, Math.min(1, color1.a * alpha)));
-  }
-  for (const key of emitter.sizeKeys || []) {
-    const time = Math.min(1, Math.max(0, num(key.time, 0)));
-    const size = Math.max(0.001, num(key.size, 1) * num(emitter.maxSize, 1));
-    system.addSizeGradient?.(time, size);
-  }
-}
-
-function playbackSpeed(emitter) {
-  return Math.max(0.001, num(emitter.updateSpeed, BABYLON_PARTICLE_UPDATE_SPEED_UNIT) / BABYLON_PARTICLE_UPDATE_SPEED_UNIT);
-}
-
-function runtimeDuration(emitter) {
-  return Math.max(0.1, num(emitter.runtime?.stopAfterSeconds, 3) / playbackSpeed(emitter));
-}
-
-export async function createParticleEmitterRuntime({ BABYLON, scene, emitter, index = 0, urlForPackagePath, shouldStart = false }) {
-  if (!BABYLON) throw new Error("createParticleEmitterRuntime requires BABYLON.");
-  if (!scene) throw new Error("createParticleEmitterRuntime requires scene.");
-  if (!emitter) throw new Error("createParticleEmitterRuntime requires emitter.");
-
-  const capacity = Math.max(1, Math.round(num(emitter.capacity, 100)));
-  const system = new BABYLON.ParticleSystem(`particle-emitter-${emitter.name || index}`, capacity, scene);
-  const textureUrl = urlForPackagePath ? urlForPackagePath(emitter.particleTexturePath) : emitter.particleTexturePath;
-  system.particleTexture = new BABYLON.Texture(textureUrl, scene);
-  system.particleTexture.hasAlpha = true;
-  system.emitter = BABYLON.Vector3.Zero();
-  system.blendMode = blendMode(BABYLON, emitter.blendMode);
-  system.isLocal = emitter.isLocal === true;
-  system.minSize = Math.max(0.001, num(emitter.minSize, 1));
-  system.maxSize = Math.max(system.minSize, num(emitter.maxSize, system.minSize));
-  system.minScaleX = Math.max(0.001, num(emitter.minScaleX, 1));
-  system.maxScaleX = Math.max(system.minScaleX, num(emitter.maxScaleX, system.minScaleX));
-  system.minScaleY = Math.max(0.001, num(emitter.minScaleY, 1));
-  system.maxScaleY = Math.max(system.minScaleY, num(emitter.maxScaleY, system.minScaleY));
-  system.minLifeTime = Math.max(0.02, num(emitter.minLifeTime, 0.55));
-  system.maxLifeTime = Math.max(system.minLifeTime, num(emitter.maxLifeTime, system.minLifeTime));
-  system.minEmitPower = Math.max(0, num(emitter.minEmitPower, 1));
-  system.maxEmitPower = Math.max(system.minEmitPower, num(emitter.maxEmitPower, system.minEmitPower));
-  system.updateSpeed = Math.max(0.00001, num(emitter.updateSpeed, BABYLON_PARTICLE_UPDATE_SPEED_UNIT));
-  system.gravity = readVec(BABYLON, emitter.gravity, new BABYLON.Vector3(0, -6, 0));
-  system.emitRate = Math.max(0, num(emitter.emitRate, 0));
-  if (system.emitRate <= 0) system.manualEmitCount = Math.max(0, Math.round(num(emitter.manualEmitCount, 0)));
-
-  const colors = particleColors(BABYLON, emitter);
-  system.color1 = colors.color1;
-  system.color2 = colors.color2;
-  system.colorDead = colors.colorDead;
-  system.minInitialRotation = num(emitter.minInitialRotation, 0);
-  system.maxInitialRotation = num(emitter.maxInitialRotation, system.minInitialRotation);
-  system.minAngularSpeed = num(emitter.minAngularSpeed, 0);
-  system.maxAngularSpeed = num(emitter.maxAngularSpeed, system.minAngularSpeed);
-
-  const nextBillboardMode = billboardMode(BABYLON, emitter.billboardMode);
-  if (nextBillboardMode !== undefined) system.billboardMode = nextBillboardMode;
-
-  applyEmitterShape(BABYLON, system, emitter);
-  addGradients(BABYLON, system, emitter, system.color1);
-
-  const preview = {
-    start: () => system.start(),
-    stop: () => system.stop(),
-    dispose: () => system.dispose(),
-    isStarted: () => system.isStarted(),
-    duration: runtimeDuration(emitter),
-    system,
-  };
-  if (shouldStart) preview.start();
-  return preview;
-}