@triforge/particle-core 0.1.0

package/dist/renderers/LineRenderer.js

@@ -0,0 +1,96 @@
+import { LineSegments, BufferGeometry, BufferAttribute, LineBasicMaterial, Color, } from 'three';
+import { BaseRenderer } from '../core/BaseRenderer.js';
+/**
+ * LineRenderer — renders each particle as a velocity-aligned line segment.
+ * (Blender: Render → Line)
+ */
+export class LineRenderer extends BaseRenderer {
+    constructor(opts = {}) {
+        super();
+        const max = opts.maxCount ?? 10000;
+        this._maxCount = max;
+        const low = opts.colourLow ?? [1, 0, 0];
+        const high = opts.colourHigh ?? [0, 0, 1];
+        this.parameters = {
+            lengthScale: opts.lengthScale ?? 0.1,
+            opacity: 1,
+            colourMode: opts.colourMode ?? 0,
+            colourLowR: low[0], colourLowG: low[1], colourLowB: low[2],
+            colourHighR: high[0], colourHighG: high[1], colourHighB: high[2],
+            velocityMax: opts.velocityMax ?? 10,
+        };
+        // Each line = 2 vertices × 3 floats
+        this._positions = new Float32Array(max * 6);
+        this._colors = new Float32Array(max * 6); // 2 vertices × RGB
+        const geo = new BufferGeometry();
+        this._posAttr = new BufferAttribute(this._positions, 3).setUsage(35048);
+        this._colorAttr = new BufferAttribute(this._colors, 3).setUsage(35048);
+        geo.setAttribute('position', this._posAttr);
+        geo.setAttribute('color', this._colorAttr);
+        geo.setDrawRange(0, 0);
+        const mat = new LineBasicMaterial({
+            color: new Color(opts.color ?? 0xffffff),
+            transparent: true,
+            depthWrite: false,
+        });
+        this.object3D = new LineSegments(geo, mat);
+        this.object3D.frustumCulled = false;
+        this._allocDrawBuf(max);
+    }
+    update(particles, aliveCount, params, childRng) {
+        const childCount = params ? Math.round(Math.max(0, params.childCount ?? 0)) : 0;
+        const childType = params ? Math.round(params.childType ?? 0) : 0;
+        const childSpread = params ? (params.childSpread ?? 0.5) : 0.5;
+        const rawCount = this.expandWithChildren(particles, aliveCount, childCount, childType, childSpread, childRng ?? null, this._maxCount);
+        const displayAmount = params ? Math.min(1, Math.max(0, params.displayAmount ?? 1)) : 1;
+        const drawCount = displayAmount >= 1 ? rawCount : Math.round(rawCount * displayAmount);
+        const pr = this.parameters;
+        const ls = pr.lengthScale;
+        const mode = Math.round(pr.colourMode);
+        for (let i = 0; i < drawCount; i++) {
+            const p = this._drawBuf[i];
+            const i6 = i * 6;
+            // Tail (velocity direction behind particle)
+            this._positions[i6] = p.position.x - p.velocity.x * ls;
+            this._positions[i6 + 1] = p.position.y - p.velocity.y * ls;
+            this._positions[i6 + 2] = p.position.z - p.velocity.z * ls;
+            // Head (current position)
+            this._positions[i6 + 3] = p.position.x;
+            this._positions[i6 + 4] = p.position.y;
+            this._positions[i6 + 5] = p.position.z;
+            if (mode > 0) {
+                let t;
+                if (mode === 1) {
+                    const spd = Math.sqrt(p.velocity.x * p.velocity.x +
+                        p.velocity.y * p.velocity.y +
+                        p.velocity.z * p.velocity.z);
+                    t = Math.min(1, spd / Math.max(pr.velocityMax, 0.0001));
+                }
+                else {
+                    t = p.normalised;
+                }
+                const r = pr.colourLowR + (pr.colourHighR - pr.colourLowR) * t;
+                const g = pr.colourLowG + (pr.colourHighG - pr.colourLowG) * t;
+                const b = pr.colourLowB + (pr.colourHighB - pr.colourLowB) * t;
+                // Both tail and head vertices get the same colour
+                this._colors[i6] = r;
+                this._colors[i6 + 1] = g;
+                this._colors[i6 + 2] = b;
+                this._colors[i6 + 3] = r;
+                this._colors[i6 + 4] = g;
+                this._colors[i6 + 5] = b;
+            }
+        }
+        const mat = this.object3D.material;
+        mat.vertexColors = mode > 0;
+        this._posAttr.needsUpdate = true;
+        if (mode > 0)
+            this._colorAttr.needsUpdate = true;
+        this.object3D.geometry.setDrawRange(0, drawCount * 2);
+    }
+    dispose() {
+        this.object3D.geometry.dispose();
+        this.object3D.material.dispose();
+    }
+}
+//# sourceMappingURL=LineRenderer.js.map

