webstudio 0.302.0 → 0.304.0

package/lib/cli.js

@@ -20,7 +20,7 @@ import fs, { rm, mkdtemp, writeFile, readFile, access, constants as constants$1,
 import { gzip } from "node:zlib";
 import { execFile, spawn } from "node:child_process";
 import { promisify, isDeepStrictEqual } from "node:util";
-import { readdirSync, constants as constants$2, createWriteStream, existsSync, realpathSync, readFileSync } from "node:fs";
+import { readdirSync, constants as constants$2, createWriteStream, existsSync, createReadStream, realpathSync, readFileSync } from "node:fs";
 import envPaths from "env-paths";
 import { randomUUID, createHash } from "node:crypto";
 import { text as text$d, isCancel, cancel, log, spinner, confirm, select as select$3 } from "@clack/prompts";
@@ -59876,12 +59876,29 @@ const diagnosticContext = {
   renderScope: string$5().min(1).optional(),
   sourceRange: contentBlockSourceRange.optional()
 };
+const invalidMdxDiagnosticReason = _enum([
+  // The MDX source was identified, but reading it from asset storage failed.
+  "source-read-failed",
+  // The MDX document exists, but its revision, content reference, or source text is unavailable.
+  "missing-source",
+  // No MDX document in the publication artifact matches the requested asset ID.
+  "missing-asset",
+  // A document referenced from MDX frontmatter could not be loaded or resolved.
+  "linked-document-unavailable",
+  // The rendered MDX violates HTML nesting rules, such as a link inside a link.
+  "html-content-model",
+  // Dynamic MDX contains Resources that cannot be selected safely for a Collection item or action.
+  "dynamic-resource",
+  // A dynamic source has no known candidates or exceeds the supported candidate limit.
+  "dynamic-source-unbounded"
+]);
 const contentBlockDiagnostic = discriminatedUnion("code", [
   strictObject({
     ...diagnosticContext,
     code: literal$2("invalid-mdx"),
     severity: literal$2("error"),
-    message: string$5().min(1)
+    message: string$5().min(1),
+    reason: invalidMdxDiagnosticReason.optional()
   }),
   strictObject({
     ...diagnosticContext,
@@ -63515,6 +63532,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -64093,6 +64122,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -64690,6 +64731,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -65253,6 +65306,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -65822,6 +65887,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -66373,6 +66450,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -66917,6 +67006,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -114137,6 +114238,18 @@ const runtimeOperationContractData = [
                   message: {
                     type: "string",
                     minLength: 1
+                  },
+                  reason: {
+                    type: "string",
+                    enum: [
+                      "source-read-failed",
+                      "missing-source",
+                      "missing-asset",
+                      "linked-document-unavailable",
+                      "html-content-model",
+                      "dynamic-resource",
+                      "dynamic-source-unbounded"
+                    ]
                   }
                 },
                 required: ["blockInstanceId", "code", "severity", "message"],
@@ -188102,29 +188215,41 @@ const findVariablesByInstanceId = ({
   }
   return { maskedIdByName, availableDataSourceIds };
 };
+const createFindAvailableVariables = ({
+  instances,
+  dataSources
+}) => {
+  const parentInstanceById = getParentInstanceById(instances);
+  const dataSourcesByScopeInstanceId = getDataSourcesByScopeInstanceId(dataSources);
+  return (startingInstanceId) => {
+    const { maskedIdByName } = findVariablesByInstanceId({
+      startingInstanceId,
+      parentInstanceById,
+      instances,
+      dataSources,
+      dataSourcesByScopeInstanceId
+    });
+    const availableVariables = [];
+    for (const dataSourceId2 of maskedIdByName.values()) {
+      const dataSource2 = dataSources.get(dataSourceId2);
+      if (dataSource2) {
+        availableVariables.push(dataSource2);
+      }
+      if (dataSourceId2 === SYSTEM_VARIABLE_ID) {
+        availableVariables.push(systemParameter);
+      }
+    }
+    return availableVariables;
+  };
+};
 const findAvailableVariables = ({
   startingInstanceId,
   instances,
   dataSources
 }) => {
-  const { maskedIdByName } = findVariablesByInstanceId({
-    startingInstanceId,
-    parentInstanceById: getParentInstanceById(instances),
-    instances,
-    dataSources,
-    dataSourcesByScopeInstanceId: getDataSourcesByScopeInstanceId(dataSources)
-  });
-  const availableVariables = [];
-  for (const dataSourceId2 of maskedIdByName.values()) {
-    const dataSource2 = dataSources.get(dataSourceId2);
-    if (dataSource2) {
-      availableVariables.push(dataSource2);
-    }
-    if (dataSourceId2 === SYSTEM_VARIABLE_ID) {
-      availableVariables.push(systemParameter);
-    }
-  }
-  return availableVariables;
+  return createFindAvailableVariables({ instances, dataSources })(
+    startingInstanceId
+  );
 };
 const bindExpressionToInstanceScope = ({
   expression: expression2,
@@ -193559,7 +193684,7 @@ const propsCollapsible = {
 const propsCollapsibleTrigger = {};
 const propsCollapsibleContent = {
   forceMount: {
-    description: "Used to force mounting when more control is needed. Useful when controlling animation with React animation libraries or keeping content available in the DOM.",
+    description: "When true, closed content stays mounted. Keep an explicit closed-state CSS rule such as height: 0; Radix's animation-only example assumes unmounted content. Radix suppresses CSS transitions and animations while measuring height, so the first open may not animate.",
     required: false,
     control: "boolean",
     type: "boolean"
@@ -194168,10 +194293,10 @@ const propsAccordionHeader = {};
 const propsAccordionTrigger = {};
 const propsAccordionContent = {
   forceMount: {
-    description: "Used to force mounting when more control is needed. Useful when controlling animation with React animation libraries or keeping content available in the DOM.",
     required: false,
     control: "boolean",
-    type: "boolean"
+    type: "boolean",
+    description: "When true, closed content stays mounted. Keep an explicit closed-state CSS rule such as height: 0; Radix's animation-only example assumes unmounted content. Radix suppresses CSS transitions and animations while measuring height, so the first open may not animate."
   }
 };
 const metaAccordion = {
@@ -278903,7 +279028,7 @@ const AccordionItem = reactExports.forwardRef(({ value: value2, ...props2 }, ref
 });
 const AccordionHeader = Header;
 const AccordionTrigger = Trigger2;
-const AccordionContent = Content2$1;
+const AccordionContent = reactExports.forwardRef(({ forceMount, ...props2 }, ref2) => /* @__PURE__ */ jsxRuntimeExports.jsx(Content2$1, { ref: ref2, forceMount: forceMount ? true : void 0, ...props2 }));
 const namespace$2 = "@webstudio-is/sdk-components-react-radix";
 const hooksAccordion = {
   onNavigatorSelect: (context, event) => {
@@ -286877,7 +287002,8 @@ const materializeMdxTemplates = async ({
   data: data2,
   metas,
   projectId,
-  assetReferences = []
+  assetReferences = [],
+  findAvailableVariables: sharedFindAvailableVariables
 }) => {
   const materializedTemplates = [];
   const diagnostics = [...resolution2.diagnostics];
@@ -286888,6 +287014,11 @@ const materializeMdxTemplates = async ({
       reference
     ])
   );
+  let findAvailableVariables2 = sharedFindAvailableVariables;
+  const getFindAvailableVariables = () => findAvailableVariables2 ??= createFindAvailableVariables({
+    instances: data2.instances,
+    dataSources: data2.dataSources
+  });
   for (const reference of resolution2.references) {
     if (reference.type === "unresolved-template") {
       materializedTemplates.push({
@@ -286934,11 +287065,9 @@ const materializeMdxTemplates = async ({
     const { newInstanceIds } = insertWebstudioFragmentCopy({
       data: materializedData,
       fragment: sourceFragment2,
-      availableVariables: findAvailableVariables({
-        startingInstanceId: reference.templateInstanceId,
-        instances: data2.instances,
-        dataSources: data2.dataSources
-      }),
+      availableVariables: getFindAvailableVariables()(
+        reference.templateInstanceId
+      ),
       projectId,
       createId: createId2
     });
@@ -323332,8 +323461,9 @@ const capabilityAreas = [
   },
   {
     area: "publish",
-    goal: "Publish, unpublish, inspect publish jobs, and manage domains.",
+    goal: "Validate and publish projects, inspect publish jobs, and manage domains.",
     tools: [
+      "validate-publish",
       "publish",
       "list-publishes",
       "get-publish-job",
@@ -327679,7 +327809,7 @@ const createContractVersion = (schema2, additionalSchemas = []) => {
     })
   )}`;
 };
-const maxProjectBundleSize = 20 * 1024 * 1024;
+const maxProjectBundleSize = 32 * 1024 * 1024;
 const stagedUploadPath = "/rest/staged-upload";
 const stagedUploadProjectIdHeader = "x-webstudio-project-id";
 const projectSessionRestorePointPath = "build.restorePoint";
@@ -329287,10 +329417,10 @@ const serverOnlyRouterOperationMetadata = {
   },
   "publish.validate": {
     id: "publish.validate",
-    command: "check-publish-readiness",
+    command: "validate-publish",
     method: "query",
     path: "api.publish.validate",
-    client: "checkPublishReadiness",
+    client: "validatePublish",
     permit: "edit",
     inputSchema: {
       type: "object",
@@ -330281,12 +330411,12 @@ const curatedPublicApiOperationDocumentation = [
     examples: ["webstudio delete-resource --resource resource-id --json"]
   },
   {
-    command: "check-publish-readiness",
-    description: "Check publish access, selected domains, and content diagnostics without starting a publish. Use audit for project-wide quality checks.",
+    command: "validate-publish",
+    description: "Validate publish access, selected domains, and content diagnostics without starting a publish. Use audit for project-wide quality checks.",
     requiredOptions: ["target", "json"],
     examples: [
-      "webstudio check-publish-readiness --target production --json",
-      'MCP tool: check-publish-readiness {"target":"production"}'
+      "webstudio validate-publish --target production --json",
+      'MCP tool: validate-publish {"target":"production"}'
     ]
   },
   {
@@ -332333,7 +332463,7 @@ const createResource = projectMutationInput("create-resource");
 const updateResource = projectMutationInput("update-resource");
 const deleteResource = projectMutationInput("delete-resource");
 const listPublishes = projectQueryInput("list-publishes");
-const checkPublishReadiness = projectQueryInput("check-publish-readiness");
+const validatePublish = projectQueryInput("validate-publish");
 const publish = projectMutationInput("publish");
 const getPublishJob = projectQueryInput("get-publish-job");
 const unpublish = projectConfirmedMutationInput("unpublish");
@@ -332498,7 +332628,6 @@ const httpClient = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePr
   bindProps,
   bundleVersion,
   checkProjectBuildPermission,
-  checkPublishReadiness,
   clearStyleSourceStyles,
   cloneInstance,
   connectContentBlockSource,
@@ -332682,6 +332811,7 @@ const httpClient = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePr
   upsertResource,
   upsertResourceProp,
   validateAssetQuery,
+  validatePublish,
   verifyBindings,
   verifyDomain,
   wrapInstance
@@ -332694,7 +332824,7 @@ class HandledCliError extends Error {
 }
 const isHandledCliError = (error) => error instanceof HandledCliError;
 const name = "webstudio";
-const version$1 = "0.302.0";
+const version$1 = "0.304.0";
 const description = "Webstudio CLI";
 const author = "Webstudio <github@webstudio.is>";
 const homepage = "https://webstudio.is";
@@ -333060,7 +333190,10 @@ const materializeManagedAgents = async ({
   await dependencies2.writeFileAtomic(path2, next);
   return { path: path2, status: current4 === void 0 ? "created" : "updated" };
 };
+const maxConcurrentMdxDependencyBlocks = 4;
+const maxConcurrentMdxDependenciesPerBlock = 8;
 const publishedMdxTotalBytes = 32 * 1024 * 1024;
+const getPublishedMdxAssetIds = (assets) => new Set(assets.filter(isMdxFileAsset).map(({ id: id2 }) => id2));
 const getPublishedMdxContentDatabaseMaxBytes = ({
   baseBytes,
   assets
@@ -333165,7 +333298,11 @@ const createPublishedBuildContentCompilationPlan = (build2, dynamicAssetIdsByBlo
 const resolvePublishedMdxDependencyClosureWithParser = async ({
   build: build2,
   artifact,
+  loadDocumentSource,
   onTemplateOmission,
+  onDependencyReadFailure,
+  onMdxBlockInstanceId,
+  allMdxAssetIds,
   parseDocument: parseDocument2
 }) => {
   const instances = new Map(
@@ -333203,60 +333340,102 @@ const resolvePublishedMdxDependencyClosureWithParser = async ({
     }
   };
   while (pending.length > 0) {
-    const blockId = pending.shift();
-    if (processed.has(blockId)) {
-      continue;
-    }
-    processed.add(blockId);
-    const source = sourcesByBlockId.get(blockId);
-    if (source === void 0) {
-      continue;
-    }
-    const staticValue = getStaticContentBlockSourceAssetId(source);
-    const assetIds = typeof staticValue === "string" ? [staticValue] : resolvePublishedMdxAssetCandidates({
-      build: build2,
-      artifact,
-      blockInstanceIds: /* @__PURE__ */ new Set([blockId])
-    }).get(blockId) ?? [];
-    for (const assetId2 of assetIds) {
-      const documentEntry = documentsById.get(assetId2);
-      const sourceText = documentEntry?.contentRef === void 0 ? void 0 : artifact.contents?.[documentEntry.contentRef];
-      if (documentEntry?.revision === void 0 || documentEntry.contentRef === void 0 || sourceText === void 0) {
-        continue;
-      }
-      const parsed = await parseDocument2({
-        assetId: assetId2,
-        revision: documentEntry.revision,
-        contentRef: documentEntry.contentRef,
-        source: sourceText
-      });
-      if (parsed.status === "unrecoverable") {
-        continue;
+    const blockIds = pending.splice(0);
+    const parsedDocumentsByBlock = await mapBounded(
+      blockIds,
+      maxConcurrentMdxDependencyBlocks,
+      async (blockId) => {
+        if (processed.has(blockId)) {
+          return { blockId, parsedDocuments: [] };
+        }
+        processed.add(blockId);
+        const source = sourcesByBlockId.get(blockId);
+        if (source === void 0) {
+          return { blockId, parsedDocuments: [] };
+        }
+        onMdxBlockInstanceId?.(blockId);
+        const staticValue = getStaticContentBlockSourceAssetId(source);
+        const assetIds = typeof staticValue === "string" ? [staticValue] : resolvePublishedMdxAssetCandidates({
+          build: build2,
+          artifact,
+          blockInstanceIds: /* @__PURE__ */ new Set([blockId]),
+          allMdxAssetIds
+        }).get(blockId) ?? [];
+        const parsedDocuments = await mapBounded(
+          assetIds,
+          maxConcurrentMdxDependenciesPerBlock,
+          async (assetId2) => {
+            const documentEntry = documentsById.get(assetId2);
+            if (documentEntry?.extension?.toLowerCase() !== "mdx" && documentEntry?.mimeType !== "text/mdx") {
+              return;
+            }
+            let sourceText = documentEntry.contentRef === void 0 ? void 0 : artifact.contents?.[documentEntry.contentRef];
+            if (sourceText === void 0 && documentEntry.revision !== void 0 && documentEntry.contentRef !== void 0 && loadDocumentSource !== void 0) {
+              try {
+                sourceText = await loadDocumentSource({
+                  id: assetId2,
+                  revision: documentEntry.revision,
+                  contentRef: documentEntry.contentRef
+                });
+              } catch (error) {
+                onDependencyReadFailure?.({
+                  blockInstanceId: blockId,
+                  assetId: assetId2,
+                  contentRef: documentEntry.contentRef,
+                  message: `Could not inspect this MDX source: ${error instanceof Error ? error.message : String(error)}`
+                });
+                return;
+              }
+            }
+            if (documentEntry.revision === void 0 || documentEntry.contentRef === void 0 || sourceText === void 0) {
+              return;
+            }
+            const parsed = await parseDocument2({
+              assetId: assetId2,
+              revision: documentEntry.revision,
+              contentRef: documentEntry.contentRef,
+              source: sourceText
+            });
+            return parsed.status === "unrecoverable" ? void 0 : { assetId: assetId2, documentEntry, document: parsed.document };
+          }
+        );
+        return {
+          blockId,
+          parsedDocuments: parsedDocuments.filter(
+            (document2) => document2 !== void 0
+          )
+        };
       }
-      const document2 = parsed.document;
-      const resolution2 = resolveMdxTemplates({
-        document: document2,
-        identity: {
-          blockInstanceId: blockId,
-          assetId: assetId2,
-          revision: documentEntry.revision,
-          contentRef: documentEntry.contentRef,
-          renderScope: "publication-dependency-discovery"
-        },
-        instances,
-        props: propsById,
-        metas: componentMetas
-      });
-      assertMdxTemplateStructure(resolution2);
-      for (const reference of resolution2.references) {
-        if (reference.type === "resolved-template") {
-          visitTemplateSubtree(reference.templateInstanceId);
-        } else {
-          onTemplateOmission?.({
+    );
+    for (const { blockId, parsedDocuments } of parsedDocumentsByBlock) {
+      for (const { assetId: assetId2, documentEntry, document: document2 } of parsedDocuments) {
+        if (documentEntry.revision === void 0 || documentEntry.contentRef === void 0) {
+          continue;
+        }
+        const resolution2 = resolveMdxTemplates({
+          document: document2,
+          identity: {
             blockInstanceId: blockId,
             assetId: assetId2,
-            templateName: reference.templateName
-          });
+            revision: documentEntry.revision,
+            contentRef: documentEntry.contentRef,
+            renderScope: "publication-dependency-discovery"
+          },
+          instances,
+          props: propsById,
+          metas: componentMetas
+        });
+        assertMdxTemplateStructure(resolution2);
+        for (const reference of resolution2.references) {
+          if (reference.type === "resolved-template") {
+            visitTemplateSubtree(reference.templateInstanceId);
+          } else {
+            onTemplateOmission?.({
+              blockInstanceId: blockId,
+              assetId: assetId2,
+              templateName: reference.templateName
+            });
+          }
         }
       }
     }
@@ -333265,7 +333444,8 @@ const resolvePublishedMdxDependencyClosureWithParser = async ({
     build: build2,
     artifact,
     blockInstanceIds: reachableIds,
-    allowUnresolved: true
+    allowUnresolved: true,
+    allMdxAssetIds
   });
   return createPublishedBuildContentCompilationPlan(
     build2,
@@ -333290,8 +333470,11 @@ const createPublishedMdxDependencyClosureResolver = (dependencies2 = { parseMdxD
 };
 const candidateDocumentKey = Symbol("candidate-document");
 const isCandidateDocument = (value2) => typeof value2 === "object" && value2 !== null && candidateDocumentKey in value2;
-const getValueAtPath = (value2, path2) => {
+const getValueAtPath = (value2, path2, knownNonMdxAssetIds) => {
   if (isCandidateDocument(value2)) {
+    if (knownNonMdxAssetIds?.has(value2[candidateDocumentKey]._id) && (path2.length === 0 || path2.length === 1 && (path2[0] === "id" || path2[0] === "_id"))) {
+      return;
+    }
     if (path2[0] === "properties" && value2.graph !== void 0 && isDocumentGraphFieldAffected({
       graph: value2.graph,
       sourceId: value2[candidateDocumentKey]._id,
@@ -333316,7 +333499,9 @@ const resolvePublishedMdxAssetCandidates = ({
   build: build2,
   artifact,
   allowUnresolved = false,
-  blockInstanceIds = getPublishedInstanceIds(build2)
+  blockInstanceIds = getPublishedInstanceIds(build2),
+  allAssetIds,
+  allMdxAssetIds
 }) => {
   const instances = new Map(
     getBuildValues(build2.instances).map((instance2) => [
@@ -333343,7 +333528,10 @@ const resolvePublishedMdxAssetCandidates = ({
   );
   const documentGraph = artifact?.documentGraph === void 0 ? void 0 : createDocumentGraph(artifact.documentGraph);
   const documents = artifact?.documents ?? [];
-  const evaluateDataSource = (dataSourceId2, path2, visiting = /* @__PURE__ */ new Set()) => {
+  const knownNonMdxAssetIds = allAssetIds === void 0 || allMdxAssetIds === void 0 ? void 0 : new Set(
+    [...allAssetIds].filter((assetId2) => !allMdxAssetIds.has(assetId2))
+  );
+  const evaluateDataSource = (dataSourceId2, path2, visiting = /* @__PURE__ */ new Set(), mutableVariables = /* @__PURE__ */ new Set()) => {
     if (visiting.has(dataSourceId2)) {
       throw new Error("Dynamic MDX source data dependency is cyclic");
     }
@@ -333352,6 +333540,7 @@ const resolvePublishedMdxAssetCandidates = ({
       return [];
     }
     if (dataSource2.type === "variable") {
+      mutableVariables.add(dataSourceId2);
       return [];
     }
     if (dataSource2.type === "resource") {
@@ -333404,7 +333593,8 @@ const resolvePublishedMdxAssetCandidates = ({
           graph: documentGraph
         } : getValueAtPath(
           { [candidateDocumentKey]: document2, graph: documentGraph },
-          fieldPath
+          fieldPath,
+          knownNonMdxAssetIds
         )
       );
     }
@@ -333430,7 +333620,8 @@ const resolvePublishedMdxAssetCandidates = ({
         iterables = evaluateDataSource(
           dependencyId,
           dataPath.slice(1),
-          visiting
+          visiting,
+          mutableVariables
         );
         visiting.delete(dataSourceId2);
       }
@@ -333444,7 +333635,7 @@ const resolvePublishedMdxAssetCandidates = ({
       }
       return [iterable];
     });
-    return items.map((item) => getValueAtPath(item, path2));
+    return items.map((item) => getValueAtPath(item, path2, knownNonMdxAssetIds));
   };
   const candidatesByBlock = /* @__PURE__ */ new Map();
   for (const blockInstanceId of blockInstanceIds) {
@@ -333461,8 +333652,14 @@ const resolvePublishedMdxAssetCandidates = ({
     const path2 = parseStaticMemberPath(source.value);
     const dataSourceId2 = path2 === void 0 ? void 0 : decodeDataVariableId(path2[0]);
     let assetIds = [];
+    const mutableVariables = /* @__PURE__ */ new Set();
     try {
-      assetIds = dataSourceId2 === void 0 || path2 === void 0 ? [] : evaluateDataSource(dataSourceId2, path2.slice(1)).filter(
+      assetIds = dataSourceId2 === void 0 || path2 === void 0 ? [] : evaluateDataSource(
+        dataSourceId2,
+        path2.slice(1),
+        /* @__PURE__ */ new Set(),
+        mutableVariables
+      ).filter(
         (value2) => typeof value2 === "string" && value2.length > 0
       );
     } catch (error) {
@@ -333470,6 +333667,9 @@ const resolvePublishedMdxAssetCandidates = ({
         throw error;
       }
     }
+    if (mutableVariables.size > 0 && allMdxAssetIds !== void 0) {
+      assetIds.push(...allMdxAssetIds);
+    }
     if (assetIds.length === 0) {
       if (allowUnresolved) {
         continue;
@@ -333845,10 +334045,12 @@ const sync = async (options, dependencies2 = defaultSyncDependencies) => {
     ...project.build,
     pages: migratePages(project.build.pages)
   };
+  const allMdxAssetIds = getPublishedMdxAssetIds(project.assets);
   const projectCandidates = resolvePublishedMdxAssetCandidates({
     build: publicationBuild,
     artifact: project.assetIndex,
-    allowUnresolved: true
+    allowUnresolved: true,
+    allMdxAssetIds
   });
   const dynamicBlockIds = getDynamicPublishedMdxSourceBlockIds(publicationBuild);
   const publicationPlan = createPublishedBuildContentCompilationPlan(
@@ -333908,7 +334110,11 @@ const sync = async (options, dependencies2 = defaultSyncDependencies) => {
         project.assetIndex = await compileContentUntilPlanIsStable({
           plan,
           compile,
-          resolvePlan: async (artifact) => await resolvePlan({ build: publicationBuild, artifact })
+          resolvePlan: async (artifact) => await resolvePlan({
+            build: publicationBuild,
+            artifact,
+            allMdxAssetIds
+          })
         });
       } else {
         project.assetIndex = await compile(plan);
@@ -340049,6 +340255,7 @@ const createMdxContentModelDiagnostics = ({
       {
         code: "invalid-mdx",
         severity: "error",
+        reason: "html-content-model",
         blockInstanceId: root2.identity.blockInstanceId,
         assetId: root2.identity.assetId,
         contentRef: root2.identity.contentRef,
@@ -340619,6 +340826,7 @@ const getUnsafeDynamicPublishedMdxDiagnostic = ({
     return {
       code: "invalid-mdx",
       severity: "error",
+      reason: "dynamic-resource",
       blockInstanceId: root2.identity.blockInstanceId,
       assetId: root2.identity.assetId,
       renderScope: `route:${route}:block:${root2.identity.blockInstanceId}`,
@@ -340634,6 +340842,7 @@ const getUnsafeDynamicPublishedMdxDiagnostic = ({
     return {
       code: "invalid-mdx",
       severity: "error",
+      reason: "dynamic-resource",
       blockInstanceId: root2.identity.blockInstanceId,
       assetId: root2.identity.assetId,
       renderScope: `route:${route}:block:${root2.identity.blockInstanceId}`,
@@ -340698,7 +340907,8 @@ const materializePublishedMdx = async ({
   cache = createPublishedMdxMaterializationCache(),
   dynamicAssetIdsByBlock = /* @__PURE__ */ new Map(),
   blockInstanceIds,
-  runtimeAssets: providedRuntimeAssets
+  runtimeAssets: providedRuntimeAssets,
+  loadDocumentSource
 }) => {
   const documentsById = new Map(
     artifact.documents.map((document2) => [document2._id, document2])
@@ -340726,7 +340936,7 @@ const materializePublishedMdx = async ({
           assetValueReferences: artifact.assetValueReferences,
           runtimeAssets,
           load: async (node2) => {
-            const source = artifact.contents?.[node2.contentRef];
+            const source = artifact.contents?.[node2.contentRef] ?? await loadDocumentSource?.(node2);
             if (source === void 0 || node2.format === void 0) {
               throw new Error(`Published document ${node2.id} is unavailable`);
             }
@@ -340753,9 +340963,11 @@ const materializePublishedMdx = async ({
   });
   const roots = [];
   const warnings = [];
+  let findAvailableVariables2;
   const warnUnavailableSource = ({
     blockInstanceId,
     assetId: assetId2,
+    reason,
     message
   }) => {
     warnings.push({
@@ -340763,6 +340975,7 @@ const materializePublishedMdx = async ({
       diagnostic: {
         code: "invalid-mdx",
         severity: "error",
+        ...reason === void 0 ? {} : { reason },
         blockInstanceId,
         ...assetId2 === void 0 ? {} : { assetId: assetId2 },
         renderScope: `route:${route}:block:${blockInstanceId}`,
@@ -340784,6 +340997,7 @@ const materializePublishedMdx = async ({
     if (resolvedAssetIds.length > contentEngineLimits.candidateDocuments) {
       warnUnavailableSource({
         blockInstanceId: block.id,
+        reason: "dynamic-source-unbounded",
         message: `Published Content Block "${block.id}" exceeds the safe MDX candidate limit`
       });
       continue;
@@ -340791,6 +341005,7 @@ const materializePublishedMdx = async ({
     if (resolvedAssetIds.length === 0) {
       warnUnavailableSource({
         blockInstanceId: block.id,
+        reason: "dynamic-source-unbounded",
         message: `Published Content Block "${block.id}" has no bounded dynamic MDX dependency set`
       });
       continue;
@@ -340806,6 +341021,7 @@ const materializePublishedMdx = async ({
       warnUnavailableSource({
         blockInstanceId: block.id,
         assetId: assetId2,
+        reason: "missing-asset",
         message: `Published Content Block "${block.id}" requires unavailable MDX Asset "${assetId2}"`
       });
     }
@@ -340814,15 +341030,34 @@ const materializePublishedMdx = async ({
         warnUnavailableSource({
           blockInstanceId: block.id,
           assetId: candidate._id,
+          reason: "missing-source",
           message: `Published MDX Asset "${candidate._id}" has no revision identity`
         });
         continue;
       }
-      const sourceText = artifact.contents?.[candidate.contentRef];
+      let sourceText = artifact.contents?.[candidate.contentRef];
+      if (sourceText === void 0 && loadDocumentSource !== void 0) {
+        try {
+          sourceText = await loadDocumentSource({
+            id: candidate._id,
+            revision: candidate.revision,
+            contentRef: candidate.contentRef
+          });
+        } catch (error) {
+          warnUnavailableSource({
+            blockInstanceId: block.id,
+            assetId: candidate._id,
+            reason: "source-read-failed",
+            message: `Published MDX Asset "${candidate._id}" could not be loaded: ${error instanceof Error ? error.message : String(error)}`
+          });
+          continue;
+        }
+      }
       if (sourceText === void 0) {
         warnUnavailableSource({
           blockInstanceId: block.id,
           assetId: candidate._id,
+          reason: "missing-source",
           message: `Published MDX Asset "${candidate._id}" content is unavailable`
         });
         continue;
@@ -340868,19 +341103,49 @@ const materializePublishedMdx = async ({
         metas
       });
       assertMdxTemplateStructure(resolution2);
+      if (findAvailableVariables2 === void 0 && resolution2.references.some(
+        (reference) => reference.type === "resolved-template"
+      )) {
+        findAvailableVariables2 = createFindAvailableVariables({
+          instances: data2.instances,
+          dataSources: data2.dataSources
+        });
+      }
       const templates2 = await materializeMdxTemplates({
         identity,
         resolution: resolution2,
         data: data2,
         metas,
         projectId,
-        assetReferences
+        assetReferences,
+        findAvailableVariables: findAvailableVariables2
       });
       const referencedTemplateNames = Array.from(
         new Set(
           resolution2.references.map((reference) => reference.templateName)
         )
       );
+      let resolvedFrontmatter = document2.frontmatter.properties;
+      try {
+        resolvedFrontmatter = await resolveFrontmatter(candidate._id, document2);
+      } catch (error) {
+        if (error instanceof DocumentGraphResolutionError && error.code === "REQUEST_CANCELLED") {
+          throw error;
+        }
+        if (error instanceof DocumentGraphResolutionError) {
+          const linkedDocument = error.documentId === void 0 ? "Linked document" : `Linked document "${error.documentId}"`;
+          const reference = error.referenceId === void 0 ? "" : ` (reference "${error.referenceId}")`;
+          const failure = error.code === "DOCUMENT_LOAD_FAILED" ? "could not be loaded" : `could not be resolved: ${error.message}`;
+          warnUnavailableSource({
+            blockInstanceId: block.id,
+            assetId: candidate._id,
+            reason: "linked-document-unavailable",
+            message: `${linkedDocument} ${failure}${reference} while resolving frontmatter for published MDX Asset "${candidate._id}".`
+          });
+        } else {
+          throw error;
+        }
+      }
       const materialized = materializeMdxAuthoredContent({
         identity,
         document: document2,
@@ -340913,7 +341178,7 @@ const materializePublishedMdx = async ({
         dynamic: isDynamicSource,
         identity,
         document: document2,
-        resolvedFrontmatter: await resolveFrontmatter(candidate._id, document2),
+        resolvedFrontmatter,
         fragment: materialized.fragment,
         templateDependencies: templates2.dependencies.templates,
         templateNames: referencedTemplateNames,
@@ -346980,6 +347245,8 @@ Please check webstudio --help for more details`
   const siteData = parsedSiteData.data;
   const pages2 = migratePages(siteData.build.pages);
   const publicationBuild = { ...siteData.build, pages: pages2 };
+  const allAssetIds = new Set(siteData.assets.map(({ id: id2 }) => id2));
+  const allMdxAssetIds = getPublishedMdxAssetIds(siteData.assets);
   if (siteData.assetIndex === void 0 && (createPublishedBuildContentCompilationPlan(publicationBuild) !== void 0 || hasDynamicPublishedMdxSources(publicationBuild))) {
     throw new Error(
       "Assets queries require a content database. Sync the project again before building."
@@ -347036,10 +347303,12 @@ Please check webstudio --help for more details`
   }
   let dynamicMdxCandidates;
   if (hasDynamicPublishedMdxSources(publicationBuild)) {
-    dynamicMdxCandidates = verifiedAssetIndex === void 0 ? /* @__PURE__ */ new Map() : resolvePublishedMdxAssetCandidates({
+    dynamicMdxCandidates = resolvePublishedMdxAssetCandidates({
       build: publicationBuild,
       artifact: verifiedAssetIndex,
-      allowUnresolved: true
+      allowUnresolved: true,
+      allAssetIds,
+      allMdxAssetIds
     });
     for (const blockInstanceId of getDynamicPublishedMdxSourceBlockIds(
       publicationBuild
@@ -347273,7 +347542,9 @@ Please check webstudio --help for more details`
         ) ? resolvePublishedMdxAssetCandidates({
           build: pageBuild,
           artifact: verifiedAssetIndex,
-          blockInstanceIds: pendingBlockIds
+          blockInstanceIds: pendingBlockIds,
+          allAssetIds,
+          allMdxAssetIds
         }) : void 0;
         const materialized = await materializePublishedMdx({
           route,
@@ -347294,7 +347565,21 @@ Please check webstudio --help for more details`
           cache,
           dynamicAssetIdsByBlock: pageDynamicCandidates,
           blockInstanceIds: pendingBlockIds,
-          runtimeAssets: runtimeAssetsById
+          runtimeAssets: runtimeAssetsById,
+          loadDocumentSource: async ({ contentRef }) => {
+            const source = createReadStream(
+              getLocalAssetPath(
+                contentRef,
+                options.sourceAssetsDirectory ?? join$2(buildRoot, LOCAL_ASSETS_DIR)
+              )
+            );
+            return decodeUtf8$1(
+              await readBoundedBytes(
+                source,
+                contentEngineLimits.hydratedFileBytes
+              )
+            );
+          }
         });
         for (const root2 of materialized.roots) {
           const diagnostic = getUnsafeDynamicPublishedMdxDiagnostic({
@@ -350363,7 +350648,7 @@ const publishCommandOptions = (yargs) => publishDomainsOption(publishTargetOptio
   type: "string",
   describe: "Optional idempotency key for retrying the same publish"
 });
-const checkPublishReadinessCommandOptions = (yargs) => publishDomainsOption(publishTargetOption(apiCommandOptions(yargs)));
+const validatePublishCommandOptions = (yargs) => publishDomainsOption(publishTargetOption(apiCommandOptions(yargs)));
 const publishJobCommandOptions = (yargs) => apiCommandOptions(yargs).option("job", {
   type: "string",
   describe: "Required publish job id returned by publish or unpublish",
@@ -351803,13 +352088,13 @@ const apiCommandHandlers = {
     };
     return runProjectSessionCommand("publish", input2, connection, dependencies2);
   },
-  "check-publish-readiness": async (options, connection, dependencies2) => {
+  "validate-publish": async (options, connection, dependencies2) => {
     const input2 = {
       target: publishTargetValue(options.target),
       domains: listStringOption(options.domain)
     };
     return runProjectSessionCommand(
-      "check-publish-readiness",
+      "validate-publish",
       input2,
       connection,
       dependencies2
@@ -352266,7 +352551,7 @@ const apiCommandOptionsByCommand = {
   "delete-resource": deleteResourceCommandOptions,
   "list-domains": paginatedListCommandOptions,
   publish: publishCommandOptions,
-  "check-publish-readiness": checkPublishReadinessCommandOptions,
+  "validate-publish": validatePublishCommandOptions,
   "get-publish-job": publishJobCommandOptions,
   unpublish: unpublishCommandOptions,
   "create-domain": createDomainCommandOptions,
@@ -352299,8 +352584,8 @@ const apiCommandMetadata = publicApiOperations.map((operation) => ({
 const highLevelCliCommands = [
   { command: "audit", operation: "audit" },
   {
-    command: "check-publish-readiness",
-    operation: "check-publish-readiness"
+    command: "validate-publish",
+    operation: "validate-publish"
   },
   { command: "permissions", operation: "permissions" },
   { command: "get-assets-resource", operation: "get-assets-resource" },
@@ -352854,7 +353139,7 @@ const apiCommandsByArea = {
   projectQuality: cliCommandMetadata.filter(({ cliCommand }) => cliCommand === "audit").map(({ cliCommand }) => cliCommand),
   assetsAndIndexes: cliCommandMetadata.filter(({ cliCommand }) => cliCommand.includes("asset")).map(({ cliCommand }) => cliCommand),
   publishAndDomains: cliCommandMetadata.filter(
-    ({ cliCommand }) => cliCommand === "check-publish-readiness" || cliCommand.startsWith("publish ") || cliCommand.startsWith("domains ")
+    ({ cliCommand }) => cliCommand === "validate-publish" || cliCommand.startsWith("publish ") || cliCommand.startsWith("domains ")
   ).map(({ cliCommand }) => cliCommand),
   pagesAndSettings: cliCommandMetadata.filter(
     ({ cliCommand }) => [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webstudio",
-  "version": "0.302.0",
+  "version": "0.304.0",
   "description": "Webstudio CLI",
   "author": "Webstudio <github@webstudio.is>",
   "homepage": "https://webstudio.is",
@@ -53,10 +53,10 @@
     "which": "^5.0.0",
     "yargs": "^17.7.2",
     "zod": "^4.4.3",
-    "@webstudio-is/http-client": "0.302.0",
-    "@webstudio-is/project-migrations": "0.302.0",
-    "@webstudio-is/protocol": "0.302.0",
-    "@webstudio-is/sync-client": "0.0.0"
+    "@webstudio-is/http-client": "0.304.0",
+    "@webstudio-is/project-migrations": "0.304.0",
+    "@webstudio-is/sync-client": "0.0.0",
+    "@webstudio-is/protocol": "0.304.0"
   },
   "devDependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
@@ -99,24 +99,24 @@
     "vite": "^6.3.4",
     "vitest": "^3.1.2",
     "wrangler": "4.130.0",
-    "@webstudio-is/css-engine": "0.302.0",
-    "@webstudio-is/content-engine": "0.302.0",
-    "@webstudio-is/fonts": "0.302.0",
-    "@webstudio-is/expression": "0.302.0",
-    "@webstudio-is/image": "0.302.0",
+    "@webstudio-is/css-engine": "0.304.0",
+    "@webstudio-is/expression": "0.304.0",
+    "@webstudio-is/content-engine": "0.304.0",
+    "@webstudio-is/fonts": "0.304.0",
+    "@webstudio-is/image": "0.304.0",
     "@webstudio-is/project-build": "0.0.0",
-    "@webstudio-is/query-builder": "0.302.0",
-    "@webstudio-is/react-sdk": "0.302.0",
-    "@webstudio-is/sdk-components-animation": "0.302.0",
-    "@webstudio-is/sdk": "0.302.0",
-    "@webstudio-is/sdk-components-react": "0.302.0",
-    "@webstudio-is/sdk-components-react-remix": "0.302.0",
-    "@webstudio-is/sdk-components-react-radix": "0.302.0",
-    "@webstudio-is/sdk-components-react-router": "0.302.0",
-    "@webstudio-is/sdk-components-registry": "0.302.0",
-    "@webstudio-is/tsconfig": "1.0.7",
+    "@webstudio-is/query-builder": "0.304.0",
+    "@webstudio-is/sdk-components-react-radix": "0.304.0",
+    "@webstudio-is/sdk-components-react-remix": "0.304.0",
+    "@webstudio-is/sdk-components-react": "0.304.0",
+    "@webstudio-is/sdk-components-react-router": "0.304.0",
     "@webstudio-is/vision": "0.0.0",
-    "@webstudio-is/wsauth": "0.302.0"
+    "@webstudio-is/sdk-components-animation": "0.304.0",
+    "@webstudio-is/sdk-components-registry": "0.304.0",
+    "@webstudio-is/tsconfig": "1.0.7",
+    "@webstudio-is/react-sdk": "0.304.0",
+    "@webstudio-is/sdk": "0.304.0",
+    "@webstudio-is/wsauth": "0.304.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/templates/cloudflare/package.json

@@ -12,7 +12,7 @@
     "build-cf-types": "wrangler types"
   },
   "dependencies": {
-    "@webstudio-is/wsauth": "0.302.0",
+    "@webstudio-is/wsauth": "0.304.0",
     "@remix-run/cloudflare": "2.16.5",
     "@remix-run/cloudflare-pages": "2.16.5"
   },

package/templates/defaults/package.json

@@ -13,14 +13,14 @@
     "@remix-run/node": "2.16.5",
     "@remix-run/react": "2.16.5",
     "@remix-run/server-runtime": "2.16.5",
-    "@webstudio-is/image": "0.302.0",
-    "@webstudio-is/react-sdk": "0.302.0",
-    "@webstudio-is/sdk": "0.302.0",
-    "@webstudio-is/sdk-components-react": "0.302.0",
-    "@webstudio-is/sdk-components-animation": "0.302.0",
-    "@webstudio-is/sdk-components-react-radix": "0.302.0",
-    "@webstudio-is/sdk-components-react-remix": "0.302.0",
-    "@webstudio-is/wsauth": "0.302.0",
+    "@webstudio-is/image": "0.304.0",
+    "@webstudio-is/react-sdk": "0.304.0",
+    "@webstudio-is/sdk": "0.304.0",
+    "@webstudio-is/sdk-components-react": "0.304.0",
+    "@webstudio-is/sdk-components-animation": "0.304.0",
+    "@webstudio-is/sdk-components-react-radix": "0.304.0",
+    "@webstudio-is/sdk-components-react-remix": "0.304.0",
+    "@webstudio-is/wsauth": "0.304.0",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",

package/templates/react-router/package.json

@@ -15,14 +15,14 @@
     "@react-router/fs-routes": "^7.5.3",
     "@react-router/node": "^7.5.3",
     "@react-router/serve": "^7.5.3",
-    "@webstudio-is/image": "0.302.0",
-    "@webstudio-is/react-sdk": "0.302.0",
-    "@webstudio-is/sdk": "0.302.0",
-    "@webstudio-is/sdk-components-animation": "0.302.0",
-    "@webstudio-is/sdk-components-react-radix": "0.302.0",
-    "@webstudio-is/sdk-components-react-router": "0.302.0",
-    "@webstudio-is/sdk-components-react": "0.302.0",
-    "@webstudio-is/wsauth": "0.302.0",
+    "@webstudio-is/image": "0.304.0",
+    "@webstudio-is/react-sdk": "0.304.0",
+    "@webstudio-is/sdk": "0.304.0",
+    "@webstudio-is/sdk-components-animation": "0.304.0",
+    "@webstudio-is/sdk-components-react-radix": "0.304.0",
+    "@webstudio-is/sdk-components-react-router": "0.304.0",
+    "@webstudio-is/sdk-components-react": "0.304.0",
+    "@webstudio-is/wsauth": "0.304.0",
     "isbot": "^5.1.25",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",

package/templates/react-router-cloudflare/package.json

@@ -7,7 +7,7 @@
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "^1.1.0",
-    "@webstudio-is/wsauth": "0.302.0",
+    "@webstudio-is/wsauth": "0.304.0",
     "wrangler": "^4.14.1"
   }
 }

package/templates/ssg/package.json

@@ -11,12 +11,12 @@
   "dependencies": {
     "@shikijs/langs": "4.4.1",
     "@shikijs/themes": "4.4.1",
-    "@webstudio-is/image": "0.302.0",
-    "@webstudio-is/react-sdk": "0.302.0",
-    "@webstudio-is/sdk": "0.302.0",
-    "@webstudio-is/sdk-components-react": "0.302.0",
-    "@webstudio-is/sdk-components-animation": "0.302.0",
-    "@webstudio-is/sdk-components-react-radix": "0.302.0",
+    "@webstudio-is/image": "0.304.0",
+    "@webstudio-is/react-sdk": "0.304.0",
+    "@webstudio-is/sdk": "0.304.0",
+    "@webstudio-is/sdk-components-react": "0.304.0",
+    "@webstudio-is/sdk-components-animation": "0.304.0",
+    "@webstudio-is/sdk-components-react-radix": "0.304.0",
     "react": "18.3.0-canary-14898b6a9-20240318",
     "react-dom": "18.3.0-canary-14898b6a9-20240318",
     "shiki": "4.4.1",