@adobe/data-gpu 0.9.69

package/dist/graphics/scene/model/world-bounds-plugin.js

@@ -0,0 +1,93 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Aabb, Mat4x4 } from "@adobe/data/math";
+import { transform } from "../node/transform-plugin.js";
+import { modelLoader } from "./model-loader-plugin.js";
+/**
+ * worldBoundsCreate
+ *   query: Model-_worldBounds
+ *   write: _worldBounds   (archetype migration; unit placeholder)
+ *
+ *   Adds the `_worldBounds` column to any Model that doesn't have it yet, so
+ *   `worldBoundsSystem` can write directly without further migration.
+ *
+ * worldBoundsSystem
+ *   query: Model+_worldMatrix+_worldBounds
+ *   read:  geometry → _bounds, _worldMatrix
+ *   write: _worldBounds
+ *
+ *   Transforms the asset-space AABB on each Model's `geometry` by the Model's
+ *   `_worldMatrix` (all 8 corners, reduce to min/max) and writes the result.
+ *   Geometries still loading have no `_bounds` yet — those Models are skipped
+ *   until the asset finishes; their `_worldBounds` stays at its placeholder.
+ *
+ *   Cost: one matrix-vec multiply × 8 corners × N visible Models, per frame.
+ *   At N=1000 that's ~8K vec3 ops; well under 0.1ms on modern CPUs.
+ */
+export const worldBounds = Database.Plugin.create({
+    extends: Database.Plugin.combine(modelLoader, transform),
+    systems: {
+        worldBoundsCreate: {
+            schedule: { after: ["transformCreateWorldMatrix"] },
+            create: db => () => {
+                for (const arch of db.store.queryArchetypes(["geometry", "_worldMatrix"], { exclude: ["_worldBounds"] })) {
+                    const ids = arch.columns.id;
+                    // Iterate tail→head: every row migrates out of this archetype.
+                    for (let i = arch.rowCount - 1; i >= 0; i--) {
+                        db.store.update(ids.get(i), { _worldBounds: Aabb.unit });
+                    }
+                }
+            },
+        },
+        worldBoundsSystem: {
+            schedule: { after: ["transformSystem", "worldBoundsCreate"] },
+            create: db => () => {
+                for (const arch of db.store.queryArchetypes([
+                    "geometry", "_worldMatrix", "_worldBounds",
+                ])) {
+                    const geos = arch.columns.geometry;
+                    const worldMats = arch.columns._worldMatrix;
+                    const worldBoundsCol = arch.columns._worldBounds;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        const localBounds = db.store.get(geos.get(i), "_bounds");
+                        if (!localBounds)
+                            continue;
+                        worldBoundsCol.set(i, transformAabb(localBounds, worldMats.get(i)));
+                    }
+                }
+            },
+        },
+    },
+});
+const transformAabb = (local, m) => {
+    const { min, max } = local;
+    let minX = Infinity, minY = Infinity, minZ = Infinity;
+    let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity;
+    // The 8 box corners.
+    for (let cx = 0; cx < 2; cx++) {
+        for (let cy = 0; cy < 2; cy++) {
+            for (let cz = 0; cz < 2; cz++) {
+                const corner = [
+                    cx === 0 ? min[0] : max[0],
+                    cy === 0 ? min[1] : max[1],
+                    cz === 0 ? min[2] : max[2],
+                ];
+                const w = Mat4x4.multiplyVec3(m, corner);
+                if (w[0] < minX)
+                    minX = w[0];
+                if (w[0] > maxX)
+                    maxX = w[0];
+                if (w[1] < minY)
+                    minY = w[1];
+                if (w[1] > maxY)
+                    maxY = w[1];
+                if (w[2] < minZ)
+                    minZ = w[2];
+                if (w[2] > maxZ)
+                    maxZ = w[2];
+            }
+        }
+    }
+    return { min: [minX, minY, minZ], max: [maxX, maxY, maxZ] };
+};
+//# sourceMappingURL=world-bounds-plugin.js.map

package/dist/graphics/scene/model/world-bounds-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-bounds-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/scene/model/world-bounds-plugin.ts"],"names":[],"mappings":"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"}

package/dist/graphics/scene/node/node-data-plugin.d.ts

