gloop-sim 0.0.0-stage → 1.0.0

package/dist/render/springs/links.d.ts

@@ -0,0 +1,70 @@
+import { type Layer } from "../../render/layer.js";
+import { type ColorInput, type ColorValue, type ScalarInput, type ScalarValue } from "../../render/ramp.js";
+import type { LinkGroup } from "../../render/springs/link.js";
+import type { Springs } from "../../render/springs/source.js";
+/**
+ * Render-only fracture: strained links visually split and later re-form,
+ * without touching the simulation.
+ */
+export interface FractureOptions {
+    /**
+     * The strain, as a fraction of rest length, at which a link visually breaks.
+     */
+    readonly threshold: number;
+    /**
+     * How long, in seconds, a fractured link stays broken before re-forming.
+     */
+    readonly recovery: number;
+}
+/**
+ * A layer of links drawn between particle pairs, styled by constant or
+ * signal-driven properties.
+ */
+export interface LinksLayer extends Layer<Springs> {
+    /**
+     * Restricts the layer to links tagged with this group. When omitted, every
+     * link is drawn.
+     */
+    readonly group?: LinkGroup;
+    /**
+     * The base color of each link band.
+     */
+    readonly color: ColorValue<Springs>;
+    /**
+     * The link width in the layer's own width-units; always positive. World
+     * thickness scales from it.
+     */
+    readonly width: ScalarValue<Springs>;
+    /**
+     * The link opacity, within 0..1.
+     */
+    readonly opacity: ScalarValue<Springs>;
+    /**
+     * A narrow emissive highlight, `0..1`, added on top of the link color.
+     * Omitted means no emission.
+     */
+    readonly emissive?: ScalarValue<Springs>;
+    /**
+     * Chromatic separation: how far, in link-width units, faint red and blue
+     * copies of the link are offset to either side of it. Omitted means the link
+     * is drawn once, with no separation.
+     */
+    readonly chromatic?: ScalarValue<Springs>;
+    /**
+     * Enables render-only fracture on the layer. Disabled when omitted.
+     */
+    readonly fracture?: FractureOptions;
+}
+/**
+ * A links layer over the springs.
+ */
+export declare function links({ from, group, color, width, opacity, emissive, chromatic, fracture, }: {
+    from: Springs;
+    group?: LinkGroup;
+    color: ColorInput<Springs>;
+    width?: ScalarInput<Springs>;
+    opacity?: ScalarInput<Springs>;
+    emissive?: ScalarInput<Springs>;
+    chromatic?: ScalarInput<Springs>;
+    fracture?: FractureOptions;
+}): LinksLayer;

package/dist/render/springs/links.js

