@adobe/data 0.8.5 → 0.9.0

package/dist/ecs/world/index.js

@@ -0,0 +1,27 @@
+/*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 "./world.js";
+export * from "./system.js";
+export * from "./create-world.js";
+export * from "./world-schema/index.js";
+export * from "./system-phase.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/world/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ecs/world/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}

package/dist/ecs/world/system-phase.d.ts

@@ -0,0 +1,5 @@
+import { FromSchema } from "../../schema/schema.js";
+export declare const SystemPhaseSchema: {
+    readonly enum: readonly ["input", "preUpdate", "update", "physics", "postUpdate", "preRender", "render", "postRender", "cleanup"];
+};
+export type SystemPhase = FromSchema<typeof SystemPhaseSchema>;

package/dist/ecs/world/system-phase.js

@@ -0,0 +1,14 @@
+export const SystemPhaseSchema = {
+    enum: [
+        "input",
+        "preUpdate",
+        "update",
+        "physics",
+        "postUpdate",
+        "preRender",
+        "render",
+        "postRender",
+        "cleanup",
+    ]
+};
+//# sourceMappingURL=system-phase.js.map

package/dist/ecs/world/system-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-phase.js","sourceRoot":"","sources":["../../../src/ecs/world/system-phase.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,IAAI,EAAE;QACF,OAAO;QAEP,WAAW;QACX,QAAQ;QACR,SAAS;QACT,YAAY;QAEZ,WAAW;QACX,QAAQ;QACR,YAAY;QAEZ,SAAS;KACZ;CACsB,CAAC"}

package/dist/ecs/world/system.d.ts

@@ -0,0 +1,25 @@
+import { StringKeyof } from "../../types/types.js";
+import { Database, Store, TransactionFunctions } from "../index.js";
+import { ArchetypeComponents } from "../store/archetype-components.js";
+import { Components } from "../store/components.js";
+import { ResourceComponents } from "../store/resource-components.js";
+import { SystemPhase } from "./system-phase.js";
+import { SystemNames } from "./world.js";
+export type StoreSystem<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>> = {
+    type: "store";
+    run: ((store: Store<C, R, A>) => void) | ((store: Store<C, R, A>) => Promise<void>);
+};
+export type DatabaseSystem<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, T extends TransactionFunctions> = {
+    type: "database";
+    run: ((database: Database<C, R, A, T>) => void) | ((database: Database<C, R, A, T>) => Promise<void>);
+};
+export type System<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, T extends TransactionFunctions, S extends SystemNames> = (StoreSystem<C, R, A> | DatabaseSystem<C, R, A, T>) & {
+    /**
+     * If not specified then the system will never run unless explicitly called.
+     */
+    phase?: SystemPhase;
+    schedule?: {
+        before?: readonly S[];
+        after?: readonly S[];
+    };
+};

package/dist/ecs/world/system.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=system.js.map

package/dist/ecs/world/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/ecs/world/system.ts"],"names":[],"mappings":""}

package/dist/ecs/world/world-schema/create-world-schema-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ecs/world/world-schema/create-world-schema-test.js

