@localess/richtext 4.0.0-dev.20260905085556 → 4.0.0-dev.20260906124410

package/dist/parse-common.d.ts

@@ -0,0 +1,71 @@
+import { LocalessRichTextDocument } from './model';
+/**
+ * What to do with input that has no representation in the Localess rich text
+ * model — the model is closed and matches the Studio editor exactly, so a
+ * `<table>` or a blockquote has nowhere to go.
+ *
+ * - `unwrap` — keep the text content, drop the wrapper (default)
+ * - `skip` — drop the element and everything inside it
+ * - `throw` — throw {@link RichTextParseError} naming the element
+ */
+export type RichTextUnsupportedPolicy = 'unwrap' | 'skip' | 'throw';
+/** Options accepted by both parsers. */
+export interface RichTextParseOptions {
+    /**
+     * Handling for elements the model cannot represent.
+     *
+     * @default 'unwrap'
+     */
+    unsupported?: RichTextUnsupportedPolicy;
+}
+/** One unsupported element type, and what the parser did with it. */
+export interface RichTextUnsupportedReport {
+    /** Element or construct name, e.g. `table`, `blockquote`, `img`. */
+    element: string;
+    action: 'unwrapped' | 'skipped';
+    /** How many times it occurred in this parse. */
+    count: number;
+}
+/** What both parsers return. */
+export interface RichTextParseResult {
+    doc: LocalessRichTextDocument;
+    /**
+     * Every element that could not be represented, with its handling and count.
+     * Empty when the input was fully representable.
+     *
+     * Returned rather than only warned so a migration can surface "347 tables
+     * were unwrapped" and decide whether to proceed before committing a write.
+     */
+    unsupported: RichTextUnsupportedReport[];
+}
+/** Thrown by both parsers when `unsupported: 'throw'` meets an unrepresentable element. */
+export declare class RichTextParseError extends Error {
+    /** The element that could not be represented. */
+    readonly element: string;
+    constructor(element: string);
+}
+/**
+ * Records unsupported elements for the result report, warns once per element
+ * type per parse, and applies the configured policy.
+ *
+ * Mirrors the renderer's forward-compat behaviour, which warns once per unknown
+ * type per render and stays silent in production.
+ */
+export declare class UnsupportedTracker {
+    private readonly policy;
+    private readonly counts;
+    private readonly warned;
+    constructor(options?: RichTextParseOptions);
+    /**
+     * Records one occurrence and returns whether the caller should keep the
+     * element's children.
+     *
+     * @throws {RichTextParseError} When the policy is `throw`.
+     */
+    record(element: string): 'unwrap' | 'skip';
+    /** The report, in first-seen order. */
+    report(): RichTextUnsupportedReport[];
+    private warn;
+}
+/** An empty document — what both parsers return for empty, `null`, or `undefined` input. */
+export declare function emptyDocument(): LocalessRichTextDocument;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/richtext",
-  "version": "4.0.0-dev.20260905085556",
+  "version": "4.0.0-dev.20260906124410",
   "description": "Framework-neutral rich text model and renderer for Localess's TipTap JSON content.",
   "keywords": [
     "localess",
@@ -30,6 +30,16 @@
       "types": "./dist/test-utils/index.d.ts",
       "import": "./dist/test-utils/index.mjs",
       "require": "./dist/test-utils/index.js"
+    },
+    "./html-parser": {
+      "types": "./dist/html-parser/index.d.ts",
+      "import": "./dist/html-parser/index.mjs",
+      "require": "./dist/html-parser/index.js"
+    },
+    "./markdown-parser": {
+      "types": "./dist/markdown-parser/index.d.ts",
+      "import": "./dist/markdown-parser/index.mjs",
+      "require": "./dist/markdown-parser/index.js"
     }
   },
   "repository": {
@@ -48,7 +58,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@localess/model": "4.0.0-dev.20260905085556"
+    "@localess/model": "4.0.0-dev.20260906124410"
   },
   "devDependencies": {
     "@tiptap/extension-bold": "^3.22.5",
@@ -67,7 +77,10 @@
     "@tiptap/extension-text": "^3.22.5",
     "@tiptap/extension-underline": "^3.22.5",
     "@tiptap/html": "^3.22.5",
+    "@types/markdown-it": "^14.1.2",
     "@types/node": "^24",
+    "happy-dom": "^20.9.0",
+    "markdown-it": "^14.1.0",
     "typescript": "^5.9.3",
     "vite": "^8.0.16",
     "vite-plugin-dts": "^5.0.0"