@adobe/data 0.1.2

package/perftest/horizon-perf.d.ts

@@ -0,0 +1,22 @@
+export declare const horizon: {
+    create: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        type: "create";
+    };
+    move_best: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: () => number[];
+        type: "move";
+    };
+    move_worst: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: () => number[];
+        type: "move";
+    };
+};

package/perftest/horizon-perf.js

@@ -0,0 +1,126 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { shuffleArray } from "./helper-functions.js";
+function uuidv4() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+// uuid-imports.d.ts
+async function createParticles(count) {
+    const particlesIds = [];
+    const components = new Map();
+    const setComponent = (name, key, value) => {
+        let component = components.get(name);
+        if (!component) {
+            component = new Map();
+            components.set(name, component);
+        }
+        component.set(key, value);
+    };
+    const getComponent = (name, key) => {
+        const component = components.get(name);
+        if (!component) {
+            return undefined;
+        }
+        return component.get(key);
+    };
+    const particles = [];
+    for (let i = 0; i < count; i++) {
+        const entity = uuidv4();
+        particlesIds.push(entity);
+        setComponent(entity, "color", { value: 0xff00ff });
+        setComponent(entity, "mass", { value: 10 });
+        setComponent(entity, "position", { x: i + 1, y: i + 1, z: i + 1 });
+        setComponent(entity, "velocity", { x: -i, y: -i, z: -i });
+        if ((i >> 0) % 2 === 0) {
+            setComponent(entity, "visible", true);
+        }
+        if ((i >> 1) % 2 === 0) {
+            setComponent(entity, "enabled", true);
+        }
+    }
+    const enabledVisibleParticles = particlesIds.filter((id, i) => {
+        return getComponent(id, "enabled") && getComponent(id, "visible");
+    });
+    return {
+        particles,
+        components,
+        setComponent,
+        getComponent,
+        enabledVisibleParticles,
+    };
+}
+const create = (() => {
+    let count = 0;
+    const setup = async (n) => {
+        count = n;
+    };
+    const run = () => {
+        createParticles(count);
+    };
+    const cleanup = async () => { };
+    return { setup, run: run, cleanup, type: "create" };
+})();
+function createMoveParticlesPerformanceTest(options) {
+    let ecs;
+    const setup = async (n) => {
+        ecs = await createParticles(n);
+        if (options.shuffle) {
+            shuffleArray(ecs.particles);
+        }
+    };
+    const run = () => {
+        for (let i = 0; i < ecs.enabledVisibleParticles.length; i++) {
+            const p = ecs.enabledVisibleParticles[i];
+            const position = ecs.getComponent(p, "position");
+            const velocity = ecs.getComponent(p, "velocity");
+            const newPosition = {
+                x: position.x + velocity.x,
+                y: position.y + velocity.y,
+                z: position.z + velocity.z,
+            };
+            ecs.setComponent(p, "position", newPosition);
+        }
+    };
+    const getVisibleEnabledPositions = () => {
+        const values = [];
+        for (let i = 0; i < ecs.enabledVisibleParticles.length; i++) {
+            const p = ecs.enabledVisibleParticles[i];
+            const position = ecs.getComponent(p, "position");
+            values.push(position.x, position.y, position.z);
+        }
+        return values;
+    };
+    const cleanup = async () => { };
+    return { setup, run: run, cleanup, getVisibleEnabledPositions, type: "move" };
+}
+const move_best = createMoveParticlesPerformanceTest({ shuffle: false });
+const move_worst = createMoveParticlesPerformanceTest({ shuffle: true });
+export const horizon = {
+    create,
+    move_best,
+    move_worst,
+};
+//# sourceMappingURL=horizon-perf.js.map

