@lionrapid/core 0.1.0

package/dist/content/parser/MarkupParser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Markup parser for converting HTML strings to ContentUnit
+ * @module content/parser/MarkupParser
+ */
+import type { IParser } from './IParser.js';
+import type { ContentUnit } from '../types.js';
+import type { IStyleMapper } from '../style-mapper/IStyleMapper.js';
+/**
+ * Configuration options for MarkupParser
+ */
+export interface MarkupParserOptions {
+    /**
+     * Custom style mapper for element ↔ style conversion
+     * Defaults to DefaultStyleMapper
+     */
+    styleMapper?: IStyleMapper;
+}
+/**
+ * Parser that converts HTML markup strings to ContentUnit format
+ *
+ * Transforms inline HTML elements into indexed tags with style mapping:
+ * - `<b>bold</b>` → text: `<1>bold</1>`, styles: `{"1": ["bold"]}`
+ * - `<a href="/url">link</a>` → styles: `{"1": ["hyperlink:/url"]}`
+ *
+ * @example
+ * ```typescript
+ * const parser = new MarkupParser();
+ *
+ * const unit = parser.parse('Read our <b>Terms</b>.');
+ * // → { text: "Read our <1>Terms</1>.", styles: {"1": ["bold"]} }
+ *
+ * const nested = parser.parse('<b>bold <i>and italic</i></b>');
+ * // → { text: "<1>bold <2>and italic</2></1>", styles: {"1": ["bold"], "2": ["italic"]} }
+ * ```
+ */
+export declare class MarkupParser implements IParser<string> {
+    private readonly styleMapper;
+    constructor(options?: MarkupParserOptions);
+    /**
+     * Parse HTML string into ContentUnit
+     *
+     * Handles two input formats:
+     * 1. HTML tags: `<b>text</b>` → converts to indexed `<1>text</1>` with styles
+     * 2. Already indexed: `<1>text</1>` → passes through as-is (from server)
+     *
+     * @param input - HTML string with inline elements or already indexed
+     * @returns ContentUnit with indexed tags and styles
+     */
+    parse(input: string): ContentUnit;
+    /**
+     * Match an HTML tag at the given position
+     */
+    private matchTag;
+    /**
+     * Parse HTML attributes string into key-value pairs
+     */
+    private parseAttributes;
+    /**
+     * Find matching opening tag in the stack
+     */
+    private findMatchingOpenTag;
+    /**
+     * Find the closing tag index for a given opening tag
+     */
+    private findClosingTagIndex;
+}
+//# sourceMappingURL=MarkupParser.d.ts.map

package/dist/content/parser/MarkupParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkupParser.d.ts","sourceRoot":"","sources":["../../../src/content/parser/MarkupParser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAaD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,YAAW,OAAO,CAAC,MAAM,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,OAAO,GAAE,mBAAwB;IAI7C;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAuIjC;;OAEG;IACH,OAAO,CAAC,QAAQ;IA0ChB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA6B5B"}

package/dist/content/parser/MarkupParser.js

