@adobe/ecs 0.0.0-stage → 0.2.0

package/dist/interface/gpu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/gpu/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/interface/gpu/layout.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The bind group layout of `wgsl` declarations, which render pipelines take at the group they name. It's the same
+ * object for a device every time, so pipelines can be built before a world exists.
+ */
+export declare const layout: (device: GPUDevice) => GPUBindGroupLayout;

package/dist/interface/gpu/layout.js

@@ -0,0 +1,22 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { recordBytes } from './record.js';
+const layouts = new WeakMap();
+/**
+ * The bind group layout of `wgsl` declarations, which render pipelines take at the group they name. It's the same
+ * object for a device every time, so pipelines can be built before a world exists.
+ */
+export const layout = (device) => {
+    let existing = layouts.get(device);
+    if (existing === undefined) {
+        const visibility = GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT | GPUShaderStage.COMPUTE;
+        existing = device.createBindGroupLayout({
+            entries: [
+                { binding: 0, visibility, buffer: { type: "read-only-storage" } },
+                { binding: 1, visibility, buffer: { type: "uniform", hasDynamicOffset: true, minBindingSize: recordBytes } },
+            ],
+        });
+        layouts.set(device, existing);
+    }
+    return existing;
+};
+//# sourceMappingURL=layout.js.map

package/dist/interface/gpu/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../src/interface/gpu/layout.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAsB,EAAE;IAC5D,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC;QAC5F,QAAQ,GAAG,MAAM,CAAC,qBAAqB,CAAC;YACpC,OAAO,EAAE;gBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;gBACjE,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE;aAC/G;SACJ,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC"}

package/dist/interface/gpu/record.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Bytes per parameter or table record, the dynamic offset alignment WebGPU guarantees. A record is `u32` words: a
+ * row count, then a word address in the heap per column, then, for kernels, scalars as f32 bits.
+ */
+export declare const recordBytes = 256;

package/dist/interface/gpu/record.js

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Bytes per parameter or table record, the dynamic offset alignment WebGPU guarantees. A record is `u32` words: a
+ * row count, then a word address in the heap per column, then, for kernels, scalars as f32 bits.
+ */
+export const recordBytes = 256;
+//# sourceMappingURL=record.js.map

package/dist/interface/gpu/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/interface/gpu/record.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC"}

package/dist/interface/gpu/wgsl.d.ts

@@ -0,0 +1,9 @@
+import type { System } from '../system/system.js';
+/**
+ * The WGSL a render system's shaders include: its bind group at `shader.group` (the heap and its table record), and a
+ * function per accessor returning that component of a row, such as `fn position(row: u32) -> vec3<f32>`, plus
+ * `ecs_count()`. For a system with `order`, `row` is an instance's position in its order and `ecs_count()` the number
+ * of instances. Depends only on registered schemas, so pipelines can be built before any world exists.
+ * Throws if the system isn't a render system or a component can't be read on the GPU.
+ */
+export declare const wgsl: (system: System<unknown>) => string;

package/dist/interface/gpu/wgsl.js

@@ -0,0 +1,24 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { definitionOf } from '../registry/index.js';
+import { accessorsOf, declarationsOf } from './accessors.js';
+/**
+ * The WGSL a render system's shaders include: its bind group at `shader.group` (the heap and its table record), and a
+ * function per accessor returning that component of a row, such as `fn position(row: u32) -> vec3<f32>`, plus
+ * `ecs_count()`. For a system with `order`, `row` is an instance's position in its order and `ecs_count()` the number
+ * of instances. Depends only on registered schemas, so pipelines can be built before any world exists.
+ * Throws if the system isn't a render system or a component can't be read on the GPU.
+ */
+export const wgsl = (system) => {
+    const definition = definitionOf(system);
+    const declaration = definition?.kind === "render" ? definition.declaration : undefined;
+    const shader = declaration?.shader;
+    if (declaration === undefined || shader === undefined)
+        throw new Error(`System "${system.name}" isn't a render system.`);
+    const { name } = system;
+    const ordered = declaration.order !== undefined;
+    const accessors = accessorsOf(shader, ordered);
+    if (typeof accessors === "string")
+        throw new Error(`Render system "${name}": ${accessors}.`);
+    return declarationsOf(shader.group ?? 0, accessors, ordered);
+};
+//# sourceMappingURL=wgsl.js.map

