@hashrock/ono 0.1.3 → 0.2.0

package/src/commands/dev.js

@@ -0,0 +1,54 @@
+/**
+ * Dev command for Ono CLI
+ */
+import { resolve, relative } from "node:path";
+import { stat } from "node:fs/promises";
+import { createDevServer } from "../server.js";
+import { buildFile, buildFiles, generateUnoCSS } from "../builder.js";
+import { watchFile, watchFiles } from "../watcher.js";
+import { copyPublicFiles, initializeBarrels, parseCommandArgs } from "./build.js";
+
+/**
+ * Run the dev command
+ * @param {string[]} args - Command line arguments (after 'dev')
+ * @returns {Promise<void>}
+ */
+export async function runDevCommand(args) {
+  const { input, port, outputDir } = parseCommandArgs(args);
+
+  // Generate barrel files if barrels directory exists
+  await initializeBarrels();
+
+  const inputPath = resolve(process.cwd(), input);
+  const inputStat = await stat(inputPath);
+  const isDirectory = inputStat.isDirectory();
+
+  const initialBuild = isDirectory
+    ? await buildFiles(input, { outputDir })
+    : [await buildFile(input, { outputDir })];
+
+  await copyPublicFiles(outputDir);
+  await generateUnoCSS({ outputDir });
+
+  const mode = isDirectory ? "pages" : "single";
+  const indexFile = isDirectory
+    ? "index.html"
+    : relative(outputDir, initialBuild[0].outputPath);
+
+  const { port: serverPort, reload } = await createDevServer({
+    outputDir,
+    port,
+    mode,
+    indexFile,
+  });
+
+  const watchOpts = {
+    outputDir,
+    reload,
+    onRebuild: () => copyPublicFiles(outputDir),
+  };
+  await (isDirectory ? watchFiles(input, watchOpts) : watchFile(input, watchOpts));
+
+  console.log(`\n🚀 Server running at http://localhost:${serverPort}`);
+  console.log(`📝 Serving: ${input}/ → ${outputDir}/`);
+}

package/src/constants.js

@@ -0,0 +1,74 @@
+/**
+ * Constants for Ono SSG
+ */
+
+/**
+ * Default port configuration
+ */
+export const PORTS = {
+  /** Default HTTP server port */
+  SERVER: 3000,
+};
+
+/**
+ * Default directory names
+ */
+export const DIRS = {
+  /** Default input directory for pages */
+  PAGES: "pages",
+  /** Default output directory for built files */
+  OUTPUT: "dist",
+  /** Directory for static public files */
+  PUBLIC: "public",
+  /** Directory for barrel file sources */
+  BARRELS: "barrels",
+};
+
+/**
+ * Timing configuration
+ */
+export const TIMING = {
+  /** Debounce delay for file watcher in milliseconds */
+  DEBOUNCE_MS: 100,
+};
+
+/**
+ * Self-closing HTML tags (void elements)
+ */
+export const SELF_CLOSING_TAGS = new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr",
+]);
+
+/**
+ * Content-Type mappings for file extensions
+ */
+export const MIME_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon",
+  ".webp": "image/webp",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".eot": "application/vnd.ms-fontobject",
+};

package/src/jsx-runtime.js

@@ -1,22 +1,32 @@
 /**
  * JSX Runtime - createElement function
  * Creates a VNode (Virtual Node) from JSX
+ *
+ * This module is self-contained (no imports) so the builder can inject it
+ * verbatim into compiled pages as the single source of truth for the runtime.
+ * It must stay browser-compatible for the REPL.
  */
 
 /**
- * Flatten array recursively and filter out falsy values
+ * Fragment symbol for grouping elements without a wrapper.
+ * Symbol.for keeps identity stable even if the runtime is evaluated twice.
+ */
+export const Fragment = Symbol.for("ono.fragment");
+
+/**
+ * Flatten array recursively and filter out null/undefined/boolean children
+ * @param {any[]} children - Array of children to flatten
+ * @returns {any[]} Flattened array
  */
 function flattenChildren(children) {
   const result = [];
 
   for (const child of children) {
-    if (child === null || child === undefined || typeof child === 'boolean') {
-      // Skip null, undefined, and boolean values
+    if (child === null || child === undefined || typeof child === "boolean") {
       continue;
     }
 
     if (Array.isArray(child)) {
-      // Recursively flatten arrays
       result.push(...flattenChildren(child));
     } else {
       result.push(child);
@@ -44,7 +54,7 @@ export function createElement(tag, props, ...children) {
 /**
  * JSX runtime function (react-jsx transform)
  * @param {string|Function} tag - HTML tag name or component function
- * @param {Object} props - Element properties/attributes (includes children)
+ * @param {Record<string, any> | null | undefined} props - Element properties/attributes (includes children)
  * @returns {Object} VNode object
  */
 export function jsx(tag, props) {