@agent-native/core 0.37.3 → 0.39.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/tabs.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAC/E,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,kBAAkB,CAAC;AAuE1B,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,OAAO,EACP,KAAK,EACL,GAAG,GACJ,EAAE,cAAc,CAAC,QAAQ,CAAC,2CAuB1B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,EACL,GAAG,GACJ,EAAE,cAAc,CAAC,QAAQ,CAAC,2CAsI1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,2CAYpB,CAAC"}

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

@@ -0,0 +1,123 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { IconLayoutNavbar, IconPlus, IconX } from "@tabler/icons-react";
+import { cn } from "../../utils.js";
+import { defineBlock } from "../types.js";
+import { tabsSchema, tabsMdx, } from "./tabs.config.js";
+/**
+ * Standard `tabs` block: a horizontal pill-tab container whose tabs each hold a
+ * list of child blocks. Lives in core so any app (plan today, content later) can
+ * register it.
+ *
+ * `Read`/`Edit` mirror the legacy plan `TabsBlock` markup byte-for-byte (same
+ * `plan-block` section, the `inline-flex` pill tab rail with `role="tablist"`/
+ * `role="tab"`, the same active-tab `useState`, and the `compactVisuals`
+ * heuristic on the block title) so converting the block to the registry does not
+ * change rendered output. The plan CSS classes (`plan-block`, `bg-plan-block`,
+ * `text-plan-*`) resolve against the plan app's stylesheet at render time,
+ * exactly as before.
+ *
+ * Child rendering flows through `ctx.renderBlock` — the app's own block
+ * dispatcher — so registered children render via their spec and unconverted
+ * children fall through the app's legacy switch. This is the coexistence seam:
+ * the core tabs block never has to know app-specific child block types.
+ */
+/** Mint a reasonably-unique tab id without pulling a dep into core. */
+function newTabId() {
+    return `tab-${Math.random().toString(36).slice(2, 10)}`;
+}
+/** Compact embedded visuals for dense tab panes, matching legacy behavior. */
+function isCompact(title) {
+    return /interaction|component|note/i.test(title ?? "");
+}
+/** Shared pill-tab rail. */
+function TabRail({ tabs, activeId, onSelect, }) {
+    return (_jsx("div", { className: "mb-8 inline-flex max-w-full gap-1 overflow-x-auto", role: "tablist", "data-plan-interactive": true, children: tabs.map((tab) => {
+            const selected = tab.id === activeId;
+            return (_jsx("button", { type: "button", role: "tab", "aria-selected": selected, onClick: () => onSelect(tab.id), className: cn("rounded-lg px-4 py-2 text-sm font-semibold transition-colors", selected
+                    ? "bg-plan-block text-plan-text shadow-sm"
+                    : "text-plan-muted hover:bg-plan-block/60 hover:text-plan-text"), children: tab.label }, tab.id));
+        }) }));
+}
+/** Read renderer: pill tabs, child blocks rendered read-only via the app. */
+export function TabsBlockReader({ data, blockId, title, ctx, }) {
+    const [activeId, setActiveId] = useState(data.tabs[0]?.id ?? "");
+    const active = data.tabs.find((tab) => tab.id === activeId) ?? data.tabs[0];
+    const compact = isCompact(title);
+    return (_jsxs("section", { className: "plan-block", "data-block-id": blockId, children: [title && _jsx("div", { className: "plan-block-label", children: title }), _jsx(TabRail, { tabs: data.tabs, activeId: active?.id, onSelect: setActiveId }), active && (_jsx("div", { children: active.blocks.map((child) => (_jsx("div", { children: ctx.renderBlock?.({
+                        block: child,
+                        editing: false,
+                        compactVisuals: compact,
+                    }) }, child.id))) }))] }));
+}
+/**
+ * Editor: pill tabs plus tab management (add/remove/rename), with child blocks
+ * rendered editable in place through the app dispatcher. A child change updates
+ * that child within its tab and commits the whole tabs block — mirroring the
+ * legacy `TabsBlock` onChange bubbling so the plan's recursive `updateBlocks`/
+ * `findBlock` (`PlanContentRenderer`) keeps working unchanged.
+ */
+export function TabsBlockEditor({ data, onChange, editable, blockId, title, ctx, }) {
+    const [activeId, setActiveId] = useState(data.tabs[0]?.id ?? "");
+    const active = data.tabs.find((tab) => tab.id === activeId) ?? data.tabs[0];
+    const compact = isCompact(title);
+    const commit = (tabs) => onChange({ tabs });
+    const renameTab = (id, label) => commit(data.tabs.map((tab) => (tab.id === id ? { ...tab, label } : tab)));
+    const removeTab = (id) => {
+        const next = data.tabs.filter((tab) => tab.id !== id);
+        if (next.length === 0)
+            return; // tabs must keep at least one (schema min 1)
+        commit(next);
+        if (activeId === id)
+            setActiveId(next[0]?.id ?? "");
+    };
+    const addTab = () => {
+        if (data.tabs.length >= 12)
+            return; // schema max
+        const id = newTabId();
+        commit([
+            ...data.tabs,
+            { id, label: `Tab ${data.tabs.length + 1}`, blocks: [] },
+        ]);
+        setActiveId(id);
+    };
+    const updateChild = (tabId, child) => commit(data.tabs.map((tab) => tab.id === tabId
+        ? {
+            ...tab,
+            blocks: tab.blocks.map((existing) => existing.id === child.id ? child : existing),
+        }
+        : tab));
+    // Renders BARE (no `plan-block` section / title): in edit mode the app's
+    // block dispatcher already wraps registered editors in a titled `plan-block`
+    // section, so wrapping again here would double-nest. The read renderer
+    // (`TabsBlockReader`) owns its own section because read mode renders the spec
+    // directly.
+    return (_jsxs("div", { "data-tabs-edit-block": blockId, children: [_jsxs("div", { className: "mb-8 flex max-w-full flex-wrap items-center gap-1 overflow-x-auto", role: "tablist", "data-plan-interactive": true, children: [data.tabs.map((tab) => {
+                        const selected = tab.id === active?.id;
+                        return (_jsxs("div", { className: cn("group flex items-center gap-1 rounded-lg pr-1 transition-colors", selected ? "bg-plan-block shadow-sm" : "hover:bg-plan-block/60"), children: [_jsx("button", { type: "button", role: "tab", "aria-selected": selected, onClick: () => setActiveId(tab.id), className: cn("rounded-lg px-4 py-2 text-sm font-semibold transition-colors", selected ? "text-plan-text" : "text-plan-muted"), children: tab.label }), editable && data.tabs.length > 1 && (_jsx("button", { type: "button", "data-plan-interactive": true, "aria-label": `Remove ${tab.label}`, className: cn("flex size-6 shrink-0 items-center justify-center rounded text-plan-muted transition-opacity", "opacity-0 group-hover:opacity-100 group-focus-within:opacity-100", "hover:bg-muted hover:text-foreground"), onClick: () => removeTab(tab.id), children: _jsx(IconX, { className: "size-3.5 shrink-0" }) }))] }, tab.id));
+                    }), editable && data.tabs.length < 12 && (_jsxs("button", { type: "button", "data-plan-interactive": true, "aria-label": "Add tab", className: "flex items-center gap-1.5 rounded-md px-2 py-2 text-sm text-plan-muted hover:bg-plan-block/60 hover:text-plan-text", onClick: addTab, children: [_jsx(IconPlus, { className: "size-4" }), "Add tab"] }))] }), active && (_jsxs("div", { className: "grid gap-3", children: [editable && (_jsx("input", { type: "text", "data-plan-interactive": true, className: "flex h-9 w-full max-w-xs rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", placeholder: "Tab label", value: active.label, onChange: (event) => renameTab(active.id, event.target.value) })), _jsx("div", { children: active.blocks.map((child) => (_jsx("div", { children: ctx.renderBlock?.({
+                                block: child,
+                                editing: true,
+                                compactVisuals: compact,
+                                onChange: (next) => updateChild(active.id, next),
+                            }) }, child.id))) })] }))] }));
+}
+/**
+ * The standard tabs block spec (with React `Read`/`Edit`). Apps register this in
+ * their browser registry. The schema + MDX config come from `./tabs.config.ts`,
+ * the exact same object server / agent code registers, so rendering and source
+ * round-trip never drift.
+ */
+export const tabsBlock = defineBlock({
+    type: "tabs",
+    schema: tabsSchema,
+    mdx: tabsMdx,
+    Read: TabsBlockReader,
+    Edit: TabsBlockEditor,
+    placement: ["block", "inline"],
+    label: "Tabs",
+    icon: IconLayoutNavbar,
+    description: "A horizontal pill-tab container; each tab holds its own list of blocks.",
+    empty: () => ({ tabs: [{ id: newTabId(), label: "Tab 1", blocks: [] }] }),
+});
+//# sourceMappingURL=tabs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/tabs.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useState } from \"react\";\nimport { IconLayoutNavbar, IconPlus, IconX } from \"@tabler/icons-react\";\nimport { cn } from \"../../utils.js\";\nimport { defineBlock } from \"../types.js\";\nimport type { BlockReadProps, BlockEditProps, NestedBlock } from \"../types.js\";\nimport {\n  tabsSchema,\n  tabsMdx,\n  type TabsData,\n  type TabsTab,\n} from \"./tabs.config.js\";\n\n/**\n * Standard `tabs` block: a horizontal pill-tab container whose tabs each hold a\n * list of child blocks. Lives in core so any app (plan today, content later) can\n * register it.\n *\n * `Read`/`Edit` mirror the legacy plan `TabsBlock` markup byte-for-byte (same\n * `plan-block` section, the `inline-flex` pill tab rail with `role=\"tablist\"`/\n * `role=\"tab\"`, the same active-tab `useState`, and the `compactVisuals`\n * heuristic on the block title) so converting the block to the registry does not\n * change rendered output. The plan CSS classes (`plan-block`, `bg-plan-block`,\n * `text-plan-*`) resolve against the plan app's stylesheet at render time,\n * exactly as before.\n *\n * Child rendering flows through `ctx.renderBlock` — the app's own block\n * dispatcher — so registered children render via their spec and unconverted\n * children fall through the app's legacy switch. This is the coexistence seam:\n * the core tabs block never has to know app-specific child block types.\n */\n\n/** Mint a reasonably-unique tab id without pulling a dep into core. */\nfunction newTabId(): string {\n  return `tab-${Math.random().toString(36).slice(2, 10)}`;\n}\n\n/** Compact embedded visuals for dense tab panes, matching legacy behavior. */\nfunction isCompact(title: string | undefined): boolean {\n  return /interaction|component|note/i.test(title ?? \"\");\n}\n\n/** Shared pill-tab rail. */\nfunction TabRail({\n  tabs,\n  activeId,\n  onSelect,\n}: {\n  tabs: TabsTab[];\n  activeId: string | undefined;\n  onSelect: (id: string) => void;\n}) {\n  return (\n    <div\n      className=\"mb-8 inline-flex max-w-full gap-1 overflow-x-auto\"\n      role=\"tablist\"\n      data-plan-interactive\n    >\n      {tabs.map((tab) => {\n        const selected = tab.id === activeId;\n        return (\n          <button\n            key={tab.id}\n            type=\"button\"\n            role=\"tab\"\n            aria-selected={selected}\n            onClick={() => onSelect(tab.id)}\n            className={cn(\n              \"rounded-lg px-4 py-2 text-sm font-semibold transition-colors\",\n              selected\n                ? \"bg-plan-block text-plan-text shadow-sm\"\n                : \"text-plan-muted hover:bg-plan-block/60 hover:text-plan-text\",\n            )}\n          >\n            {tab.label}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\n/** Read renderer: pill tabs, child blocks rendered read-only via the app. */\nexport function TabsBlockReader({\n  data,\n  blockId,\n  title,\n  ctx,\n}: BlockReadProps<TabsData>) {\n  const [activeId, setActiveId] = useState(data.tabs[0]?.id ?? \"\");\n  const active = data.tabs.find((tab) => tab.id === activeId) ?? data.tabs[0];\n  const compact = isCompact(title);\n  return (\n    <section className=\"plan-block\" data-block-id={blockId}>\n      {title && <div className=\"plan-block-label\">{title}</div>}\n      <TabRail tabs={data.tabs} activeId={active?.id} onSelect={setActiveId} />\n      {active && (\n        <div>\n          {active.blocks.map((child) => (\n            <div key={child.id}>\n              {ctx.renderBlock?.({\n                block: child,\n                editing: false,\n                compactVisuals: compact,\n              })}\n            </div>\n          ))}\n        </div>\n      )}\n    </section>\n  );\n}\n\n/**\n * Editor: pill tabs plus tab management (add/remove/rename), with child blocks\n * rendered editable in place through the app dispatcher. A child change updates\n * that child within its tab and commits the whole tabs block — mirroring the\n * legacy `TabsBlock` onChange bubbling so the plan's recursive `updateBlocks`/\n * `findBlock` (`PlanContentRenderer`) keeps working unchanged.\n */\nexport function TabsBlockEditor({\n  data,\n  onChange,\n  editable,\n  blockId,\n  title,\n  ctx,\n}: BlockEditProps<TabsData>) {\n  const [activeId, setActiveId] = useState(data.tabs[0]?.id ?? \"\");\n  const active = data.tabs.find((tab) => tab.id === activeId) ?? data.tabs[0];\n  const compact = isCompact(title);\n\n  const commit = (tabs: TabsTab[]) => onChange({ tabs });\n\n  const renameTab = (id: string, label: string) =>\n    commit(data.tabs.map((tab) => (tab.id === id ? { ...tab, label } : tab)));\n\n  const removeTab = (id: string) => {\n    const next = data.tabs.filter((tab) => tab.id !== id);\n    if (next.length === 0) return; // tabs must keep at least one (schema min 1)\n    commit(next);\n    if (activeId === id) setActiveId(next[0]?.id ?? \"\");\n  };\n\n  const addTab = () => {\n    if (data.tabs.length >= 12) return; // schema max\n    const id = newTabId();\n    commit([\n      ...data.tabs,\n      { id, label: `Tab ${data.tabs.length + 1}`, blocks: [] },\n    ]);\n    setActiveId(id);\n  };\n\n  const updateChild = (tabId: string, child: NestedBlock) =>\n    commit(\n      data.tabs.map((tab) =>\n        tab.id === tabId\n          ? {\n              ...tab,\n              blocks: tab.blocks.map((existing) =>\n                existing.id === child.id ? child : existing,\n              ),\n            }\n          : tab,\n      ),\n    );\n\n  // Renders BARE (no `plan-block` section / title): in edit mode the app's\n  // block dispatcher already wraps registered editors in a titled `plan-block`\n  // section, so wrapping again here would double-nest. The read renderer\n  // (`TabsBlockReader`) owns its own section because read mode renders the spec\n  // directly.\n  return (\n    <div data-tabs-edit-block={blockId}>\n      <div\n        className=\"mb-8 flex max-w-full flex-wrap items-center gap-1 overflow-x-auto\"\n        role=\"tablist\"\n        data-plan-interactive\n      >\n        {data.tabs.map((tab) => {\n          const selected = tab.id === active?.id;\n          return (\n            <div\n              key={tab.id}\n              className={cn(\n                \"group flex items-center gap-1 rounded-lg pr-1 transition-colors\",\n                selected ? \"bg-plan-block shadow-sm\" : \"hover:bg-plan-block/60\",\n              )}\n            >\n              <button\n                type=\"button\"\n                role=\"tab\"\n                aria-selected={selected}\n                onClick={() => setActiveId(tab.id)}\n                className={cn(\n                  \"rounded-lg px-4 py-2 text-sm font-semibold transition-colors\",\n                  selected ? \"text-plan-text\" : \"text-plan-muted\",\n                )}\n              >\n                {tab.label}\n              </button>\n              {editable && data.tabs.length > 1 && (\n                <button\n                  type=\"button\"\n                  data-plan-interactive\n                  aria-label={`Remove ${tab.label}`}\n                  className={cn(\n                    \"flex size-6 shrink-0 items-center justify-center rounded text-plan-muted transition-opacity\",\n                    \"opacity-0 group-hover:opacity-100 group-focus-within:opacity-100\",\n                    \"hover:bg-muted hover:text-foreground\",\n                  )}\n                  onClick={() => removeTab(tab.id)}\n                >\n                  <IconX className=\"size-3.5 shrink-0\" />\n                </button>\n              )}\n            </div>\n          );\n        })}\n        {editable && data.tabs.length < 12 && (\n          <button\n            type=\"button\"\n            data-plan-interactive\n            aria-label=\"Add tab\"\n            className=\"flex items-center gap-1.5 rounded-md px-2 py-2 text-sm text-plan-muted hover:bg-plan-block/60 hover:text-plan-text\"\n            onClick={addTab}\n          >\n            <IconPlus className=\"size-4\" />\n            Add tab\n          </button>\n        )}\n      </div>\n      {active && (\n        <div className=\"grid gap-3\">\n          {editable && (\n            <input\n              type=\"text\"\n              data-plan-interactive\n              className=\"flex h-9 w-full max-w-xs rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring\"\n              placeholder=\"Tab label\"\n              value={active.label}\n              onChange={(event) => renameTab(active.id, event.target.value)}\n            />\n          )}\n          <div>\n            {active.blocks.map((child) => (\n              <div key={child.id}>\n                {ctx.renderBlock?.({\n                  block: child,\n                  editing: true,\n                  compactVisuals: compact,\n                  onChange: (next) => updateChild(active.id, next),\n                })}\n              </div>\n            ))}\n          </div>\n        </div>\n      )}\n    </div>\n  );\n}\n\n/**\n * The standard tabs block spec (with React `Read`/`Edit`). Apps register this in\n * their browser registry. The schema + MDX config come from `./tabs.config.ts`,\n * the exact same object server / agent code registers, so rendering and source\n * round-trip never drift.\n */\nexport const tabsBlock = defineBlock<TabsData>({\n  type: \"tabs\",\n  schema: tabsSchema,\n  mdx: tabsMdx,\n  Read: TabsBlockReader,\n  Edit: TabsBlockEditor,\n  placement: [\"block\", \"inline\"],\n  label: \"Tabs\",\n  icon: IconLayoutNavbar,\n  description:\n    \"A horizontal pill-tab container; each tab holds its own list of blocks.\",\n  empty: () => ({ tabs: [{ id: newTabId(), label: \"Tab 1\", blocks: [] }] }),\n});\n"]}

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

