gloop-sim 0.0.0-stage → 1.0.0

package/dist/render/backend/solids.js

@@ -0,0 +1,134 @@
+import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
+import { attribute, dot, float, max, normalize, normalView, positionLocal, vec3 } from "three/tsl";
+import { CylinderGeometry, DynamicDrawUsage, InstancedBufferAttribute, InstancedBufferGeometry, Mesh, OctahedronGeometry, SphereGeometry, TorusGeometry, } from "three/webgpu";
+import { assert } from "../../assert.js";
+import { prepareGlyphReader } from "../../render/backend/cloud.js";
+import { material as materialFactory } from "../../render/backend/material.js";
+const SOLID_GLYPHS = new Set(["sphere", "octahedron", "axes", "gimbal"]);
+const CENTER_ATTRIBUTE = "aCenter";
+const SCALE_ATTRIBUTE = "aScale";
+const COLOR_ATTRIBUTE = "aColor";
+const FLOATS_PER_CENTER = 3;
+const FLOATS_PER_COLOR = 4;
+const SHADING = {
+    /**
+     * The direction of the light, in view space, toward the light.
+     */
+    light: [0.35, 0.55, 0.75],
+    /**
+     * The brightness of a surface facing away from the light, as a fraction of
+     * one facing it.
+     */
+    ambient: 0.4,
+};
+/**
+ * Whether `shape` is drawn as a solid.
+ */
+export function isSolid(shape) {
+    return SOLID_GLYPHS.has(shape);
+}
+// Each shape fits the unit cube that a flat glyph's quad spans, with the
+// proportions of the flat glyph it corresponds to.
+function solidGeometry(shape) {
+    switch (shape) {
+        case "sphere":
+            return new SphereGeometry(0.55, 12, 8);
+        case "octahedron":
+            return new OctahedronGeometry(0.75);
+        case "axes":
+            return merged([
+                new CylinderGeometry(0.11, 0.11, 1.7, 6).rotateZ(Math.PI / 2),
+                new CylinderGeometry(0.11, 0.11, 1.7, 6),
+                new CylinderGeometry(0.11, 0.11, 1.7, 6).rotateX(Math.PI / 2),
+            ]);
+        case "gimbal":
+            return merged([
+                new TorusGeometry(0.8, 0.06, 6, 32),
+                new TorusGeometry(0.8, 0.06, 6, 32).rotateX(Math.PI / 2),
+                new TorusGeometry(0.8, 0.06, 6, 32).rotateY(Math.PI / 2),
+            ]);
+    }
+}
+function merged(parts) {
+    const result = mergeGeometries(parts);
+    assert(result !== null, "solid glyph parts have mismatched attributes");
+    for (const part of parts) {
+        part.dispose();
+    }
+    return result;
+}
+function instancedCopy(base) {
+    const result = new InstancedBufferGeometry();
+    result.setIndex(base.getIndex());
+    for (const [name, values] of Object.entries(base.attributes)) {
+        result.setAttribute(name, values);
+    }
+    return result;
+}
+function createSolidMaterial() {
+    const color = attribute(COLOR_ATTRIBUTE, "vec4");
+    const facing = max(dot(normalView, normalize(vec3(...SHADING.light))), 0);
+    const shade = float(SHADING.ambient).add(facing.mul(1 - SHADING.ambient));
+    const result = materialFactory.solid({ color: color.xyz.mul(shade), opacity: color.w });
+    const center = attribute(CENTER_ATTRIBUTE, "vec3");
+    const scale = attribute(SCALE_ATTRIBUTE, "float");
+    result.positionNode = positionLocal.mul(scale).add(center);
+    return result;
+}
+function instancedAttribute(count, itemSize) {
+    const result = new InstancedBufferAttribute(new Float32Array(count * itemSize), itemSize);
+    result.setUsage(DynamicDrawUsage);
+    return result;
+}
+function allocateSolidAttributes(geometry, count) {
+    const attributes = {
+        centers: instancedAttribute(count, FLOATS_PER_CENTER),
+        scales: instancedAttribute(count, 1),
+        colors: instancedAttribute(count, FLOATS_PER_COLOR),
+    };
+    geometry.setAttribute(CENTER_ATTRIBUTE, attributes.centers);
+    geometry.setAttribute(SCALE_ATTRIBUTE, attributes.scales);
+    geometry.setAttribute(COLOR_ATTRIBUTE, attributes.colors);
+    geometry.instanceCount = count;
+    return attributes;
+}
+/**
+ * Builds a glyph cloud that draws one shaded solid per particle.
+ */
+export function buildSolidCloud({ shape, style, sizeScale }) {
+    const geometry = instancedCopy(solidGeometry(shape));
+    const material = createSolidMaterial();
+    const mesh = new Mesh(geometry, material);
+    mesh.frustumCulled = false;
+    let count = -1;
+    let attributes = allocateSolidAttributes(geometry, 0);
+    return {
+        mesh,
+        update(frame, indices) {
+            if (indices.length !== count) {
+                count = indices.length;
+                attributes = allocateSolidAttributes(geometry, count);
+            }
+            const read = prepareGlyphReader(style, sizeScale, frame);
+            const centers = attributes.centers.array;
+            const scales = attributes.scales.array;
+            const colors = attributes.colors.array;
+            for (let slot = 0; slot < indices.length; slot++) {
+                const particle = indices[slot];
+                assert(particle !== undefined, `glyph slot ${slot} has no source particle`);
+                const { halfSize, center, color } = read(particle);
+                centers.set([center.x, center.y, center.z], slot * FLOATS_PER_CENTER);
+                scales[slot] = halfSize;
+                colors.set([color.r, color.g, color.b, color.a], slot * FLOATS_PER_COLOR);
+            }
+            attributes.centers.needsUpdate = true;
+            attributes.scales.needsUpdate = true;
+            attributes.colors.needsUpdate = true;
+        },
+        dispose() {
+            geometry.dispose();
+            material.dispose();
+        },
+    };
+}
+//# sourceMappingURL=solids.js.map