@@ -0,0 +1,210 @@
+import { vec3 } from "three/tsl";
+import { Group } from "three/webgpu";
+import { assert } from "../../assert.js";
+import { attributeNameOf, channelAttribute, channelsOf } from "../../render/backend/channels.js";
+import { compileColor, compileScalar } from "../../render/backend/compile.js";
+import { material as materialFactory } from "../../render/backend/material.js";
+import { PackedPositions } from "../../render/frame.js";
+import { constant, verifyIsNonNegative, verifyIsPositive, verifyIsUnit, } from "../../render/layer.js";
+import { colorValue, scalarValue, } from "../../render/ramp.js";
+import { segmentAttribute, segmentGeometry, segmentMesh, VERTICES_PER_SEGMENT, writeSegment, } from "../../render/springs/segment.js";
+// World-space thickness, in scene units, of a link one width-unit wide. Link
+// widths are otherwise unitless, so this sets their overall scale.
+const LINK_WIDTH_WORLD = 0.011;
+// How strongly the emissive term brightens a link's color under strain.
+const EMISSIVE_GAIN = 3;
+// How much fainter a chromatic fringe is than the link it separates from.
+const FRINGE_OPACITY = 0.4;
+/**
+ * A links layer over the springs.
+ */
+export function links({ from, group, color, width = 1, opacity = 1, emissive, chromatic, fracture, }) {
+    verifyIsPositive(constant(width), "links width");
+    verifyIsUnit(constant(opacity), "links opacity");
+    verifyIsUnit(constant(emissive), "links emissive");
+    verifyIsNonNegative(constant(chromatic), "links chromatic");
+    if (fracture !== undefined) {
+        assert(fracture.threshold >= 0 && fracture.threshold <= 1, `fracture threshold must be within 0..1`);
+        assert(fracture.recovery > 0, `fracture recovery must be positive, but is ${fracture.recovery}`);
+    }
+    const spec = {
+        source: from,
+        group,
+        color: colorValue(color),
+        width: scalarValue(width),
+        opacity: scalarValue(opacity),
+        emissive: emissive === undefined ? undefined : scalarValue(emissive),
+        chromatic: chromatic === undefined ? undefined : scalarValue(chromatic),
+        fracture,
+        build: () => buildLinks(spec),
+    };
+    return spec;
+}
+function selectLinks(layer) {
+    const selected = [];
+    for (const [index, link] of layer.source.links.entries()) {
+        if (layer.group === undefined || link.group === layer.group) {
+            selected.push(index);
+        }
+    }
+    return selected;
+}
+function createBand({ count, side, color, opacity, additive, channels, }) {
+    const { geometry, positions } = segmentGeometry(count);
+    const channelAttributes = addChannelAttributes({ geometry, channels, count });
+    const material = materialFactory.flat({ color, opacity, additive });
+    const mesh = segmentMesh(geometry, material);
+    return {
+        side,
+        mesh,
+        positionArray: positions.array,
+        channelArrays: channelAttributes.map((values) => values.array),
+        flush() {
+            positions.needsUpdate = true;
+            for (const values of channelAttributes) {
+                values.needsUpdate = true;
+            }
+        },
+        dispose() {
+            geometry.dispose();
+            material.dispose();
+        },
+    };
+}
+function addChannelAttributes({ geometry, channels, count, }) {
+    return channels.map((channel) => {
+        const values = segmentAttribute(count, 1);
+        geometry.setAttribute(attributeNameOf(channel), values);
+        return values;
+    });
+}
+/**
+ * Builds a links layer as a screen-facing thick-line mesh, its endpoints and
+ * channel attributes rewritten each frame. Width is baked into the geometry on
+ * the CPU, since WebGPU cannot draw wide lines directly. Chromatic separation
+ * adds two additive copies, one red and one blue, offset to either side.
+ */
+function buildLinks(layer) {
+    const indices = selectLinks(layer);
+    const count = indices.length;
+    const channels = channelsOf([layer.color, layer.opacity, layer.emissive]);
+    const bands = createBands({
+        count,
+        channels,
+        color: linkColor(layer),
+        opacity: compileScalar(layer.opacity, channelAttribute),
+        chromatic: layer.chromatic !== undefined,
+    });
+    const group = new Group().add(...bands.map((band) => band.mesh));
+    const fractureUntil = new Float32Array(count);
+    const channelValues = new Float32Array(channels.length);
+    return {
+        object: group,
+        update(frame) {
+            const samples = sampleFrame({ layer, channels, frame });
+            for (const [slot, linkIndex] of indices.entries()) {
+                writeLink({ layer, bands, samples, slot, linkIndex, fractureUntil, channelValues });
+            }
+            for (const band of bands) {
+                band.flush();
+            }
+        },
+        dispose() {
+            for (const band of bands) {
+                group.remove(band.mesh);
+                band.dispose();
+            }
+        },
+    };
+}
+function sampleFrame({ layer, channels, frame, }) {
+    return {
+        channelArrays: channels.map((channel) => channel.values(layer.source)),
+        widthAt: layer.width.prepare(layer.source),
+        chromaticAt: layer.chromatic?.prepare(layer.source),
+        strains: layer.fracture === undefined ? undefined : layer.source.strains(),
+        points: PackedPositions.of(frame.positions),
+        time: frame.time,
+    };
+}
+function writeLink({ layer, bands, samples, slot, linkIndex, fractureUntil, channelValues, }) {
+    const link = layer.source.links[linkIndex];
+    assert(link !== undefined, `link ${linkIndex} is missing`);
+    gatherChannelValues({ arrays: samples.channelArrays, linkIndex, target: channelValues });
+    const halfWidth = linkHalfWidth({
+        width: samples.widthAt(linkIndex),
+        fracture: layer.fracture,
+        strains: samples.strains,
+        linkIndex,
+        slot,
+        time: samples.time,
+        fractureUntil,
+    });
+    const separation = samples.chromaticAt === undefined ? 0 : samples.chromaticAt(linkIndex) * LINK_WIDTH_WORLD;
+    for (const band of bands) {
+        writeBandSegment({ band, slot, link, points: samples.points, halfWidth, separation, channelValues });
+    }
+}
+function linkColor(layer) {
+    const base = compileColor(layer.color, channelAttribute);
+    if (layer.emissive === undefined) {
+        return base;
+    }
+    const emissive = compileScalar(layer.emissive, channelAttribute);
+    return base.add(base.mul(emissive.mul(EMISSIVE_GAIN)));
+}
+function createBands({ count, channels, color, opacity, chromatic, }) {
+    const base = createBand({ count, side: 0, color, opacity, additive: false, channels });
+    if (!chromatic) {
+        return [base];
+    }
+    const fringeOpacity = opacity.mul(FRINGE_OPACITY);
+    const red = color.mul(vec3(1, 0, 0));
+    const blue = color.mul(vec3(0, 0, 1));
+    return [
+        createBand({ count, side: -1, color: red, opacity: fringeOpacity, additive: true, channels }),
+        createBand({ count, side: 1, color: blue, opacity: fringeOpacity, additive: true, channels }),
+        base,
+    ];
+}
+function gatherChannelValues({ arrays, linkIndex, target, }) {
+    for (const [position, array] of arrays.entries()) {
+        const value = array[linkIndex];
+        assert(value !== undefined, `channel ${position} has no value for link ${linkIndex}`);
+        target[position] = value;
+    }
+}
+function writeBandSegment({ band, slot, link, points, halfWidth, separation, channelValues, }) {
+    writeSegment({
+        target: band.positionArray,
+        segment: slot,
+        a: points.at(link.between[0]),
+        b: points.at(link.between[1]),
+        halfWidth,
+        shift: band.side * separation,
+    });
+    for (const [position, array] of band.channelArrays.entries()) {
+        const value = channelValues[position];
+        assert(value !== undefined, `channel ${position} has no value`);
+        array.fill(value, slot * VERTICES_PER_SEGMENT, (slot + 1) * VERTICES_PER_SEGMENT);
+    }
+}
+function linkHalfWidth({ width, fracture, strains, linkIndex, slot, time, fractureUntil, }) {
+    const halfWidth = (width * LINK_WIDTH_WORLD) / 2;
+    if (fracture === undefined || strains === undefined) {
+        return halfWidth;
+    }
+    const strain = strains[linkIndex];
+    assert(strain !== undefined, `link ${linkIndex} has no strain sample`);
+    return fracturedHalfWidth({ fracture, strain, slot, time, fractureUntil, halfWidth });
+}
+function fracturedHalfWidth({ fracture, strain, slot, time, fractureUntil, halfWidth, }) {
+    const brokenUntil = fractureUntil[slot];
+    assert(brokenUntil !== undefined, `link slot ${slot} has no fracture timer`);
+    if (time >= brokenUntil && strain > fracture.threshold) {
+        fractureUntil[slot] = time + fracture.recovery;
+        return 0;
+    }
+    return time < brokenUntil ? 0 : halfWidth;
+}
+//# sourceMappingURL=links.js.map

