@barefootjs/hono 0.1.3 → 0.3.0

package/dist/adapter/hono-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hono-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/hono-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hono-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/hono-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapter/index.js

@@ -447,14 +447,24 @@ export default ${this.componentName}` : "";
     if (loop.bodyIsMultiRoot) {
       safeChildren = `<>{bfComment('bf-loop-i')}${children}</>`;
     }
-    const chainedArray = applyHonoLoopChain(loop);
+    let chainedArray = applyHonoLoopChain(loop);
     const iterMethod = loop.method ?? "map";
+    let callbackParam;
+    if (loop.iterationShape === "entries" && loop.index) {
+      chainedArray = `[...${chainedArray}.entries()]`;
+      callbackParam = `([${loop.index}${indexAnnotation}, ${loop.param}${paramAnnotation}])`;
+    } else if (loop.iterationShape === "keys") {
+      chainedArray = `[...${chainedArray}.keys()]`;
+      callbackParam = `(${loop.param}${paramAnnotation})`;
+    } else {
+      callbackParam = `(${loop.param}${paramAnnotation}${indexParam})`;
+    }
     if (loop.flatMapCallback) {
       mapExpr = `{${chainedArray}.flatMap(${loop.flatMapCallback.params} => ${loop.flatMapCallback.rawBody})}`;
     } else if (preamble) {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => { ${preamble} return ${safeChildren} })}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => { ${preamble} return ${safeChildren} })}`;
     } else {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => ${safeChildren})}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => ${safeChildren})}`;
     }
     return `{bfComment('loop:${loop.markerId}')}${mapExpr}{bfComment('/loop:${loop.markerId}')}`;
   }

package/dist/app.d.ts

@@ -63,14 +63,48 @@ export interface BarefootBuildManifest {
  */
 export declare function manifestToScriptUrls(manifest: BarefootBuildManifest, base: string): string[];
 export declare function relPathFromComponentsBase(p: string): string;
+/**
+ * Shape of `barefoot-externals.json`, written by `bf build` when
+ * `externals` / `bundleEntries` are configured. Only the fields
+ * `BfImportMap` consumes are typed here; the build also emits an
+ * `externals` array (the `--external` list) which the importmap
+ * doesn't need. Fields are optional so a partial/hand-written
+ * manifest still type-checks. See issue #1639.
+ */
+export interface BarefootExternalsManifest {
+    /** Entries for the `<script type="importmap">`. */
+    importmap?: {
+        imports?: Record<string, string>;
+    };
+    /** URLs to emit as `<link rel="modulepreload">`. */
+    preloads?: string[];
+}
 export interface BfImportMapProps {
     /** Base URL where the runtime + component bundles are served. */
     base: string;
+    /**
+     * Contents of `barefoot-externals.json` (import it and pass it
+     * through). Its `importmap.imports` are merged on top of the
+     * built-in `@barefootjs/client*` mappings so islands importing
+     * configured externals (e.g. `zod`, `@barefootjs/form`) resolve in
+     * the browser. When omitted, only the `@barefootjs/client*`
+     * mappings are emitted — the pre-#1639 behavior.
+     */
+    externals?: BarefootExternalsManifest;
+    /**
+     * Whether to also emit `<link rel="modulepreload">` for the
+     * manifest's `preloads`. Defaults to `true`; set `false` to emit
+     * the importmap only.
+     */
+    preload?: boolean;
 }
 /**
  * Emits the `<script type="importmap">` that maps the bare
  * `@barefootjs/client` / `@barefootjs/client/runtime` specifiers to
- * the runtime bundle. Place in `<head>`.
+ * the runtime bundle, plus any externals from `barefoot-externals.json`
+ * passed via the `externals` prop. Also emits `<link rel="modulepreload">`
+ * for the manifest's `preloads` unless `preload` is `false`. Place in
+ * `<head>`.
  */
 export declare function BfImportMap(props: BfImportMapProps): HtmlEscapedString | Promise<HtmlEscapedString>;
 export interface BfScriptsProps {

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,CAAC,aAAa,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAA;CAChF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAWV;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAID,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CASnG;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,QAAQ,EAAE,qBAAqB,CAAA;CAChC;AAQD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa/F;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,gBAAqB,GAAG,iBAAiB,GAAG,IAAI,CAelF;AAID,MAAM,WAAW,wBAAwB;IACvC,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CAanF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQxD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,CAAC,aAAa,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAA;CAChF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAWV;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IAChD,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,yBAAyB,CAAA;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkBnG;AAOD,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,QAAQ,EAAE,qBAAqB,CAAA;CAChC;AAQD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAa/F;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,gBAAqB,GAAG,iBAAiB,GAAG,IAAI,CAelF;AAID,MAAM,WAAW,wBAAwB;IACvC,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CAanF"}

package/dist/app.js

@@ -84,13 +84,18 @@ function relPathFromComponentsBase(p) {
 }
 function BfImportMap(props) {
   const base = props.base.replace(/\/$/, "");
-  const json = JSON.stringify({
-    imports: {
-      "@barefootjs/client": `${base}/barefoot.js`,
-      "@barefootjs/client/runtime": `${base}/barefoot.js`
-    }
-  });
-  return html`<script type="importmap">${raw(json)}</script>`;
+  const imports = {
+    "@barefootjs/client": `${base}/barefoot.js`,
+    "@barefootjs/client/runtime": `${base}/barefoot.js`,
+    ...props.externals?.importmap?.imports ?? {}
+  };
+  const json = JSON.stringify({ imports });
+  const preloads = props.preload === false ? [] : props.externals?.preloads ?? [];
+  const links = preloads.map((href) => `<link rel="modulepreload" href="${escapeAttr(href)}">`).join("");
+  return html`<script type="importmap">${raw(json)}</script>${raw(links)}`;
+}
+function escapeAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 }
 var __bfEmptyManifestWarned = false;
 function BfScripts(props) {

package/dist/build.js

@@ -447,14 +447,24 @@ export default ${this.componentName}` : "";
     if (loop.bodyIsMultiRoot) {
       safeChildren = `<>{bfComment('bf-loop-i')}${children}</>`;
     }
