@lionrapid/core 0.1.0

package/dist/content/style-mapper/DefaultStyleMapper.js

@@ -0,0 +1,128 @@
+/**
+ * Default style mapper for bidirectional HTML element ↔ style property mapping
+ * @module content/style-mapper/DefaultStyleMapper
+ */
+/**
+ * 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 class DefaultStyleMapper {
+    /**
+     * Element → Style mapping
+     * Maps HTML element names to their style property
+     */
+    elementToStyles = {
+        b: 'bold',
+        strong: 'bold',
+        i: 'italic',
+        em: 'italic',
+        u: 'underline',
+        s: 'strikethrough',
+        del: 'strikethrough',
+        strike: 'strikethrough',
+        code: 'code',
+        mark: 'highlight',
+        sub: 'subscript',
+        sup: 'superscript',
+    };
+    /**
+     * Style → Element mapping (reverse)
+     * Uses simple, familiar elements for developer convenience
+     * Also accepts element names directly (strong, em, etc.)
+     */
+    styleToElement = {
+        // Semantic style names → simple elements
+        bold: 'b',
+        italic: 'i',
+        underline: 'u',
+        strikethrough: 's',
+        code: 'code',
+        highlight: 'mark',
+        subscript: 'sub',
+        superscript: 'sup',
+        // Element names (for servers that store styles as element names)
+        strong: 'b',
+        b: 'b',
+        em: 'i',
+        i: 'i',
+        u: 'u',
+        s: 's',
+        del: 's',
+        strike: 's',
+        mark: 'mark',
+        sub: 'sub',
+        sup: 'sup',
+    };
+    /**
+     * 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, attrs) {
+        const styles = [];
+        const tag = element.toLowerCase();
+        // Basic element mapping
+        const mappedStyle = this.elementToStyles[tag];
+        if (mappedStyle) {
+            styles.push(mappedStyle);
+        }
+        // Special: <a href="..."> → hyperlink:url
+        if (tag === 'a' && attrs.href) {
+            styles.push(`hyperlink:${attrs.href}`);
+        }
+        return styles;
+    }
+    /**
+     * 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) {
+        // Check for hyperlink first (takes priority as wrapper element)
+        for (const style of styles) {
+            if (style.startsWith('hyperlink:')) {
+                return {
+                    element: 'a',
+                    attrs: { href: style.slice('hyperlink:'.length) },
+                };
+            }
+        }
+        // Map first recognized style to element
+        for (const style of styles) {
+            const element = this.styleToElement[style];
+            if (element) {
+                return {
+                    element,
+                    attrs: {},
+                };
+            }
+        }
+        // Fallback: span with no special attributes
+        return { element: 'span', attrs: {} };
+    }
+}
+//# sourceMappingURL=DefaultStyleMapper.js.map

package/dist/content/style-mapper/DefaultStyleMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultStyleMapper.js","sourceRoot":"","sources":["../../../src/content/style-mapper/DefaultStyleMapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;OAGG;IACc,eAAe,GAA2B;QACzD,CAAC,EAAE,MAAM;QACT,MAAM,EAAE,MAAM;QACd,CAAC,EAAE,QAAQ;QACX,EAAE,EAAE,QAAQ;QACZ,CAAC,EAAE,WAAW;QACd,CAAC,EAAE,eAAe;QAClB,GAAG,EAAE,eAAe;QACpB,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,aAAa;KACnB,CAAC;IAEF;;;;OAIG;IACc,cAAc,GAA2B;QACxD,yCAAyC;QACzC,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,GAAG;QAClB,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,KAAK;QAClB,iEAAiE;QACjE,MAAM,EAAE,GAAG;QACX,CAAC,EAAE,GAAG;QACN,EAAE,EAAE,GAAG;QACP,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,GAAG;QACN,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;KACX,CAAC;IAEF;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAe,EAAE,KAA6B;QAC/D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAElC,wBAAwB;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;QAED,0CAA0C;QAC1C,IAAI,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,MAAgB;QACjC,gEAAgE;QAChE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,GAAG;oBACZ,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;iBAClD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,wCAAwC;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;oBACL,OAAO;oBACP,KAAK,EAAE,EAAE;iBACV,CAAC;YACJ,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,50 @@
+/**
+ * Style mapper interface for bidirectional HTML element ↔ style property mapping
+ * @module content/style-mapper/IStyleMapper
+ */
+/**
+ * Result of mapping styles to an HTML element
+ */
+export interface ElementMapping {
+    /**
+     * HTML element tag name (e.g., "b", "a", "span")
+     */
+    element: string;
+    /**
+     * HTML attributes (e.g., { href: "/terms" })
+     */
+    attrs: Record<string, string>;
+}
+/**
+ * Bidirectional mapper between HTML elements and style properties
+ *
+ * Used by:
+ * - MarkupParser: element → styles (parsing HTML)
+ * - HTMLSerializer: styles → element (generating HTML)
+ *
+ * @example
+ * ```typescript
+ * class DefaultStyleMapper implements IStyleMapper {
+ *   mapElementToStyles("a", { href: "/terms" }) // → ["hyperlink:/terms"]
+ *   mapStylesToElement(["bold", "hyperlink:/terms"]) // → { element: "a", attrs: { href: "/terms" } }
+ * }
+ * ```
+ */
+export interface IStyleMapper {
+    /**
+     * 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 (e.g., ["bold", "hyperlink:/url"])
+     */
+    mapElementToStyles(element: string, attrs: Record<string, string>): string[];
+    /**
+     * Convert style properties to HTML element
+     *
+     * @param styles - Array of style strings
+     * @returns Element info for serialization
+     */
+    mapStylesToElement(styles: string[]): ElementMapping;
+}
+//# sourceMappingURL=IStyleMapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IStyleMapper.d.ts","sourceRoot":"","sources":["../../../src/content/style-mapper/IStyleMapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IAE7E;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;CACtD"}