package/dist/render/springs/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/render/springs/links.ts"],"names":[],"mappings":"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","sourcesContent":["import { vec3 } from \"three/tsl\";\nimport { type BufferAttribute, type BufferGeometry, Group, type Mesh } from \"three/webgpu\";\nimport { assert } from \"@/assert.js\";\nimport { attributeNameOf, channelAttribute, channelsOf } from \"@/render/backend/channels.js\";\nimport { type ColorNode, compileColor, compileScalar, type ScalarNode } from \"@/render/backend/compile.js\";\nimport { material as materialFactory } from \"@/render/backend/material.js\";\nimport type { Channel } from \"@/render/channel.js\";\nimport { type Frame, PackedPositions } from \"@/render/frame.js\";\nimport {\n  constant,\n  type Layer,\n  type LayerObject,\n  verifyIsNonNegative,\n  verifyIsPositive,\n  verifyIsUnit,\n} from \"@/render/layer.js\";\nimport {\n  type ColorInput,\n  type ColorValue,\n  colorValue,\n  type ScalarInput,\n  type ScalarValue,\n  scalarValue,\n} from \"@/render/ramp.js\";\nimport type { Link, LinkGroup } from \"@/render/springs/link.js\";\nimport {\n  segmentAttribute,\n  segmentGeometry,\n  segmentMesh,\n  VERTICES_PER_SEGMENT,\n  writeSegment,\n} from \"@/render/springs/segment.js\";\nimport type { Springs } from \"@/render/springs/source.js\";\n\n// World-space thickness, in scene units, of a link one width-unit wide. Link\n// widths are otherwise unitless, so this sets their overall scale.\nconst LINK_WIDTH_WORLD = 0.011;\n\n// How strongly the emissive term brightens a link's color under strain.\nconst EMISSIVE_GAIN = 3;\n\n// How much fainter a chromatic fringe is than the link it separates from.\nconst FRINGE_OPACITY = 0.4;\n\n/**\n * Render-only fracture: strained links visually split and later re-form,\n * without touching the simulation.\n */\nexport interface FractureOptions {\n  /**\n   * The strain, as a fraction of rest length, at which a link visually breaks.\n   */\n  readonly threshold: number;\n\n  /**\n   * How long, in seconds, a fractured link stays broken before re-forming.\n   */\n  readonly recovery: number;\n}\n\n/**\n * A layer of links drawn between particle pairs, styled by constant or\n * signal-driven properties.\n */\nexport interface LinksLayer extends Layer<Springs> {\n  /**\n   * Restricts the layer to links tagged with this group. When omitted, every\n   * link is drawn.\n   */\n  readonly group?: LinkGroup;\n\n  /**\n   * The base color of each link band.\n   */\n  readonly color: ColorValue<Springs>;\n\n  /**\n   * The link width in the layer's own width-units; always positive. World\n   * thickness scales from it.\n   */\n  readonly width: ScalarValue<Springs>;\n\n  /**\n   * The link opacity, within 0..1.\n   */\n  readonly opacity: ScalarValue<Springs>;\n\n  /**\n   * A narrow emissive highlight, `0..1`, added on top of the link color.\n   * Omitted means no emission.\n   */\n  readonly emissive?: ScalarValue<Springs>;\n\n  /**\n   * Chromatic separation: how far, in link-width units, faint red and blue\n   * copies of the link are offset to either side of it. Omitted means the link\n   * is drawn once, with no separation.\n   */\n  readonly chromatic?: ScalarValue<Springs>;\n\n  /**\n   * Enables render-only fracture on the layer. Disabled when omitted.\n   */\n  readonly fracture?: FractureOptions;\n}\n\n/**\n * A links layer over the springs.\n */\nexport function links({\n  from,\n  group,\n  color,\n  width = 1,\n  opacity = 1,\n  emissive,\n  chromatic,\n  fracture,\n}: {\n  from: Springs;\n  group?: LinkGroup;\n  color: ColorInput<Springs>;\n  width?: ScalarInput<Springs>;\n  opacity?: ScalarInput<Springs>;\n  emissive?: ScalarInput<Springs>;\n  chromatic?: ScalarInput<Springs>;\n  fracture?: FractureOptions;\n}): LinksLayer {\n  verifyIsPositive(constant(width), \"links width\");\n  verifyIsUnit(constant(opacity), \"links opacity\");\n  verifyIsUnit(constant(emissive), \"links emissive\");\n  verifyIsNonNegative(constant(chromatic), \"links chromatic\");\n  if (fracture !== undefined) {\n    assert(fracture.threshold >= 0 && fracture.threshold <= 1, `fracture threshold must be within 0..1`);\n    assert(fracture.recovery > 0, `fracture recovery must be positive, but is ${fracture.recovery}`);\n  }\n  const spec: LinksLayer = {\n    source: from,\n    group,\n    color: colorValue(color),\n    width: scalarValue(width),\n    opacity: scalarValue(opacity),\n    emissive: emissive === undefined ? undefined : scalarValue(emissive),\n    chromatic: chromatic === undefined ? undefined : scalarValue(chromatic),\n    fracture,\n    build: () => buildLinks(spec),\n  };\n  return spec;\n}\n\nfunction selectLinks(layer: LinksLayer): number[] {\n  const selected: number[] = [];\n  for (const [index, link] of layer.source.links.entries()) {\n    if (layer.group === undefined || link.group === layer.group) {\n      selected.push(index);\n    }\n  }\n  return selected;\n}\n\n/**\n * One drawn copy of the link set: the base band sits on the link, and the two\n * chromatic fringes sit one separation to either side of it.\n */\ninterface Band {\n  readonly side: -1 | 0 | 1;\n  readonly mesh: Mesh;\n  readonly positionArray: Float32Array;\n  readonly channelArrays: readonly Float32Array[];\n  flush(): void;\n  dispose(): void;\n}\n\nfunction createBand({\n  count,\n  side,\n  color,\n  opacity,\n  additive,\n  channels,\n}: {\n  count: number;\n  side: -1 | 0 | 1;\n  color: ColorNode;\n  opacity: ScalarNode;\n  additive: boolean;\n  channels: readonly Channel<Springs>[];\n}): Band {\n  const { geometry, positions } = segmentGeometry(count);\n  const channelAttributes = addChannelAttributes({ geometry, channels, count });\n  const material = materialFactory.flat({ color, opacity, additive });\n  const mesh = segmentMesh(geometry, material);\n\n  return {\n    side,\n    mesh,\n    positionArray: positions.array as Float32Array,\n    channelArrays: channelAttributes.map((values) => values.array as Float32Array),\n    flush(): void {\n      positions.needsUpdate = true;\n      for (const values of channelAttributes) {\n        values.needsUpdate = true;\n      }\n    },\n    dispose(): void {\n      geometry.dispose();\n      material.dispose();\n    },\n  };\n}\n\nfunction addChannelAttributes({\n  geometry,\n  channels,\n  count,\n}: {\n  geometry: BufferGeometry;\n  channels: readonly Channel<Springs>[];\n  count: number;\n}): BufferAttribute[] {\n  return channels.map((channel) => {\n    const values = segmentAttribute(count, 1);\n    geometry.setAttribute(attributeNameOf(channel), values);\n    return values;\n  });\n}\n\n/**\n * Builds a links layer as a screen-facing thick-line mesh, its endpoints and\n * channel attributes rewritten each frame. Width is baked into the geometry on\n * the CPU, since WebGPU cannot draw wide lines directly. Chromatic separation\n * adds two additive copies, one red and one blue, offset to either side.\n */\nfunction buildLinks(layer: LinksLayer): LayerObject {\n  const indices = selectLinks(layer);\n  const count = indices.length;\n  const channels = channelsOf<Springs>([layer.color, layer.opacity, layer.emissive]);\n  const bands = createBands({\n    count,\n    channels,\n    color: linkColor(layer),\n    opacity: compileScalar(layer.opacity, channelAttribute),\n    chromatic: layer.chromatic !== undefined,\n  });\n\n  const group = new Group().add(...bands.map((band) => band.mesh));\n\n  const fractureUntil = new Float32Array(count);\n  const channelValues = new Float32Array(channels.length);\n\n  return {\n    object: group,\n    update(frame: Frame): void {\n      const samples = sampleFrame({ layer, channels, frame });\n      for (const [slot, linkIndex] of indices.entries()) {\n        writeLink({ layer, bands, samples, slot, linkIndex, fractureUntil, channelValues });\n      }\n      for (const band of bands) {\n        band.flush();\n      }\n    },\n    dispose(): void {\n      for (const band of bands) {\n        group.remove(band.mesh);\n        band.dispose();\n      }\n    },\n  };\n}\n\ninterface FrameSamples {\n  readonly channelArrays: readonly Float32Array[];\n  readonly widthAt: (link: number) => number;\n  readonly chromaticAt: ((link: number) => number) | undefined;\n  readonly strains: Float32Array | undefined;\n  readonly points: PackedPositions;\n  readonly time: number;\n}\n\nfunction sampleFrame({\n  layer,\n  channels,\n  frame,\n}: {\n  layer: LinksLayer;\n  channels: readonly Channel<Springs>[];\n  frame: Frame;\n}): FrameSamples {\n  return {\n    channelArrays: channels.map((channel) => channel.values(layer.source)),\n    widthAt: layer.width.prepare(layer.source),\n    chromaticAt: layer.chromatic?.prepare(layer.source),\n    strains: layer.fracture === undefined ? undefined : layer.source.strains(),\n    points: PackedPositions.of(frame.positions),\n    time: frame.time,\n  };\n}\n\nfunction writeLink({\n  layer,\n  bands,\n  samples,\n  slot,\n  linkIndex,\n  fractureUntil,\n  channelValues,\n}: {\n  layer: LinksLayer;\n  bands: readonly Band[];\n  samples: FrameSamples;\n  slot: number;\n  linkIndex: number;\n  fractureUntil: Float32Array;\n  channelValues: Float32Array;\n}): void {\n  const link = layer.source.links[linkIndex];\n  assert(link !== undefined, `link ${linkIndex} is missing`);\n\n  gatherChannelValues({ arrays: samples.channelArrays, linkIndex, target: channelValues });\n\n  const halfWidth = linkHalfWidth({\n    width: samples.widthAt(linkIndex),\n    fracture: layer.fracture,\n    strains: samples.strains,\n    linkIndex,\n    slot,\n    time: samples.time,\n    fractureUntil,\n  });\n  const separation = samples.chromaticAt === undefined ? 0 : samples.chromaticAt(linkIndex) * LINK_WIDTH_WORLD;\n\n  for (const band of bands) {\n    writeBandSegment({ band, slot, link, points: samples.points, halfWidth, separation, channelValues });\n  }\n}\n\nfunction linkColor(layer: LinksLayer): ColorNode {\n  const base = compileColor(layer.color, channelAttribute);\n  if (layer.emissive === undefined) {\n    return base;\n  }\n  const emissive = compileScalar(layer.emissive, channelAttribute);\n  return base.add(base.mul(emissive.mul(EMISSIVE_GAIN)));\n}\n\nfunction createBands({\n  count,\n  channels,\n  color,\n  opacity,\n  chromatic,\n}: {\n  count: number;\n  channels: readonly Channel<Springs>[];\n  color: ColorNode;\n  opacity: ScalarNode;\n  chromatic: boolean;\n}): Band[] {\n  const base = createBand({ count, side: 0, color, opacity, additive: false, channels });\n  if (!chromatic) {\n    return [base];\n  }\n  const fringeOpacity = opacity.mul(FRINGE_OPACITY);\n  const red = color.mul(vec3(1, 0, 0));\n  const blue = color.mul(vec3(0, 0, 1));\n  return [\n    createBand({ count, side: -1, color: red, opacity: fringeOpacity, additive: true, channels }),\n    createBand({ count, side: 1, color: blue, opacity: fringeOpacity, additive: true, channels }),\n    base,\n  ];\n}\n\nfunction gatherChannelValues({\n  arrays,\n  linkIndex,\n  target,\n}: {\n  arrays: readonly Float32Array[];\n  linkIndex: number;\n  target: Float32Array;\n}): void {\n  for (const [position, array] of arrays.entries()) {\n    const value = array[linkIndex];\n    assert(value !== undefined, `channel ${position} has no value for link ${linkIndex}`);\n    target[position] = value;\n  }\n}\n\nfunction writeBandSegment({\n  band,\n  slot,\n  link,\n  points,\n  halfWidth,\n  separation,\n  channelValues,\n}: {\n  band: Band;\n  slot: number;\n  link: Link;\n  points: PackedPositions;\n  halfWidth: number;\n  separation: number;\n  channelValues: Float32Array;\n}): void {\n  writeSegment({\n    target: band.positionArray,\n    segment: slot,\n    a: points.at(link.between[0]),\n    b: points.at(link.between[1]),\n    halfWidth,\n    shift: band.side * separation,\n  });\n  for (const [position, array] of band.channelArrays.entries()) {\n    const value = channelValues[position];\n    assert(value !== undefined, `channel ${position} has no value`);\n    array.fill(value, slot * VERTICES_PER_SEGMENT, (slot + 1) * VERTICES_PER_SEGMENT);\n  }\n}\n\nfunction linkHalfWidth({\n  width,\n  fracture,\n  strains,\n  linkIndex,\n  slot,\n  time,\n  fractureUntil,\n}: {\n  width: number;\n  fracture: FractureOptions | undefined;\n  strains: Float32Array | undefined;\n  linkIndex: number;\n  slot: number;\n  time: number;\n  fractureUntil: Float32Array;\n}): number {\n  const halfWidth = (width * LINK_WIDTH_WORLD) / 2;\n  if (fracture === undefined || strains === undefined) {\n    return halfWidth;\n  }\n  const strain = strains[linkIndex];\n  assert(strain !== undefined, `link ${linkIndex} has no strain sample`);\n  return fracturedHalfWidth({ fracture, strain, slot, time, fractureUntil, halfWidth });\n}\n\nfunction fracturedHalfWidth({\n  fracture,\n  strain,\n  slot,\n  time,\n  fractureUntil,\n  halfWidth,\n}: {\n  fracture: FractureOptions;\n  strain: number;\n  slot: number;\n  time: number;\n  fractureUntil: Float32Array;\n  halfWidth: number;\n}): number {\n  const brokenUntil = fractureUntil[slot];\n  assert(brokenUntil !== undefined, `link slot ${slot} has no fracture timer`);\n  if (time >= brokenUntil && strain > fracture.threshold) {\n    fractureUntil[slot] = time + fracture.recovery;\n    return 0;\n  }\n  return time < brokenUntil ? 0 : halfWidth;\n}\n"]}