@@ -0,0 +1,55 @@
+/*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 { createWorldSchema } from "./create-world-schema.js";
+const worldSchema = createWorldSchema({
+    velocity: { type: "number" },
+    particle: { type: "boolean" },
+}, {
+    mousePosition: { type: "number", default: 0 },
+    fooPosition: { type: "number", default: 0 },
+}, {
+    Particle: ["particle"],
+    DynamicParticle: ["particle", "velocity"],
+}, {
+    createParticle(t, args) {
+    },
+    createDynamicParticle(t, args) {
+    }
+}, {
+    foo: {
+        type: "store",
+        run: (store) => {
+            // @ts-expect-error
+            store.archetypes.NonParticle;
+            store.archetypes.Particle.insert({ particle: true });
+        }
+    },
+    bar: {
+        type: "database",
+        run: (db) => {
+            // @ts-expect-error
+            db.transactions.nonTransaction;
+            db.transactions.createParticle({ particle: true });
+        }
+    }
+});
+//# sourceMappingURL=create-world-schema-test.js.map

package/dist/ecs/world/world-schema/create-world-schema-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-world-schema-test.js","sourceRoot":"","sources":["../../../../src/ecs/world/world-schema/create-world-schema-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAQX,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,GAAG,iBAAiB,CACjC;IACI,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,EACD;IACI,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;CAC9C,EACD;IACI,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;CAC5C,EACD;IACI,cAAc,CAAC,CAAC,EAAE,IAA2B;IAC7C,CAAC;IACD,qBAAqB,CAAC,CAAC,EAAE,IAA6C;IACtE,CAAC;CACJ,EACD;IACI,GAAG,EAAE;QACD,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;YACX,mBAAmB;YACnB,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;YAC7B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;KACJ;IACD,GAAG,EAAE;QACD,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;YACR,mBAAmB;YACnB,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC;YAC/B,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;KACJ;CACJ,CACJ,CAAA"}

package/dist/ecs/world/world-schema/create-world-schema.d.ts

@@ -0,0 +1,19 @@
+import { FromSchemas } from "../../../schema/schema.js";
+import { StringKeyof } from "../../../types/types.js";
+import { ComponentSchemas } from "../../component-schemas.js";
+import { System, ToTransactionFunctions, TransactionDeclarations } from "../../index.js";
+import { ResourceSchemas } from "../../resource-schemas.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { WorldFromSchema, WorldSchema } from "./world-schema.js";
+export declare function createWorldSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>, const SD extends {
+    readonly [K: string]: System<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, StringKeyof<SD>>;
+}>(components: CS, resources: RS, archetypes: A, transactions: TD, systems: SD): {
+    readonly components: CS;
+    readonly resources: RS;
+    readonly archetypes: A;
+    readonly transactions: TD;
+    readonly systems: SD;
+};
+export declare function createWorldFromSchema<const CS extends ComponentSchemas, const RS extends ResourceSchemas, const A extends ArchetypeComponents<StringKeyof<CS>>, const TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>, const SD extends {
+    readonly [K: string]: System<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, StringKeyof<SD>>;
+}>(schema: WorldSchema<CS, RS, A, TD, SD>): WorldFromSchema<typeof schema>;

package/dist/ecs/world/world-schema/create-world-schema.js

@@ -0,0 +1,33 @@
+/*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 { createDatabase, createStoreFromSchema, createWorld } from "../../index.js";
+export function createWorldSchema(components, resources, archetypes, transactions, systems) {
+    return { components, resources, archetypes, transactions, systems };
+}
+;
+export function createWorldFromSchema(schema) {
+    const store = createStoreFromSchema(schema);
+    const database = createDatabase(store, schema.transactions);
+    return createWorld(store, database, schema.systems);
+}
+;
+//# sourceMappingURL=create-world-schema.js.map

package/dist/ecs/world/world-schema/create-world-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-world-schema.js","sourceRoot":"","sources":["../../../../src/ecs/world/world-schema/create-world-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAKX,OAAO,EAA2D,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7I,MAAM,UAAU,iBAAiB,CAO7B,UAAc,EACd,SAAa,EACb,UAAa,EACb,YAAgB,EAChB,OAAW;IAEX,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAoD,CAAC;AAC1H,CAAC;AAAA,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAOjC,MAAsC;IAEtC,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,YAAmB,CAAC,CAAC;IACnE,OAAO,WAAW,CACd,KAAK,EACL,QAAe,EACf,MAAM,CAAC,OAAc,CACjB,CAAC;AACb,CAAC;AAAA,CAAC"}

package/dist/ecs/world/world-schema/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./create-world-schema.js";
+export * from "./world-schema.js";

package/dist/ecs/world/world-schema/index.js

@@ -0,0 +1,24 @@
+/*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 "./create-world-schema.js";
+export * from "./world-schema.js";
+//# sourceMappingURL=index.js.map

package/dist/ecs/world/world-schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ecs/world/world-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/ecs/world/world-schema/world-schema.d.ts

@@ -0,0 +1,18 @@
+import { FromSchemas } from "../../../schema/schema.js";
+import { ComponentSchemas } from "../../component-schemas.js";
+import { ResourceSchemas } from "../../resource-schemas.js";
+import { StringKeyof } from "../../../types/types.js";
+import { ToTransactionFunctions, TransactionDeclarations } from "../../database/database.js";
+import { ArchetypeComponents } from "../../store/archetype-components.js";
+import { World } from "../world.js";
+import { System } from "../system.js";
+export type WorldSchema<CS extends ComponentSchemas, RS extends ResourceSchemas, A extends ArchetypeComponents<StringKeyof<CS>>, TD extends TransactionDeclarations<FromSchemas<CS>, FromSchemas<RS>, A>, SD extends {
+    readonly [K: string]: System<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, StringKeyof<SD>>;
+}> = {
+    readonly components: CS;
+    readonly resources: RS;
+    readonly archetypes: A;
+    readonly transactions: TD;
+    readonly systems: SD;
+};
+export type WorldFromSchema<T> = T extends WorldSchema<infer CS, infer RS, infer A, infer TD, infer SD> ? World<FromSchemas<CS>, FromSchemas<RS>, A, ToTransactionFunctions<TD>, StringKeyof<SD>> : never;

package/dist/ecs/world/world-schema/world-schema.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 {};
+//# sourceMappingURL=world-schema.js.map

package/dist/ecs/world/world-schema/world-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-schema.js","sourceRoot":"","sources":["../../../../src/ecs/world/world-schema/world-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW"}

package/dist/ecs/world/world.d.ts

@@ -0,0 +1,11 @@
+import { ResourceComponents } from "../store/resource-components.js";
+import { StringKeyof } from "../../types/types.js";
+import { Components } from "../store/components.js";
+import { ArchetypeComponents } from "../store/archetype-components.js";
+import { Database, TransactionFunctions } from "../database/database.js";
+import { SystemPhase } from "./system-phase.js";
+export type SystemNames = string;
+export interface World<C extends Components = never, R extends ResourceComponents = never, A extends ArchetypeComponents<StringKeyof<C>> = never, T extends TransactionFunctions = never, S extends SystemNames = never> extends Database<C, R, A, T> {
+    runPhases(phases?: readonly SystemPhase[]): Promise<void>;
+    runSystems(systems: readonly S[]): Promise<void>;
+}

package/dist/ecs/world/world.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=world.js.map

package/dist/ecs/world/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../../../src/ecs/world/world.ts"],"names":[],"mappings":""}

package/dist/graphics/camera/camera.d.ts

@@ -0,0 +1,62 @@
+import { FromSchema } from "../../schema/index.js";
+export declare const CameraSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly aspect: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly fieldOfView: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly nearPlane: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly farPlane: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        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 target: {
+            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 up: {
+            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 ["aspect", "fieldOfView", "nearPlane", "farPlane", "position", "target", "up"];
+    readonly additionalProperties: false;
+};
+export type Camera = FromSchema<typeof CameraSchema>;

package/dist/graphics/camera/camera.js

@@ -0,0 +1,17 @@
+import { F32Schema } from "../../schema/index.js";
+import { Vec3 } from "../../math/index.js";
+export const CameraSchema = {
+    type: 'object',
+    properties: {
+        aspect: F32Schema,
+        fieldOfView: F32Schema,
+        nearPlane: F32Schema,
+        farPlane: F32Schema,
+        position: Vec3.schema,
+        target: Vec3.schema,
+        up: Vec3.schema,
+    },
+    required: ["aspect", "fieldOfView", "nearPlane", "farPlane", "position", "target", "up"],
+    additionalProperties: false,
+};
+//# sourceMappingURL=camera.js.map

package/dist/graphics/camera/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../../src/graphics/camera/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,EAAE,EAAE,IAAI,CAAC,MAAM;KAClB;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC;IACxF,oBAAoB,EAAE,KAAK;CACJ,CAAC"}

package/dist/graphics/camera/index.d.ts

@@ -0,0 +1,4 @@
+export * from './camera.js';
+export * from './to-view-projection.js';
+export * from './world-to-screen.js';
+export * from './screen-to-world-ray.js';

package/dist/graphics/camera/index.js

@@ -0,0 +1,5 @@
+export * from './camera.js';
+export * from './to-view-projection.js';
+export * from './world-to-screen.js';
+export * from './screen-to-world-ray.js';
+//# sourceMappingURL=index.js.map

package/dist/graphics/camera/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphics/camera/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/dist/graphics/camera/screen-to-world-ray.d.ts

@@ -0,0 +1,12 @@
+import { Vec2, Line3, Mat4x4 } from "../../math/index.js";
+/**
+ * Converts screen coordinates to a world space pick line for ray casting.
+ *
+ * @param screenPosition - Screen coordinates [x, y] where (0,0) is top-left
+ * @param invViewProjection - The inverse view-projection matrix
+ * @param canvasWidth - The width of the canvas in pixels
+ * @param canvasHeight - The height of the canvas in pixels
+ * @param rayLength - The length of the ray in world units (default: 1000)
+ * @returns A Line3 representing the ray from near plane through the screen point
+ */
+export declare const screenToWorldRay: (screenPosition: Vec2, invViewProjection: Mat4x4, canvasWidth: number, canvasHeight: number, rayLength?: number) => Line3;

