@octanejs/mcp-server 0.2.15 → 0.2.17

package/README.md

@@ -163,7 +163,7 @@ one manifest suite by name (`js-framework`, `todomvc`, `weather-app`,
 `controlled-form`, `external-store-fanout`, `external-store-integrations`,
 `scheduler-responsiveness`, `suspense-recovery`, `event-delegation`,
 `application-composition`, `scaling-curves`, `streaming-ssr`,
-`streaming-backpressure`, `compiler-throughput`, `codegen-size`,
+`streaming-backpressure`, `compiler-throughput`, `codegen-size`, `hook-memo`,
 `bundle-size`, `bundle-reachability`, `three-renderer`, `three-bundle-size`, …)
 or every suite with `all`; `quick` selects the reduced-iteration smoke pass. The
 suite list mirrors the runner manifest and `node benchmarks/bench.mjs --list`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/mcp-server",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "type": "module",
   "engines": {
     "node": ">=22.22.2"

package/skills/bridge-react-package.md

@@ -24,6 +24,7 @@ of bridging by hand:
 | `styled-components` | `@octanejs/styled-components` |
 | `react-router` / `react-router-dom` | `@octanejs/remix-router` |
 | `@lexical/react` | `@octanejs/lexical` |
+| `@monaco-editor/react` | `@octanejs/monaco-editor` |
 | `lucide-react` | `@octanejs/lucide` |
 | `@floating-ui/react` | `@octanejs/floating-ui` |
 | `radix-ui` | `@octanejs/radix` |
@@ -44,6 +45,7 @@ of bridging by hand:
 | `@reduxjs/toolkit` | `@octanejs/redux-toolkit` |
 | `@testing-library/react` | `@octanejs/testing-library` |
 | `@mdx-js/react` | `@octanejs/mdx` |
+| `ink` | `@octanejs/ink` |
 
 The `octane_bindings` tool returns the same map machine-readably. For anything
 else, run the `octane_bridge_react_package` tool to get a scan of the

package/src/bridge.js

@@ -18,9 +18,11 @@ export const KNOWN_BINDINGS = {
 	'@apollo/client': '@octanejs/apollo-client',
 	'@solana/react': '@octanejs/solana-react',
 	'@tanstack/ai-react': '@octanejs/tanstack-ai',
+	'@tanstack/react-db': '@octanejs/tanstack-db',
 	'@tanstack/react-devtools': '@octanejs/tanstack-devtools',
 	'@tanstack/react-form': '@octanejs/tanstack-form',
 	'@tanstack/react-query': '@octanejs/tanstack-query',
+	swr: '@octanejs/swr',
 	wagmi: '@octanejs/wagmi',
 	'@rainbow-me/rainbowkit': '@octanejs/rainbowkit',
 	'@tanstack/react-router': '@octanejs/tanstack-router',
@@ -30,8 +32,11 @@ export const KNOWN_BINDINGS = {
 	'@tanstack/react-pacer': '@octanejs/tanstack-pacer',
 	'@tanstack/react-table': '@octanejs/tanstack-table',
 	'@tanstack/react-virtual': '@octanejs/tanstack-virtual',
+	'react-window': '@octanejs/window',
 	'framer-motion': '@octanejs/motion',
 	motion: '@octanejs/motion',
+	'@react-spring/web': '@octanejs/spring',
+	'@react-spring/parallax': '@octanejs/spring',
 	'@stylexjs/stylex': '@octanejs/stylex',
 	'styled-components': '@octanejs/styled-components',
 	'react-router': '@octanejs/remix-router',
@@ -40,9 +45,12 @@ export const KNOWN_BINDINGS = {
 	cmdk: '@octanejs/cmdk',
 	'@lexical/react': '@octanejs/lexical',
 	'@tiptap/react': '@octanejs/tiptap',
+	'react-pdf': '@octanejs/pdf',
+	'@monaco-editor/react': '@octanejs/monaco-editor',
 	'lucide-react': '@octanejs/lucide',
 	'@phosphor-icons/react': '@octanejs/phosphor-icons',
 	'@floating-ui/react': '@octanejs/floating-ui',
+	'react-popper': '@octanejs/popper',
 	'react-aria': '@octanejs/aria',
 	'react-aria-components': '@octanejs/aria',
 	'react-stately': '@octanejs/aria',
@@ -50,9 +58,21 @@ export const KNOWN_BINDINGS = {
 	'react-hook-form': '@octanejs/hook-form',
 	'@base-ui-components/react': '@octanejs/base-ui',
 	'@dnd-kit/react': '@octanejs/dnd-kit',
+	'embla-carousel-react': '@octanejs/embla-carousel',
+	'react-dropzone': '@octanejs/dropzone',
 	sonner: '@octanejs/sonner',
 	'react-error-boundary': '@octanejs/react-error-boundary',
+	'react-transition-group': '@octanejs/transition-group',
+	'react-day-picker': '@octanejs/day-picker',
+	'input-otp': '@octanejs/input-otp',
+	vaul: '@octanejs/vaul',
+	'react-markdown': '@octanejs/markdown',
+	'react-textarea-autosize': '@octanejs/textarea-autosize',
+	'react-intersection-observer': '@octanejs/intersection-observer',
+	'react-draggable': '@octanejs/draggable',
+	'react-colorful': '@octanejs/colorful',
 	streamdown: '@octanejs/streamdown',
+	'react-syntax-highlighter': '@octanejs/syntax-highlighter',
 	// The official plugins are consolidated as subpaths of the same package.
 	// The bundled bridge skill documents each exact import rewrite.
 	'@streamdown/code': '@octanejs/streamdown',
@@ -61,12 +81,14 @@ export const KNOWN_BINDINGS = {
 	'@streamdown/cjk': '@octanejs/streamdown',
 	shadcn: '@octanejs/shadcn',
 	recharts: '@octanejs/recharts',
+	'react-alien-signals': '@octanejs/alien-signals',
 	// react-map-gl@8 is a re-export shell; the binding covers the package its
 	// ./mapbox subpath resolves to, so both specifiers map here.
 	'react-map-gl': '@octanejs/react-map-gl',
 	'react-map-gl/mapbox': '@octanejs/react-map-gl',
 	'@vis.gl/react-mapbox': '@octanejs/react-map-gl',
 	'@react-three/fiber': '@octanejs/three',
+	'@react-three/drei': '@octanejs/drei',
 	'@visx/visx': '@octanejs/visx',
 	'@visx/a11y': '@octanejs/visx',
 	'@visx/a11y/react': '@octanejs/visx',
@@ -118,11 +140,13 @@ export const KNOWN_BINDINGS = {
 	'@visx/zoom': '@octanejs/visx',
 	'react-redux': '@octanejs/redux',
 	'@reduxjs/toolkit': '@octanejs/redux-toolkit',
+	'@zag-js/react': '@octanejs/zag',
 	'@react-rxjs/core': '@octanejs/rxjs',
 	'@react-rxjs/utils': '@octanejs/rxjs',
 	'@testing-library/react': '@octanejs/testing-library',
 	'react-i18next': '@octanejs/i18next',
 	'@inertiajs/react': '@octanejs/inertia',
+	ink: '@octanejs/ink',
 	'@mdx-js/react': '@octanejs/mdx',
 	'dexie-react-hooks': '@octanejs/dexie',
 	'@livestore/react': '@octanejs/livestore',
@@ -149,6 +173,7 @@ export const KNOWN_BINDING_PACKAGE_DIRS = new Set(
 export const KNOWN_VANILLA_CORES = {
 	'@apollo/client': '@apollo/client',
 	'@solana/react': '@solana/kit',
+	'@tanstack/react-db': '@tanstack/db',
 	'@tanstack/react-query': '@tanstack/query-core',
 	wagmi: '@wagmi/core',
 	'@tanstack/react-table': '@tanstack/table-core',
@@ -156,16 +181,19 @@ export const KNOWN_VANILLA_CORES = {
 	'@tanstack/react-form': '@tanstack/form-core',
 	'@floating-ui/react': '@floating-ui/dom',
 	'@dnd-kit/react': '@dnd-kit/dom',
+	'embla-carousel-react': 'embla-carousel',
 	'@xstate/react': 'xstate',
 	'react-redux': 'redux',
 	'@reduxjs/toolkit': 'redux',
 	'react-i18next': 'i18next',
 	'react-hook-form': null,
+	'react-alien-signals': 'alien-signals',
 	zustand: 'zustand/vanilla',
 	valtio: 'valtio/vanilla',
 	jotai: 'jotai/vanilla',
 	'@lexical/react': 'lexical',
 	'@tiptap/react': '@tiptap/core',
+	'@monaco-editor/react': 'monaco-editor',
 	'@livestore/react': '@livestore/livestore',
 };
 
@@ -559,9 +587,11 @@ export function bridgeReportFromSource(source, { packageName } = {}) {
 function planFor(report) {
 	const steps = [];
 	if (report.existingBinding) {
-		steps.push(
-			`An official Octane binding already exists: ${report.existingBinding}. Prefer installing it over bridging by hand.`,
-		);
+		return [
+			`Install the official Octane binding: ${report.existingBinding}.`,
+			`Replace imports from ${report.target} with imports from ${report.existingBinding}, preserving the imported API names.`,
+			'Run the application typecheck and the relevant unit, SSR, hydration, and browser tests; no manual React binding port is needed.',
+		];
 	}
 	if (report.vanillaCore) {
 		steps.push(

package/src/bridge.test.js

@@ -10,6 +10,7 @@ import {
 	detectVanillaCore,
 	scanSource,
 	KNOWN_BINDINGS,
+	KNOWN_VANILLA_CORES,
 	KNOWN_NATIVE_BINDINGS,
 	KNOWN_BINDING_PACKAGE_DIRS,
 } from './bridge.js';
@@ -253,6 +254,15 @@ describe('bridgeReportFromSource', () => {
 		expect(report.plan[0]).toContain('@octanejs/tanstack-query');
 	});
 
+	it('routes the React Monaco adapter to its framework-neutral editor core', () => {
+		const report = bridgeReportFromSource(`export {};`, {
+			packageName: '@monaco-editor/react',
+		});
+		expect(report.existingBinding).toBe('@octanejs/monaco-editor');
+		expect(report.vanillaCore).toBe('monaco-editor');
+		expect(report.plan[0]).toContain('@octanejs/monaco-editor');
+	});
+
 	it('same-name hook usage stays bridgeable', () => {
 		const report = bridgeReportFromSource(`
 			import { useSyncExternalStore } from 'react';
@@ -265,6 +275,24 @@ describe('bridgeReportFromSource', () => {
 });
 
 describe('KNOWN_BINDINGS', () => {
+	it('maps react-alien-signals to the Octane binding and vanilla core', () => {
+		expect(KNOWN_BINDINGS['react-alien-signals']).toBe('@octanejs/alien-signals');
+		expect(KNOWN_VANILLA_CORES['react-alien-signals']).toBe('alien-signals');
+	});
+
+	it('maps react-textarea-autosize to the exact Octane binding', () => {
+		expect(KNOWN_BINDINGS['react-textarea-autosize']).toBe('@octanejs/textarea-autosize');
+	});
+
+	it('maps react-window to its exact official Octane binding', () => {
+		expect(KNOWN_BINDINGS['react-window']).toBe('@octanejs/window');
+	});
+
+	it('maps TanStack React DB to the Octane binding and framework-neutral core', () => {
+		expect(KNOWN_BINDINGS['@tanstack/react-db']).toBe('@octanejs/tanstack-db');
+		expect(KNOWN_VANILLA_CORES['@tanstack/react-db']).toBe('@tanstack/db');
+	});
+
 	it('maps Streamdown and every official plugin package to the consolidated binding', () => {
 		const upstreamPackages = [
 			'streamdown',

package/src/index.js

@@ -65,6 +65,7 @@ export const BENCHMARK_SUITES = [
 	'application-composition',
 	'scaling-curves',
 	'store-selector-fanout',
+	'hook-store-composition',
 	'effectful-list',
 	'list-clear',
 	'memo-wall',
@@ -82,11 +83,13 @@ export const BENCHMARK_SUITES = [
 	'async-composition',
 	'lynx-list',
 	'universal-leaf-update',
+	'universal-external-store',
 	'lynx-render',
 	'lynx-table',
 	'lynx-table-web',
 	'lynx-bundle-size',
 	'codegen-size',
+	'hook-memo',
 	'compiler-throughput',
 	'bundle-size',
 	'bundle-reachability',

package/src/index.test.js

@@ -28,6 +28,7 @@ describe('@octanejs/mcp-server helpers', () => {
 		expect(areaForPath('packages/octane/src/runtime.ts')).toBe('core-runtime');
 		expect(areaForPath('packages/octane/src/runtime.server.ts')).toBe('ssr');
 		expect(areaForPath('packages/zustand/src/index.ts')).toBe('ecosystem-binding');
+		expect(areaForPath('packages/alien-signals/src/index.ts')).toBe('ecosystem-binding');
 		expect(areaForPath('packages/radix/src/index.ts')).toBe('ecosystem-binding');
 		expect(areaForPath('packages/octane-mcp-server/src/index.js')).toBe('mcp-server');
 		expect(areaForPath('packages/adapter-vercel/src/index.ts')).toBe('deploy-adapter');
@@ -76,6 +77,21 @@ describe('@octanejs/mcp-server helpers', () => {
 			.map((line) => line.trim())
 			.filter((line) => line && line !== 'Available suites:');
 		expect(suites).toEqual(BENCHMARK_SUITES);
+
+		// The public MCP schema must accept every runner suite, not just keep
+		// an exported helper list in sync.
+		const server = createServer({ repoRoot });
+		const client = new Client({ name: 'octane-mcp-test', version: '1.0.0' });
+		const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+		try {
+			await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
+			const tools = await client.listTools();
+			const benchmark = tools.tools.find((tool) => tool.name === 'octane_benchmark');
+			expect(benchmark?.inputSchema.properties?.benchmark?.enum).toEqual(['all', ...suites]);
+		} finally {
+			await client.close();
+			await server.close();
+		}
 	});
 
 	it('classifies every maintained binding and recommends its test project', () => {