@@ -0,0 +1,113 @@
+/**
+ * The transform-hierarchy core model. Every entity with a position in the
+ * world is a `Node` — see `node.ts` for the field bundle.
+ *
+ * `_worldMatrix` and `_worldBounds` are declared as components but NOT listed
+ * on the authored Node archetype — systems write them via `db.store.update`,
+ * migrating each entity once into a wider archetype.
+ */
+export declare const nodeData: {
+    readonly components: {
+        readonly visible: {
+            readonly type: "boolean";
+            readonly const: true;
+            readonly default: true;
+        };
+        readonly position: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly rotation: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+            readonly default: readonly [0, 0, 0, 1];
+            readonly interpolators: {
+                readonly linear: (q1: any, q2: any, t: number) => any;
+            };
+        };
+        readonly scale: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly parent: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _worldMatrix: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 16;
+            readonly maxItems: 16;
+            readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+        };
+        readonly _worldBounds: {
+            readonly type: "object";
+            readonly properties: {
+                readonly min: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly precision: 1;
+                        readonly default: number;
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 0];
+                };
+                readonly max: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly precision: 1;
+                        readonly default: number;
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 0];
+                };
+            };
+            readonly required: readonly ["min", "max"];
+            readonly additionalProperties: false;
+            readonly default: {
+                readonly min: readonly [0, 0, 0];
+                readonly max: readonly [0, 0, 0];
+            };
+        };
+    };
+    readonly resources: {};
+    readonly archetypes: {
+        readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+    };
+    readonly transactions: {};
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<never>;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {};
+};

package/dist/graphics/scene/node/node-data-plugin.js

@@ -0,0 +1,27 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database, Entity } from "@adobe/data/ecs";
+import { Aabb, Mat4x4, Quat, Vec3 } from "@adobe/data/math";
+import { True } from "@adobe/data/schema";
+/**
+ * The transform-hierarchy core model. Every entity with a position in the
+ * world is a `Node` — see `node.ts` for the field bundle.
+ *
+ * `_worldMatrix` and `_worldBounds` are declared as components but NOT listed
+ * on the authored Node archetype — systems write them via `db.store.update`,
+ * migrating each entity once into a wider archetype.
+ */
+export const nodeData = Database.Plugin.create({
+    components: {
+        visible: True.schema,
+        position: Vec3.schema,
+        rotation: Quat.schema,
+        scale: Vec3.schema,
+        parent: Entity.schema,
+        _worldMatrix: Mat4x4.schema,
+        _worldBounds: Aabb.schema,
+    },
+    archetypes: {
+        Node: ["position", "rotation", "scale", "parent", "visible"],
+    },
+});
+//# sourceMappingURL=node-data-plugin.js.map

package/dist/graphics/scene/node/node-data-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-data-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/scene/node/node-data-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE;QACR,OAAO,EAAO,IAAI,CAAC,MAAM;QACzB,QAAQ,EAAM,IAAI,CAAC,MAAM;QACzB,QAAQ,EAAM,IAAI,CAAC,MAAM;QACzB,KAAK,EAAS,IAAI,CAAC,MAAM;QACzB,MAAM,EAAQ,MAAM,CAAC,MAAM;QAC3B,YAAY,EAAE,MAAM,CAAC,MAAM;QAC3B,YAAY,EAAE,IAAI,CAAC,MAAM;KAC5B;IACD,UAAU,EAAE;QACR,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;KAC/D;CACJ,CAAC,CAAC"}

package/dist/graphics/scene/node/node-plugin.d.ts

