@rtif-sdk/web 1.0.0

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

@@ -0,0 +1,129 @@
+/**
+ * URL content handler — processes pasted URLs into RTIF links or embed blocks.
+ *
+ * Three paths:
+ * - **Path A**: Selection exists → wrap selected text as a link with the pasted URL
+ * - **Path B**: No selection + autoEmbed + embeddable URL → create an embed block
+ * - **Path C**: No selection + plain URL → insert URL as linked text
+ *
+ * Priority: -95 (runs after HTML, before plain text). Uses `canHandle` to
+ * distinguish URLs from regular text — non-URLs fall through to the plain
+ * text handler.
+ *
+ * @module
+ */
+import type { ContentHandler } from './content-pipeline.js';
+/**
+ * An embed URL matcher — maps a URL pattern to an embed type.
+ *
+ * @example
+ * ```ts
+ * const matcher: EmbedUrlMatcher = {
+ *   pattern: /^https?:\/\/(?:www\.)?youtube\.com\/watch\?v=[\w-]+/,
+ *   type: 'video',
+ * };
+ * ```
+ */
+export interface EmbedUrlMatcher {
+    /** Regex pattern tested against the URL. */
+    readonly pattern: RegExp;
+    /** The embed type to use when the pattern matches. */
+    readonly type: 'video' | 'tweet' | 'generic';
+}
+/**
+ * Configuration for the URL content handler.
+ *
+ * @example
+ * ```ts
+ * const handler = createUrlContentHandler({
+ *   autoEmbed: true,
+ *   embedPatterns: [
+ *     { pattern: /^https?:\/\/example\.com\/video\/\d+/, type: 'video' },
+ *   ],
+ * });
+ * ```
+ */
+export interface UrlContentHandlerConfig {
+    /**
+     * Auto-embed recognized URLs (YouTube, Vimeo, Twitter).
+     * Default: false — URLs are inserted as linked text.
+     */
+    readonly autoEmbed?: boolean;
+    /**
+     * Additional embed patterns beyond built-in ones.
+     * Merged with built-in patterns during matching.
+     */
+    readonly embedPatterns?: readonly EmbedUrlMatcher[];
+}
+/**
+ * Built-in URL patterns for recognized embeddable services.
+ *
+ * Matches YouTube (watch + short URLs), Vimeo, and Twitter/X status URLs.
+ *
+ * @example
+ * ```ts
+ * import { BUILTIN_EMBED_PATTERNS, matchEmbedUrl } from '@rtif-sdk/web';
+ *
+ * const match = matchEmbedUrl('https://youtube.com/watch?v=abc123', BUILTIN_EMBED_PATTERNS);
+ * // match?.type === 'video'
+ * ```
+ */
+export declare const BUILTIN_EMBED_PATTERNS: readonly EmbedUrlMatcher[];
+/**
+ * Check whether a string is a valid HTTP/HTTPS URL.
+ *
+ * Returns false for multi-line strings, non-HTTP protocols, and invalid URLs.
+ *
+ * @param text - The text to check
+ * @returns true if the text is a valid HTTP or HTTPS URL
+ *
+ * @example
+ * ```ts
+ * isValidUrl('https://example.com');  // true
+ * isValidUrl('not a url');            // false
+ * isValidUrl('ftp://files.com');      // false
+ * isValidUrl('https://a.com\nmore'); // false
+ * ```
+ */
+export declare function isValidUrl(text: string): boolean;
+/**
+ * Match a URL against an array of embed patterns.
+ *
+ * Returns the first matching pattern, or null if no pattern matches.
+ *
+ * @param url - The URL to match
+ * @param patterns - Array of embed patterns to test
+ * @returns The matching pattern, or null
+ *
+ * @example
+ * ```ts
+ * const match = matchEmbedUrl('https://youtube.com/watch?v=abc', BUILTIN_EMBED_PATTERNS);
+ * // match?.type === 'video'
+ * ```
+ */
+export declare function matchEmbedUrl(url: string, patterns: readonly EmbedUrlMatcher[]): EmbedUrlMatcher | null;
+/**
+ * Create a content handler for URL paste.
+ *
+ * Accepts `text/plain` and `text/uri-list` content. Uses `canHandle` to
+ * distinguish URLs from regular text — non-URLs return false and fall through
+ * to the plain text handler.
+ *
+ * Three behaviors:
+ * - **Selection + URL**: Wraps the selected text as a link
+ * - **No selection + autoEmbed + recognized URL**: Creates an embed block
+ * - **No selection + URL**: Inserts the URL as linked text
+ *
+ * Priority: -95 (between HTML at -90 and plain text at -100).
+ *
+ * @param config - Optional configuration for auto-embed behavior
+ * @returns A ContentHandler for URLs
+ *
+ * @example
+ * ```ts
+ * const handler = createUrlContentHandler({ autoEmbed: true });
+ * pipeline.register(handler);
+ * ```
+ */
+export declare function createUrlContentHandler(config?: UrlContentHandlerConfig): ContentHandler;
+//# sourceMappingURL=content-handler-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-handler-url.d.ts","sourceRoot":"","sources":["../src/content-handler-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACrD;AAMD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAK5D,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,eAAe,GAAG,IAAI,CAKxB;AA0BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,uBAAuB,GAC/B,cAAc,CA0HhB"}

