appstage 0.2.4 → 0.2.6

package/dist/bin.js

@@ -25,8 +25,146 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// node_modules/dateshape/dist/index.cjs
+// node_modules/args-json/dist/index.cjs
 var require_dist = __commonJS({
+  "node_modules/args-json/dist/index.cjs"(exports) {
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    function isKey2(x) {
+      return x.startsWith("-") && x.length === 2 && x !== "--" || x.startsWith("--") && x.length > 2;
+    }
+    var Args2 = class {
+      _values;
+      constructor(values) {
+        this._values = values ?? process.argv.slice(2);
+      }
+      hasKey(x) {
+        return isKey2(x) && this._values.includes(x);
+      }
+      getValue(key, fallback) {
+        let args = this._values;
+        let keys = Array.isArray(key) ? key : [key];
+        for (let k of keys) {
+          let i = args.indexOf(k);
+          if (i !== -1 && args[i + 1] && !isKey2(args[i + 1])) return args[i + 1];
+        }
+        return fallback;
+      }
+      getValues(key, fallback) {
+        let args = this._values;
+        let keys = Array.isArray(key) ? key : [key];
+        let values = [];
+        for (let k of keys) {
+          let i = args.indexOf(k);
+          while (i !== -1 && args[i + 1] && !isKey2(args[i + 1])) values.push(args[++i]);
+        }
+        return values.length === 0 ? fallback : values;
+      }
+    };
+    function getValue(key, fallback) {
+      let args = new Args2();
+      if (fallback === void 0) return args.getValue(key);
+      return args.getValue(key, fallback);
+    }
+    function getValues(key, fallback) {
+      let args = new Args2();
+      if (fallback === void 0) return args.getValues(key);
+      return args.getValues(key, fallback);
+    }
+    function hasKey2(x) {
+      return new Args2().hasKey(x);
+    }
+    function split(x) {
+      let words = [], word = "";
+      let hasOpenSingleQuote = false;
+      let hasOpenDoubleQuote = false;
+      for (let i = 0; i < x.length; i++) {
+        let c = x[i];
+        if (/^\s/.test(c) && !hasOpenSingleQuote && !hasOpenDoubleQuote) {
+          if (word) words.push(word);
+          word = "";
+          continue;
+        }
+        if (c === "'" && x[i - 1] !== "\\") hasOpenSingleQuote = !hasOpenSingleQuote;
+        if (c === '"' && x[i - 1] !== "\\") hasOpenDoubleQuote = !hasOpenDoubleQuote;
+        word += c;
+      }
+      if (word) words.push(word);
+      return words;
+    }
+    function toCamelCase(x) {
+      let s = x.replace(/^[-_.\s~+]|[-_.\s~+]$/g, "");
+      if (!/[-_.\s~+]/.test(s)) return s.slice(0, 1).toLowerCase() + s.slice(1);
+      return s.toLowerCase().replace(/[-_.\s~+](\S)/g, (_, match) => match.toUpperCase());
+    }
+    function toKey(x) {
+      if (x === void 0 || !isKey2(x)) return;
+      if (x.startsWith("-") && x.length === 2) return toCamelCase(x.slice(1));
+      if (x.startsWith("--") && x.length > 2) return toCamelCase(x.slice(2));
+    }
+    function getDefaultInput() {
+      return typeof process === "undefined" ? [] : process.argv;
+    }
+    function parseArgs(input, map) {
+      let normalizedInput;
+      let normalizedMap;
+      if (input === void 0) normalizedInput = getDefaultInput();
+      else if (typeof input === "string") normalizedInput = split(input);
+      else if (Array.isArray(input)) normalizedInput = input.map((x) => String(x));
+      else if (input !== null && typeof input === "object") {
+        normalizedInput = getDefaultInput();
+        normalizedMap = input;
+      } else normalizedInput = [];
+      normalizedInput = normalizedInput.flatMap((item) => {
+        let normalizedItem = item.trim();
+        let k = normalizedItem.indexOf("=");
+        if (k === -1) return normalizedItem;
+        let key2 = normalizedItem.slice(0, k);
+        let value = normalizedItem.slice(k + 1);
+        if (!isKey2(key2)) return normalizedItem;
+        return [key2, value];
+      });
+      if (map) normalizedMap = map;
+      let key = "";
+      let parsedArgs = {};
+      for (let rawValue of normalizedInput) {
+        rawValue = rawValue.trim();
+        if (rawValue.startsWith('"') && rawValue.endsWith('"')) rawValue = rawValue.slice(1, -1);
+        else if (rawValue.startsWith("'") && rawValue.endsWith("'")) rawValue = rawValue.slice(1, -1);
+        let parsedKey = toKey(rawValue);
+        if (parsedKey !== void 0) {
+          let nextKey = normalizedMap?.[parsedKey] ?? parsedKey;
+          if (key && nextKey !== key && parsedArgs[key] === void 0) parsedArgs[key] = true;
+          key = nextKey;
+          continue;
+        }
+        let parsedValue;
+        if (rawValue) try {
+          parsedValue = JSON.parse(rawValue);
+        } catch {
+          parsedValue = rawValue;
+        }
+        else parsedValue = true;
+        let prevValue = parsedArgs[key];
+        let value;
+        if (prevValue === void 0) value = key === "" ? [parsedValue] : parsedValue;
+        else if (Array.isArray(prevValue)) value = [...prevValue, parsedValue];
+        else value = [prevValue, parsedValue];
+        parsedArgs[key] = value;
+      }
+      if (key && parsedArgs[key] === void 0) parsedArgs[key] = true;
+      return parsedArgs;
+    }
+    exports.Args = Args2;
+    exports.getValue = getValue;
+    exports.getValues = getValues;
+    exports.hasKey = hasKey2;
+    exports.isKey = isKey2;
+    exports.parseArgs = parseArgs;
+  }
+});
+
+// node_modules/dateshape/dist/index.cjs
+var require_dist2 = __commonJS({
   "node_modules/dateshape/dist/index.cjs"(exports) {
     var SEC = 1e3;
     var MIN = 60 * SEC;
@@ -215,11 +353,15 @@ var require_dist = __commonJS({
   }
 });
 
+// src/scripts/bin.ts
+var import_args_json2 = __toESM(require_dist(), 1);
+
 // src/scripts/cli.ts
+var import_args_json = __toESM(require_dist(), 1);
 import { rm as rm2 } from "node:fs/promises";
 
 // src/scripts/build.ts
-var import_dateshape = __toESM(require_dist(), 1);
+var import_dateshape = __toESM(require_dist2(), 1);
 import { spawn } from "node:child_process";
 
 // src/scripts/utils/buildClient.ts
@@ -291,7 +433,7 @@ async function getEntryPoints(path) {
 }
 
 // src/scripts/utils/buildClient.ts
-async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
+async function buildClient({ clientDir, watch, watchClient }, plugins) {
   let clientEntries = await getEntryPoints(["ui/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -299,7 +441,7 @@ async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
     bundle: true,
     splitting: true,
     format: "esm",
-    outdir: `${publicAssetsDir}/-`,
+    outdir: clientDir,
     outbase: "src/entries",
     minify: process.env.NODE_ENV !== "development",
     plugins
@@ -332,7 +474,8 @@ function toImportPath(relativePath, referencePath = ".") {
 }
 
 // src/scripts/utils/populateEntries.ts
-async function populateEntries() {
+async function populateEntries({ entriesPath }) {
+  if (entriesPath === null) return;
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let content = "";
   if (serverEntries.length === 0) content = "export const entries = [];";
@@ -346,7 +489,7 @@ async function populateEntries() {
     content += "\n  ])\n).map(({ server }) => server);";
   }
   await writeFile(
-    "src/server/autoentries.ts",
+    entriesPath ?? "src/server/entries.ts",
     `// Populated automatically during the build phase by picking
 // all server exports from "src/entries/<entry_name>/server(/index)?.(js|ts)"
 ${content}
@@ -355,14 +498,15 @@ ${content}
 }
 
 // src/scripts/utils/buildServer.ts
-async function buildServer({ targetDir, watch, watchServer }, plugins) {
-  await populateEntries();
+async function buildServer(params, plugins) {
+  let { serverDir, watch, watchServer } = params;
+  await populateEntries(params);
   let buildOptions = {
     ...commonBuildOptions,
     entryPoints: ["src/server/index.ts"],
     bundle: true,
     splitting: true,
-    outdir: `${targetDir}/server`,
+    outdir: `${serverDir}/server`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -380,7 +524,7 @@ async function buildServer({ targetDir, watch, watchServer }, plugins) {
 
 // src/scripts/utils/buildServerCSS.ts
 import esbuild3 from "esbuild";
-async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
+async function buildServerCSS({ serverDir, watch, watchServer }, plugins) {
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -390,7 +534,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
     })),
     bundle: true,
     splitting: false,
-    outdir: `${targetDir}/server-css`,
+    outdir: `${serverDir}/server-css`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -408,7 +552,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
 
 // src/scripts/utils/createPostbuildPlugins.ts
 import { mkdir, readdir as readdir2, rename, rm } from "node:fs/promises";
-function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild) {
+function createPostbuildPlugins({ serverDir, clientDir }, onServerRebuild) {
   let serverPlugins = [
     {
       name: "skip-css",
@@ -430,19 +574,19 @@ function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild)
       name: "postbuild-server-css",
       setup(build2) {
         build2.onEnd(async () => {
-          let dir = `${targetDir}/server-css`;
+          let dir = `${serverDir}/server-css`;
           try {
             let files = (await readdir2(dir)).filter(
               (name) => name.endsWith(".css")
             );
             if (files.length === 0) return;
-            await mkdir(`${publicAssetsDir}/-`, { recursive: true });
+            await mkdir(clientDir, { recursive: true });
             await Promise.all(
               files.map(async (name) => {
-                let dir2 = `${publicAssetsDir}/-/${name.slice(0, -4)}`;
+                let dir2 = `${clientDir}/${name.slice(0, -4)}`;
                 await mkdir(dir2, { recursive: true });
                 await rename(
-                  `${targetDir}/server-css/${name}`,
+                  `${serverDir}/server-css/${name}`,
                   `${dir2}/index.css`
                 );
               })
@@ -478,7 +622,7 @@ async function build(params) {
       inited = true;
     }
     if (params.start)
-      serverProcess = spawn("node", [`${params.targetDir}/server/index.js`], {
+      serverProcess = spawn("node", [`${params.serverDir}/server/index.js`], {
         stdio: "inherit"
       });
   }
@@ -494,37 +638,32 @@ async function build(params) {
 }
 
 // src/scripts/cli.ts
-var defaultTargetDir = "dist";
-async function clean({ targetDir, publicAssetsDir }) {
-  let dirs = [
-    `${targetDir}/server`,
-    `${targetDir}/server-css`,
-    `${publicAssetsDir}/-`
-  ];
+async function clean({ serverDir, clientDir }) {
+  let dirs = [`${serverDir}/server`, `${serverDir}/server-css`, clientDir];
   return Promise.all(
     dirs.map((dir) => rm2(dir, { recursive: true, force: true }))
   );
 }
-async function cli(args = []) {
-  let publicAssetsDir = args[0];
-  let targetDir = args[1];
-  if (!publicAssetsDir || publicAssetsDir.startsWith("--"))
-    throw new Error("Public assets directory is undefined");
-  if (!targetDir || targetDir.startsWith("--")) targetDir = defaultTargetDir;
+async function cli(input = []) {
+  let args = new import_args_json.Args(input);
+  let clientDir = args.getValue("--client-dir");
+  let serverDir = args.getValue("--server-dir", "dist");
+  if (!clientDir) throw new Error("Public assets directory is undefined");
   let params = {
-    targetDir,
-    publicAssetsDir,
-    silent: args.includes("--silent"),
-    watch: args.includes("--watch"),
-    watchServer: args.includes("--watch-server"),
-    watchClient: args.includes("--watch-client"),
-    start: args.includes("--start")
+    serverDir,
+    clientDir,
+    silent: args.hasKey("--silent"),
+    watch: args.hasKey("--watch"),
+    watchServer: args.hasKey("--watch-server"),
+    watchClient: args.hasKey("--watch-client"),
+    start: args.hasKey("--start")
   };
-  if (args.includes("--clean-only")) {
+  if (args.hasKey("--no-auto-entries")) params.entriesPath = null;
+  if (args.hasKey("--clean-only")) {
     await clean(params);
     return;
   }
-  if (args.includes("--clean")) await clean(params);
+  if (args.hasKey("--clean")) await clean(params);
   await build(params);
 }
 
@@ -542,15 +681,16 @@ async function run() {
   }
   if (scriptName === "build") return await cli(args);
   let nodeEnv = nodeEnvMap[scriptName];
-  let host = args[0];
   if (nodeEnv !== void 0) process.env.NODE_ENV = nodeEnv;
-  if (host) {
-    let [hostname, port] = host.split(":");
+  if (args.length !== 0 && !(0, import_args_json2.isKey)(args[0])) {
+    let [hostname, port] = args[0].split(":");
     if (hostname) process.env.APP_HOST = hostname;
     if (port) process.env.APP_PORT = port;
+    args.shift();
   }
+  if (!(0, import_args_json2.hasKey)("--client-dir")) args.push("--client-dir", "src/public/-");
   await cli(
-    nodeEnv === "development" ? ["src/public", "--clean", "--start", "--watch"] : ["src/public", "--clean", "--start", "--silent"]
+    nodeEnv === "development" ? ["--clean", "--start", "--watch", ...args] : ["--clean", "--start", "--silent", ...args]
   );
 }
 await run();

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -7,16 +7,12 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-      key = keys[i];
-      if (!__hasOwnProp.call(to, key) && key !== except) {
-        __defProp(to, key, {
-          get: ((k) => from[k]).bind(null, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-      }
-    }
+  if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+    key = keys[i];
+    if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: ((k) => from[k]).bind(null, key),
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
   }
   return to;
 };
@@ -33,6 +29,7 @@ let node_http = require("node:http");
 let node_child_process = require("node:child_process");
 let esbuild = require("esbuild");
 esbuild = __toESM(esbuild);
+let args_json = require("args-json");
 let node_events = require("node:events");
 node_events = __toESM(node_events);
 let express = require("express");
@@ -372,7 +369,7 @@ async function getEntryPoints(path) {
 * than client since their contents can also be used with the server-side
 * rendering.
 */
-async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
+async function buildClient({ clientDir, watch, watchClient }, plugins) {
   let clientEntries = await getEntryPoints(["ui/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -380,7 +377,7 @@ async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
     bundle: true,
     splitting: true,
     format: "esm",
-    outdir: `${publicAssetsDir}/-`,
+    outdir: clientDir,
     outbase: "src/entries",
     minify: process.env.NODE_ENV !== "development",
     plugins
@@ -402,7 +399,8 @@ function toImportPath(relativePath, referencePath = ".") {
   return importPath;
 }
 
-async function populateEntries() {
+async function populateEntries({ entriesPath }) {
+  if (entriesPath === null) return;
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let content = "";
   if (serverEntries.length === 0) content = "export const entries = [];";
@@ -412,20 +410,21 @@ async function populateEntries() {
     import("${toImportPath(serverEntries[i].path, "src/server")}"),`;
     content += "\n  ])\n).map(({ server }) => server);";
   }
-  await (0, node_fs_promises.writeFile)("src/server/autoentries.ts", `// Populated automatically during the build phase by picking
+  await (0, node_fs_promises.writeFile)(entriesPath ?? "src/server/entries.ts", `// Populated automatically during the build phase by picking
 // all server exports from "src/entries/<entry_name>/server(/index)?.(js|ts)"
 ${content}
 `);
 }
 
-async function buildServer({ targetDir, watch, watchServer }, plugins) {
-  await populateEntries();
+async function buildServer(params, plugins) {
+  let { serverDir, watch, watchServer } = params;
+  await populateEntries(params);
   let buildOptions = {
     ...commonBuildOptions,
     entryPoints: ["src/server/index.ts"],
     bundle: true,
     splitting: true,
-    outdir: `${targetDir}/server`,
+    outdir: `${serverDir}/server`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -441,7 +440,7 @@ async function buildServer({ targetDir, watch, watchServer }, plugins) {
   await esbuild.default.build(buildOptions);
 }
 
-async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
+async function buildServerCSS({ serverDir, watch, watchServer }, plugins) {
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -451,7 +450,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
     })),
     bundle: true,
     splitting: false,
-    outdir: `${targetDir}/server-css`,
+    outdir: `${serverDir}/server-css`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -467,7 +466,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
   await esbuild.default.build(buildOptions);
 }
 
-function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild) {
+function createPostbuildPlugins({ serverDir, clientDir }, onServerRebuild) {
   return {
     serverPlugins: [{
       name: "skip-css",
@@ -487,15 +486,15 @@ function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild)
       name: "postbuild-server-css",
       setup(build) {
         build.onEnd(async () => {
-          let dir = `${targetDir}/server-css`;
+          let dir = `${serverDir}/server-css`;
           try {
             let files = (await (0, node_fs_promises.readdir)(dir)).filter((name) => name.endsWith(".css"));
             if (files.length === 0) return;
-            await (0, node_fs_promises.mkdir)(`${publicAssetsDir}/-`, { recursive: true });
+            await (0, node_fs_promises.mkdir)(clientDir, { recursive: true });
             await Promise.all(files.map(async (name) => {
-              let dir = `${publicAssetsDir}/-/${name.slice(0, -4)}`;
+              let dir = `${clientDir}/${name.slice(0, -4)}`;
               await (0, node_fs_promises.mkdir)(dir, { recursive: true });
-              await (0, node_fs_promises.rename)(`${targetDir}/server-css/${name}`, `${dir}/index.css`);
+              await (0, node_fs_promises.rename)(`${serverDir}/server-css/${name}`, `${dir}/index.css`);
             }));
             await (0, node_fs_promises.rm)(dir, {
               recursive: true,
@@ -523,7 +522,7 @@ async function build(params) {
       log(`Build completed +${(0, dateshape.formatDuration)(Date.now() - startTime)}`);
       inited = true;
     }
-    if (params.start) serverProcess = (0, node_child_process.spawn)("node", [`${params.targetDir}/server/index.js`], { stdio: "inherit" });
+    if (params.start) serverProcess = (0, node_child_process.spawn)("node", [`${params.serverDir}/server/index.js`], { stdio: "inherit" });
   }
   let { serverPlugins, serverCSSPlugins } = createPostbuildPlugins(params, handleServerRebuild);
   await Promise.all([
@@ -533,37 +532,37 @@ async function build(params) {
   ]);
 }
 
-const defaultTargetDir = "dist";
-async function clean({ targetDir, publicAssetsDir }) {
+async function clean({ serverDir, clientDir }) {
   let dirs = [
-    `${targetDir}/server`,
-    `${targetDir}/server-css`,
-    `${publicAssetsDir}/-`
+    `${serverDir}/server`,
+    `${serverDir}/server-css`,
+    clientDir
   ];
   return Promise.all(dirs.map((dir) => (0, node_fs_promises.rm)(dir, {
     recursive: true,
     force: true
   })));
 }
-async function cli(args = []) {
-  let publicAssetsDir = args[0];
-  let targetDir = args[1];
-  if (!publicAssetsDir || publicAssetsDir.startsWith("--")) throw new Error("Public assets directory is undefined");
-  if (!targetDir || targetDir.startsWith("--")) targetDir = defaultTargetDir;
+async function cli(input = []) {
+  let args = new args_json.Args(input);
+  let clientDir = args.getValue("--client-dir");
+  let serverDir = args.getValue("--server-dir", "dist");
+  if (!clientDir) throw new Error("Public assets directory is undefined");
   let params = {
-    targetDir,
-    publicAssetsDir,
-    silent: args.includes("--silent"),
-    watch: args.includes("--watch"),
-    watchServer: args.includes("--watch-server"),
-    watchClient: args.includes("--watch-client"),
-    start: args.includes("--start")
+    serverDir,
+    clientDir,
+    silent: args.hasKey("--silent"),
+    watch: args.hasKey("--watch"),
+    watchServer: args.hasKey("--watch-server"),
+    watchClient: args.hasKey("--watch-client"),
+    start: args.hasKey("--start")
   };
-  if (args.includes("--clean-only")) {
+  if (args.hasKey("--no-auto-entries")) params.entriesPath = null;
+  if (args.hasKey("--clean-only")) {
     await clean(params);
     return;
   }
-  if (args.includes("--clean")) await clean(params);
+  if (args.hasKey("--clean")) await clean(params);
   await build(params);
 }
 
@@ -578,7 +577,7 @@ function createApp(callback) {
   let app = (0, express.default)();
   if (!app.events) app.events = new node_events.default();
   let host = process.env.APP_HOST || "localhost";
-  let port = Number(process.env.APP_PORT) || 80;
+  let port = Number(process.env.APP_PORT) || 3e3;
   let listen = () => {
     app.listen(port, host, () => {
       emitLog(app, `Server running at ${`http://${host}:${port}/`} (${`NODE_ENV=${process.env.NODE_ENV}`})`);

package/dist/index.d.ts

@@ -131,18 +131,27 @@ declare const lang$1: Middleware<LangParams | void>;
 declare const requestEvents: Middleware;
 
 type BuildParams = {
-  targetDir: string;
-  publicAssetsDir: string;
+  serverDir: string;
+  clientDir: string;
   silent?: boolean;
   watch?: boolean;
   watchClient?: boolean;
   watchServer?: boolean;
   start?: boolean;
+  /**
+   * A file path that the automatically picked entry exports will be
+   * written to.
+   *
+   * Set it to `null` to skip the automatic picking of entry exports.
+   *
+   * @default "src/server/entries.ts"
+   */
+  entriesPath?: string | null;
 };
 
 declare function build(params: BuildParams): Promise<void>;
 
-declare function cli(args?: string[]): Promise<void>;
+declare function cli(input?: string[]): Promise<void>;
 
 type LogLevel = "error" | "debug" | "info" | "warn";
 

package/dist/index.mjs

@@ -5,6 +5,7 @@ import { randomBytes } from "node:crypto";
 import { STATUS_CODES } from "node:http";
 import { spawn } from "node:child_process";
 import esbuild from "esbuild";
+import { Args } from "args-json";
 import EventEmitter from "node:events";
 import express from "express";
 
@@ -342,7 +343,7 @@ async function getEntryPoints(path) {
 * than client since their contents can also be used with the server-side
 * rendering.
 */
-async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
+async function buildClient({ clientDir, watch, watchClient }, plugins) {
   let clientEntries = await getEntryPoints(["ui/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -350,7 +351,7 @@ async function buildClient({ publicAssetsDir, watch, watchClient }, plugins) {
     bundle: true,
     splitting: true,
     format: "esm",
-    outdir: `${publicAssetsDir}/-`,
+    outdir: clientDir,
     outbase: "src/entries",
     minify: process.env.NODE_ENV !== "development",
     plugins
@@ -372,7 +373,8 @@ function toImportPath(relativePath, referencePath = ".") {
   return importPath;
 }
 
-async function populateEntries() {
+async function populateEntries({ entriesPath }) {
+  if (entriesPath === null) return;
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let content = "";
   if (serverEntries.length === 0) content = "export const entries = [];";
@@ -382,20 +384,21 @@ async function populateEntries() {
     import("${toImportPath(serverEntries[i].path, "src/server")}"),`;
     content += "\n  ])\n).map(({ server }) => server);";
   }
-  await writeFile("src/server/autoentries.ts", `// Populated automatically during the build phase by picking
+  await writeFile(entriesPath ?? "src/server/entries.ts", `// Populated automatically during the build phase by picking
 // all server exports from "src/entries/<entry_name>/server(/index)?.(js|ts)"
 ${content}
 `);
 }
 
-async function buildServer({ targetDir, watch, watchServer }, plugins) {
-  await populateEntries();
+async function buildServer(params, plugins) {
+  let { serverDir, watch, watchServer } = params;
+  await populateEntries(params);
   let buildOptions = {
     ...commonBuildOptions,
     entryPoints: ["src/server/index.ts"],
     bundle: true,
     splitting: true,
-    outdir: `${targetDir}/server`,
+    outdir: `${serverDir}/server`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -411,7 +414,7 @@ async function buildServer({ targetDir, watch, watchServer }, plugins) {
   await esbuild.build(buildOptions);
 }
 
-async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
+async function buildServerCSS({ serverDir, watch, watchServer }, plugins) {
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let buildOptions = {
     ...commonBuildOptions,
@@ -421,7 +424,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
     })),
     bundle: true,
     splitting: false,
-    outdir: `${targetDir}/server-css`,
+    outdir: `${serverDir}/server-css`,
     platform: "node",
     format: "esm",
     packages: "external",
@@ -437,7 +440,7 @@ async function buildServerCSS({ targetDir, watch, watchServer }, plugins) {
   await esbuild.build(buildOptions);
 }
 
-function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild) {
+function createPostbuildPlugins({ serverDir, clientDir }, onServerRebuild) {
   return {
     serverPlugins: [{
       name: "skip-css",
@@ -457,15 +460,15 @@ function createPostbuildPlugins({ targetDir, publicAssetsDir }, onServerRebuild)
       name: "postbuild-server-css",
       setup(build) {
         build.onEnd(async () => {
-          let dir = `${targetDir}/server-css`;
+          let dir = `${serverDir}/server-css`;
           try {
             let files = (await readdir(dir)).filter((name) => name.endsWith(".css"));
             if (files.length === 0) return;
-            await mkdir(`${publicAssetsDir}/-`, { recursive: true });
+            await mkdir(clientDir, { recursive: true });
             await Promise.all(files.map(async (name) => {
-              let dir = `${publicAssetsDir}/-/${name.slice(0, -4)}`;
+              let dir = `${clientDir}/${name.slice(0, -4)}`;
               await mkdir(dir, { recursive: true });
-              await rename(`${targetDir}/server-css/${name}`, `${dir}/index.css`);
+              await rename(`${serverDir}/server-css/${name}`, `${dir}/index.css`);
             }));
             await rm(dir, {
               recursive: true,
@@ -493,7 +496,7 @@ async function build(params) {
       log(`Build completed +${formatDuration(Date.now() - startTime)}`);
       inited = true;
     }
-    if (params.start) serverProcess = spawn("node", [`${params.targetDir}/server/index.js`], { stdio: "inherit" });
+    if (params.start) serverProcess = spawn("node", [`${params.serverDir}/server/index.js`], { stdio: "inherit" });
   }
   let { serverPlugins, serverCSSPlugins } = createPostbuildPlugins(params, handleServerRebuild);
   await Promise.all([
@@ -503,37 +506,37 @@ async function build(params) {
   ]);
 }
 
-const defaultTargetDir = "dist";
-async function clean({ targetDir, publicAssetsDir }) {
+async function clean({ serverDir, clientDir }) {
   let dirs = [
-    `${targetDir}/server`,
-    `${targetDir}/server-css`,
-    `${publicAssetsDir}/-`
+    `${serverDir}/server`,
+    `${serverDir}/server-css`,
+    clientDir
   ];
   return Promise.all(dirs.map((dir) => rm(dir, {
     recursive: true,
     force: true
   })));
 }
-async function cli(args = []) {
-  let publicAssetsDir = args[0];
-  let targetDir = args[1];
-  if (!publicAssetsDir || publicAssetsDir.startsWith("--")) throw new Error("Public assets directory is undefined");
-  if (!targetDir || targetDir.startsWith("--")) targetDir = defaultTargetDir;
+async function cli(input = []) {
+  let args = new Args(input);
+  let clientDir = args.getValue("--client-dir");
+  let serverDir = args.getValue("--server-dir", "dist");
+  if (!clientDir) throw new Error("Public assets directory is undefined");
   let params = {
-    targetDir,
-    publicAssetsDir,
-    silent: args.includes("--silent"),
-    watch: args.includes("--watch"),
-    watchServer: args.includes("--watch-server"),
-    watchClient: args.includes("--watch-client"),
-    start: args.includes("--start")
+    serverDir,
+    clientDir,
+    silent: args.hasKey("--silent"),
+    watch: args.hasKey("--watch"),
+    watchServer: args.hasKey("--watch-server"),
+    watchClient: args.hasKey("--watch-client"),
+    start: args.hasKey("--start")
   };
-  if (args.includes("--clean-only")) {
+  if (args.hasKey("--no-auto-entries")) params.entriesPath = null;
+  if (args.hasKey("--clean-only")) {
     await clean(params);
     return;
   }
-  if (args.includes("--clean")) await clean(params);
+  if (args.hasKey("--clean")) await clean(params);
   await build(params);
 }
 
@@ -548,7 +551,7 @@ function createApp(callback) {
   let app = express();
   if (!app.events) app.events = new EventEmitter();
   let host = process.env.APP_HOST || "localhost";
-  let port = Number(process.env.APP_PORT) || 80;
+  let port = Number(process.env.APP_PORT) || 3e3;
   let listen = () => {
     app.listen(port, host, () => {
       emitLog(app, `Server running at ${`http://${host}:${port}/`} (${`NODE_ENV=${process.env.NODE_ENV}`})`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appstage",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -29,7 +29,8 @@
     "@types/node": "^25.4.0"
   },
   "dependencies": {
+    "args-json": "^1.3.3",
     "dateshape": "^1.1.2",
-    "esbuild": "^0.27.3"
+    "esbuild": "^0.27.4"
   }
 }

package/src/scripts/bin.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { hasKey, isKey } from "args-json";
 import { cli } from "./cli.ts";
 
 const availableScriptNames = new Set(["build", "dev", "prod"]);
@@ -19,21 +20,24 @@ async function run() {
   if (scriptName === "build") return await cli(args);
 
   let nodeEnv = nodeEnvMap[scriptName];
-  let host = args[0];
 
   if (nodeEnv !== undefined) process.env.NODE_ENV = nodeEnv;
 
-  if (host) {
-    let [hostname, port] = host.split(":");
+  if (args.length !== 0 && !isKey(args[0])) {
+    let [hostname, port] = args[0].split(":");
 
     if (hostname) process.env.APP_HOST = hostname;
     if (port) process.env.APP_PORT = port;
+
+    args.shift();
   }
 
+  if (!hasKey("--client-dir")) args.push("--client-dir", "src/public/-");
+
   await cli(
     nodeEnv === "development"
-      ? ["src/public", "--clean", "--start", "--watch"]
-      : ["src/public", "--clean", "--start", "--silent"],
+      ? ["--clean", "--start", "--watch", ...args]
+      : ["--clean", "--start", "--silent", ...args],
   );
 }
 

package/src/scripts/build.ts

@@ -27,7 +27,7 @@ export async function build(params: BuildParams) {
     }
 
     if (params.start)
-      serverProcess = spawn("node", [`${params.targetDir}/server/index.js`], {
+      serverProcess = spawn("node", [`${params.serverDir}/server/index.js`], {
         stdio: "inherit",
       });
   }

package/src/scripts/cli.ts

@@ -1,46 +1,42 @@
 import { rm } from "node:fs/promises";
+import { Args } from "args-json";
 import { build } from "./build.ts";
 import type { BuildParams } from "./types/BuildParams.ts";
 
-const defaultTargetDir = "dist";
-
-async function clean({ targetDir, publicAssetsDir }: BuildParams) {
-  let dirs = [
-    `${targetDir}/server`,
-    `${targetDir}/server-css`,
-    `${publicAssetsDir}/-`,
-  ];
+async function clean({ serverDir, clientDir }: BuildParams) {
+  let dirs = [`${serverDir}/server`, `${serverDir}/server-css`, clientDir];
 
   return Promise.all(
     dirs.map((dir) => rm(dir, { recursive: true, force: true })),
   );
 }
 
-export async function cli(args: string[] = []) {
-  let publicAssetsDir = args[0];
-  let targetDir = args[1];
+export async function cli(input: string[] = []) {
+  let args = new Args(input);
 
-  if (!publicAssetsDir || publicAssetsDir.startsWith("--"))
-    throw new Error("Public assets directory is undefined");
+  let clientDir = args.getValue("--client-dir");
+  let serverDir = args.getValue("--server-dir", "dist");
 
-  if (!targetDir || targetDir.startsWith("--")) targetDir = defaultTargetDir;
+  if (!clientDir) throw new Error("Public assets directory is undefined");
 
   let params: BuildParams = {
-    targetDir,
-    publicAssetsDir,
-    silent: args.includes("--silent"),
-    watch: args.includes("--watch"),
-    watchServer: args.includes("--watch-server"),
-    watchClient: args.includes("--watch-client"),
-    start: args.includes("--start"),
+    serverDir,
+    clientDir,
+    silent: args.hasKey("--silent"),
+    watch: args.hasKey("--watch"),
+    watchServer: args.hasKey("--watch-server"),
+    watchClient: args.hasKey("--watch-client"),
+    start: args.hasKey("--start"),
   };
 
-  if (args.includes("--clean-only")) {
+  if (args.hasKey("--no-auto-entries")) params.entriesPath = null;
+
+  if (args.hasKey("--clean-only")) {
     await clean(params);
     return;
   }
 
-  if (args.includes("--clean")) await clean(params);
+  if (args.hasKey("--clean")) await clean(params);
 
   await build(params);
 }

package/src/scripts/types/BuildParams.ts

@@ -1,9 +1,18 @@
 export type BuildParams = {
-  targetDir: string;
-  publicAssetsDir: string;
+  serverDir: string;
+  clientDir: string;
   silent?: boolean;
   watch?: boolean;
   watchClient?: boolean;
   watchServer?: boolean;
   start?: boolean;
+  /**
+   * A file path that the automatically picked entry exports will be
+   * written to.
+   *
+   * Set it to `null` to skip the automatic picking of entry exports.
+   *
+   * @default "src/server/entries.ts"
+   */
+  entriesPath?: string | null;
 };

package/src/scripts/utils/buildClient.ts

@@ -10,7 +10,7 @@ import { getEntryPoints } from "./getEntryPoints.ts";
  * rendering.
  */
 export async function buildClient(
-  { publicAssetsDir, watch, watchClient }: BuildParams,
+  { clientDir, watch, watchClient }: BuildParams,
   plugins?: Plugin[],
 ) {
   let clientEntries = await getEntryPoints(["ui/index"]);
@@ -21,7 +21,7 @@ export async function buildClient(
     bundle: true,
     splitting: true,
     format: "esm",
-    outdir: `${publicAssetsDir}/-`,
+    outdir: clientDir,
     outbase: "src/entries",
     minify: process.env.NODE_ENV !== "development",
     plugins,

package/src/scripts/utils/buildServer.ts

@@ -3,18 +3,17 @@ import { commonBuildOptions } from "../const/commonBuildOptions.ts";
 import type { BuildParams } from "../types/BuildParams.ts";
 import { populateEntries } from "./populateEntries.ts";
 
-export async function buildServer(
-  { targetDir, watch, watchServer }: BuildParams,
-  plugins?: Plugin[],
-) {
-  await populateEntries();
+export async function buildServer(params: BuildParams, plugins?: Plugin[]) {
+  let { serverDir, watch, watchServer } = params;
+
+  await populateEntries(params);
 
   let buildOptions: BuildOptions = {
     ...commonBuildOptions,
     entryPoints: ["src/server/index.ts"],
     bundle: true,
     splitting: true,
-    outdir: `${targetDir}/server`,
+    outdir: `${serverDir}/server`,
     platform: "node",
     format: "esm",
     packages: "external",

package/src/scripts/utils/buildServerCSS.ts

@@ -4,7 +4,7 @@ import type { BuildParams } from "../types/BuildParams.ts";
 import { getEntryPoints } from "./getEntryPoints.ts";
 
 export async function buildServerCSS(
-  { targetDir, watch, watchServer }: BuildParams,
+  { serverDir, watch, watchServer }: BuildParams,
   plugins?: Plugin[],
 ) {
   let serverEntries = await getEntryPoints(["server", "server/index"]);
@@ -17,7 +17,7 @@ export async function buildServerCSS(
     })),
     bundle: true,
     splitting: false,
-    outdir: `${targetDir}/server-css`,
+    outdir: `${serverDir}/server-css`,
     platform: "node",
     format: "esm",
     packages: "external",

package/src/scripts/utils/createPostbuildPlugins.ts

@@ -3,7 +3,7 @@ import type { Plugin } from "esbuild";
 import type { BuildParams } from "../types/BuildParams.ts";
 
 export function createPostbuildPlugins(
-  { targetDir, publicAssetsDir }: BuildParams,
+  { serverDir, clientDir }: BuildParams,
   onServerRebuild: () => void,
 ) {
   let serverPlugins: Plugin[] = [
@@ -29,7 +29,7 @@ export function createPostbuildPlugins(
       name: "postbuild-server-css",
       setup(build) {
         build.onEnd(async () => {
-          let dir = `${targetDir}/server-css`;
+          let dir = `${serverDir}/server-css`;
 
           try {
             let files = (await readdir(dir)).filter((name) =>
@@ -38,15 +38,15 @@ export function createPostbuildPlugins(
 
             if (files.length === 0) return;
 
-            await mkdir(`${publicAssetsDir}/-`, { recursive: true });
+            await mkdir(clientDir, { recursive: true });
 
             await Promise.all(
               files.map(async (name) => {
-                let dir = `${publicAssetsDir}/-/${name.slice(0, -4)}`;
+                let dir = `${clientDir}/${name.slice(0, -4)}`;
 
                 await mkdir(dir, { recursive: true });
                 await rename(
-                  `${targetDir}/server-css/${name}`,
+                  `${serverDir}/server-css/${name}`,
                   `${dir}/index.css`,
                 );
               }),

package/src/scripts/utils/populateEntries.ts

@@ -1,8 +1,11 @@
 import { writeFile } from "node:fs/promises";
+import type { BuildParams } from "../types/BuildParams.ts";
 import { getEntryPoints } from "./getEntryPoints.ts";
 import { toImportPath } from "./toImportPath.ts";
 
-export async function populateEntries() {
+export async function populateEntries({ entriesPath }: BuildParams) {
+  if (entriesPath === null) return;
+
   let serverEntries = await getEntryPoints(["server", "server/index"]);
   let content = "";
 
@@ -19,7 +22,7 @@ export async function populateEntries() {
   }
 
   await writeFile(
-    "src/server/autoentries.ts",
+    entriesPath ?? "src/server/entries.ts",
     `// Populated automatically during the build phase by picking
 // all server exports from "src/entries/<entry_name>/server(/index)?.(js|ts)"
 ${content}

package/src/utils/createApp.ts

@@ -13,7 +13,7 @@ export function createApp(callback?: () => void | Promise<void>) {
   if (!app.events) app.events = new EventEmitter();
 
   let host = process.env.APP_HOST || "localhost";
-  let port = Number(process.env.APP_PORT) || 80;
+  let port = Number(process.env.APP_PORT) || 3000;
 
   let listen = () => {
     app.listen(port, host, () => {