@fungi.computer/oyster 0.2.0 → 0.3.0

package/dist/build/app-imports.js

@@ -0,0 +1,105 @@
+import { readFile, realpath } from "node:fs/promises";
+import { dirname, extname, join } from "node:path";
+import { fileURLToPath, pathToFileURL, URL } from "node:url";
+import { build } from "esbuild";
+import { parse } from "parse5";
+import { isInsideSnapshot } from "./snapshot-programs/snapshot-path.js";
+// Only code contributes package imports. Vite, not this planning pass, owns
+// loading, validating and emitting assets (including extension-specific loaders).
+const codeExtensions = new Set([
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",
+    ".json",
+]);
+/**
+ * Find runtime package imports in the App, not in its authoring tools or in
+ * package export siblings. esbuild follows local modules and erases type-only
+ * imports; packages stay external until their declared products are compiled.
+ * parse5 owns HTML syntax, including inline module scripts.
+ */
+export async function appRuntimeImports(options) {
+    const root = await realpath(options.root);
+    const contained = async (path) => {
+        const resolved = await realpath(path);
+        if (!isInsideSnapshot(root, resolved))
+            throw new Error(`App import escapes the captured source: ${path}`);
+        return resolved;
+    };
+    const entry = await contained(join(root, options.entry));
+    const modules = [];
+    const document = parse(await readFile(entry, "utf8"));
+    const visit = (node) => {
+        if ("tagName" in node && node.tagName === "script") {
+            const attribute = (name) => node.attrs.find((attribute) => attribute.name === name)?.value;
+            if (attribute("type") === "module") {
+                const src = attribute("src");
+                if (src !== undefined) {
+                    // Vite roots absolute page paths beside the HTML entry.
+                    const url = new URL(src.startsWith("/") && !src.startsWith("//") ? `.${src}` : src, pathToFileURL(entry));
+                    if (url.protocol === "file:")
+                        modules.push({ entryPoints: [fileURLToPath(url)] });
+                }
+                else {
+                    modules.push({
+                        stdin: {
+                            contents: node.childNodes
+                                .map((child) => ("value" in child ? child.value : ""))
+                                .join(""),
+                            resolveDir: dirname(entry),
+                            sourcefile: entry,
+                            loader: "js",
+                        },
+                    });
+                }
+            }
+        }
+        if ("childNodes" in node)
+            node.childNodes.forEach(visit);
+    };
+    visit(document);
+    for (const path of [options.backendEntry, options.shellEntry])
+        if (path !== undefined)
+            modules.push({ entryPoints: [await contained(join(root, path))] });
+    const imports = new Set();
+    for (const module of modules) {
+        const result = await build({
+            ...module,
+            absWorkingDir: root,
+            bundle: true,
+            write: false,
+            metafile: true,
+            packages: "external",
+            platform: "neutral",
+            format: "esm",
+            outdir: ".botanical/app-imports",
+            logLevel: "silent",
+            plugins: [
+                {
+                    name: "captured-app-imports",
+                    setup(build) {
+                        build.onLoad({ filter: /.*/ }, async ({ path, suffix }) => {
+                            await contained(path);
+                            const query = new URL(suffix, "file:///").searchParams;
+                            if (!codeExtensions.has(extname(path)) ||
+                                query.has("raw") ||
+                                query.has("url"))
+                                return { contents: "", loader: "empty" };
+                            return undefined;
+                        });
+                    },
+                },
+            ],
+        });
+        for (const output of Object.values(result.metafile.outputs))
+            for (const imported of output.imports)
+                if (imported.external)
+                    imports.add(imported.path);
+    }
+    return imports;
+}

package/dist/build/build-policy.d.ts

@@ -1,10 +1,12 @@
 /**
  * The pinned workspace build policy: how a captured workspace's manifests
- * build (`package.json#fungi.build`). v2 lets a dependency name its own
- * package build script, which only an admitted Computer build runs.
+ * build (`package.json#fungi.build`). v4 selects App compile roots from runtime
+ * imports, not the authoring/host dependencies in its owning manifest.
+ * A dependency may name its own package build script, which
+ * only an admitted Computer build runs.
  *
  * It is part of every workspace HTML recipe's toolchain, so its digest moves
  * with it, and the Computer build request carries it at the top level, where
  * a builder compiled before it existed refuses the request outright.
  */
-export declare const workspaceBuildPolicy = "package-json-fungi-build-v2";
+export declare const workspaceBuildPolicy = "package-json-fungi-build-v4";

package/dist/build/build-policy.js

@@ -1,10 +1,12 @@
 /**
  * The pinned workspace build policy: how a captured workspace's manifests
- * build (`package.json#fungi.build`). v2 lets a dependency name its own
- * package build script, which only an admitted Computer build runs.
+ * build (`package.json#fungi.build`). v4 selects App compile roots from runtime
+ * imports, not the authoring/host dependencies in its owning manifest.
+ * A dependency may name its own package build script, which
+ * only an admitted Computer build runs.
  *
  * It is part of every workspace HTML recipe's toolchain, so its digest moves
  * with it, and the Computer build request carries it at the top level, where
  * a builder compiled before it existed refuses the request outright.
  */
-export const workspaceBuildPolicy = "package-json-fungi-build-v2";
+export const workspaceBuildPolicy = "package-json-fungi-build-v4";

package/dist/build/candidate-builder.d.ts

@@ -6,7 +6,7 @@ export declare class TeamCandidateBuildError extends Error {
 export declare const teamCandidateConfigurationSchema: Schema.Struct<{
     /** The build policy the host expects; a builder that predates it refuses
      * the request, and this one refuses any other. */
-    readonly buildPolicy: Schema.Literal<"package-json-fungi-build-v2">;
+    readonly buildPolicy: Schema.Literal<"package-json-fungi-build-v4">;
     readonly appId: Schema.refine<import("@fungi.computer/puffball").AppId, Schema.String>;
     readonly sourceRevision: Schema.refine<import("@fungi.computer/puffball").SourceRevision, Schema.String>;
     readonly recipe: Schema.Struct<{