@@ -0,0 +1,74 @@
+import type { BlockSpec, BlockAttrReader } from "./types.js";
+import type { BlockRegistry } from "./registry.js";
+/**
+ * Registry-driven MDX serialize/parse, plus the shared encoder primitives that
+ * are the round-trip contract. This module is React-free so the server MDX
+ * adapter (`plan-mdx.ts`) and the agent schema export can import it. The encoder
+ * + estree literal walker are kept BYTE-FOR-BYTE identical to the originals in
+ * `plan-mdx.ts` — `plan-mdx.ts` re-imports them so nothing else there changes
+ * and stored `.mdx` files round-trip the same.
+ */
+export declare function jsonExpression(value: unknown): string;
+export declare function escapeAttr(value: string): string;
+/**
+ * Encode a single attribute. Returns "" (the attribute is dropped) for
+ * undefined/null; a bare/`={false}` flag for booleans; `={n}` for numbers; a
+ * quoted string when it matches the safe charset and is short, else a JSON
+ * expression. Objects/arrays always serialize as a JSON expression.
+ */
+export declare function prop(name: string, value: unknown): string;
+/** Minimal MDX AST node shape (subset of the remark-mdx jsx element). */
+export type MdxAttrNode = {
+    type: string;
+    name?: string;
+    value?: string | null | MdxAttrExpression;
+};
+type MdxAttrExpression = {
+    type: string;
+    value: string;
+    data?: unknown;
+};
+export type MdxJsxNode = {
+    type: string;
+    name?: string;
+    attributes?: MdxAttrNode[];
+    children?: unknown[];
+    [key: string]: unknown;
+};
+export declare function attributeValue(attr: MdxAttrNode | undefined): unknown;
+/** Build a {@link BlockAttrReader} bound to one parsed JSX node. */
+export declare function createAttrReader(node: MdxJsxNode): BlockAttrReader;
+/** The base-attribute + body shape every block carries. */
+export interface SerializableBlock {
+    id: string;
+    title?: string;
+    summary?: string;
+    editable?: boolean;
+    data: unknown;
+}
+/** Base block attributes parsed from a node, before the type-specific data. */
+export interface ParsedBlockBase {
+    id: string;
+    title?: string;
+    summary?: string;
+    editable?: boolean;
+}
+/**
+ * Serialize a block to its MDX element using its spec. Byte output MUST match
+ * the legacy `serializeBlock` for every converted block: base attrs
+ * (`id,title,summary,editable`) first, then the spec's `toAttrs` in insertion
+ * order, then either nested children, prose children, or self-closing.
+ */
+export declare function serializeSpecBlock(spec: BlockSpec<any>, block: SerializableBlock): string;
+/**
+ * Parse one MDX JSX node into a block via the registry, if its tag is
+ * registered. Returns `null` for unregistered tags so the caller can fall back
+ * to its legacy parser. `base` is the already-extracted id/title/summary/
+ * editable; `children` is the stringified prose children.
+ */
+export declare function parseSpecBlock(registry: BlockRegistry, node: MdxJsxNode, base: ParsedBlockBase, children: string, idContext: string): {
+    type: string;
+    data: unknown;
+} | null;
+export {};
+//# sourceMappingURL=mdx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/mdx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;GAOG;AAMH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAazD;AAMD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAAC;CAC3C,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAgBF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAWF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAgBrE;AA+CD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAyBlE;AAMD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,EACpB,KAAK,EAAE,iBAAiB,GACvB,MAAM,CA+BR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAmBxC"}

