@barefootjs/cli 0.3.0 → 0.4.0

package/dist/docs/core/adapters/hono-adapter.md

@@ -197,3 +197,24 @@ Ternaries with element branches use `bf-c` markers. Text-only ternaries use comm
 ```
 
 Loop markers (`<!--bf-loop-->...<!--bf-/loop-->`) are used for reconciliation. For child components in loops, the adapter generates unique instance IDs per iteration using the loop index or `key`.
+
+## Deploying to Cloudflare Workers
+
+`bf build` writes browser-served files (`barefoot.js`, `*.client.js`, vendor chunks) and server/build-only files (the SSR `.tsx` templates, `manifest.json`, `barefoot-externals.json`, `.bfemit.json`, `.buildcache.json`, `.dev/`) into the same `outDir`. With Workers Assets, `assets.directory` serves that whole directory, so a naive `wrangler deploy` would upload the server-only files too — shipping the SSR template source and build internals as publicly fetchable assets.
+
+To prevent this, `bf build` maintains a [`.assetsignore`](https://developers.cloudflare.com/workers/static-assets/#ignoring-assets) in `outDir` whenever the project targets Workers (detected by a `wrangler.toml` / `wrangler.json` / `wrangler.jsonc` next to `barefoot.config.ts`). The server/build-only outputs are listed in a managed block that's regenerated on every build:
+
+```
+# >>> barefoot managed block (generated by `bf build`) >>>
+# Server/build-only barefoot outputs — not browser-served. Regenerated on
+# every `bf build`; add your own entries outside this block.
+.bfemit.json
+.buildcache.json
+.dev/
+barefoot-externals.json
+components/Counter.tsx
+components/manifest.json
+# <<< barefoot managed block <<<
+```
+
+Anything you add outside the managed markers is preserved across rebuilds. The browser-served outputs (`barefoot.js`, `*.client.js`, vendor chunks) are intentionally left out so they still deploy.

package/dist/index.js

@@ -1885,6 +1885,9 @@ function irToComponentTemplateWithOpts(node, opts) {
       }
       return `\${${transformExpr(node.expr, node.templateExpr)}}`;
     case "conditional": {
+      if (node.clientOnly && node.slotId) {
+        return `<!--bf-cond-start:${node.slotId}--><!--bf-cond-end:${node.slotId}-->`;
+      }
       const trueBranch = recurse(node.whenTrue);
       const falseBranch = recurse(node.whenFalse);
       const trueHtml = node.slotId ? addCondAttrToTemplate(trueBranch, node.slotId) : trueBranch;
@@ -2103,6 +2106,9 @@ function generateCsrTemplateWithOpts(node, opts) {
         return `\${${expr}}`;
       }
     case "conditional": {
+      if (node.clientOnly && node.slotId) {
+        return `<!--bf-cond-start:${node.slotId}--><!--bf-cond-end:${node.slotId}-->`;
+      }
       const trueBranch = recurse(node.whenTrue);
       const falseBranch = recurse(node.whenFalse);
       const trueHtml = node.slotId ? addCondAttrToTemplate(trueBranch, node.slotId) : trueBranch;
@@ -8221,11 +8227,11 @@ function transformMapCall(node, ctx2, isClientOnly = false, method = "map") {
           if (stmt === returnStmt) break;
           const js = ctx2.getJS(stmt);
           const tjs = ctx2.getTemplateJS(stmt);
-          const ts19 = stmt.getText(ctx2.sourceFile);
+          const ts20 = stmt.getText(ctx2.sourceFile);
           preambleStmts.push(js.endsWith(";") ? js : js + ";");
           templatePreambleStmts.push(tjs.endsWith(";") ? tjs : tjs + ";");
-          typedPreambleStmts.push(ts19.endsWith(";") ? ts19 : ts19 + ";");
-          if (js !== ts19) hasTypeDiff = true;
+          typedPreambleStmts.push(ts20.endsWith(";") ? ts20 : ts20 + ";");
+          if (js !== ts20) hasTypeDiff = true;
           if (js !== tjs) hasTemplateDiff = true;
         }
         if (preambleStmts.length > 0) {
@@ -9033,10 +9039,10 @@ function hasDynamicContent(children) {
 function inferExpressionType(_node, _ctx) {
   return null;
 }
-function replaceBranchLocalRefs(text, branchNames, resolve10) {
+function replaceBranchLocalRefs(text, branchNames, resolve11) {
   if (branchNames.length === 0) return text;
   const pattern = new RegExp(`(?<![\\w$])(${branchNames.join("|")})(?![\\w$])`, "g");
-  return replaceInExprContexts(text, pattern, (_match, name) => resolve10(name));
+  return replaceInExprContexts(text, pattern, (_match, name) => resolve11(name));
 }
 function buildIfStatementChain(analyzer, ctx2) {
   const conditionalReturns = analyzer.conditionalReturns;
@@ -17503,7 +17509,7 @@ function buildLocalFunctionSetterMap(meta, setterToSignal) {
     }
     directCalls.set(name, calls);
   }
-  const resolve10 = (name, stack) => {
+  const resolve11 = (name, stack) => {
     const out = [];
     const seen = /* @__PURE__ */ new Set();
     for (const setter of directSetters.get(name) ?? []) {
@@ -17514,7 +17520,7 @@ function buildLocalFunctionSetterMap(meta, setterToSignal) {
     }
     for (const callee of directCalls.get(name) ?? []) {
       if (stack.has(callee)) continue;
-      const sub2 = resolve10(callee, /* @__PURE__ */ new Set([...stack, callee]));
+      const sub2 = resolve11(callee, /* @__PURE__ */ new Set([...stack, callee]));
       for (const r of sub2) {
         if (!seen.has(r.setter)) {
           out.push({ setter: r.setter, chain: [callee, ...r.chain] });
@@ -17526,7 +17532,7 @@ function buildLocalFunctionSetterMap(meta, setterToSignal) {
   };
   const result = /* @__PURE__ */ new Map();
   for (const name of bodies.keys()) {
-    const resolved = resolve10(name, /* @__PURE__ */ new Set([name]));
+    const resolved = resolve11(name, /* @__PURE__ */ new Set([name]));
     if (resolved.length > 0) result.set(name, resolved);
   }
   return result;
@@ -19461,9 +19467,78 @@ var init_emit_ledger = __esm({
   }
 });
 
+// src/lib/assets-ignore.ts
+import { resolve as resolve5 } from "node:path";
+async function isCloudflareWorkersProject(projectDir) {
+  for (const name of WRANGLER_CONFIG_NAMES) {
+    if (await fileExists(resolve5(projectDir, name))) return true;
+  }
+  return false;
+}
+function collectServerOnlyAssets(input) {
+  const entries = /* @__PURE__ */ new Set();
+  entries.add(`${input.devSentinelSubdir}/`);
+  entries.add(EMIT_LEDGER_FILENAME);
+  entries.add(CACHE_FILENAME);
+  if (input.hasExternals) entries.add("barefoot-externals.json");
+  if (!input.clientOnly) {
+    entries.add(`${input.templatesSubdir}/manifest.json`);
+    for (const row of Object.values(input.manifest)) {
+      if (row.markedTemplate) entries.add(row.markedTemplate);
+    }
+  }
+  return [...entries].sort();
+}
+function stripManagedBlock(content) {
+  const lines = content.split("\n");
+  const begin = lines.indexOf(BLOCK_BEGIN);
+  const end = lines.indexOf(BLOCK_END);
+  if (begin !== -1 && end !== -1 && end > begin) {
+    const kept = [...lines.slice(0, begin), ...lines.slice(end + 1)];
+    return kept.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+  }
+  return content.trim();
+}
+function buildManagedBlock(entries) {
+  return [
+    BLOCK_BEGIN,
+    "# Server/build-only barefoot outputs \u2014 not browser-served. Regenerated on",
+    "# every `bf build`; add your own entries outside this block.",
+    ...entries,
+    BLOCK_END
+  ].join("\n");
+}
+async function writeAssetsIgnore(outDir, entries) {
+  const path23 = resolve5(outDir, ASSETS_IGNORE_FILENAME);
+  const existing = await fileExists(path23) ? await readText(path23) : "";
+  const userContent = stripManagedBlock(existing);
+  const block = buildManagedBlock(entries);
+  const merged = userContent.length > 0 ? `${userContent}
+
+${block}
+` : `${block}
+`;
+  return writeIfChanged(path23, merged);
+}
+var ASSETS_IGNORE_FILENAME, BLOCK_BEGIN, BLOCK_END, WRANGLER_CONFIG_NAMES;
+var init_assets_ignore = __esm({
+  "src/lib/assets-ignore.ts"() {
+    "use strict";
+    init_runtime();
+    init_fs_utils();
+    init_build_cache();
+    init_emit_ledger();
+    ASSETS_IGNORE_FILENAME = ".assetsignore";
+    BLOCK_BEGIN = "# >>> barefoot managed block (generated by `bf build`) >>>";
+    BLOCK_END = "# <<< barefoot managed block <<<";
+    WRANGLER_CONFIG_NAMES = ["wrangler.toml", "wrangler.json", "wrangler.jsonc"];
+  }
+});
+
 // src/lib/build.ts
+import ts19 from "typescript";
 import { mkdir, readdir, stat, unlink } from "node:fs/promises";
-import { resolve as resolve5, basename, relative as relative2, dirname as dirname3, isAbsolute as isAbsolute2 } from "node:path";
+import { resolve as resolve6, basename, relative as relative2, dirname as dirname3, isAbsolute as isAbsolute2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { build as esbuildBuild } from "esbuild";
 function detectMissingUseClient(content) {
@@ -19503,7 +19578,7 @@ async function discoverComponentFiles(dir, options) {
     return results;
   }
   for (const entry of entries) {
-    const fullPath = resolve5(dir, String(entry.name));
+    const fullPath = resolve6(dir, String(entry.name));
     if (entry.isDirectory()) {
       if (skipDirs?.has(String(entry.name))) continue;
       results.push(...await discoverComponentFiles(fullPath, options));
@@ -19518,9 +19593,9 @@ function generateHash(content) {
 }
 function resolveBuildConfigFromTs(projectDir, tsConfig, overrides) {
   const componentDirs = (tsConfig.components ?? ["components"]).map(
-    (dir) => resolve5(projectDir, dir)
+    (dir) => resolve6(projectDir, dir)
   );
-  const outDir = resolve5(projectDir, tsConfig.outDir ?? "dist");
+  const outDir = resolve6(projectDir, tsConfig.outDir ?? "dist");
   return {
     projectDir,
     adapter: tsConfig.adapter,
@@ -19535,7 +19610,7 @@ function resolveBuildConfigFromTs(projectDir, tsConfig, overrides) {
     externals: tsConfig.externals,
     externalsBasePath: tsConfig.externalsBasePath,
     bundleEntries: tsConfig.bundleEntries?.map((e) => ({
-      entry: resolve5(projectDir, e.entry),
+      entry: resolve6(projectDir, e.entry),
       outfile: e.outfile,
       externals: e.externals
     })),
@@ -19545,9 +19620,9 @@ function resolveBuildConfigFromTs(projectDir, tsConfig, overrides) {
 async function findCliPackageJson() {
   const here = dirname3(fileURLToPath2(import.meta.url));
   const candidates = [
-    resolve5(here, "../package.json"),
+    resolve6(here, "../package.json"),
     // bundled dist/index.js
-    resolve5(here, "../../package.json")
+    resolve6(here, "../../package.json")
     // source src/lib/build.ts
   ];
   for (const cand of candidates) {
@@ -19559,7 +19634,7 @@ async function findNearestLockfile(projectDir) {
   let dir = projectDir;
   while (true) {
     for (const name of LOCKFILE_NAMES) {
-      const candidate = resolve5(dir, name);
+      const candidate = resolve6(dir, name);
       if (await fileExists(candidate)) return candidate;
     }
     const parent = dirname3(dir);
@@ -19580,9 +19655,9 @@ async function computeGlobalHash(config) {
     parts.push(await readText(cliPkgPath));
   }
   const configCandidates = [
-    resolve5(config.projectDir, "barefoot.config.ts"),
-    resolve5(config.projectDir, "barefoot.config.js"),
-    resolve5(config.projectDir, "barefoot.config.mjs")
+    resolve6(config.projectDir, "barefoot.config.ts"),
+    resolve6(config.projectDir, "barefoot.config.js"),
+    resolve6(config.projectDir, "barefoot.config.mjs")
   ];
   for (const cand of configCandidates) {
     if (await fileExists(cand)) {
@@ -19603,9 +19678,9 @@ async function build(config, options = {}) {
   const templatesSubdir = layout?.templates ?? "components";
   const clientJsSubdir = layout?.clientJs ?? "components";
   const runtimeSubdir = layout?.runtime ?? clientJsSubdir;
-  const templatesOutDir = resolve5(config.outDir, templatesSubdir);
-  const clientJsOutDir = resolve5(config.outDir, clientJsSubdir);
-  const runtimeOutDir = resolve5(config.outDir, runtimeSubdir);
+  const templatesOutDir = resolve6(config.outDir, templatesSubdir);
+  const clientJsOutDir = resolve6(config.outDir, clientJsSubdir);
+  const runtimeOutDir = resolve6(config.outDir, runtimeSubdir);
   await Promise.all([
     mkdir(templatesOutDir, { recursive: true }),
     mkdir(clientJsOutDir, { recursive: true }),
@@ -19619,14 +19694,14 @@ async function build(config, options = {}) {
   let anyOutputChanged = false;
   const loadedLedger = await loadEmitLedger(config.outDir, config.projectDir);
   const previousEmitEntries = loadedLedger?.entries ?? extractLedgerFromCache(onDiskCache);
-  const domPkgDir = resolve5(config.projectDir, "node_modules/@barefootjs/client");
+  const domPkgDir = resolve6(config.projectDir, "node_modules/@barefootjs/client");
   const domDistCandidates = [
-    resolve5(config.projectDir, "../../packages/client/dist/runtime/standalone.js"),
-    resolve5(domPkgDir, "dist/runtime/standalone.js"),
+    resolve6(config.projectDir, "../../packages/client/dist/runtime/standalone.js"),
+    resolve6(domPkgDir, "dist/runtime/standalone.js"),
     // Legacy fallback for older @barefootjs/client dists that only shipped
     // the single runtime entry.
-    resolve5(config.projectDir, "../../packages/client/dist/runtime/index.js"),
-    resolve5(domPkgDir, "dist/runtime/index.js")
+    resolve6(config.projectDir, "../../packages/client/dist/runtime/index.js"),
+    resolve6(domPkgDir, "dist/runtime/index.js")
   ];
   let domDistFile = null;
   for (const candidate of domDistCandidates) {
@@ -19638,7 +19713,7 @@ async function build(config, options = {}) {
     }
   }
   if (domDistFile) {
-    const runtimeOutPath = resolve5(runtimeOutDir, "barefoot.js");
+    const runtimeOutPath = resolve6(runtimeOutDir, "barefoot.js");
     let runtimeContent;
     if (config.minify) {
       runtimeContent = transpile(await readText(domDistFile), { loader: "js", minify: true });
@@ -19811,9 +19886,9 @@ async function build(config, options = {}) {
       if (!currentEmitSet.has(output)) orphanedOutputs.add(output);
     }
   }
-  const outDirAbs = resolve5(config.outDir);
+  const outDirAbs = resolve6(config.outDir);
   for (const output of orphanedOutputs) {
-    const abs = resolve5(config.outDir, output);
+    const abs = resolve6(config.outDir, output);
     const rel = relative2(outDirAbs, abs);
     const escapes = rel === "" || rel === "." || rel.startsWith("..") || isAbsolute2(rel);
     if (escapes) {
@@ -19841,7 +19916,7 @@ async function build(config, options = {}) {
     if (!entry.clientJs) continue;
     let raw = compiledClientJsByKey.get(name);
     if (!raw) {
-      const filePath = resolve5(config.outDir, entry.clientJs);
+      const filePath = resolve6(config.outDir, entry.clientJs);
       try {
         raw = await readText(filePath);
       } catch {
@@ -19856,7 +19931,7 @@ async function build(config, options = {}) {
     for (const [name, content] of combined) {
       const entry = manifest[name];
       if (!entry?.clientJs) continue;
-      const filePath = resolve5(config.outDir, entry.clientJs);
+      const filePath = resolve6(config.outDir, entry.clientJs);
       if (await writeIfChanged(filePath, content)) {
         anyOutputChanged = true;
         console.log(`Combined: ${entry.clientJs}`);
@@ -19909,10 +19984,10 @@ async function build(config, options = {}) {
     }
   }
   {
-    const runtimeAbs = resolve5(config.outDir, runtimeSubdir, "barefoot.js");
+    const runtimeAbs = resolve6(config.outDir, runtimeSubdir, "barefoot.js");
     for (const [name, entry] of Object.entries(manifest)) {
       if (!entry.clientJs || name === "__barefoot__") continue;
-      const filePath = resolve5(config.outDir, entry.clientJs);
+      const filePath = resolve6(config.outDir, entry.clientJs);
       let rel = relative2(dirname3(filePath), runtimeAbs);
       if (!rel.startsWith(".")) rel = "./" + rel;
       try {
@@ -19935,7 +20010,7 @@ async function build(config, options = {}) {
   if (config.minify) {
     for (const [name, entry] of Object.entries(manifest)) {
       if (!entry.clientJs || name === "__barefoot__") continue;
-      const filePath = resolve5(config.outDir, entry.clientJs);
+      const filePath = resolve6(config.outDir, entry.clientJs);
       try {
         const content = await readText(filePath);
         if (content) {
@@ -19960,8 +20035,8 @@ async function build(config, options = {}) {
     });
   }
   if (!config.clientOnly) {
-    const manifestDir = resolve5(config.outDir, templatesSubdir);
-    const manifestPath = resolve5(manifestDir, "manifest.json");
+    const manifestDir = resolve6(config.outDir, templatesSubdir);
+    const manifestPath = resolve6(manifestDir, "manifest.json");
     const manifestContent = JSON.stringify(manifest, null, 2);
     if (await writeIfChanged(manifestPath, manifestContent)) {
       anyOutputChanged = true;
@@ -19989,6 +20064,18 @@ async function build(config, options = {}) {
     saveCache(config.outDir, nextCache),
     saveEmitLedger(config.outDir, config.projectDir, nextLedger)
   ]);
+  if (await isCloudflareWorkersProject(config.projectDir)) {
+    const ignored = collectServerOnlyAssets({
+      devSentinelSubdir: DEV_SENTINEL_SUBDIR,
+      templatesSubdir,
+      manifest,
+      hasExternals: !!config.externals && Object.keys(config.externals).length > 0,
+      clientOnly: config.clientOnly
+    });
+    if (await writeAssetsIgnore(config.outDir, ignored)) {
+      console.log(`Generated: ${ASSETS_IGNORE_FILENAME}`);
+    }
+  }
   return {
     compiledCount,
     skippedCount,
@@ -19999,6 +20086,28 @@ async function build(config, options = {}) {
     sharedProgram
   };
 }
+function extractBareImports(code) {
+  const { importedFiles } = ts19.preProcessFile(code, true, true);
+  const specifiers = /* @__PURE__ */ new Set();
+  for (const { fileName } of importedFiles) {
+    if (!fileName.startsWith(".") && !fileName.startsWith("/") && !fileName.includes("://")) {
+      specifiers.add(fileName);
+    }
+  }
+  return [...specifiers];
+}
+function unresolvedBareImports(code, externals) {
+  const keys = /* @__PURE__ */ new Set([...Object.keys(externals), ...BF_CLIENT_DEDUP_KEYS]);
+  const isResolved = (spec) => keys.has(spec) || [...keys].some((k) => k.endsWith("/") && spec.startsWith(k));
+  return extractBareImports(code).filter((spec) => !isResolved(spec));
+}
+function rebundleExternalsFor(pkgName, externals) {
+  return [.../* @__PURE__ */ new Set([
+    ...Object.keys(externals).filter((k) => k !== pkgName),
+    ...BF_CLIENT_DEDUP_KEYS,
+    "@barefootjs/client/*"
+  ])];
+}
 function vendorChunkFilename(pkgName) {
   const base = pkgName.includes("/") ? pkgName.split("/").pop() : pkgName;
   return `${base}.js`;
@@ -20007,7 +20116,7 @@ function effectiveNamesFor(entryPath, componentDirs) {
   const bn = basename(entryPath);
   if (componentDirs && componentDirs.length > 0) {
     for (const dir of componentDirs) {
-      const root = resolve5(dir);
+      const root = resolve6(dir);
       if (entryPath !== root && entryPath.startsWith(root + "/")) {
         const rel = entryPath.slice(root.length + 1);
         const noExt2 = rel.replace(/\.[^.]+$/, "");
@@ -20021,14 +20130,14 @@ function effectiveNamesFor(entryPath, componentDirs) {
 function buildRelativeImportRewriter(sourcePath, outputPath, componentDirs, templatesOutDir) {
   const sourceDir = dirname3(sourcePath);
   const outputDir = dirname3(outputPath);
-  const resolvedComponentDirs = componentDirs.map((d) => resolve5(d));
+  const resolvedComponentDirs = componentDirs.map((d) => resolve6(d));
   return (importPath) => {
-    const srcAbs = resolve5(sourceDir, importPath);
+    const srcAbs = resolve6(sourceDir, importPath);
     let targetAbs = srcAbs;
     for (const componentDir of resolvedComponentDirs) {
       if (srcAbs === componentDir || srcAbs.startsWith(componentDir + "/")) {
         const relUnderComponentDir = srcAbs.slice(componentDir.length + 1);
-        targetAbs = relUnderComponentDir ? resolve5(templatesOutDir, relUnderComponentDir) : templatesOutDir;
+        targetAbs = relUnderComponentDir ? resolve6(templatesOutDir, relUnderComponentDir) : templatesOutDir;
         break;
       }
     }
@@ -20081,7 +20190,7 @@ function mergeDuplicateNamedImports(content) {
   return out.join("\n");
 }
 async function resolvePkgBrowserEntry(pkgDir) {
-  const pkgJsonPath = resolve5(pkgDir, "package.json");
+  const pkgJsonPath = resolve6(pkgDir, "package.json");
   if (!await fileExists(pkgJsonPath)) return null;
   const pkg = JSON.parse(await readText(pkgJsonPath));
   const browserCandidates = [
@@ -20090,7 +20199,7 @@ async function resolvePkgBrowserEntry(pkgDir) {
     pkg.jsdelivr
   ].filter((v) => typeof v === "string");
   for (const rel of browserCandidates) {
-    const abs = resolve5(pkgDir, rel);
+    const abs = resolve6(pkgDir, rel);
     if (await fileExists(abs)) return { path: abs, isBrowserReady: true };
   }
   const fallbackCandidates = [
@@ -20098,7 +20207,7 @@ async function resolvePkgBrowserEntry(pkgDir) {
     pkg.main
   ].filter((v) => typeof v === "string");
   for (const rel of fallbackCandidates) {
-    const abs = resolve5(pkgDir, rel);
+    const abs = resolve6(pkgDir, rel);
     if (await fileExists(abs)) return { path: abs, isBrowserReady: false };
   }
   return null;
@@ -20121,35 +20230,41 @@ async function processExternals(config, runtimeSubdir, runtimeOutDir) {
       continue;
     }
     if (isChunk) {
-      const pkgDir = resolve5(config.projectDir, "node_modules", pkgName);
+      const pkgDir = resolve6(config.projectDir, "node_modules", pkgName);
       const entry = await resolvePkgBrowserEntry(pkgDir);
       if (!entry) {
         console.warn(`Warning: externals \u2014 could not resolve browser entry for "${pkgName}". Skipping.`);
         continue;
       }
       const wantRebundle = typeof spec === "object" && !("url" in spec) && spec.rebundle === true;
-      if (!entry.isBrowserReady && !wantRebundle) {
-        console.warn(
-          `Warning: externals \u2014 "${pkgName}" resolved via import/main entry (no umd/unpkg/jsdelivr found). The copied file may contain external imports that are not browser-ready. Set rebundle: true to re-bundle it into a self-contained ESM file.`
-        );
-      }
       const srcFile = entry.path;
       const filename = vendorChunkFilename(pkgName);
-      const destPath = resolve5(runtimeOutDir, filename);
+      const destPath = resolve6(runtimeOutDir, filename);
       if (wantRebundle) {
         await esbuildBuild({
           entryPoints: [srcFile],
           outfile: destPath,
           format: "esm",
           bundle: true,
-          minify: config.minify ?? false
+          minify: config.minify ?? false,
+          external: rebundleExternalsFor(pkgName, config.externals)
         });
         anyChanged = true;
         console.log(`Generated (bundled): ${runtimeSubdir}/${filename}`);
       } else {
-        let content = await readBytes(srcFile);
+        const bytes = await readBytes(srcFile);
+        const text = new TextDecoder().decode(bytes);
+        if (!entry.isBrowserReady) {
+          const unresolved = unresolvedBareImports(text, config.externals);
+          if (unresolved.length > 0) {
+            console.warn(
+              `Warning: externals \u2014 "${pkgName}" resolved via import/main entry (no umd/unpkg/jsdelivr found) and imports packages not in the importmap: ${unresolved.join(", ")}. These are not browser-ready. Set rebundle: true to re-bundle it into a self-contained ESM file.`
+            );
+          }
+        }
+        let content = bytes;
         if (config.minify) {
-          content = transpile(content instanceof Uint8Array ? new TextDecoder().decode(content) : content, { loader: "js", minify: true });
+          content = transpile(text, { loader: "js", minify: true });
         }
         if (await writeIfChanged(destPath, content)) {
           anyChanged = true;
@@ -20174,7 +20289,7 @@ async function processExternals(config, runtimeSubdir, runtimeOutDir) {
     preloads,
     externals: allExternals
   };
-  const manifestPath = resolve5(config.outDir, "barefoot-externals.json");
+  const manifestPath = resolve6(config.outDir, "barefoot-externals.json");
   if (await writeIfChanged(manifestPath, JSON.stringify(manifest, null, 2))) {
     anyChanged = true;
     console.log("Generated: barefoot-externals.json");
@@ -20186,8 +20301,8 @@ async function processBundleEntries(config, clientJsOutDir, clientJsSubdir, allE
   let anyChanged = false;
   for (const entry of config.bundleEntries) {
     const entryExternals = [...allExternals, ...entry.externals ?? []];
-    const outfilePath = resolve5(clientJsOutDir, entry.outfile);
-    const absEntry = resolve5(entry.entry);
+    const outfilePath = resolve6(clientJsOutDir, entry.outfile);
+    const absEntry = resolve6(entry.entry);
     const cacheKey = `${BUNDLE_KEY_PREFIX}${absEntry}`;
     const sourceContent = await readText(absEntry);
     const sourceHash = hashContent(sourceContent);
@@ -20227,7 +20342,7 @@ async function processBundleEntries(config, clientJsOutDir, clientJsSubdir, allE
     if (metafile) {
       for (const inputPath of Object.keys(metafile.inputs)) {
         if (externalsSet.has(inputPath)) continue;
-        const abs = resolve5(absWorkingDir, inputPath);
+        const abs = resolve6(absWorkingDir, inputPath);
         if (abs === absEntry) continue;
         if (abs.includes("/node_modules/")) continue;
         if (await fileExists(abs)) {
@@ -20252,7 +20367,7 @@ async function collectRelativeImportDeps(entryPath, sourceContent) {
   for (const match of sourceContent.matchAll(RELATIVE_IMPORT_SCAN_RE)) {
     const rel = match[1];
     if (!rel.startsWith(".")) continue;
-    const base = resolve5(baseDir, rel);
+    const base = resolve6(baseDir, rel);
     const candidates = [base, ...EXT_CANDIDATES.map((ext) => base + ext)];
     for (const cand of candidates) {
       if (seen.has(cand)) continue;
@@ -20286,7 +20401,7 @@ async function compileEntry(args2) {
   for (const depPath of await collectRelativeImportDeps(entryPath, sourceContent)) {
     deps[depPath] = hashContent(await readText(depPath));
   }
-  const presumedOutputPath = resolve5(
+  const presumedOutputPath = resolve6(
     templatesOutDir,
     baseFileName.replace(/\.tsx?$/, config.adapter.extension)
   );
@@ -20352,7 +20467,7 @@ async function compileEntry(args2) {
   if (hasClientJs) {
     const rel = `${clientJsSubdir}/${clientJsFilename}`;
     outputs.push(rel);
-    const target = resolve5(clientJsOutDir, clientJsFilename);
+    const target = resolve6(clientJsOutDir, clientJsFilename);
     await mkdir(dirname3(target), { recursive: true });
     if (await writeIfChanged(target, clientJsContent)) {
       wroteAny = true;
@@ -20369,7 +20484,7 @@ async function compileEntry(args2) {
       }
       const rel = `${templatesSubdir}/${outName}`;
       outputs.push(rel);
-      const target = resolve5(templatesOutDir, outName);
+      const target = resolve6(templatesOutDir, outName);
       await mkdir(dirname3(target), { recursive: true });
       if (await writeIfChanged(target, outputContent)) {
         wroteAny = true;
@@ -20414,9 +20529,9 @@ async function compileEntry(args2) {
 }
 async function writeBuildId(outDir, result) {
   if (!result.changed) return;
-  const devDir = resolve5(outDir, DEV_SENTINEL_SUBDIR);
+  const devDir = resolve6(outDir, DEV_SENTINEL_SUBDIR);
   await mkdir(devDir, { recursive: true });
-  const path23 = resolve5(devDir, DEV_SENTINEL_FILENAME);
+  const path23 = resolve6(devDir, DEV_SENTINEL_FILENAME);
   await writeIfChanged(path23, String(Date.now()));
 }
 async function watch(config, options = {}) {
@@ -20559,6 +20674,7 @@ var init_build = __esm({
     init_build_cache();
     init_emit_ledger();
     init_fs_utils();
+    init_assets_ignore();
     init_runtime();
     init_resolve_imports();
     BF001_TRIPWIRE_IMPORTS = /* @__PURE__ */ new Set([
@@ -23875,7 +23991,7 @@ async function select(args2) {
   output.write(`\x1B[33m?\x1B[0m \x1B[1m${args2.message}\x1B[0m
 `);
   render(true);
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     readline.emitKeypressEvents(input);
     input.setRawMode?.(true);
     input.resume();
@@ -23920,7 +24036,7 @@ async function select(args2) {
         output.write(`\x1B[${totalLines}A`);
         output.write(`\u2714 ${args2.message} \x1B[1;32m${shortLabel}\x1B[0m
 `);
-        resolve10(args2.options[cursor].value);
+        resolve11(args2.options[cursor].value);
         return;
       }
     };
@@ -24823,21 +24939,21 @@ var init_scaffold_layout = __esm({
 import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
 import { existsSync as existsSync12 } from "node:fs";
 import { execFileSync } from "node:child_process";
-import { resolve as resolve6, relative as relative3 } from "node:path";
+import { resolve as resolve7, relative as relative3 } from "node:path";
 import { build as build2 } from "esbuild";
 async function compile(options) {
   const { assets, previewsPath, previewNames, componentName, liveReload } = options;
   const { rootDir, srcComponentsDir, tokensCss, globalsCss, runtimeStandalone, uno } = assets;
-  const DIST_DIR = resolve6(rootDir, ".preview-dist");
-  const MODULES_DIR = resolve6(DIST_DIR, "_modules");
+  const DIST_DIR = resolve7(rootDir, ".preview-dist");
+  const MODULES_DIR = resolve7(DIST_DIR, "_modules");
   await mkdir2(MODULES_DIR, { recursive: true });
   console.log("Generating CSS...");
-  await writeFile2(resolve6(DIST_DIR, "globals.css"), tokensCss + "\n" + globalsCss);
+  await writeFile2(resolve7(DIST_DIR, "globals.css"), tokensCss + "\n" + globalsCss);
   console.log("Generated: .preview-dist/globals.css");
   console.log("Generating UnoCSS...");
   let unoConfigPath = uno.configPath;
   if (uno.configIsBundled) {
-    unoConfigPath = resolve6(DIST_DIR, "uno.config.ts");
+    unoConfigPath = resolve7(DIST_DIR, "uno.config.ts");
     await writeFile2(unoConfigPath, await readFile2(uno.configPath, "utf-8"));
   }
   execFileSync(uno.bin, [
@@ -24845,7 +24961,7 @@ async function compile(options) {
     "--config",
     unoConfigPath,
     "-o",
-    resolve6(DIST_DIR, "uno.css")
+    resolve7(DIST_DIR, "uno.css")
   ], { cwd: uno.cwd, stdio: "inherit" });
   console.log("Generated: .preview-dist/uno.css");
   const previewSource = await readFile2(previewsPath, "utf-8");
@@ -24855,7 +24971,7 @@ async function compile(options) {
   const componentFiles = resolveDependenciesFromSource(
     [componentName, ...previewSiblings],
     srcComponentsDir
-  ).map((name) => resolve6(srcComponentsDir, name, "index.tsx")).filter(existsSync12);
+  ).map((name) => resolve7(srcComponentsDir, name, "index.tsx")).filter(existsSync12);
   console.log(`Compiling ${componentFiles.length + 1} files...`);
   const allFiles = [...componentFiles, previewsPath];
   const adapter = new PreviewCsrAdapter();
@@ -24891,16 +25007,16 @@ async function compile(options) {
   const allModules = new Map([...clientJsByKey, ...combined]);
   for (const [key, content] of allModules) {
     const safeName = key.replace(/[/\\]/g, "__") + ".js";
-    await writeFile2(resolve6(MODULES_DIR, safeName), content);
+    await writeFile2(resolve7(MODULES_DIR, safeName), content);
   }
   const previewModuleFile = previewKey.replace(/[/\\]/g, "__") + ".js";
   const entrySource = generateEntryScript(previewModuleFile, previewNames);
-  const entryPath = resolve6(DIST_DIR, "_entry.js");
+  const entryPath = resolve7(DIST_DIR, "_entry.js");
   await writeFile2(entryPath, entrySource);
   console.log("Bundling for browser...");
   await build2({
     entryPoints: [entryPath],
-    outfile: resolve6(DIST_DIR, "_bundle.js"),
+    outfile: resolve7(DIST_DIR, "_bundle.js"),
     bundle: true,
     format: "esm",
     platform: "browser",
@@ -24911,7 +25027,7 @@ async function compile(options) {
     define: { "process.env.NODE_ENV": '"development"' }
   });
   console.log("Generated: .preview-dist/_bundle.js");
-  await writeFile2(resolve6(DIST_DIR, "index.html"), generateHTML(componentName, liveReload));
+  await writeFile2(resolve7(DIST_DIR, "index.html"), generateHTML(componentName, liveReload));
   console.log("Generated: .preview-dist/index.html");
   return { distDir: DIST_DIR };
 }
@@ -25077,7 +25193,7 @@ var init_compile = __esm({
 // src/lib/tokens.ts
 import { readFile as readFile3 } from "node:fs/promises";
 import { existsSync as existsSync13 } from "node:fs";
-import { resolve as resolve7, dirname as dirname4 } from "node:path";
+import { resolve as resolve8, dirname as dirname4 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 async function loadTokens(jsonPath) {
   const content = await readFile3(jsonPath, "utf-8");
@@ -25152,15 +25268,15 @@ ${darkLines.join("\n")}
   return css;
 }
 function findBaseTokensJson(ctx2) {
-  const monorepoTokens = resolve7(ctx2.root, "site/shared/tokens/tokens.json");
+  const monorepoTokens = resolve8(ctx2.root, "site/shared/tokens/tokens.json");
   if (existsSync13(monorepoTokens)) return monorepoTokens;
-  const bundledTokens = resolve7(dirname4(thisFile2), "tokens.json");
+  const bundledTokens = resolve8(dirname4(thisFile2), "tokens.json");
   if (existsSync13(bundledTokens)) return bundledTokens;
   return null;
 }
 async function loadTokenSet(ctx2) {
   if (ctx2.projectDir && ctx2.config?.paths.tokens) {
-    const userTokens = resolve7(ctx2.projectDir, ctx2.config.paths.tokens, "tokens.json");
+    const userTokens = resolve8(ctx2.projectDir, ctx2.config.paths.tokens, "tokens.json");
     if (await fileExists(userTokens)) return loadTokens(userTokens);
   }
   const basePath = findBaseTokensJson(ctx2);
@@ -25170,7 +25286,7 @@ async function loadTokenSet(ctx2) {
     );
   }
   const base = await loadTokens(basePath);
-  const uiJsonPath = resolve7(ctx2.root, "site/ui/tokens.json");
+  const uiJsonPath = resolve8(ctx2.root, "site/ui/tokens.json");
   if (await fileExists(uiJsonPath)) {
     return mergeTokenSets(base, await loadTokens(uiJsonPath));
   }
@@ -25201,33 +25317,33 @@ var init_errors2 = __esm({
 // src/lib/preview/assets.ts
 import { existsSync as existsSync14 } from "node:fs";
 import { readFile as readFile4 } from "node:fs/promises";
-import { resolve as resolve8, dirname as dirname5 } from "node:path";
+import { resolve as resolve9, dirname as dirname5 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function firstExisting(...candidates) {
   return candidates.find((c) => !!c && existsSync14(c));
 }
 function unoBinCandidates(dir) {
-  return ["unocss", "unocss.cmd", "unocss.CMD"].map((n) => resolve8(dir, "node_modules/.bin", n));
+  return ["unocss", "unocss.cmd", "unocss.CMD"].map((n) => resolve9(dir, "node_modules/.bin", n));
 }
 async function resolvePreviewAssets(ctx2) {
   const monorepo = ctx2.config === null;
   const projectDir = ctx2.projectDir;
   const rootDir = projectDir ?? ctx2.root;
-  const srcComponentsDir = monorepo ? resolve8(ctx2.root, "ui/components/ui") : resolve8(projectDir, ctx2.config.paths.components);
+  const srcComponentsDir = monorepo ? resolve9(ctx2.root, "ui/components/ui") : resolve9(projectDir, ctx2.config.paths.components);
   const tokensCss = await loadTokensCss(ctx2);
   const globalsPath = firstExisting(
-    projectDir && resolve8(projectDir, "styles/globals.css"),
-    projectDir && resolve8(projectDir, "globals.css"),
-    projectDir && resolve8(projectDir, "app/globals.css"),
-    monorepo ? resolve8(ctx2.root, "site/ui/styles/globals.css") : void 0,
-    resolve8(assetDir, "preview-globals.css")
+    projectDir && resolve9(projectDir, "styles/globals.css"),
+    projectDir && resolve9(projectDir, "globals.css"),
+    projectDir && resolve9(projectDir, "app/globals.css"),
+    monorepo ? resolve9(ctx2.root, "site/ui/styles/globals.css") : void 0,
+    resolve9(assetDir, "preview-globals.css")
   );
   const globalsCss = globalsPath ? await readFile4(globalsPath, "utf-8") : "";
-  const bundledUnoConfig = resolve8(assetDir, "preview-uno.config.ts");
+  const bundledUnoConfig = resolve9(assetDir, "preview-uno.config.ts");
   const configPath = firstExisting(
-    projectDir && resolve8(projectDir, "uno.config.ts"),
-    projectDir && resolve8(projectDir, "uno.config.js"),
-    monorepo ? resolve8(ctx2.root, "site/ui/uno.config.ts") : void 0,
+    projectDir && resolve9(projectDir, "uno.config.ts"),
+    projectDir && resolve9(projectDir, "uno.config.js"),
+    monorepo ? resolve9(ctx2.root, "site/ui/uno.config.ts") : void 0,
     bundledUnoConfig
   );
   if (!configPath) {
@@ -25235,11 +25351,11 @@ async function resolvePreviewAssets(ctx2) {
       "No UnoCSS config found and the bundled default is missing \u2014 reinstall @barefootjs/cli."
     );
   }
-  const unoCwd = monorepo ? resolve8(ctx2.root, "site/ui") : rootDir;
-  const globs = monorepo ? ["../../ui/components/**/*.tsx", "./**/*.tsx", "./dist/**/*.tsx"] : [resolve8(srcComponentsDir, "**/*.tsx")];
+  const unoCwd = monorepo ? resolve9(ctx2.root, "site/ui") : rootDir;
+  const globs = monorepo ? ["../../ui/components/**/*.tsx", "./**/*.tsx", "./dist/**/*.tsx"] : [resolve9(srcComponentsDir, "**/*.tsx")];
   const unoBin = firstExisting(
     ...unoBinCandidates(rootDir),
-    ...monorepo ? unoBinCandidates(resolve8(ctx2.root, "site/ui")) : [],
+    ...monorepo ? unoBinCandidates(resolve9(ctx2.root, "site/ui")) : [],
     ...monorepo ? unoBinCandidates(ctx2.root) : []
   );
   if (!unoBin) {
@@ -25248,9 +25364,9 @@ async function resolvePreviewAssets(ctx2) {
     );
   }
   const runtimeStandalone = firstExisting(
-    monorepo ? resolve8(ctx2.root, "packages/client/dist/runtime/standalone.js") : void 0,
-    resolve8(rootDir, "node_modules/@barefootjs/client/dist/runtime/standalone.js"),
-    resolve8(rootDir, "node_modules/@barefootjs/client/dist/runtime/index.js")
+    monorepo ? resolve9(ctx2.root, "packages/client/dist/runtime/standalone.js") : void 0,
+    resolve9(rootDir, "node_modules/@barefootjs/client/dist/runtime/standalone.js"),
+    resolve9(rootDir, "node_modules/@barefootjs/client/dist/runtime/index.js")
   );
   if (!runtimeStandalone) {
     throw new PreviewError(
@@ -25549,11 +25665,11 @@ var init_preview_generate = __esm({
 });
 
 // src/lib/preview/run.ts
-import { resolve as resolve9, relative as relative4 } from "node:path";
+import { resolve as resolve10, relative as relative4 } from "node:path";
 import { readFileSync as readFileSync6, writeFileSync as writeFileSync4, existsSync as existsSync15 } from "node:fs";
 async function runPreview(componentName, ctx2, opts = {}) {
   const assets = await resolvePreviewAssets(ctx2);
-  const previewsPath = resolve9(assets.srcComponentsDir, componentName, "index.preview.tsx");
+  const previewsPath = resolve10(assets.srcComponentsDir, componentName, "index.preview.tsx");
   if (!existsSync15(previewsPath)) {
     try {
       const meta = loadComponent(ctx2.metaDir, componentName);
@@ -25725,7 +25841,7 @@ async function run8(args2, ctx2) {
   Serving ${server.url}`);
   if (!opts.watch) {
     console.log("  Press Ctrl+C to stop.");
-    await new Promise((resolve10) => process.on("SIGINT", resolve10));
+    await new Promise((resolve11) => process.on("SIGINT", resolve11));
     server.close();
     return;
   }
@@ -25775,7 +25891,7 @@ async function run8(args2, ctx2) {
   const watchers = watchTargets.map(
     (target) => fsWatch(target, { recursive: true }, schedule)
   );
-  await new Promise((resolve10) => process.on("SIGINT", resolve10));
+  await new Promise((resolve11) => process.on("SIGINT", resolve11));
   for (const w of watchers) w.close();
   server.close();
 }
@@ -27259,9 +27375,9 @@ function findProjectConfig(startDir) {
   let dir = path.resolve(startDir);
   const { root: fsRoot } = path.parse(dir);
   while (true) {
-    const ts19 = path.join(dir, "barefoot.config.ts");
-    if (existsSync2(ts19)) {
-      return { dir, tsConfigPath: ts19 };
+    const ts20 = path.join(dir, "barefoot.config.ts");
+    if (existsSync2(ts20)) {
+      return { dir, tsConfigPath: ts20 };
     }
     if (dir === fsRoot) return null;
     dir = path.dirname(dir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI for agent-driven UI component discovery and scaffolding",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
     "typescript": "^5.0.0"
   },
   "devDependencies": {
-    "@barefootjs/jsx": "0.3.0",
+    "@barefootjs/jsx": "0.4.0",
     "@types/node": "^22.0.0"
   }
 }