package/dist/interface/gpu/wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgsl.js","sourceRoot":"","sources":["../../../src/interface/gpu/wgsl.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAuB,EAAU,EAAE;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,UAAU,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,MAAM,GAAG,WAAW,EAAE,MAAM,CAAC;IACnC,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,0BAA0B,CAAC,CAAC;IACzH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC;IAChD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,MAAM,SAAS,GAAG,CAAC,CAAC;IAC7F,OAAO,cAAc,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/interface/index.d.ts

@@ -0,0 +1,16 @@
+export { Component } from './component/component.js';
+export { Entity } from './entity/entity.js';
+export { Finalizer } from './finalizer/finalizer.js';
+export { Gpu } from './gpu/gpu.js';
+export { Index } from './indexes/index-type.js';
+export * from './math/index.js';
+export * from './resources/index.js';
+export { Resource } from './resource/resource.js';
+export { Rule } from './rule/rule.js';
+export type { Schema } from './schema/schema.js';
+export { System } from './system/system.js';
+export type { World } from './world/world.js';
+export type { Components } from './component/types.js';
+export type { Resources } from './resource/types.js';
+export type { Traits } from './trait/types.js';
+export type { Threads } from './thread/thread.js';

package/dist/interface/index.js

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { Component } from './component/component.js';
+export { Entity } from './entity/entity.js';
+export { Finalizer } from './finalizer/finalizer.js';
+export { Gpu } from './gpu/gpu.js';
+export { Index } from './indexes/index-type.js';
+export * from './math/index.js';
+export * from './resources/index.js';
+export { Resource } from './resource/resource.js';
+export { Rule } from './rule/rule.js';
+export { System } from './system/system.js';
+//# sourceMappingURL=index.js.map

package/dist/interface/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/interface/indexes/create.d.ts

@@ -0,0 +1,39 @@
+import type { Component } from '../component/component.js';
+import type { Shared } from '../component/value.js';
+import type { Listed, Property } from '../system/property.js';
+import type { Declaration } from './declaration.js';
+import type { Index } from './index-type.js';
+/**
+ * `not` excludes what the index holds by: its key parts and `with`. An index without a key isn't unique. A key part is
+ * a value each entity holds, never a shared component's, which systems filter by with `where`.
+ */
+type Validate<D extends Declaration> = {
+    readonly components?: {
+        readonly not?: readonly Exclude<Component.Key, D["key"][number] | Listed<Property<D, "components">, "with">>[];
+        readonly has?: never;
+    };
+} & (D["key"] extends readonly [] ? {
+    readonly unique?: false;
+} : unknown) & ([D["key"][number] & Shared] extends [never] ? unknown : {
+    readonly key: {
+        readonly "error: a key part is a value each entity holds; filter by a shared component with where": D["key"][number] & Shared;
+    };
+});
+/**
+ * Declares an index over components' values and returns it; nothing is built until a world's system or finalizer uses
+ * it. It holds the entities with every key part and every component in `with`, and none in `not`, keyed by the values
+ * of `key`, compared part by part: numbers and tuples by value, an entity with its generation, so a stale one finds
+ * nothing. With an empty key it holds those entities, every entity but the resource entity when `with` and `not` are
+ * empty too, and its lookup takes no key and gives them all, in entity order.
+ * - `sorted`: keeps key order, numbers numerically, NaN last, booleans false first, strings by code point, tuples
+ *   element by element, then entity order, so a lookup takes a prefix of the key whose last part may be a comparison.
+ * - `unique`: at most one entity per key: a lookup by a whole key returns its row or null. When two entities share a
+ *   key, the one with the lower entity index is kept, and the index fails the run or tick that found them.
+ *
+ * Throws if a key part isn't a registered component of data, is listed twice, is a set or map or shared, a sorted part has no
+ * order, its object parts live on different threads, or on another than the world's beside a string, which the world
+ * keeps its keys of, it's unique without a key, or `with` or `not` names a key that isn't a registered component
+ * or `not` names a key part or a `with` component.
+ */
+export declare const create: <const D extends Declaration>(declaration: D & Validate<D>) => Index<D>;
+export {};

package/dist/interface/indexes/create.js

