@hello-ai-company/editor-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuki Shibata
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @hello-ai-company/editor-core
+
+Portable TypeScript document model, JSON serialization, and optional provider types.
+
+This is a **small host-neutral document layer** — not a rich-text editor, not a React component, and not a BlockNote/UI package.
+
+## Install
+
+```bash
+npm install @hello-ai-company/editor-core
+```
+
+Requirements: Node.js `>=20`, ESM. No runtime dependencies. No CommonJS export.
+
+Until the first public npmjs publish, pack from this repository:
+
+```bash
+npm pack -w @hello-ai-company/editor-core
+npm install ./hello-ai-company-editor-core-0.1.0.tgz
+```
+
+## Quickstart
+
+```ts
+import {
+  createEditorDocument,
+  serializeEditorDocument,
+  deserializeEditorDocument,
+  EDITOR_DOCUMENT_SCHEMA_VERSION
+} from "@hello-ai-company/editor-core";
+
+const doc = createEditorDocument([
+  {
+    id: "p1",
+    type: "paragraph",
+    props: { text: "Hello" },
+    content: [{ type: "text", text: "Hello" }]
+  }
+]);
+
+const json = serializeEditorDocument(doc);
+const roundTrip = deserializeEditorDocument(json);
+
+if (roundTrip.schemaVersion !== EDITOR_DOCUMENT_SCHEMA_VERSION) {
+  throw new Error("unexpected schemaVersion");
+}
+```
+
+`createEditorDocument` takes an **array of blocks**, not a `{ blocks }` wrapper. Unknown `type` strings are first-class data and round-trip. `schemaVersion` is the positive integer `1`.
+
+## What this package is
+
+- `EditorDocument` / `EditorBlock` / `JsonValue`
+- JSON serialize / deserialize
+- Optional provider **types** only (no network clients, no UI)
+
+## What this package is not
+
+- Not a rich-text editor
+- Not a host app, sync layer, or HTTP client
+- Not an adapter package (host integrations belong in later separate packages)
+
+Public runtime and type lists: [docs/public-api.md](https://github.com/hello-ai-company/open-editor/blob/main/docs/public-api.md).
+
+## License
+
+MIT. Copyright (c) 2026 Yuki Shibata.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { EDITOR_DOCUMENT_SCHEMA_VERSION, cloneEditorBlock, cloneEditorBlocks, createEditorDocument, isEditorBlock, isEditorDocument, isJsonValue, isSupportedSchemaVersion, type EditorBlock, type EditorBlockProps, type EditorDocument, type JsonValue } from "./model.js";
+export { EditorDocumentSerializationError, deserializeEditorDocument, fromSerializedEditorDocument, serializeEditorDocument, toSerializedEditorDocument, type SerializedEditorDocument } from "./serialization.js";
+export type { AIEditAction, AIEditRequest, AIProvider, AssetProvider, AssetUploadScope, CommentsProvider, CreatedChildPage, DatabaseListOptions, DatabaseProvider, DatabaseRowItem, DatabaseRowsPage, EditorAsset, EditorAssetKind, EditorComment, EditorPageLink, EditorProviders, EditorUploadFile, EditorVersionSnapshot, ImageSearchProvider, ImageSearchResult, NativeBridge, NativeBridgeStats, NativeHostRequest, NativeHostResponse, PageProvider, VersionProvider } from "./providers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EAChB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { EDITOR_DOCUMENT_SCHEMA_VERSION, cloneEditorBlock, cloneEditorBlocks, createEditorDocument, isEditorBlock, isEditorDocument, isJsonValue, isSupportedSchemaVersion } from "./model.js";
+export { EditorDocumentSerializationError, deserializeEditorDocument, fromSerializedEditorDocument, serializeEditorDocument, toSerializedEditorDocument } from "./serialization.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EAKzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAE3B,MAAM,oBAAoB,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Provider-neutral editor document model.
+ *
+ * This module is a seam only: it describes typed block trees without host
+ * workspace, privacy, source, or server metadata.
+ */
+export declare const EDITOR_DOCUMENT_SCHEMA_VERSION = 1;
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type EditorBlockProps = Record<string, JsonValue>;
+/**
+ * Minimal extensible block. Unknown `type` values and extra `props` keys are
+ * first-class so a newer producer can round-trip through an older consumer.
+ */
+export type EditorBlock = {
+    id: string;
+    type: string;
+    props?: EditorBlockProps;
+    content?: JsonValue;
+    children?: EditorBlock[];
+};
+export type EditorDocument = {
+    schemaVersion: number;
+    blocks: EditorBlock[];
+};
+/**
+ * Phase 2 contract: only the positive integer `1` is a supported schemaVersion.
+ * Rejects `-1`, `0`, `1.5`, `2`, and any non-integer numeric value.
+ */
+export declare function isSupportedSchemaVersion(value: unknown): value is number;
+export declare function createEditorDocument(blocks: EditorBlock[], schemaVersion?: number): EditorDocument;
+export declare function cloneEditorBlocks(blocks: EditorBlock[]): EditorBlock[];
+export declare function cloneEditorBlock(block: EditorBlock): EditorBlock;
+export declare function isEditorBlock(value: unknown): value is EditorBlock;
+export declare function isJsonValue(value: unknown): value is JsonValue;
+export declare function isEditorDocument(value: unknown): value is EditorDocument;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMxE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,aAAa,SAAiC,GAAG,cAAc,CAQ1H;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAehE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAWlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAQ9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE"}

package/dist/model.js

@@ -0,0 +1,95 @@
+/**
+ * Provider-neutral editor document model.
+ *
+ * This module is a seam only: it describes typed block trees without host
+ * workspace, privacy, source, or server metadata.
+ */
+export const EDITOR_DOCUMENT_SCHEMA_VERSION = 1;
+/**
+ * Phase 2 contract: only the positive integer `1` is a supported schemaVersion.
+ * Rejects `-1`, `0`, `1.5`, `2`, and any non-integer numeric value.
+ */
+export function isSupportedSchemaVersion(value) {
+    return typeof value === "number"
+        && Number.isInteger(value)
+        && Number.isFinite(value)
+        && value > 0
+        && value === EDITOR_DOCUMENT_SCHEMA_VERSION;
+}
+export function createEditorDocument(blocks, schemaVersion = EDITOR_DOCUMENT_SCHEMA_VERSION) {
+    if (!isSupportedSchemaVersion(schemaVersion)) {
+        throw new Error("Editor document schemaVersion must be the positive integer 1.");
+    }
+    return {
+        schemaVersion,
+        blocks: cloneEditorBlocks(blocks)
+    };
+}
+export function cloneEditorBlocks(blocks) {
+    return blocks.map(cloneEditorBlock);
+}
+export function cloneEditorBlock(block) {
+    const cloned = {
+        id: block.id,
+        type: block.type
+    };
+    if (block.props !== undefined) {
+        cloned.props = cloneJsonValue(block.props);
+    }
+    if (block.content !== undefined) {
+        cloned.content = cloneJsonValue(block.content);
+    }
+    if (block.children !== undefined) {
+        cloned.children = cloneEditorBlocks(block.children);
+    }
+    return cloned;
+}
+export function isEditorBlock(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const block = value;
+    if (typeof block.id !== "string" || block.id.length === 0)
+        return false;
+    if (typeof block.type !== "string" || block.type.length === 0)
+        return false;
+    if (block.props !== undefined && !(isPlainObject(block.props) && isJsonValue(block.props)))
+        return false;
+    if (block.content !== undefined && !isJsonValue(block.content))
+        return false;
+    if (block.children !== undefined) {
+        if (!Array.isArray(block.children) || !block.children.every(isEditorBlock))
+            return false;
+    }
+    return true;
+}
+export function isJsonValue(value) {
+    if (value === null)
+        return true;
+    const kind = typeof value;
+    if (kind === "string" || kind === "boolean")
+        return true;
+    if (kind === "number")
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    if (!isPlainObject(value))
+        return false;
+    return Object.values(value).every(isJsonValue);
+}
+export function isEditorDocument(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const document = value;
+    if (!isSupportedSchemaVersion(document.schemaVersion))
+        return false;
+    if (!Array.isArray(document.blocks) || !document.blocks.every(isEditorBlock))
+        return false;
+    return true;
+}
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function cloneJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/providers.d.ts

@@ -0,0 +1,201 @@
+import type { EditorDocument, JsonValue } from "./model.js";
+/**
+ * Optional seams the host may implement. Every provider is optional so a
+ * consumer can mount a read-only document with zero integrations.
+ *
+ * Contracts stay host-neutral: edit/transform, persistence, comments,
+ * versions, assets, pages, and a generic native host protocol.
+ */
+export type AIEditAction = "improve" | "shorten" | "expand" | "rewrite" | "custom";
+export type AIEditRequest = {
+    prompt: string;
+    selectionText?: string;
+    action?: AIEditAction;
+    instruction?: string;
+};
+export type AIProvider = {
+    edit?(request: AIEditRequest): Promise<string>;
+};
+export type DatabaseListOptions = {
+    limit?: number;
+    cursor?: string;
+    query?: string;
+    sortBy?: "position" | "title";
+    direction?: "asc" | "desc";
+    includeTrashed?: boolean;
+    trashedOnly?: boolean;
+};
+export type DatabaseRowItem = {
+    rowKey: string;
+    sortOrder: number;
+    deletedAt?: string | null;
+    row: Record<string, JsonValue>;
+};
+export type DatabaseRowsPage = {
+    databaseId: string;
+    rows: Array<Record<string, JsonValue>>;
+    items: DatabaseRowItem[];
+    schema: Record<string, string>;
+    config: Record<string, JsonValue>;
+    pagination: {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+        total: number;
+    };
+};
+export type DatabaseProvider = {
+    listRows?(databaseId: string, options?: DatabaseListOptions): Promise<DatabaseRowsPage>;
+    getRow?(databaseId: string, rowKey: string): Promise<{
+        databaseId: string;
+        row: Record<string, JsonValue>;
+    }>;
+    createRow?(databaseId: string, row: Record<string, JsonValue>, options?: {
+        rowKey?: string;
+        sortOrder?: number;
+    }): Promise<JsonValue>;
+    updateRow?(databaseId: string, rowKey: string, row: Record<string, JsonValue>, sortOrder?: number): Promise<JsonValue>;
+    deleteRow?(databaseId: string, rowKey: string): Promise<JsonValue>;
+    restoreRow?(databaseId: string, rowKey: string): Promise<JsonValue>;
+    reorderRows?(databaseId: string, rowKeys: string[]): Promise<JsonValue>;
+};
+export type EditorComment = {
+    id: string;
+    blockId: string;
+    text: string;
+    createdAt: string;
+    resolved?: boolean;
+};
+export type CommentsProvider = {
+    list?(documentId: string): Promise<EditorComment[]>;
+    add?(documentId: string, blockId: string, text: string): Promise<EditorComment | void>;
+    update?(documentId: string, commentId: string, update: {
+        text?: string;
+        resolved?: boolean;
+    }): Promise<EditorComment | void>;
+    delete?(documentId: string, commentId: string): Promise<void>;
+};
+export type EditorVersionSnapshot = {
+    id: string;
+    name?: string;
+    title?: string;
+    createdAt: string;
+    document: EditorDocument;
+};
+export type VersionProvider = {
+    list?(documentId: string): Promise<EditorVersionSnapshot[]>;
+    save?(documentId: string, snapshot: Omit<EditorVersionSnapshot, "id" | "createdAt"> & {
+        id?: string;
+        createdAt?: string;
+    }): Promise<EditorVersionSnapshot | void>;
+    restore?(documentId: string, versionId: string): Promise<EditorVersionSnapshot | void>;
+    rename?(documentId: string, versionId: string, name: string): Promise<void>;
+    delete?(documentId: string, versionId: string): Promise<void>;
+};
+export type EditorAssetKind = "image" | "video" | "audio" | "pdf" | "file";
+export type EditorAsset = {
+    url: string;
+    attachmentId?: string;
+    name: string;
+    mimeType: string;
+    size?: number;
+    kind?: EditorAssetKind;
+};
+export type EditorUploadFile = {
+    name: string;
+    type: string;
+    size: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+};
+export type AssetUploadScope = {
+    documentId?: string;
+    blockId?: string;
+};
+export type AssetProvider = {
+    upload?(file: EditorUploadFile, scope?: AssetUploadScope): Promise<EditorAsset>;
+    insertCloud?(asset: EditorAsset): void;
+};
+export type ImageSearchResult = {
+    id: string;
+    title: string;
+    url: string;
+    keywords?: string;
+};
+export type ImageSearchProvider = {
+    search?(query: string, page?: number, perPage?: number): Promise<{
+        configured: boolean;
+        page: number;
+        perPage: number;
+        total: number;
+        hasMore: boolean;
+        results: ImageSearchResult[];
+    }>;
+};
+export type EditorPageLink = {
+    id: string;
+    title: string;
+    preview?: string;
+    imageUrl?: string;
+    imageAlt?: string;
+};
+export type CreatedChildPage = {
+    id: string;
+    title: string;
+    preview?: string;
+    imageUrl?: string;
+    imageAlt?: string;
+};
+export type PageProvider = {
+    listLinks?(excludePageId?: string): Promise<EditorPageLink[]>;
+    createChildPage?(): CreatedChildPage | void;
+    openPage?(pageId: string): void;
+};
+export type NativeBridgeStats = {
+    characters?: number;
+    words?: number;
+    blocks?: number;
+    headings?: number;
+    tasks?: number;
+    completedTasks?: number;
+    media?: number;
+    tables?: number;
+    links?: number;
+    readingMinutes?: number;
+};
+export type NativeHostRequest = {
+    id: string;
+    method: string;
+    payload?: JsonValue;
+};
+export type NativeHostResponse = {
+    id: string;
+    ok: boolean;
+    payload?: JsonValue;
+    error?: string;
+};
+/**
+ * Minimal generic host protocol. Host-specific transport (network proxy,
+ * document chrome, workforce actions) maps onto hostRequest / hostResponse.
+ */
+export type NativeBridge = {
+    ready?(documentId: string): void;
+    change?(payload: {
+        dirty: boolean;
+        stats?: NativeBridgeStats;
+    }): void;
+    commit?(payload: Record<string, JsonValue>): void;
+    error?(message: string): void;
+    hostRequest?(request: NativeHostRequest): void;
+    hostResponse?(response: NativeHostResponse): void;
+};
+export type EditorProviders = {
+    ai?: AIProvider;
+    database?: DatabaseProvider;
+    comments?: CommentsProvider;
+    versions?: VersionProvider;
+    assets?: AssetProvider;
+    imageSearch?: ImageSearchProvider;
+    pages?: PageProvider;
+    nativeBridge?: NativeBridge;
+};
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

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

package/dist/providers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":""}

package/dist/serialization.d.ts

@@ -0,0 +1,13 @@
+import { type EditorBlock, type EditorDocument } from "./model.js";
+export declare class EditorDocumentSerializationError extends Error {
+    constructor(message: string);
+}
+export type SerializedEditorDocument = {
+    schemaVersion: number;
+    blocks: EditorBlock[];
+};
+export declare function serializeEditorDocument(document: EditorDocument): string;
+export declare function deserializeEditorDocument(payload: string): EditorDocument;
+export declare function toSerializedEditorDocument(document: EditorDocument): SerializedEditorDocument;
+export declare function fromSerializedEditorDocument(payload: unknown): EditorDocument;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAQzE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,wBAAwB,CAW7F;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAyB7E"}

package/dist/serialization.js

@@ -0,0 +1,67 @@
+import { EDITOR_DOCUMENT_SCHEMA_VERSION, cloneEditorBlock, isEditorBlock, isSupportedSchemaVersion } from "./model.js";
+export class EditorDocumentSerializationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EditorDocumentSerializationError";
+    }
+}
+export function serializeEditorDocument(document) {
+    return JSON.stringify(toSerializedEditorDocument(document));
+}
+export function deserializeEditorDocument(payload) {
+    let parsed;
+    try {
+        parsed = JSON.parse(payload);
+    }
+    catch {
+        throw new EditorDocumentSerializationError("Editor document JSON is not valid.");
+    }
+    return fromSerializedEditorDocument(parsed);
+}
+export function toSerializedEditorDocument(document) {
+    if (!isSupportedSchemaVersion(document.schemaVersion)) {
+        throw new EditorDocumentSerializationError("Editor document schemaVersion must be the positive integer 1.");
+    }
+    if (!Array.isArray(document.blocks)) {
+        throw new EditorDocumentSerializationError("Editor document blocks must be an array.");
+    }
+    return {
+        schemaVersion: document.schemaVersion,
+        blocks: document.blocks.map(normalizeEditorBlock)
+    };
+}
+export function fromSerializedEditorDocument(payload) {
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+        throw new EditorDocumentSerializationError("Editor document must be an object.");
+    }
+    const record = payload;
+    const schemaVersion = record.schemaVersion === undefined ? EDITOR_DOCUMENT_SCHEMA_VERSION : record.schemaVersion;
+    if (!isSupportedSchemaVersion(schemaVersion)) {
+        throw new EditorDocumentSerializationError(typeof schemaVersion === "number"
+            ? `Unsupported editor document schemaVersion ${schemaVersion}.`
+            : "Editor document schemaVersion must be the positive integer 1.");
+    }
+    if (!Array.isArray(record.blocks)) {
+        throw new EditorDocumentSerializationError("Editor document blocks must be an array.");
+    }
+    return {
+        schemaVersion,
+        blocks: record.blocks.map((block, index) => {
+            if (!isEditorBlock(block)) {
+                throw new EditorDocumentSerializationError(`Editor document block at index ${index} is invalid.`);
+            }
+            return normalizeEditorBlock(block);
+        })
+    };
+}
+function normalizeEditorBlock(block) {
+    const normalized = cloneEditorBlock(block);
+    if (normalized.children?.length === 0) {
+        delete normalized.children;
+    }
+    if (normalized.props && Object.keys(normalized.props).length === 0) {
+        delete normalized.props;
+    }
+    return normalized;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@hello-ai-company/editor-core",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Portable TypeScript document model, JSON serialization, and optional provider types. A small host-neutral document layer - not a rich-text editor.",
+  "keywords": [
+    "document-model",
+    "serialization",
+    "typescript",
+    "json",
+    "editor-core",
+    "portable-document",
+    "schema"
+  ],
+  "homepage": "https://github.com/hello-ai-company/open-editor/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/hello-ai-company/open-editor/issues"
+  },
+  "author": "Yuki Shibata",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hello-ai-company/open-editor.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}