@agent-native/core 0.37.3 → 0.39.0

package/dist/client/blocks/library/json-explorer.config.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import type { BlockMdxConfig } from "../types.js";
+/**
+ * Pure (React-free) part of the PLAN-SPECIFIC `json-explorer` block: its data
+ * schema and MDX round-trip config. Shared by the server MDX adapter
+ * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec
+ * (`planBlocks.tsx`). Keeping this React-free means importing it into a server
+ * module never pulls React into the Nitro/SSR bundle.
+ *
+ * The block renders a browser-devtools / Postman-style collapsible JSON tree:
+ * object/array nodes show a chevron + a one-line summary ("{…} 3 keys" /
+ * "[…] 5 items") and expand/collapse; leaf values are type-colored (string =
+ * green, number = blue, boolean = violet, null = muted). The raw JSON TEXT is
+ * the source of truth (`json`), so authoring round-trips losslessly even when
+ * the JSON is invalid — the reader parses defensively and falls back to the raw
+ * text on a parse error rather than throwing.
+ *
+ * The schema MUST stay data-compatible with the inline `json-explorer` member of
+ * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`Json`) +
+ * attribute shape MUST match the `<Json title json collapsedDepth />` encoding so
+ * stored `.mdx` round-trips. `json` lives in the `json` ATTRIBUTE (not MDX
+ * children) — the shared `prop()` encoder round-trips multiline strings cleanly,
+ * and keeping it an attribute avoids the payload being reflowed as prose.
+ */
+export interface JsonExplorerData {
+    /** Optional heading shown above the tree. */
+    title?: string;
+    /** Raw JSON text — the source of truth, parsed defensively at render time. */
+    json: string;
+    /**
+     * Depth beyond which nodes start collapsed (default 1). Nodes at a depth `<`
+     * this value render expanded; deeper nodes render collapsed until clicked.
+     */
+    collapsedDepth?: number;
+}
+export declare const jsonExplorerSchema: z.ZodType<JsonExplorerData>;
+/**
+ * MDX config: `title`, `json`, and `collapsedDepth` are flat attributes — the
+ * `<Json id … title json collapsedDepth />` self-closing form. Insertion order
+ * of `toAttrs` is the on-disk attribute order (`title` → `json` →
+ * `collapsedDepth`). `fromAttrs` mirrors a forgiving parse (`json ?? ""`,
+ * `title`/`collapsedDepth` undefined when absent) so a plan missing an attribute
+ * still parses.
+ */
+export declare const jsonExplorerMdx: BlockMdxConfig<JsonExplorerData>;
+//# sourceMappingURL=json-explorer.config.d.ts.map

package/dist/client/blocks/library/json-explorer.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-explorer.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/json-explorer.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAId,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,gBAAgB,CAY5D,CAAC"}

package/dist/client/blocks/library/json-explorer.config.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export const jsonExplorerSchema = z.object({
+    title: z.string().trim().max(200).optional(),
+    json: z.string().max(200_000),
+    collapsedDepth: z.number().int().min(0).max(20).optional(),
+});
+/**
+ * MDX config: `title`, `json`, and `collapsedDepth` are flat attributes — the
+ * `<Json id … title json collapsedDepth />` self-closing form. Insertion order
+ * of `toAttrs` is the on-disk attribute order (`title` → `json` →
+ * `collapsedDepth`). `fromAttrs` mirrors a forgiving parse (`json ?? ""`,
+ * `title`/`collapsedDepth` undefined when absent) so a plan missing an attribute
+ * still parses.
+ */
+export const jsonExplorerMdx = {
+    tag: "Json",
+    toAttrs: (data) => ({
+        title: data.title,
+        json: data.json,
+        collapsedDepth: data.collapsedDepth,
+    }),
+    fromAttrs: (attrs) => ({
+        json: attrs.string("json") ?? "",
+        title: attrs.string("title"),
+        collapsedDepth: attrs.number("collapsedDepth"),
+    }),
+};
+//# sourceMappingURL=json-explorer.config.js.map