@@ -0,0 +1,82 @@
+import { threadOfDeclaration } from '../registry/declarations.js';
+import { takeIdOfDeclaration } from '../registry/ids.js';
+import { addIndex } from '../registry/indexes.js';
+import { nameOf } from '../registry/items.js';
+import { layoutOf } from '../registry/layout.js';
+import { declarationOf, firstKeyOf, kindOf, labelOf, whyUnregistered } from '../registry/names.js';
+/** Whether a schema's values have an order: numbers, booleans, entities and fixed-length tuples of them, and strings. */
+const ordered = (schema) => {
+    if ("type" in schema && schema.type === "string")
+        return true;
+    const layout = layoutOf(schema);
+    return layout.kind === "linear" && layout.leaves.every(leaf => leaf.path.every(step => typeof step === "number"));
+};
+/** Whether a schema's values are sets or maps, which a key part can't be yet. */
+const collection = (schema) => "type" in schema && (schema.type === "set" || schema.type === "map");
+/**
+ * Declares an index over components' values and returns it; nothing is built until a world's system or finalizer uses
+ * it. It holds the entities with every key part and every component in `with`, and none in `not`, keyed by the values
+ * of `key`, compared part by part: numbers and tuples by value, an entity with its generation, so a stale one finds
+ * nothing. With an empty key it holds those entities, every entity but the resource entity when `with` and `not` are
+ * empty too, and its lookup takes no key and gives them all, in entity order.
+ * - `sorted`: keeps key order, numbers numerically, NaN last, booleans false first, strings by code point, tuples
+ *   element by element, then entity order, so a lookup takes a prefix of the key whose last part may be a comparison.
+ * - `unique`: at most one entity per key: a lookup by a whole key returns its row or null. When two entities share a
+ *   key, the one with the lower entity index is kept, and the index fails the run or tick that found them.
+ *
+ * Throws if a key part isn't a registered component of data, is listed twice, is a set or map or shared, a sorted part has no
+ * order, its object parts live on different threads, or on another than the world's beside a string, which the world
+ * keeps its keys of, it's unique without a key, or `with` or `not` names a key that isn't a registered component
+ * or `not` names a key part or a `with` component.
+ */
+export const create = (declaration) => {
+    const id = takeIdOfDeclaration(declaration);
+    const name = nameOf(declaration, id, "index");
+    const fail = (message) => { throw new Error(`Index "${name}" ${message}.`); };
+    const { key, sorted } = declaration;
+    const components = declaration.components === undefined ? undefined : { has: declaration.components.with, not: declaration.components.not };
+    if (!Array.isArray(key))
+        fail("needs a key: a list of components");
+    if (key.length === 0 && declaration.unique === true)
+        fail("is unique without a key: it holds at most one entity per key");
+    const threads = new Set();
+    const parts = new Set();
+    for (const part of key) {
+        const found = declarationOf(part);
+        const type = found?.type;
+        if (kindOf(part) !== "component" || type === undefined)
+            fail(`has key part "${labelOf(part)}", which isn't a registered component of data: ${whyUnregistered(part)}`);
+        else {
+            if (parts.has(firstKeyOf(part)))
+                fail(`lists key part "${labelOf(part)}" twice`);
+            parts.add(firstKeyOf(part));
+            if (collection(type))
+                fail(`has key part "${labelOf(part)}", a set or map, which a key part can't be yet`);
+            if (found?.shared === true)
+                fail(`has key part "${labelOf(part)}", a shared component: filter by it with where`);
+            if (sorted === true && !ordered(type))
+                fail(`is sorted by "${labelOf(part)}", whose values have no order: a sorted part is a number, boolean, entity, string or fixed-length tuple of them`);
+            // The world's thread keeps keys of strings, so they hold the index there with its objects.
+            const thread = found === undefined ? null : threadOfDeclaration(found) ?? (layoutOf(type).kind === "string" ? "world" : null);
+            if (thread !== null)
+                threads.add(thread);
+        }
+    }
+    if (threads.size > 1)
+        fail(`has key parts on threads ${[...threads].map(thread => `"${thread}"`).join(" and ")}; its object parts live on one thread, the world's beside a string`);
+    const held = new Set(parts);
+    for (const component of components?.has ?? []) {
+        if (kindOf(component) !== "component")
+            fail(`has "${labelOf(component)}", which isn't a registered component: ${whyUnregistered(component)}`);
+        held.add(firstKeyOf(component));
+    }
+    for (const component of components?.not ?? []) {
+        if (kindOf(component) !== "component")
+            fail(`excludes "${labelOf(component)}", which isn't a registered component: ${whyUnregistered(component)}`);
+        if (held.has(firstKeyOf(component)))
+            fail(`excludes "${labelOf(component)}", which it holds by`);
+    }
+    const index = { kind: "index", name, declaration: { ...declaration, ...components === undefined ? {} : { components } } };
+    return addIndex(index, id);
+};
+//# sourceMappingURL=create.js.map

