@agent-native/core 0.109.1 → 0.109.2

package/corpus/templates/clips/desktop/src/lib/recorder.ts

@@ -78,6 +78,7 @@ import {
   createPauseTransitionQueue,
   type PauseTransitionQueue,
 } from "./pause-transition";
+import { reconcileProcessingBackup } from "./processing-backup-recovery";
 import { buildCaptureTitle, type CaptureTitleResult } from "./recording-title";
 import { singleFlight } from "./single-flight";
 import {
@@ -86,6 +87,7 @@ import {
   type TranscriptionCapture,
 } from "./transcription-capture";
 import {
+  parseFinalizeReceipt,
   verifyFinalizeReceipt,
   type FinalizeReceipt,
 } from "./upload-verification";
@@ -744,6 +746,7 @@ export async function dismissBrowserRecordingBackup(
 async function markBrowserRecordingBackupError(
   recordingId: string,
   error: string,
+  incrementRetryCount = true,
 ): Promise<void> {
   const meta = await getBrowserRecordingBackupMeta(recordingId);
   if (!meta) return;
@@ -751,7 +754,26 @@ async function markBrowserRecordingBackupError(
     ...meta,
     lastAttemptAt: new Date().toISOString(),
     lastError: error,
-    retryCount: meta.retryCount + 1,
+    retryCount: incrementRetryCount ? meta.retryCount + 1 : meta.retryCount,
+  });
+}
+
+const MEDIA_VERIFICATION_BACKUP_ERROR =
+  "The server could not finish verifying this upload. The local copy is still saved; retry to continue.";
+
+async function flagBrowserBackupAfterProcessing(recordingId: string) {
+  await markBrowserRecordingBackupError(
+    recordingId,
+    MEDIA_VERIFICATION_BACKUP_ERROR,
+    false,
+  );
+  await emit("clips:pending-uploads-changed").catch(() => {});
+}
+
+async function flagNativeBackupAfterProcessing(recordingId: string) {
+  await invoke("native_fullscreen_recording_mark_upload_error", {
+    recordingId,
+    error: MEDIA_VERIFICATION_BACKUP_ERROR,
   });
 }
 
@@ -760,24 +782,26 @@ function scheduleBrowserBackupCleanupAfterProcessing(args: {
   recordingId: string;
   authToken?: string;
 }): void {
-  void waitForReadyRecordingAfterFinalizeError({
-    uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
-    recordingId: args.recordingId,
-    authToken: args.authToken,
-    preferAuthenticated: true,
-    timeoutMs: 12 * 60 * 1000,
-  })
-    .then((recovered) => {
-      if (recovered?.status === "ready") {
-        return deleteBrowserRecordingBackup(args.recordingId);
-      }
-    })
-    .catch((err) => {
+  void reconcileProcessingBackup({
+    waitForReady: () =>
+      waitForReadyRecordingAfterFinalizeError({
+        uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
+        recordingId: args.recordingId,
+        authToken: args.authToken,
+        preferAuthenticated: true,
+        timeoutMs: 12 * 60 * 1000,
+      }),
+    onReady: () => deleteBrowserRecordingBackup(args.recordingId),
+    onUnresolved: () => flagBrowserBackupAfterProcessing(args.recordingId),
+    onPollError: (err) => {
       console.warn(
         "[clips-recorder] background backup cleanup check failed:",
         err,
       );
-    });
+    },
+  }).catch((err) => {
+    console.warn("[clips-recorder] background backup flag failed:", err);
+  });
 }
 
 export function scheduleNativeBackupCleanupAfterProcessing(args: {
@@ -785,23 +809,26 @@ export function scheduleNativeBackupCleanupAfterProcessing(args: {
   recordingId: string;
   authToken?: string;
 }): void {
-  void waitForReadyRecordingAfterFinalizeError({
-    uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
-    recordingId: args.recordingId,
-    authToken: args.authToken,
-    preferAuthenticated: true,
-    timeoutMs: 12 * 60 * 1000,
-  })
-    .then((recovered) => {
-      if (recovered?.status === "ready") {
-        return invoke("native_fullscreen_recording_dismiss_upload", {
-          recordingId: args.recordingId,
-        });
-      }
-    })
-    .catch((err) => {
+  void reconcileProcessingBackup({
+    waitForReady: () =>
+      waitForReadyRecordingAfterFinalizeError({
+        uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
+        recordingId: args.recordingId,
+        authToken: args.authToken,
+        preferAuthenticated: true,
+        timeoutMs: 12 * 60 * 1000,
+      }),
+    onReady: () =>
+      invoke("native_fullscreen_recording_dismiss_upload", {
+        recordingId: args.recordingId,
+      }),
+    onUnresolved: () => flagNativeBackupAfterProcessing(args.recordingId),
+    onPollError: (err) => {
       console.warn("[clips-recorder] native backup cleanup check failed:", err);
-    });
+    },
+  }).catch((err) => {
+    console.warn("[clips-recorder] native backup flag failed:", err);
+  });
 }
 
 async function recoverAcceptedRecordingAfterFinalizeError({
@@ -884,7 +911,7 @@ async function postBackupChunk(
       `Upload retry failed (${res.status}): ${body.slice(0, 200)}`,
     );
   }
-  return body ? (JSON.parse(body) as FinalizeReceipt) : null;
+  return parseFinalizeReceipt(body);
 }
 
 async function resetBrowserRecordingBackupUpload(
@@ -3965,9 +3992,7 @@ async function startRecordingInner(
                 `Finalize failed (${finalRes.status}): ${bodyText.slice(0, 200)}`,
               );
             }
-            const receipt = bodyText
-              ? (JSON.parse(bodyText) as FinalizeReceipt)
-              : null;
+            const receipt = parseFinalizeReceipt(bodyText);
             const receiptStatus = verifyFinalizeReceipt(receipt, {
               bytes: backupBytes,
               durationMs,

package/corpus/templates/clips/desktop/src/lib/upload-verification.ts

@@ -14,6 +14,18 @@ export interface LocalRecordingProof {
 
 export type FinalizeReceiptStatus = "processing" | "ready";
 
+export function parseFinalizeReceipt(body: string): FinalizeReceipt | null {
+  if (!body) return null;
+  try {
+    const parsed: unknown = JSON.parse(body);
+    return parsed && typeof parsed === "object"
+      ? (parsed as FinalizeReceipt)
+      : null;
+  } catch {
+    throw new Error("Upload returned an invalid finalization response");
+  }
+}
+
 export function verifyFinalizeReceipt(
   receipt: FinalizeReceipt | null,
   local: LocalRecordingProof,

package/corpus/templates/clips/desktop/src-tauri/src/lib.rs

@@ -141,6 +141,7 @@ pub fn run() {
             native_screen::native_fullscreen_recording_rotate_segment,
             native_screen::native_fullscreen_pending_uploads,
             native_screen::native_fullscreen_recording_retry_upload,
+            native_screen::native_fullscreen_recording_mark_upload_error,
             native_screen::native_fullscreen_recording_dismiss_upload,
             native_screen::native_fullscreen_open_drafts_folder,
             // local-only always-on screen memory compatibility helpers

package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs

@@ -2626,6 +2626,20 @@ pub async fn native_fullscreen_recording_retry_upload(
     }
 }
 
+#[tauri::command]
+pub async fn native_fullscreen_recording_mark_upload_error(
+    app: AppHandle,
+    recording_id: String,
+    error: String,
+) -> Result<(), String> {
+    let mut saved = read_saved_recording_metadata(&app, &recording_id)?;
+    saved.last_attempt_at = Some(now_iso());
+    saved.last_error = Some(error);
+    write_saved_recording_metadata(&app, &saved)?;
+    let _ = app.emit("clips:pending-uploads-changed", ());
+    Ok(())
+}
+
 #[tauri::command]
 pub async fn native_fullscreen_recording_dismiss_upload(
     app: AppHandle,

package/corpus/templates/clips/server/db/schema.ts

@@ -586,7 +586,15 @@ export const dictations = table("clips_dictations", {
   // are text-only since native recognition runs on-device.
   audioUrl: text("audio_url"),
   source: text("source", {
-    enum: ["fn-hold", "cmd-shift-space", "manual", "other", "fn", "custom"],
+    enum: [
+      "fn-hold",
+      "cmd-shift-space",
+      "manual",
+      "mobile",
+      "other",
+      "fn",
+      "custom",
+    ],
   })
     .notNull()
     .default("fn-hold"),

package/corpus/templates/clips/server/lib/builder-media-compression.ts

@@ -9,7 +9,7 @@ import {
   resolveBuilderPrivateKey,
   runWithRequestContext,
 } from "@agent-native/core/server";
-import { and, eq } from "drizzle-orm";
+import { and, eq, isNull } from "drizzle-orm";
 
 import type { MediaWorkerCallback } from "../../shared/media-worker-contract.js";
 import { getDb, schema } from "../db/index.js";
@@ -958,7 +958,12 @@ export async function runBuilderMediaCompressionSweepOnce(): Promise<void> {
     key?: unknown;
     value?: unknown;
   }>) {
-    const sessionId = typeof row.session_id === "string" ? row.session_id : "";
+    const sessionId =
+      typeof row.session_id === "string" ? row.session_id.trim() : "";
+    const key = typeof row.key === "string" ? row.key : "";
+    const recordingId = key.startsWith(BUILDER_MEDIA_COMPRESSION_STATE_PREFIX)
+      ? key.slice(BUILDER_MEDIA_COMPRESSION_STATE_PREFIX.length)
+      : "";
     const rawValue = typeof row.value === "string" ? row.value : "";
     let value: Record<string, unknown> | null = null;
     try {
@@ -967,14 +972,61 @@ export async function runBuilderMediaCompressionSweepOnce(): Promise<void> {
       continue;
     }
     const state = parseState(value);
-    if (!state || isFinalStatus(state.status) || !isDue(state)) continue;
-    const ownerEmail = state.ownerEmail || sessionId;
-    if (!ownerEmail) continue;
+    if (
+      !sessionId ||
+      !recordingId ||
+      !state ||
+      state.recordingId !== recordingId ||
+      isFinalStatus(state.status) ||
+      !isDue(state)
+    ) {
+      continue;
+    }
     try {
+      const [recording] = await getDb()
+        .select({
+          ownerEmail: schema.recordings.ownerEmail,
+          orgId: schema.recordings.orgId,
+          videoUrl: schema.recordings.videoUrl,
+        })
+        .from(schema.recordings)
+        .where(
+          and(
+            eq(schema.recordings.id, recordingId),
+            ownerEmailMatches(schema.recordings.ownerEmail, sessionId),
+            eq(schema.recordings.status, "ready"),
+            isNull(schema.recordings.trashedAt),
+          ),
+        )
+        .limit(1);
+      const expectedTarget = extractBuilderMediaTarget(
+        recording?.videoUrl ?? "",
+      );
+      if (
+        !recording ||
+        !expectedTarget ||
+        state.sourceUrl !== expectedTarget.sourceUrl ||
+        (state.mediaWorker &&
+          (state.mediaWorker.jobId !==
+            mediaWorkerCompressionJobId(recordingId) ||
+            state.mediaWorker.outputUrl !== expectedTarget.compressedUrl))
+      ) {
+        continue;
+      }
+
+      const trustedState: BuilderMediaCompressionState = {
+        ...state,
+        ...expectedTarget,
+        ownerEmail: recording.ownerEmail,
+        orgId: recording.orgId,
+      };
       await runWithRequestContext(
-        { userEmail: ownerEmail, orgId: state.orgId ?? undefined },
+        {
+          userEmail: recording.ownerEmail,
+          orgId: recording.orgId ?? undefined,
+        },
         async () => {
-          await processCompressionState({ ...state, ownerEmail });
+          await processCompressionState(trustedState);
         },
       );
     } catch (err) {

package/corpus/templates/clips/server/lib/media-verification-state.ts

@@ -1,3 +1,5 @@
+import { appStateGet } from "@agent-native/core/application-state";
+
 export const MEDIA_VERIFICATION_STATE_PREFIX = "recording-media-verification-";
 
 export type MediaVerificationMarker = {
@@ -36,3 +38,18 @@ export function parseMediaVerificationMarker(
   }
   return state as MediaVerificationMarker;
 }
+
+export async function isMediaVerificationPending(args: {
+  ownerEmail: string;
+  recordingId: string;
+  recordingStatus: string;
+}): Promise<boolean> {
+  if (args.recordingStatus !== "processing") return false;
+
+  const value = await appStateGet(
+    args.ownerEmail,
+    mediaVerificationStateKey(args.recordingId),
+  ).catch(() => null);
+  const marker = parseMediaVerificationMarker(value);
+  return marker?.recordingId === args.recordingId;
+}

package/corpus/templates/clips/server/routes/api/public-recording.get.ts

@@ -42,6 +42,7 @@ import {
 } from "../../../shared/transcript-segments.js";
 import { resolveTranscriptPresentation } from "../../../shared/transcript-status.js";
 import { getDb, schema } from "../../db/index.js";
+import { isMediaVerificationPending } from "../../lib/media-verification-state.js";
 import { resolvePlayerThumbnailUrl } from "../../lib/player-thumbnail-url.js";
 import { resolvePlayerVideoUrl } from "../../lib/player-video-url.js";
 import {
@@ -398,6 +399,11 @@ export default defineEventHandler(async (event) => {
   // Referer of any outbound link the share page renders.
   setResponseHeader(event, "Referrer-Policy", "no-referrer");
   const transcriptPresentation = resolveTranscriptPresentation(transcript);
+  const verificationPending = await isMediaVerificationPending({
+    ownerEmail: rec.ownerEmail,
+    recordingId,
+    recordingStatus: rec.status,
+  });
 
   return {
     recording: {
@@ -416,6 +422,7 @@ export default defineEventHandler(async (event) => {
       hasAudio: Boolean(rec.hasAudio),
       hasCamera: Boolean(rec.hasCamera),
       status: rec.status,
+      verificationPending,
       uploadProgress: rec.uploadProgress,
       failureReason: rec.failureReason,
       // Don't leak the password to clients; just indicate whether one was set.

package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/reset-chunks.post.ts

@@ -42,6 +42,7 @@ import {
 } from "h3";
 
 import { getDb, schema } from "../../../../db/index.js";
+import { isMediaVerificationPending } from "../../../../lib/media-verification-state.js";
 import {
   getEventOwnerContext,
   ownerEmailMatches,
@@ -115,7 +116,11 @@ export default defineEventHandler(async (event: H3Event) => {
     const db = getDb();
 
     const [existing] = await db
-      .select({ id: schema.recordings.id })
+      .select({
+        id: schema.recordings.id,
+        status: schema.recordings.status,
+        videoUrl: schema.recordings.videoUrl,
+      })
       .from(schema.recordings)
       .where(
         and(
@@ -129,6 +134,22 @@ export default defineEventHandler(async (event: H3Event) => {
       return { error: "Recording not found" };
     }
 
+    if (existing.status === "ready" && existing.videoUrl) {
+      setResponseStatus(event, 409);
+      return { error: "Recording is already ready" };
+    }
+
+    if (
+      await isMediaVerificationPending({
+        ownerEmail,
+        recordingId,
+        recordingStatus: existing.status,
+      })
+    ) {
+      setResponseStatus(event, 409);
+      return { error: "Recording is still being verified" };
+    }
+
     const cleared = await deleteAppStateByPrefix(
       `recording-chunks-${recordingId}-`,
     );

package/corpus/templates/plan/changelog/2026-07-17-diagrams-can-opt-into-a-polished-clean-rendering-mode-withou.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-17
+---
+
+Diagrams can opt into a polished clean rendering mode without sketch styling.

package/corpus/templates/plan/shared/plan-content.ts

@@ -367,6 +367,8 @@ export type PlanDiagramBlock = PlanBlockBase & {
      */
     html?: string;
     css?: string;
+    /** `design` forces clean HTML/CSS rendering without the sketch overlay. */
+    renderMode?: PlanVisualCanvasMode;
     caption?: string;
     /** Outer surface frame. `auto` lets the host choose the right default. */
     frame?: PlanVisualFrame;
@@ -1396,6 +1398,7 @@ const diagramDataSchema: z.ZodType<PlanDiagramBlock["data"]> = z
         message: "Diagram css must not include document or script tags.",
       })
       .optional(),
+    renderMode: visualCanvasModeSchema.optional(),
     caption: z.string().trim().max(600).optional(),
     frame: visualFrameSchema.optional(),
     nodes: z.array(diagramNodeSchema).max(80).optional(),

package/dist/client/blocks/library/diagram.config.d.ts

@@ -37,6 +37,8 @@ export interface DiagramData {
      */
     html?: string;
     css?: string;
+    /** `design` forces clean HTML/CSS rendering without the sketch overlay. */
+    renderMode?: "wireframe" | "design";
     caption?: string;
     /** Outer surface frame. `auto` lets the host choose the right default. */
     frame?: BlockVisualFrame;

package/dist/client/blocks/library/diagram.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAsED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EA+BP,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAiB1C;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,WAAW,CAyBlD,CAAC"}
+{"version":3,"file":"diagram.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AAsED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAgCP,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAiB1C;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,WAAW,CA+BlD,CAAC"}

package/dist/client/blocks/library/diagram.config.js

@@ -78,6 +78,7 @@ export const diagramSchema = z
         message: "Diagram css must not include document or script tags.",
     })
         .optional(),
+    renderMode: z.enum(["wireframe", "design"]).optional(),
     caption: z.string().trim().max(600).optional(),
     frame: visualFrameSchema.optional(),
     nodes: z.array(diagramNodeSchema).max(80).optional(),
@@ -108,7 +109,7 @@ function graphDataForAttr(data) {
         return graph;
     if (hasChildFenceData(data))
         return undefined;
-    const { frame: _frame, ...dataForAttr } = data;
+    const { frame: _frame, renderMode: _renderMode, ...dataForAttr } = data;
     return Object.keys(dataForAttr).length > 0 ? dataForAttr : undefined;
 }
 /**
@@ -125,6 +126,7 @@ export const diagramMdx = {
         data: graphDataForAttr(data),
         caption: data.caption,
         frame: data.frame,
+        renderMode: data.renderMode,
     }),
     fromAttrs: (attrs) => ({
         ...(attrs.object("data") ?? {}),
@@ -134,6 +136,11 @@ export const diagramMdx = {
         ...(attrs.string("frame") !== undefined
             ? { frame: attrs.string("frame") }
             : {}),
+        ...(attrs.string("renderMode") !== undefined
+            ? {
+                renderMode: attrs.string("renderMode"),
+            }
+            : {}),
     }),
     serializeChildren: (data) => serializeChildCodeFenceFields(data, { html: "html", css: "css" }),
     parseChildren: (childNodes) => childCodeFenceFields(childNodes, {

package/dist/client/blocks/library/diagram.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagram.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.config.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { childCodeFenceFields, serializeChildCodeFenceFields } from \"../mdx.js\";\nimport type { BlockMdxConfig, BlockVisualFrame } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the shared `diagram` block: its data schema and MDX\n * round-trip config. Lives in core so BOTH apps' server/shared registries\n * (`plan-block-registry.ts`, `nfm-registry.ts`) and the client spec\n * (`diagram.tsx`) consume one definition. Keeping it React-free means importing\n * it into a server module never pulls React into the Nitro/SSR bundle.\n *\n * The MDX `tag` keeps backward compatibility with legacy\n * `<Diagram … data={…} />` files while the current authoring form stores\n * maintainable `html`/`css` as child code fences.\n */\n\nexport interface DiagramNode {\n  id: string;\n  label: string;\n  detail?: string;\n  x?: number;\n  y?: number;\n}\n\nexport interface DiagramEdge {\n  from: string;\n  to: string;\n  label?: string;\n}\n\nexport interface DiagramNote {\n  id: string;\n  text: string;\n  x?: number;\n  y?: number;\n}\n\nexport interface DiagramData {\n  /**\n   * Preferred authoring path for architecture/code diagrams: a scoped, inert\n   * HTML/SVG fragment. Use .diagram-* primitives and --wf-* tokens; the\n   * renderer supplies theme-token-backed styling plus sketch/clean style hooks.\n   */\n  html?: string;\n  css?: string;\n  caption?: string;\n  /** Outer surface frame. `auto` lets the host choose the right default. */\n  frame?: BlockVisualFrame;\n  /**\n   * Legacy compatibility path for older/simple node graphs. New plans should use\n   * `html`/`css` when layout quality matters.\n   */\n  nodes?: DiagramNode[];\n  edges?: DiagramEdge[];\n  notes?: DiagramNote[];\n}\n\nconst idSchema = z.string().trim().min(1).max(120);\nconst unsafeDiagramHtmlPattern =\n  /(?:<!doctype|<\\/?(?:html|head|body|script|style|iframe|object|embed|link|meta|base|form|math|foreignObject|noscript|frame|frameset|applet|portal|marquee)[\\s>/]|@(?:import|font-face|keyframes|page|namespace|charset)\\b|\\b(?:java\\s*script|vb\\s*script|data\\s*:\\s*(?:text\\/html|image\\/svg\\+xml))\\s*:?\\s*|\\bsrcdoc\\s*=|(?:^|\\s)(?:on[a-z][\\w:-]*|@[\\w:.-]+|x-on:[\\w:.-]+|:on[a-z][\\w:-]*|x-bind:on[a-z][\\w:-]*|:style|x-bind:style)\\s*=|expression\\s*\\(|url\\s*\\(\\s*['\"]?\\s*(?:java\\s*script|vb\\s*script|data\\s*:\\s*(?:text\\/html|image\\/svg\\+xml)))/i;\nconst unsafeViewportCssPattern =\n  /(?:^|[;{\\s])position\\s*:\\s*(?:fixed|sticky)\\b|(?:^|[;{\\s])z-index\\s*:\\s*[1-9]\\d{4,}\\b/i;\n\nfunction decodeSafetyEntities(value: string): string {\n  return value\n    .replace(/&#(x[0-9a-f]+|\\d+);?/gi, (_, code: string) => {\n      const point = code.toLowerCase().startsWith(\"x\")\n        ? Number.parseInt(code.slice(1), 16)\n        : Number.parseInt(code, 10);\n      return Number.isFinite(point) ? String.fromCodePoint(point) : \"\";\n    })\n    .replace(/&(colon|tab|newline);/gi, (_, name: string) => {\n      if (name.toLowerCase() === \"colon\") return \":\";\n      if (name.toLowerCase() === \"tab\") return \"\\t\";\n      return \"\\n\";\n    });\n}\n\nfunction decodeCssSafetyEscapes(value: string): string {\n  return value.replace(/\\\\([0-9a-fA-F]{1,6}\\s?|.)/g, (_match, escaped) => {\n    const hex = String(escaped).match(/^[0-9a-fA-F]{1,6}/)?.[0];\n    if (hex) {\n      const point = Number.parseInt(hex, 16);\n      return Number.isFinite(point) ? String.fromCodePoint(point) : \"\";\n    }\n    return String(escaped)[0] ?? \"\";\n  });\n}\n\nfunction noActiveDiagramText(value: string) {\n  const decoded = decodeCssSafetyEscapes(decodeSafetyEntities(value));\n  const compact = decoded.toLowerCase().replace(/[\\u0000-\\u0020]+/g, \"\");\n  return (\n    !unsafeDiagramHtmlPattern.test(value) &&\n    !unsafeDiagramHtmlPattern.test(decoded) &&\n    !unsafeViewportCssPattern.test(decoded) &&\n    !/(?:javascript|vbscript):|data:(?:text\\/html|image\\/svg\\+xml)|expression\\(|url\\(['\"]?(?:javascript|vbscript|data:(?:text\\/html|image\\/svg\\+xml))/.test(\n      compact,\n    )\n  );\n}\n\nconst diagramNodeSchema = z.object({\n  id: idSchema,\n  label: z.string().trim().min(1).max(160),\n  detail: z.string().trim().max(500).optional(),\n  x: z.number().min(0).max(100).optional(),\n  y: z.number().min(0).max(100).optional(),\n}) as z.ZodType<DiagramNode>;\n\nconst diagramEdgeSchema = z.object({\n  from: idSchema,\n  to: idSchema,\n  label: z.string().trim().max(100).optional(),\n}) as z.ZodType<DiagramEdge>;\n\nconst diagramNoteSchema = z.object({\n  id: idSchema,\n  text: z.string().trim().min(1).max(500),\n  x: z.number().min(0).max(100).optional(),\n  y: z.number().min(0).max(100).optional(),\n}) as z.ZodType<DiagramNote>;\n\nconst visualFrameSchema = z.enum([\"auto\", \"show\", \"hide\"]);\n\n/**\n * The block can be a flexible HTML/SVG fragment or a legacy positional\n * node/edge/note graph, so it ships a custom `Edit` rather than relying on the\n * schema auto-editor. Editing stays comment/patch-driven.\n */\nexport const diagramSchema = z\n  .object({\n    html: z\n      .string()\n      .trim()\n      .max(100_000)\n      .refine(noActiveDiagramText, {\n        message:\n          \"Diagram html must be an inert fragment; SVG is allowed, scripts/events are not.\",\n      })\n      .optional(),\n    css: z\n      .string()\n      .max(50_000)\n      .refine(noActiveDiagramText, {\n        message: \"Diagram css must not include document or script tags.\",\n      })\n      .optional(),\n    caption: z.string().trim().max(600).optional(),\n    frame: visualFrameSchema.optional(),\n    nodes: z.array(diagramNodeSchema).max(80).optional(),\n    edges: z.array(diagramEdgeSchema).max(120).optional(),\n    notes: z.array(diagramNoteSchema).max(40).optional(),\n  })\n  .superRefine((data, ctx) => {\n    if (data.html?.trim() || (data.nodes?.length ?? 0) > 0) return;\n    ctx.addIssue({\n      code: \"custom\",\n      path: [\"html\"],\n      message: \"Diagram block requires html or at least one node.\",\n    });\n  }) as unknown as z.ZodType<DiagramData>;\n\nfunction hasChildFenceData(data: DiagramData) {\n  return Boolean(data.html || data.css);\n}\n\nfunction graphDataForAttr(data: DiagramData): DiagramData | undefined {\n  const graph: DiagramData = {};\n  if (data.nodes?.length) graph.nodes = data.nodes;\n  if (data.edges?.length) graph.edges = data.edges;\n  if (data.notes?.length) graph.notes = data.notes;\n  if (Object.keys(graph).length > 0) return graph;\n  if (hasChildFenceData(data)) return undefined;\n  const { frame: _frame, ...dataForAttr } = data;\n  return Object.keys(dataForAttr).length > 0 ? dataForAttr : undefined;\n}\n\n/**\n * MDX config: new source uses normal fenced-code children:\n *\n * `<Diagram caption=\"...\">` plus child `html` / `css` fences. Legacy\n * `<Diagram data={...} />` remains accepted by `fromAttrs`; `toAttrs` keeps the\n * `data` key present-but-undefined when using child fences so docs validation\n * still recognizes old `data={...}` as a supported compatibility attribute.\n */\nexport const diagramMdx: BlockMdxConfig<DiagramData> = {\n  tag: \"Diagram\",\n  toAttrs: (data) => ({\n    data: graphDataForAttr(data) as unknown as\n      | Record<string, unknown>\n      | undefined,\n    caption: data.caption,\n    frame: data.frame,\n  }),\n  fromAttrs: (attrs) => ({\n    ...(attrs.object<DiagramData>(\"data\") ?? {}),\n    ...(attrs.string(\"caption\") !== undefined\n      ? { caption: attrs.string(\"caption\") }\n      : {}),\n    ...(attrs.string(\"frame\") !== undefined\n      ? { frame: attrs.string(\"frame\") as BlockVisualFrame }\n      : {}),\n  }),\n  serializeChildren: (data) =>\n    serializeChildCodeFenceFields(data, { html: \"html\", css: \"css\" }),\n  parseChildren: (childNodes) =>\n    childCodeFenceFields<DiagramData>(childNodes, {\n      html: \"html\",\n      css: \"css\",\n    }),\n};\n"]}
+{"version":3,"file":"diagram.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.config.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { childCodeFenceFields, serializeChildCodeFenceFields } from \"../mdx.js\";\nimport type { BlockMdxConfig, BlockVisualFrame } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the shared `diagram` block: its data schema and MDX\n * round-trip config. Lives in core so BOTH apps' server/shared registries\n * (`plan-block-registry.ts`, `nfm-registry.ts`) and the client spec\n * (`diagram.tsx`) consume one definition. Keeping it React-free means importing\n * it into a server module never pulls React into the Nitro/SSR bundle.\n *\n * The MDX `tag` keeps backward compatibility with legacy\n * `<Diagram … data={…} />` files while the current authoring form stores\n * maintainable `html`/`css` as child code fences.\n */\n\nexport interface DiagramNode {\n  id: string;\n  label: string;\n  detail?: string;\n  x?: number;\n  y?: number;\n}\n\nexport interface DiagramEdge {\n  from: string;\n  to: string;\n  label?: string;\n}\n\nexport interface DiagramNote {\n  id: string;\n  text: string;\n  x?: number;\n  y?: number;\n}\n\nexport interface DiagramData {\n  /**\n   * Preferred authoring path for architecture/code diagrams: a scoped, inert\n   * HTML/SVG fragment. Use .diagram-* primitives and --wf-* tokens; the\n   * renderer supplies theme-token-backed styling plus sketch/clean style hooks.\n   */\n  html?: string;\n  css?: string;\n  /** `design` forces clean HTML/CSS rendering without the sketch overlay. */\n  renderMode?: \"wireframe\" | \"design\";\n  caption?: string;\n  /** Outer surface frame. `auto` lets the host choose the right default. */\n  frame?: BlockVisualFrame;\n  /**\n   * Legacy compatibility path for older/simple node graphs. New plans should use\n   * `html`/`css` when layout quality matters.\n   */\n  nodes?: DiagramNode[];\n  edges?: DiagramEdge[];\n  notes?: DiagramNote[];\n}\n\nconst idSchema = z.string().trim().min(1).max(120);\nconst unsafeDiagramHtmlPattern =\n  /(?:<!doctype|<\\/?(?:html|head|body|script|style|iframe|object|embed|link|meta|base|form|math|foreignObject|noscript|frame|frameset|applet|portal|marquee)[\\s>/]|@(?:import|font-face|keyframes|page|namespace|charset)\\b|\\b(?:java\\s*script|vb\\s*script|data\\s*:\\s*(?:text\\/html|image\\/svg\\+xml))\\s*:?\\s*|\\bsrcdoc\\s*=|(?:^|\\s)(?:on[a-z][\\w:-]*|@[\\w:.-]+|x-on:[\\w:.-]+|:on[a-z][\\w:-]*|x-bind:on[a-z][\\w:-]*|:style|x-bind:style)\\s*=|expression\\s*\\(|url\\s*\\(\\s*['\"]?\\s*(?:java\\s*script|vb\\s*script|data\\s*:\\s*(?:text\\/html|image\\/svg\\+xml)))/i;\nconst unsafeViewportCssPattern =\n  /(?:^|[;{\\s])position\\s*:\\s*(?:fixed|sticky)\\b|(?:^|[;{\\s])z-index\\s*:\\s*[1-9]\\d{4,}\\b/i;\n\nfunction decodeSafetyEntities(value: string): string {\n  return value\n    .replace(/&#(x[0-9a-f]+|\\d+);?/gi, (_, code: string) => {\n      const point = code.toLowerCase().startsWith(\"x\")\n        ? Number.parseInt(code.slice(1), 16)\n        : Number.parseInt(code, 10);\n      return Number.isFinite(point) ? String.fromCodePoint(point) : \"\";\n    })\n    .replace(/&(colon|tab|newline);/gi, (_, name: string) => {\n      if (name.toLowerCase() === \"colon\") return \":\";\n      if (name.toLowerCase() === \"tab\") return \"\\t\";\n      return \"\\n\";\n    });\n}\n\nfunction decodeCssSafetyEscapes(value: string): string {\n  return value.replace(/\\\\([0-9a-fA-F]{1,6}\\s?|.)/g, (_match, escaped) => {\n    const hex = String(escaped).match(/^[0-9a-fA-F]{1,6}/)?.[0];\n    if (hex) {\n      const point = Number.parseInt(hex, 16);\n      return Number.isFinite(point) ? String.fromCodePoint(point) : \"\";\n    }\n    return String(escaped)[0] ?? \"\";\n  });\n}\n\nfunction noActiveDiagramText(value: string) {\n  const decoded = decodeCssSafetyEscapes(decodeSafetyEntities(value));\n  const compact = decoded.toLowerCase().replace(/[\\u0000-\\u0020]+/g, \"\");\n  return (\n    !unsafeDiagramHtmlPattern.test(value) &&\n    !unsafeDiagramHtmlPattern.test(decoded) &&\n    !unsafeViewportCssPattern.test(decoded) &&\n    !/(?:javascript|vbscript):|data:(?:text\\/html|image\\/svg\\+xml)|expression\\(|url\\(['\"]?(?:javascript|vbscript|data:(?:text\\/html|image\\/svg\\+xml))/.test(\n      compact,\n    )\n  );\n}\n\nconst diagramNodeSchema = z.object({\n  id: idSchema,\n  label: z.string().trim().min(1).max(160),\n  detail: z.string().trim().max(500).optional(),\n  x: z.number().min(0).max(100).optional(),\n  y: z.number().min(0).max(100).optional(),\n}) as z.ZodType<DiagramNode>;\n\nconst diagramEdgeSchema = z.object({\n  from: idSchema,\n  to: idSchema,\n  label: z.string().trim().max(100).optional(),\n}) as z.ZodType<DiagramEdge>;\n\nconst diagramNoteSchema = z.object({\n  id: idSchema,\n  text: z.string().trim().min(1).max(500),\n  x: z.number().min(0).max(100).optional(),\n  y: z.number().min(0).max(100).optional(),\n}) as z.ZodType<DiagramNote>;\n\nconst visualFrameSchema = z.enum([\"auto\", \"show\", \"hide\"]);\n\n/**\n * The block can be a flexible HTML/SVG fragment or a legacy positional\n * node/edge/note graph, so it ships a custom `Edit` rather than relying on the\n * schema auto-editor. Editing stays comment/patch-driven.\n */\nexport const diagramSchema = z\n  .object({\n    html: z\n      .string()\n      .trim()\n      .max(100_000)\n      .refine(noActiveDiagramText, {\n        message:\n          \"Diagram html must be an inert fragment; SVG is allowed, scripts/events are not.\",\n      })\n      .optional(),\n    css: z\n      .string()\n      .max(50_000)\n      .refine(noActiveDiagramText, {\n        message: \"Diagram css must not include document or script tags.\",\n      })\n      .optional(),\n    renderMode: z.enum([\"wireframe\", \"design\"]).optional(),\n    caption: z.string().trim().max(600).optional(),\n    frame: visualFrameSchema.optional(),\n    nodes: z.array(diagramNodeSchema).max(80).optional(),\n    edges: z.array(diagramEdgeSchema).max(120).optional(),\n    notes: z.array(diagramNoteSchema).max(40).optional(),\n  })\n  .superRefine((data, ctx) => {\n    if (data.html?.trim() || (data.nodes?.length ?? 0) > 0) return;\n    ctx.addIssue({\n      code: \"custom\",\n      path: [\"html\"],\n      message: \"Diagram block requires html or at least one node.\",\n    });\n  }) as unknown as z.ZodType<DiagramData>;\n\nfunction hasChildFenceData(data: DiagramData) {\n  return Boolean(data.html || data.css);\n}\n\nfunction graphDataForAttr(data: DiagramData): DiagramData | undefined {\n  const graph: DiagramData = {};\n  if (data.nodes?.length) graph.nodes = data.nodes;\n  if (data.edges?.length) graph.edges = data.edges;\n  if (data.notes?.length) graph.notes = data.notes;\n  if (Object.keys(graph).length > 0) return graph;\n  if (hasChildFenceData(data)) return undefined;\n  const { frame: _frame, renderMode: _renderMode, ...dataForAttr } = data;\n  return Object.keys(dataForAttr).length > 0 ? dataForAttr : undefined;\n}\n\n/**\n * MDX config: new source uses normal fenced-code children:\n *\n * `<Diagram caption=\"...\">` plus child `html` / `css` fences. Legacy\n * `<Diagram data={...} />` remains accepted by `fromAttrs`; `toAttrs` keeps the\n * `data` key present-but-undefined when using child fences so docs validation\n * still recognizes old `data={...}` as a supported compatibility attribute.\n */\nexport const diagramMdx: BlockMdxConfig<DiagramData> = {\n  tag: \"Diagram\",\n  toAttrs: (data) => ({\n    data: graphDataForAttr(data) as unknown as\n      | Record<string, unknown>\n      | undefined,\n    caption: data.caption,\n    frame: data.frame,\n    renderMode: data.renderMode,\n  }),\n  fromAttrs: (attrs) => ({\n    ...(attrs.object<DiagramData>(\"data\") ?? {}),\n    ...(attrs.string(\"caption\") !== undefined\n      ? { caption: attrs.string(\"caption\") }\n      : {}),\n    ...(attrs.string(\"frame\") !== undefined\n      ? { frame: attrs.string(\"frame\") as BlockVisualFrame }\n      : {}),\n    ...(attrs.string(\"renderMode\") !== undefined\n      ? {\n          renderMode: attrs.string(\"renderMode\") as DiagramData[\"renderMode\"],\n        }\n      : {}),\n  }),\n  serializeChildren: (data) =>\n    serializeChildCodeFenceFields(data, { html: \"html\", css: \"css\" }),\n  parseChildren: (childNodes) =>\n    childCodeFenceFields<DiagramData>(childNodes, {\n      html: \"html\",\n      css: \"css\",\n    }),\n};\n"]}

package/dist/client/blocks/library/diagram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,qBAAqB,CAAC;AAkiB7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,+BAsCA;AAoFD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,EACH,cAAc,GACf,EAAE,cAAc,CAAC,WAAW,CAAC,+BAY7B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,GACJ,EAAE,cAAc,CAAC,WAAW,CAAC,+BAkL7B;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,8CAgBvB,CAAC"}
+{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/diagram.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EAGL,KAAK,WAAW,EAGjB,MAAM,qBAAqB,CAAC;AAoiB7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,+BAsCA;AAqFD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,EACH,cAAc,GACf,EAAE,cAAc,CAAC,WAAW,CAAC,+BAY7B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,GACJ,EAAE,cAAc,CAAC,WAAW,CAAC,+BAoL7B;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,8CAgBvB,CAAC"}

package/dist/client/blocks/library/diagram.js

@@ -45,7 +45,9 @@ const DIAGRAM_ROUGH_SELECTOR = "[data-rough],.diagram-panel,.diagram-node,.diagr
 function HtmlDiagram({ data, ctx, compact, }) {
     const ref = useRef(null);
     const isDark = useIsDark();
-    const style = useWireframeStyle();
+    const preferredStyle = useWireframeStyle();
+    const designMode = data.renderMode === "design";
+    const style = designMode ? "clean" : preferredStyle;
     const showFrame = resolveVisualFrame(data.frame, ctx);
     const scopeId = useId().replace(/[^a-zA-Z0-9_-]/g, "");
     // Sanitize author HTML/CSS at the render point (defense-in-depth against
@@ -61,7 +63,7 @@ function HtmlDiagram({ data, ctx, compact, }) {
             ? scopeDesignCss(safeCss, `[data-plan-diagram-scope="${scopeId}"]`)
             : "";
     }, [data.css, scopeId]);
-    return (_jsxs("div", { ref: ref, className: cn("plan-diagram-shell", compact && "plan-diagram-compact"), children: [_jsxs("div", { className: "plan-diagram-frame", dir: ctx.textDirection, "data-theme": isDark ? "dark" : "light", "data-style": style, "data-frame": showFrame ? "show" : "hide", "data-text-direction": ctx.textDirection, "data-plan-diagram-scope": scopeId, children: [scopedCss && _jsx("style", { children: scopedCss }), _jsx("div", { className: "plan-diagram-frame-content", dangerouslySetInnerHTML: { __html: safeHtml } })] }), _jsx(RoughOverlay, { scopeRef: ref, enabled: style === "sketchy", drawFrame: showFrame, selector: DIAGRAM_ROUGH_SELECTOR }), data.caption && !compact && (_jsx("p", { className: "mt-3 text-sm leading-6 text-muted-foreground", children: data.caption }))] }));
+    return (_jsxs("div", { ref: ref, className: cn("plan-diagram-shell", compact && "plan-diagram-compact"), children: [_jsxs("div", { className: "plan-diagram-frame", dir: ctx.textDirection, "data-theme": isDark ? "dark" : "light", "data-style": style, "data-frame": showFrame ? "show" : "hide", "data-text-direction": ctx.textDirection, "data-plan-diagram-scope": scopeId, children: [scopedCss && _jsx("style", { children: scopedCss }), _jsx("div", { className: "plan-diagram-frame-content", dangerouslySetInnerHTML: { __html: safeHtml } })] }), _jsx(RoughOverlay, { scopeRef: ref, enabled: !designMode && style === "sketchy", drawFrame: showFrame, selector: DIAGRAM_ROUGH_SELECTOR }), data.caption && !compact && (_jsx("p", { className: "mt-3 text-sm leading-6 text-muted-foreground", children: data.caption }))] }));
 }
 function resolveVisualFrame(frame, ctx) {
     const resolved = frame && frame !== "auto" ? frame : (ctx.visualFrame ?? "show");
@@ -282,7 +284,8 @@ export function DiagramLightbox({ children, onClose, }) {
  */
 function ExpandableDiagramBody({ data, ctx, compact, }) {
     const [expanded, setExpanded] = useState(false);
-    const supportsStyleToggle = Boolean(data.html);
+    const designMode = data.renderMode === "design";
+    const supportsStyleToggle = Boolean(data.html) && !designMode;
     const style = useWireframeStyle();
     const copy = useBlockCopy();
     const sketchy = style === "sketchy";
@@ -336,7 +339,9 @@ export function DiagramEdit({ data, onChange, editable, blockId, title, summary,
         onChange({
             html: html.trim() || undefined,
             css: css.trim() || undefined,
+            renderMode: data.renderMode,
             caption: caption.trim() || undefined,
+            frame: data.frame,
             nodes: data.nodes,
             edges: data.edges,
             notes: data.notes,
@@ -388,7 +393,7 @@ export const diagramBlock = defineBlock({
     // edit from a corner button + panel rather than inline.
     editSurface: "panel",
     label: "Diagram",
-    description: "A flexible inline architecture/code diagram. Prefer html/css with SVG or semantic HTML for polished two-dimensional layouts; use .diagram-* primitives and --wf-* tokens for theme/sketch compatibility. Legacy nodes/edges are only for simple previews.",
+    description: "A flexible inline architecture/code diagram. Prefer html/css with SVG or semantic HTML for polished two-dimensional layouts; use renderMode design for clean presentation or .diagram-* primitives and --wf-* tokens for theme/sketch compatibility. Legacy nodes/edges are only for simple previews.",
     // Seed the legacy fallback shape so a fresh block validates while agents can
     // replace it with html/css when layout quality matters.
     empty: () => ({ nodes: [{ id: "n1", label: "Module" }], edges: [] }),