@dcl/ecs 7.24.5-28985931443.commit-4a0bcfc → 7.24.5-29247185020.commit-e92dfe6

package/dist/components/extended/AudioAnalysis.d.ts

@@ -1,55 +0,0 @@
-import { Entity, IEngine } from '../../engine';
-import { LastWriteWinElementSetComponentDefinition } from '../../engine/component';
-import { PBAudioAnalysis, PBAudioAnalysisMode } from '../generated/pb/decentraland/sdk/components/audio_analysis.gen';
-export interface AudioAnalysisComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBAudioAnalysis> {
-    /**
-     * Reads the component data of `entity` into the provided `out` view.
-     *
-     * @throws Error if the entity does not have an AudioAnalysis component.
-     * @param entity - The entity whose AudioAnalysis data will be read.
-     * @param out - An existing AudioAnalysisView to populate with the latest values.
-     */
-    readIntoView(entity: Entity, out: AudioAnalysisView): void;
-    /**
-     * Attempts to read the component data of `entity` into the provided `out` view.
-     *
-     * @returns `true` if the component exists and data was written into `out`,
-     *          `false` if the entity does not have an AudioAnalysis component.
-     * @param entity - The entity whose AudioAnalysis data will be read.
-     * @param out - An existing AudioAnalysisView to populate.
-     */
-    tryReadIntoView(entity: Entity, out: AudioAnalysisView): boolean;
-    /**
-     * Creates an AudioAnalysis component for the given `entity`.
-     *
-     * If a component already exists on the entity, this call fails (does not replace).
-     *
-     * @param entity - The entity to attach the component to.
-     * @param mode - Analysis mode. Defaults to `PBAudioAnalysisMode.MODE_LOGARITHMIC`.
-     * @param amplitudeGain - Optional amplitude gain multiplier.
-     * @param bandsGain - Optional gain multiplier applied to all frequency bands.
-     */
-    createAudioAnalysis(entity: Entity, mode?: PBAudioAnalysisMode, // default is PBAudioAnalysisMode.MODE_LOGARITHMIC
-    amplitudeGain?: number, bandsGain?: number): void;
-    /**
-     * Creates the AudioAnalysis component if missing, or replaces the existing one.
-     *
-     * @param entity - The target entity.
-     * @param mode - Analysis mode. Defaults to `PBAudioAnalysisMode.MODE_LOGARITHMIC`.
-     * @param amplitudeGain - Optional amplitude gain multiplier.
-     * @param bandsGain - Optional gain multiplier applied to the frequency bands.
-     */
-    createOrReplaceAudioAnalysis(entity: Entity, mode?: PBAudioAnalysisMode, // default is PBAudioAnalysisMode.MODE_LOGARITHMIC
-    amplitudeGain?: number, bandsGain?: number): void;
-}
-/**
- * A read-only JavaScript-friendly view of AudioAnalysis ECS data.
- *
- * `amplitude` represents the aggregated signal strength.
- * `bands` represents the processed frequency bands.
- */
-export type AudioAnalysisView = {
-    amplitude: number;
-    bands: number[];
-};
-export declare function defineAudioAnalysisComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): AudioAnalysisComponentDefinitionExtended;

package/dist/components/extended/AudioAnalysis.js

