@azurioh/discord-kernel 0.1.0

package/dist/discord/command/options.js

@@ -0,0 +1,509 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStringOption = createStringOption;
+exports.createUserOption = createUserOption;
+exports.createBooleanOption = createBooleanOption;
+exports.createIntegerOption = createIntegerOption;
+exports.createNumberOption = createNumberOption;
+exports.createDateTimeOption = createDateTimeOption;
+exports.createWallClockOption = createWallClockOption;
+exports.createDateOption = createDateOption;
+exports.createChannelOption = createChannelOption;
+exports.createRoleOption = createRoleOption;
+exports.createMentionableOption = createMentionableOption;
+exports.createAttachmentOption = createAttachmentOption;
+exports.allRequired = allRequired;
+const datetime_1 = require("../../datetime");
+const errors_1 = require("../../discord/command/errors");
+/** Applies the localization maps to a builder, if any were provided. */
+function applyOptionLocalizations(option, localizations) {
+    if (localizations.nameLocalizations) {
+        option.setNameLocalizations(localizations.nameLocalizations);
+    }
+    if (localizations.descriptionLocalizations) {
+        option.setDescriptionLocalizations(localizations.descriptionLocalizations);
+    }
+}
+const CHOICES_WITH_AUTOCOMPLETE_MESSAGE = "An option cannot declare both `choices` and `autocomplete`; Discord rejects the command.";
+/**
+ * Discord refuses a command whose option carries both a static choice list and
+ * an autocomplete resolver, so fail at registration rather than at deploy time.
+ */
+function assertChoicesAndAutocompleteExclusive(hasChoices, resolver) {
+    if (hasChoices && resolver !== undefined) {
+        throw new errors_1.OptionValidationError(CHOICES_WITH_AUTOCOMPLETE_MESSAGE);
+    }
+}
+class StringOption {
+    description;
+    isRequired;
+    choiceValues;
+    validator;
+    bounds;
+    autocomplete;
+    localizations;
+    constructor(description, isRequired, choiceValues, validator, bounds, autocomplete, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.choiceValues = choiceValues;
+        this.validator = validator;
+        this.bounds = bounds;
+        this.autocomplete = autocomplete;
+        this.localizations = localizations;
+    }
+    required() {
+        return new StringOption(this.description, true, this.choiceValues, this.validator, this.bounds, this.autocomplete, this.localizations);
+    }
+    choices(values) {
+        return new StringOption(this.description, this.isRequired, values, this.validator, this.bounds, this.autocomplete, this.localizations);
+    }
+    withAutocomplete(resolver) {
+        return new StringOption(this.description, this.isRequired, this.choiceValues, this.validator, this.bounds, resolver, this.localizations);
+    }
+    apply(container, name) {
+        assertChoicesAndAutocompleteExclusive(this.choiceValues !== null, this.autocomplete);
+        container.addStringOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            if (this.choiceValues) {
+                option.addChoices(...this.choiceValues.map((value) => ({ name: value, value })));
+            }
+            if (this.bounds.minLength !== undefined) {
+                option.setMinLength(this.bounds.minLength);
+            }
+            if (this.bounds.maxLength !== undefined) {
+                option.setMaxLength(this.bounds.maxLength);
+            }
+            if (this.autocomplete !== undefined) {
+                option.setAutocomplete(true);
+            }
+            return option;
+        });
+    }
+    read(interaction, name) {
+        const raw = interaction.options.getString(name, this.isRequired);
+        if (raw !== null && this.validator) {
+            this.validator(raw);
+        }
+        return raw;
+    }
+}
+function createStringOption(description, bounds = {}, localizations = {}) {
+    return new StringOption(description, false, null, null, bounds, undefined, localizations);
+}
+class UserOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new UserOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("User options do not support choices.");
+    }
+    apply(container, name) {
+        container.addUserOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getUser(name, this.isRequired);
+    }
+}
+function createUserOption(description, localizations = {}) {
+    return new UserOption(description, false, localizations);
+}
+class BooleanOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new BooleanOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Boolean options do not support choices.");
+    }
+    apply(container, name) {
+        container.addBooleanOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getBoolean(name, this.isRequired);
+    }
+}
+function createBooleanOption(description, localizations = {}) {
+    return new BooleanOption(description, false, localizations);
+}
+class IntegerOption {
+    description;
+    isRequired;
+    bounds;
+    autocomplete;
+    localizations;
+    constructor(description, isRequired, bounds, autocomplete, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.bounds = bounds;
+        this.autocomplete = autocomplete;
+        this.localizations = localizations;
+    }
+    required() {
+        return new IntegerOption(this.description, true, this.bounds, this.autocomplete, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Integer options do not support choices.");
+    }
+    withAutocomplete(resolver) {
+        return new IntegerOption(this.description, this.isRequired, this.bounds, resolver, this.localizations);
+    }
+    apply(container, name) {
+        container.addIntegerOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            if (this.bounds.min !== undefined) {
+                option.setMinValue(this.bounds.min);
+            }
+            if (this.bounds.max !== undefined) {
+                option.setMaxValue(this.bounds.max);
+            }
+            if (this.autocomplete !== undefined) {
+                option.setAutocomplete(true);
+            }
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getInteger(name, this.isRequired);
+    }
+}
+function createIntegerOption(description, bounds = {}, localizations = {}) {
+    return new IntegerOption(description, false, bounds, undefined, localizations);
+}
+class NumberOption {
+    description;
+    isRequired;
+    bounds;
+    autocomplete;
+    localizations;
+    constructor(description, isRequired, bounds, autocomplete, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.bounds = bounds;
+        this.autocomplete = autocomplete;
+        this.localizations = localizations;
+    }
+    required() {
+        return new NumberOption(this.description, true, this.bounds, this.autocomplete, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Number options do not support choices.");
+    }
+    withAutocomplete(resolver) {
+        return new NumberOption(this.description, this.isRequired, this.bounds, resolver, this.localizations);
+    }
+    apply(container, name) {
+        container.addNumberOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            if (this.bounds.min !== undefined) {
+                option.setMinValue(this.bounds.min);
+            }
+            if (this.bounds.max !== undefined) {
+                option.setMaxValue(this.bounds.max);
+            }
+            if (this.autocomplete !== undefined) {
+                option.setAutocomplete(true);
+            }
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getNumber(name, this.isRequired);
+    }
+}
+function createNumberOption(description, bounds = {}, localizations = {}) {
+    return new NumberOption(description, false, bounds, undefined, localizations);
+}
+const INVALID_DATETIME_MESSAGE = "Invalid date format. Use `YYYY-MM-DD HH:MM` (e.g. `2025-03-15 14:00`).";
+function assertValidDate(value, message) {
+    if (Number.isNaN(Date.parse(value))) {
+        throw new errors_1.OptionValidationError(message);
+    }
+}
+class DateTimeOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new DateTimeOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Date options do not support choices.");
+    }
+    apply(container, name) {
+        container.addStringOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        const raw = interaction.options.getString(name, this.isRequired);
+        if (raw === null) {
+            return null;
+        }
+        assertValidDate(raw, INVALID_DATETIME_MESSAGE);
+        return new Date(raw.replace(" ", "T"));
+    }
+}
+function createDateTimeOption(description, localizations = {}) {
+    return new DateTimeOption(description, false, localizations);
+}
+const INVALID_WALL_CLOCK_MESSAGE = "Invalid date format. Use `YYYY-MM-DD` or `YYYY-MM-DD HH:MM` (e.g. `2025-03-15 14:00`).";
+const INVALID_DATE_ONLY_MESSAGE = "Invalid date format. Use `YYYY-MM-DD` (e.g. `2025-03-15`).";
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * A raw `YYYY-MM-DD[ HH:MM[:SS]]` string, validated but *not* anchored to any
+ * timezone here — the core has no notion of "the guild's timezone", so
+ * anchoring (`zonedWallClockToUtc`) is the caller's job, once it knows which
+ * IANA zone applies. This is what lets the same option be reused by any module
+ * that needs a wall-clock input.
+ */
+class WallClockOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new WallClockOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Wall-clock options do not support choices.");
+    }
+    apply(container, name) {
+        container.addStringOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        const raw = interaction.options.getString(name, this.isRequired);
+        if (raw === null) {
+            return null;
+        }
+        if (!(0, datetime_1.isValidWallClock)(raw)) {
+            throw new errors_1.OptionValidationError(INVALID_WALL_CLOCK_MESSAGE);
+        }
+        return raw;
+    }
+}
+/**
+ * A `YYYY-MM-DD[ HH:MM[:SS]]` string option, validated against the wall-clock
+ * grammar but left unanchored (no `Date` conversion, no assumed timezone) — the
+ * caller anchors it with `zonedWallClockToUtc` once it knows the guild zone.
+ */
+function createWallClockOption(description, localizations = {}) {
+    return new WallClockOption(description, false, localizations);
+}
+/** A strict, date-only (`YYYY-MM-DD`) option — rejects any time component. */
+class DateOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new DateOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Date options do not support choices.");
+    }
+    apply(container, name) {
+        container.addStringOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        const raw = interaction.options.getString(name, this.isRequired);
+        if (raw === null) {
+            return null;
+        }
+        // Strict `YYYY-MM-DD` with a real-calendar check (rejects `2026/03/15`,
+        // time-bearing input, and impossible dates like `2026-02-30`).
+        if (!DATE_ONLY_PATTERN.test(raw) || !(0, datetime_1.isValidWallClock)(raw)) {
+            throw new errors_1.OptionValidationError(INVALID_DATE_ONLY_MESSAGE);
+        }
+        return new Date(raw);
+    }
+}
+/**
+ * A strict date-only (`YYYY-MM-DD`) option. The returned `Date` is UTC
+ * midnight of that calendar day — a caller that needs it anchored to a guild
+ * timezone (start/end of that guild-local day) uses `startOfGuildDay`/
+ * `endOfGuildDay` from `core/datetime`.
+ */
+function createDateOption(description, localizations = {}) {
+    return new DateOption(description, false, localizations);
+}
+class ChannelOption {
+    description;
+    isRequired;
+    channelTypes;
+    localizations;
+    constructor(description, isRequired, channelTypes, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.channelTypes = channelTypes;
+        this.localizations = localizations;
+    }
+    required() {
+        return new ChannelOption(this.description, true, this.channelTypes, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Channel options do not support choices.");
+    }
+    apply(container, name) {
+        container.addChannelOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            if (this.channelTypes !== undefined) {
+                option.addChannelTypes(...this.channelTypes);
+            }
+            return option;
+        });
+    }
+    read(interaction, name) {
+        // The declared types are re-sent at read time: `addChannelTypes` only drives
+        // the client-side picker, so Discord can still deliver another channel kind.
+        return interaction.options.getChannel(name, this.isRequired, this.channelTypes);
+    }
+}
+function createChannelOption(description, channelTypes, localizations = {}) {
+    return new ChannelOption(description, false, channelTypes, localizations);
+}
+class RoleOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new RoleOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Role options do not support choices.");
+    }
+    apply(container, name) {
+        container.addRoleOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getRole(name, this.isRequired);
+    }
+}
+function createRoleOption(description, localizations = {}) {
+    return new RoleOption(description, false, localizations);
+}
+class MentionableOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new MentionableOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Mentionable options do not support choices.");
+    }
+    apply(container, name) {
+        container.addMentionableOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getMentionable(name, this.isRequired);
+    }
+}
+function createMentionableOption(description, localizations = {}) {
+    return new MentionableOption(description, false, localizations);
+}
+class AttachmentOption {
+    description;
+    isRequired;
+    localizations;
+    constructor(description, isRequired, localizations = {}) {
+        this.description = description;
+        this.isRequired = isRequired;
+        this.localizations = localizations;
+    }
+    required() {
+        return new AttachmentOption(this.description, true, this.localizations);
+    }
+    choices(_values) {
+        throw new errors_1.OptionValidationError("Attachment options do not support choices.");
+    }
+    apply(container, name) {
+        container.addAttachmentOption((option) => {
+            option.setName(name).setDescription(this.description).setRequired(this.isRequired);
+            applyOptionLocalizations(option, this.localizations);
+            return option;
+        });
+    }
+    read(interaction, name) {
+        return interaction.options.getAttachment(name, this.isRequired);
+    }
+}
+function createAttachmentOption(description, localizations = {}) {
+    return new AttachmentOption(description, false, localizations);
+}
+/** Turn every option in a record into its required variant. */
+function allRequired(fields) {
+    const out = {};
+    for (const [key, option] of Object.entries(fields)) {
+        out[key] = option.required();
+    }
+    return out;
+}
+//# sourceMappingURL=options.js.map

