⚡ dde and docs improvements (#27)

* ⚡ 🎉 * ⚡ wip * 🔤 * ⚡ wip * ⚡ wip * ⚡ Refatc signals to .get/.set syntax #26 * 🐛 Better types for on* * 🔤 * 🔤 * 🐛 coumputed signal * 🔤 ⚡ Docs UI/UX * ⚡ 🔤 UI enhancements * ⚡ (bs) (un)min * 🔤 adds debugging * 🔤 ssr * 🔤 * ⚡ bs/lint * 🔤 * 🔤 UI * 🔤 updates texts * 🔤UI * ⚡ dispatch * 🔤 events * 🔤 elements * 🔤 intro * 🐛 fixes completitions for el with components * 🐛 wrong file(s) in git * 🔤 logo * 🐛 🔤 types 3ps * 🔤 ui/ux * 🔤 * 🔤 * 🔤 scopes * 🔤 * 🔤 ui/ux * 🔤 * ⚡ issignal * 🔤 improvemens * ⚡ irelands * 🔤 UI/UX/wording * 🐛 npx-hint [Scrollable region must have keyboard access | Axe Rules | Deque University | Deque Systems](https://dequeuniversity.com/rules/axe/4.10/scrollable-region-focusable?application=axeAPI) * 🔤 logos * ⚡ better? dts builds * Update README.md
2025-07-01 12:22:15 +02:00 · 2025-03-07 14:40:45 +01:00
parent dba4e93b88
commit 4366027658
110 changed files with 16261 additions and 4741 deletions
--- a/bs/dev/.build.js
+++ b/bs/dev/.build.js
@ -0,0 +1,108 @@
+#!/usr/bin/env -S npx nodejsscript
+import { bundle, bundle as bundleDTS } from "dts-bundler";
+const css= echo.css`
+	.info{ color: gray; }
+`;
+
+export async function build({ files, filesOut, minify= "partial", dde= true }){
+	for(const file_root of files){
+		const file= file_root+".js";
+		echo(`Processing ${file} (minified: ${minify})`);
+		const out= filesOut(file);
+		const esbuild_output= buildEsbuild({ file, out, minify });
+		echoVariant(esbuild_output.stderr.split("\n")[1].trim()+ " (esbuild)");
+
+		const file_dts= file_root+".d.ts";
+		const file_dts_out= filesOut(file_dts);
+		echoVariant(file_dts_out, true);
+		buildDts({
+			bundle: out,
+			entry: file_dts,
+		});
+		echoVariant(file_dts_out);
+
+		if(dde) toDDE(file, file_root);
+	}
+	return 0;
+
+	async function toDDE(file, file_root){
+		const name= "dde";
+		const out= filesOut(file_root+".js", name);
+
+		const params= [
+			"--format=iife",
+			"--global-name="+name,
+		];
+		const dde_output= buildEsbuild({ file, out, minify, params });
+		echoVariant(`${out} (${file} → globalThis.${name})`)
+
+		const file_dts= file_root+".d.ts";
+		const file_dts_out= filesOut(file_dts, name);
+		echoVariant(file_dts_out, true);
+		buildDts({
+			name,
+			bundle: out,
+			entry: file_dts,
+		})
+		echoVariant(file_dts_out);
+
+		return dde_output;
+	}
+}
+export function buildDts({ bundle, entry, name }){
+	const out= bundle.slice(0, bundle.lastIndexOf("."))+".d.ts";
+	const dts_b_g_output= s.run([
+		"npx dts-bundle-generator",
+		"--silent",
+		"-o ::out::",
+		!name ? false : ("--umd-module-name "+name),
+		"--inline-declare-global",
+		"::entry::"
+	].filter(Boolean).join(" "), { out, entry });
+	return dts_b_g_output;
+}
+class ErrorEsbuild extends Error{
+	constructor({ code, stderr }){
+		super(stderr);
+		this.code= code;
+		this.stderr= stderr;
+	}
+}
+function buildEsbuild({ file, out, minify= "partial", params= [] }){
+	try {
+		return esbuild({ file, out, minify, params });
+	} catch(e){
+		if(e instanceof ErrorEsbuild)
+			return $.exit(e.code, echo(e.stderr));
+		throw e;
+	}
+}
+export function esbuild({ file, out, minify= "partial", params= [] }){
+	const esbuild_output= s.$().run([
+		"npx esbuild '::file::'",
+		"--platform=neutral",
+		"--bundle",
+		minifyOption(minify),
+		"--legal-comments=inline",
+		"--packages=external",
+		...params,
+		"--outfile='::out::'"
+	].filter(Boolean).join(" "), { file, out });
+	if(esbuild_output.code)
+		throw new ErrorEsbuild(esbuild_output);
+	pipe(
+		f=> f.replace(/^ +/gm, m=> "\t".repeat(m.length/2)),
+		f=> s.echo(f).to(out)
+	)(s.cat(out));
+	return esbuild_output;
+}
+/** @param {"no"|"full"|"partial"} level */
+function minifyOption(level= "partial"){
+	if("no"===level) return undefined;
+	if("full"===level) return "--minify";
+	return "--minify-syntax --minify-identifiers";
+}
+function echoVariant(name, todo= false){
+	if(todo) return echo.use("-R", "~ "+name);
+	return echo("%c✓ "+name, css.info);
+}