@@ -1,66 +0,0 @@
-import { AudioAnalysis } from '../generated/index.gen';
-export function defineAudioAnalysisComponent(engine) {
-    const theComponent = AudioAnalysis(engine);
-    return {
-        ...theComponent,
-        readIntoView(entity, out) {
-            const audioAnalysis = theComponent.get(entity);
-            out.amplitude = audioAnalysis.amplitude;
-            out.bands[0] = audioAnalysis.band0;
-            out.bands[1] = audioAnalysis.band1;
-            out.bands[2] = audioAnalysis.band2;
-            out.bands[3] = audioAnalysis.band3;
-            out.bands[4] = audioAnalysis.band4;
-            out.bands[5] = audioAnalysis.band5;
-            out.bands[6] = audioAnalysis.band6;
-            out.bands[7] = audioAnalysis.band7;
-        },
-        tryReadIntoView(entity, out) {
-            const audioAnalysis = theComponent.getOrNull(entity);
-            if (!audioAnalysis)
-                return false;
-            out.amplitude = audioAnalysis.amplitude;
-            out.bands[0] = audioAnalysis.band0;
-            out.bands[1] = audioAnalysis.band1;
-            out.bands[2] = audioAnalysis.band2;
-            out.bands[3] = audioAnalysis.band3;
-            out.bands[4] = audioAnalysis.band4;
-            out.bands[5] = audioAnalysis.band5;
-            out.bands[6] = audioAnalysis.band6;
-            out.bands[7] = audioAnalysis.band7;
-            return true;
-        },
-        createAudioAnalysis(entity, mode, amplitudeGain, bandsGain) {
-            theComponent.create(entity, {
-                mode: mode || 1 /* PBAudioAnalysisMode.MODE_LOGARITHMIC */,
-                amplitudeGain: amplitudeGain ?? undefined,
-                bandsGain: bandsGain ?? undefined,
-                amplitude: 0,
-                band0: 0,
-                band1: 0,
-                band2: 0,
-                band3: 0,
-                band4: 0,
-                band5: 0,
-                band6: 0,
-                band7: 0
-            });
-        },
-        createOrReplaceAudioAnalysis(entity, mode, amplitudeGain, bandsGain) {
-            theComponent.createOrReplace(entity, {
-                mode: mode || 1 /* PBAudioAnalysisMode.MODE_LOGARITHMIC */,
-                amplitudeGain: amplitudeGain ?? undefined,
-                bandsGain: bandsGain ?? undefined,
-                amplitude: 0,
-                band0: 0,
-                band1: 0,
-                band2: 0,
-                band3: 0,
-                band4: 0,
-                band5: 0,
-                band6: 0,
-                band7: 0
-            });
-        }
-    };
-}

package/dist/components/extended/ParticleSystem.d.ts

@@ -1,24 +0,0 @@
-import { IEngine, LastWriteWinElementSetComponentDefinition } from '../../engine';
-import { PBParticleSystem, PBParticleSystem_BlendMode, PBParticleSystem_PlaybackState, PBParticleSystem_Point, PBParticleSystem_Sphere, PBParticleSystem_Cone, PBParticleSystem_Box } from '../generated/index.gen';
-export { PBParticleSystem_BlendMode as ParticleSystemBlendMode, PBParticleSystem_PlaybackState as ParticleSystemPlaybackState };
-/**
- * @public
- */
-export interface ParticleSystemHelper {
-    /** Emit from a single point */
-    Point: (point?: PBParticleSystem_Point) => PBParticleSystem['shape'];
-    /** Emit from the surface or volume of a sphere */
-    Sphere: (sphere?: PBParticleSystem_Sphere) => PBParticleSystem['shape'];
-    /** Emit from the base of a cone, projecting outward */
-    Cone: (cone?: PBParticleSystem_Cone) => PBParticleSystem['shape'];
-    /** Emit from the surface or volume of a box */
-    Box: (box?: PBParticleSystem_Box) => PBParticleSystem['shape'];
-}
-/**
- * @public
- */
-export interface ParticleSystemComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBParticleSystem> {
-    /** Helpers for constructing emitter shapes */
-    Shape: ParticleSystemHelper;
-}
-export declare function defineParticleSystemComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): ParticleSystemComponentDefinitionExtended;

package/dist/components/extended/ParticleSystem.js

@@ -1,23 +0,0 @@
-import { ParticleSystem, PBParticleSystem_BlendMode, PBParticleSystem_PlaybackState } from '../generated/index.gen';
-export { PBParticleSystem_BlendMode as ParticleSystemBlendMode, PBParticleSystem_PlaybackState as ParticleSystemPlaybackState };
-const ParticleSystemShapeHelper = {
-    Point(point = {}) {
-        return { $case: 'point', point };
-    },
-    Sphere(sphere = {}) {
-        return { $case: 'sphere', sphere };
-    },
-    Cone(cone = {}) {
-        return { $case: 'cone', cone };
-    },
-    Box(box = {}) {
-        return { $case: 'box', box };
-    }
-};
-export function defineParticleSystemComponent(engine) {
-    const theComponent = ParticleSystem(engine);
-    return {
-        ...theComponent,
-        Shape: ParticleSystemShapeHelper
-    };
-}