package/dist/client/blocks/library/json-explorer.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-explorer.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/json-explorer.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAA2C,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAChC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC;KAC/C,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC `json-explorer` block: its data\n * schema and MDX round-trip config. Shared by the server MDX adapter\n * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec\n * (`planBlocks.tsx`). Keeping this React-free means importing it into a server\n * module never pulls React into the Nitro/SSR bundle.\n *\n * The block renders a browser-devtools / Postman-style collapsible JSON tree:\n * object/array nodes show a chevron + a one-line summary (\"{…} 3 keys\" /\n * \"[…] 5 items\") and expand/collapse; leaf values are type-colored (string =\n * green, number = blue, boolean = violet, null = muted). The raw JSON TEXT is\n * the source of truth (`json`), so authoring round-trips losslessly even when\n * the JSON is invalid — the reader parses defensively and falls back to the raw\n * text on a parse error rather than throwing.\n *\n * The schema MUST stay data-compatible with the inline `json-explorer` member of\n * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`Json`) +\n * attribute shape MUST match the `<Json title json collapsedDepth />` encoding so\n * stored `.mdx` round-trips. `json` lives in the `json` ATTRIBUTE (not MDX\n * children) — the shared `prop()` encoder round-trips multiline strings cleanly,\n * and keeping it an attribute avoids the payload being reflowed as prose.\n */\n\nexport interface JsonExplorerData {\n  /** Optional heading shown above the tree. */\n  title?: string;\n  /** Raw JSON text — the source of truth, parsed defensively at render time. */\n  json: string;\n  /**\n   * Depth beyond which nodes start collapsed (default 1). Nodes at a depth `<`\n   * this value render expanded; deeper nodes render collapsed until clicked.\n   */\n  collapsedDepth?: number;\n}\n\nexport const jsonExplorerSchema = z.object({\n  title: z.string().trim().max(200).optional(),\n  json: z.string().max(200_000),\n  collapsedDepth: z.number().int().min(0).max(20).optional(),\n}) as unknown as z.ZodType<JsonExplorerData>;\n\n/**\n * MDX config: `title`, `json`, and `collapsedDepth` are flat attributes — the\n * `<Json id … title json collapsedDepth />` self-closing form. Insertion order\n * of `toAttrs` is the on-disk attribute order (`title` → `json` →\n * `collapsedDepth`). `fromAttrs` mirrors a forgiving parse (`json ?? \"\"`,\n * `title`/`collapsedDepth` undefined when absent) so a plan missing an attribute\n * still parses.\n */\nexport const jsonExplorerMdx: BlockMdxConfig<JsonExplorerData> = {\n  tag: \"Json\",\n  toAttrs: (data) => ({\n    title: data.title,\n    json: data.json,\n    collapsedDepth: data.collapsedDepth,\n  }),\n  fromAttrs: (attrs) => ({\n    json: attrs.string(\"json\") ?? \"\",\n    title: attrs.string(\"title\"),\n    collapsedDepth: attrs.number(\"collapsedDepth\"),\n  }),\n};\n"]}

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

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import type { BlockMdxConfig } from "../types.js";
+/**
+ * Pure (React-free) part of the PLAN-SPECIFIC mermaid block: its data schema and
+ * MDX round-trip config. Shared by the server MDX adapter (`plan-mdx.ts` via
+ * `plan-block-registry.ts`) and the client spec (`planBlocks.tsx`). Keeping this
+ * React-free means importing it into a server module never pulls React (or the
+ * client-only `mermaid` runtime) into the Nitro/SSR bundle.
+ *
+ * The schema MUST stay data-compatible with the `mermaid` branch of
+ * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` + flat `source` /
+ * `caption` attribute shape MUST match the `<Mermaid source caption />` encoding
+ * so stored `.mdx` round-trips. The diagram code lives in the `source` ATTRIBUTE
+ * (not MDX children) — the shared `prop()` encoder round-trips multiline strings
+ * cleanly, and keeping it an attribute avoids the source being reflowed as prose.
+ */
+export interface MermaidData {
+    /** Mermaid diagram definition (flowchart/sequence/etc.) edited as raw text. */
+    source: string;
+    /** Optional short caption rendered (muted) under the diagram. */
+    caption?: string;
+}
+export declare const mermaidSchema: z.ZodType<MermaidData>;
+/**
+ * MDX config: `source` and `caption` are flat attributes — the `<Mermaid id …
+ * source caption />` self-closing form. Insertion order of `toAttrs` is the
+ * on-disk attribute order (`source` → `caption`). `fromAttrs` mirrors a
+ * forgiving parse (`source ?? ""`, `caption` undefined when absent) so a plan
+ * missing the attribute still parses.
+ */
+export declare const mermaidMdx: BlockMdxConfig<MermaidData>;
+//# sourceMappingURL=mermaid.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/mermaid.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAGT,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,WAAW,CAUlD,CAAC"}

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const mermaidSchema = z.object({
+    source: z.string().max(50_000),
+    caption: z.string().trim().max(400).optional(),
+});
+/**
+ * MDX config: `source` and `caption` are flat attributes — the `<Mermaid id …
+ * source caption />` self-closing form. Insertion order of `toAttrs` is the
+ * on-disk attribute order (`source` → `caption`). `fromAttrs` mirrors a
+ * forgiving parse (`source ?? ""`, `caption` undefined when absent) so a plan
+ * missing the attribute still parses.
+ */
+export const mermaidMdx = {
+    tag: "Mermaid",
+    toAttrs: (data) => ({
+        source: data.source,
+        caption: data.caption,
+    }),
+    fromAttrs: (attrs) => ({
+        source: attrs.string("source") ?? "",
+        caption: attrs.string("caption"),
+    }),
+};
+//# sourceMappingURL=mermaid.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/mermaid.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAsC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgC;IACrD,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACpC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;KACjC,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC mermaid block: its data schema and\n * MDX round-trip config. Shared by the server MDX adapter (`plan-mdx.ts` via\n * `plan-block-registry.ts`) and the client spec (`planBlocks.tsx`). Keeping this\n * React-free means importing it into a server module never pulls React (or the\n * client-only `mermaid` runtime) into the Nitro/SSR bundle.\n *\n * The schema MUST stay data-compatible with the `mermaid` branch of\n * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` + flat `source` /\n * `caption` attribute shape MUST match the `<Mermaid source caption />` encoding\n * so stored `.mdx` round-trips. The diagram code lives in the `source` ATTRIBUTE\n * (not MDX children) — the shared `prop()` encoder round-trips multiline strings\n * cleanly, and keeping it an attribute avoids the source being reflowed as prose.\n */\n\nexport interface MermaidData {\n  /** Mermaid diagram definition (flowchart/sequence/etc.) edited as raw text. */\n  source: string;\n  /** Optional short caption rendered (muted) under the diagram. */\n  caption?: string;\n}\n\nexport const mermaidSchema = z.object({\n  source: z.string().max(50_000),\n  caption: z.string().trim().max(400).optional(),\n}) as unknown as z.ZodType<MermaidData>;\n\n/**\n * MDX config: `source` and `caption` are flat attributes — the `<Mermaid id …\n * source caption />` self-closing form. Insertion order of `toAttrs` is the\n * on-disk attribute order (`source` → `caption`). `fromAttrs` mirrors a\n * forgiving parse (`source ?? \"\"`, `caption` undefined when absent) so a plan\n * missing the attribute still parses.\n */\nexport const mermaidMdx: BlockMdxConfig<MermaidData> = {\n  tag: \"Mermaid\",\n  toAttrs: (data) => ({\n    source: data.source,\n    caption: data.caption,\n  }),\n  fromAttrs: (attrs) => ({\n    source: attrs.string(\"source\") ?? \"\",\n    caption: attrs.string(\"caption\"),\n  }),\n};\n"]}

