create-jen-app 1.2.2 → 1.2.3

package/templates/static/lib/shared/log.d.ts

@@ -1,5 +1,49 @@
+/**
+ * Structured logging utility for the Jen.js framework.
+ * Provides three log levels (info, warn, error) that output to appropriate streams.
+ *
+ * Usage:
+ * - log.info(): Development and progress messages
+ * - log.warn(): Warnings and non-fatal issues
+ * - log.error(): Critical errors that may require attention
+ *
+ * Format:
+ * All logs include an ISO 8601 timestamp and a level prefix.
+ * Example: "[2026-02-19T15:30:45.123Z] [INFO] Building 42 routes"
+ *
+ * Output:
+ * - info() -> console.log (stdout)
+ * - warn() -> console.warn (stderr)
+ * - error() -> console.error (stderr)
+ *
+ * This is used throughout the framework for build output, server status, and diagnostics.
+ */
 export declare const log: {
-    info(msg: string): void;
-    warn(msg: string): void;
-    error(msg: string): void;
+  /**
+   * Logs an informational message with timestamp and [INFO] prefix.
+   * Used for progress updates, build completion, server startup, etc.
+   *
+   * @param msg Message to log
+   *
+   * @example log.info("Server running on port 3000");
+   */
+  info(msg: string): void;
+  /**
+   * Logs a warning message with timestamp and [WARN] prefix.
+   * Used for non-fatal issues, deprecated usage, or recoverable problems.
+   *
+   * @param msg Warning message to log
+   *
+   * @example log.warn("Configuration file not found, using defaults");
+   */
+  warn(msg: string): void;
+  /**
+   * Logs an error message with timestamp and [ERROR] prefix.
+   * Used for critical failures that require immediate attention.
+   *
+   * @param msg Error message to log
+   *
+   * @example log.error("Failed to compile SCSS: syntax error on line 42");
+   */
+  error(msg: string): void;
 };

package/templates/static/lib/shared/log.js

@@ -15,17 +15,67 @@
  * You should have received a copy of the GNU General Public License
  * along with this program. If not, see <https://www.gnu.org/licenses/>.
  */
+/**
+ * Get current timestamp in ISO 8601 format.
+ * Used to prefix all log messages with precise UTC time information for debugging and monitoring.
+ *
+ * @returns ISO 8601 timestamp string (e.g., "2026-02-19T15:30:45.123Z")
+ */
 function ts() {
-    return new Date().toISOString();
+  return new Date().toISOString();
 }
+/**
+ * Structured logging utility for the Jen.js framework.
+ * Provides three log levels (info, warn, error) that output to appropriate streams.
+ *
+ * Usage:
+ * - log.info(): Development and progress messages
+ * - log.warn(): Warnings and non-fatal issues
+ * - log.error(): Critical errors that may require attention
+ *
+ * Format:
+ * All logs include an ISO 8601 timestamp and a level prefix.
+ * Example: "[2026-02-19T15:30:45.123Z] [INFO] Building 42 routes"
+ *
+ * Output:
+ * - info() -> console.log (stdout)
+ * - warn() -> console.warn (stderr)
+ * - error() -> console.error (stderr)
+ *
+ * This is used throughout the framework for build output, server status, and diagnostics.
+ */
 export const log = {
-    info(msg) {
-        console.log(`[${ts()}] [INFO] ${msg}`);
-    },
-    warn(msg) {
-        console.warn(`[${ts()}] [WARN] ${msg}`);
-    },
-    error(msg) {
-        console.error(`[${ts()}] [ERROR] ${msg}`);
-    },
+  /**
+   * Logs an informational message with timestamp and [INFO] prefix.
+   * Used for progress updates, build completion, server startup, etc.
+   *
+   * @param msg Message to log
+   *
+   * @example log.info("Server running on port 3000");
+   */
+  info(msg) {
+    console.log(`[${ts()}] [INFO] ${msg}`);
+  },
+  /**
+   * Logs a warning message with timestamp and [WARN] prefix.
+   * Used for non-fatal issues, deprecated usage, or recoverable problems.
+   *
+   * @param msg Warning message to log
+   *
+   * @example log.warn("Configuration file not found, using defaults");
+   */
+  warn(msg) {
+    console.warn(`[${ts()}] [WARN] ${msg}`);
+  },
+  /**
+   * Logs an error message with timestamp and [ERROR] prefix.
+   * Used for critical failures that require immediate attention.
+   *
+   * @param msg Error message to log
+   *
+   * @example log.error("Failed to compile SCSS: syntax error on line 42");
+   */
+  error(msg) {
+    console.error(`[${ts()}] [ERROR] ${msg}`);
+  },
 };

