@fundamental-engine/react 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Shallbetter
+
+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

@@ -0,0 +1,139 @@
+# @fundamental-engine/react
+
+**The React adapter for [`@fundamental-engine/core`](../core)** — a reciprocal DOM-physics field as a React
+component. Elements you mark with `data-body` become forces; the single background field reacts to
+them, and its density reacts back. You author meaning in JSX (`data-*` in); the field returns
+measurement (`--field-*` CSS variables out).
+
+→ Live manual, Lab, and gallery at **[fundamental-engine.com](https://fundamental-engine.com)**.
+
+## Install
+
+```sh
+npm i @fundamental-engine/react
+```
+
+React (17, 18, or 19) is a **peer dependency** — the core engine itself stays zero-dependency.
+
+## Use
+
+```tsx
+import { FieldField } from '@fundamental-engine/react';
+
+export function App() {
+  return (
+    <>
+      <FieldField accent="#4da3ff" />
+      <a data-body="attract" data-strength="0.9" data-range="320" data-feedback>
+        pull me
+      </a>
+    </>
+  );
+}
+```
+
+`<FieldField>` mounts a fixed, full-viewport canvas behind your app and runs the engine on it — the
+same field the `<field-root>` custom element and vanilla `mountField()` wrap. The field reacts to every
+`[data-body]` element on the page (the *field-reacts* law), so the bodies do not need to be children of
+`<FieldField>`.
+
+## Props
+
+`<FieldField>` accepts every [`FieldOptions`](../core) value plus React conveniences:
+
+| Prop | Type | What it does |
+|---|---|---|
+| `accent` | `string` | base hue for the field (any CSS color) |
+| `density` | `number` | particle density multiplier |
+| `render` | `'dots' \| 'trails' \| 'links' \| 'metaballs' \| 'voronoi' \| 'streamlines'` | underlay render method |
+| `palette` | `string \| string[]` | named palette (`ours`, `heatmap`, `infrared`, `spectrum`) or explicit colors |
+| `waves` | `boolean` | enable wave propagation |
+| `mass` | `boolean` | first-class mass in the integrator |
+| `attention` | `boolean` | attention/importance weighting |
+| `causality` | `boolean` | causal-trail visualization |
+| `heatmap` | `boolean` | density heatmap diagnostic |
+| `className` / `style` | — | applied to the managed `<canvas>` |
+| `onReady` | `(field: FieldHandle) => void` | called once the engine is live |
+
+```tsx
+<FieldField
+  render="streamlines"
+  palette="infrared"
+  onReady={(field) => field.setFormation('wells')}
+/>
+```
+
+## Driving the field from code
+
+`onReady` hands you the live `FieldHandle` — the full imperative surface:
+
+```tsx
+<FieldField onReady={(field) => {
+  field.scan();                 // re-pick-up [data-body] elements after a render
+  field.setFormation('wells');
+  field.setRender('trails');
+  field.burst(window.innerWidth / 2, 200);   // a one-off impulse
+  field.flowTo(x, y);           // a movable focus the field bends toward
+}} />
+```
+
+| Method | Use |
+|---|---|
+| `scan()` / `rescan()` | re-read `[data-body]` elements after the DOM changes |
+| `setAccent(hex)` · `setPalette(p)` | recolor live |
+| `setFormation(name)` | arrange particles into a named formation (e.g. `wells`) |
+| `setRender(mode)` · `setOverlay(mode)` | change the underlay / overlay surface |
+| `setAttention(on)` · `setCausality(on)` · `setHeatmap(on)` | toggle diagnostics |
+| `burst(x, y, hex?)` · `flowTo(x, y)` · `clearFlow()` | impulses and a movable focus |
+| `destroy()` | stop the loop and remove the managed canvas |
+
+### The hook
+
+For full control of the canvas element yourself, use `useFieldField()` instead of the component:
+
+```tsx
+const { canvasRef, fieldRef } = useFieldField({ accent: '#4da3ff' });
+return <canvas ref={canvasRef} className="my-field" />;
+// fieldRef.current is the FieldHandle once mounted
+```
+
+## Marking bodies — the `data-body` vocabulary
+
+Any element on the page becomes a *body* by carrying `data-body`. The common attributes:
+
+| Attribute | Meaning |
+|---|---|
+| `data-body="attract"` | the force token (`attract`, `gravity`, `charge`, `sink`, …) |
+| `data-strength` | how hard it bends the field |
+| `data-range` | radius of influence, in px |
+| `data-feedback` | opt in to receiving `--field-*` variables back |
+| `data-absorb` / `data-max` | for `sink` bodies: accretion load and capacity |
+
+After rendering **new** bodies, call `field.scan()` (e.g. from `onReady` or via `fieldRef`) so the
+engine picks them up.
+
+## Server-side rendering (Next.js, Remix, Astro islands)
+
+The field is a browser effect — the engine starts inside React effects, so `<FieldField>` is safe to
+include in an app that server-renders, but it only comes alive on the client. In the Next.js App
+Router, render it from a Client Component (`'use client'`).
+
+## Recipes & data binding
+
+To apply a named recipe or bind data to the field, use `applyRecipe()` / `bindData()` from
+[`@fundamental-engine/platform`](../platform) against a ref'd container. Browse all 64 recipes at
+[`/docs/gallery`](https://fundamental-engine.com/docs/gallery).
+
+## Aliases
+
+`ForcesField` / `useForcesField` and `ForcesFieldProps` are deprecated aliases of `FieldField` /
+`useFieldField` / `FieldFieldProps`, kept for the `forces-ui` → `field-ui` rename.
+
+## Related
+
+[`@fundamental-engine/core`](../core) · [`@fundamental-engine/platform`](../platform) · [`@fundamental-engine/elements`](../elements)
+· [`@fundamental-engine/vanilla`](../vanilla) · the [documentation map](../../docs/README.md).
+
+## License
+
+MIT © Zach Shallbetter

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The React adapter (Phase 7) — `<FieldField>` mounts the reciprocal field on a
+ * canvas via the core engine, the same field the custom element and `mountField`
+ * wrap. React is a peer dependency (the one framework dep; the core stays zero-dep).
+ *
+ * ```tsx
+ * import { FieldField } from '@fundamental-engine/react';
+ * <FieldField accent="#4da3ff" />            // a full-viewport reciprocal field
+ * <FieldField onReady={(f) => f.scan()} />   // grab the handle to drive it
+ * ```
+ *
+ * The field reacts to `[data-body]` elements anywhere on the page (the field-reacts
+ * law); call `field.scan()` from `onReady` after you render new bodies.
+ */
+import type { CSSProperties, ReactElement, RefObject } from 'react';
+import { type FieldHandle, type FieldOptions } from '@fundamental-engine/core';
+export interface FieldFieldProps extends FieldOptions {
+    className?: string;
+    style?: CSSProperties;
+    /** called once the field is created, with its handle (scan/burst/setAccent/…). */
+    onReady?: (field: FieldHandle) => void;
+}
+export declare function FieldField({ className, style, onReady, accent, density, waves, background, render, overlay, mass, palette, attention, causality, }: FieldFieldProps): ReactElement;
+/**
+ * Hook form — returns a ref to attach to your own `<canvas>` and the live handle.
+ * Use when you need to own the canvas element (sizing, placement) yourself.
+ */
+export declare function useFieldField(opts?: FieldOptions): {
+    canvasRef: RefObject<HTMLCanvasElement | null>;
+    fieldRef: RefObject<FieldHandle | 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.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAqB,MAAM,0BAA0B,CAAC;AAGtH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAGxC;AAKD,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,KAAK,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,MAAM,EACN,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,SAAS,GACV,EAAE,eAAe,GAAG,YAAY,CAwChC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,YAAiB,GAAG;IACtD,SAAS,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/C,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACzC,CAmCA"}

package/dist/index.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The React adapter (Phase 7) — `<FieldField>` mounts the reciprocal field on a
+ * canvas via the core engine, the same field the custom element and `mountField`
+ * wrap. React is a peer dependency (the one framework dep; the core stays zero-dep).
+ *
+ * ```tsx
+ * import { FieldField } from '@fundamental-engine/react';
+ * <FieldField accent="#4da3ff" />            // a full-viewport reciprocal field
+ * <FieldField onReady={(f) => f.scan()} />   // grab the handle to drive it
+ * ```
+ *
+ * The field reacts to `[data-body]` elements anywhere on the page (the field-reacts
+ * law); call `field.scan()` from `onReady` after you render new bodies.
+ */
+import { useEffect, useRef } from 'react';
+import { FIELD_CANVAS_STYLE } from '@fundamental-engine/core';
+import { createBrowserField } from '@fundamental-engine/platform';
+// the fixed, click-through surface — shared with the vanilla mount via core/surface.ts.
+const FIXED = FIELD_CANVAS_STYLE;
+export function FieldField({ className, style, onReady, accent, density, waves, background, render, overlay, mass, palette, attention, causality, }) {
+    const canvasRef = useRef(null);
+    const onReadyRef = useRef(onReady);
+    onReadyRef.current = onReady;
+    /** Field Surfaces: the front overlay surface this component owns, lazily created. */
+    const overlayCanvasRef = useRef(null);
+    useEffect(() => {
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return;
+        // Field Surfaces: lazily create the overlay canvas the first time an overlay is set.
+        // Matches the element's pattern: fixed, full-viewport, click-through, above content.
+        if (overlay !== undefined && overlay !== 'off' && !overlayCanvasRef.current && typeof document !== 'undefined') {
+            const oc = document.createElement('canvas');
+            oc.setAttribute('aria-hidden', 'true');
+            oc.style.cssText =
+                'position:fixed;inset:0;width:100%;height:100%;pointer-events:none;z-index:5;mix-blend-mode:screen';
+            document.body.appendChild(oc);
+            overlayCanvasRef.current = oc;
+        }
+        const field = createBrowserField(canvas, {
+            accent, density, waves, background, render,
+            overlay, overlayCanvas: overlayCanvasRef.current ?? undefined,
+            mass, palette, attention, causality,
+        });
+        onReadyRef.current?.(field);
+        return () => {
+            field.destroy();
+            // Field Surfaces: remove the overlay canvas this component owns on teardown.
+            overlayCanvasRef.current?.remove();
+            overlayCanvasRef.current = null;
+        };
+        // re-create only when an engine option actually changes
+    }, [accent, density, waves, background, render, overlay, mass, palette, attention, causality]);
+    return (_jsx("canvas", { ref: canvasRef, "aria-hidden": "true", className: className, style: { ...FIXED, ...style } }));
+}
+/**
+ * Hook form — returns a ref to attach to your own `<canvas>` and the live handle.
+ * Use when you need to own the canvas element (sizing, placement) yourself.
+ */
+export function useFieldField(opts = {}) {
+    const canvasRef = useRef(null);
+    const fieldRef = useRef(null);
+    /** Field Surfaces: the front overlay surface this hook owns, lazily created. */
+    const overlayCanvasRef = useRef(null);
+    const { accent, density, waves, background, render, overlay, mass, palette, attention, causality } = opts;
+    useEffect(() => {
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return;
+        // Field Surfaces: lazily create the overlay canvas when an overlay reading is requested.
+        if (overlay !== undefined && overlay !== 'off' && !overlayCanvasRef.current && typeof document !== 'undefined') {
+            const oc = document.createElement('canvas');
+            oc.setAttribute('aria-hidden', 'true');
+            oc.style.cssText =
+                'position:fixed;inset:0;width:100%;height:100%;pointer-events:none;z-index:5;mix-blend-mode:screen';
+            document.body.appendChild(oc);
+            overlayCanvasRef.current = oc;
+        }
+        const field = createBrowserField(canvas, {
+            accent, density, waves, background, render,
+            overlay, overlayCanvas: overlayCanvasRef.current ?? undefined,
+            mass, palette, attention, causality,
+        });
+        fieldRef.current = field;
+        return () => {
+            field.destroy();
+            fieldRef.current = null;
+            // Field Surfaces: remove the overlay canvas this hook owns on teardown.
+            overlayCanvasRef.current?.remove();
+            overlayCanvasRef.current = null;
+        };
+    }, [accent, density, waves, background, render, overlay, mass, palette, attention, causality]);
+    return { canvasRef, fieldRef };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@fundamental-engine/react",
+  "version": "0.4.0",
+  "description": "React adapter for Fundamental — a reciprocal DOM-physics field as a <FieldField> component + useFieldField hook.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Zach Shallbetter <hi@zachshallbetter.com> (https://zachshallbetter.com)",
+  "homepage": "https://fundamental-engine.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zachshallbetter/fundamental-engine.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/zachshallbetter/fundamental-engine/issues"
+  },
+  "keywords": [
+    "Fundamental",
+    "react",
+    "particles",
+    "physics",
+    "canvas",
+    "field",
+    "react-component"
+  ],
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fundamental-engine/platform": "0.4.0",
+    "@fundamental-engine/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test"
+  }
+}