feat: add custom builder

Author: lowlighter

@mizu/internal/engine/renderer.ts

@@ -1169,7 +1169,9 @@ export class Renderer {
    * ```
    */
   debug(message: string, target?: Nullable<HTMLElement | Comment>): void {
-    this.#debug?.(message, target)
+    if (this.#debug) {
+      this.#debug(message, target)
+    }
   }
 }
 
@@ -1178,9 +1180,9 @@ export type RendererOptions = {
   /** Initial {@linkcode Directive}s. */
   directives?: Arg<Renderer["load"]>
   /** Warnings callback. */
-  warn?: (message: string, target?: Nullable<HTMLElement | Comment>) => unknown
+  warn?: false | ((message: string, target?: Nullable<HTMLElement | Comment>) => unknown)
   /** Debug callback. */
-  debug?: (message: string, target?: Nullable<HTMLElement | Comment>) => unknown
+  debug?: false | ((message: string, target?: Nullable<HTMLElement | Comment>) => unknown)
 }
 
 /** {@linkcode Renderer.evaluate()} options. */

@mizu/render/client/client.ts

@@ -17,10 +17,13 @@ export class Client {
   static defaults = {
     window: globalThis.window,
     directives: defaults,
-    context: {},
+    // @ts-expect-error: custom builder
+    context: globalThis.MIZU_CUSTOM_DEFAULTS_CONTEXT ?? {},
+    // @ts-expect-error: custom builder
     // deno-lint-ignore no-console
-    warn: console.warn,
-    debug: undefined,
+    warn: globalThis.MIZU_CUSTOM_DEFAULTS_WARN ?? console.warn,
+    // @ts-expect-error: custom builder
+    debug: globalThis.MIZU_CUSTOM_DEFAULTS_DEBUG ?? false,
   } as unknown as Required<ClientOptions>
 
   /** {@linkcode Client} constructor. */

api/build.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env DENO_DIR=/tmp deno run --version=v2.1.2
+// Imports
+import { STATUS_CODE as Status, STATUS_TEXT as StatusText } from "@std/http"
+import { banner as _banner, js, meta } from "@www/tools.ts"
+
+/** API: Minify css */
+export default async function (request: Request) {
+  if (request.method !== "POST") {
+    return new Response(StatusText[Status.MethodNotAllowed], { status: Status.MethodNotAllowed })
+  }
+  if (new URL(`https://${request.headers.get("Host")}`).hostname !== new URL(`https://${Deno.env.get("ALLOWED_HOST") || "localhost"}`).hostname) {
+    return new Response("Custom builds may not be linked directly", { status: Status.Forbidden })
+  }
+  try {
+    const options = await request.json()
+    const bundled = await js("@mizu/render/client", {
+      banner: _banner.replace(`${meta.name} — ${meta.version}\n`, `${meta.name} — ${meta.version} — Custom build (${new Date().toDateString()})\n`),
+      minify: options.minify === true ? "terser" : false,
+      format: ["iife", "esm"].includes(options.format) ? options.format : throws("format: must be 'iife' or 'esm'"),
+      raw: {
+        define: {
+          "globalThis.MIZU_CUSTOM_DEFAULTS_CONTEXT": options.context ? options.context : "null",
+          "globalThis.MIZU_CUSTOM_DEFAULTS_WARN": options.console?.includes("warn") ? "console.warn" : "false",
+          "globalThis.MIZU_CUSTOM_DEFAULTS_DEBUG": options.console?.includes("debug") ? "console.debug" : "false",
+        },
+      },
+      overrides: {
+        imports: {
+          "./defaults.ts": Array.isArray(options.directives) && options.directives.every((name) => typeof name === "string")
+            ? `data:text/javascript;base64,${
+              btoa(
+                `
+            import _mizu from "@mizu/mizu"
+            ${options.directives.map((name: string, i: number) => `import _${i} from "@mizu/${name}"`).join("\n")}
+            export default [${options.directives.map((_: string, i: number) => `_${i}`).join(", ")}].flat(Infinity)
+          `.split("\n").map((line) => line.trim()).filter(Boolean).join("\n"),
+              )
+            }`
+            : throws("directives: must be an array of string"),
+        },
+      },
+    })
+    return new Response(bundled, { headers: { "Content-Type": "application/javascript; charset=utf-8" } })
+  } catch (error) {
+    if (error instanceof TypeError) {
+      return new Response(error.message, { status: Status.BadRequest })
+    }
+    return new Response(error.message, { status: Status.InternalServerError })
+  }
+}
+
+/** Throws a `TypeError` with the provided message. */
+function throws(message: string): never {
+  throw new TypeError(message)
+}

deno.jsonc

@@ -82,7 +82,7 @@
     },
     "serve": {
       "description": "Serve website locally",
-      "command": "deno serve --allow-read --allow-env --allow-net --allow-run --allow-write=/tmp --port=4649 --location=http://localhost:4649 www/serve.ts"
+      "command": "deno serve --allow-read --allow-env --allow-net --allow-run --allow-write=/tmp --allow-sys=osRelease --port=4649 --location=http://localhost:4649 www/serve.ts"
     },
     // Miscellaneous tasks
     "repo:fill-scopes": {
@@ -116,9 +116,10 @@
     "@libs/testing": "jsr:@libs/testing@4",
     "@std/fmt": "jsr:@std/fmt@1",
     // Development server dependencies
+    "@api/": "./api/",
     "@www/": "./www/",
     "@deno/doc": "jsr:@deno/doc@~0.161",
-    "@libs/bundle": "jsr:@libs/bundle@12",
+    "@libs/bundle": "jsr:@libs/bundle@12.5",
     "@libs/logger": "jsr:@libs/logger@3",
     "@std/collections": "jsr:@std/collections@1",
     "@std/http": "jsr:@std/http@1",