@aura3d/engine 4.6.2 → 4.7.0

package/dist/engine/agent-api/nodes/builder.js

@@ -1,4 +1,19 @@
 // PRD-15 Phase 3 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+/**
+ * GU47 E-G phase 2: unwrap a node builder to its plain node. `AuraNodeBuilder`
+ * is the common case; `world.*` builders (`AuraWorldNodeBuilder`, which cannot
+ * extend this class without an import cycle) carry `toJSON()` and no `kind`.
+ * Pushing such a builder as-is left its `name()` method where a node name
+ * belongs and the compiler never saw `kind: "water"`.
+ */
+export function toSceneNode(node) {
+    if (node instanceof AuraNodeBuilder)
+        return node.toJSON();
+    const candidate = node;
+    if (typeof candidate.toJSON === "function" && !("kind" in node))
+        return candidate.toJSON.call(node);
+    return node;
+}
 export class AuraNodeBuilder {
     value;
     constructor(value) {

package/dist/engine/agent-api/nodes/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/builder.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAI/G,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAK7C,QAAQ,CAAC,CAAoB,EAAE,CAAU,EAAE,CAAU;QACnD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAW,EAAE,CAAW,CAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;QAC3G,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAKD,MAAM,CAAC,CAAoB,EAAE,CAAgE,EAAE,CAAU,EAAE,KAA2D;QACpK,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAW,EAAE,CAAW,CAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;QAC7G,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAqE,CAAC;QAC1H,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,yFAAyF;IACzF,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAwB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAKD,MAAM,CAAC,CAAoB,EAAE,CAAU,EAAE,CAAU;QACjD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAW,EAAE,CAAW,CAAW,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;QAC3G,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,QAA0B;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,SAA4B;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,WAAgC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,IAAyB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,IAAyB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,IAAI,CAAwC,KAAa;QAC/D,OAAO,IAAI,eAAe,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAoB,CAAC,CAAC;IAC5E,CAAC;CACF"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/builder.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/nodes/effects.composite.d.ts

@@ -1,11 +1,14 @@
 export declare const effects: {
     readonly contactShadows: (options?: import("./effects.lighting.js").AuraContactShadowOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly toon: (options?: import("./effects.toon.js").AuraToonOptions) => import("../publishedUnion.js").AuraCustomPostPass;
-    readonly bloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly bloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & {
+        readonly knee?: number;
+        readonly clampLuminance?: number;
+    }) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly neonBloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly ambientOcclusion: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly contactOcclusion: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly colorGrade: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly colorGrade: (options?: import("./effects.post.js").AuraColorGradeOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly antiAlias: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly vignette: (options?: import("./effects.post.js").PostV3EffectOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly filmGrain: (options?: import("./effects.post.js").PostV3EffectOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
@@ -13,14 +16,14 @@ export declare const effects: {
     readonly shaderPass: (options: import("./effects.post.js").AuraShaderPassOptions) => import("../publishedUnion.js").AuraCustomPostPass;
     readonly fog: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & Record<string, unknown>) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly cinematicBloom: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly volumetricFog: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly volumetricFog: (options?: import("./effects.js").AuraVolumetricFogOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly depthFog: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly outline: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly screenSpaceReflections: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly depthOfField: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly outline: (options?: import("./effects.js").AuraOutlineOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly screenSpaceReflections: (options?: import("./effects.js").AuraScreenSpaceReflectionsOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly depthOfField: (options?: import("./effects.js").AuraDepthOfFieldOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly motionBlur: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly rain: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly snow: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly rain: (options?: import("./effects.js").AuraWeatherEffectOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly snow: (options?: import("./effects.js").AuraWeatherEffectOptions) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly flipbook: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & {
         readonly blend?: import("../../../rendering/contracts/index.js").AuraBlendMode;
         readonly size?: number | readonly [number, number];
@@ -28,9 +31,10 @@ export declare const effects: {
         readonly loop?: boolean;
         readonly prewarm?: number;
         readonly sprite?: import("../publishedUnion.js").AuraParticleEmitterOptions["sprite"];
+        readonly texture?: import("./types.js").AuraAssetRef<"texture"> | string;
     }) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly beam: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
-    readonly particles: (options?: import("../publishedUnion.js").AuraParticleEmitterOptions & import("../publishedUnion.js").AuraLegacyParticleFields & Omit<import("./types.js").AuraEffectNode, "kind" | "effect">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
+    readonly particles: (options?: import("../publishedUnion.js").AuraParticleEmitterOptions & import("../publishedUnion.js").AuraLegacyParticleFields & Omit<import("./types.js").AuraEffectNode, "kind" | "effect" | "speed">) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly trail: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & Record<string, unknown>) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly lightCone: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & Record<string, unknown>) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;
     readonly auroraRibbon: (options?: Omit<import("./types.js").AuraEffectNode, "kind" | "effect"> & Record<string, unknown>) => import("./builder.js").AuraNodeBuilder<import("./types.js").AuraEffectNode>;

package/dist/engine/agent-api/nodes/effects.composite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effects.composite.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;sBAMyhR,CAAC;qBAAkC,CAAC;qBAAuD,CAAC;qBAA2B,CAAC;wBAA+B,CAAC;uBAA6B,CAAC;;;;;;;;;CADvtR,CAAC"}
+{"version":3,"file":"effects.composite.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.composite.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAMmyY,CAAC;qBAAkC,CAAC;qBAAuD,CAAC;qBAA2B,CAAC;wBAA+B,CAAC;uBAA6B,CAAC;wBAA6K,CAAC;;;;;;;;;CAD/oZ,CAAC"}

package/dist/engine/agent-api/nodes/effects.d.ts

@@ -1,4 +1,4 @@
-import type { AuraEffectNode } from "../nodes/types.js";
+import type { AuraAssetRef, AuraEffectNode } from "../nodes/types.js";
 import { AuraNodeBuilder } from "../nodes/builder.js";
 import type { AuraBlendMode } from "../../../rendering/contracts/index.js";
 import type { AuraLegacyParticleFields, AuraParticleEmitterOptions } from "../../contracts/effects.js";
@@ -9,6 +9,47 @@ import type { AuraLegacyParticleFields, AuraParticleEmitterOptions } from "../..
  * `withEmitterOptions` — identical to the §6.2 emitter-option pattern above.
  */
 type VfxNodeOptions = Omit<AuraEffectNode, "kind" | "effect"> & Record<string, unknown>;
+/**
+ * GU47 (PRD §3.1 E-C): tilt-shift focus band on `effects.depthOfField`. The
+ * builder only records it on the node; the post bridge (lane E-C) executes it
+ * and defines the band units.
+ */
+export interface AuraDepthOfFieldTiltShift {
+    readonly bandCenter: number;
+    readonly bandWidth: number;
+    readonly angleDeg?: number;
+}
+/** GU47 E-C: `effects.depthOfField` options (adds `tiltShift`). */
+export type AuraDepthOfFieldOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    readonly tiltShift?: AuraDepthOfFieldTiltShift;
+};
+/** GU47 E-C: `effects.volumetricFog` options (adds `godRayDensity`, decoupled from scene-fog density; behaviour in E-C). */
+export type AuraVolumetricFogOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    readonly godRayDensity?: number;
+};
+/**
+ * GU47 E-C (EC-6): `effects.screenSpaceReflections` options. `maxDistance` (world units, default 18), `roughness`
+ * (reflections fade out above it; S3 cutoff 0.5) and `thickness` (hit thickness, default 0.25) reach the v2 S3 stage.
+ */
+export type AuraScreenSpaceReflectionsOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    readonly maxDistance?: number;
+    readonly roughness?: number;
+    readonly thickness?: number;
+};
+/** GU47 E-E: `effects.outline` options (adds `targets`: node names written to the outline ID mask; behaviour in E-E). */
+export type AuraOutlineOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    readonly targets?: readonly string[];
+};
+/**
+ * Authored rain/snow fields the weather-volume lowering reads (EffectNodeLowering: `size`, `radius`, `seed`) and the
+ * node `name` (so a game can find or replace the volume), copied only when the caller wrote them (GU47 pass 4: g09, g12).
+ */
+export type AuraWeatherEffectOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    /** Flake or drop world size, metres (a `[min, max]` range uses its midpoint); default: the weather preset. */
+    readonly size?: number | readonly [number, number];
+    /** Volume seed; default: a hash of the node id. */
+    readonly seed?: number;
+};
 export declare const vfxEffectBuilders: {
     /**
      * §6.6/F-07-01 — the builder records ONLY authored fields; C-21 defaults are
@@ -24,37 +65,42 @@ export declare const vfxEffectBuilders: {
      * node (never plain fog) that submits the depth-aware inscatter pass plus
      * forward GPU height-fog terms. quality "off" keeps forward exp2 fog only.
      */
-    volumetricFog: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    volumetricFog: (options?: AuraVolumetricFogOptions) => AuraNodeBuilder<AuraEffectNode>;
     depthFog: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root outline node (muse3jsparity-PRD A3): native outline pass, width in
      * pixels clamped to the device range 1-6 by the bridge.
      */
-    outline: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    outline: (options?: AuraOutlineOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root screen-space reflections node (muse3jsparity-PRD A3): submits the
      * native SSR pass against renderer-owned depth where available.
      */
-    screenSpaceReflections: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    screenSpaceReflections: (options?: AuraScreenSpaceReflectionsOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root depth-of-field node (muse3jsparity-PRD A3). focus is a
      * linear-distance fraction (0 = near plane, 1 = far plane); aperture widens
      * the focus transition band (game-tuned control, not a physical f-stop).
      */
-    depthOfField: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    depthOfField: (options?: AuraDepthOfFieldOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root motion-blur node: renderer-owned GPU velocity for opaque rigid geometry.
      * Unsupported deforming/transparent/instanced geometry emits a named warning.
      */
     motionBlur: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
-    rain: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
-    snow: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    rain: (options?: AuraWeatherEffectOptions) => AuraNodeBuilder<AuraEffectNode>;
+    snow: (options?: AuraWeatherEffectOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Flipbook explosion/muzzle-flash sprite sheet (muse3jsparity-PRD D4).
      * Under A3D_QR_VFX it draws through the particle pass: one upright sprite
      * of world `size`, frame = age · `frameRate` over `spriteColumns ×
-     * spriteRows` (wrapping unless `loop: false`), sampling the built-in
-     * seeded `fireball` sheet. `prewarm` starts the sprite that many seconds in.
+     * spriteRows` (wrapping unless `loop: false`). The sheet is, in order:
+     * `texture` (GU47 E-F: a typed texture asset such as an `aura3d-game-art`
+     * sheet, straight alpha, frame 0 in the top-left cell, grid `spriteColumns ×
+     * spriteRows`), a built-in atlas `sprite` name (its own grid, e.g.
+     * "flame-loop"), else the built-in seeded `fireball` sheet. A texture or
+     * sprite draws the soft-dot until it has loaded. `prewarm` starts the
+     * sprite that many seconds in.
      */
     flipbook: (options?: Omit<AuraEffectNode, "kind" | "effect"> & {
         readonly blend?: AuraBlendMode;
@@ -63,23 +109,28 @@ export declare const vfxEffectBuilders: {
         readonly loop?: boolean;
         readonly prewarm?: number;
         readonly sprite?: AuraParticleEmitterOptions["sprite"];
+        /** GU47 E-F: sprite-sheet texture asset (`assets.sheet`) or URL; grid from `spriteColumns × spriteRows`. */
+        readonly texture?: AuraAssetRef<"texture"> | string;
     }) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Additive thick light beam / fence strip (muse3jsparity-PRD D4): recorded
-     * with a validated quad-strip descriptor, but withheld — root has no native
-     * beam target yet, so no pass is submitted.
+     * with a validated quad-strip descriptor and drawn by the prd07.beams pass
+     * under A3D_QR_VFX (camera-facing strip from `from` to `to`).
      */
     beam: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * PRD-07 §6.2 emitter surface: accepts `AuraParticleEmitterOptions` plus the
      * legacy fields; every defined option rides the node to lowering.
      */
-    particles: (options?: AuraParticleEmitterOptions & AuraLegacyParticleFields & Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    particles: (options?: AuraParticleEmitterOptions & AuraLegacyParticleFields & Omit<AuraEffectNode, "kind" | "effect" | "speed">) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * P2-T5 §6.2.9 trail ribbon: the node carries the ring options; lowering
      * maps it to a `RibbonTrail` on the prd07 RibbonBatch. `target` is a runtime
-     * node id, `handle.socket(bone)` (C-19), or a callback — resolved by the
-     * production system, never by the builder.
+     * node id or `{ node, socket }` — resolved by the production system every
+     * frame (GU47 E-F), never by the builder. Optional `life` (seconds) fades
+     * and drops old points (absent: a ring of `maxPoints`); optional
+     * `widthOverSpeed: [min, max]` (m/s) ramps the width by the target's speed.
+     * For a trail started from game code use `app.effects.trail(target, opts)`.
      */
     trail: (options?: VfxNodeOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**

package/dist/engine/agent-api/nodes/effects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAIvG;;;;;GAKG;AACH,KAAK,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0BxF,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;oBACY,cAAc;+BAaH,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAYjE;;;;OAIG;8BACsB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;yBAa5C,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAM3D;;;OAGG;wBACgB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAU1D;;;OAGG;uCAC+B,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAOzE;;;;OAIG;6BACqB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAe/D;;;OAGG;2BACmB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;qBAe7C,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;qBAavC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAavD;;;;;;OAMG;yBACiB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;QAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;KACxD;IAeD;;;;OAIG;qBACa,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAmBvD;;;OAGG;0BACkB,0BAA0B,GAAG,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IA0BpH;;;;;OAKG;sBACc,cAAc;IAa/B;;;;OAIG;0BACkB,cAAc;IAcnC;;;OAGG;6BACqB,cAAc;IAetC;;;;;OAKG;8BACsB,cAAc;IAevC;;;;OAIG;0BACkB,cAAc;CAYlC,CAAC"}
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAY,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAIvG;;;;;GAKG;AACH,KAAK,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0BxF;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAA;CAAE,CAAC;AACnI,4HAA4H;AAC5H,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACrH;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AACF,yHAAyH;AACzH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAapH;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;IAC/E,8GAA8G;IAC9G,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AASF,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;oBACY,cAAc;+BAaH,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAYjE;;;;OAIG;8BACsB,wBAAwB;yBAa7B,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAM3D;;;OAGG;wBACgB,kBAAkB;IAUrC;;;OAGG;uCAC+B,iCAAiC;IAWnE;;;;OAIG;6BACqB,uBAAuB;IAe/C;;;OAGG;2BACmB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;qBAe7C,wBAAwB;qBAcxB,wBAAwB;IAcxC;;;;;;;;;;;OAWG;yBACiB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG;QAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACvD,4GAA4G;QAC5G,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;KACrD;IAeD;;;;OAIG;qBACa,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAmBvD;;;OAGG;0BAEkB,0BAA0B,GAAG,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IA2B9H;;;;;;;;OAQG;sBACc,cAAc;IAa/B;;;;OAIG;0BACkB,cAAc;IAcnC;;;OAGG;6BACqB,cAAc;IAetC;;;;;OAKG;8BACsB,cAAc;IAevC;;;;OAIG;0BACkB,cAAc;CAYlC,CAAC"}

package/dist/engine/agent-api/nodes/effects.js

@@ -27,6 +27,23 @@ function withEmitterOptions(value, options) {
     }
     return value;
 }
+/**
+ * Record a GU47 option field on the node only when the caller passed it, so
+ * existing scenes keep byte-identical node snapshots. `AuraEffectNode` (E-D
+ * owned) has no typed slot for these fields yet; they ride as data like the
+ * §6.2 emitter options above.
+ */
+function withDefinedField(value, key, fieldValue) {
+    if (fieldValue !== undefined)
+        value[key] = fieldValue;
+    return value;
+}
+const weatherAuthored = (options) => ({
+    ...(options.name !== undefined ? { name: options.name } : {}),
+    ...(options.size !== undefined ? { size: options.size } : {}),
+    ...(options.radius !== undefined ? { radius: options.radius } : {}),
+    ...(options.seed !== undefined ? { seed: options.seed } : {})
+});
 export const vfxEffectBuilders = lazyNamespace(() => ({
     /**
      * §6.6/F-07-01 — the builder records ONLY authored fields; C-21 defaults are
@@ -58,7 +75,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
      * node (never plain fog) that submits the depth-aware inscatter pass plus
      * forward GPU height-fog terms. quality "off" keeps forward exp2 fog only.
      */
-    volumetricFog: (options = {}) => new AuraNodeBuilder({
+    volumetricFog: (options = {}) => new AuraNodeBuilder(withDefinedField({
         kind: "effect",
         effect: "volumetric-fog",
         name: options.name ?? "volumetric fog inscatter",
@@ -69,7 +86,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         ...(options.lightPosition ? { lightPosition: options.lightPosition } : {}),
         ...(options.heightFalloff !== undefined ? { heightFalloff: options.heightFalloff } : {}),
         ...(options.heightReference !== undefined ? { heightReference: options.heightReference } : {})
-    }),
+    }, "godRayDensity", options.godRayDensity)),
     depthFog: (options = {}) => effects.fog({
         density: options.density ?? 0.14,
         color: options.color ?? "#7aa2d6",
@@ -79,7 +96,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
      * Root outline node (muse3jsparity-PRD A3): native outline pass, width in
      * pixels clamped to the device range 1-6 by the bridge.
      */
-    outline: (options = {}) => new AuraNodeBuilder({
+    outline: (options = {}) => new AuraNodeBuilder(withDefinedField({
         kind: "effect",
         effect: "outline",
         name: options.name ?? "outline",
@@ -87,7 +104,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         width: options.width ?? 3,
         threshold: options.threshold ?? 0.12,
         intensity: options.intensity ?? 0.9
-    }),
+    }, "targets", options.targets !== undefined ? [...options.targets] : undefined)),
     /**
      * Root screen-space reflections node (muse3jsparity-PRD A3): submits the
      * native SSR pass against renderer-owned depth where available.
@@ -96,14 +113,18 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         kind: "effect",
         effect: "screen-space-reflections",
         name: options.name ?? "screen space reflections",
-        intensity: options.intensity ?? 0.9
+        intensity: options.intensity ?? 0.9,
+        // GU47 E-C handoff (eint EC-2): the S3 fields the v2 bridge reads, only when authored.
+        ...(options.maxDistance !== undefined ? { maxDistance: options.maxDistance } : {}),
+        ...(options.roughness !== undefined ? { roughness: options.roughness } : {}),
+        ...(options.thickness !== undefined ? { thickness: options.thickness } : {})
     }),
     /**
      * Root depth-of-field node (muse3jsparity-PRD A3). focus is a
      * linear-distance fraction (0 = near plane, 1 = far plane); aperture widens
      * the focus transition band (game-tuned control, not a physical f-stop).
      */
-    depthOfField: (options = {}) => new AuraNodeBuilder({
+    depthOfField: (options = {}) => new AuraNodeBuilder(withDefinedField({
         kind: "effect",
         effect: "depth-of-field",
         name: options.name ?? "depth of field",
@@ -116,7 +137,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         ...(options.fStop !== undefined ? { fStop: options.fStop } : {}),
         ...(options.focalLength !== undefined ? { focalLength: options.focalLength } : {}),
         postAuthored: options.postAuthored ?? Object.keys(options).filter((key) => key !== "postAuthored")
-    }),
+    }, "tiltShift", options.tiltShift !== undefined ? { ...options.tiltShift } : undefined)),
     /**
      * Root motion-blur node: renderer-owned GPU velocity for opaque rigid geometry.
      * Unsupported deforming/transparent/instanced geometry emits a named warning.
@@ -145,7 +166,8 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         wind: options.wind ?? [-0.32, -5.4, -0.16],
         particleCount: options.particleCount,
         splashes: options.splashes ?? true,
-        mist: options.mist ?? true
+        mist: options.mist ?? true,
+        ...weatherAuthored(options)
     }),
     snow: (options = {}) => new AuraNodeBuilder({
         kind: "effect",
@@ -157,14 +179,20 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         wind: options.wind ?? [-0.85, -1.1, -0.22],
         particleCount: options.particleCount,
         splashes: options.splashes ?? false,
-        mist: options.mist ?? true
+        mist: options.mist ?? true,
+        ...weatherAuthored(options)
     }),
     /**
      * Flipbook explosion/muzzle-flash sprite sheet (muse3jsparity-PRD D4).
      * Under A3D_QR_VFX it draws through the particle pass: one upright sprite
      * of world `size`, frame = age · `frameRate` over `spriteColumns ×
-     * spriteRows` (wrapping unless `loop: false`), sampling the built-in
-     * seeded `fireball` sheet. `prewarm` starts the sprite that many seconds in.
+     * spriteRows` (wrapping unless `loop: false`). The sheet is, in order:
+     * `texture` (GU47 E-F: a typed texture asset such as an `aura3d-game-art`
+     * sheet, straight alpha, frame 0 in the top-left cell, grid `spriteColumns ×
+     * spriteRows`), a built-in atlas `sprite` name (its own grid, e.g.
+     * "flame-loop"), else the built-in seeded `fireball` sheet. A texture or
+     * sprite draws the soft-dot until it has loaded. `prewarm` starts the
+     * sprite that many seconds in.
      */
     flipbook: (options = {}) => {
         const columns = options.spriteColumns ?? 4;
@@ -183,8 +211,8 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
     },
     /**
      * Additive thick light beam / fence strip (muse3jsparity-PRD D4): recorded
-     * with a validated quad-strip descriptor, but withheld — root has no native
-     * beam target yet, so no pass is submitted.
+     * with a validated quad-strip descriptor and drawn by the prd07.beams pass
+     * under A3D_QR_VFX (camera-facing strip from `from` to `to`).
      */
     beam: (options = {}) => {
         const descriptor = createBeamDescriptor({
@@ -209,6 +237,7 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
      * PRD-07 §6.2 emitter surface: accepts `AuraParticleEmitterOptions` plus the
      * legacy fields; every defined option rides the node to lowering.
      */
+    // GU47 pass 4 (g13 DD47-V2): the node's `speed: number` no longer narrows the emitter's `speed: AuraRange`.
     particles: (options = {}) => new AuraNodeBuilder(withEmitterOptions({
         kind: "effect",
         effect: "particles",
@@ -216,7 +245,8 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
         intensity: options.intensity ?? 0.8,
         density: options.density ?? 1,
         color: options.color ?? "#7dfcff",
-        speed: options.speed ?? 1,
+        // a `[min, max]` range rides to lowering through withEmitterOptions below, as before
+        speed: typeof options.speed === "number" ? options.speed : 1,
         particleCount: options.particleCount ?? 2400,
         emitter: options.emitter ?? "fountain",
         radius: options.radius ?? 1.15,
@@ -236,8 +266,11 @@ export const vfxEffectBuilders = lazyNamespace(() => ({
     /**
      * P2-T5 §6.2.9 trail ribbon: the node carries the ring options; lowering
      * maps it to a `RibbonTrail` on the prd07 RibbonBatch. `target` is a runtime
-     * node id, `handle.socket(bone)` (C-19), or a callback — resolved by the
-     * production system, never by the builder.
+     * node id or `{ node, socket }` — resolved by the production system every
+     * frame (GU47 E-F), never by the builder. Optional `life` (seconds) fades
+     * and drops old points (absent: a ring of `maxPoints`); optional
+     * `widthOverSpeed: [min, max]` (m/s) ramps the width by the target's speed.
+     * For a trail started from game code use `app.effects.trail(target, opts)`.
      */
     trail: (options = {}) => new AuraNodeBuilder(withEmitterOptions({
         kind: "effect",

package/dist/engine/agent-api/nodes/effects.js.map

@@ -1 +1 @@
-{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAGxG,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUpD;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAA2C,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAA2B,KAAQ,EAAE,OAA0C;IACxG,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CACpC,IAAI,eAAe,CACjB,kBAAkB,CAChB;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,EACD,OAA4C,CAC7C,CACF;IACH,cAAc,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACxE,OAAO,CAAC,KAAK,CAAC;QACZ,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;IACJ;;;;OAIG;IACH,aAAa,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACvE,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,0BAA0B;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;IACJ,QAAQ,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CAClE,OAAO,CAAC,GAAG,CAAC;QACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;KACrC,CAAC;IACJ;;;OAGG;IACH,OAAO,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACjE,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;KACpC,CAAC;IACJ;;;OAGG;IACH,sBAAsB,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CAChF,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,0BAA0B;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,0BAA0B;QAChD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;KACpC,CAAC;IACJ;;;;OAIG;IACH,YAAY,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACtE,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC7B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,wEAAwE;QACxE,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC;KACnG,CAAC;IACJ;;;OAGG;IACH,UAAU,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACpE,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,2EAA2E;QAC3E,uEAAuE;QACvE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC;KACnG,CAAC;IACJ,IAAI,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CAC9D,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;KAC3B,CAAC;IACJ,IAAI,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CAC9D,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;KAC3B,CAAC;IACJ;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,UAOP,EAAE,EAAE,EAAE;QACR,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QACrC,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,eAAe,CAAiB,kBAAkB,CAAC;YAC5D,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,2BAA2B;YACjD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;YACjC,aAAa,EAAE,OAAO;YACtB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;SACnC,EAAE,OAAO,CAAC,CAAC,CAAC;IACf,CAAC;IACD;;;;OAIG;IACH,IAAI,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE;QAC9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC,CAAC;QACH,OAAO,IAAI,eAAe,CAAiB;YACzC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;YACjC,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAa;YACtC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAa;YAClC,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,YAAY,EAAE,UAAU,CAAC,YAAY;SACtC,CAAC,CAAC;IACL,CAAC;IACD;;;OAGG;IACH,SAAS,EAAE,CAAC,UAA2G,EAAE,EAAE,EAAE,CAC3H,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,kBAAkB;QACxE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;QACvG,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACpD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;QACrD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;QAC7D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;KAC7B,EAAE,OAA6C,CAAC,CAAC;IAErD;;;;;OAKG;IACH,KAAK,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CACtC,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,cAAc;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACpD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ;KAC7C,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC1C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG;KAClC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;OAGG;IACH,YAAY,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC7C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe;QACrC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,GAAG;KAChC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,aAAa,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC9C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa;KACpC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC1C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,GAAG;QACzD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG;KAC5C,EAAE,OAA6C,CAAC,CAAC;CACrD,CAAC,CAAC,CAAC"}
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAGxG,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUpD;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAA2C,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAA2B,KAAQ,EAAE,OAA0C;IACxG,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AA6BD;;;;;GAKG;AACH,SAAS,gBAAgB,CAA2B,KAAQ,EAAE,GAAW,EAAE,UAAmB;IAC5F,IAAI,UAAU,KAAK,SAAS;QAAG,KAAiC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACnF,OAAO,KAAK,CAAC;AACf,CAAC;AAaD,MAAM,eAAe,GAAG,CAAC,OAAiC,EAA2B,EAAE,CAAC,CAAC;IACvF,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC9D,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CACpC,IAAI,eAAe,CACjB,kBAAkB,CAChB;QACE,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;QACb,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,EACD,OAA4C,CAC7C,CACF;IACH,cAAc,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACxE,OAAO,CAAC,KAAK,CAAC;QACZ,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;IACJ;;;;OAIG;IACH,aAAa,EAAE,CAAC,UAAoC,EAAE,EAAE,EAAE,CACxD,IAAI,eAAe,CAAiB,gBAAgB,CAAC;QACnD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,0BAA0B;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,EAAE,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CAClE,OAAO,CAAC,GAAG,CAAC;QACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;KACrC,CAAC;IACJ;;;OAGG;IACH,OAAO,EAAE,CAAC,UAA8B,EAAE,EAAE,EAAE,CAC5C,IAAI,eAAe,CAAiB,gBAAgB,CAAC;QACnD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;KACpC,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClF;;;OAGG;IACH,sBAAsB,EAAE,CAAC,UAA6C,EAAE,EAAE,EAAE,CAC1E,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,0BAA0B;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,0BAA0B;QAChD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,uFAAuF;QACvF,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,CAAC,UAAmC,EAAE,EAAE,EAAE,CACtD,IAAI,eAAe,CAAiB,gBAAgB,CAAC;QACnD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,gBAAgB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC7B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,wEAAwE;QACxE,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC;KACnG,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1F;;;OAGG;IACH,UAAU,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE,CACpE,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,2EAA2E;QAC3E,uEAAuE;QACvE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC;KACnG,CAAC;IACJ,IAAI,EAAE,CAAC,UAAoC,EAAE,EAAE,EAAE,CAC/C,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,GAAG,eAAe,CAAC,OAAO,CAAC;KAC5B,CAAC;IACJ,IAAI,EAAE,CAAC,UAAoC,EAAE,EAAE,EAAE,CAC/C,IAAI,eAAe,CAAiB;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,GAAG,eAAe,CAAC,OAAO,CAAC;KAC5B,CAAC;IACJ;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,CAAC,UASP,EAAE,EAAE,EAAE;QACR,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QACrC,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,eAAe,CAAiB,kBAAkB,CAAC;YAC5D,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,2BAA2B;YACjD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;YACjC,aAAa,EAAE,OAAO;YACtB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;SACnC,EAAE,OAAO,CAAC,CAAC,CAAC;IACf,CAAC;IACD;;;;OAIG;IACH,IAAI,EAAE,CAAC,UAAmD,EAAE,EAAE,EAAE;QAC9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/B,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC,CAAC;QACH,OAAO,IAAI,eAAe,CAAiB;YACzC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,qBAAqB;YAC3C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;YACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;YACjC,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAa;YACtC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAa;YAClC,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,YAAY,EAAE,UAAU,CAAC,YAAY;SACtC,CAAC,CAAC;IACL,CAAC;IACD;;;OAGG;IACH,4GAA4G;IAC5G,SAAS,EAAE,CAAC,UAAqH,EAAE,EAAE,EAAE,CACrI,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,kBAAkB;QACxE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,qFAAqF;QACrF,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5D,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;QACvG,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACpD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC;QACrD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;QAC7D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;KAC7B,EAAE,OAA6C,CAAC,CAAC;IAErD;;;;;;;;OAQG;IACH,KAAK,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CACtC,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,cAAc;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACpD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ;KAC7C,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC1C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG;KAClC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;OAGG;IACH,YAAY,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC7C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe;QACrC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;QACvC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC;QAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,GAAG;KAChC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,aAAa,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC9C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE;QAC1C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,GAAG;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa;KACpC,EAAE,OAA6C,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,EAAE,CAAC,UAA0B,EAAE,EAAE,EAAE,CAC1C,IAAI,eAAe,CAAiB,kBAAkB,CAAC;QACrD,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;QACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,GAAG;QACzD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG;KAC5C,EAAE,OAA6C,CAAC,CAAC;CACrD,CAAC,CAAC,CAAC"}

package/dist/engine/agent-api/nodes/effects.post.d.ts

@@ -14,17 +14,73 @@ export interface PostV3EffectOptions extends Omit<AuraEffectNode, "kind" | "effe
     readonly size?: number;
     readonly luminanceResponse?: number;
 }
+/** GU47 E-C: a per-channel grade term — a scalar applies to all three channels. */
+export type AuraGradeRgb = number | readonly [number, number, number] | {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+};
+/**
+ * GU47 E-C (PRD §3.1): `colorGrade({ lut })` takes a typed `.cube` asset
+ * (`aura3d assets add <file.cube> --type lut` → `assets.<name>`), i.e.
+ * `AuraAssetRef<"lut">` (`AuraAssetType` includes `"lut"`). This structural
+ * type accepts that typed ref as well as hand-built refs, and a plain served
+ * URL string (`"/luts/venue.cube"`) is accepted too.
+ */
+export interface AuraLutAssetRef {
+    readonly kind: "aura-asset-ref";
+    readonly id: string;
+    readonly type: "lut";
+    readonly url: string;
+    readonly format?: string;
+    readonly hash?: string;
+    readonly sha256?: string;
+}
+/**
+ * GU47 E-C: `effects.colorGrade` options. `exposure`/`contrast`/`saturation`
+ * as before; the HDR terms reach pixels through the S10 linear grade
+ * (`post/shaders/hdrGrade.glsl.ts`): `temperature`/`tint` in [-1, 1]
+ * (0 neutral, +temperature warmer, +tint magenta; 0.2 ≈ a "+20" white-balance
+ * slider), `lift` (additive, default 0), `gamma`/`gain` (default 1) and the
+ * `shadows`/`midtones`/`highlights` multipliers (default 1). `lut` binds a
+ * `.cube` in the S10b display grade at `lutIntensity` (0..1, default 1).
+ * The `AuraEffectNode` field widening is a lane E-D `nodes/types.ts` handoff;
+ * this local type keeps the factory typed until it lands.
+ */
+export interface AuraColorGradeOptions extends Omit<AuraEffectNode, "kind" | "effect" | "shadows" | "highlights" | "lut"> {
+    readonly temperature?: number;
+    readonly tint?: number;
+    readonly vibrance?: number;
+    readonly lift?: AuraGradeRgb;
+    readonly gamma?: AuraGradeRgb;
+    readonly gain?: AuraGradeRgb;
+    readonly shadows?: AuraGradeRgb;
+    readonly midtones?: AuraGradeRgb;
+    readonly highlights?: AuraGradeRgb;
+    readonly lut?: AuraLutAssetRef | string;
+    readonly lutIntensity?: number;
+}
+/**
+ * `effects.bloom` options: the node fields plus the v2 bright-pass `knee`
+ * (0..1) and `clampLuminance` (0..64), copied onto the node when authored so
+ * the v2 bridge (`mapBloomOptionsV2`) reads them (GU47 E-A handoff).
+ */
+type BloomBuilderOptions = Omit<AuraEffectNode, "kind" | "effect"> & {
+    readonly knee?: number;
+    readonly clampLuminance?: number;
+};
 export declare const postEffectBuilders: {
-    bloom: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    bloom: (options?: BloomBuilderOptions) => AuraNodeBuilder<AuraEffectNode>;
     neonBloom: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     ambientOcclusion: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     contactOcclusion: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
     /**
-     * Root color-grade node (muse3jsparity-PRD A3). contrast/saturation execute
-     * natively; exposure/shadows/highlights/lut are recorded on the node and
-     * warned (no native grade target yet — never silently accepted).
+     * Root color-grade node (muse3jsparity-PRD A3). contrast/saturation run in
+     * the fused present; GU47 E-C: temperature/tint/lift/gamma/gain/shadows/
+     * midtones/highlights run in the S10 linear grade and `lut` (a `.cube`
+     * asset or URL) in the S10b display grade on the v2 chain.
      */
-    colorGrade: (options?: Omit<AuraEffectNode, "kind" | "effect">) => AuraNodeBuilder<AuraEffectNode>;
+    colorGrade: (options?: AuraColorGradeOptions) => AuraNodeBuilder<AuraEffectNode>;
     /**
      * Root anti-alias node (muse3jsparity-PRD A3). `fxaa` executes natively;
      * `off` submits nothing; `taa` uses renderer-owned velocity/history for opaque
@@ -76,4 +132,5 @@ export interface AuraShaderPassOptions {
     /** `false` keeps the pass registered but skips execution. */
     readonly enabled?: boolean;
 }
+export {};
 //# sourceMappingURL=effects.post.d.ts.map

package/dist/engine/agent-api/nodes/effects.post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effects.post.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.post.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;;;GAKG;AAGH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAID,eAAO,MAAM,kBAAkB;sBACZ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;0BA4BnC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;iCAahC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;iCAcvC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAanE;;;;OAIG;2BACmB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAc7D;;;;OAIG;0BACkB,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC;IAY5D;;;;;OAKG;yBACiB,mBAAmB;IAWvC,kFAAkF;0BAC7D,mBAAmB;IAUxC,6EAA6E;oCAC9C,mBAAmB;IASlD;;;;;;;;;;;OAWG;0BACmB,qBAAqB,KAAG,kBAAkB;CAyDjE,CAAC;AAIF,2GAA2G;AAC3G,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC;IAC9D,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"effects.post.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/nodes/effects.post.ts"],"names":[],"mappings":"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"}