@agent-native/core 0.37.3 → 0.39.0

package/dist/client/blocks/SchemaBlockEditor.js

@@ -0,0 +1,165 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { IconPlus, IconTrash } from "@tabler/icons-react";
+import { cn } from "../utils.js";
+import { introspect } from "./schema-form/introspect.js";
+/**
+ * Schema-driven auto-editor. When a {@link BlockSpec} omits `Edit`, the registry
+ * renders this: it walks the block's zod `data` schema and renders one control
+ * per field (string → input, longtext → textarea, number, boolean → toggle,
+ * enum → native select, array → repeating rows, object → nested fieldset). A
+ * `markdown()`-tagged string field defers to the app-provided inline rich
+ * editor via `ctx.renderMarkdownEditor` so prose stays Notion-editable.
+ *
+ * It uses plain accessible native controls (not template shadcn primitives,
+ * which core does not bundle) styled to match the shadcn look. Validation runs
+ * the spec's own schema on every edit; the raw edit is kept in local state so a
+ * transiently-invalid value (e.g. mid-typing) doesn't get rolled back, and only
+ * valid data is committed upstream.
+ */
+export function SchemaBlockEditor({ data, onChange, schema, editable, blockId, ctx, }) {
+    const fields = useMemo(() => introspect(schema), [schema]);
+    const [showOptional, setShowOptional] = useState(false);
+    const setField = (key, value) => {
+        const next = { ...data, [key]: value };
+        const parsed = schema.safeParse(next);
+        // Commit valid data; otherwise pass the raw edit through so the user can
+        // keep typing — the upstream owner re-validates before persisting.
+        onChange((parsed.success ? parsed.data : next));
+    };
+    const required = fields.filter((field) => !field.optional);
+    const optional = fields.filter((field) => field.optional);
+    return (_jsxs("div", { className: "an-schema-block-editor flex flex-col gap-3", children: [required.map((field) => (_jsx(FieldControl, { field: field, value: data[field.key], onChange: (value) => setField(field.key, value), editable: editable, blockId: blockId, ctx: ctx }, field.key))), optional.length > 0 && (_jsx("div", { className: "flex flex-col gap-3", children: showOptional ? (optional.map((field) => (_jsx(FieldControl, { field: field, value: data[field.key], onChange: (value) => setField(field.key, value), editable: editable, blockId: blockId, ctx: ctx }, field.key)))) : (_jsx("button", { type: "button", "data-plan-interactive": true, className: "self-start text-sm text-muted-foreground underline-offset-2 hover:underline", onClick: () => setShowOptional(true), children: "More options" })) }))] }));
+}
+const inputClass = "flex h-9 w-full 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 disabled:cursor-not-allowed disabled:opacity-50";
+const textareaClass = "flex min-h-[80px] w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50";
+function FieldLabel({ children }) {
+    return (_jsx("span", { className: "text-xs font-medium text-muted-foreground", children: children }));
+}
+/** A sensible empty value for a single field, used when adding array items. */
+function emptyForField(field) {
+    switch (field.kind) {
+        case "text":
+            // A field literally named `id` gets a fresh stable id so new rows are
+            // distinguishable without the user having to type one.
+            return field.key === "id"
+                ? `item-${Math.random().toString(36).slice(2, 10)}`
+                : "";
+        case "longtext":
+        case "markdown":
+        case "richtext":
+            return "";
+        case "boolean":
+            return false;
+        case "enum":
+            return field.enumValues?.[0];
+        case "array":
+            return [];
+        case "object":
+            return emptyObjectFromFields(field.fields);
+        case "number":
+        default:
+            // number → undefined (the input shows blank until the user types); any
+            // unsupported kind also defaults to undefined.
+            return undefined;
+    }
+}
+/** Build an empty object value from a descriptor's child fields. */
+function emptyObjectFromFields(fields) {
+    const result = {};
+    for (const child of fields ?? []) {
+        result[child.key] = emptyForField(child);
+    }
+    return result;
+}
+/** A scalar element kind classified from an array's inner element schema. */
+function scalarKindFromInner(inner) {
+    const type = inner?._def?.type;
+    if (type === "number" || type === "bigint")
+        return "number";
+    if (type === "boolean")
+        return "boolean";
+    return "text";
+}
+/** An empty value for a scalar array element of the given kind. */
+function emptyScalar(kind) {
+    if (kind === "boolean")
+        return false;
+    if (kind === "number")
+        return undefined;
+    return "";
+}
+function FieldControl({ field, value, onChange, editable, blockId, ctx, }) {
+    if (field.kind === "markdown" || field.kind === "richtext") {
+        const node = ctx.renderMarkdownEditor?.({
+            value: typeof value === "string" ? value : "",
+            onChange: (next) => onChange(next),
+            editable,
+            blockId,
+        });
+        return (_jsxs("label", { className: "flex flex-col gap-1.5", children: [_jsx(FieldLabel, { children: field.label }), node ?? (_jsx("textarea", { "data-plan-interactive": true, className: textareaClass, value: typeof value === "string" ? value : "", disabled: !editable, onChange: (event) => onChange(event.target.value) }))] }));
+    }
+    if (field.kind === "boolean") {
+        return (_jsxs("label", { className: "flex items-center gap-2", children: [_jsx("input", { type: "checkbox", "data-plan-interactive": true, className: "size-4 rounded border-input accent-primary", checked: Boolean(value), disabled: !editable, onChange: (event) => onChange(event.target.checked) }), _jsx(FieldLabel, { children: field.label })] }));
+    }
+    if (field.kind === "enum") {
+        const options = field.enumValues ?? [];
+        return (_jsxs("label", { className: "flex flex-col gap-1.5", children: [_jsx(FieldLabel, { children: field.label }), _jsxs("select", { "data-plan-interactive": true, className: inputClass, value: typeof value === "string" ? value : "", disabled: !editable, onChange: (event) => onChange(event.target.value || undefined), children: [field.optional && _jsx("option", { value: "", children: "\u2014" }), options.map((option) => (_jsx("option", { value: option, children: option }, option)))] })] }));
+    }
+    if (field.kind === "number") {
+        return (_jsxs("label", { className: "flex flex-col gap-1.5", children: [_jsx(FieldLabel, { children: field.label }), _jsx("input", { type: "number", "data-plan-interactive": true, className: inputClass, value: typeof value === "number" ? value : "", disabled: !editable, onChange: (event) => {
+                        const raw = event.target.value;
+                        onChange(raw === "" ? undefined : Number(raw));
+                    } })] }));
+    }
+    if (field.kind === "longtext") {
+        return (_jsxs("label", { className: "flex flex-col gap-1.5", children: [_jsx(FieldLabel, { children: field.label }), _jsx("textarea", { "data-plan-interactive": true, className: textareaClass, value: typeof value === "string" ? value : "", disabled: !editable, onChange: (event) => onChange(event.target.value) })] }));
+    }
+    if (field.kind === "text") {
+        return (_jsxs("label", { className: "flex flex-col gap-1.5", children: [_jsx(FieldLabel, { children: field.label }), _jsx("input", { type: "text", "data-plan-interactive": true, className: inputClass, value: typeof value === "string" ? value : "", disabled: !editable, onChange: (event) => onChange(event.target.value) })] }));
+    }
+    if (field.kind === "object" && field.fields && field.fields.length > 0) {
+        const objValue = value && typeof value === "object" && !Array.isArray(value)
+            ? value
+            : {};
+        return (_jsxs("div", { className: "flex flex-col gap-3 rounded-md border border-input px-3 py-3", children: [_jsx(FieldLabel, { children: field.label }), _jsx("div", { className: "flex flex-col gap-3", children: field.fields.map((child) => (_jsx(FieldControl, { field: child, value: objValue[child.key], onChange: (childVal) => onChange({ ...objValue, [child.key]: childVal }), editable: editable, blockId: blockId, ctx: ctx }, child.key))) })] }));
+    }
+    if (field.kind === "array") {
+        const items = Array.isArray(value) ? value : [];
+        const replaceItem = (index, next) => {
+            const copy = items.slice();
+            copy[index] = next;
+            onChange(copy);
+        };
+        const removeItem = (index) => {
+            onChange(items.filter((_, i) => i !== index));
+        };
+        const objectElement = Array.isArray(field.fields) && field.fields.length > 0;
+        const scalarKind = objectElement ? null : scalarKindFromInner(field.inner);
+        const addItem = () => {
+            if (objectElement) {
+                onChange([...items, emptyObjectFromFields(field.fields)]);
+            }
+            else {
+                onChange([...items, emptyScalar(scalarKind ?? "text")]);
+            }
+        };
+        return (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(FieldLabel, { children: field.label }), _jsx("div", { className: "flex flex-col gap-2", children: items.map((item, index) => (_jsxs("div", { className: "flex items-start gap-2 rounded-md border border-input px-3 py-3", children: [_jsx("div", { className: "flex flex-1 flex-col gap-3", children: objectElement ? (field.fields.map((child) => {
+                                    const itemValue = item && typeof item === "object" && !Array.isArray(item)
+                                        ? item
+                                        : {};
+                                    return (_jsx(FieldControl, { field: child, value: itemValue[child.key], onChange: (childVal) => replaceItem(index, {
+                                            ...itemValue,
+                                            [child.key]: childVal,
+                                        }), editable: editable, blockId: blockId, ctx: ctx }, child.key));
+                                })) : scalarKind === "boolean" ? (_jsx("input", { type: "checkbox", "data-plan-interactive": true, className: "size-4 self-start rounded border-input accent-primary", checked: Boolean(item), disabled: !editable, onChange: (event) => replaceItem(index, event.target.checked) })) : scalarKind === "number" ? (_jsx("input", { type: "number", "data-plan-interactive": true, className: inputClass, value: typeof item === "number" ? item : "", disabled: !editable, onChange: (event) => {
+                                        const raw = event.target.value;
+                                        replaceItem(index, raw === "" ? undefined : Number(raw));
+                                    } })) : (_jsx("input", { type: "text", "data-plan-interactive": true, className: inputClass, value: typeof item === "string" ? item : "", disabled: !editable, onChange: (event) => replaceItem(index, event.target.value) })) }), editable && (_jsx("button", { type: "button", "data-plan-interactive": true, "aria-label": "Remove item", className: "mt-0.5 inline-flex size-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", onClick: () => removeItem(index), children: _jsx(IconTrash, { className: "size-4" }) }))] }, index))) }), editable && (_jsxs("button", { type: "button", "data-plan-interactive": true, className: "inline-flex items-center gap-1.5 self-start text-sm text-muted-foreground underline-offset-2 hover:text-foreground hover:underline", onClick: addItem, children: [_jsx(IconPlus, { className: "size-4" }), "Add ", field.label.replace(/s$/i, "").toLowerCase() || "item"] }))] }));
+    }
+    // Unsupported / structured-without-fields: the auto-editor cannot infer a
+    // control. Blocks with these fields should ship a custom `Edit`. Surface a
+    // hint in dev so the gap is visible.
+    return (_jsxs("div", { className: cn("rounded-md border border-dashed border-input px-3 py-2 text-xs text-muted-foreground"), children: [_jsx(FieldLabel, { children: field.label }), _jsxs("p", { className: "mt-1", children: ["This field (", field.kind, ") needs a custom editor \u2014 define `Edit` on the block spec."] })] }));
+}
+//# sourceMappingURL=SchemaBlockEditor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaBlockEditor.js","sourceRoot":"","sources":["../../../src/client/blocks/SchemaBlockEditor.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useState } from \"react\";\nimport type { ZodType } from \"zod\";\nimport { IconPlus, IconTrash } from \"@tabler/icons-react\";\nimport { cn } from \"../utils.js\";\nimport type { BlockRenderContext } from \"./types.js\";\nimport { introspect, type FieldDescriptor } from \"./schema-form/introspect.js\";\n\n/**\n * Schema-driven auto-editor. When a {@link BlockSpec} omits `Edit`, the registry\n * renders this: it walks the block's zod `data` schema and renders one control\n * per field (string → input, longtext → textarea, number, boolean → toggle,\n * enum → native select, array → repeating rows, object → nested fieldset). A\n * `markdown()`-tagged string field defers to the app-provided inline rich\n * editor via `ctx.renderMarkdownEditor` so prose stays Notion-editable.\n *\n * It uses plain accessible native controls (not template shadcn primitives,\n * which core does not bundle) styled to match the shadcn look. Validation runs\n * the spec's own schema on every edit; the raw edit is kept in local state so a\n * transiently-invalid value (e.g. mid-typing) doesn't get rolled back, and only\n * valid data is committed upstream.\n */\nexport function SchemaBlockEditor<T>({\n  data,\n  onChange,\n  schema,\n  editable,\n  blockId,\n  ctx,\n}: {\n  data: T;\n  onChange: (next: T) => void;\n  schema: ZodType<T>;\n  editable: boolean;\n  blockId?: string;\n  ctx: BlockRenderContext;\n}) {\n  const fields = useMemo(() => introspect(schema), [schema]);\n  const [showOptional, setShowOptional] = useState(false);\n\n  const setField = (key: string, value: unknown) => {\n    const next = { ...(data as Record<string, unknown>), [key]: value } as T;\n    const parsed = schema.safeParse(next);\n    // Commit valid data; otherwise pass the raw edit through so the user can\n    // keep typing — the upstream owner re-validates before persisting.\n    onChange((parsed.success ? parsed.data : next) as T);\n  };\n\n  const required = fields.filter((field) => !field.optional);\n  const optional = fields.filter((field) => field.optional);\n\n  return (\n    <div className=\"an-schema-block-editor flex flex-col gap-3\">\n      {required.map((field) => (\n        <FieldControl\n          key={field.key}\n          field={field}\n          value={(data as Record<string, unknown>)[field.key]}\n          onChange={(value) => setField(field.key, value)}\n          editable={editable}\n          blockId={blockId}\n          ctx={ctx}\n        />\n      ))}\n      {optional.length > 0 && (\n        <div className=\"flex flex-col gap-3\">\n          {showOptional ? (\n            optional.map((field) => (\n              <FieldControl\n                key={field.key}\n                field={field}\n                value={(data as Record<string, unknown>)[field.key]}\n                onChange={(value) => setField(field.key, value)}\n                editable={editable}\n                blockId={blockId}\n                ctx={ctx}\n              />\n            ))\n          ) : (\n            <button\n              type=\"button\"\n              data-plan-interactive\n              className=\"self-start text-sm text-muted-foreground underline-offset-2 hover:underline\"\n              onClick={() => setShowOptional(true)}\n            >\n              More options\n            </button>\n          )}\n        </div>\n      )}\n    </div>\n  );\n}\n\nconst inputClass =\n  \"flex h-9 w-full 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 disabled:cursor-not-allowed disabled:opacity-50\";\n\nconst textareaClass =\n  \"flex min-h-[80px] w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50\";\n\nfunction FieldLabel({ children }: { children: React.ReactNode }) {\n  return (\n    <span className=\"text-xs font-medium text-muted-foreground\">\n      {children}\n    </span>\n  );\n}\n\n/** A sensible empty value for a single field, used when adding array items. */\nfunction emptyForField(field: FieldDescriptor): unknown {\n  switch (field.kind) {\n    case \"text\":\n      // A field literally named `id` gets a fresh stable id so new rows are\n      // distinguishable without the user having to type one.\n      return field.key === \"id\"\n        ? `item-${Math.random().toString(36).slice(2, 10)}`\n        : \"\";\n    case \"longtext\":\n    case \"markdown\":\n    case \"richtext\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"enum\":\n      return field.enumValues?.[0];\n    case \"array\":\n      return [];\n    case \"object\":\n      return emptyObjectFromFields(field.fields);\n    case \"number\":\n    default:\n      // number → undefined (the input shows blank until the user types); any\n      // unsupported kind also defaults to undefined.\n      return undefined;\n  }\n}\n\n/** Build an empty object value from a descriptor's child fields. */\nfunction emptyObjectFromFields(\n  fields: FieldDescriptor[] | undefined,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const child of fields ?? []) {\n    result[child.key] = emptyForField(child);\n  }\n  return result;\n}\n\n/** A scalar element kind classified from an array's inner element schema. */\nfunction scalarKindFromInner(\n  inner: FieldDescriptor[\"inner\"],\n): \"number\" | \"boolean\" | \"text\" {\n  const type = (inner?._def as { type?: string } | undefined)?.type;\n  if (type === \"number\" || type === \"bigint\") return \"number\";\n  if (type === \"boolean\") return \"boolean\";\n  return \"text\";\n}\n\n/** An empty value for a scalar array element of the given kind. */\nfunction emptyScalar(kind: \"number\" | \"boolean\" | \"text\"): unknown {\n  if (kind === \"boolean\") return false;\n  if (kind === \"number\") return undefined;\n  return \"\";\n}\n\nfunction FieldControl({\n  field,\n  value,\n  onChange,\n  editable,\n  blockId,\n  ctx,\n}: {\n  field: FieldDescriptor;\n  value: unknown;\n  onChange: (value: unknown) => void;\n  editable: boolean;\n  blockId?: string;\n  ctx: BlockRenderContext;\n}) {\n  if (field.kind === \"markdown\" || field.kind === \"richtext\") {\n    const node = ctx.renderMarkdownEditor?.({\n      value: typeof value === \"string\" ? value : \"\",\n      onChange: (next) => onChange(next),\n      editable,\n      blockId,\n    });\n    return (\n      <label className=\"flex flex-col gap-1.5\">\n        <FieldLabel>{field.label}</FieldLabel>\n        {node ?? (\n          // Fallback when no app markdown editor is injected: a plain textarea.\n          <textarea\n            data-plan-interactive\n            className={textareaClass}\n            value={typeof value === \"string\" ? value : \"\"}\n            disabled={!editable}\n            onChange={(event) => onChange(event.target.value)}\n          />\n        )}\n      </label>\n    );\n  }\n\n  if (field.kind === \"boolean\") {\n    return (\n      <label className=\"flex items-center gap-2\">\n        <input\n          type=\"checkbox\"\n          data-plan-interactive\n          className=\"size-4 rounded border-input accent-primary\"\n          checked={Boolean(value)}\n          disabled={!editable}\n          onChange={(event) => onChange(event.target.checked)}\n        />\n        <FieldLabel>{field.label}</FieldLabel>\n      </label>\n    );\n  }\n\n  if (field.kind === \"enum\") {\n    const options = field.enumValues ?? [];\n    return (\n      <label className=\"flex flex-col gap-1.5\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <select\n          data-plan-interactive\n          className={inputClass}\n          value={typeof value === \"string\" ? value : \"\"}\n          disabled={!editable}\n          onChange={(event) => onChange(event.target.value || undefined)}\n        >\n          {field.optional && <option value=\"\">—</option>}\n          {options.map((option) => (\n            <option key={option} value={option}>\n              {option}\n            </option>\n          ))}\n        </select>\n      </label>\n    );\n  }\n\n  if (field.kind === \"number\") {\n    return (\n      <label className=\"flex flex-col gap-1.5\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <input\n          type=\"number\"\n          data-plan-interactive\n          className={inputClass}\n          value={typeof value === \"number\" ? value : \"\"}\n          disabled={!editable}\n          onChange={(event) => {\n            const raw = event.target.value;\n            onChange(raw === \"\" ? undefined : Number(raw));\n          }}\n        />\n      </label>\n    );\n  }\n\n  if (field.kind === \"longtext\") {\n    return (\n      <label className=\"flex flex-col gap-1.5\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <textarea\n          data-plan-interactive\n          className={textareaClass}\n          value={typeof value === \"string\" ? value : \"\"}\n          disabled={!editable}\n          onChange={(event) => onChange(event.target.value)}\n        />\n      </label>\n    );\n  }\n\n  if (field.kind === \"text\") {\n    return (\n      <label className=\"flex flex-col gap-1.5\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <input\n          type=\"text\"\n          data-plan-interactive\n          className={inputClass}\n          value={typeof value === \"string\" ? value : \"\"}\n          disabled={!editable}\n          onChange={(event) => onChange(event.target.value)}\n        />\n      </label>\n    );\n  }\n\n  if (field.kind === \"object\" && field.fields && field.fields.length > 0) {\n    const objValue =\n      value && typeof value === \"object\" && !Array.isArray(value)\n        ? (value as Record<string, unknown>)\n        : {};\n    return (\n      <div className=\"flex flex-col gap-3 rounded-md border border-input px-3 py-3\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <div className=\"flex flex-col gap-3\">\n          {field.fields.map((child) => (\n            <FieldControl\n              key={child.key}\n              field={child}\n              value={objValue[child.key]}\n              onChange={(childVal) =>\n                onChange({ ...objValue, [child.key]: childVal })\n              }\n              editable={editable}\n              blockId={blockId}\n              ctx={ctx}\n            />\n          ))}\n        </div>\n      </div>\n    );\n  }\n\n  if (field.kind === \"array\") {\n    const items = Array.isArray(value) ? (value as unknown[]) : [];\n    const replaceItem = (index: number, next: unknown) => {\n      const copy = items.slice();\n      copy[index] = next;\n      onChange(copy);\n    };\n    const removeItem = (index: number) => {\n      onChange(items.filter((_, i) => i !== index));\n    };\n    const objectElement =\n      Array.isArray(field.fields) && field.fields.length > 0;\n    const scalarKind = objectElement ? null : scalarKindFromInner(field.inner);\n    const addItem = () => {\n      if (objectElement) {\n        onChange([...items, emptyObjectFromFields(field.fields)]);\n      } else {\n        onChange([...items, emptyScalar(scalarKind ?? \"text\")]);\n      }\n    };\n    return (\n      <div className=\"flex flex-col gap-2\">\n        <FieldLabel>{field.label}</FieldLabel>\n        <div className=\"flex flex-col gap-2\">\n          {items.map((item, index) => (\n            <div\n              key={index}\n              className=\"flex items-start gap-2 rounded-md border border-input px-3 py-3\"\n            >\n              <div className=\"flex flex-1 flex-col gap-3\">\n                {objectElement ? (\n                  field.fields!.map((child) => {\n                    const itemValue =\n                      item && typeof item === \"object\" && !Array.isArray(item)\n                        ? (item as Record<string, unknown>)\n                        : {};\n                    return (\n                      <FieldControl\n                        key={child.key}\n                        field={child}\n                        value={itemValue[child.key]}\n                        onChange={(childVal) =>\n                          replaceItem(index, {\n                            ...itemValue,\n                            [child.key]: childVal,\n                          })\n                        }\n                        editable={editable}\n                        blockId={blockId}\n                        ctx={ctx}\n                      />\n                    );\n                  })\n                ) : scalarKind === \"boolean\" ? (\n                  <input\n                    type=\"checkbox\"\n                    data-plan-interactive\n                    className=\"size-4 self-start rounded border-input accent-primary\"\n                    checked={Boolean(item)}\n                    disabled={!editable}\n                    onChange={(event) =>\n                      replaceItem(index, event.target.checked)\n                    }\n                  />\n                ) : scalarKind === \"number\" ? (\n                  <input\n                    type=\"number\"\n                    data-plan-interactive\n                    className={inputClass}\n                    value={typeof item === \"number\" ? item : \"\"}\n                    disabled={!editable}\n                    onChange={(event) => {\n                      const raw = event.target.value;\n                      replaceItem(index, raw === \"\" ? undefined : Number(raw));\n                    }}\n                  />\n                ) : (\n                  <input\n                    type=\"text\"\n                    data-plan-interactive\n                    className={inputClass}\n                    value={typeof item === \"string\" ? item : \"\"}\n                    disabled={!editable}\n                    onChange={(event) => replaceItem(index, event.target.value)}\n                  />\n                )}\n              </div>\n              {editable && (\n                <button\n                  type=\"button\"\n                  data-plan-interactive\n                  aria-label=\"Remove item\"\n                  className=\"mt-0.5 inline-flex size-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground\"\n                  onClick={() => removeItem(index)}\n                >\n                  <IconTrash className=\"size-4\" />\n                </button>\n              )}\n            </div>\n          ))}\n        </div>\n        {editable && (\n          <button\n            type=\"button\"\n            data-plan-interactive\n            className=\"inline-flex items-center gap-1.5 self-start text-sm text-muted-foreground underline-offset-2 hover:text-foreground hover:underline\"\n            onClick={addItem}\n          >\n            <IconPlus className=\"size-4\" />\n            Add {field.label.replace(/s$/i, \"\").toLowerCase() || \"item\"}\n          </button>\n        )}\n      </div>\n    );\n  }\n\n  // Unsupported / structured-without-fields: the auto-editor cannot infer a\n  // control. Blocks with these fields should ship a custom `Edit`. Surface a\n  // hint in dev so the gap is visible.\n  return (\n    <div\n      className={cn(\n        \"rounded-md border border-dashed border-input px-3 py-2 text-xs text-muted-foreground\",\n      )}\n    >\n      <FieldLabel>{field.label}</FieldLabel>\n      <p className=\"mt-1\">\n        This field ({field.kind}) needs a custom editor — define `Edit` on the\n        block spec.\n      </p>\n    </div>\n  );\n}\n"]}

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

