@earendil-works/chord 1.4.0 → 1.5.1

package/dist/node/plugins/base-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-inputs.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/base-inputs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,oHAAoH;AACpH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAErD;AAED,wHAAwH;AACxH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUnE"}

package/dist/node/plugins/base-inputs.js

@@ -0,0 +1,33 @@
+// What a base build read (decision "Workers start from the base code the server booted with", slice 11 §1; design §21):
+// each file's bytes, hashed as esbuild's loader receives them (one read per file, never a later read racing a save),
+// the record the watcher's `base` mark compares the files on disk with.
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+/** The hash of `bytes` a base record keeps (SHA-256, hex). */
+export function contentHash(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+/** Reads `path` for a build, recording its bytes' hash in `inputs`: the one read of the file, its bytes for esbuild. */
+export async function readRecorded(path, inputs) {
+    const bytes = await readFile(path);
+    inputs.set(path, contentHash(bytes));
+    return bytes;
+}
+/**
+ * An esbuild plugin loading every file through `readRecorded`, with esbuild's own loader for its extension: what the
+ * build read, in `inputs`. The last of a build's plugins: an earlier `onLoad` returning contents reads (and records)
+ * the file itself.
+ */
+export function recordedSources(inputs) {
+    return {
+        name: "chord-recorded-sources",
+        setup(builder) {
+            builder.onLoad({ filter: /.*/ }, async (args) => {
+                if (args.namespace !== "file")
+                    return undefined;
+                return { contents: await readRecorded(args.path, inputs), loader: "default" };
+            });
+        },
+    };
+}
+//# sourceMappingURL=base-inputs.js.map

package/dist/node/plugins/base-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-inputs.js","sourceRoot":"","sources":["../../../src/node/plugins/base-inputs.ts"],"names":[],"mappings":"AAAA,wHAAwH;AACxH,qHAAqH;AACrH,wEAAwE;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAM5C,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,wHAAwH;AACxH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,MAA2B;IAC3E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAA2B;IAC1D,OAAO;QACN,IAAI,EAAE,wBAAwB;QAC9B,KAAK,CAAC,OAAO;YACZ,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC/C,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;oBAAE,OAAO,SAAS,CAAC;gBAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/E,CAAC,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["// What a base build read (decision \"Workers start from the base code the server booted with\", slice 11 §1; design §21):\n// each file's bytes, hashed as esbuild's loader receives them (one read per file, never a later read racing a save),\n// the record the watcher's `base` mark compares the files on disk with.\n\nimport { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport type { Plugin } from \"esbuild\";\n\n/** What a base artifact was built from: the hash of each file's bytes as read (`contentHash`), by absolute path. */\nexport type BaseInputs = ReadonlyMap<string, string>;\n\n/** The hash of `bytes` a base record keeps (SHA-256, hex). */\nexport function contentHash(bytes: Uint8Array): string {\n\treturn createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\n/** Reads `path` for a build, recording its bytes' hash in `inputs`: the one read of the file, its bytes for esbuild. */\nexport async function readRecorded(path: string, inputs: Map<string, string>): Promise<Buffer> {\n\tconst bytes = await readFile(path);\n\tinputs.set(path, contentHash(bytes));\n\treturn bytes;\n}\n\n/**\n * An esbuild plugin loading every file through `readRecorded`, with esbuild's own loader for its extension: what the\n * build read, in `inputs`. The last of a build's plugins: an earlier `onLoad` returning contents reads (and records)\n * the file itself.\n */\nexport function recordedSources(inputs: Map<string, string>): Plugin {\n\treturn {\n\t\tname: \"chord-recorded-sources\",\n\t\tsetup(builder) {\n\t\t\tbuilder.onLoad({ filter: /.*/ }, async (args) => {\n\t\t\t\tif (args.namespace !== \"file\") return undefined;\n\t\t\t\treturn { contents: await readRecorded(args.path, inputs), loader: \"default\" };\n\t\t\t});\n\t\t},\n\t};\n}\n"]}

package/dist/node/plugins/build.d.ts

