@agent-native/core 0.66.5 → 0.66.6

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

@@ -100,40 +100,40 @@ function ArtboardFrame({ surface, compact, canvasSize, canvasWidth, skeleton, re
     return (_jsxs("div", { ref: fitRef, className: "plan-kit-wireframe", style: {
             width: "100%",
             maxWidth: maxFrameWidth,
-        }, children: [_jsx("div", { style: {
+        }, children: [_jsxs("div", { className: "group/wireframe-artboard relative", style: {
                     width: "100%",
                     maxWidth: maxFrameWidth,
                     ...(reserveScaledHeight ? { height: reservedHeight } : {}),
                     marginInline: "auto",
-                }, children: _jsxs("div", { ref: ref, className: "group/wireframe-artboard plan-kit-artboard relative", style: {
-                        width,
-                        // Auto-height by default (content-driven, floored at `minHeight`);
-                        // a fixed `canvasSize` locks the height for canvas artboards.
-                        ...(fixedHeight != null ? { height: fixedHeight } : { minHeight }),
-                        borderRadius: preset.radius,
-                        background: paper,
-                        ...(fitScale !== 1
-                            ? {
-                                transform: `scale(${fitScale})`,
-                                transformOrigin: "top left",
-                            }
-                            : {}),
-                    }, children: [_jsx("div", { className: "overflow-hidden", style: {
-                                borderRadius: preset.radius,
-                                ...(fixedHeight != null
-                                    ? { position: "absolute", inset: 0 }
-                                    : { minHeight }),
-                            }, children: render({ theme, style }) }), !roughEnabled && (_jsx("div", { className: "pointer-events-none absolute inset-0", style: {
-                                borderRadius: preset.radius,
-                                border: `1.5px solid ${frameBorder}`,
-                            } })), _jsx(RoughOverlay, { scopeRef: ref, enabled: roughEnabled, frameRadius: preset.radius, selector: selector }), !designMode && !skeleton && _jsx(WireframeStyleToggleButton, {})] }) }), caption && (_jsx("p", { className: "mt-2 text-center text-xs text-plan-muted", children: caption }))] }));
+                }, children: [_jsxs("div", { ref: ref, className: "plan-kit-artboard relative", "data-rough-scope": "wireframe", style: {
+                            width,
+                            // Auto-height by default (content-driven, floored at `minHeight`);
+                            // a fixed `canvasSize` locks the height for canvas artboards.
+                            ...(fixedHeight != null ? { height: fixedHeight } : { minHeight }),
+                            borderRadius: preset.radius,
+                            background: paper,
+                            ...(fitScale !== 1
+                                ? {
+                                    transform: `scale(${fitScale})`,
+                                    transformOrigin: "top left",
+                                }
+                                : {}),
+                        }, children: [_jsx("div", { className: "overflow-hidden", style: {
+                                    borderRadius: preset.radius,
+                                    ...(fixedHeight != null
+                                        ? { position: "absolute", inset: 0 }
+                                        : { minHeight }),
+                                }, children: render({ theme, style }) }), !roughEnabled && (_jsx("div", { className: "pointer-events-none absolute inset-0", style: {
+                                    borderRadius: preset.radius,
+                                    border: `1.5px solid ${frameBorder}`,
+                                } })), _jsx(RoughOverlay, { scopeRef: ref, enabled: roughEnabled, frameRadius: preset.radius, selector: selector })] }), !designMode && !skeleton && _jsx(WireframeStyleToggleButton, {})] }), caption && (_jsx("p", { className: "mt-2 text-center text-xs text-plan-muted", children: caption }))] }));
 }
 function WireframeStyleToggleButton() {
     const style = useWireframeStyle();
     const nextStyle = style === "sketchy" ? "clean" : "sketchy";
     const label = nextStyle === "clean" ? "Clean" : "Sketchy";
     const description = `Switch to ${label.toLowerCase()} visual style`;
-    return (_jsxs("button", { type: "button", "data-plan-interactive": true, "aria-label": description, title: description, onClick: (event) => {
+    return (_jsxs("button", { type: "button", "data-plan-interactive": true, "data-rough": "none", "data-wireframe-style-toggle": true, "aria-label": description, title: description, onClick: (event) => {
             event.stopPropagation();
             toggleWireframeStyle();
         }, className: "absolute right-2 top-2 z-30 inline-flex h-7 items-center gap-1 rounded-md border border-border/60 bg-background/90 px-2 text-xs font-medium text-muted-foreground opacity-0 shadow-sm backdrop-blur transition-[color,opacity] hover:text-foreground focus-visible:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring group-hover/wireframe-artboard:opacity-100", children: [_jsx(IconPencil, { className: "size-3.5", "aria-hidden": "true" }), _jsx("span", { children: label })] }));
@@ -188,8 +188,8 @@ function WireframeSurfaceView({ data, ctx, compact, }) {
 /* Block Read / Edit                                                          */
 /* -------------------------------------------------------------------------- */
 /** Read-only renderer for a `wireframe` block. */
-export function WireframeBlock({ data, blockId, title, summary, ctx, }) {
-    return (_jsxs("section", { ...ltrCodeBlockProps, className: "an-block plan-block an-wireframe", "data-block-id": blockId, children: [title && _jsx("div", { className: "an-block-label plan-block-label", children: title }), _jsx(WireframeSurfaceView, { data: data, ctx: ctx }), summary && _jsx("p", { className: "mt-5 text-plan-muted", children: summary })] }));
+export function WireframeBlock({ data, blockId, title, summary, ctx, compactVisuals, }) {
+    return (_jsxs("section", { ...ltrCodeBlockProps, className: "an-block plan-block an-wireframe", "data-block-id": blockId, children: [title && _jsx("div", { className: "an-block-label plan-block-label", children: title }), _jsx(WireframeSurfaceView, { data: data, ctx: ctx, compact: compactVisuals }), summary && _jsx("p", { className: "mt-5 text-plan-muted", children: summary })] }));
 }
 /**
  * Editor for the `wireframe` block. The wireframe is canvas / agent-patch edited

package/dist/client/blocks/library/wireframe.js.map

@@ -1 +1 @@
-{"version":3,"file":"wireframe.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/wireframe.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { IconPencil } from \"@tabler/icons-react\";\nimport { defineBlock } from \"../types.js\";\nimport { ltrCodeBlockProps } from \"../code-block-direction.js\";\nimport type {\n  BlockReadProps,\n  BlockEditProps,\n  BlockRenderContext,\n} from \"../types.js\";\nimport {\n  wireframeSchema,\n  wireframeMdx,\n  type WireframeData,\n  type WireframeSurface,\n} from \"./wireframe.config.js\";\nimport {\n  HTML_ROUGH_SELECTOR,\n  KitConfigContext,\n  RoughOverlay,\n  Screen,\n  renderNodes,\n  toggleWireframeStyle,\n  useIsDark,\n  useWireframeStyle,\n} from \"./wireframe-kit.js\";\nimport {\n  sanitizeWireframeCss,\n  sanitizeWireframeHtml,\n  scopeDesignCss,\n} from \"./sanitize-html.js\";\nimport { renderWireframeIconHtml } from \"./wireframe-icons.js\";\n\n/**\n * Shared `wireframe` block — a hand-drawn low-fi mockup of one screen, rendered\n * from either a declarative kit tree (`data.screen`) or a self-contained HTML\n * mockup (`data.html`), inside a surface-locked frame (desktop/mobile/popover/\n * panel/browser) with a rough.js sketch overlay. Lives in core so any app can\n * register it (it originated in the plan template).\n *\n * DECOUPLING from the plan original:\n * - Theme: `useIsDark()` reads `document.documentElement.classList` instead of\n *   `next-themes` (the MermaidBlock precedent), so core stays dependency-light.\n * - HTML sanitize: the HTML path runs `data.html`/`data.css` through the\n *   app-injected `ctx.sanitizeHtml`. If no sanitizer is wired the HTML path is\n *   skipped (kit tree or an empty frame renders) — core never injects unsanitized\n *   author HTML.\n * - The plan-only prototype runtime, design-element selection, and legacy region\n *   fallback are intentionally NOT ported; those are plan-canvas features, not\n *   part of the document-block render. The kit element vocabulary, the `--wf-*`\n *   token contract, and the `.plan-wf` / `[data-rough]` classes the overlay\n *   measures are preserved exactly.\n *\n * The section carries the app-neutral `an-block` class plus the legacy\n * `plan-block` class so plan renders byte-identically while any other app gets\n * the theme-token treatment from core's `blocks.css`.\n *\n * The wireframe is canvas / agent-patch edited (node-addressable content patches\n * applied server-side), NOT schema-form edited in the browser — so `Edit` reuses\n * the same static render as `Read`, mirroring the plan `WireframeEditor`.\n */\n\ntype SurfacePreset = {\n  width: number;\n  /**\n   * Floor height for the surface. The frame is AUTO-HEIGHT (content-driven): it\n   * grows past this when content is tall and shrinks toward its content height\n   * when content is short, but never collapses below this floor — so an empty or\n   * near-empty frame still reads as that surface instead of a thin sliver. This\n   * is a `min-height`, not a fixed `height`: it is the lower bound the old fixed\n   * preset height used to also be the UPPER bound, which is what left a big empty\n   * vertical band below short content (e.g. a header + one dropdown padded to a\n   * tall fixed aspect).\n   */\n  minHeight: number;\n  radius: number;\n};\n\nconst SURFACE_PRESETS: Record<WireframeSurface, SurfacePreset> = {\n  // mobile keeps a tall floor: a phone frame reads as a phone even when short.\n  mobile: { width: 300, minHeight: 360, radius: 30 },\n  desktop: { width: 840, minHeight: 200, radius: 14 },\n  browser: { width: 900, minHeight: 200, radius: 14 },\n  popover: { width: 360, minHeight: 120, radius: 16 },\n  panel: { width: 420, minHeight: 200, radius: 16 },\n};\n\nfunction isHtmlData(data: WireframeData): boolean {\n  return typeof data.html === \"string\" && data.html.trim().length > 0;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Shared frame shell: surface-locked WIDTH + auto (content-driven) height +   */\n/* theme + rough overlay. The frame keeps each surface's footprint and chrome  */\n/* but fits its content height instead of padding to a fixed aspect, so short  */\n/* content yields a short frame and tall content grows. Pass `canvasSize` to   */\n/* opt a fixed-aspect canvas artboard back into a hard pixel height.           */\n/* -------------------------------------------------------------------------- */\n\nfunction ArtboardFrame({\n  surface,\n  compact,\n  canvasSize,\n  canvasWidth,\n  skeleton,\n  renderMode,\n  roughOverlay = true,\n  selector,\n  caption,\n  render,\n}: {\n  surface: WireframeSurface;\n  compact?: boolean;\n  /**\n   * Force a FIXED pixel height instead of the auto-height (content-driven)\n   * default. Reserved for fixed-aspect canvas artboards (pan/zoom). Document-flow\n   * wireframes — what recaps render — leave this unset so the frame fits content.\n   */\n  canvasSize?: number;\n  canvasWidth?: number;\n  skeleton?: boolean;\n  renderMode?: \"wireframe\" | \"design\";\n  roughOverlay?: boolean;\n  selector: string;\n  caption?: string;\n  render: (ctx: {\n    theme: \"light\" | \"dark\";\n    style: \"sketchy\" | \"clean\";\n  }) => ReactNode;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const fitRef = useRef<HTMLDivElement>(null);\n  const isDark = useIsDark();\n  const theme: \"light\" | \"dark\" = isDark ? \"dark\" : \"light\";\n  const style = useWireframeStyle();\n  const preset = SURFACE_PRESETS[surface] ?? SURFACE_PRESETS.desktop;\n  const width = canvasWidth ?? preset.width;\n  // AUTO-HEIGHT: with no explicit `canvasSize` the artboard height is driven by\n  // its content (`height: auto`), floored at the surface's `minHeight` so a short\n  // screen produces a short frame and a tall screen grows — instead of every\n  // surface being padded to a fixed preset height that left a big empty band\n  // below short content. A `canvasSize` (fixed-aspect canvas artboard) overrides\n  // this with a hard pixel height.\n  const fixedHeight = canvasSize;\n  const minHeight = fixedHeight ?? preset.minHeight;\n  const baseScale = compact ? Math.min(1, 320 / preset.width) : 1;\n  const maxFrameWidth = compact ? preset.width * baseScale : width;\n  const [fitScale, setFitScale] = useState(baseScale);\n  // The scaled artboard is `transform: scale()`-ed, which does not change its\n  // layout box, so the wrapper that reserves vertical space must track the\n  // artboard's ACTUAL rendered height. With a fixed height that's known up front;\n  // with auto-height we measure it.\n  const [measuredHeight, setMeasuredHeight] = useState<number | null>(\n    fixedHeight ?? null,\n  );\n  const designMode = renderMode === \"design\";\n  const sketchy = !designMode && style === \"sketchy\" && !skeleton;\n  const roughEnabled = sketchy && roughOverlay;\n  const paper = designMode\n    ? \"hsl(var(--background))\"\n    : \"var(--plan-document, hsl(var(--background)))\";\n  const frameBorder = skeleton\n    ? \"var(--plan-placeholder-line, var(--plan-line, hsl(var(--border))))\"\n    : \"var(--plan-line, hsl(var(--border)))\";\n\n  useEffect(() => {\n    const element = fitRef.current;\n    if (!element) return;\n    const measure = () => {\n      const availableWidth = element.clientWidth;\n      const nextScale =\n        availableWidth > 0\n          ? Math.min(baseScale, availableWidth / width)\n          : baseScale;\n      setFitScale((current) =>\n        Math.abs(current - nextScale) < 0.001 ? current : nextScale,\n      );\n    };\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [baseScale, width]);\n\n  // Track the auto-height artboard's rendered height so the (un-transformed)\n  // wrapper reserves exactly the scaled space the frame occupies. Skipped when a\n  // fixed height is supplied — there's nothing to measure.\n  useEffect(() => {\n    if (fixedHeight != null) return;\n    const element = ref.current;\n    if (!element) return;\n    const measure = () => {\n      const next = element.offsetHeight;\n      setMeasuredHeight((current) =>\n        current != null && Math.abs(current - next) < 0.5 ? current : next,\n      );\n    };\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [fixedHeight]);\n\n  // Height the wrapper reserves: the measured (or fixed) artboard height scaled\n  // by the fit factor. Falls back to the surface floor before the first measure\n  // so SSR / first paint reserves a sensible box rather than collapsing.\n  const reservedHeight = (measuredHeight ?? minHeight) * fitScale;\n  const reserveScaledHeight = fixedHeight != null || fitScale !== 1;\n\n  return (\n    <div\n      ref={fitRef}\n      className=\"plan-kit-wireframe\"\n      style={{\n        width: \"100%\",\n        maxWidth: maxFrameWidth,\n      }}\n    >\n      <div\n        style={{\n          width: \"100%\",\n          maxWidth: maxFrameWidth,\n          ...(reserveScaledHeight ? { height: reservedHeight } : {}),\n          marginInline: \"auto\",\n        }}\n      >\n        <div\n          ref={ref}\n          className=\"group/wireframe-artboard plan-kit-artboard relative\"\n          style={{\n            width,\n            // Auto-height by default (content-driven, floored at `minHeight`);\n            // a fixed `canvasSize` locks the height for canvas artboards.\n            ...(fixedHeight != null ? { height: fixedHeight } : { minHeight }),\n            borderRadius: preset.radius,\n            background: paper,\n            ...(fitScale !== 1\n              ? {\n                  transform: `scale(${fitScale})`,\n                  transformOrigin: \"top left\",\n                }\n              : {}),\n          }}\n        >\n          {/* Content drives the artboard height in flow when auto-height; for a\n              fixed height it's pinned to the box. Rounded corners clip overflow\n              either way. */}\n          <div\n            className=\"overflow-hidden\"\n            style={{\n              borderRadius: preset.radius,\n              ...(fixedHeight != null\n                ? { position: \"absolute\", inset: 0 }\n                : { minHeight }),\n            }}\n          >\n            {render({ theme, style })}\n          </div>\n          {!roughEnabled && (\n            <div\n              className=\"pointer-events-none absolute inset-0\"\n              style={{\n                borderRadius: preset.radius,\n                border: `1.5px solid ${frameBorder}`,\n              }}\n            />\n          )}\n          <RoughOverlay\n            scopeRef={ref}\n            enabled={roughEnabled}\n            frameRadius={preset.radius}\n            selector={selector}\n          />\n          {!designMode && !skeleton && <WireframeStyleToggleButton />}\n        </div>\n      </div>\n      {caption && (\n        <p className=\"mt-2 text-center text-xs text-plan-muted\">{caption}</p>\n      )}\n    </div>\n  );\n}\n\nfunction WireframeStyleToggleButton() {\n  const style = useWireframeStyle();\n  const nextStyle = style === \"sketchy\" ? \"clean\" : \"sketchy\";\n  const label = nextStyle === \"clean\" ? \"Clean\" : \"Sketchy\";\n  const description = `Switch to ${label.toLowerCase()} visual style`;\n\n  return (\n    <button\n      type=\"button\"\n      data-plan-interactive\n      aria-label={description}\n      title={description}\n      onClick={(event) => {\n        event.stopPropagation();\n        toggleWireframeStyle();\n      }}\n      className=\"absolute right-2 top-2 z-30 inline-flex h-7 items-center gap-1 rounded-md border border-border/60 bg-background/90 px-2 text-xs font-medium text-muted-foreground opacity-0 shadow-sm backdrop-blur transition-[color,opacity] hover:text-foreground focus-visible:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring group-hover/wireframe-artboard:opacity-100\"\n    >\n      <IconPencil className=\"size-3.5\" aria-hidden=\"true\" />\n      <span>{label}</span>\n    </button>\n  );\n}\n\n/* -------------------------------------------------------------------------- */\n/* HTML artboard — author HTML, themed + roughened by the renderer.           */\n/* -------------------------------------------------------------------------- */\n\nfunction HtmlArtboard({\n  data,\n  ctx: _ctx,\n  compact,\n}: {\n  data: WireframeData;\n  ctx: BlockRenderContext;\n  compact?: boolean;\n}) {\n  const renderMode = data.renderMode ?? \"wireframe\";\n  // Sanitize author HTML/CSS at the render point (defense-in-depth against stored\n  // XSS). Self-contained in core via the shared block sanitizer (DOM-based in the\n  // browser, regex fallback on the server) so the HTML mockup path renders in any\n  // app without the host wiring a sanitizer hook.\n  const safeHtml = useMemo(\n    () => renderWireframeIconHtml(sanitizeWireframeHtml(data.html)),\n    [data.html],\n  );\n  const scopeId = useId().replace(/[^a-zA-Z0-9_-]/g, \"\");\n  const scopedCss = useMemo(() => {\n    const safeCss = sanitizeWireframeCss(data.css);\n    // Scope every author selector under this instance's artboard so global\n    // selectors (body, *, .app-shell, :root) can't restyle/hide the host app.\n    return safeCss\n      ? scopeDesignCss(safeCss, `[data-plan-design-scope=\"${scopeId}\"]`)\n      : \"\";\n  }, [data.css, scopeId]);\n\n  return (\n    <ArtboardFrame\n      surface={data.surface}\n      compact={compact}\n      skeleton={data.skeleton}\n      renderMode={renderMode}\n      selector={HTML_ROUGH_SELECTOR}\n      caption={data.caption}\n      render={({ theme, style }) => (\n        <div\n          className=\"plan-html-frame\"\n          data-theme={theme}\n          data-style={style}\n          data-render-mode={renderMode}\n          data-plan-design-scope={scopeId}\n          data-skeleton={data.skeleton ? \"true\" : undefined}\n        >\n          {scopedCss && <style>{scopedCss}</style>}\n          <div\n            className=\"plan-html-frame-content\"\n            dangerouslySetInnerHTML={{ __html: safeHtml }}\n          />\n        </div>\n      )}\n    />\n  );\n}\n\n/* -------------------------------------------------------------------------- */\n/* Kit artboard — declarative kit tree.                                       */\n/* -------------------------------------------------------------------------- */\n\nfunction KitArtboard({\n  data,\n  compact,\n}: {\n  data: WireframeData;\n  compact?: boolean;\n}) {\n  return (\n    <ArtboardFrame\n      surface={data.surface}\n      compact={compact}\n      skeleton={data.skeleton}\n      selector=\"[data-rough]\"\n      caption={data.caption}\n      render={({ theme, style }) => (\n        <KitConfigContext.Provider\n          value={{ skeleton: data.skeleton, theme, style }}\n        >\n          {renderKitScreen(data.screen ?? [])}\n        </KitConfigContext.Provider>\n      )}\n    />\n  );\n}\n\nfunction renderKitScreen(\n  nodes: NonNullable<WireframeData[\"screen\"]>,\n): ReactNode {\n  if (nodes.length === 1 && nodes[0]?.el === \"screen\") {\n    return renderNodes(nodes);\n  }\n  // `minHeight` (not `height`) so the screen fills the auto-height artboard floor\n  // but grows past it when content is tall, instead of locking to a fixed box.\n  return (\n    <Screen pad=\"calc(var(--pad) * 1.35)\" style={{ minHeight: \"100%\" }}>\n      {renderNodes(nodes)}\n    </Screen>\n  );\n}\n\n/**\n * The bare wireframe surface (no block section / title). Routes to the HTML\n * mockup when `data.html` is present and a sanitizer is wired; otherwise renders\n * the kit tree.\n */\nfunction WireframeSurfaceView({\n  data,\n  ctx,\n  compact,\n}: {\n  data: WireframeData;\n  ctx: BlockRenderContext;\n  compact?: boolean;\n}) {\n  if (isHtmlData(data)) {\n    return <HtmlArtboard data={data} ctx={ctx} compact={compact} />;\n  }\n  return <KitArtboard data={data} compact={compact} />;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Block Read / Edit                                                          */\n/* -------------------------------------------------------------------------- */\n\n/** Read-only renderer for a `wireframe` block. */\nexport function WireframeBlock({\n  data,\n  blockId,\n  title,\n  summary,\n  ctx,\n}: BlockReadProps<WireframeData>) {\n  return (\n    <section\n      {...ltrCodeBlockProps}\n      className=\"an-block plan-block an-wireframe\"\n      data-block-id={blockId}\n    >\n      {title && <div className=\"an-block-label plan-block-label\">{title}</div>}\n      <WireframeSurfaceView data={data} ctx={ctx} />\n      {summary && <p className=\"mt-5 text-plan-muted\">{summary}</p>}\n    </section>\n  );\n}\n\n/**\n * Editor for the `wireframe` block. The wireframe is canvas / agent-patch edited\n * (it never calls `onChange`), so edit mode reuses the read surface — mirroring\n * the plan `WireframeEditor`. The host document editor already wraps the registry\n * edit path in a titled section, so this renders only the surface to avoid\n * double-nesting.\n */\nexport function WireframeEditor({ data, ctx }: BlockEditProps<WireframeData>) {\n  return <WireframeSurfaceView data={data} ctx={ctx} />;\n}\n\n/** Full client spec for the shared `wireframe` block (schema + MDX + Read/Edit). */\nexport const wireframeBlock = defineBlock<WireframeData>({\n  type: \"wireframe\",\n  schema: wireframeSchema,\n  mdx: wireframeMdx,\n  Read: WireframeBlock,\n  Edit: WireframeEditor,\n  placement: [\"block\"],\n  editSurface: \"inline\",\n  label: \"Wireframe\",\n  description:\n    \"A sketch wireframe of one screen built from kit primitives (or an HTML mockup), rendered in a chosen surface frame (desktop/mobile/popover/panel/browser).\",\n  // `surface` is the only required field; `screen` defaults to []. Start on the\n  // desktop surface with an empty screen so the canvas/agent can fill it in.\n  empty: () => ({ surface: \"desktop\", screen: [] }),\n});\n"]}
+{"version":3,"file":"wireframe.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/wireframe.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  useEffect,\n  useId,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport { IconPencil } from \"@tabler/icons-react\";\nimport { defineBlock } from \"../types.js\";\nimport { ltrCodeBlockProps } from \"../code-block-direction.js\";\nimport type {\n  BlockReadProps,\n  BlockEditProps,\n  BlockRenderContext,\n} from \"../types.js\";\nimport {\n  wireframeSchema,\n  wireframeMdx,\n  type WireframeData,\n  type WireframeSurface,\n} from \"./wireframe.config.js\";\nimport {\n  HTML_ROUGH_SELECTOR,\n  KitConfigContext,\n  RoughOverlay,\n  Screen,\n  renderNodes,\n  toggleWireframeStyle,\n  useIsDark,\n  useWireframeStyle,\n} from \"./wireframe-kit.js\";\nimport {\n  sanitizeWireframeCss,\n  sanitizeWireframeHtml,\n  scopeDesignCss,\n} from \"./sanitize-html.js\";\nimport { renderWireframeIconHtml } from \"./wireframe-icons.js\";\n\n/**\n * Shared `wireframe` block — a hand-drawn low-fi mockup of one screen, rendered\n * from either a declarative kit tree (`data.screen`) or a self-contained HTML\n * mockup (`data.html`), inside a surface-locked frame (desktop/mobile/popover/\n * panel/browser) with a rough.js sketch overlay. Lives in core so any app can\n * register it (it originated in the plan template).\n *\n * DECOUPLING from the plan original:\n * - Theme: `useIsDark()` reads `document.documentElement.classList` instead of\n *   `next-themes` (the MermaidBlock precedent), so core stays dependency-light.\n * - HTML sanitize: the HTML path runs `data.html`/`data.css` through the\n *   app-injected `ctx.sanitizeHtml`. If no sanitizer is wired the HTML path is\n *   skipped (kit tree or an empty frame renders) — core never injects unsanitized\n *   author HTML.\n * - The plan-only prototype runtime, design-element selection, and legacy region\n *   fallback are intentionally NOT ported; those are plan-canvas features, not\n *   part of the document-block render. The kit element vocabulary, the `--wf-*`\n *   token contract, and the `.plan-wf` / `[data-rough]` classes the overlay\n *   measures are preserved exactly.\n *\n * The section carries the app-neutral `an-block` class plus the legacy\n * `plan-block` class so plan renders byte-identically while any other app gets\n * the theme-token treatment from core's `blocks.css`.\n *\n * The wireframe is canvas / agent-patch edited (node-addressable content patches\n * applied server-side), NOT schema-form edited in the browser — so `Edit` reuses\n * the same static render as `Read`, mirroring the plan `WireframeEditor`.\n */\n\ntype SurfacePreset = {\n  width: number;\n  /**\n   * Floor height for the surface. The frame is AUTO-HEIGHT (content-driven): it\n   * grows past this when content is tall and shrinks toward its content height\n   * when content is short, but never collapses below this floor — so an empty or\n   * near-empty frame still reads as that surface instead of a thin sliver. This\n   * is a `min-height`, not a fixed `height`: it is the lower bound the old fixed\n   * preset height used to also be the UPPER bound, which is what left a big empty\n   * vertical band below short content (e.g. a header + one dropdown padded to a\n   * tall fixed aspect).\n   */\n  minHeight: number;\n  radius: number;\n};\n\nconst SURFACE_PRESETS: Record<WireframeSurface, SurfacePreset> = {\n  // mobile keeps a tall floor: a phone frame reads as a phone even when short.\n  mobile: { width: 300, minHeight: 360, radius: 30 },\n  desktop: { width: 840, minHeight: 200, radius: 14 },\n  browser: { width: 900, minHeight: 200, radius: 14 },\n  popover: { width: 360, minHeight: 120, radius: 16 },\n  panel: { width: 420, minHeight: 200, radius: 16 },\n};\n\nfunction isHtmlData(data: WireframeData): boolean {\n  return typeof data.html === \"string\" && data.html.trim().length > 0;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Shared frame shell: surface-locked WIDTH + auto (content-driven) height +   */\n/* theme + rough overlay. The frame keeps each surface's footprint and chrome  */\n/* but fits its content height instead of padding to a fixed aspect, so short  */\n/* content yields a short frame and tall content grows. Pass `canvasSize` to   */\n/* opt a fixed-aspect canvas artboard back into a hard pixel height.           */\n/* -------------------------------------------------------------------------- */\n\nfunction ArtboardFrame({\n  surface,\n  compact,\n  canvasSize,\n  canvasWidth,\n  skeleton,\n  renderMode,\n  roughOverlay = true,\n  selector,\n  caption,\n  render,\n}: {\n  surface: WireframeSurface;\n  compact?: boolean;\n  /**\n   * Force a FIXED pixel height instead of the auto-height (content-driven)\n   * default. Reserved for fixed-aspect canvas artboards (pan/zoom). Document-flow\n   * wireframes — what recaps render — leave this unset so the frame fits content.\n   */\n  canvasSize?: number;\n  canvasWidth?: number;\n  skeleton?: boolean;\n  renderMode?: \"wireframe\" | \"design\";\n  roughOverlay?: boolean;\n  selector: string;\n  caption?: string;\n  render: (ctx: {\n    theme: \"light\" | \"dark\";\n    style: \"sketchy\" | \"clean\";\n  }) => ReactNode;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const fitRef = useRef<HTMLDivElement>(null);\n  const isDark = useIsDark();\n  const theme: \"light\" | \"dark\" = isDark ? \"dark\" : \"light\";\n  const style = useWireframeStyle();\n  const preset = SURFACE_PRESETS[surface] ?? SURFACE_PRESETS.desktop;\n  const width = canvasWidth ?? preset.width;\n  // AUTO-HEIGHT: with no explicit `canvasSize` the artboard height is driven by\n  // its content (`height: auto`), floored at the surface's `minHeight` so a short\n  // screen produces a short frame and a tall screen grows — instead of every\n  // surface being padded to a fixed preset height that left a big empty band\n  // below short content. A `canvasSize` (fixed-aspect canvas artboard) overrides\n  // this with a hard pixel height.\n  const fixedHeight = canvasSize;\n  const minHeight = fixedHeight ?? preset.minHeight;\n  const baseScale = compact ? Math.min(1, 320 / preset.width) : 1;\n  const maxFrameWidth = compact ? preset.width * baseScale : width;\n  const [fitScale, setFitScale] = useState(baseScale);\n  // The scaled artboard is `transform: scale()`-ed, which does not change its\n  // layout box, so the wrapper that reserves vertical space must track the\n  // artboard's ACTUAL rendered height. With a fixed height that's known up front;\n  // with auto-height we measure it.\n  const [measuredHeight, setMeasuredHeight] = useState<number | null>(\n    fixedHeight ?? null,\n  );\n  const designMode = renderMode === \"design\";\n  const sketchy = !designMode && style === \"sketchy\" && !skeleton;\n  const roughEnabled = sketchy && roughOverlay;\n  const paper = designMode\n    ? \"hsl(var(--background))\"\n    : \"var(--plan-document, hsl(var(--background)))\";\n  const frameBorder = skeleton\n    ? \"var(--plan-placeholder-line, var(--plan-line, hsl(var(--border))))\"\n    : \"var(--plan-line, hsl(var(--border)))\";\n\n  useEffect(() => {\n    const element = fitRef.current;\n    if (!element) return;\n    const measure = () => {\n      const availableWidth = element.clientWidth;\n      const nextScale =\n        availableWidth > 0\n          ? Math.min(baseScale, availableWidth / width)\n          : baseScale;\n      setFitScale((current) =>\n        Math.abs(current - nextScale) < 0.001 ? current : nextScale,\n      );\n    };\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [baseScale, width]);\n\n  // Track the auto-height artboard's rendered height so the (un-transformed)\n  // wrapper reserves exactly the scaled space the frame occupies. Skipped when a\n  // fixed height is supplied — there's nothing to measure.\n  useEffect(() => {\n    if (fixedHeight != null) return;\n    const element = ref.current;\n    if (!element) return;\n    const measure = () => {\n      const next = element.offsetHeight;\n      setMeasuredHeight((current) =>\n        current != null && Math.abs(current - next) < 0.5 ? current : next,\n      );\n    };\n    measure();\n    const observer = new ResizeObserver(measure);\n    observer.observe(element);\n    return () => observer.disconnect();\n  }, [fixedHeight]);\n\n  // Height the wrapper reserves: the measured (or fixed) artboard height scaled\n  // by the fit factor. Falls back to the surface floor before the first measure\n  // so SSR / first paint reserves a sensible box rather than collapsing.\n  const reservedHeight = (measuredHeight ?? minHeight) * fitScale;\n  const reserveScaledHeight = fixedHeight != null || fitScale !== 1;\n\n  return (\n    <div\n      ref={fitRef}\n      className=\"plan-kit-wireframe\"\n      style={{\n        width: \"100%\",\n        maxWidth: maxFrameWidth,\n      }}\n    >\n      <div\n        className=\"group/wireframe-artboard relative\"\n        style={{\n          width: \"100%\",\n          maxWidth: maxFrameWidth,\n          ...(reserveScaledHeight ? { height: reservedHeight } : {}),\n          marginInline: \"auto\",\n        }}\n      >\n        <div\n          ref={ref}\n          className=\"plan-kit-artboard relative\"\n          data-rough-scope=\"wireframe\"\n          style={{\n            width,\n            // Auto-height by default (content-driven, floored at `minHeight`);\n            // a fixed `canvasSize` locks the height for canvas artboards.\n            ...(fixedHeight != null ? { height: fixedHeight } : { minHeight }),\n            borderRadius: preset.radius,\n            background: paper,\n            ...(fitScale !== 1\n              ? {\n                  transform: `scale(${fitScale})`,\n                  transformOrigin: \"top left\",\n                }\n              : {}),\n          }}\n        >\n          {/* Content drives the artboard height in flow when auto-height; for a\n              fixed height it's pinned to the box. Rounded corners clip overflow\n              either way. */}\n          <div\n            className=\"overflow-hidden\"\n            style={{\n              borderRadius: preset.radius,\n              ...(fixedHeight != null\n                ? { position: \"absolute\", inset: 0 }\n                : { minHeight }),\n            }}\n          >\n            {render({ theme, style })}\n          </div>\n          {!roughEnabled && (\n            <div\n              className=\"pointer-events-none absolute inset-0\"\n              style={{\n                borderRadius: preset.radius,\n                border: `1.5px solid ${frameBorder}`,\n              }}\n            />\n          )}\n          <RoughOverlay\n            scopeRef={ref}\n            enabled={roughEnabled}\n            frameRadius={preset.radius}\n            selector={selector}\n          />\n        </div>\n        {!designMode && !skeleton && <WireframeStyleToggleButton />}\n      </div>\n      {caption && (\n        <p className=\"mt-2 text-center text-xs text-plan-muted\">{caption}</p>\n      )}\n    </div>\n  );\n}\n\nfunction WireframeStyleToggleButton() {\n  const style = useWireframeStyle();\n  const nextStyle = style === \"sketchy\" ? \"clean\" : \"sketchy\";\n  const label = nextStyle === \"clean\" ? \"Clean\" : \"Sketchy\";\n  const description = `Switch to ${label.toLowerCase()} visual style`;\n\n  return (\n    <button\n      type=\"button\"\n      data-plan-interactive\n      data-rough=\"none\"\n      data-wireframe-style-toggle\n      aria-label={description}\n      title={description}\n      onClick={(event) => {\n        event.stopPropagation();\n        toggleWireframeStyle();\n      }}\n      className=\"absolute right-2 top-2 z-30 inline-flex h-7 items-center gap-1 rounded-md border border-border/60 bg-background/90 px-2 text-xs font-medium text-muted-foreground opacity-0 shadow-sm backdrop-blur transition-[color,opacity] hover:text-foreground focus-visible:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring group-hover/wireframe-artboard:opacity-100\"\n    >\n      <IconPencil className=\"size-3.5\" aria-hidden=\"true\" />\n      <span>{label}</span>\n    </button>\n  );\n}\n\n/* -------------------------------------------------------------------------- */\n/* HTML artboard — author HTML, themed + roughened by the renderer.           */\n/* -------------------------------------------------------------------------- */\n\nfunction HtmlArtboard({\n  data,\n  ctx: _ctx,\n  compact,\n}: {\n  data: WireframeData;\n  ctx: BlockRenderContext;\n  compact?: boolean;\n}) {\n  const renderMode = data.renderMode ?? \"wireframe\";\n  // Sanitize author HTML/CSS at the render point (defense-in-depth against stored\n  // XSS). Self-contained in core via the shared block sanitizer (DOM-based in the\n  // browser, regex fallback on the server) so the HTML mockup path renders in any\n  // app without the host wiring a sanitizer hook.\n  const safeHtml = useMemo(\n    () => renderWireframeIconHtml(sanitizeWireframeHtml(data.html)),\n    [data.html],\n  );\n  const scopeId = useId().replace(/[^a-zA-Z0-9_-]/g, \"\");\n  const scopedCss = useMemo(() => {\n    const safeCss = sanitizeWireframeCss(data.css);\n    // Scope every author selector under this instance's artboard so global\n    // selectors (body, *, .app-shell, :root) can't restyle/hide the host app.\n    return safeCss\n      ? scopeDesignCss(safeCss, `[data-plan-design-scope=\"${scopeId}\"]`)\n      : \"\";\n  }, [data.css, scopeId]);\n\n  return (\n    <ArtboardFrame\n      surface={data.surface}\n      compact={compact}\n      skeleton={data.skeleton}\n      renderMode={renderMode}\n      selector={HTML_ROUGH_SELECTOR}\n      caption={data.caption}\n      render={({ theme, style }) => (\n        <div\n          className=\"plan-html-frame\"\n          data-theme={theme}\n          data-style={style}\n          data-render-mode={renderMode}\n          data-plan-design-scope={scopeId}\n          data-skeleton={data.skeleton ? \"true\" : undefined}\n        >\n          {scopedCss && <style>{scopedCss}</style>}\n          <div\n            className=\"plan-html-frame-content\"\n            dangerouslySetInnerHTML={{ __html: safeHtml }}\n          />\n        </div>\n      )}\n    />\n  );\n}\n\n/* -------------------------------------------------------------------------- */\n/* Kit artboard — declarative kit tree.                                       */\n/* -------------------------------------------------------------------------- */\n\nfunction KitArtboard({\n  data,\n  compact,\n}: {\n  data: WireframeData;\n  compact?: boolean;\n}) {\n  return (\n    <ArtboardFrame\n      surface={data.surface}\n      compact={compact}\n      skeleton={data.skeleton}\n      selector=\"[data-rough]\"\n      caption={data.caption}\n      render={({ theme, style }) => (\n        <KitConfigContext.Provider\n          value={{ skeleton: data.skeleton, theme, style }}\n        >\n          {renderKitScreen(data.screen ?? [])}\n        </KitConfigContext.Provider>\n      )}\n    />\n  );\n}\n\nfunction renderKitScreen(\n  nodes: NonNullable<WireframeData[\"screen\"]>,\n): ReactNode {\n  if (nodes.length === 1 && nodes[0]?.el === \"screen\") {\n    return renderNodes(nodes);\n  }\n  // `minHeight` (not `height`) so the screen fills the auto-height artboard floor\n  // but grows past it when content is tall, instead of locking to a fixed box.\n  return (\n    <Screen pad=\"calc(var(--pad) * 1.35)\" style={{ minHeight: \"100%\" }}>\n      {renderNodes(nodes)}\n    </Screen>\n  );\n}\n\n/**\n * The bare wireframe surface (no block section / title). Routes to the HTML\n * mockup when `data.html` is present and a sanitizer is wired; otherwise renders\n * the kit tree.\n */\nfunction WireframeSurfaceView({\n  data,\n  ctx,\n  compact,\n}: {\n  data: WireframeData;\n  ctx: BlockRenderContext;\n  compact?: boolean;\n}) {\n  if (isHtmlData(data)) {\n    return <HtmlArtboard data={data} ctx={ctx} compact={compact} />;\n  }\n  return <KitArtboard data={data} compact={compact} />;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Block Read / Edit                                                          */\n/* -------------------------------------------------------------------------- */\n\n/** Read-only renderer for a `wireframe` block. */\nexport function WireframeBlock({\n  data,\n  blockId,\n  title,\n  summary,\n  ctx,\n  compactVisuals,\n}: BlockReadProps<WireframeData>) {\n  return (\n    <section\n      {...ltrCodeBlockProps}\n      className=\"an-block plan-block an-wireframe\"\n      data-block-id={blockId}\n    >\n      {title && <div className=\"an-block-label plan-block-label\">{title}</div>}\n      <WireframeSurfaceView data={data} ctx={ctx} compact={compactVisuals} />\n      {summary && <p className=\"mt-5 text-plan-muted\">{summary}</p>}\n    </section>\n  );\n}\n\n/**\n * Editor for the `wireframe` block. The wireframe is canvas / agent-patch edited\n * (it never calls `onChange`), so edit mode reuses the read surface — mirroring\n * the plan `WireframeEditor`. The host document editor already wraps the registry\n * edit path in a titled section, so this renders only the surface to avoid\n * double-nesting.\n */\nexport function WireframeEditor({ data, ctx }: BlockEditProps<WireframeData>) {\n  return <WireframeSurfaceView data={data} ctx={ctx} />;\n}\n\n/** Full client spec for the shared `wireframe` block (schema + MDX + Read/Edit). */\nexport const wireframeBlock = defineBlock<WireframeData>({\n  type: \"wireframe\",\n  schema: wireframeSchema,\n  mdx: wireframeMdx,\n  Read: WireframeBlock,\n  Edit: WireframeEditor,\n  placement: [\"block\"],\n  editSurface: \"inline\",\n  label: \"Wireframe\",\n  description:\n    \"A sketch wireframe of one screen built from kit primitives (or an HTML mockup), rendered in a chosen surface frame (desktop/mobile/popover/panel/browser).\",\n  // `surface` is the only required field; `screen` defaults to []. Start on the\n  // desktop surface with an empty screen so the canvas/agent can fill it in.\n  empty: () => ({ surface: \"desktop\", screen: [] }),\n});\n"]}

package/dist/client/blocks/types.d.ts

@@ -291,6 +291,8 @@ export interface BlockReadProps<TData> {
     summary?: string;
     /** Injected app capabilities. */
     ctx: BlockRenderContext;
+    /** Tighten embedded visuals in dense contexts such as tabs and question cards. */
+    compactVisuals?: boolean;
 }
 /** Props passed to a block's editor (custom or schema-generated). */
 export interface BlockEditProps<TData> {

package/dist/client/blocks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"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"}

package/dist/client/blocks/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"AA4YA,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAQ,IAAsB;IACvD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { FC } from \"react\";\nimport type { ZodType } from \"zod\";\n\n/**\n * Block-registry contract. A `BlockSpec` describes one document block end to end:\n * its data shape (`schema`), how it round-trips to MDX source (`mdx`), how it\n * renders read-only (`Read`) and how it is edited (`Edit`, or an auto-generated\n * schema-driven editor when omitted), where it can be placed (`placement`), and\n * metadata for menus / agent schema export.\n *\n * The registry runs ALONGSIDE existing per-block code (the plan `PlanBlockView`\n * switch + `serializeBlock`/`parseBlock`). Renderers check the registry first;\n * unregistered block types fall through to the legacy code path unchanged. The\n * MDX `tag` and attribute shape for a converted block MUST match the historical\n * encoding (e.g. `<Callout tone>…body…</Callout>`) so stored `.mdx` files still\n * parse byte-compatibly.\n */\n\n/** Where a block can be placed in a document. */\nexport type BlockPlacement = \"block\" | \"inline\";\n\n/**\n * A serialized MDX/NFM attribute value before the shared `prop()` encoder runs.\n * `prop()` decides string-vs-JSON encoding; this is just the value domain.\n */\nexport type MdxAttrValue =\n  | string\n  | number\n  | boolean\n  | unknown[]\n  | Record<string, unknown>;\n\n/**\n * Type-narrowed reader over the resolved MDX attributes of a parsed block node.\n * The values are already estree/JSON-resolved by the shared attribute reader\n * (the same engine `plan-mdx.ts` uses), so a spec's `fromAttrs` never touches\n * the AST directly.\n */\nexport interface BlockAttrReader {\n  string(name: string): string | undefined;\n  number(name: string): number | undefined;\n  bool(name: string): boolean | undefined;\n  array<T = unknown>(name: string): T[] | undefined;\n  object<T = unknown>(name: string): T | undefined;\n  raw(name: string): unknown;\n}\n\n/**\n * Maps a block's validated data to/from its MDX component representation.\n * `tag` is the JSX component name in source (e.g. \"Callout\"). It MUST match the\n * historical name in `plan-mdx.ts` `BLOCK_COMPONENTS` / stored `.mdx` files or\n * existing plans break.\n */\nexport interface BlockMdxConfig<TData> {\n  /** JSX component name in MDX source. Stable contract — never rename. */\n  tag: string;\n  /**\n   * Encode `data` → a flat attribute bag. The registry serializer runs each\n   * value through the shared `prop()` encoder (string-vs-JSON heuristic) and\n   * preserves insertion order, so write the keys in the exact historical order.\n   * Return `undefined` for a key (or omit it) to drop the attribute. When\n   * `childrenField` is set, that field is excluded from the attribute bag.\n   */\n  toAttrs: (data: TData) => Record<string, MdxAttrValue | undefined>;\n  /**\n   * Decode resolved attributes (+ optional children markdown) → data. Must\n   * tolerate missing/partial attributes for backward-compat (mirror today's\n   * `?? []` / `?? \"\"` defaults).\n   */\n  fromAttrs: (attrs: BlockAttrReader, children: string) => TData;\n  /**\n   * When set, this data field is a markdown string serialized as MDX *children*\n   * between the open/close tags (prose-bearing blocks: rich-text, callout)\n   * rather than as a prop — so the body survives as real, inline-editable MDX\n   * prose in source.\n   */\n  childrenField?: keyof TData & string;\n  /**\n   * Opt-in custom children serializer for blocks whose internals are nested MDX\n   * components rather than a single markdown string (e.g. wireframe → Screen/kit\n   * primitives). When present it overrides `childrenField`. `serializeChildren`\n   * returns the raw inner MDX; `parseChildren` receives the child MDX AST nodes.\n   */\n  serializeChildren?: (data: TData) => string;\n  parseChildren?: (childNodes: unknown[], idContext: string) => Partial<TData>;\n}\n\n/**\n * App-injected capabilities. Core blocks stay app-agnostic by taking these\n * rather than importing app services — mirroring `createImageExtension`'s\n * `onImageUpload` injection. Provided via `BlockRegistryProvider`.\n */\nexport interface BlockRenderContext {\n  /** Markdown dialect for the auto-editor's rich-text field. */\n  dialect?: \"gfm\" | \"nfm\";\n  /** Document text direction inferred by the host app. */\n  textDirection?: \"ltr\" | \"rtl\";\n  /** Resolve an asset id → displayable URL. */\n  resolveAssetSrc?: (assetId: string) => string | undefined;\n  /** Open the shared asset picker (returns the chosen asset). */\n  pickAsset?: () => Promise<{ assetId: string; url?: string } | null>;\n  /** Upload a local file, returns a hosted URL. */\n  uploadFile?: (file: File) => Promise<{ url: string; assetId?: string }>;\n  /** Call an app action by name (for blocks that fetch live data). */\n  callAction?: (name: string, args: unknown) => Promise<unknown>;\n  /** Sanitizer for HTML-bearing blocks. Provided by the app/core. */\n  sanitizeHtml?: (html: string, css?: string) => string;\n  /**\n   * Render a markdown string with the app's read-only markdown renderer. Lets a\n   * core block (whose `Read` lives in core) defer prose rendering to the app's\n   * markdown reader (e.g. the plan `PlanMarkdownReader`) without importing it.\n   */\n  renderMarkdown?: (\n    markdown: string,\n    options?: { className?: string },\n  ) => React.ReactNode;\n  /**\n   * Static capture mode: render every code/diff line annotation as a visible\n   * inline overlay instead of requiring hover.\n   */\n  showCodeAnnotationOverlays?: boolean;\n  /**\n   * Optional placement policy for line-anchored code/diff annotations.\n   * Hosts can keep the default right-first hover behavior, or ask annotations to\n   * prefer a margin side and become persistent whenever that margin has room.\n   */\n  codeAnnotationLayout?: {\n    /** Preferred side for hover cards when that side has a clean gutter. */\n    hoverSide?: \"left\" | \"right\";\n    /**\n     * Final hover fallback when neither side has a clean gutter. `\"below\"` keeps\n     * the legacy line-below behavior; `\"left\"`/`\"right\"` overlap the card from\n     * that code edge with a small overhang.\n     */\n    hoverFallbackSide?: \"left\" | \"right\" | \"below\";\n    /** Show all annotation cards by default when the requested margin fits. */\n    showByDefaultWhenRoom?: boolean;\n    /**\n     * When margin annotations are enabled, choose how many cards become visible\n     * without hover. Defaults to all for callers using the legacy boolean.\n     */\n    defaultVisibleAnnotations?: \"all\" | \"first\";\n    /** Margin side for persistent cards; `\"auto\"` tries hoverSide, then the other side. */\n    marginSide?: \"left\" | \"right\" | \"auto\";\n  };\n  /**\n   * Render an inline, editable rich-markdown field. The auto-editor calls this\n   * for a `markdown()`-tagged field so the app owns the editor wiring (collab,\n   * autosave debounce, dialect) rather than core hardcoding it.\n   */\n  renderMarkdownEditor?: (props: {\n    value: string;\n    onChange: (next: string) => void;\n    editable: boolean;\n    blockId?: string;\n    className?: string;\n    ariaLabel?: string;\n  }) => React.ReactNode;\n  /**\n   * Render an app-owned edit-by-prompt affordance (\"Describe a change…\") for a focused/editable block\n   * field. Core block editors pass the current field value and nearby companion\n   * fields; the host app decides how to collect the prompt and route it to the\n   * agent sidebar. This keeps reusable core blocks from importing app-specific\n   * popover/composer code while still exposing a generic AI edit hook.\n   */\n  renderAiFieldAction?: (props: BlockAiFieldActionProps) => React.ReactNode;\n  /**\n   * Render a nested child block through the app's own block dispatcher. Container\n   * blocks whose `Read`/`Edit` live in core (e.g. tabs) call this to render each\n   * child so the recursion keeps flowing through the SAME app renderer the\n   * top-level document uses — registered children render via their spec, and\n   * unregistered (not-yet-converted) children still fall through the app's legacy\n   * switch. This is the coexistence seam: a core container never has to know\n   * about app-specific child block types. Returns `null`/`undefined` when no\n   * dispatcher is wired (read-only/SSR-only contexts can omit it).\n   */\n  renderBlock?: (props: {\n    block: NestedBlock;\n    /** Commit a replacement for this child block (edit mode only). */\n    onChange?: (next: NestedBlock) => void;\n    /** Whether the parent container is being edited. */\n    editing?: boolean;\n    /** Tighten embedded visuals in dense contexts (e.g. tab panes). */\n    compactVisuals?: boolean;\n  }) => React.ReactNode;\n  /**\n   * Render a nested editable block list through the host app's document editor.\n   * Container blocks such as columns call this for each editable region so slash\n   * commands, nested structured blocks, and ordinary prose behave like the\n   * top-level document while the container still persists its normalized runtime\n   * data. Source adapters may still expose a human-friendly nested MDX form\n   * (for example `<Columns><Column>markdown</Column></Columns>`) and normalize it\n   * into these block arrays at runtime.\n   */\n  renderBlocksEditor?: (props: {\n    blocks: NestedBlock[];\n    onChange: (blocks: NestedBlock[]) => void;\n    editable: boolean;\n    containerBlockId: string;\n    regionId: string;\n    regionLabel?: string;\n    /** Tighten embedded visuals in dense regions such as tab panes. */\n    compactVisuals?: boolean;\n  }) => React.ReactNode;\n  /**\n   * Wrap a block's edit form in an app-provided \"panel\" surface (e.g. a shadcn\n   * Popover anchored to the corner edit button) for `editSurface: \"panel\"`\n   * blocks. Core renders the rendered `Read` view plus a corner trigger button\n   * and the form, then hands them here so the app owns the overlay primitive\n   * (core stays shadcn-free, mirroring `renderMarkdownEditor`). When omitted, a\n   * panel-mode block falls back to inline editing. `title` is the block label.\n   */\n  renderEditSurface?: (props: {\n    title: string;\n    open?: boolean;\n    onOpenChange?: (open: boolean) => void;\n    trigger: React.ReactNode;\n    children: React.ReactNode;\n    /** Compact action menus omit host block-edit chrome such as edit-by-prompt. */\n    variant?: \"panel\" | \"menu\";\n    /** Metadata for host-provided contextual controls such as the edit-by-prompt CTA. */\n    blockId?: string;\n    blockType?: string;\n    blockTitle?: string;\n    blockSummary?: string;\n    blockData?: unknown;\n  }) => React.ReactNode;\n  /**\n   * Submit a respondent's answers from a `question-form` / `visual-questions`\n   * block back to the host. The app decides how to route the summary (e.g. send\n   * to the inline agent, copy to clipboard). Core blocks call this through the\n   * context so they never import app-specific submit wiring; omit it and the\n   * block degrades to a no-op submit.\n   */\n  onQuestionFormSubmit?: (summary: string) => void;\n}\n\nexport interface BlockAiFieldActionProps {\n  blockId: string;\n  blockType: string;\n  blockTitle?: string;\n  blockSummary?: string;\n  fieldLabel: string;\n  fieldValue: string;\n  draftScope: string;\n  disabled?: boolean;\n  /**\n   * Human-readable instructions for the host agent prompt. Mention how to patch\n   * the block and which sibling fields should be preserved.\n   */\n  instructions: string;\n  companionFields?: Array<{\n    label: string;\n    value: string;\n    language?: string;\n  }>;\n}\n\n/**\n * The minimal shape of a nested child block passed to {@link\n * BlockRenderContext.renderBlock}. It mirrors the app's block union loosely (the\n * app casts it back to its own block type) — a discriminating `type`, a stable\n * `id`, optional heading/summary, and the type-specific `data`.\n */\nexport interface NestedBlock {\n  type: string;\n  id: string;\n  title?: string;\n  summary?: string;\n  data: unknown;\n  [key: string]: unknown;\n}\n\nexport interface BlockContainerRegion {\n  id: string;\n  label?: string;\n  blocks: NestedBlock[];\n}\n\nexport interface BlockContainerSpec<TData> {\n  regions: (data: TData) => BlockContainerRegion[];\n  updateRegion: (data: TData, regionId: string, blocks: NestedBlock[]) => TData;\n  addRegion?: (data: TData, afterRegionId?: string) => TData;\n  removeRegion?: (data: TData, regionId: string) => TData;\n  reorderRegion?: (\n    data: TData,\n    fromRegionId: string,\n    toRegionId: string,\n  ) => TData;\n}\n\nexport type BlockDataChangeMeta = {\n  containerRegion?: {\n    regionId: string;\n    blocks: NestedBlock[];\n  };\n};\n\n/** Props passed to a block's read-only renderer. */\nexport interface BlockReadProps<TData> {\n  data: TData;\n  /** Stable block id (for anchors, comment targeting, source patches). */\n  blockId: string;\n  /** Block heading, when present. */\n  title?: string;\n  /** Block trailing summary, when present. */\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n}\n\n/** Props passed to a block's editor (custom or schema-generated). */\nexport interface BlockEditProps<TData> {\n  data: TData;\n  onChange: (next: TData, meta?: BlockDataChangeMeta) => void;\n  editable: boolean;\n  blockId: string;\n  title?: string;\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n}\n\nexport interface BlockSpec<TData = unknown> {\n  /** Discriminator. Equals the runtime block `type`. */\n  type: string;\n  /** Zod schema for `data`. Drives validation AND the schema-auto-editor. */\n  schema: ZodType<TData>;\n  /** MDX round-trip config. */\n  mdx: BlockMdxConfig<TData>;\n  /** Read-only renderer (replaces a `PlanBlockView` switch branch / NodeView). */\n  Read: FC<BlockReadProps<TData>>;\n  /**\n   * Optional editor. When omitted, the registry renders the schema-driven\n   * `SchemaBlockEditor` generated from `schema`. Supply for full control\n   * (wireframe canvas, diagram editor).\n   */\n  Edit?: FC<BlockEditProps<TData>>;\n  /** Allowed placements: `[\"block\"]`, `[\"inline\"]`, or both. */\n  placement: BlockPlacement[];\n  /**\n   * When `true`, this block's data maps to a Notion-Flavored-Markdown (NFM)\n   * analog and therefore round-trips into a Notion page. Apps can derive\n   * registry-backed Notion allowlists with\n   * {@link BlockRegistry.notionCompatibleTypes} instead of hand-maintaining\n   * per-app sets. Set it on registry-atom blocks with an NFM counterpart\n   * (checklist, table); leave it `false`/undefined on dev-doc blocks\n   * (api-endpoint, openapi-spec, data-model, diff, file-tree, json-explorer,\n   * annotated-code, mermaid, custom-html, tabs, code-tabs) and visual/plan-only\n   * blocks (wireframe, diagram). Prose blocks that aren't registry atoms\n   * (rich-text, callout) carry their NFM analog through the prose path, not this\n   * flag.\n   */\n  notionCompatible?: boolean;\n  /**\n   * How the block is edited in a `block`-placed document:\n   * - `\"inline\"` — the `Edit`/auto-form renders in place for direct\n   *   manipulation of authored content (prose, checklist text, table cells,\n   *   code bodies). Schema-ish metadata such as tone/type, tab labels,\n   *   language, density, or structural settings should still be tucked behind a\n   *   contextual edit/settings affordance inside the custom `Edit`.\n   * - `\"panel\"` — the block shows its rendered `Read` view with a corner edit\n   *   button that opens the `Edit`/auto-form in an app-provided panel (popover).\n   *   Best for config-driven blocks whose render differs from their props\n   *   (custom HTML, charts, any user-registered block).\n   * - `\"container\"` — the block renders its `Edit` in place, and that editor\n   *   may call `ctx.renderBlocksEditor` for nested block regions with normal\n   *   slash commands and nested structured blocks.\n   * Defaults to `\"inline\"` when a custom `Edit` is supplied, else `\"panel\"`\n   * (auto-form blocks are property forms, ideal for a panel). The app must wire\n   * `ctx.renderEditSurface` for `\"panel\"` to take effect; otherwise it falls\n   * back to inline.\n   */\n  editSurface?: \"inline\" | \"panel\" | \"container\";\n  /**\n   * Optional generic contract for content-bearing container blocks. Keep this\n   * runtime-oriented: it describes editable regions over normalized block arrays;\n   * source formats can provide readable nested MDX adapters independently.\n   */\n  container?: BlockContainerSpec<TData>;\n  /** Human label for menus + agent schema export. */\n  label: string;\n  /** Tabler icon component for UI menus (never emoji/robot/sparkle). */\n  icon?: FC<{ size?: number; className?: string }>;\n  /** One-line description for the agent schema export. */\n  description: string;\n  /** Optional default `data` factory for slash-menu insertion (an empty block). */\n  empty?: () => TData;\n  /**\n   * Optional block-specific source-patch handlers, generalizing bespoke ops\n   * like `update-custom-html`. Keyed by op name; the registry dispatches a\n   * matching patch op here. Generic ops (`update-block` shallow-merge) need none.\n   */\n  patches?: Record<string, (data: TData, op: Record<string, unknown>) => TData>;\n}\n\n/** Identity helper for authoring a spec with full type inference. */\nexport function defineBlock<TData>(spec: BlockSpec<TData>): BlockSpec<TData> {\n  return spec;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"AA8YA,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAQ,IAAsB;IACvD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { FC } from \"react\";\nimport type { ZodType } from \"zod\";\n\n/**\n * Block-registry contract. A `BlockSpec` describes one document block end to end:\n * its data shape (`schema`), how it round-trips to MDX source (`mdx`), how it\n * renders read-only (`Read`) and how it is edited (`Edit`, or an auto-generated\n * schema-driven editor when omitted), where it can be placed (`placement`), and\n * metadata for menus / agent schema export.\n *\n * The registry runs ALONGSIDE existing per-block code (the plan `PlanBlockView`\n * switch + `serializeBlock`/`parseBlock`). Renderers check the registry first;\n * unregistered block types fall through to the legacy code path unchanged. The\n * MDX `tag` and attribute shape for a converted block MUST match the historical\n * encoding (e.g. `<Callout tone>…body…</Callout>`) so stored `.mdx` files still\n * parse byte-compatibly.\n */\n\n/** Where a block can be placed in a document. */\nexport type BlockPlacement = \"block\" | \"inline\";\n\n/**\n * A serialized MDX/NFM attribute value before the shared `prop()` encoder runs.\n * `prop()` decides string-vs-JSON encoding; this is just the value domain.\n */\nexport type MdxAttrValue =\n  | string\n  | number\n  | boolean\n  | unknown[]\n  | Record<string, unknown>;\n\n/**\n * Type-narrowed reader over the resolved MDX attributes of a parsed block node.\n * The values are already estree/JSON-resolved by the shared attribute reader\n * (the same engine `plan-mdx.ts` uses), so a spec's `fromAttrs` never touches\n * the AST directly.\n */\nexport interface BlockAttrReader {\n  string(name: string): string | undefined;\n  number(name: string): number | undefined;\n  bool(name: string): boolean | undefined;\n  array<T = unknown>(name: string): T[] | undefined;\n  object<T = unknown>(name: string): T | undefined;\n  raw(name: string): unknown;\n}\n\n/**\n * Maps a block's validated data to/from its MDX component representation.\n * `tag` is the JSX component name in source (e.g. \"Callout\"). It MUST match the\n * historical name in `plan-mdx.ts` `BLOCK_COMPONENTS` / stored `.mdx` files or\n * existing plans break.\n */\nexport interface BlockMdxConfig<TData> {\n  /** JSX component name in MDX source. Stable contract — never rename. */\n  tag: string;\n  /**\n   * Encode `data` → a flat attribute bag. The registry serializer runs each\n   * value through the shared `prop()` encoder (string-vs-JSON heuristic) and\n   * preserves insertion order, so write the keys in the exact historical order.\n   * Return `undefined` for a key (or omit it) to drop the attribute. When\n   * `childrenField` is set, that field is excluded from the attribute bag.\n   */\n  toAttrs: (data: TData) => Record<string, MdxAttrValue | undefined>;\n  /**\n   * Decode resolved attributes (+ optional children markdown) → data. Must\n   * tolerate missing/partial attributes for backward-compat (mirror today's\n   * `?? []` / `?? \"\"` defaults).\n   */\n  fromAttrs: (attrs: BlockAttrReader, children: string) => TData;\n  /**\n   * When set, this data field is a markdown string serialized as MDX *children*\n   * between the open/close tags (prose-bearing blocks: rich-text, callout)\n   * rather than as a prop — so the body survives as real, inline-editable MDX\n   * prose in source.\n   */\n  childrenField?: keyof TData & string;\n  /**\n   * Opt-in custom children serializer for blocks whose internals are nested MDX\n   * components rather than a single markdown string (e.g. wireframe → Screen/kit\n   * primitives). When present it overrides `childrenField`. `serializeChildren`\n   * returns the raw inner MDX; `parseChildren` receives the child MDX AST nodes.\n   */\n  serializeChildren?: (data: TData) => string;\n  parseChildren?: (childNodes: unknown[], idContext: string) => Partial<TData>;\n}\n\n/**\n * App-injected capabilities. Core blocks stay app-agnostic by taking these\n * rather than importing app services — mirroring `createImageExtension`'s\n * `onImageUpload` injection. Provided via `BlockRegistryProvider`.\n */\nexport interface BlockRenderContext {\n  /** Markdown dialect for the auto-editor's rich-text field. */\n  dialect?: \"gfm\" | \"nfm\";\n  /** Document text direction inferred by the host app. */\n  textDirection?: \"ltr\" | \"rtl\";\n  /** Resolve an asset id → displayable URL. */\n  resolveAssetSrc?: (assetId: string) => string | undefined;\n  /** Open the shared asset picker (returns the chosen asset). */\n  pickAsset?: () => Promise<{ assetId: string; url?: string } | null>;\n  /** Upload a local file, returns a hosted URL. */\n  uploadFile?: (file: File) => Promise<{ url: string; assetId?: string }>;\n  /** Call an app action by name (for blocks that fetch live data). */\n  callAction?: (name: string, args: unknown) => Promise<unknown>;\n  /** Sanitizer for HTML-bearing blocks. Provided by the app/core. */\n  sanitizeHtml?: (html: string, css?: string) => string;\n  /**\n   * Render a markdown string with the app's read-only markdown renderer. Lets a\n   * core block (whose `Read` lives in core) defer prose rendering to the app's\n   * markdown reader (e.g. the plan `PlanMarkdownReader`) without importing it.\n   */\n  renderMarkdown?: (\n    markdown: string,\n    options?: { className?: string },\n  ) => React.ReactNode;\n  /**\n   * Static capture mode: render every code/diff line annotation as a visible\n   * inline overlay instead of requiring hover.\n   */\n  showCodeAnnotationOverlays?: boolean;\n  /**\n   * Optional placement policy for line-anchored code/diff annotations.\n   * Hosts can keep the default right-first hover behavior, or ask annotations to\n   * prefer a margin side and become persistent whenever that margin has room.\n   */\n  codeAnnotationLayout?: {\n    /** Preferred side for hover cards when that side has a clean gutter. */\n    hoverSide?: \"left\" | \"right\";\n    /**\n     * Final hover fallback when neither side has a clean gutter. `\"below\"` keeps\n     * the legacy line-below behavior; `\"left\"`/`\"right\"` overlap the card from\n     * that code edge with a small overhang.\n     */\n    hoverFallbackSide?: \"left\" | \"right\" | \"below\";\n    /** Show all annotation cards by default when the requested margin fits. */\n    showByDefaultWhenRoom?: boolean;\n    /**\n     * When margin annotations are enabled, choose how many cards become visible\n     * without hover. Defaults to all for callers using the legacy boolean.\n     */\n    defaultVisibleAnnotations?: \"all\" | \"first\";\n    /** Margin side for persistent cards; `\"auto\"` tries hoverSide, then the other side. */\n    marginSide?: \"left\" | \"right\" | \"auto\";\n  };\n  /**\n   * Render an inline, editable rich-markdown field. The auto-editor calls this\n   * for a `markdown()`-tagged field so the app owns the editor wiring (collab,\n   * autosave debounce, dialect) rather than core hardcoding it.\n   */\n  renderMarkdownEditor?: (props: {\n    value: string;\n    onChange: (next: string) => void;\n    editable: boolean;\n    blockId?: string;\n    className?: string;\n    ariaLabel?: string;\n  }) => React.ReactNode;\n  /**\n   * Render an app-owned edit-by-prompt affordance (\"Describe a change…\") for a focused/editable block\n   * field. Core block editors pass the current field value and nearby companion\n   * fields; the host app decides how to collect the prompt and route it to the\n   * agent sidebar. This keeps reusable core blocks from importing app-specific\n   * popover/composer code while still exposing a generic AI edit hook.\n   */\n  renderAiFieldAction?: (props: BlockAiFieldActionProps) => React.ReactNode;\n  /**\n   * Render a nested child block through the app's own block dispatcher. Container\n   * blocks whose `Read`/`Edit` live in core (e.g. tabs) call this to render each\n   * child so the recursion keeps flowing through the SAME app renderer the\n   * top-level document uses — registered children render via their spec, and\n   * unregistered (not-yet-converted) children still fall through the app's legacy\n   * switch. This is the coexistence seam: a core container never has to know\n   * about app-specific child block types. Returns `null`/`undefined` when no\n   * dispatcher is wired (read-only/SSR-only contexts can omit it).\n   */\n  renderBlock?: (props: {\n    block: NestedBlock;\n    /** Commit a replacement for this child block (edit mode only). */\n    onChange?: (next: NestedBlock) => void;\n    /** Whether the parent container is being edited. */\n    editing?: boolean;\n    /** Tighten embedded visuals in dense contexts (e.g. tab panes). */\n    compactVisuals?: boolean;\n  }) => React.ReactNode;\n  /**\n   * Render a nested editable block list through the host app's document editor.\n   * Container blocks such as columns call this for each editable region so slash\n   * commands, nested structured blocks, and ordinary prose behave like the\n   * top-level document while the container still persists its normalized runtime\n   * data. Source adapters may still expose a human-friendly nested MDX form\n   * (for example `<Columns><Column>markdown</Column></Columns>`) and normalize it\n   * into these block arrays at runtime.\n   */\n  renderBlocksEditor?: (props: {\n    blocks: NestedBlock[];\n    onChange: (blocks: NestedBlock[]) => void;\n    editable: boolean;\n    containerBlockId: string;\n    regionId: string;\n    regionLabel?: string;\n    /** Tighten embedded visuals in dense regions such as tab panes. */\n    compactVisuals?: boolean;\n  }) => React.ReactNode;\n  /**\n   * Wrap a block's edit form in an app-provided \"panel\" surface (e.g. a shadcn\n   * Popover anchored to the corner edit button) for `editSurface: \"panel\"`\n   * blocks. Core renders the rendered `Read` view plus a corner trigger button\n   * and the form, then hands them here so the app owns the overlay primitive\n   * (core stays shadcn-free, mirroring `renderMarkdownEditor`). When omitted, a\n   * panel-mode block falls back to inline editing. `title` is the block label.\n   */\n  renderEditSurface?: (props: {\n    title: string;\n    open?: boolean;\n    onOpenChange?: (open: boolean) => void;\n    trigger: React.ReactNode;\n    children: React.ReactNode;\n    /** Compact action menus omit host block-edit chrome such as edit-by-prompt. */\n    variant?: \"panel\" | \"menu\";\n    /** Metadata for host-provided contextual controls such as the edit-by-prompt CTA. */\n    blockId?: string;\n    blockType?: string;\n    blockTitle?: string;\n    blockSummary?: string;\n    blockData?: unknown;\n  }) => React.ReactNode;\n  /**\n   * Submit a respondent's answers from a `question-form` / `visual-questions`\n   * block back to the host. The app decides how to route the summary (e.g. send\n   * to the inline agent, copy to clipboard). Core blocks call this through the\n   * context so they never import app-specific submit wiring; omit it and the\n   * block degrades to a no-op submit.\n   */\n  onQuestionFormSubmit?: (summary: string) => void;\n}\n\nexport interface BlockAiFieldActionProps {\n  blockId: string;\n  blockType: string;\n  blockTitle?: string;\n  blockSummary?: string;\n  fieldLabel: string;\n  fieldValue: string;\n  draftScope: string;\n  disabled?: boolean;\n  /**\n   * Human-readable instructions for the host agent prompt. Mention how to patch\n   * the block and which sibling fields should be preserved.\n   */\n  instructions: string;\n  companionFields?: Array<{\n    label: string;\n    value: string;\n    language?: string;\n  }>;\n}\n\n/**\n * The minimal shape of a nested child block passed to {@link\n * BlockRenderContext.renderBlock}. It mirrors the app's block union loosely (the\n * app casts it back to its own block type) — a discriminating `type`, a stable\n * `id`, optional heading/summary, and the type-specific `data`.\n */\nexport interface NestedBlock {\n  type: string;\n  id: string;\n  title?: string;\n  summary?: string;\n  data: unknown;\n  [key: string]: unknown;\n}\n\nexport interface BlockContainerRegion {\n  id: string;\n  label?: string;\n  blocks: NestedBlock[];\n}\n\nexport interface BlockContainerSpec<TData> {\n  regions: (data: TData) => BlockContainerRegion[];\n  updateRegion: (data: TData, regionId: string, blocks: NestedBlock[]) => TData;\n  addRegion?: (data: TData, afterRegionId?: string) => TData;\n  removeRegion?: (data: TData, regionId: string) => TData;\n  reorderRegion?: (\n    data: TData,\n    fromRegionId: string,\n    toRegionId: string,\n  ) => TData;\n}\n\nexport type BlockDataChangeMeta = {\n  containerRegion?: {\n    regionId: string;\n    blocks: NestedBlock[];\n  };\n};\n\n/** Props passed to a block's read-only renderer. */\nexport interface BlockReadProps<TData> {\n  data: TData;\n  /** Stable block id (for anchors, comment targeting, source patches). */\n  blockId: string;\n  /** Block heading, when present. */\n  title?: string;\n  /** Block trailing summary, when present. */\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n  /** Tighten embedded visuals in dense contexts such as tabs and question cards. */\n  compactVisuals?: boolean;\n}\n\n/** Props passed to a block's editor (custom or schema-generated). */\nexport interface BlockEditProps<TData> {\n  data: TData;\n  onChange: (next: TData, meta?: BlockDataChangeMeta) => void;\n  editable: boolean;\n  blockId: string;\n  title?: string;\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n}\n\nexport interface BlockSpec<TData = unknown> {\n  /** Discriminator. Equals the runtime block `type`. */\n  type: string;\n  /** Zod schema for `data`. Drives validation AND the schema-auto-editor. */\n  schema: ZodType<TData>;\n  /** MDX round-trip config. */\n  mdx: BlockMdxConfig<TData>;\n  /** Read-only renderer (replaces a `PlanBlockView` switch branch / NodeView). */\n  Read: FC<BlockReadProps<TData>>;\n  /**\n   * Optional editor. When omitted, the registry renders the schema-driven\n   * `SchemaBlockEditor` generated from `schema`. Supply for full control\n   * (wireframe canvas, diagram editor).\n   */\n  Edit?: FC<BlockEditProps<TData>>;\n  /** Allowed placements: `[\"block\"]`, `[\"inline\"]`, or both. */\n  placement: BlockPlacement[];\n  /**\n   * When `true`, this block's data maps to a Notion-Flavored-Markdown (NFM)\n   * analog and therefore round-trips into a Notion page. Apps can derive\n   * registry-backed Notion allowlists with\n   * {@link BlockRegistry.notionCompatibleTypes} instead of hand-maintaining\n   * per-app sets. Set it on registry-atom blocks with an NFM counterpart\n   * (checklist, table); leave it `false`/undefined on dev-doc blocks\n   * (api-endpoint, openapi-spec, data-model, diff, file-tree, json-explorer,\n   * annotated-code, mermaid, custom-html, tabs, code-tabs) and visual/plan-only\n   * blocks (wireframe, diagram). Prose blocks that aren't registry atoms\n   * (rich-text, callout) carry their NFM analog through the prose path, not this\n   * flag.\n   */\n  notionCompatible?: boolean;\n  /**\n   * How the block is edited in a `block`-placed document:\n   * - `\"inline\"` — the `Edit`/auto-form renders in place for direct\n   *   manipulation of authored content (prose, checklist text, table cells,\n   *   code bodies). Schema-ish metadata such as tone/type, tab labels,\n   *   language, density, or structural settings should still be tucked behind a\n   *   contextual edit/settings affordance inside the custom `Edit`.\n   * - `\"panel\"` — the block shows its rendered `Read` view with a corner edit\n   *   button that opens the `Edit`/auto-form in an app-provided panel (popover).\n   *   Best for config-driven blocks whose render differs from their props\n   *   (custom HTML, charts, any user-registered block).\n   * - `\"container\"` — the block renders its `Edit` in place, and that editor\n   *   may call `ctx.renderBlocksEditor` for nested block regions with normal\n   *   slash commands and nested structured blocks.\n   * Defaults to `\"inline\"` when a custom `Edit` is supplied, else `\"panel\"`\n   * (auto-form blocks are property forms, ideal for a panel). The app must wire\n   * `ctx.renderEditSurface` for `\"panel\"` to take effect; otherwise it falls\n   * back to inline.\n   */\n  editSurface?: \"inline\" | \"panel\" | \"container\";\n  /**\n   * Optional generic contract for content-bearing container blocks. Keep this\n   * runtime-oriented: it describes editable regions over normalized block arrays;\n   * source formats can provide readable nested MDX adapters independently.\n   */\n  container?: BlockContainerSpec<TData>;\n  /** Human label for menus + agent schema export. */\n  label: string;\n  /** Tabler icon component for UI menus (never emoji/robot/sparkle). */\n  icon?: FC<{ size?: number; className?: string }>;\n  /** One-line description for the agent schema export. */\n  description: string;\n  /** Optional default `data` factory for slash-menu insertion (an empty block). */\n  empty?: () => TData;\n  /**\n   * Optional block-specific source-patch handlers, generalizing bespoke ops\n   * like `update-custom-html`. Keyed by op name; the registry dispatches a\n   * matching patch op here. Generic ops (`update-block` shallow-merge) need none.\n   */\n  patches?: Record<string, (data: TData, op: Record<string, unknown>) => TData>;\n}\n\n/** Identity helper for authoring a spec with full type inference. */\nexport function defineBlock<TData>(spec: BlockSpec<TData>): BlockSpec<TData> {\n  return spec;\n}\n"]}

package/dist/client/chat/run-recovery.d.ts

@@ -18,10 +18,12 @@ export declare function BuilderConnectCta({ variant, onConnected, }: {
 export declare function ApiKeyConnect({ onConnected }: {
     onConnected?: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, }: {
+export type BuilderSetupCardLayout = "default" | "sidebar";
+export declare function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, layout, }: {
     onConnected?: () => void;
     bouncePulse?: number;
     fullWidth?: boolean;
+    layout?: BuilderSetupCardLayout;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDismiss, }: {
     info: RunErrorInfo;

package/dist/client/chat/run-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-recovery.d.ts","sourceRoot":"","sources":["../../../src/client/chat/run-recovery.tsx"],"names":[],"mappings":"AAmCA,MAAM,MAAM,aAAa,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAgBF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAc3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAgCzE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,GACf,KAAK,GAAG,MAAM,GAAG,IAAI,CASvB;AA4DD,wBAAgB,iBAAiB,CAAC,EAChC,OAAmB,EACnB,WAAW,GACZ,EAAE;IACD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B,2CAgGA;AAaD,wBAAgB,aAAa,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,2CAoG1E;AAID,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACX,WAAW,EACX,SAAS,GACV,EAAE;IACD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,2CA0DA;AAID,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;IACD,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IACxD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,2CAgNA;AAID,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAU,GACX,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,2CA0KA;AAID,wBAAgB,eAAe,CAAC,EAC9B,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,EAAE;IACD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,2CAyCA"}
+{"version":3,"file":"run-recovery.d.ts","sourceRoot":"","sources":["../../../src/client/chat/run-recovery.tsx"],"names":[],"mappings":"AAmCA,MAAM,MAAM,aAAa,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAgBF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAc3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAgCzE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,GACf,KAAK,GAAG,MAAM,GAAG,IAAI,CASvB;AA4DD,wBAAgB,iBAAiB,CAAC,EAChC,OAAmB,EACnB,WAAW,GACZ,EAAE;IACD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B,2CAgGA;AAaD,wBAAgB,aAAa,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,2CAoG1E;AAID,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,EAC/B,WAAW,EACX,WAAW,EACX,SAAS,EACT,MAAkB,GACnB,EAAE;IACD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC,2CAyEA;AAID,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,GACV,EAAE;IACD,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;IACxD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,2CAgNA;AAID,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAU,GACX,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,2CA0KA;AAID,wBAAgB,eAAe,CAAC,EAC9B,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,EAAE;IACD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,2CAyCA"}

package/dist/client/chat/run-recovery.js

@@ -164,11 +164,11 @@ export function ApiKeyConnect({ onConnected }) {
                             }
                         }, className: "h-8 min-w-0 flex-1 rounded-md border border-input bg-background px-2.5 text-[12px] text-foreground placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-1 focus:ring-offset-background" }), _jsx("button", { type: "button", onClick: handleSave, disabled: !apiKey.trim() || saving, className: "inline-flex h-8 shrink-0 items-center gap-1 rounded-md bg-foreground px-3 text-[11px] font-medium text-background hover:opacity-90 disabled:cursor-not-allowed disabled:opacity-60", children: saving ? (_jsxs(_Fragment, { children: [_jsx(IconLoader2, { size: 11, className: "animate-spin" }), "Saving\u2026"] })) : ("Save") })] }), error ? (_jsx("p", { className: "mt-2 text-[11px] text-destructive", children: error })) : null] }));
 }
