@opentui/react 0.2.0 → 0.2.2

package/{chunk-81sn2skb.js → chunk-42jvgte5.js}

@@ -166,7 +166,7 @@ import { TextNodeRenderable as TextNodeRenderable2 } from "@opentui/core";
 // package.json
 var package_default = {
   name: "@opentui/react",
-  version: "0.2.0",
+  version: "0.2.2",
   description: "React renderer for building terminal user interfaces using OpenTUI core",
   license: "MIT",
   repository: {
@@ -191,6 +191,10 @@ var package_default = {
       import: "./scripts/runtime-plugin-support.ts",
       types: "./scripts/runtime-plugin-support.ts"
     },
+    "./runtime-plugin-support/configure": {
+      import: "./scripts/runtime-plugin-support-configure.ts",
+      types: "./scripts/runtime-plugin-support-configure.ts"
+    },
     "./jsx-runtime": {
       import: "./jsx-runtime.js",
       types: "./jsx-runtime.d.ts"

package/index.js

@@ -11,7 +11,7 @@ import {
   getComponentCatalogue,
   jsxDEV,
   useAppContext
-} from "./chunk-81sn2skb.js";
+} from "./chunk-42jvgte5.js";
 import"./chunk-2mx7fq49.js";
 // src/hooks/use-keyboard.ts
 import { useEffect } from "react";

package/package.json

@@ -4,7 +4,7 @@
   "main": "index.js",
   "types": "src/index.d.ts",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "React renderer for building terminal user interfaces using OpenTUI core",
   "license": "MIT",
   "repository": {
@@ -32,6 +32,10 @@
       "types": "./scripts/runtime-plugin-support.d.ts",
       "import": "./scripts/runtime-plugin-support.ts"
     },
+    "./runtime-plugin-support/configure": {
+      "types": "./scripts/runtime-plugin-support-configure.d.ts",
+      "import": "./scripts/runtime-plugin-support-configure.ts"
+    },
     "./jsx-runtime": {
       "types": "./jsx-runtime.d.ts",
       "import": "./jsx-runtime.js",
@@ -44,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@opentui/core": "0.2.0",
+    "@opentui/core": "0.2.2",
     "react-reconciler": "^0.32.0"
   },
   "devDependencies": {

package/scripts/runtime-plugin-support-configure.d.ts

@@ -0,0 +1,7 @@
+import { type RuntimeModuleEntry, type RuntimePluginRewriteOptions } from "@opentui/core/runtime-plugin";
+export interface ReactRuntimePluginSupportOptions {
+    additional?: Record<string, RuntimeModuleEntry>;
+    core?: RuntimeModuleEntry;
+    rewrite?: RuntimePluginRewriteOptions;
+}
+export declare function ensureRuntimePluginSupport(options?: ReactRuntimePluginSupportOptions): boolean;

package/scripts/runtime-plugin-support-configure.ts

@@ -0,0 +1,99 @@
+import { plugin as registerBunPlugin } from "bun"
+import * as coreRuntime from "@opentui/core"
+import {
+  createRuntimePlugin,
+  type RuntimeModuleEntry,
+  type RuntimePluginRewriteOptions,
+} from "@opentui/core/runtime-plugin"
+import * as reactRuntime from "react"
+import * as reactJsxRuntime from "react/jsx-runtime"
+import * as reactJsxDevRuntime from "react/jsx-dev-runtime"
+import * as opentuiReactRuntime from "../index.js"
+
+const runtimePluginSupportInstalledKey = "__opentuiReactRuntimePluginSupportInstalled__"
+
+export interface ReactRuntimePluginSupportOptions {
+  additional?: Record<string, RuntimeModuleEntry>
+  core?: RuntimeModuleEntry
+  rewrite?: RuntimePluginRewriteOptions
+}
+
+interface RuntimePluginSupportInstall {
+  specifiers: ReadonlySet<string>
+  core: RuntimeModuleEntry
+  rewriteKey: string
+}
+
+type RuntimePluginSupportState = typeof globalThis & {
+  [runtimePluginSupportInstalledKey]?: RuntimePluginSupportInstall
+}
+
+const defaultRuntimeModules: Record<string, RuntimeModuleEntry> = {
+  "@opentui/react": opentuiReactRuntime as Record<string, unknown>,
+  "@opentui/react/jsx-runtime": reactJsxRuntime as Record<string, unknown>,
+  "@opentui/react/jsx-dev-runtime": reactJsxDevRuntime as Record<string, unknown>,
+  react: reactRuntime as Record<string, unknown>,
+  "react/jsx-runtime": reactJsxRuntime as Record<string, unknown>,
+  "react/jsx-dev-runtime": reactJsxDevRuntime as Record<string, unknown>,
+}
+
+function normalizeRewriteKey(rewrite: RuntimePluginRewriteOptions | undefined): string {
+  return `${rewrite?.nodeModulesRuntimeSpecifiers ?? true}:${rewrite?.nodeModulesBareSpecifiers ?? false}`
+}
+
+function createRuntimeModules(options?: ReactRuntimePluginSupportOptions): Record<string, RuntimeModuleEntry> {
+  return {
+    ...defaultRuntimeModules,
+    ...(options?.additional ?? {}),
+  }
+}
+
+function assertCompatibleInstall(
+  install: RuntimePluginSupportInstall,
+  modules: Record<string, RuntimeModuleEntry>,
+  options?: ReactRuntimePluginSupportOptions,
+): void {
+  for (const specifier of Object.keys(modules)) {
+    if (!install.specifiers.has(specifier)) {
+      throw new Error(
+        `OpenTUI React runtime plugin support is already installed without ${specifier}. Call ensureRuntimePluginSupport({ additional }) from @opentui/react/runtime-plugin-support/configure before importing @opentui/react/runtime-plugin-support.`,
+      )
+    }
+  }
+
+  if (options?.core && options.core !== install.core) {
+    throw new Error("OpenTUI React runtime plugin support is already installed with a different core runtime module.")
+  }
+
+  if (options?.rewrite && normalizeRewriteKey(options.rewrite) !== install.rewriteKey) {
+    throw new Error("OpenTUI React runtime plugin support is already installed with different rewrite options.")
+  }
+}
+
+export function ensureRuntimePluginSupport(options: ReactRuntimePluginSupportOptions = {}): boolean {
+  const state = globalThis as RuntimePluginSupportState
+  const modules = createRuntimeModules(options)
+  const core = options.core ?? (coreRuntime as Record<string, unknown>)
+  const rewriteKey = normalizeRewriteKey(options.rewrite)
+
+  const install = state[runtimePluginSupportInstalledKey]
+  if (install) {
+    assertCompatibleInstall(install, modules, options)
+    return false
+  }
+
+  registerBunPlugin(
+    createRuntimePlugin({
+      core,
+      additional: modules,
+      rewrite: options.rewrite,
+    }),
+  )
+
+  state[runtimePluginSupportInstalledKey] = {
+    specifiers: new Set(Object.keys(modules)),
+    core,
+    rewriteKey,
+  }
+  return true
+}

package/scripts/runtime-plugin-support.d.ts

@@ -1 +1,3 @@
-export declare function ensureRuntimePluginSupport(): boolean;
+import { ensureRuntimePluginSupport } from "./runtime-plugin-support-configure.js";
+export { ensureRuntimePluginSupport };
+export type { ReactRuntimePluginSupportOptions } from "./runtime-plugin-support-configure.js";

package/scripts/runtime-plugin-support.ts

@@ -1,42 +1,6 @@
-import { plugin as registerBunPlugin } from "bun"
-import * as coreRuntime from "@opentui/core"
-import { createRuntimePlugin, type RuntimeModuleEntry } from "@opentui/core/runtime-plugin"
-import * as reactRuntime from "react"
-import * as reactJsxRuntime from "react/jsx-runtime"
-import * as reactJsxDevRuntime from "react/jsx-dev-runtime"
-import * as opentuiReactRuntime from "../index.js"
+import { ensureRuntimePluginSupport } from "./runtime-plugin-support-configure.js"
 
-const runtimePluginSupportInstalledKey = "__opentuiReactRuntimePluginSupportInstalled__"
-
-type RuntimePluginSupportState = typeof globalThis & {
-  [runtimePluginSupportInstalledKey]?: boolean
-}
-
-const additionalRuntimeModules: Record<string, RuntimeModuleEntry> = {
-  "@opentui/react": opentuiReactRuntime as Record<string, unknown>,
-  "@opentui/react/jsx-runtime": reactJsxRuntime as Record<string, unknown>,
-  "@opentui/react/jsx-dev-runtime": reactJsxDevRuntime as Record<string, unknown>,
-  react: reactRuntime as Record<string, unknown>,
-  "react/jsx-runtime": reactJsxRuntime as Record<string, unknown>,
-  "react/jsx-dev-runtime": reactJsxDevRuntime as Record<string, unknown>,
-}
-
-export function ensureRuntimePluginSupport(): boolean {
-  const state = globalThis as RuntimePluginSupportState
-
-  if (state[runtimePluginSupportInstalledKey]) {
-    return false
-  }
-
-  registerBunPlugin(
-    createRuntimePlugin({
-      core: coreRuntime as Record<string, unknown>,
-      additional: additionalRuntimeModules,
-    }),
-  )
-
-  state[runtimePluginSupportInstalledKey] = true
-  return true
-}
+export { ensureRuntimePluginSupport }
+export type { ReactRuntimePluginSupportOptions } from "./runtime-plugin-support-configure.js"
 
 ensureRuntimePluginSupport()

package/test-utils.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   createRoot
-} from "./chunk-81sn2skb.js";
+} from "./chunk-42jvgte5.js";
 import"./chunk-2mx7fq49.js";
 
 // src/test-utils.ts