-    const chainedArray = applyHonoLoopChain(loop);
+    let chainedArray = applyHonoLoopChain(loop);
     const iterMethod = loop.method ?? "map";
+    let callbackParam;
+    if (loop.iterationShape === "entries" && loop.index) {
+      chainedArray = `[...${chainedArray}.entries()]`;
+      callbackParam = `([${loop.index}${indexAnnotation}, ${loop.param}${paramAnnotation}])`;
+    } else if (loop.iterationShape === "keys") {
+      chainedArray = `[...${chainedArray}.keys()]`;
+      callbackParam = `(${loop.param}${paramAnnotation})`;
+    } else {
+      callbackParam = `(${loop.param}${paramAnnotation}${indexParam})`;
+    }
     if (loop.flatMapCallback) {
       mapExpr = `{${chainedArray}.flatMap(${loop.flatMapCallback.params} => ${loop.flatMapCallback.rawBody})}`;
     } else if (preamble) {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => { ${preamble} return ${safeChildren} })}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => { ${preamble} return ${safeChildren} })}`;
     } else {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => ${safeChildren})}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => ${safeChildren})}`;
     }
     return `{bfComment('loop:${loop.markerId}')}${mapExpr}{bfComment('/loop:${loop.markerId}')}`;
   }

package/dist/index.js