package/dist/render/backend/solids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solids.js","sourceRoot":"","sources":["../../../src/render/backend/solids.ts"],"names":[],"mappings":"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","sourcesContent":["import { mergeGeometries } from \"three/addons/utils/BufferGeometryUtils.js\";\nimport { attribute, dot, float, max, normalize, normalView, positionLocal, vec3 } from \"three/tsl\";\nimport {\n  type BufferGeometry,\n  CylinderGeometry,\n  DynamicDrawUsage,\n  InstancedBufferAttribute,\n  InstancedBufferGeometry,\n  Mesh,\n  type MeshBasicNodeMaterial,\n  OctahedronGeometry,\n  SphereGeometry,\n  TorusGeometry,\n} from \"three/webgpu\";\nimport { assert } from \"@/assert.js\";\nimport { type GlyphCloud, type GlyphCloudOptions, prepareGlyphReader } from \"@/render/backend/cloud.js\";\nimport { material as materialFactory } from \"@/render/backend/material.js\";\nimport type { Frame } from \"@/render/frame.js\";\nimport type { ParticleGlyph, SolidGlyph } from \"@/render/layer.js\";\n\nconst SOLID_GLYPHS: ReadonlySet<ParticleGlyph> = new Set<SolidGlyph>([\"sphere\", \"octahedron\", \"axes\", \"gimbal\"]);\n\nconst CENTER_ATTRIBUTE = \"aCenter\";\nconst SCALE_ATTRIBUTE = \"aScale\";\nconst COLOR_ATTRIBUTE = \"aColor\";\n\nconst FLOATS_PER_CENTER = 3;\nconst FLOATS_PER_COLOR = 4;\n\nconst SHADING = {\n  /**\n   * The direction of the light, in view space, toward the light.\n   */\n  light: [0.35, 0.55, 0.75],\n\n  /**\n   * The brightness of a surface facing away from the light, as a fraction of\n   * one facing it.\n   */\n  ambient: 0.4,\n} as const;\n\ninterface SolidAttributes {\n  centers: InstancedBufferAttribute;\n  scales: InstancedBufferAttribute;\n  colors: InstancedBufferAttribute;\n}\n\n/**\n * Whether `shape` is drawn as a solid.\n */\nexport function isSolid(shape: ParticleGlyph): shape is SolidGlyph {\n  return SOLID_GLYPHS.has(shape);\n}\n\n// Each shape fits the unit cube that a flat glyph's quad spans, with the\n// proportions of the flat glyph it corresponds to.\nfunction solidGeometry(shape: SolidGlyph): BufferGeometry {\n  switch (shape) {\n    case \"sphere\":\n      return new SphereGeometry(0.55, 12, 8);\n    case \"octahedron\":\n      return new OctahedronGeometry(0.75);\n    case \"axes\":\n      return merged([\n        new CylinderGeometry(0.11, 0.11, 1.7, 6).rotateZ(Math.PI / 2),\n        new CylinderGeometry(0.11, 0.11, 1.7, 6),\n        new CylinderGeometry(0.11, 0.11, 1.7, 6).rotateX(Math.PI / 2),\n      ]);\n    case \"gimbal\":\n      return merged([\n        new TorusGeometry(0.8, 0.06, 6, 32),\n        new TorusGeometry(0.8, 0.06, 6, 32).rotateX(Math.PI / 2),\n        new TorusGeometry(0.8, 0.06, 6, 32).rotateY(Math.PI / 2),\n      ]);\n  }\n}\n\nfunction merged(parts: BufferGeometry[]): BufferGeometry {\n  const result = mergeGeometries(parts);\n  assert(result !== null, \"solid glyph parts have mismatched attributes\");\n  for (const part of parts) {\n    part.dispose();\n  }\n  return result;\n}\n\nfunction instancedCopy(base: BufferGeometry): InstancedBufferGeometry {\n  const result = new InstancedBufferGeometry();\n  result.setIndex(base.getIndex());\n  for (const [name, values] of Object.entries(base.attributes)) {\n    result.setAttribute(name, values);\n  }\n  return result;\n}\n\nfunction createSolidMaterial(): MeshBasicNodeMaterial {\n  const color = attribute<\"vec4\">(COLOR_ATTRIBUTE, \"vec4\");\n  const facing = max(dot(normalView, normalize(vec3(...SHADING.light))), 0);\n  const shade = float(SHADING.ambient).add(facing.mul(1 - SHADING.ambient));\n  const result = materialFactory.solid({ color: color.xyz.mul(shade), opacity: color.w });\n  const center = attribute<\"vec3\">(CENTER_ATTRIBUTE, \"vec3\");\n  const scale = attribute<\"float\">(SCALE_ATTRIBUTE, \"float\");\n  result.positionNode = positionLocal.mul(scale).add(center);\n  return result;\n}\n\nfunction instancedAttribute(count: number, itemSize: number): InstancedBufferAttribute {\n  const result = new InstancedBufferAttribute(new Float32Array(count * itemSize), itemSize);\n  result.setUsage(DynamicDrawUsage);\n  return result;\n}\n\nfunction allocateSolidAttributes(geometry: InstancedBufferGeometry, count: number): SolidAttributes {\n  const attributes = {\n    centers: instancedAttribute(count, FLOATS_PER_CENTER),\n    scales: instancedAttribute(count, 1),\n    colors: instancedAttribute(count, FLOATS_PER_COLOR),\n  };\n  geometry.setAttribute(CENTER_ATTRIBUTE, attributes.centers);\n  geometry.setAttribute(SCALE_ATTRIBUTE, attributes.scales);\n  geometry.setAttribute(COLOR_ATTRIBUTE, attributes.colors);\n  geometry.instanceCount = count;\n  return attributes;\n}\n\n/**\n * Builds a glyph cloud that draws one shaded solid per particle.\n */\nexport function buildSolidCloud({ shape, style, sizeScale }: GlyphCloudOptions<SolidGlyph>): GlyphCloud {\n  const geometry = instancedCopy(solidGeometry(shape));\n  const material = createSolidMaterial();\n  const mesh = new Mesh(geometry, material);\n  mesh.frustumCulled = false;\n\n  let count = -1;\n  let attributes = allocateSolidAttributes(geometry, 0);\n\n  return {\n    mesh,\n\n    update(frame: Frame, indices: readonly number[]): void {\n      if (indices.length !== count) {\n        count = indices.length;\n        attributes = allocateSolidAttributes(geometry, count);\n      }\n\n      const read = prepareGlyphReader(style, sizeScale, frame);\n      const centers = attributes.centers.array as Float32Array;\n      const scales = attributes.scales.array as Float32Array;\n      const colors = attributes.colors.array as Float32Array;\n      for (let slot = 0; slot < indices.length; slot++) {\n        const particle = indices[slot];\n        assert(particle !== undefined, `glyph slot ${slot} has no source particle`);\n        const { halfSize, center, color } = read(particle);\n        centers.set([center.x, center.y, center.z], slot * FLOATS_PER_CENTER);\n        scales[slot] = halfSize;\n        colors.set([color.r, color.g, color.b, color.a], slot * FLOATS_PER_COLOR);\n      }\n\n      attributes.centers.needsUpdate = true;\n      attributes.scales.needsUpdate = true;\n      attributes.colors.needsUpdate = true;\n    },\n\n    dispose(): void {\n      geometry.dispose();\n      material.dispose();\n    },\n  };\n}\n"]}