package/dist/discord/command/options.js.map

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

package/dist/discord/command/permission-guard.d.ts

@@ -0,0 +1,21 @@
+import type { Guard } from "../../discord/command/guard";
+import { type PermissionBit } from "../../discord/permissions";
+import type { LocalizedText } from "../../i18n";
+/**
+ * Deny unless the member holds every permission in `required`.
+ *
+ * `interaction.memberPermissions` is `null` outside a guild; that is a denial,
+ * since an unknown permission set cannot be treated as a granted one.
+ */
+export declare function createPermissionGuard(required: readonly PermissionBit[], denyMessage?: LocalizedText): Guard;
+/**
+ * Deny unless the member holds one of `roleIds`.
+ *
+ * Outside a guild there is no member and therefore no role: deny. The member's
+ * role cache is authoritative here because `interactionCreate` always carries a
+ * fully resolved member object for guild interactions.
+ */
+export declare function createRoleGuard(roleIds: readonly string[], denyMessage?: LocalizedText): Guard;
+/** Deny outside a guild, so a handler can rely on the guild context existing. */
+export declare const guildOnlyGuard: Guard;
+//# sourceMappingURL=permission-guard.d.ts.map

package/dist/discord/command/permission-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-guard.d.ts","sourceRoot":"","sources":["../../../src/discord/command/permission-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAW5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,WAAW,CAAC,EAAE,aAAa,GACzB,KAAK,CAgBP;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,aAAa,GAAG,KAAK,CAc9F;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,KAO5B,CAAC"}