package/perftest/horizon-perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizon-perf.js","sourceRoot":"","sources":["../../src/perftest/horizon-perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,SAAS,MAAM;IACb,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AACD,oBAAoB;AACpB,KAAK,UAAU,eAAe,CAAC,KAAa;IAC1C,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,UAAU,GAAkC,IAAI,GAAG,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,KAAU,EAAE,EAAE;QAC7D,IAAI,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,EAAE;QACjD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,MAAM,SAAS,GAAU,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5C,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,CAAE,CAAC,EAAE,CAAC,EAAE,CAAE,CAAC,EAAE,CAAC,EAAE,CAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,MAAM,uBAAuB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QAC5D,OAAO,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS;QACT,UAAU;QACV,YAAY;QACZ,YAAY;QACZ,uBAAuB;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE;QAChC,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,eAAe,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAA4B,CAAC;AAChF,CAAC,CAAC,EAAE,CAAC;AAEL,SAAS,kCAAkC,CAAC,OAA6B;IACvE,IAAI,GAAQ,CAAC;IACb,MAAM,KAAK,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE;QAChC,GAAG,GAAG,MAAM,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG;gBAClB,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAC1B,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAC1B,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;aAC3B,CAAC;YACF,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC;IACF,MAAM,0BAA0B,GAAG,GAAG,EAAE;QACtC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAA4B,CAAC;AAC1G,CAAC;AAED,MAAM,SAAS,GAAG,kCAAkC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACzE,MAAM,UAAU,GAAG,kCAAkC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM;IACN,SAAS;IACT,UAAU;CACX,CAAC"}

package/perftest/index.d.ts

@@ -0,0 +1 @@
+export declare function run(): void;

package/perftest/index.js

@@ -0,0 +1,35 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import * as vanilla_tests from "./vanilla-perf.js";
+import * as ecs_tests from "./ecs-perf.js";
+import { runTests } from "./perf-test.js";
+export function run() {
+    runTests({
+        ...ecs_tests,
+        ...vanilla_tests,
+        // ...horizon_tests,
+    });
+}
+if (typeof globalThis.process === "object" && import.meta.url === `file://${process?.argv[1]}`) {
+    run();
+}
+//# sourceMappingURL=index.js.map

package/perftest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/perftest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,SAAS,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,GAAG;IACjB,QAAQ,CAAC;QACP,GAAG,SAAS;QACZ,GAAG,aAAa;QAChB,oBAAoB;KACrB,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/F,GAAG,EAAE,CAAC;AACR,CAAC"}

package/perftest/perf-test.d.ts

@@ -0,0 +1,18 @@
+declare global {
+    interface Performance {
+        measureUserAgentSpecificMemory?: () => {
+            bytes: number;
+        };
+        memory?: {
+            usedJSHeapSize: number;
+        };
+    }
+}
+export interface PerformanceTest {
+    setup: (n: number) => Promise<void>;
+    run: () => any;
+    getVisibleEnabledPositions?: () => number[];
+    type: "create" | "move";
+    cleanup: () => Promise<void>;
+}
+export declare function runTests(testSuites: Record<string, Record<string, PerformanceTest>>): Promise<void>;

package/perftest/perf-test.js

