create-aziz-app 3.1.1 → 3.1.3

package/template/scripts/lib/js-transform.js

@@ -1,141 +1,213 @@
-// ============================================================
-//  Aziz.js — JS/JSX transform pipeline (server-side)
-//  - JSX → h() calls via @babel/standalone
-//  - Bare / @/ import rewriting to browser-servable URLs
-//  - mtime-based transform cache (big dev-server speed win)
-// ============================================================
-
-const path = require('path');
-const fs = require('fs');
-
-// ─── Babel loading (with fallback resolution for monorepos/tests) ───
-let Babel = null;
-try {
-    Babel = require('@babel/standalone');
-} catch (e) {
-    const fallbacks = [
-        path.join(__dirname, '..', '..', 'node_modules', '@babel', 'standalone'),
-        path.join(process.cwd(), 'node_modules', '@babel', 'standalone'),
-    ];
-    for (const fb of fallbacks) {
-        try { Babel = require(fb); break; } catch { /* keep looking */ }
-    }
-}
-
-function hasBabel() {
-    return !!Babel;
-}
-
-// ─── JSX transform ───────────────────────────────────────────
-
-function isFrameworkPath(filePath) {
-    return filePath.includes('/_framework/') || filePath.includes('\\_framework\\');
-}
-
-function transformJSX(code, filename) {
-    if (!Babel) return code;
-    const result = Babel.transform(code, {
-        filename,
-        presets: [
-            ['react', { pragma: 'h', pragmaFrag: 'Fragment' }]
-        ],
-        plugins: [],
-        sourceType: 'module',
-    });
-    return result.code;
-}
-
-// ─── Import rewriting ─────────────────────────────────────────
-//  import X from 'mongoose'      → '/_modules/mongoose'
-//  import X from '@/lib/db'      → '/lib/db'
-//  import X from '/absolute.js'  → unchanged
-//  import('pkg')                 → import('/_modules/pkg')
-//
-// Runs on the whole module (not line-by-line) so multi-line
-// import statements are handled correctly.
-
-function isRelativeOrAbsolute(spec) {
-    return spec.startsWith('/') ||
-           spec.startsWith('./') ||
-           spec.startsWith('../') ||
-           spec.startsWith('#') ||
-           spec.startsWith('node:') ||
-           spec.startsWith('data:') ||
-           spec.startsWith('file:') ||
-           /^https?:\/\//.test(spec);
-}
-
-function mapSpecifier(spec) {
-    if (isRelativeOrAbsolute(spec)) return spec;
-    if (spec.startsWith('@/')) return '/' + spec.slice(2);
-    return '/_modules/' + spec;
-}
-
-function rewriteImports(code) {
-    // from 'specifier'  (covers `import ... from`, `export ... from`)
-    code = code.replace(/(\bfrom\s*)(['"])([^'"\n]+)\2/g, (m, from, q, spec) => {
-        const mapped = mapSpecifier(spec);
-        return mapped === spec ? m : `${from}${q}${mapped}${q}`;
-    });
-
-    // side-effect imports: import 'specifier';
-    // (requires the quote right after `import`, so `import(` is not matched)
-    code = code.replace(/(\bimport\s+)(['"])([^'"\n]+)\2/g, (m, kw, q, spec) => {
-        const mapped = mapSpecifier(spec);
-        return mapped === spec ? m : `${kw}${q}${mapped}${q}`;
-    });
-
-    // dynamic imports: import('specifier')
-    code = code.replace(/(\bimport\s*\(\s*)(['"])([^'"\n]+)\2(\s*\))/g, (m, pre, q, spec, post) => {
-        const mapped = mapSpecifier(spec);
-        return mapped === spec ? m : `${pre}${q}${mapped}${q}${post}`;
-    });
-
-    return code;
-}
-
-// ─── mtime-keyed transform cache ─────────────────────────────
-
-const cache = new Map(); // filePath → { mtimeMs, code }
-
-function transformModule(code, filePath, mtimeMs) {
-    // Framework internals contain no JSX and only use absolute imports.
-    if (isFrameworkPath(filePath)) return code;
-
-    const hit = cache.get(filePath);
-    if (hit && hit.mtimeMs === mtimeMs) return hit.code;
-
-    let out;
-    try {
-        out = transformJSX(code, path.basename(filePath));
-    } catch (err) {
-        console.error(`❌ JSX transform error in ${filePath}:`, err.message);
-        out = `throw new Error(${JSON.stringify('JSX transform error in ' + filePath + ': ' + err.message)});`;
-    }
-    out = rewriteImports(out);
-    cache.set(filePath, { mtimeMs, code: out });
-    return out;
-}
-
-function invalidate(filePath) {
-    cache.delete(filePath);
-}
-
-function clearCache() {
-    cache.clear();
-}
-
-function cacheSize() {
-    return cache.size;
-}
-
-module.exports = {
-    hasBabel,
-    transformJSX,
-    rewriteImports,
-    transformModule,
-    invalidate,
-    clearCache,
-    cacheSize,
-    isFrameworkPath,
-};
+// ============================================================
+//  Aziz.js — JS/JSX transform pipeline (server-side)
+//  - JSX → h() calls via @babel/standalone
+//  - Bare / @/ import rewriting to browser-servable URLs
+//  - mtime-based transform cache (big dev-server speed win)
+// ============================================================
+
+const path = require('path');
+const fs = require('fs');
+
+// ─── Babel loading (with fallback resolution for monorepos/tests) ───
+let Babel = null;
+try {
+    Babel = require('@babel/standalone');
+} catch (e) {
+    const fallbacks = [
+        path.join(__dirname, '..', '..', 'node_modules', '@babel', 'standalone'),
+        path.join(process.cwd(), 'node_modules', '@babel', 'standalone'),
+    ];
+    for (const fb of fallbacks) {
+        try { Babel = require(fb); break; } catch { /* keep looking */ }
+    }
+}
+
+function hasBabel() {
+    return !!Babel;
+}
+
+// Thrown whenever a module needs compiling but Babel is unavailable.
+// Never fall back to the untransformed source: the browser cannot execute
+// JSX, the module import rejects, and the router silently renders its
+// built-in 404 — a missing dependency disguised as a routing bug.
+const BABEL_MISSING_MESSAGE =
+    '@babel/standalone is not installed, so JSX cannot be compiled. ' +
+    'Run "npm install" in the project folder, then restart the dev server.';
+
+// ─── JSX transform ───────────────────────────────────────────
+
+function isFrameworkPath(filePath) {
+    return filePath.includes('/_framework/') || filePath.includes('\\_framework\\');
+}
+
+function transformJSX(code, filename) {
+    if (!Babel) throw new Error(BABEL_MISSING_MESSAGE);
+    const result = Babel.transform(code, {
+        filename,
+        presets: [
+            // runtime: 'classic' is required. Babel 8 defaults to the automatic
+            // runtime, which rejects an explicit pragma ("pragma and pragmaFrag
+            // cannot be set when runtime is automatic"). We compile to the
+            // global `h`/`Fragment` that boot.js installs, not to jsx-runtime.
+            ['react', { runtime: 'classic', pragma: 'h', pragmaFrag: 'Fragment' }]
+        ],
+        plugins: [],
+        sourceType: 'module',
+    });
+    return result.code;
+}
+
+// ─── Import rewriting ─────────────────────────────────────────
+//  import X from 'mongoose'      → '/_modules/mongoose'
+//  import X from '@/lib/db'      → '/lib/db'
+//  import X from '/absolute.js'  → unchanged
+//  import('pkg')                 → import('/_modules/pkg')
+//
+// Runs on the whole module (not line-by-line) so multi-line
+// import statements are handled correctly.
+//
+// Only keywords sitting in CODE position are rewritten. A `from`
+// or `import` inside a string literal / template literal / comment
+// is prose (e.g. documentation text in JSX) and must be left alone
+// — rewriting it corrupts the module and the page fails to load.
+
+// Uint8Array marking every character that is in code position
+// (outside string literals, template literals and comments).
+function codePositions(code) {
+    const n = code.length;
+    const isCode = new Uint8Array(n);
+    const stack = [];          // '{' for blocks, 'tpl' for ${ … } in templates
+    let mode = 'code';         // code | ' | " | ` | // | /*
+    let i = 0;
+
+    while (i < n) {
+        const c = code[i];
+
+        if (mode === 'code') {
+            isCode[i] = 1;
+            if (c === '\\') { i += 2; continue; }
+            if (c === "'" || c === '"' || c === '`') mode = c;
+            else if (c === '/' && code[i + 1] === '/') mode = '//';
+            else if (c === '/' && code[i + 1] === '*') mode = '/*';
+            else if (c === '{') stack.push('{');
+            else if (c === '}') { if (stack.pop() === 'tpl') mode = '`'; }
+            i++;
+        } else if (mode === "'" || mode === '"' || mode === '`') {
+            if (c === '\\') { i += 2; continue; }
+            if (c === mode) mode = 'code';
+            else if (mode === '`' && c === '$' && code[i + 1] === '{') {
+                stack.push('tpl');
+                mode = 'code';
+                isCode[i] = 1;
+                isCode[i + 1] = 1;
+                i += 2;
+                continue;
+            }
+            i++;
+        } else if (mode === '//') {
+            if (c === '\n') mode = 'code';
+            i++;
+        } else { // block comment
+            if (c === '*' && code[i + 1] === '/') { mode = 'code'; i += 2; continue; }
+            i++;
+        }
+    }
+    return isCode;
+}
+
+function isRelativeOrAbsolute(spec) {
+    return spec.startsWith('/') ||
+           spec.startsWith('./') ||
+           spec.startsWith('../') ||
+           spec.startsWith('#') ||
+           spec.startsWith('node:') ||
+           spec.startsWith('data:') ||
+           spec.startsWith('file:') ||
+           /^https?:\/\//.test(spec);
+}
+
+function mapSpecifier(spec) {
+    if (isRelativeOrAbsolute(spec)) return spec;
+    if (spec.startsWith('@/')) return '/' + spec.slice(2);
+    return '/_modules/' + spec;
+}
+
+function rewriteImports(code) {
+    const isCode = codePositions(code);
+
+    // from 'specifier'  (covers `import ... from`, `export ... from`)
+    code = code.replace(/(\bfrom\s*)(['"])([^'"\n]+)\2/g, (m, from, q, spec, offset) => {
+        if (!isCode[offset]) return m;
+        const mapped = mapSpecifier(spec);
+        return mapped === spec ? m : `${from}${q}${mapped}${q}`;
+    });
+
+    // side-effect imports: import 'specifier';
+    // (requires the quote right after `import`, so `import(` is not matched)
+    code = code.replace(/(\bimport\s+)(['"])([^'"\n]+)\2/g, (m, kw, q, spec, offset) => {
+        if (!isCode[offset]) return m;
+        const mapped = mapSpecifier(spec);
+        return mapped === spec ? m : `${kw}${q}${mapped}${q}`;
+    });
+
+    // dynamic imports: import('specifier')
+    code = code.replace(/(\bimport\s*\(\s*)(['"])([^'"\n]+)\2(\s*\))/g, (m, pre, q, spec, post, offset) => {
+        if (!isCode[offset]) return m;
+        const mapped = mapSpecifier(spec);
+        return mapped === spec ? m : `${pre}${q}${mapped}${q}${post}`;
+    });
+
+    return code;
+}
+
+// ─── mtime-keyed transform cache ─────────────────────────────
+
+const cache = new Map(); // filePath → { mtimeMs, code }
+
+function transformModule(code, filePath, mtimeMs) {
+    // Framework internals contain no JSX and only use absolute imports.
+    if (isFrameworkPath(filePath)) return code;
+
+    const hit = cache.get(filePath);
+    if (hit && hit.mtimeMs === mtimeMs) return hit.code;
+
+    let out;
+    try {
+        out = transformJSX(code, path.basename(filePath));
+    } catch (err) {
+        if (err.message === BABEL_MISSING_MESSAGE) {
+            // Startup prints an actionable banner — don't repeat it for every file.
+            out = `throw new Error(${JSON.stringify(BABEL_MISSING_MESSAGE)});`;
+        } else {
+            console.error(`❌ JSX transform error in ${filePath}:`, err.message);
+            out = `throw new Error(${JSON.stringify('JSX transform error in ' + filePath + ': ' + err.message)});`;
+        }
+    }
+    out = rewriteImports(out);
+    cache.set(filePath, { mtimeMs, code: out });
+    return out;
+}
+
+function invalidate(filePath) {
+    cache.delete(filePath);
+}
+
+function clearCache() {
+    cache.clear();
+}
+
+function cacheSize() {
+    return cache.size;
+}
+
+module.exports = {
+    hasBabel,
+    BABEL_MISSING_MESSAGE,
+    transformJSX,
+    rewriteImports,
+    transformModule,
+    invalidate,
+    clearCache,
+    cacheSize,
+    isFrameworkPath,
+};

package/template/scripts/lib/module-resolver.js

@@ -1,132 +1,132 @@
-// ============================================================
-//  Aziz.js — node_modules resolver for browser bare imports
-//  Maps /_modules/<pkg>… to a real file inside node_modules.
-//  Supports: package.json "exports", "browser", "module", "main".
-// ============================================================
-
-const fs = require('fs');
-const path = require('path');
-
-const EXTENSIONS = ['.js', '.mjs', '.cjs', '.json'];
-
-function statIsFile(p) {
-    try { return fs.statSync(p).isFile(); } catch { return false; }
-}
-
-function firstExisting(candidates) {
-    for (const c of candidates) {
-        if (statIsFile(c)) return c;
-        for (const ext of EXTENSIONS) {
-            if (statIsFile(c + ext)) return c + ext;
-        }
-        if (statIsFile(path.join(c, 'index.js'))) return path.join(c, 'index.js');
-    }
-    return null;
-}
-
-// Resolve a value from the "exports" field (string or nested conditions).
-// Condition order prefers browser builds, then ESM, then CJS.
-function resolveExportsValue(value) {
-    if (typeof value === 'string') return value;
-    if (Array.isArray(value)) {
-        for (const v of value) {
-            const r = resolveExportsValue(v);
-            if (r) return r;
-        }
-        return null;
-    }
-    if (value && typeof value === 'object') {
-        for (const cond of ['browser', 'import', 'module', 'default', 'require']) {
-            if (cond in value) {
-                const r = resolveExportsValue(value[cond]);
-                if (r) return r;
-            }
-        }
-    }
-    return null;
-}
-
-function resolveExportsField(exportsField, subPath) {
-    if (!exportsField) return null;
-
-    // "exports": "./index.js"
-    if (typeof exportsField === 'string') {
-        return subPath ? null : exportsField;
-    }
-
-    // Conditional exports at the top level (no subpaths)
-    if (!subPath) {
-        if ('.' in exportsField || Object.keys(exportsField).some(k => k.startsWith('./'))) {
-            return '.' in exportsField ? resolveExportsValue(exportsField['.']) : null;
-        }
-        return resolveExportsValue(exportsField);
-    }
-
-    // Subpath exports
-    const key = './' + subPath;
-    if (key in exportsField) return resolveExportsValue(exportsField[key]);
-
-    // Wildcard patterns: "./*": "./dist/*.js"
-    for (const patternKey of Object.keys(exportsField)) {
-        if (!patternKey.includes('*')) continue;
-        const [pre, post = ''] = patternKey.split('*');
-        if (key.startsWith(pre) && key.endsWith(post) && key.length >= pre.length + post.length) {
-            const star = key.slice(pre.length, key.length - post.length);
-            const target = resolveExportsValue(exportsField[patternKey]);
-            if (target) return target.replace('*', star);
-        }
-    }
-
-    return null;
-}
-
-// Resolve a bare specifier ("pkg", "pkg/sub", "@scope/pkg/sub")
-// to an absolute file path inside ROOT/node_modules.
-function resolveNodeModule(specifier, ROOT) {
-    const parts = specifier.split('/');
-    const isScoped = parts[0].startsWith('@');
-    const pkgName = isScoped ? parts[0] + '/' + parts[1] : parts[0];
-    const subPath = isScoped ? parts.slice(2).join('/') : parts.slice(1).join('/');
-
-    const pkgDir = path.join(ROOT, 'node_modules', pkgName);
-    const pkgJsonPath = path.join(pkgDir, 'package.json');
-    if (!fs.existsSync(pkgJsonPath)) return null;
-
-    let pkg;
-    try {
-        pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
-    } catch {
-        return null;
-    }
-
-    // 1. package.json "exports" (modern packages)
-    if (pkg.exports) {
-        const target = resolveExportsField(pkg.exports, subPath);
-        if (target) {
-            const resolved = firstExisting([path.join(pkgDir, target)]);
-            if (resolved) return resolved;
-        }
-        // "exports" exists but didn't resolve — fall through only when
-        // no subpath was requested, so legacy entry fields can still win.
-        if (subPath) return null;
-    }
-
-    if (subPath) {
-        return firstExisting([
-            path.join(pkgDir, subPath),
-            path.join(pkgDir, 'dist', subPath),
-            path.join(pkgDir, 'src', subPath),
-        ]);
-    }
-
-    // 2. Legacy entry fields: browser (string) → module → main
-    const entries = [];
-    if (typeof pkg.browser === 'string') entries.push(pkg.browser);
-    if (pkg.module) entries.push(pkg.module);
-    if (pkg.main) entries.push(pkg.main);
-    entries.push('index.js');
-
-    return firstExisting(entries.map(e => path.join(pkgDir, e)));
-}
-
-module.exports = { resolveNodeModule, resolveExportsField };
+// ============================================================
+//  Aziz.js — node_modules resolver for browser bare imports
+//  Maps /_modules/<pkg>… to a real file inside node_modules.
+//  Supports: package.json "exports", "browser", "module", "main".
+// ============================================================
+
+const fs = require('fs');
+const path = require('path');
+
+const EXTENSIONS = ['.js', '.mjs', '.cjs', '.json'];
+
+function statIsFile(p) {
+    try { return fs.statSync(p).isFile(); } catch { return false; }
+}
+
+function firstExisting(candidates) {
+    for (const c of candidates) {
+        if (statIsFile(c)) return c;
+        for (const ext of EXTENSIONS) {
+            if (statIsFile(c + ext)) return c + ext;
+        }
+        if (statIsFile(path.join(c, 'index.js'))) return path.join(c, 'index.js');
+    }
+    return null;
+}
+
+// Resolve a value from the "exports" field (string or nested conditions).
+// Condition order prefers browser builds, then ESM, then CJS.
+function resolveExportsValue(value) {
+    if (typeof value === 'string') return value;
+    if (Array.isArray(value)) {
+        for (const v of value) {
+            const r = resolveExportsValue(v);
+            if (r) return r;
+        }
+        return null;
+    }
+    if (value && typeof value === 'object') {
+        for (const cond of ['browser', 'import', 'module', 'default', 'require']) {
+            if (cond in value) {
+                const r = resolveExportsValue(value[cond]);
+                if (r) return r;
+            }
+        }
+    }
+    return null;
+}
+
+function resolveExportsField(exportsField, subPath) {
+    if (!exportsField) return null;
+
+    // "exports": "./index.js"
+    if (typeof exportsField === 'string') {
+        return subPath ? null : exportsField;
+    }
+
+    // Conditional exports at the top level (no subpaths)
+    if (!subPath) {
+        if ('.' in exportsField || Object.keys(exportsField).some(k => k.startsWith('./'))) {
+            return '.' in exportsField ? resolveExportsValue(exportsField['.']) : null;
+        }
+        return resolveExportsValue(exportsField);
+    }
+
+    // Subpath exports
+    const key = './' + subPath;
+    if (key in exportsField) return resolveExportsValue(exportsField[key]);
+
+    // Wildcard patterns: "./*": "./dist/*.js"
+    for (const patternKey of Object.keys(exportsField)) {
+        if (!patternKey.includes('*')) continue;
+        const [pre, post = ''] = patternKey.split('*');
+        if (key.startsWith(pre) && key.endsWith(post) && key.length >= pre.length + post.length) {
+            const star = key.slice(pre.length, key.length - post.length);
+            const target = resolveExportsValue(exportsField[patternKey]);
+            if (target) return target.replace('*', star);
+        }
+    }
+
+    return null;
+}
+
+// Resolve a bare specifier ("pkg", "pkg/sub", "@scope/pkg/sub")
+// to an absolute file path inside ROOT/node_modules.
+function resolveNodeModule(specifier, ROOT) {
+    const parts = specifier.split('/');
+    const isScoped = parts[0].startsWith('@');
+    const pkgName = isScoped ? parts[0] + '/' + parts[1] : parts[0];
+    const subPath = isScoped ? parts.slice(2).join('/') : parts.slice(1).join('/');
+
+    const pkgDir = path.join(ROOT, 'node_modules', pkgName);
+    const pkgJsonPath = path.join(pkgDir, 'package.json');
+    if (!fs.existsSync(pkgJsonPath)) return null;
+
+    let pkg;
+    try {
+        pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+    } catch {
+        return null;
+    }
+
+    // 1. package.json "exports" (modern packages)
+    if (pkg.exports) {
+        const target = resolveExportsField(pkg.exports, subPath);
+        if (target) {
+            const resolved = firstExisting([path.join(pkgDir, target)]);
+            if (resolved) return resolved;
+        }
+        // "exports" exists but didn't resolve — fall through only when
+        // no subpath was requested, so legacy entry fields can still win.
+        if (subPath) return null;
+    }
+
+    if (subPath) {
+        return firstExisting([
+            path.join(pkgDir, subPath),
+            path.join(pkgDir, 'dist', subPath),
+            path.join(pkgDir, 'src', subPath),
+        ]);
+    }
+
+    // 2. Legacy entry fields: browser (string) → module → main
+    const entries = [];
+    if (typeof pkg.browser === 'string') entries.push(pkg.browser);
+    if (pkg.module) entries.push(pkg.module);
+    if (pkg.main) entries.push(pkg.main);
+    entries.push('index.js');
+
+    return firstExisting(entries.map(e => path.join(pkgDir, e)));
+}
+
+module.exports = { resolveNodeModule, resolveExportsField };