gloop-sim 0.0.0-stage → 1.0.0

package/dist/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAqB;IAC/C,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/C,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;QAChE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO;QACL,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAkB;YACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,qBAAqB,OAAO,UAAU,CAAC,CAAC;YAEzF,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,IAAI,OAAO,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { assert } from \"@/assert.js\";\nimport type { AdvanceOptions, Swarm, SwarmOptions, SwarmState } from \"@/types.js\";\n\n/**\n * Creates a swarm using the specified options.\n */\nexport async function swarm(options: SwarmOptions): Promise<Swarm> {\n  options.model.validate?.({ particleCount: options.particleCount });\n\n  const executable = await options.backend.compile({\n    particles: options.initializer.initialize(options.particleCount),\n    model: options.model,\n    integrator: options.integrator,\n  });\n\n  let time = 0;\n\n  return {\n    advance({ time: seconds }: AdvanceOptions): void {\n      assert(Number.isFinite(seconds) && seconds >= 0, `cannot advance by ${seconds} seconds`);\n\n      executable.step(seconds);\n      time += seconds;\n    },\n    async snapshot(): Promise<SwarmState> {\n      return { time, particles: await executable.snapshot() };\n    },\n  };\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,290 @@
+import type { Node } from "three/webgpu";
+/**
+ * An accelerator device, such as a GPU.
+ */
+export type Device = GPUDevice;
+/**
+ * A position or velocity in simulation space.
+ */
+export type Vector = readonly [x: number, y: number, z: number];
+export interface Particles {
+    /**
+     * How many particles there are.
+     */
+    readonly count: number;
+    /**
+     * Particle positions, indexed by particle.
+     */
+    readonly positions: readonly Vector[];
+    /**
+     * Particle velocities, indexed by particle.
+     */
+    readonly velocities: readonly Vector[];
+}
+export interface SwarmState {
+    /**
+     * Simulated time the swarm has advanced by, in seconds.
+     */
+    readonly time: number;
+    /**
+     * The particles as of that time.
+     */
+    readonly particles: Particles;
+}
+export interface Initializer {
+    /**
+     * Builds the starting particles for a swarm of `particleCount` particles.
+     */
+    initialize(particleCount: number): Particles;
+}
+export interface CpuModel {
+    /**
+     * Accelerations acting on each particle, indexed by particle.
+     */
+    accelerate(particles: Particles): readonly Vector[];
+}
+export interface CpuIntegratorOptions {
+    /**
+     * The particles the step starts from.
+     */
+    readonly particles: Particles;
+    /**
+     * Accelerations at `particles`, indexed by particle.
+     */
+    readonly accelerations: readonly Vector[];
+    /**
+     * Simulated time the step covers, in seconds.
+     */
+    readonly seconds: number;
+}
+export interface CpuIntegrator {
+    /**
+     * Returns the particles `seconds` later, given the accelerations at them.
+     */
+    step(options: CpuIntegratorOptions): Particles;
+}
+export interface GpuParticle {
+    /**
+     * The position of the particle the compute invocation is running for.
+     */
+    readonly position: Node<"vec3">;
+    /**
+     * The velocity of the particle the compute invocation is running for.
+     */
+    readonly velocity: Node<"vec3">;
+}
+export interface GpuParticles {
+    /**
+     * How many particles there are.
+     */
+    readonly count: number;
+    /**
+     * The position of the particle at `index`.
+     */
+    position(index: Node | number): Node<"vec3">;
+    /**
+     * The velocity of the particle at `index`.
+     */
+    velocity(index: Node | number): Node<"vec3">;
+}
+export interface GpuModelOptions {
+    /**
+     * Every particle's state in the swarm.
+     */
+    readonly particles: GpuParticles;
+    /**
+     * The index of the particle the acceleration is computed for.
+     */
+    readonly index: Node<"uint">;
+}
+export interface GpuModel {
+    /**
+     * The acceleration acting on the particle at `index`.
+     */
+    acceleration(options: GpuModelOptions): Node<"vec3">;
+}
+export interface GpuIntegratorOptions {
+    /**
+     * The particle the step starts from.
+     */
+    readonly particle: GpuParticle;
+    /**
+     * The acceleration acting on `particle`.
+     */
+    readonly acceleration: Node<"vec3">;
+    /**
+     * Simulated time the step covers, in seconds.
+     */
+    readonly seconds: Node<"float">;
+}
+export interface GpuIntegrator {
+    /**
+     * Returns the particle `seconds` later.
+     */
+    step(options: GpuIntegratorOptions): GpuParticle;
+}
+export interface ModelValidationContext {
+    /**
+     * The number of particles in the swarm the model is being combined with.
+     */
+    readonly particleCount: number;
+}
+export interface Model {
+    /**
+     * The model's CPU implementation, if available.
+     */
+    readonly cpu?: CpuModel;
+    /**
+     * The model's GPU implementation, if available.
+     */
+    readonly gpu?: GpuModel;
+    /**
+     * Checks the model against the swarm it is being combined with, throwing if
+     * the two disagree.
+     */
+    validate?(context: ModelValidationContext): void;
+}
+export interface Integrator {
+    /**
+     * The integrator's CPU implementation.
+     */
+    readonly cpu: CpuIntegrator;
+    /**
+     * The integrator's GPU implementation.
+     */
+    readonly gpu: GpuIntegrator;
+}
+export interface CompileOptions {
+    /**
+     * The swarm's starting particles.
+     */
+    readonly particles: Particles;
+    /**
+     * Defines the forces acting on the particles.
+     */
+    readonly model: Model;
+    /**
+     * Advances positions and velocities under those forces.
+     */
+    readonly integrator: Integrator;
+}
+export interface Executable {
+    /**
+     * Advances the held particles by `seconds` of simulated time.
+     */
+    step(seconds: number): void;
+    /**
+     * Reads back the current particles.
+     */
+    snapshot(): Promise<Particles>;
+}
+export interface Backend {
+    /**
+     * Combines a model and an integrator into an executable holding `particles`.
+     */
+    compile(options: CompileOptions): Promise<Executable>;
+}
+export interface GpuBackendOptions {
+    /**
+     * The device to use for the accelerated computations. If unspecified, a default device
+     * will be used.
+     */
+    readonly device?: Device;
+}
+export interface SwarmOptions {
+    /**
+     * Number of particles to simulate.
+     */
+    readonly particleCount: number;
+    /**
+     * Supplies the particles' starting positions and velocities.
+     */
+    readonly initializer: Initializer;
+    /**
+     * Defines the forces acting on the particles.
+     */
+    readonly model: Model;
+    /**
+     * Advances positions and velocities under those forces.
+     */
+    readonly integrator: Integrator;
+    /**
+     * Executes the model and integrator.
+     */
+    readonly backend: Backend;
+}
+export interface AdvanceOptions {
+    /**
+     * Simulated time to advance by, in seconds.
+     */
+    readonly time: number;
+}
+export interface Swarm {
+    /**
+     * Progresses the swarm by a specified amount of simulated time.
+     */
+    advance(options: AdvanceOptions): void;
+    /**
+     * Returns a read-only copy of the swarm's observable state.
+     */
+    snapshot(): Promise<SwarmState>;
+}
+export interface FixedInitializerOptions {
+    /**
+     * Caller-owned starting positions, one per particle.
+     */
+    readonly positions: readonly Vector[];
+    /**
+     * Caller-owned starting velocities, one per particle.
+     */
+    readonly velocities: readonly Vector[];
+}
+export interface Connection {
+    /**
+     * The two particles the spring joins, by index. The connection is
+     * undirected, so the order of the pair does not affect the forces.
+     */
+    readonly between: readonly [number, number];
+    /**
+     * The length at which the spring produces no elastic force. A longer
+     * separation pulls the particles together, a shorter one pushes them apart.
+     */
+    readonly restLength: number;
+}
+export interface ElasticNetworkOptions {
+    /**
+     * The mass of each particle, indexed by particle. Every mass must be a
+     * positive, finite number.
+     */
+    readonly masses: readonly number[];
+    /**
+     * The springs joining particle pairs. If empty, no particles will be connected.
+     */
+    readonly connections?: readonly Connection[];
+    /**
+     * The rest position each particle's anchor pulls toward, indexed by
+     * particle. If omitted, particles will be unanchored.
+     */
+    readonly restPositions?: readonly Vector[];
+    /**
+     * The spring stiffness shared by every connection, controlling how strongly
+     * a connection resists changing from its rest length. If omitted, it will be
+     * assumed that there is no spring force between connected particles.
+     */
+    readonly stiffness?: number;
+    /**
+     * The spring damping shared by every connection, opposing relative motion
+     * along each connection. If omitted, it will be assumed that there is no damping.
+     */
+    readonly springDamping?: number;
+    /**
+     * The anchor strength pulling each particle toward its rest position.
+     * If omitted, it will be assumed that there is no anchoring force.
+     */
+    readonly anchorStrength?: number;
+    /**
+     * The global damping opposing every particle's velocity independently of its
+     * connections. If omitted, it will be assumed that there is no global damping.
+     */
+    readonly globalDamping?: number;
+}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Node } from \"three/webgpu\";\n\n/**\n * An accelerator device, such as a GPU.\n */\nexport type Device = GPUDevice;\n\n/**\n * A position or velocity in simulation space.\n */\nexport type Vector = readonly [x: number, y: number, z: number];\n\nexport interface Particles {\n  /**\n   * How many particles there are.\n   */\n  readonly count: number;\n\n  /**\n   * Particle positions, indexed by particle.\n   */\n  readonly positions: readonly Vector[];\n\n  /**\n   * Particle velocities, indexed by particle.\n   */\n  readonly velocities: readonly Vector[];\n}\n\nexport interface SwarmState {\n  /**\n   * Simulated time the swarm has advanced by, in seconds.\n   */\n  readonly time: number;\n\n  /**\n   * The particles as of that time.\n   */\n  readonly particles: Particles;\n}\n\nexport interface Initializer {\n  /**\n   * Builds the starting particles for a swarm of `particleCount` particles.\n   */\n  initialize(particleCount: number): Particles;\n}\n\nexport interface CpuModel {\n  /**\n   * Accelerations acting on each particle, indexed by particle.\n   */\n  accelerate(particles: Particles): readonly Vector[];\n}\n\nexport interface CpuIntegratorOptions {\n  /**\n   * The particles the step starts from.\n   */\n  readonly particles: Particles;\n  /**\n   * Accelerations at `particles`, indexed by particle.\n   */\n  readonly accelerations: readonly Vector[];\n  /**\n   * Simulated time the step covers, in seconds.\n   */\n  readonly seconds: number;\n}\n\nexport interface CpuIntegrator {\n  /**\n   * Returns the particles `seconds` later, given the accelerations at them.\n   */\n  step(options: CpuIntegratorOptions): Particles;\n}\n\nexport interface GpuParticle {\n  /**\n   * The position of the particle the compute invocation is running for.\n   */\n  readonly position: Node<\"vec3\">;\n  /**\n   * The velocity of the particle the compute invocation is running for.\n   */\n  readonly velocity: Node<\"vec3\">;\n}\n\nexport interface GpuParticles {\n  /**\n   * How many particles there are.\n   */\n  readonly count: number;\n  /**\n   * The position of the particle at `index`.\n   */\n  position(index: Node | number): Node<\"vec3\">;\n  /**\n   * The velocity of the particle at `index`.\n   */\n  velocity(index: Node | number): Node<\"vec3\">;\n}\n\nexport interface GpuModelOptions {\n  /**\n   * Every particle's state in the swarm.\n   */\n  readonly particles: GpuParticles;\n  /**\n   * The index of the particle the acceleration is computed for.\n   */\n  readonly index: Node<\"uint\">;\n}\n\nexport interface GpuModel {\n  /**\n   * The acceleration acting on the particle at `index`.\n   */\n  acceleration(options: GpuModelOptions): Node<\"vec3\">;\n}\n\nexport interface GpuIntegratorOptions {\n  /**\n   * The particle the step starts from.\n   */\n  readonly particle: GpuParticle;\n  /**\n   * The acceleration acting on `particle`.\n   */\n  readonly acceleration: Node<\"vec3\">;\n  /**\n   * Simulated time the step covers, in seconds.\n   */\n  readonly seconds: Node<\"float\">;\n}\n\nexport interface GpuIntegrator {\n  /**\n   * Returns the particle `seconds` later.\n   */\n  step(options: GpuIntegratorOptions): GpuParticle;\n}\n\nexport interface ModelValidationContext {\n  /**\n   * The number of particles in the swarm the model is being combined with.\n   */\n  readonly particleCount: number;\n}\n\nexport interface Model {\n  /**\n   * The model's CPU implementation, if available.\n   */\n  readonly cpu?: CpuModel;\n  /**\n   * The model's GPU implementation, if available.\n   */\n  readonly gpu?: GpuModel;\n  /**\n   * Checks the model against the swarm it is being combined with, throwing if\n   * the two disagree.\n   */\n  validate?(context: ModelValidationContext): void;\n}\n\nexport interface Integrator {\n  /**\n   * The integrator's CPU implementation.\n   */\n  readonly cpu: CpuIntegrator;\n  /**\n   * The integrator's GPU implementation.\n   */\n  readonly gpu: GpuIntegrator;\n}\n\nexport interface CompileOptions {\n  /**\n   * The swarm's starting particles.\n   */\n  readonly particles: Particles;\n  /**\n   * Defines the forces acting on the particles.\n   */\n  readonly model: Model;\n  /**\n   * Advances positions and velocities under those forces.\n   */\n  readonly integrator: Integrator;\n}\n\nexport interface Executable {\n  /**\n   * Advances the held particles by `seconds` of simulated time.\n   */\n  step(seconds: number): void;\n  /**\n   * Reads back the current particles.\n   */\n  snapshot(): Promise<Particles>;\n}\n\nexport interface Backend {\n  /**\n   * Combines a model and an integrator into an executable holding `particles`.\n   */\n  compile(options: CompileOptions): Promise<Executable>;\n}\n\nexport interface GpuBackendOptions {\n  /**\n   * The device to use for the accelerated computations. If unspecified, a default device\n   * will be used.\n   */\n  readonly device?: Device;\n}\n\nexport interface SwarmOptions {\n  /**\n   * Number of particles to simulate.\n   */\n  readonly particleCount: number;\n  /**\n   * Supplies the particles' starting positions and velocities.\n   */\n  readonly initializer: Initializer;\n  /**\n   * Defines the forces acting on the particles.\n   */\n  readonly model: Model;\n  /**\n   * Advances positions and velocities under those forces.\n   */\n  readonly integrator: Integrator;\n  /**\n   * Executes the model and integrator.\n   */\n  readonly backend: Backend;\n}\n\nexport interface AdvanceOptions {\n  /**\n   * Simulated time to advance by, in seconds.\n   */\n  readonly time: number;\n}\n\nexport interface Swarm {\n  /**\n   * Progresses the swarm by a specified amount of simulated time.\n   */\n  advance(options: AdvanceOptions): void;\n  /**\n   * Returns a read-only copy of the swarm's observable state.\n   */\n  snapshot(): Promise<SwarmState>;\n}\n\nexport interface FixedInitializerOptions {\n  /**\n   * Caller-owned starting positions, one per particle.\n   */\n  readonly positions: readonly Vector[];\n  /**\n   * Caller-owned starting velocities, one per particle.\n   */\n  readonly velocities: readonly Vector[];\n}\n\nexport interface Connection {\n  /**\n   * The two particles the spring joins, by index. The connection is\n   * undirected, so the order of the pair does not affect the forces.\n   */\n  readonly between: readonly [number, number];\n  /**\n   * The length at which the spring produces no elastic force. A longer\n   * separation pulls the particles together, a shorter one pushes them apart.\n   */\n  readonly restLength: number;\n}\n\nexport interface ElasticNetworkOptions {\n  /**\n   * The mass of each particle, indexed by particle. Every mass must be a\n   * positive, finite number.\n   */\n  readonly masses: readonly number[];\n  /**\n   * The springs joining particle pairs. If empty, no particles will be connected.\n   */\n  readonly connections?: readonly Connection[];\n  /**\n   * The rest position each particle's anchor pulls toward, indexed by\n   * particle. If omitted, particles will be unanchored.\n   */\n  readonly restPositions?: readonly Vector[];\n  /**\n   * The spring stiffness shared by every connection, controlling how strongly\n   * a connection resists changing from its rest length. If omitted, it will be\n   * assumed that there is no spring force between connected particles.\n   */\n  readonly stiffness?: number;\n  /**\n   * The spring damping shared by every connection, opposing relative motion\n   * along each connection. If omitted, it will be assumed that there is no damping.\n   */\n  readonly springDamping?: number;\n  /**\n   * The anchor strength pulling each particle toward its rest position.\n   * If omitted, it will be assumed that there is no anchoring force.\n   */\n  readonly anchorStrength?: number;\n  /**\n   * The global damping opposing every particle's velocity independently of its\n   * connections. If omitted, it will be assumed that there is no global damping.\n   */\n  readonly globalDamping?: number;\n}\n"]}

