@agent-native/core 0.41.1 → 0.43.0

package/dist/client/blocks/library/annotation-rail.d.ts

@@ -0,0 +1,115 @@
+import { type ReactNode } from "react";
+import type { BlockRenderContext } from "../types.js";
+/**
+ * Shared line-anchored annotation UI for the `annotated-code` and `diff` blocks.
+ *
+ * Both blocks render a numbered code surface plus a side "rail" of notes, where
+ * each note targets a 1-based `lines` ref (`"3"` or `"3-5"`) and hovering a code
+ * line ↔ its note cross-highlights. This module owns the pure pieces that were
+ * identical between them so neither block forks the behavior:
+ *
+ *  - `parseLineRange` — the forgiving 1-based `lines` range parser.
+ *  - `resolveAnnotations` / `buildLineMarkerMap` — turn a raw annotation list
+ *    into stable, marker-numbered, range-resolved records and a line→markers map.
+ *  - `rangeLabel` — the human "Line 8" / "Lines 3–6" label.
+ *  - `AnnotationGutterMarker` — the numbered amber pip placed on an annotated row
+ *    (used by the diff grid; the annotated-code surface uses its own rail bar).
+ *  - `AnnotationNoteRail` — the responsive list of note cards with two-way hover.
+ *    `showMarker` opts the diff block into a leading numbered pip on each card so
+ *    a note can be matched to its `①`/`②` row marker; annotated-code omits it to
+ *    keep its original card chrome.
+ *
+ * `AnnotatedCodeBlock` annotates a single code surface; `DiffBlock` annotates a
+ * before/after grid (each annotation also carries a `side`). The shared types
+ * here are intentionally minimal — callers pass their own `side` handling and
+ * decide which rows a marker lands on; this module only owns the parsing, the
+ * resolved-record shape, and the rendered marker + rail chrome.
+ */
+/**
+ * Parse a 1-based `lines` ref (`"3"` or `"3-5"`) into an inclusive `[start,end]`
+ * pair, clamped to `[1, lineCount]`. Returns `null` for malformed or fully
+ * out-of-range refs so callers can ignore them gracefully. A reversed range
+ * (`"5-3"`) is normalized; a partially out-of-range range is clamped.
+ */
+export declare function parseLineRange(ref: string, lineCount: number): {
+    start: number;
+    end: number;
+} | null;
+/** The minimal annotation shape the rail needs (a superset works too). */
+export interface RailAnnotation {
+    lines: string;
+    label?: string;
+    note: string;
+}
+export interface ResolvedAnnotation<A extends RailAnnotation = RailAnnotation> {
+    /** Index in the original `annotations` array (stable hover key). */
+    index: number;
+    /** 1-based marker number (authoring order). */
+    marker: number;
+    annotation: A;
+    range: {
+        start: number;
+        end: number;
+    } | null;
+}
+/**
+ * Resolve a raw annotation list into stable, marker-numbered records, parsing
+ * each `lines` ref against `lineCount`. `lineCountFor` lets the diff block pick a
+ * per-annotation line count (before-side vs after-side); annotated-code passes a
+ * single constant. Markers are authoring-order, 1-based, and assigned to ALL
+ * annotations (even unresolved ones) so numbering is stable regardless of which
+ * refs happen to match.
+ */
+export declare function resolveAnnotations<A extends RailAnnotation>(annotations: A[] | undefined, lineCountFor: (annotation: A) => number): ResolvedAnnotation<A>[];
+/** Map a 1-based line number → the resolved annotations covering it. */
+export declare function buildLineMarkerMap<A extends RailAnnotation>(resolved: ResolvedAnnotation<A>[]): Map<number, ResolvedAnnotation<A>[]>;
+/** Human label for a resolved annotation's line span ("Line 8" / "Lines 3–6"). */
+export declare function rangeLabel(item: ResolvedAnnotation): string;
+/**
+ * The numbered amber pip rendered on an annotated code row's gutter. `active`
+ * brightens it when its note (or a co-located row) is hovered.
+ */
+export declare function AnnotationGutterMarker({ marker, active, className, }: {
+    marker: number;
+    active: boolean;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * The responsive list of line-anchored note cards. Each card shows its marker
+ * pip, the resolved line span ("Line 8"), an optional label, and the markdown
+ * `note` (via `ctx.renderMarkdown`). Hovering a card sets the active index;
+ * `activeIndex` driven from outside lets a hovered code row light its card and
+ * vice-versa. Only annotations whose `range` resolved are listed.
+ */
+export declare function AnnotationNoteRail<A extends RailAnnotation>({ items, activeIndex, onActiveChange, ctx, className, showMarker, }: {
+    items: ResolvedAnnotation<A>[];
+    activeIndex: number | null;
+    onActiveChange: (index: number | null) => void;
+    ctx: BlockRenderContext;
+    className?: string;
+    /** Show a leading numbered pip on each card (diff block). */
+    showMarker?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * A single line-anchored note rendered INLINE in the diff flow — full-width,
+ * directly under the line it annotates — instead of in a side rail (the
+ * GitHub-review affordance). The diff block places one of these after the first
+ * row of each annotation's range, so the numbered `①`/`②` row marker and the note
+ * read together in one column. It carries the same marker pip, line range,
+ * optional label, and markdown `note` as a rail card, and the same two-way hover
+ * wiring (`active` / `onActiveChange`) so the row and its note cross-highlight.
+ *
+ * The outer band is `min-w-full` so the amber wash spans the diff's full scroll
+ * width; the content is `sticky left-0` with a readable `max-w` so the note stays
+ * pinned and legible while long code lines scroll horizontally beneath it.
+ */
+export declare function InlineAnnotationNote<A extends RailAnnotation>({ item, active, onActiveChange, ctx, }: {
+    item: ResolvedAnnotation<A>;
+    active: boolean;
+    onActiveChange: (index: number | null) => void;
+    ctx: BlockRenderContext;
+}): import("react/jsx-runtime").JSX.Element;
+/** Whether a resolved list has at least one note worth rendering a rail for. */
+export declare function hasRailAnnotations(items: ResolvedAnnotation[]): boolean;
+export type AnnotationRailChildren = ReactNode;
+//# sourceMappingURL=annotation-rail.d.ts.map

package/dist/client/blocks/library/annotation-rail.d.ts.map

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

package/dist/client/blocks/library/annotation-rail.js

@@ -0,0 +1,139 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { cn } from "../../utils.js";
+/**
+ * Shared line-anchored annotation UI for the `annotated-code` and `diff` blocks.
+ *
+ * Both blocks render a numbered code surface plus a side "rail" of notes, where
+ * each note targets a 1-based `lines` ref (`"3"` or `"3-5"`) and hovering a code
+ * line ↔ its note cross-highlights. This module owns the pure pieces that were
+ * identical between them so neither block forks the behavior:
+ *
+ *  - `parseLineRange` — the forgiving 1-based `lines` range parser.
+ *  - `resolveAnnotations` / `buildLineMarkerMap` — turn a raw annotation list
+ *    into stable, marker-numbered, range-resolved records and a line→markers map.
+ *  - `rangeLabel` — the human "Line 8" / "Lines 3–6" label.
+ *  - `AnnotationGutterMarker` — the numbered amber pip placed on an annotated row
+ *    (used by the diff grid; the annotated-code surface uses its own rail bar).
+ *  - `AnnotationNoteRail` — the responsive list of note cards with two-way hover.
+ *    `showMarker` opts the diff block into a leading numbered pip on each card so
+ *    a note can be matched to its `①`/`②` row marker; annotated-code omits it to
+ *    keep its original card chrome.
+ *
+ * `AnnotatedCodeBlock` annotates a single code surface; `DiffBlock` annotates a
+ * before/after grid (each annotation also carries a `side`). The shared types
+ * here are intentionally minimal — callers pass their own `side` handling and
+ * decide which rows a marker lands on; this module only owns the parsing, the
+ * resolved-record shape, and the rendered marker + rail chrome.
+ */
+/* ── Line-ref parsing ──────────────────────────────────────────────────────── */
+/**
+ * Parse a 1-based `lines` ref (`"3"` or `"3-5"`) into an inclusive `[start,end]`
+ * pair, clamped to `[1, lineCount]`. Returns `null` for malformed or fully
+ * out-of-range refs so callers can ignore them gracefully. A reversed range
+ * (`"5-3"`) is normalized; a partially out-of-range range is clamped.
+ */
+export function parseLineRange(ref, lineCount) {
+    const match = /^\s*(\d+)\s*(?:-\s*(\d+)\s*)?$/.exec(ref);
+    if (!match)
+        return null;
+    let start = Number.parseInt(match[1], 10);
+    let end = match[2] != null ? Number.parseInt(match[2], 10) : start;
+    if (!Number.isFinite(start) || !Number.isFinite(end))
+        return null;
+    if (start > end)
+        [start, end] = [end, start];
+    // Fully outside the file → ignore.
+    if (end < 1 || start > lineCount)
+        return null;
+    return { start: Math.max(1, start), end: Math.min(lineCount, end) };
+}
+/**
+ * Resolve a raw annotation list into stable, marker-numbered records, parsing
+ * each `lines` ref against `lineCount`. `lineCountFor` lets the diff block pick a
+ * per-annotation line count (before-side vs after-side); annotated-code passes a
+ * single constant. Markers are authoring-order, 1-based, and assigned to ALL
+ * annotations (even unresolved ones) so numbering is stable regardless of which
+ * refs happen to match.
+ */
+export function resolveAnnotations(annotations, lineCountFor) {
+    return (annotations ?? []).map((annotation, index) => ({
+        index,
+        marker: index + 1,
+        annotation,
+        range: parseLineRange(annotation.lines, lineCountFor(annotation)),
+    }));
+}
+/** Map a 1-based line number → the resolved annotations covering it. */
+export function buildLineMarkerMap(resolved) {
+    const map = new Map();
+    for (const item of resolved) {
+        if (!item.range)
+            continue;
+        for (let n = item.range.start; n <= item.range.end; n += 1) {
+            const list = map.get(n) ?? [];
+            list.push(item);
+            map.set(n, list);
+        }
+    }
+    return map;
+}
+/** Human label for a resolved annotation's line span ("Line 8" / "Lines 3–6"). */
+export function rangeLabel(item) {
+    if (!item.range)
+        return `Lines ${item.annotation.lines}`;
+    return item.range.start === item.range.end
+        ? `Line ${item.range.start}`
+        : `Lines ${item.range.start}–${item.range.end}`;
+}
+/* ── Marker ────────────────────────────────────────────────────────────────── */
+/**
+ * The numbered amber pip rendered on an annotated code row's gutter. `active`
+ * brightens it when its note (or a co-located row) is hovered.
+ */
+export function AnnotationGutterMarker({ marker, active, className, }) {
+    return (_jsx("span", { "aria-hidden": true, className: cn("inline-flex size-[15px] shrink-0 items-center justify-center rounded-full text-[9px] font-semibold leading-none tabular-nums transition-colors", active
+            ? "bg-amber-500 text-white dark:bg-amber-400 dark:text-amber-950"
+            : "bg-amber-400/25 text-amber-700 dark:bg-amber-300/20 dark:text-amber-300", className), children: marker }));
+}
+/* ── Note rail ─────────────────────────────────────────────────────────────── */
+/**
+ * The responsive list of line-anchored note cards. Each card shows its marker
+ * pip, the resolved line span ("Line 8"), an optional label, and the markdown
+ * `note` (via `ctx.renderMarkdown`). Hovering a card sets the active index;
+ * `activeIndex` driven from outside lets a hovered code row light its card and
+ * vice-versa. Only annotations whose `range` resolved are listed.
+ */
+export function AnnotationNoteRail({ items, activeIndex, onActiveChange, ctx, className, showMarker = false, }) {
+    const sideAnnotations = useMemo(() => items.filter((item) => item.range), [items]);
+    return (_jsx("div", { className: cn("flex flex-col gap-2.5", className), children: sideAnnotations.map((item) => {
+            const isActive = activeIndex === item.index;
+            return (_jsxs("div", { onMouseEnter: () => onActiveChange(item.index), onMouseLeave: () => onActiveChange(null), className: cn("rounded-lg border px-3.5 py-2.5 transition-colors", isActive
+                    ? "border-amber-400/70 bg-amber-50 dark:border-amber-300/40 dark:bg-amber-300/[0.08]"
+                    : "border-plan-line bg-plan-block/40 hover:border-amber-400/50"), children: [_jsxs("div", { className: cn("flex flex-wrap gap-x-2 gap-y-0.5", showMarker ? "items-center" : "items-baseline"), children: [showMarker && (_jsx(AnnotationGutterMarker, { marker: item.marker, active: isActive })), _jsx("span", { className: "text-[11px] font-semibold uppercase tracking-wide text-plan-muted", children: rangeLabel(item) }), item.annotation.label && (_jsx("span", { className: "text-[13px] font-semibold text-plan-text", children: item.annotation.label }))] }), _jsx("div", { className: "plan-annotation-note mt-1 text-[13px] leading-relaxed text-plan-text/85", children: ctx.renderMarkdown ? (ctx.renderMarkdown(item.annotation.note)) : (_jsx("p", { children: item.annotation.note })) })] }, item.index));
+        }) }));
+}
+/* ── Inline note (GitHub-style) ─────────────────────────────────────────────── */
+/**
+ * A single line-anchored note rendered INLINE in the diff flow — full-width,
+ * directly under the line it annotates — instead of in a side rail (the
+ * GitHub-review affordance). The diff block places one of these after the first
+ * row of each annotation's range, so the numbered `①`/`②` row marker and the note
+ * read together in one column. It carries the same marker pip, line range,
+ * optional label, and markdown `note` as a rail card, and the same two-way hover
+ * wiring (`active` / `onActiveChange`) so the row and its note cross-highlight.
+ *
+ * The outer band is `min-w-full` so the amber wash spans the diff's full scroll
+ * width; the content is `sticky left-0` with a readable `max-w` so the note stays
+ * pinned and legible while long code lines scroll horizontally beneath it.
+ */
+export function InlineAnnotationNote({ item, active, onActiveChange, ctx, }) {
+    return (_jsx("div", { onMouseEnter: () => onActiveChange(item.index), onMouseLeave: () => onActiveChange(null), className: cn("min-w-full border-y transition-colors", active
+            ? "border-amber-400/60 bg-amber-100/70 dark:border-amber-300/40 dark:bg-amber-300/[0.12]"
+            : "border-amber-400/30 bg-amber-50/70 dark:border-amber-300/20 dark:bg-amber-300/[0.06]"), children: _jsxs("div", { className: "sticky left-0 flex max-w-[44rem] gap-2.5 whitespace-normal px-3 py-2.5 font-sans", children: [_jsx(AnnotationGutterMarker, { marker: item.marker, active: active }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-0.5", children: [_jsx("span", { className: "text-[11px] font-semibold uppercase tracking-wide text-plan-muted", children: rangeLabel(item) }), item.annotation.label && (_jsx("span", { className: "text-[13px] font-semibold text-plan-text", children: item.annotation.label }))] }), _jsx("div", { className: "plan-annotation-note mt-1 text-[13px] leading-relaxed text-plan-text/85", children: ctx.renderMarkdown ? (ctx.renderMarkdown(item.annotation.note)) : (_jsx("p", { children: item.annotation.note })) })] })] }) }));
+}
+/** Whether a resolved list has at least one note worth rendering a rail for. */
+export function hasRailAnnotations(items) {
+    return items.some((item) => item.range);
+}
+//# sourceMappingURL=annotation-rail.js.map

package/dist/client/blocks/library/annotation-rail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-rail.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/annotation-rail.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, type ReactNode } from \"react\";\nimport { cn } from \"../../utils.js\";\nimport type { BlockRenderContext } from \"../types.js\";\n\n/**\n * Shared line-anchored annotation UI for the `annotated-code` and `diff` blocks.\n *\n * Both blocks render a numbered code surface plus a side \"rail\" of notes, where\n * each note targets a 1-based `lines` ref (`\"3\"` or `\"3-5\"`) and hovering a code\n * line ↔ its note cross-highlights. This module owns the pure pieces that were\n * identical between them so neither block forks the behavior:\n *\n *  - `parseLineRange` — the forgiving 1-based `lines` range parser.\n *  - `resolveAnnotations` / `buildLineMarkerMap` — turn a raw annotation list\n *    into stable, marker-numbered, range-resolved records and a line→markers map.\n *  - `rangeLabel` — the human \"Line 8\" / \"Lines 3–6\" label.\n *  - `AnnotationGutterMarker` — the numbered amber pip placed on an annotated row\n *    (used by the diff grid; the annotated-code surface uses its own rail bar).\n *  - `AnnotationNoteRail` — the responsive list of note cards with two-way hover.\n *    `showMarker` opts the diff block into a leading numbered pip on each card so\n *    a note can be matched to its `①`/`②` row marker; annotated-code omits it to\n *    keep its original card chrome.\n *\n * `AnnotatedCodeBlock` annotates a single code surface; `DiffBlock` annotates a\n * before/after grid (each annotation also carries a `side`). The shared types\n * here are intentionally minimal — callers pass their own `side` handling and\n * decide which rows a marker lands on; this module only owns the parsing, the\n * resolved-record shape, and the rendered marker + rail chrome.\n */\n\n/* ── Line-ref parsing ──────────────────────────────────────────────────────── */\n\n/**\n * Parse a 1-based `lines` ref (`\"3\"` or `\"3-5\"`) into an inclusive `[start,end]`\n * pair, clamped to `[1, lineCount]`. Returns `null` for malformed or fully\n * out-of-range refs so callers can ignore them gracefully. A reversed range\n * (`\"5-3\"`) is normalized; a partially out-of-range range is clamped.\n */\nexport function parseLineRange(\n  ref: string,\n  lineCount: number,\n): { start: number; end: number } | null {\n  const match = /^\\s*(\\d+)\\s*(?:-\\s*(\\d+)\\s*)?$/.exec(ref);\n  if (!match) return null;\n  let start = Number.parseInt(match[1], 10);\n  let end = match[2] != null ? Number.parseInt(match[2], 10) : start;\n  if (!Number.isFinite(start) || !Number.isFinite(end)) return null;\n  if (start > end) [start, end] = [end, start];\n  // Fully outside the file → ignore.\n  if (end < 1 || start > lineCount) return null;\n  return { start: Math.max(1, start), end: Math.min(lineCount, end) };\n}\n\n/** The minimal annotation shape the rail needs (a superset works too). */\nexport interface RailAnnotation {\n  lines: string;\n  label?: string;\n  note: string;\n}\n\nexport interface ResolvedAnnotation<A extends RailAnnotation = RailAnnotation> {\n  /** Index in the original `annotations` array (stable hover key). */\n  index: number;\n  /** 1-based marker number (authoring order). */\n  marker: number;\n  annotation: A;\n  range: { start: number; end: number } | null;\n}\n\n/**\n * Resolve a raw annotation list into stable, marker-numbered records, parsing\n * each `lines` ref against `lineCount`. `lineCountFor` lets the diff block pick a\n * per-annotation line count (before-side vs after-side); annotated-code passes a\n * single constant. Markers are authoring-order, 1-based, and assigned to ALL\n * annotations (even unresolved ones) so numbering is stable regardless of which\n * refs happen to match.\n */\nexport function resolveAnnotations<A extends RailAnnotation>(\n  annotations: A[] | undefined,\n  lineCountFor: (annotation: A) => number,\n): ResolvedAnnotation<A>[] {\n  return (annotations ?? []).map((annotation, index) => ({\n    index,\n    marker: index + 1,\n    annotation,\n    range: parseLineRange(annotation.lines, lineCountFor(annotation)),\n  }));\n}\n\n/** Map a 1-based line number → the resolved annotations covering it. */\nexport function buildLineMarkerMap<A extends RailAnnotation>(\n  resolved: ResolvedAnnotation<A>[],\n): Map<number, ResolvedAnnotation<A>[]> {\n  const map = new Map<number, ResolvedAnnotation<A>[]>();\n  for (const item of resolved) {\n    if (!item.range) continue;\n    for (let n = item.range.start; n <= item.range.end; n += 1) {\n      const list = map.get(n) ?? [];\n      list.push(item);\n      map.set(n, list);\n    }\n  }\n  return map;\n}\n\n/** Human label for a resolved annotation's line span (\"Line 8\" / \"Lines 3–6\"). */\nexport function rangeLabel(item: ResolvedAnnotation): string {\n  if (!item.range) return `Lines ${item.annotation.lines}`;\n  return item.range.start === item.range.end\n    ? `Line ${item.range.start}`\n    : `Lines ${item.range.start}–${item.range.end}`;\n}\n\n/* ── Marker ────────────────────────────────────────────────────────────────── */\n\n/**\n * The numbered amber pip rendered on an annotated code row's gutter. `active`\n * brightens it when its note (or a co-located row) is hovered.\n */\nexport function AnnotationGutterMarker({\n  marker,\n  active,\n  className,\n}: {\n  marker: number;\n  active: boolean;\n  className?: string;\n}) {\n  return (\n    <span\n      aria-hidden\n      className={cn(\n        \"inline-flex size-[15px] shrink-0 items-center justify-center rounded-full text-[9px] font-semibold leading-none tabular-nums transition-colors\",\n        active\n          ? \"bg-amber-500 text-white dark:bg-amber-400 dark:text-amber-950\"\n          : \"bg-amber-400/25 text-amber-700 dark:bg-amber-300/20 dark:text-amber-300\",\n        className,\n      )}\n    >\n      {marker}\n    </span>\n  );\n}\n\n/* ── Note rail ─────────────────────────────────────────────────────────────── */\n\n/**\n * The responsive list of line-anchored note cards. Each card shows its marker\n * pip, the resolved line span (\"Line 8\"), an optional label, and the markdown\n * `note` (via `ctx.renderMarkdown`). Hovering a card sets the active index;\n * `activeIndex` driven from outside lets a hovered code row light its card and\n * vice-versa. Only annotations whose `range` resolved are listed.\n */\nexport function AnnotationNoteRail<A extends RailAnnotation>({\n  items,\n  activeIndex,\n  onActiveChange,\n  ctx,\n  className,\n  showMarker = false,\n}: {\n  items: ResolvedAnnotation<A>[];\n  activeIndex: number | null;\n  onActiveChange: (index: number | null) => void;\n  ctx: BlockRenderContext;\n  className?: string;\n  /** Show a leading numbered pip on each card (diff block). */\n  showMarker?: boolean;\n}) {\n  const sideAnnotations = useMemo(\n    () => items.filter((item) => item.range),\n    [items],\n  );\n  return (\n    <div className={cn(\"flex flex-col gap-2.5\", className)}>\n      {sideAnnotations.map((item) => {\n        const isActive = activeIndex === item.index;\n        return (\n          <div\n            key={item.index}\n            onMouseEnter={() => onActiveChange(item.index)}\n            onMouseLeave={() => onActiveChange(null)}\n            className={cn(\n              \"rounded-lg border px-3.5 py-2.5 transition-colors\",\n              isActive\n                ? \"border-amber-400/70 bg-amber-50 dark:border-amber-300/40 dark:bg-amber-300/[0.08]\"\n                : \"border-plan-line bg-plan-block/40 hover:border-amber-400/50\",\n            )}\n          >\n            <div\n              className={cn(\n                \"flex flex-wrap gap-x-2 gap-y-0.5\",\n                showMarker ? \"items-center\" : \"items-baseline\",\n              )}\n            >\n              {showMarker && (\n                <AnnotationGutterMarker\n                  marker={item.marker}\n                  active={isActive}\n                />\n              )}\n              <span className=\"text-[11px] font-semibold uppercase tracking-wide text-plan-muted\">\n                {rangeLabel(item)}\n              </span>\n              {item.annotation.label && (\n                <span className=\"text-[13px] font-semibold text-plan-text\">\n                  {item.annotation.label}\n                </span>\n              )}\n            </div>\n            <div className=\"plan-annotation-note mt-1 text-[13px] leading-relaxed text-plan-text/85\">\n              {ctx.renderMarkdown ? (\n                ctx.renderMarkdown(item.annotation.note)\n              ) : (\n                <p>{item.annotation.note}</p>\n              )}\n            </div>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n\n/* ── Inline note (GitHub-style) ─────────────────────────────────────────────── */\n\n/**\n * A single line-anchored note rendered INLINE in the diff flow — full-width,\n * directly under the line it annotates — instead of in a side rail (the\n * GitHub-review affordance). The diff block places one of these after the first\n * row of each annotation's range, so the numbered `①`/`②` row marker and the note\n * read together in one column. It carries the same marker pip, line range,\n * optional label, and markdown `note` as a rail card, and the same two-way hover\n * wiring (`active` / `onActiveChange`) so the row and its note cross-highlight.\n *\n * The outer band is `min-w-full` so the amber wash spans the diff's full scroll\n * width; the content is `sticky left-0` with a readable `max-w` so the note stays\n * pinned and legible while long code lines scroll horizontally beneath it.\n */\nexport function InlineAnnotationNote<A extends RailAnnotation>({\n  item,\n  active,\n  onActiveChange,\n  ctx,\n}: {\n  item: ResolvedAnnotation<A>;\n  active: boolean;\n  onActiveChange: (index: number | null) => void;\n  ctx: BlockRenderContext;\n}) {\n  return (\n    <div\n      onMouseEnter={() => onActiveChange(item.index)}\n      onMouseLeave={() => onActiveChange(null)}\n      className={cn(\n        \"min-w-full border-y transition-colors\",\n        active\n          ? \"border-amber-400/60 bg-amber-100/70 dark:border-amber-300/40 dark:bg-amber-300/[0.12]\"\n          : \"border-amber-400/30 bg-amber-50/70 dark:border-amber-300/20 dark:bg-amber-300/[0.06]\",\n      )}\n    >\n      <div className=\"sticky left-0 flex max-w-[44rem] gap-2.5 whitespace-normal px-3 py-2.5 font-sans\">\n        <AnnotationGutterMarker marker={item.marker} active={active} />\n        <div className=\"min-w-0 flex-1\">\n          <div className=\"flex flex-wrap items-baseline gap-x-2 gap-y-0.5\">\n            <span className=\"text-[11px] font-semibold uppercase tracking-wide text-plan-muted\">\n              {rangeLabel(item)}\n            </span>\n            {item.annotation.label && (\n              <span className=\"text-[13px] font-semibold text-plan-text\">\n                {item.annotation.label}\n              </span>\n            )}\n          </div>\n          <div className=\"plan-annotation-note mt-1 text-[13px] leading-relaxed text-plan-text/85\">\n            {ctx.renderMarkdown ? (\n              ctx.renderMarkdown(item.annotation.note)\n            ) : (\n              <p>{item.annotation.note}</p>\n            )}\n          </div>\n        </div>\n      </div>\n    </div>\n  );\n}\n\n/** Whether a resolved list has at least one note worth rendering a rail for. */\nexport function hasRailAnnotations(items: ResolvedAnnotation[]): boolean {\n  return items.some((item) => item.range);\n}\n\nexport type AnnotationRailChildren = ReactNode;\n"]}

package/dist/client/blocks/library/api-endpoint.config.d.ts

@@ -21,12 +21,28 @@ export type ApiEndpointMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "H
 export declare const API_ENDPOINT_METHODS: ApiEndpointMethod[];
 export type ApiParamLocation = "path" | "query" | "header" | "body";
 export declare const API_PARAM_LOCATIONS: ApiParamLocation[];
+/**
+ * Diff state for a route / param / response, shared with the `file-tree` and
+ * `data-model` blocks so a recap reads consistently across all three. Drives the
+ * same change chips (Added / Modified / Removed / Renamed). Absent ⇒ no chip,
+ * rendered exactly as before diff support existed.
+ */
+export type ApiEndpointChange = "added" | "modified" | "removed" | "renamed";
+export declare const API_ENDPOINT_CHANGES: ApiEndpointChange[];
 export interface ApiEndpointParam {
     name: string;
     in: ApiParamLocation;
     type?: string;
     required?: boolean;
     description?: string;
+    /** Diff state for this parameter (drives the change chip). */
+    change?: ApiEndpointChange;
+    /**
+     * Prior value when `change === "modified"` — e.g. the old type (`string`) or
+     * the old required flag (`optional`). Shown struck-through before the current
+     * value so a reviewer can see the before/after at a glance.
+     */
+    was?: string;
 }
 export interface ApiEndpointRequest {
     contentType?: string;
@@ -36,6 +52,8 @@ export interface ApiEndpointResponse {
     status: string;
     description?: string;
     example?: string;
+    /** Diff state for this response (e.g. a new `409` is "added"). */
+    change?: ApiEndpointChange;
 }
 export interface ApiEndpointData {
     method: ApiEndpointMethod;
@@ -45,6 +63,8 @@ export interface ApiEndpointData {
     description?: string;
     auth?: string;
     deprecated?: boolean;
+    /** Diff state for the whole route (added/removed/renamed endpoint). */
+    change?: ApiEndpointChange;
     params?: ApiEndpointParam[];
     request?: ApiEndpointRequest;
     responses?: ApiEndpointResponse[];
@@ -57,12 +77,17 @@ export interface ApiEndpointData {
  */
 export declare const apiEndpointSchema: z.ZodType<ApiEndpointData>;
 /**
- * MDX config: `<Endpoint method path summary auth deprecated params request
- * responses>\n\n{description}\n\n</Endpoint>`. `description` is the prose body
- * (`childrenField`), so it is excluded from the attribute bag and survives as
- * real inline-editable MDX prose. The remaining keys are emitted in a STABLE
- * order (method, path, summary, auth, deprecated, params, request, responses);
- * `undefined` values are dropped by the shared `prop()` encoder.
+ * MDX config: `<Endpoint method path summary auth deprecated change params
+ * request responses>\n\n{description}\n\n</Endpoint>`. `description` is the prose
+ * body (`childrenField`), so it is excluded from the attribute bag and survives
+ * as real inline-editable MDX prose. The remaining keys are emitted in a STABLE
+ * order (method, path, summary, auth, deprecated, change, params, request,
+ * responses); `undefined` values are dropped by the shared `prop()` encoder.
+ *
+ * The root `change` is a flat string attribute; the per-param `change` + `was`
+ * and per-response `change` ride along inside the `params` / `responses` JSON
+ * props (the whole arrays are serialized verbatim), so all three diff levels
+ * round-trip without extra encoding.
  *
  * `fromAttrs` tolerates missing/partial attributes for backward-compat, mirrors
  * the schema defaults, and reads the prose `children` into `description`.

package/dist/client/blocks/library/api-endpoint.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-endpoint.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/api-endpoint.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAQnD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAKjD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAqBD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAUb,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,CA6B1D,CAAC"}
+{"version":3,"file":"api-endpoint.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/api-endpoint.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,SAAS,CAAC;AAEd,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAQnD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAKjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAKnD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACnC;AA0BD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAWb,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAS5C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,CA+B1D,CAAC"}

package/dist/client/blocks/library/api-endpoint.config.js

@@ -14,12 +14,21 @@ export const API_PARAM_LOCATIONS = [
     "header",
     "body",
 ];
+export const API_ENDPOINT_CHANGES = [
+    "added",
+    "modified",
+    "removed",
+    "renamed",
+];
+const apiChangeSchema = z.enum(["added", "modified", "removed", "renamed"]);
 const apiParamSchema = z.object({
     name: z.string().trim().min(1).max(160),
     in: z.enum(["path", "query", "header", "body"]),
     type: z.string().trim().max(120).optional(),
     required: z.boolean().optional(),
     description: z.string().trim().max(1_000).optional(),
+    change: apiChangeSchema.optional(),
+    was: z.string().trim().max(400).optional(),
 });
 const apiRequestSchema = z.object({
     contentType: z.string().trim().max(160).optional(),
@@ -29,6 +38,7 @@ const apiResponseSchema = z.object({
     status: z.string().trim().min(1).max(40),
     description: z.string().trim().max(1_000).optional(),
     example: z.string().max(20_000).optional(),
+    change: apiChangeSchema.optional(),
 });
 /**
  * Data-compatible with the inline `api-endpoint` member of `planBlockSchema`
@@ -43,17 +53,29 @@ export const apiEndpointSchema = z.object({
     description: z.string().max(20_000).optional(),
     auth: z.string().trim().max(200).optional(),
     deprecated: z.boolean().optional(),
+    change: apiChangeSchema.optional(),
     params: z.array(apiParamSchema).max(60).optional(),
     request: apiRequestSchema.optional(),
     responses: z.array(apiResponseSchema).max(40).optional(),
 });
+/** Coerce a serialized `change` attribute back to the enum (drops garbage). */
+function readChange(value) {
+    return value && API_ENDPOINT_CHANGES.includes(value)
+        ? value
+        : undefined;
+}
 /**
- * MDX config: `<Endpoint method path summary auth deprecated params request
- * responses>\n\n{description}\n\n</Endpoint>`. `description` is the prose body
- * (`childrenField`), so it is excluded from the attribute bag and survives as
- * real inline-editable MDX prose. The remaining keys are emitted in a STABLE
- * order (method, path, summary, auth, deprecated, params, request, responses);
- * `undefined` values are dropped by the shared `prop()` encoder.
+ * MDX config: `<Endpoint method path summary auth deprecated change params
+ * request responses>\n\n{description}\n\n</Endpoint>`. `description` is the prose
+ * body (`childrenField`), so it is excluded from the attribute bag and survives
+ * as real inline-editable MDX prose. The remaining keys are emitted in a STABLE
+ * order (method, path, summary, auth, deprecated, change, params, request,
+ * responses); `undefined` values are dropped by the shared `prop()` encoder.
+ *
+ * The root `change` is a flat string attribute; the per-param `change` + `was`
+ * and per-response `change` ride along inside the `params` / `responses` JSON
+ * props (the whole arrays are serialized verbatim), so all three diff levels
+ * round-trip without extra encoding.
  *
  * `fromAttrs` tolerates missing/partial attributes for backward-compat, mirrors
  * the schema defaults, and reads the prose `children` into `description`.
@@ -67,6 +89,7 @@ export const apiEndpointMdx = {
         summary: data.summary,
         auth: data.auth,
         deprecated: data.deprecated,
+        change: data.change,
         params: data.params,
         request: data.request,
         responses: data.responses,
@@ -82,6 +105,7 @@ export const apiEndpointMdx = {
             description: description.length > 0 ? description : undefined,
             auth: attrs.string("auth"),
             deprecated: attrs.bool("deprecated"),
+            change: readChange(attrs.string("change")),
             params: attrs.array("params"),
             request: request ?? undefined,
             responses: attrs.array("responses"),

package/dist/client/blocks/library/api-endpoint.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-endpoint.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/api-endpoint.config.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC `api-endpoint` block: its data\n * schema and MDX round-trip config. Shared by the server MDX adapter\n * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec\n * (`planBlocks.tsx`). Keeping this React-free means importing it into a server\n * module never pulls React into the Nitro/SSR bundle.\n *\n * The block renders a Swagger / Stripe-style API reference row: a colored method\n * pill + monospace path + summary, collapsed by default, expanding to a params\n * table, a request body example, and per-status response examples.\n *\n * The schema MUST stay data-compatible with the `api-endpoint` branch of\n * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`Endpoint`) +\n * attribute/children shape MUST match the inline planBlockSchema member so\n * stored `.mdx` round-trips. `description` is MDX *children* (prose body);\n * every other field is an attribute.\n */\n\nexport type ApiEndpointMethod =\n  | \"GET\"\n  | \"POST\"\n  | \"PUT\"\n  | \"PATCH\"\n  | \"DELETE\"\n  | \"HEAD\"\n  | \"OPTIONS\";\n\nexport const API_ENDPOINT_METHODS: ApiEndpointMethod[] = [\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"HEAD\",\n  \"OPTIONS\",\n];\n\nexport type ApiParamLocation = \"path\" | \"query\" | \"header\" | \"body\";\n\nexport const API_PARAM_LOCATIONS: ApiParamLocation[] = [\n  \"path\",\n  \"query\",\n  \"header\",\n  \"body\",\n];\n\nexport interface ApiEndpointParam {\n  name: string;\n  in: ApiParamLocation;\n  type?: string;\n  required?: boolean;\n  description?: string;\n}\n\nexport interface ApiEndpointRequest {\n  contentType?: string;\n  example?: string;\n}\n\nexport interface ApiEndpointResponse {\n  status: string;\n  description?: string;\n  example?: string;\n}\n\nexport interface ApiEndpointData {\n  method: ApiEndpointMethod;\n  path: string;\n  summary?: string;\n  /** Markdown prose body. Serialized as MDX children, not an attribute. */\n  description?: string;\n  auth?: string;\n  deprecated?: boolean;\n  params?: ApiEndpointParam[];\n  request?: ApiEndpointRequest;\n  responses?: ApiEndpointResponse[];\n}\n\nconst apiParamSchema = z.object({\n  name: z.string().trim().min(1).max(160),\n  in: z.enum([\"path\", \"query\", \"header\", \"body\"]),\n  type: z.string().trim().max(120).optional(),\n  required: z.boolean().optional(),\n  description: z.string().trim().max(1_000).optional(),\n}) as z.ZodType<ApiEndpointParam>;\n\nconst apiRequestSchema = z.object({\n  contentType: z.string().trim().max(160).optional(),\n  example: z.string().max(20_000).optional(),\n}) as z.ZodType<ApiEndpointRequest>;\n\nconst apiResponseSchema = z.object({\n  status: z.string().trim().min(1).max(40),\n  description: z.string().trim().max(1_000).optional(),\n  example: z.string().max(20_000).optional(),\n}) as z.ZodType<ApiEndpointResponse>;\n\n/**\n * Data-compatible with the inline `api-endpoint` member of `planBlockSchema`\n * (`plan-content.ts`). `method` + `path` are required; everything else is\n * optional and defaults to omitted so a fresh endpoint validates from\n * `{ method: \"GET\", path: \"/api/resource\" }`.\n */\nexport const apiEndpointSchema = z.object({\n  method: z.enum([\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"HEAD\", \"OPTIONS\"]),\n  path: z.string().trim().min(1).max(500),\n  summary: z.string().trim().max(400).optional(),\n  description: z.string().max(20_000).optional(),\n  auth: z.string().trim().max(200).optional(),\n  deprecated: z.boolean().optional(),\n  params: z.array(apiParamSchema).max(60).optional(),\n  request: apiRequestSchema.optional(),\n  responses: z.array(apiResponseSchema).max(40).optional(),\n}) as unknown as z.ZodType<ApiEndpointData>;\n\n/**\n * MDX config: `<Endpoint method path summary auth deprecated params request\n * responses>\\n\\n{description}\\n\\n</Endpoint>`. `description` is the prose body\n * (`childrenField`), so it is excluded from the attribute bag and survives as\n * real inline-editable MDX prose. The remaining keys are emitted in a STABLE\n * order (method, path, summary, auth, deprecated, params, request, responses);\n * `undefined` values are dropped by the shared `prop()` encoder.\n *\n * `fromAttrs` tolerates missing/partial attributes for backward-compat, mirrors\n * the schema defaults, and reads the prose `children` into `description`.\n */\nexport const apiEndpointMdx: BlockMdxConfig<ApiEndpointData> = {\n  tag: \"Endpoint\",\n  childrenField: \"description\",\n  toAttrs: (data) => ({\n    method: data.method,\n    path: data.path,\n    summary: data.summary,\n    auth: data.auth,\n    deprecated: data.deprecated,\n    params: data.params,\n    request: data.request as Record<string, unknown> | undefined,\n    responses: data.responses,\n  }),\n  fromAttrs: (attrs, children) => {\n    const method = (attrs.string(\"method\") ?? \"GET\") as ApiEndpointMethod;\n    const request = attrs.object<ApiEndpointRequest>(\"request\");\n    const description = children.trim();\n    return {\n      method: API_ENDPOINT_METHODS.includes(method) ? method : \"GET\",\n      path: attrs.string(\"path\") ?? \"\",\n      summary: attrs.string(\"summary\"),\n      description: description.length > 0 ? description : undefined,\n      auth: attrs.string(\"auth\"),\n      deprecated: attrs.bool(\"deprecated\"),\n      params: attrs.array<ApiEndpointParam>(\"params\"),\n      request: request ?? undefined,\n      responses: attrs.array<ApiEndpointResponse>(\"responses\"),\n    };\n  },\n};\n"]}
+{"version":3,"file":"api-endpoint.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/api-endpoint.config.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC `api-endpoint` block: its data\n * schema and MDX round-trip config. Shared by the server MDX adapter\n * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec\n * (`planBlocks.tsx`). Keeping this React-free means importing it into a server\n * module never pulls React into the Nitro/SSR bundle.\n *\n * The block renders a Swagger / Stripe-style API reference row: a colored method\n * pill + monospace path + summary, collapsed by default, expanding to a params\n * table, a request body example, and per-status response examples.\n *\n * The schema MUST stay data-compatible with the `api-endpoint` branch of\n * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`Endpoint`) +\n * attribute/children shape MUST match the inline planBlockSchema member so\n * stored `.mdx` round-trips. `description` is MDX *children* (prose body);\n * every other field is an attribute.\n */\n\nexport type ApiEndpointMethod =\n  | \"GET\"\n  | \"POST\"\n  | \"PUT\"\n  | \"PATCH\"\n  | \"DELETE\"\n  | \"HEAD\"\n  | \"OPTIONS\";\n\nexport const API_ENDPOINT_METHODS: ApiEndpointMethod[] = [\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"HEAD\",\n  \"OPTIONS\",\n];\n\nexport type ApiParamLocation = \"path\" | \"query\" | \"header\" | \"body\";\n\nexport const API_PARAM_LOCATIONS: ApiParamLocation[] = [\n  \"path\",\n  \"query\",\n  \"header\",\n  \"body\",\n];\n\n/**\n * Diff state for a route / param / response, shared with the `file-tree` and\n * `data-model` blocks so a recap reads consistently across all three. Drives the\n * same change chips (Added / Modified / Removed / Renamed). Absent ⇒ no chip,\n * rendered exactly as before diff support existed.\n */\nexport type ApiEndpointChange = \"added\" | \"modified\" | \"removed\" | \"renamed\";\n\nexport const API_ENDPOINT_CHANGES: ApiEndpointChange[] = [\n  \"added\",\n  \"modified\",\n  \"removed\",\n  \"renamed\",\n];\n\nexport interface ApiEndpointParam {\n  name: string;\n  in: ApiParamLocation;\n  type?: string;\n  required?: boolean;\n  description?: string;\n  /** Diff state for this parameter (drives the change chip). */\n  change?: ApiEndpointChange;\n  /**\n   * Prior value when `change === \"modified\"` — e.g. the old type (`string`) or\n   * the old required flag (`optional`). Shown struck-through before the current\n   * value so a reviewer can see the before/after at a glance.\n   */\n  was?: string;\n}\n\nexport interface ApiEndpointRequest {\n  contentType?: string;\n  example?: string;\n}\n\nexport interface ApiEndpointResponse {\n  status: string;\n  description?: string;\n  example?: string;\n  /** Diff state for this response (e.g. a new `409` is \"added\"). */\n  change?: ApiEndpointChange;\n}\n\nexport interface ApiEndpointData {\n  method: ApiEndpointMethod;\n  path: string;\n  summary?: string;\n  /** Markdown prose body. Serialized as MDX children, not an attribute. */\n  description?: string;\n  auth?: string;\n  deprecated?: boolean;\n  /** Diff state for the whole route (added/removed/renamed endpoint). */\n  change?: ApiEndpointChange;\n  params?: ApiEndpointParam[];\n  request?: ApiEndpointRequest;\n  responses?: ApiEndpointResponse[];\n}\n\nconst apiChangeSchema = z.enum([\"added\", \"modified\", \"removed\", \"renamed\"]);\n\nconst apiParamSchema = z.object({\n  name: z.string().trim().min(1).max(160),\n  in: z.enum([\"path\", \"query\", \"header\", \"body\"]),\n  type: z.string().trim().max(120).optional(),\n  required: z.boolean().optional(),\n  description: z.string().trim().max(1_000).optional(),\n  change: apiChangeSchema.optional(),\n  was: z.string().trim().max(400).optional(),\n}) as z.ZodType<ApiEndpointParam>;\n\nconst apiRequestSchema = z.object({\n  contentType: z.string().trim().max(160).optional(),\n  example: z.string().max(20_000).optional(),\n}) as z.ZodType<ApiEndpointRequest>;\n\nconst apiResponseSchema = z.object({\n  status: z.string().trim().min(1).max(40),\n  description: z.string().trim().max(1_000).optional(),\n  example: z.string().max(20_000).optional(),\n  change: apiChangeSchema.optional(),\n}) as z.ZodType<ApiEndpointResponse>;\n\n/**\n * Data-compatible with the inline `api-endpoint` member of `planBlockSchema`\n * (`plan-content.ts`). `method` + `path` are required; everything else is\n * optional and defaults to omitted so a fresh endpoint validates from\n * `{ method: \"GET\", path: \"/api/resource\" }`.\n */\nexport const apiEndpointSchema = z.object({\n  method: z.enum([\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"HEAD\", \"OPTIONS\"]),\n  path: z.string().trim().min(1).max(500),\n  summary: z.string().trim().max(400).optional(),\n  description: z.string().max(20_000).optional(),\n  auth: z.string().trim().max(200).optional(),\n  deprecated: z.boolean().optional(),\n  change: apiChangeSchema.optional(),\n  params: z.array(apiParamSchema).max(60).optional(),\n  request: apiRequestSchema.optional(),\n  responses: z.array(apiResponseSchema).max(40).optional(),\n}) as unknown as z.ZodType<ApiEndpointData>;\n\n/** Coerce a serialized `change` attribute back to the enum (drops garbage). */\nfunction readChange(value: string | undefined): ApiEndpointChange | undefined {\n  return value && API_ENDPOINT_CHANGES.includes(value as ApiEndpointChange)\n    ? (value as ApiEndpointChange)\n    : undefined;\n}\n\n/**\n * MDX config: `<Endpoint method path summary auth deprecated change params\n * request responses>\\n\\n{description}\\n\\n</Endpoint>`. `description` is the prose\n * body (`childrenField`), so it is excluded from the attribute bag and survives\n * as real inline-editable MDX prose. The remaining keys are emitted in a STABLE\n * order (method, path, summary, auth, deprecated, change, params, request,\n * responses); `undefined` values are dropped by the shared `prop()` encoder.\n *\n * The root `change` is a flat string attribute; the per-param `change` + `was`\n * and per-response `change` ride along inside the `params` / `responses` JSON\n * props (the whole arrays are serialized verbatim), so all three diff levels\n * round-trip without extra encoding.\n *\n * `fromAttrs` tolerates missing/partial attributes for backward-compat, mirrors\n * the schema defaults, and reads the prose `children` into `description`.\n */\nexport const apiEndpointMdx: BlockMdxConfig<ApiEndpointData> = {\n  tag: \"Endpoint\",\n  childrenField: \"description\",\n  toAttrs: (data) => ({\n    method: data.method,\n    path: data.path,\n    summary: data.summary,\n    auth: data.auth,\n    deprecated: data.deprecated,\n    change: data.change,\n    params: data.params,\n    request: data.request as Record<string, unknown> | undefined,\n    responses: data.responses,\n  }),\n  fromAttrs: (attrs, children) => {\n    const method = (attrs.string(\"method\") ?? \"GET\") as ApiEndpointMethod;\n    const request = attrs.object<ApiEndpointRequest>(\"request\");\n    const description = children.trim();\n    return {\n      method: API_ENDPOINT_METHODS.includes(method) ? method : \"GET\",\n      path: attrs.string(\"path\") ?? \"\",\n      summary: attrs.string(\"summary\"),\n      description: description.length > 0 ? description : undefined,\n      auth: attrs.string(\"auth\"),\n      deprecated: attrs.bool(\"deprecated\"),\n      change: readChange(attrs.string(\"change\")),\n      params: attrs.array<ApiEndpointParam>(\"params\"),\n      request: request ?? undefined,\n      responses: attrs.array<ApiEndpointResponse>(\"responses\"),\n    };\n  },\n};\n"]}

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { BlockMdxConfig } from "../types.js";
+/**
+ * Pure (React-free) part of the shared `callout` block: its data schema and MDX
+ * round-trip config. Lives in core so BOTH apps' server/shared registries
+ * (`plan-block-registry.ts`, `nfm-registry.ts`) and the client spec
+ * (`callout.tsx`) consume one definition. Keeping it React-free means importing
+ * it into a server module never pulls React into the Nitro/SSR bundle.
+ *
+ * The MDX `tag` + attribute/children shape MUST match the legacy
+ * `<Callout tone>…body…</Callout>` encoding so stored `.mdx` round-trips
+ * byte-compatibly (the block originated in the plan template before moving here).
+ */
+export type CalloutTone = "info" | "decision" | "risk" | "warning" | "success";
+export interface CalloutData {
+    tone?: CalloutTone;
+    /** Markdown body. Tagged `markdown()` so the auto-editor edits it inline. */
+    body: string;
+}
+export declare const CALLOUT_TONES: CalloutTone[];
+export declare const calloutSchema: z.ZodType<CalloutData>;
+/**
+ * MDX config: `tone` is an attribute, `body` is MDX children — exactly the
+ * legacy `<Callout id … tone>\n\n{body}\n\n</Callout>` form. `toAttrs` returns
+ * only `tone` (body is `childrenField`, excluded from attributes); `fromAttrs`
+ * reads `tone` and uses the stringified prose children as `body`.
+ */
+export declare const calloutMdx: BlockMdxConfig<CalloutData>;
+//# sourceMappingURL=callout.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/callout.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EAMtC,CAAC;AAEF,eAAO,MAAM,aAAa,EAOT,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,WAAW,CAQlD,CAAC"}

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

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { markdown } from "../schema-form/introspect.js";
+export const CALLOUT_TONES = [
+    "info",
+    "decision",
+    "risk",
+    "warning",
+    "success",
+];
+export const calloutSchema = z.object({
+    tone: z
+        .enum(["info", "decision", "risk", "warning", "success"])
+        .optional(),
+    // `markdown()` tags the field so `SchemaBlockEditor` renders it with the
+    // shared rich-markdown editor (inline, Notion-style) instead of a textarea.
+    body: markdown(z.string().trim().min(1).max(10_000)),
+});
+/**
+ * MDX config: `tone` is an attribute, `body` is MDX children — exactly the
+ * legacy `<Callout id … tone>\n\n{body}\n\n</Callout>` form. `toAttrs` returns
+ * only `tone` (body is `childrenField`, excluded from attributes); `fromAttrs`
+ * reads `tone` and uses the stringified prose children as `body`.
+ */
+export const calloutMdx = {
+    tag: "Callout",
+    childrenField: "body",
+    toAttrs: (data) => ({ tone: data.tone }),
+    fromAttrs: (attrs, children) => ({
+        tone: attrs.string("tone"),
+        body: children,
+    }),
+};
+//# sourceMappingURL=callout.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/callout.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAuBxD,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,MAAM;IACN,UAAU;IACV,MAAM;IACN,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SACxD,QAAQ,EAAwC;IACnD,yEAAyE;IACzE,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAsB;CAC1E,CAAsC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgC;IACrD,GAAG,EAAE,SAAS;IACd,aAAa,EAAE,MAAM;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAA4B;QACrD,IAAI,EAAE,QAAQ;KACf,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { markdown } from \"../schema-form/introspect.js\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the shared `callout` 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 * (`callout.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` + attribute/children shape MUST match the legacy\n * `<Callout tone>…body…</Callout>` encoding so stored `.mdx` round-trips\n * byte-compatibly (the block originated in the plan template before moving here).\n */\n\nexport type CalloutTone = \"info\" | \"decision\" | \"risk\" | \"warning\" | \"success\";\n\nexport interface CalloutData {\n  tone?: CalloutTone;\n  /** Markdown body. Tagged `markdown()` so the auto-editor edits it inline. */\n  body: string;\n}\n\nexport const CALLOUT_TONES: CalloutTone[] = [\n  \"info\",\n  \"decision\",\n  \"risk\",\n  \"warning\",\n  \"success\",\n];\n\nexport const calloutSchema = z.object({\n  tone: z\n    .enum([\"info\", \"decision\", \"risk\", \"warning\", \"success\"])\n    .optional() as z.ZodType<CalloutTone | undefined>,\n  // `markdown()` tags the field so `SchemaBlockEditor` renders it with the\n  // shared rich-markdown editor (inline, Notion-style) instead of a textarea.\n  body: markdown(z.string().trim().min(1).max(10_000)) as z.ZodType<string>,\n}) as unknown as z.ZodType<CalloutData>;\n\n/**\n * MDX config: `tone` is an attribute, `body` is MDX children — exactly the\n * legacy `<Callout id … tone>\\n\\n{body}\\n\\n</Callout>` form. `toAttrs` returns\n * only `tone` (body is `childrenField`, excluded from attributes); `fromAttrs`\n * reads `tone` and uses the stringified prose children as `body`.\n */\nexport const calloutMdx: BlockMdxConfig<CalloutData> = {\n  tag: \"Callout\",\n  childrenField: \"body\",\n  toAttrs: (data) => ({ tone: data.tone }),\n  fromAttrs: (attrs, children) => ({\n    tone: attrs.string(\"tone\") as CalloutTone | undefined,\n    body: children,\n  }),\n};\n"]}

package/dist/client/blocks/library/callout.d.ts

@@ -0,0 +1,20 @@
+import type { BlockReadProps, BlockEditProps } from "../types.js";
+import { type CalloutData } from "./callout.config.js";
+/**
+ * Standard `callout` block — an emphasized note with a tone (info / decision /
+ * risk / warning / success) and a markdown body. Lives in core so any app can
+ * register it (it originated in the plan template).
+ *
+ * The section carries BOTH the app-neutral `an-callout` classes (styled by
+ * core's `blocks.css` with shadcn theme tokens, so it looks right in any app)
+ * and the legacy `plan-callout` classes (styled by the plan template's own
+ * stylesheet). Plan therefore renders byte-identically to before; content (and
+ * any other app) gets the theme-token treatment. `data-tone` drives the accent
+ * in both. The body renders through `ctx.renderMarkdown` so each app supplies
+ * its own GFM renderer (plan's react-markdown reader, content's, etc.).
+ */
+export declare function CalloutBlock({ data, blockId, title, ctx, }: BlockReadProps<CalloutData>): import("react/jsx-runtime").JSX.Element;
+export declare function CalloutBlockEdit({ data, onChange, editable, blockId, title, summary, ctx, }: BlockEditProps<CalloutData>): import("react/jsx-runtime").JSX.Element;
+/** Full client spec for the shared `callout` block (schema + MDX + Read/Edit). */
+export declare const calloutBlock: import("../types.js").BlockSpec<CalloutData>;
+//# sourceMappingURL=callout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/callout.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,GAAG,GACJ,EAAE,cAAc,CAAC,WAAW,CAAC,2CAa7B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,GACJ,EAAE,cAAc,CAAC,WAAW,CAAC,2CA6E7B;AAED,kFAAkF;AAClF,eAAO,MAAM,YAAY,8CAcvB,CAAC"}