package/dist/render/springs/palette.d.ts

@@ -0,0 +1,36 @@
+import type { Color } from "../../render/color.js";
+export interface Palette {
+    /**
+     * The background the scene is drawn against.
+     */
+    readonly void: Color;
+    /**
+     * The primary foreground color, for the brightest marks and text.
+     */
+    readonly text: Color;
+    /**
+     * The color of static structures and secondary text.
+     */
+    readonly structure: Color;
+    /**
+     * The color strained links and impulses shift toward.
+     */
+    readonly stress: Color;
+    /**
+     * The color a link passes through between rest and {@link Palette.stress}.
+     */
+    readonly charge: Color;
+    /**
+     * The color for resting links, borders, and construction geometry.
+     */
+    readonly dim: Color;
+}
+/**
+ * The palette factories exposed on `springs.palette`.
+ */
+export declare namespace palette {
+    /**
+     * The standard spring-network palette, with individual entries overridable.
+     */
+    function standard(overrides?: Partial<Palette>): Palette;
+}

package/dist/render/springs/palette.js

@@ -0,0 +1,22 @@
+const STANDARD = {
+    void: "#07090B",
+    text: "#F0F4F8",
+    structure: "#546E7A",
+    stress: "#B8D8D8",
+    charge: "#9D4EDD",
+    dim: "#263238",
+};
+/**
+ * The palette factories exposed on `springs.palette`.
+ */
+export var palette;
+(function (palette) {
+    /**
+     * The standard spring-network palette, with individual entries overridable.
+     */
+    function standard(overrides = {}) {
+        return { ...STANDARD, ...overrides };
+    }
+    palette.standard = standard;
+})(palette || (palette = {}));
+//# sourceMappingURL=palette.js.map