package/dist/graphics/camera/screen-to-world-ray.js

@@ -0,0 +1,49 @@
+import { Vec3, Mat4x4 } from "../../math/index.js";
+/**
+ * Converts screen coordinates to a world space pick line for ray casting.
+ *
+ * @param screenPosition - Screen coordinates [x, y] where (0,0) is top-left
+ * @param invViewProjection - The inverse view-projection matrix
+ * @param canvasWidth - The width of the canvas in pixels
+ * @param canvasHeight - The height of the canvas in pixels
+ * @param rayLength - The length of the ray in world units (default: 1000)
+ * @returns A Line3 representing the ray from near plane through the screen point
+ */
+export const screenToWorldRay = (screenPosition, invViewProjection, canvasWidth, canvasHeight, rayLength = 1000) => {
+    // Convert screen coordinates to normalized device coordinates (NDC)
+    // Screen: (0,0) is top-left, (width,height) is bottom-right
+    // NDC: (-1,-1) is bottom-left, (1,1) is top-right
+    const ndcX = (screenPosition[0] / canvasWidth) * 2 - 1;
+    const ndcY = 1 - (screenPosition[1] / canvasHeight) * 2; // Flip Y axis
+    // Create two points in clip space: near plane and far plane
+    // Near plane is at z = -1 (closer to camera), far plane is at z = 1 (farther from camera)
+    const nearPoint = [ndcX, ndcY, -1, 1];
+    const farPoint = [ndcX, ndcY, 1, 1];
+    // Transform to world space
+    const nearWorld = Mat4x4.multiplyVec4(invViewProjection, nearPoint);
+    const farWorld = Mat4x4.multiplyVec4(invViewProjection, farPoint);
+    // Perform perspective divide and ensure Vec3 type
+    const nearWorldPos = [
+        nearWorld[0] / nearWorld[3],
+        nearWorld[1] / nearWorld[3],
+        nearWorld[2] / nearWorld[3]
+    ];
+    const farWorldPos = [
+        farWorld[0] / farWorld[3],
+        farWorld[1] / farWorld[3],
+        farWorld[2] / farWorld[3]
+    ];
+    // Calculate ray direction (from near to far, which should point towards negative Z)
+    const rayDirection = Vec3.normalize(Vec3.subtract(nearWorldPos, farWorldPos));
+    // Create the ray end point at the specified length from the near plane point
+    const rayEnd = [
+        nearWorldPos[0] + rayDirection[0] * rayLength,
+        nearWorldPos[1] + rayDirection[1] * rayLength,
+        nearWorldPos[2] + rayDirection[2] * rayLength
+    ];
+    return {
+        a: nearWorldPos,
+        b: rayEnd
+    };
+};
+//# sourceMappingURL=screen-to-world-ray.js.map

