@dirwell/cli 0.0.0-stage → 0.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dirwell contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @dirwell/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Unreleased alpha workspace. Install a theme separately; no default theme is selected.
+
+```sh
+npm install @dirwell/cli@alpha @dirwell/theme-plain@alpha
+npx dirwell build ./files --out ./generated --theme '@dirwell/theme-plain#createPlainTheme'
+npx dirwell server ./files --theme '@dirwell/theme-plain#createPlainTheme'
+```
+
+`--live` enables shared SSE revision notifications in Svelte/Vue clients. Plain remains script-free.
+
+`build` writes a dedicated static output tree. `server` renders HTML and reads listings/files live without generating a tree or using a watcher. It defaults to loopback, an ephemeral port, and safe media previews; HTML, SVG and other files download. Use `--port`, `--host` and `--mount` explicitly when needed. `PORT` is accepted for development proxies such as Portless.
+
+A JavaScript module passed through `--config` exports `{ theme, listing, build, server }`. Build options retain core filtering, sorting, metadata, symlinks and output-name policies. Server options provide filtering, sorting, authorization and header hooks. This is executable project configuration. For theme factories, use `--theme 'package#exportName'`; the package resolves from the working project. Unsupported legacy dev/daemon commands do not silently change behavior.
+
+`--page-size` and `--block-size` override the corresponding static policy as a pair. When only one is given, the other publication strategy is `all`. HTTP cache defaults to no-store; headers are configurable through the server config.
+
+Server mode replaces file-data rebuild/watch loops. Editing theme source still requires its framework compiler and a server restart; this is not framework HMR. Farm is not part of this server runtime.

package/dist/bin.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/bin.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { t as runCli } from "./src-7nVpwBzA.mjs";
+//#region src/bin.ts
+try {
+	const server = await runCli(process.argv.slice(2));
+	if (server !== null) {
+		let closing = false;
+		const close = async () => {
+			if (closing) return;
+			closing = true;
+			try {
+				await server.close();
+			} catch (error) {
+				console.error(error instanceof Error ? error.message : "Shutdown failed");
+				process.exitCode = 1;
+			}
+		};
+		process.once("SIGINT", close);
+		process.once("SIGTERM", close);
+	}
+} catch (error) {
+	console.error(error instanceof Error ? error.message : "Dirwell failed");
+	process.exitCode = 1;
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=bin.mjs.map

package/dist/bin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.mjs","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { runCli } from \"./index.ts\";\ntry {\n  const server = await runCli(process.argv.slice(2));\n  if (server !== null) {\n    let closing = false;\n    const close = async () => {\n      if (closing) return;\n      closing = true;\n      try {\n        await server.close();\n      } catch (error) {\n        console.error(error instanceof Error ? error.message : \"Shutdown failed\");\n        process.exitCode = 1;\n      }\n    };\n    process.once(\"SIGINT\", close);\n    process.once(\"SIGTERM\", close);\n  }\n} catch (error) {\n  console.error(error instanceof Error ? error.message : \"Dirwell failed\");\n  process.exitCode = 1;\n}\n"],"mappings":";;;AAEA,IAAI;CACF,MAAM,SAAS,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;CACjD,IAAI,WAAW,MAAM;EACnB,IAAI,UAAU;EACd,MAAM,QAAQ,YAAY;GACxB,IAAI,SAAS;GACb,UAAU;GACV,IAAI;IACF,MAAM,OAAO,MAAM;GACrB,SAAS,OAAO;IACd,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,iBAAiB;IACxE,QAAQ,WAAW;GACrB;EACF;EACA,QAAQ,KAAK,UAAU,KAAK;EAC5B,QAAQ,KAAK,WAAW,KAAK;CAC/B;AACF,SAAS,OAAO;CACd,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,gBAAgB;CACvE,QAAQ,WAAW;AACrB"}

package/dist/index.d.mts

@@ -0,0 +1,16 @@
+import { ExplorerTheme, GenerateOptions, ListingPolicy } from "@dirwell/core";
+import { ExplorerHandlerOptions } from "@dirwell/server";
+//#region src/index.d.ts
+export interface CliConfig {
+  readonly build?: Omit<GenerateOptions, "sourceDir" | "outputDir" | "theme" | "listing">;
+  readonly theme?: ExplorerTheme;
+  readonly listing?: ListingPolicy;
+  readonly server?: Omit<ExplorerHandlerOptions, "root" | "theme" | "listing">;
+}
+/** Parse explicit commands; return server ownership to the caller for graceful shutdown. */
+export declare function runCli(args: readonly string[], cwd?: string, log?: (value: string) => void): Promise<{
+  url: string;
+  close: () => Promise<void>;
+} | null>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { t as runCli } from "./src-7nVpwBzA.mjs";
+export { runCli };

