@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/files/index.js

@@ -0,0 +1,64 @@
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { CliError } from "@wirecat/cli-base";
+// Node 22's Windows path stat uses a 64-bit volume serial; handle stat uses its low DWORD.
+const deviceOf = (dev) => (process.platform === "win32" ? BigInt.asUintN(32, dev) : dev);
+/** Check the opened object before reading: Windows has no O_NOFOLLOW support. */
+export const openOrdinaryFile = async (path) => {
+    const before = await lstat(path, { bigint: true });
+    if (before.isSymbolicLink())
+        throw new CliError("validation_error", "archive path must be an ordinary file without a symlink");
+    if (!before.isFile())
+        throw new CliError("validation_error", "archive path must be an ordinary file");
+    const flags = process.platform === "win32"
+        ? constants.O_RDONLY
+        : constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0);
+    const file = await open(path, flags);
+    try {
+        const opened = await file.stat({ bigint: true });
+        const after = await lstat(path, { bigint: true });
+        if (!opened.isFile() || !after.isFile() || before.ino !== opened.ino || before.ino !== after.ino)
+            throw new CliError("validation_error", "archive file changed while opening");
+        if (process.platform === "win32" && before.dev === 0n && after.dev === 0n) {
+            // Older Windows path stats omit the device; compare two handles before any content read.
+            const witness = await open(path, flags);
+            try {
+                const identified = await witness.stat({ bigint: true });
+                const final = await lstat(path, { bigint: true });
+                if (opened.dev === 0n ||
+                    !identified.isFile() ||
+                    !final.isFile() ||
+                    deviceOf(identified.dev) !== deviceOf(opened.dev) ||
+                    identified.ino !== opened.ino ||
+                    final.ino !== before.ino ||
+                    (final.dev !== 0n && deviceOf(final.dev) !== deviceOf(opened.dev)))
+                    throw new CliError("validation_error", "archive file changed while opening");
+            }
+            finally {
+                await witness.close();
+            }
+        }
+        else if (deviceOf(before.dev) !== deviceOf(opened.dev) || deviceOf(before.dev) !== deviceOf(after.dev)) {
+            throw new CliError("validation_error", "archive file changed while opening");
+        }
+        return file;
+    }
+    catch (error) {
+        await file.close();
+        throw error;
+    }
+};
+export const syncDirectory = async (path) => {
+    if (process.platform === "win32")
+        return;
+    const directory = await open(path, constants.O_RDONLY | (constants.O_DIRECTORY ?? 0) | (constants.O_NOFOLLOW ?? 0));
+    try {
+        if (!(await directory.stat()).isDirectory())
+            throw new CliError("validation_error", "archive publication directory must be ordinary");
+        await directory.sync();
+    }
+    finally {
+        await directory.close();
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/files/index.js.map

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

package/dist/index.d.ts

@@ -1,20 +1,23 @@
-export { loadConfigFile, saveConfigFile, writeSecurely } from "./config.js";
-export type { CredentialSource, CredentialStorage, CredentialsOptions, StoredCredential } from "./credentials.js";
-export { CREDENTIAL_STORAGE, Credentials, keyringService } from "./credentials.js";
-export { createDeadline, type Deadline, type DeadlineOptions } from "./deadline.js";
-export { CliError, type CliErrorDetails, type ErrorCode, errorCodes, isCliError } from "./errors.js";
-export { EXIT_CODES, exitCodeFor, GENERIC_FAILURE } from "./exit-codes.js";
-export { brokenKeyring, type KeyringStore, memoryKeyring, systemKeyring } from "./keyring.js";
-export { type LegacyMove, legacyMacPaths, type MigrateLegacyPathsOptions, migrateLegacyMacPaths, } from "./legacy-paths.js";
-export { type Logger, noopLogger } from "./logger.js";
-export { createFileLogger, type FileLogger, type FileLoggerOptions, REDACTED_FIELDS } from "./logging.js";
-export { createOutputBuffer, type OutputBuffer, type OutputBufferOptions } from "./output-buffer.js";
-export { configFilePath, type Paths, type PathsOptions, pathsAreOverridden, resolvePaths } from "./paths.js";
-export { indent, type PrettyOptions, renderPretty } from "./pretty.js";
-export { createRenderer, RENDER_FORMATS, type Renderer, type RendererOptions, type RenderFormat, } from "./renderer.js";
-export { fieldsOf, projectFields } from "./result-fields.js";
-export { backoffMs, DEFAULT_RETRY, isTransportFailure, type RetryConfig } from "./retry.js";
-export { singleLine, visibleControls } from "./sanitize.js";
-export { captureStreams, processStreams, type Streams } from "./streams.js";
-export { abortError, type MonotonicClock, monotonic, realSleep, type SleepLike, type SleepReason, type WallClock, wallClock, } from "./time.js";
+export type { CounterField, CounterObservation, CounterObservations, CounterState } from "./domain/counters.js";
+export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { type FormattedText, type HtmlFormatting, type MarkdownFormatting, type TextSpan, validateFormattedText, } from "./domain/formatting.js";
+export { formatLocator, isLocator, type MessageLocator, parseLocator } from "./domain/locator.js";
+export { type Markup, parseMarkdown } from "./domain/markdown.js";
+export { canonicalMeetingReference, formatMeetingReference, type MeetingReference, parseMeetingReference, } from "./domain/meeting-reference.js";
+export type { MessageLink, MessagePermalink } from "./domain/message-link.js";
+export type * from "./domain/models.js";
+export type { RankingGraphEvidence, RankingGraphLink } from "./domain/rankings-graph.js";
+export type { RankingComponent, RankingInput, RankingMeasure, RankingOptions, RankingTarget, RankingWeights, ScorePreset, } from "./domain/rankings-options.js";
+export { rankingOptions } from "./domain/rankings-options.js";
+export { canonicalReference, formatReference, parseReference, type Reference } from "./domain/references.js";
+export { normalizeTag, TAG_TYPES, type TagType } from "./domain/tags.js";
+export type { CheckRow, Finding, Moderator } from "./moderation/check.js";
+export { act, judge } from "./moderation/check.js";
+export type { GroupRules } from "./moderation/rules.js";
+export { defaultRules, ModerationRules, moderationPathFor } from "./moderation/rules.js";
+export { type OutputOptions, resolveOutput } from "./output.js";
+export { type RenderOptions, renderMessage, renderMessages } from "./render/messages.js";
+export { isId, type PeopleLookup, pickChat, pickPerson } from "./resolve.js";
+export { readSecret, type SecretInput } from "./terminal/prompt.js";
+export { qrPng, terminalQr } from "./terminal/qr.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EACL,KAAK,UAAU,EACf,cAAc,EACd,KAAK,yBAAyB,EAC9B,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,SAAS,EACT,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/G,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,qBAAqB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAE,KAAK,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAA;AACtC,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC7E,mBAAmB,oBAAoB,CAAA;AACvC,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AACxF,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAC5G,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACxE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -1,19 +1,16 @@
-export { loadConfigFile, saveConfigFile, writeSecurely } from "./config.js";
-export { CREDENTIAL_STORAGE, Credentials, keyringService } from "./credentials.js";
-export { createDeadline } from "./deadline.js";
-export { CliError, errorCodes, isCliError } from "./errors.js";
-export { EXIT_CODES, exitCodeFor, GENERIC_FAILURE } from "./exit-codes.js";
-export { brokenKeyring, memoryKeyring, systemKeyring } from "./keyring.js";
-export { legacyMacPaths, migrateLegacyMacPaths, } from "./legacy-paths.js";
-export { noopLogger } from "./logger.js";
-export { createFileLogger, REDACTED_FIELDS } from "./logging.js";
-export { createOutputBuffer } from "./output-buffer.js";
-export { configFilePath, pathsAreOverridden, resolvePaths } from "./paths.js";
-export { indent, renderPretty } from "./pretty.js";
-export { createRenderer, RENDER_FORMATS, } from "./renderer.js";
-export { fieldsOf, projectFields } from "./result-fields.js";
-export { backoffMs, DEFAULT_RETRY, isTransportFailure } from "./retry.js";
-export { singleLine, visibleControls } from "./sanitize.js";
-export { captureStreams, processStreams } from "./streams.js";
-export { abortError, monotonic, realSleep, wallClock, } from "./time.js";
+export { COUNTER_FIELDS, counterValue, observedCounters } from "./domain/counters.js";
+export { validateFormattedText, } from "./domain/formatting.js";
+export { formatLocator, isLocator, parseLocator } from "./domain/locator.js";
+export { parseMarkdown } from "./domain/markdown.js";
+export { canonicalMeetingReference, formatMeetingReference, parseMeetingReference, } from "./domain/meeting-reference.js";
+export { rankingOptions } from "./domain/rankings-options.js";
+export { canonicalReference, formatReference, parseReference } from "./domain/references.js";
+export { normalizeTag, TAG_TYPES } from "./domain/tags.js";
+export { act, judge } from "./moderation/check.js";
+export { defaultRules, ModerationRules, moderationPathFor } from "./moderation/rules.js";
+export { resolveOutput } from "./output.js";
+export { renderMessage, renderMessages } from "./render/messages.js";
+export { isId, pickChat, pickPerson } from "./resolve.js";
+export { readSecret } from "./terminal/prompt.js";
+export { qrPng, terminalQr } from "./terminal/qr.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAuC,MAAM,eAAe,CAAA;AACnF,OAAO,EAAE,QAAQ,EAAwC,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAqB,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EAEL,cAAc,EAEd,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAe,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAA2C,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,kBAAkB,EAA+C,MAAM,oBAAoB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAiC,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAsB,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,GAIf,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EAEV,SAAS,EACT,SAAS,EAIT,SAAS,GACV,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACrF,OAAO,EAKL,qBAAqB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAuB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACjG,OAAO,EAAe,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EAEtB,qBAAqB,GACtB,MAAM,+BAA+B,CAAA;AAatC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAkB,MAAM,wBAAwB,CAAA;AAC5G,OAAO,EAAE,YAAY,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAA;AAExE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAsB,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAsB,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAqB,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAoB,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/kit/contract.d.ts

@@ -0,0 +1,39 @@
+import { type MessengerAdapter } from "../cli/messenger/port.js";
+import { type IdMaker, type Seed } from "./seed.js";
+export interface ContractCase {
+    name: string;
+    /** What the adapter's fake must do beyond holding the seed, where a case asks more of it. */
+    needs?: string;
+    /** Throws an `AssertionError` on a broken promise; `skipped` names the optional method the adapter lacks. */
+    run(): Promise<undefined | {
+        skipped: string;
+    }>;
+}
+export interface ContractOptions {
+    /** A fresh adapter over `seed` — the CLI's own fake, filled from it. Called once for every case. */
+    connect: (seed: Seed) => MessengerAdapter | Promise<MessengerAdapter>;
+    /** How the seed names things; non-digit `wordIds` unless the messenger's ids have a shape of their own. */
+    ids?: IdMaker;
+    /** As the messenger's `fetching.orderBy`: whether `history`'s `before` is a message id or an ISO time. */
+    orderBy?: "id" | "time";
+    /** How long `watch` may take to say it listens, and to end once aborted. */
+    waitMs?: number;
+    /** As the messenger's `history`: a `"server"` messenger's adapter must have every `ServerReads` method. */
+    history?: "server" | "store";
+}
+/** Every method of the optional groups, which `capability` hands over or refuses. */
+export declare const OPTIONAL_METHODS: readonly ["fetchCounters", "chats", "history", "around", "contact", "historyAfter", "historyBefore", "topics", "inspect", "edit", "forward", "delete", "pin", "unpin", "react", "markRead", "poll", "vote", "closePoll", "createPoll", "watch", "feed", "download", "transcribe", "scheduled", "members", "admins", "chatEvents", "sessions", "lookup", "addressBook", "people", "createGroup", "join", "leave", "group", "updateGroup", "resetInviteLink", "addMembers", "removeMembers", "addAdmin", "removeAdmin", "folders", "createFolder", "updateFolder", "deleteFolder", "addContact", "removeContact", "block", "unblock", "renameContact", "importContacts", "updateProfile", "endOtherSessions"];
+/**
+ * The port's promises as cases any test runner can run: each connects through `connect`, checks
+ * with `node:assert/strict` and closes the adapter. None needs a live service.
+ *
+ * ```ts
+ * for (const one of contractCases({ connect: (seed) => myAdapter(fakeClientFrom(seed)) }))
+ *   it(one.name, async (context) => {
+ *     const result = await one.run()
+ *     if (result) context.skip(result.skipped)
+ *   })
+ * ```
+ */
+export declare const contractCases: ({ connect, ids, orderBy, waitMs, history, }: ContractOptions) => ContractCase[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/kit/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/kit/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiC,KAAK,gBAAgB,EAAoB,MAAM,0BAA0B,CAAA;AAGjH,OAAO,EAA2B,KAAK,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAA;AAErF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6GAA6G;IAC7G,GAAG,IAAI,OAAO,CAAC,SAAS,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,eAAe;IAC9B,oGAAoG;IACpG,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrE,2GAA2G;IAC3G,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,0GAA0G;IAC1G,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2GAA2G;IAC3G,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAC7B;AAWD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,6qBAoD2B,CAAA;AAmCxD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,gDAMvB,eAAe,KAAG,YAAY,EAkXhC,CAAA"}