build: add/update build script aliases

- add clean script
- add typedoc config files

packages/adapter-editart/package.json

@@ -14,6 +14,8 @@
 		"build": "node ../../tools/build.js src/index.ts adapter-editart",
 		"build:types": "tsc -d --emitDeclarationOnly --noEmit false",
 		"build:dist": "node ../../tools/build-dist.js",
+		"clean": "bun ../../tools/clean-package.js",
+		"doc": "typedoc",
 		"publish": "yarn npm publish --access public"
 	},
 	"dependencies": {

packages/adapter-editart/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

packages/adapter-fxhash/package.json

@@ -14,6 +14,8 @@
 		"build": "node ../../tools/build.js src/index.ts adapter-fxhash",
 		"build:types": "tsc -d --emitDeclarationOnly --noEmit false",
 		"build:dist": "node ../../tools/build-dist.js",
+		"clean": "bun ../../tools/clean-package.js",
+		"doc": "typedoc",
 		"publish": "yarn npm publish --access public"
 	},
 	"dependencies": {

packages/adapter-fxhash/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

packages/adapter-layer/package.json

@@ -15,6 +15,8 @@
 		"build": "node ../../tools/build.js src/index.ts adapter-layer && yarn build:types",
 		"build:types": "tsc -d --emitDeclarationOnly --noEmit false",
 		"build:dist": "node ../../tools/build-dist.js",
+		"clean": "bun ../../tools/clean-package.js",
+		"doc": "typedoc",
 		"publish": "yarn npm publish --access public"
 	},
 	"dependencies": {

packages/adapter-layer/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

packages/adapter-urlparams/package.json

@@ -13,6 +13,8 @@
 	"scripts": {
 		"build": "node ../../tools/build.js src/index.ts adapter-urlparams",
 		"build:dist": "node ../../tools/build-dist.js",
+		"clean": "bun ../../tools/clean-package.js",
+		"doc": "typedoc",
 		"publish": "yarn npm publish --access public"
 	},
 	"dependencies": {

packages/adapter-urlparams/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

packages/core/package.json

@@ -15,7 +15,8 @@
 		"build": "node ../../tools/build.js src/genart.ts genart && yarn build:types",
 		"build:types": "tsc -d --emitDeclarationOnly --noEmit false",
 		"build:dist": "node ../../tools/build-dist.js --decl && cp ../../README.md .",
-		"doc": "typedoc --excludePrivate --excludeInternal --out doc src/api.ts",
+		"clean": "bun ../../tools/clean-package.js api params time",
+		"doc": "typedoc src/api.ts",
 		"publish": "yarn npm publish --access public",
 		"test": "bun test"
 	},
@@ -27,6 +28,7 @@
 	},
 	"files": [
 		"api",
+		"params",
 		"time",
 		"./*.js",
 		"./*.d.ts"

packages/core/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

packages/time-fps-overlay/package.json

@@ -16,6 +16,7 @@
 		"build:types": "tsc -d --emitDeclarationOnly --noEmit false",
 		"build:dist": "node ../../tools/build-dist.js",
 		"clean": "bun ../../tools/clean-package.js",
+		"doc": "typedoc --excludePrivate --excludeInternal --out doc src/index.ts",
 		"publish": "yarn npm publish --access public"
 	},
 	"dependencies": {

packages/time-fps-overlay/typedoc.json

@@ -0,0 +1,7 @@
+{
+	"excludeProtected": true,
+	"excludePrivate": true,
+	"excludeInternal": true,
+	"out": "doc",
+	"entryPoints": ["src/index.ts"]
+}

tools/clean-package.js

@@ -0,0 +1,63 @@
+import { readdirSync, rmSync, statSync, unlinkSync } from "node:fs";
+import { basename, sep } from "node:path";
+
+// utility functions adapted from thi.ng/file-io
+// used here directly to be entirely self-contained...
+
+const isDirectory = (path) => statSync(path).isDirectory();
+
+const files = (dir, match, maxDepth = Infinity) =>
+	__files(dir, match, maxDepth, 0);
+
+function* __files(dir, match, maxDepth = Infinity, depth = 0) {
+	if (depth >= maxDepth) return;
+	const pred = (x) => match.test(x);
+	for (let f of readdirSync(dir).sort()) {
+		const curr = dir + sep + f;
+		try {
+			if (isDirectory(curr)) {
+				yield* __files(curr, match, maxDepth, depth + 1);
+			} else if (pred(curr)) {
+				yield curr;
+			}
+		} catch (e) {
+			console.warn(`ignoring file: ${f} (${e.message})`);
+		}
+	}
+}
+
+function* dirs(dir, pred, maxDepth = Infinity, depth = 0) {
+	if (depth >= maxDepth) return;
+	for (let f of readdirSync(dir).sort()) {
+		const curr = dir + sep + f;
+		try {
+			if (statSync(curr).isDirectory()) {
+				if (pred(curr)) yield curr;
+				yield* dirs(curr, pred, maxDepth, depth + 1);
+			}
+		} catch (e) {
+			console.warn(`ignoring file/dir: ${f} (${e.message})`);
+		}
+	}
+}
+
+// accept & merge additional dirs as CLI args
+const removeDirs = new Set([
+	"doc",
+	"api",
+	"generated",
+	"internal",
+	...process.argv.slice(2),
+]);
+
+for (let d of dirs(".", (x) => removeDirs.has(basename(x)), 1)) {
+	console.log("removing directory:", d);
+	rmSync(d, { recursive: true, force: true });
+}
+
+for (let f of files(".", /\.(map|js|d\.ts|tsbuildinfo|wasn|wast|o)$/)) {
+	if (f.indexOf("/bin/") === -1) {
+		console.log("removing file:", f);
+		unlinkSync(f);
+	}
+}