package/dist/renderers/LineRenderer.js.map

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

package/dist/renderers/NoneRenderer.d.ts

@@ -0,0 +1,19 @@
+import { Object3D } from 'three';
+import { BaseRenderer } from '../core/BaseRenderer.js';
+import type { ParticleLike } from '../core/BaseRenderer.js';
+import type { SeededRandom } from '../core/SeededRandom.js';
+/**
+ * NoneRenderer — invisible particle renderer.
+ * Blender: Render → None.
+ *
+ * Useful when particles drive physics/emitters but should not be drawn,
+ * e.g. when particles spawn child systems or are consumed by a fluid sim.
+ */
+export declare class NoneRenderer extends BaseRenderer {
+    readonly object3D: Object3D;
+    parameters: Record<string, number>;
+    constructor();
+    update(_particles: ParticleLike[], _aliveCount: number, _params?: Record<string, number>, _rng?: SeededRandom): void;
+    dispose(): void;
+}
+//# sourceMappingURL=NoneRenderer.d.ts.map

package/dist/renderers/NoneRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoneRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/NoneRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAS,OAAO,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAiB;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAK;;IAOvC,MAAM,CAAC,UAAU,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI;IAIpH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/renderers/NoneRenderer.js

@@ -0,0 +1,24 @@
+import { Object3D } from 'three';
+import { BaseRenderer } from '../core/BaseRenderer.js';
+/**
+ * NoneRenderer — invisible particle renderer.
+ * Blender: Render → None.
+ *
+ * Useful when particles drive physics/emitters but should not be drawn,
+ * e.g. when particles spawn child systems or are consumed by a fluid sim.
+ */
+export class NoneRenderer extends BaseRenderer {
+    constructor() {
+        super();
+        this.object3D = new Object3D();
+        this.parameters = {};
+        this.object3D.visible = false;
+    }
+    update(_particles, _aliveCount, _params, _rng) {
+        // intentionally empty — no visual output
+    }
+    dispose() {
+        // nothing to clean up
+    }
+}
+//# sourceMappingURL=NoneRenderer.js.map

package/dist/renderers/NoneRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoneRenderer.js","sourceRoot":"","sources":["../../src/renderers/NoneRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAS,OAAO,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAItD;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IAI5C;QACE,KAAK,EAAE,CAAA;QAJA,aAAQ,GAAa,IAAI,QAAQ,EAAE,CAAA;QAC5C,eAAU,GAA2B,EAAE,CAAA;QAIrC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAA;IAC/B,CAAC;IAED,MAAM,CAAC,UAA0B,EAAE,WAAmB,EAAE,OAAgC,EAAE,IAAmB;QAC3G,yCAAyC;IAC3C,CAAC;IAED,OAAO;QACL,sBAAsB;IACxB,CAAC;CACF"}

package/dist/renderers/ObjectRenderer.d.ts

@@ -0,0 +1,3 @@
+export { InstanceRenderer as ObjectRenderer } from './InstanceRenderer.js';
+export type { InstanceRendererOptions as ObjectRendererOptions } from './InstanceRenderer.js';
+//# sourceMappingURL=ObjectRenderer.d.ts.map