@@ -0,0 +1,30 @@
+import type { BlockRegistry } from "./registry.js";
+import type { BlockPlacement } from "./types.js";
+/**
+ * Agent-facing description of one registered block. Generated from the registry
+ * so the agent's block vocabulary always matches what the app can render and
+ * serialize — no hand-maintained second list. React-free so an action / the
+ * agent schema export can import it.
+ */
+export interface BlockAgentDoc {
+    type: string;
+    label: string;
+    description: string;
+    placement: BlockPlacement[];
+    mdxTag: string;
+    dataSchema: unknown;
+    example?: unknown;
+}
+/** Describe every registered block for the agent (sorted by type for stability). */
+export declare function describeBlocksForAgent(registry: BlockRegistry): BlockAgentDoc[];
+/**
+ * Render the registry into a compact markdown block-vocabulary reference for the
+ * agent (skill / action surface). Lists each block's runtime `type`, MDX tag,
+ * placement, the key data fields (pulled from the converted JSON schema), and the
+ * one-line description — generated from the live registry so the agent's
+ * vocabulary can never drift from what the app actually renders and serializes.
+ */
+export declare function renderBlockVocabularyReference(registry: BlockRegistry, options?: {
+    heading?: string;
+}): string;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,GACtB,aAAa,EAAE,CAajB;AAYD;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,MAAM,CAgBR"}