package/dist/components/generated/pb/decentraland/sdk/components/audio_analysis.gen.d.ts

@@ -1,37 +0,0 @@
-import _m0 from "protobufjs/minimal";
-/**
- * @public
- */
-export declare const enum PBAudioAnalysisMode {
-    MODE_RAW = 0,
-    MODE_LOGARITHMIC = 1
-}
-/**
- * @public
- */
-export interface PBAudioAnalysis {
-    /** Parameters section */
-    mode: PBAudioAnalysisMode;
-    /** Used only when mode == MODE_LOGARITHMIC */
-    amplitudeGain?: number | undefined;
-    /** End when mode == MODE_LOGARITHMIC */
-    bandsGain?: number | undefined;
-    /** Result section */
-    amplitude: number;
-    /** Protobuf doesn't support fixed arrays -> 8 band fields */
-    band0: number;
-    band1: number;
-    band2: number;
-    band3: number;
-    band4: number;
-    band5: number;
-    band6: number;
-    band7: number;
-}
-/**
- * @public
- */
-export declare namespace PBAudioAnalysis {
-    function encode(message: PBAudioAnalysis, writer?: _m0.Writer): _m0.Writer;
-    function decode(input: _m0.Reader | Uint8Array, length?: number): PBAudioAnalysis;
-}

package/dist/components/generated/pb/decentraland/sdk/components/audio_analysis.gen.js

@@ -1,161 +0,0 @@
-/* eslint-disable */
-import _m0 from "protobufjs/minimal";
-const protobufPackageSarasa = "decentraland.sdk.components";
-/**
- * @public
- */
-export var PBAudioAnalysisMode;
-(function (PBAudioAnalysisMode) {
-    PBAudioAnalysisMode[PBAudioAnalysisMode["MODE_RAW"] = 0] = "MODE_RAW";
-    PBAudioAnalysisMode[PBAudioAnalysisMode["MODE_LOGARITHMIC"] = 1] = "MODE_LOGARITHMIC";
-})(PBAudioAnalysisMode || (PBAudioAnalysisMode = {}));
-function createBasePBAudioAnalysis() {
-    return {
-        mode: 0,
-        amplitudeGain: undefined,
-        bandsGain: undefined,
-        amplitude: 0,
-        band0: 0,
-        band1: 0,
-        band2: 0,
-        band3: 0,
-        band4: 0,
-        band5: 0,
-        band6: 0,
-        band7: 0,
-    };
-}
-/**
- * @public
- */
-export var PBAudioAnalysis;
-(function (PBAudioAnalysis) {
-    function encode(message, writer = _m0.Writer.create()) {
-        if (message.mode !== 0) {
-            writer.uint32(8).int32(message.mode);
-        }
-        if (message.amplitudeGain !== undefined) {
-            writer.uint32(805).float(message.amplitudeGain);
-        }
-        if (message.bandsGain !== undefined) {
-            writer.uint32(813).float(message.bandsGain);
-        }
-        if (message.amplitude !== 0) {
-            writer.uint32(1605).float(message.amplitude);
-        }
-        if (message.band0 !== 0) {
-            writer.uint32(1613).float(message.band0);
-        }
-        if (message.band1 !== 0) {
-            writer.uint32(1621).float(message.band1);
-        }
-        if (message.band2 !== 0) {
-            writer.uint32(1629).float(message.band2);
-        }
-        if (message.band3 !== 0) {
-            writer.uint32(1637).float(message.band3);
-        }
-        if (message.band4 !== 0) {
-            writer.uint32(1645).float(message.band4);
-        }
-        if (message.band5 !== 0) {
-            writer.uint32(1653).float(message.band5);
-        }
-        if (message.band6 !== 0) {
-            writer.uint32(1661).float(message.band6);
-        }
-        if (message.band7 !== 0) {
-            writer.uint32(1669).float(message.band7);
-        }
-        return writer;
-    }
-    PBAudioAnalysis.encode = encode;
-    function decode(input, length) {
-        const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
-        let end = length === undefined ? reader.len : reader.pos + length;
-        const message = createBasePBAudioAnalysis();
-        while (reader.pos < end) {
-            const tag = reader.uint32();
-            switch (tag >>> 3) {
-                case 1:
-                    if (tag !== 8) {
-                        break;
-                    }
-                    message.mode = reader.int32();
-                    continue;
-                case 100:
-                    if (tag !== 805) {
-                        break;
-                    }
-                    message.amplitudeGain = reader.float();
-                    continue;
-                case 101:
-                    if (tag !== 813) {
-                        break;
-                    }
-                    message.bandsGain = reader.float();
-                    continue;
-                case 200:
-                    if (tag !== 1605) {
-                        break;
-                    }
-                    message.amplitude = reader.float();
-                    continue;
-                case 201:
-                    if (tag !== 1613) {
-                        break;
-                    }
-                    message.band0 = reader.float();
-                    continue;
-                case 202:
-                    if (tag !== 1621) {
-                        break;
-                    }
-                    message.band1 = reader.float();
-                    continue;
-                case 203:
-                    if (tag !== 1629) {
-                        break;
-                    }
-                    message.band2 = reader.float();
-                    continue;
-                case 204:
-                    if (tag !== 1637) {
-                        break;
-                    }
-                    message.band3 = reader.float();
-                    continue;
-                case 205:
-                    if (tag !== 1645) {
-                        break;
-                    }
-                    message.band4 = reader.float();
-                    continue;
-                case 206:
-                    if (tag !== 1653) {
-                        break;
-                    }
-                    message.band5 = reader.float();
-                    continue;
-                case 207:
-                    if (tag !== 1661) {
-                        break;
-                    }
-                    message.band6 = reader.float();
-                    continue;
-                case 208:
-                    if (tag !== 1669) {
-                        break;
-                    }
-                    message.band7 = reader.float();
-                    continue;
-            }
-            if ((tag & 7) === 4 || tag === 0) {
-                break;
-            }
-            reader.skipType(tag & 7);
-        }
-        return message;
-    }
-    PBAudioAnalysis.decode = decode;
-})(PBAudioAnalysis || (PBAudioAnalysis = {}));

