@aura3d/rendering 1.0.6

package/dist/effects/Particle.js

@@ -0,0 +1,56 @@
+export function createVector3(value = {}) {
+    return {
+        x: value.x ?? 0,
+        y: value.y ?? 0,
+        z: value.z ?? 0,
+    };
+}
+export function cloneVector3(value) {
+    return { x: value.x, y: value.y, z: value.z };
+}
+export function addScaledVector3(target, source, scale) {
+    target.x += source.x * scale;
+    target.y += source.y * scale;
+    target.z += source.z * scale;
+}
+export function setVector3(target, source) {
+    target.x = source.x;
+    target.y = source.y;
+    target.z = source.z;
+}
+export function createColor(value = {}) {
+    return {
+        r: value.r ?? 1,
+        g: value.g ?? 1,
+        b: value.b ?? 1,
+        a: value.a ?? 1,
+    };
+}
+export function cloneColor(value) {
+    return { r: value.r, g: value.g, b: value.b, a: value.a };
+}
+export function createParticle(initial = {}) {
+    if ((initial.lifetime ?? 1) <= 0) {
+        throw new RangeError("Particle lifetime must be greater than zero.");
+    }
+    const position = createVector3(initial.position);
+    return {
+        id: initial.id ?? 0,
+        age: initial.age ?? 0,
+        lifetime: initial.lifetime ?? 1,
+        position,
+        previousPosition: cloneVector3(position),
+        velocity: createVector3(initial.velocity),
+        acceleration: createVector3(initial.acceleration),
+        color: createColor(initial.color),
+        size: initial.size ?? 1,
+        rotation: initial.rotation ?? 0,
+        angularVelocity: initial.angularVelocity ?? 0,
+        alive: initial.alive ?? true,
+        userData: { ...(initial.userData ?? {}) },
+    };
+}
+export function normalizedParticleAge(particle) {
+    return particle.lifetime <= 0 ? 1 : Math.min(Math.max(particle.age / particle.lifetime, 0), 1);
+}
+//# sourceMappingURL=Particle.js.map

package/dist/effects/Particle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Particle.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/Particle.ts"],"names":[],"mappings":"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"}

package/dist/effects/ParticleDiagnostics.d.ts

@@ -0,0 +1,58 @@
+import type { GPUParticleBackendCapabilities } from "./GPUParticleBackend.js";
+export interface ParticleBatchDiagnosticsInput {
+    readonly name: string;
+    readonly particleCount: number;
+    readonly drawCalls?: number;
+    readonly staticBytesPerParticle?: number;
+    readonly dynamicBytesPerParticle?: number;
+}
+export interface ParticleBatchDiagnosticsOptions {
+    readonly updateMode: "static-geometry" | "cpu-dynamic" | "gpu-compute";
+    readonly backend?: GPUParticleBackendCapabilities;
+    readonly targetFrameMs?: number;
+}
+export interface ParticleBatchDiagnostics {
+    readonly batches: readonly ParticleBatchDiagnosticsInput[];
+    readonly totalParticles: number;
+    readonly totalDrawCalls: number;
+    readonly staticGeometryBytes: number;
+    readonly dynamicUploadBytes: number;
+    readonly updateMode: ParticleBatchDiagnosticsOptions["updateMode"];
+    readonly gpuBackend: GPUParticleBackendCapabilities;
+    readonly warnings: readonly string[];
+}
+export interface ParticleLayerBudgetInput {
+    readonly name: string;
+    readonly weight: number;
+}
+export interface ParticleDensityTier<TMode extends string = string> {
+    readonly threshold: number;
+    readonly label: string;
+    readonly mode: TMode;
+}
+export interface LayeredParticleBudgetOptions<TMode extends string = string> {
+    readonly requestedParticles: number;
+    readonly defaultParticles?: number;
+    readonly minParticles: number;
+    readonly maxParticles: number;
+    readonly layers: readonly ParticleLayerBudgetInput[];
+    readonly densityTiers: readonly ParticleDensityTier<TMode>[];
+    readonly nativeGpuComputeDispatches?: number;
+}
+export interface ParticleLayerBudget {
+    readonly name: string;
+    readonly weight: number;
+    readonly particleCount: number;
+}
+export interface LayeredParticleBudgetPlan<TMode extends string = string> {
+    readonly requestedParticles: number;
+    readonly effectiveParticles: number;
+    readonly densityTier: string;
+    readonly mode: TMode;
+    readonly layers: readonly ParticleLayerBudget[];
+    readonly nativeGpuComputeDispatches: number;
+}
+export declare function createParticleBatchDiagnostics(batches: readonly ParticleBatchDiagnosticsInput[], options: ParticleBatchDiagnosticsOptions): ParticleBatchDiagnostics;
+export declare function summarizeParticleBatchDiagnostics(diagnostics: ParticleBatchDiagnostics): readonly string[];
+export declare function createLayeredParticleBudgetPlan<TMode extends string>(options: LayeredParticleBudgetOptions<TMode>): LayeredParticleBudgetPlan<TMode>;
+//# sourceMappingURL=ParticleDiagnostics.d.ts.map