package/dist/client/blocks/agent.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+/** Describe every registered block for the agent (sorted by type for stability). */
+export function describeBlocksForAgent(registry) {
+    return registry
+        .list()
+        .map((spec) => ({
+        type: spec.type,
+        label: spec.label,
+        description: spec.description,
+        placement: spec.placement,
+        mdxTag: spec.mdx.tag,
+        dataSchema: safeJsonSchema(spec.schema),
+        example: spec.empty?.(),
+    }))
+        .sort((a, b) => a.type.localeCompare(b.type));
+}
+function safeJsonSchema(schema) {
+    try {
+        return z.toJSONSchema(schema, { io: "input" });
+    }
+    catch {
+        // Some schemas (recursive lazy, custom refinements) can't convert; the
+        // agent still gets the type/label/description, which is the essential part.
+        return undefined;
+    }
+}
+/**
+ * Render the registry into a compact markdown block-vocabulary reference for the
+ * agent (skill / action surface). Lists each block's runtime `type`, MDX tag,
+ * placement, the key data fields (pulled from the converted JSON schema), and the
+ * one-line description — generated from the live registry so the agent's
+ * vocabulary can never drift from what the app actually renders and serializes.
+ */
+export function renderBlockVocabularyReference(registry, options = {}) {
+    const docs = describeBlocksForAgent(registry);
+    const lines = [];
+    if (options.heading)
+        lines.push(options.heading, "");
+    lines.push("| type | mdx tag | placement | key data fields | description |", "| --- | --- | --- | --- | --- |");
+    for (const doc of docs) {
+        lines.push(`| \`${doc.type}\` | \`<${doc.mdxTag}>\` | ${doc.placement.join("+")} | ${summarizeFields(doc.dataSchema) || "—"} | ${escapeCell(doc.description)} |`);
+    }
+    return lines.join("\n");
+}
+/** Pull a short `field`/`field?` list out of a converted JSON schema object. */
+function summarizeFields(jsonSchema) {
+    if (!jsonSchema || typeof jsonSchema !== "object")
+        return "";
+    const obj = jsonSchema;
+    if (!obj.properties)
+        return "";
+    const required = new Set(obj.required ?? []);
+    return Object.keys(obj.properties)
+        .map((key) => `\`${key}${required.has(key) ? "" : "?"}\``)
+        .join(", ");
+}
+/** Escape pipe/newline so a description never breaks the markdown table. */
+function escapeCell(text) {
+    return text.replace(/\|/g, "\\|").replace(/\r?\n/g, " ").trim();
+}
+//# sourceMappingURL=agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/client/blocks/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { BlockRegistry } from \"./registry.js\";\nimport type { BlockPlacement } from \"./types.js\";\n\n/**\n * Agent-facing description of one registered block. Generated from the registry\n * so the agent's block vocabulary always matches what the app can render and\n * serialize — no hand-maintained second list. React-free so an action / the\n * agent schema export can import it.\n */\nexport interface BlockAgentDoc {\n  type: string;\n  label: string;\n  description: string;\n  placement: BlockPlacement[];\n  mdxTag: string;\n  dataSchema: unknown;\n  example?: unknown;\n}\n\n/** Describe every registered block for the agent (sorted by type for stability). */\nexport function describeBlocksForAgent(\n  registry: BlockRegistry,\n): BlockAgentDoc[] {\n  return registry\n    .list()\n    .map((spec) => ({\n      type: spec.type,\n      label: spec.label,\n      description: spec.description,\n      placement: spec.placement,\n      mdxTag: spec.mdx.tag,\n      dataSchema: safeJsonSchema(spec.schema),\n      example: spec.empty?.(),\n    }))\n    .sort((a, b) => a.type.localeCompare(b.type));\n}\n\nfunction safeJsonSchema(schema: z.ZodType<unknown>): unknown {\n  try {\n    return z.toJSONSchema(schema, { io: \"input\" });\n  } catch {\n    // Some schemas (recursive lazy, custom refinements) can't convert; the\n    // agent still gets the type/label/description, which is the essential part.\n    return undefined;\n  }\n}\n\n/**\n * Render the registry into a compact markdown block-vocabulary reference for the\n * agent (skill / action surface). Lists each block's runtime `type`, MDX tag,\n * placement, the key data fields (pulled from the converted JSON schema), and the\n * one-line description — generated from the live registry so the agent's\n * vocabulary can never drift from what the app actually renders and serializes.\n */\nexport function renderBlockVocabularyReference(\n  registry: BlockRegistry,\n  options: { heading?: string } = {},\n): string {\n  const docs = describeBlocksForAgent(registry);\n  const lines: string[] = [];\n  if (options.heading) lines.push(options.heading, \"\");\n  lines.push(\n    \"| type | mdx tag | placement | key data fields | description |\",\n    \"| --- | --- | --- | --- | --- |\",\n  );\n  for (const doc of docs) {\n    lines.push(\n      `| \\`${doc.type}\\` | \\`<${doc.mdxTag}>\\` | ${doc.placement.join(\"+\")} | ${\n        summarizeFields(doc.dataSchema) || \"—\"\n      } | ${escapeCell(doc.description)} |`,\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\n/** Pull a short `field`/`field?` list out of a converted JSON schema object. */\nfunction summarizeFields(jsonSchema: unknown): string {\n  if (!jsonSchema || typeof jsonSchema !== \"object\") return \"\";\n  const obj = jsonSchema as {\n    properties?: Record<string, unknown>;\n    required?: string[];\n  };\n  if (!obj.properties) return \"\";\n  const required = new Set(obj.required ?? []);\n  return Object.keys(obj.properties)\n    .map((key) => `\\`${key}${required.has(key) ? \"\" : \"?\"}\\``)\n    .join(\", \");\n}\n\n/** Escape pipe/newline so a description never breaks the markdown table. */\nfunction escapeCell(text: string): string {\n  return text.replace(/\\|/g, \"\\\\|\").replace(/\\r?\\n/g, \" \").trim();\n}\n"]}

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