package/dist/composite/provider-registry.d.ts

@@ -1,15 +0,0 @@
-import type { IEngine } from '../engine';
-import type { CompositeProvider } from './instance';
-/**
- * Register the composite provider used to resolve composite files. Also registers
- * any `provider.schemas` on the engine pre-seal so composites that reference those
- * components can be instanced without further setup.
- * @public
- */
-export declare function setCompositeProvider(engine: IEngine, provider: CompositeProvider): void;
-/**
- * Get the composite provider registered via setCompositeProvider. Returns null if
- * no provider has been set.
- * @public
- */
-export declare function getCompositeProvider(): CompositeProvider | null;

package/dist/composite/provider-registry.js

@@ -1,32 +0,0 @@
-import { Schemas } from '../schemas';
-import { getCompositeRootComponent } from './components';
-let currentProvider = null;
-/**
- * Register the composite provider used to resolve composite files. Also registers
- * any `provider.schemas` on the engine pre-seal so composites that reference those
- * components can be instanced without further setup.
- * @public
- */
-export function setCompositeProvider(engine, provider) {
-    currentProvider = provider;
-    // Define composite::root pre-seal. setCompositeProvider runs at module-load,
-    // so this guarantees the component exists before the engine seals — composites
-    // instanced at runtime (post-seal) would otherwise trip the seal when
-    // instanceComposite looks it up via getCompositeRootComponent.
-    getCompositeRootComponent(engine);
-    if (!provider.schemas)
-        return;
-    for (const { name, jsonSchema } of provider.schemas) {
-        if (engine.getComponentOrNull(name))
-            continue;
-        engine.defineComponentFromSchema(name, Schemas.fromJson(jsonSchema));
-    }
-}
-/**
- * Get the composite provider registered via setCompositeProvider. Returns null if
- * no provider has been set.
- * @public
- */
-export function getCompositeProvider() {
-    return currentProvider;
-}