package/dist/src-7nVpwBzA.mjs

@@ -0,0 +1,125 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { resolve } from "import-meta-resolve";
+import { parseArgs } from "node:util";
+import { generateExplorer } from "@dirwell/core";
+import { startExplorerServer } from "@dirwell/server/node";
+//#region src/index.ts
+const help = `Usage:
+  dirwell build <source> --out <output> --theme <module>#<factory>
+  dirwell server <source> --theme <module>#<factory> [--port 3000]
+
+Install your theme separately. No theme is installed or selected implicitly.
+Use --config <file.mjs> for a default export with theme, listing, and server hooks.
+Build options: --mode ssg|mpa, --urls relative|base|html-base, --base <path>
+Server options: --host <host>, --port <port>, --mount <path>, --live
+Both modes: --page-size <n>, --block-size <n>
+Live server reads on request. It does not build an output tree or require watch mode.
+`;
+const positive = (value, name) => {
+	if (value === void 0) return void 0;
+	const number = Number(value);
+	if (!Number.isSafeInteger(number) || number < 1) throw new TypeError(`${name} must be a positive integer`);
+	return number;
+};
+async function loadTheme(specifier, cwd) {
+	const delimiter = specifier.lastIndexOf("#"), name = delimiter < 0 ? specifier : specifier.slice(0, delimiter), exported = delimiter < 0 ? "default" : specifier.slice(delimiter + 1);
+	if (!name || !exported) throw new TypeError("Theme needs a module and export name");
+	const module = await (name.startsWith(".") || path.isAbsolute(name) ? import(pathToFileURL(path.resolve(cwd, name)).href) : import(resolve(name, pathToFileURL(path.join(cwd, "package.json")).href)));
+	const candidate = typeof module[exported] === "function" ? await module[exported]() : module[exported];
+	if (typeof candidate !== "object" || candidate === null || !("name" in candidate) || typeof candidate.name !== "string" || !("render" in candidate) || typeof candidate.render !== "function") throw new TypeError("Theme export must be a theme or theme factory");
+	return candidate;
+}
+/** Parse explicit commands; return server ownership to the caller for graceful shutdown. */
+async function runCli(args, cwd = process.cwd(), log = console.log) {
+	const parsed = parseArgs({
+		args: [...args],
+		allowPositionals: true,
+		options: {
+			help: {
+				type: "boolean",
+				short: "h"
+			},
+			live: { type: "boolean" },
+			theme: { type: "string" },
+			config: { type: "string" },
+			out: { type: "string" },
+			mode: { type: "string" },
+			urls: { type: "string" },
+			base: { type: "string" },
+			host: { type: "string" },
+			port: { type: "string" },
+			mount: { type: "string" },
+			"page-size": { type: "string" },
+			"block-size": { type: "string" }
+		}
+	});
+	if (parsed.values.help) {
+		log(help);
+		return null;
+	}
+	const [command, source] = parsed.positionals;
+	if (!["build", "server"].includes(command ?? "") || source === void 0 || parsed.positionals.length !== 2) throw new TypeError(help);
+	let config = {};
+	if (parsed.values.config) {
+		const module = await import(pathToFileURL(path.resolve(cwd, parsed.values.config)).href);
+		if (typeof module.default !== "object" || module.default === null) throw new TypeError("Config must export an object");
+		config = module.default;
+	}
+	const theme = parsed.values.theme ? await loadTheme(parsed.values.theme, cwd) : config.theme;
+	if (theme === void 0) throw new TypeError("Choose an explicit --theme or config.theme. Install the theme package separately.");
+	const pageSize = positive(parsed.values["page-size"], "page-size"), blockSize = positive(parsed.values["block-size"], "block-size");
+	const listing = pageSize !== void 0 || blockSize !== void 0 ? {
+		html: pageSize === void 0 ? { strategy: "all" } : {
+			strategy: "paged",
+			pageSize
+		},
+		data: blockSize === void 0 ? { strategy: "all" } : {
+			strategy: "blocks",
+			blockSize
+		}
+	} : config.listing;
+	const root = path.resolve(cwd, source);
+	if (command === "build") {
+		if (parsed.values.out === void 0) throw new TypeError("Build requires --out pointing to a dedicated generated output tree");
+		const mode = parsed.values.mode ?? config.build?.mode ?? "ssg", urlStrategy = parsed.values.urls ?? config.build?.urlStrategy ?? "relative";
+		if (mode !== "ssg" && mode !== "mpa") throw new TypeError("mode must be ssg or mpa");
+		if (![
+			"relative",
+			"base",
+			"html-base"
+		].includes(urlStrategy)) throw new TypeError("Unknown URL strategy");
+		await generateExplorer({
+			...config.build,
+			sourceDir: root,
+			outputDir: path.resolve(cwd, parsed.values.out),
+			theme,
+			mode,
+			urlStrategy,
+			...parsed.values.base === void 0 ? {} : { base: parsed.values.base },
+			...listing === void 0 ? {} : { listing }
+		});
+		log(`Built ${parsed.values.out}`);
+		return null;
+	}
+	const port = Number(parsed.values.port ?? process.env.PORT ?? "0");
+	if (!Number.isSafeInteger(port) || port < 0 || port > 65535) throw new TypeError("port must be between 0 and 65535");
+	const server = await startExplorerServer({
+		...config.server,
+		...parsed.values.live ? { live: {} } : {},
+		root,
+		theme,
+		port,
+		...listing === void 0 ? {} : { listing },
+		...pageSize === void 0 ? {} : { pageSize },
+		...blockSize === void 0 ? {} : { blockSize },
+		...parsed.values.host === void 0 ? {} : { host: parsed.values.host },
+		...parsed.values.mount === void 0 ? {} : { mountPath: parsed.values.mount }
+	});
+	log(`Dirwell server: ${server.url}${parsed.values.mount ?? config.server?.mountPath ?? ""}/browse/`);
+	return server;
+}
+//#endregion
+export { runCli as t };
+
+//# sourceMappingURL=src-7nVpwBzA.mjs.map

