@backtickjs/bundler 0.1.10 → 0.2.0

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { type Bundle, type BuildOptions, bundler, type OutputChunk, type OutputOptions, } from "./bundler.js";
+export { type Build, type BuildOptions, bundler, type OutputChunk, type OutputOptions, } from "./bundler.js";
 export { type Modules, supports } from "./modules.js";

package/dist/print/code.d.ts

@@ -11,6 +11,7 @@ export interface Names {
         local: string;
     }>;
     readonly modules: Modules;
+    exec: boolean;
 }
 export declare function createNames(modules: Modules): Names;
 export declare function string(value: string): string;
@@ -22,6 +23,6 @@ export declare function array(elements: readonly string[]): string;
 export declare function object(entries: readonly (readonly [string, string])[]): string;
 /** An export of a module the client provides, imported by the bundle. */
 export declare function imported(names: Names, { from, name, version }: ClientImport<unknown>): string;
-/** An import declaration of one export under its local name. */
+/** An import declaration of one export, or the namespace (`*`), by its local name. */
 export declare function importDeclaration(from: string, name: string, local: string): string;
 export declare function requireDeclaration(from: string, name: string, local: string): string;

package/dist/print/code.js

@@ -4,7 +4,7 @@ import { supports } from "../modules.js";
 // for the framework's compiler. Everything is code, as a string.
 const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
 export function createNames(modules) {
-    return { imports: new Map(), modules };
+    return { imports: new Map(), modules, exec: false };
 }
 // A string, as a literal: `<` escaped, so no `</script>` or `<!--` appears
 // when the bundle is inlined in a page, and the line and paragraph separators,
@@ -60,9 +60,10 @@ export function imported(names, { from, name, version }) {
         throw new Error(`Can't import \`${name}\` from "${from}": the client provides ` +
             `${listed.join(", ") || "no modules"}.`);
     }
-    if (!supports(names.modules, from, version)) {
-        throw new Error(`Can't import \`${name}\` from "${from}": it needs ${version}, and ` +
-            `the client provides ${from}@${provided}.`);
+    // Typed against one version, it works with a later one of the same major.
+    if (!supports(names.modules, from, `^${version}`)) {
+        throw new Error(`Can't import \`${name}\` from "${from}": it's typed against ` +
+            `${version}, and the client provides ${from}@${provided}.`);
     }
     const key = `${from}\0${name}`;
     let entry = names.imports.get(key);
@@ -72,13 +73,19 @@ export function imported(names, { from, name, version }) {
     }
     return entry.local;
 }
-/** An import declaration of one export under its local name. */
+/** An import declaration of one export, or the namespace (`*`), by its local name. */
 export function importDeclaration(from, name, local) {
+    if (name === "*") {
+        return `import * as ${local} from ${string(from)};`;
+    }
     const exported = IDENTIFIER.test(name) ? name : string(name);
     return `import { ${exported} as ${local} } from ${string(from)};`;
 }
 // The same import as CommonJS writes it: `const { name: local } = require(…);`.
 export function requireDeclaration(from, name, local) {
+    if (name === "*") {
+        return `const ${local} = require(${string(from)});`;
+    }
     const exported = IDENTIFIER.test(name) ? name : string(name);
     return `const { ${exported}: ${local} } = require(${string(from)});`;
 }

package/dist/print/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/print/code.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,6EAA6E;AAC7E,+EAA+E;AAC/E,iEAAiE;AAEjE,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAWhD,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,2EAA2E;AAC3E,+EAA+E;AAC/E,qEAAqE;AACrE,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAClC,kBAAkB,EAClB,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAA4D;IAE5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,iEAAiE;QACjE,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,GAAG,KAAK,GAAG,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,IAAuB;IAC1D,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,6EAA6E;AAC7E,SAAS;AACT,MAAM,UAAU,KAAK,CAAC,MAAyB,EAAE,IAAY;IAC3D,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,QAA2B;IAC/C,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,MAAM,CACpB,OAA+C;IAE/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC1E,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,mCAAmC;AACnC,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAyB;IAE9C,4EAA4E;IAC5E,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAC9C,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,IAAI,EAAE,EAAE,CAC1C,CAAC;QACF,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,YAAY,IAAI,yBAAyB;YAC7D,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,GAAG,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,YAAY,IAAI,eAAe,OAAO,QAAQ;YAClE,uBAAuB,IAAI,IAAI,QAAQ,GAAG,CAC7C,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAAY,EACZ,KAAa;IAEb,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,YAAY,QAAQ,OAAO,KAAK,WAAW,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACpE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,IAAY,EACZ,KAAa;IAEb,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,WAAW,QAAQ,KAAK,KAAK,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;AACvE,CAAC"}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/print/code.ts"],"names":[],"mappings":"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"}