package/dist/runtime/helpers/vectors.js

@@ -1,36 +0,0 @@
-/**
- * Lightweight Vector3 math utilities for internal use.
- * Mirrors the subset of @dcl/ecs-math Vector3 API used by the physics helpers.
- *
- * TEMPORARY WORKAROUND: @dcl/ecs-math ships ESM-only, which breaks the dist-cjs build.
- * The proper fix is to add a CJS build to @dcl/ecs-math upstream, then replace this
- * file with `import { Vector3 } from '@dcl/ecs-math'`.
- *
- * @internal
- */
-export const Vector3 = {
-    add(a, b) {
-        return { x: a.x + b.x, y: a.y + b.y, z: a.z + b.z };
-    },
-    subtract(a, b) {
-        return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };
-    },
-    scale(v, s) {
-        return { x: v.x * s, y: v.y * s, z: v.z * s };
-    },
-    length(v) {
-        return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);
-    },
-    normalize(v) {
-        const len = Vector3.length(v);
-        if (len === 0)
-            return { x: 0, y: 0, z: 0 };
-        return { x: v.x / len, y: v.y / len, z: v.z / len };
-    },
-    equals(a, b) {
-        return a.x === b.x && a.y === b.y && a.z === b.z;
-    },
-    equalsToFloats(v, x, y, z) {
-        return v.x === x && v.y === y && v.z === z;
-    }
-};

package/dist/systems/physics-force.js

