@t8/serve 0.1.19 → 0.1.20

package/README.md

@@ -32,7 +32,7 @@ npx @t8/serve 3000 app public dist -b src/index.ts
 /playground
   - index.css
   - index.html
-     + <script src="/dist/index.js"></script>
+    + <script src="/dist/index.js"></script>
   - index.ts
 ```
 
@@ -63,8 +63,8 @@ import { serve } from "@t8/serve";
 let server = await serve({
   port: 3000,
   path: "app",
+  bundle: true, // or `{ input, output }`, or `input` path
   spa: true,
-  bundle: true,
 });
 
 // Stop
@@ -78,7 +78,7 @@ server.close();
 /playground
   - index.css
   - index.html
-     + <script src="/dist/index.js"></script>
+    + <script src="/dist/index.js"></script>
   - index.ts
 ```
 
@@ -92,8 +92,8 @@ let server: Server;
 test.beforeAll(async () => {
   server = await serve({
     path: "playground",
+    bundle: "src/index.tsx",
     spa: true,
-    bundle: true,
   });
 });
 

package/dist/index.js

@@ -16,9 +16,10 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
-  await rm(join(path, "dist"), { recursive: true, force: true });
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
+  await rm(join(path, dir), { recursive: true, force: true });
   await build({
     entryPoints: [inputFile],
     outfile: outputFile,

package/dist/run.cjs

@@ -19,9 +19,10 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = (0, import_node_path.join)(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = (0, import_node_path.join)(path, "dist", normalizedOptions.output ?? "index.js");
-  await (0, import_promises.rm)((0, import_node_path.join)(path, "dist"), { recursive: true, force: true });
+  let outputFile = (0, import_node_path.join)(path, dir, normalizedOptions.output ?? "index.js");
+  await (0, import_promises.rm)((0, import_node_path.join)(path, dir), { recursive: true, force: true });
   await (0, import_esbuild.build)({
     entryPoints: [inputFile],
     outfile: outputFile,

package/dist/run.mjs

@@ -18,9 +18,10 @@ async function bundle({ path = "", bundle: options } = {}) {
       input: options
     };
   else normalizedOptions = options;
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
-  await rm(join(path, "dist"), { recursive: true, force: true });
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
+  await rm(join(path, dir), { recursive: true, force: true });
   await build({
     entryPoints: [inputFile],
     outfile: outputFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t8/serve",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "",
   "keywords": [
     "node",

package/src/BundleConfig.ts

@@ -1,4 +1,20 @@
 export type BundleConfig = {
+  /**
+   * Output directory path relative to the server config `path`.
+   *
+   * @defaultValue "dist"
+   */
+  dir?: string;
+  /**
+   * Input path relative to the server config `path`.
+   *
+   * @defaultValue "index.ts"
+   */
   input?: string;
+  /**
+   * Output path relative to the bundle config `dir`.
+   *
+   * @defaultValue "index.js"
+   */
   output?: string;
 };

package/src/Config.ts

@@ -1,12 +1,41 @@
 import type { BundleConfig } from "./BundleConfig";
 
 export type Config = {
+  /** Server URL. */
   url?: string;
+  /**
+   * Server host.
+   *
+   * @defaultValue "localhost"
+   */
   host?: string;
+  /**
+   * Server port.
+   *
+   * @defaultValue 3000
+   */
   port?: number;
+  /** Application path. */
   path?: string;
+  /**
+   * Public assets directories. If not provided, the application
+   * `path` is served as a public assets directory.
+   */
   dirs?: string[];
+  /**
+   * Enables single-page application (SPA) mode. If `true`, all
+   * unmatched URLs are served as "/".
+   */
   spa?: boolean;
+  /** Whether to log to the console. */
   log?: boolean;
-  bundle?: boolean | string | BundleConfig;
+  /**
+   * Bundle config.
+   *
+   * If `undefined`, bundling is skipped.
+   * Otherwise, its type is `BundleConfig`, with the following shorthand options:
+   * If `true`, it's equivalent to `{ input: "index.ts", output: "index.js" }`.
+   * If `string`, it's equivalent to `input` in `{ input, ouput: "index.js" }`.
+   */
+  bundle?: boolean | string | BundleConfig | undefined;
 };

package/src/bundle.ts

@@ -16,10 +16,11 @@ export async function bundle({ path = "", bundle: options }: Config = {}) {
     };
   else normalizedOptions = options;
 
+  let dir = normalizedOptions.dir ?? "dist";
   let inputFile = join(path, normalizedOptions.input ?? "index.ts");
-  let outputFile = join(path, "dist", normalizedOptions.output ?? "index.js");
+  let outputFile = join(path, dir, normalizedOptions.output ?? "index.js");
 
-  await rm(join(path, "dist"), { recursive: true, force: true });
+  await rm(join(path, dir), { recursive: true, force: true });
 
   await build({
     entryPoints: [inputFile],