package/dist/src-7nVpwBzA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-7nVpwBzA.mjs","names":["resolveModule"],"sources":["../src/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolve as resolveModule } from \"import-meta-resolve\";\nimport { parseArgs } from \"node:util\";\nimport { generateExplorer } from \"@dirwell/core\";\nimport type { ExplorerTheme, ListingPolicy, GenerateOptions } from \"@dirwell/core\";\nimport { startExplorerServer } from \"@dirwell/server/node\";\nimport type { ExplorerHandlerOptions } from \"@dirwell/server\";\n\nexport interface CliConfig {\n  readonly build?: Omit<GenerateOptions, \"sourceDir\" | \"outputDir\" | \"theme\" | \"listing\">;\n  readonly theme?: ExplorerTheme;\n  readonly listing?: ListingPolicy;\n  readonly server?: Omit<ExplorerHandlerOptions, \"root\" | \"theme\" | \"listing\">;\n}\nconst help = `Usage:\n  dirwell build <source> --out <output> --theme <module>#<factory>\n  dirwell server <source> --theme <module>#<factory> [--port 3000]\n\nInstall your theme separately. No theme is installed or selected implicitly.\nUse --config <file.mjs> for a default export with theme, listing, and server hooks.\nBuild options: --mode ssg|mpa, --urls relative|base|html-base, --base <path>\nServer options: --host <host>, --port <port>, --mount <path>, --live\nBoth modes: --page-size <n>, --block-size <n>\nLive server reads on request. It does not build an output tree or require watch mode.\n`;\nconst positive = (value: string | undefined, name: string): number | undefined => {\n  if (value === undefined) return undefined;\n  const number = Number(value);\n  if (!Number.isSafeInteger(number) || number < 1)\n    throw new TypeError(`${name} must be a positive integer`);\n  return number;\n};\nasync function loadTheme(specifier: string, cwd: string): Promise<ExplorerTheme> {\n  const delimiter = specifier.lastIndexOf(\"#\"),\n    name = delimiter < 0 ? specifier : specifier.slice(0, delimiter),\n    exported = delimiter < 0 ? \"default\" : specifier.slice(delimiter + 1);\n  if (!name || !exported) throw new TypeError(\"Theme needs a module and export name\");\n  const moduleUrl =\n    name.startsWith(\".\") || path.isAbsolute(name)\n      ? pathToFileURL(path.resolve(cwd, name)).href\n      : resolveModule(name, pathToFileURL(path.join(cwd, \"package.json\")).href);\n  const module: Record<string, unknown> = await import(moduleUrl);\n  const candidate =\n    typeof module[exported] === \"function\" ? await module[exported]() : module[exported];\n  if (\n    typeof candidate !== \"object\" ||\n    candidate === null ||\n    !(\"name\" in candidate) ||\n    typeof candidate.name !== \"string\" ||\n    !(\"render\" in candidate) ||\n    typeof candidate.render !== \"function\"\n  )\n    throw new TypeError(\"Theme export must be a theme or theme factory\");\n  return candidate as ExplorerTheme;\n}\n/** Parse explicit commands; return server ownership to the caller for graceful shutdown. */\nexport async function runCli(\n  args: readonly string[],\n  cwd = process.cwd(),\n  log: (value: string) => void = console.log,\n) {\n  const parsed = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    options: {\n      help: { type: \"boolean\", short: \"h\" },\n      live: { type: \"boolean\" },\n      theme: { type: \"string\" },\n      config: { type: \"string\" },\n      out: { type: \"string\" },\n      mode: { type: \"string\" },\n      urls: { type: \"string\" },\n      base: { type: \"string\" },\n      host: { type: \"string\" },\n      port: { type: \"string\" },\n      mount: { type: \"string\" },\n      \"page-size\": { type: \"string\" },\n      \"block-size\": { type: \"string\" },\n    },\n  });\n  if (parsed.values.help) {\n    log(help);\n    return null;\n  }\n  const [command, source] = parsed.positionals;\n  if (\n    ![\"build\", \"server\"].includes(command ?? \"\") ||\n    source === undefined ||\n    parsed.positionals.length !== 2\n  )\n    throw new TypeError(help);\n  let config: CliConfig = {};\n  if (parsed.values.config) {\n    const module = await import(pathToFileURL(path.resolve(cwd, parsed.values.config)).href);\n    if (typeof module.default !== \"object\" || module.default === null)\n      throw new TypeError(\"Config must export an object\");\n    config = module.default;\n  }\n  const theme = parsed.values.theme ? await loadTheme(parsed.values.theme, cwd) : config.theme;\n  if (theme === undefined)\n    throw new TypeError(\n      \"Choose an explicit --theme or config.theme. Install the theme package separately.\",\n    );\n  const pageSize = positive(parsed.values[\"page-size\"], \"page-size\"),\n    blockSize = positive(parsed.values[\"block-size\"], \"block-size\");\n  const listing: ListingPolicy | undefined =\n    pageSize !== undefined || blockSize !== undefined\n      ? {\n          html: pageSize === undefined ? { strategy: \"all\" } : { strategy: \"paged\", pageSize },\n          data: blockSize === undefined ? { strategy: \"all\" } : { strategy: \"blocks\", blockSize },\n        }\n      : config.listing;\n  const root = path.resolve(cwd, source);\n  if (command === \"build\") {\n    if (parsed.values.out === undefined)\n      throw new TypeError(\"Build requires --out pointing to a dedicated generated output tree\");\n    const mode = parsed.values.mode ?? config.build?.mode ?? \"ssg\",\n      urlStrategy = parsed.values.urls ?? config.build?.urlStrategy ?? \"relative\";\n    if (mode !== \"ssg\" && mode !== \"mpa\") throw new TypeError(\"mode must be ssg or mpa\");\n    if (![\"relative\", \"base\", \"html-base\"].includes(urlStrategy))\n      throw new TypeError(\"Unknown URL strategy\");\n    await generateExplorer({\n      ...config.build,\n      sourceDir: root,\n      outputDir: path.resolve(cwd, parsed.values.out),\n      theme,\n      mode,\n      urlStrategy: urlStrategy as \"relative\" | \"base\" | \"html-base\",\n      ...(parsed.values.base === undefined ? {} : { base: parsed.values.base }),\n      ...(listing === undefined ? {} : { listing }),\n    });\n    log(`Built ${parsed.values.out}`);\n    return null;\n  }\n  const port = Number(parsed.values.port ?? process.env.PORT ?? \"0\");\n  if (!Number.isSafeInteger(port) || port < 0 || port > 65535)\n    throw new TypeError(\"port must be between 0 and 65535\");\n  const server = await startExplorerServer({\n    ...config.server,\n    ...(parsed.values.live ? { live: {} } : {}),\n    root,\n    theme,\n    port,\n    ...(listing === undefined ? {} : { listing }),\n    ...(pageSize === undefined ? {} : { pageSize }),\n    ...(blockSize === undefined ? {} : { blockSize }),\n    ...(parsed.values.host === undefined ? {} : { host: parsed.values.host }),\n    ...(parsed.values.mount === undefined ? {} : { mountPath: parsed.values.mount }),\n  });\n  log(\n    `Dirwell server: ${server.url}${parsed.values.mount ?? config.server?.mountPath ?? \"\"}/browse/`,\n  );\n  return server;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@dirwell/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1-alpha",
+  "description": "Explicit-theme build and live-server commands for Dirwell.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vp-tw/dirwell.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "dirwell": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "tag": "alpha"
+  },
+  "dependencies": {
+    "@dirwell/core": "0.0.1-alpha",
+    "@dirwell/server": "0.0.1-alpha",
+    "import-meta-resolve": "4.2.0"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "vp pack"
+  }
 }