@rtif-sdk/web 1.0.0

package/dist/content-extraction.js

@@ -0,0 +1,228 @@
+/**
+ * Content extraction — converts browser clipboard and drag events into
+ * {@link ContentItem} arrays for the content pipeline.
+ *
+ * This module bridges between the browser's DataTransfer API and the
+ * content pipeline's abstract ContentItem interface. It handles deduplication,
+ * lazy data access, and file wrapping.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// extractFromPaste
+// ---------------------------------------------------------------------------
+/**
+ * Extract content items from a ClipboardEvent.
+ *
+ * Uses the `DataTransferItemList` API when available for lazy data access.
+ * Falls back to `getData()` for string types. Deduplicates entries where both
+ * APIs provide the same MIME type.
+ *
+ * @param e - The clipboard event (from a 'paste' handler)
+ * @returns Array of ContentItem objects for pipeline processing
+ *
+ * @example
+ * ```ts
+ * root.addEventListener('paste', (e) => {
+ *   e.preventDefault();
+ *   const items = extractFromPaste(e);
+ *   pipeline.process(items, contextOpts);
+ * });
+ * ```
+ */
+export function extractFromPaste(e) {
+    const clipboardData = e.clipboardData;
+    if (!clipboardData)
+        return [];
+    return extractFromDataTransfer(clipboardData, 'paste');
+}
+// ---------------------------------------------------------------------------
+// extractFromDrop
+// ---------------------------------------------------------------------------
+/**
+ * Extract content items from a DragEvent.
+ *
+ * Uses the `DataTransferItemList` API when available, falling back to
+ * `DataTransfer.files` and `getData()`. Items are created with source 'drop'.
+ *
+ * @param e - The drag event (from a 'drop' handler)
+ * @returns Array of ContentItem objects for pipeline processing
+ *
+ * @example
+ * ```ts
+ * root.addEventListener('drop', (e) => {
+ *   e.preventDefault();
+ *   const items = extractFromDrop(e);
+ *   pipeline.process(items, contextOpts);
+ * });
+ * ```
+ */
+export function extractFromDrop(e) {
+    const dataTransfer = e.dataTransfer;
+    if (!dataTransfer)
+        return [];
+    return extractFromDataTransfer(dataTransfer, 'drop');
+}
+// ---------------------------------------------------------------------------
+// fileToContentItem
+// ---------------------------------------------------------------------------
+/**
+ * Create a ContentItem from a File object.
+ *
+ * The `getString()` method returns `file.text()` for text MIME types,
+ * null otherwise. `getFile()` and `getBlob()` always return the file.
+ *
+ * @param file - The File to wrap
+ * @param source - How the file entered the editor
+ * @returns A ContentItem wrapping the file
+ *
+ * @example
+ * ```ts
+ * const fileInput = document.querySelector('input[type=file]');
+ * const file = fileInput.files[0];
+ * const item = fileToContentItem(file, 'input');
+ * ```
+ */
+export function fileToContentItem(file, source) {
+    return {
+        type: file.type || 'application/octet-stream',
+        source,
+        async getString() {
+            if (isTextMimeType(file.type)) {
+                return file.text();
+            }
+            return null;
+        },
+        async getFile() {
+            return file;
+        },
+        async getBlob() {
+            return file;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a MIME type represents text content.
+ */
+function isTextMimeType(type) {
+    return (type.startsWith('text/') ||
+        type === 'application/json' ||
+        type === 'application/x-rtif+json' ||
+        type === 'application/xml');
+}
+/**
+ * Extract content items from a DataTransfer object.
+ *
+ * Uses DataTransferItemList when available for proper lazy access.
+ * Falls back to getData() for string types and .files for file types.
+ * Deduplicates: if both DataTransferItem and getData produce the same
+ * MIME type, the DataTransferItem version wins.
+ */
+function extractFromDataTransfer(dt, source) {
+    const result = [];
+    const seenTypes = new Set();
+    // Prefer DataTransferItemList (modern API with lazy access)
+    if (dt.items && dt.items.length > 0) {
+        for (let i = 0; i < dt.items.length; i++) {
+            const dtItem = dt.items[i];
+            if (!dtItem)
+                continue;
+            const mimeType = dtItem.type;
+            if (dtItem.kind === 'string') {
+                seenTypes.add(mimeType);
+                // Capture the DataTransferItem reference for lazy string retrieval.
+                // We must call getAsString() synchronously during the event, so we
+                // eagerly resolve the string and store it in a closure.
+                const stringPromise = getStringFromDataTransferItem(dtItem);
+                result.push({
+                    type: mimeType,
+                    source,
+                    getString: () => stringPromise,
+                    async getFile() {
+                        return null;
+                    },
+                    async getBlob() {
+                        return null;
+                    },
+                });
+            }
+            else if (dtItem.kind === 'file') {
+                const file = dtItem.getAsFile();
+                if (file) {
+                    seenTypes.add(mimeType);
+                    result.push(fileToContentItem(file, source));
+                }
+            }
+        }
+    }
+    // Fall back to getData() for string types not already captured.
+    // This handles browsers where DataTransferItemList is incomplete.
+    for (const type of dt.types) {
+        if (seenTypes.has(type))
+            continue;
+        // 'Files' is a special type indicator, not a real MIME type
+        if (type === 'Files')
+            continue;
+        try {
+            const data = dt.getData(type);
+            if (data) {
+                seenTypes.add(type);
+                result.push({
+                    type,
+                    source,
+                    async getString() {
+                        return data;
+                    },
+                    async getFile() {
+                        return null;
+                    },
+                    async getBlob() {
+                        return null;
+                    },
+                });
+            }
+        }
+        catch {
+            // getData() may throw in some browsers for certain types
+            continue;
+        }
+    }
+    // Fall back to .files for file types not already captured
+    if (dt.files && dt.files.length > 0) {
+        for (let i = 0; i < dt.files.length; i++) {
+            const file = dt.files[i];
+            if (!file)
+                continue;
+            const fileType = file.type || 'application/octet-stream';
+            if (seenTypes.has(fileType))
+                continue;
+            seenTypes.add(fileType);
+            result.push(fileToContentItem(file, source));
+        }
+    }
+    return result;
+}
+/**
+ * Get a string from a DataTransferItem using the callback-based API,
+ * wrapped in a Promise.
+ *
+ * Note: In some browsers, getAsString() must be called synchronously
+ * during the event handler. The callback fires asynchronously, but the
+ * registration is synchronous.
+ */
+function getStringFromDataTransferItem(item) {
+    return new Promise((resolve) => {
+        try {
+            item.getAsString((str) => {
+                resolve(str);
+            });
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+//# sourceMappingURL=content-extraction.js.map

package/dist/content-extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-extraction.js","sourceRoot":"","sources":["../src/content-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAiB;IAChD,MAAM,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC;IACtC,IAAI,CAAC,aAAa;QAAE,OAAO,EAAE,CAAC;IAE9B,OAAO,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,CAAY;IAC1C,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;IACpC,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAE7B,OAAO,uBAAuB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAU,EACV,MAAyB;IAEzB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,0BAA0B;QAC7C,MAAM;QACN,KAAK,CAAC,SAAS;YACb,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,OAAO;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,OAAO;YACX,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QACxB,IAAI,KAAK,kBAAkB;QAC3B,IAAI,KAAK,yBAAyB;QAClC,IAAI,KAAK,iBAAiB,CAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,EAAgB,EAChB,MAAyB;IAEzB,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,4DAA4D;IAC5D,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YAE7B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxB,oEAAoE;gBACpE,mEAAmE;gBACnE,wDAAwD;gBACxD,MAAM,aAAa,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;gBAC5D,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,QAAQ;oBACd,MAAM;oBACN,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa;oBAC9B,KAAK,CAAC,OAAO;wBACX,OAAO,IAAI,CAAC;oBACd,CAAC;oBACD,KAAK,CAAC,OAAO;wBACX,OAAO,IAAI,CAAC;oBACd,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAChC,IAAI,IAAI,EAAE,CAAC;oBACT,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,kEAAkE;IAClE,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAElC,4DAA4D;QAC5D,IAAI,IAAI,KAAK,OAAO;YAAE,SAAS;QAE/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,MAAM;oBACN,KAAK,CAAC,SAAS;wBACb,OAAO,IAAI,CAAC;oBACd,CAAC;oBACD,KAAK,CAAC,OAAO;wBACX,OAAO,IAAI,CAAC;oBACd,CAAC;oBACD,KAAK,CAAC,OAAO;wBACX,OAAO,IAAI,CAAC;oBACd,CAAC;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;YACzD,SAAS;QACX,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,0BAA0B,CAAC;YACzD,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACtC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,6BAA6B,CACpC,IAAsB;IAEtB,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/content-handler-file.d.ts

@@ -0,0 +1,40 @@
+/**
+ * File drop content handler — processes dropped text-based files (JSON, XML,
+ * CSS, JavaScript, etc.) by extracting their text content and inserting it
+ * into the editor.
+ *
+ * Only handles drop events (not paste) to avoid conflicting with the plain
+ * text handler on paste. Uses the same newline-splitting pattern as the
+ * plain text handler.
+ *
+ * Priority: -105 (runs after plain text at -100, as a catch-all for dropped files).
+ *
+ * @module
+ */
+import type { ContentHandler } from './content-pipeline.js';
+/**
+ * Create a content handler for dropped text-based files.
+ *
+ * Accepts common text-based MIME types (`text/*`, `application/json`,
+ * `application/xml`, `application/javascript`) but only from drop events.
+ * Paste events are skipped via `canHandle` to avoid conflicting with the
+ * plain text handler.
+ *
+ * Extracts the file's text content and inserts it into the document,
+ * splitting on newlines to create separate blocks.
+ *
+ * Priority: -105 (lowest, runs after all other handlers).
+ *
+ * @returns A ContentHandler for dropped text files
+ *
+ * @example
+ * ```ts
+ * const handler = createFileDropHandler();
+ * pipeline.register(handler);
+ *
+ * // Dropping a .json file into the editor will extract its text content
+ * // and insert it as blocks, one per line.
+ * ```
+ */
+export declare function createFileDropHandler(): ContentHandler;
+//# sourceMappingURL=content-handler-file.d.ts.map

package/dist/content-handler-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-handler-file.d.ts","sourceRoot":"","sources":["../src/content-handler-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CA2DtD"}

package/dist/content-handler-file.js

@@ -0,0 +1,91 @@
+/**
+ * File drop content handler — processes dropped text-based files (JSON, XML,
+ * CSS, JavaScript, etc.) by extracting their text content and inserting it
+ * into the editor.
+ *
+ * Only handles drop events (not paste) to avoid conflicting with the plain
+ * text handler on paste. Uses the same newline-splitting pattern as the
+ * plain text handler.
+ *
+ * Priority: -105 (runs after plain text at -100, as a catch-all for dropped files).
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a content handler for dropped text-based files.
+ *
+ * Accepts common text-based MIME types (`text/*`, `application/json`,
+ * `application/xml`, `application/javascript`) but only from drop events.
+ * Paste events are skipped via `canHandle` to avoid conflicting with the
+ * plain text handler.
+ *
+ * Extracts the file's text content and inserts it into the document,
+ * splitting on newlines to create separate blocks.
+ *
+ * Priority: -105 (lowest, runs after all other handlers).
+ *
+ * @returns A ContentHandler for dropped text files
+ *
+ * @example
+ * ```ts
+ * const handler = createFileDropHandler();
+ * pipeline.register(handler);
+ *
+ * // Dropping a .json file into the editor will extract its text content
+ * // and insert it as blocks, one per line.
+ * ```
+ */
+export function createFileDropHandler() {
+    return {
+        id: 'rtif:file-drop',
+        accept: [
+            'text/*',
+            'application/json',
+            'application/xml',
+            'application/javascript',
+        ],
+        priority: -105,
+        async canHandle(item) {
+            return item.source === 'drop';
+        },
+        async handle(item, context) {
+            const file = await item.getFile();
+            if (file === null)
+                return false;
+            const text = await file.text();
+            if (text === '')
+                return false;
+            const insertOffset = context.deleteSelectionAndGetOffset();
+            const ops = [];
+            let currentOffset = insertOffset;
+            const lines = text.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (i > 0) {
+                    ops.push({
+                        type: 'split_block',
+                        offset: currentOffset,
+                        newBlockId: context.generateBlockId(),
+                    });
+                    currentOffset += 1;
+                }
+                if (line.length > 0) {
+                    ops.push({
+                        type: 'insert_text',
+                        offset: currentOffset,
+                        text: line,
+                    });
+                    currentOffset += line.length;
+                }
+            }
+            if (ops.length > 0) {
+                context.dispatch(ops);
+            }
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=content-handler-file.js.map

package/dist/content-handler-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-handler-file.js","sourceRoot":"","sources":["../src/content-handler-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,MAAM,EAAE;YACN,QAAQ;YACR,kBAAkB;YAClB,iBAAiB;YACjB,wBAAwB;SACzB;QACD,QAAQ,EAAE,CAAC,GAAG;QAEd,KAAK,CAAC,SAAS,CAAC,IAAiB;YAC/B,OAAO,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,MAAM,CACV,IAAiB,EACjB,OAAuB;YAEvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAEhC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;YAE9B,MAAM,YAAY,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC;YAC3D,MAAM,GAAG,GAAgB,EAAE,CAAC;YAC5B,IAAI,aAAa,GAAG,YAAY,CAAC;YAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBAEvB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACV,GAAG,CAAC,IAAI,CAAC;wBACP,IAAI,EAAE,aAAa;wBACnB,MAAM,EAAE,aAAa;wBACrB,UAAU,EAAE,OAAO,CAAC,eAAe,EAAE;qBACtC,CAAC,CAAC;oBACH,aAAa,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,GAAG,CAAC,IAAI,CAAC;wBACP,IAAI,EAAE,aAAa;wBACnB,MAAM,EAAE,aAAa;wBACrB,IAAI,EAAE,IAAI;qBACX,CAAC,CAAC;oBACH,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/content-handler-image.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Image content handler — processes pasted/dropped image files into RTIF
+ * image blocks. Reads the file as a data URL for immediate display, with
+ * optional async upload to swap in a final URL.
+ *
+ * Priority: -85 (runs after RTIF JSON, before HTML and plain text).
+ *
+ * @module
+ */
+import type { ContentHandler } from './content-pipeline.js';
+/**
+ * Configuration for the image content handler.
+ *
+ * @example
+ * ```ts
+ * const handler = createImageContentHandler({
+ *   upload: async (file) => {
+ *     const url = await myUploadService.upload(file);
+ *     return url;
+ *   },
+ *   maxFileSize: 5 * 1024 * 1024, // 5 MB
+ * });
+ * ```
+ */
+export interface ImageContentHandlerConfig {
+    /**
+     * Upload function. Called after the image block is created with a data URL.
+     * Returns the final URL to replace the data URL. If omitted, the data URL
+     * is permanent.
+     *
+     * @param file - The image File object
+     * @returns The final URL for the image
+     */
+    readonly upload?: (file: File) => Promise<string>;
+    /**
+     * Maximum file size in bytes. Files exceeding this size are rejected
+     * (handler returns false). 0 or undefined means no limit.
+     *
+     * @example
+     * ```ts
+     * maxFileSize: 10 * 1024 * 1024 // 10 MB
+     * ```
+     */
+    readonly maxFileSize?: number;
+}
+/**
+ * Read a File as a data URL using FileReader.
+ *
+ * @param file - The file to read
+ * @returns A promise resolving to the data URL string
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await readFileAsDataUrl(imageFile);
+ * // "data:image/png;base64,iVBOR..."
+ * ```
+ */
+export declare function readFileAsDataUrl(file: File): Promise<string>;
+/**
+ * Create a content handler for image paste/drop.
+ *
+ * Accepts `image/*` content and converts it to an RTIF image block.
+ * Reads the file as a data URL for immediate display. If an `upload`
+ * function is provided, it is called after the block is created to
+ * swap the data URL for a final URL.
+ *
+ * Priority: -85 (between RTIF JSON at -80 and HTML at -90).
+ *
+ * @param config - Optional configuration for upload and file size limits
+ * @returns A ContentHandler for image files
+ *
+ * @example
+ * ```ts
+ * const handler = createImageContentHandler({
+ *   upload: async (file) => uploadToS3(file),
+ *   maxFileSize: 5 * 1024 * 1024,
+ * });
+ * pipeline.register(handler);
+ * ```
+ */
+export declare function createImageContentHandler(config?: ImageContentHandlerConfig): ContentHandler;
+//# sourceMappingURL=content-handler-image.d.ts.map

package/dist/content-handler-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-handler-image.d.ts","sourceRoot":"","sources":["../src/content-handler-image.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7D;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,yBAAyB,GACjC,cAAc,CAyEhB"}

package/dist/content-handler-image.js

@@ -0,0 +1,120 @@
+/**
+ * Image content handler — processes pasted/dropped image files into RTIF
+ * image blocks. Reads the file as a data URL for immediate display, with
+ * optional async upload to swap in a final URL.
+ *
+ * Priority: -85 (runs after RTIF JSON, before HTML and plain text).
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Read a File as a data URL using FileReader.
+ *
+ * @param file - The file to read
+ * @returns A promise resolving to the data URL string
+ *
+ * @example
+ * ```ts
+ * const dataUrl = await readFileAsDataUrl(imageFile);
+ * // "data:image/png;base64,iVBOR..."
+ * ```
+ */
+export function readFileAsDataUrl(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(reader.error);
+        reader.readAsDataURL(file);
+    });
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a content handler for image paste/drop.
+ *
+ * Accepts `image/*` content and converts it to an RTIF image block.
+ * Reads the file as a data URL for immediate display. If an `upload`
+ * function is provided, it is called after the block is created to
+ * swap the data URL for a final URL.
+ *
+ * Priority: -85 (between RTIF JSON at -80 and HTML at -90).
+ *
+ * @param config - Optional configuration for upload and file size limits
+ * @returns A ContentHandler for image files
+ *
+ * @example
+ * ```ts
+ * const handler = createImageContentHandler({
+ *   upload: async (file) => uploadToS3(file),
+ *   maxFileSize: 5 * 1024 * 1024,
+ * });
+ * pipeline.register(handler);
+ * ```
+ */
+export function createImageContentHandler(config) {
+    return {
+        id: 'rtif:image',
+        accept: ['image/*'],
+        priority: -85,
+        async handle(item, context) {
+            const file = await item.getFile();
+            if (file === null)
+                return false;
+            // Validate file size
+            if (config?.maxFileSize && config.maxFileSize > 0) {
+                if (file.size > config.maxFileSize)
+                    return false;
+            }
+            // Read image as data URL
+            const dataUrl = await readFileAsDataUrl(file);
+            // Delete selection and get insert offset
+            const insertOffset = context.deleteSelectionAndGetOffset();
+            // Generate block IDs
+            const imageBlockId = context.generateBlockId();
+            const trailingBlockId = context.generateBlockId();
+            // Compose operations:
+            // 1. Split at cursor → trailing text goes to imageBlockId
+            // 2. Split at start of imageBlockId → trailing text goes to trailingBlockId
+            // 3. Set imageBlockId type to 'image'
+            // 4. Set imageBlockId attrs with src and alt
+            const ops = [
+                { type: 'split_block', offset: insertOffset, newBlockId: imageBlockId },
+                { type: 'split_block', offset: insertOffset + 1, newBlockId: trailingBlockId },
+                { type: 'set_block_type', blockId: imageBlockId, blockType: 'image' },
+                {
+                    type: 'set_block_attrs',
+                    blockId: imageBlockId,
+                    attrs: { src: dataUrl, alt: file.name },
+                },
+            ];
+            context.dispatch(ops);
+            // Fire-and-forget upload if configured
+            if (config?.upload) {
+                const engine = context.engine;
+                void (async () => {
+                    try {
+                        const finalUrl = await config.upload(file);
+                        // Guard: verify block still exists and is still an image
+                        const block = engine.state.doc.blocks.find((b) => b.id === imageBlockId);
+                        if (!block || block.type !== 'image')
+                            return;
+                        engine.dispatch({
+                            type: 'set_block_attrs',
+                            blockId: imageBlockId,
+                            attrs: { src: finalUrl },
+                        });
+                    }
+                    catch {
+                        // Upload failed — keep the data URL. Silently swallow the error.
+                    }
+                })();
+            }
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=content-handler-image.js.map

package/dist/content-handler-image.js.map

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