@mcptoolshop/physics-svg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var h=Object.defineProperty;var l=(i,t,e)=>t in i?h(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var a=(i,t,e)=>l(i,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./svg-renderer-CiwhJO3-.cjs");class p{constructor(){a(this,"canvas",null);a(this,"ctx",null)}init(t){this.canvas=document.createElement("canvas"),this.canvas.width=t.clientWidth||800,this.canvas.height=t.clientHeight||600,this.ctx=this.canvas.getContext("2d"),t.appendChild(this.canvas)}render(t,e){if(!(!this.ctx||!this.canvas)){this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height);for(const s of t){switch(this.ctx.save(),this.ctx.translate(s.position.x,s.position.y),this.ctx.fillStyle="#6366f1",s.shape.type){case"circle":this.ctx.beginPath(),this.ctx.arc(0,0,s.shape.radius,0,Math.PI*2),this.ctx.fill();break;case"rect":this.ctx.fillRect(-s.shape.width/2,-s.shape.height/2,s.shape.width,s.shape.height);break;case"polygon":{const o=s.shape.vertices;if(o.length<2)break;this.ctx.beginPath(),this.ctx.moveTo(o[0].x,o[0].y);for(let n=1;n<o.length;n++)this.ctx.lineTo(o[n].x,o[n].y);this.ctx.closePath(),this.ctx.fill();break}}this.ctx.restore()}}}destroy(){var t;(t=this.canvas)==null||t.remove(),this.canvas=null,this.ctx=null}}class c{constructor(t,e){a(this,"currentState");a(this,"transitions");a(this,"listeners",[]);this.currentState=t,this.transitions=e}send(t){var o;const e=this.transitions.find(n=>n.from===this.currentState&&n.on===t&&(n.guard?n.guard():!0));if(!e)return;const s=this.currentState;this.currentState=e.to,(o=e.action)==null||o.call(e);for(const n of this.listeners)n(s,e.to)}getState(){return this.currentState}onTransition(t){this.listeners.push(t)}}function d(){const i=[{from:"idle",to:"picked-up",on:"GRAB"},{from:"picked-up",to:"moving",on:"MOVE"},{from:"moving",to:"dropping",on:"RELEASE"},{from:"dropping",to:"bouncing",on:"BOUNCE_START"},{from:"dropping",to:"settled",on:"SETTLE"},{from:"bouncing",to:"settled",on:"BOUNCE_END"},{from:"settled",to:"picked-up",on:"GRAB"}];return new c("idle",i)}function u(){const i=[{from:"reserve",to:"deploying",on:"DEPLOY"},{from:"deploying",to:"landing",on:"LAND"},{from:"landing",to:"settled",on:"SETTLE"}];return new c("reserve",i)}function f(i){typeof window>"u"||(window.__PHYSICS_SVG_DEVTOOLS_HOOK__=i)}class g{constructor(){a(this,"subscribers",[])}emit(t){for(const e of this.subscribers)e(t)}subscribe(t){return this.subscribers.push(t),()=>{const e=this.subscribers.indexOf(t);e!==-1&&this.subscribers.splice(e,1)}}}exports.PhysicsEngine=r.PhysicsEngine;exports.SvgRenderer=r.SvgRenderer;exports.Vec2=r.vec2;exports.applyAttraction=r.applyAttraction;exports.applyDrag=r.applyDrag;exports.applyForceFields=r.applyForceFields;exports.applyGravity=r.applyGravity;exports.applyWind=r.applyWind;exports.createBody=r.createBody;exports.createConstraint=r.createConstraint;exports.wakeBody=r.wakeBody;exports.AnimationEmitter=g;exports.CanvasRenderer=p;exports.StateMachine=c;exports.createDeployMachine=u;exports.createPickupDropMachine=d;exports.installDevToolsHook=f;

package/dist/index.d.ts

@@ -0,0 +1,179 @@
+import { BodyShape } from '@mcp-tool-shop/siege-types';
+import { Constraint } from '@mcp-tool-shop/siege-types';
+import { Context } from 'react';
+import { ForceField } from '@mcp-tool-shop/siege-types';
+import { JSX } from 'react/jsx-runtime';
+import { PhysicsBody } from '@mcp-tool-shop/siege-types';
+import { ReactNode } from 'react';
+import { Vec2 } from '@mcp-tool-shop/siege-types';
+import { WorldConfig } from '@mcp-tool-shop/siege-types';
+
+/**
+ * Body — declarative React component that registers a physics body with
+ * the engine on mount and removes it on unmount.
+ *
+ * Renders nothing to the DOM. Visual representation is handled entirely
+ * by the {@link SvgRenderer}.
+ */
+declare function Body_2(props: BodyProps): null;
+export { Body_2 as Body }
+
+/** Props for the {@link Body} component. */
+export declare interface BodyProps {
+    /** Shape of the physics body. */
+    shape?: BodyShape;
+    /** Mass (kg). Default 1. */
+    mass?: number;
+    /** Initial position. */
+    position?: Vec2;
+    /** Initial velocity. */
+    velocity?: Vec2;
+    /** Coefficient of restitution (bounciness). 0-1. */
+    restitution?: number;
+    /** Friction coefficient. */
+    friction?: number;
+    /** If true, the body is immovable. */
+    isStatic?: boolean;
+    /** Arbitrary user data attached to the body. */
+    userData?: Record<string, unknown>;
+}
+
+/**
+ * React context that provides the {@link PhysicsEngine} instance to
+ * descendant components and hooks.
+ */
+export declare const PhysicsContext: Context<PhysicsEngine | null>;
+
+/**
+ * PhysicsEngine — top-level facade for the physics-svg simulation.
+ *
+ * Features:
+ * - Fixed-timestep simulation with accumulator
+ * - Interpolated body positions for smooth rendering
+ * - Body and constraint management
+ * - Force field system
+ * - Sleep/wake management
+ */
+declare class PhysicsEngine {
+    private world;
+    private accumulator;
+    private _alpha;
+    constructor(config: WorldConfig);
+    /**
+     * Advance the simulation by `frameTime` seconds.
+     *
+     * Uses Glenn Fiedler's fixed-timestep-with-accumulator pattern:
+     * - Clamp frame time to prevent spiral of death
+     * - Step physics at fixed 60Hz intervals
+     * - Store interpolation alpha for smooth rendering
+     */
+    update(frameTime: number): void;
+    /**
+     * Get the interpolation alpha for the current frame.
+     *
+     * Use this to blend between previousPosition and position:
+     * renderPos = lerp(body.previousPosition, body.position, alpha)
+     */
+    get alpha(): number;
+    /**
+     * Get the interpolated render position for a body.
+     */
+    getInterpolatedPosition(body: PhysicsBody): Vec2;
+    /** Register a body and return its id. */
+    addBody(body: PhysicsBody): string;
+    /** Remove a body by id. */
+    removeBody(id: string): void;
+    /** Look up a single body. */
+    getBody(id: string): PhysicsBody | undefined;
+    /** Return every body currently in the world. */
+    getBodies(): PhysicsBody[];
+    /** Apply an instantaneous impulse to a body. */
+    applyImpulse(id: string, impulse: Vec2): void;
+    /** Set a body's position directly (teleport). */
+    setPosition(id: string, position: Vec2): void;
+    /** Set a body's velocity directly. */
+    setVelocity(id: string, velocity: Vec2): void;
+    /** Register a constraint and return its id. */
+    addConstraint(constraint: Constraint): string;
+    /** Remove a constraint by id. */
+    removeConstraint(id: string): void;
+    /** Return every constraint currently in the world. */
+    getConstraints(): Constraint[];
+    /** Add a force field to the world. */
+    addForceField(field: ForceField): void;
+    /** Remove all force fields of a given type. */
+    removeForceFields(type: ForceField['type']): void;
+    /** Access the underlying world config. */
+    getConfig(): WorldConfig;
+}
+
+/**
+ * PhysicsScene — root React component that owns the physics engine and SVG
+ * renderer.
+ *
+ * Provides the engine via React context so child components and hooks can
+ * register bodies and constraints.
+ *
+ * Runs a `requestAnimationFrame` loop that steps the simulation and renders
+ * each frame.
+ */
+export declare function PhysicsScene({ config, width, height, children, }: PhysicsSceneProps): JSX.Element;
+
+/** Props for the {@link PhysicsScene} component. */
+export declare interface PhysicsSceneProps {
+    /** World configuration for the physics engine. */
+    config?: Partial<WorldConfig>;
+    /** Width of the SVG viewport. */
+    width?: number | string;
+    /** Height of the SVG viewport. */
+    height?: number | string;
+    /** Child components (e.g. `<Body>`, `<Spring>`). */
+    children?: ReactNode;
+}
+
+/**
+ * Spring — declarative React component that registers a spring constraint
+ * between two bodies on mount and removes it on unmount.
+ *
+ * Renders nothing to the DOM.
+ */
+export declare function Spring(props: SpringProps): null;
+
+/** Props for the {@link Spring} component. */
+export declare interface SpringProps {
+    /** ID of the first body. */
+    bodyA: string;
+    /** ID of the second body. */
+    bodyB: string;
+    /** Spring stiffness. Default 0.5. */
+    stiffness?: number;
+    /** Damping coefficient. Default 0.1. */
+    damping?: number;
+    /** Anchor point on body A (local coords). */
+    anchorA?: Vec2;
+    /** Anchor point on body B (local coords). */
+    anchorB?: Vec2;
+    /** Rest length. If omitted, computed from initial body positions. */
+    length?: number;
+}
+
+/**
+ * Hook to create and manage a physics body imperatively.
+ *
+ * The body is added to the engine on mount and removed on unmount.
+ *
+ * @param config - Partial body configuration.
+ * @returns The created {@link PhysicsBody} (stable reference).
+ */
+export declare function useBody(config: Partial<PhysicsBody>): PhysicsBody;
+
+/**
+ * Hook to access the nearest {@link PhysicsEngine} from context.
+ *
+ * Must be used inside a `<PhysicsScene>` provider.
+ *
+ * @throws If no PhysicsEngine is found in context.
+ */
+export declare function usePhysics(): PhysicsEngine;
+
+export { }

package/dist/index.js

@@ -0,0 +1,142 @@
+var c = Object.defineProperty;
+var h = (e, t, s) => t in e ? c(e, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : e[t] = s;
+var o = (e, t, s) => h(e, typeof t != "symbol" ? t + "" : t, s);
+import { P as b, S as m, v as y, a as S, b as E, c as w, d as T, e as k, f as O, g as P, w as _ } from "./svg-renderer-BOSG5i9F.js";
+class d {
+  constructor() {
+    o(this, "canvas", null);
+    o(this, "ctx", null);
+  }
+  init(t) {
+    this.canvas = document.createElement("canvas"), this.canvas.width = t.clientWidth || 800, this.canvas.height = t.clientHeight || 600, this.ctx = this.canvas.getContext("2d"), t.appendChild(this.canvas);
+  }
+  render(t, s) {
+    if (!(!this.ctx || !this.canvas)) {
+      this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
+      for (const i of t) {
+        switch (this.ctx.save(), this.ctx.translate(i.position.x, i.position.y), this.ctx.fillStyle = "#6366f1", i.shape.type) {
+          case "circle":
+            this.ctx.beginPath(), this.ctx.arc(0, 0, i.shape.radius, 0, Math.PI * 2), this.ctx.fill();
+            break;
+          case "rect":
+            this.ctx.fillRect(
+              -i.shape.width / 2,
+              -i.shape.height / 2,
+              i.shape.width,
+              i.shape.height
+            );
+            break;
+          case "polygon": {
+            const r = i.shape.vertices;
+            if (r.length < 2) break;
+            this.ctx.beginPath(), this.ctx.moveTo(r[0].x, r[0].y);
+            for (let n = 1; n < r.length; n++)
+              this.ctx.lineTo(r[n].x, r[n].y);
+            this.ctx.closePath(), this.ctx.fill();
+            break;
+          }
+        }
+        this.ctx.restore();
+      }
+    }
+  }
+  destroy() {
+    var t;
+    (t = this.canvas) == null || t.remove(), this.canvas = null, this.ctx = null;
+  }
+}
+class a {
+  constructor(t, s) {
+    o(this, "currentState");
+    o(this, "transitions");
+    o(this, "listeners", []);
+    this.currentState = t, this.transitions = s;
+  }
+  /** Send an event to the machine. If a valid transition matches, it fires. */
+  send(t) {
+    var r;
+    const s = this.transitions.find(
+      (n) => n.from === this.currentState && n.on === t && (n.guard ? n.guard() : !0)
+    );
+    if (!s) return;
+    const i = this.currentState;
+    this.currentState = s.to, (r = s.action) == null || r.call(s);
+    for (const n of this.listeners)
+      n(i, s.to);
+  }
+  /** Get the current state. */
+  getState() {
+    return this.currentState;
+  }
+  /** Register a callback invoked on every successful transition. */
+  onTransition(t) {
+    this.listeners.push(t);
+  }
+}
+function p() {
+  const e = [
+    { from: "idle", to: "picked-up", on: "GRAB" },
+    { from: "picked-up", to: "moving", on: "MOVE" },
+    { from: "moving", to: "dropping", on: "RELEASE" },
+    { from: "dropping", to: "bouncing", on: "BOUNCE_START" },
+    { from: "dropping", to: "settled", on: "SETTLE" },
+    { from: "bouncing", to: "settled", on: "BOUNCE_END" },
+    // Allow re-grab from settled
+    { from: "settled", to: "picked-up", on: "GRAB" }
+  ];
+  return new a(
+    "idle",
+    e
+  );
+}
+function u() {
+  const e = [
+    { from: "reserve", to: "deploying", on: "DEPLOY" },
+    { from: "deploying", to: "landing", on: "LAND" },
+    { from: "landing", to: "settled", on: "SETTLE" }
+  ];
+  return new a("reserve", e);
+}
+function f(e) {
+  typeof window > "u" || (window.__PHYSICS_SVG_DEVTOOLS_HOOK__ = e);
+}
+class g {
+  constructor() {
+    o(this, "subscribers", []);
+  }
+  /** Emit an animation event to all current subscribers. */
+  emit(t) {
+    for (const s of this.subscribers)
+      s(t);
+  }
+  /**
+   * Subscribe to animation events.
+   *
+   * @returns An unsubscribe function.
+   */
+  subscribe(t) {
+    return this.subscribers.push(t), () => {
+      const s = this.subscribers.indexOf(t);
+      s !== -1 && this.subscribers.splice(s, 1);
+    };
+  }
+}
+export {
+  g as AnimationEmitter,
+  d as CanvasRenderer,
+  b as PhysicsEngine,
+  a as StateMachine,
+  m as SvgRenderer,
+  y as Vec2,
+  S as applyAttraction,
+  E as applyDrag,
+  w as applyForceFields,
+  T as applyGravity,
+  k as applyWind,
+  O as createBody,
+  P as createConstraint,
+  u as createDeployMachine,
+  p as createPickupDropMachine,
+  f as installDevToolsHook,
+  _ as wakeBody
+};

package/dist/react/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("react/jsx-runtime"),t=require("react"),u=require("../svg-renderer-CiwhJO3-.cjs"),l=t.createContext(null),v={gravity:{x:0,y:980},substeps:4,velocityIterations:6};function R({config:e,width:r="100%",height:n="100%",children:s}){const d=t.useRef(null),y=t.useMemo(()=>({...v,...e}),[]),i=t.useMemo(()=>new u.PhysicsEngine(y),[y]),o=t.useRef(null);return t.useEffect(()=>{if(!d.current)return;const c=new u.SvgRenderer;return c.init(d.current),o.current=c,()=>{c.destroy(),o.current=null}},[]),t.useEffect(()=>{let c=performance.now(),f;const m=g=>{const B=Math.min((g-c)/1e3,.05);c=g,i.update(B),o.current&&(o.current.alpha=i.alpha,o.current.render(i.getBodies(),i.getConstraints())),f=requestAnimationFrame(m)};return f=requestAnimationFrame(m),()=>{cancelAnimationFrame(f)}},[i]),h.jsx(l.Provider,{value:i,children:h.jsx("div",{ref:d,style:{width:r,height:n,position:"relative"},children:s})})}function a(){const e=t.useContext(l);if(!e)throw new Error("usePhysics() must be used inside a <PhysicsScene> component.");return e}function b(e){const r=a(),n=t.useRef(null);return n.current||(n.current=u.createBody({shape:e.shape,mass:e.mass,position:e.position,velocity:e.velocity,restitution:e.restitution,friction:e.friction,isStatic:e.isStatic,userData:e.userData})),t.useEffect(()=>{const s=n.current;return r.addBody(s),()=>{r.removeBody(s.id)}},[r]),null}function P(e){const r=a(),n=t.useRef(null);return n.current||(n.current=u.createConstraint({type:"spring",bodyA:e.bodyA,bodyB:e.bodyB,stiffness:e.stiffness,damping:e.damping,anchorA:e.anchorA,anchorB:e.anchorB,length:e.length})),t.useEffect(()=>{const s=n.current;return r.addConstraint(s),()=>{r.removeConstraint(s.id)}},[r]),null}function C(e){const r=a(),n=t.useRef(null);return n.current||(n.current=u.createBody(e)),t.useEffect(()=>{const s=n.current;return r.addBody(s),()=>{r.removeBody(s.id)}},[r]),n.current}exports.Body=b;exports.PhysicsContext=l;exports.PhysicsScene=R;exports.Spring=P;exports.useBody=C;exports.usePhysics=a;

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * from './src/index'
+export {}

package/dist/react/index.js

@@ -0,0 +1,107 @@
+import { jsx as g } from "react/jsx-runtime";
+import { createContext as C, useRef as s, useMemo as h, useEffect as u, useContext as A } from "react";
+import { P, S as R, f as v, g as S } from "../svg-renderer-BOSG5i9F.js";
+const B = C(null), x = {
+  gravity: { x: 0, y: 980 },
+  substeps: 4,
+  velocityIterations: 6
+};
+function D({
+  config: n,
+  width: t = "100%",
+  height: e = "100%",
+  children: r
+}) {
+  const a = s(null), f = h(
+    () => ({ ...x, ...n }),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  ), i = h(() => new P(f), [f]), c = s(null);
+  return u(() => {
+    if (!a.current) return;
+    const o = new R();
+    return o.init(a.current), c.current = o, () => {
+      o.destroy(), c.current = null;
+    };
+  }, []), u(() => {
+    let o = performance.now(), d;
+    const y = (m) => {
+      const b = Math.min((m - o) / 1e3, 0.05);
+      o = m, i.update(b), c.current && (c.current.alpha = i.alpha, c.current.render(
+        i.getBodies(),
+        i.getConstraints()
+      )), d = requestAnimationFrame(y);
+    };
+    return d = requestAnimationFrame(y), () => {
+      cancelAnimationFrame(d);
+    };
+  }, [i]), /* @__PURE__ */ g(B.Provider, { value: i, children: /* @__PURE__ */ g(
+    "div",
+    {
+      ref: a,
+      style: { width: t, height: e, position: "relative" },
+      children: r
+    }
+  ) });
+}
+function l() {
+  const n = A(B);
+  if (!n)
+    throw new Error(
+      "usePhysics() must be used inside a <PhysicsScene> component."
+    );
+  return n;
+}
+function I(n) {
+  const t = l(), e = s(null);
+  return e.current || (e.current = v({
+    shape: n.shape,
+    mass: n.mass,
+    position: n.position,
+    velocity: n.velocity,
+    restitution: n.restitution,
+    friction: n.friction,
+    isStatic: n.isStatic,
+    userData: n.userData
+  })), u(() => {
+    const r = e.current;
+    return t.addBody(r), () => {
+      t.removeBody(r.id);
+    };
+  }, [t]), null;
+}
+function q(n) {
+  const t = l(), e = s(null);
+  return e.current || (e.current = S({
+    type: "spring",
+    bodyA: n.bodyA,
+    bodyB: n.bodyB,
+    stiffness: n.stiffness,
+    damping: n.damping,
+    anchorA: n.anchorA,
+    anchorB: n.anchorB,
+    length: n.length
+  })), u(() => {
+    const r = e.current;
+    return t.addConstraint(r), () => {
+      t.removeConstraint(r.id);
+    };
+  }, [t]), null;
+}
+function M(n) {
+  const t = l(), e = s(null);
+  return e.current || (e.current = v(n)), u(() => {
+    const r = e.current;
+    return t.addBody(r), () => {
+      t.removeBody(r.id);
+    };
+  }, [t]), e.current;
+}
+export {
+  I as Body,
+  B as PhysicsContext,
+  D as PhysicsScene,
+  q as Spring,
+  M as useBody,
+  l as usePhysics
+};

package/dist/svg-renderer-BOSG5i9F.js

@@ -0,0 +1,636 @@
+var O = Object.defineProperty;
+var N = (t, e, i) => e in t ? O(t, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : t[e] = i;
+var y = (t, e, i) => N(t, typeof e != "symbol" ? e + "" : e, i);
+function L(t = 0, e = 0) {
+  return { x: t, y: e };
+}
+function V() {
+  return { x: 0, y: 0 };
+}
+function d(t, e) {
+  return { x: t.x + e.x, y: t.y + e.y };
+}
+function S(t, e) {
+  return { x: t.x - e.x, y: t.y - e.y };
+}
+function g(t, e) {
+  return { x: t.x * e, y: t.y * e };
+}
+function _(t) {
+  return { x: -t.x, y: -t.y };
+}
+function X(t, e, i) {
+  return t.x = e.x + i.x, t.y = e.y + i.y, t;
+}
+function j(t, e, i) {
+  return t.x = e.x - i.x, t.y = e.y - i.y, t;
+}
+function Y(t, e, i) {
+  return t.x = e.x * i, t.y = e.y * i, t;
+}
+function C(t, e) {
+  return t.x += e.x, t.y += e.y, t;
+}
+function U(t, e) {
+  return t.x -= e.x, t.y -= e.y, t;
+}
+function $(t, e) {
+  return t.x *= e, t.y *= e, t;
+}
+function A(t, e) {
+  return t.x * e.x + t.y * e.y;
+}
+function H(t, e) {
+  return t.x * e.y - t.y * e.x;
+}
+function z(t, e) {
+  return { x: -t * e.y, y: t * e.x };
+}
+function Q(t, e) {
+  return { x: e * t.y, y: -e * t.x };
+}
+function P(t) {
+  return t.x * t.x + t.y * t.y;
+}
+function m(t) {
+  return Math.sqrt(t.x * t.x + t.y * t.y);
+}
+function R(t, e) {
+  const i = e.x - t.x, s = e.y - t.y;
+  return i * i + s * s;
+}
+function W(t, e) {
+  return Math.sqrt(R(t, e));
+}
+function Z(t) {
+  const e = m(t);
+  return e < 1e-10 ? { x: 0, y: 0 } : { x: t.x / e, y: t.y / e };
+}
+function G(t) {
+  const e = m(t);
+  return e < 1e-10 ? (t.x = 0, t.y = 0) : (t.x /= e, t.y /= e), t;
+}
+function J(t) {
+  return { x: -t.y, y: t.x };
+}
+function K(t) {
+  return { x: t.y, y: -t.x };
+}
+function F(t, e, i) {
+  return {
+    x: t.x + (e.x - t.x) * i,
+    y: t.y + (e.y - t.y) * i
+  };
+}
+function b(t, e) {
+  const i = P(t);
+  if (i > e * e) {
+    const s = Math.sqrt(i);
+    return { x: t.x / s * e, y: t.y / s * e };
+  }
+  return { x: t.x, y: t.y };
+}
+function tt(t, e) {
+  const i = A(e, e);
+  if (i < 1e-10) return { x: 0, y: 0 };
+  const s = A(t, e) / i;
+  return { x: e.x * s, y: e.y * s };
+}
+function et(t, e) {
+  const i = 2 * A(t, e);
+  return { x: t.x - i * e.x, y: t.y - i * e.y };
+}
+function it(t, e) {
+  return t.x = e.x, t.y = e.y, t;
+}
+function st(t) {
+  return { x: t.x, y: t.y };
+}
+function nt(t, e, i = 1e-6) {
+  return Math.abs(t.x - e.x) < i && Math.abs(t.y - e.y) < i;
+}
+function ot(t, e) {
+  const i = Math.cos(e), s = Math.sin(e);
+  return {
+    x: t.x * i - t.y * s,
+    y: t.x * s + t.y * i
+  };
+}
+const It = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  add: d,
+  addMut: X,
+  addTo: C,
+  approxEqual: nt,
+  clampLength: b,
+  clone: st,
+  copy: it,
+  cross: H,
+  crossSV: z,
+  crossVS: Q,
+  distance: W,
+  distanceSq: R,
+  dot: A,
+  length: m,
+  lengthSq: P,
+  lerp: F,
+  negate: _,
+  normalize: Z,
+  normalizeMut: G,
+  perpL: J,
+  perpR: K,
+  project: tt,
+  reflect: et,
+  rotate: ot,
+  scale: g,
+  scaleBy: $,
+  scaleMut: Y,
+  sub: S,
+  subFrom: U,
+  subMut: j,
+  vec2: L,
+  zero: V
+}, Symbol.toStringTag, { value: "Module" }));
+function rt(t, e) {
+  t.previousPosition.x = t.position.x, t.previousPosition.y = t.position.y, t.velocity.x += t.acceleration.x * e, t.velocity.y += t.acceleration.y * e, t.position.x += t.velocity.x * e, t.position.y += t.velocity.y * e, t.acceleration.x = 0, t.acceleration.y = 0;
+}
+function ct(t, e, i = 4) {
+  for (let s = 0; s < i; s++)
+    for (const r of t.values()) {
+      const o = e.get(r.bodyA), n = e.get(r.bodyB);
+      if (!(!o || !n))
+        switch (r.type) {
+          case "spring":
+            at(o, n, r);
+            break;
+          case "distance":
+            lt(o, n, r);
+            break;
+          case "pin":
+            ut(o, n, r);
+            break;
+        }
+    }
+}
+function at(t, e, i) {
+  const s = d(t.position, i.anchorA), r = d(e.position, i.anchorB), o = S(r, s), n = m(o);
+  if (n < 1e-10) return;
+  const a = g(o, 1 / n), c = i.length ?? n, u = n - c, l = S(e.velocity, t.velocity), h = A(l, a), p = i.stiffness * u + i.damping * h, f = g(a, p);
+  t.isStatic || (t.acceleration.x += f.x * t.invMass, t.acceleration.y += f.y * t.invMass), e.isStatic || (e.acceleration.x -= f.x * e.invMass, e.acceleration.y -= f.y * e.invMass);
+}
+function lt(t, e, i) {
+  const s = d(t.position, i.anchorA), r = d(e.position, i.anchorB), o = S(r, s), n = m(o);
+  if (n < 1e-10) return;
+  const a = i.length ?? 0, c = n - a, u = g(o, 1 / n), l = t.invMass + e.invMass;
+  if (l < 1e-10) return;
+  const h = i.stiffness;
+  if (!t.isStatic) {
+    const p = c * t.invMass * h / l;
+    t.position.x += u.x * p, t.position.y += u.y * p;
+  }
+  if (!e.isStatic) {
+    const p = c * e.invMass * h / l;
+    e.position.x -= u.x * p, e.position.y -= u.y * p;
+  }
+}
+function ut(t, e, i) {
+  const s = d(e.position, i.anchorB), r = d(t.position, i.anchorA), o = S(s, r), n = g(o, i.stiffness);
+  t.isStatic || (C(t.position, n), t.velocity.x += n.x * i.damping, t.velocity.y += n.y * i.damping);
+}
+function k(t, e) {
+  t.acceleration.x += e.x, t.acceleration.y += e.y;
+}
+function D(t, e) {
+  t.invMass <= 0 || (t.acceleration.x += -e * t.velocity.x * t.invMass, t.acceleration.y += -e * t.velocity.y * t.invMass);
+}
+function ht(t, e, i) {
+  t.invMass <= 0 || (t.acceleration.x += e.x * i * t.invMass, t.acceleration.y += e.y * i * t.invMass);
+}
+function pt(t, e, i, s = "quadratic") {
+  if (t.invMass <= 0) return;
+  const r = S(e, t.position), o = P(r), a = Math.max(o, 100), c = Math.sqrt(a), u = g(r, 1 / c);
+  let l;
+  switch (s) {
+    case "none":
+      l = i;
+      break;
+    case "linear":
+      l = i / c;
+      break;
+    case "quadratic":
+      l = i / a;
+      break;
+  }
+  t.acceleration.x += u.x * l * t.invMass, t.acceleration.y += u.y * l * t.invMass;
+}
+function ft(t, e, i) {
+  for (const s of e)
+    switch (s.type) {
+      case "gravity":
+        k(t, s.vector ?? i);
+        break;
+      case "drag":
+        D(t, s.strength ?? 0.01);
+        break;
+      case "wind":
+        s.vector && ht(t, s.vector, s.strength ?? 1);
+        break;
+      case "attraction":
+        s.vector && pt(t, s.vector, s.strength ?? 100, s.falloff ?? "quadratic");
+        break;
+    }
+}
+function yt(t) {
+  const e = [];
+  for (let i = 0; i < t.length; i++)
+    for (let s = i + 1; s < t.length; s++) {
+      const r = t[i], o = t[s];
+      if (r.isStatic && o.isStatic || r.isSleeping && o.isSleeping) continue;
+      const n = xt(r, o);
+      n && e.push(n);
+    }
+  return e;
+}
+function xt(t, e) {
+  const i = t.shape.type, s = e.shape.type;
+  if (i === "circle" && s === "circle")
+    return dt(t, e);
+  if (i === "circle" && s === "rect")
+    return I(t, e);
+  if (i === "rect" && s === "circle") {
+    const r = I(e, t);
+    return r ? {
+      bodyA: t.id,
+      bodyB: e.id,
+      normal: _(r.normal),
+      penetration: r.penetration,
+      overlap: _(r.overlap)
+    } : null;
+  }
+  return i === "rect" && s === "rect" ? gt(t, e) : null;
+}
+function dt(t, e) {
+  if (t.shape.type !== "circle" || e.shape.type !== "circle") return null;
+  const i = e.position.x - t.position.x, s = e.position.y - t.position.y, r = i * i + s * s, o = t.shape.radius + e.shape.radius;
+  if (r >= o * o) return null;
+  const n = Math.sqrt(r), a = n < 1e-10 ? { x: 0, y: 1 } : { x: i / n, y: s / n }, c = o - n;
+  return {
+    bodyA: t.id,
+    bodyB: e.id,
+    normal: a,
+    penetration: c,
+    overlap: g(a, c)
+  };
+}
+function I(t, e) {
+  if (t.shape.type !== "circle" || e.shape.type !== "rect") return null;
+  const i = e.shape.width / 2, s = e.shape.height / 2, r = t.position.x - e.position.x, o = t.position.y - e.position.y, n = Math.max(-i, Math.min(i, r)), a = Math.max(-s, Math.min(s, o)), c = r - n, u = o - a, l = c * c + u * u, h = t.shape.radius;
+  if (l >= h * h) return null;
+  const p = Math.sqrt(l);
+  let f, x;
+  if (p < 1e-10) {
+    const w = i - Math.abs(r), T = s - Math.abs(o);
+    w < T ? f = { x: r > 0 ? 1 : -1, y: 0 } : f = { x: 0, y: o > 0 ? 1 : -1 }, x = h + Math.min(w, T);
+  } else
+    f = { x: c / p, y: u / p }, x = h - p;
+  return {
+    bodyA: t.id,
+    bodyB: e.id,
+    normal: f,
+    penetration: x,
+    overlap: g(f, x)
+  };
+}
+function gt(t, e) {
+  if (t.shape.type !== "rect" || e.shape.type !== "rect") return null;
+  const i = t.shape.width / 2, s = t.shape.height / 2, r = e.shape.width / 2, o = e.shape.height / 2, n = e.position.x - t.position.x, a = e.position.y - t.position.y, c = i + r - Math.abs(n);
+  if (c <= 0) return null;
+  const u = s + o - Math.abs(a);
+  if (u <= 0) return null;
+  let l, h;
+  return c < u ? (l = { x: n > 0 ? 1 : -1, y: 0 }, h = c) : (l = { x: 0, y: a > 0 ? 1 : -1 }, h = u), {
+    bodyA: t.id,
+    bodyB: e.id,
+    normal: l,
+    penetration: h,
+    overlap: g(l, h)
+  };
+}
+const vt = 0.5, Mt = 0.4, St = 0.5;
+function mt(t, e, i) {
+  const { normal: s, penetration: r } = i, o = e.velocity.x - t.velocity.x, n = e.velocity.y - t.velocity.y, a = o * s.x + n * s.y;
+  if (a > 0) return;
+  let c = Math.min(t.restitution, e.restitution);
+  Math.abs(a) < St && (c = 0);
+  const u = t.invMass + e.invMass;
+  if (u < 1e-10) return;
+  const l = -(1 + c) * a / u;
+  t.velocity.x -= l * t.invMass * s.x, t.velocity.y -= l * t.invMass * s.y, e.velocity.x += l * e.invMass * s.x, e.velocity.y += l * e.invMass * s.y;
+  let h = o - a * s.x, p = n - a * s.y;
+  const f = Math.sqrt(h * h + p * p);
+  if (f > 1e-10) {
+    h /= f, p /= f;
+    const w = Math.sqrt(t.friction * e.friction);
+    let v = -(o * h + n * p) / u;
+    Math.abs(v) > Math.abs(l * w) && (v = l * w * Math.sign(v)), t.velocity.x -= v * t.invMass * h, t.velocity.y -= v * t.invMass * p, e.velocity.x += v * e.invMass * h, e.velocity.y += v * e.invMass * p;
+  }
+  const x = Math.max(r - vt, 0) * Mt / u;
+  t.position.x -= x * t.invMass * s.x, t.position.y -= x * t.invMass * s.y, e.position.x += x * e.invMass * s.x, e.position.y += x * e.invMass * s.y;
+}
+const wt = 0.5, At = 30;
+function Et(t) {
+  if (t.isStatic) return;
+  m(t.velocity) < wt ? (t.sleepTimer++, t.sleepTimer >= At && (t.isSleeping = !0, t.velocity.x = 0, t.velocity.y = 0)) : (t.sleepTimer = 0, t.isSleeping = !1);
+}
+function M(t) {
+  t.isSleeping = !1, t.sleepTimer = 0;
+}
+function Tt(t, e) {
+  t.isSleeping && !e.isSleeping && !e.isStatic && M(t), e.isSleeping && !t.isSleeping && !t.isStatic && M(e);
+}
+class Bt {
+  constructor(e) {
+    y(this, "bodies", /* @__PURE__ */ new Map());
+    y(this, "constraints", /* @__PURE__ */ new Map());
+    y(this, "forces", []);
+    y(this, "config");
+    this.config = e;
+  }
+  /**
+   * Advance the world by `dt` seconds.
+   *
+   * Pipeline per substep:
+   * 1. Apply forces (gravity, drag, custom force fields)
+   * 2. Integrate positions (semi-implicit Euler)
+   * 3. Solve constraints (spring, distance, pin)
+   * 4. Detect & resolve collisions
+   * 5. Enforce world bounds
+   * 6. Update sleep states
+   */
+  step(e) {
+    const i = e / this.config.substeps;
+    for (let s = 0; s < this.config.substeps; s++) {
+      for (const n of this.constraints.values()) {
+        const a = this.bodies.get(n.bodyA), c = this.bodies.get(n.bodyB);
+        a && !a.isStatic && a.isSleeping && M(a), c && !c.isStatic && c.isSleeping && M(c);
+      }
+      for (const n of this.bodies.values())
+        n.isStatic || n.isSleeping || (k(n, this.config.gravity), D(n, 0.01), this.forces.length > 0 && ft(n, this.forces, this.config.gravity));
+      for (const n of this.bodies.values())
+        n.isStatic || n.isSleeping || rt(n, i);
+      ct(
+        this.constraints,
+        this.bodies,
+        this.config.velocityIterations
+      );
+      const r = Array.from(this.bodies.values()), o = yt(r);
+      for (const n of o) {
+        const a = this.bodies.get(n.bodyA), c = this.bodies.get(n.bodyB);
+        a && c && (Tt(a, c), mt(a, c, n));
+      }
+      this.config.bounds && this.enforceBounds();
+      for (const n of this.bodies.values())
+        n.isStatic || Et(n);
+    }
+  }
+  /** Clamp bodies within configured world bounds. */
+  enforceBounds() {
+    const e = this.config.bounds;
+    if (e)
+      for (const i of this.bodies.values()) {
+        if (i.isStatic) continue;
+        let s = 0;
+        i.shape.type === "circle" ? s = i.shape.radius : i.shape.type === "rect" && (s = Math.max(i.shape.width, i.shape.height) / 2), i.position.x - s < e.min.x && (i.position.x = e.min.x + s, i.velocity.x = Math.abs(i.velocity.x) * i.restitution), i.position.x + s > e.max.x && (i.position.x = e.max.x - s, i.velocity.x = -Math.abs(i.velocity.x) * i.restitution), i.position.y - s < e.min.y && (i.position.y = e.min.y + s, i.velocity.y = Math.abs(i.velocity.y) * i.restitution), i.position.y + s > e.max.y && (i.position.y = e.max.y - s, i.velocity.y = -Math.abs(i.velocity.y) * i.restitution);
+      }
+  }
+  /** Add a force field. */
+  addForceField(e) {
+    this.forces.push(e);
+  }
+  /** Remove all force fields of a given type. */
+  removeForceFields(e) {
+    for (let i = this.forces.length - 1; i >= 0; i--)
+      this.forces[i].type === e && this.forces.splice(i, 1);
+  }
+}
+const E = 1 / 60, _t = 0.25;
+class qt {
+  // interpolation factor for rendering
+  constructor(e) {
+    y(this, "world");
+    y(this, "accumulator", 0);
+    y(this, "_alpha", 0);
+    this.world = new Bt(e);
+  }
+  // ---- Simulation ----------------------------------------------------------
+  /**
+   * Advance the simulation by `frameTime` seconds.
+   *
+   * Uses Glenn Fiedler's fixed-timestep-with-accumulator pattern:
+   * - Clamp frame time to prevent spiral of death
+   * - Step physics at fixed 60Hz intervals
+   * - Store interpolation alpha for smooth rendering
+   */
+  update(e) {
+    const i = Math.min(e, _t);
+    for (this.accumulator += i; this.accumulator >= E; )
+      this.world.step(E), this.accumulator -= E;
+    this._alpha = this.accumulator / E;
+  }
+  /**
+   * Get the interpolation alpha for the current frame.
+   *
+   * Use this to blend between previousPosition and position:
+   * renderPos = lerp(body.previousPosition, body.position, alpha)
+   */
+  get alpha() {
+    return this._alpha;
+  }
+  /**
+   * Get the interpolated render position for a body.
+   */
+  getInterpolatedPosition(e) {
+    return F(e.previousPosition, e.position, this._alpha);
+  }
+  // ---- Body Management -----------------------------------------------------
+  /** Register a body and return its id. */
+  addBody(e) {
+    return this.world.bodies.set(e.id, e), e.id;
+  }
+  /** Remove a body by id. */
+  removeBody(e) {
+    this.world.bodies.delete(e);
+  }
+  /** Look up a single body. */
+  getBody(e) {
+    return this.world.bodies.get(e);
+  }
+  /** Return every body currently in the world. */
+  getBodies() {
+    return Array.from(this.world.bodies.values());
+  }
+  /** Apply an instantaneous impulse to a body. */
+  applyImpulse(e, i) {
+    const s = this.world.bodies.get(e);
+    !s || s.isStatic || (M(s), s.velocity.x += i.x * s.invMass, s.velocity.y += i.y * s.invMass);
+  }
+  /** Set a body's position directly (teleport). */
+  setPosition(e, i) {
+    const s = this.world.bodies.get(e);
+    s && (M(s), s.position.x = i.x, s.position.y = i.y, s.previousPosition.x = i.x, s.previousPosition.y = i.y);
+  }
+  /** Set a body's velocity directly. */
+  setVelocity(e, i) {
+    const s = this.world.bodies.get(e);
+    !s || s.isStatic || (M(s), s.velocity.x = i.x, s.velocity.y = i.y);
+  }
+  // ---- Constraint Management -----------------------------------------------
+  /** Register a constraint and return its id. */
+  addConstraint(e) {
+    return this.world.constraints.set(e.id, e), e.id;
+  }
+  /** Remove a constraint by id. */
+  removeConstraint(e) {
+    this.world.constraints.delete(e);
+  }
+  /** Return every constraint currently in the world. */
+  getConstraints() {
+    return Array.from(this.world.constraints.values());
+  }
+  // ---- Force Fields --------------------------------------------------------
+  /** Add a force field to the world. */
+  addForceField(e) {
+    this.world.addForceField(e);
+  }
+  /** Remove all force fields of a given type. */
+  removeForceFields(e) {
+    this.world.removeForceFields(e);
+  }
+  // ---- Config --------------------------------------------------------------
+  /** Access the underlying world config. */
+  getConfig() {
+    return this.world.config;
+  }
+}
+const B = { x: 0, y: 0 }, Pt = { type: "circle", radius: 10 };
+function Ct(t = {}) {
+  const e = t.isStatic ?? !1, i = e ? 0 : t.mass ?? 1, s = t.position ?? { ...B };
+  return {
+    id: t.id ?? crypto.randomUUID(),
+    position: { ...s },
+    previousPosition: t.previousPosition ?? { ...s },
+    velocity: t.velocity ?? { ...B },
+    acceleration: t.acceleration ?? { ...B },
+    mass: i,
+    invMass: i > 0 ? 1 / i : 0,
+    restitution: t.restitution ?? 0.5,
+    friction: t.friction ?? 0.3,
+    isStatic: e,
+    isSleeping: t.isSleeping ?? !1,
+    sleepTimer: t.sleepTimer ?? 0,
+    shape: t.shape ?? { ...Pt },
+    userData: t.userData
+  };
+}
+const q = { x: 0, y: 0 };
+function Rt(t) {
+  return {
+    id: t.id ?? crypto.randomUUID(),
+    type: t.type ?? "spring",
+    bodyA: t.bodyA,
+    bodyB: t.bodyB,
+    anchorA: t.anchorA ?? { ...q },
+    anchorB: t.anchorB ?? { ...q },
+    stiffness: t.stiffness ?? 0.5,
+    damping: t.damping ?? 0.1,
+    length: t.length
+  };
+}
+class kt {
+  constructor() {
+    y(this, "svg", null);
+    y(this, "elementMap", /* @__PURE__ */ new Map());
+    y(this, "constraintMap", /* @__PURE__ */ new Map());
+    /** Interpolation alpha (0 = previous state, 1 = current state). */
+    y(this, "alpha", 1);
+  }
+  init(e) {
+    this.svg = document.createElementNS("http://www.w3.org/2000/svg", "svg"), this.svg.setAttribute("width", "100%"), this.svg.setAttribute("height", "100%"), this.svg.style.overflow = "visible", e.appendChild(this.svg);
+  }
+  render(e, i) {
+    this.svg && (this.renderConstraints(i, e), this.renderBodies(e));
+  }
+  destroy() {
+    var e;
+    (e = this.svg) == null || e.remove(), this.svg = null, this.elementMap.clear(), this.constraintMap.clear();
+  }
+  // ---- Body Rendering ------------------------------------------------------
+  renderBodies(e) {
+    const i = /* @__PURE__ */ new Set();
+    for (const s of e) {
+      i.add(s.id);
+      let r = this.elementMap.get(s.id);
+      r || (r = this.createElement(s), this.elementMap.set(s.id, r), this.svg.appendChild(r));
+      const o = this.interpolate(s);
+      r.setAttribute(
+        "transform",
+        `translate(${o.x}, ${o.y})`
+      ), r.setAttribute("opacity", s.isSleeping ? "0.5" : "1");
+    }
+    for (const [s, r] of this.elementMap)
+      i.has(s) || (r.remove(), this.elementMap.delete(s));
+  }
+  /** Interpolate between previous and current position. */
+  interpolate(e) {
+    return this.alpha >= 1 ? e.position : F(e.previousPosition, e.position, this.alpha);
+  }
+  /** Create the appropriate SVG element for a body's shape. */
+  createElement(e) {
+    const i = "http://www.w3.org/2000/svg";
+    switch (e.shape.type) {
+      case "circle": {
+        const s = document.createElementNS(i, "circle");
+        return s.setAttribute("r", String(e.shape.radius)), s.setAttribute("fill", "#6366f1"), s;
+      }
+      case "rect": {
+        const s = document.createElementNS(i, "rect");
+        return s.setAttribute("width", String(e.shape.width)), s.setAttribute("height", String(e.shape.height)), s.setAttribute("x", String(-e.shape.width / 2)), s.setAttribute("y", String(-e.shape.height / 2)), s.setAttribute("fill", "#6366f1"), s;
+      }
+      case "polygon": {
+        const s = document.createElementNS(i, "polygon"), r = e.shape.vertices.map((o) => `${o.x},${o.y}`).join(" ");
+        return s.setAttribute("points", r), s.setAttribute("fill", "#6366f1"), s;
+      }
+    }
+  }
+  // ---- Constraint Rendering ------------------------------------------------
+  renderConstraints(e, i) {
+    const s = new Map(i.map((o) => [o.id, o])), r = /* @__PURE__ */ new Set();
+    for (const o of e) {
+      const n = s.get(o.bodyA), a = s.get(o.bodyB);
+      if (!n || !a) continue;
+      r.add(o.id);
+      let c = this.constraintMap.get(o.id);
+      c || (c = document.createElementNS(
+        "http://www.w3.org/2000/svg",
+        "line"
+      ), c.setAttribute("stroke", "#94a3b8"), c.setAttribute("stroke-width", "1"), c.setAttribute("stroke-dasharray", "4 2"), this.constraintMap.set(o.id, c), this.svg.insertBefore(c, this.svg.firstChild));
+      const u = this.interpolate(n), l = this.interpolate(a), h = d(u, o.anchorA), p = d(l, o.anchorB);
+      c.setAttribute("x1", String(h.x)), c.setAttribute("y1", String(h.y)), c.setAttribute("x2", String(p.x)), c.setAttribute("y2", String(p.y));
+    }
+    for (const [o, n] of this.constraintMap)
+      r.has(o) || (n.remove(), this.constraintMap.delete(o));
+  }
+}
+export {
+  qt as P,
+  kt as S,
+  pt as a,
+  D as b,
+  ft as c,
+  k as d,
+  ht as e,
+  Ct as f,
+  Rt as g,
+  It as v,
+  M as w
+};

package/dist/svg-renderer-CiwhJO3-.cjs

@@ -0,0 +1 @@
+"use strict";var V=Object.defineProperty;var X=(t,e,i)=>e in t?V(t,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):t[e]=i;var y=(t,e,i)=>X(t,typeof e!="symbol"?e+"":e,i);function j(t=0,e=0){return{x:t,y:e}}function Y(){return{x:0,y:0}}function d(t,e){return{x:t.x+e.x,y:t.y+e.y}}function S(t,e){return{x:t.x-e.x,y:t.y-e.y}}function g(t,e){return{x:t.x*e,y:t.y*e}}function _(t){return{x:-t.x,y:-t.y}}function U(t,e,i){return t.x=e.x+i.x,t.y=e.y+i.y,t}function $(t,e,i){return t.x=e.x-i.x,t.y=e.y-i.y,t}function H(t,e,i){return t.x=e.x*i,t.y=e.y*i,t}function k(t,e){return t.x+=e.x,t.y+=e.y,t}function z(t,e){return t.x-=e.x,t.y-=e.y,t}function W(t,e){return t.x*=e,t.y*=e,t}function A(t,e){return t.x*e.x+t.y*e.y}function G(t,e){return t.x*e.y-t.y*e.x}function Q(t,e){return{x:-t*e.y,y:t*e.x}}function Z(t,e){return{x:e*t.y,y:-e*t.x}}function F(t){return t.x*t.x+t.y*t.y}function m(t){return Math.sqrt(t.x*t.x+t.y*t.y)}function D(t,e){const i=e.x-t.x,s=e.y-t.y;return i*i+s*s}function J(t,e){return Math.sqrt(D(t,e))}function K(t){const e=m(t);return e<1e-10?{x:0,y:0}:{x:t.x/e,y:t.y/e}}function b(t){const e=m(t);return e<1e-10?(t.x=0,t.y=0):(t.x/=e,t.y/=e),t}function tt(t){return{x:-t.y,y:t.x}}function et(t){return{x:t.y,y:-t.x}}function P(t,e,i){return{x:t.x+(e.x-t.x)*i,y:t.y+(e.y-t.y)*i}}function it(t,e){const i=F(t);if(i>e*e){const s=Math.sqrt(i);return{x:t.x/s*e,y:t.y/s*e}}return{x:t.x,y:t.y}}function st(t,e){const i=A(e,e);if(i<1e-10)return{x:0,y:0};const s=A(t,e)/i;return{x:e.x*s,y:e.y*s}}function nt(t,e){const i=2*A(t,e);return{x:t.x-i*e.x,y:t.y-i*e.y}}function ot(t,e){return t.x=e.x,t.y=e.y,t}function rt(t){return{x:t.x,y:t.y}}function ct(t,e,i=1e-6){return Math.abs(t.x-e.x)<i&&Math.abs(t.y-e.y)<i}function at(t,e){const i=Math.cos(e),s=Math.sin(e);return{x:t.x*i-t.y*s,y:t.x*s+t.y*i}}const lt=Object.freeze(Object.defineProperty({__proto__:null,add:d,addMut:U,addTo:k,approxEqual:ct,clampLength:it,clone:rt,copy:ot,cross:G,crossSV:Q,crossVS:Z,distance:J,distanceSq:D,dot:A,length:m,lengthSq:F,lerp:P,negate:_,normalize:K,normalizeMut:b,perpL:tt,perpR:et,project:st,reflect:nt,rotate:at,scale:g,scaleBy:W,scaleMut:H,sub:S,subFrom:z,subMut:$,vec2:j,zero:Y},Symbol.toStringTag,{value:"Module"}));function ut(t,e){t.previousPosition.x=t.position.x,t.previousPosition.y=t.position.y,t.velocity.x+=t.acceleration.x*e,t.velocity.y+=t.acceleration.y*e,t.position.x+=t.velocity.x*e,t.position.y+=t.velocity.y*e,t.acceleration.x=0,t.acceleration.y=0}function ht(t,e,i=4){for(let s=0;s<i;s++)for(const r of t.values()){const o=e.get(r.bodyA),n=e.get(r.bodyB);if(!(!o||!n))switch(r.type){case"spring":pt(o,n,r);break;case"distance":ft(o,n,r);break;case"pin":yt(o,n,r);break}}}function pt(t,e,i){const s=d(t.position,i.anchorA),r=d(e.position,i.anchorB),o=S(r,s),n=m(o);if(n<1e-10)return;const a=g(o,1/n),c=i.length??n,u=n-c,l=S(e.velocity,t.velocity),h=A(l,a),p=i.stiffness*u+i.damping*h,f=g(a,p);t.isStatic||(t.acceleration.x+=f.x*t.invMass,t.acceleration.y+=f.y*t.invMass),e.isStatic||(e.acceleration.x-=f.x*e.invMass,e.acceleration.y-=f.y*e.invMass)}function ft(t,e,i){const s=d(t.position,i.anchorA),r=d(e.position,i.anchorB),o=S(r,s),n=m(o);if(n<1e-10)return;const a=i.length??0,c=n-a,u=g(o,1/n),l=t.invMass+e.invMass;if(l<1e-10)return;const h=i.stiffness;if(!t.isStatic){const p=c*t.invMass*h/l;t.position.x+=u.x*p,t.position.y+=u.y*p}if(!e.isStatic){const p=c*e.invMass*h/l;e.position.x-=u.x*p,e.position.y-=u.y*p}}function yt(t,e,i){const s=d(e.position,i.anchorB),r=d(t.position,i.anchorA),o=S(s,r),n=g(o,i.stiffness);t.isStatic||(k(t.position,n),t.velocity.x+=n.x*i.damping,t.velocity.y+=n.y*i.damping)}function C(t,e){t.acceleration.x+=e.x,t.acceleration.y+=e.y}function I(t,e){t.invMass<=0||(t.acceleration.x+=-e*t.velocity.x*t.invMass,t.acceleration.y+=-e*t.velocity.y*t.invMass)}function O(t,e,i){t.invMass<=0||(t.acceleration.x+=e.x*i*t.invMass,t.acceleration.y+=e.y*i*t.invMass)}function N(t,e,i,s="quadratic"){if(t.invMass<=0)return;const r=S(e,t.position),o=F(r),a=Math.max(o,100),c=Math.sqrt(a),u=g(r,1/c);let l;switch(s){case"none":l=i;break;case"linear":l=i/c;break;case"quadratic":l=i/a;break}t.acceleration.x+=u.x*l*t.invMass,t.acceleration.y+=u.y*l*t.invMass}function L(t,e,i){for(const s of e)switch(s.type){case"gravity":C(t,s.vector??i);break;case"drag":I(t,s.strength??.01);break;case"wind":s.vector&&O(t,s.vector,s.strength??1);break;case"attraction":s.vector&&N(t,s.vector,s.strength??100,s.falloff??"quadratic");break}}function xt(t){const e=[];for(let i=0;i<t.length;i++)for(let s=i+1;s<t.length;s++){const r=t[i],o=t[s];if(r.isStatic&&o.isStatic||r.isSleeping&&o.isSleeping)continue;const n=dt(r,o);n&&e.push(n)}return e}function dt(t,e){const i=t.shape.type,s=e.shape.type;if(i==="circle"&&s==="circle")return gt(t,e);if(i==="circle"&&s==="rect")return q(t,e);if(i==="rect"&&s==="circle"){const r=q(e,t);return r?{bodyA:t.id,bodyB:e.id,normal:_(r.normal),penetration:r.penetration,overlap:_(r.overlap)}:null}return i==="rect"&&s==="rect"?vt(t,e):null}function gt(t,e){if(t.shape.type!=="circle"||e.shape.type!=="circle")return null;const i=e.position.x-t.position.x,s=e.position.y-t.position.y,r=i*i+s*s,o=t.shape.radius+e.shape.radius;if(r>=o*o)return null;const n=Math.sqrt(r),a=n<1e-10?{x:0,y:1}:{x:i/n,y:s/n},c=o-n;return{bodyA:t.id,bodyB:e.id,normal:a,penetration:c,overlap:g(a,c)}}function q(t,e){if(t.shape.type!=="circle"||e.shape.type!=="rect")return null;const i=e.shape.width/2,s=e.shape.height/2,r=t.position.x-e.position.x,o=t.position.y-e.position.y,n=Math.max(-i,Math.min(i,r)),a=Math.max(-s,Math.min(s,o)),c=r-n,u=o-a,l=c*c+u*u,h=t.shape.radius;if(l>=h*h)return null;const p=Math.sqrt(l);let f,x;if(p<1e-10){const w=i-Math.abs(r),B=s-Math.abs(o);w<B?f={x:r>0?1:-1,y:0}:f={x:0,y:o>0?1:-1},x=h+Math.min(w,B)}else f={x:c/p,y:u/p},x=h-p;return{bodyA:t.id,bodyB:e.id,normal:f,penetration:x,overlap:g(f,x)}}function vt(t,e){if(t.shape.type!=="rect"||e.shape.type!=="rect")return null;const i=t.shape.width/2,s=t.shape.height/2,r=e.shape.width/2,o=e.shape.height/2,n=e.position.x-t.position.x,a=e.position.y-t.position.y,c=i+r-Math.abs(n);if(c<=0)return null;const u=s+o-Math.abs(a);if(u<=0)return null;let l,h;return c<u?(l={x:n>0?1:-1,y:0},h=c):(l={x:0,y:a>0?1:-1},h=u),{bodyA:t.id,bodyB:e.id,normal:l,penetration:h,overlap:g(l,h)}}const Mt=.5,St=.4,mt=.5;function wt(t,e,i){const{normal:s,penetration:r}=i,o=e.velocity.x-t.velocity.x,n=e.velocity.y-t.velocity.y,a=o*s.x+n*s.y;if(a>0)return;let c=Math.min(t.restitution,e.restitution);Math.abs(a)<mt&&(c=0);const u=t.invMass+e.invMass;if(u<1e-10)return;const l=-(1+c)*a/u;t.velocity.x-=l*t.invMass*s.x,t.velocity.y-=l*t.invMass*s.y,e.velocity.x+=l*e.invMass*s.x,e.velocity.y+=l*e.invMass*s.y;let h=o-a*s.x,p=n-a*s.y;const f=Math.sqrt(h*h+p*p);if(f>1e-10){h/=f,p/=f;const w=Math.sqrt(t.friction*e.friction);let M=-(o*h+n*p)/u;Math.abs(M)>Math.abs(l*w)&&(M=l*w*Math.sign(M)),t.velocity.x-=M*t.invMass*h,t.velocity.y-=M*t.invMass*p,e.velocity.x+=M*e.invMass*h,e.velocity.y+=M*e.invMass*p}const x=Math.max(r-Mt,0)*St/u;t.position.x-=x*t.invMass*s.x,t.position.y-=x*t.invMass*s.y,e.position.x+=x*e.invMass*s.x,e.position.y+=x*e.invMass*s.y}const At=.5,Et=30;function Bt(t){if(t.isStatic)return;m(t.velocity)<At?(t.sleepTimer++,t.sleepTimer>=Et&&(t.isSleeping=!0,t.velocity.x=0,t.velocity.y=0)):(t.sleepTimer=0,t.isSleeping=!1)}function v(t){t.isSleeping=!1,t.sleepTimer=0}function Tt(t,e){t.isSleeping&&!e.isSleeping&&!e.isStatic&&v(t),e.isSleeping&&!t.isSleeping&&!t.isStatic&&v(e)}class _t{constructor(e){y(this,"bodies",new Map);y(this,"constraints",new Map);y(this,"forces",[]);y(this,"config");this.config=e}step(e){const i=e/this.config.substeps;for(let s=0;s<this.config.substeps;s++){for(const n of this.constraints.values()){const a=this.bodies.get(n.bodyA),c=this.bodies.get(n.bodyB);a&&!a.isStatic&&a.isSleeping&&v(a),c&&!c.isStatic&&c.isSleeping&&v(c)}for(const n of this.bodies.values())n.isStatic||n.isSleeping||(C(n,this.config.gravity),I(n,.01),this.forces.length>0&&L(n,this.forces,this.config.gravity));for(const n of this.bodies.values())n.isStatic||n.isSleeping||ut(n,i);ht(this.constraints,this.bodies,this.config.velocityIterations);const r=Array.from(this.bodies.values()),o=xt(r);for(const n of o){const a=this.bodies.get(n.bodyA),c=this.bodies.get(n.bodyB);a&&c&&(Tt(a,c),wt(a,c,n))}this.config.bounds&&this.enforceBounds();for(const n of this.bodies.values())n.isStatic||Bt(n)}}enforceBounds(){const e=this.config.bounds;if(e)for(const i of this.bodies.values()){if(i.isStatic)continue;let s=0;i.shape.type==="circle"?s=i.shape.radius:i.shape.type==="rect"&&(s=Math.max(i.shape.width,i.shape.height)/2),i.position.x-s<e.min.x&&(i.position.x=e.min.x+s,i.velocity.x=Math.abs(i.velocity.x)*i.restitution),i.position.x+s>e.max.x&&(i.position.x=e.max.x-s,i.velocity.x=-Math.abs(i.velocity.x)*i.restitution),i.position.y-s<e.min.y&&(i.position.y=e.min.y+s,i.velocity.y=Math.abs(i.velocity.y)*i.restitution),i.position.y+s>e.max.y&&(i.position.y=e.max.y-s,i.velocity.y=-Math.abs(i.velocity.y)*i.restitution)}}addForceField(e){this.forces.push(e)}removeForceFields(e){for(let i=this.forces.length-1;i>=0;i--)this.forces[i].type===e&&this.forces.splice(i,1)}}const E=1/60,Ft=.25;class Pt{constructor(e){y(this,"world");y(this,"accumulator",0);y(this,"_alpha",0);this.world=new _t(e)}update(e){const i=Math.min(e,Ft);for(this.accumulator+=i;this.accumulator>=E;)this.world.step(E),this.accumulator-=E;this._alpha=this.accumulator/E}get alpha(){return this._alpha}getInterpolatedPosition(e){return P(e.previousPosition,e.position,this._alpha)}addBody(e){return this.world.bodies.set(e.id,e),e.id}removeBody(e){this.world.bodies.delete(e)}getBody(e){return this.world.bodies.get(e)}getBodies(){return Array.from(this.world.bodies.values())}applyImpulse(e,i){const s=this.world.bodies.get(e);!s||s.isStatic||(v(s),s.velocity.x+=i.x*s.invMass,s.velocity.y+=i.y*s.invMass)}setPosition(e,i){const s=this.world.bodies.get(e);s&&(v(s),s.position.x=i.x,s.position.y=i.y,s.previousPosition.x=i.x,s.previousPosition.y=i.y)}setVelocity(e,i){const s=this.world.bodies.get(e);!s||s.isStatic||(v(s),s.velocity.x=i.x,s.velocity.y=i.y)}addConstraint(e){return this.world.constraints.set(e.id,e),e.id}removeConstraint(e){this.world.constraints.delete(e)}getConstraints(){return Array.from(this.world.constraints.values())}addForceField(e){this.world.addForceField(e)}removeForceFields(e){this.world.removeForceFields(e)}getConfig(){return this.world.config}}const T={x:0,y:0},Ct={type:"circle",radius:10};function It(t={}){const e=t.isStatic??!1,i=e?0:t.mass??1,s=t.position??{...T};return{id:t.id??crypto.randomUUID(),position:{...s},previousPosition:t.previousPosition??{...s},velocity:t.velocity??{...T},acceleration:t.acceleration??{...T},mass:i,invMass:i>0?1/i:0,restitution:t.restitution??.5,friction:t.friction??.3,isStatic:e,isSleeping:t.isSleeping??!1,sleepTimer:t.sleepTimer??0,shape:t.shape??{...Ct},userData:t.userData}}const R={x:0,y:0};function qt(t){return{id:t.id??crypto.randomUUID(),type:t.type??"spring",bodyA:t.bodyA,bodyB:t.bodyB,anchorA:t.anchorA??{...R},anchorB:t.anchorB??{...R},stiffness:t.stiffness??.5,damping:t.damping??.1,length:t.length}}class Rt{constructor(){y(this,"svg",null);y(this,"elementMap",new Map);y(this,"constraintMap",new Map);y(this,"alpha",1)}init(e){this.svg=document.createElementNS("http://www.w3.org/2000/svg","svg"),this.svg.setAttribute("width","100%"),this.svg.setAttribute("height","100%"),this.svg.style.overflow="visible",e.appendChild(this.svg)}render(e,i){this.svg&&(this.renderConstraints(i,e),this.renderBodies(e))}destroy(){var e;(e=this.svg)==null||e.remove(),this.svg=null,this.elementMap.clear(),this.constraintMap.clear()}renderBodies(e){const i=new Set;for(const s of e){i.add(s.id);let r=this.elementMap.get(s.id);r||(r=this.createElement(s),this.elementMap.set(s.id,r),this.svg.appendChild(r));const o=this.interpolate(s);r.setAttribute("transform",`translate(${o.x}, ${o.y})`),r.setAttribute("opacity",s.isSleeping?"0.5":"1")}for(const[s,r]of this.elementMap)i.has(s)||(r.remove(),this.elementMap.delete(s))}interpolate(e){return this.alpha>=1?e.position:P(e.previousPosition,e.position,this.alpha)}createElement(e){const i="http://www.w3.org/2000/svg";switch(e.shape.type){case"circle":{const s=document.createElementNS(i,"circle");return s.setAttribute("r",String(e.shape.radius)),s.setAttribute("fill","#6366f1"),s}case"rect":{const s=document.createElementNS(i,"rect");return s.setAttribute("width",String(e.shape.width)),s.setAttribute("height",String(e.shape.height)),s.setAttribute("x",String(-e.shape.width/2)),s.setAttribute("y",String(-e.shape.height/2)),s.setAttribute("fill","#6366f1"),s}case"polygon":{const s=document.createElementNS(i,"polygon"),r=e.shape.vertices.map(o=>`${o.x},${o.y}`).join(" ");return s.setAttribute("points",r),s.setAttribute("fill","#6366f1"),s}}}renderConstraints(e,i){const s=new Map(i.map(o=>[o.id,o])),r=new Set;for(const o of e){const n=s.get(o.bodyA),a=s.get(o.bodyB);if(!n||!a)continue;r.add(o.id);let c=this.constraintMap.get(o.id);c||(c=document.createElementNS("http://www.w3.org/2000/svg","line"),c.setAttribute("stroke","#94a3b8"),c.setAttribute("stroke-width","1"),c.setAttribute("stroke-dasharray","4 2"),this.constraintMap.set(o.id,c),this.svg.insertBefore(c,this.svg.firstChild));const u=this.interpolate(n),l=this.interpolate(a),h=d(u,o.anchorA),p=d(l,o.anchorB);c.setAttribute("x1",String(h.x)),c.setAttribute("y1",String(h.y)),c.setAttribute("x2",String(p.x)),c.setAttribute("y2",String(p.y))}for(const[o,n]of this.constraintMap)r.has(o)||(n.remove(),this.constraintMap.delete(o))}}exports.PhysicsEngine=Pt;exports.SvgRenderer=Rt;exports.applyAttraction=N;exports.applyDrag=I;exports.applyForceFields=L;exports.applyGravity=C;exports.applyWind=O;exports.createBody=It;exports.createConstraint=qt;exports.vec2=lt;exports.wakeBody=v;

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@mcptoolshop/physics-svg",
+  "version": "0.1.0",
+  "description": "Deterministic 2D physics engine with SVG rendering for web games and simulations",
+  "type": "module",
+  "license": "MIT",
+  "author": "MCP Tool Shop",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcp-tool-shop-org/siege-kit.git",
+    "directory": "packages/physics-svg"
+  },
+  "homepage": "https://github.com/mcp-tool-shop-org/siege-kit/tree/main/packages/physics-svg#readme",
+  "bugs": {
+    "url": "https://github.com/mcp-tool-shop-org/siege-kit/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "gsap": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "gsap": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0",
+    "@types/react-dom": "^19.0",
+    "@vitejs/plugin-react": "^4.4",
+    "react": "^19.0",
+    "react-dom": "^19.0",
+    "gsap": "^3.12",
+    "vite": "^6.2",
+    "vite-plugin-dts": "^4.5",
+    "vitest": "^3.0",
+    "typescript": "^5.7",
+    "@mcp-tool-shop/siege-types": "0.1.0",
+    "@mcp-tool-shop/tsconfig": "0.1.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}