package/dist/graphics/camera/screen-to-world-ray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-to-world-ray.js","sourceRoot":"","sources":["../../../src/graphics/camera/screen-to-world-ray.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,IAAI,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC5B,cAAoB,EACpB,iBAAyB,EACzB,WAAmB,EACnB,YAAoB,EACpB,YAAoB,IAAI,EACnB,EAAE;IACP,oEAAoE;IACpE,4DAA4D;IAC5D,kDAAkD;IAClD,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc;IAEvE,4DAA4D;IAC5D,0FAA0F;IAC1F,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC;IAC/C,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;IAE7C,2BAA2B;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAElE,kDAAkD;IAClD,MAAM,YAAY,GAAS;QACvB,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;QAC3B,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;QAC3B,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;KAC9B,CAAC;IACF,MAAM,WAAW,GAAS;QACtB,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACzB,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACzB,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;KAC5B,CAAC;IAEF,oFAAoF;IACpF,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9E,6EAA6E;IAC7E,MAAM,MAAM,GAAS;QACjB,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;QAC7C,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;QAC7C,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;KAChD,CAAC;IAEF,OAAO;QACH,CAAC,EAAE,YAAY;QACf,CAAC,EAAE,MAAM;KACZ,CAAC;AACN,CAAC,CAAC"}

package/dist/graphics/camera/screen-to-world-ray.test.d.ts

@@ -0,0 +1 @@
+export {};