@@ -447,14 +447,24 @@ export default ${this.componentName}` : "";
     if (loop.bodyIsMultiRoot) {
       safeChildren = `<>{bfComment('bf-loop-i')}${children}</>`;
     }
-    const chainedArray = applyHonoLoopChain(loop);
+    let chainedArray = applyHonoLoopChain(loop);
     const iterMethod = loop.method ?? "map";
+    let callbackParam;
+    if (loop.iterationShape === "entries" && loop.index) {
+      chainedArray = `[...${chainedArray}.entries()]`;
+      callbackParam = `([${loop.index}${indexAnnotation}, ${loop.param}${paramAnnotation}])`;
+    } else if (loop.iterationShape === "keys") {
+      chainedArray = `[...${chainedArray}.keys()]`;
+      callbackParam = `(${loop.param}${paramAnnotation})`;
+    } else {
+      callbackParam = `(${loop.param}${paramAnnotation}${indexParam})`;
+    }
     if (loop.flatMapCallback) {
       mapExpr = `{${chainedArray}.flatMap(${loop.flatMapCallback.params} => ${loop.flatMapCallback.rawBody})}`;
     } else if (preamble) {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => { ${preamble} return ${safeChildren} })}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => { ${preamble} return ${safeChildren} })}`;
     } else {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => ${safeChildren})}`;
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => ${safeChildren})}`;
     }
     return `{bfComment('loop:${loop.markerId}')}${mapExpr}{bfComment('/loop:${loop.markerId}')}`;
   }

package/dist/scripts.js

@@ -84,13 +84,18 @@ function relPathFromComponentsBase(p) {
 }
 function BfImportMap(props) {
   const base = props.base.replace(/\/$/, "");
-  const json = JSON.stringify({
-    imports: {
-      "@barefootjs/client": `${base}/barefoot.js`,
-      "@barefootjs/client/runtime": `${base}/barefoot.js`
-    }
-  });
-  return html`<script type="importmap">${raw(json)}</script>`;
+  const imports = {
+    "@barefootjs/client": `${base}/barefoot.js`,
+    "@barefootjs/client/runtime": `${base}/barefoot.js`,
+    ...props.externals?.importmap?.imports ?? {}
+  };
+  const json = JSON.stringify({ imports });
+  const preloads = props.preload === false ? [] : props.externals?.preloads ?? [];
+  const links = preloads.map((href) => `<link rel="modulepreload" href="${escapeAttr(href)}">`).join("");
+  return html`<script type="importmap">${raw(json)}</script>${raw(links)}`;
+}
+function escapeAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 }
 var __bfEmptyManifestWarned = false;
 function BfScripts(props) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/hono",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Hono integration for BarefootJS",
   "type": "module",
   "main": "./dist/index.js",
