@portel/photon 1.20.0 → 1.21.0

package/dist/tsx-compiler.js

@@ -0,0 +1,221 @@
+/**
+ * TSX View Compiler
+ *
+ * Transpiles and bundles .tsx view files into self-contained HTML documents
+ * using esbuild. Ships a tiny built-in JSX runtime (~1KB) that maps directly
+ * to DOM calls — no React, no Preact, no virtual DOM.
+ *
+ * Users can override with `@jsxImportSource` pragma or tsconfig.json in the
+ * ui/ folder to use React/Preact/Solid if they prefer.
+ */
+import * as esbuild from 'esbuild';
+import * as fs from 'fs';
+import * as fsAsync from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+// ─── Built-in JSX Runtime ──────────────────────────────────────────────────
+// Tiny DOM-based JSX factory. `h()` returns real DOM nodes, not virtual nodes.
+// Injected into every TSX build unless the user overrides via tsconfig.
+const JSX_RUNTIME = `
+export function h(type, props, ...children) {
+  if (type === Fragment) {
+    const frag = document.createDocumentFragment();
+    _append(frag, children);
+    return frag;
+  }
+  if (typeof type === 'function') {
+    return type(Object.assign({}, props, { children: children.length <= 1 ? children[0] : children }));
+  }
+  const el = document.createElement(type);
+  if (props) {
+    for (const [k, v] of Object.entries(props)) {
+      if (k === 'children' || v == null || v === false) continue;
+      if (k.startsWith('on') && typeof v === 'function') {
+        el.addEventListener(k[2].toLowerCase() + k.slice(3), v);
+      } else if (k === 'style' && typeof v === 'object') {
+        Object.assign(el.style, v);
+      } else if (k === 'className') {
+        el.setAttribute('class', v);
+      } else if (k === 'htmlFor') {
+        el.setAttribute('for', v);
+      } else if (k === 'dangerouslySetInnerHTML') {
+        el.innerHTML = v.__html;
+      } else if (v === true) {
+        el.setAttribute(k, '');
+      } else {
+        el.setAttribute(k, String(v));
+      }
+    }
+  }
+  _append(el, children);
+  return el;
+}
+
+export function Fragment() {}
+
+export function _append(parent, children) {
+  for (const child of children) {
+    if (child == null || child === false || child === true) continue;
+    if (Array.isArray(child)) { _append(parent, child); continue; }
+    parent.append(typeof child === 'object' ? child : String(child));
+  }
+}
+
+export function render(element, container) {
+  if (typeof container === 'string') container = document.querySelector(container);
+  container.replaceChildren(element);
+  return element;
+}
+`.trim();
+// Write runtime to a temp file once per process for esbuild inject
+let _runtimePath = null;
+function getRuntimePath() {
+    if (!_runtimePath) {
+        _runtimePath = path.join(os.tmpdir(), `photon-jsx-runtime-${process.pid}.js`);
+        fs.writeFileSync(_runtimePath, JSX_RUNTIME);
+    }
+    return _runtimePath;
+}
+// In-memory cache: filePath → { mtimeMs, html }
+const cache = new Map();
+/**
+ * Find the nearest tsconfig.json walking up from startDir.
+ * Stops at the photon asset folder root (parent of ui/).
+ */
+function findTsconfig(startDir) {
+    let dir = startDir;
+    const root = path.dirname(dir); // stop at parent of ui/
+    while (true) {
+        const candidate = path.join(dir, 'tsconfig.json');
+        if (fs.existsSync(candidate))
+            return candidate;
+        if (dir === root || dir === path.dirname(dir))
+            break;
+        dir = path.dirname(dir);
+    }
+    return undefined;
+}
+/**
+ * Build esbuild options for a TSX file.
+ * Uses built-in DOM-based JSX runtime by default.
+ * Users can override via tsconfig.json (jsx/jsxImportSource settings).
+ */
+function buildOptions(filePath, tsconfigPath) {
+    const uiDir = path.dirname(filePath);
+    // If user has a tsconfig, let it control JSX settings
+    // Otherwise use our built-in runtime via inject
+    const hasUserTsconfig = !!tsconfigPath;
+    return {
+        entryPoints: [filePath],
+        bundle: true,
+        write: false,
+        format: 'esm',
+        platform: 'browser',
+        target: 'es2020',
+        // Built-in runtime: classic transform with injected h/Fragment
+        ...(!hasUserTsconfig
+            ? {
+                jsx: 'transform',
+                jsxFactory: 'h',
+                jsxFragment: 'Fragment',
+                inject: [getRuntimePath()],
+            }
+            : {
+                // Let tsconfig control jsx mode and import source
+                tsconfig: tsconfigPath,
+            }),
+        nodePaths: [
+            path.join(uiDir, 'node_modules'),
+            path.join(uiDir, '..', 'node_modules'),
+            path.join(uiDir, '..', '..', 'node_modules'),
+            path.join(uiDir, '..', '..', '..', 'node_modules'),
+        ],
+        logLevel: 'silent',
+    };
+}
+/**
+ * Wrap bundled JS in a self-contained HTML document.
+ */
+function wrapInHtml(js) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<style>*, *::before, *::after { box-sizing: border-box; } body { margin: 0; font-family: system-ui, -apple-system, sans-serif; }</style>
+</head>
+<body>
+<div id="root"></div>
+<script type="module">
+${js}
+</script>
+</body>
+</html>`;
+}
+/**
+ * Wrap an esbuild error in a developer-friendly HTML error page.
+ */
+function wrapError(filePath, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const escaped = message.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<style>
+body { margin: 0; padding: 24px; font-family: ui-monospace, monospace; background: #1a0000; color: #ff6b6b; }
+h2 { margin: 0 0 16px; font-size: 14px; color: #ff4444; }
+pre { white-space: pre-wrap; word-break: break-word; font-size: 13px; line-height: 1.5; }
+.file { color: #888; font-size: 12px; margin-bottom: 8px; }
+</style>
+</head>
+<body>
+<h2>TSX Build Error</h2>
+<div class="file">${path.basename(filePath)}</div>
+<pre>${escaped}</pre>
+</body>
+</html>`;
+}
+/**
+ * Compile a TSX file into a self-contained HTML document.
+ */
+export async function compileTsx(filePath) {
+    const tsconfigPath = findTsconfig(path.dirname(filePath));
+    try {
+        const result = await esbuild.build(buildOptions(filePath, tsconfigPath));
+        const js = result.outputFiles?.[0]?.text ?? '';
+        return wrapInHtml(js);
+    }
+    catch (err) {
+        return wrapError(filePath, err);
+    }
+}
+/**
+ * Compile with mtime-based caching. Re-transpiles only when the file changes.
+ */
+export async function compileTsxCached(filePath) {
+    const stat = await fsAsync.stat(filePath);
+    const cached = cache.get(filePath);
+    if (cached && cached.mtimeMs === stat.mtimeMs) {
+        return cached.html;
+    }
+    const html = await compileTsx(filePath);
+    cache.set(filePath, { mtimeMs: stat.mtimeMs, html });
+    return html;
+}
+/**
+ * Synchronous variant for the build command (uses esbuild.buildSync).
+ */
+export function compileTsxSync(filePath) {
+    const tsconfigPath = findTsconfig(path.dirname(filePath));
+    try {
+        const result = esbuild.buildSync(buildOptions(filePath, tsconfigPath));
+        const js = result.outputFiles?.[0]?.text ?? '';
+        return wrapInHtml(js);
+    }
+    catch (err) {
+        return wrapError(filePath, err);
+    }
+}
+//# sourceMappingURL=tsx-compiler.js.map