package/dist/print/printBundle.js

@@ -11,6 +11,20 @@ const RUNTIME = `const $require = (id) => {
   }
   return $exports[id];
 };`;
+// Another bundle, executed as this one is, to its value. As CommonJS, handed the
+// `require` this bundle was: inside the module table, `require` is the
+// table's own.
+const EXEC_CJS = `const $exec = async (bundle) => {
+  const module = { exports: {} };
+  new Function("module", "exports", "require", bundle)(module, module.exports, require);
+  return module.exports;
+};`;
+// As an ES module, imported whole, the page's import map answering its
+// imports as it answers this bundle's.
+const EXEC_ES = `const $exec = async (bundle) => {
+  const module = await import("data:text/javascript," + encodeURIComponent(bundle));
+  return module.default;
+};`;
 /**
  * A bundle tree as a module whose default export is the tree's root: the value
  * bundled, as its scripts wrote it.
@@ -36,6 +50,9 @@ export function printBundle(tree, format) {
     for (const { from, name, local } of names.imports.values()) {
         module.line(declaration(from, name, local));
     }
+    if (names.exec) {
+        module.line(format === "es" ? EXEC_ES : EXEC_CJS);
+    }
     // Each script a module table's entry, as webpack's and Metro's are: its body
     // under its id, run once by `$require`. The modules they require are the
     // client's, each imported whole, once.

package/dist/print/printBundle.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtickjs/bundler",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "description": "Runs Backtick server components and bundles a screen per request: one JavaScript file for the client",
   "keywords": [
     "backtick",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@backtickjs/core": "^0.1.10",
+    "@backtickjs/core": "^0.2.0",
     "semver": "^7.8.1"
   },
   "devDependencies": {

package/src/bundle/buildBundle.ts

@@ -1,6 +1,7 @@
 import {
-  type ClientModule,
+  type ScriptModule,
   type ClientScript,
+  isClientExec,
   isClientImport,
   isClientScript,
   isJsxElement,
@@ -8,7 +9,7 @@ import {
 } from "@backtickjs/core";
 
 import { expandServerComponents } from "./expandServerComponents.js";
-import { bindingsOf, capturesOf } from "./params.js";
+import { bindingsOf, capturesOf, isValue } from "./params.js";
 import { sourceName } from "./bindingKey.js";
 import {
   array,
@@ -28,7 +29,7 @@ import type { Modules } from "../modules.js";
  * root, as code; and what they import.
  */
 export interface BundleTree {
-  readonly modules: readonly (readonly [string, ClientModule])[];
+  readonly modules: readonly (readonly [string, ScriptModule])[];
   // The functions and `once` values the bundle makes once, each under its
   // label, in the order they're finished: after what they read.
   readonly constants: readonly (readonly [string, string])[];
@@ -69,7 +70,7 @@ const rootScope = (): Scope => ({ bindings: new Set(), read: new Set() });
 // intermediate script that binds a same-looking variable has a different
 // unique name, so there is nothing to disambiguate and nothing to rename.
 export async function buildBundle(
-  value: unknown,
+  spliceable: unknown,
   provided: Modules,
 ): Promise<BundleTree> {
   const names = createNames(provided);
@@ -137,25 +138,22 @@ export async function buildBundle(
   const labelOf = (target: ClientScript): string =>
     `$cs${numbers.get(target)!}`;
 
-  // Every function the bundle writes is a closure: a function script, and the
-  // thunk a splice is handed over as. One whose code reads nothing of the
+  // The thunk a splice is handed over as. One whose code reads nothing of the
   // scope it's written in, beyond its own parameters, is the same function
   // wherever it's written, so the bundle makes it once, as a constant, and
-  // the same code anywhere else is that constant: a client component keeps
-  // its identity across renders, and a value spliced at every level of a deep
-  // composition is written once per level, not once per path. Making a
-  // function runs nothing, so sharing one isn't observable; everything is
-  // still rendered where it stands.
+  // the same code anywhere else is that constant: a value spliced at every
+  // level of a deep composition is written once per level, not once per path.
+  // A thunk is the bundle's own, never the script's, so sharing one isn't
+  // observable; everything is still rendered where it stands.
   const constants: (readonly [string, string])[] = [];
   const byCode = new Map<string, string>();
-  // `write` renders a closure's code in a scope that records what it reads:
-  // a constant's label if it read nothing of `scope` beyond `own`, its
+  // `write` renders a thunk's code in a scope that records what it reads: a
+  // constant's label if it read nothing of `scope` beyond `own`, its
   // parameters, or else the code, written where it's used.
-  const closure = (
+  const thunk = (
     scope: Scope,
     own: readonly string[],
     write: (inner: Scope) => string,
-    name: string,
   ): string => {
     const read = new Set<string>();
     const code = write({
@@ -171,31 +169,40 @@ export async function buildBundle(
     }
     let label = byCode.get(code);
     if (label === undefined) {
-      label = `${name}${constants.length}`;
+      label = `$thunk${constants.length}`;
       byCode.set(code, label);
       constants.push([label, code]);
     }
     return label;
   };
 
-  // A `once` script is one value: its code run at the top of the bundle,
-  // where nothing encloses it, and every read is that constant. One per
-  // script, which is one per call of `once`, not per code: two runs of a host
-  // function that each make a context are two contexts, as two calls of
-  // `createContext` are. Running code is observable, so unlike a function it
-  // is never shared by code.
+  // A function, a class and a `once` script are each one value (see
+  // `isValue`): its code run at the top of the bundle, where nothing encloses
+  // it, and every read is that constant. One per script, not per code: two
+  // runs of a host function that each make a function are two functions, and
+  // two that each make a context two contexts, as in plain TypeScript.
+  //
+  // A function or a class that reads a variable of the scope it's read in,
+  // itself or through what it's handed, is made there instead, as one
+  // declared in a function is. A `once` script that does is refused.
   const values = new Map<ClientScript, string>();
-  const valueOf = (script: ClientScript): string => {
+  const valueOf = (script: ClientScript, scope: Scope): string => {
     let label = values.get(script);
-    if (label === undefined) {
-      const code = call(
-        labelOf(scriptFor(script)),
-        exprCallArgs(script, rootScope()),
-      );
-      label = `$value${constants.length}`;
-      values.set(script, label);
-      constants.push([label, code]);
+    if (label !== undefined) {
+      return label;
+    }
+    const at: Scope = script.once
+      ? rootScope()
+      : { bindings: scope.bindings, read: new Set() };
+    const code = call(labelOf(scriptFor(script)), exprCallArgs(script, at));
+    const outside = [...at.read].filter((key) => scope.bindings.has(key));
+    if (outside.length > 0) {
+      outside.forEach((key) => scope.read.add(key));
+      return code;
     }
+    label = `$value${constants.length}`;
+    values.set(script, label);
+    constants.push([label, code]);
     return label;
   };
 
@@ -204,41 +211,39 @@ export async function buildBundle(
   // what to hand it; everything else is its literal form. Rendered in order,
   // one value after the other, so the table follows the order rendering first
   // reached each script. Expansion has refused cycles, so it ends.
-  const render = (value: unknown, scope: Scope = rootScope()): string => {
-    if (isClientScript(value)) {
-      if (value.once) {
-        return valueOf(value);
+  const render = (spliceable: unknown, scope: Scope = rootScope()): string => {
+    if (isClientScript(spliceable)) {
+      if (isValue(spliceable)) {
+        return valueOf(spliceable, scope);
       }
-      const target = scriptFor(value);
-      if (target.module.kind !== "function") {
-        return call(labelOf(target), exprCallArgs(value, scope));
-      }
-      return closure(
-        scope,
-        [],
-        (inner) => call(labelOf(target), exprCallArgs(value, inner)),
-        "$function",
+      return call(
+        labelOf(scriptFor(spliceable)),
+        exprCallArgs(spliceable, scope),
       );
     }
-    if (isJsxElement(value)) {
-      return renderJsx(value);
+    if (isJsxElement(spliceable)) {
+      return renderJsx(spliceable);
+    }
+    if (isClientImport(spliceable)) {
+      return imported(names, spliceable);
     }
-    if (isClientImport(value)) {
-      return imported(names, value);
+    if (isClientExec(spliceable)) {
+      names.exec = true;
+      return "$exec";
     }
     if (
-      value === null ||
-      value === undefined ||
-      typeof value === "number" ||
-      typeof value === "bigint" ||
-      typeof value === "string" ||
-      typeof value === "boolean"
+      spliceable === null ||
+      spliceable === undefined ||
+      typeof spliceable === "number" ||
+      typeof spliceable === "bigint" ||
+      typeof spliceable === "string" ||
+      typeof spliceable === "boolean"
     ) {
-      return literal(value);
+      return literal(spliceable);
     }
-    if (Array.isArray(value)) {
+    if (Array.isArray(spliceable)) {
       const elements: string[] = [];
-      for (const element of value) {
+      for (const element of spliceable) {
         elements.push(render(element, scope));
       }
       return array(elements);
@@ -246,8 +251,8 @@ export async function buildBundle(
     // A host function is host code, which never reaches the client: client
     // code is written in a script, and reaches another as one.
     // A server component among them, written as a tag: `<$Rule />`.
-    if (typeof value === "function") {
-      const { name } = value;
+    if (typeof spliceable === "function") {
+      const { name } = spliceable;
       throw new Error(
         (name === ""
           ? "Can't splice a host function"
@@ -258,7 +263,7 @@ export async function buildBundle(
           `\`{\${<${/^[A-Z]/.test(name) ? name : "Name"} />}}\`.`,
       );
     }
-    if (typeof value !== "object") {
+    if (typeof spliceable !== "object") {
       throw new Error(
         "Can't splice a symbol: a bundle can't write one that is the same " +
           "symbol on the client. Splice a string, and make the symbol from it " +
@@ -270,16 +275,16 @@ export async function buildBundle(
     // vanish — so fail loudly instead. An object with behaviour is built by a
     // client function: `state` for what it holds, arrows for what may be done
     // to it.
-    const prototype = Object.getPrototypeOf(value);
+    const prototype = Object.getPrototypeOf(spliceable);
     if (prototype !== Object.prototype && prototype !== null) {
-      const name = value.constructor?.name ?? "an unknown class";
+      const name = spliceable.constructor?.name ?? "an unknown class";
       throw new Error(
         `Can't splice this \`${name}\` instance: only plain objects cross into ` +
           "a client script. Build one with a client function instead.",
       );
     }
     const entries: [string, string][] = [];
-    for (const [key, entry] of Object.entries(value)) {
+    for (const [key, entry] of Object.entries(spliceable)) {
       entries.push([key, render(entry, scope)]);
     }
     return object(entries);
@@ -320,11 +325,8 @@ export async function buildBundle(
       const passed = [...passKeys(target, index), ...capturesOf(target)];
       // A thunk taking them, the splice rendered inside it.
       parts.push(
-        closure(
-          scope,
-          passed,
-          (inner) => arrow(passed.map(displayName), render(arg, inner)),
-          "$thunk",
+        thunk(scope, passed, (inner) =>
+          arrow(passed.map(displayName), render(arg, inner)),
         ),
       );
     }
@@ -356,7 +358,7 @@ export async function buildBundle(
 
   // Every server component first, so siblings run at once; then the drawing,
   // in order. Nothing encloses the root, so nothing it holds can capture.
-  const root = render(await expandServerComponents(value));
+  const root = render(await expandServerComponents(spliceable));
   // In table order, which is the order rendering first reached each script.
   const modules = [...numbers.keys()].map(
     (script) => [labelOf(script), script.module] as const,

package/src/bundle/expandServerComponents.ts

@@ -4,6 +4,7 @@ import {
   isClientScript,
   isJsxElement,
 } from "@backtickjs/core";
+import { isValue } from "./params.js";
 
 const CYCLE_ERROR =
   "Can't splice a value that contains itself: a bundle writes each value " +
@@ -34,70 +35,71 @@ const contains = (ancestors: Ancestors | null, value: object): boolean => {
 // the client code it bottoms out in reaches the bundle. A value holding no
 // server component comes back as the same object.
 //
-// A `once` script is one value, so what it splices is expanded once, however
-// many places read it: a server component inside it runs once. `values` holds
+// A function, a class and a `once` script are each one value (see `isValue`),
+// so what one splices is expanded once, however many places read it: a server
+// component inside it runs once. `values` holds
 // each one's expansion for the call.
 export async function expandServerComponents(
-  value: unknown,
+  spliceable: unknown,
   ancestors: Ancestors | null = null,
   values = new Map<ClientScript, Promise<unknown>>(),
 ): Promise<unknown> {
-  if (typeof value !== "object" || value === null) {
-    return value;
+  if (typeof spliceable !== "object" || spliceable === null) {
+    return spliceable;
   }
-  if (contains(ancestors, value)) {
+  if (contains(ancestors, spliceable)) {
     throw new Error(CYCLE_ERROR);
   }
-  const inside: Ancestors = { value, parent: ancestors };
+  const inside: Ancestors = { value: spliceable, parent: ancestors };
   const all = (entries: readonly unknown[]) =>
     Promise.all(
       entries.map((entry) => expandServerComponents(entry, inside, values)),
     );
 
-  if (isJsxElement(value)) {
-    const { type } = value;
+  if (isJsxElement(spliceable)) {
+    const { type } = spliceable;
     // A tag the client draws is left for rendering to refuse.
     if (typeof type !== "function" || isClientImport(type)) {
-      return value;
+      return spliceable;
     }
     return expandServerComponents(
-      await type(value.props as never),
+      await type(spliceable.props as never),
       inside,
       values,
     );
   }
-  if (isClientScript(value)) {
+  if (isClientScript(spliceable)) {
     const expanded = async (): Promise<unknown> => {
-      const args = await all(value.args);
-      return args.every((arg, index) => arg === value.args[index])
-        ? value
-        : { ...value, args };
+      const args = await all(spliceable.args);
+      return args.every((arg, index) => arg === spliceable.args[index])
+        ? spliceable
+        : { ...spliceable, args };
     };
-    if (!value.once) {
+    if (!isValue(spliceable)) {
       return expanded();
     }
-    let made = values.get(value);
+    let made = values.get(spliceable);
     if (made === undefined) {
       made = expanded();
-      values.set(value, made);
+      values.set(spliceable, made);
     }
     return made;
   }
-  if (Array.isArray(value)) {
-    const elements = await all(value);
-    return elements.every((element, index) => element === value[index])
-      ? value
+  if (Array.isArray(spliceable)) {
+    const elements = await all(spliceable);
+    return elements.every((element, index) => element === spliceable[index])
+      ? spliceable
       : elements;
   }
   // Only plain objects cross; rendering refuses anything else.
-  const prototype = Object.getPrototypeOf(value);
+  const prototype = Object.getPrototypeOf(spliceable);
   if (prototype !== Object.prototype && prototype !== null) {
-    return value;
+    return spliceable;
   }
-  const entries = Object.entries(value);
+  const entries = Object.entries(spliceable);
   const expanded = await all(entries.map(([, entry]) => entry));
   if (expanded.every((entry, index) => entry === entries[index]![1])) {
-    return value;
+    return spliceable;
   }
   // Defined, not assigned, so a `__proto__` key stays a key.
   return Object.fromEntries(

package/src/bundle/params.ts

@@ -7,6 +7,18 @@ export function bindingsOf(param: Param | undefined): readonly string[] {
   return param?.kind === "splice" ? param.bindings : [];
 }
 
+// Whether a script is one value for the bundle, made once at its top: a
+// `once` script, a function and a class, as a module-level one is. A function
+// or a class that reads a variable of the script around it, itself or through
+// what it's handed, is made where it's read instead (see `valueOf`).
+export function isValue(script: ClientScript): boolean {
+  return (
+    script.once === true ||
+    script.module.kind === "function" ||
+    script.module.kind === "class"
+  );
+}
+
 // The binding keys a script captures, in parameter order.
 export function capturesOf(script: ClientScript): readonly string[] {
   return script.module.params.flatMap((param) =>

package/src/bundler.ts

@@ -1,4 +1,4 @@
-import type { Spliceable, SplicesAs } from "@backtickjs/core";
+import type { Bundle, Spliceable, Spliced, SplicesAs } from "@backtickjs/core";
 import { buildBundle } from "./bundle/buildBundle.js";
 import type { Modules } from "./modules.js";
 import { printBundle } from "./print/printBundle.js";
@@ -23,39 +23,45 @@ export interface OutputOptions {
   readonly sourcemap?: false | "inline" | "hidden";
 }
 
-/** What `generate` writes: the code, and its map where one was asked for. */
-export interface OutputChunk {
-  readonly code: string;
+/**
+ * What `generate` writes: the bundle, which runs to a `T`, and its map where
+ * one was asked for.
+ */
+export interface OutputChunk<T = unknown> {
+  readonly code: Bundle<T>;
   readonly map: string | null;
 }
 
-/** A built bundle, written out by `generate`. */
-export interface Bundle {
-  generate(options: OutputOptions): OutputChunk;
+/** What `build` makes of a value that is a `T` on the client, written out by
+ * `generate`. */
+export interface Build<T = unknown> {
+  generate(options: OutputOptions): OutputChunk<T>;
 }
 
 /**
  * What runs your components and hands back what they drew, shaped as Rollup
  * is: a build, then output from it.
  *
- *     const bundle = await bundler.build({ input: <Home />, modules });
- *     const { code, map } = bundle.generate({ format: "es", sourcemap: "hidden" });
+ *     const build = await bundler.build({ input: <Home />, modules });
+ *     const { code, map } = build.generate({ format: "es", sourcemap: "hidden" });
  *
- * The module's default export is the value (CommonJS: `module.exports`). A
- * namespace rather than a bare function, so `bundle` stays a name a caller can
- * give what comes back.
+ * `code` is the bundle, a module whose default export is the value (CommonJS:
+ * `module.exports`). A namespace rather than a bare function, so `build`
+ * stays a name a caller can give what comes back.
  */
 export const bundler = {
   async build<T extends [T] extends [SplicesAs<T>] ? unknown : Spliceable>({
     input,
     modules,
-  }: BuildOptions<T>): Promise<Bundle> {
+  }: BuildOptions<T>): Promise<Build<Spliced<T>>> {
     // Scripts come compiled for their framework when their host was built, so
     // the bundle is only put together: nothing is compiled or parsed here.
     const tree = await buildBundle(input, modules);
     return {
       generate: ({ format, sourcemap = false }) => {
-        const { code, map } = printBundle(tree, format);
+        const printed = printBundle(tree, format);
+        const code = printed.code as Bundle<Spliced<T>>;
+        const map = printed.map;
         if (sourcemap === false) {
           return { code, map: null };
         }
@@ -63,7 +69,10 @@ export const bundler = {
           return { code, map };
         }
         const url = `data:application/json;charset=utf-8,${encodeURIComponent(map)}`;
-        return { code: `${code}\n//# sourceMappingURL=${url}`, map };
+        return {
+          code: `${code}\n//# sourceMappingURL=${url}` as Bundle<Spliced<T>>,
+          map,
+        };
       },
     };
   },

package/src/index.ts

@@ -1,5 +1,5 @@
 export {
-  type Bundle,
+  type Build,
   type BuildOptions,
   bundler,
   type OutputChunk,