package/dist/render/camera.d.ts

@@ -0,0 +1,73 @@
+/**
+ * A three-component position or direction in scene space.
+ */
+export type Vec3 = readonly [x: number, y: number, z: number];
+/**
+ * The framing of a camera configuration.
+ */
+interface Framing {
+    /**
+     * The camera position in scene space.
+     */
+    readonly position: Vec3;
+    /**
+     * The point the camera looks toward.
+     */
+    readonly target: Vec3;
+}
+/**
+ * A camera configuration that uses a perspective projection, where objects
+ * farther from the camera appear smaller, the way the eye and a real lens see.
+ */
+export interface PerspectiveCamera extends Framing {
+    readonly kind: "perspective";
+    /**
+     * The vertical field of view, in degrees.
+     */
+    readonly fieldOfView: number;
+    readonly near: number;
+    readonly far: number;
+}
+/**
+ * A camera configuration that uses an orthographic projection, where an object
+ * keeps the same size no matter its distance, so parallel lines stay parallel.
+ */
+export interface OrthographicCamera extends Framing {
+    readonly kind: "orthographic";
+    /**
+     * Half the vertical extent of the view volume, in scene units.
+     */
+    readonly extent: number;
+    readonly near: number;
+    readonly far: number;
+}
+/**
+ * Any camera descriptor a stage accepts.
+ */
+export type Camera = PerspectiveCamera | OrthographicCamera;
+/**
+ * The camera factories exposed on `view.camera`.
+ */
+export declare namespace camera {
+    /**
+     * A perspective camera.
+     */
+    function perspective({ position, target, fieldOfView, near, far, }?: {
+        position?: Vec3;
+        target?: Vec3;
+        fieldOfView?: number;
+        near?: number;
+        far?: number;
+    }): PerspectiveCamera;
+    /**
+     * An orthographic camera.
+     */
+    function orthographic({ position, target, extent, near, far, }?: {
+        position?: Vec3;
+        target?: Vec3;
+        extent?: number;
+        near?: number;
+        far?: number;
+    }): OrthographicCamera;
+}
+export {};

package/dist/render/camera.js