package/dist/render/springs/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../../src/render/springs/palette.ts"],"names":[],"mappings":"AAkCA,MAAM,QAAQ,GAAY;IACxB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,SAAS;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,KAAW,OAAO,CAOvB;AAPD,WAAiB,OAAO;IACtB;;OAEG;IACH,SAAgB,QAAQ,CAAC,YAA8B,EAAE;QACvD,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,EAAE,CAAC;IACvC,CAAC;IAFe,gBAAQ,WAEvB,CAAA;AACH,CAAC,EAPgB,OAAO,KAAP,OAAO,QAOvB","sourcesContent":["import type { Color } from \"@/render/color.js\";\n\nexport interface Palette {\n  /**\n   * The background the scene is drawn against.\n   */\n  readonly void: Color;\n\n  /**\n   * The primary foreground color, for the brightest marks and text.\n   */\n  readonly text: Color;\n\n  /**\n   * The color of static structures and secondary text.\n   */\n  readonly structure: Color;\n\n  /**\n   * The color strained links and impulses shift toward.\n   */\n  readonly stress: Color;\n\n  /**\n   * The color a link passes through between rest and {@link Palette.stress}.\n   */\n  readonly charge: Color;\n\n  /**\n   * The color for resting links, borders, and construction geometry.\n   */\n  readonly dim: Color;\n}\n\nconst STANDARD: Palette = {\n  void: \"#07090B\",\n  text: \"#F0F4F8\",\n  structure: \"#546E7A\",\n  stress: \"#B8D8D8\",\n  charge: \"#9D4EDD\",\n  dim: \"#263238\",\n};\n\n/**\n * The palette factories exposed on `springs.palette`.\n */\nexport namespace palette {\n  /**\n   * The standard spring-network palette, with individual entries overridable.\n   */\n  export function standard(overrides: Partial<Palette> = {}): Palette {\n    return { ...STANDARD, ...overrides };\n  }\n}\n"]}

