@particle-academy/fancy-flow 0.31.0 → 0.33.0

package/dist/engine.cjs

@@ -441,6 +441,7 @@ function validateNodeManifest(input) {
     );
   }
   validateCapabilities(m.capabilities, problems);
+  validateFancyDependencies(m.fancyDependencies, problems);
   if (m.sideEffects !== void 0 && !SIDE_EFFECTS.includes(m.sideEffects)) {
     problems.push(err("sideEffects", `Must be one of: ${SIDE_EFFECTS.join(", ")}.`));
   }
@@ -477,7 +478,7 @@ function validateAliases(aliases2, problems) {
 }
 function validateRuntimes(runtimes, problems) {
   if (typeof runtimes !== "object" || runtimes === null || Array.isArray(runtimes)) {
-    problems.push(err("runtimes", "Required \u2014 an object of runtime id to { entry | package, engine }."));
+    problems.push(err("runtimes", "Required \u2014 an object of runtime id to { files, engine }."));
     return;
   }
   const entries = Object.entries(runtimes);
@@ -487,17 +488,26 @@ function validateRuntimes(runtimes, problems) {
   }
   for (const [runtime, spec] of entries) {
     if (typeof spec !== "object" || spec === null || Array.isArray(spec)) {
-      problems.push(err(`runtimes.${runtime}`, "Must be an object of { entry | package, engine }."));
+      problems.push(err(`runtimes.${runtime}`, "Must be an object of { files, engine }."));
       continue;
     }
     const s = spec;
-    const hasEntry = typeof s.entry === "string" && s.entry.trim() !== "";
-    const hasPackage = typeof s.package === "string" && s.package.trim() !== "";
-    if (!hasEntry && !hasPackage) {
-      problems.push(err(`runtimes.${runtime}`, "Needs `entry` (a module path) or `package` (a dependency requirement)."));
+    const files = Array.isArray(s.files) ? s.files : null;
+    if (!files || files.length === 0 || files.some((f) => typeof f !== "string" || f.trim() === "")) {
+      problems.push(
+        err(
+          `runtimes.${runtime}`,
+          "Needs `files` \u2014 the node source directories this runtime's backend lives in, relative to the node."
+        )
+      );
     }
-    if (hasEntry && hasPackage) {
-      problems.push(err(`runtimes.${runtime}`, "Declare `entry` or `package`, not both \u2014 which one is authoritative is otherwise ambiguous."));
+    if (s.entry !== void 0 || s.package !== void 0) {
+      problems.push(
+        err(
+          `runtimes.${runtime}`,
+          "`entry` / `package` are gone \u2014 nodes are copied into a project, not installed from a registry. Declare `files` instead."
+        )
+      );
     }
     if (typeof s.engine !== "string" || s.engine.trim() === "") {
       problems.push(
@@ -506,6 +516,47 @@ function validateRuntimes(runtimes, problems) {
     }
   }
 }
+var VERSIONED = /(?:@|:)\s*[\^~>=<]*\s*\d/;
+function validateFancyDependencies(deps, problems) {
+  if (deps === void 0) return;
+  if (!Array.isArray(deps)) {
+    problems.push(err("fancyDependencies", "Must be an array of { package, npm?, composer?, reason?, requirement? }."));
+    return;
+  }
+  deps.forEach((entry, index) => {
+    const at = `fancyDependencies[${index}]`;
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+      problems.push(err(at, "Must be an object naming a suite package, not a bare string \u2014 a slug alone cannot say whether the package exists on npm, on Composer, or both."));
+      return;
+    }
+    const dep = entry;
+    if (typeof dep.package !== "string" || dep.package.trim() === "") {
+      problems.push(err(`${at}.package`, "Required \u2014 the suite slug, e.g. `fancy-screens`."));
+    }
+    if (dep.npm === void 0 && dep.composer === void 0) {
+      problems.push(
+        err(at, "Needs at least one of `npm` or `composer`. Naming neither leaves the CLI with a package it cannot offer any way to install.")
+      );
+    }
+    for (const field of ["package", "npm", "composer"]) {
+      const value = dep[field];
+      if (typeof value === "string" && VERSIONED.test(value.replace(/^@[a-z0-9._-]+\//i, ""))) {
+        problems.push(
+          err(
+            `${at}.${field}`,
+            "Must not carry a version range \u2014 the suite ships additively and a pin here freezes a consumer on an old surface. Express engine compatibility in `runtimes[].engine` instead."
+          )
+        );
+      }
+    }
+    if (dep.version !== void 0) {
+      problems.push(err(`${at}.version`, "Not a field. Fancy dependencies are unversioned \u2014 see `runtimes[].engine` for the constraint that is actually checked."));
+    }
+    if (dep.requirement !== void 0 && !REQUIREMENTS.includes(dep.requirement)) {
+      problems.push(err(`${at}.requirement`, `Must be "required" or "optional".`));
+    }
+  });
+}
 function validateCapabilities(capabilities, problems) {
   if (capabilities === void 0) return;
   if (typeof capabilities !== "object" || capabilities === null || Array.isArray(capabilities)) {