package/dist/content/style-mapper/IStyleMapper.js

@@ -0,0 +1,6 @@
+/**
+ * Style mapper interface for bidirectional HTML element ↔ style property mapping
+ * @module content/style-mapper/IStyleMapper
+ */
+export {};
+//# sourceMappingURL=IStyleMapper.js.map

package/dist/content/style-mapper/IStyleMapper.js.map

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

package/dist/content/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Core content types for the Unified Content Architecture
+ * @module content/types
+ */
+/**
+ * ContentUnit - Universal representation of styled translatable content
+ *
+ * Uses indexed tags (1-based) to represent styled regions:
+ * - Text: "Hello <1>world</1>"
+ * - Styles: { "1": ["bold"] }
+ *
+ * ICU parameter schema is provided at the namespace level by the server,
+ * not per-translation. See the `schema` field in server responses.
+ *
+ * @example
+ * ```typescript
+ * const unit: ContentUnit = {
+ *   text: "Read our <1>Terms</1> and <2>Privacy</2>.",
+ *   styles: {
+ *     "1": ["bold", "hyperlink:/terms"],
+ *     "2": ["hyperlink:/privacy"]
+ *   }
+ * };
+ * ```
+ */
+export interface ContentUnit {
+    /**
+     * Text with indexed tags: "Hello <1>world</1>"
+     * Tags are 1-based integers matching keys in styles
+     */
+    text: string;
+    /**
+     * Style definitions by tag index
+     * Key: tag index as string (e.g., "1", "2")
+     * Value: array of style properties (e.g., ["bold", "hyperlink:/url"])
+     */
+    styles: Record<string, string[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/content/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/content/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC"}

package/dist/content/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core content types for the Unified Content Architecture
+ * @module content/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/content/types.js.map

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

package/dist/content/validator/ContentValidator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Content validator for ContentUnit integrity checking
+ * @module content/validator/ContentValidator
+ */
+import type { IValidator, ValidationResult } from './IValidator.js';
+import type { ContentUnit } from '../types.js';
+/**
+ * Validates ContentUnit for structural integrity
+ *
+ * Checks for:
+ * - Balanced indexed tags (`<1>...</1>`)
+ * - Valid tag indices (no invalid/malformed tags)
+ * - Style references (styles referenced by tags exist)
+ * - Orphan styles (styles defined but not used)
+ * - Basic ICU brace balance validation
+ *
+ * @example
+ * ```typescript
+ * const validator = new ContentValidator();
+ *
+ * // Valid unit
+ * const valid = validator.validate({
+ *   text: 'Hello <1>world</1>',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → { valid: true, errors: [], warnings: [] }
+ *
+ * // Unbalanced tags
+ * const invalid = validator.validate({
+ *   text: 'Hello <1>world',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → { valid: false, errors: [{ code: 'UNBALANCED_TAGS', ... }], ... }
+ * ```
+ */
+export declare class ContentValidator implements IValidator {
+    /**
+     * Validate a ContentUnit for structural integrity
+     *
+     * @param unit - ContentUnit to validate
+     * @returns Validation result with errors and warnings
+     */
+    validate(unit: ContentUnit): ValidationResult;
+    /**
+     * Validate that all indexed tags are properly balanced and correctly nested
+     */
+    private validateTagBalance;
+    /**
+     * Validate style references - check that used tags have styles and vice versa
+     */
+    private validateStyleReferences;
+    /**
+     * Validate ICU MessageFormat brace balance
+     */
+    private validateICUBraces;
+}
+//# sourceMappingURL=ContentValidator.d.ts.map

package/dist/content/validator/ContentValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentValidator.d.ts","sourceRoot":"","sources":["../../../src/content/validator/ContentValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAKjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB;IAoB7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmE1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA+D1B"}

package/dist/content/validator/ContentValidator.js

@@ -0,0 +1,215 @@
+/**
+ * Content validator for ContentUnit integrity checking
+ * @module content/validator/ContentValidator
+ */
+/**
+ * Validates ContentUnit for structural integrity
+ *
+ * Checks for:
+ * - Balanced indexed tags (`<1>...</1>`)
+ * - Valid tag indices (no invalid/malformed tags)
+ * - Style references (styles referenced by tags exist)
+ * - Orphan styles (styles defined but not used)
+ * - Basic ICU brace balance validation
+ *
+ * @example
+ * ```typescript
+ * const validator = new ContentValidator();
+ *
+ * // Valid unit
+ * const valid = validator.validate({
+ *   text: 'Hello <1>world</1>',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → { valid: true, errors: [], warnings: [] }
+ *
+ * // Unbalanced tags
+ * const invalid = validator.validate({
+ *   text: 'Hello <1>world',
+ *   styles: { '1': ['bold'] }
+ * });
+ * // → { valid: false, errors: [{ code: 'UNBALANCED_TAGS', ... }], ... }
+ * ```
+ */
+export class ContentValidator {
+    /**
+     * Validate a ContentUnit for structural integrity
+     *
+     * @param unit - ContentUnit to validate
+     * @returns Validation result with errors and warnings
+     */
+    validate(unit) {
+        const errors = [];
+        const warnings = [];
+        // Check tag balance
+        this.validateTagBalance(unit.text, errors);
+        // Check style references
+        this.validateStyleReferences(unit.text, unit.styles, errors, warnings);
+        // Check ICU brace balance (always, since text may contain ICU patterns)
+        this.validateICUBraces(unit.text, errors);
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate that all indexed tags are properly balanced and correctly nested
+     */
+    validateTagBalance(text, errors) {
+        // Pattern to match indexed tags: <1>, </1>, <1/>
+        const tagPattern = /<(\/?)?(\d+)(\/)?>/g;
+        // Stack-based approach to verify proper nesting order
+        const tagStack = [];
+        let match;
+        while ((match = tagPattern.exec(text)) !== null) {
+            const [, closingSlash, indexStr, selfClosingSlash] = match;
+            if (selfClosingSlash) {
+                // Self-closing tag: <1/> - always valid
+                continue;
+            }
+            if (closingSlash) {
+                // Closing tag: </1>
+                // Must match the most recently opened tag (proper nesting)
+                if (tagStack.length === 0) {
+                    errors.push({
+                        code: 'UNBALANCED_TAGS',
+                        message: `Closing tag </${indexStr}> has no matching opening tag`,
+                        path: `text[${match.index}]`,
+                    });
+                }
+                else {
+                    const lastOpen = tagStack[tagStack.length - 1];
+                    if (lastOpen.index === indexStr) {
+                        // Proper closing - pop the stack
+                        tagStack.pop();
+                    }
+                    else {
+                        // Check if this tag was opened earlier (improper nesting)
+                        const foundIndex = tagStack.findIndex((t) => t.index === indexStr);
+                        if (foundIndex >= 0) {
+                            // Tag was opened but not in the right order
+                            errors.push({
+                                code: 'UNBALANCED_TAGS',
+                                message: `Improperly nested: </${indexStr}> should close before </${lastOpen.index}>`,
+                                path: `text[${match.index}]`,
+                            });
+                            // Remove the out-of-order tag from stack
+                            tagStack.splice(foundIndex, 1);
+                        }
+                        else {
+                            // Tag was never opened
+                            errors.push({
+                                code: 'UNBALANCED_TAGS',
+                                message: `Closing tag </${indexStr}> has no matching opening tag`,
+                                path: `text[${match.index}]`,
+                            });
+                        }
+                    }
+                }
+            }
+            else {
+                // Opening tag: <1>
+                tagStack.push({ index: indexStr, position: match.index });
+            }
+        }
+        // Check for unclosed tags
+        for (const { index } of tagStack) {
+            errors.push({
+                code: 'UNBALANCED_TAGS',
+                message: `Opening tag <${index}> has no matching closing tag`,
+                path: 'text',
+            });
+        }
+    }
+    /**
+     * Validate style references - check that used tags have styles and vice versa
+     */
+    validateStyleReferences(text, styles, errors, warnings) {
+        // Find all tag indices used in text
+        const usedIndices = new Set();
+        const tagPattern = /<\/?(\d+)(?:\/)?>/g;
+        let match;
+        while ((match = tagPattern.exec(text)) !== null) {
+            usedIndices.add(match[1]);
+        }
+        // Check for used indices without style definitions
+        for (const index of usedIndices) {
+            if (!styles[index] || styles[index].length === 0) {
+                // This is a warning, not an error - tag will render as <span>
+                warnings.push({
+                    code: 'EMPTY_STYLE',
+                    message: `Tag <${index}> has no style definition, will render as <span>`,
+                });
+            }
+        }
+        // Check for defined styles not used in text (orphan styles)
+        for (const index of Object.keys(styles)) {
+            if (!usedIndices.has(index)) {
+                warnings.push({
+                    code: 'UNUSED_TAG',
+                    message: `Style for tag <${index}> is defined but tag is not used in text`,
+                });
+            }
+        }
+    }
+    /**
+     * Validate ICU MessageFormat brace balance
+     */
+    validateICUBraces(text, errors) {
+        // Check for balanced braces
+        let depth = 0;
+        let inString = false;
+        let stringChar = '';
+        for (let i = 0; i < text.length; i++) {
+            const char = text[i];
+            const prevChar = i > 0 ? text[i - 1] : '';
+            // Handle string escaping
+            if ((char === '"' || char === "'") &&
+                prevChar !== '\\') {
+                if (!inString) {
+                    inString = true;
+                    stringChar = char;
+                }
+                else if (char === stringChar) {
+                    inString = false;
+                    stringChar = '';
+                }
+                continue;
+            }
+            if (inString)
+                continue;
+            if (char === '{') {
+                depth++;
+            }
+            else if (char === '}') {
+                depth--;
+                if (depth < 0) {
+                    errors.push({
+                        code: 'INVALID_ICU',
+                        message: `Unbalanced ICU braces: unexpected '}' at position ${i}`,
+                        path: `text[${i}]`,
+                    });
+                    depth = 0; // Reset to continue checking
+                }
+            }
+        }
+        if (depth > 0) {
+            errors.push({
+                code: 'INVALID_ICU',
+                message: `Unbalanced ICU braces: ${depth} unclosed '{'`,
+                path: 'text',
+            });
+        }
+        // Check for empty variable names
+        const emptyVarPattern = /\{\s*[,}]/;
+        if (emptyVarPattern.test(text)) {
+            errors.push({
+                code: 'INVALID_ICU',
+                message: 'ICU variable name is empty or missing',
+                path: 'text',
+            });
+        }
+    }
+}
+//# sourceMappingURL=ContentValidator.js.map

package/dist/content/validator/ContentValidator.js.map

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

package/dist/content/validator/IValidator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Validator interface and result types for ContentUnit validation
+ * @module content/validator/IValidator
+ */
+import type { ContentUnit } from '../types.js';
+/**
+ * Validation error codes
+ */
+export type ValidationErrorCode = 'UNBALANCED_TAGS' | 'INVALID_TAG_INDEX' | 'ORPHAN_STYLE' | 'INVALID_ICU';
+/**
+ * Validation warning codes
+ */
+export type ValidationWarningCode = 'EMPTY_STYLE' | 'UNUSED_TAG';
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    /**
+     * Error code identifying the type of error
+     */
+    code: ValidationErrorCode;
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Path to the error location (e.g., "text", "styles.1")
+     */
+    path?: string;
+}
+/**
+ * Validation warning details
+ */
+export interface ValidationWarning {
+    /**
+     * Warning code identifying the type of warning
+     */
+    code: ValidationWarningCode;
+    /**
+     * Human-readable warning message
+     */
+    message: string;
+}
+/**
+ * Validation result containing errors and warnings
+ */
+export interface ValidationResult {
+    /**
+     * Whether the ContentUnit is valid (no errors)
+     */
+    valid: boolean;
+    /**
+     * List of validation errors (blocking issues)
+     */
+    errors: ValidationError[];
+    /**
+     * List of validation warnings (non-blocking issues)
+     */
+    warnings: ValidationWarning[];
+}
+/**
+ * Validator interface for ContentUnit integrity checks
+ *
+ * @example
+ * ```typescript
+ * class ContentValidator implements IValidator {
+ *   validate(unit: ContentUnit): ValidationResult {
+ *     // Check balanced tags, orphan styles, ICU syntax
+ *   }
+ * }
+ * ```
+ */
+export interface IValidator {
+    /**
+     * Validate ContentUnit integrity
+     *
+     * @param unit - The ContentUnit to validate
+     * @returns Validation result with errors and warnings
+     */
+    validate(unit: ContentUnit): ValidationResult;
+}
+//# sourceMappingURL=IValidator.d.ts.map

package/dist/content/validator/IValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IValidator.d.ts","sourceRoot":"","sources":["../../../src/content/validator/IValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,mBAAmB,GACnB,cAAc,GACd,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,YAAY,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,qBAAqB,CAAC;IAE5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,CAAC;CAC/C"}

package/dist/content/validator/IValidator.js

@@ -0,0 +1,6 @@
+/**
+ * Validator interface and result types for ContentUnit validation
+ * @module content/validator/IValidator
+ */
+export {};
+//# sourceMappingURL=IValidator.js.map

package/dist/content/validator/IValidator.js.map

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