@opsydyn/effect-three 0.2.0 → 0.4.0

package/dist/index-ttwy0znv.js

@@ -0,0 +1,145 @@
+// src/kernel/seeded.ts
+var seededRandom = (seed) => {
+  let state = seed >>> 0;
+  return () => {
+    state = state + 1831565813 >>> 0;
+    let t = state;
+    t = Math.imul(t ^ t >>> 15, t | 1);
+    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+};
+
+// src/kernel/lineGeometry.ts
+import { Color, EdgesGeometry } from "three";
+var drawable = (line) => line.points.length >= 2;
+var fillLineGeometry = (geometry, line) => {
+  const points = drawable(line) ? line.points : [[0, 0, 0], [0, 0, 0]];
+  const used = line.segments ? points.slice(0, points.length - points.length % 2) : points;
+  geometry.setPositions(used.flat());
+  const colors = line.vertexColors;
+  if (colors !== null) {
+    const per = used.map((_, index) => colors[Math.min(index, colors.length - 1)] ?? line.color);
+    geometry.setColors(per.flatMap((color) => new Color(color).toArray()));
+  }
+  return geometry;
+};
+var edgePoints = (geometry, threshold) => {
+  const found = new EdgesGeometry(geometry, threshold);
+  const position = found.getAttribute("position");
+  const points = Array.from({ length: position.count }, (_, index) => [position.getX(index), position.getY(index), position.getZ(index)]);
+  found.dispose();
+  return points;
+};
+var edgeLine = (key, look, points) => ({
+  _tag: "Line",
+  key: `${key}:edges`,
+  position: [0, 0, 0],
+  rotation: { _tag: "Fixed", euler: [0, 0, 0] },
+  scale: [1, 1, 1],
+  transition: { _tag: "Instant" },
+  behaviour: null,
+  interactive: false,
+  points,
+  segments: true,
+  color: look.color,
+  vertexColors: null,
+  width: look.width,
+  worldUnits: look.worldUnits,
+  dashed: look.dashed,
+  dashSize: look.dashSize,
+  gapSize: look.gapSize,
+  dashScale: 1,
+  dashOffset: 0,
+  opacity: look.opacity,
+  transparent: look.transparent
+});
+
+// src/kernel/pointBuffers.ts
+import { Color as Color2, Spherical, Vector3 } from "three";
+var linear = new Color2;
+var dots = (look) => {
+  const count = look.positions.length;
+  const colors = new Float32Array(count * 3);
+  for (let point = 0;point < count; point++) {
+    linear.setHex(look.colors?.[point] ?? look.color).toArray(colors, point * 3);
+  }
+  return {
+    count,
+    positions: Float32Array.from(look.positions.flat()),
+    colors,
+    sizes: Float32Array.from({ length: count }, (_, point) => look.sizes?.[point] ?? 1),
+    speeds: new Float32Array(0),
+    opacities: new Float32Array(0),
+    noise: new Float32Array(0)
+  };
+};
+var sparkles = (look) => {
+  const random = seededRandom(look.seed);
+  const spread = (range) => range * (0.5 - random());
+  const { count } = look;
+  const positions = new Float32Array(count * 3);
+  for (let point = 0;point < count; point++) {
+    positions[point * 3] = spread(look.scale[0]);
+    positions[point * 3 + 1] = spread(look.scale[1]);
+    positions[point * 3 + 2] = spread(look.scale[2]);
+  }
+  const colors = new Float32Array(count * 3);
+  linear.setHex(look.color);
+  for (let point = 0;point < count; point++)
+    linear.toArray(colors, point * 3);
+  const noise = new Float32Array(count * 3);
+  for (let point = 0;point < count; point++)
+    noise.set(look.noise, point * 3);
+  return {
+    count,
+    positions,
+    colors,
+    sizes: Float32Array.from({ length: count }, () => look.size ?? random()),
+    speeds: new Float32Array(count).fill(look.speed),
+    opacities: new Float32Array(count).fill(look.opacity),
+    noise
+  };
+};
+var stars = (look) => {
+  const random = seededRandom(look.seed);
+  const { count } = look;
+  const positions = new Float32Array(count * 3);
+  const colors = new Float32Array(count * 3);
+  const sizes = Float32Array.from({ length: count }, () => (0.5 + 0.5 * random()) * look.factor);
+  const place = new Vector3;
+  const spherical = new Spherical;
+  const increment = look.depth / count;
+  let radius = look.radius + look.depth;
+  for (let star = 0;star < count; star++) {
+    radius -= increment * random();
+    place.setFromSpherical(spherical.set(radius, Math.acos(1 - random() * 2), random() * 2 * Math.PI));
+    place.toArray(positions, star * 3);
+    linear.setHSL(star / count, look.saturation, 0.9).toArray(colors, star * 3);
+  }
+  return {
+    count,
+    positions,
+    colors,
+    sizes,
+    speeds: new Float32Array(0),
+    opacities: new Float32Array(0),
+    noise: new Float32Array(0)
+  };
+};
+var pointBuffers = (look) => {
+  switch (look._tag) {
+    case "Dots":
+      return dots(look);
+    case "Sparkles":
+      return sparkles(look);
+    case "Stars":
+      return stars(look);
+  }
+};
+var animatedLook = (look) => look._tag !== "Dots";
+
+export { seededRandom, drawable, fillLineGeometry, edgePoints, edgeLine, pointBuffers, animatedLook };
+
+//# debugId=76D13B28B891165764756E2164756E21
+//# sourceMappingURL=index-ttwy0znv.js.map

package/dist/index-ttwy0znv.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/kernel/seeded.ts", "../src/kernel/lineGeometry.ts", "../src/kernel/pointBuffers.ts"],
+  "sourcesContent": [
+    "/**\n * A small seeded random generator (mulberry32): the same numbers for the same seed on\n * every page load, so randomly scattered scene parts are reproducible.\n *\n * @module\n */\n\n/** A generator of numbers in [0, 1) from `seed`, as `Math.random` would give them. */\nexport const seededRandom = (seed: number): (() => number) => {\n  let state = seed >>> 0;\n  return () => {\n    state = (state + 0x6d2b79f5) >>> 0;\n    let t = state;\n    t = Math.imul(t ^ (t >>> 15), t | 1);\n    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);\n    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n  };\n};\n",
+    "/**\n * A line's geometry, as Drei's `Line` builds it: three's `LineGeometry` through the points\n * (or `LineSegmentsGeometry`, a segment for each pair), with a colour per point when it\n * has them. Shared by the render kits, whose materials differ; the geometry does not.\n *\n * @module\n */\nimport { type BufferGeometry, Color, EdgesGeometry } from 'three';\nimport type { LineSegmentsGeometry } from 'three/addons/lines/LineSegmentsGeometry.js';\n\nimport type { Edges, LineNode, Vec3 } from './description.ts';\n\n/** Whether there is anything to draw: two points for a line, a pair for segments. */\nexport const drawable = (line: LineNode): boolean => line.points.length >= 2;\n\n/**\n * Fills a line's geometry: a `LineGeometry` through the points, or a\n * `LineSegmentsGeometry` for segments. Too few points give one empty segment (hidden).\n */\nexport const fillLineGeometry = <G extends LineSegmentsGeometry>(\n  geometry: G,\n  line: LineNode,\n): G => {\n  const points = drawable(line) ? line.points : [[0, 0, 0] as const, [0, 0, 0] as const];\n  // Segments come in pairs: an odd last point has nothing to join.\n  const used = line.segments ? points.slice(0, points.length - (points.length % 2)) : points;\n  geometry.setPositions(used.flat());\n  const colors = line.vertexColors;\n  if (colors !== null) {\n    // A colour for every point: the last given carries on, as a line can't skip one.\n    const per = used.map((_, index) => colors[Math.min(index, colors.length - 1)] ?? line.color);\n    geometry.setColors(per.flatMap((color) => new Color(color).toArray()));\n  }\n  return geometry;\n};\n\n/**\n * The line segments along a geometry's edges where faces meet at more than `threshold`\n * degrees, as Drei's `Edges` takes them from three's `EdgesGeometry`.\n */\nexport const edgePoints = (geometry: BufferGeometry, threshold: number): ReadonlyArray<Vec3> => {\n  const found = new EdgesGeometry(geometry, threshold);\n  const position = found.getAttribute('position');\n  const points = Array.from(\n    { length: position.count },\n    (_, index): Vec3 => [position.getX(index), position.getY(index), position.getZ(index)],\n  );\n  found.dispose();\n  return points;\n};\n\n/** The line a mesh's edges are drawn as: segments in the mesh's own space. */\nexport const edgeLine = (key: string, look: Edges, points: ReadonlyArray<Vec3>): LineNode => ({\n  _tag: 'Line',\n  key: `${key}:edges`,\n  position: [0, 0, 0],\n  rotation: { _tag: 'Fixed', euler: [0, 0, 0] },\n  scale: [1, 1, 1],\n  transition: { _tag: 'Instant' },\n  behaviour: null,\n  interactive: false,\n  points,\n  segments: true,\n  color: look.color,\n  vertexColors: null,\n  width: look.width,\n  worldUnits: look.worldUnits,\n  dashed: look.dashed,\n  dashSize: look.dashSize,\n  gapSize: look.gapSize,\n  dashScale: 1,\n  dashOffset: 0,\n  opacity: look.opacity,\n  transparent: look.transparent,\n});\n",
+    "/**\n * The buffers a render kit draws points from, made from their look: given points as\n * they are, Drei's sparkles and stars scattered as Drei scatters them (`Sparkles.tsx`,\n * `Stars.tsx` at `bf6f4ad`) but from a seed, so the same look gives the same buffers.\n *\n * @module\n */\nimport { Color, Spherical, Vector3 } from 'three';\n\nimport type { PointLook } from './description.ts';\nimport { seededRandom } from './seeded.ts';\n\n/** Per-point attributes: three numbers a point for positions, colours and noise. */\nexport type PointBuffers = {\n  readonly count: number;\n  readonly positions: Float32Array;\n  readonly colors: Float32Array;\n  readonly sizes: Float32Array;\n  /** Sparkles only: each mote's drift speed, opacity and noise. */\n  readonly speeds: Float32Array;\n  readonly opacities: Float32Array;\n  readonly noise: Float32Array;\n};\n\nconst linear = new Color();\n\nconst dots = (look: Extract<PointLook, { readonly _tag: 'Dots' }>): PointBuffers => {\n  const count = look.positions.length;\n  const colors = new Float32Array(count * 3);\n  for (let point = 0; point < count; point++) {\n    linear.setHex(look.colors?.[point] ?? look.color).toArray(colors, point * 3);\n  }\n  return {\n    count,\n    positions: Float32Array.from(look.positions.flat()),\n    colors,\n    sizes: Float32Array.from({ length: count }, (_, point) => look.sizes?.[point] ?? 1),\n    speeds: new Float32Array(0),\n    opacities: new Float32Array(0),\n    noise: new Float32Array(0),\n  };\n};\n\n/** Drei's `Sparkles`: positions spread through the box, random sizes unless given. */\nconst sparkles = (look: Extract<PointLook, { readonly _tag: 'Sparkles' }>): PointBuffers => {\n  const random = seededRandom(look.seed);\n  // three's `MathUtils.randFloatSpread`, as Drei spreads them, from the seed.\n  const spread = (range: number) => range * (0.5 - random());\n  const { count } = look;\n  const positions = new Float32Array(count * 3);\n  for (let point = 0; point < count; point++) {\n    positions[point * 3] = spread(look.scale[0]);\n    positions[point * 3 + 1] = spread(look.scale[1]);\n    positions[point * 3 + 2] = spread(look.scale[2]);\n  }\n  const colors = new Float32Array(count * 3);\n  linear.setHex(look.color);\n  for (let point = 0; point < count; point++) linear.toArray(colors, point * 3);\n  const noise = new Float32Array(count * 3);\n  for (let point = 0; point < count; point++) noise.set(look.noise, point * 3);\n  return {\n    count,\n    positions,\n    colors,\n    sizes: Float32Array.from({ length: count }, () => look.size ?? random()),\n    speeds: new Float32Array(count).fill(look.speed),\n    opacities: new Float32Array(count).fill(look.opacity),\n    noise,\n  };\n};\n\n/** Drei's `Stars`: a shell of stars, nearer ones later, hues round the colour wheel. */\nconst stars = (look: Extract<PointLook, { readonly _tag: 'Stars' }>): PointBuffers => {\n  const random = seededRandom(look.seed);\n  const { count } = look;\n  const positions = new Float32Array(count * 3);\n  const colors = new Float32Array(count * 3);\n  const sizes = Float32Array.from({ length: count }, () => (0.5 + 0.5 * random()) * look.factor);\n  const place = new Vector3();\n  const spherical = new Spherical();\n  const increment = look.depth / count;\n  let radius = look.radius + look.depth;\n  for (let star = 0; star < count; star++) {\n    radius -= increment * random();\n    place.setFromSpherical(\n      spherical.set(radius, Math.acos(1 - random() * 2), random() * 2 * Math.PI),\n    );\n    place.toArray(positions, star * 3);\n    linear.setHSL(star / count, look.saturation, 0.9).toArray(colors, star * 3);\n  }\n  return {\n    count,\n    positions,\n    colors,\n    sizes,\n    speeds: new Float32Array(0),\n    opacities: new Float32Array(0),\n    noise: new Float32Array(0),\n  };\n};\n\n/** The buffers for a look. */\nexport const pointBuffers = (look: PointLook): PointBuffers => {\n  switch (look._tag) {\n    case 'Dots':\n      return dots(look);\n    case 'Sparkles':\n      return sparkles(look);\n    case 'Stars':\n      return stars(look);\n  }\n};\n\n/** Whether a look moves on its own: sparkles drift and stars twinkle in scene time. */\nexport const animatedLook = (look: PointLook): boolean => look._tag !== 'Dots';\n"
+  ],
+  "mappings": "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",
+  "debugId": "76D13B28B891165764756E2164756E21",
+  "names": []
+}