@agent-native/core 0.37.3 → 0.38.0

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,24 @@
+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>;
+    /** 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,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"}

package/dist/client/blocks/registry.js

@@ -0,0 +1,50 @@
+/**
+ * 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 class BlockRegistry {
+    byType = new Map();
+    byTag = new Map();
+    register(spec) {
+        if (this.byType.has(spec.type)) {
+            throw new Error(`Block type "${spec.type}" is already registered.`);
+        }
+        if (this.byTag.has(spec.mdx.tag)) {
+            throw new Error(`Block MDX tag "${spec.mdx.tag}" is already registered.`);
+        }
+        this.byType.set(spec.type, spec);
+        this.byTag.set(spec.mdx.tag, spec);
+    }
+    get(type) {
+        return this.byType.get(type);
+    }
+    getByTag(tag) {
+        return this.byTag.get(tag);
+    }
+    has(type) {
+        return this.byType.has(type);
+    }
+    hasTag(tag) {
+        return this.byTag.has(tag);
+    }
+    /** All registered MDX tags — replaces the hardcoded `BLOCK_COMPONENTS` set. */
+    tags() {
+        return new Set(this.byTag.keys());
+    }
+    /** All registered specs, optionally filtered by placement. */
+    list(placement) {
+        const all = [...this.byType.values()];
+        return placement
+            ? all.filter((spec) => spec.placement.includes(placement))
+            : all;
+    }
+}
+/** Register a batch of specs in order. */
+export function registerBlocks(registry, specs) {
+    for (const spec of specs)
+        registry.register(spec);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/client/blocks/registry.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC3C,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,GAAG,CAAC,GAAG,0BAA0B,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,+EAA+E;IAC/E,IAAI;QACF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,SAA0B;QAC7B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,OAAO,SAAS;YACd,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1D,CAAC,CAAC,GAAG,CAAC;IACV,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAC5B,QAAuB,EACvB,KAAuB;IAEvB,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import type { BlockSpec, BlockPlacement } from \"./types.js\";\n\n/**\n * In-memory block registry. Holds two lookups: by runtime `type` (render +\n * serialize side) and by MDX `tag` (parse side). The registry is a plain object\n * usable both inside React (via the context provider) and outside it (the\n * server MDX serializer/parser, agent schema export) — mirroring how the legacy\n * `BLOCK_COMPONENTS` set and `serializeBlock`/`parseBlock` are plain functions.\n */\nexport class BlockRegistry {\n  private byType = new Map<string, BlockSpec<any>>();\n  private byTag = new Map<string, BlockSpec<any>>();\n\n  register(spec: BlockSpec<any>): void {\n    if (this.byType.has(spec.type)) {\n      throw new Error(`Block type \"${spec.type}\" is already registered.`);\n    }\n    if (this.byTag.has(spec.mdx.tag)) {\n      throw new Error(`Block MDX tag \"${spec.mdx.tag}\" is already registered.`);\n    }\n    this.byType.set(spec.type, spec);\n    this.byTag.set(spec.mdx.tag, spec);\n  }\n\n  get(type: string): BlockSpec<any> | undefined {\n    return this.byType.get(type);\n  }\n\n  getByTag(tag: string): BlockSpec<any> | undefined {\n    return this.byTag.get(tag);\n  }\n\n  has(type: string): boolean {\n    return this.byType.has(type);\n  }\n\n  hasTag(tag: string): boolean {\n    return this.byTag.has(tag);\n  }\n\n  /** All registered MDX tags — replaces the hardcoded `BLOCK_COMPONENTS` set. */\n  tags(): Set<string> {\n    return new Set(this.byTag.keys());\n  }\n\n  /** All registered specs, optionally filtered by placement. */\n  list(placement?: BlockPlacement): BlockSpec<any>[] {\n    const all = [...this.byType.values()];\n    return placement\n      ? all.filter((spec) => spec.placement.includes(placement))\n      : all;\n  }\n}\n\n/** Register a batch of specs in order. */\nexport function registerBlocks(\n  registry: BlockRegistry,\n  specs: BlockSpec<any>[],\n): void {\n  for (const spec of specs) registry.register(spec);\n}\n"]}