@@ -0,0 +1,102 @@
+import { Database } from "@adobe/data/ecs";
+/**
+ * Full node plugin — spatial hierarchy data plus the `transform` system that
+ * derives `_worldMatrix` each frame. Use `Node.plugin` (= this) to get both.
+ * Use `nodeData` directly if you only need the declared components and archetype
+ * without the per-frame TRS computation.
+ */
+export declare const plugin: Database.Plugin<{
+    readonly visible: {
+        readonly type: "boolean";
+        readonly const: true;
+        readonly default: true;
+    };
+    readonly position: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly minItems: 3;
+        readonly maxItems: 3;
+        readonly default: readonly [0, 0, 0];
+    };
+    readonly rotation: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly minItems: 4;
+        readonly maxItems: 4;
+        readonly default: readonly [0, 0, 0, 1];
+        readonly interpolators: {
+            readonly linear: (q1: any, q2: any, t: number) => any;
+        };
+    };
+    readonly scale: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly minItems: 3;
+        readonly maxItems: 3;
+        readonly default: readonly [0, 0, 0];
+    };
+    readonly parent: {
+        readonly type: "integer";
+        readonly minimum: -2147483648;
+        readonly maximum: 2147483647;
+        readonly default: number;
+    };
+    readonly _worldMatrix: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly minItems: 16;
+        readonly maxItems: 16;
+        readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+    };
+    readonly _worldBounds: {
+        readonly type: "object";
+        readonly properties: {
+            readonly min: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 3;
+                readonly maxItems: 3;
+                readonly default: readonly [0, 0, 0];
+            };
+            readonly max: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 3;
+                readonly maxItems: 3;
+                readonly default: readonly [0, 0, 0];
+            };
+        };
+        readonly required: readonly ["min", "max"];
+        readonly additionalProperties: false;
+        readonly default: {
+            readonly min: readonly [0, 0, 0];
+            readonly max: readonly [0, 0, 0];
+        };
+    };
+} & {}, {}, {
+    readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+} & {}, {} & {}, "transformCreateWorldMatrix" | "transformSystem", {}, {}, {}, {} & {}>;

package/dist/graphics/scene/node/node-plugin.js

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { nodeData } from "./node-data-plugin.js";
+import { transform } from "./transform-plugin.js";
+/**
+ * Full node plugin — spatial hierarchy data plus the `transform` system that
+ * derives `_worldMatrix` each frame. Use `Node.plugin` (= this) to get both.
+ * Use `nodeData` directly if you only need the declared components and archetype
+ * without the per-frame TRS computation.
+ */
+export const plugin = Database.Plugin.combine(nodeData, transform);
+//# sourceMappingURL=node-plugin.js.map

package/dist/graphics/scene/node/node-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/scene/node/node-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC"}

package/dist/graphics/scene/node/node.d.ts

@@ -0,0 +1,19 @@
+import type { Entity } from "@adobe/data/ecs";
+import type { Quat, Vec3 } from "@adobe/data/math";
+/**
+ * One entity in the Node archetype — a transform-hierarchy slot. Each field
+ * is its own ECS component (typed-buffer column), but the Node shape names
+ * the bundle so consumers can declare typed locals like
+ * `const node: Node = arch.read(i)`.
+ *
+ * `_worldMatrix` is *not* on the authored Node — the `transform` system
+ * adds it later, migrating each entity into a wider archetype.
+ */
+export interface Node {
+    position: Vec3;
+    rotation: Quat;
+    scale: Vec3;
+    parent: Entity;
+    visible: boolean;
+}
+export * as Node from "./public.js";

package/dist/graphics/scene/node/node.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * as Node from "./public.js";
+//# sourceMappingURL=node.js.map

package/dist/graphics/scene/node/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../src/graphics/scene/node/node.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsBvD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC"}

package/dist/graphics/scene/node/public.d.ts

@@ -0,0 +1 @@
+export { plugin } from "./node-plugin.js";

package/dist/graphics/scene/node/public.js

@@ -0,0 +1,2 @@
+export { plugin } from "./node-plugin.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/scene/node/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/scene/node/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/graphics/scene/node/transform-plugin.d.ts