-// ─── BuilderSetupCard ─────────────────────────────────────────────────────────
-export function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, }) {
+export function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, layout = "default", }) {
     // Progressive disclosure: the card leads with one-click Builder connect while
     // keeping the bring-your-own-key path close by.
     const [keyOpen, setKeyOpen] = useState(false);
+    const sidebarLayout = layout === "sidebar";
     const cardRef = useRef(null);
     // Replay the bounce keyframe each time bouncePulse increments. Toggling the
     // class off-then-on (with a forced reflow) restarts the animation even when
@@ -183,9 +183,15 @@ export function BuilderSetupCard({ onConnected, bouncePulse, fullWidth, }) {
         void el.offsetWidth;
         el.classList.add("animate-bounce-once");
     }, [bouncePulse]);
-    return (_jsx("div", { ref: cardRef, className: fullWidth
+    return (_jsx("div", { ref: cardRef, className: cn(fullWidth
             ? "w-full pb-2"
-            : "mx-auto w-full max-w-[42rem] px-3 pb-2 sm:w-fit", children: _jsxs("div", { className: "rounded-lg border border-border/80 bg-background/80 p-3 shadow-sm backdrop-blur", children: [_jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "min-w-0", children: [_jsx("h3", { className: "text-[13px] font-medium text-foreground", children: "Connect AI" }), _jsx("p", { className: "mt-0.5 text-[11px] leading-relaxed text-muted-foreground", children: "Use Builder.io (free credits), or add an Anthropic/OpenAI key." })] }), _jsxs("div", { className: "flex shrink-0 flex-nowrap items-center gap-2", children: [_jsx(BuilderConnectCta, { variant: "compact", onConnected: onConnected }), _jsx("button", { type: "button", onClick: () => setKeyOpen((open) => !open), className: "inline-flex h-8 shrink-0 items-center whitespace-nowrap rounded-md border border-border bg-background px-3 text-[11px] font-medium text-foreground hover:bg-accent", "aria-expanded": keyOpen, children: "Use API key" })] })] }), keyOpen ? (_jsx("div", { className: "mt-3", children: _jsx(ApiKeyConnect, { onConnected: onConnected }) })) : null] }) }));
+            : sidebarLayout
+                ? "mx-auto w-full max-w-[42rem] px-3 pb-2"
+                : "mx-auto w-full max-w-[42rem] px-3 pb-2 sm:w-fit"), children: _jsxs("div", { className: "rounded-lg border border-border/80 bg-background/80 p-3 shadow-sm backdrop-blur", children: [_jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between", children: [_jsxs("div", { className: "min-w-0", children: [_jsx("h3", { className: "text-[13px] font-medium text-foreground", children: "Connect AI" }), _jsx("p", { className: "mt-0.5 text-[11px] leading-relaxed text-muted-foreground", children: "Use Builder.io (free credits), or add an Anthropic/OpenAI key." })] }), _jsxs("div", { className: cn("flex shrink-0", sidebarLayout
+                                ? "flex-col items-start gap-0 sm:items-center"
+                                : "flex-nowrap items-center gap-2"), children: [_jsx(BuilderConnectCta, { variant: "compact", onConnected: onConnected }), _jsx("button", { type: "button", onClick: () => setKeyOpen((open) => !open), className: cn("inline-flex shrink-0 items-center whitespace-nowrap rounded-md text-[11px] font-medium", sidebarLayout
+                                        ? "h-7 border-0 bg-transparent px-0 text-muted-foreground hover:bg-transparent hover:text-foreground"
+                                        : "h-8 border border-border bg-background px-3 text-foreground hover:bg-accent"), "aria-expanded": keyOpen, children: sidebarLayout ? "Or, use API key" : "Use API key" })] })] }), keyOpen ? (_jsx("div", { className: "mt-3", children: _jsx(ApiKeyConnect, { onConnected: onConnected }) })) : null] }) }));
 }
 // ─── RunErrorRecoveryCard ─────────────────────────────────────────────────────
 export function RunErrorRecoveryCard({ info, onContinue, onRetry, onFork, onDismiss, }) {