package/dist/renderers/ObjectRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/ObjectRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC1E,YAAY,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/renderers/ObjectRenderer.js

@@ -0,0 +1,4 @@
+// Blender "Object" render mode alias → InstanceRenderer.
+// Both names are exported so code may use either; they are the same class.
+export { InstanceRenderer as ObjectRenderer } from './InstanceRenderer.js';
+//# sourceMappingURL=ObjectRenderer.js.map

package/dist/renderers/ObjectRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectRenderer.js","sourceRoot":"","sources":["../../src/renderers/ObjectRenderer.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,2EAA2E;AAC3E,OAAO,EAAE,gBAAgB,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/renderers/StrandRenderer.d.ts

@@ -0,0 +1,169 @@
+import { Group, LineBasicMaterial, MeshBasicMaterial } from 'three';
+import { BaseRenderer } from '../core/BaseRenderer.js';
+import type { ParticleLike } from '../core/BaseRenderer.js';
+import type { SeededRandom } from '../core/SeededRandom.js';
+/** Source geometry with optional vertex-group float attributes. */
+export interface StrandSourceGeometry {
+    getAttribute(name: string): {
+        getX(i: number): number;
+    } | undefined;
+}
+export type StrandCurveFn = (particle: ParticleLike, t: number, // 0 = root, 1 = tip
+index: number) => {
+    x: number;
+    y: number;
+    z: number;
+};
+export type StrandRenderMode = 'line' | 'tube';
+export interface StrandRendererOptions {
+    /**
+     * Maximum number of live strands. Default 1000.
+     * Set to the particle system's `count` for best results.
+     */
+    maxCount?: number;
+    /**
+     * Number of segments per strand. Default 8.
+     * More segments = smoother curves, higher GPU cost.
+     */
+    segments?: number;
+    /**
+     * Strand cross-section radius for 'tube' mode. Default 0.02.
+     * Blender: Hair Shape → Diameter Root
+     */
+    thickness?: number;
+    /**
+     * Tip taper factor [0–1]. 1 = uniform, 0 = taper to point. Default 0.5.
+     * Blender: Hair Shape → Taper
+     */
+    taper?: number;
+    /**
+     * How strands are rendered.
+     * 'line' (default) — fast LineSegments, thickness controlled by material.
+     * 'tube'           — mesh tube, supports lighting. Heavier, best for hero strands.
+     */
+    mode?: StrandRenderMode;
+    /**
+     * Function that returns a world-space point along the strand at normalised t ∈ [0,1].
+     * t=0 = root (particle position), t=1 = tip.
+     *
+     * Default: straight strand drooping 1 world unit downward along gravity.
+     *
+     * To connect with st-hair-core:
+     *   const gen = new StrandGenerator({ ... })
+     *   renderer = new StrandRenderer({
+     *     strandCurve: (p, t) => gen.evaluateAt(p.position, p.velocity, t)
+     *   })
+     */
+    strandCurve?: StrandCurveFn;
+    /** Material for the strands. Default: white LineBasicMaterial or MeshBasicMaterial. */
+    material?: LineBasicMaterial | MeshBasicMaterial;
+    /**
+     * Source geometry to read vertex-group float attributes from.
+     * The particle's `poolIdx` is used as the vertex index.
+     * Blender: Vertex Groups → Strand panel.
+     */
+    sourceGeometry?: StrandSourceGeometry;
+    /**
+     * Name of a float vertex attribute on `sourceGeometry` whose value [0–1]
+     * scales each strand's length multiplier. 0 = no strand, 1 = full length.
+     * Blender: Vertex Groups → Length.
+     */
+    lengthAttribute?: string;
+    /**
+     * Name of a float vertex attribute on `sourceGeometry` whose value [0–1]
+     * offsets the strand root toward the emitter surface centre (clumping).
+     * Blender: Vertex Groups → Clump.
+     */
+    clumpAttribute?: string;
+    /**
+     * Name of a float vertex attribute on `sourceGeometry` whose value [0–1]
+     * scales the kink amplitude for this strand.
+     * Blender: Vertex Groups → Roughness.
+     */
+    roughnessAttribute?: string;
+    /**
+     * Viewport display fraction [0–1]. Default 1 (show all).
+     * 0.5 shows 50% of strands in the viewport without affecting simulation.
+     * Blender: Display panel → Display Amount.
+     */
+    displayAmount?: number;
+    /**
+     * Optional callback that returns the world-space tangent direction at
+     * a normalised position t along the strand.
+     * Used to drive anisotropic shading in tube mode (e.g. PrincipledHair node).
+     *
+     * @example
+     * // Connect with st-hair-core StrandGenerator
+     * const gen = new StrandGenerator({ ... })
+     * new StrandRenderer({
+     *   tangentFn: (particle, t) => gen.tangentAt(particle.position, particle.velocity, t)
+     * })
+     */
+    tangentFn?: (particle: ParticleLike, t: number) => {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/**
+ * StrandRenderer — Blender: Hair / Path render type on a particle system.
+ *
+ * Renders each alive particle as a strand (hair, grass, fur).
+ * The strand shape is defined by a `strandCurve` callback — this allows
+ * integration with st-hair-core's StrandGenerator without a hard import.
+ *
+ * Usage:
+ * ```typescript
+ * const renderer = new StrandRenderer({
+ *   maxCount: 500,
+ *   segments: 8,
+ *   strandCurve: (p, t) => ({
+ *     x: p.position.x,
+ *     y: p.position.y + t * 0.3,
+ *     z: p.position.z,
+ *   })
+ * })
+ * sys.setRenderer(renderer)
+ * scene.add(renderer.object3D)
+ * ```
+ *
+ * To use st-hair-core strand shapes, pass a generator callback:
+ * ```typescript
+ * // Outside st-particle-core — no import restriction applies here
+ * import { StrandGenerator } from 'st-hair-core'
+ * const gen = new StrandGenerator({ length: 0.4, gravity: 0.3 })
+ * const renderer = new StrandRenderer({
+ *   strandCurve: (p, t) => gen.samplePoint(p.position, p.velocity, t)
+ * })
+ * ```
+ */
+export declare class StrandRenderer extends BaseRenderer {
+    parameters: Record<string, number>;
+    readonly object3D: Group;
+    private readonly _segments;
+    private readonly _maxCount;
+    private readonly _mode;
+    private readonly _strandCurve;
+    private readonly _material;
+    private readonly _sourceGeo;
+    private readonly _lengthAttrName;
+    private readonly _clumpAttrName;
+    private readonly _roughnessAttrName;
+    private readonly _tangentFn;
+    private _lineGeo;
+    private _lineSegs;
+    private _linePosArr;
+    private _tubeMeshes;
+    private _tubeInScene;
+    constructor(opts?: StrandRendererOptions);
+    update(particles: ParticleLike[], aliveCount: number, params?: Record<string, number>, childRng?: SeededRandom): void;
+    dispose(): void;
+    private _initLineGeometry;
+    private _updateLine;
+    private _initTubePool;
+    private _updateTubes;
+    /** Read a float attribute value at vertex index `vi`; returns 1 if unavailable. */
+    private _attrVal;
+    private static _defaultCurve;
+}
+//# sourceMappingURL=StrandRenderer.d.ts.map

package/dist/renderers/StrandRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrandRenderer.d.ts","sourceRoot":"","sources":["../../src/renderers/StrandRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAAgB,iBAAiB,EAEtC,iBAAiB,EAClB,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,YAAY,EAAE,MAAU,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACpE;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,YAAY,EACtB,CAAC,EAAE,MAAM,EAAY,oBAAoB;AACzC,KAAK,EAAE,MAAM,KACV;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAA;AAE9C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;IAEvB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,aAAa,CAAA;IAE3B,uFAAuF;IACvF,QAAQ,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAAA;IAEhD;;;;OAIG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAErC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACvF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiD;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoD;IAG/E,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,WAAW,CAA4B;IAG/C,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,YAAY,CAAuB;gBAE/B,IAAI,GAAE,qBAA0B;IAqC5C,MAAM,CACJ,SAAS,EAAG,YAAY,EAAE,EAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,QAAQ,CAAC,EAAG,YAAY,GACvB,IAAI;IAiBP,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;IAmEpB,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,MAAM,CAAC,aAAa,CAI1B;CACH"}

package/dist/renderers/StrandRenderer.js

@@ -0,0 +1,235 @@
+import { Group, LineSegments, LineBasicMaterial, BufferGeometry, BufferAttribute, MeshBasicMaterial, Mesh, TubeGeometry, CatmullRomCurve3, Vector3, } from 'three';
+import { BaseRenderer } from '../core/BaseRenderer.js';
+/**
+ * StrandRenderer — Blender: Hair / Path render type on a particle system.
+ *
+ * Renders each alive particle as a strand (hair, grass, fur).
+ * The strand shape is defined by a `strandCurve` callback — this allows
+ * integration with st-hair-core's StrandGenerator without a hard import.
+ *
+ * Usage:
+ * ```typescript
+ * const renderer = new StrandRenderer({
+ *   maxCount: 500,
+ *   segments: 8,
+ *   strandCurve: (p, t) => ({
+ *     x: p.position.x,
+ *     y: p.position.y + t * 0.3,
+ *     z: p.position.z,
+ *   })
+ * })
+ * sys.setRenderer(renderer)
+ * scene.add(renderer.object3D)
+ * ```
+ *
+ * To use st-hair-core strand shapes, pass a generator callback:
+ * ```typescript
+ * // Outside st-particle-core — no import restriction applies here
+ * import { StrandGenerator } from 'st-hair-core'
+ * const gen = new StrandGenerator({ length: 0.4, gravity: 0.3 })
+ * const renderer = new StrandRenderer({
+ *   strandCurve: (p, t) => gen.samplePoint(p.position, p.velocity, t)
+ * })
+ * ```
+ */
+export class StrandRenderer extends BaseRenderer {
+    constructor(opts = {}) {
+        super();
+        // Line mode geometry — one pre-allocated geometry updated in place
+        this._lineGeo = null;
+        this._lineSegs = null;
+        this._linePosArr = null;
+        // Tube mode — one Mesh per strand, pooled
+        this._tubeMeshes = [];
+        this._tubeInScene = [];
+        this._maxCount = opts.maxCount ?? 1000;
+        this._segments = opts.segments ?? 8;
+        this._mode = opts.mode ?? 'line';
+        this._strandCurve = opts.strandCurve ?? StrandRenderer._defaultCurve;
+        this._sourceGeo = opts.sourceGeometry ?? null;
+        this._lengthAttrName = opts.lengthAttribute ?? null;
+        this._clumpAttrName = opts.clumpAttribute ?? null;
+        this._roughnessAttrName = opts.roughnessAttribute ?? null;
+        this._tangentFn = opts.tangentFn ?? null;
+        this._material = opts.material ?? (this._mode === 'tube'
+            ? new MeshBasicMaterial({ color: 0xccaa77 })
+            : new LineBasicMaterial({ color: 0xccaa77 }));
+        this._allocDrawBuf(this._maxCount);
+        this.object3D = new Group();
+        this.parameters = {
+            thickness: opts.thickness ?? 0.02,
+            taper: opts.taper ?? 0.5,
+            segments: this._segments,
+            kinkAmplitude: 0, // wave displacement — Blender: Kink → Amplitude
+            kinkFrequency: 1, // waves per strand  — Blender: Kink → Frequency
+            densityThreshold: 0, // skip strands where particle.size < this value
+            displayAmount: opts.displayAmount ?? 1.0, // fraction of strands shown [0–1]
+        };
+        if (this._mode === 'line') {
+            this._initLineGeometry();
+        }
+        else {
+            this._initTubePool();
+        }
+    }
+    update(particles, aliveCount, params, childRng) {
+        const n = this.expandWithChildren(particles, aliveCount, params?.childCount ?? 0, params?.childType ?? 0, params?.childSpread ?? 0.5, childRng ?? null, this._maxCount);
+        if (this._mode === 'line') {
+            this._updateLine(n);
+        }
+        else {
+            this._updateTubes(n);
+        }
+    }
+    dispose() {
+        this._lineGeo?.dispose();
+        this._material.dispose();
+        for (const m of this._tubeMeshes)
+            m.geometry.dispose();
+    }
+    // ── Line mode ─────────────────────────────────────────────────────────────
+    _initLineGeometry() {
+        // Each strand = _segments segments = _segments+1 points = _segments*2 line endpoints
+        const pointsPerStrand = this._segments + 1;
+        const totalPoints = this._maxCount * pointsPerStrand;
+        this._linePosArr = new Float32Array(totalPoints * 3);
+        this._lineGeo = new BufferGeometry();
+        this._lineGeo.setAttribute('position', new BufferAttribute(this._linePosArr, 3));
+        // Build index: pairs of consecutive points per strand
+        const indices = [];
+        for (let s = 0; s < this._maxCount; s++) {
+            const base = s * pointsPerStrand;
+            for (let seg = 0; seg < this._segments; seg++) {
+                indices.push(base + seg, base + seg + 1);
+            }
+        }
+        this._lineGeo.setIndex(indices);
+        this._lineSegs = new LineSegments(this._lineGeo, this._material);
+        this.object3D.add(this._lineSegs);
+    }
+    _updateLine(count) {
+        const arr = this._linePosArr;
+        const segs = this._segments;
+        const pps = segs + 1; // points per strand
+        const threshold = this.parameters.densityThreshold;
+        const displayMax = Math.round(count * Math.max(0, Math.min(1, this.parameters.displayAmount)));
+        for (let i = 0; i < count; i++) {
+            const d = this._drawBuf[i];
+            const base = i * pps * 3;
+            // Skip beyond displayAmount or low-weight strands
+            if (i >= displayMax || (threshold > 0 && d.size < threshold)) {
+                for (let j = 0; j < pps * 3; j++)
+                    arr[base + j] = 0;
+                continue;
+            }
+            const lengthScale = this._attrVal(this._lengthAttrName, d.poolIdx);
+            const clumpScale = this._attrVal(this._clumpAttrName, d.poolIdx);
+            const roughnessScale = this._attrVal(this._roughnessAttrName, d.poolIdx);
+            const kinkAmp = this.parameters.kinkAmplitude * roughnessScale;
+            const kinkFreq = this.parameters.kinkFrequency;
+            for (let j = 0; j <= segs; j++) {
+                const t = (j / segs) * lengthScale;
+                const pt = this._strandCurve(d, t, d.poolIdx);
+                const kink = kinkAmp > 0 ? Math.sin(t * kinkFreq * Math.PI * 2) * kinkAmp * t : 0;
+                const clumpX = (d.position.x - pt.x) * (1 - clumpScale);
+                const clumpZ = (d.position.z - pt.z) * (1 - clumpScale);
+                const off = base + j * 3;
+                arr[off] = pt.x + kink + clumpX;
+                arr[off + 1] = pt.y;
+                arr[off + 2] = pt.z + kink * 0.5 + clumpZ;
+            }
+        }
+        // Zero out unused strands
+        for (let i = count; i < this._maxCount; i++) {
+            const base = i * pps * 3;
+            for (let j = 0; j < pps * 3; j++)
+                arr[base + j] = 0;
+        }
+        this._lineGeo.getAttribute('position').needsUpdate = true;
+        this._lineGeo.computeBoundingSphere();
+    }
+    // ── Tube mode ─────────────────────────────────────────────────────────────
+    _initTubePool() {
+        for (let i = 0; i < this._maxCount; i++) {
+            // Placeholder geometry — replaced each update
+            const geo = new BufferGeometry();
+            const mesh = new Mesh(geo, this._material);
+            mesh.visible = false;
+            this._tubeMeshes.push(mesh);
+            this._tubeInScene.push(false);
+            this.object3D.add(mesh);
+        }
+    }
+    _updateTubes(count) {
+        const segs = this._segments;
+        const thickness = this.parameters.thickness;
+        const taper = this.parameters.taper;
+        const threshold = this.parameters.densityThreshold;
+        const displayMax = Math.round(count * Math.max(0, Math.min(1, this.parameters.displayAmount)));
+        for (let i = 0; i < count; i++) {
+            const d = this._drawBuf[i];
+            const mesh = this._tubeMeshes[i];
+            if (i >= displayMax || (threshold > 0 && d.size < threshold)) {
+                mesh.visible = false;
+                continue;
+            }
+            const lengthScale = this._attrVal(this._lengthAttrName, d.poolIdx);
+            const clumpScale = this._attrVal(this._clumpAttrName, d.poolIdx);
+            const roughnessScale = this._attrVal(this._roughnessAttrName, d.poolIdx);
+            const kinkAmp = this.parameters.kinkAmplitude * roughnessScale;
+            const kinkFreq = this.parameters.kinkFrequency;
+            const pts = [];
+            for (let j = 0; j <= segs; j++) {
+                const t = (j / segs) * lengthScale;
+                const pt = this._strandCurve(d, t, d.poolIdx);
+                const kink = kinkAmp > 0 ? Math.sin(t * kinkFreq * Math.PI * 2) * kinkAmp * t : 0;
+                const clumpX = (d.position.x - pt.x) * (1 - clumpScale);
+                const clumpZ = (d.position.z - pt.z) * (1 - clumpScale);
+                pts.push(new Vector3(pt.x + kink + clumpX, pt.y, pt.z + kink * 0.5 + clumpZ));
+            }
+            // Build tube geometry along the curve
+            const curve = new CatmullRomCurve3(pts);
+            const radiusFn = (t) => thickness * (1 - t * (1 - taper));
+            const tubeRadius = thickness; // TubeGeometry doesn't support per-point radius
+            void radiusFn;
+            mesh.geometry.dispose();
+            const geo = new TubeGeometry(curve, segs, tubeRadius * taper, 4, false);
+            // Bake tangent attribute for anisotropic shading (PrincipledHair / HairInfo node)
+            if (this._tangentFn) {
+                const vtxCount = geo.attributes.position.count;
+                const tangents = new Float32Array(vtxCount * 3);
+                for (let vi = 0; vi < vtxCount; vi++) {
+                    const t = (vi / vtxCount);
+                    const tv = this._tangentFn(d, t);
+                    tangents[vi * 3] = tv.x;
+                    tangents[vi * 3 + 1] = tv.y;
+                    tangents[vi * 3 + 2] = tv.z;
+                }
+                geo.setAttribute('strandTangent', new BufferAttribute(tangents, 3));
+            }
+            mesh.geometry = geo;
+            mesh.visible = true;
+        }
+        // Hide unused
+        for (let i = count; i < this._maxCount; i++) {
+            this._tubeMeshes[i].visible = false;
+        }
+    }
+    // ── Vertex group attribute helpers ───────────────────────────────────────
+    /** Read a float attribute value at vertex index `vi`; returns 1 if unavailable. */
+    _attrVal(attrName, vi) {
+        if (!attrName || !this._sourceGeo)
+            return 1;
+        const attr = this._sourceGeo.getAttribute(attrName);
+        if (!attr)
+            return 1;
+        return attr.getX(vi);
+    }
+}
+// ── Default strand curve ──────────────────────────────────────────────────
+StrandRenderer._defaultCurve = (p, t) => ({
+    x: p.position.x,
+    y: p.position.y + t * p.size * 5, // strand grows upward from particle
+    z: p.position.z,
+});
+//# sourceMappingURL=StrandRenderer.js.map

package/dist/renderers/StrandRenderer.js.map

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