package/dist/effects/ParticleDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleDiagnostics.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleDiagnostics.ts"],"names":[],"mappings":"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"}

package/dist/effects/ParticleDiagnostics.js

@@ -0,0 +1,145 @@
+const POSITION_ONLY_BYTES = 3 * Float32Array.BYTES_PER_ELEMENT;
+const SPRITE_UPLOAD_BYTES = (3 + 4 + 1 + 1) * Float32Array.BYTES_PER_ELEMENT;
+export function createParticleBatchDiagnostics(batches, options) {
+    let totalParticles = 0;
+    let totalDrawCalls = 0;
+    let staticGeometryBytes = 0;
+    let dynamicUploadBytes = 0;
+    for (const batch of batches) {
+        validateParticleBatch(batch);
+        totalParticles += batch.particleCount;
+        totalDrawCalls += batch.drawCalls ?? 1;
+        staticGeometryBytes += batch.particleCount * (batch.staticBytesPerParticle ?? POSITION_ONLY_BYTES);
+        dynamicUploadBytes += batch.particleCount * (batch.dynamicBytesPerParticle ?? SPRITE_UPLOAD_BYTES);
+    }
+    const gpuBackend = options.backend ?? {
+        supported: false,
+        backend: "none",
+        reason: "No GPU particle backend capability report was supplied."
+    };
+    const warnings = createParticleWarnings(totalParticles, dynamicUploadBytes, options, gpuBackend);
+    return {
+        batches,
+        totalParticles,
+        totalDrawCalls,
+        staticGeometryBytes,
+        dynamicUploadBytes,
+        updateMode: options.updateMode,
+        gpuBackend,
+        warnings
+    };
+}
+export function summarizeParticleBatchDiagnostics(diagnostics) {
+    const gpu = diagnostics.gpuBackend.supported
+        ? `${diagnostics.gpuBackend.backend}${diagnostics.gpuBackend.adapterName ? `:${diagnostics.gpuBackend.adapterName}` : ""}`
+        : `${diagnostics.gpuBackend.backend}:unsupported`;
+    return [
+        `${diagnostics.totalParticles.toLocaleString("en-US")} particles across ${diagnostics.batches.length} A3D point batches`,
+        `${diagnostics.totalDrawCalls} particle draw batches, ${formatBytes(diagnostics.staticGeometryBytes)} static point data`,
+        `${formatBytes(diagnostics.dynamicUploadBytes)} estimated CPU sprite upload if updated as dynamic particles`,
+        `particle update path: ${diagnostics.updateMode}; accelerator backend: ${gpu}`,
+        ...diagnostics.warnings
+    ];
+}
+export function createLayeredParticleBudgetPlan(options) {
+    validateLayeredBudgetOptions(options);
+    const requestedParticles = Number.isFinite(options.requestedParticles)
+        ? Math.round(options.requestedParticles)
+        : Math.round(options.defaultParticles ?? options.minParticles);
+    const effectiveParticles = Math.min(options.maxParticles, Math.max(options.minParticles, requestedParticles));
+    const layers = [];
+    let assigned = 0;
+    for (let index = 0; index < options.layers.length; index += 1) {
+        const layer = options.layers[index];
+        const isLast = index === options.layers.length - 1;
+        const particleCount = isLast
+            ? Math.max(0, effectiveParticles - assigned)
+            : Math.ceil(effectiveParticles * layer.weight);
+        assigned += particleCount;
+        layers.push({
+            name: layer.name,
+            weight: layer.weight,
+            particleCount
+        });
+    }
+    const densityTier = [...options.densityTiers]
+        .sort((a, b) => b.threshold - a.threshold)
+        .find((tier) => effectiveParticles >= tier.threshold) ?? options.densityTiers[options.densityTiers.length - 1];
+    return {
+        requestedParticles,
+        effectiveParticles,
+        densityTier: densityTier.label,
+        mode: densityTier.mode,
+        layers,
+        nativeGpuComputeDispatches: Math.max(0, Math.round(options.nativeGpuComputeDispatches ?? 0))
+    };
+}
+function validateParticleBatch(batch) {
+    if (!Number.isInteger(batch.particleCount) || batch.particleCount < 0) {
+        throw new RangeError("Particle batch particleCount must be a non-negative integer.");
+    }
+    if (batch.drawCalls !== undefined && (!Number.isInteger(batch.drawCalls) || batch.drawCalls < 0)) {
+        throw new RangeError("Particle batch drawCalls must be a non-negative integer.");
+    }
+    if (batch.staticBytesPerParticle !== undefined && (!Number.isFinite(batch.staticBytesPerParticle) || batch.staticBytesPerParticle < 0)) {
+        throw new RangeError("Particle batch staticBytesPerParticle must be finite and non-negative.");
+    }
+    if (batch.dynamicBytesPerParticle !== undefined && (!Number.isFinite(batch.dynamicBytesPerParticle) || batch.dynamicBytesPerParticle < 0)) {
+        throw new RangeError("Particle batch dynamicBytesPerParticle must be finite and non-negative.");
+    }
+}
+function validateLayeredBudgetOptions(options) {
+    if (!Number.isFinite(options.minParticles) || !Number.isInteger(options.minParticles) || options.minParticles < 0) {
+        throw new RangeError("Layered particle budget minParticles must be a non-negative integer.");
+    }
+    if (options.defaultParticles !== undefined && (!Number.isFinite(options.defaultParticles) || !Number.isInteger(options.defaultParticles))) {
+        throw new RangeError("Layered particle budget defaultParticles must be an integer when supplied.");
+    }
+    if (!Number.isFinite(options.maxParticles) || !Number.isInteger(options.maxParticles) || options.maxParticles < options.minParticles) {
+        throw new RangeError("Layered particle budget maxParticles must be an integer greater than or equal to minParticles.");
+    }
+    if (options.layers.length === 0) {
+        throw new RangeError("Layered particle budget requires at least one layer.");
+    }
+    for (const layer of options.layers) {
+        if (!layer.name.trim())
+            throw new RangeError("Layered particle budget layer names must be non-empty.");
+        if (!Number.isFinite(layer.weight) || layer.weight < 0 || layer.weight > 1) {
+            throw new RangeError("Layered particle budget layer weights must be finite values from 0 to 1.");
+        }
+    }
+    if (options.densityTiers.length === 0) {
+        throw new RangeError("Layered particle budget requires at least one density tier.");
+    }
+    for (const tier of options.densityTiers) {
+        if (!Number.isFinite(tier.threshold) || !Number.isInteger(tier.threshold) || tier.threshold < 0) {
+            throw new RangeError("Layered particle budget density tier thresholds must be non-negative integers.");
+        }
+        if (!tier.label.trim())
+            throw new RangeError("Layered particle budget density tier labels must be non-empty.");
+    }
+}
+function createParticleWarnings(totalParticles, dynamicUploadBytes, options, backend) {
+    const warnings = [];
+    if (options.updateMode !== "gpu-compute") {
+        warnings.push("CPU/static particle update path; positions are generated on CPU and animated by render-item transforms");
+    }
+    if (!backend.supported) {
+        warnings.push(backend.reason ?? "GPU particle backend is unavailable in this runtime");
+    }
+    if (totalParticles >= 50000 && options.updateMode !== "gpu-compute") {
+        warnings.push("50k CPU-generated particles is a dense visualization tier, not a native compute-particle stress proof");
+    }
+    if (options.targetFrameMs !== undefined && dynamicUploadBytes / Math.max(1, options.targetFrameMs) > 750_000) {
+        warnings.push("dynamic CPU particle upload estimate is high for the target frame budget");
+    }
+    return warnings;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MiB`;
+}
+//# sourceMappingURL=ParticleDiagnostics.js.map

package/dist/effects/ParticleDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleDiagnostics.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleDiagnostics.ts"],"names":[],"mappings":"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"}

package/dist/effects/ParticleEffectPresets.d.ts

@@ -0,0 +1,8 @@
+import { ParticleSystem } from "./ParticleSystem.js";
+export type ParticleEffectPresetName = "fire" | "fountain" | "collision-burst" | "spark-shower";
+export interface ParticleEffectPresetOptions {
+    readonly seed?: number;
+    readonly maxParticles?: number;
+}
+export declare function createParticleEffectPreset(name: ParticleEffectPresetName, options?: ParticleEffectPresetOptions): ParticleSystem;
+//# sourceMappingURL=ParticleEffectPresets.d.ts.map

package/dist/effects/ParticleEffectPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleEffectPresets.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleEffectPresets.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAEhG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,GAAE,2BAAgC,GACxC,cAAc,CAOhB"}

package/dist/effects/ParticleEffectPresets.js

@@ -0,0 +1,137 @@
+import { CollisionModule } from "./CollisionModule.js";
+import { ColorModule } from "./ColorModule.js";
+import { ForceModule } from "./ForceModule.js";
+import { ParticleEmitter } from "./ParticleEmitter.js";
+import { ParticleSystem } from "./ParticleSystem.js";
+import { SizeModule } from "./SizeModule.js";
+export function createParticleEffectPreset(name, options = {}) {
+    if (name === "fire")
+        return createFirePreset(options);
+    if (name === "fountain")
+        return createFountainPreset(options);
+    if (name === "collision-burst")
+        return createCollisionBurstPreset(options);
+    if (name === "spark-shower")
+        return createSparkShowerPreset(options);
+    const exhaustive = name;
+    throw new Error(`Unsupported particle effect preset: ${exhaustive}`);
+}
+function createSparkShowerPreset(options) {
+    return new ParticleSystem({
+        maxParticles: options.maxParticles ?? 160,
+        emitters: [
+            new ParticleEmitter({
+                seed: options.seed ?? 404,
+                emissionRate: 0,
+                bursts: [{ time: 0, count: 48 }],
+                lifetime: { min: 0.55, max: 1.1 },
+                speed: { min: 0.55, max: 1.15 },
+                shape: { type: "cone", origin: { x: 0, y: 0.12, z: 0 }, radius: 0.22, length: 0.36, angle: Math.PI / 7, emitFromVolume: true },
+                initial: { size: 0.055, color: { r: 1, g: 0.78, b: 0.25, a: 1 } }
+            })
+        ],
+        modules: [
+            new ForceModule({ x: 0.16, y: -1.4, z: 0 }),
+            new ColorModule([
+                { time: 0, color: { r: 1, g: 0.92, b: 0.42, a: 1 } },
+                { time: 0.55, color: { r: 1, g: 0.35, b: 0.1, a: 0.8 } },
+                { time: 1, color: { r: 0.35, g: 0.08, b: 0.04, a: 0.08 } }
+            ]),
+            new SizeModule([
+                { time: 0, size: 0.035 },
+                { time: 0.22, size: 0.075 },
+                { time: 1, size: 0.012 }
+            ]),
+            new CollisionModule({ normal: { x: 0, y: 1, z: 0 }, constant: 0, restitution: 0.18 })
+        ]
+    });
+}
+function createFirePreset(options) {
+    return new ParticleSystem({
+        maxParticles: options.maxParticles ?? 260,
+        emitters: [
+            new ParticleEmitter({
+                seed: options.seed ?? 101,
+                emissionRate: 180,
+                lifetime: { min: 0.85, max: 1.25 },
+                speed: { min: 0.3, max: 0.75 },
+                shape: { type: "cone", origin: { x: 0, y: 0.05, z: 0 }, radius: 0.28, length: 0.16, angle: Math.PI / 6, emitFromVolume: true },
+                initial: { size: 0.13 }
+            })
+        ],
+        modules: [
+            new ForceModule({ x: 0.02, y: 0.82, z: 0 }),
+            new ColorModule([
+                { time: 0, color: { r: 1, g: 0.92, b: 0.28, a: 1 } },
+                { time: 0.38, color: { r: 1, g: 0.38, b: 0.08, a: 0.88 } },
+                { time: 0.76, color: { r: 0.72, g: 0.12, b: 0.04, a: 0.36 } },
+                { time: 1, color: { r: 0.12, g: 0.1, b: 0.1, a: 0.08 } }
+            ]),
+            new SizeModule([
+                { time: 0, size: 0.05 },
+                { time: 0.28, size: 0.18 },
+                { time: 0.72, size: 0.13 },
+                { time: 1, size: 0.035 }
+            ])
+        ]
+    });
+}
+function createFountainPreset(options) {
+    return new ParticleSystem({
+        maxParticles: options.maxParticles ?? 220,
+        emitters: [
+            new ParticleEmitter({
+                seed: options.seed ?? 202,
+                emissionRate: 155,
+                lifetime: { min: 1.0, max: 1.4 },
+                speed: { min: 0.72, max: 1.15 },
+                shape: { type: "cone", origin: { x: 0, y: 0.08, z: 0 }, radius: 0.12, length: 0.12, angle: Math.PI / 5, emitFromVolume: true },
+                initial: { size: 0.075 }
+            })
+        ],
+        modules: [
+            new ForceModule({ x: 0, y: -0.78, z: 0 }),
+            new ColorModule([
+                { time: 0, color: { r: 0.55, g: 0.9, b: 1, a: 0.95 } },
+                { time: 0.58, color: { r: 0.18, g: 0.62, b: 1, a: 0.72 } },
+                { time: 1, color: { r: 0.1, g: 0.26, b: 1, a: 0.2 } }
+            ]),
+            new SizeModule([
+                { time: 0, size: 0.045 },
+                { time: 0.38, size: 0.09 },
+                { time: 1, size: 0.028 }
+            ])
+        ]
+    });
+}
+function createCollisionBurstPreset(options) {
+    return new ParticleSystem({
+        maxParticles: options.maxParticles ?? 96,
+        emitters: [
+            new ParticleEmitter({
+                seed: options.seed ?? 303,
+                emissionRate: 0,
+                bursts: [{ time: 0, count: 42 }],
+                lifetime: { min: 0.9, max: 1.6 },
+                speed: { min: 0.35, max: 0.95 },
+                shape: { type: "sphere", center: { x: 0, y: 0.56, z: 0 }, radius: 0.24 },
+                initial: { size: 0.1, color: { r: 0.45, g: 1, b: 0.58, a: 1 } }
+            })
+        ],
+        modules: [
+            new ForceModule({ x: 0, y: -2.2, z: 0 }),
+            new CollisionModule({ normal: { x: 0, y: 1, z: 0 }, constant: 0, restitution: 0.32 }),
+            new ColorModule([
+                { time: 0, color: { r: 0.7, g: 1, b: 0.62, a: 1 } },
+                { time: 0.5, color: { r: 0.22, g: 1, b: 0.7, a: 0.72 } },
+                { time: 1, color: { r: 0.08, g: 0.45, b: 0.22, a: 0.16 } }
+            ]),
+            new SizeModule([
+                { time: 0, size: 0.055 },
+                { time: 0.2, size: 0.12 },
+                { time: 1, size: 0.025 }
+            ])
+        ]
+    });
+}
+//# sourceMappingURL=ParticleEffectPresets.js.map

package/dist/effects/ParticleEffectPresets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleEffectPresets.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleEffectPresets.ts"],"names":[],"mappings":"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"}

package/dist/effects/ParticleEmitter.d.ts

@@ -0,0 +1,87 @@
+import { type Particle, type ParticleInitialState, type Vector3Like } from "./Particle.js";
+export interface ParticleBurst {
+    time: number;
+    count: number;
+    interval?: number;
+    cycles?: number;
+}
+export type ParticleEmitterShape = {
+    type: "point";
+    position?: Partial<Vector3Like>;
+} | {
+    type: "box";
+    center?: Partial<Vector3Like>;
+    size: Partial<Vector3Like>;
+} | {
+    type: "sphere";
+    center?: Partial<Vector3Like>;
+    radius: number;
+    shell?: boolean;
+} | {
+    type: "circle";
+    center?: Partial<Vector3Like>;
+    radius: number;
+    arc?: number;
+    filled?: boolean;
+} | {
+    type: "cone";
+    origin?: Partial<Vector3Like>;
+    radius: number;
+    length: number;
+    angle?: number;
+    emitFromVolume?: boolean;
+};
+export interface ParticleEmitterOptions {
+    seed?: number;
+    emissionRate?: number;
+    maxParticles?: number;
+    duration?: number;
+    looping?: boolean;
+    lifetime?: number | {
+        min: number;
+        max: number;
+    };
+    speed?: number | {
+        min: number;
+        max: number;
+    };
+    shape?: ParticleEmitterShape;
+    bursts?: readonly ParticleBurst[];
+    initial?: Omit<ParticleInitialState, "id" | "age" | "lifetime" | "position" | "velocity">;
+}
+export interface EmissionResult {
+    particles: Particle[];
+    requested: number;
+    emitted: number;
+}
+export declare class ParticleEmitter {
+    readonly random: () => number;
+    readonly maxParticles: number;
+    readonly bursts: readonly ParticleBurst[];
+    emissionRate: number;
+    duration: number;
+    looping: boolean;
+    lifetime: number | {
+        min: number;
+        max: number;
+    };
+    speed: number | {
+        min: number;
+        max: number;
+    };
+    shape: ParticleEmitterShape;
+    initial: Omit<ParticleInitialState, "id" | "age" | "lifetime" | "position" | "velocity">;
+    elapsedTime: number;
+    paused: boolean;
+    private emissionCarry;
+    private nextParticleId;
+    private burstExecutions;
+    constructor(options?: ParticleEmitterOptions);
+    reset(): void;
+    emit(deltaTime: number, capacity?: number): EmissionResult;
+    createParticle(): Particle;
+    private advanceTime;
+    private countContinuous;
+    private countBursts;
+}
+//# sourceMappingURL=ParticleEmitter.d.ts.map

package/dist/effects/ParticleEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleEmitter.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleEmitter.ts"],"names":[],"mappings":"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"}