package/dist/render/springs/preset.d.ts

@@ -0,0 +1,65 @@
+import { type Camera } from "../../render/camera.js";
+import { type Effect } from "../../render/effect.js";
+import { type Layer } from "../../render/layer.js";
+import { type Source } from "../../render/sources.js";
+import { type Palette } from "../../render/springs/palette.js";
+import { type Springs } from "../../render/springs/source.js";
+/**
+ * Whether the free links use render-only fracture (`"visual"`) or none
+ * (`false`).
+ */
+export type FractureMode = "visual" | false;
+/**
+ * Options for {@link preset.standard}.
+ */
+export interface PresetOptions {
+    /**
+     * The springs the links and impulses layers draw.
+     */
+    readonly from: Springs;
+    /**
+     * Overrides for individual palette entries.
+     */
+    readonly palette?: Partial<Palette>;
+    /**
+     * Overall strength of the preset, `0..1`. Scales the emissive response,
+     * bloom, and impulse frequency together.
+     */
+    readonly intensity?: number;
+    /**
+     * Whether to include the construction-geometry layer.
+     */
+    readonly construction?: boolean;
+    /**
+     * Whether to include the impulses layer.
+     */
+    readonly impulses?: boolean;
+    /**
+     * Render-only fracture behavior for the free links.
+     */
+    readonly fracture?: FractureMode;
+}
+export interface Preset {
+    /**
+     * The resolved palette, with any overrides applied.
+     */
+    readonly palette: Palette;
+    /**
+     * The layers to draw, in back-to-front order.
+     */
+    readonly layers: readonly Layer<Source>[];
+    /**
+     * The post-processing effects applied to the composed frame.
+     */
+    readonly effects: readonly Effect[];
+    /**
+     * The camera the scene is viewed through.
+     */
+    readonly camera: Camera;
+}
+export declare namespace preset {
+    /**
+     * The standard preset for creating a swarm with springs.
+     */
+    function standard({ from, palette: overrides, intensity, construction, impulses, fracture, }: PresetOptions): Preset;
+}

package/dist/render/springs/preset.js