@@ -0,0 +1,32 @@
+import { assert } from "../assert.js";
+const DEFAULT_POSITION = [0, 0, 3];
+const DEFAULT_TARGET = [0, 0, 0];
+function verifyClipRange({ near, far }) {
+    assert(near > 0, `camera near plane must be positive, but is ${near}`);
+    assert(far > near, `camera far plane ${far} must exceed the near plane ${near}`);
+}
+/**
+ * The camera factories exposed on `view.camera`.
+ */
+export var camera;
+(function (camera) {
+    /**
+     * A perspective camera.
+     */
+    function perspective({ position = DEFAULT_POSITION, target = DEFAULT_TARGET, fieldOfView = 45, near = 0.01, far = 100, } = {}) {
+        assert(fieldOfView > 0 && fieldOfView < 180, `field of view must be within 0..180, but is ${fieldOfView}`);
+        verifyClipRange({ near, far });
+        return { kind: "perspective", position, target, fieldOfView, near, far };
+    }
+    camera.perspective = perspective;
+    /**
+     * An orthographic camera.
+     */
+    function orthographic({ position = DEFAULT_POSITION, target = DEFAULT_TARGET, extent = 1.2, near = 0.01, far = 100, } = {}) {
+        assert(extent > 0, `orthographic extent must be positive, but is ${extent}`);
+        verifyClipRange({ near, far });
+        return { kind: "orthographic", position, target, extent, near, far };
+    }
+    camera.orthographic = orthographic;
+})(camera || (camera = {}));
+//# sourceMappingURL=camera.js.map

package/dist/render/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../src/render/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAuDrC,MAAM,gBAAgB,GAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACzC,MAAM,cAAc,GAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvC,SAAS,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,EAAiC;IACnE,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,8CAA8C,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,oBAAoB,GAAG,+BAA+B,IAAI,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,KAAW,MAAM,CA0CtB;AA1CD,WAAiB,MAAM;IACrB;;OAEG;IACH,SAAgB,WAAW,CAAC,EAC1B,QAAQ,GAAG,gBAAgB,EAC3B,MAAM,GAAG,cAAc,EACvB,WAAW,GAAG,EAAE,EAChB,IAAI,GAAG,IAAI,EACX,GAAG,GAAG,GAAG,MAOP,EAAE;QACJ,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,GAAG,EAAE,+CAA+C,WAAW,EAAE,CAAC,CAAC;QAC3G,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC3E,CAAC;IAhBe,kBAAW,cAgB1B,CAAA;IAED;;OAEG;IACH,SAAgB,YAAY,CAAC,EAC3B,QAAQ,GAAG,gBAAgB,EAC3B,MAAM,GAAG,cAAc,EACvB,MAAM,GAAG,GAAG,EACZ,IAAI,GAAG,IAAI,EACX,GAAG,GAAG,GAAG,MAOP,EAAE;QACJ,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,gDAAgD,MAAM,EAAE,CAAC,CAAC;QAC7E,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACvE,CAAC;IAhBe,mBAAY,eAgB3B,CAAA;AACH,CAAC,EA1CgB,MAAM,KAAN,MAAM,QA0CtB","sourcesContent":["import { assert } from \"@/assert.js\";\n\n/**\n * A three-component position or direction in scene space.\n */\nexport type Vec3 = readonly [x: number, y: number, z: number];\n\n/**\n * The framing of a camera configuration.\n */\ninterface Framing {\n  /**\n   * The camera position in scene space.\n   */\n  readonly position: Vec3;\n\n  /**\n   * The point the camera looks toward.\n   */\n  readonly target: Vec3;\n}\n\n/**\n * A camera configuration that uses a perspective projection, where objects\n * farther from the camera appear smaller, the way the eye and a real lens see.\n */\nexport interface PerspectiveCamera extends Framing {\n  readonly kind: \"perspective\";\n  /**\n   * The vertical field of view, in degrees.\n   */\n  readonly fieldOfView: number;\n  readonly near: number;\n  readonly far: number;\n}\n\n/**\n * A camera configuration that uses an orthographic projection, where an object\n * keeps the same size no matter its distance, so parallel lines stay parallel.\n */\nexport interface OrthographicCamera extends Framing {\n  readonly kind: \"orthographic\";\n  /**\n   * Half the vertical extent of the view volume, in scene units.\n   */\n  readonly extent: number;\n  readonly near: number;\n  readonly far: number;\n}\n\n/**\n * Any camera descriptor a stage accepts.\n */\nexport type Camera = PerspectiveCamera | OrthographicCamera;\n\nconst DEFAULT_POSITION: Vec3 = [0, 0, 3];\nconst DEFAULT_TARGET: Vec3 = [0, 0, 0];\n\nfunction verifyClipRange({ near, far }: { near: number; far: number }): void {\n  assert(near > 0, `camera near plane must be positive, but is ${near}`);\n  assert(far > near, `camera far plane ${far} must exceed the near plane ${near}`);\n}\n\n/**\n * The camera factories exposed on `view.camera`.\n */\nexport namespace camera {\n  /**\n   * A perspective camera.\n   */\n  export function perspective({\n    position = DEFAULT_POSITION,\n    target = DEFAULT_TARGET,\n    fieldOfView = 45,\n    near = 0.01,\n    far = 100,\n  }: {\n    position?: Vec3;\n    target?: Vec3;\n    fieldOfView?: number;\n    near?: number;\n    far?: number;\n  } = {}): PerspectiveCamera {\n    assert(fieldOfView > 0 && fieldOfView < 180, `field of view must be within 0..180, but is ${fieldOfView}`);\n    verifyClipRange({ near, far });\n    return { kind: \"perspective\", position, target, fieldOfView, near, far };\n  }\n\n  /**\n   * An orthographic camera.\n   */\n  export function orthographic({\n    position = DEFAULT_POSITION,\n    target = DEFAULT_TARGET,\n    extent = 1.2,\n    near = 0.01,\n    far = 100,\n  }: {\n    position?: Vec3;\n    target?: Vec3;\n    extent?: number;\n    near?: number;\n    far?: number;\n  } = {}): OrthographicCamera {\n    assert(extent > 0, `orthographic extent must be positive, but is ${extent}`);\n    verifyClipRange({ near, far });\n    return { kind: \"orthographic\", position, target, extent, near, far };\n  }\n}\n"]}

package/dist/render/channel.d.ts

@@ -0,0 +1,25 @@
+import type { Source } from "../render/sources.js";
+/**
+ * A component extracting data for visualization from a source.
+ */
+export interface Channel<S extends Source> {
+    /**
+     * A human-readable label for data provided by this channel.
+     */
+    readonly name: string;
+    /**
+     * The value of whatever this channel represents for each element in source.
+     */
+    values(source: S): Float32Array;
+}
+/**
+ * Options for {@link channel}.
+ */
+export interface ChannelOptions<S extends Source> {
+    name: string;
+    values: (source: S) => Float32Array;
+}
+/**
+ * Defines a channel that will extract data from a source for visualization.
+ */
+export declare function channel<S extends Source>({ name, values }: ChannelOptions<S>): Channel<S>;

package/dist/render/channel.js

@@ -0,0 +1,9 @@
+import { assert } from "../assert.js";
+/**
+ * Defines a channel that will extract data from a source for visualization.
+ */
+export function channel({ name, values }) {
+    assert(/^[A-Za-z][A-Za-z0-9]*$/.test(name), `channel name must be alphanumeric and start with a letter, but is "${name}"`);
+    return { name, values };
+}
+//# sourceMappingURL=channel.js.map

package/dist/render/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/render/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA0BrC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAmB,EAAE,IAAI,EAAE,MAAM,EAAqB;IAC3E,MAAM,CACJ,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EACnC,sEAAsE,IAAI,GAAG,CAC9E,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["import { assert } from \"@/assert.js\";\nimport type { Source } from \"@/render/sources.js\";\n\n/**\n * A component extracting data for visualization from a source.\n */\nexport interface Channel<S extends Source> {\n  /**\n   * A human-readable label for data provided by this channel.\n   */\n  readonly name: string;\n\n  /**\n   * The value of whatever this channel represents for each element in source.\n   */\n  values(source: S): Float32Array;\n}\n\n/**\n * Options for {@link channel}.\n */\nexport interface ChannelOptions<S extends Source> {\n  name: string;\n  values: (source: S) => Float32Array;\n}\n\n/**\n * Defines a channel that will extract data from a source for visualization.\n */\nexport function channel<S extends Source>({ name, values }: ChannelOptions<S>): Channel<S> {\n  assert(\n    /^[A-Za-z][A-Za-z0-9]*$/.test(name),\n    `channel name must be alphanumeric and start with a letter, but is \"${name}\"`,\n  );\n  return { name, values };\n}\n"]}

package/dist/render/color.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A color at the API surface, written as an sRGB hex string: `#RGB`, `#RGBA`,
+ * `#RRGGBB`, or `#RRGGBBAA`.
+ */
+export type Color = string;
+/**
+ * A parsed color with sRGB channels and alpha, each in the range `0..1`.
+ */
+export interface Rgba {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    readonly a: number;
+}
+export declare namespace color {
+    /**
+     * Parses an sRGB hex color into channels in `0..1`.
+     */
+    function parse(value: Color): Rgba;
+    /**
+     * Formats sRGB channels back into a hex string. The alpha channel is
+     * only emitted when it is not fully opaque.
+     */
+    function format(rgba: Rgba): Color;
+    /**
+     * Linearly interpolates between two parsed colors in sRGB space by fraction
+     * `t`, clamped to `0..1`. `t = 0` returns `from`, `t = 1` returns `to`.
+     */
+    function mix({ from, to, t }: {
+        from: Rgba;
+        to: Rgba;
+        t: number;
+    }): Rgba;
+}

package/dist/render/color.js

@@ -0,0 +1,56 @@
+import { assert } from "../assert.js";
+function expand(hex) {
+    if (hex.length === 3 || hex.length === 4) {
+        return [...hex].map((digit) => digit + digit).join("");
+    }
+    return hex;
+}
+function channel(hex, offset) {
+    const pair = hex.slice(offset, offset + 2);
+    const value = Number.parseInt(pair, 16);
+    assert(Number.isInteger(value), `color "#${hex}" has an invalid channel "${pair}"`);
+    return value / 255;
+}
+function byte(value) {
+    const clamped = Math.max(0, Math.min(255, Math.round(value * 255)));
+    return clamped.toString(16).padStart(2, "0");
+}
+export var color;
+(function (color) {
+    /**
+     * Parses an sRGB hex color into channels in `0..1`.
+     */
+    function parse(value) {
+        assert(value.startsWith("#"), `color "${value}" must start with "#"`);
+        const body = expand(value.slice(1));
+        assert(body.length === 6 || body.length === 8, `color "${value}" must have 3, 4, 6, or 8 hex digits, but has ${body.length}`);
+        assert(/^[0-9a-fA-F]+$/.test(body), `color "${value}" has a non-hexadecimal digit`);
+        return {
+            r: channel(body, 0),
+            g: channel(body, 2),
+            b: channel(body, 4),
+            a: body.length === 8 ? channel(body, 6) : 1,
+        };
+    }
+    color.parse = parse;
+    /**
+     * Formats sRGB channels back into a hex string. The alpha channel is
+     * only emitted when it is not fully opaque.
+     */
+    function format(rgba) {
+        const base = `#${byte(rgba.r)}${byte(rgba.g)}${byte(rgba.b)}`;
+        return rgba.a >= 1 ? base : `${base}${byte(rgba.a)}`;
+    }
+    color.format = format;
+    /**
+     * Linearly interpolates between two parsed colors in sRGB space by fraction
+     * `t`, clamped to `0..1`. `t = 0` returns `from`, `t = 1` returns `to`.
+     */
+    function mix({ from, to, t }) {
+        const amount = Math.max(0, Math.min(1, t));
+        const lerp = (a, b) => a + (b - a) * amount;
+        return { r: lerp(from.r, to.r), g: lerp(from.g, to.g), b: lerp(from.b, to.b), a: lerp(from.a, to.a) };
+    }
+    color.mix = mix;
+})(color || (color = {}));
+//# sourceMappingURL=color.js.map

