@ultimat3/render 27.16.0 → 28.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/render",
-  "version": "27.16.0",
+  "version": "28.0.0",
   "description": "The route primitive and the five render modes: static, isr, ssr, stream, spa.",
   "license": "MIT",
   "type": "module",
@@ -33,18 +33,18 @@
     "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.4.2"
+    "bun": ">=1.4.3"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/cache": "27.16.0",
-    "@ultimat3/core": "27.16.0",
-    "@ultimat3/http": "27.16.0",
-    "@ultimat3/i18n": "27.16.0",
-    "@ultimat3/seo": "27.16.0",
+    "@ultimat3/cache": "28.0.0",
+    "@ultimat3/core": "28.0.0",
+    "@ultimat3/http": "28.0.0",
+    "@ultimat3/i18n": "28.0.0",
+    "@ultimat3/seo": "28.0.0",
     "sass": "1.105.1"
   }
 }

package/src/module-loader.ts

@@ -12,11 +12,15 @@ import type { Surface } from './surfaces';
 import { surfaceUnder } from './surfaces';
 
 /**
- * Why a transform at all: `tsconfig.json` says `jsx: 'preserve'`, which makes Bun fall back to the
- * CLASSIC React factory and ignore `jsxImportSource` entirely — every `.tsx` in an Ultimate app
- * compiles to `React.createElement` against a global that does not exist. `jsxImportSource` stays
- * pointed at `solid-js` because that is where the JSX *type* namespace lives (`class`, not
- * `className`); the *runtime* factory is the framework's, and an app never configures one.
+ * Why a transform at all: Bun's own compile of a `.tsx` under the app's `tsconfig.json` (`jsx:
+ * 'preserve'`, `jsxImportSource: 'solid-js'`) is wrong on every Bun. Through 1.4.2 it fell back to
+ * the CLASSIC React factory — `React.createElement` against a global that does not exist. From
+ * 1.4.3 it honours `jsxImportSource` and imports `jsxDEV` from `solid-js/jsx-dev-runtime`, which
+ * solid-js maps to a module exporting no such name: a link-time `SyntaxError` (issue #883,
+ * measured on 1.3.14 and 1.4.3). Solid ships no runtime factory because its JSX is a COMPILE-time
+ * contract. `jsxImportSource` stays pointed at `solid-js` because that is where the JSX *type*
+ * namespace lives (`class`, not `className`); the *runtime* factory is the framework's, every graph
+ * that loads a `.tsx` installs this transform or the island one, and an app never configures one.
  */
 const JSX_FACTORY = '__xh';
 const JSX_FRAGMENT = '__xFragment';
@@ -57,7 +61,8 @@ export const JSX_FACTORY_SPECIFIER = ((): string => {
 })();
 
 /** No newline: the prelude shares line 1 with the file's own first line, so stack traces still point at it. */
-const JSX_PRELUDE = `import { h as ${JSX_FACTORY}, Fragment as ${JSX_FRAGMENT} } from ${JSON.stringify(JSX_FACTORY_SPECIFIER)};`;
+const jsxPrelude = (factory: string): string =>
+  `import { h as ${JSX_FACTORY}, Fragment as ${JSX_FRAGMENT} } from ${JSON.stringify(factory)};`;
 
 const transpiler = new Bun.Transpiler({
   loader: 'tsx',
@@ -244,11 +249,14 @@ export function stylesheetOrder(a: Stylesheet, b: Stylesheet): number {
 /**
  * `.tsx` source → JS calling the server factory. Exported so the transform is testable as a pure
  * function: the plugin below is the six lines of glue that hand it a file.
+ *
+ * `factory` is the specifier the prelude imports `h` from: the runtime loader's resolved URL by
+ * default, and the PATH that URL names for a bundler (`tsx-build-plugin.ts` says why).
  */
-export function transformTsx(source: string): string {
+export function transformTsx(source: string, factory: string = JSX_FACTORY_SPECIFIER): string {
   // No newline between: the prelude shares line 1 with the file's own first line, so every stack
   // trace and every reported error still points at the line the author wrote.
-  return JSX_PRELUDE + transpiler.transformSync(source);
+  return jsxPrelude(factory) + transpiler.transformSync(source);
 }
 
 /**

package/src/server.ts

@@ -89,3 +89,4 @@ export {
 } from './render-stream';
 // ---- the Sass compile cache: where it lives, and how often this process ran Sass instead --------
 export { sassCompilations, setSassCacheDir } from './sass-cache';
+export { serverTsxBuildPlugin } from './tsx-build-plugin';

package/src/tsx-build-plugin.ts

@@ -0,0 +1,34 @@
+/**
+ * The server `.tsx` transform as a `Bun.build` plugin: what a bundle that carries server code —
+ * the compiled `x` executable, a module-graph measurement — hands the bundler so a `.tsx` it
+ * reaches compiles to the server factory, the same output the runtime loader gives that file.
+ */
+
+import type { BunPlugin } from 'bun';
+import { JSX_FACTORY_SPECIFIER, transformTsx } from './module-loader';
+
+/**
+ * The PATH the loader's resolved URL names. `Bun.build` does not resolve a `file:` specifier —
+ * measured on 1.4.3, `Could not resolve: "file:///…/packages/render/src/index.ts"` — and resolves an
+ * absolute path. The bare-name fallback (inside a compiled binary) passes through unchanged.
+ */
+const BUILD_FACTORY_SPECIFIER = JSX_FACTORY_SPECIFIER.startsWith('file:')
+  ? Bun.fileURLToPath(JSX_FACTORY_SPECIFIER)
+  : JSX_FACTORY_SPECIFIER;
+
+/**
+ * Without it a bundle compiles each `.tsx` with Bun's own transform, which no Bun gets right
+ * (`module-loader.ts`): 1.4.3 refuses the build outright with `No matching export in
+ * "solid-js/dist/solid.js" for import "jsxDEV"` (issue #883), and earlier Bun shipped a
+ * `React.createElement` nobody defines. Islands do not use this: their graph is a browser's, and
+ * `@ultimat3/cli`'s `solidJsxPlugin` compiles it with Solid.
+ */
+export const serverTsxBuildPlugin: BunPlugin = {
+  name: 'ultimate-render-tsx',
+  setup(build): void {
+    build.onLoad({ filter: /\.tsx$/ }, async ({ path }) => ({
+      contents: transformTsx(await Bun.file(path).text(), BUILD_FACTORY_SPECIFIER),
+      loader: 'js',
+    }));
+  },
+};