feat: Add new cli-tool for creating and building webby projects

package-lock.json

@@ -7,17 +7,18 @@
         "": {
             "name": "webby",
             "version": "1.0.0",
-      "hasInstallScript": true,
             "license": "GPL-3.0",
             "dependencies": {
-        "esbuild": "^0.25.0",
+                "glob": "^11.0.0",
-        "rimraf": "^6.0.1"
+                "package-json-from-dist": "^1.0.0"
             },
             "bin": {
                 "webby": "dist/esm/bin.mjs"
             },
             "devDependencies": {
-        "@types/node": "^22.13.9"
+                "@types/node": "^22.13.9",
+                "esbuild": "^0.25.0",
+                "rimraf": "^6.0.1"
             },
             "engines": {
                 "node": ">=18"
@@ -30,6 +31,7 @@
             "cpu": [
                 "ppc64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -46,6 +48,7 @@
             "cpu": [
                 "arm"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -62,6 +65,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -78,6 +82,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -94,6 +99,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -110,6 +116,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -126,6 +133,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -142,6 +150,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -158,6 +167,7 @@
             "cpu": [
                 "arm"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -174,6 +184,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -190,6 +201,7 @@
             "cpu": [
                 "ia32"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -206,6 +218,7 @@
             "cpu": [
                 "loong64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -222,6 +235,7 @@
             "cpu": [
                 "mips64el"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -238,6 +252,7 @@
             "cpu": [
                 "ppc64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -254,6 +269,7 @@
             "cpu": [
                 "riscv64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -270,6 +286,7 @@
             "cpu": [
                 "s390x"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -286,6 +303,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -302,6 +320,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -318,6 +337,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -334,6 +354,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -350,6 +371,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -366,6 +388,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -382,6 +405,7 @@
             "cpu": [
                 "arm64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -398,6 +422,7 @@
             "cpu": [
                 "ia32"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -414,6 +439,7 @@
             "cpu": [
                 "x64"
             ],
+            "dev": true,
             "license": "MIT",
             "optional": true,
             "os": [
@@ -537,6 +563,7 @@
             "version": "0.25.0",
             "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.0.tgz",
             "integrity": "sha512-BXq5mqc8ltbaN34cDqWuYKyNhX8D/Z0J1xdtdQ8UcIIIyJyz+ZMKUt58tF3SrZ85jcfN/PZYhjR5uDQAYNVbuw==",
+            "dev": true,
             "hasInstallScript": true,
             "license": "MIT",
             "bin": {
@@ -710,6 +737,7 @@
             "version": "6.0.1",
             "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.0.1.tgz",
             "integrity": "sha512-9dkvaxAsk/xNXSJzMgFqqMCuFgt2+KsOFek3TMLfo8NCPfWpBmqwyNn5Y+NX56QUYfCtsyhF3ayiboEoUmJk/A==",
+            "dev": true,
             "license": "ISC",
             "dependencies": {
                 "glob": "^11.0.0",

src/bin.mts

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import type { WebbyAsyncOptions } from './index.js'
+import { loadPackageJson } from 'package-json-from-dist'
+
+const { version } = loadPackageJson(import.meta.url)
+
+const runHelpForUsage = () => console.error('run `webby --help` for usage information')
+
+export const help = `webby version ${version}
+  
+  Usage: webby <path to webby.conf.js file>
+  Builds your website with the information from the webby.conf.js file.
+  
+  Options:
+    -h --help            Display this usage info
+    --version            Display version
+  `
+
+import { parse, relative, resolve } from 'path'
+const cwd = process.cwd()
+
+const main = async (...args: string[]) => {
+	if (process.env.__WEBBY_TESTING_BIN_FAIL__ === '1') {
+		throw new Error('simulated Webby failure')
+	}
+	
+	const opt: WebbyAsyncOptions = {}
+	const paths: string[] = []
+	/*
+	let impl: (
+		path: string | string[],
+		opt?: WebbyAsyncOptions,
+	) => Promise<boolean> = webby
+	*/
+  
+    for (const arg of args) {
+		if (arg === '-h' || arg === '--help') {
+			console.log(help)
+			return 0
+		} else if (arg === '--version') {
+			console.log(version)
+			return 0
+		} else {
+			console.error(`unknown option: ${arg}`)
+			runHelpForUsage()
+			return 1
+		}
+    }
+	
+	if (!paths.length) {
+		console.error('webby: must provide a path to build')
+		runHelpForUsage()
+		return 1
+	}
+	
+	return 0
+}
+
+main.help = help
+main.version = version
+
+export default main
+
+if (process.env.__TESTING_WEBBY_BIN__ !== '1') {
+	const args = process.argv.slice(2)
+	main(...args).then(
+		code => process.exit(code),
+		er => {
+			console.error(er)
+			process.exit(1)
+		},
+	)
+}

src/index.ts

@@ -1 +1,18 @@
-console.log("This is Webby - A small static website builder written in TypeScript for learning purposes.")
+import { Dirent, Stats } from 'fs'
+import { GlobOptions } from 'glob'
+
+export interface WebbyAsyncOptions {
+    preserveRoot?: boolean
+    tmp?: string
+    maxRetries?: number
+    retryDelay?: number
+    backoff?: number
+    maxBackoff?: number
+    signal?: AbortSignal
+    glob?: boolean | GlobOptions
+    filter?:
+    | ((path: string, ent: Dirent | Stats) => boolean)
+    | ((path: string, ent: Dirent | Stats) => Promise<boolean>)
+}
+
+//console.log("This is Webby - A small static website builder written in TypeScript for learning purposes.")