docxmlater 0.1.0

package/dist/elements/Comment.d.ts

@@ -0,0 +1,42 @@
+import { Run } from './Run';
+import { XMLElement } from '../xml/XMLBuilder';
+export interface CommentProperties {
+    id?: number;
+    author: string;
+    initials?: string;
+    date?: Date;
+    content: string | Run | Run[];
+    parentId?: number;
+}
+export declare class Comment {
+    private id;
+    private author;
+    private initials;
+    private date;
+    private runs;
+    private parentId?;
+    constructor(properties: CommentProperties);
+    private generateInitials;
+    getId(): number;
+    setId(id: number): void;
+    getAuthor(): string;
+    setAuthor(author: string): this;
+    getInitials(): string;
+    setInitials(initials: string): this;
+    getDate(): Date;
+    setDate(date: Date): this;
+    getParentId(): number | undefined;
+    isReply(): boolean;
+    getRuns(): Run[];
+    addRun(run: Run): this;
+    getText(): string;
+    private formatDate;
+    toRangeStartXML(): XMLElement;
+    toRangeEndXML(): XMLElement;
+    toReferenceXML(): XMLElement;
+    toXML(): XMLElement;
+    static create(author: string, content: string | Run | Run[], initials?: string): Comment;
+    static createReply(parentId: number, author: string, content: string | Run | Run[], initials?: string): Comment;
+    static createFormatted(author: string, runs: Run[], initials?: string): Comment;
+}
+//# sourceMappingURL=Comment.d.ts.map

package/dist/elements/Comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Comment.d.ts","sourceRoot":"","sources":["../../src/elements/Comment.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,MAAM,WAAW,iBAAiB;IAEhC,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IAE9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAMd,UAAU,EAAE,iBAAiB;IAqBzC,OAAO,CAAC,gBAAgB;IAcxB,KAAK,IAAI,MAAM;IAQf,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,SAAS,IAAI,MAAM;IAOnB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/B,WAAW,IAAI,MAAM;IAOrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQzB,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,OAAO,IAAI,OAAO;IAOlB,OAAO,IAAI,GAAG,EAAE;IAOhB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAQtB,OAAO,IAAI,MAAM;IAOjB,OAAO,CAAC,UAAU;IAQlB,eAAe,IAAI,UAAU;IAc7B,aAAa,IAAI,UAAU;IAc3B,cAAc,IAAI,UAAU;IAmB5B,KAAK,IAAI,UAAU;IAiCnB,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,WAAW,CAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EAAE,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;CAOX"}

package/dist/elements/Comment.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Comment = void 0;
+const Run_1 = require("./Run");
+class Comment {
+    constructor(properties) {
+        this.id = properties.id ?? 0;
+        this.author = properties.author;
+        this.initials = properties.initials || this.generateInitials(properties.author);
+        this.date = properties.date || new Date();
+        this.parentId = properties.parentId;
+        if (typeof properties.content === 'string') {
+            this.runs = [new Run_1.Run(properties.content)];
+        }
+        else if (Array.isArray(properties.content)) {
+            this.runs = properties.content;
+        }
+        else {
+            this.runs = [properties.content];
+        }
+    }
+    generateInitials(author) {
+        const words = author.trim().split(/\s+/).filter(w => w.length > 0);
+        if (words.length === 0)
+            return 'U';
+        if (words.length === 1)
+            return (words[0] || 'U').substring(0, 2).toUpperCase();
+        return words
+            .map(word => word[0] || '')
+            .join('')
+            .toUpperCase()
+            .substring(0, 3) || 'U';
+    }
+    getId() {
+        return this.id;
+    }
+    setId(id) {
+        this.id = id;
+    }
+    getAuthor() {
+        return this.author;
+    }
+    setAuthor(author) {
+        this.author = author;
+        return this;
+    }
+    getInitials() {
+        return this.initials;
+    }
+    setInitials(initials) {
+        this.initials = initials;
+        return this;
+    }
+    getDate() {
+        return this.date;
+    }
+    setDate(date) {
+        this.date = date;
+        return this;
+    }
+    getParentId() {
+        return this.parentId;
+    }
+    isReply() {
+        return this.parentId !== undefined;
+    }
+    getRuns() {
+        return [...this.runs];
+    }
+    addRun(run) {
+        this.runs.push(run);
+        return this;
+    }
+    getText() {
+        return this.runs.map(run => run.getText()).join('');
+    }
+    formatDate(date) {
+        return date.toISOString();
+    }
+    toRangeStartXML() {
+        return {
+            name: 'w:commentRangeStart',
+            attributes: {
+                'w:id': this.id.toString(),
+            },
+            selfClosing: true,
+        };
+    }
+    toRangeEndXML() {
+        return {
+            name: 'w:commentRangeEnd',
+            attributes: {
+                'w:id': this.id.toString(),
+            },
+            selfClosing: true,
+        };
+    }
+    toReferenceXML() {
+        return {
+            name: 'w:r',
+            children: [
+                {
+                    name: 'w:commentReference',
+                    attributes: {
+                        'w:id': this.id.toString(),
+                    },
+                    selfClosing: true,
+                },
+            ],
+        };
+    }
+    toXML() {
+        const attributes = {
+            'w:id': this.id.toString(),
+            'w:author': this.author,
+            'w:date': this.formatDate(this.date),
+            'w:initials': this.initials,
+        };
+        if (this.parentId !== undefined) {
+            attributes['w:parentId'] = this.parentId.toString();
+        }
+        const commentParagraph = {
+            name: 'w:p',
+            children: this.runs.map(run => run.toXML()),
+        };
+        return {
+            name: 'w:comment',
+            attributes,
+            children: [commentParagraph],
+        };
+    }
+    static create(author, content, initials) {
+        return new Comment({
+            author,
+            content,
+            initials,
+        });
+    }
+    static createReply(parentId, author, content, initials) {
+        return new Comment({
+            author,
+            content,
+            initials,
+            parentId,
+        });
+    }
+    static createFormatted(author, runs, initials) {
+        return new Comment({
+            author,
+            content: runs,
+            initials,
+        });
+    }
+}
+exports.Comment = Comment;
+//# sourceMappingURL=Comment.js.map