@@ -0,0 +1,51 @@
+/**
+ * `@agent-native/core/blocks` — the first-party block registry.
+ *
+ * A block registry unifies structured document blocks under one `defineBlock`
+ * contract: a zod `schema` for the data, an `mdx` config for byte-stable MDX
+ * round-trip, a `Read` renderer, an optional `Edit` (auto-generated from the
+ * schema when omitted), and `placement` (top-level and/or inline). Apps create a
+ * `BlockRegistry`, register the core standard library plus their own specs, and
+ * render through `BlockView` inside a `BlockRegistryProvider`. The renderer
+ * checks the registry first and falls back to legacy code for unregistered
+ * types, so existing documents keep working unchanged.
+ *
+ * This entry includes the React surface. For server/agent code that must stay
+ * React-free, import from `@agent-native/core/blocks/server`.
+ */
+export { defineBlock, type BlockSpec, type BlockPlacement, type BlockMdxConfig, type BlockAttrReader, type BlockRenderContext, type BlockReadProps, type BlockEditProps, type MdxAttrValue, type NestedBlock, } from "./types.js";
+export { BlockRegistry, registerBlocks } from "./registry.js";
+export { BlockRegistryProvider, useBlockRegistry, useOptionalBlockRegistry, } from "./provider.js";
+export { BlockView, blockEditSurface } from "./BlockView.js";
+export { SchemaBlockEditor } from "./SchemaBlockEditor.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 { libraryBlockSpecs, registerLibraryBlocks, type LibraryBlockOverrides, } from "./library/specs.js";
+export { checklistBlock, ChecklistBlock, ChecklistEditor, } from "./library/checklist.js";
+export { checklistSchema, checklistMdx, type ChecklistData, type ChecklistItem, } from "./library/checklist.config.js";
+export { tableBlock } from "./library/table.js";
+export { tableSchema, tableMdx, type TableData, } from "./library/table.config.js";
+export { codeTabsBlock } from "./library/code-tabs.js";
+export { codeTabsSchema, codeTabsMdx, type CodeTabsData, type CodeTabsTab, } from "./library/code-tabs.config.js";
+export { htmlBlock, HtmlReadBlock, HtmlEditBlock } from "./library/html.js";
+export { htmlSchema, htmlMdx, type HtmlBlockData, } from "./library/html.config.js";
+export { tabsBlock, TabsBlockReader, TabsBlockEditor } from "./library/tabs.js";
+export { tabsSchema, tabsMdx, type TabsData, type TabsTab, } from "./library/tabs.config.js";
+export { MermaidRead, MermaidEdit } from "./library/MermaidBlock.js";
+export { mermaidSchema, mermaidMdx, type MermaidData, } from "./library/mermaid.config.js";
+export { ApiEndpointRead, ApiEndpointEdit, } from "./library/ApiEndpointBlock.js";
+export { apiEndpointSchema, apiEndpointMdx, API_ENDPOINT_METHODS, API_PARAM_LOCATIONS, type ApiEndpointData, type ApiEndpointMethod, type ApiEndpointParam, type ApiEndpointRequest, type ApiEndpointResponse, type ApiParamLocation, } from "./library/api-endpoint.config.js";
+export { DataModelRead, DataModelEdit } from "./library/DataModelBlock.js";
+export { dataModelSchema, dataModelMdx, DATA_MODEL_RELATION_KINDS, type DataModelData, type DataModelEntity, type DataModelField, type DataModelRelation, type DataModelRelationKind, } from "./library/data-model.config.js";
+export { DiffRead, DiffEdit } from "./library/DiffBlock.js";
+export { diffSchema, diffMdx, type DiffData, type DiffMode, } from "./library/diff.config.js";
+export { FileTreeRead, FileTreeEdit } from "./library/FileTreeBlock.js";
+export { fileTreeSchema, fileTreeMdx, FILE_TREE_CHANGES, type FileTreeData, type FileTreeEntry, type FileTreeChange, } from "./library/file-tree.config.js";
+export { JsonExplorerRead, JsonExplorerEdit, } from "./library/JsonExplorerBlock.js";
+export { jsonExplorerSchema, jsonExplorerMdx, type JsonExplorerData, } from "./library/json-explorer.config.js";
+export { AnnotatedCodeRead, AnnotatedCodeEdit, } from "./library/AnnotatedCodeBlock.js";
+export { annotatedCodeSchema, annotatedCodeMdx, type AnnotatedCodeData, type AnnotatedCodeAnnotation, } from "./library/annotated-code.config.js";
+export { OpenApiSpecRead, OpenApiSpecEdit, } from "./library/OpenApiSpecBlock.js";
+export { openApiSpecSchema, openApiSpecMdx, type OpenApiSpecData, } from "./library/openapi-spec.config.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/client/blocks/index.js