@@ -0,0 +1,124 @@
+const typeToFlops = {
+    create: 10,
+    move: 3 / 4,
+};
+function isPerformanceTest(obj) {
+    return (typeof obj.setup === "function" &&
+        typeof obj.run === "function" &&
+        typeof obj.cleanup === "function");
+}
+function getMemory() {
+    //  if in the browser, try to get browser memory usage
+    if (typeof window !== "undefined") {
+        return performance.memory?.usedJSHeapSize ?? 0;
+    }
+    return performance.measureUserAgentSpecificMemory?.().bytes ?? 0;
+}
+function getTime() {
+    return performance.now();
+}
+function garbageCollect() {
+    if (typeof globalThis.gc === "function") {
+        globalThis.gc();
+    }
+}
+export async function runTests(testSuites) {
+    console.log("Starting Tests:");
+    const allResults = {};
+    const display = (name) => name.replace(/_/g, " ");
+    for (const [suite, tests] of Object.entries(testSuites)) {
+        console.log(`- ${display(suite)}...`);
+        const suiteResults = (allResults[suite] = {});
+        for (const [name, test] of Object.entries(tests)) {
+            console.log(`  - ${display(name)}...`);
+            const testResults = [];
+            suiteResults[name] = testResults;
+            if (test.getVisibleEnabledPositions) {
+                if (test.type === "create") {
+                    throw new Error("Cannot have getVisibleEnabledPositions with create test");
+                }
+                //  we will run a small n sample of this to verify it works correctly.
+                const sample_n = 17;
+                await test.setup(sample_n);
+                const initialPositions = test.getVisibleEnabledPositions();
+                const expectedInitialPositions = [1, 1, 1, 5, 5, 5, 9, 9, 9, 13, 13, 13, 17, 17, 17];
+                if (JSON.stringify(initialPositions) !== JSON.stringify(expectedInitialPositions)) {
+                    console.log(`  Error: invalid initial positions: ${initialPositions}, expected. ${expectedInitialPositions}`);
+                }
+                // console.log(JSON.stringify(initialPositions));
+                //  run the test once to add to visible, enabled particle positions.
+                test.run();
+                const finalPositions = test.getVisibleEnabledPositions();
+                const expectedFinalPositions = [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1];
+                if (JSON.stringify(finalPositions) !== JSON.stringify(expectedFinalPositions)) {
+                    console.log(`  Error: invalid final positions: ${finalPositions}, expected. ${expectedFinalPositions}`);
+                }
+                // console.log(JSON.stringify(finalPositions));
+            }
+            const n = test.getVisibleEnabledPositions ? 100000 : 100000;
+            await test.setup(n);
+            garbageCollect();
+            const baselineMemory = getMemory();
+            const timeStart = getTime();
+            //   only run for 1 second
+            while (getTime() - timeStart < 100) {
+                const result = runOnce(test.run, test);
+                result.memoryKb -= baselineMemory;
+                testResults.push({ ...result, flops: n * typeToFlops[test.type] });
+            }
+            await test.cleanup();
+            garbageCollect();
+        }
+    }
+    // console.log(allResults);
+    //  console log some meaningful and readable results for each test that include the min, max and average times
+    if (typeof console.table === "function") {
+        // Let's use the console table function to layout some nice results that the best results in time and memory
+        // are easy to see.
+        const tableValues = {};
+        for (const [suite, suiteResults] of Object.entries(allResults)) {
+            for (const [name, testResults] of Object.entries(suiteResults)) {
+                const memoryKb = testResults.map((r) => r.memoryKb / (1024 * 1024));
+                const timeMs = testResults.map((r) => r.timeMs);
+                const fastestResult = testResults.reduce((a, b) => (a.timeMs < b.timeMs ? a : b));
+                const fastestFlopsPerSecond = (fastestResult.flops * 1000) / (fastestResult.timeMs);
+                const totalTime = timeMs.reduce((a, b) => a + b, 0);
+                const totalFlops = testResults.reduce((a, b) => a + b.flops, 0);
+                const averageFlopsPerSecond = (totalFlops * 1000) / totalTime;
+                tableValues[`${display(suite)}:${display(name)}`] = {
+                    Passes: memoryKb.length,
+                    // 'Mem Min (Mb)': Math.min(...memoryKb).toFixed(2),
+                    // 'Mem Max (Mb)': Math.max(...memoryKb).toFixed(2),
+                    // "Mem Avg (Mb)": (
+                    //   memoryKb.reduce((a, b) => a + b, 0) / memoryKb.length
+                    // ).toFixed(2),
+                    "Time Min (ms)": Math.min(...timeMs).toFixed(2),
+                    // 'Time Max (ms)': Math.max(...timeMs).toFixed(2),
+                    "Time Avg (ms)": (timeMs.reduce((a, b) => a + b, 0) / timeMs.length).toFixed(2),
+                    "Fastest MFlops": Math.round(fastestFlopsPerSecond / 1000000),
+                    "Average MFlops": Math.round(averageFlopsPerSecond / 1000000),
+                };
+            }
+        }
+        console.table(tableValues);
+    }
+    else {
+        for (const [suite, suiteResults] of Object.entries(allResults)) {
+            for (const [name, testResults] of Object.entries(suiteResults)) {
+                const memoryKb = testResults.map((r) => r.memoryKb);
+                const timeMs = testResults.map((r) => r.timeMs);
+                console.log(`${name}: ${Math.min(...memoryKb)}kb - ${Math.max(...memoryKb)}kb - ${Math.round(memoryKb.reduce((a, b) => a + b, 0) / memoryKb.length)}kb`);
+                console.log(`${name}: ${Math.round(Math.min(...timeMs))}ms - ${Math.round(Math.max(...timeMs))}ms - ${Math.round(timeMs.reduce((a, b) => a + b, 0) / timeMs.length)}ms`);
+            }
+        }
+    }
+}
+function runOnce(fn, test) {
+    const start = getTime();
+    const result = fn();
+    const end = getTime();
+    const after = getMemory();
+    const timeMs = end - start;
+    return { memoryKb: after, timeMs, result };
+}
+//# sourceMappingURL=perf-test.js.map

