@octanejs/mcp-server 0.2.14 → 0.2.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/mcp-server",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "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` |

package/src/bridge.js

@@ -6,6 +6,8 @@ import { join, resolve } from 'node:path';
 // expected union from the workspace manifests, so publishing a new binding
 // without registering it in either catalog fails the mcp-server tests.
 export const KNOWN_BINDINGS = {
+	'@gsap/react': '@octanejs/gsap',
+	animejs: '@octanejs/animejs',
 	'usehooks-ts': '@octanejs/usehooks-ts',
 	zustand: '@octanejs/zustand',
 	valtio: '@octanejs/valtio',
@@ -14,10 +16,12 @@ export const KNOWN_BINDINGS = {
 	'mobx-react-lite': '@octanejs/mobx',
 	'mobx-react': '@octanejs/mobx',
 	'@apollo/client': '@octanejs/apollo-client',
+	'@solana/react': '@octanejs/solana-react',
 	'@tanstack/ai-react': '@octanejs/tanstack-ai',
 	'@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',
@@ -27,8 +31,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',
@@ -37,9 +44,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',
@@ -47,9 +57,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',
@@ -58,12 +80,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',
@@ -115,12 +139,15 @@ 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',
 	'@mdx-js/react': '@octanejs/mdx',
 	'dexie-react-hooks': '@octanejs/dexie',
+	'@livestore/react': '@octanejs/livestore',
 };
 
 // Octane-specific ecosystem packages that have no React import to rewrite.
@@ -143,6 +170,7 @@ export const KNOWN_BINDING_PACKAGE_DIRS = new Set(
 
 export const KNOWN_VANILLA_CORES = {
 	'@apollo/client': '@apollo/client',
+	'@solana/react': '@solana/kit',
 	'@tanstack/react-query': '@tanstack/query-core',
 	wagmi: '@wagmi/core',
 	'@tanstack/react-table': '@tanstack/table-core',
@@ -150,16 +178,20 @@ 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',
 };
 
 export const REACT_API_MAP = {
@@ -552,9 +584,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,19 @@ 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 Streamdown and every official plugin package to the consolidated binding', () => {
 		const upstreamPackages = [
 			'streamdown',

package/src/index.js

@@ -50,6 +50,7 @@ export const BENCHMARK_SUITES = [
 	'svg-dashboard',
 	'dbmon',
 	'recursive-context',
+	'spa-navigation',
 	'signal-favoring',
 	'news',
 	'hydration-interactivity',
@@ -82,6 +83,8 @@ export const BENCHMARK_SUITES = [
 	'lynx-list',
 	'universal-leaf-update',
 	'lynx-render',
+	'lynx-table',
+	'lynx-table-web',
 	'lynx-bundle-size',
 	'codegen-size',
 	'compiler-throughput',

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');