@@ -0,0 +1,77 @@
+import type { Context } from "../../context/index.ts";
+import { type Plugin } from "./discover.ts";
+/**
+ * The app's API (slice 12 §1): the package plugins import it as and the versions it provides, newest first
+ * (`{ name: "@acme/app", versions: ["v3", "v2"] }`). Its modules are host packages (`@acme/app/v3`, `@acme/app/v3/web`).
+ */
+export type AppApi = {
+    readonly name: string;
+    readonly versions: readonly string[];
+};
+/** What `buildFacet` takes besides the plugin and the kind. */
+export type BuildOptions = {
+    /** The host packages' specifiers (`@acme/app/v3`, `@acme/app/v3/web`, `react`, `react/jsx-runtime`): external. */
+    readonly hostPackages: readonly string[];
+    /** Where the script runs: Node (a server, a worker, a TUI) or a browser (a page). */
+    readonly platform: "node" | "browser";
+    /** The app's API: its imports checked by version and kind, Chord refused. Without one, host packages as listed. */
+    readonly api?: AppApi;
+    /** The app's facet kinds: a file named `<name>.<kind>.<ext>` is one of that kind, refused in a facet of another. */
+    readonly kinds?: readonly string[];
+    /** The discovered plugins: a file of a directory plugin of the same root may be imported by relative path (a copy). */
+    readonly plugins?: readonly Plugin[];
+    /** Where the app serves a browser build's assets: the URL prefix their imports evaluate to (`/` by default). */
+    readonly publicPath?: string;
+};
+/** A file a build read, with the hash of the bytes it handed esbuild (the watcher's inputs). */
+export type BuildInput = {
+    readonly file: string;
+    readonly hash: string;
+};
+/** A built facet: its script and what it used, or the build's errors. Plain data. */
+export type BuiltFacet = {
+    readonly kind: "script";
+    readonly plugin: string;
+    readonly facet: string;
+    /** The wrapped CommonJS script, minified, with an inline source map whose sources are relative to the plugin. */
+    readonly source: string;
+    /** A hash of `source`: the same on every machine and checkout for the same files. */
+    readonly digest: string;
+    /** Every plugin file it read (its own and copied ones; not packages), absolute paths, with their hashes. */
+    readonly inputs: readonly BuildInput[];
+    /** The files of other plugins inlined into it, absolute paths. */
+    readonly copied: readonly string[];
+    /** A browser build's stylesheet, when it imports CSS. */
+    readonly css?: {
+        readonly name: string;
+        readonly text: string;
+    };
+    /** A browser build's assets, by content-hashed file name. */
+    readonly assets: readonly {
+        readonly name: string;
+        readonly bytes: Uint8Array;
+    }[];
+    /**
+     * The app's API the build checked against and the version the script imports (when it imports one):
+     * evaluation refuses other versions and Chord to a computed `require` as the build did to imports.
+     */
+    readonly api?: {
+        readonly name: string;
+        readonly version: string | undefined;
+    };
+} | {
+    readonly kind: "failed";
+    readonly plugin: string;
+    readonly facet: string;
+    readonly errors: readonly string[];
+};
+/**
+ * Builds `plugin`'s facet of `kind` (one esbuild build from cold): a script wrapped as `(function (require, module,
+ * exports) { … })`, or the errors that refuse it (an import the rules do not admit, a syntax error, `import.meta`,
+ * `__dirname`, `__filename`, a literal dynamic `import("x")`, a top-level `await`), each naming its file and line. A
+ * computed `import(x)` becomes a call of the script's `require`.
+ */
+export declare function buildFacet(plugin: Plugin, kind: string, options: BuildOptions, context: Context): Promise<BuiltFacet>;
+/** Whether `path` lies inside directory `dir` (both absolute). */
+export declare function inside(dir: string, path: string): boolean;
+//# sourceMappingURL=build.d.ts.map

package/dist/node/plugins/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/node/plugins/build.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAI7D;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAErF,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG;IAC1B,kHAAkH;IAClH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,mHAAmH;IACnH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,oHAAoH;IACpH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,uHAAuH;IACvH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gHAAgH;IAChH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,gGAAgG;AAChG,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,qFAAqF;AACrF,MAAM,MAAM,UAAU,GACnB;IACA,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iHAAiH;IACjH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4GAA4G;IAC5G,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAClF;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;CAC9E,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAKpH;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,CAAC,CAgFrB;AA8cD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD"}