package/dist/elements/Comment.js.map

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

package/dist/elements/CommentManager.d.ts

@@ -0,0 +1,40 @@
+import { Comment } from './Comment';
+import { Run } from './Run';
+export declare class CommentManager {
+    private comments;
+    private nextId;
+    register(comment: Comment): Comment;
+    getComment(id: number): Comment | undefined;
+    getAllComments(): Comment[];
+    getAllCommentsWithReplies(): Comment[];
+    getReplies(commentId: number): Comment[];
+    hasReplies(commentId: number): boolean;
+    getCount(): number;
+    getTopLevelCount(): number;
+    getAuthors(): string[];
+    getCommentsByAuthor(author: string): Comment[];
+    getCommentsByDateRange(startDate: Date, endDate: Date): Comment[];
+    removeComment(id: number): boolean;
+    clear(): void;
+    createComment(author: string, content: string | Run | Run[], initials?: string): Comment;
+    createReply(parentCommentId: number, author: string, content: string | Run | Run[], initials?: string): Comment;
+    isEmpty(): boolean;
+    getCommentThread(commentId: number): {
+        comment: Comment;
+        replies: Comment[];
+    } | undefined;
+    findCommentsByText(searchText: string): Comment[];
+    getRecentComments(count: number): Comment[];
+    getStats(): {
+        total: number;
+        topLevel: number;
+        replies: number;
+        authors: string[];
+        nextId: number;
+    };
+    generateCommentsXml(): string;
+    private commentToXmlString;
+    private runToXmlString;
+    static create(): CommentManager;
+}
+//# sourceMappingURL=CommentManager.d.ts.map

package/dist/elements/CommentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentManager.d.ts","sourceRoot":"","sources":["../../src/elements/CommentManager.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAe5B,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,MAAM,CAAa;IAQ3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IA2BnC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C,cAAc,IAAI,OAAO,EAAE;IAU3B,yBAAyB,IAAI,OAAO,EAAE;IAStC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAUxC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAStC,QAAQ,IAAI,MAAM;IAQlB,gBAAgB,IAAI,MAAM;IAQ1B,UAAU,IAAI,MAAM,EAAE;IAatB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE;IAY9C,sBAAsB,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE;IAejE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAkBlC,KAAK,IAAI,IAAI;IAYb,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAcV,WAAW,CACT,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO;IAgBV,OAAO,IAAI,OAAO;IASlB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,SAAS;IAgBzF,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAYjD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAW3C,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IAeD,mBAAmB,IAAI,MAAM;IA6B7B,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,cAAc;IAetB,MAAM,CAAC,MAAM,IAAI,cAAc;CAGhC"}

package/dist/elements/CommentManager.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentManager = void 0;
+const Comment_1 = require("./Comment");
+const XMLBuilder_1 = require("../xml/XMLBuilder");
+class CommentManager {
+    constructor() {
+        this.comments = new Map();
+        this.nextId = 0;
+    }
+    register(comment) {
+        comment.setId(this.nextId++);
+        const entry = {
+            comment,
+            replies: [],
+        };
+        this.comments.set(comment.getId(), entry);
+        if (comment.isReply() && comment.getParentId() !== undefined) {
+            const parentEntry = this.comments.get(comment.getParentId());
+            if (parentEntry) {
+                parentEntry.replies.push(comment);
+            }
+        }
+        return comment;
+    }
+    getComment(id) {
+        return this.comments.get(id)?.comment;
+    }
+    getAllComments() {
+        return Array.from(this.comments.values())
+            .filter(entry => !entry.comment.isReply())
+            .map(entry => entry.comment);
+    }
+    getAllCommentsWithReplies() {
+        return Array.from(this.comments.values()).map(entry => entry.comment);
+    }
+    getReplies(commentId) {
+        const entry = this.comments.get(commentId);
+        return entry ? [...entry.replies] : [];
+    }
+    hasReplies(commentId) {
+        const entry = this.comments.get(commentId);
+        return entry ? entry.replies.length > 0 : false;
+    }
+    getCount() {
+        return this.comments.size;
+    }
+    getTopLevelCount() {
+        return this.getAllComments().length;
+    }
+    getAuthors() {
+        const authorsSet = new Set();
+        for (const entry of this.comments.values()) {
+            authorsSet.add(entry.comment.getAuthor());
+        }
+        return Array.from(authorsSet);
+    }
+    getCommentsByAuthor(author) {
+        return Array.from(this.comments.values())
+            .map(entry => entry.comment)
+            .filter(comment => comment.getAuthor() === author);
+    }
+    getCommentsByDateRange(startDate, endDate) {
+        return Array.from(this.comments.values())
+            .map(entry => entry.comment)
+            .filter(comment => {
+            const commentDate = comment.getDate();
+            return commentDate >= startDate && commentDate <= endDate;
+        });
+    }
+    removeComment(id) {
+        const entry = this.comments.get(id);
+        if (!entry) {
+            return false;
+        }
+        for (const reply of entry.replies) {
+            this.comments.delete(reply.getId());
+        }
+        return this.comments.delete(id);
+    }
+    clear() {
+        this.comments.clear();
+        this.nextId = 0;
+    }
+    createComment(author, content, initials) {
+        const comment = Comment_1.Comment.create(author, content, initials);
+        return this.register(comment);
+    }
+    createReply(parentCommentId, author, content, initials) {
+        if (!this.comments.has(parentCommentId)) {
+            throw new Error(`Cannot create reply: parent comment with ID ${parentCommentId} does not exist`);
+        }
+        const reply = Comment_1.Comment.createReply(parentCommentId, author, content, initials);
+        return this.register(reply);
+    }
+    isEmpty() {
+        return this.comments.size === 0;
+    }
+    getCommentThread(commentId) {
+        const entry = this.comments.get(commentId);
+        if (!entry || entry.comment.isReply()) {
+            return undefined;
+        }
+        return {
+            comment: entry.comment,
+            replies: [...entry.replies],
+        };
+    }
+    findCommentsByText(searchText) {
+        const lowerSearch = searchText.toLowerCase();
+        return Array.from(this.comments.values())
+            .map(entry => entry.comment)
+            .filter(comment => comment.getText().toLowerCase().includes(lowerSearch));
+    }
+    getRecentComments(count) {
+        const allComments = this.getAllCommentsWithReplies();
+        return allComments
+            .sort((a, b) => b.getDate().getTime() - a.getDate().getTime())
+            .slice(0, count);
+    }
+    getStats() {
+        const topLevel = this.getTopLevelCount();
+        return {
+            total: this.comments.size,
+            topLevel,
+            replies: this.comments.size - topLevel,
+            authors: this.getAuthors(),
+            nextId: this.nextId,
+        };
+    }
+    generateCommentsXml() {
+        const comments = this.getAllCommentsWithReplies();
+        if (comments.length === 0) {
+            return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+</w:comments>`;
+        }
+        let xml = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n';
+        xml += '<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"';
+        xml += ' xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">\n';
+        for (const comment of comments) {
+            xml += this.commentToXmlString(comment);
+        }
+        xml += '</w:comments>';
+        return xml;
+    }
+    commentToXmlString(comment) {
+        let xml = `  <w:comment w:id="${comment.getId()}"`;
+        xml += ` w:author="${XMLBuilder_1.XMLBuilder.escapeXmlAttribute(comment.getAuthor())}"`;
+        xml += ` w:date="${comment.getDate().toISOString()}"`;
+        xml += ` w:initials="${XMLBuilder_1.XMLBuilder.escapeXmlAttribute(comment.getInitials())}"`;
+        if (comment.isReply() && comment.getParentId() !== undefined) {
+            xml += ` w:parentId="${comment.getParentId()}"`;
+        }
+        xml += '>\n';
+        xml += '    <w:p>\n';
+        for (const run of comment.getRuns()) {
+            xml += this.runToXmlString(run, 6);
+        }
+        xml += '    </w:p>\n';
+        xml += '  </w:comment>\n';
+        return xml;
+    }
+    runToXmlString(run, indent) {
+        const spaces = ' '.repeat(indent);
+        const text = XMLBuilder_1.XMLBuilder.escapeXmlText(run.getText());
+        let xml = `${spaces}<w:r>\n`;
+        xml += `${spaces}  <w:t xml:space="preserve">${text}</w:t>\n`;
+        xml += `${spaces}</w:r>\n`;
+        return xml;
+    }
+    static create() {
+        return new CommentManager();
+    }
+}
+exports.CommentManager = CommentManager;
+//# sourceMappingURL=CommentManager.js.map

package/dist/elements/CommentManager.js.map

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

package/dist/elements/Field.d.ts

@@ -0,0 +1,36 @@
+import { XMLElement } from '../xml/XMLBuilder';
+import { RunFormatting } from './Run';
+export type FieldType = 'PAGE' | 'NUMPAGES' | 'DATE' | 'TIME' | 'AUTHOR' | 'TITLE' | 'FILENAME' | 'FILENAMEWITHPATH' | 'SUBJECT' | 'KEYWORDS' | 'CREATEDATE' | 'SAVEDATE' | 'PRINTDATE' | 'SECTIONPAGES' | 'SECTION';
+export interface FieldProperties {
+    type: FieldType;
+    instruction?: string;
+    format?: string;
+    dateFormat?: string;
+    preserveFormatting?: boolean;
+    formatting?: RunFormatting;
+}
+export declare class Field {
+    private type;
+    private instruction;
+    private formatting?;
+    constructor(properties: FieldProperties);
+    private buildInstruction;
+    private isDateField;
+    getType(): FieldType;
+    getInstruction(): string;
+    setFormatting(formatting: RunFormatting): this;
+    getFormatting(): RunFormatting | undefined;
+    toXML(): XMLElement;
+    private getPlaceholderText;
+    private createRunProperties;
+    static createPageNumber(formatting?: RunFormatting): Field;
+    static createTotalPages(formatting?: RunFormatting): Field;
+    static createDate(format?: string, formatting?: RunFormatting): Field;
+    static createTime(format?: string, formatting?: RunFormatting): Field;
+    static createFilename(includePath?: boolean, formatting?: RunFormatting): Field;
+    static createAuthor(formatting?: RunFormatting): Field;
+    static createTitle(formatting?: RunFormatting): Field;
+    static createCustom(instruction: string, formatting?: RunFormatting): Field;
+    static create(properties: FieldProperties): Field;
+}
+//# sourceMappingURL=Field.d.ts.map

package/dist/elements/Field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/elements/Field.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAKtC,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,UAAU,GACV,kBAAkB,GAClB,SAAS,GACT,UAAU,GACV,YAAY,GACZ,UAAU,GACV,WAAW,GACX,cAAc,GACd,SAAS,CAAC;AAKd,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,SAAS,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAKD,qBAAa,KAAK;IAChB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAgB;gBAMvB,UAAU,EAAE,eAAe;IAevC,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,WAAW;IAOnB,OAAO,IAAI,SAAS;IAOpB,cAAc,IAAI,MAAM;IAOxB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAQ9C,aAAa,IAAI,aAAa,GAAG,SAAS;IAQ1C,KAAK,IAAI,UAAU;IA0BnB,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,mBAAmB;IAgF3B,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAW1D,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAY1D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAarE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAarE,MAAM,CAAC,cAAc,CAAC,WAAW,GAAE,OAAe,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAWtF,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAWtD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAYrD,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,KAAK;IAY3E,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,KAAK;CAGlD"}