refactor(particlesystem): align ParticleSystemComponent with CameraComponent architecture

[willeastcott]

Description

Continues the component architecture migration series (#8871 collision, #8870 button, #8777, #8693, #8666) by moving the ParticleSystemComponent off the legacy data-object + set_* event architecture.

component.js

• All ~60 properties are now private fields on the component with real getters/setters; the side effects previously spread across twelve onSet* event handlers are inlined into the setters, gated on this.emitter (the emitter only exists after onEnable).
• The old SIMPLE/COMPLEX/GRAPH property category handlers became three private helpers (_setSimpleProperty, _setComplexProperty, _setGraphProperty) called from the setters.
• Asset setters normalize Asset instances to ids and handle bind/unbind directly.
• The unused mode and scene data fields are dropped; paused becomes a private runtime field.

data.js

• Reduced to just enabled = true.

system.js

• Schema is now ['enabled']; initializeComponentData keeps the legacy mesh→meshAsset id remap and vec3/curve/curveset deserialization, then applies properties through the public setters; cloneComponent reads getters and deep-clones Vec3/Curve/CurveSet values; Component._buildAccessors provides the enabled accessor.

Tests

• Added 8 tests: default values, JSON-style initialization (arrays→Vec3, raw {type, keys}→Curve/CurveSet with type preserved), instance pass-through, legacy mesh-id remap, Asset→id normalization, deep cloning, and pause behavior.

Notes for reviewers

• loop was registered with two legacy handlers (onSetLoop plus the SIMPLE_PROPERTIES handler), so its new setter performs both resetTime() and resetMaterial() to preserve behavior.
• cloneComponent skips null/undefined values exactly like the old schema-based clone did — otherwise a cloned direct-assigned mesh would be wiped by a trailing meshAsset: null write.
• Verified beyond unit tests by running the particles examples (spark, mesh) in the browser and live-mutating every setter category (complex rebuild, simple, graph, loop, blendType, depthSoftening depth-layer request/release, layers migration, pause()/play(), enabled toggle) — all propagate to the emitter with no console errors.

Checklist

• I have read the contributing guidelines
• My code follows the project's coding standards
• This PR focuses on a single change

🤖 Generated with Claude Code

[github-actions]

Public API report

This PR changes the public API surface (+10 / −10), per the docs' rules (@ignore / @Private / undocumented are excluded).

Show API diff

-AttributeSchema.type: "string" | "number" | "boolean" | "vec2" | "vec3" | "vec4" | "json" | "rgb" | "asset" | "curve" | "entity" | "rgba"
+AttributeSchema.type: "string" | "number" | "boolean" | "vec2" | "vec3" | "vec4" | "json" | "rgb" | "asset" | "entity" | "rgba" | "curve"
-ParticleSystemComponent.get colorMapAsset(): Asset
+ParticleSystemComponent.get colorMapAsset(): Asset | null
-ParticleSystemComponent.get meshAsset(): Asset
+ParticleSystemComponent.get meshAsset(): Asset | null
-ParticleSystemComponent.get normalMapAsset(): Asset
+ParticleSystemComponent.get normalMapAsset(): Asset | null
-ParticleSystemComponent.get renderAsset(): Asset
+ParticleSystemComponent.get renderAsset(): Asset | null
-ParticleSystemComponent.set colorMapAsset(arg: Asset)
+ParticleSystemComponent.set colorMapAsset(arg: Asset | null)
-ParticleSystemComponent.set meshAsset(arg: Asset)
+ParticleSystemComponent.set meshAsset(arg: Asset | null)
-ParticleSystemComponent.set normalMapAsset(arg: Asset)
+ParticleSystemComponent.set normalMapAsset(arg: Asset | null)
-ParticleSystemComponent.set renderAsset(arg: Asset)
+ParticleSystemComponent.set renderAsset(arg: Asset | null)
-ScriptAttributes.add(name: string, args: { array: boolean; assetType: string; color: string; curves: string[]; default: any; description: string; enum: any[]; max: number; min: number; placeholder: string | string[]; precision: number; schema: any[]; size: number; step: number; title: string; type: "string" | "number" | "boolean" | "vec2" | "vec3" | "vec4" | "json" | "rgb" | "asset" | "curve" | "entity" | "rgba" }): void
+ScriptAttributes.add(name: string, args: { array: boolean; assetType: string; color: string; curves: string[]; default: any; description: string; enum: any[]; max: number; min: number; placeholder: string | string[]; precision: number; schema: any[]; size: number; step: number; title: string; type: "string" | "number" | "boolean" | "vec2" | "vec3" | "vec4" | "json" | "rgb" | "asset" | "entity" | "rgba" | "curve" }): void

Informational only — this never fails the build.

[Copilot]

Pull request overview

Refactors ParticleSystemComponent to match the newer component architecture used by Camera/Light/Button/etc by moving most state off the legacy data bag and set_* event handlers, while keeping enabled schema-based.

Changes:

• Migrates ParticleSystemComponent properties to private fields with real getters/setters; inlines side effects previously implemented via set_* listeners.
• Reduces component data/schema to enabled only; updates system initialization/cloning to use public setters/getters and perform vec3/curve deserialization.
• Adds a new unit test suite covering defaults, JSON-style initialization, asset/id normalization, cloning, and pause/play behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
src/framework/components/particle-system/component.js	Moves runtime state to private fields; rewires property side effects and lifecycle behavior to operate on this.emitter and private fields.
src/framework/components/particle-system/system.js	Shrinks schema to enabled, updates initialization and cloning to apply properties via setters and deep-clone Vec3/Curve/CurveSet values.
src/framework/components/particle-system/data.js	Reduces data object to enabled only.
test/framework/components/particlesystem/component.test.mjs	Adds tests for defaults, initialization conversions, legacy remap, asset normalization, cloning, and pause behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 9 comments.