@@ -1,140 +0,0 @@
-import * as components from '../components';
-import { Vector3, createTimers } from '../runtime/helpers';
-import { KnockbackFalloff } from './physics-impulse';
-/** @internal */
-export function createPhysicsForceHelper(engine) {
-    const PhysicsCombinedForce = components.PhysicsCombinedForce(engine);
-    const Transform = components.Transform(engine);
-    const timers = createTimers(engine);
-    const durationTimers = new Map();
-    // Key = source entity producing the force (not the target); all forces target PlayerEntity.
-    const forceSources = new Map();
-    const repulsionSources = new Map();
-    let lastWrittenForceVector = null;
-    function recalcForce() {
-        if (forceSources.size === 0) {
-            if (PhysicsCombinedForce.has(engine.PlayerEntity)) {
-                PhysicsCombinedForce.deleteFrom(engine.PlayerEntity);
-            }
-            lastWrittenForceVector = null;
-            return;
-        }
-        const current = PhysicsCombinedForce.getOrNull(engine.PlayerEntity);
-        if (current && lastWrittenForceVector && current.vector) {
-            if (!Vector3.equals(current.vector, lastWrittenForceVector)) {
-                console.error('PBPhysicsCombinedForce was modified externally.', 'Expected:', lastWrittenForceVector, 'Found:', current.vector, '-- overwriting with local state.');
-            }
-        }
-        let sum = { x: 0, y: 0, z: 0 };
-        for (const v of forceSources.values()) {
-            sum = Vector3.add(sum, v);
-        }
-        PhysicsCombinedForce.createOrReplace(engine.PlayerEntity, { vector: sum });
-        lastWrittenForceVector = sum;
-    }
-    function applyForceToPlayer(source, vector, magnitude) {
-        let finalVector;
-        if (Vector3.equalsToFloats(vector, 0, 0, 0))
-            return;
-        if (typeof magnitude === 'number') {
-            finalVector = Vector3.scale(Vector3.normalize(vector), magnitude);
-        }
-        else {
-            finalVector = vector;
-        }
-        forceSources.set(source, finalVector);
-        recalcForce();
-    }
-    function removeForceFromPlayer(source) {
-        repulsionSources.delete(source);
-        const timerId = durationTimers.get(source);
-        if (timerId !== undefined) {
-            timers.clearTimeout(timerId);
-            durationTimers.delete(source);
-        }
-        if (!forceSources.has(source))
-            return;
-        forceSources.delete(source);
-        recalcForce();
-    }
-    function scheduleForceDuration(source, seconds) {
-        const existing = durationTimers.get(source);
-        if (existing !== undefined) {
-            timers.clearTimeout(existing);
-        }
-        const timerId = timers.setTimeout(() => {
-            durationTimers.delete(source);
-            removeForceFromPlayer(source);
-        }, seconds * 1000);
-        durationTimers.set(source, timerId);
-    }
-    function applyForceToPlayerForDuration(source, duration, vector, magnitude) {
-        applyForceToPlayer(source, vector, magnitude);
-        scheduleForceDuration(source, duration);
-    }
-    function computeRepulsionVector(fromPosition, magnitude, radius, falloff) {
-        const diff = Vector3.subtract(Transform.get(engine.PlayerEntity).position, fromPosition);
-        if (Vector3.equalsToFloats(diff, 0, 0, 0))
-            return { x: 0, y: magnitude, z: 0 };
-        // Fast path: default params — no need to compute distance
-        if (radius === Infinity && falloff === KnockbackFalloff.CONSTANT) {
-            return Vector3.scale(Vector3.normalize(diff), magnitude);
-        }
-        const distance = Vector3.length(diff);
-        if (distance > radius)
-            return null;
-        let effectiveMagnitude;
-        switch (falloff) {
-            case KnockbackFalloff.LINEAR:
-                effectiveMagnitude = magnitude * (1 - distance / radius);
-                break;
-            case KnockbackFalloff.INVERSE_SQUARE:
-                effectiveMagnitude = magnitude / (distance * distance + 1);
-                break;
-            case KnockbackFalloff.CONSTANT:
-            default:
-                effectiveMagnitude = magnitude;
-                break;
-        }
-        if (effectiveMagnitude === 0)
-            return null;
-        // normalize(diff) * effectiveMagnitude in one step
-        return Vector3.scale(diff, effectiveMagnitude / distance);
-    }
-    function applyRepulsionForceToPlayer(source, fromPosition, magnitude, radius = Infinity, falloff = KnockbackFalloff.CONSTANT) {
-        repulsionSources.set(source, { fromPosition, magnitude, radius, falloff });
-        const vector = computeRepulsionVector(fromPosition, magnitude, radius, falloff);
-        if (vector) {
-            forceSources.set(source, vector);
-        }
-        else {
-            forceSources.delete(source);
-        }
-        recalcForce();
-    }
-    // Background system: recalculate repulsion vectors and clean up stale forces every tick.
-    // Stale forces can appear when CRDT sync from another client writes PhysicsCombinedForce
-    // externally (entity-1 ambiguity: each client interprets entity 1 as its own player).
-    engine.addSystem(() => {
-        // Repulsion forces need per-tick direction recalculation as the player moves
-        if (repulsionSources.size > 0) {
-            for (const [source, { fromPosition, magnitude, radius, falloff }] of repulsionSources) {
-                const vector = computeRepulsionVector(fromPosition, magnitude, radius, falloff);
-                if (vector) {
-                    forceSources.set(source, vector);
-                }
-                else {
-                    forceSources.delete(source);
-                }
-            }
-            recalcForce();
-            return;
-        }
-        // No local sources — clean up any externally-created component (e.g. from CRDT sync)
-        if (forceSources.size === 0 && PhysicsCombinedForce.has(engine.PlayerEntity)) {
-            PhysicsCombinedForce.deleteFrom(engine.PlayerEntity);
-            lastWrittenForceVector = null;
-        }
-    });
-    return { applyForceToPlayer, removeForceFromPlayer, applyForceToPlayerForDuration, applyRepulsionForceToPlayer };
-}

package/dist/systems/physics-impulse.d.ts

@@ -1,12 +0,0 @@
-/**
- * @public
- * Falloff mode for knockback force over distance.
- */
-export declare enum KnockbackFalloff {
-    /** Same force at any distance within radius */
-    CONSTANT = 0,
-    /** Smooth linear decrease to 0 at radius edge: F = magnitude * (1 - distance / radius) */
-    LINEAR = 1,
-    /** Sharp drop-off, physically realistic: F = magnitude / (distance^2 + 1) */
-    INVERSE_SQUARE = 2
-}