@xuanyue202/wechat-mp 2026.3.21

package/dist/src/send.js.map

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

package/dist/src/state.d.ts

@@ -0,0 +1,7 @@
+import type { WechatMpAccountState } from "./types.js";
+export declare function markProcessedMessage(msgId: string): Promise<boolean>;
+export declare function getAccountState(accountId: string): Promise<WechatMpAccountState>;
+export declare function updateAccountState(accountId: string, patch: Partial<WechatMpAccountState>): Promise<WechatMpAccountState>;
+export declare function flushWechatMpStateForTests(): Promise<void>;
+export declare function setWechatMpStateFilePathForTests(nextPath?: string): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAA0B,MAAM,YAAY,CAAC;AAqE/E,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW1E;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAGtF;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhE;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAQxE"}

package/dist/src/state.js

@@ -0,0 +1,109 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const DEDUP_TTL_MS = 10 * 60 * 1000;
+const DEFAULT_STATE_FILE = join(homedir(), ".openclaw", "wechat-mp", "data", "state.json");
+let stateFilePath = DEFAULT_STATE_FILE;
+let cachedState = null;
+let loadingState = null;
+let saveTimer = null;
+function createEmptyState() {
+    return {
+        version: 1,
+        processedMsgIds: {},
+        accounts: {},
+    };
+}
+function pruneState(state) {
+    const cutoff = Date.now() - DEDUP_TTL_MS;
+    for (const [msgId, timestamp] of Object.entries(state.processedMsgIds)) {
+        if (timestamp < cutoff) {
+            delete state.processedMsgIds[msgId];
+        }
+    }
+}
+async function saveState() {
+    if (!cachedState)
+        return;
+    pruneState(cachedState);
+    await mkdir(dirname(stateFilePath), { recursive: true });
+    await writeFile(stateFilePath, `${JSON.stringify(cachedState, null, 2)}\n`, "utf8");
+}
+function scheduleSave() {
+    if (saveTimer)
+        return;
+    saveTimer = setTimeout(() => {
+        saveTimer = null;
+        void saveState();
+    }, 50);
+}
+async function loadState() {
+    if (cachedState)
+        return cachedState;
+    if (loadingState)
+        return loadingState;
+    loadingState = (async () => {
+        try {
+            const raw = await readFile(stateFilePath, "utf8");
+            const parsed = JSON.parse(raw);
+            cachedState = {
+                version: 1,
+                processedMsgIds: parsed.processedMsgIds ?? {},
+                accounts: parsed.accounts ?? {},
+            };
+        }
+        catch {
+            cachedState = createEmptyState();
+        }
+        pruneState(cachedState);
+        return cachedState;
+    })();
+    try {
+        return await loadingState;
+    }
+    finally {
+        loadingState = null;
+    }
+}
+export async function markProcessedMessage(msgId) {
+    const normalized = msgId.trim();
+    if (!normalized)
+        return false;
+    const state = await loadState();
+    pruneState(state);
+    if (state.processedMsgIds[normalized]) {
+        return false;
+    }
+    state.processedMsgIds[normalized] = Date.now();
+    scheduleSave();
+    return true;
+}
+export async function getAccountState(accountId) {
+    const state = await loadState();
+    return { ...(state.accounts[accountId] ?? {}) };
+}
+export async function updateAccountState(accountId, patch) {
+    const state = await loadState();
+    const current = state.accounts[accountId] ?? {};
+    const next = { ...current, ...patch };
+    state.accounts[accountId] = next;
+    scheduleSave();
+    return next;
+}
+export async function flushWechatMpStateForTests() {
+    if (saveTimer) {
+        clearTimeout(saveTimer);
+        saveTimer = null;
+    }
+    await saveState();
+}
+export function setWechatMpStateFilePathForTests(nextPath) {
+    stateFilePath = nextPath?.trim() || DEFAULT_STATE_FILE;
+    cachedState = null;
+    loadingState = null;
+    if (saveTimer) {
+        clearTimeout(saveTimer);
+        saveTimer = null;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/src/state.js.map

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

package/dist/src/text.d.ts

@@ -0,0 +1,46 @@
+/**
+ * WeChat MP text normalization utilities
+ *
+ * Provides markdown-friendly text normalization that can be shared between
+ * the reply pipeline (dispatch.ts) and direct outbound (outbound.ts).
+ *
+ * The normalization behavior is controlled by the `renderMarkdown` config:
+ * - true (default): Apply markdown-friendly formatting for WeChat MP
+ * - false: Minimal passthrough, preserving original text
+ */
+/** WeChat MP text message byte limit (2048 bytes) */
+export declare const WECHAT_TEXT_BYTE_LIMIT = 2048;
+/**
+ * Calculate UTF-8 byte length of a string.
+ * @param str - The string to measure
+ * @returns The byte length in UTF-8 encoding
+ */
+export declare function getUtf8ByteLength(str: string): number;
+/**
+ * Split text by byte limit, respecting boundaries (paragraphs, sentences, spaces).
+ * Ensures no multi-byte characters are truncated.
+ *
+ * @param text - The text to split
+ * @param maxBytes - Maximum bytes per chunk (default: WECHAT_TEXT_BYTE_LIMIT)
+ * @returns Array of text chunks, each within the byte limit
+ */
+export declare function splitTextByByteLimit(text: string, maxBytes?: number): string[];
+/**
+ * Normalize text for WeChat MP delivery.
+ *
+ * When renderMarkdown is enabled (default), converts markdown to WeChat MP
+ * friendly plain text. When disabled, returns text with minimal changes.
+ *
+ * @param text - The raw text to normalize
+ * @param renderMarkdown - Whether to apply markdown-friendly formatting
+ * @returns Normalized text ready for WeChat MP delivery
+ */
+export declare function normalizeWechatMpText(text: string, renderMarkdown: boolean): string;
+/**
+ * Resolve the renderMarkdown setting from account config.
+ * Defaults to true if not explicitly set to false.
+ */
+export declare function resolveRenderMarkdown(config: {
+    renderMarkdown?: boolean;
+}): boolean;
+//# sourceMappingURL=text.d.ts.map

package/dist/src/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA+B,GACxC,MAAM,EAAE,CAmCV;AA2CD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAWnF;AAiGD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEnF"}

package/dist/src/text.js

@@ -0,0 +1,192 @@
+/**
+ * WeChat MP text normalization utilities
+ *
+ * Provides markdown-friendly text normalization that can be shared between
+ * the reply pipeline (dispatch.ts) and direct outbound (outbound.ts).
+ *
+ * The normalization behavior is controlled by the `renderMarkdown` config:
+ * - true (default): Apply markdown-friendly formatting for WeChat MP
+ * - false: Minimal passthrough, preserving original text
+ */
+/** WeChat MP text message byte limit (2048 bytes) */
+export const WECHAT_TEXT_BYTE_LIMIT = 2048;
+/**
+ * Calculate UTF-8 byte length of a string.
+ * @param str - The string to measure
+ * @returns The byte length in UTF-8 encoding
+ */
+export function getUtf8ByteLength(str) {
+    return Buffer.byteLength(str, "utf-8");
+}
+/**
+ * Split text by byte limit, respecting boundaries (paragraphs, sentences, spaces).
+ * Ensures no multi-byte characters are truncated.
+ *
+ * @param text - The text to split
+ * @param maxBytes - Maximum bytes per chunk (default: WECHAT_TEXT_BYTE_LIMIT)
+ * @returns Array of text chunks, each within the byte limit
+ */
+export function splitTextByByteLimit(text, maxBytes = WECHAT_TEXT_BYTE_LIMIT) {
+    if (getUtf8ByteLength(text) <= maxBytes) {
+        return [text];
+    }
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        // Find the maximum character length that fits within maxBytes
+        let end = remaining.length;
+        while (end > 0 && getUtf8ByteLength(remaining.slice(0, end)) > maxBytes) {
+            end--;
+        }
+        if (end === 0) {
+            // Single character exceeds limit (should not happen with 2048 bytes)
+            // Force take at least 1 character to avoid infinite loop
+            end = 1;
+        }
+        // Try to find a good boundary (paragraph > sentence > space)
+        const boundary = findBestBoundary(remaining, end);
+        if (boundary > 0) {
+            end = boundary;
+        }
+        const chunk = remaining.slice(0, end).trim();
+        if (chunk) {
+            chunks.push(chunk);
+        }
+        remaining = remaining.slice(end).trim();
+    }
+    return chunks;
+}
+/**
+ * Find the best boundary position for splitting text.
+ * Prioritizes: paragraphs > horizontal rules > sentences > spaces.
+ *
+ * @param text - The text to search
+ * @param maxPos - Maximum position to consider
+ * @returns Best boundary position, or 0 if none found
+ */
+function findBestBoundary(text, maxPos) {
+    const searchRegion = text.slice(0, maxPos);
+    // Priority: paragraph > horizontal rule > sentence > space
+    // Each tuple: [pattern, include pattern in chunk]
+    const boundaries = [
+        ["\n\n", true],
+        ["\n------------\n", true], // Converted markdown horizontal rule
+        ["\n---\n", true], // Markdown horizontal rule
+        ["\n***\n", true],
+        ["\n___\n", true],
+        ["\n", true],
+        ["。", true],
+        ["！", true],
+        ["？", true],
+        ["。 ", true],
+        ["! ", true],
+        ["? ", true],
+        [". ", true],
+        [" ", false],
+    ];
+    for (const [boundary, include] of boundaries) {
+        const pos = searchRegion.lastIndexOf(boundary);
+        // Ensure split point is not too early (at least 30% of maxPos)
+        if (pos > maxPos * 0.3) {
+            return include ? pos + boundary.length : pos;
+        }
+    }
+    return 0; // No suitable boundary found
+}
+/**
+ * Normalize text for WeChat MP delivery.
+ *
+ * When renderMarkdown is enabled (default), converts markdown to WeChat MP
+ * friendly plain text. When disabled, returns text with minimal changes.
+ *
+ * @param text - The raw text to normalize
+ * @param renderMarkdown - Whether to apply markdown-friendly formatting
+ * @returns Normalized text ready for WeChat MP delivery
+ */
+export function normalizeWechatMpText(text, renderMarkdown) {
+    const raw = String(text ?? "").trim();
+    if (!raw)
+        return "";
+    // When renderMarkdown is disabled, pass through with minimal normalization
+    if (!renderMarkdown) {
+        return raw;
+    }
+    // Apply markdown-friendly normalization for WeChat MP
+    return stripMarkdownForWechatMp(raw);
+}
+/**
+ * Strip markdown formatting and convert to WeChat MP friendly plain text.
+ *
+ * WeChat MP text messages do not support markdown, so we convert to a
+ * readable plain-text format similar to the wecom-app implementation.
+ */
+function stripMarkdownForWechatMp(text) {
+    let result = text;
+    // 1. Code blocks: extract content with indentation (preserve language label)
+    result = result.replace(/```(\w*)\n?([\s\S]*?)```/g, (_match, lang, code) => {
+        const trimmedCode = code.trim();
+        if (!trimmedCode)
+            return "";
+        const langLabel = lang ? `[${lang}]\n` : "";
+        const indentedCode = trimmedCode
+            .split("\n")
+            .map((line) => `    ${line}`)
+            .join("\n");
+        return `\n${langLabel}${indentedCode}\n`;
+    });
+    // 2. Headings: use brackets to mark
+    result = result.replace(/^#{1,6}\s+(.+)$/gm, "[$1]");
+    // 3. Bold/italic: preserve text (exclude underscores in URLs)
+    result = result
+        .replace(/\*\*(.*?)\*\*/g, "$1")
+        .replace(/\*(.*?)\*/g, "$1")
+        .replace(/__(.*?)__/g, "$1")
+        // Only replace standalone underscores (surrounded by space/punctuation), avoid URLs
+        .replace(/(?<![\w/])_(.+?)_(?![\w/])/g, "$1");
+    // 4. Unordered list items to bullet points
+    result = result.replace(/^[-*]\s+/gm, "- ");
+    // 5. Ordered lists keep numbering
+    result = result.replace(/^(\d+)\.\s+/gm, "$1. ");
+    // 6. Inline code: preserve content
+    result = result.replace(/`([^`]+)`/g, "$1");
+    // 7. Strikethrough
+    result = result.replace(/~~(.*?)~~/g, "$1");
+    // 8. Links: preserve text and URL
+    result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)");
+    // 9. Images: display alt text
+    result = result.replace(/!\[([^\]]*)\]\([^)]+\)/g, "[image: $1]");
+    // 10. Tables: simplify to aligned text (basic table support)
+    result = result.replace(/\|(.+)\|\n\|[-:| ]+\|\n((?:\|.+\|\n?)*)/g, (_match, header, body) => {
+        const headerCells = header.split("|").map((c) => c.trim()).filter(Boolean);
+        const rows = body.trim().split("\n").map((row) => row.split("|").map((c) => c.trim()).filter(Boolean));
+        // Calculate max width per column
+        const colWidths = headerCells.map((h, i) => {
+            const maxRowWidth = Math.max(...rows.map((r) => (r[i] || "").length));
+            return Math.max(h.length, maxRowWidth);
+        });
+        // Format header
+        const formattedHeader = headerCells
+            .map((h, i) => h.padEnd(colWidths[i]))
+            .join("  ");
+        // Format data rows
+        const formattedRows = rows
+            .map((row) => headerCells.map((_, i) => (row[i] || "").padEnd(colWidths[i])).join("  "))
+            .join("\n");
+        return `${formattedHeader}\n${formattedRows}\n`;
+    });
+    // 11. Blockquotes: remove > prefix
+    result = result.replace(/^>\s?/gm, "");
+    // 12. Horizontal rules
+    result = result.replace(/^[-*_]{3,}$/gm, "------------");
+    // 13. Collapse multiple blank lines
+    result = result.replace(/\n{3,}/g, "\n\n");
+    return result.trim();
+}
+/**
+ * Resolve the renderMarkdown setting from account config.
+ * Defaults to true if not explicitly set to false.
+ */
+export function resolveRenderMarkdown(config) {
+    return config.renderMarkdown !== false;
+}
+//# sourceMappingURL=text.js.map

package/dist/src/text.js.map

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

package/dist/src/text.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=text.test.d.ts.map

package/dist/src/text.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.test.d.ts","sourceRoot":"","sources":["../../src/text.test.ts"],"names":[],"mappings":""}

package/dist/src/text.test.js

@@ -0,0 +1,110 @@
+import { describe, expect, it } from "vitest";
+import { getUtf8ByteLength, splitTextByByteLimit, WECHAT_TEXT_BYTE_LIMIT, } from "./text.js";
+describe("wechat-mp text utils", () => {
+    describe("getUtf8ByteLength", () => {
+        it("calculates ASCII byte length", () => {
+            expect(getUtf8ByteLength("hello")).toBe(5);
+            expect(getUtf8ByteLength("12345")).toBe(5);
+        });
+        it("calculates Chinese character byte length (3 bytes per char)", () => {
+            expect(getUtf8ByteLength("你好")).toBe(6); // 2 chars * 3 bytes
+            expect(getUtf8ByteLength("测试")).toBe(6);
+        });
+        it("calculates mixed content byte length", () => {
+            expect(getUtf8ByteLength("hello你好")).toBe(11); // 5 + 6
+            expect(getUtf8ByteLength("abc测试123")).toBe(12); // 3 + 6 + 3
+        });
+        it("handles empty string", () => {
+            expect(getUtf8ByteLength("")).toBe(0);
+        });
+    });
+    describe("splitTextByByteLimit", () => {
+        it("returns single chunk when within limit", () => {
+            const text = "a".repeat(100);
+            const chunks = splitTextByByteLimit(text, 200);
+            expect(chunks).toHaveLength(1);
+            expect(chunks[0]).toBe(text);
+        });
+        it("splits at exact byte limit boundary", () => {
+            const text = "a".repeat(3000);
+            const chunks = splitTextByByteLimit(text, 1000);
+            expect(chunks.length).toBeGreaterThan(1);
+            // Each chunk should be within limit
+            for (const chunk of chunks) {
+                expect(getUtf8ByteLength(chunk)).toBeLessThanOrEqual(1000);
+            }
+        });
+        it("splits at paragraph boundary (\\n\\n)", () => {
+            const part1 = "a".repeat(500);
+            const part2 = "b".repeat(500);
+            const text = `${part1}\n\n${part2}`;
+            const chunks = splitTextByByteLimit(text, 600);
+            expect(chunks.length).toBeGreaterThan(1);
+            expect(chunks[0]).toContain(part1);
+            expect(chunks[1]).toContain(part2);
+        });
+        it("splits at horizontal rule (---)", () => {
+            const part1 = "a".repeat(500);
+            const part2 = "b".repeat(500);
+            const text = `${part1}\n---\n${part2}`;
+            const chunks = splitTextByByteLimit(text, 600);
+            expect(chunks.length).toBeGreaterThan(1);
+        });
+        it("splits at Chinese sentence boundary", () => {
+            const part1 = "中".repeat(300); // 900 bytes
+            const part2 = "文".repeat(300); // 900 bytes
+            const text = `${part1}。${part2}`;
+            const chunks = splitTextByByteLimit(text, 1000);
+            expect(chunks.length).toBeGreaterThan(1);
+        });
+        it("does not truncate multi-byte characters", () => {
+            // Create text that would be exactly at boundary
+            const chinese = "你".repeat(683); // 2049 bytes, slightly over limit
+            const chunks = splitTextByByteLimit(chinese, WECHAT_TEXT_BYTE_LIMIT);
+            // Verify no characters are corrupted
+            const rejoined = chunks.join("");
+            expect(rejoined).toBe(chinese);
+        });
+        it("handles mixed ASCII and Chinese content", () => {
+            const part1 = "hello " + "中".repeat(300);
+            const part2 = "world " + "文".repeat(300);
+            const text = `${part1}\n\n${part2}`;
+            const chunks = splitTextByByteLimit(text, 1000);
+            // Each chunk should be within limit
+            for (const chunk of chunks) {
+                expect(getUtf8ByteLength(chunk)).toBeLessThanOrEqual(1000);
+            }
+        });
+        it("splits very long text into multiple chunks", () => {
+            const text = "a".repeat(10000);
+            const chunks = splitTextByByteLimit(text, WECHAT_TEXT_BYTE_LIMIT);
+            expect(chunks.length).toBeGreaterThan(4);
+            // Verify all content is preserved
+            expect(chunks.join("")).toBe(text);
+        });
+        it("handles text with multiple paragraph breaks", () => {
+            const paragraphs = [
+                "First paragraph with some content here.",
+                "Second paragraph with more content here.",
+                "Third paragraph with even more content here.",
+            ];
+            const text = paragraphs.join("\n\n");
+            const chunks = splitTextByByteLimit(text, 50);
+            // Should split into multiple chunks at boundaries
+            expect(chunks.length).toBeGreaterThanOrEqual(3);
+            // Verify content preserved
+            const rejoined = chunks.join(" ");
+            expect(rejoined).toContain("First paragraph");
+            expect(rejoined).toContain("Second paragraph");
+            expect(rejoined).toContain("Third paragraph");
+        });
+        it("handles leading/trailing whitespace in short text", () => {
+            const text = "   hello world   ";
+            const chunks = splitTextByByteLimit(text, 100);
+            // Short text within limit is returned as-is
+            expect(chunks).toHaveLength(1);
+            expect(chunks[0]).toBe("   hello world   ");
+        });
+    });
+});
+//# sourceMappingURL=text.test.js.map

package/dist/src/text.test.js.map

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

package/dist/src/token.d.ts

@@ -0,0 +1,40 @@
+/**
+ * access_token lifecycle management for wechat-mp
+ *
+ * Provides centralized token caching, proactive refresh, and error handling.
+ */
+import type { ResolvedWechatMpAccount } from "./types.js";
+/**
+ * Get a cached access_token or fetch a new one.
+ * @throws Error if appId/appSecret not configured or API call fails
+ */
+export declare function getAccessToken(account: ResolvedWechatMpAccount): Promise<string>;
+/**
+ * Clear token cache for an account
+ */
+export declare function clearAccessTokenCache(account: ResolvedWechatMpAccount): void;
+/**
+ * Clear all token caches
+ */
+export declare function clearAllAccessTokenCache(): void;
+/**
+ * Check if a token needs refresh (expires within 5 minutes)
+ */
+export declare function shouldRefreshToken(account: ResolvedWechatMpAccount): boolean;
+/**
+ * Get token cache status
+ */
+export declare function getTokenCacheStatus(account: ResolvedWechatMpAccount): {
+    cached: boolean;
+    expiresAt?: number;
+    valid?: boolean;
+};
+/**
+ * Force refresh token (clear cache and fetch new)
+ */
+export declare function refreshToken(account: ResolvedWechatMpAccount): Promise<string>;
+/**
+ * Check if error code indicates invalid token
+ */
+export declare function isInvalidTokenError(errcode: number): boolean;
+//# sourceMappingURL=token.d.ts.map

package/dist/src/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAyB,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAsBjF;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BtF;AAgCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAU5E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAO5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAW1D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpF;AA+BD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}