package/dist/client/blocks/library/openapi-spec.config.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import type { BlockMdxConfig } from "../types.js";
+/**
+ * Pure (React-free) part of the PLAN-SPECIFIC `openapi-spec` block: its data
+ * schema and MDX round-trip config. Shared by the server MDX adapter
+ * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec
+ * (`planBlocks.tsx`). Keeping this React-free means importing it into a server
+ * module never pulls React into the Nitro/SSR bundle.
+ *
+ * This is the WHOLE-DOCUMENT counterpart to the single-endpoint `api-endpoint`
+ * block: instead of one operation, it carries a complete OpenAPI 3 / Swagger 2
+ * document (the `spec` string) and the reader renders a Redoc / Swagger-UI-style
+ * reference — operations grouped by tag, each a collapsible row (colored method
+ * pill + path + summary) expanding to params / request body / per-status
+ * responses, with `$ref` models resolved. The raw `spec` TEXT is the source of
+ * truth, so authoring round-trips losslessly even when the spec is malformed —
+ * the reader parses defensively and falls back to a graceful error rather than
+ * throwing.
+ *
+ * v1 supports JSON specs only. A YAML parser (`yaml`) is NOT a declared
+ * dependency of this package, so to avoid pulling in an undeclared/transitive
+ * module the reader parses JSON (a superset of nothing — pure `JSON.parse`).
+ * The Edit form documents the JSON-only constraint inline. When `yaml` is later
+ * added as a real dependency, the reader's `parseSpec` is the single seam to
+ * extend.
+ *
+ * The schema MUST stay data-compatible with the inline `openapi-spec` member of
+ * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`OpenApi`) +
+ * attribute shape MUST match the `<OpenApi title spec />` encoding so stored
+ * `.mdx` round-trips. `spec` lives in the `spec` ATTRIBUTE (not MDX children) —
+ * the shared `prop()` encoder round-trips multiline strings cleanly, and keeping
+ * it an attribute avoids the payload being reflowed as prose.
+ */
+export interface OpenApiSpecData {
+    /** Raw OpenAPI 3 / Swagger 2 document text (JSON in v1). Source of truth. */
+    spec: string;
+    /** Optional heading shown above the reference. */
+    title?: string;
+}
+export declare const openApiSpecSchema: z.ZodType<OpenApiSpecData>;
+/**
+ * MDX config: `title` and `spec` are flat attributes — the `<OpenApi id … title
+ * spec />` self-closing form. Insertion order of `toAttrs` is the on-disk
+ * attribute order (`title` → `spec`). `fromAttrs` mirrors a forgiving parse
+ * (`spec ?? ""`, `title` undefined when absent) so a plan missing an attribute
+ * still parses.
+ */
+export declare const openApiSpecMdx: BlockMdxConfig<OpenApiSpecData>;
+//# sourceMappingURL=openapi-spec.config.d.ts.map

