@octanejs/drei 0.0.1

package/src/web/scroll-html-root.tsrx

@@ -0,0 +1,27 @@
+import { context as threeContext, type RootStore } from '@octanejs/three';
+import { createRoot, type Context, type OctaneNode } from 'octane';
+import type { ScrollControlsState } from './ScrollControls.three.tsrx';
+
+// The Three context is registered with Octane's renderer bridge, so this DOM-owned
+// root must expose that same provider through the DOM Context call signature.
+const DomThreeContextProvider = threeContext.Provider as unknown as Context<RootStore | null>['Provider'];
+
+function ScrollHtmlContent({ state, fiberState, children }: {
+	state: ScrollControlsState;
+	fiberState: RootStore;
+	children?: OctaneNode;
+}) @{
+	<ScrollControlsStateProvider value={state}>
+		<DomThreeContextProvider value={fiberState}>{children}</DomThreeContextProvider>
+	</ScrollControlsStateProvider>
+}
+
+// Assigned by ScrollControls to avoid a runtime circular import while preserving context identity.
+export let ScrollControlsStateProvider: any;
+export function setScrollControlsStateProvider(provider: any): void { ScrollControlsStateProvider = provider; }
+
+export function mountScrollHtml(container: HTMLElement, props: { state: ScrollControlsState; fiberState: RootStore; children?: OctaneNode }): () => void {
+	const root = createRoot(container);
+	root.render(ScrollHtmlContent, props);
+	return () => root.unmount();
+}

package/src/web/useCursor.three.tsrx

@@ -0,0 +1,19 @@
+import { useEffect } from '@octanejs/three/renderer';
+import { slotDefault } from '../core/compiler-slot.js';
+
+export function useCursor(
+	hovered: boolean,
+	onPointerOver = 'pointer',
+	onPointerOut = 'auto',
+	container: HTMLElement = document.body,
+) {
+	onPointerOver = slotDefault(onPointerOver, 'pointer');
+	onPointerOut = slotDefault(onPointerOut, 'auto');
+	container = slotDefault(container, document.body);
+	useEffect(() => {
+		if (hovered) {
+			container.style.cursor = onPointerOver;
+			return () => void (container.style.cursor = onPointerOut);
+		}
+	}, [hovered]);
+}

package/src/web/useGesture.ts

@@ -0,0 +1,27 @@
+import { Controller, parseMergedHandlers } from '@use-gesture/core';
+import {
+	dragAction,
+	hoverAction,
+	moveAction,
+	pinchAction,
+	registerAction,
+	scrollAction,
+	wheelAction,
+} from '@use-gesture/core/actions';
+import type { GestureHandlers, UserGestureConfig } from '@use-gesture/core/types';
+import { useEffect, useMemo } from '@octanejs/three/renderer';
+import { slotDefault } from '../core/compiler-slot.js';
+
+for (const action of [dragAction, pinchAction, scrollAction, wheelAction, moveAction, hoverAction])
+	registerAction(action);
+
+export function useGesture(handlersInput: GestureHandlers, configInput: UserGestureConfig = {}) {
+	configInput = slotDefault(configInput, {});
+	const { handlers, nativeHandlers, config } = parseMergedHandlers(handlersInput, configInput);
+	const controller = useMemo(() => new Controller(handlers), []);
+	controller.applyHandlers(handlers, nativeHandlers);
+	controller.applyConfig(config);
+	useEffect(controller.effect.bind(controller));
+	useEffect(() => controller.clean.bind(controller), []);
+	return config.target === undefined ? controller.bind.bind(controller) : undefined;
+}

package/status.json

@@ -0,0 +1,14 @@
+{
+  "upstream": {
+    "package": "@react-three/drei",
+    "version": "10.7.7"
+  },
+  "surface": "Complete port of the pinned @react-three/drei 10.7.7 public web API (commit b8b99fd4ca1dfb8d821335671320512daa6efea4): 379 source exports and 217 runtime exports are accounted for by the executable crosswalk, with 299 parity assertions across 105 test files.",
+  "divergences": [
+    "View: inline Canvas views are ported. Calling View from an Octane DOM root fails with the universal renderer-boundary diagnostic, and View.Port is a callable no-op. Octane components are statically renderer-owned, so one component cannot switch between DOM and Three renderers or transport authored Three children between independent roots as React Drei does with tunnel-rat."
+  ],
+  "ssr": "Browser-dependent helpers remain client-only; server-safe behavior is verified per export.",
+  "verified": "2026-08-02",
+  "parityEvidence": "packages/drei/audit/react-parity.json",
+  "docs": ["packages/drei/README.md", "packages/drei/UPSTREAM.md"]
+}