package/dist/render/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/render/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAkBrC,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,GAAW,EAAE,MAAc;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,6BAA6B,IAAI,GAAG,CAAC,CAAC;IACpF,OAAO,KAAK,GAAG,GAAG,CAAC;AACrB,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,KAAW,KAAK,CAuCrB;AAvCD,WAAiB,KAAK;IACpB;;OAEG;IACH,SAAgB,KAAK,CAAC,KAAY;QAChC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,KAAK,uBAAuB,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CACJ,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EACtC,UAAU,KAAK,iDAAiD,IAAI,CAAC,MAAM,EAAE,CAC9E,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,KAAK,+BAA+B,CAAC,CAAC;QAEpF,OAAO;YACL,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnB,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnB,CAAC,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5C,CAAC;IACJ,CAAC;IAfe,WAAK,QAepB,CAAA;IAED;;;OAGG;IACH,SAAgB,MAAM,CAAC,IAAU;QAC/B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IAHe,YAAM,SAGrB,CAAA;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAuC;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;QACpE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,CAAC;IAJe,SAAG,MAIlB,CAAA;AACH,CAAC,EAvCgB,KAAK,KAAL,KAAK,QAuCrB","sourcesContent":["import { assert } from \"@/assert.js\";\n\n/**\n * A color at the API surface, written as an sRGB hex string: `#RGB`, `#RGBA`,\n * `#RRGGBB`, or `#RRGGBBAA`.\n */\nexport type Color = string;\n\n/**\n * A parsed color with sRGB channels and alpha, each in the range `0..1`.\n */\nexport interface Rgba {\n  readonly r: number;\n  readonly g: number;\n  readonly b: number;\n  readonly a: number;\n}\n\nfunction expand(hex: string): string {\n  if (hex.length === 3 || hex.length === 4) {\n    return [...hex].map((digit) => digit + digit).join(\"\");\n  }\n  return hex;\n}\n\nfunction channel(hex: string, offset: number): number {\n  const pair = hex.slice(offset, offset + 2);\n  const value = Number.parseInt(pair, 16);\n  assert(Number.isInteger(value), `color \"#${hex}\" has an invalid channel \"${pair}\"`);\n  return value / 255;\n}\n\nfunction byte(value: number): string {\n  const clamped = Math.max(0, Math.min(255, Math.round(value * 255)));\n  return clamped.toString(16).padStart(2, \"0\");\n}\n\nexport namespace color {\n  /**\n   * Parses an sRGB hex color into channels in `0..1`.\n   */\n  export function parse(value: Color): Rgba {\n    assert(value.startsWith(\"#\"), `color \"${value}\" must start with \"#\"`);\n    const body = expand(value.slice(1));\n    assert(\n      body.length === 6 || body.length === 8,\n      `color \"${value}\" must have 3, 4, 6, or 8 hex digits, but has ${body.length}`,\n    );\n    assert(/^[0-9a-fA-F]+$/.test(body), `color \"${value}\" has a non-hexadecimal digit`);\n\n    return {\n      r: channel(body, 0),\n      g: channel(body, 2),\n      b: channel(body, 4),\n      a: body.length === 8 ? channel(body, 6) : 1,\n    };\n  }\n\n  /**\n   * Formats sRGB channels back into a hex string. The alpha channel is\n   * only emitted when it is not fully opaque.\n   */\n  export function format(rgba: Rgba): Color {\n    const base = `#${byte(rgba.r)}${byte(rgba.g)}${byte(rgba.b)}`;\n    return rgba.a >= 1 ? base : `${base}${byte(rgba.a)}`;\n  }\n\n  /**\n   * Linearly interpolates between two parsed colors in sRGB space by fraction\n   * `t`, clamped to `0..1`. `t = 0` returns `from`, `t = 1` returns `to`.\n   */\n  export function mix({ from, to, t }: { from: Rgba; to: Rgba; t: number }): Rgba {\n    const amount = Math.max(0, Math.min(1, t));\n    const lerp = (a: number, b: number): number => a + (b - a) * amount;\n    return { r: lerp(from.r, to.r), g: lerp(from.g, to.g), b: lerp(from.b, to.b), a: lerp(from.a, to.a) };\n  }\n}\n"]}

