@seedcord/core 0.1.1-next.0 → 0.1.2

package/dist/{cursor-Bk-W5MTq.d.mts → cursor-C77xH5QT.d.mts}

@@ -1,5 +1,5 @@
-import { n as CommandBuilder, r as DeployResult, t as Constructor } from "./basic-CeSFvbaz.mjs";
-import { A as AckState, D as Notice, O as ReplyTelemetry, V as InteractionRoutes, g as CoreBase } from "./Plugin-BPz0obbN.mjs";
+import { n as CommandBuilder, r as DeployResult, t as Constructor } from "./basic-Dng__Ena.mjs";
+import { A as AckState, D as Notice, O as ReplyTelemetry, V as InteractionRoutes, g as CoreBase } from "./Plugin-qRc7Ch4g.mjs";
 import "reflect-metadata";
 import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
 import { APIMessageTopLevelComponent, APIModalInteractionResponseCallbackData, ApplicationCommandType, ChannelType, Snowflake } from "discord-api-types/v10";
@@ -119,11 +119,7 @@ interface InjectedContextMenuMap {
  * ```
  */
 declare const ContextMenus: InjectedContextMenuMap;
-/**
- * Records each deployed command on {@link Commands} and {@link ContextMenus}.
- *
- * @internal
- */
+/** @internal */
 declare class CommandInjector {
   private readonly logger;
   inject(deploy: DeployResult, all: readonly CommandBuilder[]): void;
@@ -202,21 +198,14 @@ type RowType = keyof typeof RowTypes;
 type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;
 //#endregion
 //#region src/components/Component.d.ts
-/**
- * Base class for Discord component wrappers.
- *
- * @typeParam TComponent - The Discord.js component type being wrapped
- *
- * @internal
- */
+/** @internal */
 declare abstract class BaseComponent<TComponent> {
   private readonly _component;
   protected constructor(ComponentClass: new () => TComponent);
   /**
    * Returns the live builder, ready to send in a Discord message or nest in another component.
    *
-   * Configure it through `this.instance`. Reading this can apply the bot color (see
-   * {@link BuilderComponent}), so it has a side effect.
+   * Reading this can apply the bot color (see {@link BuilderComponent}), so it has a side effect.
    * @example new SomeComponent().component
    */
   abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;
@@ -375,7 +364,6 @@ type CommandMeta = GlobalMeta | GuildMeta;
 /**
  * Attaches deployment metadata so the framework registers this command globally or in specific guilds.
  *
- * @param scope - Must be 'global' for global registration
  * @decorator
  * @example
  * ```typescript
@@ -387,7 +375,6 @@ declare function RegisterCommand(scope: 'global'): (ctor: CommandCtor) => void;
 /**
  * Registers a command for specific guild deployment.
  *
- * @param scope - Must be 'guild' for guild-specific registration
  * @param guilds - Array of guild IDs where the command should be registered
  * @decorator
  * @example
@@ -434,7 +421,8 @@ type DecodedParams<Shape extends CustomIdShape> = { [Name in keyof Shape]: Shape
 declare function prefixOf(wire: string): string;
 /**
  * A typed customId. The single source of truth shared by the component that mints it and the handler
- * that reads it. This gives you typed reads on the `.customId` field in components. Values are packed into a compact wire string rather than plain stringified tokens, so the 100-char Discord limit goes further. More string per string, basically.
+ * that reads it. This gives you typed reads on the `.customId` field in components. Values are packed
+ * into a compact wire string, which fits more of them inside Discord's 100-char limit.
  *
  * @typeParam Prefix - The stable route prefix, e.g. 'approve'.
  * @typeParam Shape - The accumulated fields, filled in by the chain.
@@ -448,7 +436,7 @@ declare function prefixOf(wire: string): string;
  * // Set the custom id on a button when creating it.
  * new ButtonBuilder().setCustomId(ApproveId.encode({ userId: '123', action: 'approve' }));
  *
- * // reading in the handler: userId comes back a string
+ * // in the handler, userId comes back a string
  * const { userId, action } = this.params; // userId: string, action: 'approve' | 'deny'
  * await this.event.guild?.members.fetch(userId);
  * ```
@@ -456,7 +444,7 @@ declare function prefixOf(wire: string): string;
 declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}> {
   /** The stable route prefix, e.g. 'approve'. */
   readonly prefix: Prefix;
-  /** Like a zod shape */
+  /** The field definitions accumulated by the chain, keyed by name. */
   readonly shape: Shape;
   /** The prefix plus a short hash of the shape, the part of the wire before the colon. */
   readonly routeKey: string;
@@ -517,7 +505,8 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
    */
   oneOf<Name extends string, const Choices extends NonEmptyTuple<string>>(name: Name, choices: Choices): CustomId<Prefix, Shape & Record<Name, CustomIdField<Choices[number]>>>;
   /**
-   * Add a free short text field. Avoid it where possible, it cannot be packed so it costs the most wire space.
+   * Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
+   * expensive field on the wire.
    *
    * @example
    * ```ts
@@ -545,11 +534,7 @@ declare class CustomId<Prefix extends string, Shape extends CustomIdShape = {}>
   /** True if this wire was minted from this customId's prefix, ignoring the shape hash. */
   owns(wire: string): boolean;
 }