package/dist/client/blocks/schema-form/introspect.d.ts

@@ -0,0 +1,31 @@
+import { type ZodType, type ZodTypeAny } from "zod";
+/**
+ * Tag a string schema so the auto-editor renders it with the shared inline
+ * rich-markdown editor (Notion-style editing) instead of a plain textarea.
+ * Survives `.optional()` because `unwrap` reads the inner description.
+ */
+export declare function markdown(schema?: ZodTypeAny): ZodTypeAny;
+/** Alias for {@link markdown} — tags a string field as rich text. */
+export declare function richtext(schema?: ZodTypeAny): ZodTypeAny;
+export type FieldKind = "markdown" | "richtext" | "text" | "longtext" | "number" | "boolean" | "enum" | "array" | "object" | "unsupported";
+export interface FieldDescriptor {
+    key: string;
+    /** Humanized key for the field label. */
+    label: string;
+    kind: FieldKind;
+    optional: boolean;
+    enumValues?: string[];
+    /** Element schema for arrays / inner schema for objects. */
+    inner?: ZodTypeAny;
+    /** Element descriptors for object fields (one level of nesting). */
+    fields?: FieldDescriptor[];
+    /** Description tag, when present (used to detect markdown/richtext). */
+    description?: string;
+}
+/**
+ * Introspect a block's `data` schema into a flat list of field descriptors. The
+ * input is unwrapped to its object schema first (so an `.optional()`-wrapped or
+ * `.refine()`-wrapped object still yields its fields).
+ */
+export declare function introspect(schema: ZodType<unknown>): FieldDescriptor[];
+//# sourceMappingURL=introspect.d.ts.map

package/dist/client/blocks/schema-form/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/schema-form/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAiBvD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,GAAE,UAAuB,GAAG,UAAU,CAEpE;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,MAAM,GAAE,UAAuB,GAAG,UAAU,CAEpE;AAED,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,UAAU,GACV,MAAM,GACN,UAAU,GACV,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,eAAe,EAAE,CAKtE"}