@@ -0,0 +1,67 @@
+/**
+ * `@agent-native/core/blocks` — the first-party block registry.
+ *
+ * A block registry unifies structured document blocks under one `defineBlock`
+ * contract: a zod `schema` for the data, an `mdx` config for byte-stable MDX
+ * round-trip, a `Read` renderer, an optional `Edit` (auto-generated from the
+ * schema when omitted), and `placement` (top-level and/or inline). Apps create a
+ * `BlockRegistry`, register the core standard library plus their own specs, and
+ * render through `BlockView` inside a `BlockRegistryProvider`. The renderer
+ * checks the registry first and falls back to legacy code for unregistered
+ * types, so existing documents keep working unchanged.
+ *
+ * This entry includes the React surface. For server/agent code that must stay
+ * React-free, import from `@agent-native/core/blocks/server`.
+ */
+// Types + authoring
+export { defineBlock, } from "./types.js";
+// Registry + provisioning
+export { BlockRegistry, registerBlocks } from "./registry.js";
+export { BlockRegistryProvider, useBlockRegistry, useOptionalBlockRegistry, } from "./provider.js";
+// Rendering
+export { BlockView, blockEditSurface } from "./BlockView.js";
+export { SchemaBlockEditor } from "./SchemaBlockEditor.js";
+// Schema-form helpers
+export { markdown, richtext, introspect, } from "./schema-form/introspect.js";
+// MDX round-trip (registry-driven serialize/parse + shared encoder primitives)
+export { prop, escapeAttr, jsonExpression, attributeValue, createAttrReader, serializeSpecBlock, parseSpecBlock, } from "./mdx.js";
+// Agent schema export
+export { describeBlocksForAgent, renderBlockVocabularyReference, } from "./agent.js";
+// Standard library registration. Apps call `registerLibraryBlocks(registry)` to
+// register the whole standard library (the five pre-built specs + the eight
+// dev-doc specs) in one place, then register only their app-specific blocks on
+// top. `libraryBlockSpecs` is the underlying ordered array.
+export { libraryBlockSpecs, registerLibraryBlocks, } from "./library/specs.js";
+// Standard block library (React specs). Apps register these in their browser
+// registry alongside their own app-specific blocks.
+export { checklistBlock, ChecklistBlock, ChecklistEditor, } from "./library/checklist.js";
+export { checklistSchema, checklistMdx, } from "./library/checklist.config.js";
+export { tableBlock } from "./library/table.js";
+export { tableSchema, tableMdx, } from "./library/table.config.js";
+export { codeTabsBlock } from "./library/code-tabs.js";
+export { codeTabsSchema, codeTabsMdx, } from "./library/code-tabs.config.js";
+export { htmlBlock, HtmlReadBlock, HtmlEditBlock } from "./library/html.js";
+export { htmlSchema, htmlMdx, } from "./library/html.config.js";
+export { tabsBlock, TabsBlockReader, TabsBlockEditor } from "./library/tabs.js";
+export { tabsSchema, tabsMdx, } from "./library/tabs.config.js";
+// Dev-doc block library (React `Read`/`Edit` renderers + their React-free
+// schema/MDX config). Apps register these alongside their own blocks, supplying
+// app-specific spec metadata (label/description/editSurface/empty) via
+// `defineBlock`. Mirrors the standard library above.
+export { MermaidRead, MermaidEdit } from "./library/MermaidBlock.js";
+export { mermaidSchema, mermaidMdx, } from "./library/mermaid.config.js";
+export { ApiEndpointRead, ApiEndpointEdit, } from "./library/ApiEndpointBlock.js";
+export { apiEndpointSchema, apiEndpointMdx, API_ENDPOINT_METHODS, API_PARAM_LOCATIONS, } from "./library/api-endpoint.config.js";
+export { DataModelRead, DataModelEdit } from "./library/DataModelBlock.js";
+export { dataModelSchema, dataModelMdx, DATA_MODEL_RELATION_KINDS, } from "./library/data-model.config.js";
+export { DiffRead, DiffEdit } from "./library/DiffBlock.js";
+export { diffSchema, diffMdx, } from "./library/diff.config.js";
+export { FileTreeRead, FileTreeEdit } from "./library/FileTreeBlock.js";
+export { fileTreeSchema, fileTreeMdx, FILE_TREE_CHANGES, } from "./library/file-tree.config.js";
+export { JsonExplorerRead, JsonExplorerEdit, } from "./library/JsonExplorerBlock.js";
+export { jsonExplorerSchema, jsonExplorerMdx, } from "./library/json-explorer.config.js";
+export { AnnotatedCodeRead, AnnotatedCodeEdit, } from "./library/AnnotatedCodeBlock.js";
+export { annotatedCodeSchema, annotatedCodeMdx, } from "./library/annotated-code.config.js";
+export { OpenApiSpecRead, OpenApiSpecEdit, } from "./library/OpenApiSpecBlock.js";
+export { openApiSpecSchema, openApiSpecMdx, } from "./library/openapi-spec.config.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/blocks/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@agent-native/core/blocks` — the first-party block registry.\n *\n * A block registry unifies structured document blocks under one `defineBlock`\n * contract: a zod `schema` for the data, an `mdx` config for byte-stable MDX\n * round-trip, a `Read` renderer, an optional `Edit` (auto-generated from the\n * schema when omitted), and `placement` (top-level and/or inline). Apps create a\n * `BlockRegistry`, register the core standard library plus their own specs, and\n * render through `BlockView` inside a `BlockRegistryProvider`. The renderer\n * checks the registry first and falls back to legacy code for unregistered\n * types, so existing documents keep working unchanged.\n *\n * This entry includes the React surface. For server/agent code that must stay\n * React-free, import from `@agent-native/core/blocks/server`.\n */\n\n// Types + authoring\nexport {\n  defineBlock,\n  type BlockSpec,\n  type BlockPlacement,\n  type BlockMdxConfig,\n  type BlockAttrReader,\n  type BlockRenderContext,\n  type BlockReadProps,\n  type BlockEditProps,\n  type MdxAttrValue,\n  type NestedBlock,\n} from \"./types.js\";\n\n// Registry + provisioning\nexport { BlockRegistry, registerBlocks } from \"./registry.js\";\nexport {\n  BlockRegistryProvider,\n  useBlockRegistry,\n  useOptionalBlockRegistry,\n} from \"./provider.js\";\n\n// Rendering\nexport { BlockView, blockEditSurface } from \"./BlockView.js\";\nexport { SchemaBlockEditor } from \"./SchemaBlockEditor.js\";\n\n// Schema-form helpers\nexport {\n  markdown,\n  richtext,\n  introspect,\n  type FieldKind,\n  type FieldDescriptor,\n} from \"./schema-form/introspect.js\";\n\n// MDX round-trip (registry-driven serialize/parse + shared encoder primitives)\nexport {\n  prop,\n  escapeAttr,\n  jsonExpression,\n  attributeValue,\n  createAttrReader,\n  serializeSpecBlock,\n  parseSpecBlock,\n  type MdxJsxNode,\n  type MdxAttrNode,\n  type SerializableBlock,\n  type ParsedBlockBase,\n} from \"./mdx.js\";\n\n// Agent schema export\nexport {\n  describeBlocksForAgent,\n  renderBlockVocabularyReference,\n  type BlockAgentDoc,\n} from \"./agent.js\";\n\n// Standard library registration. Apps call `registerLibraryBlocks(registry)` to\n// register the whole standard library (the five pre-built specs + the eight\n// dev-doc specs) in one place, then register only their app-specific blocks on\n// top. `libraryBlockSpecs` is the underlying ordered array.\nexport {\n  libraryBlockSpecs,\n  registerLibraryBlocks,\n  type LibraryBlockOverrides,\n} from \"./library/specs.js\";\n\n// Standard block library (React specs). Apps register these in their browser\n// registry alongside their own app-specific blocks.\nexport {\n  checklistBlock,\n  ChecklistBlock,\n  ChecklistEditor,\n} from \"./library/checklist.js\";\nexport {\n  checklistSchema,\n  checklistMdx,\n  type ChecklistData,\n  type ChecklistItem,\n} from \"./library/checklist.config.js\";\nexport { tableBlock } from \"./library/table.js\";\nexport {\n  tableSchema,\n  tableMdx,\n  type TableData,\n} from \"./library/table.config.js\";\nexport { codeTabsBlock } from \"./library/code-tabs.js\";\nexport {\n  codeTabsSchema,\n  codeTabsMdx,\n  type CodeTabsData,\n  type CodeTabsTab,\n} from \"./library/code-tabs.config.js\";\nexport { htmlBlock, HtmlReadBlock, HtmlEditBlock } from \"./library/html.js\";\nexport {\n  htmlSchema,\n  htmlMdx,\n  type HtmlBlockData,\n} from \"./library/html.config.js\";\nexport { tabsBlock, TabsBlockReader, TabsBlockEditor } from \"./library/tabs.js\";\nexport {\n  tabsSchema,\n  tabsMdx,\n  type TabsData,\n  type TabsTab,\n} from \"./library/tabs.config.js\";\n\n// Dev-doc block library (React `Read`/`Edit` renderers + their React-free\n// schema/MDX config). Apps register these alongside their own blocks, supplying\n// app-specific spec metadata (label/description/editSurface/empty) via\n// `defineBlock`. Mirrors the standard library above.\nexport { MermaidRead, MermaidEdit } from \"./library/MermaidBlock.js\";\nexport {\n  mermaidSchema,\n  mermaidMdx,\n  type MermaidData,\n} from \"./library/mermaid.config.js\";\nexport {\n  ApiEndpointRead,\n  ApiEndpointEdit,\n} from \"./library/ApiEndpointBlock.js\";\nexport {\n  apiEndpointSchema,\n  apiEndpointMdx,\n  API_ENDPOINT_METHODS,\n  API_PARAM_LOCATIONS,\n  type ApiEndpointData,\n  type ApiEndpointMethod,\n  type ApiEndpointParam,\n  type ApiEndpointRequest,\n  type ApiEndpointResponse,\n  type ApiParamLocation,\n} from \"./library/api-endpoint.config.js\";\nexport { DataModelRead, DataModelEdit } from \"./library/DataModelBlock.js\";\nexport {\n  dataModelSchema,\n  dataModelMdx,\n  DATA_MODEL_RELATION_KINDS,\n  type DataModelData,\n  type DataModelEntity,\n  type DataModelField,\n  type DataModelRelation,\n  type DataModelRelationKind,\n} from \"./library/data-model.config.js\";\nexport { DiffRead, DiffEdit } from \"./library/DiffBlock.js\";\nexport {\n  diffSchema,\n  diffMdx,\n  type DiffData,\n  type DiffMode,\n} from \"./library/diff.config.js\";\nexport { FileTreeRead, FileTreeEdit } from \"./library/FileTreeBlock.js\";\nexport {\n  fileTreeSchema,\n  fileTreeMdx,\n  FILE_TREE_CHANGES,\n  type FileTreeData,\n  type FileTreeEntry,\n  type FileTreeChange,\n} from \"./library/file-tree.config.js\";\nexport {\n  JsonExplorerRead,\n  JsonExplorerEdit,\n} from \"./library/JsonExplorerBlock.js\";\nexport {\n  jsonExplorerSchema,\n  jsonExplorerMdx,\n  type JsonExplorerData,\n} from \"./library/json-explorer.config.js\";\nexport {\n  AnnotatedCodeRead,\n  AnnotatedCodeEdit,\n} from \"./library/AnnotatedCodeBlock.js\";\nexport {\n  annotatedCodeSchema,\n  annotatedCodeMdx,\n  type AnnotatedCodeData,\n  type AnnotatedCodeAnnotation,\n} from \"./library/annotated-code.config.js\";\nexport {\n  OpenApiSpecRead,\n  OpenApiSpecEdit,\n} from \"./library/OpenApiSpecBlock.js\";\nexport {\n  openApiSpecSchema,\n  openApiSpecMdx,\n  type OpenApiSpecData,\n} from \"./library/openapi-spec.config.js\";\n"]}

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

@@ -0,0 +1,6 @@
+import type { BlockEditProps, BlockReadProps } from "../types.js";
+import type { AnnotatedCodeData } from "./annotated-code.config.js";
+declare function AnnotatedCodeRead({ data, blockId, title, summary, ctx, }: BlockReadProps<AnnotatedCodeData>): import("react/jsx-runtime").JSX.Element;
+declare function AnnotatedCodeEdit({ data, onChange, editable, }: BlockEditProps<AnnotatedCodeData>): import("react/jsx-runtime").JSX.Element;
+export { AnnotatedCodeRead, AnnotatedCodeEdit };
+//# sourceMappingURL=AnnotatedCodeBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotatedCodeBlock.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/AnnotatedCodeBlock.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAsDpC,iBAAS,iBAAiB,CAAC,EACzB,IAAI,EACJ,OAAO,EACP,KAAK,EACL,OAAO,EACP,GAAG,GACJ,EAAE,cAAc,CAAC,iBAAiB,CAAC,2CAmOnC;AAMD,iBAAS,iBAAiB,CAAC,EACzB,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE,cAAc,CAAC,iBAAiB,CAAC,2CAiJnC;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC"}