package/dist/client/blocks/library/openapi-spec.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-spec.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/openapi-spec.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB,EAGb,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,CAU1D,CAAC"}

package/dist/client/blocks/library/openapi-spec.config.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const openApiSpecSchema = z.object({
+    spec: z.string().max(400_000),
+    title: z.string().trim().max(200).optional(),
+});
+/**
+ * MDX config: `title` and `spec` are flat attributes — the `<OpenApi id … title
+ * spec />` self-closing form. Insertion order of `toAttrs` is the on-disk
+ * attribute order (`title` → `spec`). `fromAttrs` mirrors a forgiving parse
+ * (`spec ?? ""`, `title` undefined when absent) so a plan missing an attribute
+ * still parses.
+ */
+export const openApiSpecMdx = {
+    tag: "OpenApi",
+    toAttrs: (data) => ({
+        title: data.title,
+        spec: data.spec,
+    }),
+    fromAttrs: (attrs) => ({
+        spec: attrs.string("spec") ?? "",
+        title: attrs.string("title"),
+    }),
+};
+//# sourceMappingURL=openapi-spec.config.js.map

package/dist/client/blocks/library/openapi-spec.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-spec.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/openapi-spec.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAA0C,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAChC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;KAC7B,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC `openapi-spec` block: its data\n * schema and MDX round-trip config. Shared by the server MDX adapter\n * (`plan-mdx.ts` via `plan-block-registry.ts`) and the client spec\n * (`planBlocks.tsx`). Keeping this React-free means importing it into a server\n * module never pulls React into the Nitro/SSR bundle.\n *\n * This is the WHOLE-DOCUMENT counterpart to the single-endpoint `api-endpoint`\n * block: instead of one operation, it carries a complete OpenAPI 3 / Swagger 2\n * document (the `spec` string) and the reader renders a Redoc / Swagger-UI-style\n * reference — operations grouped by tag, each a collapsible row (colored method\n * pill + path + summary) expanding to params / request body / per-status\n * responses, with `$ref` models resolved. The raw `spec` TEXT is the source of\n * truth, so authoring round-trips losslessly even when the spec is malformed —\n * the reader parses defensively and falls back to a graceful error rather than\n * throwing.\n *\n * v1 supports JSON specs only. A YAML parser (`yaml`) is NOT a declared\n * dependency of this package, so to avoid pulling in an undeclared/transitive\n * module the reader parses JSON (a superset of nothing — pure `JSON.parse`).\n * The Edit form documents the JSON-only constraint inline. When `yaml` is later\n * added as a real dependency, the reader's `parseSpec` is the single seam to\n * extend.\n *\n * The schema MUST stay data-compatible with the inline `openapi-spec` member of\n * `planBlockSchema` (`plan-content.ts`), and the MDX `tag` (`OpenApi`) +\n * attribute shape MUST match the `<OpenApi title spec />` encoding so stored\n * `.mdx` round-trips. `spec` lives in the `spec` ATTRIBUTE (not MDX children) —\n * the shared `prop()` encoder round-trips multiline strings cleanly, and keeping\n * it an attribute avoids the payload being reflowed as prose.\n */\n\nexport interface OpenApiSpecData {\n  /** Raw OpenAPI 3 / Swagger 2 document text (JSON in v1). Source of truth. */\n  spec: string;\n  /** Optional heading shown above the reference. */\n  title?: string;\n}\n\nexport const openApiSpecSchema = z.object({\n  spec: z.string().max(400_000),\n  title: z.string().trim().max(200).optional(),\n}) as unknown as z.ZodType<OpenApiSpecData>;\n\n/**\n * MDX config: `title` and `spec` are flat attributes — the `<OpenApi id … title\n * spec />` self-closing form. Insertion order of `toAttrs` is the on-disk\n * attribute order (`title` → `spec`). `fromAttrs` mirrors a forgiving parse\n * (`spec ?? \"\"`, `title` undefined when absent) so a plan missing an attribute\n * still parses.\n */\nexport const openApiSpecMdx: BlockMdxConfig<OpenApiSpecData> = {\n  tag: \"OpenApi\",\n  toAttrs: (data) => ({\n    title: data.title,\n    spec: data.spec,\n  }),\n  fromAttrs: (attrs) => ({\n    spec: attrs.string(\"spec\") ?? \"\",\n    title: attrs.string(\"title\"),\n  }),\n};\n"]}

package/dist/client/blocks/library/server-specs.d.ts