package/dist/tsx-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsx-compiler.js","sourceRoot":"","sources":["../src/tsx-compiler.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portel/photon",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "You focus on the business logic. We'll enable the rest. Build MCP servers and CLI tools in a single TypeScript file.",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,7 @@
   ],
   "scripts": {
     "prepare": "git config core.hooksPath .githooks || true",
-    "build": "eslint src/ --quiet && tsc && cp -r src/photons dist/ && chmod +x dist/cli.js && tsx scripts/build-beam.ts",
+    "build": "eslint src/ --quiet && tsc && cp -r src/photons dist/ && chmod +x dist/cli.js && node scripts/build-beam.mjs",
     "dev": "tsc --watch",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
@@ -22,9 +22,9 @@
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "typecheck": "tsc --noEmit",
-    "build:beam": "tsx scripts/build-beam.ts",
-    "watch:beam": "tsx scripts/build-beam.ts --watch",
-    "dev:beam": "npm run build && npm run build:beam && (trap 'kill 0' EXIT; tsc --watch --preserveWatchOutput & tsx scripts/build-beam.ts --watch & sleep 1 && tsx watch src/cli.ts beam)",
+    "build:beam": "node scripts/build-beam.mjs",
+    "watch:beam": "node scripts/build-beam.mjs --watch",
+    "dev:beam": "npm run build && npm run build:beam && (trap 'kill 0' EXIT; tsc --watch --preserveWatchOutput & node scripts/build-beam.mjs --watch & sleep 1 && tsx watch src/cli.ts beam)",
     "prepublishOnly": "node -e \"const p=require('./package.json'); if(JSON.stringify(p.dependencies).includes('file:')) { console.error('ERROR: file: dependency found.'); process.exit(1); }\" && node -e \"const fs=require('fs'),path=require('path'); const p=require('./package.json'); for(const d of Object.keys(p.dependencies||{})){const t=path.join('node_modules',d); if(fs.lstatSync(t).isSymbolicLink()){console.error('ERROR: '+d+' is npm-linked. Run: npm unlink '+d+' && npm install '+d); process.exit(1);}}\" && npm run build && npm run build:beam",
     "test": "bash scripts/run-tests.sh",
     "test:chain": "npm run test:all",
@@ -112,7 +112,7 @@
     "@modelcontextprotocol/ext-apps": "^1.0.1",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@portel/cli": "^1.1.0",
-    "@portel/photon-core": "^2.18.0",
+    "@portel/photon-core": "^2.19.1",
     "boxen": "^8.0.1",
     "chalk": "^5.4.1",
     "chart.js": "^4.5.1",
@@ -120,7 +120,7 @@
     "cli-highlight": "^2.1.11",
     "cli-table3": "^0.6.5",
     "commander": "^12.1.0",
-    "esbuild": "^0.27.0",
+    "esbuild": "^0.28.0",
     "fast-json-patch": "^3.1.1",
     "ora": "^9.3.0",
     "qrcode": "^1.5.4"