package/dist/discord/command/permission-guard.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guildOnlyGuard = void 0;
+exports.createPermissionGuard = createPermissionGuard;
+exports.createRoleGuard = createRoleGuard;
+const i18n_1 = require("../../discord/i18n");
+const permissions_1 = require("../../discord/permissions");
+/**
+ * Generic, reusable guards. They complement — never replace —
+ * `defaultMemberPermissions` on a command: that field only *hides* the command
+ * in the Discord client, and a server admin can override it in the Integrations
+ * UI. The guard is the enforcement that actually runs server-side.
+ */
+const ALLOW = { ok: true };
+/**
+ * Deny unless the member holds every permission in `required`.
+ *
+ * `interaction.memberPermissions` is `null` outside a guild; that is a denial,
+ * since an unknown permission set cannot be treated as a granted one.
+ */
+function createPermissionGuard(required, denyMessage) {
+    return {
+        check(interaction) {
+            const missing = (0, permissions_1.missingPermissions)(interaction.memberPermissions, required);
+            if (missing.length === 0) {
+                return ALLOW;
+            }
+            return {
+                ok: false,
+                message: denyMessage ?? {
+                    key: i18n_1.CORE_MESSAGES.guardPermissionDenied,
+                    params: { missing: (0, permissions_1.formatPermissions)(missing) },
+                },
+            };
+        },
+    };
+}
+/**
+ * Deny unless the member holds one of `roleIds`.
+ *
+ * Outside a guild there is no member and therefore no role: deny. The member's
+ * role cache is authoritative here because `interactionCreate` always carries a
+ * fully resolved member object for guild interactions.
+ */
+function createRoleGuard(roleIds, denyMessage) {
+    return {
+        check(interaction) {
+            const member = interaction.member;
+            if (!member || !interaction.inCachedGuild()) {
+                return { ok: false, message: denyMessage ?? { key: i18n_1.CORE_MESSAGES.guardGuildOnly } };
+            }
+            const held = interaction.member.roles.cache;
+            if (roleIds.some((roleId) => held.has(roleId))) {
+                return ALLOW;
+            }
+            return { ok: false, message: denyMessage ?? { key: i18n_1.CORE_MESSAGES.guardRoleDenied } };
+        },
+    };
+}
+/** Deny outside a guild, so a handler can rely on the guild context existing. */
+exports.guildOnlyGuard = {
+    check(interaction) {
+        if (interaction.inGuild()) {
+            return ALLOW;
+        }
+        return { ok: false, message: { key: i18n_1.CORE_MESSAGES.guardGuildOnly } };
+    },
+};
+//# sourceMappingURL=permission-guard.js.map

