@orb3d/react 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amir Abushanab
+
+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,44 @@
-# Temporary Holding Version
+# @orb3d/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.
+A drop-in glass orb with states for React.
+
+```sh
+pnpm add @orb3d/react
+```
+
+```tsx
+import { Orb3D } from "@orb3d/react";
+
+export function Status({ state }: { state: "idle" | "thinking" | "speaking" }) {
+  return <Orb3D preset="aura" state={state} poster="/orb.png" style={{ width: 96, height: 96 }} />;
+}
+```
+
+Props: `preset` (a name, lazy-loaded, or a function, tree-shaken: `clear`, the default, `aura`,
+`landscape`, `sunset`, `dawn`, `storm`, `night`), `state`, `level` (0 to 1), `config` (merged last,
+block by block), the flat `size`, `background`, `speed` and `paused`, and
+the shell's mount-time options: `poster`, `posterFit`, `fadeMs`, `lazy`, `webgl`,
+`respectReducedMotion`, `adaptiveQuality`, `minSizeForWebGL`, `onReady`, `onFallback`, `onPhaseChange`.
+
+`adaptiveQuality` is opt-in for large orbs: it lowers live resolution during sustained slow frames
+and gradually recovers, while snapshots retain the authored resolution.
+
+Changing `state` springs the orb to it and rebuilds nothing. For audio, drive the level through the
+ref rather than a prop, so React doesn't re-render every frame:
+
+```tsx
+const orb = useRef<OrbHandle>(null);
+useEffect(() => analyser.onLevel((rms) => orb.current?.setLevel(rms * 6)), []);
+return <Orb3D ref={orb} preset="aura" state="speaking" />;
+```
+
+Anything can go in the glass through `config`:
+
+```tsx
+<Orb3D config={{ contents: { type: "image", src: "/avatar.jpg" } }} />
+<Orb3D config={{ contents: { type: "video", src: "/loop.mp4" } }} />
+<Orb3D preset="aura" config={{ glass: { frost: 0.3, tint: "#cfe3ff" } }} />
+```
+
+It renders a `<div>`, so it is safe to server-render; pass `<img data-orb3d-poster src="…" />` as
+a child for a poster in the server HTML, which the shell adopts.

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { CSSProperties, ReactNode } from "react";
+import { FallbackReason, FallbackReason as FallbackReason$1, OrbConfig, OrbConfigInput, OrbHandle, OrbHandle as OrbHandle$1, OrbPhase, OrbPhase as OrbPhase$1, OrbRenderer, PosterFit, SnapshotOptions } from "@orb3d/core";
+//#region src/index.d.ts
+/** Flat props for the settings people actually reach for; anything else goes through `config`. */
+interface FlatProps {
+  /** The orb's diameter as a share of the box's shorter side. Below 1 leaves room for a halo. */
+  size?: number;
+  /** `"transparent"` (the default) composites over the page; a colour fills behind the orb. */
+  background?: string;
+  /** Scales every motion at once. */
+  speed?: number;
+  paused?: boolean;
+}
+interface Orb3DProps extends FlatProps {
+  /** A preset: a function (tree-shakeable) or a name string (lazy-imports the presets chunk). */
+  preset?: string | (() => OrbConfigInput);
+  /**
+   * The state to show, by name (`idle`, `listening`, `thinking`, `speaking`, `muted` in the
+   * built-in presets). Changing it springs the orb to the new state; it never rebuilds anything.
+   */
+  state?: string;
+  /**
+   * The input level, 0 to 1. Fine for a value that changes now and then; for audio, call
+   * `ref.current.setLevel()` from your analyser loop instead, so React doesn't re-render per frame.
+   */
+  level?: number;
+  /**
+   * Escape hatch: a full or partial config, applied last and merged block by block, so
+   * `config={{ glass: { frost: 0.5 } }}` keeps the rest of the glass, and
+   * `config={{ contents: { type: "image", src: "/photo.jpg" } }}` puts a picture in it.
+   * Precedence: default ← preset ← flat props ← config.
+   */
+  config?: OrbConfigInput;
+  poster?: string;
+  /** Poster `object-fit`. Default `"fill"` (matches the canvas, so the handoff is seamless). */
+  posterFit?: PosterFit;
+  /** Poster→canvas crossfade in ms. Default 300. */
+  fadeMs?: number;
+  lazy?: boolean;
+  webgl?: "auto" | "force" | "off";
+  respectReducedMotion?: boolean;
+  adaptiveQuality?: boolean;
+  /** Stay a poster below this box size in CSS pixels. */
+  minSizeForWebGL?: number;
+  className?: string;
+  style?: CSSProperties;
+  /** Custom SSR poster markup, e.g. `<img data-orb3d-poster src="…" />`; the shell adopts it. */
+  children?: ReactNode;
+  onReady?: (renderer: OrbRenderer) => void;
+  onFallback?: (reason: FallbackReason$1) => void;
+  onPhaseChange?: (phase: OrbPhase$1) => void;
+}
+/**
+ * A drop-in orb. Renders a `<div>` (SSR-safe; pass an `<img data-orb3d-poster>` child for a
+ * server-rendered poster) and, on the client, mounts the shell: poster-first, lazy, WebGL2,
+ * reduced-motion and Save-Data aware, with the engine code-split out.
+ *
+ * A `ref` receives the {@link OrbHandle}: `setState()`, `setLevel()`, `snapshot()`, `set()`,
+ * `play()`, `pause()`.
+ */
+declare const Orb3D: import("react").ForwardRefExoticComponent<Orb3DProps & import("react").RefAttributes<OrbHandle$1>>;
+//#endregion
+export { type FallbackReason, Orb3D, Orb3D as default, Orb3DProps, type OrbConfig, type OrbHandle, type OrbPhase, type SnapshotOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,165 @@
+"use client";
+import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from "react";
+import { createDefaultConfig, createOrb, ensureOrbConfig, mergeOrbConfig } from "@orb3d/core";
+import { jsx } from "react/jsx-runtime";
+//#region src/index.tsx
+/** Resolve the base config: function preset (sync) → its config; string preset → lazy-load. */
+async function resolveBase(preset) {
+	if (typeof preset === "string") {
+		const { PRESETS, isPresetName } = await import("@orb3d/core/presets");
+		if (isPresetName(preset)) return PRESETS[preset]();
+	}
+	return syncBase(preset);
+}
+/** The base we can build synchronously (function preset or default); a string preset resolves later. */
+function syncBase(preset) {
+	return typeof preset === "function" ? ensureOrbConfig(mergeOrbConfig(createDefaultConfig(), preset())) : createDefaultConfig();
+}
+/** Apply the flat props (and the config escape hatch) onto a full base config. */
+function buildConfig(base, props) {
+	const out = structuredClone(base);
+	if (props.size !== void 0) out.size = props.size;
+	if (props.background !== void 0) out.background = props.background;
+	if (props.speed !== void 0) out.speed = props.speed;
+	if (props.paused !== void 0) out.paused = props.paused;
+	delete out.state;
+	const config = props.config ? mergeOrbConfig(out, props.config) : out;
+	if (props.state !== void 0) delete config.state;
+	return config;
+}
+/**
+* Function presets are keyed by identity: swapping one function for another must re-run the update
+* effect, and a string cannot say which function it saw. An inline function gets a fresh id each
+* render; memoize the preset if you want the effect to skip entirely.
+*/
+const presetIds = /* @__PURE__ */ new WeakMap();
+let nextPresetId = 0;
+function presetKey(preset) {
+	if (typeof preset !== "function") return preset;
+	let id = presetIds.get(preset);
+	if (id === void 0) presetIds.set(preset, id = nextPresetId++);
+	return `fn#${id}`;
+}
+/** A stable string that changes whenever the resolved config would; keys the update effect. */
+function configKey(props) {
+	return JSON.stringify({
+		preset: presetKey(props.preset),
+		flat: [
+			props.size,
+			props.background,
+			props.speed,
+			props.paused
+		],
+		config: props.config
+	});
+}
+function Orb3DInner(props, ref) {
+	const { className, style, children } = props;
+	const containerRef = useRef(null);
+	const handleRef = useRef(null);
+	const cbRef = useRef({});
+	cbRef.current.onReady = props.onReady;
+	cbRef.current.onFallback = props.onFallback;
+	cbRef.current.onPhaseChange = props.onPhaseChange;
+	const key = useMemo(() => configKey(props), [
+		props.preset,
+		props.size,
+		props.background,
+		props.speed,
+		props.paused,
+		props.config
+	]);
+	const appliedKeyRef = useRef(null);
+	const configRevisionRef = useRef(0);
+	useImperativeHandle(ref, () => ({
+		get phase() {
+			return handleRef.current?.phase ?? "poster";
+		},
+		get renderer() {
+			return handleRef.current?.renderer ?? null;
+		},
+		get state() {
+			return handleRef.current?.state ?? props.state ?? "idle";
+		},
+		setState: (name) => handleRef.current?.setState(name),
+		setLevel: (value) => handleRef.current?.setLevel(value),
+		setWeather: (snapshot, options) => handleRef.current?.setWeather(snapshot, options),
+		snapshot: (opts) => handleRef.current?.snapshot(opts) ?? Promise.resolve(null),
+		set: (config) => handleRef.current?.set(config),
+		play: () => handleRef.current?.play(),
+		pause: () => handleRef.current?.pause(),
+		destroy: () => handleRef.current?.destroy()
+	}), []);
+	useEffect(() => {
+		const container = containerRef.current;
+		if (!container) return;
+		let cancelled = false;
+		const revision = ++configRevisionRef.current;
+		const options = {
+			poster: props.poster,
+			posterFit: props.posterFit,
+			fadeMs: props.fadeMs,
+			lazy: props.lazy,
+			webgl: props.webgl,
+			respectReducedMotion: props.respectReducedMotion,
+			adaptiveQuality: props.adaptiveQuality,
+			minSizeForWebGL: props.minSizeForWebGL,
+			onReady: (r) => cbRef.current.onReady?.(r),
+			onFallback: (reason) => cbRef.current.onFallback?.(reason),
+			onPhaseChange: (phase) => cbRef.current.onPhaseChange?.(phase)
+		};
+		const initial = buildConfig(syncBase(props.preset), props);
+		if (props.state !== void 0) initial.state = props.state;
+		const handle = createOrb(container, initial, options);
+		handleRef.current = handle;
+		appliedKeyRef.current = key;
+		if (props.level !== void 0) handle.setLevel(props.level);
+		if (typeof props.preset === "string") resolveBase(props.preset).then((base) => {
+			if (!cancelled && handleRef.current === handle && configRevisionRef.current === revision) handle.set(buildConfig(base, props));
+		});
+		return () => {
+			cancelled = true;
+			configRevisionRef.current++;
+			handle.destroy();
+			handleRef.current = null;
+			appliedKeyRef.current = null;
+		};
+	}, []);
+	useEffect(() => {
+		const handle = handleRef.current;
+		if (!handle || appliedKeyRef.current === key) return;
+		appliedKeyRef.current = key;
+		const revision = ++configRevisionRef.current;
+		const apply = (base) => {
+			if (handleRef.current === handle && configRevisionRef.current === revision) handle.set(buildConfig(base, props));
+		};
+		if (typeof props.preset === "string") resolveBase(props.preset).then(apply);
+		else apply(syncBase(props.preset));
+	}, [key]);
+	useEffect(() => {
+		if (props.state !== void 0) handleRef.current?.setState(props.state);
+	}, [props.state]);
+	useEffect(() => {
+		if (props.level !== void 0) handleRef.current?.setLevel(props.level);
+	}, [props.level]);
+	return /* @__PURE__ */ jsx("div", {
+		ref: containerRef,
+		className,
+		style,
+		children
+	});
+}
+/**
+* A drop-in orb. Renders a `<div>` (SSR-safe; pass an `<img data-orb3d-poster>` child for a
+* server-rendered poster) and, on the client, mounts the shell: poster-first, lazy, WebGL2,
+* reduced-motion and Save-Data aware, with the engine code-split out.
+*
+* A `ref` receives the {@link OrbHandle}: `setState()`, `setLevel()`, `snapshot()`, `set()`,
+* `play()`, `pause()`.
+*/
+const Orb3D = forwardRef(Orb3DInner);
+Orb3D.displayName = "Orb3D";
+//#endregion
+export { Orb3D, Orb3D as default };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.tsx"],"sourcesContent":["\"use client\";\n\nimport { forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from \"react\";\nimport type { CSSProperties, ForwardedRef, ReactElement, ReactNode } from \"react\";\nimport { createDefaultConfig, createOrb, ensureOrbConfig, mergeOrbConfig } from \"@orb3d/core\";\nimport type {\n  FallbackReason,\n  OrbConfigInput,\n  OrbConfig,\n  OrbHandle,\n  OrbOptions,\n  OrbPhase,\n  OrbRenderer,\n  PosterFit,\n} from \"@orb3d/core\";\n\n/** Flat props for the settings people actually reach for; anything else goes through `config`. */\ninterface FlatProps {\n  /** The orb's diameter as a share of the box's shorter side. Below 1 leaves room for a halo. */\n  size?: number;\n  /** `\"transparent\"` (the default) composites over the page; a colour fills behind the orb. */\n  background?: string;\n  /** Scales every motion at once. */\n  speed?: number;\n  paused?: boolean;\n}\n\nexport interface Orb3DProps extends FlatProps {\n  /** A preset: a function (tree-shakeable) or a name string (lazy-imports the presets chunk). */\n  preset?: string | (() => OrbConfigInput);\n  /**\n   * The state to show, by name (`idle`, `listening`, `thinking`, `speaking`, `muted` in the\n   * built-in presets). Changing it springs the orb to the new state; it never rebuilds anything.\n   */\n  state?: string;\n  /**\n   * The input level, 0 to 1. Fine for a value that changes now and then; for audio, call\n   * `ref.current.setLevel()` from your analyser loop instead, so React doesn't re-render per frame.\n   */\n  level?: number;\n  /**\n   * Escape hatch: a full or partial config, applied last and merged block by block, so\n   * `config={{ glass: { frost: 0.5 } }}` keeps the rest of the glass, and\n   * `config={{ contents: { type: \"image\", src: \"/photo.jpg\" } }}` puts a picture in it.\n   * Precedence: default ← preset ← flat props ← config.\n   */\n  config?: OrbConfigInput;\n  poster?: string;\n  /** Poster `object-fit`. Default `\"fill\"` (matches the canvas, so the handoff is seamless). */\n  posterFit?: PosterFit;\n  /** Poster→canvas crossfade in ms. Default 300. */\n  fadeMs?: number;\n  lazy?: boolean;\n  webgl?: \"auto\" | \"force\" | \"off\";\n  respectReducedMotion?: boolean;\n  adaptiveQuality?: boolean;\n  /** Stay a poster below this box size in CSS pixels. */\n  minSizeForWebGL?: number;\n  className?: string;\n  style?: CSSProperties;\n  /** Custom SSR poster markup, e.g. `<img data-orb3d-poster src=\"…\" />`; the shell adopts it. */\n  children?: ReactNode;\n  onReady?: (renderer: OrbRenderer) => void;\n  onFallback?: (reason: FallbackReason) => void;\n  onPhaseChange?: (phase: OrbPhase) => void;\n}\n\n/** Resolve the base config: function preset (sync) → its config; string preset → lazy-load. */\nasync function resolveBase(preset: Orb3DProps[\"preset\"]): Promise<OrbConfig> {\n  if (typeof preset === \"string\") {\n    const { PRESETS, isPresetName } = await import(\"@orb3d/core/presets\");\n    if (isPresetName(preset)) return PRESETS[preset]();\n  }\n  return syncBase(preset);\n}\n\n/** The base we can build synchronously (function preset or default); a string preset resolves later. */\nfunction syncBase(preset: Orb3DProps[\"preset\"]): OrbConfig {\n  return typeof preset === \"function\"\n    ? ensureOrbConfig(mergeOrbConfig(createDefaultConfig(), preset()))\n    : createDefaultConfig();\n}\n\n/** Apply the flat props (and the config escape hatch) onto a full base config. */\nfunction buildConfig(base: OrbConfig, props: Orb3DProps): OrbConfigInput {\n  // A function preset may hand back the same object on every call, so copy before writing.\n  const out: OrbConfigInput = structuredClone(base);\n  if (props.size !== undefined) out.size = props.size;\n  if (props.background !== undefined) out.background = props.background;\n  if (props.speed !== undefined) out.speed = props.speed;\n  if (props.paused !== undefined) out.paused = props.paused;\n  // The state prop is applied through setState, never through the config: a config change cuts\n  // the dials, and a state change should spring.\n  delete out.state;\n  const config = props.config ? mergeOrbConfig(out, props.config) : out;\n  if (props.state !== undefined) delete config.state;\n  return config;\n}\n\n/**\n * Function presets are keyed by identity: swapping one function for another must re-run the update\n * effect, and a string cannot say which function it saw. An inline function gets a fresh id each\n * render; memoize the preset if you want the effect to skip entirely.\n */\nconst presetIds = new WeakMap<object, number>();\nlet nextPresetId = 0;\nfunction presetKey(preset: Orb3DProps[\"preset\"]): string | undefined {\n  if (typeof preset !== \"function\") return preset;\n  let id = presetIds.get(preset);\n  if (id === undefined) presetIds.set(preset, (id = nextPresetId++));\n  return `fn#${id}`;\n}\n\n/** A stable string that changes whenever the resolved config would; keys the update effect. */\nfunction configKey(props: Orb3DProps): string {\n  return JSON.stringify({\n    preset: presetKey(props.preset),\n    flat: [props.size, props.background, props.speed, props.paused],\n    config: props.config,\n  });\n}\n\nfunction Orb3DInner(props: Orb3DProps, ref: ForwardedRef<OrbHandle>): ReactElement {\n  const { className, style, children } = props;\n  const containerRef = useRef<HTMLDivElement>(null);\n  const handleRef = useRef<OrbHandle | null>(null);\n  // Keep the latest callbacks in a ref so they never force a remount.\n  const cbRef = useRef<Pick<Orb3DProps, \"onReady\" | \"onFallback\" | \"onPhaseChange\">>({});\n  cbRef.current.onReady = props.onReady;\n  cbRef.current.onFallback = props.onFallback;\n  cbRef.current.onPhaseChange = props.onPhaseChange;\n\n  const key = useMemo(\n    () => configKey(props),\n    [props.preset, props.size, props.background, props.speed, props.paused, props.config],\n  );\n  // The key the live handle was last given, so the update effect can tell a real change from its\n  // own first run (and from StrictMode's replay), both of which the mount effect already covered.\n  const appliedKeyRef = useRef<string | null>(null);\n  const configRevisionRef = useRef(0);\n\n  // A stable object that delegates to whichever handle is live, so a ref taken before the shell\n  // mounted, or across a StrictMode remount, keeps working.\n  useImperativeHandle(\n    ref,\n    () => ({\n      get phase() {\n        return handleRef.current?.phase ?? \"poster\";\n      },\n      get renderer() {\n        return handleRef.current?.renderer ?? null;\n      },\n      get state() {\n        return handleRef.current?.state ?? props.state ?? \"idle\";\n      },\n      setState: (name) => handleRef.current?.setState(name),\n      setLevel: (value) => handleRef.current?.setLevel(value),\n      setWeather: (snapshot, options) => handleRef.current?.setWeather(snapshot, options),\n      snapshot: (opts) => handleRef.current?.snapshot(opts) ?? Promise.resolve(null),\n      set: (config) => handleRef.current?.set(config),\n      play: () => handleRef.current?.play(),\n      pause: () => handleRef.current?.pause(),\n      destroy: () => handleRef.current?.destroy(),\n    }),\n    [],\n  );\n\n  // Mount once. StrictMode's double mount is safe: destroy() aborts a pending upgrade, and the\n  // pre-upgrade create/destroy is DOM-only (poster + IntersectionObserver).\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container) return;\n    let cancelled = false;\n    const revision = ++configRevisionRef.current;\n    const options: OrbOptions = {\n      poster: props.poster,\n      posterFit: props.posterFit,\n      fadeMs: props.fadeMs,\n      lazy: props.lazy,\n      webgl: props.webgl,\n      respectReducedMotion: props.respectReducedMotion,\n      adaptiveQuality: props.adaptiveQuality,\n      minSizeForWebGL: props.minSizeForWebGL,\n      onReady: (r) => cbRef.current.onReady?.(r),\n      onFallback: (reason) => cbRef.current.onFallback?.(reason),\n      onPhaseChange: (phase) => cbRef.current.onPhaseChange?.(phase),\n    };\n    const initial = buildConfig(syncBase(props.preset), props);\n    if (props.state !== undefined) initial.state = props.state;\n    const handle = createOrb(container, initial, options);\n    handleRef.current = handle;\n    appliedKeyRef.current = key;\n    if (props.level !== undefined) handle.setLevel(props.level);\n    // A string preset resolves asynchronously; stage the real config once it loads. This is the one\n    // set a mount makes: the update effect below sees the key it already applied and skips.\n    if (typeof props.preset === \"string\") {\n      void resolveBase(props.preset).then((base) => {\n        if (!cancelled && handleRef.current === handle && configRevisionRef.current === revision)\n          handle.set(buildConfig(base, props));\n      });\n    }\n    return () => {\n      cancelled = true;\n      configRevisionRef.current++;\n      handle.destroy();\n      handleRef.current = null;\n      appliedKeyRef.current = null;\n    };\n    // Mount-time only: options are captured once; config, state and level flow through the\n    // effects below.\n  }, []);\n\n  // Push config changes (flat props, config, preset) to the live handle.\n  useEffect(() => {\n    const handle = handleRef.current;\n    if (!handle || appliedKeyRef.current === key) return;\n    appliedKeyRef.current = key;\n    const revision = ++configRevisionRef.current;\n    const apply = (base: OrbConfig): void => {\n      if (handleRef.current === handle && configRevisionRef.current === revision)\n        handle.set(buildConfig(base, props));\n    };\n    if (typeof props.preset === \"string\") void resolveBase(props.preset).then(apply);\n    else apply(syncBase(props.preset));\n  }, [key]);\n\n  useEffect(() => {\n    if (props.state !== undefined) handleRef.current?.setState(props.state);\n  }, [props.state]);\n\n  useEffect(() => {\n    if (props.level !== undefined) handleRef.current?.setLevel(props.level);\n  }, [props.level]);\n\n  return (\n    <div ref={containerRef} className={className} style={style}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * A drop-in orb. Renders a `<div>` (SSR-safe; pass an `<img data-orb3d-poster>` child for a\n * server-rendered poster) and, on the client, mounts the shell: poster-first, lazy, WebGL2,\n * reduced-motion and Save-Data aware, with the engine code-split out.\n *\n * A `ref` receives the {@link OrbHandle}: `setState()`, `setLevel()`, `snapshot()`, `set()`,\n * `play()`, `pause()`.\n */\nexport const Orb3D = forwardRef(Orb3DInner);\nOrb3D.displayName = \"Orb3D\";\n\nexport default Orb3D;\nexport type { OrbConfig, OrbHandle, OrbPhase, FallbackReason, SnapshotOptions } from \"@orb3d/core\";\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@orb3d/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Drop-in glass orb with states for React: the <Orb3D> component",
+  "keywords": [
+    "agent",
+    "avatar",
+    "component",
+    "glass",
+    "orb",
+    "react",
+    "status",
+    "voice",
+    "webgl"
+  ],
+  "homepage": "https://github.com/Amir-Abushanab/orb3d/tree/main/packages/react#readme",
+  "bugs": "https://github.com/Amir-Abushanab/orb3d/issues",
+  "license": "MIT",
+  "author": "Amir Abushanab (https://github.com/Amir-Abushanab)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Amir-Abushanab/orb3d.git",
+    "directory": "packages/react"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@orb3d/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0"
+  },
+  "peerDependencies": {
+    "@types/react": ">=18",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }