@octanejs/mcp-server 0.2.22 → 0.2.24

package/README.md

@@ -163,9 +163,11 @@ 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`, `dev-form-diagnostics`,
-`behavior-root-events`, `router-dispatch`, `floating-tree-navigation`, `manifest-cache-invalidation`, `vite-client-assets`, `activity`, `streaming-ssr`, `streaming-backpressure`,
+`behavior-root-events`, `radix-collection-order`, `router-dispatch`,
+`floating-tree-navigation`, `manifest-cache-invalidation`, `vite-client-assets`, `activity`,
+`streaming-ssr`, `streaming-backpressure`,
 `compiler-throughput`, `tsrx-component-graph`, `codegen-size`, `hook-memo`,
-`template-call-memo`, `bundle-size`, `bundle-reachability`, `three-renderer`,
+`transition-hooks`, `template-call-memo`, `tsrx-renderer-selection`, `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.22",
+  "version": "0.2.24",
   "type": "module",
   "engines": {
     "node": ">=22.22.2"

package/src/bridge.js

@@ -6,6 +6,7 @@ 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 = {
+	'react-is': '@octanejs/octane-is',
 	'@gsap/react': '@octanejs/gsap',
 	animejs: '@octanejs/animejs',
 	'usehooks-ts': '@octanejs/usehooks-ts',
@@ -30,6 +31,7 @@ export const KNOWN_BINDINGS = {
 	'@tanstack/react-store': '@octanejs/tanstack-store',
 	'@xstate/react': '@octanejs/xstate',
 	'@xstate/store-react': '@octanejs/xstate-store',
+	'@xyflow/react': '@octanejs/xyflow',
 	'@tanstack/react-router-ssr-query': '@octanejs/tanstack-router-ssr-query',
 	'@tanstack/react-hotkeys': '@octanejs/tanstack-hotkeys',
 	'@tanstack/react-pacer': '@octanejs/tanstack-pacer',
@@ -50,6 +52,10 @@ export const KNOWN_BINDINGS = {
 	'@lexical/react': '@octanejs/lexical',
 	'@tiptap/react': '@octanejs/tiptap',
 	'react-pdf': '@octanejs/pdf',
+	'@portabletext/react': '@octanejs/portabletext',
+	'@sanity/icons': '@octanejs/sanity-icons',
+	'@sanity/react-loader': '@octanejs/sanity-loader',
+	'@sanity/logos': '@octanejs/sanity-logos',
 	'@monaco-editor/react': '@octanejs/monaco-editor',
 	'lucide-react': '@octanejs/lucide',
 	'@phosphor-icons/react': '@octanejs/phosphor-icons',
@@ -60,13 +66,17 @@ export const KNOWN_BINDINGS = {
 	'react-stately': '@octanejs/aria',
 	'radix-ui': '@octanejs/radix',
 	'react-hook-form': '@octanejs/hook-form',
+	'better-auth/react': '@octanejs/better-auth',
 	'@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-email': '@octanejs/email',
+	'@react-email/components': '@octanejs/email',
 	'react-resizable-panels': '@octanejs/resizable-panels',
+	'react-select': '@octanejs/select',
 	'react-transition-group': '@octanejs/transition-group',
 	'react-day-picker': '@octanejs/day-picker',
 	'input-otp': '@octanejs/input-otp',
@@ -81,6 +91,7 @@ export const KNOWN_BINDINGS = {
 	'react-content-loader': '@octanejs/content-loader',
 	'react-to-print': '@octanejs/to-print',
 	'react-calendar': '@octanejs/calendar',
+	'thinking-orbs': '@octanejs/thinking-orbs',
 	'@formkit/auto-animate': '@octanejs/auto-animate',
 	streamdown: '@octanejs/streamdown',
 	'react-syntax-highlighter': '@octanejs/syntax-highlighter',
@@ -172,6 +183,7 @@ export const KNOWN_BINDINGS = {
 export const KNOWN_NATIVE_BINDINGS = new Set([
 	'@octanejs/devtools',
 	'@octanejs/electron',
+	'@octanejs/email-cli',
 	'@octanejs/tauri',
 ]);
 
@@ -199,6 +211,7 @@ export const KNOWN_VANILLA_CORES = {
 	'embla-carousel-react': 'embla-carousel',
 	'@xstate/react': 'xstate',
 	'@xstate/store-react': '@xstate/store',
+	'@xyflow/react': '@xyflow/system',
 	'react-redux': 'redux',
 	'@reduxjs/toolkit': 'redux',
 	'react-i18next': 'i18next',
@@ -462,6 +475,20 @@ export async function collectSourceFiles(root, out = [], depth = 0) {
 
 export function scanSource(source) {
 	const apis = new Map();
+	const symbolExports = new Map();
+	// Introspection libraries export element-kind symbols, not components.
+	// Require the right-hand identifier to resolve to an actual Symbol.for
+	// declaration; ordinary component exports/render calls remain API uses.
+	const symbols = new Set(
+		[...source.matchAll(/\b([A-Za-z_$][\w$]*)\s*=\s*Symbol\.for\(\s*['"][^'"]+['"]\s*\)/g)].map(
+			(match) => match[1],
+		),
+	);
+	for (const match of source.matchAll(
+		/\bexports\.([A-Za-z_$][\w$]*)\s*=\s*([A-Za-z_$][\w$]*)\s*;/g,
+	)) {
+		if (symbols.has(match[2])) symbolExports.set(match[1], (symbolExports.get(match[1]) ?? 0) + 1);
+	}
 	for (const name of Object.keys(REACT_API_MAP)) {
 		if (name === 'onChange') continue;
 		const matches = source.match(new RegExp(`\\b${name}\\b`, 'g'));
@@ -481,13 +508,14 @@ export function scanSource(source) {
 		}
 	}
 	const classComponent = /\bextends\s+(React\.)?(Pure)?Component\b/.test(source);
-	return { apis, imports, classComponent };
+	return { apis, imports, classComponent, symbolExports };
 }
 
 export async function scanPath(root) {
 	const files = await collectSourceFiles(resolve(root));
 	const totals = new Map();
 	const imports = new Set();
+	const symbolExports = new Map();
 	let classComponents = false;
 	for (const file of files) {
 		let source;
@@ -501,14 +529,26 @@ export async function scanPath(root) {
 			totals.set(name, (totals.get(name) ?? 0) + count);
 		}
 		for (const spec of result.imports) imports.add(spec);
+		for (const [name, count] of result.symbolExports) {
+			symbolExports.set(name, (symbolExports.get(name) ?? 0) + count);
+		}
 		classComponents ||= result.classComponent;
 	}
-	return { filesScanned: files.length, totals, imports, classComponents };
+	return { filesScanned: files.length, totals, imports, classComponents, symbolExports };
 }
 
-function apiRows(totals) {
+function apiRows(totals, symbolExports) {
 	return [...totals.entries()]
-		.map(([name, count]) => ({ name, count, ...REACT_API_MAP[name] }))
+		.map(([name, count]) =>
+			symbolExports.get(name) === count
+				? {
+						name,
+						count,
+						status: 'rewrite',
+						note: 'Exported element-kind marker: map to the Octane kind; predicates for unsupported kinds remain false. This does not require rendering that component.',
+					}
+				: { name, count, ...REACT_API_MAP[name] },
+		)
 		.sort((a, b) => b.count - a.count);
 }
 
@@ -569,7 +609,7 @@ export async function bridgeReport({ packageName, path, projectRoot }) {
 	}
 
 	const scan = await scanPath(scanRoot);
-	const rows = apiRows(scan.totals);
+	const rows = apiRows(scan.totals, scan.symbolExports);
 	report.filesScanned = scan.filesScanned;
 	report.reactImports = [...scan.imports];
 	report.classComponents = scan.classComponents;
@@ -592,7 +632,7 @@ export function bridgeReportFromSource(source, { packageName } = {}) {
 		report.vanillaCore = detectVanillaCore(packageName, null);
 	}
 	const scan = scanSource(source);
-	const rows = apiRows(scan.apis);
+	const rows = apiRows(scan.apis, scan.symbolExports);
 	report.reactImports = [...scan.imports];
 	report.classComponents = scan.classComponent;
 	report.apis = rows;

package/src/bridge.test.js

@@ -41,6 +41,23 @@ describe('scanSource', () => {
 		expect(scanSource('class Memoish extends PureComponent {}').classComponent).toBe(true);
 	});
 
+	it('classifies symbol-kind exports without requiring the corresponding renderer', () => {
+		const report = bridgeReportFromSource(`
+			var REACT_PROFILER_TYPE = Symbol.for('react.profiler');
+			exports.Profiler = REACT_PROFILER_TYPE;
+			exports.isProfiler = value => value.type === REACT_PROFILER_TYPE;
+		`);
+		expect(report.apis.find((row) => row.name === 'Profiler').status).toBe('rewrite');
+		expect(report.verdict).toBe('bridgeable-with-rewrites');
+		const renderer = bridgeReportFromSource(`
+			import { Profiler } from 'react';
+			var REACT_PROFILER_TYPE = Symbol.for('react.profiler');
+			exports.Profiler = REACT_PROFILER_TYPE;
+			export const View = () => <Profiler />;
+		`);
+		expect(renderer.verdict).toBe('needs-rework');
+	});
+
 	it('targets only React-style text-host onChange wiring', () => {
 		const source = `
 			function Demo(props) {
@@ -298,6 +315,10 @@ describe('KNOWN_BINDINGS', () => {
 		expect(KNOWN_BINDINGS['react-textarea-autosize']).toBe('@octanejs/textarea-autosize');
 	});
 
+	it('maps react-select to the exact Octane binding', () => {
+		expect(KNOWN_BINDINGS['react-select']).toBe('@octanejs/select');
+	});
+
 	it('maps react-window to its exact official Octane binding', () => {
 		expect(KNOWN_BINDINGS['react-window']).toBe('@octanejs/window');
 	});
@@ -307,6 +328,11 @@ describe('KNOWN_BINDINGS', () => {
 		expect(KNOWN_VANILLA_CORES['@tanstack/react-db']).toBe('@tanstack/db');
 	});
 
+	it('maps XYFlow React to the Octane binding and framework-neutral system core', () => {
+		expect(KNOWN_BINDINGS['@xyflow/react']).toBe('@octanejs/xyflow');
+		expect(KNOWN_VANILLA_CORES['@xyflow/react']).toBe('@xyflow/system');
+	});
+
 	it('maps Streamdown and every official plugin package to the consolidated binding', () => {
 		const upstreamPackages = [
 			'streamdown',

package/src/index.js

@@ -55,6 +55,7 @@ export const BENCHMARK_SUITES = [
 	'recursive-context',
 	'spa-navigation',
 	'scoped-signals',
+	'scoped-signals-trace',
 	'scoped-native-reads',
 	'signal-favoring',
 	'news',
@@ -71,9 +72,16 @@ export const BENCHMARK_SUITES = [
 	'scaling-curves',
 	'dev-form-diagnostics',
 	'scheduler-depth',
+	'hydration-range-compaction',
+	'deferred-hydration-boundaries',
+	'hydration-render-phase-queue',
 	'behavior-root-events',
+	'radix-collection-order',
 	'router-dispatch',
+	'visx-categorical-scale',
+	'rspack-css-graph',
 	'floating-tree-navigation',
+	'ink-cursor-update',
 	'manifest-cache-invalidation',
 	'vite-client-assets',
 	'store-selector-fanout',
@@ -95,7 +103,10 @@ export const BENCHMARK_SUITES = [
 	'async-waterfall',
 	'async-composition',
 	'lynx-list',
+	'lynx-handle-retirement',
 	'universal-leaf-update',
+	'universal-object-teardown',
+	'universal-template-events',
 	'universal-external-store',
 	'lynx-render',
 	'lynx-table',
@@ -103,13 +114,21 @@ export const BENCHMARK_SUITES = [
 	'lynx-bundle-size',
 	'codegen-size',
 	'hook-memo',
+	'transition-hooks',
 	'template-call-memo',
 	'compiler-throughput',
 	'tsrx-component-graph',
+	'tsrx-void-memo-aliases',
+	'tsrx-hydrate-module-slicing',
+	'tsrx-stable-hookful-propagation',
+	'tsrx-renderer-validation-ranges',
+	'tsrx-local-component-name-catalog',
 	'tsrx-jsx-return-branches',
 	'text-type-roots',
 	'tsrx-nesting-diagnostics',
+	'tsrx-renderer-selection',
 	'tsrx-native-change-analysis',
+	'tsrx-vite-preflight-parsing',
 	'bundle-size',
 	'bundle-reachability',
 	'three-renderer',

package/src/index.test.js

@@ -76,6 +76,10 @@ describe('@octanejs/mcp-server helpers', () => {
 			.split('\n')
 			.map((line) => line.trim())
 			.filter((line) => line && line !== 'Available suites:');
+		expect(suites).toContain('tsrx-hydrate-module-slicing');
+		expect(suites).toContain('tsrx-stable-hookful-propagation');
+		expect(suites).toContain('tsrx-renderer-validation-ranges');
+		expect(suites).toContain('tsrx-local-component-name-catalog');
 		expect(suites).toEqual(BENCHMARK_SUITES);
 
 		// The public MCP schema must accept every runner suite, not just keep