package/dist/discord/command/permission-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-guard.js","sourceRoot":"","sources":["../../../src/discord/command/permission-guard.ts"],"names":[],"mappings":";;;AAqBA,sDAmBC;AASD,0CAcC;AA7DD,yCAA+C;AAC/C,uDAAkG;AAGlG;;;;;GAKG;AAEH,MAAM,KAAK,GAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAExC;;;;;GAKG;AACH,SAAgB,qBAAqB,CACpC,QAAkC,EAClC,WAA2B;IAE3B,OAAO;QACN,KAAK,CAAC,WAA+B;YACpC,MAAM,OAAO,GAAG,IAAA,gCAAkB,EAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC;YACd,CAAC;YACD,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,WAAW,IAAI;oBACvB,GAAG,EAAE,oBAAa,CAAC,qBAAqB;oBACxC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAA,+BAAiB,EAAC,OAAO,CAAC,EAAE;iBAC/C;aACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,OAA0B,EAAE,WAA2B;IACtF,OAAO;QACN,KAAK,CAAC,WAA+B;YACpC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;YAClC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC;gBAC7C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE,GAAG,EAAE,oBAAa,CAAC,cAAc,EAAE,EAAE,CAAC;YACrF,CAAC;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YAC5C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAC;YACd,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE,GAAG,EAAE,oBAAa,CAAC,eAAe,EAAE,EAAE,CAAC;QACtF,CAAC;KACD,CAAC;AACH,CAAC;AAED,iFAAiF;AACpE,QAAA,cAAc,GAAU;IACpC,KAAK,CAAC,WAA+B;QACpC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACd,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,oBAAa,CAAC,cAAc,EAAE,EAAE,CAAC;IACtE,CAAC;CACD,CAAC"}