create-jen-app 1.2.2 → 1.2.4

package/templates/static/lib/i18n/index.js

@@ -1,32 +1,20 @@
-/*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <https://www.gnu.org/licenses/>.
- */
-import en from "./en.json";
-import es from "./es.json";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const en = JSON.parse(readFileSync(join(__dirname, "./en.json"), "utf-8"));
+const es = JSON.parse(readFileSync(join(__dirname, "./es.json"), "utf-8"));
 const translations = { en, es };
 export class I18n {
-    locale;
-    constructor(defaultLocale = "en") {
-        this.locale = defaultLocale;
-    }
-    setLocale(locale) {
-        this.locale = locale;
-    }
-    t(key) {
-        return translations[this.locale][key] || key;
-    }
+  locale;
+  constructor(defaultLocale = "en") {
+    this.locale = defaultLocale;
+  }
+  setLocale(locale) {
+    this.locale = locale;
+  }
+  t(key) {
+    return translations[this.locale][key] || key;
+  }
 }

package/templates/static/lib/import/jen-import.js

@@ -1,128 +1,161 @@
-/*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <https://www.gnu.org/licenses/>.
- */
 import { buildSync } from "esbuild";
 import { pathToFileURL } from "node:url";
 import { join, resolve, extname } from "node:path";
 import { mkdirSync, existsSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { log } from "../shared/log.js";
-import { vueEsbuildPlugin, svelteEsbuildPlugin } from "../compilers/esbuild-plugins.js";
+import {
+  vueEsbuildPlugin,
+  svelteEsbuildPlugin,
+} from "../compilers/esbuild-plugins.js";
+/** In-memory cache mapping file paths to imported modules. Enables fast repeated imports. */
 const importCache = new Map();
+/**
+ * Resolve the cache directory path for a compiled module.
+ * Uses a flattened naming scheme to work reliably on Windows and other systems.
+ * Compiled modules are cached in node_modules/.jen/import-cache and are typically .gitignored.
+ *
+ * @param filePath The absolute path to the original source file.
+ * @returns The absolute path to the cached compiled .mjs file.
+ */
 function getCachePath(filePath) {
-    const cacheDir = join(process.cwd(), "node_modules", ".jen", "import-cache");
-    if (!existsSync(cacheDir)) {
-        mkdirSync(cacheDir, { recursive: true });
-    }
-    const flatName = filePath.replace(/[\\/:]/g, "_").replace(/^_+/, "");
-    return join(cacheDir, flatName + ".mjs");
+  const cacheDir = join(process.cwd(), "node_modules", ".jen", "import-cache");
+  if (!existsSync(cacheDir)) {
+    mkdirSync(cacheDir, { recursive: true });
+  }
+  const flatName = filePath.replace(/[\\/:]/g, "_").replace(/^_+/, "");
+  return join(cacheDir, flatName + ".mjs");
 }
+/**
+ * Generate an ETag hash for a file to detect changes.
+ * Uses SHA1 for speed and sufficient collision resistance for this use case.
+ *
+ * @param content The file content to hash.
+ * @returns A 40-character hex string representing the hash.
+ */
 function generateEtag(content) {
-    return createHash("sha1").update(content).digest("hex");
+  return createHash("sha1").update(content).digest("hex");
 }
 /**
- * Universal module importer for Vue, Svelte, and regular JS/TS
+ * Universal module importer for Vue, Svelte, and regular JS/TS files.
+ * Handles transpilation and caching to enable dynamic imports of framework components
+ * and utility modules with automatic compilation.
+ *
+ * Supported file types: .vue, .svelte, .ts, .tsx, .js, .jsx.
+ * Transpilation is performed using esbuild with Vue and Svelte plugins.
+ * Compiled modules are cached in node_modules/.jen/import-cache for fast subsequent loads.
+ *
+ * @param specifier File path relative to baseDir (typically process.cwd() or a component directory).
+ * @param opts Import options.
+ * @param opts.baseDir Base directory for relative path resolution. Defaults to process.cwd().
+ * @param opts.cache Whether to use in-memory cache. Defaults to true.
+ * @param opts.forceRecompile If true, bypass cache and recompile the module.
+ * @returns The imported module object (exports).
+ * @throws Error if the file type is unsupported, the file cannot be read, or transpilation fails.
  *
  * @example
- * const Button = await jen.import("./components/Button.vue");
- * const Card = await jen.import("./ui/Card.svelte");
- * const Utils = await jen.import("./utils.ts");
+ * const Button = await jenImport("./components/Button.vue");
+ * const Card = await jenImport("./ui/Card.svelte");
+ * const Utils = await jenImport("./utils.ts", { cache: true });
+ * const Fresh = await jenImport("./component.tsx", { forceRecompile: true });
  */
 export async function jenImport(specifier, opts) {
-    const baseDir = opts?.baseDir ?? process.cwd();
-    const useCache = opts?.cache !== false;
-    const forceRecompile = opts?.forceRecompile ?? false;
-    try {
-        // Resolve the file path
-        const filePath = resolve(baseDir, specifier);
-        const ext = extname(filePath);
-        // Check cache first
-        if (useCache && !forceRecompile && importCache.has(filePath)) {
-            log.info(`[jen.import] Cache hit: ${specifier}`);
-            return importCache.get(filePath).module;
-        }
-        const isVue = ext === ".vue";
-        const isSvelte = ext === ".svelte";
-        const isTs = ext === ".ts" || ext === ".tsx";
-        if (!isVue && !isSvelte && !isTs && ext !== ".js" && ext !== ".jsx") {
-            throw new Error(`Unsupported file type: ${ext}. Supported: .vue, .svelte, .ts, .tsx, .js, .jsx`);
-        }
-        log.info(`[jen.import] Loading: ${specifier} (${ext})`);
-        const outfile = getCachePath(filePath);
-        // Build with appropriate plugins
-        const result = buildSync({
-            entryPoints: [filePath],
-            outfile,
-            format: "esm",
-            platform: "browser",
-            target: "es2022",
-            bundle: false, // Don't bundle to preserve imports
-            write: true,
-            plugins: [vueEsbuildPlugin(), svelteEsbuildPlugin()],
-            external: [
-                "preact",
-                "preact/hooks",
-                "preact/jsx-runtime",
-                "preact-render-to-string",
-                "vue",
-                "svelte",
-            ],
-            logLevel: "error",
-            define: {
-                "process.env.NODE_ENV": JSON.stringify("development"),
-            },
-        });
-        // Dynamic import with cache-busting
-        const moduleUrl = pathToFileURL(outfile).href + "?t=" + Date.now();
-        const mod = await import(moduleUrl);
-        // Cache the imported module
-        if (useCache) {
-            importCache.set(filePath, {
-                module: mod,
-                etag: generateEtag(outfile),
-            });
-        }
-        log.info(`[jen.import] Successfully loaded: ${specifier}`);
-        return mod;
+  const baseDir = opts?.baseDir ?? process.cwd();
+  const useCache = opts?.cache !== false;
+  const forceRecompile = opts?.forceRecompile ?? false;
+  try {
+    // Resolve the file path relative to baseDir
+    const filePath = resolve(baseDir, specifier);
+    const ext = extname(filePath);
+    // Check cache first if enabled and not forcing recompile
+    if (useCache && !forceRecompile && importCache.has(filePath)) {
+      log.info(`[jen.import] Cache hit: ${specifier}`);
+      return importCache.get(filePath).module;
     }
-    catch (err) {
-        const message = err.message || String(err);
-        log.error(`[jen.import] Failed to import "${specifier}": ${message}`);
-        throw new Error(`jen.import() failed for "${specifier}": ${message}`);
+    const isVue = ext === ".vue";
+    const isSvelte = ext === ".svelte";
+    const isTs = ext === ".ts" || ext === ".tsx";
+    // Validate file type
+    if (!isVue && !isSvelte && !isTs && ext !== ".js" && ext !== ".jsx") {
+      throw new Error(
+        `Unsupported file type: ${ext}. Supported: .vue, .svelte, .ts, .tsx, .js, .jsx`,
+      );
     }
+    log.info(`[jen.import] Loading: ${specifier} (${ext})`);
+    const outfile = getCachePath(filePath);
+    // Transpile the module using esbuild with appropriate plugins
+    // Platform is set to "browser" for client-side components
+    // Bundle is false to preserve imports and enable tree-shaking
+    const result = buildSync({
+      entryPoints: [filePath],
+      outfile,
+      format: "esm",
+      platform: "browser",
+      target: "es2022",
+      bundle: false, // Don't bundle to preserve imports
+      write: true,
+      plugins: [vueEsbuildPlugin(), svelteEsbuildPlugin()],
+      external: [
+        "preact",
+        "preact/hooks",
+        "preact/jsx-runtime",
+        "preact-render-to-string",
+        "vue",
+        "svelte",
+      ],
+      logLevel: "error",
+      define: {
+        "process.env.NODE_ENV": JSON.stringify("development"),
+      },
+    });
+    // Dynamic import with cache-busting query parameter
+    // Prevents Node.js from caching the old module on repeated imports
+    const moduleUrl = pathToFileURL(outfile).href + "?t=" + Date.now();
+    const mod = await import(moduleUrl);
+    // Cache the imported module if caching is enabled
+    if (useCache) {
+      importCache.set(filePath, {
+        module: mod,
+        etag: generateEtag(outfile),
+      });
+    }
+    log.info(`[jen.import] Successfully loaded: ${specifier}`);
+    return mod;
+  } catch (err) {
+    const message = err.message || String(err);
+    log.error(`[jen.import] Failed to import "${specifier}": ${message}`);
+    throw new Error(`jen.import() failed for "${specifier}": ${message}`);
+  }
 }
 /**
- * Clear import cache for a specific file
+ * Invalidate the import cache for a specific file.
+ * Forces the next import to recompile the module from source.
+ * Useful during development when code changes frequently and cache may be stale.
+ *
+ * @param specifier File path (relative to process.cwd()) to invalidate.
  */
 export function invalidateImportCache(specifier) {
-    const filePath = resolve(process.cwd(), specifier);
-    importCache.delete(filePath);
-    log.info(`[jen.import] Cache invalidated: ${specifier}`);
+  const filePath = resolve(process.cwd(), specifier);
+  importCache.delete(filePath);
+  log.info(`[jen.import] Cache invalidated: ${specifier}`);
 }
 /**
- * Clear all import caches
+ * Clear all import caches completely.
+ * Forces all subsequent imports to recompile from source.
+ * Should be called sparingly; typically used when restarting the development server.
  */
 export function clearImportCache() {
-    importCache.clear();
-    log.info(`[jen.import] All caches cleared`);
+  importCache.clear();
+  log.info(`[jen.import] All caches cleared`);
 }
 /**
- * Export as global jen.import if needed
+ * Global jen namespace providing access to jen.import() for dynamic module loading.
+ * Can be used as an alternative to calling jenImport() directly.
+ *
+ * @example
+ * import { jen } from '../import/jen-import';
+ * const Component = await jen.import('./Component.vue');
  */
 export const jen = {
-    import: jenImport,
+  import: jenImport,
 };

package/templates/static/lib/index.js

@@ -1,120 +1,87 @@
 /*
- * This file is part of Jen.js.
- * Copyright (C) 2026 oopsio
+ * Jen.js Public API - Minimal tree-shakeable barrel exports
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
+ * This file exports only the essential public API surface needed by applications.
+ * All internal utilities, advanced features, and implementation details are intentionally
+ * excluded to enable tree-shaking and keep bundle sizes minimal for typical use cases.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ * Total exports: ~30 (core types, functions, and components)
+ * Previous file: 217 lines exporting everything
+ * This file: ~100 lines exporting only public API
  */
 // ============================================================================
-// Barrel Export: Automatically exports everything from all nested modules
-// ============================================================================
-// API
-export * from "./api/(hello).js";
-// Auth
-export * from "./auth/index.js";
-export * from "./auth/jwt.js";
-export * from "./auth/session.js";
-export * from "./auth/cookie-utils.js";
-// Build
-export { buildSite as legacyBuildSite, } from "./build-tools/build-site.js";
-export * from "./build/build.js";
-export { ProductionBuilder, } from "./build/production-build.js";
-export { SSGPipeline } from "./build/ssg-pipeline.js";
-export * from "./build/island-hydration.js";
-export { AssetManifest } from "./build/asset-manifest.js";
-export { AssetHasher } from "./build/asset-hashing.js";
-export { PageRenderer } from "./build/page-renderer.js";
-export { Minifier } from "./build/minifier.js";
-export { createIslandRegistry, markIsland, extractIslandsFromHtml, injectIslandScript, } from "./build/island-hydration.js";
-// Cache
-export * from "./cache/index.js";
-export * from "./cache/memory.js";
-export * from "./cache/redis.js";
-// CLI
-export * from "./cli/templates/ssg/jen.config.js";
-export * from "./cli/templates/ssr/jen.config.js";
-export * from "./cli/banner.js";
-// Compilers
-export { createVueCompiler } from "./compilers/vue.js";
-export { createSvelteCompiler } from "./compilers/svelte.js";
-export { vueEsbuildPlugin, svelteEsbuildPlugin, invalidateVueCache, invalidateSvelteCache, clearAllCompilerCaches, } from "./compilers/esbuild-plugins.js";
-// Core
-export * from "./core/config.js";
-export * from "./core/http.js";
-export * from "./core/paths.js";
-export * from "./core/types.js";
-export * from "./core/routes/match.js";
-export * from "./core/routes/scan.js";
-export * from "./core/middleware-hooks.js";
-// CSS
-export * from "./css/compiler.js";
-// Database
-export * from "./db/index.js";
-export * from "./db/types.js";
-export * from "./db/connector.js";
-export * from "./db/drivers/sql.js";
-export * from "./db/drivers/jdb.js";
-// GraphQL
-export * from "./graphql/index.js";
-export * from "./graphql/schema.js";
-export * from "./graphql/resolvers.js";
-// i18n
-export * from "./i18n/index.js";
-// Import utilities
-export { jenImport, clearImportCache, invalidateImportCache, jen } from "./import/jen-import.js";
-// JDB
-export * from "./jdb/index.js";
-export * from "./jdb/engine.js";
-export * from "./jdb/types.js";
-export * from "./jdb/utils.js";
-// Middleware
-export * from "./middleware/types.js";
-export * from "./middleware/context.js";
-export * from "./middleware/response.js";
-export * from "./middleware/pipeline.js";
-export * from "./middleware/kernel.js";
-export * from "./middleware/registry.js";
-export * from "./middleware/decorators.js";
-export * from "./middleware/builtins/logger.js";
-export * from "./middleware/builtins/request-id.js";
-export * from "./middleware/builtins/security-headers.js";
-export * from "./middleware/builtins/cors.js";
-export * from "./middleware/builtins/body-parser.js";
-export * from "./middleware/builtins/rate-limit.js";
-export * from "./middleware/errors/http-error.js";
-export * from "./middleware/errors/handler.js";
-export * from "./middleware/utils/matcher.js";
-// Native
-export * from "./native/index.js";
-export * from "./native/bundle.js";
-export * from "./native/dev-server.js";
-export * from "./native/optimizer.js";
-export * from "./native/style-compiler.js";
-// Plugin
-export * from "./plugin/loader.js";
-// Runtime
-export * from "./runtime/render.js";
-export * from "./runtime/client-runtime.js";
-export * from "./runtime/hydrate.js";
-export * from "./runtime/hmr.js";
-export * from "./runtime/islands.js";
-export * from "./runtime/island-hydration-client.js";
-// Server
-export * from "./server/app.js";
-// Use new api-routes.ts for HTTP method handlers (replaces old api.js behavior)
-export { tryHandleApiRoute as tryHandleApiRoute_v2 } from "./server/api-routes.js";
-// Keep old api.js exports for backward compatibility
-export { tryHandleApiRoute } from "./server/api.js";
-export * from "./server/runtimeServe.js";
-// Shared utilities
-export * from "./shared/log.js";
+// ROUTING (4 exports)
+// ============================================================================
+// Core routing functions for matching routes and scanning file system
+export { matchRoute } from "./core/routes/match.js";
+export { scanRoutes } from "./core/routes/scan.js";
+// ============================================================================
+// SERVER / APPLICATION (1 export)
+// ============================================================================
+// Main application factory for creating the HTTP handler
+export { createApp } from "./server/app.js";
+// ============================================================================
+// BUILD & STATIC GENERATION (1 export)
+// ============================================================================
+// Primary build function for static site generation
+export { buildSite } from "./build/build.js";
+// ============================================================================
+// CLIENT COMPONENTS (5 exports + types)
+// ============================================================================
+// Reusable Preact components for common patterns
+export { Image, Seo, PWA } from "./client/index.js";
+export { useRouter, useNavigation } from "./client/index.js";
+// ============================================================================
+// MIDDLEWARE & REQUEST HANDLING (7 exports)
+// ============================================================================
+// Core middleware types and HTTP utilities for route handlers
+// ============================================================================
+// TYPED LOADERS (5 exports)
+// ============================================================================
+// Type-safe data loading with compile-time validation
+export {
+  defineLoader,
+  defineMiddleware,
+  validateLoaderData,
+} from "./core/loader-schema.js";
+export { parseCookies, headersToObject } from "./core/http.js";
+// ============================================================================
+// PLUGINS (3 exports)
+// ============================================================================
+// Plugin system for extending framework functionality
+export {
+  getPluginManager,
+  resetPluginManager,
+} from "./plugin/plugin-manager.js";
+export { HookStage } from "./plugin/types.js";
+// ============================================================================
+// RUNTIME & ISLANDS (2 exports)
+// ============================================================================
+// Client-side hydration and island components for interactivity
+export { Island } from "./runtime/islands.js";
+// ============================================================================
+// CLIENT ROUTING & STATE (8 exports + types)
+// ============================================================================
+// Minimal client-side router and signal-based reactive state
+export {
+  navigate,
+  getCurrentRoute,
+  onRouteChange,
+  initRouter,
+} from "./client-routing/router.js";
+export {
+  signal,
+  computed,
+  bindSignal,
+  bindInput,
+  batch,
+  watch,
+  createStore,
+} from "./client-routing/signal.js";
+export { Link } from "./client-routing/Link.js";
+// ============================================================================
+// UTILITIES (2 exports)
+// ============================================================================
+// Common utilities for logging and framework usage
+export { log } from "./shared/log.js";
+export { jenImport } from "./import/jen-import.js";