@cmssy/cli 19.2.0 → 19.3.1

package/dist/index.js

@@ -1416,6 +1416,36 @@ import { basename, join as join7, resolve as resolve3 } from "path";
 import { pathToFileURL } from "url";
 import { build } from "esbuild";
 var RUNTIME_ONLY_MODULES = ["server-only", "client-only"];
+var FRAMEWORK_MODULES = /^(next(\/.*)?|astro:.*)$/;
+var FRAMEWORK_STUB = `
+function serve(prop) {
+  if (prop === "__esModule" || prop === "__cmssyFrameworkStub") return true;
+  if (prop === Symbol.toPrimitive) return () => "";
+  if (prop === Symbol.iterator) return () => [][Symbol.iterator]();
+  if (typeof prop === "symbol" || prop === "then") return undefined;
+  return stub;
+}
+const names = new Proxy({}, {
+  get(target, prop) {
+    return serve(prop);
+  },
+});
+const stub = new Proxy(function Stub() {}, {
+  get(target, prop) {
+    return serve(prop);
+  },
+  getPrototypeOf() {
+    return names;
+  },
+  apply() {
+    return stub;
+  },
+  construct() {
+    return stub;
+  },
+});
+module.exports = stub;
+`;
 var ASSET_EXTENSIONS = [
   ".module.css",
   ".module.scss",
@@ -1441,7 +1471,8 @@ var ASSET_EXTENSIONS = [
   ".webm",
   ".mp3",
   ".md",
-  ".mdx"
+  ".mdx",
+  ".astro"
 ];
 var assetLoaders = Object.fromEntries(
   ASSET_EXTENSIONS.map((extension) => [extension, "empty"])
@@ -1460,6 +1491,19 @@ var runtimeOnlyModules = {
     }));
   }
 };
+var frameworkModules = {
+  name: "cmssy-framework-modules",
+  setup(api) {
+    api.onResolve({ filter: FRAMEWORK_MODULES }, (args) => ({
+      path: args.path,
+      namespace: "cmssy-framework-stub"
+    }));
+    api.onLoad({ filter: /.*/, namespace: "cmssy-framework-stub" }, () => ({
+      contents: FRAMEWORK_STUB,
+      loader: "js"
+    }));
+  }
+};
 async function loadSiteModule(cwd, entry) {
   const entryPath = resolve3(cwd, entry);
   let code;
@@ -1476,7 +1520,7 @@ async function loadSiteModule(cwd, entry) {
       jsx: "automatic",
       loader: assetLoaders,
       define: { "import.meta.env": "process.env" },
-      plugins: [runtimeOnlyModules],
+      plugins: [runtimeOnlyModules, frameworkModules],
       logLevel: "silent"
     });
     code = result.outputFiles[0]?.text ?? "";
@@ -1503,14 +1547,35 @@ async function loadSiteModule(cwd, entry) {
   try {
     return await import(pathToFileURL(file).href);
   } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    const code2 = error?.code;
+    const fromFramework = (code2 === "ERR_PACKAGE_PATH_NOT_EXPORTED" || code2 === "ERR_MODULE_NOT_FOUND") && /node_modules\/(next|astro)\/|'(next|astro)[/:']/.test(detail);
     throw new CliError(
       `could not load ${entry}`,
-      error instanceof Error ? error.message : String(error)
+      fromFramework ? `${detail}
+  a package imported by ${entry} loads a framework module at import time - cmssy stubs framework imports in your own files, not inside node_modules; import that package from app code instead of the files the manifest reads` : detail
     );
   } finally {
     rmSync(file, { force: true });
   }
 }
+function findFrameworkStubValues(value, path = "") {
+  if (value === null || typeof value !== "object" && typeof value !== "function") {
+    return [];
+  }
+  if (value.__cmssyFrameworkStub === true) {
+    return [path || "<root>"];
+  }
+  if (typeof value === "function") return [];
+  if (Array.isArray(value)) {
+    return value.flatMap(
+      (item, index) => findFrameworkStubValues(item, `${path}[${index}]`)
+    );
+  }
+  return Object.entries(value).flatMap(
+    ([key, item]) => findFrameworkStubValues(item, path ? `${path}.${key}` : key)
+  );
+}
 
 // src/sync-manifest.ts
 var BLOCKS_CANDIDATES = [
@@ -1723,6 +1788,13 @@ async function collectManifest(options, deps) {
     category,
     regions: config.layout?.regions
   });
+  const stubbedPaths = findFrameworkStubValues(manifest);
+  if (stubbedPaths.length > 0) {
+    throw new CliError(
+      `${blocksPath} feeds framework values into the manifest`,
+      `these entries hold a stubbed next/astro value and would be saved empty: ${stubbedPaths.join(", ")} - the manifest is read without the framework, so compute such values in the component, not in the block schema`
+    );
+  }
   return {
     manifest,
     blocksPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/cli",
-  "version": "19.2.0",
+  "version": "19.3.1",
   "description": "The cmssy CLI: `cmssy init` wires cmssy into an existing Next.js, Astro or React Router app; `cmssy link` connects it to a workspace and verifies the editor wiring.",
   "keywords": [
     "cmssy",
@@ -28,7 +28,7 @@
   ],
   "dependencies": {
     "esbuild": "^0.27.7",
-    "@cmssy/core": "19.2.0"
+    "@cmssy/core": "19.3.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",