package/templates/static/server.js

@@ -1,17 +1,17 @@
 /*
  * 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/>.
  */
@@ -76,9 +76,7 @@ async function main() {
   const { createApp } = await import(appPath);
 
   // Load banner
-  const bannerPath = pathToFileURL(
-    join(rootDir, "lib/cli/banner.js"),
-  ).href;
+  const bannerPath = pathToFileURL(join(rootDir, "lib/cli/banner.js")).href;
   const { printBanner } = await import(bannerPath);
 
   const app = await createApp({

package/templates/static/site/(home).tsx

@@ -1,12 +1,30 @@
-export default function Index() {
-  return (
-    <div className="container">
-      <h1>Jen.js</h1>
-
-      <div className="card">
-        <h2>You're ready 🚀</h2>
-        <p>Edit (home).tsx to start developing!</p>
-      </div>
-    </div>
-  );
-}
+/*
+ * 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/>.
+ */
+
+export default function Index() {
+  return (
+    <div className="container">
+      <h1>Jen.js</h1>
+
+      <div className="card">
+        <h2>You're ready 🚀</h2>
+        <p>Edit (home).tsx to start developing!</p>
+      </div>
+    </div>
+  );
+}

package/templates/static/site/styles/global.scss

@@ -1,78 +1,89 @@
-/* Vercel-ish (Geist style) */
-
-$bg: #000;
-$fg: #fff;
-$muted: rgba(255, 255, 255, 0.7);
-$muted2: rgba(255, 255, 255, 0.5);
-$border: rgba(255, 255, 255, 0.12);
-$card: rgba(255, 255, 255, 0.04);
-
-body {
-  background: $bg;
-  color: $fg;
-  font-family: "Geist", ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto,
-    Helvetica, Arial, "Apple Color Emoji", "Segoe UI Emoji";
-  margin: 0;
-  min-height: 100vh;
-
-  display: flex;
-  justify-content: center;
-  align-items: center;
-}
-
-.container {
-  width: 100%;
-  max-width: 720px;
-  padding: 3rem 1.5rem;
-  text-align: center;
-
-  h1 {
-    font-size: 3.25rem;
-    font-weight: 700;
-    letter-spacing: -0.05em;
-    margin: 0;
-  }
-
-  p {
-    margin-top: 0.75rem;
-    font-size: 1.1rem;
-    color: $muted;
-    line-height: 1.6;
-  }
-
-  .card {
-    margin-top: 2rem;
-    padding: 1.75rem;
-    border-radius: 14px;
-    background: $card;
-    border: 1px solid $border;
-    backdrop-filter: blur(12px);
-
-    box-shadow: 0 0 0 1px rgba(255, 255, 255, 0.02),
-      0 20px 50px rgba(0, 0, 0, 0.6);
-
-    h2 {
-      margin: 0;
-      font-size: 1.25rem;
-      font-weight: 600;
-      letter-spacing: -0.02em;
-    }
-
-    p {
-      margin-top: 0.75rem;
-      font-size: 0.95rem;
-      color: $muted2;
-    }
-
-    code {
-      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
-        "Liberation Mono", "Courier New", monospace;
-      background: rgba(255, 255, 255, 0.06);
-      border: 1px solid rgba(255, 255, 255, 0.1);
-      padding: 0.2rem 0.45rem;
-      border-radius: 8px;
-      font-size: 0.9em;
-      color: rgba(255, 255, 255, 0.9);
-    }
-  }
-}
+/* Vercel-ish (Geist style) */
+
+$bg: #000;
+$fg: #fff;
+$muted: rgba(255, 255, 255, 0.7);
+$muted2: rgba(255, 255, 255, 0.5);
+$border: rgba(255, 255, 255, 0.12);
+$card: rgba(255, 255, 255, 0.04);
+
+body {
+  background: $bg;
+  color: $fg;
+  font-family:
+    "Geist",
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    Segoe UI,
+    Roboto,
+    Helvetica,
+    Arial,
+    "Apple Color Emoji",
+    "Segoe UI Emoji";
+  margin: 0;
+  min-height: 100vh;
+
+  display: flex;
+  justify-content: center;
+  align-items: center;
+}
+
+.container {
+  width: 100%;
+  max-width: 720px;
+  padding: 3rem 1.5rem;
+  text-align: center;
+
+  h1 {
+    font-size: 3.25rem;
+    font-weight: 700;
+    letter-spacing: -0.05em;
+    margin: 0;
+  }
+
+  p {
+    margin-top: 0.75rem;
+    font-size: 1.1rem;
+    color: $muted;
+    line-height: 1.6;
+  }
+
+  .card {
+    margin-top: 2rem;
+    padding: 1.75rem;
+    border-radius: 14px;
+    background: $card;
+    border: 1px solid $border;
+    backdrop-filter: blur(12px);
+
+    box-shadow:
+      0 0 0 1px rgba(255, 255, 255, 0.02),
+      0 20px 50px rgba(0, 0, 0, 0.6);
+
+    h2 {
+      margin: 0;
+      font-size: 1.25rem;
+      font-weight: 600;
+      letter-spacing: -0.02em;
+    }
+
+    p {
+      margin-top: 0.75rem;
+      font-size: 0.95rem;
+      color: $muted2;
+    }
+
+    code {
+      font-family:
+        ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+        "Liberation Mono", "Courier New", monospace;
+      background: rgba(255, 255, 255, 0.06);
+      border: 1px solid rgba(255, 255, 255, 0.1);
+      padding: 0.2rem 0.45rem;
+      border-radius: 8px;
+      font-size: 0.9em;
+      color: rgba(255, 255, 255, 0.9);
+    }
+  }
+}

package/templates/static/tsconfig.json

@@ -1,39 +1,39 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-
-    "jsx": "react-jsx",
-    "jsxImportSource": "preact",
-
-    "strict": true,
-    "skipLibCheck": true,
-
-    "baseUrl": ".",
-    "paths": {
-      "@src/*": ["src/*"]
-    },
-
-    "types": ["node"],
-
-    "outDir": "dist",
-    "rootDir": ".",
-
-    "allowJs": false,
-    "resolveJsonModule": true,
-
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": [
-    "site/**/*.ts",
-    "site/**/*.tsx",
-    "server.ts",
-    "build.ts",
-    "jen.config.ts"
-  ],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+
+    "strict": true,
+    "skipLibCheck": true,
+
+    "baseUrl": ".",
+    "paths": {
+      "@src/*": ["lib/*"]
+    },
+
+    "types": ["node"],
+
+    "outDir": "dist",
+    "rootDir": ".",
+
+    "allowJs": false,
+    "resolveJsonModule": true,
+
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "site/**/*.ts",
+    "site/**/*.tsx",
+    "server.ts",
+    "build.ts",
+    "jen.config.ts"
+  ],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/static/node_modules/.bin/esbuild

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../esbuild/bin/esbuild" "$@"
-else 
-  exec node  "$basedir/../esbuild/bin/esbuild" "$@"
-fi

package/templates/static/node_modules/.bin/esbuild.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\esbuild\bin\esbuild" %*

package/templates/static/node_modules/.bin/esbuild.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/static/node_modules/.bin/tsc

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
-else 
-  exec node  "$basedir/../typescript/bin/tsc" "$@"
-fi

package/templates/static/node_modules/.bin/tsc.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\typescript\bin\tsc" %*

package/templates/static/node_modules/.bin/tsc.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/static/node_modules/.bin/tsserver

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
-else 
-  exec node  "$basedir/../typescript/bin/tsserver" "$@"
-fi

package/templates/static/node_modules/.bin/tsserver.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\typescript\bin\tsserver" %*

package/templates/static/node_modules/.bin/tsserver.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../typescript/bin/tsserver" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../typescript/bin/tsserver" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../typescript/bin/tsserver" $args
-  } else {
-    & "node$exe"  "$basedir/../typescript/bin/tsserver" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/static/node_modules/.jen/cache/B__Jen.js_packages_create-jen-app_templates_static_site_(home).tsx.mjs

@@ -1,14 +0,0 @@
-// site/(home).tsx
-import { jsx, jsxs } from "preact/jsx-runtime";
-function Index() {
-  return /* @__PURE__ */ jsxs("div", { className: "container", children: [
-    /* @__PURE__ */ jsx("h1", { children: "Jen.js" }),
-    /* @__PURE__ */ jsxs("div", { className: "card", children: [
-      /* @__PURE__ */ jsx("h2", { children: "You're ready \u{1F680}" }),
-      /* @__PURE__ */ jsx("p", { children: "Edit (home).tsx to start developing!" })
-    ] })
-  ] });
-}
-export {
-  Index as default
-};