feat: expose headless Runtime bindings entrypoint

.changeset/headless-runtime-bindings.md

@@ -0,0 +1,5 @@
+---
+'@ankhorage/runtime': minor
+---
+
+Expose canonical API and binding execution through the package-neutral `@ankhorage/runtime/bindings` entrypoint so headless consumers do not load React Native renderer modules.

knip.config.ts

@@ -1,6 +1,7 @@
 import { createKnipConfig } from '@ankhorage/devtools/knip';
 
 export default createKnipConfig({
+  entry: ['src/index.ts', 'src/bindings.ts'],
   ignoreFiles: [
     'eslint.config.mjs',
     'paradox.config.ts',

package.json

@@ -31,6 +31,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./bindings": {
+      "types": "./dist/bindings.d.ts",
+      "import": "./dist/bindings.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [

src/bindings.test.ts

@@ -0,0 +1,33 @@
+import { readFile } from 'node:fs/promises';
+
+import { expect, test } from 'bun:test';
+
+import {
+  createRuntimeApiOperationExecutor,
+  createRuntimeBindingOperationKey,
+  resolveRuntimeBindingValue,
+  validateRuntimeBindingOperationRef,
+} from './bindings';
+
+test('headless bindings entrypoint exposes canonical Runtime API helpers', () => {
+  expect(typeof createRuntimeApiOperationExecutor).toBe('function');
+  expect(typeof createRuntimeBindingOperationKey).toBe('function');
+  expect(typeof resolveRuntimeBindingValue).toBe('function');
+  expect(typeof validateRuntimeBindingOperationRef).toBe('function');
+});
+
+test('package exports headless bindings without renderer modules', async () => {
+  const packageJson = JSON.parse(await readFile('package.json', 'utf8')) as {
+    readonly exports?: Readonly<Record<string, unknown>>;
+  };
+  const source = await readFile('src/bindings.ts', 'utf8');
+
+  expect(packageJson.exports?.['./bindings']).toEqual({
+    types: './dist/bindings.d.ts',
+    import: './dist/bindings.js',
+  });
+  expect(source).not.toContain('RuntimeRenderer');
+  expect(source).not.toContain('RuntimeScreen');
+  expect(source).not.toContain('react-native');
+  expect(source).not.toContain("from 'react'");
+});

src/bindings.ts

@@ -0,0 +1,23 @@
+export type { RuntimeApiOperationExecutorOptions } from './runtimeApiOperations';
+export { createRuntimeApiOperationExecutor } from './runtimeApiOperations';
+export type { RuntimeApiOperationSelection } from './runtimeApiSelection';
+export { validateRuntimeBindingOperationRef } from './runtimeApiSelection';
+export type {
+  RuntimeBindingOperationExecutionArgs,
+  RuntimeBindingOperationExecutionResult,
+  RuntimeBindingOperationExecutor,
+  RuntimeBindingOperationKey,
+  RuntimeBindingOperationResultCache,
+  RuntimeBindingOperationResultWriter,
+  RuntimeBindingResolutionArgs,
+  RuntimeBindingResolutionContext,
+  RuntimeBindingResolutionResult,
+} from './runtimeBindings';
+export {
+  createRuntimeBindingOperationKey,
+  resolveBindingInputMap,
+  resolveRuntimeBindings,
+  resolveRuntimeBindingsAsync,
+  resolveRuntimeBindingValue,
+  resolveRuntimeBindingValueSync,
+} from './runtimeBindings';