docxodus 3.5.1 → 3.6.1

package/dist/types.d.ts

@@ -38,6 +38,19 @@ export declare enum PaginationMode {
      */
     Paginated = 1
 }
+/**
+ * Annotation label display mode
+ */
+export declare enum AnnotationLabelMode {
+    /** Floating label positioned above the highlight */
+    Above = 0,
+    /** Label displayed inline at start of highlight */
+    Inline = 1,
+    /** Label shown only on hover (tooltip) */
+    Tooltip = 2,
+    /** No labels displayed, only highlights */
+    None = 3
+}
 /**
  * Options for DOCX to HTML conversion
  */
@@ -60,6 +73,12 @@ export interface ConversionOptions {
     paginationScale?: number;
     /** CSS class prefix for pagination elements. Default: "page-" */
     paginationCssClassPrefix?: string;
+    /** Whether to render custom annotations (default: false) */
+    renderAnnotations?: boolean;
+    /** How to display annotation labels (default: Above) */
+    annotationLabelMode?: AnnotationLabelMode;
+    /** CSS class prefix for annotation elements (default: "annot-") */
+    annotationCssClassPrefix?: string;
 }
 /**
  * Options for document comparison
@@ -277,6 +296,13 @@ export interface DocxodusWasmExports {
         ConvertDocxToHtml: (bytes: Uint8Array) => string;
         ConvertDocxToHtmlWithOptions: (bytes: Uint8Array, pageTitle: string, cssPrefix: string, fabricateClasses: boolean, additionalCss: string, commentRenderMode: number, commentCssClassPrefix: string) => string;
         ConvertDocxToHtmlWithPagination: (bytes: Uint8Array, pageTitle: string, cssPrefix: string, fabricateClasses: boolean, additionalCss: string, commentRenderMode: number, commentCssClassPrefix: string, paginationMode: number, paginationScale: number, paginationCssClassPrefix: string) => string;
+        ConvertDocxToHtmlFull: (bytes: Uint8Array, pageTitle: string, cssPrefix: string, fabricateClasses: boolean, additionalCss: string, commentRenderMode: number, commentCssClassPrefix: string, paginationMode: number, paginationScale: number, paginationCssClassPrefix: string, renderAnnotations: boolean, annotationLabelMode: number, annotationCssClassPrefix: string) => string;
+        GetAnnotations: (bytes: Uint8Array) => string;
+        AddAnnotation: (bytes: Uint8Array, requestJson: string) => string;
+        AddAnnotationWithTarget: (bytes: Uint8Array, requestJson: string) => string;
+        RemoveAnnotation: (bytes: Uint8Array, annotationId: string) => string;
+        HasAnnotations: (bytes: Uint8Array) => string;
+        GetDocumentStructure: (bytes: Uint8Array) => string;
         GetVersion: () => string;
     };
     DocumentComparer: {
@@ -316,4 +342,306 @@ export interface GetRevisionsOptions {
      */
     caseInsensitive?: boolean;
 }