@@ -101,9 +101,9 @@
     "directory": "packages/adapter-hono"
   },
   "peerDependencies": {
-    "@barefootjs/client": "0.1.3",
-    "@barefootjs/jsx": "0.1.3",
-    "@barefootjs/shared": "0.1.3",
+    "@barefootjs/client": ">=0.2.0",
+    "@barefootjs/jsx": ">=0.2.0",
+    "@barefootjs/shared": ">=0.2.0",
     "hono": "^4.0.0"
   },
   "devDependencies": {

package/src/__tests__/import-map.test.ts

@@ -0,0 +1,88 @@
+/**
+ * BfImportMap tests
+ *
+ * Verifies the importmap merges configured externals from
+ * `barefoot-externals.json` (issue #1639) and emits modulepreload
+ * links, while preserving the pre-#1639 `@barefootjs/client*` defaults
+ * when no externals are passed.
+ */
+import { describe, test, expect } from 'bun:test'
+import { BfImportMap, type BarefootExternalsManifest } from '../app'
+
+function parseImportMap(html: string): Record<string, string> {
+  const match = html.match(/<script type="importmap">(.*?)<\/script>/s)
+  if (!match) throw new Error(`no importmap in: ${html}`)
+  return JSON.parse(match[1]).imports
+}
+
+describe('BfImportMap', () => {
+  test('emits @barefootjs/client defaults when no externals passed', () => {
+    const html = String(BfImportMap({ base: '/components' }))
+    expect(parseImportMap(html)).toEqual({
+      '@barefootjs/client': '/components/barefoot.js',
+      '@barefootjs/client/runtime': '/components/barefoot.js',
+    })
+    expect(html).not.toContain('modulepreload')
+  })
+
+  test('strips trailing slash from base', () => {
+    const html = String(BfImportMap({ base: '/components/' }))
+    expect(parseImportMap(html)['@barefootjs/client']).toBe('/components/barefoot.js')
+  })
+
+  test('merges externals importmap on top of the client defaults', () => {
+    const externals: BarefootExternalsManifest = {
+      importmap: {
+        imports: {
+          zod: 'https://esm.sh/zod@4.4.3',
+          '@barefootjs/form': '/components/form.js',
+        },
+      },
+      preloads: [],
+    }
+    const imports = parseImportMap(String(BfImportMap({ base: '/components', externals })))
+    expect(imports).toEqual({
+      '@barefootjs/client': '/components/barefoot.js',
+      '@barefootjs/client/runtime': '/components/barefoot.js',
+      zod: 'https://esm.sh/zod@4.4.3',
+      '@barefootjs/form': '/components/form.js',
+    })
+  })
+
+  test('manifest @barefootjs/client mapping wins over the prop-derived one', () => {
+    const externals: BarefootExternalsManifest = {
+      importmap: { imports: { '@barefootjs/client': '/vendor/barefoot.js' } },
+    }
+    const imports = parseImportMap(String(BfImportMap({ base: '/components', externals })))
+    expect(imports['@barefootjs/client']).toBe('/vendor/barefoot.js')
+  })
+
+  test('emits modulepreload links for manifest preloads', () => {
+    const externals: BarefootExternalsManifest = {
+      importmap: { imports: {} },
+      preloads: ['/components/form.js', 'https://esm.sh/zod@4.4.3'],
+    }
+    const html = String(BfImportMap({ base: '/components', externals }))
+    expect(html).toContain('<link rel="modulepreload" href="/components/form.js">')
+    expect(html).toContain('<link rel="modulepreload" href="https://esm.sh/zod@4.4.3">')
+  })
+
+  test('preload=false suppresses modulepreload links', () => {
+    const externals: BarefootExternalsManifest = {
+      preloads: ['/components/form.js'],
+    }
+    const html = String(BfImportMap({ base: '/components', externals, preload: false }))
+    expect(html).not.toContain('modulepreload')
+    // importmap still emitted
+    expect(parseImportMap(html)['@barefootjs/client']).toBe('/components/barefoot.js')
+  })
+
+  test('escapes double quotes in preload hrefs', () => {
+    const externals: BarefootExternalsManifest = {
+      preloads: ['/components/"onerror=alert(1).js'],
+    }
+    const html = String(BfImportMap({ base: '/components', externals }))
+    expect(html).not.toContain('"onerror=alert(1)')
+    expect(html).toContain('&quot;onerror=alert(1)')
+  })
+})

package/src/adapter/hono-adapter.ts

@@ -822,17 +822,32 @@ export class HonoAdapter extends JsxAdapter implements IRNodeEmitter<HonoRenderC
     // for both SSR (runtime-eval) and CSR (template fallback).
     // `.toSorted` (non-mutating) preserves shared prop arrays across
     // renders — `.sort()` here would reorder `_p.items` in place.
-    const chainedArray = applyHonoLoopChain(loop)
+    let chainedArray = applyHonoLoopChain(loop)
     const iterMethod = loop.method ?? 'map'
 
+    // Re-emit `.entries()` / `.keys()` / `.values()` for Hono's runtime
+    // JS evaluation. The IR stripped the iterator call and synthesised
+    // param/index, so we reconstruct proper JS: `[...arr.entries()]`
+    // (spread into an array so `.map()` works).
+    let callbackParam: string
+    if (loop.iterationShape === 'entries' && loop.index) {
+      chainedArray = `[...${chainedArray}.entries()]`
+      callbackParam = `([${loop.index}${indexAnnotation}, ${loop.param}${paramAnnotation}])`
+    } else if (loop.iterationShape === 'keys') {
+      chainedArray = `[...${chainedArray}.keys()]`
+      callbackParam = `(${loop.param}${paramAnnotation})`
+    } else {
+      callbackParam = `(${loop.param}${paramAnnotation}${indexParam})`
+    }
+
     if (loop.flatMapCallback) {
       // Complex flatMap: use the original raw callback body (preserves JSX
       // for Hono's runtime JSX evaluation).
       mapExpr = `{${chainedArray}.flatMap(${loop.flatMapCallback.params} => ${loop.flatMapCallback.rawBody})}`
     } else if (preamble) {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => { ${preamble} return ${safeChildren} })}`
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => { ${preamble} return ${safeChildren} })}`
     } else {
-      mapExpr = `{${chainedArray}.${iterMethod}((${loop.param}${paramAnnotation}${indexParam}) => ${safeChildren})}`
+      mapExpr = `{${chainedArray}.${iterMethod}(${callbackParam} => ${safeChildren})}`
     }
     // Wrap with loop boundary markers so reconciliation doesn't affect siblings.
     // bfComment('loop:<id>') → <!--bf-loop:<id>-->. The marker id is unique