@@ -0,0 +1,114 @@
+import { assert } from "../../assert.js";
+import { camera as cameraFactory } from "../../render/camera.js";
+import { effect as effectFactory } from "../../render/effect.js";
+import { layer as layerFactory } from "../../render/layer.js";
+import { ramp as rampFactory } from "../../render/ramp.js";
+import { sources } from "../../render/sources.js";
+import { anchors as anchorsFactory } from "../../render/springs/anchors.js";
+import { construction as constructionFactory } from "../../render/springs/construction.js";
+import { impulses as impulsesFactory } from "../../render/springs/impulses.js";
+import { links as linksFactory } from "../../render/springs/links.js";
+import { palette as paletteFactory } from "../../render/springs/palette.js";
+import { strain as strainSignal } from "../../render/springs/source.js";
+export var preset;
+(function (preset) {
+    /**
+     * The standard preset for creating a swarm with springs.
+     */
+    function standard({ from, palette: overrides, intensity = 0.8, construction = true, impulses = true, fracture = "visual", }) {
+        assert(intensity >= 0 && intensity <= 1, `preset intensity must be within 0..1, but is ${intensity}`);
+        const palette = paletteFactory.standard(overrides);
+        const particles = sources.particles();
+        const layers = [];
+        if (construction) {
+            layers.push(constructionLayer(particles, palette));
+        }
+        layers.push(pinnedLinksLayer(from, palette), freeLinksLayer({ from, palette, intensity, fracture }));
+        if (impulses) {
+            layers.push(impulsesLayer({ from, palette, intensity }));
+        }
+        layers.push(particlesLayer(particles, palette), anchorsLayer(from, palette));
+        return { palette, layers, effects: standardEffects(intensity), camera: cameraFactory.perspective() };
+    }
+    preset.standard = standard;
+})(preset || (preset = {}));
+function constructionLayer(particles, palette) {
+    return constructionFactory({ from: particles, color: palette.dim, opacity: 0.12, rings: 5 });
+}
+function pinnedLinksLayer(from, palette) {
+    return linksFactory({
+        from,
+        group: "pinned",
+        color: palette.structure,
+        width: 1.25,
+        opacity: 0.35,
+    });
+}
+function freeLinksLayer({ from, palette, intensity, fracture, }) {
+    const strain = strainSignal({ domain: [0, 0.4] });
+    return linksFactory({
+        from,
+        group: "free",
+        color: rampFactory.color({
+            by: strain,
+            stops: [
+                { at: 0, value: palette.dim },
+                { at: 0.7, value: palette.structure },
+                { at: 1, value: palette.stress },
+            ],
+        }),
+        width: rampFactory.scalar({
+            by: strain,
+            stops: [
+                { at: 0, value: 0.45 },
+                { at: 1, value: 2.1 },
+            ],
+        }),
+        opacity: rampFactory.scalar({
+            by: strain,
+            stops: [
+                { at: 0, value: 0.18 },
+                { at: 1, value: 0.9 },
+            ],
+        }),
+        emissive: rampFactory.scalar({
+            by: strain,
+            stops: [
+                { at: 0, value: 0 },
+                { at: 0.75, value: 0.05 * intensity },
+                { at: 1, value: intensity },
+            ],
+        }),
+        fracture: fracture === "visual" ? { threshold: 0.33, recovery: 0.6 } : undefined,
+    });
+}
+function impulsesLayer({ from, palette, intensity, }) {
+    return impulsesFactory({
+        from,
+        stress: 0.22,
+        color: palette.text,
+        tailColor: palette.stress,
+        frequency: 0.12 * intensity,
+        speed: 1.5,
+        length: 0.08,
+    });
+}
+function particlesLayer(particles, palette) {
+    return layerFactory.particles({
+        from: particles,
+        shape: "cross",
+        color: palette.structure,
+        size: 2,
+        opacity: 0.8,
+    });
+}
+function anchorsLayer(from, palette) {
+    return anchorsFactory({ from, shape: "gyroscope", color: palette.structure, size: 4.4, opacity: 0.8 });
+}
+function standardEffects(intensity) {
+    return [
+        effectFactory.bloom({ threshold: 0.85, intensity: 0.65 * intensity, radius: 0.12 }),
+        effectFactory.vignette({ intensity: 0.45, smoothness: 0.85 }),
+    ];
+}
+//# sourceMappingURL=preset.js.map