@@ -0,0 +1,123 @@
+/**
+ * transformCreateWorldMatrix
+ *   query: Node-_worldMatrix
+ *   write: _worldMatrix   (archetype migration; identity)
+ *
+ *   Adds the `_worldMatrix` column to any Node that doesn't have it yet, so
+ *   `transformSystem` can assume the column exists and write to it directly.
+ *
+ * transformSystem
+ *   query: Node+_worldMatrix
+ *   read:  position, rotation, scale, parent
+ *   write: _worldMatrix
+ *
+ *   Computes TRS for every Node and writes the result into the existing
+ *   `_worldMatrix` column. Parents are typically inserted before children
+ *   (glTF order, sample setup), so by the time we reach a child the parent's
+ *   matrix is already populated this frame.
+ */
+export declare const transform: {
+    readonly components: {
+        readonly visible: {
+            readonly type: "boolean";
+            readonly const: true;
+            readonly default: true;
+        };
+        readonly position: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly rotation: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+            readonly default: readonly [0, 0, 0, 1];
+            readonly interpolators: {
+                readonly linear: (q1: any, q2: any, t: number) => any;
+            };
+        };
+        readonly scale: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly parent: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _worldMatrix: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 16;
+            readonly maxItems: 16;
+            readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+        };
+        readonly _worldBounds: {
+            readonly type: "object";
+            readonly properties: {
+                readonly min: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly precision: 1;
+                        readonly default: number;
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 0];
+                };
+                readonly max: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "number";
+                        readonly precision: 1;
+                        readonly default: number;
+                    };
+                    readonly minItems: 3;
+                    readonly maxItems: 3;
+                    readonly default: readonly [0, 0, 0];
+                };
+            };
+            readonly required: readonly ["min", "max"];
+            readonly additionalProperties: false;
+            readonly default: {
+                readonly min: readonly [0, 0, 0];
+                readonly max: readonly [0, 0, 0];
+            };
+        };
+    } & {};
+    readonly resources: {};
+    readonly archetypes: {
+        readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+    } & {};
+    readonly transactions: {} & {};
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"transformCreateWorldMatrix" | "transformSystem">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {} & {};
+};

package/dist/graphics/scene/node/transform-plugin.js

@@ -0,0 +1,65 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Mat4x4, Quat } from "@adobe/data/math";
+import { nodeData } from "./node-data-plugin.js";
+/**
+ * transformCreateWorldMatrix
+ *   query: Node-_worldMatrix
+ *   write: _worldMatrix   (archetype migration; identity)
+ *
+ *   Adds the `_worldMatrix` column to any Node that doesn't have it yet, so
+ *   `transformSystem` can assume the column exists and write to it directly.
+ *
+ * transformSystem
+ *   query: Node+_worldMatrix
+ *   read:  position, rotation, scale, parent
+ *   write: _worldMatrix
+ *
+ *   Computes TRS for every Node and writes the result into the existing
+ *   `_worldMatrix` column. Parents are typically inserted before children
+ *   (glTF order, sample setup), so by the time we reach a child the parent's
+ *   matrix is already populated this frame.
+ */
+export const transform = Database.Plugin.create({
+    extends: nodeData,
+    systems: {
+        transformCreateWorldMatrix: {
+            create: db => () => {
+                for (const arch of db.store.queryArchetypes(["position", "rotation", "scale", "parent"], { exclude: ["_worldMatrix"] })) {
+                    const ids = arch.columns.id;
+                    // Iterate tail→head: every row migrates out of this archetype,
+                    // and removing the last row first means no hole-fill shift.
+                    for (let i = arch.rowCount - 1; i >= 0; i--) {
+                        db.store.update(ids.get(i), { _worldMatrix: Mat4x4.identity });
+                    }
+                }
+            },
+        },
+        transformSystem: {
+            schedule: { after: ["transformCreateWorldMatrix"] },
+            create: db => () => {
+                for (const arch of db.store.queryArchetypes([
+                    "position", "rotation", "scale", "parent", "_worldMatrix",
+                ])) {
+                    const positions = arch.columns.position;
+                    const rotations = arch.columns.rotation;
+                    const scales = arch.columns.scale;
+                    const parents = arch.columns.parent;
+                    const worldMats = arch.columns._worldMatrix;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        const pos = positions.get(i);
+                        const rot = rotations.get(i);
+                        const scl = scales.get(i);
+                        const parentId = parents.get(i);
+                        const local = Mat4x4.multiply(Mat4x4.translation(pos[0], pos[1], pos[2]), Mat4x4.multiply(Quat.toMat4(rot), Mat4x4.scaling(scl[0], scl[1], scl[2])));
+                        const parentWorld = parentId === 0
+                            ? Mat4x4.identity
+                            : db.store.get(parentId, "_worldMatrix") ?? Mat4x4.identity;
+                        worldMats.set(i, parentId === 0 ? local : Mat4x4.multiply(parentWorld, local));
+                    }
+                }
+            },
+        },
+    },
+});
+//# sourceMappingURL=transform-plugin.js.map

package/dist/graphics/scene/node/transform-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-plugin.js","sourceRoot":"","sources":["../../../../src/graphics/scene/node/transform-plugin.ts"],"names":[],"mappings":"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"}