package/dist/interface/indexes/create.js.map

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

package/dist/interface/indexes/created.d.ts

@@ -0,0 +1,7 @@
+import type { Stored } from './declaration.js';
+/** What `Index.create` records: its kind, its label and its declaration. */
+export type Created = {
+    readonly kind: "index";
+    readonly name: string;
+    readonly declaration: Stored;
+};

package/dist/interface/indexes/created.js

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

package/dist/interface/indexes/created.js.map

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

package/dist/interface/indexes/declaration.d.ts

@@ -0,0 +1,18 @@
+import type { Component } from '../component/component.js';
+/** What `Index.create` takes, its fields documented there; not exported from the package. */
+export type Declaration = {
+    readonly key: readonly Component.Key[];
+    readonly components?: {
+        readonly with?: readonly Component.Key[];
+        readonly not?: readonly Component.Key[];
+    };
+    readonly sorted?: boolean;
+    readonly unique?: boolean;
+};
+/** An index's declaration as the world takes it: what it requires in `has`. */
+export type Stored = Omit<Declaration, "components"> & {
+    readonly components?: {
+        readonly has?: readonly symbol[];
+        readonly not?: readonly symbol[];
+    };
+};

package/dist/interface/indexes/declaration.js

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

package/dist/interface/indexes/declaration.js.map

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

package/dist/interface/indexes/index-type.d.ts

@@ -0,0 +1,12 @@
+import type { Declaration } from './declaration.js';
+declare const declared: unique symbol;
+/**
+ * An index, the value `Index.create` returned: identified by that value, labeled by the binding it's declared at. `D`
+ * is the type of the declaration it was created from, which its lookups take their key and rows from; code accepting
+ * any sorted index takes `Index<{ readonly sorted: true }>`.
+ */
+export type Index<D extends object = Declaration> = {
+    readonly name: string;
+    readonly [declared]?: D;
+};
+export * as Index from './index.js';

package/dist/interface/indexes/index-type.js

@@ -0,0 +1,2 @@
+export * as Index from './index.js';
+//# sourceMappingURL=index-type.js.map

package/dist/interface/indexes/index-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-type.js","sourceRoot":"","sources":["../../../src/interface/indexes/index-type.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/interface/indexes/index.d.ts

@@ -0,0 +1 @@
+export * from './create.js';

package/dist/interface/indexes/index.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * from './create.js';
+//# sourceMappingURL=index.js.map

package/dist/interface/indexes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/indexes/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,aAAa,CAAC"}

package/dist/interface/math/f32/default.d.ts

@@ -0,0 +1,4 @@
+import type { F32 } from "./index.js";
+/** What a value of this type starts at. */
+declare const start: F32;
+export { start as default };

package/dist/interface/math/f32/default.js

@@ -0,0 +1,4 @@
+/** What a value of this type starts at. */
+const start = 0;
+export { start as default };
+//# sourceMappingURL=default.js.map

package/dist/interface/math/f32/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../src/interface/math/f32/default.ts"],"names":[],"mappings":"AAGA,2CAA2C;AAC3C,MAAM,KAAK,GAAQ,CAAC,CAAC;AACrB,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}

package/dist/interface/math/f32/index.d.ts

@@ -0,0 +1,4 @@
+import type { Schema } from "../../schema/schema.js";
+import type { schema } from "./schema.js";
+export type F32 = Schema.Type<typeof schema>;
+export * as F32 from "./public.js";

package/dist/interface/math/f32/index.js

@@ -0,0 +1,2 @@
+export * as F32 from "./public.js";
+//# sourceMappingURL=index.js.map

package/dist/interface/math/f32/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/interface/math/f32/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC"}

package/dist/interface/math/f32/public.d.ts

@@ -0,0 +1,2 @@
+export * from "./schema.js";
+export { default } from "./default.js";

package/dist/interface/math/f32/public.js

@@ -0,0 +1,4 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * from "./schema.js";
+export { default } from "./default.js";
+//# sourceMappingURL=public.js.map

package/dist/interface/math/f32/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/interface/math/f32/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/interface/math/f32/round-half-even.d.ts

@@ -0,0 +1,2 @@
+/** Rounds to the nearest integer, and halfway values to the even one, as WGSL's `round` does. */
+export declare const roundHalfEven: (x: number) => number;