@@ -0,0 +1,35 @@
+import { type BlockSpec } from "../types.js";
+import { type BlockRegistry } from "../registry.js";
+/**
+ * Canonical React-free specs for the standard library, used by BOTH apps' server
+ * / shared registries (`plan-block-registry.ts`, `nfm-registry.ts`). Each carries
+ * only the parts the server path touches — `schema` + `mdx` + metadata for the
+ * agent schema export — with a render-only `Read` stub. The full client specs
+ * (with real React `Read`/`Edit`) live in `./specs.tsx`; both share the identical
+ * `schema`/`mdx` config so inline source can never drift from what renders.
+ *
+ * `table` keeps the core default `type` here; content's server registry renames
+ * it to `table-block` via {@link LibraryBlockConfigOverrides}. The descriptions
+ * are the neutral agent-schema phrasing; an app that curates a longer
+ * description for a block (e.g. plan's hand-drawn Mermaid, plan's detailed file
+ * tree) passes an override rather than re-authoring the spec.
+ */
+export declare const libraryBlockConfigs: BlockSpec<any>[];
+/**
+ * Per-block overrides for {@link registerLibraryBlockConfigs}, keyed by canonical
+ * `type`. Servers tweak only the agent-facing fields that legitimately differ:
+ * content re-types `table` → `table-block`; plan curates a longer Mermaid and
+ * file-tree description. The `schema` / `mdx` config always stays shared.
+ */
+export type LibraryBlockConfigOverrides = Record<string, Partial<Pick<BlockSpec<any>, "type" | "label" | "description" | "notionCompatible">>>;
+/**
+ * Register the React-free standard-library config stubs into a server / shared
+ * {@link BlockRegistry}. Both `plan-block-registry.ts` and `nfm-registry.ts` call
+ * this, then register only their app-specific block configs (plan adds callout /
+ * diagram / wireframe / question-form) on top — so the shared library lives in
+ * exactly one place across browser AND server registries.
+ */
+export declare function registerLibraryBlockConfigs(registry: BlockRegistry, options?: {
+    overrides?: LibraryBlockConfigOverrides;
+}): void;
+//# sourceMappingURL=server-specs.d.ts.map

package/dist/client/blocks/library/server-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-specs.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/server-specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA0DpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,GAAG,CAAC,EAqI/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C,MAAM,EACN,OAAO,CACL,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,kBAAkB,CAAC,CAC5E,CACF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,2BAA2B,CAAA;CAAO,GACxD,IAAI,CAON"}

package/dist/client/blocks/library/server-specs.js