package/dist/render/effect.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A bloom effect that makes pixels brighter than `threshold` flare.
+ */
+export interface BloomEffect {
+    readonly type: "bloom";
+    /**
+     * The luminance, `0..1`, a pixel must exceed before it blooms.
+     */
+    readonly threshold: number;
+    /**
+     * The gain bloomed pixels are added back with. Non-negative, unbounded
+     * above.
+     */
+    readonly intensity: number;
+    /**
+     * The bloom spread, as a fraction of the viewport's smaller side.
+     */
+    readonly radius: number;
+}
+/**
+ * A vignette pass darkening the frame edges.
+ */
+export interface VignetteEffect {
+    readonly type: "vignette";
+    /**
+     * How dark the corners become, `0..1`.
+     */
+    readonly intensity: number;
+    /**
+     * How gradually the vignette falls off, `0..1`.
+     */
+    readonly smoothness: number;
+}
+/**
+ * Any post-processing effect a stage accepts, applied in array order.
+ */
+export type Effect = BloomEffect | VignetteEffect;
+/**
+ * Options for {@link effect.bloom}.
+ */
+export interface BloomOptions {
+    /**
+     * The luminance, `0..1`, a pixel must exceed before it blooms.
+     */
+    readonly threshold?: number;
+    /**
+     * The gain bloomed pixels are added back with. Non-negative, unbounded
+     * above.
+     */
+    readonly intensity?: number;
+    /**
+     * The bloom spread, as a fraction of the viewport's smaller side.
+     */
+    readonly radius?: number;
+}
+/**
+ * Options for {@link effect.vignette}.
+ */
+export interface VignetteOptions {
+    /**
+     * How dark the corners become, `0..1`.
+     */
+    readonly intensity?: number;
+    /**
+     * How gradually the vignette falls off, `0..1`.
+     */
+    readonly smoothness?: number;
+}
+/**
+ * The effect factories exposed on `view.effect`.
+ */
+export declare namespace effect {
+    /**
+     * A thresholded bloom pass.
+     */
+    function bloom({ threshold, intensity, radius }?: BloomOptions): BloomEffect;
+    /**
+     * A vignette pass.
+     */
+    function vignette({ intensity, smoothness }?: VignetteOptions): VignetteEffect;
+}

package/dist/render/effect.js

@@ -0,0 +1,30 @@
+import { assert } from "../assert.js";
+function verifyIsUnit(value, name) {
+    assert(value >= 0 && value <= 1, `${name} must be within 0..1, but is ${value}`);
+}
+/**
+ * The effect factories exposed on `view.effect`.
+ */
+export var effect;
+(function (effect) {
+    /**
+     * A thresholded bloom pass.
+     */
+    function bloom({ threshold = 0.85, intensity = 0.65, radius = 0.12 } = {}) {
+        verifyIsUnit(threshold, "bloom threshold");
+        assert(Number.isFinite(intensity) && intensity >= 0, `bloom intensity must be non-negative and finite, but is ${intensity}`);
+        assert(radius >= 0, `bloom radius must be non-negative, but is ${radius}`);
+        return { type: "bloom", threshold, intensity, radius };
+    }
+    effect.bloom = bloom;
+    /**
+     * A vignette pass.
+     */
+    function vignette({ intensity = 0.45, smoothness = 0.85 } = {}) {
+        verifyIsUnit(intensity, "vignette intensity");
+        verifyIsUnit(smoothness, "vignette smoothness");
+        return { type: "vignette", intensity, smoothness };
+    }
+    effect.vignette = vignette;
+})(effect || (effect = {}));
+//# sourceMappingURL=effect.js.map