package/src/app.ts

@@ -88,25 +88,72 @@ export function relPathFromComponentsBase(p: string): string {
 
 // ── JSX components ─────────────────────────────────────────────────────────
 
+/**
+ * Shape of `barefoot-externals.json`, written by `bf build` when
+ * `externals` / `bundleEntries` are configured. Only the fields
+ * `BfImportMap` consumes are typed here; the build also emits an
+ * `externals` array (the `--external` list) which the importmap
+ * doesn't need. Fields are optional so a partial/hand-written
+ * manifest still type-checks. See issue #1639.
+ */
+export interface BarefootExternalsManifest {
+  /** Entries for the `<script type="importmap">`. */
+  importmap?: { imports?: Record<string, string> }
+  /** URLs to emit as `<link rel="modulepreload">`. */
+  preloads?: string[]
+}
+
 export interface BfImportMapProps {
   /** Base URL where the runtime + component bundles are served. */
   base: string
+  /**
+   * Contents of `barefoot-externals.json` (import it and pass it
+   * through). Its `importmap.imports` are merged on top of the
+   * built-in `@barefootjs/client*` mappings so islands importing
+   * configured externals (e.g. `zod`, `@barefootjs/form`) resolve in
+   * the browser. When omitted, only the `@barefootjs/client*`
+   * mappings are emitted — the pre-#1639 behavior.
+   */
+  externals?: BarefootExternalsManifest
+  /**
+   * Whether to also emit `<link rel="modulepreload">` for the
+   * manifest's `preloads`. Defaults to `true`; set `false` to emit
+   * the importmap only.
+   */
+  preload?: boolean
 }
 
 /**
  * Emits the `<script type="importmap">` that maps the bare
  * `@barefootjs/client` / `@barefootjs/client/runtime` specifiers to
- * the runtime bundle. Place in `<head>`.
+ * the runtime bundle, plus any externals from `barefoot-externals.json`
+ * passed via the `externals` prop. Also emits `<link rel="modulepreload">`
+ * for the manifest's `preloads` unless `preload` is `false`. Place in
+ * `<head>`.
  */
 export function BfImportMap(props: BfImportMapProps): HtmlEscapedString | Promise<HtmlEscapedString> {
   const base = props.base.replace(/\/$/, '')
-  const json = JSON.stringify({
-    imports: {
-      '@barefootjs/client': `${base}/barefoot.js`,
-      '@barefootjs/client/runtime': `${base}/barefoot.js`,
-    },
-  })
-  return html`<script type="importmap">${raw(json)}</script>`
+  // Built-in defaults first, then manifest imports so a configured
+  // `@barefootjs/client` mapping (emitted by `bf build` against the
+  // build's `externalsBasePath`) wins over the prop-derived one.
+  const imports: Record<string, string> = {
+    '@barefootjs/client': `${base}/barefoot.js`,
+    '@barefootjs/client/runtime': `${base}/barefoot.js`,
+    ...(props.externals?.importmap?.imports ?? {}),
+  }
+  const json = JSON.stringify({ imports })
+
+  const preloads = props.preload === false ? [] : props.externals?.preloads ?? []
+  const links = preloads
+    .map((href) => `<link rel="modulepreload" href="${escapeAttr(href)}">`)
+    .join('')
+
+  return html`<script type="importmap">${raw(json)}</script>${raw(links)}`
+}
+
+/** Minimal double-quoted-attribute escaping for config-derived URLs. */
+function escapeAttr(value: string): string {
+  return value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;')
 }
 
 export interface BfScriptsProps {