@@ -0,0 +1,171 @@
+import { defineBlock } from "../types.js";
+import { registerBlocks } from "../registry.js";
+// React-free schema + MDX config for the standard library. The matching React
+// `Read`/`Edit` live in the full client entry; the server path only ever touches
+// `spec.schema` / `spec.mdx`, so these configs register with a render-only stub.
+import { checklistSchema, checklistMdx, } from "./checklist.config.js";
+import { tableSchema, tableMdx } from "./table.config.js";
+import { codeTabsSchema, codeTabsMdx, } from "./code-tabs.config.js";
+import { htmlSchema, htmlMdx } from "./html.config.js";
+import { tabsSchema, tabsMdx } from "./tabs.config.js";
+import { mermaidSchema, mermaidMdx, } from "./mermaid.config.js";
+import { apiEndpointSchema, apiEndpointMdx, } from "./api-endpoint.config.js";
+import { openApiSpecSchema, openApiSpecMdx, } from "./openapi-spec.config.js";
+import { dataModelSchema, dataModelMdx, } from "./data-model.config.js";
+import { diffSchema, diffMdx } from "./diff.config.js";
+import { fileTreeSchema, fileTreeMdx, } from "./file-tree.config.js";
+import { jsonExplorerSchema, jsonExplorerMdx, } from "./json-explorer.config.js";
+import { annotatedCodeSchema, annotatedCodeMdx, } from "./annotated-code.config.js";
+/** Render-only stub for server / agent registries (never invoked off-browser). */
+const ServerReadStub = () => null;
+/**
+ * Canonical React-free specs for the standard library, used by BOTH apps' server
+ * / shared registries (`plan-block-registry.ts`, `nfm-registry.ts`). Each carries
+ * only the parts the server path touches — `schema` + `mdx` + metadata for the
+ * agent schema export — with a render-only `Read` stub. The full client specs
+ * (with real React `Read`/`Edit`) live in `./specs.tsx`; both share the identical
+ * `schema`/`mdx` config so inline source can never drift from what renders.
+ *
+ * `table` keeps the core default `type` here; content's server registry renames
+ * it to `table-block` via {@link LibraryBlockConfigOverrides}. The descriptions
+ * are the neutral agent-schema phrasing; an app that curates a longer
+ * description for a block (e.g. plan's hand-drawn Mermaid, plan's detailed file
+ * tree) passes an override rather than re-authoring the spec.
+ */
+export const libraryBlockConfigs = [
+    defineBlock({
+        type: "checklist",
+        schema: checklistSchema,
+        mdx: checklistMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        notionCompatible: true,
+        label: "Checklist",
+        description: "A list of toggleable items, each with a label and an optional note.",
+    }),
+    defineBlock({
+        type: "table",
+        schema: tableSchema,
+        mdx: tableMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        notionCompatible: true,
+        label: "Table",
+        description: "A simple grid with header columns and string rows for comparisons, parameters, or structured lists.",
+    }),
+    defineBlock({
+        type: "code-tabs",
+        schema: codeTabsSchema,
+        mdx: codeTabsMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "Code tabs",
+        description: "A vertical file tab rail of syntax-highlighted code snippets, one tab per file with an optional language and caption.",
+    }),
+    defineBlock({
+        type: "custom-html",
+        schema: htmlSchema,
+        mdx: htmlMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "HTML / Tailwind",
+        description: "An author-supplied HTML (with optional CSS) fragment rendered in a sandboxed iframe, with inline source editing.",
+    }),
+    defineBlock({
+        type: "tabs",
+        schema: tabsSchema,
+        mdx: tabsMdx,
+        Read: ServerReadStub,
+        placement: ["block", "inline"],
+        label: "Tabs",
+        description: "A horizontal pill-tab container; each tab holds its own list of blocks.",
+    }),
+    defineBlock({
+        type: "mermaid",
+        schema: mermaidSchema,
+        mdx: mermaidMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "Diagram (Mermaid)",
+        description: "A Mermaid diagram (flowchart, sequence, etc.) defined as text and rendered as a diagram.",
+    }),
+    defineBlock({
+        type: "api-endpoint",
+        schema: apiEndpointSchema,
+        mdx: apiEndpointMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "API endpoint",
+        description: "A Swagger-style API endpoint reference: a colored method pill + path, collapsed by default, expanding to params, request body, and per-status response examples.",
+    }),
+    defineBlock({
+        type: "openapi-spec",
+        schema: openApiSpecSchema,
+        mdx: openApiSpecMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "OpenAPI spec",
+        description: "A whole-document Redoc / Swagger-UI-style API reference rendered from a complete OpenAPI 3 / Swagger 2 spec (JSON).",
+    }),
+    defineBlock({
+        type: "data-model",
+        schema: dataModelSchema,
+        mdx: dataModelMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "Data model",
+        description: "An ERD / dbdiagram-style data model: entity cards with typed fields (PK/FK/nullable flags) and interactive foreign-key relations.",
+    }),
+    defineBlock({
+        type: "diff",
+        schema: diffSchema,
+        mdx: diffMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "Diff",
+        description: "A GitHub-style before/after line diff for a file, with unified or split view and added/removed line highlighting.",
+    }),
+    defineBlock({
+        type: "file-tree",
+        schema: fileTreeSchema,
+        mdx: fileTreeMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "File tree",
+        description: "A VS Code / GitHub-explorer file and change tree with per-file change badges, notes, and code snippets.",
+    }),
+    defineBlock({
+        type: "json-explorer",
+        schema: jsonExplorerSchema,
+        mdx: jsonExplorerMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "JSON explorer",
+        description: "A collapsible browser-devtools / Postman-style JSON tree with type-colored values and expand/collapse.",
+    }),
+    defineBlock({
+        type: "annotated-code",
+        schema: annotatedCodeSchema,
+        mdx: annotatedCodeMdx,
+        Read: ServerReadStub,
+        placement: ["block"],
+        label: "Annotated code",
+        description: "A line-numbered code walkthrough whose line ranges carry anchored explanatory notes.",
+    }),
+];
+/**
+ * Register the React-free standard-library config stubs into a server / shared
+ * {@link BlockRegistry}. Both `plan-block-registry.ts` and `nfm-registry.ts` call
+ * this, then register only their app-specific block configs (plan adds callout /
+ * diagram / wireframe / question-form) on top — so the shared library lives in
+ * exactly one place across browser AND server registries.
+ */
+export function registerLibraryBlockConfigs(registry, options = {}) {
+    const overrides = options.overrides ?? {};
+    const specs = libraryBlockConfigs.map((spec) => {
+        const override = overrides[spec.type];
+        return override ? { ...spec, ...override } : spec;
+    });
+    registerBlocks(registry, specs);
+}
+//# sourceMappingURL=server-specs.js.map