package/dist/interface/math/f32/round-half-even.js

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/** Rounds to the nearest integer, and halfway values to the even one, as WGSL's `round` does. */
+export const roundHalfEven = (x) => {
+    const rounded = Math.round(x);
+    return rounded - x === 0.5 && Math.floor(rounded * 0.5) * 2 !== rounded ? rounded - 1 : rounded;
+};
+//# sourceMappingURL=round-half-even.js.map

package/dist/interface/math/f32/round-half-even.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-half-even.js","sourceRoot":"","sources":["../../../../src/interface/math/f32/round-half-even.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,iGAAiG;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAU,EAAE;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpG,CAAC,CAAC"}

package/dist/interface/math/f32/schema.d.ts

@@ -0,0 +1,4 @@
+export declare const schema: {
+    readonly type: "number";
+    readonly precision: 1;
+};

package/dist/interface/math/f32/schema.js

@@ -0,0 +1,2 @@
+export const schema = { type: "number", precision: 1 };
+//# sourceMappingURL=schema.js.map

package/dist/interface/math/f32/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/interface/math/f32/schema.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAA4B,CAAC"}

package/dist/interface/math/i32/default.d.ts

@@ -0,0 +1,4 @@
+import type { I32 } from "./index.js";
+/** What a value of this type starts at. */
+declare const start: I32;
+export { start as default };

package/dist/interface/math/i32/default.js

@@ -0,0 +1,4 @@
+/** What a value of this type starts at. */
+const start = 0;
+export { start as default };
+//# sourceMappingURL=default.js.map

package/dist/interface/math/i32/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../src/interface/math/i32/default.ts"],"names":[],"mappings":"AAGA,2CAA2C;AAC3C,MAAM,KAAK,GAAQ,CAAC,CAAC;AACrB,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}

package/dist/interface/math/i32/index.d.ts

@@ -0,0 +1,5 @@
+import type { Schema } from "../../schema/schema.js";
+import type { schema } from "./schema.js";
+/** Integers in [-2^31, 2^31). Functions wrap as WGSL's i32 does; for other values their results are indeterminate. */
+export type I32 = Schema.Type<typeof schema>;
+export * as I32 from "./public.js";

package/dist/interface/math/i32/index.js

@@ -0,0 +1,2 @@
+export * as I32 from "./public.js";
+//# sourceMappingURL=index.js.map

package/dist/interface/math/i32/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/interface/math/i32/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC"}

package/dist/interface/math/i32/public.d.ts

@@ -0,0 +1,3 @@
+export { schema } from "./schema.js";
+export { shiftRight } from "./shift-right.js";
+export { default } from "./default.js";

package/dist/interface/math/i32/public.js

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { schema } from "./schema.js";
+export { shiftRight } from "./shift-right.js";
+export { default } from "./default.js";
+//# sourceMappingURL=public.js.map

package/dist/interface/math/i32/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/interface/math/i32/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/interface/math/i32/schema.d.ts

@@ -0,0 +1,5 @@
+export declare const schema: {
+    readonly type: "integer";
+    readonly minimum: -2147483648;
+    readonly maximum: 2147483647;
+};

package/dist/interface/math/i32/schema.js

@@ -0,0 +1,2 @@
+export const schema = { type: "integer", minimum: -2147483648, maximum: 2147483647 };
+//# sourceMappingURL=schema.js.map

package/dist/interface/math/i32/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/interface/math/i32/schema.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAA4B,CAAC"}

package/dist/interface/math/i32/shift-right.d.ts

@@ -0,0 +1,2 @@
+import type { I32 } from "./index.js";
+export declare const shiftRight: (n: I32, shift: number) => I32;

package/dist/interface/math/i32/shift-right.js

@@ -0,0 +1,2 @@
+export const shiftRight = (n, shift) => n >> shift;
+//# sourceMappingURL=shift-right.js.map

package/dist/interface/math/i32/shift-right.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-right.js","sourceRoot":"","sources":["../../../../src/interface/math/i32/shift-right.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAM,EAAE,KAAa,EAAO,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC"}

package/dist/interface/math/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./f32/index.js";
+export * from "./i32/index.js";
+export * from "./u32/index.js";
+export * from "./vec2/index.js";
+export * from "./vec3/index.js";
+export * from "./vec4/index.js";
+export * from "./quat/index.js";
+export * from "./mat4x4/index.js";

package/dist/interface/math/index.js