package/dist/render/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../../src/render/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmFrC,SAAS,YAAY,CAAC,KAAa,EAAE,IAAY;IAC/C,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,GAAG,IAAI,gCAAgC,KAAK,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,KAAW,MAAM,CAsBtB;AAtBD,WAAiB,MAAM;IACrB;;OAEG;IACH,SAAgB,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,KAAmB,EAAE;QAC5F,YAAY,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAC3C,MAAM,CACJ,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAC5C,2DAA2D,SAAS,EAAE,CACvE,CAAC;QACF,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,6CAA6C,MAAM,EAAE,CAAC,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IARe,YAAK,QAQpB,CAAA;IAED;;OAEG;IACH,SAAgB,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,UAAU,GAAG,IAAI,KAAsB,EAAE;QACpF,YAAY,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC9C,YAAY,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACrD,CAAC;IAJe,eAAQ,WAIvB,CAAA;AACH,CAAC,EAtBgB,MAAM,KAAN,MAAM,QAsBtB","sourcesContent":["import { assert } from \"@/assert.js\";\n\n/**\n * A bloom effect that makes pixels brighter than `threshold` flare.\n */\nexport interface BloomEffect {\n  readonly type: \"bloom\";\n\n  /**\n   * The luminance, `0..1`, a pixel must exceed before it blooms.\n   */\n  readonly threshold: number;\n\n  /**\n   * The gain bloomed pixels are added back with. Non-negative, unbounded\n   * above.\n   */\n  readonly intensity: number;\n\n  /**\n   * The bloom spread, as a fraction of the viewport's smaller side.\n   */\n  readonly radius: number;\n}\n\n/**\n * A vignette pass darkening the frame edges.\n */\nexport interface VignetteEffect {\n  readonly type: \"vignette\";\n\n  /**\n   * How dark the corners become, `0..1`.\n   */\n  readonly intensity: number;\n\n  /**\n   * How gradually the vignette falls off, `0..1`.\n   */\n  readonly smoothness: number;\n}\n\n/**\n * Any post-processing effect a stage accepts, applied in array order.\n */\nexport type Effect = BloomEffect | VignetteEffect;\n\n/**\n * Options for {@link effect.bloom}.\n */\nexport interface BloomOptions {\n  /**\n   * The luminance, `0..1`, a pixel must exceed before it blooms.\n   */\n  readonly threshold?: number;\n\n  /**\n   * The gain bloomed pixels are added back with. Non-negative, unbounded\n   * above.\n   */\n  readonly intensity?: number;\n\n  /**\n   * The bloom spread, as a fraction of the viewport's smaller side.\n   */\n  readonly radius?: number;\n}\n\n/**\n * Options for {@link effect.vignette}.\n */\nexport interface VignetteOptions {\n  /**\n   * How dark the corners become, `0..1`.\n   */\n  readonly intensity?: number;\n\n  /**\n   * How gradually the vignette falls off, `0..1`.\n   */\n  readonly smoothness?: number;\n}\n\nfunction verifyIsUnit(value: number, name: string): void {\n  assert(value >= 0 && value <= 1, `${name} must be within 0..1, but is ${value}`);\n}\n\n/**\n * The effect factories exposed on `view.effect`.\n */\nexport namespace effect {\n  /**\n   * A thresholded bloom pass.\n   */\n  export function bloom({ threshold = 0.85, intensity = 0.65, radius = 0.12 }: BloomOptions = {}): BloomEffect {\n    verifyIsUnit(threshold, \"bloom threshold\");\n    assert(\n      Number.isFinite(intensity) && intensity >= 0,\n      `bloom intensity must be non-negative and finite, but is ${intensity}`,\n    );\n    assert(radius >= 0, `bloom radius must be non-negative, but is ${radius}`);\n    return { type: \"bloom\", threshold, intensity, radius };\n  }\n\n  /**\n   * A vignette pass.\n   */\n  export function vignette({ intensity = 0.45, smoothness = 0.85 }: VignetteOptions = {}): VignetteEffect {\n    verifyIsUnit(intensity, \"vignette intensity\");\n    verifyIsUnit(smoothness, \"vignette smoothness\");\n    return { type: \"vignette\", intensity, smoothness };\n  }\n}\n"]}

package/dist/render/frame.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A view over a position buffer.
+ */
+export interface PackedPositions {
+    /**
+     * The number of particles the buffer holds.
+     */
+    readonly count: number;
+    /**
+     * The x coordinate of a particle at the specified index.
+     */
+    x(particle: number): number;
+    /**
+     * The y coordinate of a particle at the specified index.
+     */
+    y(particle: number): number;
+    /**
+     * The z coordinate of a particle at the specified index.
+     */
+    z(particle: number): number;
+    /**
+     * A particle's coordinates as a tuple.
+     */
+    at(particle: number): readonly [number, number, number];
+    /**
+     * Updates a particle's coordinates from an `[x, y, z]` tuple.
+     */
+    set(particle: number, position: readonly [number, number, number]): void;
+}
+export declare namespace PackedPositions {
+    /**
+     * Wraps a packed position buffer so it can be read and written by particle.
+     */
+    function of(buffer: Float32Array): PackedPositions;
+    /**
+     * Allocates a packed position buffer sized to hold `count` particles.
+     */
+    function allocate(count: number): Float32Array<ArrayBuffer>;
+}
+/**
+ * A snapshot of the simulation state at a given point in time.
+ */
+export interface Frame {
+    /**
+     * The simulated time of this frame, in seconds.
+     */
+    readonly time: number;
+    /**
+     * Particle positions as a packed `x, y, z` buffer.
+     */
+    readonly positions: Float32Array;
+    /**
+     * Per-particle speed (velocity magnitude).
+     */
+    readonly speeds: Float32Array;
+    /**
+     * The number of particles in the swarm.
+     */
+    readonly particleCount: number;
+}

package/dist/render/frame.js

@@ -0,0 +1,52 @@
+import { assert } from "../assert.js";
+const STRIDE = 3;
+class PackedView {
+    buffer;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    get count() {
+        return this.buffer.length / STRIDE;
+    }
+    x(particle) {
+        return this.read(particle, 0);
+    }
+    y(particle) {
+        return this.read(particle, 1);
+    }
+    z(particle) {
+        return this.read(particle, 2);
+    }
+    at(particle) {
+        return [this.x(particle), this.y(particle), this.z(particle)];
+    }
+    set(particle, position) {
+        const base = particle * STRIDE;
+        this.buffer[base] = position[0];
+        this.buffer[base + 1] = position[1];
+        this.buffer[base + 2] = position[2];
+    }
+    read(particle, axis) {
+        const value = this.buffer[particle * STRIDE + axis];
+        assert(value !== undefined, `particle ${particle} is out of range in a position buffer of ${this.buffer.length} floats`);
+        return value;
+    }
+}
+export var PackedPositions;
+(function (PackedPositions) {
+    /**
+     * Wraps a packed position buffer so it can be read and written by particle.
+     */
+    function of(buffer) {
+        return new PackedView(buffer);
+    }
+    PackedPositions.of = of;
+    /**
+     * Allocates a packed position buffer sized to hold `count` particles.
+     */
+    function allocate(count) {
+        return new Float32Array(count * STRIDE);
+    }
+    PackedPositions.allocate = allocate;
+})(PackedPositions || (PackedPositions = {}));
+//# sourceMappingURL=frame.js.map