package/dist/client/blocks/library/server-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-specs.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/server-specs.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineBlock, type BlockSpec } from \"../types.js\";\nimport { registerBlocks, type BlockRegistry } from \"../registry.js\";\n\n// React-free schema + MDX config for the standard library. The matching React\n// `Read`/`Edit` live in the full client entry; the server path only ever touches\n// `spec.schema` / `spec.mdx`, so these configs register with a render-only stub.\nimport {\n  checklistSchema,\n  checklistMdx,\n  type ChecklistData,\n} from \"./checklist.config.js\";\nimport { tableSchema, tableMdx, type TableData } from \"./table.config.js\";\nimport {\n  codeTabsSchema,\n  codeTabsMdx,\n  type CodeTabsData,\n} from \"./code-tabs.config.js\";\nimport { htmlSchema, htmlMdx, type HtmlBlockData } from \"./html.config.js\";\nimport { tabsSchema, tabsMdx, type TabsData } from \"./tabs.config.js\";\nimport {\n  mermaidSchema,\n  mermaidMdx,\n  type MermaidData,\n} from \"./mermaid.config.js\";\nimport {\n  apiEndpointSchema,\n  apiEndpointMdx,\n  type ApiEndpointData,\n} from \"./api-endpoint.config.js\";\nimport {\n  openApiSpecSchema,\n  openApiSpecMdx,\n  type OpenApiSpecData,\n} from \"./openapi-spec.config.js\";\nimport {\n  dataModelSchema,\n  dataModelMdx,\n  type DataModelData,\n} from \"./data-model.config.js\";\nimport { diffSchema, diffMdx, type DiffData } from \"./diff.config.js\";\nimport {\n  fileTreeSchema,\n  fileTreeMdx,\n  type FileTreeData,\n} from \"./file-tree.config.js\";\nimport {\n  jsonExplorerSchema,\n  jsonExplorerMdx,\n  type JsonExplorerData,\n} from \"./json-explorer.config.js\";\nimport {\n  annotatedCodeSchema,\n  annotatedCodeMdx,\n  type AnnotatedCodeData,\n} from \"./annotated-code.config.js\";\n\n/** Render-only stub for server / agent registries (never invoked off-browser). */\nconst ServerReadStub = () => null;\n\n/**\n * Canonical React-free specs for the standard library, used by BOTH apps' server\n * / shared registries (`plan-block-registry.ts`, `nfm-registry.ts`). Each carries\n * only the parts the server path touches — `schema` + `mdx` + metadata for the\n * agent schema export — with a render-only `Read` stub. The full client specs\n * (with real React `Read`/`Edit`) live in `./specs.tsx`; both share the identical\n * `schema`/`mdx` config so inline source can never drift from what renders.\n *\n * `table` keeps the core default `type` here; content's server registry renames\n * it to `table-block` via {@link LibraryBlockConfigOverrides}. The descriptions\n * are the neutral agent-schema phrasing; an app that curates a longer\n * description for a block (e.g. plan's hand-drawn Mermaid, plan's detailed file\n * tree) passes an override rather than re-authoring the spec.\n */\nexport const libraryBlockConfigs: BlockSpec<any>[] = [\n  defineBlock<ChecklistData>({\n    type: \"checklist\",\n    schema: checklistSchema,\n    mdx: checklistMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    notionCompatible: true,\n    label: \"Checklist\",\n    description:\n      \"A list of toggleable items, each with a label and an optional note.\",\n  }),\n  defineBlock<TableData>({\n    type: \"table\",\n    schema: tableSchema,\n    mdx: tableMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    notionCompatible: true,\n    label: \"Table\",\n    description:\n      \"A simple grid with header columns and string rows for comparisons, parameters, or structured lists.\",\n  }),\n  defineBlock<CodeTabsData>({\n    type: \"code-tabs\",\n    schema: codeTabsSchema,\n    mdx: codeTabsMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"Code tabs\",\n    description:\n      \"A vertical file tab rail of syntax-highlighted code snippets, one tab per file with an optional language and caption.\",\n  }),\n  defineBlock<HtmlBlockData>({\n    type: \"custom-html\",\n    schema: htmlSchema,\n    mdx: htmlMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"HTML / Tailwind\",\n    description:\n      \"An author-supplied HTML (with optional CSS) fragment rendered in a sandboxed iframe, with inline source editing.\",\n  }),\n  defineBlock<TabsData>({\n    type: \"tabs\",\n    schema: tabsSchema,\n    mdx: tabsMdx,\n    Read: ServerReadStub,\n    placement: [\"block\", \"inline\"],\n    label: \"Tabs\",\n    description:\n      \"A horizontal pill-tab container; each tab holds its own list of blocks.\",\n  }),\n  defineBlock<MermaidData>({\n    type: \"mermaid\",\n    schema: mermaidSchema,\n    mdx: mermaidMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"Diagram (Mermaid)\",\n    description:\n      \"A Mermaid diagram (flowchart, sequence, etc.) defined as text and rendered as a diagram.\",\n  }),\n  defineBlock<ApiEndpointData>({\n    type: \"api-endpoint\",\n    schema: apiEndpointSchema,\n    mdx: apiEndpointMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"API endpoint\",\n    description:\n      \"A Swagger-style API endpoint reference: a colored method pill + path, collapsed by default, expanding to params, request body, and per-status response examples.\",\n  }),\n  defineBlock<OpenApiSpecData>({\n    type: \"openapi-spec\",\n    schema: openApiSpecSchema,\n    mdx: openApiSpecMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"OpenAPI spec\",\n    description:\n      \"A whole-document Redoc / Swagger-UI-style API reference rendered from a complete OpenAPI 3 / Swagger 2 spec (JSON).\",\n  }),\n  defineBlock<DataModelData>({\n    type: \"data-model\",\n    schema: dataModelSchema,\n    mdx: dataModelMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"Data model\",\n    description:\n      \"An ERD / dbdiagram-style data model: entity cards with typed fields (PK/FK/nullable flags) and interactive foreign-key relations.\",\n  }),\n  defineBlock<DiffData>({\n    type: \"diff\",\n    schema: diffSchema,\n    mdx: diffMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"Diff\",\n    description:\n      \"A GitHub-style before/after line diff for a file, with unified or split view and added/removed line highlighting.\",\n  }),\n  defineBlock<FileTreeData>({\n    type: \"file-tree\",\n    schema: fileTreeSchema,\n    mdx: fileTreeMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"File tree\",\n    description:\n      \"A VS Code / GitHub-explorer file and change tree with per-file change badges, notes, and code snippets.\",\n  }),\n  defineBlock<JsonExplorerData>({\n    type: \"json-explorer\",\n    schema: jsonExplorerSchema,\n    mdx: jsonExplorerMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"JSON explorer\",\n    description:\n      \"A collapsible browser-devtools / Postman-style JSON tree with type-colored values and expand/collapse.\",\n  }),\n  defineBlock<AnnotatedCodeData>({\n    type: \"annotated-code\",\n    schema: annotatedCodeSchema,\n    mdx: annotatedCodeMdx,\n    Read: ServerReadStub,\n    placement: [\"block\"],\n    label: \"Annotated code\",\n    description:\n      \"A line-numbered code walkthrough whose line ranges carry anchored explanatory notes.\",\n  }),\n];\n\n/**\n * Per-block overrides for {@link registerLibraryBlockConfigs}, keyed by canonical\n * `type`. Servers tweak only the agent-facing fields that legitimately differ:\n * content re-types `table` → `table-block`; plan curates a longer Mermaid and\n * file-tree description. The `schema` / `mdx` config always stays shared.\n */\nexport type LibraryBlockConfigOverrides = Record<\n  string,\n  Partial<\n    Pick<BlockSpec<any>, \"type\" | \"label\" | \"description\" | \"notionCompatible\">\n  >\n>;\n\n/**\n * Register the React-free standard-library config stubs into a server / shared\n * {@link BlockRegistry}. Both `plan-block-registry.ts` and `nfm-registry.ts` call\n * this, then register only their app-specific block configs (plan adds callout /\n * diagram / wireframe / question-form) on top — so the shared library lives in\n * exactly one place across browser AND server registries.\n */\nexport function registerLibraryBlockConfigs(\n  registry: BlockRegistry,\n  options: { overrides?: LibraryBlockConfigOverrides } = {},\n): void {\n  const overrides = options.overrides ?? {};\n  const specs = libraryBlockConfigs.map((spec) => {\n    const override = overrides[spec.type];\n    return override ? ({ ...spec, ...override } as BlockSpec<any>) : spec;\n  });\n  registerBlocks(registry, specs);\n}\n"]}

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