package/dist/render/springs/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../../../src/render/springs/preset.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from \"@/assert.js\";\nimport { type Camera, camera as cameraFactory } from \"@/render/camera.js\";\nimport { type Effect, effect as effectFactory } from \"@/render/effect.js\";\nimport { type Layer, layer as layerFactory } from \"@/render/layer.js\";\nimport { ramp as rampFactory } from \"@/render/ramp.js\";\nimport { type ParticleSource, type Source, sources } from \"@/render/sources.js\";\nimport { anchors as anchorsFactory } from \"@/render/springs/anchors.js\";\nimport { construction as constructionFactory } from \"@/render/springs/construction.js\";\nimport { impulses as impulsesFactory } from \"@/render/springs/impulses.js\";\nimport { links as linksFactory } from \"@/render/springs/links.js\";\nimport { type Palette, palette as paletteFactory } from \"@/render/springs/palette.js\";\nimport { type Springs, strain as strainSignal } from \"@/render/springs/source.js\";\n\n/**\n * Whether the free links use render-only fracture (`\"visual\"`) or none\n * (`false`).\n */\nexport type FractureMode = \"visual\" | false;\n\n/**\n * Options for {@link preset.standard}.\n */\nexport interface PresetOptions {\n  /**\n   * The springs the links and impulses layers draw.\n   */\n  readonly from: Springs;\n\n  /**\n   * Overrides for individual palette entries.\n   */\n  readonly palette?: Partial<Palette>;\n\n  /**\n   * Overall strength of the preset, `0..1`. Scales the emissive response,\n   * bloom, and impulse frequency together.\n   */\n  readonly intensity?: number;\n\n  /**\n   * Whether to include the construction-geometry layer.\n   */\n  readonly construction?: boolean;\n\n  /**\n   * Whether to include the impulses layer.\n   */\n  readonly impulses?: boolean;\n\n  /**\n   * Render-only fracture behavior for the free links.\n   */\n  readonly fracture?: FractureMode;\n}\n\nexport interface Preset {\n  /**\n   * The resolved palette, with any overrides applied.\n   */\n  readonly palette: Palette;\n  /**\n   * The layers to draw, in back-to-front order.\n   */\n  readonly layers: readonly Layer<Source>[];\n  /**\n   * The post-processing effects applied to the composed frame.\n   */\n  readonly effects: readonly Effect[];\n  /**\n   * The camera the scene is viewed through.\n   */\n  readonly camera: Camera;\n}\n\nexport namespace preset {\n  /**\n   * The standard preset for creating a swarm with springs.\n   */\n  export function standard({\n    from,\n    palette: overrides,\n    intensity = 0.8,\n    construction = true,\n    impulses = true,\n    fracture = \"visual\",\n  }: PresetOptions): Preset {\n    assert(intensity >= 0 && intensity <= 1, `preset intensity must be within 0..1, but is ${intensity}`);\n\n    const palette: Palette = paletteFactory.standard(overrides);\n    const particles = sources.particles();\n\n    const layers: Layer<Source>[] = [];\n\n    if (construction) {\n      layers.push(constructionLayer(particles, palette));\n    }\n\n    layers.push(pinnedLinksLayer(from, palette), freeLinksLayer({ from, palette, intensity, fracture }));\n\n    if (impulses) {\n      layers.push(impulsesLayer({ from, palette, intensity }));\n    }\n\n    layers.push(particlesLayer(particles, palette), anchorsLayer(from, palette));\n\n    return { palette, layers, effects: standardEffects(intensity), camera: cameraFactory.perspective() };\n  }\n}\n\nfunction constructionLayer(particles: ParticleSource, palette: Palette): Layer<Source> {\n  return constructionFactory({ from: particles, color: palette.dim, opacity: 0.12, rings: 5 });\n}\n\nfunction pinnedLinksLayer(from: Springs, palette: Palette): Layer<Source> {\n  return linksFactory({\n    from,\n    group: \"pinned\",\n    color: palette.structure,\n    width: 1.25,\n    opacity: 0.35,\n  });\n}\n\nfunction freeLinksLayer({\n  from,\n  palette,\n  intensity,\n  fracture,\n}: {\n  from: Springs;\n  palette: Palette;\n  intensity: number;\n  fracture: FractureMode;\n}): Layer<Source> {\n  const strain = strainSignal({ domain: [0, 0.4] });\n\n  return linksFactory({\n    from,\n    group: \"free\",\n    color: rampFactory.color({\n      by: strain,\n      stops: [\n        { at: 0, value: palette.dim },\n        { at: 0.7, value: palette.structure },\n        { at: 1, value: palette.stress },\n      ],\n    }),\n    width: rampFactory.scalar({\n      by: strain,\n      stops: [\n        { at: 0, value: 0.45 },\n        { at: 1, value: 2.1 },\n      ],\n    }),\n    opacity: rampFactory.scalar({\n      by: strain,\n      stops: [\n        { at: 0, value: 0.18 },\n        { at: 1, value: 0.9 },\n      ],\n    }),\n    emissive: rampFactory.scalar({\n      by: strain,\n      stops: [\n        { at: 0, value: 0 },\n        { at: 0.75, value: 0.05 * intensity },\n        { at: 1, value: intensity },\n      ],\n    }),\n    fracture: fracture === \"visual\" ? { threshold: 0.33, recovery: 0.6 } : undefined,\n  });\n}\n\nfunction impulsesLayer({\n  from,\n  palette,\n  intensity,\n}: {\n  from: Springs;\n  palette: Palette;\n  intensity: number;\n}): Layer<Source> {\n  return impulsesFactory({\n    from,\n    stress: 0.22,\n    color: palette.text,\n    tailColor: palette.stress,\n    frequency: 0.12 * intensity,\n    speed: 1.5,\n    length: 0.08,\n  });\n}\n\nfunction particlesLayer(particles: ParticleSource, palette: Palette): Layer<Source> {\n  return layerFactory.particles({\n    from: particles,\n    shape: \"cross\",\n    color: palette.structure,\n    size: 2,\n    opacity: 0.8,\n  });\n}\n\nfunction anchorsLayer(from: Springs, palette: Palette): Layer<Source> {\n  return anchorsFactory({ from, shape: \"gyroscope\", color: palette.structure, size: 4.4, opacity: 0.8 });\n}\n\nfunction standardEffects(intensity: number): Effect[] {\n  return [\n    effectFactory.bloom({ threshold: 0.85, intensity: 0.65 * intensity, radius: 0.12 }),\n    effectFactory.vignette({ intensity: 0.45, smoothness: 0.85 }),\n  ];\n}\n"]}

package/dist/render/springs/segment.d.ts

@@ -0,0 +1,40 @@
+import { BufferAttribute, BufferGeometry, type Material, Mesh } from "three/webgpu";
+/**
+ * The number of vertices a thick segment expands to.
+ */
+export declare const VERTICES_PER_SEGMENT = 6;
+type Point = readonly [number, number, number];
+/**
+ * A dynamic buffer attribute holding `itemSize` floats per vertex for `count`
+ * segments.
+ */
+export declare function segmentAttribute(count: number, itemSize: number): BufferAttribute;
+/**
+ * A geometry for `count` segments, with a dynamic position attribute that
+ * {@link writeSegment} fills.
+ */
+export declare function segmentGeometry(count: number): {
+    geometry: BufferGeometry;
+    positions: BufferAttribute;
+};
+/**
+ * A mesh over segment geometry. Frustum culling is off, since the positions are
+ * rewritten every frame and the geometry's bounds are never recomputed.
+ */
+export declare function segmentMesh(geometry: BufferGeometry, material: Material): Mesh;
+interface WriteSegmentOptions {
+    target: Float32Array;
+    segment: number;
+    a: Point;
+    b: Point;
+    halfWidth: number;
+    shift?: number;
+}
+/**
+ * Writes a thick segment between endpoints `a` and `b` into `target`, drawn as
+ * two triangles that lie flat in the screen plane. The width is added at a right
+ * angle to the segment, and `shift` slides the whole quad that same way, for
+ * drawing offset copies. `segment` picks which slice of `target` to fill.
+ */
+export declare function writeSegment({ target, segment, a, b, halfWidth, shift }: WriteSegmentOptions): void;
+export {};