package/perftest/perf-test.js.map

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

package/perftest/vanilla-perf.d.ts

@@ -0,0 +1,38 @@
+export declare const vanilla_js: {
+    create: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        type: "create";
+    };
+    move_best: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: (() => number[]) | undefined;
+        type: "move";
+    };
+    move_worst: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: (() => number[]) | undefined;
+        type: "move";
+    };
+};
+export declare const immutable_js: {
+    move_best: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: (() => number[]) | undefined;
+        type: "move";
+    };
+    move_worst: {
+        setup: (n: number) => Promise<void>;
+        run: () => void;
+        cleanup: () => Promise<void>;
+        getVisibleEnabledPositions: (() => number[]) | undefined;
+        type: "move";
+    };
+};

package/perftest/vanilla-perf.js

@@ -0,0 +1,128 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { shuffleArray } from "./helper-functions.js";
+function createParticlesJS(n) {
+    const particles = [];
+    for (let i = 0; i < n; i++) {
+        const particle = {
+            color: 0xff00ff,
+            mass: 10,
+            positionX: i + 1,
+            positionY: i + 1,
+            positionZ: i + 1,
+            velocityX: -i,
+            velocityY: -i,
+            velocityZ: -i,
+        };
+        if ((i >> 0) % 2 === 0) {
+            particle.visible = true;
+        }
+        if ((i >> 1) % 2 === 0) {
+            particle.enabled = true;
+        }
+        particles.push(particle);
+    }
+    return particles;
+}
+const create = (() => {
+    let count = 0;
+    const setup = async (n) => {
+        count = n;
+    };
+    const run = () => {
+        createParticlesJS(count);
+    };
+    const cleanup = async () => { };
+    return { setup, run: run, cleanup, type: "create" };
+})();
+function createMoveParticlesPerformanceTest(options) {
+    let particles = [];
+    const setup = async (n) => {
+        particles = createParticlesJS(n);
+        if (options.shuffle) {
+            shuffleArray(particles);
+        }
+    };
+    const run = () => {
+        if (options.immutable) {
+            for (let i = 0; i < particles.length; i++) {
+                const p = particles[i];
+                if (p.visible && p.enabled) {
+                    particles[i] = {
+                        ...p,
+                        positionX: p.positionX + p.velocityX,
+                        positionY: p.positionY + p.velocityY,
+                        positionZ: p.positionZ + p.velocityZ,
+                    };
+                }
+            }
+        }
+        else {
+            for (let i = 0; i < particles.length; i++) {
+                const p = particles[i];
+                if (p.visible && p.enabled) {
+                    p.positionX += p.velocityX;
+                    p.positionY += p.velocityY;
+                    p.positionZ += p.velocityZ;
+                }
+            }
+        }
+    };
+    const getVisibleEnabledPositions = () => {
+        const values = [];
+        for (let i = 0; i < particles.length; i++) {
+            const p = particles[i];
+            if (p.visible && p.enabled) {
+                values.push(p.positionX, p.positionY, p.positionZ);
+            }
+        }
+        return values;
+    };
+    const cleanup = async () => { };
+    return { setup, run: run, cleanup, getVisibleEnabledPositions: options.shuffle ? undefined : getVisibleEnabledPositions, type: "move" };
+}
+const move_best = createMoveParticlesPerformanceTest({
+    shuffle: false,
+    immutable: false,
+});
+const move_worst = createMoveParticlesPerformanceTest({
+    shuffle: true,
+    immutable: false,
+});
+const move_best_immutable = createMoveParticlesPerformanceTest({
+    shuffle: false,
+    immutable: true,
+});
+const move_worst_immutable = createMoveParticlesPerformanceTest({
+    shuffle: true,
+    immutable: true,
+});
+export const vanilla_js = {
+    create,
+    move_best,
+    move_worst,
+};
+export const immutable_js = {
+    move_best: move_best_immutable,
+    move_worst: move_worst_immutable,
+};
+//# sourceMappingURL=vanilla-perf.js.map