package/dist/client/blocks/schema-form/introspect.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+/**
+ * Schema introspection for the auto-editor. Walks a block's zod `data` schema
+ * and classifies each top-level field into a {@link FieldKind} the
+ * `SchemaBlockEditor` knows how to render.
+ *
+ * zod v4 note: schemas expose `_def.type` (a string discriminator) rather than
+ * v3's `typeName`. Object shape is `_def.shape`, array element is `_def.element`,
+ * enum options are `.options`. `.describe()` does NOT propagate through
+ * `.optional()`/`.default()`/`.nullable()` to the outer schema, so `unwrap`
+ * inherits the innermost description while peeling wrapper layers.
+ */
+const MD_TAG = "x-an-field:markdown";
+const RT_TAG = "x-an-field:richtext";
+/**
+ * Tag a string schema so the auto-editor renders it with the shared inline
+ * rich-markdown editor (Notion-style editing) instead of a plain textarea.
+ * Survives `.optional()` because `unwrap` reads the inner description.
+ */
+export function markdown(schema = z.string()) {
+    return schema.describe(MD_TAG);
+}
+/** Alias for {@link markdown} — tags a string field as rich text. */
+export function richtext(schema = z.string()) {
+    return schema.describe(RT_TAG);
+}
+function defType(schema) {
+    return schema?._def?.type;
+}
+/** Peel optional/default/nullable/refine wrappers; keep the innermost description. */
+function unwrap(schema) {
+    let current = schema;
+    let optional = false;
+    let description = current?.description;
+    // Bound the loop so a malformed schema can never spin forever.
+    for (let i = 0; i < 12; i++) {
+        const type = defType(current);
+        const inner = current._def
+            ?.innerType;
+        if (type === "optional" || type === "nullable" || type === "nullish") {
+            optional = true;
+        }
+        else if (type === "default" || type === "catch" || type === "readonly") {
+            // not optional per se, but a wrapper to peel
+        }
+        else {
+            break;
+        }
+        if (!inner)
+            break;
+        current = inner;
+        description = description ?? current.description;
+    }
+    return { schema: current, optional, description };
+}
+function humanize(key) {
+    return key
+        .replace(/[_-]+/g, " ")
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/^\w/, (c) => c.toUpperCase());
+}
+function classify(schema, description) {
+    if (description === MD_TAG)
+        return "markdown";
+    if (description === RT_TAG)
+        return "richtext";
+    const type = defType(schema);
+    switch (type) {
+        case "string": {
+            // A long max length implies a textarea; otherwise a single-line input.
+            const checks = schema._def
+                ?.checks;
+            const max = readMaxLength(checks);
+            return max !== undefined && max > 240 ? "longtext" : "text";
+        }
+        case "number":
+        case "bigint":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "enum":
+            return "enum";
+        case "array":
+            return "array";
+        case "object":
+            return "object";
+        default:
+            return "unsupported";
+    }
+}
+function readMaxLength(checks) {
+    if (!checks)
+        return undefined;
+    for (const check of checks) {
+        const def = check?._zod?.def;
+        if (def?.check === "max_length" && typeof def.maximum === "number") {
+            return def.maximum;
+        }
+        // Fallback for shapes that expose the bound directly.
+        const direct = check;
+        if (direct?.kind === "max" && typeof direct.value === "number") {
+            return direct.value;
+        }
+        if (typeof direct?.maximum === "number")
+            return direct.maximum;
+    }
+    return undefined;
+}
+function objectShape(schema) {
+    const rawShape = schema._def?.shape;
+    if (!rawShape)
+        return null;
+    const shape = typeof rawShape === "function" ? rawShape() : rawShape;
+    return shape && typeof shape === "object"
+        ? shape
+        : null;
+}
+function describeField(key, raw) {
+    const { schema, optional, description } = unwrap(raw);
+    const kind = classify(schema, description);
+    const descriptor = {
+        key,
+        label: humanize(key),
+        kind,
+        optional,
+        description,
+    };
+    if (kind === "enum") {
+        const options = schema.options;
+        descriptor.enumValues = Array.isArray(options)
+            ? options.map((value) => String(value))
+            : [];
+    }
+    else if (kind === "array") {
+        const element = schema._def
+            ?.element;
+        descriptor.inner = element;
+        const elementShape = element ? objectShape(unwrap(element).schema) : null;
+        if (elementShape) {
+            descriptor.fields = Object.entries(elementShape).map(([childKey, child]) => describeField(childKey, child));
+        }
+    }
+    else if (kind === "object") {
+        descriptor.inner = schema;
+        const shape = objectShape(schema);
+        if (shape) {
+            descriptor.fields = Object.entries(shape).map(([childKey, child]) => describeField(childKey, child));
+        }
+    }
+    return descriptor;
+}
+/**
+ * Introspect a block's `data` schema into a flat list of field descriptors. The
+ * input is unwrapped to its object schema first (so an `.optional()`-wrapped or
+ * `.refine()`-wrapped object still yields its fields).
+ */
+export function introspect(schema) {
+    const { schema: unwrapped } = unwrap(schema);
+    const shape = objectShape(unwrapped);
+    if (!shape)
+        return [];
+    return Object.entries(shape).map(([key, child]) => describeField(key, child));
+}
+//# sourceMappingURL=introspect.js.map