@@ -0,0 +1,10 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * from "./f32/index.js";
+export * from "./i32/index.js";
+export * from "./u32/index.js";
+export * from "./vec2/index.js";
+export * from "./vec3/index.js";
+export * from "./vec4/index.js";
+export * from "./quat/index.js";
+export * from "./mat4x4/index.js";
+//# sourceMappingURL=index.js.map

package/dist/interface/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interface/math/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/interface/math/intrinsic.d.ts

@@ -0,0 +1,13 @@
+/** A WGSL value type an intrinsic takes or returns, made of one lane per scalar leaf. */
+export type WgslType = "f32" | "i32" | "u32" | "vec2f" | "vec3f" | "vec4f" | "vec2i" | "vec3i" | "vec4i" | "vec2u" | "vec3u" | "vec4u" | "mat4x4f";
+/**
+ * Declares the WGSL builtin a math function matches, so GPU kernels emit `wgsl` for calls to it: a function, or with
+ * `form`, an operator between or before its operands. Other backends inline `implementation`, which is returned as is.
+ * The compiler reads the declaration from source, so it is written as literals.
+ */
+export declare const intrinsic: <F>(declaration: {
+    readonly wgsl: string;
+    readonly form?: "infix" | "prefix";
+    readonly parameters: readonly WgslType[];
+    readonly result: WgslType;
+}, implementation: F) => F;

package/dist/interface/math/intrinsic.js

@@ -0,0 +1,10 @@
+/**
+ * Declares the WGSL builtin a math function matches, so GPU kernels emit `wgsl` for calls to it: a function, or with
+ * `form`, an operator between or before its operands. Other backends inline `implementation`, which is returned as is.
+ * The compiler reads the declaration from source, so it is written as literals.
+ */
+export const intrinsic = (declaration, implementation) => {
+    void declaration;
+    return implementation;
+};
+//# sourceMappingURL=intrinsic.js.map

package/dist/interface/math/intrinsic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intrinsic.js","sourceRoot":"","sources":["../../../src/interface/math/intrinsic.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACrB,WAA+I,EAC/I,cAAiB,EAChB,EAAE;IACH,KAAK,WAAW,CAAC;IACjB,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC"}

package/dist/interface/math/mat4x4/add.d.ts

@@ -0,0 +1,2 @@
+import type { Mat4x4 } from "./index.js";
+export declare const add: (a: Mat4x4, b: Mat4x4) => Mat4x4;

package/dist/interface/math/mat4x4/add.js

@@ -0,0 +1,8 @@
+import { intrinsic } from "../intrinsic.js";
+export const add = intrinsic({ wgsl: "+", form: "infix", parameters: ["mat4x4f", "mat4x4f"], result: "mat4x4f" }, (a, b) => [
+    a[0] + b[0], a[1] + b[1], a[2] + b[2], a[3] + b[3],
+    a[4] + b[4], a[5] + b[5], a[6] + b[6], a[7] + b[7],
+    a[8] + b[8], a[9] + b[9], a[10] + b[10], a[11] + b[11],
+    a[12] + b[12], a[13] + b[13], a[14] + b[14], a[15] + b[15]
+]);
+//# sourceMappingURL=add.js.map

package/dist/interface/math/mat4x4/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../src/interface/math/mat4x4/add.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC;IAChJ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;CAC7D,CAAC,CAAC"}

package/dist/interface/math/mat4x4/determinant.d.ts

@@ -0,0 +1,2 @@
+import type { Mat4x4 } from "./index.js";
+export declare const determinant: (m: Mat4x4) => number;

package/dist/interface/math/mat4x4/determinant.js

@@ -0,0 +1,18 @@
+import { intrinsic } from "../intrinsic.js";
+export const determinant = intrinsic({ wgsl: "determinant", parameters: ["mat4x4f"], result: "f32" }, (m) => {
+    const [m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33] = m;
+    const b00 = m00 * m11 - m01 * m10;
+    const b01 = m00 * m12 - m02 * m10;
+    const b02 = m00 * m13 - m03 * m10;
+    const b03 = m01 * m12 - m02 * m11;
+    const b04 = m01 * m13 - m03 * m11;
+    const b05 = m02 * m13 - m03 * m12;
+    const b06 = m20 * m31 - m21 * m30;
+    const b07 = m20 * m32 - m22 * m30;
+    const b08 = m20 * m33 - m23 * m30;
+    const b09 = m21 * m32 - m22 * m31;
+    const b10 = m21 * m33 - m23 * m31;
+    const b11 = m22 * m33 - m23 * m32;
+    return b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;
+});
+//# sourceMappingURL=determinant.js.map