@pajh/buldng 0.0.2 → 0.0.3

package/dist/buldng-ops.js

@@ -0,0 +1,258 @@
+import { WorkFile } from "./workfile.js";
+
+// buldng-ops.js
+import fs from "node:fs";
+import path from "node:path";
+import esbuild from "esbuild";
+
+import { assertSourceRead, assertDestWrite, looksLikeFilename, ensureWorkFile } from "./buldng-validate.js";
+export const OPS = {
+    file: op_file,
+    literal: op_literal,
+    append: op_append,
+    replace: op_replace,
+    compile: op_compile,
+    materialise: op_materialise,
+    wrap: op_wrap,
+};
+
+// --------------------------------------------------
+// FILE — lazy read from disk. op:"file"
+// --------------------------------------------------
+export function file(strings, ...values) {
+    if (values.length > 0) {
+        throw new Error("file`` does not support interpolation");
+    }
+
+    const relPath = strings.join("");
+    const absPath = assertSourceRead(relPath);
+
+    return new WorkFile("file", { relPath, absPath }, []);
+}
+
+// op for "file"
+export function op_file(config, children) {
+    return fs.readFileSync(config.absPath, "utf8");
+}
+
+// --------------------------------------------------
+// LITERAL — inline text
+// --------------------------------------------------
+export function op_literal(config, children) {
+    return config.value;
+}
+
+// --------------------------------------------------
+// APPEND — concat children in order
+// --------------------------------------------------
+export function op_append(config, children) {
+    let out = "";
+
+    for (const child of children) {
+        const chunk = child.execute();
+
+        if (out.length > 0 &&
+            !out.endsWith("\n") &&
+            !chunk.startsWith("\n")) {
+            out += "\n";
+        }
+
+        out += chunk;
+    }
+
+    return out;
+}
+
+// --------------------------------------------------
+// REPLACE — replace tag with replacement
+// --------------------------------------------------
+export function op_replace(config, children) {
+    if (children.length !== 3) {
+        throw new Error(`replace(): expected 3 children, got ${children.length}`);
+    }
+
+    const [srcWF, tagWF, repWF] = children;
+
+    const src = srcWF.execute();
+    const tag = tagWF.execute();
+    const rep = repWF.execute();
+
+    if (!src.includes(tag)) {
+        throw new Error(`replace(): tag "${tag}" not found in source`);
+    }
+
+    return src.replace(tag, rep);
+}
+
+// --------------------------------------------------
+// COMPILE — esbuild wrapper
+// --------------------------------------------------
+export function op_compile(config, children) {
+    if (children.length !== 1) {
+        throw new Error(`compile(): expected 1 child, got ${children.length}`);
+    }
+
+    const child = children[0];
+
+    // If child is a file WorkFile, use its absolute path directly
+    if (child.op === "file" && child.config.absPath) {
+        const entry = child.config.absPath;
+
+        const result = esbuild.buildSync({
+            entryPoints: [entry],
+            bundle: true,
+            minify: true,
+            sourcemap: true,
+            format: "esm",
+            target: "esnext",
+            write: false
+        });
+
+        if (result.errors?.length) {
+            throw new Error("Build failed:\n" + result.errors.map(e => e.text).join("\n"));
+        }
+
+        return result.outputFiles[0].text;
+    }
+
+    // Otherwise compile from stdin
+    const srcText = child.execute();
+
+    const result = esbuild.buildSync({
+        stdin: {
+            contents: srcText,
+            resolveDir: process.cwd(),
+            sourcefile: "input.ts"
+        },
+        bundle: true,
+        minify: true,
+        sourcemap: true,
+        format: "esm",
+        target: "esnext",
+        write: false
+    });
+
+    if (result.errors?.length) {
+        throw new Error("Build failed:\n" + result.errors.map(e => e.text).join("\n"));
+    }
+
+    return result.outputFiles[0].text;
+}
+
+// --------------------------------------------------
+// MATERIALISE — write file if identical or new
+// --------------------------------------------------
+export function materialise(child, target) {
+    const childWF = ensureWorkFile(child, "materialise");
+    return new WorkFile("materialise", { target }, [childWF]);
+}
+
+export function op_materialise(config, children) {
+    if (children.length !== 1) {
+        throw new Error(`materialise(): expected 1 child, got ${children.length}`);
+    }
+
+    const child = children[0];
+
+    const text = child.execute();
+
+    if (looksLikeFilename(text)) {
+        console.warn(
+            `materialise(): child returned a filename '${text}' but expected text.\n` +
+            `Did you accidentally pass a materialised WorkFile instead of raw text?`
+        );
+    }
+
+    const abs = assertDestWrite(config.target);
+
+    if (!fs.existsSync(abs)) {
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, text, "utf8");
+        // NEW: mark file read-only
+        fs.chmodSync(abs, 0o444);
+        console.log(`materialise: ${abs}`);
+        return "/" + config.target;
+    }
+
+    const existing = fs.readFileSync(abs, "utf8");
+
+    if (existing === text) {
+        return "/" + config.target;
+    }
+
+    throw new Error(
+        `materialise(): cannot overwrite '${config.target}' — existing file differs from generated output`
+    );
+}
+
+// --------------------------------------------------
+// WRAP — pre + child + post
+// --------------------------------------------------
+export function op_wrap(config, children) {
+    if (children.length !== 1) {
+        throw new Error(`wrap(): expected 1 child, got ${children.length}`);
+    }
+
+    const inner = children[0].execute();
+    const pre = config.pre ?? "";
+    const post = config.post ?? "";
+
+    return pre + inner + post;
+}
+
+
+
+// --------------------------------------------------
+// literal(text)
+// --------------------------------------------------
+export function literal(value) {
+    return new WorkFile("literal", { value }, []);
+}
+
+// --------------------------------------------------
+// wrap(pre, child, post)
+// --------------------------------------------------
+export function wrap(pre, child, post, tag=null) {
+    const childWF = ensureWorkFile(child, "wrap child");
+    return new WorkFile("wrap", { pre, post }, [childWF], tag);
+}
+
+export function append() {
+    const children = [];
+
+    for (let i = 0; i < arguments.length; i++) {
+        const item = arguments[i];
+        const wf = ensureWorkFile(item, "append item");
+        children.push(wf);
+    }
+
+    if (children.length < 2) {
+        throw new Error("append(): requires at least 2 items");
+    }
+
+    return new WorkFile("append", {}, children);
+}
+
+
+// --------------------------------------------------
+// replace(source, tag, replacement)
+// --------------------------------------------------
+export function replace(source, tag, replacement) {
+    const srcWF = ensureWorkFile(source, "source");
+    const tagWF = ensureWorkFile(tag, "tag");
+    const repWF = ensureWorkFile(replacement, "replacement");
+
+    if (tagWF.op === "literal" && tagWF.config.value.trim() === "") {
+        throw new Error(`replace(): tag cannot be blank`);
+    }
+
+    return new WorkFile("replace", {}, [srcWF, tagWF, repWF]);
+}
+
+// --------------------------------------------------
+// compile(source)
+// --------------------------------------------------
+export function compile(source, flags = {}) {
+    const srcWF = ensureWorkFile(source, "source");
+    return new WorkFile("compile", { flags }, [srcWF]);
+}

