@backtickjs/bundler 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jean-François Bisson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# @backtickjs/bundler
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Turns a screen into one JavaScript file for the client. On each request, your server calls `bundler.build` with a server component; the bundler runs it and the server components it draws, and combines their data with the client scripts they return into a bundle. Scripts were already compiled at build time, so nothing is compiled or parsed per request.
+
+## Install
+
+```sh
+npm install @backtickjs/bundler @backtickjs/core
+```
+
+## Usage
+
+For React Native, write CommonJS and serve it; the app fetches it and runs it with `evaluate` from `@backtickjs/react-native-client`:
+
+```tsx
+import { bundler } from "@backtickjs/bundler";
+import { Home } from "./Home.js";
+
+const packageVersions = { react: "19.2.3", "react-native": "0.86.3" };
+
+// In a request handler:
+const bundle = await bundler.build({ input: <Home />, packageVersions });
+const { code } = bundle.generate({ format: "cjs" });
+response.setHeader("content-type", "text/javascript");
+response.end(code);
+```
+
+For the web, write an ES module whose default export is the value, and load it with `<script type="module">` and an import map for the packages the page provides:
+
+```tsx
+import { bundler } from "@backtickjs/bundler";
+import { cs } from "@backtickjs/core";
+import { createRoot } from "@backtickjs/react/client";
+import { Home } from "./Home.js";
+
+const element = <Home />;
+const bundle = await bundler.build({
+  input: cs`$createRoot(document.getElementById("app")!).render($element)`,
+  packageVersions: { react: "19.2.3", "react-dom": "19.2.3" },
+});
+const { code } = bundle.generate({ format: "es", sourcemap: "inline" });
+```
+
+### `packageVersions`
+
+The packages the client provides, each at its exact version. The server decides which versions to bundle for: one app version, or one per client if your server tells them apart. Those packages are left out of the bundle, which imports (`es`) or requires (`cjs`) them. `build` rejects a script that imports from any other package, or whose import needs a range that doesn't include the version given: an adapter's (`^19.2.3` for `@backtickjs/react`) or one written with `createImport`.
+
+### What crosses into a script
+
+Spliced values are written into the bundle as data: strings, finite numbers, booleans, `null`, `undefined`, plain objects and arrays. They are never written as code. A host function or a class instance can't be spliced, and `build` rejects one: write a client function as a script, `` cs`(n: number) => …` ``, and draw a server component through a splice, `{${<Footer />}}`.
+
+### Formats
+
+- `"es"`: an ES module, for a web page. Packages are imported by specifier, which the page's import map resolves.
+- `"cjs"`: CommonJS, for a client that provides `require` itself, as a React Native app does through `evaluate`.
+
+### Source maps
+
+`sourcemap: "inline"` appends the map to the code as a `data:` URL; `"hidden"` doesn't. Either way, it is also returned as `map`. The map names your server files and lines, not their content. None by default.
+
+## API
+
+- `bundler.build({ input, packageVersions })`: runs the server components in `input` and returns a `Bundle`. Async.
+- `Bundle.generate({ format, sourcemap })`: writes the bundle; returns `{ code, map }`, where `map` is `null` without a source map.
+- Types: `BuildOptions`, `OutputOptions`, `OutputChunk`, `Bundle`.
+
+## Related
+
+- [`@backtickjs/core`](https://github.com/backtickjs/backtick/tree/main/packages/core): the `cs` tag
+- [`@backtickjs/react-native-client`](https://github.com/backtickjs/backtick/tree/main/packages/react-native-client): runs a `cjs` bundle in a React Native app
+- [`@backtickjs/react`](https://github.com/backtickjs/backtick/tree/main/packages/react), [`@backtickjs/react-native`](https://github.com/backtickjs/backtick/tree/main/packages/react-native), [`@backtickjs/solid-js`](https://github.com/backtickjs/backtick/tree/main/packages/solid-js): framework adapters
+- [Documentation](https://backtickjs.com/docs)
+
+## License
+
+MIT

package/dist/bundle/bindingKey.d.ts

@@ -0,0 +1 @@
+export declare function sourceName(key: string): string;

package/dist/bundle/bindingKey.js

@@ -0,0 +1,10 @@
+// A binding key as the compiler writes it, `<name>$<fileHash>$<n>`. Shared by
+// the two halves of the bundler because both have to agree on what a key means,
+// and neither owns it.
+// The source name a key was written under, with the uniqueness suffix dropped.
+// Printing it is the caller's job: two distinct keys can share a source name,
+// and whether that matters depends on whether they can meet in one scope.
+export function sourceName(key) {
+    return key.replace(/\$[0-9a-z]+\$\d+$/, "");
+}
+//# sourceMappingURL=bindingKey.js.map

package/dist/bundle/bindingKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindingKey.js","sourceRoot":"","sources":["../../src/bundle/bindingKey.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,uBAAuB;AAEvB,+EAA+E;AAC/E,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/bundle/buildBundle.d.ts

@@ -0,0 +1,14 @@
+import { type ClientModule } from "@backtickjs/core";
+import { type Spliceable } from "@backtickjs/core";
+import type { Names } from "../print/code.js";
+/**
+ * A bundle as it is built, before it is printed: each script's module it
+ * declares under its label, in the order rendering first reached it, and the
+ * root, as code; and what they import.
+ */
+export interface BundleTree {
+    readonly modules: readonly (readonly [string, ClientModule])[];
+    readonly root: string;
+    readonly names: Names;
+}
+export declare function buildBundle(value: Spliceable, packageVersions: Readonly<Record<string, string>>): Promise<BundleTree>;

package/dist/bundle/buildBundle.js

@@ -0,0 +1,270 @@
+import { isClientScript, isJsxElement, } from "@backtickjs/core";
+import { isClientImport } from "@backtickjs/core";
+import { expandJsxElement, } from "./expandJsxElement.js";
+import { bindingsOf, capturesOf } from "./params.js";
+import { sourceName } from "./bindingKey.js";
+import { array, arrow, call, createNames, imported, literal, object, thunk, undefinedValue, } from "../print/code.js";
+// Names a binding may not take: what strict code cannot bind. Every name the
+// bundle introduces starts with `$`, which a script cannot bind, so none of
+// those can meet a binding.
+const RESERVED = ["arguments", "await", "eval", "yield"];
+const rootScope = { bindings: new Set() };
+// Builds the bundle `{ scripts, root }` as code, and documents how it is
+// derived.
+//
+// Each script is declared once, as its compiled code under a label `$cs<n>`,
+// and called wherever it is used. Its code takes a parameter per splice —
+// a hole reads `$splice<i>()` — then per tag and per capture, so it is a function of the
+// script's source alone: every call passes its own splice arguments, as
+// thunks, and nothing from a call site is inlined.
+//
+// A captured variable is threaded, not resolved by name at the splice site: a
+// fragment written in one script but spliced (via host code) into another still
+// refers to the binding it was written under. Each script receives its live
+// captures as parameters, and a call of it passes those captures from the
+// enclosing scope. Because the compiler gives every binding a globally unique
+// name, a capture is threaded under that one name the whole way down — an
+// 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, packageVersions) {
+    const names = createNames(packageVersions);
+    const elementExpansions = new WeakMap();
+    // Each script's number, in the order rendering first reaches it. Two
+    // scripts written at one source location are one declaration, so the first
+    // script with an id stands for all of them, and a reference to a shared
+    // script is a reference to the same object. Keyed by that script so a label
+    // is a lookup rather than a scan, and ordered by insertion, which is the
+    // order the tail declares them in.
+    const numbers = new Map();
+    const scriptById = new Map();
+    const scriptFor = (script) => {
+        const existing = scriptById.get(script.module.id);
+        if (existing !== undefined) {
+            return existing;
+        }
+        scriptById.set(script.module.id, script);
+        numbers.set(script, numbers.size);
+        return script;
+    };
+    // A binding key printed under its source name, with a numeric suffix when two
+    // distinct bindings would otherwise print the same.
+    //
+    // Disambiguated at all because these become identifiers, and identifiers nest:
+    // a hole inside a thunk puts one thunk's parameters inside another's, so two
+    // bindings sharing a source name can land in one chain and the inner would
+    // shadow what the outer was handed (`shadowing` nests three).
+    //
+    // One scope, which is the bundle root: what a drawing is written into now
+    // that structure goes where it stands. A declared script's names are the
+    // compiler's, from its own source — nothing out here reads those names,
+    // because a call hands a script its arguments positionally, and its
+    // captures arrive as numbered parameters rather than under a name.
+    const displayed = new Map();
+    const used = new Set(RESERVED);
+    const displayName = (key) => {
+        const existing = displayed.get(key);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const base = sourceName(key);
+        let name = base;
+        for (let n = 2; used.has(name); n++) {
+            name = `${base}${n}`;
+        }
+        used.add(name);
+        displayed.set(key, name);
+        return name;
+    };
+    // The script-declared bindings a hole feeds its thunk, so a spliced fragment
+    // sees the bindings in scope at its hole even though the thunk is written at
+    // the call site. The body's hole call and every thunk's parameter list read
+    // this, so they agree positionally.
+    //
+    // Read off the script's own source (see `splices` in `resolveBindings`),
+    // not off what the arguments reaching that hole in this bundle happen to
+    // capture. That is what lets a script be compiled from its source alone: a
+    // second call site appearing elsewhere in a render cannot change a thunk a
+    // first one already had.
+    //
+    // It is a superset — the bindings a fragment written there *could* name, not
+    // the ones it does — because which fragment reaches a hole is a host
+    // decision. A carried fragment arrives with its own captures already bound,
+    // so the extra parameters are unused rather than wrong.
+    const passKeys = (target, hole) => bindingsOf(target.module.params[hole]);
+    // The scripts the bundle declares: those a reference calls or passes, not
+    // every one looked up on the way.
+    const declared = new Set();
+    // A declared script's label: `$cs` and its number.
+    const labelOf = (target) => `$cs${numbers.get(target)}`;
+    const declare = (script) => {
+        declared.add(script);
+    };
+    // A fragment that is one script whose parameters are exactly what this hole
+    // passes, so calling it is what a thunk around it would have done. The lists
+    // are compared rather than assumed: a hole hands over what its own script has,
+    // and a fragment wants what its own script needs, and those coincide often
+    // but not always.
+    const forwarding = (value, passed) => {
+        if (!isClientScript(value) ||
+            value.module.params.some((param) => param.kind !== "capture")) {
+            return null;
+        }
+        const target = scriptFor(value);
+        const wanted = capturesOf(target);
+        if (wanted.length !== passed.length ||
+            wanted.some((key, at) => key !== passed[at])) {
+            return null;
+        }
+        declare(target);
+        return labelOf(target);
+    };
+    // Writes a value as the code it becomes: composition as data, which is what
+    // a bundle is. A script reference is a call naming which script and
+    // 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.
+    const render = async (value, scope = rootScope) => {
+        if (isClientScript(value)) {
+            const target = scriptFor(value);
+            declare(target);
+            return call(labelOf(target), await exprCallArgs(value, scope));
+        }
+        if (isJsxElement(value)) {
+            return renderJsx(value, scope);
+        }
+        if (isClientImport(value)) {
+            return imported(names, value);
+        }
+        if (value === null) {
+            return literal(null);
+        }
+        // Checked by name, since everything past here reads the value as an object.
+        if (value === undefined) {
+            return undefinedValue;
+        }
+        if (typeof value === "number" ||
+            typeof value === "string" ||
+            typeof value === "boolean") {
+            return literal(value);
+        }
+        if (Array.isArray(value)) {
+            const elements = [];
+            for (const element of value) {
+                elements.push(await render(element, scope));
+            }
+            return array(elements);
+        }
+        // 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;
+            throw new Error((name === ""
+                ? "Can't splice a host function"
+                : `Can't splice the host function \`${name}\``) +
+                ": it's host code, and only runs on the host. Write a client " +
+                "function as a script instead: cs`(n: number) => ...`; a server " +
+                `component is drawn in a braced splice: \`{\${<${name || "Name"} />}}\`.`);
+        }
+        // Only plain objects cross structurally. A class instance would land here
+        // and half-work — own fields would cross, getters and methods silently
+        // 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);
+        if (prototype !== Object.prototype && prototype !== null) {
+            const name = value.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 = [];
+        for (const [key, entry] of Object.entries(value)) {
+            entries.push([key, await render(entry, scope)]);
+        }
+        return object(entries);
+    };
+    // Renders a capture in JSON position: a parameter of an enclosing thunk
+    // resolves by name; anything else must be a parameter of the enclosing script.
+    // At
+    // the bundle root there is no enclosing instance, so a capture reaching it
+    // can't be threaded from anywhere.
+    const capExpr = (key, scope) => {
+        if (scope.bindings.has(key)) {
+            return displayName(key);
+        }
+        throw new Error(`Can't thread the capture \`${sourceName(key)}\`: nothing encloses ` +
+            "this reference to supply it. A fragment carries the bindings it was " +
+            "written under, so this is also what happens when one is spliced " +
+            "somewhere another `" +
+            sourceName(key) +
+            "` shadows it: the binding is still there, but no longer reachable by " +
+            "name, and naming it anyway would mean emitting what the source " +
+            "couldn't say.");
+    };
+    // The arguments of a call of a declared script: for
+    // one `#thunk` per splice ahead of the environment.
+    const exprCallArgs = async (ref, scope) => {
+        const target = scriptFor(ref);
+        const parts = [];
+        // The splices lead the parameters, one `arg` each.
+        for (const [index, arg] of ref.args.entries()) {
+            // What the hole hands over, in the order the script fixes: the bindings
+            // bound there, then the captures it forwards on behalf of whatever is
+            // nested inside it.
+            const passed = [...passKeys(target, index), ...capturesOf(target)];
+            // A fragment whose own parameters are exactly that list reads the hole's
+            // arguments as they arrive, so it is passed as it is rather than wrapped
+            // in a thunk that would only pass them along.
+            const forwarded = forwarding(arg, passed);
+            if (forwarded !== null) {
+                parts.push(forwarded);
+                continue;
+            }
+            if (passed.length === 0) {
+                parts.push(thunk(await render(arg, scope)));
+                continue;
+            }
+            // Otherwise a thunk names them and calls the fragment with what it wants.
+            const inner = { bindings: new Set([...scope.bindings, ...passed]) };
+            parts.push(arrow(passed.map(displayName), await render(arg, inner)));
+        }
+        for (const key of capturesOf(target)) {
+            parts.push(capExpr(key, scope));
+        }
+        return parts;
+    };
+    // A tag. A component runs on the host and what it drew stands where the tag
+    // stood; an element is its own name, each prop an expression in the
+    // enclosing script's scope.
+    //
+    // A prop that is `undefined` is left out, as JSX and TypeScript's optional
+    // props read it: a component forwarding an optional prop it wasn't given
+    // writes nothing.
+    const renderJsx = async (jsx, scope) => {
+        const type = jsx.type;
+        if (typeof type === "function" && !isClientImport(type)) {
+            return render(await expandJsxElement(jsx, type, elementExpansions), scope);
+        }
+        // An element and a client component (an import, or a script answering
+        // one) are client code, so on the host they can't be tags: they are tags
+        // in a script.
+        if (typeof type === "string") {
+            throw new Error(`\`<${type}>\` is drawn by the client, so it belongs in a script: ` +
+                `cs\`<${type}>…</${type}>\`.`);
+        }
+        const tag = isClientImport(type) ? `\`<${type.name}>\`` : "A script";
+        throw new Error(`${tag} is a client component, so it can't be a tag on the host. ` +
+            "Use it as a tag in a script.");
+    };
+    // Nothing encloses the root, so nothing it holds can capture.
+    const root = await render(value);
+    // In table order, which is the order rendering first reached each script.
+    const modules = [];
+    for (const script of numbers.keys()) {
+        if (declared.has(script)) {
+            modules.push([labelOf(script), script.module]);
+        }
+    }
+    return { modules, root, names };
+}
+//# sourceMappingURL=buildBundle.js.map

package/dist/bundle/buildBundle.js.map

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

package/dist/bundle/expandJsxElement.d.ts

@@ -0,0 +1,3 @@
+import type { JsxElement, Spliceable } from "@backtickjs/core";
+export type ElementExpansions = WeakMap<JsxElement, Promise<Spliceable>>;
+export declare function expandJsxElement(jsx: JsxElement, component: (props: never) => unknown, expansions: ElementExpansions): Promise<Spliceable>;

package/dist/bundle/expandJsxElement.js

@@ -0,0 +1,13 @@
+// Runs a host component and answers with what it drew. The component itself
+// never leaves the host: a server component expands away here, and only the
+// client component it bottoms out in reaches the bundle.
+export function expandJsxElement(jsx, component, expansions) {
+    const shared = expansions.get(jsx);
+    if (shared) {
+        return shared;
+    }
+    const expansion = Promise.resolve(component(jsx.props));
+    expansions.set(jsx, expansion);
+    return expansion;
+}
+//# sourceMappingURL=expandJsxElement.js.map

package/dist/bundle/expandJsxElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expandJsxElement.js","sourceRoot":"","sources":["../../src/bundle/expandJsxElement.ts"],"names":[],"mappings":"AAQA,4EAA4E;AAC5E,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAC9B,GAAe,EACf,SAAoC,EACpC,UAA6B;IAE7B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAC/B,SAAS,CAAC,GAAG,CAAC,KAAc,CAAqC,CAClE,CAAC;IACF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/bundle/params.d.ts

@@ -0,0 +1,3 @@
+import type { ClientScript, Param } from "@backtickjs/core";
+export declare function bindingsOf(param: Param | undefined): readonly string[];
+export declare function capturesOf(script: ClientScript): readonly string[];

package/dist/bundle/params.js

@@ -0,0 +1,10 @@
+// What a script's module says about its parameters, the same for every run.
+// The bindings a hole hands over. A capture hands over none.
+export function bindingsOf(param) {
+    return param?.kind === "splice" ? param.bindings : [];
+}
+// The binding keys a script captures, in parameter order.
+export function capturesOf(script) {
+    return script.module.params.flatMap((param) => param.kind === "capture" ? [param.key] : []);
+}
+//# sourceMappingURL=params.js.map

package/dist/bundle/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/bundle/params.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAE5E,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,KAAwB;IACjD,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5C,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAC5C,CAAC;AACJ,CAAC"}

package/dist/bundler.d.ts

@@ -0,0 +1,32 @@
+import type { Spliceable } from "@backtickjs/core";
+export interface BuildOptions {
+    readonly input: Spliceable;
+    readonly packageVersions: Readonly<Record<string, string>>;
+}
+export interface OutputOptions {
+    readonly format: "es" | "cjs";
+    readonly sourcemap?: false | "inline" | "hidden";
+}
+/** What `generate` writes: the code, and its map where one was asked for. */
+export interface OutputChunk {
+    readonly code: string;
+    readonly map: string | null;
+}
+/** A built bundle, written out by `generate`. */
+export interface Bundle {
+    generate(options: OutputOptions): OutputChunk;
+}
+/**
+ * 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 />, packageVersions });
+ *     const { code, map } = bundle.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.
+ */
+export declare const bundler: {
+    build({ input, packageVersions }: BuildOptions): Promise<Bundle>;
+};

package/dist/bundler.js

@@ -0,0 +1,34 @@
+import { buildBundle } from "./bundle/buildBundle.js";
+import { printBundle } from "./print/printBundle.js";
+/**
+ * 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 />, packageVersions });
+ *     const { code, map } = bundle.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.
+ */
+export const bundler = {
+    async build({ input, packageVersions }) {
+        // 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, packageVersions);
+        return {
+            generate: ({ format, sourcemap = false }) => {
+                const { code, map } = printBundle(tree, format);
+                if (sourcemap === false) {
+                    return { code, map: null };
+                }
+                if (sourcemap === "hidden") {
+                    return { code, map };
+                }
+                const url = `data:application/json;charset=utf-8,${encodeURIComponent(map)}`;
+                return { code: `${code}\n//# sourceMappingURL=${url}`, map };
+            },
+        };
+    },
+};
+//# sourceMappingURL=bundler.js.map

package/dist/bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAiCrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,eAAe,EAAgB;QAClD,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACvD,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,EAAE,EAAE;gBAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAChD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;oBACxB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;gBAC7B,CAAC;gBACD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBACvB,CAAC;gBACD,MAAM,GAAG,GAAG,uCAAuC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,0BAA0B,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC;YAC/D,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { type Bundle, type BuildOptions, bundler, type OutputChunk, type OutputOptions, } from "./bundler.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { bundler, } from "./bundler.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,OAAO,GAGR,MAAM,cAAc,CAAC"}

package/dist/print/code.d.ts

@@ -0,0 +1,28 @@
+import type { ClientImport } from "@backtickjs/core";
+/**
+ * What a bundle imports, keyed by specifier and export, each bound once; and
+ * the packages it may import them from, which the client provides, by version.
+ */
+export interface Names {
+    readonly imports: Map<string, {
+        from: string;
+        name: string;
+        local: string;
+    }>;
+    readonly packageVersions: Readonly<Record<string, string>>;
+}
+export declare function createNames(packageVersions: Readonly<Record<string, string>>): Names;
+export declare function string(value: string): string;
+export declare function literal(value: string | number | boolean | null): string;
+export declare const undefinedValue = "void 0";
+export declare function call(callee: string, args: readonly string[]): string;
+export declare function arrow(params: readonly string[], body: string): string;
+export declare function thunk(body: string): string;
+export declare function array(elements: readonly string[]): string;
+/** An object literal, each key bare where it can be and a string where not. */
+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. */
+export declare function importDeclaration(from: string, name: string, local: string): string;
+export declare function requireDeclaration(from: string, name: string, local: string): string;