-/**
- * Any customId, for places where the exact prefix and shape do not matter.
- *
- * @internal
- */
+/** @internal */
 type AnyCustomId = CustomId<string, CustomIdShape>;
 /**
  * The outcome of decoding a wire against several customIds, the matched prefix paired with its values.
@@ -560,11 +545,7 @@ type DecodedRoute<Defs extends readonly AnyCustomId[]> = { [Index in keyof Defs]
   readonly prefix: Defs[Index]['prefix'];
   readonly params: DecodedParams<Defs[Index]['shape']>;
 } : never; }[number];
-/**
- * Find the customId whose prefix owns this wire, decode against it, and report which one matched.
- *
- * @internal
- */
+/** @internal */
 declare function decodeFor<Defs extends readonly AnyCustomId[]>(defs: Defs, wire: string): DecodedRoute<Defs>;
 //#endregion
 //#region src/decorators/interactionRoutes.d.ts
@@ -579,7 +560,7 @@ declare enum SelectMenuKind {
 type RoutableConstructor = new (...args: never[]) => unknown;
 declare function areRoutes(routes: unknown): routes is string[];
 /**
- * Every stored route kind and its route strings on a decorated constructor. The build's manifest
+ * every stored route kind and its route strings on a decorated constructor. the build's manifest
  * emitter reads the same pairs.
  */
 declare function interactionRoutesOf(constructor: RoutableConstructor): [InteractionRoutes, string[]][];
@@ -589,13 +570,11 @@ declare function selectMenuRouteOf(kind: SelectMenuKind): InteractionRoutes;
 declare function contextMenuRouteOf(kind: ContextMenuKind): InteractionRoutes;
 //#endregion
 //#region src/reply/serializeReply.d.ts
-/** Serialized message data the transport wire writers consume. */
 interface SerializedReply<TNative = never> {
   readonly components: APIMessageTopLevelComponent[];
   readonly allowedMentions?: ReplyResponse['allowedMentions'];
   readonly files?: ReplyResponse<TNative>['files'];
 }
-/** Wraps a string in a TextDisplay component. */
 declare function serializeReply<TNative>(response: ReplyResponse<TNative> | string, routeId: string): SerializedReply<TNative>;
 //#endregion
 //#region src/reply/BaseReplySender.d.ts
@@ -605,9 +584,9 @@ interface ModalLike {
 }
 /**
  * Tracks acknowledgement state and throws a translated `SeedcordError` on an illegal verb before any
- * transport call. Verbs execute the legality check, control the transport wire writer, then update the
- * state and ack trace. Each transport binds `TMessage` to its created-message lens and supplies the
- * writers.
+ * transport call. Every verb runs the legality check, calls the transport's wire writer, then updates
+ * the state and the ack trace. Each transport binds `TMessage` to its own created-message type and
+ * supplies the writers.
  */
 declare abstract class BaseReplySender<TMessage extends {
   id: string;
@@ -624,7 +603,7 @@ declare abstract class BaseReplySender<TMessage extends {
   defer(opts?: DeferOpts): Promise<void>;
   deferUpdate(): Promise<void>;
   /**
-   * After a deferUpdate the state stays deferred-update, so the rewrite repeats. The returned message
+   * After a deferUpdate the state stays deferred-update. Calling this again rewrites. The returned message
    * is the source message, editable only through a bare `update` or `edit`. A targeted `edit` or `delete`
    * of it throws the foreign-target error.
    */
@@ -688,7 +667,7 @@ interface GateContextBase {
   readonly memberRoleIds: readonly string[];
   /**
    * The member's permission bits, or null outside a guild. On an interaction these are the
-   * channel-scoped permissions the payload contains, on a gateway event the member's guild-level ones.
+   * channel-scoped permissions the payload contains, and on a gateway event they're the member's guild-level ones.
    */
   readonly memberPermissions: bigint | null;
   /**
@@ -731,8 +710,8 @@ declare const GateBrand: unique symbol;
  * a field absent on a handler's context is rejected at compile time. `Name` is captured as a literal so
  * a mismatch error can name the gate. Build one with {@link defineGate} or {@link defineEffectGate}.
  *
- * @typeParam Ctx - The context the gate requires, so reading a field absent on a handler's context is a compile error.
- * @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+ * @typeParam Ctx - The context the gate requires. A field missing from it is a compile error.
+ * @typeParam Name - The gate's literal name, named in a mismatch error.
  *
  * @example
  * ```ts
@@ -756,12 +735,12 @@ interface Gate<Ctx extends GateContextBase = GateContextBase, Name extends strin
 }
 /**
  * A gate that carries a side effect, split so the effect fires only once the gate is the one that
- * let the request through. `check` peeks and refuses, `commit` applies the effect after the whole
+ * let the request through. `check` peeks and refuses, while `commit` applies the effect after the whole
  * gate set passes. {@link Cooldown} is the catalog gate that returns one. Build one with
  * {@link defineEffectGate}.
  *
- * @typeParam Ctx - The context the gate requires, so reading a field absent on a handler's context is a compile error.
- * @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+ * @typeParam Ctx - The context both `check` and `commit` require. A field missing from it fails to compile.
+ * @typeParam Name - The gate's literal name, shown when a mismatch error names the gate.
  *
  * @example
  * ```ts
@@ -791,7 +770,7 @@ interface EffectGate<Ctx extends GateContextBase = GateContextBase, Name extends
  * the check reads. No annotation defaults to {@link GateContextBase}, an agnostic gate that fits every
  * handler.
  *
- * @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+ * @typeParam Name - The gate's name, captured as a literal for mismatch errors.
  * @typeParam Ctx - The context the check reads, inferred from the `ctx` annotation.
  *
  * @param name - The gate's name, used in mismatch errors.
@@ -825,7 +804,7 @@ declare function defineGate<const Name extends string, Ctx extends GateContextBa
  * commits. In an `or`, a refusing arm's queued commit is rolled back. This is how {@link Cooldown} peeks
  * in `check` and charges the slot in `commit`.
  *
- * @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+ * @typeParam Name - The gate's literal name, used to name a mismatch error.
  * @typeParam Ctx - The context both `check` and `commit` read, inferred from the `ctx` annotation.
  *
  * @param name - The gate's name, used in mismatch errors.
@@ -843,7 +822,7 @@ declare function defineGate<const Name extends string, Ctx extends GateContextBa
  *     return defineEffectGate(
  *         'UsesPerDay',
  *         (ctx) => {
- *             // peek and refuse by throwing, do not mutate yet
+ *             // peek and refuse by throwing. do not mutate yet
  *             if (usedToday(ctx.userId) >= max) throw new OutOfUsesNotice(max);
  *         },
  *         (ctx) => {
@@ -907,7 +886,6 @@ declare function pickNotice(options: GateNoticeOptions | undefined, makeDefault:
  * `discord-api-types/v10` (or `discord.js`).
  */
 type PermissionScope = readonly bigint[];
-/** Permission bit to its prettified human-readable name. */
 declare const PermissionNames: Map<bigint, string>;
 //#endregion
 //#region src/gates/catalog/permissions.d.ts
@@ -981,7 +959,7 @@ declare function RequirePermissions(scope: PermissionScope, options?: RequirePer
  *
  * The default `'channel'` scope reads the bot's effective channel set (wire `app_permissions`), what
  * Discord enforces in the invoked channel. The `'guild'` scope reads the bot's base set from roles and
- * requires a {@link GuildPermissionsContext}, so it fits a gateway handler only. `app_permissions` is
+ * requires a {@link GuildPermissionsContext}, fitting a gateway handler only. `app_permissions` is
  * absent on gateway events, the channel scope refuses there as unresolved, use `in: 'guild'` on an
  * event handler.
  *
@@ -1042,7 +1020,7 @@ type ChoiceValueOf<Entry> = Entry extends {
 } ? string : Entry extends {
   kind: 'integer' | 'number';
 } ? number : never;
-/** The focused option. `value` is the raw partial Discord delivers mid-type, always a string regardless of kind. */
+/** the focused option. `value` is the raw partial discord delivers mid-type, always a string regardless of kind. */
 interface FocusedField<Route extends keyof SlashOptionRegistry> {
   name: AutocompletableNames<Route>;
   value: string;
@@ -1081,4 +1059,4 @@ type PageCursor<Prefix extends string> = CustomId<Prefix, {
 declare function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix>;
 //#endregion
 export { RowType as $, ModalLike as A, storeInteractionRoute as B, Gate as C, defineEffectGate as D, RequiredOf as E, areRoutes as F, DecodedParams as G, CustomId as H, contextMenuRouteOf as I, Promisable as J, CommandMeta as K, interactionRoutesOf as L, serializeReply as M, RoutableConstructor as N, defineGate as O, SelectMenuKind as P, BuilderType as Q, selectMenuRouteOf as R, EffectGate as S, GuildPermissionsContext as T, decodeFor as U, AnyCustomId as V, prefixOf as W, BuilderComponent as X, IsNever as Y, RowComponent as Z, pickNotice as _, AutocompleteOptions as a, InjectedCommandMap as at, JoinNames as b, FocusedField as c, SlashOption as ct, RequirePermissionsOptions as d, MessageContextMenuRegistry as dt, CommandInfo as et, RequireRole as f, UserContextMenuRegistry as ft, GateNoticeOptions as g, PermissionScope as h, AutocompletableNames as i, ContextMenus as it, SerializedReply as j, BaseReplySender as k, RequireBotPermissions as l, SlashOptionRegistry as lt, PermissionNames as m, PageCursor as n, Commands as nt, ChoiceValueOf as o, InjectedContextMenuMap as ot, RequireRoleOptions as p, RegisterCommand as q, pageCursor as r, ContextMenuInfo as rt, EntryFor as s, OptionKind as st, PAGE_MAX as t, CommandInjector as tt, RequirePermissions as u, ContextMenuKind as ut, GateFitsWith as v, GateContextBase as w, TwoOrMore as x, IntersectRequired as y, storeComponentRoute as z };
-//# sourceMappingURL=cursor-Bk-W5MTq.d.mts.map
+//# sourceMappingURL=cursor-C77xH5QT.d.mts.map

package/dist/{cursor-Y6ct-N_8.mjs → cursor-D207VrRo.mjs}

@@ -1,4 +1,4 @@
-import { d as InteractionRouteKeys, f as InteractionRoutes, g as contextMenuLeaves, i as BuilderComponent, u as InteractionMetadataKey } from "./publishDefault-CldnxcT2.mjs";
+import { d as InteractionRouteKeys, f as InteractionRoutes, g as contextMenuLeaves, i as BuilderComponent, u as InteractionMetadataKey } from "./publishDefault-BCrMG9T8.mjs";
 import "reflect-metadata";
 import { SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
 import { Logger, paint } from "@seedcord/logger";
@@ -9,25 +9,12 @@ import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
 import { prettify, toEpochSeconds } from "@seedcord/utils";
 
 //#region src/miscellaneous/guarded.ts
-/**
-* A backing record for a generated accessor. Null-prototype, on a plain object a key named `__proto__` sets
-* the store's prototype and adds no entry.
-*
-* @internal
-*/
 function accessorStore() {
 	return Object.create(null);
 }
-/** Empties a store in place, keeping the reference the accessor's Proxy wraps. @internal */
 function clearStore(store) {
 	for (const key of Object.keys(store)) Reflect.deleteProperty(store, key);
 }
-/**
-* Wraps a generated accessor's backing record so a read of an absent key throws. Handler modules import before
-* startup fills the record, and an unguarded read there returns `undefined` and renders as an empty string.
-*
-* @internal
-*/
 function guardedAccessor(accessor, storage) {
 	return new Proxy(storage, { get(target, key, receiver) {
 		if (typeof key !== "string" || Object.hasOwn(target, key)) return Reflect.get(target, key, receiver);
@@ -78,11 +65,7 @@ function slashBuildersOf(all) {
 	const slash = all.filter((command) => command instanceof SlashCommandBuilder);
 	return [...new Set(slash)];
 }
-/**
-* Records each deployed command on {@link Commands} and {@link ContextMenus}.
-*
-* @internal
-*/
+/** @internal */
 var CommandInjector = class {
 	logger = new Logger("Commands", { channel: "bot" });
 	inject(deploy, all) {
@@ -217,7 +200,7 @@ var Notice = class extends Error {
 	*/
 	report = false;
 	/**
-	* Whether the reply is ephemeral, so only the invoking user sees it. Set it false for a refusal the
+	* Whether the reply is ephemeral, seen only by the invoking user. Set it false for a refusal the
 	* whole channel should see.
 	*
 	* @defaultValue `true`
@@ -225,7 +208,7 @@ var Notice = class extends Error {
 	ephemeral = true;
 	/**
 	* A short one-line reason. When every arm of an `or` gate refuses and each refusal sets this, `or`
-	* lists them instead of showing a neutral message.
+	* lists them as the reply.
 	*/
 	summary;
 	constructor(message, options) {
@@ -237,10 +220,6 @@ var Notice = class extends Error {
 
 //#endregion
 //#region src/stops/NoticeCard.ts
-/**
-* Built fresh inside a {@link Notice}'s `render` to back its ComponentsV2 reply. The title renders as
-* an h3 line with the description on the next line.
-*/
 var NoticeCard = class extends BuilderComponent {
 	constructor(description, title = "Cannot Proceed") {
 		super("container");
@@ -253,7 +232,7 @@ var NoticeCard = class extends BuilderComponent {
 /**
 * Thrown when a customId was minted by an older version of its shape.
 *
-* This is normal after the shape changes. The reply tells the user to run the command again.
+* This is normal after the shape changes.
 */
 var StaleCustomId = class extends Notice {
 	constructor(prefix) {
@@ -266,7 +245,7 @@ var StaleCustomId = class extends Notice {
 /**
 * Thrown when a customId wire is corrupt or tampered with and cannot be trusted.
 *
-* This should not happen in normal use, so it reports.
+* It reports because this is an odd case that should not happen.
 */
 var InvalidCustomId = class extends Notice {
 	constructor(detail) {
@@ -503,7 +482,8 @@ function prefixOf(wire) {
 }
 /**
 * A typed customId. The single source of truth shared by the component that mints it and the handler
-* that reads it. This gives you typed reads on the `.customId` field in components. Values are packed into a compact wire string rather than plain stringified tokens, so the 100-char Discord limit goes further. More string per string, basically.
+* that reads it. This gives you typed reads on the `.customId` field in components. Values are packed
+* into a compact wire string, which fits more of them inside Discord's 100-char limit.
 *
 * @typeParam Prefix - The stable route prefix, e.g. 'approve'.
 * @typeParam Shape - The accumulated fields, filled in by the chain.
@@ -517,7 +497,7 @@ function prefixOf(wire) {
 * // Set the custom id on a button when creating it.
 * new ButtonBuilder().setCustomId(ApproveId.encode({ userId: '123', action: 'approve' }));
 *
-* // reading in the handler: userId comes back a string
+* // in the handler, userId comes back a string
 * const { userId, action } = this.params; // userId: string, action: 'approve' | 'deny'
 * await this.event.guild?.members.fetch(userId);
 * ```
@@ -525,7 +505,7 @@ function prefixOf(wire) {
 var CustomId = class CustomId {
 	/** The stable route prefix, e.g. 'approve'. */
 	prefix;
-	/** Like a zod shape */
+	/** The field definitions accumulated by the chain, keyed by name. */
 	shape;
 	/** The prefix plus a short hash of the shape, the part of the wire before the colon. */
 	routeKey;
@@ -606,7 +586,8 @@ var CustomId = class CustomId {
 		});
 	}
 	/**
-	* Add a free short text field. Avoid it where possible, it cannot be packed so it costs the most wire space.
+	* Add a free short text field. Avoid it where possible. It cannot be packed, which makes it the most
+	* expensive field on the wire.
 	*
 	* @example
 	* ```ts
@@ -649,11 +630,7 @@ var CustomId = class CustomId {
 		return prefixOf(wire) === this.prefix;
 	}
 };
-/**
-* Find the customId whose prefix owns this wire, decode against it, and report which one matched.
-*
-* @internal
-*/
+/** @internal */
 function decodeFor(defs, wire) {
 	const match = defs.find((def) => def.owns(wire));
 	if (!match) throw new InvalidCustomId(`no customId owns ${JSON.stringify(routeKeyOf(wire))}`);
@@ -666,14 +643,14 @@ function decodeFor(defs, wire) {
 //#endregion
 //#region src/customId/routing.ts
 /**
-* The route decorators store a handler's customId definitions here so the component base can decode
+* route decorators store a handler's customId defs here, so the component base can decode
 * against them at runtime.
 *
 * @internal
 */
 const ComponentDefsKey = Symbol("seedcord:customId:componentDefs");
 /**
-* Throws `CustomIdHandlerRouteMissing` when the class has no stored defs. A drifted or corrupt wire
+* throws `CustomIdHandlerRouteMissing` when the class has no stored defs. a drifted or corrupt wire
 * throws `StaleCustomId` or `InvalidCustomId`.
 *
 * @internal
@@ -699,7 +676,7 @@ function areRoutes(routes) {
 	return Array.isArray(routes) && routes.every((route) => typeof route === "string");
 }
 /**
-* Every stored route kind and its route strings on a decorated constructor. The build's manifest
+* every stored route kind and its route strings on a decorated constructor. the build's manifest
 * emitter reads the same pairs.
 */
 function interactionRoutesOf(constructor) {
@@ -744,7 +721,7 @@ function contextMenuRouteOf(kind) {
 * the check reads. No annotation defaults to {@link GateContextBase}, an agnostic gate that fits every
 * handler.
 *
-* @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+* @typeParam Name - The gate's name, captured as a literal for mismatch errors.
 * @typeParam Ctx - The context the check reads, inferred from the `ctx` annotation.
 *
 * @param name - The gate's name, used in mismatch errors.
@@ -783,7 +760,7 @@ function defineGate(name, fn) {
 * commits. In an `or`, a refusing arm's queued commit is rolled back. This is how {@link Cooldown} peeks
 * in `check` and charges the slot in `commit`.
 *
-* @typeParam Name - The gate's name captured as a literal, so a mismatch error can name the gate.
+* @typeParam Name - The gate's literal name, used to name a mismatch error.
 * @typeParam Ctx - The context both `check` and `commit` read, inferred from the `ctx` annotation.
 *
 * @param name - The gate's name, used in mismatch errors.
@@ -801,7 +778,7 @@ function defineGate(name, fn) {
 *     return defineEffectGate(
 *         'UsesPerDay',
 *         (ctx) => {
-*             // peek and refuse by throwing, do not mutate yet
+*             // peek and refuse by throwing. do not mutate yet
 *             if (usedToday(ctx.userId) >= max) throw new OutOfUsesNotice(max);
 *         },
 *         (ctx) => {
@@ -946,7 +923,6 @@ function pickNotice(options, makeDefault) {
 
 //#endregion
 //#region src/permissions/bits.ts
-/** Permission bit to its prettified human-readable name. */
 const PermissionNames = new Map(Object.entries(PermissionFlagsBits).map(([key, bit]) => [bit, prettify(key)]));
 const ADMINISTRATOR = PermissionFlagsBits.Administrator;
 function nameOf(bit) {
@@ -1073,4 +1049,4 @@ function pageCursor(prefix) {
 
 //#endregion
 export { areRoutes as A, prefixOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, storeInteractionRoute as F, ContextMenus as G, Notice as H, ComponentDefsKey as I, guardedAccessor as J, accessorStore as K, decodeComponentRoute as L, interactionRoutesOf as M, selectMenuRouteOf as N, defineGate as O, storeComponentRoute as P, CustomId as R, NotAllowed as S, NotOwner as T, CommandInjector as U, NoticeCard as V, Commands as W, GateNotice as _, RequirePermissions as a, MissingRole as b, hasAll as c, pickNotice as d, discardCommits as f, runCommits as g, runCheck as h, RequireBotPermissions as i, contextMenuRouteOf as j, SelectMenuKind as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, clearStore as q, Silence as r, PermissionNames as s, PAGE_MAX as t, presentNames as u, HasDangerousPermissions as v, NotInGuild as w, NeedsAny as x, MissingPermissions as y, decodeFor as z };
-//# sourceMappingURL=cursor-Y6ct-N_8.mjs.map
+//# sourceMappingURL=cursor-D207VrRo.mjs.map