package/dist/content-handler-url.js

@@ -0,0 +1,244 @@
+/**
+ * URL content handler — processes pasted URLs into RTIF links or embed blocks.
+ *
+ * Three paths:
+ * - **Path A**: Selection exists → wrap selected text as a link with the pasted URL
+ * - **Path B**: No selection + autoEmbed + embeddable URL → create an embed block
+ * - **Path C**: No selection + plain URL → insert URL as linked text
+ *
+ * Priority: -95 (runs after HTML, before plain text). Uses `canHandle` to
+ * distinguish URLs from regular text — non-URLs fall through to the plain
+ * text handler.
+ *
+ * @module
+ */
+import { resolve } from '@rtif-sdk/core';
+// ---------------------------------------------------------------------------
+// Built-in embed patterns
+// ---------------------------------------------------------------------------
+/**
+ * Built-in URL patterns for recognized embeddable services.
+ *
+ * Matches YouTube (watch + short URLs), Vimeo, and Twitter/X status URLs.
+ *
+ * @example
+ * ```ts
+ * import { BUILTIN_EMBED_PATTERNS, matchEmbedUrl } from '@rtif-sdk/web';
+ *
+ * const match = matchEmbedUrl('https://youtube.com/watch?v=abc123', BUILTIN_EMBED_PATTERNS);
+ * // match?.type === 'video'
+ * ```
+ */
+export const BUILTIN_EMBED_PATTERNS = [
+    { pattern: /^https?:\/\/(?:www\.)?youtube\.com\/watch\?v=[\w-]+/, type: 'video' },
+    { pattern: /^https?:\/\/youtu\.be\/[\w-]+/, type: 'video' },
+    { pattern: /^https?:\/\/(?:www\.)?vimeo\.com\/\d+/, type: 'video' },
+    { pattern: /^https?:\/\/(?:www\.)?(?:twitter|x)\.com\/\w+\/status\/\d+/, type: 'tweet' },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a string is a valid HTTP/HTTPS URL.
+ *
+ * Returns false for multi-line strings, non-HTTP protocols, and invalid URLs.
+ *
+ * @param text - The text to check
+ * @returns true if the text is a valid HTTP or HTTPS URL
+ *
+ * @example
+ * ```ts
+ * isValidUrl('https://example.com');  // true
+ * isValidUrl('not a url');            // false
+ * isValidUrl('ftp://files.com');      // false
+ * isValidUrl('https://a.com\nmore'); // false
+ * ```
+ */
+export function isValidUrl(text) {
+    // Reject multi-line text
+    if (text.includes('\n') || text.includes('\r'))
+        return false;
+    try {
+        const url = new URL(text);
+        return url.protocol === 'http:' || url.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Match a URL against an array of embed patterns.
+ *
+ * Returns the first matching pattern, or null if no pattern matches.
+ *
+ * @param url - The URL to match
+ * @param patterns - Array of embed patterns to test
+ * @returns The matching pattern, or null
+ *
+ * @example
+ * ```ts
+ * const match = matchEmbedUrl('https://youtube.com/watch?v=abc', BUILTIN_EMBED_PATTERNS);
+ * // match?.type === 'video'
+ * ```
+ */
+export function matchEmbedUrl(url, patterns) {
+    for (const matcher of patterns) {
+        if (matcher.pattern.test(url))
+            return matcher;
+    }
+    return null;
+}
+/**
+ * Extract the first URL from a `text/uri-list` string.
+ *
+ * URI lists are newline-separated. Lines starting with `#` are comments.
+ * Returns the first non-comment, non-empty line, or null.
+ *
+ * @param text - The URI list text
+ * @returns The first URL, or null
+ */
+function extractFirstUri(text) {
+    const lines = text.split(/\r?\n/);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.length > 0 && !trimmed.startsWith('#')) {
+            return trimmed;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a content handler for URL paste.
+ *
+ * Accepts `text/plain` and `text/uri-list` content. Uses `canHandle` to
+ * distinguish URLs from regular text — non-URLs return false and fall through
+ * to the plain text handler.
+ *
+ * Three behaviors:
+ * - **Selection + URL**: Wraps the selected text as a link
+ * - **No selection + autoEmbed + recognized URL**: Creates an embed block
+ * - **No selection + URL**: Inserts the URL as linked text
+ *
+ * Priority: -95 (between HTML at -90 and plain text at -100).
+ *
+ * @param config - Optional configuration for auto-embed behavior
+ * @returns A ContentHandler for URLs
+ *
+ * @example
+ * ```ts
+ * const handler = createUrlContentHandler({ autoEmbed: true });
+ * pipeline.register(handler);
+ * ```
+ */
+export function createUrlContentHandler(config) {
+    const autoEmbed = config?.autoEmbed ?? false;
+    const customPatterns = config?.embedPatterns ?? [];
+    return {
+        id: 'rtif:url',
+        accept: ['text/plain', 'text/uri-list'],
+        priority: -95,
+        async canHandle(item) {
+            const text = await item.getString();
+            if (text === null || text === '')
+                return false;
+            // For text/uri-list, extract the first URI
+            if (item.type === 'text/uri-list') {
+                const firstUri = extractFirstUri(text);
+                return firstUri !== null && isValidUrl(firstUri);
+            }
+            return isValidUrl(text.trim());
+        },
+        async handle(item, context) {
+            const rawText = await item.getString();
+            if (rawText === null || rawText === '')
+                return false;
+            // Resolve the URL
+            let url;
+            if (item.type === 'text/uri-list') {
+                const firstUri = extractFirstUri(rawText);
+                if (firstUri === null)
+                    return false;
+                url = firstUri;
+            }
+            else {
+                url = rawText.trim();
+            }
+            if (!isValidUrl(url))
+                return false;
+            // -------------------------------------------------------------------
+            // Path A: Selection exists → wrap as link
+            // -------------------------------------------------------------------
+            const { selection } = context.engine.state;
+            const start = Math.min(selection.anchor.offset, selection.focus.offset);
+            const end = Math.max(selection.anchor.offset, selection.focus.offset);
+            if (start !== end) {
+                // Verify single-block selection
+                const doc = context.engine.state.doc;
+                try {
+                    const startResolved = resolve(doc, start);
+                    const endResolved = resolve(doc, end);
+                    if (startResolved.blockIndex === endResolved.blockIndex) {
+                        // Single-block selection — wrap as link
+                        const ops = [
+                            {
+                                type: 'set_span_marks',
+                                offset: start,
+                                count: end - start,
+                                marks: { link: { href: url } },
+                            },
+                        ];
+                        context.dispatch(ops);
+                        return true;
+                    }
+                }
+                catch {
+                    // Offset error — fall through to Path C
+                }
+                // Cross-block selection — fall through to Path C
+            }
+            // -------------------------------------------------------------------
+            // Path B: No selection + autoEmbed + recognized URL → embed block
+            // -------------------------------------------------------------------
+            if (autoEmbed) {
+                const allPatterns = [...BUILTIN_EMBED_PATTERNS, ...customPatterns];
+                const match = matchEmbedUrl(url, allPatterns);
+                if (match) {
+                    const insertOffset = context.deleteSelectionAndGetOffset();
+                    const embedBlockId = context.generateBlockId();
+                    const trailingBlockId = context.generateBlockId();
+                    const ops = [
+                        { type: 'split_block', offset: insertOffset, newBlockId: embedBlockId },
+                        { type: 'split_block', offset: insertOffset + 1, newBlockId: trailingBlockId },
+                        { type: 'set_block_type', blockId: embedBlockId, blockType: 'embed' },
+                        {
+                            type: 'set_block_attrs',
+                            blockId: embedBlockId,
+                            attrs: { url, embedType: match.type },
+                        },
+                    ];
+                    context.dispatch(ops);
+                    return true;
+                }
+            }
+            // -------------------------------------------------------------------
+            // Path C: Insert URL as linked text (default)
+            // -------------------------------------------------------------------
+            const insertOffset = context.deleteSelectionAndGetOffset();
+            const ops = [
+                { type: 'insert_text', offset: insertOffset, text: url },
+                {
+                    type: 'set_span_marks',
+                    offset: insertOffset,
+                    count: url.length,
+                    marks: { link: { href: url } },
+                },
+            ];
+            context.dispatch(ops);
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=content-handler-url.js.map

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

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

package/dist/content-handlers.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Built-in content handlers for the RTIF content pipeline.
+ *
+ * Provides handlers for:
+ * - Plain text (`text/plain`) — splits on newlines, creates blocks
+ * - RTIF JSON (`application/x-rtif+json`) — preserves marks and block attrs
+ * - HTML (`text/html`) — stub, falls through to plain text handler
+ *
+ * @module
+ */
+import type { ContentHandler } from './content-pipeline.js';
+/**
+ * Create a content handler for plain text paste/drop.
+ *
+ * Accepts `text/plain` content and converts it to RTIF operations by splitting
+ * on newlines. Each line becomes a separate block via `split_block`, with the
+ * text inserted via `insert_text`.
+ *
+ * Priority: -100 (lowest built-in, runs last as fallback).
+ *
+ * @param generateBlockId - Factory for generating unique block IDs
+ * @returns A ContentHandler for plain text
+ *
+ * @example
+ * ```ts
+ * const handler = createPlainTextHandler(() => crypto.randomUUID());
+ * pipeline.register(handler);
+ * ```
+ */
+export declare function createPlainTextHandler(generateBlockId: () => string): ContentHandler;
+/**
+ * Create a content handler for RTIF JSON paste.
+ *
+ * Accepts `application/x-rtif+json` content and preserves full formatting
+ * fidelity including span marks and block attributes. Parses the JSON payload,
+ * validates its structure, and generates the appropriate RTIF operations.
+ *
+ * Priority: -80 (highest built-in, runs before HTML and plain text).
+ *
+ * @param generateBlockId - Factory for generating unique block IDs
+ * @returns A ContentHandler for RTIF JSON paste
+ *
+ * @example
+ * ```ts
+ * const handler = createRtifPasteHandler(() => crypto.randomUUID());
+ * pipeline.register(handler);
+ * ```
+ */
+export declare function createRtifPasteHandler(generateBlockId: () => string): ContentHandler;
+/**
+ * Create a stub content handler for HTML paste.
+ *
+ * Currently always returns `false` (falls through to the plain text handler).
+ * Will be implemented when the `@rtif-sdk/format-html` plugin is available.
+ *
+ * Priority: -90 (between RTIF JSON and plain text).
+ *
+ * @returns A ContentHandler stub for HTML paste
+ *
+ * @example
+ * ```ts
+ * const handler = createHtmlPasteHandler();
+ * pipeline.register(handler);
+ * ```
+ */
+export declare function createHtmlPasteHandler(): ContentHandler;
+//# sourceMappingURL=content-handlers.d.ts.map

package/dist/content-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-handlers.d.ts","sourceRoot":"","sources":["../src/content-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,MAAM,GAC5B,cAAc,CA+ChB;AAcD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,MAAM,GAC5B,cAAc,CAyHhB;AAqDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CAevD"}