package/dist/buldng-validate.js

@@ -1,6 +1,9 @@
 import fs from "node:fs";
 import path from "node:path";
-
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { WorkFile } from "./workfile.js";
+import { literal } from "./buldng-ops.js";
 // --------------------------------------------------
 // GLOBAL SOURCE & DEST ROOTS
 // --------------------------------------------------
@@ -25,24 +28,84 @@ export function setSource(dir) {
 export function setDest(dir) {
   const abs = path.resolve(dir);
 
+  // ------------------------------------------------------------
+  // If dest exists, perform full safety checks
+  // ------------------------------------------------------------
   if (fs.existsSync(abs)) {
-    const sentinel = path.join(abs, "BULDNG_SRC");
-    if (fs.existsSync(sentinel)) {
-      throw new Error(`SECURITY: Dest directory "${abs}" contains BLDNG_SRC sentinel`);
+
+    // SECURITY: full recursive scan for BULDNG_SRC
+    const stack = [abs];
+    while (stack.length) {
+      const current = stack.pop();
+      const entries = fs.readdirSync(current, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const full = path.join(current, entry.name);
+
+        if (entry.isDirectory()) {
+          stack.push(full);
+        } else if (entry.name === "BULDNG_SRC") {
+          throw new Error(`SECURITY: Dest directory "${abs}" contains BULDNG_SRC sentinel`);
+        }
+      }
+    }
+
+    // SECURITY: require DEST sentinel in root
+    const destSentinel = path.join(abs, "BULDNG_DEST");
+    if (!fs.existsSync(destSentinel)) {
+      throw new Error(`SECURITY: Refusing to delete "${abs}" — missing BULDNG_DEST sentinel`);
     }
 
-    const entries = fs.readdirSync(abs, { withFileTypes: true });
-    for (const entry of entries) {
-      fs.rmSync(path.join(abs, entry.name), { recursive: true, force: true });
+    // -----------------------------------------------------------
+    // Copy clean.sh from package into dest
+    // ------------------------------------------------------------
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const cleanSrc = path.join(__dirname, "clean.sh");   // your package copy
+    const cleanDest = path.join(abs, "clean.sh");
+
+    fs.copyFileSync(cleanSrc, cleanDest);
+    fs.chmodSync(cleanDest, 0o755);
+
+    // ------------------------------------------------------------
+    // Call safe_clean.sh with full path to clean.sh
+    // ------------------------------------------------------------
+    const safeClean = path.resolve("safe_clean.sh");
+    console.log(`SECURITY: Running safe_clean.sh on "${abs}"`);
+
+    const result = spawnSync(safeClean, [cleanDest], {
+      stdio: "inherit"
+    });
+
+    if (result.status !== 0) {
+      throw new Error(`SECURITY: safe_clean.sh failed with exit code ${result.status}`);
+    }
+
+    // ------------------------------------------------------------
+    // Verify directory is empty after cleaning
+    // ------------------------------------------------------------
+    const remaining = fs.readdirSync(abs);
+    if (remaining.length !== 0) {
+      throw new Error(`SECURITY: Dest directory "${abs}" not empty after safe_clean`);
     }
-  } else {
-    fs.mkdirSync(abs, { recursive: true });
   }
 
+  // ------------------------------------------------------------
+  // Always recreate DEST fresh
+  // ------------------------------------------------------------
+  fs.mkdirSync(abs, { recursive: true });
+
+  // Create DEST sentinel and mark read-only
+  const sentinelPath = path.join(abs, "BULDNG_DEST");
+  fs.writeFileSync(sentinelPath, "");
+  fs.chmodSync(sentinelPath, 0o444);
+
   DEST = abs;
   validateRoots();
 }
 
+
+
 export function getDest() {
   if (!DEST) throw new Error("SECURITY: Dest root not set");
   return DEST;
@@ -99,4 +162,46 @@ export function trackInput(absPath) {
   if (absPath.startsWith(SRC) && !absPath.startsWith(DEST)) {
     INPUTS.add(absPath);
   }
+}
+
+export function looksLikeFilename(s) {
+  return typeof s === "string" &&
+    s.length < 200 &&
+    /[A-Za-z0-9_\-\/]+\.(html|css|js)$/.test(s);
+}
+
+export function looksLikeHTML(s) {
+  return typeof s === "string" &&
+    s.trim().startsWith("<") &&
+    s.includes(">");
+}
+
+export function looksLikeCSS(s) {
+  return typeof s === "string" &&
+    s.includes("{") &&
+    s.includes("}");
+}
+
+export function looksLikeJS(s) {
+  return typeof s === "string" &&
+    (s.includes("function") ||
+      s.includes("const ") ||
+      s.includes("let "));
+}
+
+export function ensureLeadingSlash(p) {
+  return p.startsWith("/") ? p : "/" + p;
+}
+
+// --------------------------------------------------
+// ensureWorkFile(x)
+// --------------------------------------------------
+export function ensureWorkFile(x, fieldName = "value") {
+  if (x instanceof WorkFile) return x;
+
+  if (typeof x === "string") {
+    return literal(x);
+  }
+
+  throw new Error(`${fieldName} must be WorkFile or string`);
 }

package/dist/buldng.css

@@ -0,0 +1,148 @@
+/* --------------------------------------------------
+   LOCAL FONTS
+-------------------------------------------------- */
+@font-face {
+  font-family: Inter;
+  src: url("/assets/InterVariable.woff2") format("woff2");
+  font-weight: 100 900;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: "JetBrains Mono";
+  src: url("/assets/JetBrainsMono-Regular.woff2") format("woff2");
+  font-weight: 400;
+  font-display: swap;
+}
+
+/* --------------------------------------------------
+   CAMERA GEOMETRY — JS-SIZED, CSS-LAID-OUT
+   Matches layout.ts:
+     CAM-PORTRAIT
+     CAM-LANDSCAPE-A
+     CAM-LANDSCAPE-B
+-------------------------------------------------- */
+
+#b-camera {
+  position: absolute;
+  inset: 0;
+  margin: auto;
+  container-type: size;
+  overflow: hidden;
+  background: var(--back);
+}
+
+/* --------------------------------------------------
+   CAMERA INTERNAL AREAS
+-------------------------------------------------- */
+
+#b-camera-style {
+  display: grid;
+  height: 100%;
+  width: 100%;
+  grid-template-areas:
+    "header"
+    "client"
+    "footer";
+}
+
+#b-top-bar {
+  grid-area: header;
+  overflow: hidden;
+  container-type: size;
+  width: 100%;
+}
+
+#b-client-area {
+  grid-area: client;
+}
+
+#b-bottom-bar {
+  grid-area: footer;
+  overflow: hidden;
+}
+
+/* --------------------------------------------------
+   PORTRAIT MODE
+   JS sets width/height; CSS sets layout only
+-------------------------------------------------- */
+
+.CAM-PORTRAIT#b-camera-style {
+  grid-template-rows: 20% auto 5%
+}
+
+/* --------------------------------------------------
+   LANDSCAPE-A MODE
+   JS sets width/height; CSS sets layout only
+-------------------------------------------------- */
+
+.CAM-LANDSCAPE-A#b-camera-style {
+  grid-template-rows: 15% 80% 5%;
+}
+
+/* --------------------------------------------------
+   LANDSCAPE-B MODE
+   JS sets width/height; CSS sets layout only
+-------------------------------------------------- */
+
+.CAM-LANDSCAPE-B#b-camera-style {
+  grid-template-rows: 15% 80% 5%;
+}
+
+/* --------------------------------------------------
+   GLOBAL THEME VARIABLES
+-------------------------------------------------- */
+:root[data-theme="light"] {
+  --back: #f7f7f7;
+  --panel: #ffffff;
+  --button: #f0f0f0;
+  --text: #222222;
+  --line: #9c9c9c;
+  --highlight1: #4aa3ff;
+  --highlight2: #ffd84a;
+  --logo-bg: #e0e0e0;
+  --logo-fg: #222;
+  --logo-shadow: 0 2px 4px rgb(0 0 0 0.15);
+}
+
+:root[data-theme="dark"] {
+  --back: #111111;
+  --panel: #1b1b1b;
+  --button: #4a4a4a;
+  --text: #eeeeee;
+  --line: #848484;
+  --highlight1: #4aa3ff;
+  --highlight2: #ffd84a;
+  --logo-bg: #333;
+  --logo-fg: #eee;
+  --logo-shadow: 0 2px 4px rgb(0 0 0 0.4);
+}
+
+/* --------------------------------------------------
+   GLOBAL BODY
+-------------------------------------------------- */
+html {
+  margin: 0;
+  padding: 0;
+  height:100%;
+  width:100%;
+}
+
+body { 
+  background: var(--back);
+  margin: 0;
+  padding: 0; 
+  height: 100%;
+  width: 100%;
+}
+
+html, body, button, input, select, textarea {
+    font-family: Inter, sans-serif;
+    font-size: var(--std-font-size);
+    color: var(--text);
+}
+
+button {
+  background: var(--button);
+}
+

package/dist/clean.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -euo pipefail
+
+# Sentinel must exist in the current directory
+if [ ! -f BULDNG_DEST ]; then
+    echo "clean.sh: refusing — sentinel missing"
+    exit 1
+fi
+
+# Delete everything in the current directory, including subdirectories
+rm -rf ./*
+
+# Delete the script itself
+rm -f "$0"