package/dist/client/blocks/mdx.js

@@ -0,0 +1,205 @@
+/**
+ * Registry-driven MDX serialize/parse, plus the shared encoder primitives that
+ * are the round-trip contract. This module is React-free so the server MDX
+ * adapter (`plan-mdx.ts`) and the agent schema export can import it. The encoder
+ * + estree literal walker are kept BYTE-FOR-BYTE identical to the originals in
+ * `plan-mdx.ts` — `plan-mdx.ts` re-imports them so nothing else there changes
+ * and stored `.mdx` files round-trip the same.
+ */
+/* -------------------------------------------------------------------------- */
+/* Serialize-side encoder primitives (moved verbatim from plan-mdx.ts)        */
+/* -------------------------------------------------------------------------- */
+export function jsonExpression(value) {
+    return JSON.stringify(value, null, 2);
+}
+export function escapeAttr(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/"/g, """)
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+/**
+ * Encode a single attribute. Returns "" (the attribute is dropped) for
+ * undefined/null; a bare/`={false}` flag for booleans; `={n}` for numbers; a
+ * quoted string when it matches the safe charset and is short, else a JSON
+ * expression. Objects/arrays always serialize as a JSON expression.
+ */
+export function prop(name, value) {
+    if (value === undefined || value === null)
+        return "";
+    if (typeof value === "boolean") {
+        return value ? ` ${name}` : ` ${name}={false}`;
+    }
+    if (typeof value === "number")
+        return ` ${name}={${value}}`;
+    if (typeof value === "string") {
+        if (/^[\w .:/@#,+()[\]-]+$/.test(value) && value.length < 140) {
+            return ` ${name}="${escapeAttr(value)}"`;
+        }
+        return ` ${name}={${jsonExpression(value)}}`;
+    }
+    return ` ${name}={${jsonExpression(value)}}`;
+}
+function findAttribute(node, name) {
+    return node.attributes?.find((attr) => attr.type === "mdxJsxAttribute" && attr.name === name);
+}
+export function attributeValue(attr) {
+    if (!attr)
+        return undefined;
+    if (attr.value === null || attr.value === undefined)
+        return true;
+    if (typeof attr.value === "string")
+        return attr.value;
+    const astValue = literalExpressionValue(attr.value);
+    if (astValue !== undefined)
+        return astValue;
+    const expression = attr.value.value.trim();
+    if (!expression)
+        return undefined;
+    if (expression === "undefined")
+        return undefined;
+    try {
+        return JSON.parse(expression);
+    }
+    catch {
+        throw new Error(`Unsupported MDX attribute expression for "${attr.name}": {${expression}}. Use literal values or valid JSON.`);
+    }
+}
+function literalExpressionValue(expression) {
+    const estree = expression.data
+        ?.estree;
+    const statement = estree?.body?.[0];
+    if (!statement || statement.type !== "ExpressionStatement")
+        return undefined;
+    return literalNodeValue(statement.expression);
+}
+function literalNodeValue(node) {
+    if (!node)
+        return undefined;
+    if (node.type === "Literal")
+        return node.value;
+    if (node.type === "ArrayExpression") {
+        return (node.elements ?? []).map((item) => literalNodeValue(item));
+    }
+    if (node.type === "ObjectExpression") {
+        const out = {};
+        for (const property of node.properties ?? []) {
+            if (property.type !== "Property" || property.computed)
+                return undefined;
+            const key = property.key;
+            const rawKey = key?.type === "Identifier"
+                ? key.name
+                : key?.type === "Literal" && typeof key.value === "string"
+                    ? key.value
+                    : undefined;
+            if (!rawKey)
+                return undefined;
+            const value = literalNodeValue(property.value);
+            if (value !== undefined)
+                out[rawKey] = value;
+        }
+        return out;
+    }
+    if (node.type === "UnaryExpression") {
+        const value = literalNodeValue(node.argument);
+        if (typeof value !== "number")
+            return undefined;
+        if (node.operator === "-")
+            return -value;
+        if (node.operator === "+")
+            return value;
+    }
+    if (node.type === "Identifier") {
+        if (node.name === "undefined")
+            return undefined;
+        if (node.name === "NaN")
+            return Number.NaN;
+        if (node.name === "Infinity")
+            return Infinity;
+    }
+    return undefined;
+}
+/** Build a {@link BlockAttrReader} bound to one parsed JSX node. */
+export function createAttrReader(node) {
+    const read = (name) => attributeValue(findAttribute(node, name));
+    return {
+        raw: read,
+        string(name) {
+            const value = read(name);
+            return typeof value === "string" ? value : undefined;
+        },
+        number(name) {
+            const value = read(name);
+            return typeof value === "number" ? value : undefined;
+        },
+        bool(name) {
+            const value = read(name);
+            return typeof value === "boolean" ? value : undefined;
+        },
+        array(name) {
+            const value = read(name);
+            return Array.isArray(value) ? value : undefined;
+        },
+        object(name) {
+            const value = read(name);
+            return value && typeof value === "object" ? value : undefined;
+        },
+    };
+}
+/**
+ * Serialize a block to its MDX element using its spec. Byte output MUST match
+ * the legacy `serializeBlock` for every converted block: base attrs
+ * (`id,title,summary,editable`) first, then the spec's `toAttrs` in insertion
+ * order, then either nested children, prose children, or self-closing.
+ */
+export function serializeSpecBlock(spec, block) {
+    const base = prop("id", block.id) +
+        prop("title", block.title) +
+        prop("summary", block.summary) +
+        prop("editable", block.editable);
+    const attrs = spec.mdx.toAttrs(block.data);
+    const childrenField = spec.mdx.childrenField;
+    const attrStr = Object.entries(attrs)
+        .filter(([key]) => key !== childrenField)
+        .map(([key, value]) => prop(key, value))
+        .join("");
+    const tag = spec.mdx.tag;
+    // Custom nested-MDX children (e.g. wireframe Screen/kit tree).
+    if (spec.mdx.serializeChildren) {
+        return `<${tag}${base}${attrStr}>\n${spec.mdx.serializeChildren(block.data)}\n</${tag}>`;
+    }
+    // Prose children (rich-text, callout): body is a trimmed markdown string.
+    if (childrenField) {
+        const body = String(block.data[childrenField] ?? "").trim();
+        return `<${tag}${base}${attrStr}>\n\n${body}\n\n</${tag}>`;
+    }
+    // Self-closing structured block.
+    return `<${tag}${base}${attrStr} />`;
+}
+/**
+ * Parse one MDX JSX node into a block via the registry, if its tag is
+ * registered. Returns `null` for unregistered tags so the caller can fall back
+ * to its legacy parser. `base` is the already-extracted id/title/summary/
+ * editable; `children` is the stringified prose children.
+ */
+export function parseSpecBlock(registry, node, base, children, idContext) {
+    const tag = node.name;
+    if (!tag)
+        return null;
+    const spec = registry.getByTag(tag);
+    if (!spec)
+        return null;
+    const reader = createAttrReader(node);
+    let data;
+    if (spec.mdx.parseChildren) {
+        const fromAttrs = spec.mdx.fromAttrs(reader, children);
+        const fromChildren = spec.mdx.parseChildren(node.children ?? [], `${idContext}-${base.id}`);
+        data = { ...fromAttrs, ...fromChildren };
+    }
+    else {
+        data = spec.mdx.fromAttrs(reader, children);
+    }
+    return { type: spec.type, data };
+}
+//# sourceMappingURL=mdx.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.js","sourceRoot":"","sources":["../../../src/client/blocks/mdx.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BlockSpec, BlockAttrReader, MdxAttrValue } from \"./types.js\";\nimport type { BlockRegistry } from \"./registry.js\";\n\n/**\n * Registry-driven MDX serialize/parse, plus the shared encoder primitives that\n * are the round-trip contract. This module is React-free so the server MDX\n * adapter (`plan-mdx.ts`) and the agent schema export can import it. The encoder\n * + estree literal walker are kept BYTE-FOR-BYTE identical to the originals in\n * `plan-mdx.ts` — `plan-mdx.ts` re-imports them so nothing else there changes\n * and stored `.mdx` files round-trip the same.\n */\n\n/* -------------------------------------------------------------------------- */\n/* Serialize-side encoder primitives (moved verbatim from plan-mdx.ts)        */\n/* -------------------------------------------------------------------------- */\n\nexport function jsonExpression(value: unknown): string {\n  return JSON.stringify(value, null, 2);\n}\n\nexport function escapeAttr(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\n/**\n * Encode a single attribute. Returns \"\" (the attribute is dropped) for\n * undefined/null; a bare/`={false}` flag for booleans; `={n}` for numbers; a\n * quoted string when it matches the safe charset and is short, else a JSON\n * expression. Objects/arrays always serialize as a JSON expression.\n */\nexport function prop(name: string, value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  if (typeof value === \"boolean\") {\n    return value ? ` ${name}` : ` ${name}={false}`;\n  }\n  if (typeof value === \"number\") return ` ${name}={${value}}`;\n  if (typeof value === \"string\") {\n    if (/^[\\w .:/@#,+()[\\]-]+$/.test(value) && value.length < 140) {\n      return ` ${name}=\"${escapeAttr(value)}\"`;\n    }\n    return ` ${name}={${jsonExpression(value)}}`;\n  }\n  return ` ${name}={${jsonExpression(value)}}`;\n}\n\n/* -------------------------------------------------------------------------- */\n/* Parse-side attribute resolution (moved verbatim from plan-mdx.ts)          */\n/* -------------------------------------------------------------------------- */\n\n/** Minimal MDX AST node shape (subset of the remark-mdx jsx element). */\nexport type MdxAttrNode = {\n  type: string;\n  name?: string;\n  value?: string | null | MdxAttrExpression;\n};\n\ntype MdxAttrExpression = {\n  type: string;\n  value: string;\n  data?: unknown;\n};\n\ntype EstreeNode = {\n  type: string;\n  value?: unknown;\n  name?: string;\n  expression?: EstreeNode;\n  body?: EstreeNode[];\n  elements?: Array<EstreeNode | null>;\n  properties?: EstreeNode[];\n  key?: EstreeNode;\n  computed?: boolean;\n  argument?: EstreeNode;\n  operator?: string;\n};\n\nexport type MdxJsxNode = {\n  type: string;\n  name?: string;\n  attributes?: MdxAttrNode[];\n  children?: unknown[];\n  [key: string]: unknown;\n};\n\nfunction findAttribute(\n  node: MdxJsxNode,\n  name: string,\n): MdxAttrNode | undefined {\n  return node.attributes?.find(\n    (attr) => attr.type === \"mdxJsxAttribute\" && attr.name === name,\n  );\n}\n\nexport function attributeValue(attr: MdxAttrNode | undefined): unknown {\n  if (!attr) return undefined;\n  if (attr.value === null || attr.value === undefined) return true;\n  if (typeof attr.value === \"string\") return attr.value;\n  const astValue = literalExpressionValue(attr.value);\n  if (astValue !== undefined) return astValue;\n  const expression = attr.value.value.trim();\n  if (!expression) return undefined;\n  if (expression === \"undefined\") return undefined;\n  try {\n    return JSON.parse(expression);\n  } catch {\n    throw new Error(\n      `Unsupported MDX attribute expression for \"${attr.name}\": {${expression}}. Use literal values or valid JSON.`,\n    );\n  }\n}\n\nfunction literalExpressionValue(expression: MdxAttrExpression): unknown {\n  const estree = (expression.data as { estree?: EstreeNode } | undefined)\n    ?.estree;\n  const statement = estree?.body?.[0];\n  if (!statement || statement.type !== \"ExpressionStatement\") return undefined;\n  return literalNodeValue(statement.expression);\n}\n\nfunction literalNodeValue(node: EstreeNode | undefined | null): unknown {\n  if (!node) return undefined;\n  if (node.type === \"Literal\") return node.value;\n  if (node.type === \"ArrayExpression\") {\n    return (node.elements ?? []).map((item) => literalNodeValue(item));\n  }\n  if (node.type === \"ObjectExpression\") {\n    const out: Record<string, unknown> = {};\n    for (const property of node.properties ?? []) {\n      if (property.type !== \"Property\" || property.computed) return undefined;\n      const key = property.key;\n      const rawKey =\n        key?.type === \"Identifier\"\n          ? key.name\n          : key?.type === \"Literal\" && typeof key.value === \"string\"\n            ? key.value\n            : undefined;\n      if (!rawKey) return undefined;\n      const value = literalNodeValue(property.value as EstreeNode | undefined);\n      if (value !== undefined) out[rawKey] = value;\n    }\n    return out;\n  }\n  if (node.type === \"UnaryExpression\") {\n    const value = literalNodeValue(node.argument);\n    if (typeof value !== \"number\") return undefined;\n    if (node.operator === \"-\") return -value;\n    if (node.operator === \"+\") return value;\n  }\n  if (node.type === \"Identifier\") {\n    if (node.name === \"undefined\") return undefined;\n    if (node.name === \"NaN\") return Number.NaN;\n    if (node.name === \"Infinity\") return Infinity;\n  }\n  return undefined;\n}\n\n/** Build a {@link BlockAttrReader} bound to one parsed JSX node. */\nexport function createAttrReader(node: MdxJsxNode): BlockAttrReader {\n  const read = (name: string) => attributeValue(findAttribute(node, name));\n  return {\n    raw: read,\n    string(name) {\n      const value = read(name);\n      return typeof value === \"string\" ? value : undefined;\n    },\n    number(name) {\n      const value = read(name);\n      return typeof value === \"number\" ? value : undefined;\n    },\n    bool(name) {\n      const value = read(name);\n      return typeof value === \"boolean\" ? value : undefined;\n    },\n    array(name) {\n      const value = read(name);\n      return Array.isArray(value) ? (value as never[]) : undefined;\n    },\n    object(name) {\n      const value = read(name);\n      return value && typeof value === \"object\" ? (value as never) : undefined;\n    },\n  };\n}\n\n/* -------------------------------------------------------------------------- */\n/* Registry serialize / parse                                                 */\n/* -------------------------------------------------------------------------- */\n\n/** The base-attribute + body shape every block carries. */\nexport interface SerializableBlock {\n  id: string;\n  title?: string;\n  summary?: string;\n  editable?: boolean;\n  data: unknown;\n}\n\n/** Base block attributes parsed from a node, before the type-specific data. */\nexport interface ParsedBlockBase {\n  id: string;\n  title?: string;\n  summary?: string;\n  editable?: boolean;\n}\n\n/**\n * Serialize a block to its MDX element using its spec. Byte output MUST match\n * the legacy `serializeBlock` for every converted block: base attrs\n * (`id,title,summary,editable`) first, then the spec's `toAttrs` in insertion\n * order, then either nested children, prose children, or self-closing.\n */\nexport function serializeSpecBlock(\n  spec: BlockSpec<any>,\n  block: SerializableBlock,\n): string {\n  const base =\n    prop(\"id\", block.id) +\n    prop(\"title\", block.title) +\n    prop(\"summary\", block.summary) +\n    prop(\"editable\", block.editable);\n\n  const attrs = spec.mdx.toAttrs(block.data);\n  const childrenField = spec.mdx.childrenField;\n  const attrStr = Object.entries(attrs)\n    .filter(([key]) => key !== childrenField)\n    .map(([key, value]) => prop(key, value as MdxAttrValue | undefined))\n    .join(\"\");\n\n  const tag = spec.mdx.tag;\n\n  // Custom nested-MDX children (e.g. wireframe Screen/kit tree).\n  if (spec.mdx.serializeChildren) {\n    return `<${tag}${base}${attrStr}>\\n${spec.mdx.serializeChildren(block.data)}\\n</${tag}>`;\n  }\n\n  // Prose children (rich-text, callout): body is a trimmed markdown string.\n  if (childrenField) {\n    const body = String(\n      (block.data as Record<string, unknown>)[childrenField] ?? \"\",\n    ).trim();\n    return `<${tag}${base}${attrStr}>\\n\\n${body}\\n\\n</${tag}>`;\n  }\n\n  // Self-closing structured block.\n  return `<${tag}${base}${attrStr} />`;\n}\n\n/**\n * Parse one MDX JSX node into a block via the registry, if its tag is\n * registered. Returns `null` for unregistered tags so the caller can fall back\n * to its legacy parser. `base` is the already-extracted id/title/summary/\n * editable; `children` is the stringified prose children.\n */\nexport function parseSpecBlock(\n  registry: BlockRegistry,\n  node: MdxJsxNode,\n  base: ParsedBlockBase,\n  children: string,\n  idContext: string,\n): { type: string; data: unknown } | null {\n  const tag = node.name;\n  if (!tag) return null;\n  const spec = registry.getByTag(tag);\n  if (!spec) return null;\n\n  const reader = createAttrReader(node);\n  let data: unknown;\n  if (spec.mdx.parseChildren) {\n    const fromAttrs = spec.mdx.fromAttrs(reader, children);\n    const fromChildren = spec.mdx.parseChildren(\n      node.children ?? [],\n      `${idContext}-${base.id}`,\n    );\n    data = { ...(fromAttrs as object), ...(fromChildren as object) };\n  } else {\n    data = spec.mdx.fromAttrs(reader, children);\n  }\n  return { type: spec.type, data };\n}\n"]}

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

@@ -0,0 +1,25 @@
+import { type ReactNode } from "react";
+import type { BlockRegistry } from "./registry.js";
+import type { BlockRenderContext } from "./types.js";
+/**
+ * React provision for the block registry. The registry itself is a per-app
+ * module singleton (so the server MDX serializer/parser and the agent schema
+ * export can import it outside React); this thin context threads that singleton
+ * plus the runtime {@link BlockRenderContext} (asset resolver, action caller,
+ * inline markdown editor, …) into the renderer, and lets tests swap registries.
+ */
+interface BlockRegistryValue {
+    registry: BlockRegistry;
+    ctx: BlockRenderContext;
+}
+export declare function BlockRegistryProvider({ registry, ctx, children, }: {
+    registry: BlockRegistry;
+    ctx: BlockRenderContext;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** Read the active registry + render context. Throws outside a provider. */
+export declare function useBlockRegistry(): BlockRegistryValue;
+/** Read the active registry + render context, or `null` outside a provider. */
+export declare function useOptionalBlockRegistry(): BlockRegistryValue | null;
+export {};
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AAEH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAID,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,GAAG,EACH,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,kBAAkB,CAAC;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAMA;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,IAAI,kBAAkB,CAQrD;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,IAAI,kBAAkB,GAAG,IAAI,CAEpE"}

package/dist/client/blocks/provider.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const BlockRegistryContext = createContext(null);
+export function BlockRegistryProvider({ registry, ctx, children, }) {
+    return (_jsx(BlockRegistryContext.Provider, { value: { registry, ctx }, children: children }));
+}
+/** Read the active registry + render context. Throws outside a provider. */
+export function useBlockRegistry() {
+    const value = useContext(BlockRegistryContext);
+    if (!value) {
+        throw new Error("useBlockRegistry must be used inside a <BlockRegistryProvider>.");
+    }
+    return value;
+}
+/** Read the active registry + render context, or `null` outside a provider. */
+export function useOptionalBlockRegistry() {
+    return useContext(BlockRegistryContext);
+}
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/client/blocks/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAiBlE,MAAM,oBAAoB,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAE5E,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,EACR,GAAG,EACH,QAAQ,GAKT;IACC,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,YACpD,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport type { BlockRegistry } from \"./registry.js\";\nimport type { BlockRenderContext } from \"./types.js\";\n\n/**\n * React provision for the block registry. The registry itself is a per-app\n * module singleton (so the server MDX serializer/parser and the agent schema\n * export can import it outside React); this thin context threads that singleton\n * plus the runtime {@link BlockRenderContext} (asset resolver, action caller,\n * inline markdown editor, …) into the renderer, and lets tests swap registries.\n */\n\ninterface BlockRegistryValue {\n  registry: BlockRegistry;\n  ctx: BlockRenderContext;\n}\n\nconst BlockRegistryContext = createContext<BlockRegistryValue | null>(null);\n\nexport function BlockRegistryProvider({\n  registry,\n  ctx,\n  children,\n}: {\n  registry: BlockRegistry;\n  ctx: BlockRenderContext;\n  children: ReactNode;\n}) {\n  return (\n    <BlockRegistryContext.Provider value={{ registry, ctx }}>\n      {children}\n    </BlockRegistryContext.Provider>\n  );\n}\n\n/** Read the active registry + render context. Throws outside a provider. */\nexport function useBlockRegistry(): BlockRegistryValue {\n  const value = useContext(BlockRegistryContext);\n  if (!value) {\n    throw new Error(\n      \"useBlockRegistry must be used inside a <BlockRegistryProvider>.\",\n    );\n  }\n  return value;\n}\n\n/** Read the active registry + render context, or `null` outside a provider. */\nexport function useOptionalBlockRegistry(): BlockRegistryValue | null {\n  return useContext(BlockRegistryContext);\n}\n"]}

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

@@ -0,0 +1,32 @@
+import type { BlockSpec, BlockPlacement } from "./types.js";
+/**
+ * In-memory block registry. Holds two lookups: by runtime `type` (render +
+ * serialize side) and by MDX `tag` (parse side). The registry is a plain object
+ * usable both inside React (via the context provider) and outside it (the
+ * server MDX serializer/parser, agent schema export) — mirroring how the legacy
+ * `BLOCK_COMPONENTS` set and `serializeBlock`/`parseBlock` are plain functions.
+ */
+export declare class BlockRegistry {
+    private byType;
+    private byTag;
+    register(spec: BlockSpec<any>): void;
+    get(type: string): BlockSpec<any> | undefined;
+    getByTag(tag: string): BlockSpec<any> | undefined;
+    has(type: string): boolean;
+    hasTag(tag: string): boolean;
+    /** All registered MDX tags — replaces the hardcoded `BLOCK_COMPONENTS` set. */
+    tags(): Set<string>;
+    /**
+     * The set of registered block `type`s whose specs declare
+     * `notionCompatible: true` — i.e. they round-trip to Notion-Flavored Markdown
+     * and may sync to Notion. Apps use this as the registry-backed part of their
+     * Notion gating allowlist; prose-only NFM analogs that are not registry atoms
+     * (rich-text, callout) are NOT in here — apps union those in separately.
+     */
+    notionCompatibleTypes(): Set<string>;
+    /** All registered specs, optionally filtered by placement. */
+    list(placement?: BlockPlacement): BlockSpec<any>[];
+}
+/** Register a batch of specs in order. */
+export declare function registerBlocks(registry: BlockRegistry, specs: BlockSpec<any>[]): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,KAAK,CAAqC;IAElD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAWpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;IAI7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS;IAIjD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,+EAA+E;IAC/E,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;IAInB;;;;;;OAMG;IACH,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC;IAQpC,8DAA8D;IAC9D,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE;CAMnD;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,GACtB,IAAI,CAEN"}