@animatter/react 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alanshown
+
+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/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# @animatter/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional React lifecycle hooks for the shared Animatter runtime. Peer dependencies: React >=18 and animatter ^0.1.0. Version 0.1.0 is available on npm.
+
+useAnimatter returns {ref,world}; useSurface registers a ref and cleans up on unmount. Keep surface option objects stable. World options are captured on mount; configure the world for live changes.
+
+[Usage and tests](https://github.com/Alanshown/Animatter.js/blob/main/README.md#framework-integrations). MIT.

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+import { type ReactNode, type RefObject } from "react";
+import { createWorld, type AnimatterWorld, type Interaction, type PresetInput, type SurfaceOptions, type WorldOptions } from "animatter";
+export interface PhysicsProviderProps {
+    children?: ReactNode;
+    /** Root element the world scans and listens on. Defaults to document.body inside the browser. */
+    root?: () => HTMLElement;
+    options?: Omit<WorldOptions, "root">;
+}
+/**
+ * Creates one world per provider instance. The world is created inside an effect, so importing this module
+ * never touches the DOM, and StrictMode's double effect invocation destroys the first world cleanly.
+ */
+export declare function PhysicsProvider({ children, root, options }: PhysicsProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<AnimatterWorld | null>>;
+/** Returns the shared world from the nearest PhysicsProvider, or null until it has mounted. */
+export declare function usePhysicsWorld(): AnimatterWorld | null;
+/** Stable identity for preset lists. Presets are plain definitions, so name plus options identifies them. */
+export declare function presetKey(presets: PresetInput | undefined): string;
+/**
+ * Applies presets to the element referenced by the returned ref. Changing the preset list updates the
+ * existing handle when possible; the surface itself is never re-registered.
+ */
+export declare function useEnhance<T extends HTMLElement>(presets: PresetInput | undefined, disabled?: boolean): RefObject<T | null>;
+export interface PhysicsSurfaceOptions extends SurfaceOptions {
+    presets?: PresetInput;
+    onInteraction?: (event: Interaction) => void;
+}
+/**
+ * Registers an element as a surface and optionally enhances it. Registration depends only on world and id.
+ * Material, mode and draggable changes go through world.configure. Preset changes go through the enhancement handle.
+ */
+export declare function usePhysicsSurface<T extends HTMLElement>(options?: PhysicsSurfaceOptions): RefObject<T | null>;
+/** Shorthand for a magnetic pull toward the pointer. */
+export declare function useMagnetic<T extends HTMLElement>(options?: {
+    strength?: number;
+    radius?: number;
+    disabled?: boolean;
+}): RefObject<T | null>;
+/** Shorthand for an elastic spring response. */
+export declare function useSpring<T extends HTMLElement>(options?: {
+    stiffness?: number;
+    damping?: number;
+    disabled?: boolean;
+}): RefObject<T | null>;
+/** Draggable surface with damping feedback while dragging. */
+export declare function usePhysicsDrag<T extends HTMLElement>(options?: {
+    disabled?: boolean;
+}): RefObject<T | null>;
+export interface PhysicsSurfaceProps extends Omit<PhysicsSurfaceOptions, "id"> {
+    children?: ReactNode;
+    className?: string;
+    style?: Record<string, string | number>;
+    tag?: "div" | "span" | "button";
+}
+/** Declarative wrapper: renders a tag whose element is registered and enhanced by the nearest provider. */
+export declare function PhysicsSurface({ children, className, style, tag, ...options }: PhysicsSurfaceProps): import("react").DetailedReactHTMLElement<{
+    ref: RefObject<HTMLElement | null>;
+    className: string | undefined;
+    style: Record<string, string | number> | undefined;
+}, HTMLElement>;
+export { createWorld };
+export type { AnimatterWorld, PresetInput, SurfaceOptions, WorldOptions } from "animatter";
+/** v0.1 compatibility: creates a world bound to a ref'd div. Options are captured on mount. */
+export declare function useAnimatter(options?: Omit<WorldOptions, "root">): {
+    ref: RefObject<HTMLDivElement | null>;
+    world: AnimatterWorld | null;
+};
+/**
+ * v0.1 compatibility: registers the ref'd element with the given world. Registration depends on the world
+ * only; inline option objects no longer cause re-registration on every render.
+ */
+export declare function useSurface<T extends HTMLElement>(world: AnimatterWorld | null, options?: SurfaceOptions): RefObject<T | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,188 @@
+import { createContext, createElement, useContext, useEffect, useId, useRef, useState, } from "react";
+import { createWorld, presets as builtinPresets, } from "animatter";
+const WorldContext = createContext(null);
+/**
+ * Creates one world per provider instance. The world is created inside an effect, so importing this module
+ * never touches the DOM, and StrictMode's double effect invocation destroys the first world cleanly.
+ */
+export function PhysicsProvider({ children, root, options }) {
+    const [world, setWorld] = useState(null);
+    const initial = useRef({ root, options });
+    useEffect(() => {
+        const { root: resolveRoot, options: worldOptions } = initial.current;
+        const instance = createWorld({ ...worldOptions, root: resolveRoot?.() ?? document.body });
+        setWorld(instance);
+        return () => {
+            instance.destroy();
+            setWorld(null);
+        };
+    }, []);
+    return createElement(WorldContext.Provider, { value: world }, children);
+}
+/** Returns the shared world from the nearest PhysicsProvider, or null until it has mounted. */
+export function usePhysicsWorld() {
+    return useContext(WorldContext);
+}
+/** Stable identity for preset lists. Presets are plain definitions, so name plus options identifies them. */
+export function presetKey(presets) {
+    if (!presets)
+        return "";
+    const list = Array.isArray(presets) ? presets : [presets];
+    return list.map((p) => `${p.name}:${JSON.stringify(p.options)}`).join("|");
+}
+/**
+ * Applies presets to the element referenced by the returned ref. Changing the preset list updates the
+ * existing handle when possible; the surface itself is never re-registered.
+ */
+export function useEnhance(presets, disabled = false) {
+    const world = usePhysicsWorld();
+    const ref = useRef(null);
+    const handleRef = useRef(null);
+    const disabledRef = useRef(disabled);
+    disabledRef.current = disabled;
+    const presetsRef = useRef(presets);
+    presetsRef.current = presets;
+    const key = presetKey(presets);
+    useEffect(() => {
+        const list = presetsRef.current;
+        if (!world || !ref.current || !list)
+            return;
+        const handle = world.enhance(ref.current, list);
+        handleRef.current = handle;
+        if (disabledRef.current)
+            handle.disable();
+        return () => {
+            handle.destroy();
+            if (handleRef.current === handle)
+                handleRef.current = null;
+        };
+        // The preset key identifies the list; the element and world identify the surface.
+    }, [world, key]);
+    useEffect(() => {
+        const handle = handleRef.current;
+        if (!handle)
+            return;
+        if (disabled)
+            handle.disable();
+        else
+            handle.enable();
+    }, [disabled, world, key]);
+    return ref;
+}
+/**
+ * Registers an element as a surface and optionally enhances it. Registration depends only on world and id.
+ * Material, mode and draggable changes go through world.configure. Preset changes go through the enhancement handle.
+ */
+export function usePhysicsSurface(options = {}) {
+    const world = usePhysicsWorld();
+    const generated = useId();
+    const id = options.id ?? `react-${generated}`;
+    const ref = useRef(null);
+    const latest = useRef(options);
+    latest.current = options;
+    const config = JSON.stringify({
+        mode: options.mode,
+        material: options.material,
+        draggable: options.draggable ?? false,
+        collision: options.collision ?? false,
+        disabled: options.disabled ?? false,
+    });
+    useEffect(() => {
+        if (!world || !ref.current)
+            return;
+        const { presets: _p, onInteraction: _o, ...surface } = latest.current;
+        void _p;
+        void _o;
+        return world.register(ref.current, { ...surface, id });
+    }, [world, id]);
+    useEffect(() => {
+        if (!world || !world.spatial.surfaces.has(id))
+            return;
+        const parsed = JSON.parse(config);
+        const patch = {
+            draggable: parsed.draggable,
+            collision: parsed.collision,
+            disabled: parsed.disabled,
+            ...(parsed.mode !== undefined ? { mode: parsed.mode } : {}),
+            ...(parsed.material !== undefined ? { material: parsed.material } : {}),
+        };
+        world.configure(id, patch);
+    }, [world, id, config]);
+    useEffect(() => {
+        if (!world)
+            return;
+        return world.on((event) => {
+            if (event.target !== id)
+                return;
+            latest.current.onInteraction?.(event);
+        });
+    }, [world, id]);
+    useEnhance(options.presets, options.disabled ?? false);
+    return ref;
+}
+/** Shorthand for a magnetic pull toward the pointer. */
+export function useMagnetic(options = {}) {
+    const { strength, radius, disabled } = options;
+    return usePhysicsSurface({
+        presets: builtinPresets.magnetic({
+            ...(strength !== undefined ? { strength } : {}),
+            ...(radius !== undefined ? { radius } : {}),
+        }),
+        disabled: disabled ?? false,
+    });
+}
+/** Shorthand for an elastic spring response. */
+export function useSpring(options = {}) {
+    const { stiffness, damping, disabled } = options;
+    return usePhysicsSurface({
+        presets: builtinPresets.elastic({
+            ...(stiffness !== undefined ? { stiffness } : {}),
+            ...(damping !== undefined ? { damping } : {}),
+        }),
+        disabled: disabled ?? false,
+    });
+}
+/** Draggable surface with damping feedback while dragging. */
+export function usePhysicsDrag(options = {}) {
+    return usePhysicsSurface({
+        draggable: true,
+        presets: builtinPresets.dragFeedback(),
+        disabled: options.disabled ?? false,
+    });
+}
+/** Declarative wrapper: renders a tag whose element is registered and enhanced by the nearest provider. */
+export function PhysicsSurface({ children, className, style, tag = "div", ...options }) {
+    const ref = usePhysicsSurface(options);
+    return createElement(tag, { ref, className, style }, children);
+}
+export { createWorld };
+/** v0.1 compatibility: creates a world bound to a ref'd div. Options are captured on mount. */
+export function useAnimatter(options = {}) {
+    const ref = useRef(null), initial = useRef(options);
+    const [world, setWorld] = useState(null);
+    useEffect(() => {
+        if (!ref.current)
+            return;
+        const instance = createWorld({ ...initial.current, root: ref.current });
+        setWorld(instance);
+        return () => {
+            instance.destroy();
+        };
+    }, []);
+    return { ref, world };
+}
+/**
+ * v0.1 compatibility: registers the ref'd element with the given world. Registration depends on the world
+ * only; inline option objects no longer cause re-registration on every render.
+ */
+export function useSurface(world, options = {}) {
+    const ref = useRef(null);
+    const latest = useRef(options);
+    latest.current = options;
+    useEffect(() => {
+        if (world && ref.current)
+            return world.register(ref.current, latest.current);
+    }, [world]);
+    return ref;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@animatter/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "animatter": "^0.2.0",
+    "react": ">=18"
+  },
+  "description": "React lifecycle hooks for the shared Animatter.js physics interaction runtime",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alanshown/Animatter.js.git",
+    "directory": "packages/react"
+  },
+  "homepage": "https://github.com/Alanshown/Animatter.js#readme",
+  "bugs": {
+    "url": "https://github.com/Alanshown/Animatter.js/issues"
+  },
+  "author": "Alanshown",
+  "keywords": [
+    "physics",
+    "interaction",
+    "animation",
+    "typescript",
+    "web",
+    "react"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}