package/perftest/vanilla-perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vanilla-perf.js","sourceRoot":"","sources":["../../src/perftest/vanilla-perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,SAAS,iBAAiB,CAAC,CAAS;IAClC,MAAM,SAAS,GAAU,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAQ;YACpB,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,CAAC,GAAG,CAAC;YAChB,SAAS,EAAE,CAAC,GAAG,CAAC;YAChB,SAAS,EAAE,CAAC,GAAG,CAAC;YAChB,SAAS,EAAE,CAAC,CAAC;YACb,SAAS,EAAE,CAAC,CAAC;YACb,SAAS,EAAE,CAAC,CAAC;SACd,CAAC;QACF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE;QAChC,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAA4B,CAAC;AAChF,CAAC,CAAC,EAAE,CAAC;AAEL,SAAS,kCAAkC,CAAC,OAG3C;IACC,IAAI,SAAS,GAAU,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE;QAChC,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBAC3B,SAAS,CAAC,CAAC,CAAC,GAAG;wBACb,GAAG,CAAC;wBACJ,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;wBACpC,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;wBACpC,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;qBACrC,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;oBAC3B,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC;oBAC3B,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC;oBAC3B,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,0BAA0B,GAAG,GAAG,EAAE;QACtC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,0BAA0B,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAA4B,CAAC;AACpK,CAAC;AAED,MAAM,SAAS,GAAG,kCAAkC,CAAC;IACnD,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC;AACH,MAAM,UAAU,GAAG,kCAAkC,CAAC;IACpD,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC;AACH,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;IAC7D,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AACH,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;IAC9D,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,MAAM;IACN,SAAS;IACT,UAAU;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,UAAU,EAAE,oBAAoB;CACjC,CAAC"}

package/schemas/index.d.ts

@@ -0,0 +1 @@
+export * from "./schemas.js";

package/schemas/index.js

@@ -0,0 +1,23 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+export * from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,cAAc,CAAC"}

package/schemas/schemas.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from "../core/index.js";
+export declare function Nullable<T extends Schema>(schema: T): {
+    oneOf: [T, {
+        type: "null";
+    }];
+};
+export declare function Tuple<T extends Schema, N extends number>(items: T, length: N): {
+    readonly type: "array";
+    readonly items: T;
+    readonly minItems: N;
+    readonly maxItems: N;
+};
+export declare const TrueSchema: {
+    readonly const: true;
+};
+export declare const BooleanSchema: {
+    readonly type: "boolean";
+};
+export declare const Float32Schema: {
+    readonly type: "number";
+    readonly precision: 1;
+};
+export declare const Float64Schema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const TimeSchema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const Uint8Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 255;
+};
+export declare const Uint16Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 65535;
+};
+export declare const Uint32Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 4294967295;
+};

package/schemas/schemas.js

@@ -0,0 +1,39 @@
+export function Nullable(schema) {
+    return {
+        oneOf: [schema, { type: "null" }],
+    };
+}
+export function Tuple(items, length) {
+    return { type: "array", items, minItems: length, maxItems: length };
+}
+export const TrueSchema = {
+    const: true,
+};
+export const BooleanSchema = {
+    type: "boolean",
+};
+export const Float32Schema = {
+    type: "number",
+    precision: 1,
+};
+export const Float64Schema = {
+    type: "number",
+    precision: 2,
+};
+export const TimeSchema = Float64Schema;
+export const Uint8Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xff,
+};
+export const Uint16Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffff,
+};
+export const Uint32Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffffffff,
+};
+//# sourceMappingURL=schemas.js.map

package/schemas/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas/schemas.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,QAAQ,CACtB,MAAS;IAET,OAAO;QACL,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAqC,KAAQ,EAAE,MAAS;IAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAA4B,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,IAAI;CACc,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,IAAI;CACY,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,MAAM;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,UAAU;CACM,CAAC"}