@@ -0,0 +1,231 @@
+/**
+ * Markup parser for converting HTML strings to ContentUnit
+ * @module content/parser/MarkupParser
+ */
+import { DefaultStyleMapper } from '../style-mapper/DefaultStyleMapper.js';
+/**
+ * Parser that converts HTML markup strings to ContentUnit format
+ *
+ * Transforms inline HTML elements into indexed tags with style mapping:
+ * - `<b>bold</b>` → text: `<1>bold</1>`, styles: `{"1": ["bold"]}`
+ * - `<a href="/url">link</a>` → styles: `{"1": ["hyperlink:/url"]}`
+ *
+ * @example
+ * ```typescript
+ * const parser = new MarkupParser();
+ *
+ * const unit = parser.parse('Read our <b>Terms</b>.');
+ * // → { text: "Read our <1>Terms</1>.", styles: {"1": ["bold"]} }
+ *
+ * const nested = parser.parse('<b>bold <i>and italic</i></b>');
+ * // → { text: "<1>bold <2>and italic</2></1>", styles: {"1": ["bold"], "2": ["italic"]} }
+ * ```
+ */
+export class MarkupParser {
+    styleMapper;
+    constructor(options = {}) {
+        this.styleMapper = options.styleMapper ?? new DefaultStyleMapper();
+    }
+    /**
+     * Parse HTML string into ContentUnit
+     *
+     * Handles two input formats:
+     * 1. HTML tags: `<b>text</b>` → converts to indexed `<1>text</1>` with styles
+     * 2. Already indexed: `<1>text</1>` → passes through as-is (from server)
+     *
+     * @param input - HTML string with inline elements or already indexed
+     * @returns ContentUnit with indexed tags and styles
+     */
+    parse(input) {
+        // Check if input already uses indexed tags (from server)
+        // Pattern: <1>, </1>, <2>, </2>, etc.
+        const hasIndexedTags = /<\/?[0-9]+>/.test(input);
+        if (hasIndexedTags) {
+            // Input already has indexed tags - pass through without style mapping
+            // The styles will come from component children in Trans, not from server
+            return {
+                text: input,
+                styles: {}, // Empty - styles determined by children
+            };
+        }
+        const styles = {};
+        let tagIndex = 0;
+        // Stack to track open tags and their indices
+        const tagStack = [];
+        // Result text being built
+        let result = '';
+        let pos = 0;
+        while (pos < input.length) {
+            // Look for opening tag
+            const tagMatch = this.matchTag(input, pos);
+            if (!tagMatch) {
+                // No more tags, append rest of string
+                result += input.slice(pos);
+                break;
+            }
+            // Append text before tag
+            result += input.slice(pos, tagMatch.startIndex);
+            if (tagMatch.isClosing) {
+                // Closing tag - find matching opening tag
+                const matchingOpen = this.findMatchingOpenTag(tagStack, tagMatch.tag.toLowerCase());
+                if (matchingOpen !== null) {
+                    result += `</${matchingOpen}>`;
+                    // Remove from stack
+                    const stackIndex = tagStack.findIndex((t) => t.index === matchingOpen);
+                    if (stackIndex !== -1) {
+                        tagStack.splice(stackIndex, 1);
+                    }
+                }
+                else {
+                    // Unmatched closing tag - keep as-is (will be validated later)
+                    result += input.slice(tagMatch.startIndex, tagMatch.endIndex);
+                }
+            }
+            else if (tagMatch.isSelfClosing) {
+                // Self-closing tag - assign index but no content
+                tagIndex++;
+                const styleList = this.styleMapper.mapElementToStyles(tagMatch.tag, tagMatch.attrs);
+                if (styleList.length > 0) {
+                    styles[String(tagIndex)] = styleList;
+                    result += `<${tagIndex}/>`;
+                }
+                // If no styles mapped, skip the tag entirely
+            }
+            else {
+                // Opening tag
+                const styleList = this.styleMapper.mapElementToStyles(tagMatch.tag, tagMatch.attrs);
+                if (styleList.length > 0) {
+                    tagIndex++;
+                    styles[String(tagIndex)] = styleList;
+                    result += `<${tagIndex}>`;
+                    tagStack.push({ tag: tagMatch.tag.toLowerCase(), index: tagIndex });
+                }
+                else {
+                    // Unknown element - don't index it, just process content
+                    // We need to find the closing tag and process content
+                    const closingIndex = this.findClosingTagIndex(input, tagMatch.endIndex, tagMatch.tag);
+                    if (closingIndex !== -1) {
+                        // Recursively parse content
+                        const innerContent = input.slice(tagMatch.endIndex, closingIndex);
+                        const innerUnit = this.parse(innerContent);
+                        // Merge inner styles (adjusting indices based on current tagIndex)
+                        const baseIndex = tagIndex;
+                        for (const [key, value] of Object.entries(innerUnit.styles)) {
+                            const adjustedKey = String(baseIndex + parseInt(key, 10));
+                            styles[adjustedKey] = value;
+                        }
+                        // Adjust result and indices
+                        result += innerUnit.text.replace(/<(\/?)\d+>/g, (match, slash) => {
+                            const num = parseInt(match.replace(/[</>]/g, ''), 10);
+                            return `<${slash}${baseIndex + num}>`;
+                        });
+                        // Move position past closing tag
+                        const closingMatch = this.matchTag(input, closingIndex);
+                        pos = closingMatch ? closingMatch.endIndex : closingIndex;
+                        // Adjust tagIndex to account for inner tags
+                        const maxInnerIndex = Object.keys(innerUnit.styles).length > 0
+                            ? Math.max(...Object.keys(innerUnit.styles).map(Number))
+                            : 0;
+                        tagIndex = baseIndex + maxInnerIndex;
+                        continue;
+                    }
+                }
+            }
+            pos = tagMatch.endIndex;
+        }
+        // Handle unclosed tags (add closing tags in reverse order)
+        while (tagStack.length > 0) {
+            const unclosed = tagStack.pop();
+            result += `</${unclosed.index}>`;
+        }
+        return {
+            text: result,
+            styles,
+        };
+    }
+    /**
+     * Match an HTML tag at the given position
+     */
+    matchTag(input, startPos) {
+        // Find next '<' from startPos
+        const tagStart = input.indexOf('<', startPos);
+        if (tagStart === -1)
+            return null;
+        // Match tag pattern: <tagname attrs> or </tagname> or <tagname/>
+        const tagPattern = /^<(\/?)([a-zA-Z][a-zA-Z0-9]*)((?:\s+[a-zA-Z][a-zA-Z0-9-]*(?:=(?:"[^"]*"|'[^']*'|[^\s>]*))?)*)\s*(\/?)>/;
+        const remaining = input.slice(tagStart);
+        const match = remaining.match(tagPattern);
+        if (!match) {
+            // Not a valid tag, skip this '<' and try again
+            if (tagStart + 1 < input.length) {
+                return this.matchTag(input, tagStart + 1);
+            }
+            return null;
+        }
+        const [fullMatch, closingSlash, tagName, attrsString, selfClosingSlash] = match;
+        return {
+            tag: tagName,
+            attrs: this.parseAttributes(attrsString),
+            isClosing: closingSlash === '/',
+            isSelfClosing: selfClosingSlash === '/',
+            startIndex: tagStart,
+            endIndex: tagStart + fullMatch.length,
+        };
+    }
+    /**
+     * Parse HTML attributes string into key-value pairs
+     */
+    parseAttributes(attrsString) {
+        const attrs = {};
+        if (!attrsString.trim())
+            return attrs;
+        // Match attribute patterns: name="value" or name='value' or name=value or name
+        const attrPattern = /([a-zA-Z][a-zA-Z0-9-]*)(?:=(?:"([^"]*)"|'([^']*)'|([^\s>]*)))?/g;
+        let match;
+        while ((match = attrPattern.exec(attrsString)) !== null) {
+            const [, name, doubleQuoted, singleQuoted, unquoted] = match;
+            const value = doubleQuoted ?? singleQuoted ?? unquoted ?? '';
+            attrs[name.toLowerCase()] = value;
+        }
+        return attrs;
+    }
+    /**
+     * Find matching opening tag in the stack
+     */
+    findMatchingOpenTag(stack, tagName) {
+        // Search from end of stack (most recent)
+        for (let i = stack.length - 1; i >= 0; i--) {
+            if (stack[i].tag === tagName) {
+                return stack[i].index;
+            }
+        }
+        return null;
+    }
+    /**
+     * Find the closing tag index for a given opening tag
+     */
+    findClosingTagIndex(input, startPos, tagName) {
+        const lowerTag = tagName.toLowerCase();
+        let depth = 1;
+        let pos = startPos;
+        while (pos < input.length && depth > 0) {
+            const tagMatch = this.matchTag(input, pos);
+            if (!tagMatch)
+                break;
+            if (tagMatch.tag.toLowerCase() === lowerTag) {
+                if (tagMatch.isClosing) {
+                    depth--;
+                    if (depth === 0) {
+                        return tagMatch.startIndex;
+                    }
+                }
+                else if (!tagMatch.isSelfClosing) {
+                    depth++;
+                }
+            }
+            pos = tagMatch.endIndex;
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=MarkupParser.js.map

package/dist/content/parser/MarkupParser.js.map

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

package/dist/content/serializer/HTMLSerializer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * HTML serializer for converting ContentUnit to HTML strings
+ * @module content/serializer/HTMLSerializer
+ */
+import type { ISerializer } from './ISerializer.js';
+import type { ContentUnit } from '../types.js';
+import type { IStyleMapper } from '../style-mapper/IStyleMapper.js';
+/**
+ * Configuration options for HTMLSerializer
+ */
+export interface HTMLSerializerOptions {
+    /**
+     * Custom style mapper for styles → element conversion
+     * Defaults to DefaultStyleMapper
+     */
+    styleMapper?: IStyleMapper;
+}
+/**
+ * Serializer that converts ContentUnit format back to HTML strings
+ *
+ * Transforms indexed tags and style mappings into HTML:
+ * - `<1>bold</1>` with styles `{"1": ["bold"]}` → `<b>bold</b>`
+ * - `<1>link</1>` with styles `{"1": ["hyperlink:/url"]}` → `<a href="/url">link</a>`
+ *
+ * @example
+ * ```typescript
+ * const serializer = new HTMLSerializer();
+ *
+ * const html = serializer.serialize({
+ *   text: 'Read our <1>Terms</1>.',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → "Read our <b>Terms</b>."
+ *
+ * const link = serializer.serialize({
+ *   text: 'Click <1>here</1>.',
+ *   styles: { '1': ['hyperlink:/url'] }
+ * });
+ * // → "Click <a href=\"/url\">here</a>."
+ * ```
+ */
+export declare class HTMLSerializer implements ISerializer<string> {
+    private readonly styleMapper;
+    constructor(options?: HTMLSerializerOptions);
+    /**
+     * Serialize ContentUnit to HTML string
+     *
+     * @param unit - ContentUnit with indexed tags and styles
+     * @returns HTML string with semantic elements
+     */
+    serialize(unit: ContentUnit): string;
+    /**
+     * Format attributes object into HTML attribute string
+     */
+    private formatAttributes;
+    /**
+     * Escape special characters in attribute values
+     */
+    private escapeAttributeValue;
+}
+//# sourceMappingURL=HTMLSerializer.d.ts.map

package/dist/content/serializer/HTMLSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTMLSerializer.d.ts","sourceRoot":"","sources":["../../../src/content/serializer/HTMLSerializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,YAAW,WAAW,CAAC,MAAM,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,OAAO,GAAE,qBAA0B;IAI/C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IA2CpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/content/serializer/HTMLSerializer.js

@@ -0,0 +1,100 @@
+/**
+ * HTML serializer for converting ContentUnit to HTML strings
+ * @module content/serializer/HTMLSerializer
+ */
+import { DefaultStyleMapper } from '../style-mapper/DefaultStyleMapper.js';
+/**
+ * Serializer that converts ContentUnit format back to HTML strings
+ *
+ * Transforms indexed tags and style mappings into HTML:
+ * - `<1>bold</1>` with styles `{"1": ["bold"]}` → `<b>bold</b>`
+ * - `<1>link</1>` with styles `{"1": ["hyperlink:/url"]}` → `<a href="/url">link</a>`
+ *
+ * @example
+ * ```typescript
+ * const serializer = new HTMLSerializer();
+ *
+ * const html = serializer.serialize({
+ *   text: 'Read our <1>Terms</1>.',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → "Read our <b>Terms</b>."
+ *
+ * const link = serializer.serialize({
+ *   text: 'Click <1>here</1>.',
+ *   styles: { '1': ['hyperlink:/url'] }
+ * });
+ * // → "Click <a href=\"/url\">here</a>."
+ * ```
+ */
+export class HTMLSerializer {
+    styleMapper;
+    constructor(options = {}) {
+        this.styleMapper = options.styleMapper ?? new DefaultStyleMapper();
+    }
+    /**
+     * Serialize ContentUnit to HTML string
+     *
+     * @param unit - ContentUnit with indexed tags and styles
+     * @returns HTML string with semantic elements
+     */
+    serialize(unit) {
+        const { text, styles } = unit;
+        // Pattern to match indexed tags: <1>, </1>, <1/>
+        const tagPattern = /<(\/?)?(\d+)(\/)?>/g;
+        let result = '';
+        let lastIndex = 0;
+        let match;
+        while ((match = tagPattern.exec(text)) !== null) {
+            // Append text before the tag
+            result += text.slice(lastIndex, match.index);
+            const [fullMatch, closingSlash, indexStr, selfClosingSlash] = match;
+            const tagIndex = indexStr;
+            const styleList = styles[tagIndex] || [];
+            if (closingSlash) {
+                // Closing tag: </1>
+                const mapping = this.styleMapper.mapStylesToElement(styleList);
+                result += `</${mapping.element}>`;
+            }
+            else if (selfClosingSlash) {
+                // Self-closing tag: <1/>
+                const mapping = this.styleMapper.mapStylesToElement(styleList);
+                const attrs = this.formatAttributes(mapping.attrs);
+                result += `<${mapping.element}${attrs} />`;
+            }
+            else {
+                // Opening tag: <1>
+                const mapping = this.styleMapper.mapStylesToElement(styleList);
+                const attrs = this.formatAttributes(mapping.attrs);
+                result += `<${mapping.element}${attrs}>`;
+            }
+            lastIndex = match.index + fullMatch.length;
+        }
+        // Append remaining text
+        result += text.slice(lastIndex);
+        return result;
+    }
+    /**
+     * Format attributes object into HTML attribute string
+     */
+    formatAttributes(attrs) {
+        const entries = Object.entries(attrs);
+        if (entries.length === 0)
+            return '';
+        return (' ' +
+            entries
+                .map(([key, value]) => `${key}="${this.escapeAttributeValue(value)}"`)
+                .join(' '));
+    }
+    /**
+     * Escape special characters in attribute values
+     */
+    escapeAttributeValue(value) {
+        return value
+            .replace(/&/g, '&amp;')
+            .replace(/"/g, '&quot;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;');
+    }
+}
+//# sourceMappingURL=HTMLSerializer.js.map

package/dist/content/serializer/HTMLSerializer.js.map

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

package/dist/content/serializer/ISerializer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Serializer interface for converting ContentUnit to platform-specific output
+ * @module content/serializer/ISerializer
+ */
+import type { ContentUnit } from '../types.js';
+/**
+ * Generic serializer interface
+ *
+ * Implementations:
+ * - HTMLSerializer: ContentUnit → HTML string (core)
+ * - JSXSerializer: ContentUnit → ReactNode (react package)
+ *
+ * @typeParam TOutput - Platform-specific output type
+ *
+ * @example
+ * ```typescript
+ * class HTMLSerializer implements ISerializer<string> {
+ *   serialize(unit: ContentUnit): string {
+ *     // Convert indexed tags back to <b>, <a>, etc.
+ *   }
+ * }
+ * ```
+ */
+export interface ISerializer<TOutput> {
+    /**
+     * Serialize ContentUnit to platform-specific output
+     *
+     * @param unit - The ContentUnit to serialize
+     * @returns Platform-specific output (HTML string, ReactNode, etc.)
+     */
+    serialize(unit: ContentUnit): TOutput;
+}
+//# sourceMappingURL=ISerializer.d.ts.map

package/dist/content/serializer/ISerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISerializer.d.ts","sourceRoot":"","sources":["../../../src/content/serializer/ISerializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO;IAClC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;CACvC"}

package/dist/content/serializer/ISerializer.js

@@ -0,0 +1,6 @@
+/**
+ * Serializer interface for converting ContentUnit to platform-specific output
+ * @module content/serializer/ISerializer
+ */
+export {};
+//# sourceMappingURL=ISerializer.js.map

package/dist/content/serializer/ISerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISerializer.js","sourceRoot":"","sources":["../../../src/content/serializer/ISerializer.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/content/style-mapper/DefaultStyleMapper.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Default style mapper for bidirectional HTML element ↔ style property mapping
+ * @module content/style-mapper/DefaultStyleMapper
+ */
+import type { IStyleMapper, ElementMapping } from './IStyleMapper.js';
+/**
+ * Default implementation of style mapping
+ *
+ * Provides bidirectional conversion between HTML elements and style properties:
+ * - mapElementToStyles: `<b>` → `["bold"]`
+ * - mapStylesToElement: `["bold"]` → `<b>`
+ *
+ * @example
+ * ```typescript
+ * const mapper = new DefaultStyleMapper();
+ *
+ * // Parsing: HTML → styles
+ * mapper.mapElementToStyles('a', { href: '/terms' });
+ * // → ["hyperlink:/terms"]
+ *
+ * // Serializing: styles → HTML
+ * mapper.mapStylesToElement(['bold', 'hyperlink:/terms']);
+ * // → { element: 'a', attrs: { href: '/terms' } }
+ * ```
+ */
+export declare class DefaultStyleMapper implements IStyleMapper {
+    /**
+     * Element → Style mapping
+     * Maps HTML element names to their style property
+     */
+    private readonly elementToStyles;
+    /**
+     * Style → Element mapping (reverse)
+     * Uses simple, familiar elements for developer convenience
+     * Also accepts element names directly (strong, em, etc.)
+     */
+    private readonly styleToElement;
+    /**
+     * Convert HTML element to style properties
+     *
+     * @param element - Tag name (e.g., "b", "a", "strong")
+     * @param attrs - Element attributes (e.g., { href: "/url" })
+     * @returns Array of style strings
+     */
+    mapElementToStyles(element: string, attrs: Record<string, string>): string[];
+    /**
+     * Convert style properties to HTML element
+     *
+     * Priority order:
+     * 1. Hyperlink (becomes wrapper element with href)
+     * 2. First recognized style property
+     * 3. Fallback to span
+     *
+     * @param styles - Array of style strings
+     * @returns Element info for serialization
+     */
+    mapStylesToElement(styles: string[]): ElementMapping;
+}
+//# sourceMappingURL=DefaultStyleMapper.d.ts.map

package/dist/content/style-mapper/DefaultStyleMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultStyleMapper.d.ts","sourceRoot":"","sources":["../../../src/content/style-mapper/DefaultStyleMapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAa9B;IAEF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAsB7B;IAEF;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE;IAkB5E;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc;CAyBrD"}