@particle-academy/fancy-flow 0.32.0 → 0.33.1

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(", ")}.`));
   }
@@ -515,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)) {