package/dist/client/blocks/schema-form/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../../../src/client/blocks/schema-form/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAiC,MAAM,KAAK,CAAC;AAEvD;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,GAAG,qBAAqB,CAAC;AACrC,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAqB,CAAC,CAAC,MAAM,EAAE;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,SAAqB,CAAC,CAAC,MAAM,EAAE;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AA6BD,SAAS,OAAO,CAAC,MAAkB;IACjC,OAAQ,MAAM,EAAE,IAAsC,EAAE,IAAI,CAAC;AAC/D,CAAC;AAED,sFAAsF;AACtF,SAAS,MAAM,CAAC,MAAkB;IAKhC,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,WAAW,GAAuB,OAAO,EAAE,WAAW,CAAC;IAC3D,+DAA+D;IAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAI,OAAO,CAAC,IAA+C;YACpE,EAAE,SAAS,CAAC;QACd,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrE,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACzE,6CAA6C;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM;QAClB,OAAO,GAAG,KAAK,CAAC;QAChB,WAAW,GAAG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,GAAG;SACP,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,QAAQ,CAAC,MAAkB,EAAE,WAAoB;IACxD,IAAI,WAAW,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IAC9C,IAAI,WAAW,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,uEAAuE;YACvE,MAAM,MAAM,GAAI,MAAM,CAAC,IAA2C;gBAChE,EAAE,MAAM,CAAC;YACX,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAA6B;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GACP,KACD,EAAE,IAAI,EAAE,GAAG,CAAC;QACb,IAAI,GAAG,EAAE,KAAK,KAAK,YAAY,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnE,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,sDAAsD;QACtD,MAAM,MAAM,GAAG,KAA4D,CAAC;QAC5E,IAAI,MAAM,EAAE,IAAI,KAAK,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/D,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,IAAI,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACjE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB;IACrC,MAAM,QAAQ,GAAI,MAAM,CAAC,IAAwC,EAAE,KAAK,CAAC;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrE,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACvC,CAAC,CAAE,KAAoC;QACvC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,GAAe;IACjD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAoB;QAClC,GAAG;QACH,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC;QACpB,IAAI;QACJ,QAAQ;QACR,WAAW;KACZ,CAAC;IACF,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,OAAO,GAAI,MAAkC,CAAC,OAAO,CAAC;QAC5D,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAC5C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAI,MAAM,CAAC,IAA6C;YACnE,EAAE,OAAO,CAAC;QACZ,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,IAAI,YAAY,EAAE,CAAC;YACjB,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAClD,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC;QAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAClE,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAoB,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import { z, type ZodType, type ZodTypeAny } from \"zod\";\n\n/**\n * Schema introspection for the auto-editor. Walks a block's zod `data` schema\n * and classifies each top-level field into a {@link FieldKind} the\n * `SchemaBlockEditor` knows how to render.\n *\n * zod v4 note: schemas expose `_def.type` (a string discriminator) rather than\n * v3's `typeName`. Object shape is `_def.shape`, array element is `_def.element`,\n * enum options are `.options`. `.describe()` does NOT propagate through\n * `.optional()`/`.default()`/`.nullable()` to the outer schema, so `unwrap`\n * inherits the innermost description while peeling wrapper layers.\n */\n\nconst MD_TAG = \"x-an-field:markdown\";\nconst RT_TAG = \"x-an-field:richtext\";\n\n/**\n * Tag a string schema so the auto-editor renders it with the shared inline\n * rich-markdown editor (Notion-style editing) instead of a plain textarea.\n * Survives `.optional()` because `unwrap` reads the inner description.\n */\nexport function markdown(schema: ZodTypeAny = z.string()): ZodTypeAny {\n  return schema.describe(MD_TAG);\n}\n\n/** Alias for {@link markdown} — tags a string field as rich text. */\nexport function richtext(schema: ZodTypeAny = z.string()): ZodTypeAny {\n  return schema.describe(RT_TAG);\n}\n\nexport type FieldKind =\n  | \"markdown\"\n  | \"richtext\"\n  | \"text\"\n  | \"longtext\"\n  | \"number\"\n  | \"boolean\"\n  | \"enum\"\n  | \"array\"\n  | \"object\"\n  | \"unsupported\";\n\nexport interface FieldDescriptor {\n  key: string;\n  /** Humanized key for the field label. */\n  label: string;\n  kind: FieldKind;\n  optional: boolean;\n  enumValues?: string[];\n  /** Element schema for arrays / inner schema for objects. */\n  inner?: ZodTypeAny;\n  /** Element descriptors for object fields (one level of nesting). */\n  fields?: FieldDescriptor[];\n  /** Description tag, when present (used to detect markdown/richtext). */\n  description?: string;\n}\n\nfunction defType(schema: ZodTypeAny): string | undefined {\n  return (schema?._def as { type?: string } | undefined)?.type;\n}\n\n/** Peel optional/default/nullable/refine wrappers; keep the innermost description. */\nfunction unwrap(schema: ZodTypeAny): {\n  schema: ZodTypeAny;\n  optional: boolean;\n  description?: string;\n} {\n  let current = schema;\n  let optional = false;\n  let description: string | undefined = current?.description;\n  // Bound the loop so a malformed schema can never spin forever.\n  for (let i = 0; i < 12; i++) {\n    const type = defType(current);\n    const inner = (current._def as { innerType?: ZodTypeAny } | undefined)\n      ?.innerType;\n    if (type === \"optional\" || type === \"nullable\" || type === \"nullish\") {\n      optional = true;\n    } else if (type === \"default\" || type === \"catch\" || type === \"readonly\") {\n      // not optional per se, but a wrapper to peel\n    } else {\n      break;\n    }\n    if (!inner) break;\n    current = inner;\n    description = description ?? current.description;\n  }\n  return { schema: current, optional, description };\n}\n\nfunction humanize(key: string): string {\n  return key\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/^\\w/, (c) => c.toUpperCase());\n}\n\nfunction classify(schema: ZodTypeAny, description?: string): FieldKind {\n  if (description === MD_TAG) return \"markdown\";\n  if (description === RT_TAG) return \"richtext\";\n  const type = defType(schema);\n  switch (type) {\n    case \"string\": {\n      // A long max length implies a textarea; otherwise a single-line input.\n      const checks = (schema._def as { checks?: unknown[] } | undefined)\n        ?.checks;\n      const max = readMaxLength(checks);\n      return max !== undefined && max > 240 ? \"longtext\" : \"text\";\n    }\n    case \"number\":\n    case \"bigint\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"enum\":\n      return \"enum\";\n    case \"array\":\n      return \"array\";\n    case \"object\":\n      return \"object\";\n    default:\n      return \"unsupported\";\n  }\n}\n\nfunction readMaxLength(checks: unknown[] | undefined): number | undefined {\n  if (!checks) return undefined;\n  for (const check of checks) {\n    const def = (\n      check as { _zod?: { def?: { check?: string; maximum?: number } } }\n    )?._zod?.def;\n    if (def?.check === \"max_length\" && typeof def.maximum === \"number\") {\n      return def.maximum;\n    }\n    // Fallback for shapes that expose the bound directly.\n    const direct = check as { kind?: string; value?: number; maximum?: number };\n    if (direct?.kind === \"max\" && typeof direct.value === \"number\") {\n      return direct.value;\n    }\n    if (typeof direct?.maximum === \"number\") return direct.maximum;\n  }\n  return undefined;\n}\n\nfunction objectShape(schema: ZodTypeAny): Record<string, ZodTypeAny> | null {\n  const rawShape = (schema._def as { shape?: unknown } | undefined)?.shape;\n  if (!rawShape) return null;\n  const shape = typeof rawShape === \"function\" ? rawShape() : rawShape;\n  return shape && typeof shape === \"object\"\n    ? (shape as Record<string, ZodTypeAny>)\n    : null;\n}\n\nfunction describeField(key: string, raw: ZodTypeAny): FieldDescriptor {\n  const { schema, optional, description } = unwrap(raw);\n  const kind = classify(schema, description);\n  const descriptor: FieldDescriptor = {\n    key,\n    label: humanize(key),\n    kind,\n    optional,\n    description,\n  };\n  if (kind === \"enum\") {\n    const options = (schema as { options?: unknown[] }).options;\n    descriptor.enumValues = Array.isArray(options)\n      ? options.map((value) => String(value))\n      : [];\n  } else if (kind === \"array\") {\n    const element = (schema._def as { element?: ZodTypeAny } | undefined)\n      ?.element;\n    descriptor.inner = element;\n    const elementShape = element ? objectShape(unwrap(element).schema) : null;\n    if (elementShape) {\n      descriptor.fields = Object.entries(elementShape).map(\n        ([childKey, child]) => describeField(childKey, child),\n      );\n    }\n  } else if (kind === \"object\") {\n    descriptor.inner = schema;\n    const shape = objectShape(schema);\n    if (shape) {\n      descriptor.fields = Object.entries(shape).map(([childKey, child]) =>\n        describeField(childKey, child),\n      );\n    }\n  }\n  return descriptor;\n}\n\n/**\n * Introspect a block's `data` schema into a flat list of field descriptors. The\n * input is unwrapped to its object schema first (so an `.optional()`-wrapped or\n * `.refine()`-wrapped object still yields its fields).\n */\nexport function introspect(schema: ZodType<unknown>): FieldDescriptor[] {\n  const { schema: unwrapped } = unwrap(schema as ZodTypeAny);\n  const shape = objectShape(unwrapped);\n  if (!shape) return [];\n  return Object.entries(shape).map(([key, child]) => describeField(key, child));\n}\n"]}

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