@@ -0,0 +1,29 @@
+import { type BlockSpec } from "../types.js";
+import { type BlockRegistry } from "../registry.js";
+/**
+ * The full standard library spec set, in registration order: the five fully
+ * pre-built specs (checklist, table, code-tabs, html, tabs) followed by the
+ * eight dev-doc specs. This is the single list both the plan and content browser
+ * registries register — adding a 14th library block here lands in both apps.
+ */
+export declare const libraryBlockSpecs: BlockSpec<any>[];
+/**
+ * Per-block metadata overrides for {@link registerLibraryBlocks}, keyed by the
+ * canonical block `type`. Lets an app tweak the few fields that legitimately
+ * differ (a `type` rename, a tweaked `description` or `empty` seed) without
+ * re-authoring the spec. Anything omitted keeps the canonical value, so the
+ * schema / MDX config and the React `Read`/`Edit` renderers always stay shared.
+ */
+export type LibraryBlockOverrides = Record<string, Partial<Pick<BlockSpec<any>, "type" | "label" | "description" | "empty">>>;
+/**
+ * Register the standard library block specs into a {@link BlockRegistry}. Both
+ * the plan and content browser registries call this, then register only their
+ * own app-specific blocks on top — so the shared library lives in exactly one
+ * place. Pass `overrides` (keyed by canonical `type`) for the small per-app
+ * differences (content re-types `table` → `table-block`; each app phrases the
+ * Mermaid description and seeds the OpenAPI example a little differently).
+ */
+export declare function registerLibraryBlocks(registry: BlockRegistry, options?: {
+    overrides?: LibraryBlockOverrides;
+}): void;
+//# sourceMappingURL=specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/specs.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAsPpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,GAAG,CAAC,EAO7C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CACxC,MAAM,EACN,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAC1E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAAO,GAClD,IAAI,CAON"}