@trustless-work/blocks 0.0.1

package/bin/index.js

@@ -0,0 +1,1123 @@
+#!/usr/bin/env node
+
+/* 
+ AUTHOR: @trustless-work / Joel Vargas
+ COPYRIGHT: 2025 Trustless Work
+ LICENSE: MIT
+ VERSION: 1.0.0
+*/
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync, spawn } from "node:child_process";
+import readline from "node:readline";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PROJECT_ROOT = process.cwd();
+const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
+const GLOBAL_DEPS_FILE = path.join(TEMPLATES_DIR, "deps.json");
+
+const args = process.argv.slice(2);
+
+function detectPM() {
+  if (fs.existsSync(path.join(PROJECT_ROOT, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs.existsSync(path.join(PROJECT_ROOT, "yarn.lock"))) return "yarn";
+  if (fs.existsSync(path.join(PROJECT_ROOT, "bun.lockb"))) return "bun";
+  return "npm";
+}
+
+function run(cmd, args) {
+  const r = spawnSync(cmd, args.filter(Boolean), {
+    stdio: "inherit",
+    cwd: PROJECT_ROOT,
+    shell: true,
+  });
+  if (r.status !== 0) process.exit(r.status ?? 1);
+}
+
+function tryRun(cmd, args, errorMessage) {
+  const r = spawnSync(cmd, args.filter(Boolean), {
+    stdio: "inherit",
+    cwd: PROJECT_ROOT,
+    shell: true,
+  });
+  if (r.status !== 0) {
+    console.error(errorMessage);
+    process.exit(r.status ?? 1);
+  }
+}
+
+async function runAsync(cmd, args) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args.filter(Boolean), {
+      stdio: "inherit",
+      cwd: PROJECT_ROOT,
+      shell: true,
+    });
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${cmd} exited with code ${code}`));
+    });
+  });
+}
+
+const COLORS = {
+  reset: "\x1b[0m",
+  green: "\x1b[32m",
+  gray: "\x1b[90m",
+  blueTW: "\x1b[38;2;0;107;228m",
+};
+
+function logCheck(message) {
+  console.log(`${COLORS.green}✔${COLORS.reset} ${message}`);
+}
+
+function startSpinner(message) {
+  const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+  let i = 0;
+  process.stdout.write(`${frames[0]} ${message}`);
+  const timer = setInterval(() => {
+    i = (i + 1) % frames.length;
+    process.stdout.write(`\r${frames[i]} ${message}`);
+  }, 80);
+  return () => {
+    clearInterval(timer);
+    process.stdout.write("\r");
+  };
+}
+
+async function withSpinner(message, fn) {
+  const stop = startSpinner(message);
+  try {
+    await fn();
+    stop();
+    logCheck(message);
+  } catch (err) {
+    stop();
+    throw err;
+  }
+}
+
+async function promptYesNo(question, def = true) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  const suffix = def ? "(Y/n)" : "(y/N)";
+  const answer = await new Promise((res) =>
+    rl.question(`${question} ${suffix} `, (ans) => res(ans))
+  );
+  rl.close();
+  const a = String(answer).trim().toLowerCase();
+  if (!a) return def;
+  return a.startsWith("y");
+}
+
+function oscHyperlink(text, url) {
+  return `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
+}
+
+function printBannerTRUSTLESSWORK() {
+  const map = {
+    T: ["******", "  **  ", "  **  ", "  **  ", "  **  "],
+    R: ["***** ", "**  **", "***** ", "** ** ", "**  **"],
+    U: ["**  **", "**  **", "**  **", "**  **", " **** "],
+    S: [" **** ", "**    ", " **** ", "    **", " **** "],
+    L: ["**    ", "**    ", "**    ", "**    ", "******"],
+    E: ["******", "**    ", "***** ", "**    ", "******"],
+    W: ["**   **", "**   **", "** * **", "*** ***", "**   **"],
+    O: [" **** ", "**  **", "**  **", "**  **", " **** "],
+    K: ["**  **", "** ** ", "****  ", "** ** ", "**  **"],
+    " ": ["   ", "   ", "   ", "   ", "   "],
+  };
+  const text = "TRUSTLESS WORK";
+  const rows = ["", "", "", "", ""];
+  for (const ch of text) {
+    const glyph = map[ch] || map[" "];
+    for (let i = 0; i < 5; i++) {
+      rows[i] += glyph[i] + " ";
+    }
+  }
+  console.log("\n\n");
+  for (const line of rows) {
+    console.log(`${COLORS.blueTW}${line}${COLORS.reset}`);
+  }
+}
+
+function readProjectPackageJson() {
+  const pkgPath = path.join(PROJECT_ROOT, "package.json");
+  if (!fs.existsSync(pkgPath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function installDeps({ dependencies = {}, devDependencies = {} }) {
+  const pm = detectPM();
+  const BLOCKED = new Set([
+    "tailwindcss",
+    "@tailwindcss/cli",
+    "@tailwindcss/postcss",
+    "@tailwindcss/vite",
+    "postcss",
+    "autoprefixer",
+    "postcss-import",
+  ]);
+  const depList = Object.entries(dependencies)
+    .filter(([k]) => !BLOCKED.has(k))
+    .map(([k, v]) => `${k}@${v}`);
+  const devList = Object.entries(devDependencies)
+    .filter(([k]) => !BLOCKED.has(k))
+    .map(([k, v]) => `${k}@${v}`);
+
+  if (depList.length) {
+    if (pm === "pnpm") run("pnpm", ["add", ...depList]);
+    else if (pm === "yarn") run("yarn", ["add", ...depList]);
+    else if (pm === "bun") run("bun", ["add", ...depList]);
+    else run("npm", ["install", ...depList]);
+  }
+
+  if (devList.length) {
+    if (pm === "pnpm") run("pnpm", ["add", "-D", ...devList]);
+    else if (pm === "yarn") run("yarn", ["add", "-D", ...devList]);
+    else if (pm === "bun") run("bun", ["add", "-d", ...devList]);
+    else run("npm", ["install", "-D", ...devList]);
+  }
+}
+
+function loadConfig() {
+  const cfgPath = path.join(PROJECT_ROOT, ".twblocks.json");
+  if (fs.existsSync(cfgPath)) {
+    try {
+      return JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+    } catch (e) {
+      console.warn("⚠️  Failed to parse .twblocks.json, ignoring.");
+    }
+  }
+  return {};
+}
+
+function parseFlags(argv) {
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--ui-base=")) {
+      flags.uiBase = a.split("=").slice(1).join("=");
+    } else if (a === "--ui-base") {
+      flags.uiBase = argv[i + 1];
+      i++;
+    } else if (a === "--install" || a === "-i") {
+      flags.install = true;
+    }
+  }
+  return flags;
+}
+
+function copyTemplate(name, { uiBase, shouldInstall = false } = {}) {
+  const srcFile = path.join(TEMPLATES_DIR, `${name}.tsx`);
+  const srcDir = path.join(TEMPLATES_DIR, name);
+  const outRoot = path.join(PROJECT_ROOT, "src", "components", "tw-blocks");
+
+  const config = loadConfig();
+  const effectiveUiBase = uiBase || config.uiBase || "@/components/ui";
+
+  function writeTransformed(srcPath, destPath) {
+    const raw = fs.readFileSync(srcPath, "utf8");
+    const transformed = raw.replaceAll("__UI_BASE__", effectiveUiBase);
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.writeFileSync(destPath, transformed, "utf8");
+    console.log(`✅ ${path.relative(PROJECT_ROOT, destPath)} created`);
+  }
+
+  if (fs.existsSync(srcDir) && fs.lstatSync(srcDir).isDirectory()) {
+    const skipDetails =
+      name === "escrows/escrows-by-role" ||
+      name === "escrows/escrows-by-signer" ||
+      name === "escrows";
+    // Copy directory recursively
+    const destDir = path.join(outRoot, name);
+    fs.mkdirSync(destDir, { recursive: true });
+    const stack = [""];
+    while (stack.length) {
+      const rel = stack.pop();
+      const current = path.join(srcDir, rel);
+      const entries = fs.readdirSync(current, { withFileTypes: true });
+      for (const entry of entries) {
+        const entryRel = path.join(rel, entry.name);
+        // Skip copying any shared directory at any depth
+        const parts = entryRel.split(path.sep);
+        if (parts.includes("shared")) {
+          continue;
+        }
+        if (skipDetails) {
+          const top = parts[0] || "";
+          const firstTwo = parts.slice(0, 2).join(path.sep);
+          if (
+            top === "details" ||
+            firstTwo === path.join("escrows-by-role", "details") ||
+            firstTwo === path.join("escrows-by-signer", "details")
+          ) {
+            continue;
+          }
+        }
+        const entrySrc = path.join(srcDir, entryRel);
+        const entryDest = path.join(destDir, entryRel);
+        if (entry.isDirectory()) {
+          stack.push(entryRel);
+          continue;
+        }
+        // Only process text files (.ts, .tsx, .js, .jsx)
+        if (/\.(tsx?|jsx?)$/i.test(entry.name)) {
+          writeTransformed(entrySrc, entryDest);
+        } else {
+          fs.mkdirSync(path.dirname(entryDest), { recursive: true });
+          fs.copyFileSync(entrySrc, entryDest);
+          console.log(`✅ ${path.relative(PROJECT_ROOT, entryDest)} created`);
+        }
+      }
+    }
+
+    // Post-copy: materialize shared initialize-escrow files into dialog/form
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/initialize-escrow";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/initialize-escrow/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/initialize-escrow/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "initialize-escrow",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared initialize-escrow files:",
+        e?.message || e
+      );
+    }
+
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/approve-milestone";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/approve-milestone/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/approve-milestone/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "approve-milestone",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared approve-milestone files:",
+        e?.message || e
+      );
+    }
+
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/change-milestone-status";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/change-milestone-status/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/change-milestone-status/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "change-milestone-status",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared change-milestone-status files:",
+        e?.message || e
+      );
+    }
+
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/fund-escrow";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/fund-escrow/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/fund-escrow/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "fund-escrow",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared fund-escrow files:",
+        e?.message || e
+      );
+    }
+
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/resolve-dispute";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/resolve-dispute/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/resolve-dispute/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "resolve-dispute",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared resolve-dispute files:",
+        e?.message || e
+      );
+    }
+
+    try {
+      const isSingleReleaseInitRoot =
+        name === "escrows/single-release/update-escrow";
+      const isSingleReleaseInitDialog =
+        name === "escrows/single-release/update-escrow/dialog";
+      const isSingleReleaseInitForm =
+        name === "escrows/single-release/update-escrow/form";
+
+      const srcSharedDir = path.join(
+        TEMPLATES_DIR,
+        "escrows",
+        "single-release",
+        "update-escrow",
+        "shared"
+      );
+
+      function copySharedInto(targetDir) {
+        if (!fs.existsSync(srcSharedDir)) return;
+        const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+          const entrySrc = path.join(srcSharedDir, entry.name);
+          const entryDest = path.join(targetDir, entry.name);
+          writeTransformed(entrySrc, entryDest);
+        }
+      }
+
+      if (isSingleReleaseInitRoot) {
+        copySharedInto(path.join(destDir, "dialog"));
+        copySharedInto(path.join(destDir, "form"));
+      } else if (isSingleReleaseInitDialog) {
+        copySharedInto(destDir);
+      } else if (isSingleReleaseInitForm) {
+        copySharedInto(destDir);
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared update-escrow files:",
+        e?.message || e
+      );
+    }
+
+    // If adding the whole single-release bundle, materialize all shared files
+    try {
+      if (name === "escrows/single-release") {
+        const modules = [
+          "initialize-escrow",
+          "approve-milestone",
+          "change-milestone-status",
+          "fund-escrow",
+          "resolve-dispute",
+          "update-escrow",
+        ];
+
+        for (const mod of modules) {
+          const srcSharedDir = path.join(
+            TEMPLATES_DIR,
+            "escrows",
+            "single-release",
+            mod,
+            "shared"
+          );
+          if (!fs.existsSync(srcSharedDir)) continue;
+
+          const targets = [
+            path.join(destDir, mod, "dialog"),
+            path.join(destDir, mod, "form"),
+          ];
+
+          const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+            const entrySrc = path.join(srcSharedDir, entry.name);
+            for (const t of targets) {
+              const entryDest = path.join(t, entry.name);
+              writeTransformed(entrySrc, entryDest);
+            }
+          }
+        }
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared files for single-release bundle:",
+        e?.message || e
+      );
+    }
+
+    // If adding the root escrows bundle, also materialize single-release shared files
+    try {
+      if (name === "escrows") {
+        const modules = [
+          "initialize-escrow",
+          "approve-milestone",
+          "change-milestone-status",
+          "fund-escrow",
+          "resolve-dispute",
+          "update-escrow",
+        ];
+
+        const baseTarget = path.join(destDir, "single-release");
+        for (const mod of modules) {
+          const srcSharedDir = path.join(
+            TEMPLATES_DIR,
+            "escrows",
+            "single-release",
+            mod,
+            "shared"
+          );
+          if (!fs.existsSync(srcSharedDir)) continue;
+
+          const targets = [
+            path.join(baseTarget, mod, "dialog"),
+            path.join(baseTarget, mod, "form"),
+          ];
+
+          const entries = fs.readdirSync(srcSharedDir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (!/\.(tsx?|jsx?)$/i.test(entry.name)) continue;
+            const entrySrc = path.join(srcSharedDir, entry.name);
+            for (const t of targets) {
+              const entryDest = path.join(t, entry.name);
+              writeTransformed(entrySrc, entryDest);
+            }
+          }
+        }
+      }
+    } catch (e) {
+      console.warn(
+        "⚠️  Failed to materialize shared files for escrows root:",
+        e?.message || e
+      );
+    }
+  } else if (fs.existsSync(srcFile)) {
+    fs.mkdirSync(outRoot, { recursive: true });
+    const destFile = path.join(outRoot, name + ".tsx");
+    writeTransformed(srcFile, destFile);
+  } else {
+    console.error(`❌ The template "${name}" does not exist`);
+    process.exit(1);
+  }
+
+  if (shouldInstall && fs.existsSync(GLOBAL_DEPS_FILE)) {
+    const meta = JSON.parse(fs.readFileSync(GLOBAL_DEPS_FILE, "utf8"));
+    installDeps(meta);
+  }
+}
+
+function copySharedDetailsInto(targetRelativeDir, { uiBase } = {}) {
+  const srcDir = path.join(TEMPLATES_DIR, "escrows", "details");
+  const outRoot = path.join(PROJECT_ROOT, "src", "components", "tw-blocks");
+  const destDir = path.join(outRoot, targetRelativeDir);
+  const config = loadConfig();
+  const effectiveUiBase = uiBase || config.uiBase || "@/components/ui";
+
+  if (!fs.existsSync(srcDir)) return;
+  fs.mkdirSync(destDir, { recursive: true });
+
+  function writeTransformed(srcPath, destPath) {
+    const raw = fs.readFileSync(srcPath, "utf8");
+    const transformed = raw.replaceAll("__UI_BASE__", effectiveUiBase);
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.writeFileSync(destPath, transformed, "utf8");
+    console.log(`✅ ${path.relative(PROJECT_ROOT, destPath)} created`);
+  }
+
+  const stack = [""];
+  while (stack.length) {
+    const rel = stack.pop();
+    const current = path.join(srcDir, rel);
+    const entries = fs.readdirSync(current, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryRel = path.join(rel, entry.name);
+      const entrySrc = path.join(srcDir, entryRel);
+      const entryDest = path.join(destDir, entryRel);
+      if (entry.isDirectory()) {
+        stack.push(entryRel);
+        continue;
+      }
+      if (/\.(tsx?|jsx?)$/i.test(entry.name)) {
+        writeTransformed(entrySrc, entryDest);
+      } else {
+        fs.mkdirSync(path.dirname(entryDest), { recursive: true });
+        fs.copyFileSync(entrySrc, entryDest);
+        console.log(`✅ ${path.relative(PROJECT_ROOT, entryDest)} created`);
+      }
+    }
+  }
+}
+
+function copySharedRoleSignerHooks() {
+  const srcDir = path.join(TEMPLATES_DIR, "tanstak");
+  const outRoot = path.join(PROJECT_ROOT, "src", "components", "tw-blocks");
+
+  const files = [
+    {
+      shared: "useEscrowsByRole.shared.ts",
+      targets: [
+        path.join(
+          outRoot,
+          "escrows",
+          "escrows-by-role",
+          "cards",
+          "useEsrowsByRole.ts"
+        ),
+        path.join(
+          outRoot,
+          "escrows",
+          "escrows-by-role",
+          "table",
+          "useEsrowsByRole.ts"
+        ),
+      ],
+    },
+    {
+      shared: "useEscrowsBySigner.shared.ts",
+      targets: [
+        path.join(
+          outRoot,
+          "escrows",
+          "escrows-by-signer",
+          "cards",
+          "useEsrowsBySigner.ts"
+        ),
+        path.join(
+          outRoot,
+          "escrows",
+          "escrows-by-signer",
+          "table",
+          "useEsrowsBySigner.ts"
+        ),
+      ],
+    },
+  ];
+
+  for (const group of files) {
+    const src = path.join(srcDir, group.shared);
+    if (!fs.existsSync(src)) continue;
+    const raw = fs.readFileSync(src, "utf8");
+    for (const dest of group.targets) {
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, raw, "utf8");
+      console.log(`✅ ${path.relative(PROJECT_ROOT, dest)} created`);
+    }
+  }
+}
+
+function findLayoutFile() {
+  const candidates = [
+    path.join(PROJECT_ROOT, "app", "layout.tsx"),
+    path.join(PROJECT_ROOT, "app", "layout.ts"),
+    path.join(PROJECT_ROOT, "app", "layout.jsx"),
+    path.join(PROJECT_ROOT, "app", "layout.js"),
+    path.join(PROJECT_ROOT, "src", "app", "layout.tsx"),
+    path.join(PROJECT_ROOT, "src", "app", "layout.ts"),
+    path.join(PROJECT_ROOT, "src", "app", "layout.jsx"),
+    path.join(PROJECT_ROOT, "src", "app", "layout.js"),
+  ];
+  return candidates.find((p) => fs.existsSync(p)) || null;
+}
+
+function injectProvidersIntoLayout(
+  layoutPath,
+  { reactQuery = false, trustless = false, wallet = false, escrow = false } = {}
+) {
+  try {
+    let content = fs.readFileSync(layoutPath, "utf8");
+
+    const importRQ =
+      'import { ReactQueryClientProvider } from "@/components/tw-blocks/providers/ReactQueryClientProvider";\n';
+    const importTW =
+      'import { TrustlessWorkProvider } from "@/components/tw-blocks/providers/TrustlessWork";\n';
+    const importEscrow =
+      'import { EscrowProvider } from "@/components/tw-blocks/escrows/escrow-context/EscrowProvider";\n';
+    const importWallet =
+      'import { WalletProvider } from "@/components/tw-blocks/wallet-kit/WalletProvider";\n';
+    const commentText =
+      "// Use these imports to wrap your application (<ReactQueryClientProvider>, <TrustlessWorkProvider>, <WalletProvider> y <EscrowProvider>)\n";
+
+    const needImport = (name) =>
+      !new RegExp(
+        `import\\s+[^;]*${name}[^;]*from\\s+['\"][^'\"]+['\"];?`
+      ).test(content);
+
+    let importsToAdd = "";
+    if (reactQuery && needImport("ReactQueryClientProvider"))
+      importsToAdd += importRQ;
+    if (trustless && needImport("TrustlessWorkProvider"))
+      importsToAdd += importTW;
+    if (wallet && needImport("WalletProvider")) importsToAdd += importWallet;
+    if (escrow && needImport("EscrowProvider")) importsToAdd += importEscrow;
+
+    if (importsToAdd) {
+      const importStmtRegex = /^import.*;\s*$/gm;
+      let last = null;
+      for (const m of content.matchAll(importStmtRegex)) last = m;
+      if (last) {
+        const idx = last.index + last[0].length;
+        content =
+          content.slice(0, idx) +
+          "\n" +
+          importsToAdd +
+          commentText +
+          content.slice(idx);
+      } else {
+        content = importsToAdd + commentText + content;
+      }
+    }
+
+    const hasTag = (tag) => new RegExp(`<${tag}[\\s>]`).test(content);
+    const wrapInside = (containerTag, newTag) => {
+      const open = content.match(new RegExp(`<${containerTag}(\\s[^>]*)?>`));
+      if (!open) return false;
+      const openIdx = open.index + open[0].length;
+      const closeIdx = content.indexOf(`</${containerTag}>`, openIdx);
+      if (closeIdx === -1) return false;
+      content =
+        content.slice(0, openIdx) +
+        `\n<${newTag}>\n` +
+        content.slice(openIdx, closeIdx) +
+        `\n</${newTag}>\n` +
+        content.slice(closeIdx);
+      return true;
+    };
+
+    const ensureTag = (tag) => {
+      if (hasTag(tag)) return;
+      const bodyOpen = content.match(/<body[^>]*>/);
+      const bodyCloseIdx = content.lastIndexOf("</body>");
+      if (!bodyOpen || bodyCloseIdx === -1) return;
+      const bodyOpenIdx = bodyOpen.index + bodyOpen[0].length;
+      if (tag === "TrustlessWorkProvider") {
+        if (wrapInside("ReactQueryClientProvider", tag)) return;
+      }
+      if (tag === "WalletProvider") {
+        if (wrapInside("TrustlessWorkProvider", tag)) return;
+        if (wrapInside("ReactQueryClientProvider", tag)) return;
+      }
+      if (tag === "EscrowProvider") {
+        if (wrapInside("WalletProvider", tag)) return;
+        if (wrapInside("TrustlessWorkProvider", tag)) return;
+        if (wrapInside("ReactQueryClientProvider", tag)) return;
+      }
+      content =
+        content.slice(0, bodyOpenIdx) +
+        `\n<${tag}>\n` +
+        content.slice(bodyOpenIdx, bodyCloseIdx) +
+        `\n</${tag}>\n` +
+        content.slice(bodyCloseIdx);
+    };
+
+    if (reactQuery) ensureTag("ReactQueryClientProvider");
+    if (trustless) ensureTag("TrustlessWorkProvider");
+    if (wallet) ensureTag("WalletProvider");
+    if (escrow) ensureTag("EscrowProvider");
+
+    fs.writeFileSync(layoutPath, content, "utf8");
+    logCheck(
+      `Updated ${path.relative(PROJECT_ROOT, layoutPath)} with providers`
+    );
+  } catch (e) {
+    console.error("❌ Failed to update layout with providers:", e.message);
+  }
+}
+
+if (args[0] === "init") {
+  console.log("\n▶ Setting up shadcn/ui components...");
+  const doInit = await promptYesNo("Run shadcn init now?", true);
+  if (doInit) {
+    run("npx", ["shadcn@latest", "init"]);
+  } else {
+    console.log("\x1b[90m– Skipped shadcn init\x1b[0m");
+  }
+
+  const addShadcn = await promptYesNo(
+    "Add shadcn components (button, input, form, card, sonner, checkbox, dialog, textarea, sonner, select, table, calendar, popover, separator, calendar-05, badge, sheet, tabs, avatar)?",
+    true
+  );
+  if (addShadcn) {
+    await withSpinner("Installing shadcn/ui components", async () => {
+      await runAsync("npx", [
+        "shadcn@latest",
+        "add",
+        "button",
+        "input",
+        "form",
+        "card",
+        "sonner",
+        "checkbox",
+        "dialog",
+        "textarea",
+        "sonner",
+        "select",
+        "table",
+        "calendar",
+        "popover",
+        "separator",
+        "calendar-05",
+        "badge",
+        "sheet",
+        "tabs",
+        "avatar",
+      ]);
+    });
+  } else {
+    console.log("\x1b[90m– Skipped adding shadcn components\x1b[0m");
+  }
+
+  if (!fs.existsSync(GLOBAL_DEPS_FILE)) {
+    console.error("❌ deps.json not found in templates/");
+    process.exit(1);
+  }
+  const meta = JSON.parse(fs.readFileSync(GLOBAL_DEPS_FILE, "utf8"));
+  const installLibs = await promptYesNo(
+    "Install (react-hook-form, @tanstack/react-query, @tanstack/react-query-devtools, @trustless-work/escrow, @hookform/resolvers, axios, @creit.tech/stellar-wallets-kit, react-day-picker & zod) dependencies now?",
+    true
+  );
+  if (installLibs) {
+    await withSpinner("Installing required dependencies", async () => {
+      installDeps(meta);
+    });
+  } else {
+    console.log("\x1b[90m– Skipped installing required dependencies\x1b[0m");
+  }
+  const cfgPath = path.join(PROJECT_ROOT, ".twblocks.json");
+  if (!fs.existsSync(cfgPath)) {
+    fs.writeFileSync(
+      cfgPath,
+      JSON.stringify({ uiBase: "@/components/ui" }, null, 2)
+    );
+    console.log(
+      `\x1b[32m✔\x1b[0m Created ${path.relative(
+        PROJECT_ROOT,
+        cfgPath
+      )} with default uiBase`
+    );
+  }
+  console.log("\x1b[32m✔\x1b[0m shadcn/ui components step completed");
+
+  const wantProviders = await promptYesNo(
+    "Install TanStack Query and Trustless Work providers and wrap app/layout with them?",
+    true
+  );
+  if (wantProviders) {
+    await withSpinner("Installing providers", async () => {
+      copyTemplate("providers");
+    });
+    const layoutPath = findLayoutFile();
+    if (layoutPath) {
+      await withSpinner("Updating app/layout with providers", async () => {
+        injectProvidersIntoLayout(layoutPath, {
+          reactQuery: true,
+          trustless: true,
+        });
+      });
+    } else {
+      console.warn(
+        "⚠️  Could not find app/layout file. Skipped automatic wiring."
+      );
+    }
+  } else {
+    console.log("\x1b[90m– Skipped installing providers\x1b[0m");
+  }
+
+  printBannerTRUSTLESSWORK();
+  console.log("\n\nResources");
+  console.log("- " + oscHyperlink("Website", "https://trustlesswork.com"));
+  console.log(
+    "- " + oscHyperlink("Documentation", "https://docs.trustlesswork.com")
+  );
+  console.log("- " + oscHyperlink("Demo", "https://demo.trustlesswork.com"));
+  console.log(
+    "- " + oscHyperlink("Backoffice", "https://dapp.trustlesswork.com")
+  );
+  console.log(
+    "- " + oscHyperlink("GitHub", "https://github.com/trustless-work")
+  );
+  console.log(
+    "- " + oscHyperlink("Escrow Viewer", "https://viewer.trustlesswork.com")
+  );
+  console.log(
+    "- " + oscHyperlink("Telegram", "https://t.me/+kmr8tGegxLU0NTA5")
+  );
+  console.log(
+    "- " +
+      oscHyperlink(
+        "LinkedIn",
+        "https://www.linkedin.com/company/trustlesswork/posts/?feedView=all"
+      )
+  );
+  console.log("- " + oscHyperlink("X", "https://x.com/TrustlessWork"));
+} else if (args[0] === "add" && args[1]) {
+  const flags = parseFlags(args.slice(2));
+  const cfgPath = path.join(PROJECT_ROOT, ".twblocks.json");
+  if (!fs.existsSync(cfgPath)) {
+    console.error(
+      "❌ Missing initial setup. Run 'trustless-work init' first to install dependencies and create .twblocks.json (uiBase)."
+    );
+    console.error(
+      "   After init, re-run: trustless-work add " +
+        args[1] +
+        (flags.uiBase ? ' --ui-base "' + flags.uiBase + '"' : "")
+    );
+    process.exit(1);
+  }
+  copyTemplate(args[1], {
+    uiBase: flags.uiBase,
+    shouldInstall: !!flags.install,
+  });
+
+  // Post-add wiring for specific templates
+  const layoutPath = findLayoutFile();
+  if (layoutPath) {
+    if (args[1] === "wallet-kit" || args[1].startsWith("wallet-kit/")) {
+      injectProvidersIntoLayout(layoutPath, { wallet: true });
+    }
+    if (
+      args[1] === "escrows/escrow-context" ||
+      args[1].startsWith("escrows/escrow-context/")
+    ) {
+      injectProvidersIntoLayout(layoutPath, { escrow: true });
+    }
+  }
+
+  // Copy shared details into role/signer targets when applicable
+  try {
+    if (args[1] === "escrows") {
+      copySharedDetailsInto("escrows/escrows-by-role/details", {
+        uiBase: flags.uiBase,
+      });
+      copySharedDetailsInto("escrows/escrows-by-signer/details", {
+        uiBase: flags.uiBase,
+      });
+      copySharedRoleSignerHooks();
+    }
+    if (
+      args[1] === "escrows/escrows-by-role" ||
+      args[1].startsWith("escrows/escrows-by-role/")
+    ) {
+      copySharedDetailsInto("escrows/escrows-by-role/details", {
+        uiBase: flags.uiBase,
+      });
+      copySharedRoleSignerHooks();
+    }
+    if (
+      args[1] === "escrows/escrows-by-signer" ||
+      args[1].startsWith("escrows/escrows-by-signer/")
+    ) {
+      copySharedDetailsInto("escrows/escrows-by-signer/details", {
+        uiBase: flags.uiBase,
+      });
+      copySharedRoleSignerHooks();
+    }
+  } catch (e) {
+    console.warn("⚠️  Failed to copy shared details:", e?.message || e);
+  }
+} else {
+  console.log(`
+  
+  Usage:
+
+  trustless-work init
+  trustless-work add <template> [--install]
+  
+  Options:
+
+  --ui-base <path>      Base import path to your shadcn/ui components (default: "@/components/ui")
+  --install, -i         Also install dependencies (normally use 'init' once instead)
+
+  Examples:
+
+  --- Get started ---
+  trustless-work init
+
+  --- Providers ---
+  trustless-work add providers
+
+  --- Wallet-kit ---
+  trustless-work add wallet-kit
+
+  --- Handle-errors ---
+  trustless-work add handle-errors
+
+  --- Tanstack ---
+  trustless-work add tanstak
+
+  --- Escrows ---
+  trustless-work add escrows
+
+  --- Escrow context ---
+  trustless-work add escrows/escrow-context
+
+  --- Escrows by role ---
+  trustless-work add escrows/escrows-by-role
+  trustless-work add escrows/escrows-by-role/table
+  trustless-work add escrows/escrows-by-role/cards
+
+  --- Escrows by signer ---
+  trustless-work add escrows/escrows-by-signer
+  trustless-work add escrows/escrows-by-signer/table
+  trustless-work add escrows/escrows-by-signer/cards
+
+  ----------------------
+  --- SINGLE-RELEASE ---
+  trustless-work add escrows/single-release
+
+  --- Initialize escrow ---
+  - trustless-work add escrows/single-release/initialize-escrow
+
+  --- Fund escrow ---
+  - trustless-work add escrows/single-release/fund-escrow
+  - trustless-work add escrows/single-release/fund-escrow/form
+  - trustless-work add escrows/single-release/fund-escrow/button
+  - trustless-work add escrows/single-release/fund-escrow/dialog
+
+  ---------------------
+  --- MULTI-RELEASE ---
+  trustless-work add escrows/multi-release
+  
+   --- Initialize escrow ---
+  - trustless-work add escrows/multi-release/initialize-escrow
+
+  --- Fund escrow ---
+  - trustless-work add escrows/multi-release/fund-escrow
+  - trustless-work add escrows/multi-release/fund-escrow/form
+  - trustless-work add escrows/multi-release/fund-escrow/button
+  - trustless-work add escrows/multi-release/fund-escrow/dialog
+`);
+}