@@ -0,0 +1,22 @@
+/**
+ * `@agent-native/core/blocks/server` — the React-free subset of the block
+ * registry for server / agent code (MDX serialize/parse, the registry, schema
+ * introspection, the `markdown()` helper, agent schema export). Importing this
+ * entry never pulls React into the server bundle.
+ *
+ * A `BlockSpec` carries React (`Read`/`Edit`) and pure (`schema`/`mdx`) parts in
+ * the same object; the server path only touches `spec.schema` / `spec.mdx`. The
+ * app's registry module is shared by browser and server, but the server only
+ * ever calls these React-free functions on it.
+ */
+export { defineBlock, type BlockSpec, type BlockPlacement, type BlockMdxConfig, type BlockAttrReader, type MdxAttrValue, type NestedBlock, } from "./types.js";
+export { BlockRegistry, registerBlocks } from "./registry.js";
+export { markdown, richtext, introspect, type FieldKind, type FieldDescriptor, } from "./schema-form/introspect.js";
+export { prop, escapeAttr, jsonExpression, attributeValue, createAttrReader, serializeSpecBlock, parseSpecBlock, type MdxJsxNode, type MdxAttrNode, type SerializableBlock, type ParsedBlockBase, } from "./mdx.js";
+export { describeBlocksForAgent, renderBlockVocabularyReference, type BlockAgentDoc, } from "./agent.js";
+export { checklistSchema, checklistMdx, type ChecklistData, type ChecklistItem, } from "./library/checklist.config.js";
+export { tableSchema, tableMdx, type TableData, } from "./library/table.config.js";
+export { codeTabsSchema, codeTabsMdx, type CodeTabsData, type CodeTabsTab, } from "./library/code-tabs.config.js";
+export { htmlSchema, htmlMdx, type HtmlBlockData, } from "./library/html.config.js";
+export { tabsSchema, tabsMdx, type TabsData, type TabsTab, } from "./library/tabs.config.js";
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,EACX,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,IAAI,EACJ,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,EACR,KAAK,SAAS,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,EACV,OAAO,EACP,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,UAAU,EACV,OAAO,EACP,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,0BAA0B,CAAC"}