+/**
+ * A custom annotation on a document range.
+ */
+export interface Annotation {
+    /** Unique annotation ID */
+    id: string;
+    /** Label category/type identifier (e.g., "CLAUSE_TYPE_A", "DATE_REF") */
+    labelId: string;
+    /** Human-readable label text */
+    label: string;
+    /** Highlight color in hex format (e.g., "#FFEB3B") */
+    color: string;
+    /** Author who created the annotation */
+    author?: string;
+    /** Creation timestamp (ISO 8601) */
+    created?: string;
+    /** Internal bookmark name */
+    bookmarkName?: string;
+    /** Start page number (if computed) */
+    startPage?: number;
+    /** End page number (if computed) */
+    endPage?: number;
+    /** The annotated text content */
+    annotatedText?: string;
+    /** Custom metadata key-value pairs */
+    metadata?: Record<string, string>;
+}
+/**
+ * Request to add an annotation to a document.
+ */
+export interface AddAnnotationRequest {
+    /** Unique annotation ID */
+    id: string;
+    /** Label category/type identifier */
+    labelId: string;
+    /** Human-readable label text */
+    label: string;
+    /** Highlight color in hex format (default: "#FFEB3B") */
+    color?: string;
+    /** Author who created the annotation */
+    author?: string;
+    /** Text to search for and annotate */
+    searchText?: string;
+    /** Which occurrence to annotate (1-based, default: 1) */
+    occurrence?: number;
+    /** Start paragraph index (0-based) */
+    startParagraphIndex?: number;
+    /** End paragraph index (0-based, inclusive) */
+    endParagraphIndex?: number;
+    /** Custom metadata key-value pairs */
+    metadata?: Record<string, string>;
+}
+/**
+ * Response from adding an annotation.
+ */
+export interface AddAnnotationResponse {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The modified document as base64 string */
+    documentBytes: string;
+    /** The added annotation details */
+    annotation?: Annotation;
+}
+/**
+ * Response from removing an annotation.
+ */
+export interface RemoveAnnotationResponse {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The modified document as base64 string */
+    documentBytes: string;
+}
+/**
+ * Options for annotation rendering in HTML output.
+ */
+export interface AnnotationOptions {
+    /** Whether to render annotations (default: false) */
+    renderAnnotations?: boolean;
+    /** How to display annotation labels (default: Above) */
+    annotationLabelMode?: AnnotationLabelMode;
+    /** CSS class prefix for annotation elements (default: "annot-") */
+    annotationCssClassPrefix?: string;
+}
+/**
+ * Document element types that can be annotated.
+ */
+export declare enum DocumentElementType {
+    /** Root document element */
+    Document = "Document",
+    /** A paragraph (w:p) */
+    Paragraph = "Paragraph",
+    /** A run within a paragraph (w:r) */
+    Run = "Run",
+    /** A table (w:tbl) */
+    Table = "Table",
+    /** A table row (w:tr) */
+    TableRow = "TableRow",
+    /** A table cell (w:tc) */
+    TableCell = "TableCell",
+    /** A virtual table column (not a real OOXML element) */
+    TableColumn = "TableColumn",
+    /** A hyperlink (w:hyperlink) */
+    Hyperlink = "Hyperlink",
+    /** An image/drawing (w:drawing) */
+    Image = "Image"
+}
+/**
+ * A document element in the structure tree.
+ */
+export interface DocumentElement {
+    /** Unique element ID (path-based, e.g., "doc/tbl-0/tr-1/tc-2") */
+    id: string;
+    /** Element type */
+    type: DocumentElementType | string;
+    /** Preview of text content (first ~100 characters) */
+    textPreview?: string;
+    /** Position index within parent element */
+    index: number;
+    /** Child elements */
+    children: DocumentElement[];
+    /** For table rows/cells: the row index */
+    rowIndex?: number;
+    /** For table cells: the column index */
+    columnIndex?: number;
+    /** For table cells: number of rows this cell spans */
+    rowSpan?: number;
+    /** For table cells: number of columns this cell spans */
+    columnSpan?: number;
+}
+/**
+ * Information about a table column.
+ */
+export interface TableColumnInfo {
+    /** ID of the table this column belongs to */
+    tableId: string;
+    /** Zero-based column index */
+    columnIndex: number;
+    /** IDs of all cells in this column */
+    cellIds: string[];
+    /** Total number of rows in this column */
+    rowCount: number;
+}
+/**
+ * Document structure analysis result.
+ */
+export interface DocumentStructure {
+    /** Root document element */
+    root: DocumentElement;
+    /** All elements indexed by ID for quick lookup */
+    elementsById: Record<string, DocumentElement>;
+    /** Table column information indexed by column ID */
+    tableColumns: Record<string, TableColumnInfo>;
+}
+/**
+ * Target specification for element-based annotation.
+ * Supports multiple targeting modes: element ID, indices, or text search.
+ */
+export interface AnnotationTarget {
+    /** Target by element ID (e.g., "doc/p-0/r-1") */
+    elementId?: string;
+    /** Element type for index-based targeting */
+    elementType?: DocumentElementType | string;
+    /** Paragraph index (0-based) */
+    paragraphIndex?: number;
+    /** Run index within paragraph (0-based) */
+    runIndex?: number;
+    /** Table index (0-based) */
+    tableIndex?: number;
+    /** Row index within table (0-based) */
+    rowIndex?: number;
+    /** Cell index within row (0-based) */
+    cellIndex?: number;
+    /** Column index for table column targeting (0-based) */
+    columnIndex?: number;
+    /** Text to search for (global or within elementId) */
+    searchText?: string;
+    /** Which occurrence of searchText to target (1-based, default: 1) */
+    occurrence?: number;
+    /** End paragraph index for range targeting */
+    rangeEndParagraphIndex?: number;
+}
+/**
+ * Request to add an annotation using flexible targeting.
+ */
+export interface AddAnnotationWithTargetRequest {
+    /** Unique annotation ID */
+    id: string;
+    /** Label category/type identifier */
+    labelId: string;
+    /** Human-readable label text */
+    label: string;
+    /** Highlight color in hex format (default: "#FFEB3B") */
+    color?: string;
+    /** Author who created the annotation */
+    author?: string;
+    /** Custom metadata key-value pairs */
+    metadata?: Record<string, string>;
+    /** Target specification */
+    target: AnnotationTarget;
+}
+/**
+ * Find an element by ID in the document structure.
+ * @param structure - The document structure
+ * @param elementId - The element ID to find
+ * @returns The element or undefined if not found
+ */
+export declare function findElementById(structure: DocumentStructure, elementId: string): DocumentElement | undefined;
+/**
+ * Find all elements of a specific type in the document structure.
+ * @param structure - The document structure
+ * @param type - The element type to find
+ * @returns Array of matching elements
+ */
+export declare function findElementsByType(structure: DocumentStructure, type: DocumentElementType | string): DocumentElement[];
+/**
+ * Get all paragraphs from the document structure.
+ * @param structure - The document structure
+ * @returns Array of paragraph elements
+ */
+export declare function getParagraphs(structure: DocumentStructure): DocumentElement[];
+/**
+ * Get all tables from the document structure.
+ * @param structure - The document structure
+ * @returns Array of table elements
+ */
+export declare function getTables(structure: DocumentStructure): DocumentElement[];
+/**
+ * Get column information for a specific table.
+ * @param structure - The document structure
+ * @param tableId - The table ID
+ * @returns Array of column info objects sorted by column index
+ */
+export declare function getTableColumns(structure: DocumentStructure, tableId: string): TableColumnInfo[];
+/**
+ * Create an annotation target for an element by ID.
+ * @param elementId - The element ID (e.g., "doc/p-0", "doc/tbl-0/tr-1/tc-2")
+ * @returns AnnotationTarget object
+ */
+export declare function targetElement(elementId: string): AnnotationTarget;
+/**
+ * Create an annotation target for a paragraph by index.
+ * @param paragraphIndex - Zero-based paragraph index
+ * @returns AnnotationTarget object
+ */
+export declare function targetParagraph(paragraphIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a range of paragraphs.
+ * @param startIndex - Zero-based start paragraph index
+ * @param endIndex - Zero-based end paragraph index
+ * @returns AnnotationTarget object
+ */
+export declare function targetParagraphRange(startIndex: number, endIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a specific run within a paragraph.
+ * @param paragraphIndex - Zero-based paragraph index
+ * @param runIndex - Zero-based run index within the paragraph
+ * @returns AnnotationTarget object
+ */
+export declare function targetRun(paragraphIndex: number, runIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a table by index.
+ * @param tableIndex - Zero-based table index
+ * @returns AnnotationTarget object
+ */
+export declare function targetTable(tableIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a table row.
+ * @param tableIndex - Zero-based table index
+ * @param rowIndex - Zero-based row index within the table
+ * @returns AnnotationTarget object
+ */
+export declare function targetTableRow(tableIndex: number, rowIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a table cell.
+ * @param tableIndex - Zero-based table index
+ * @param rowIndex - Zero-based row index
+ * @param cellIndex - Zero-based cell index within the row
+ * @returns AnnotationTarget object
+ */
+export declare function targetTableCell(tableIndex: number, rowIndex: number, cellIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target for a table column (all cells in that column).
+ * @param tableIndex - Zero-based table index
+ * @param columnIndex - Zero-based column index
+ * @returns AnnotationTarget object
+ */
+export declare function targetTableColumn(tableIndex: number, columnIndex: number): AnnotationTarget;
+/**
+ * Create an annotation target by text search.
+ * @param searchText - Text to search for
+ * @param occurrence - Which occurrence to target (1-based, default: 1)
+ * @returns AnnotationTarget object
+ */
+export declare function targetSearch(searchText: string, occurrence?: number): AnnotationTarget;
+/**
+ * Create an annotation target to search text within a specific element.
+ * @param elementId - The element ID to search within
+ * @param searchText - Text to search for
+ * @param occurrence - Which occurrence to target (1-based, default: 1)
+ * @returns AnnotationTarget object
+ */
+export declare function targetSearchInElement(elementId: string, searchText: string, occurrence?: number): AnnotationTarget;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -41,6 +41,20 @@ export var PaginationMode;
      */
     PaginationMode[PaginationMode["Paginated"] = 1] = "Paginated";
 })(PaginationMode || (PaginationMode = {}));
+/**
+ * Annotation label display mode
+ */
+export var AnnotationLabelMode;
+(function (AnnotationLabelMode) {
+    /** Floating label positioned above the highlight */
+    AnnotationLabelMode[AnnotationLabelMode["Above"] = 0] = "Above";
+    /** Label displayed inline at start of highlight */
+    AnnotationLabelMode[AnnotationLabelMode["Inline"] = 1] = "Inline";
+    /** Label shown only on hover (tooltip) */
+    AnnotationLabelMode[AnnotationLabelMode["Tooltip"] = 2] = "Tooltip";
+    /** No labels displayed, only highlights */
+    AnnotationLabelMode[AnnotationLabelMode["None"] = 3] = "None";
+})(AnnotationLabelMode || (AnnotationLabelMode = {}));
 /**
  * Type guard to check if a revision is an insertion.
  * @param revision - The revision to check
@@ -150,4 +164,195 @@ export function findMovePair(revision, allRevisions) {
     return allRevisions.find((r) => r.moveGroupId === revision.moveGroupId &&
         r.isMoveSource !== revision.isMoveSource);
 }
+// ============================================================================
+// Document Structure Types (for element-based annotation targeting)
+// ============================================================================
+/**
+ * Document element types that can be annotated.
+ */
+export var DocumentElementType;
+(function (DocumentElementType) {
+    /** Root document element */
+    DocumentElementType["Document"] = "Document";
+    /** A paragraph (w:p) */
+    DocumentElementType["Paragraph"] = "Paragraph";
+    /** A run within a paragraph (w:r) */
+    DocumentElementType["Run"] = "Run";
+    /** A table (w:tbl) */
+    DocumentElementType["Table"] = "Table";
+    /** A table row (w:tr) */
+    DocumentElementType["TableRow"] = "TableRow";
+    /** A table cell (w:tc) */
+    DocumentElementType["TableCell"] = "TableCell";
+    /** A virtual table column (not a real OOXML element) */
+    DocumentElementType["TableColumn"] = "TableColumn";
+    /** A hyperlink (w:hyperlink) */
+    DocumentElementType["Hyperlink"] = "Hyperlink";
+    /** An image/drawing (w:drawing) */
+    DocumentElementType["Image"] = "Image";
+})(DocumentElementType || (DocumentElementType = {}));
+// ============================================================================
+// Helper functions for document structure navigation
+// ============================================================================
+/**
+ * Find an element by ID in the document structure.
+ * @param structure - The document structure
+ * @param elementId - The element ID to find
+ * @returns The element or undefined if not found
+ */
+export function findElementById(structure, elementId) {
+    return structure.elementsById[elementId];
+}
+/**
+ * Find all elements of a specific type in the document structure.
+ * @param structure - The document structure
+ * @param type - The element type to find
+ * @returns Array of matching elements
+ */
+export function findElementsByType(structure, type) {
+    return Object.values(structure.elementsById).filter((el) => el.type === type);
+}
+/**
+ * Get all paragraphs from the document structure.
+ * @param structure - The document structure
+ * @returns Array of paragraph elements
+ */
+export function getParagraphs(structure) {
+    return findElementsByType(structure, DocumentElementType.Paragraph);
+}
+/**
+ * Get all tables from the document structure.
+ * @param structure - The document structure
+ * @returns Array of table elements
+ */
+export function getTables(structure) {
+    return findElementsByType(structure, DocumentElementType.Table);
+}
+/**
+ * Get column information for a specific table.
+ * @param structure - The document structure
+ * @param tableId - The table ID
+ * @returns Array of column info objects sorted by column index
+ */
+export function getTableColumns(structure, tableId) {
+    return Object.values(structure.tableColumns)
+        .filter((col) => col.tableId === tableId)
+        .sort((a, b) => a.columnIndex - b.columnIndex);
+}
+/**
+ * Create an annotation target for an element by ID.
+ * @param elementId - The element ID (e.g., "doc/p-0", "doc/tbl-0/tr-1/tc-2")
+ * @returns AnnotationTarget object
+ */
+export function targetElement(elementId) {
+    return { elementId };
+}
+/**
+ * Create an annotation target for a paragraph by index.
+ * @param paragraphIndex - Zero-based paragraph index
+ * @returns AnnotationTarget object
+ */
+export function targetParagraph(paragraphIndex) {
+    return {
+        elementType: DocumentElementType.Paragraph,
+        paragraphIndex,
+    };
+}
+/**
+ * Create an annotation target for a range of paragraphs.
+ * @param startIndex - Zero-based start paragraph index
+ * @param endIndex - Zero-based end paragraph index
+ * @returns AnnotationTarget object
+ */
+export function targetParagraphRange(startIndex, endIndex) {
+    return {
+        elementType: DocumentElementType.Paragraph,
+        paragraphIndex: startIndex,
+        rangeEndParagraphIndex: endIndex,
+    };
+}
+/**
+ * Create an annotation target for a specific run within a paragraph.
+ * @param paragraphIndex - Zero-based paragraph index
+ * @param runIndex - Zero-based run index within the paragraph
+ * @returns AnnotationTarget object
+ */
+export function targetRun(paragraphIndex, runIndex) {
+    return {
+        elementType: DocumentElementType.Run,
+        paragraphIndex,
+        runIndex,
+    };
+}
+/**
+ * Create an annotation target for a table by index.
+ * @param tableIndex - Zero-based table index
+ * @returns AnnotationTarget object
+ */
+export function targetTable(tableIndex) {
+    return {
+        elementType: DocumentElementType.Table,
+        tableIndex,
+    };
+}
+/**
+ * Create an annotation target for a table row.
+ * @param tableIndex - Zero-based table index
+ * @param rowIndex - Zero-based row index within the table
+ * @returns AnnotationTarget object
+ */
+export function targetTableRow(tableIndex, rowIndex) {
+    return {
+        elementType: DocumentElementType.TableRow,
+        tableIndex,
+        rowIndex,
+    };
+}
+/**
+ * Create an annotation target for a table cell.
+ * @param tableIndex - Zero-based table index
+ * @param rowIndex - Zero-based row index
+ * @param cellIndex - Zero-based cell index within the row
+ * @returns AnnotationTarget object
+ */
+export function targetTableCell(tableIndex, rowIndex, cellIndex) {
+    return {
+        elementType: DocumentElementType.TableCell,
+        tableIndex,
+        rowIndex,
+        cellIndex,
+    };
+}
+/**
+ * Create an annotation target for a table column (all cells in that column).
+ * @param tableIndex - Zero-based table index
+ * @param columnIndex - Zero-based column index
+ * @returns AnnotationTarget object
+ */
+export function targetTableColumn(tableIndex, columnIndex) {
+    return {
+        elementType: DocumentElementType.TableColumn,
+        tableIndex,
+        columnIndex,
+    };
+}
+/**
+ * Create an annotation target by text search.
+ * @param searchText - Text to search for
+ * @param occurrence - Which occurrence to target (1-based, default: 1)
+ * @returns AnnotationTarget object
+ */
+export function targetSearch(searchText, occurrence = 1) {
+    return { searchText, occurrence };
+}
+/**
+ * Create an annotation target to search text within a specific element.
+ * @param elementId - The element ID to search within
+ * @param searchText - Text to search for
+ * @param occurrence - Which occurrence to target (1-based, default: 1)
+ * @returns AnnotationTarget object
+ */
+export function targetSearchInElement(elementId, searchText, occurrence = 1) {
+    return { elementId, searchText, occurrence };
+}
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,8CAA8C;IAC9C,qCAAqB,CAAA;IACrB,+CAA+C;IAC/C,mCAAmB,CAAA;IACnB,6DAA6D;IAC7D,+BAAe,CAAA;IACf,yEAAyE;IACzE,+CAA+B,CAAA;AACjC,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,uCAAuC;IACvC,kEAAa,CAAA;IACb,2FAA2F;IAC3F,yEAAgB,CAAA;IAChB,8DAA8D;IAC9D,6DAAU,CAAA;IACV,0DAA0D;IAC1D,6DAAU,CAAA;AACZ,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB,2DAA2D;IAC3D,mDAAQ,CAAA;IACR;;;;OAIG;IACH,6DAAa,CAAA;AACf,CAAC,EATW,cAAc,KAAd,cAAc,QASzB;AAyHD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB;IAC5C,OAAO,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC,QAAQ,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,QAAkB;IAC3C,OAAO,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC,OAAO,CAAC;AACxD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,QAAkB;IACvC,OAAO,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC,KAAK,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,OAAO,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC,aAAa,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,YAAY,KAAK,IAAI,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,YAAY,KAAK,KAAK,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,YAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;QACtC,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,YAAY,CAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}