package/docs/assets/logo.svg

@@ -0,0 +1,112 @@
+<svg viewBox="40 40 420 420" xmlns="http://www.w3.org/2000/svg" aria-labelledby="gloop-logo-title" style="vertical-align: middle;">
+  <title id="gloop-logo-title">Gloop Logo</title>
+  <defs>
+    <!-- Deep Purple & Cyan Glow Filters -->
+    <filter id="bloom" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="6" result="blur"></feGaussianBlur>
+      <feMerge>
+        <feMergeNode in="blur"></feMergeNode>
+        <feMergeNode in="SourceGraphic"></feMergeNode>
+      </feMerge>
+    </filter>
+
+    <filter id="intense-bloom" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="12" result="blur"></feGaussianBlur>
+      <feMerge>
+        <feMergeNode in="blur"></feMergeNode>
+        <feMergeNode in="SourceGraphic"></feMergeNode>
+      </feMerge>
+    </filter>
+
+    <!-- Kinematic Linkage Gradient -->
+    <linearGradient id="linkageGradient" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#B8D8D8"></stop>
+      <stop offset="50%" stop-color="#9D4EDD"></stop>
+      <stop offset="100%" stop-color="#B8D8D8"></stop>
+    </linearGradient>
+
+    <!-- Background Void Energy -->
+    <radialGradient id="voidEnergy" cx="50%" cy="50%" r="50%">
+      <stop offset="0%" stop-color="#9D4EDD" stop-opacity="0.15"></stop>
+      <stop offset="50%" stop-color="#B8D8D8" stop-opacity="0.05"></stop>
+      <stop offset="100%" stop-color="#07090B" stop-opacity="0"></stop>
+    </radialGradient>
+  </defs>
+
+  <!-- Void Purple Energy Core -->
+  <circle cx="250" cy="250" r="200" fill="url(#voidEnergy)"></circle>
+
+  <!-- Da Vinci Construction Lines -->
+  <g stroke="#263238" stroke-width="1" fill="none">
+    <!-- Orbits -->
+    <circle cx="250" cy="250" r="160"></circle>
+    <circle cx="250" cy="250" r="120" stroke-dasharray="4 6"></circle>
+    <circle cx="250" cy="250" r="60" stroke-opacity="0.5"></circle>
+
+    <!-- Axes -->
+    <line x1="50" y1="250" x2="450" y2="250"></line>
+    <line x1="250" y1="50" x2="250" y2="450"></line>
+
+    <!-- 60-degree Diagonals -->
+    <line x1="111" y1="10" x2="389" y2="490" stroke-opacity="0.3"></line>
+    <line x1="389" y1="10" x2="111" y2="490" stroke-opacity="0.3"></line>
+  </g>
+
+  <!-- Secondary "Sinew" / Tissue connections -->
+  <g stroke="#546E7A" stroke-width="0.75" fill="none" opacity="0.6">
+    <line x1="310" y1="146" x2="370" y2="90"></line>
+    <line x1="190" y1="146" x2="130" y2="90"></line>
+    <line x1="190" y1="354" x2="130" y2="410"></line>
+    <line x1="310" y1="354" x2="370" y2="410"></line>
+    <line x1="250" y1="250" x2="250" y2="354" stroke-dasharray="2 4"></line>
+  </g>
+
+  <!-- Main "G" Kinematic Linkage (Hexagonal trace) -->
+  <!-- Base Glow -->
+  <polyline points="310,146 190,146 130,250 190,354 310,354 370,250 250,250" stroke="url(#linkageGradient)" stroke-width="16" fill="none" stroke-linejoin="miter" stroke-miterlimit="4" opacity="0.2" filter="url(#bloom)"></polyline>
+
+  <!-- Outer Strut Ring -->
+  <polyline points="310,146 190,146 130,250 190,354 310,354 370,250 250,250" stroke="url(#linkageGradient)" stroke-width="12" fill="none" stroke-linejoin="miter"></polyline>
+
+  <!-- Hollow Core Track -->
+  <polyline points="310,146 190,146 130,250 190,354 310,354 370,250 250,250" stroke="#07090B" stroke-width="6" fill="none" stroke-linejoin="miter"></polyline>
+
+  <!-- Icy Center Rail / Sparkline -->
+  <polyline points="310,146 190,146 130,250 190,354 310,354 370,250 250,250" stroke="#F0F4F8" stroke-width="1.5" fill="none" stroke-linejoin="miter" opacity="0.9"></polyline>
+
+  <!-- Particles (Technical Glyphs & Joints) -->
+  <g fill="#07090B" stroke-width="1.5">
+    <!-- P6: Top Right -->
+    <circle cx="310" cy="146" r="6" stroke="#B8D8D8"></circle>
+    <circle cx="310" cy="146" r="2" fill="#B8D8D8" stroke="none"></circle>
+
+    <!-- P5: Top Left -->
+    <circle cx="190" cy="146" r="6" stroke="#9D4EDD" filter="url(#bloom)"></circle>
+
+    <!-- P4: Mid Left -->
+    <circle cx="130" cy="250" r="8" stroke="#546E7A"></circle>
+    <circle cx="130" cy="250" r="3" stroke="#B8D8D8"></circle>
+
+    <!-- P3: Bottom Left -->
+    <circle cx="190" cy="354" r="6" stroke="#9D4EDD" filter="url(#bloom)"></circle>
+
+    <!-- P2: Bottom Right -->
+    <circle cx="310" cy="354" r="6" stroke="#B8D8D8"></circle>
+
+    <!-- P1: Mid Right -->
+    <circle cx="370" cy="250" r="8" stroke="#546E7A"></circle>
+    <path d="M 364 250 L 376 250 M 370 244 L 370 256" stroke="#B8D8D8" stroke-width="1"></path>
+  </g>
+
+  <!-- Center Actuator Particle (P0) -->
+  <g>
+    <!-- Purple energy ring -->
+    <circle cx="250" cy="250" r="14" fill="#07090B" stroke="#9D4EDD" stroke-width="2.5" filter="url(#intense-bloom)"></circle>
+    <!-- Cyan mechanical ring -->
+    <circle cx="250" cy="250" r="10" fill="none" stroke="#B8D8D8" stroke-width="1" stroke-dasharray="2 2"></circle>
+    <!-- Core pin -->
+    <circle cx="250" cy="250" r="4" fill="#F0F4F8" filter="url(#bloom)"></circle>
+    <!-- Reticle Cross -->
+    <path d="M 230 250 L 270 250 M 250 230 L 250 270" stroke="#F0F4F8" stroke-width="1" opacity="0.6"></path>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,105 @@
 {
   "name": "gloop-sim",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A particle swarm simulation and rendering library for running in the browser.",
+  "keywords": [
+    "webgpu",
+    "swarm",
+    "elastic",
+    "particles",
+    "simulation",
+    "browser",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Zurab Mujirishvili <zurab.mu@gmail.com>",
+  "homepage": "https://zurabm.gitlab.io/gloop/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/zurabm/gloop.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/zurabm/gloop/-/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./render": {
+      "types": "./dist/render/index.d.ts",
+      "import": "./dist/render/index.js",
+      "default": "./dist/render/index.js"
+    },
+    "./render/springs": {
+      "types": "./dist/render/springs/index.d.ts",
+      "import": "./dist/render/springs/index.js",
+      "default": "./dist/render/springs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "docs/assets/logo.svg"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@webgpu/types": "^0.1.66"
+  },
+  "peerDependencies": {
+    "three": "0.185.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.2",
+    "@types/three": "0.185.1",
+    "@vitest/browser-playwright": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.3",
+    "concurrently": "^10.0.3",
+    "cspell": "^10.0.1",
+    "cutline": "0.0.4",
+    "lefthook": "^2.1.9",
+    "playwright": "^1.61.1",
+    "three": "0.185.1",
+    "tsc-alias": "^1.9.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.16",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "dev": "pnpm --filter gloop-lab dev",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "pnpm run build:lib && pnpm run build:lab",
+    "build:lib": "pnpm run clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:lab": "pnpm --filter gloop-lab build",
+    "docs:lab": "pnpm --filter gloop-lab build:embed",
+    "docs:api": "node scripts/docs-api.mjs",
+    "docs:install": "node scripts/docs-install.mjs",
+    "docs:build": "pnpm run docs:lab && pnpm run docs:api && pnpm run docs:install && uvx zensical build",
+    "docs:serve": "uvx zensical serve",
+    "docs:watch": "pnpm run docs:lab && pnpm run docs:api && pnpm run docs:install && concurrently -k -n lab,docs -c green,cyan \"pnpm --filter gloop-lab build:embed:watch\" \"uvx zensical serve\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:webgpu": "vitest --config vitest.webgpu.config.ts",
+    "test:coverage": "vitest run --coverage",
+    "bench": "node -e \"require('fs').rmSync('generated/bench/latest',{recursive:true,force:true})\" && vitest bench --run --config vitest.bench.config.ts && pnpm --filter gloop-bench report",
+    "bench:report": "pnpm --filter gloop-bench report",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "spellcheck": "cspell --no-progress --gitignore .",
+    "typecheck": "tsc --noEmit && pnpm --filter gloop-lab typecheck && pnpm --filter gloop-bench typecheck",
+    "format": "biome format --write .",
+    "check": "pnpm run lint && pnpm run spellcheck && pnpm run typecheck && pnpm run test && pnpm run build"
+  }
 }