email-builder-online 4.1.6 → 4.1.7

package/README.md

@@ -777,15 +777,49 @@ interface AIFeatureRequest {
 
 ## Block Schemas & Validation (`@eb/document-core`)
 
-All block schemas, the document-level schema, and the validation logic are exported from the `@eb/document-core` package. This package has **zero browser dependencies** (only `zod`) and is safe to use in Node.js processes — designed for MCP servers, backend scripts, and CLI tools.
+All block schemas, the document-level schema, and the validation logic are exported from the `@eb/document-core` package. The package ships a **node-safe entry** with **zero browser dependencies** (only `zod` is required) — designed for MCP servers, backend scripts, and CLI tools that validate documents in a plain Node.js process.
+
+### Two entry points
+
+| Entry | Import specifier | Contents | Deps |
+|---|---|---|---|
+| Default (editor) | `@eb/document-core` | Everything, incl. React-coupled builders (`buildBlockComponent`) | React + Zod |
+| **Node-safe** | `@eb/document-core/node` | Schemas, validation, theme schemas, resolvers — **no React** | Zod only |
+
+> Server-side consumers (MCP, backend, CLI) must import from **`@eb/document-core/node`** so they never pull in React.
 
 ### Installation
 
+**Inside this monorepo** (e.g. `@eb/backend`) — workspace protocol:
+
 ```bash
-# Within the monorepo (workspace protocol)
 pnpm add @eb/document-core
 ```
 
+**From an external project** (e.g. the standalone MCP repo) — the package is not
+published, so consume a **vendored** build. Generate it from the monorepo:
+
+```bash
+cd packages/document-core
+pnpm vendor   # bundles the node-safe entry → vendor/document-core + a .tgz tarball
+```
+
+Copy `vendor/document-core` (or the `eb-document-core-<version>.tgz` tarball) into
+the consumer repo and reference it via `file:`:
+
+```jsonc
+// consumer package.json
+{
+  "dependencies": {
+    "@eb/document-core": "file:./vendor/document-core",
+    "zod": "^3.22.4"   // peer dep — provided by the consumer
+  }
+}
+```
+
+The vendored bundle ships ESM + CJS + `.d.ts` and type-checks **without
+`@types/react`**.
+
 ### Schemas
 
 ```ts
@@ -823,7 +857,7 @@ import {
 ### Validation
 
 ```ts
-import { validateDocument, type ValidationResult } from '@eb/document-core';
+import { validateDocument, type ValidationResult } from '@eb/document-core/node';
 
 const result: ValidationResult = validateDocument(jsonDocument);