@azurioh/discord-kernel 0.1.0

package/dist/discord/components/interactive-message/interactive-message-collector.d.ts

@@ -0,0 +1,195 @@
+import type { ActionRowBuilder, AnySelectMenuInteraction, Attachment, ChatInputCommandInteraction, ContainerBuilder, EmbedBuilder, InteractionUpdateOptions, MessageActionRowComponentBuilder, MessageMentionOptions } from "discord.js";
+import type { Button } from "../../../discord/interaction/button";
+import type { Card } from "../../../discord/ui/card";
+import { type MessageFile } from "../../../discord/ui/message-attachments";
+import type { Logger } from "../../../logger";
+/** How long an interactive message stays live without a click. */
+export declare const COLLECTOR_IDLE_MS: number;
+/**
+ * What every layout a message can render shares: the files it carries and who
+ * it may notify.
+ */
+interface InteractiveMessagePayloadBase {
+    /**
+     * The files this message carries, as its **whole** set — an embed or a
+     * card's `thumbnail`/`gallery` refers to one by name, as
+     * `attachment://<name>`.
+     *
+     * Leaving the key out means "leave the message's attachments alone", which
+     * is what a view carrying no file of its own must do: stating an empty set
+     * would strip whatever the message was sent with. A view that does own its
+     * files states them on every render, empty included, since that is what
+     * makes removing one show up.
+     */
+    files?: MessageFile[];
+    /**
+     * Who this message may notify.
+     *
+     * Stated by a view that renders text it does not own — user-authored content
+     * carrying mentions — so looking at a preview never pings the people it
+     * names. Left out means Discord's own default, which is what a view building
+     * every string itself wants.
+     */
+    allowedMentions?: MessageMentionOptions;
+}
+/**
+ * The message payload shape shared by the initial reply and every update.
+ *
+ * A discriminated union rather than one shape with an optional `card`:
+ * Discord's `IS_COMPONENTS_V2` flag is **irreversible** (once a message carries
+ * it, an edit can never clear it) and a message carrying it may hold **no**
+ * embed at all — so "embeds" and "card" are not two options on the same
+ * message, they are two kinds of message, and mixing their fields must fail to
+ * compile rather than build a payload Discord would refuse.
+ *
+ * `layout` defaults to `"embeds"` — it is optional on that branch alone — so
+ * every payload a view already returns (`{ embeds, components }`, no `layout`
+ * key at all) keeps satisfying this type unchanged: nothing that predates the
+ * card layout has to name the one it was always using.
+ */
+export type InteractiveMessagePayload<S = never> = (InteractiveMessagePayloadBase & {
+    layout?: "embeds";
+    embeds: EmbedBuilder[];
+    components: ActionRowBuilder<MessageActionRowComponentBuilder>[];
+}) | (InteractiveMessagePayloadBase & {
+    layout: "card";
+    card: Card<S>;
+    /**
+     * Rows shown beside the card rather than inside it — a screen's own
+     * controls (reset, back, done). A Components V2 message accepts several
+     * top-level components: the `Container` `card` compiles to is one, and
+     * each of these is an `ActionRow` next to it. Omitted, or empty, for a
+     * payload with no screen-level controls to show right now (a closed
+     * screen).
+     */
+    controls?: ActionRowBuilder<MessageActionRowComponentBuilder>[];
+    /**
+     * Never present on this branch — declared anyway so that
+     * `InteractiveMessagePayload<S>["components"]`, used elsewhere purely to
+     * name the action-row array type, keeps resolving instead of erroring on
+     * a key one arm of the union does not have.
+     */
+    components?: never;
+});
+/**
+ * The payload as discord.js takes it on an edit, given what the message already
+ * carries: a file already up there under a wanted name is kept rather than
+ * uploaded a second time, so an unrelated re-render neither drops nor re-sends
+ * it.
+ *
+ * A payload stating no files touches neither field, leaving the message's own
+ * attachments alone.
+ *
+ * `state` is only read for a `"card"` payload — it is what `Card.apply` needs
+ * to render the container — and is otherwise unused. No caller building an
+ * `"embeds"` payload has ever had to pass it, and still does not: it is the
+ * third, optional parameter existing two-argument calls already omit.
+ */
+export declare function toMessageEditOptions<S>(payload: InteractiveMessagePayload<S>, existing: readonly Attachment[], state?: S): InteractionUpdateOptions;
+/**
+ * The single mutable cell shared by the view and the collector. Kept explicit
+ * rather than captured as a closure variable so the two always read the same
+ * reference.
+ */
+export interface StateStore<S> {
+    read(): S;
+    write(next: S): void;
+}
+/** Hold a state the collector can advance in place. */
+export declare function createStateStore<S>(initial: S): StateStore<S>;
+/**
+ * What {@link InteractiveView.disabledControls} hands back: enough of a payload
+ * to neutralise the message's controls in place, in whichever layout the view
+ * renders.
+ *
+ * Not `Pick<InteractiveMessagePayload<S>, "components">` alone — on the card
+ * branch that type is `{ components?: never }`, since a card carries `render`'s
+ * controls beside its one container rather than inside it, as top-level
+ * `components` of its own kind. The second arm is what lets a card screen hand
+ * back its neutralised container *and* its neutralised outer row together —
+ * `Card.apply(state, true)` for the former, the same `createActionRow(...,
+ * { disableAll: true })` `render` already builds the row with for the latter —
+ * see {@link import("../../../discord/ui/card").Card}.
+ */
+export type DisabledInteractiveMessageComponents<S> = Pick<InteractiveMessagePayload<S>, "components"> | {
+    readonly components: readonly (ContainerBuilder | ActionRowBuilder<MessageActionRowComponentBuilder>)[];
+};
+/**
+ * Turns a state into a message payload. Everything sent to Discord goes through
+ * here, so the collector never builds a payload of its own and the initial
+ * render can never drift from the updates.
+ */
+export interface InteractiveView<S> {
+    render(state: S): InteractiveMessagePayload<S>;
+    disabledControls(state: S): DisabledInteractiveMessageComponents<S>;
+}
+/**
+ * What a pick hands to its handler: the triggering interaction, the values
+ * Discord sent back already unwrapped, and the same `state`/`update` pairing a
+ * button's {@link ComponentContext} carries.
+ */
+export interface SelectComponentContext<S> {
+    readonly interaction: AnySelectMenuInteraction;
+    readonly values: readonly string[];
+    readonly state: S;
+    update(next: S): Promise<void>;
+}
+/**
+ * A select menu's behaviour inside an interactive message: the custom id the
+ * collector routes on, and what a pick does with the current state.
+ *
+ * Only the behaviour, unlike {@link Button} which also renders itself: a
+ * compiled select menu's rendering does not vary with the state, so it stays
+ * where the rest of the message is built — in the view.
+ */
+export interface InteractiveSelect<S> {
+    readonly id: string;
+    onSelect(ctx: SelectComponentContext<S>): Promise<void> | void;
+}
+export interface InteractiveMessageCollectorDeps<S> {
+    interaction: ChatInputCommandInteraction;
+    response: Awaited<ReturnType<ChatInputCommandInteraction["editReply"]>>;
+    buttons: Button<S>[];
+    /** Omitted by a message whose controls are all buttons. */
+    selects?: InteractiveSelect<S>[];
+    view: InteractiveView<S>;
+    store: StateStore<S>;
+    ownerId: string;
+    idleMs: number;
+    /**
+     * Run once the message stops reacting, whichever way it ended — an explicit
+     * {@link InteractiveMessageHandle.stop} or the idle deadline.
+     *
+     * This is where work that must not repeat at every click belongs: a settings
+     * screen pushing its result to whatever it configures, so what it configures
+     * never shows the half-finished states an administrator passed through. A
+     * failure is logged, never thrown — the message has already ended.
+     */
+    onEnd?: () => Promise<void> | void;
+    logger: Logger;
+}
+/**
+ * Attach the interaction/idle wiring to an already-sent message: it owns the
+ * collector, routes each interaction by custom ID to the button's `onClick` or
+ * the select menu's `onSelect`, scopes every interaction to the owner, and
+ * centralises error handling. Mirrors command `dispatch`.
+ *
+ * Generic over the state so the same mechanism serves anything whose controls
+ * react for a bounded lifetime — pagination, a settings screen, a confirmation.
+ * Persistent components that must survive a restart belong to the
+ * {@link import("../../../discord/components/component-router").ComponentRouter}
+ * instead: this state lives in memory and dies on idle.
+ */
+export interface InteractiveMessageHandle {
+    /**
+     * End the message's interactive life **without** neutralising its controls.
+     *
+     * For callers that have already rendered a final state — a confirmed
+     * deletion, say — where the usual "disable on end" edit would target a
+     * message, or a channel, that no longer exists. `onEnd` still runs.
+     */
+    stop(): void;
+}
+export declare function mountInteractiveMessageCollector<S>(deps: InteractiveMessageCollectorDeps<S>): InteractiveMessageHandle;
+export {};
+//# sourceMappingURL=interactive-message-collector.d.ts.map

package/dist/discord/components/interactive-message/interactive-message-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-message-collector.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/interactive-message/interactive-message-collector.ts"],"names":[],"mappings":"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"}

package/dist/discord/components/interactive-message/interactive-message-collector.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLLECTOR_IDLE_MS = void 0;
+exports.toMessageEditOptions = toMessageEditOptions;
+exports.createStateStore = createStateStore;
+exports.mountInteractiveMessageCollector = mountInteractiveMessageCollector;
+const message_attachments_1 = require("../../../discord/ui/message-attachments");
+const errors_1 = require("../../../errors");
+/** How long an interactive message stays live without a click. */
+exports.COLLECTOR_IDLE_MS = 5 * 60 * 1000;
+/**
+ * The payload as discord.js takes it on an edit, given what the message already
+ * carries: a file already up there under a wanted name is kept rather than
+ * uploaded a second time, so an unrelated re-render neither drops nor re-sends
+ * it.
+ *
+ * A payload stating no files touches neither field, leaving the message's own
+ * attachments alone.
+ *
+ * `state` is only read for a `"card"` payload — it is what `Card.apply` needs
+ * to render the container — and is otherwise unused. No caller building an
+ * `"embeds"` payload has ever had to pass it, and still does not: it is the
+ * third, optional parameter existing two-argument calls already omit.
+ */
+function toMessageEditOptions(payload, existing, state) {
+    const { files, allowedMentions } = payload;
+    const mentions = allowedMentions === undefined ? {} : { allowedMentions };
+    const attachments = files === undefined ? {} : (0, message_attachments_1.planMessageAttachments)(existing, files);
+    if (payload.layout === "card") {
+        if (state === undefined) {
+            // Only reachable once a caller actually builds a `"card"` payload
+            // without threading the state its `Card` needs — a programming error
+            // in that caller, not something a member's click can trigger.
+            throw new Error('toMessageEditOptions: a "card" layout payload needs the state its Card was ' +
+                "declared over to call Card.apply, and none was given.");
+        }
+        return {
+            components: [payload.card.apply(state, false), ...(payload.controls ?? [])],
+            ...mentions,
+            ...attachments,
+        };
+    }
+    const { embeds, components } = payload;
+    return { embeds, components, ...mentions, ...attachments };
+}
+/** Hold a state the collector can advance in place. */
+function createStateStore(initial) {
+    let state = initial;
+    return {
+        read: () => state,
+        write: (next) => {
+            state = next;
+        },
+    };
+}
+function mountInteractiveMessageCollector(deps) {
+    const { interaction, response, buttons, view, store, ownerId, idleMs, logger } = deps;
+    const selects = deps.selects ?? [];
+    function renderOnto(collected, next) {
+        return toMessageEditOptions(view.render(next), [...collected.message.attachments.values()], next);
+    }
+    function createClickContext(clicked) {
+        return {
+            interaction: clicked,
+            state: store.read(),
+            update: async (next) => {
+                store.write(next);
+                await clicked.update(renderOnto(clicked, next));
+            },
+        };
+    }
+    function createPickContext(picked) {
+        return {
+            interaction: picked,
+            values: picked.values,
+            state: store.read(),
+            update: async (next) => {
+                store.write(next);
+                await picked.update(renderOnto(picked, next));
+            },
+        };
+    }
+    async function route(collected) {
+        if (collected.isButton()) {
+            const target = buttons.find((entry) => entry.id === collected.customId);
+            await target?.onClick?.(createClickContext(collected));
+            return;
+        }
+        if (collected.isAnySelectMenu()) {
+            const target = selects.find((entry) => entry.id === collected.customId);
+            await target?.onSelect(createPickContext(collected));
+        }
+    }
+    async function handleCollected(collected) {
+        try {
+            await route(collected);
+        }
+        catch (error) {
+            // At `error`, and with everything the throw carried: whatever lands here
+            // left the click unanswered — Discord tells the administrator the
+            // interaction failed — so it is a defect to be found, not a hiccup. The
+            // custom id says which control it was, since the state that produced it
+            // is gone by the time anybody reads this.
+            logger.error({ err: (0, errors_1.describeError)(error), customId: collected.customId }, "Failed to update interactive message");
+        }
+    }
+    function disableOnEnd() {
+        // The message outlives the collector, so leave the controls visibly inert
+        // instead of letting clicks fail silently.
+        interaction.editReply(view.disabledControls(store.read())).catch((error) => {
+            logger.warn({ err: (0, errors_1.describeError)(error) }, "Failed to disable interactive message controls");
+        });
+    }
+    /**
+     * A caller that stops the message itself has already rendered the final state,
+     * so the disabling edit would be at best redundant and at worst aimed at
+     * something that is gone. `onEnd` still runs: it answers "the message is over",
+     * not "the message timed out".
+     */
+    let stoppedByCaller = false;
+    async function handleEnd() {
+        if (!stoppedByCaller) {
+            disableOnEnd();
+        }
+        try {
+            await deps.onEnd?.();
+        }
+        catch (error) {
+            logger.warn({ err: (0, errors_1.describeError)(error) }, "Failed to close interactive message");
+        }
+    }
+    // No `componentType`: the collector takes every message component the view
+    // renders — buttons and select menus alike — and `route` sorts them out.
+    const collector = response.createMessageComponentCollector({
+        // `idle` rearms on every collected interaction, so each click grants a
+        // fresh window rather than counting down from the first render.
+        idle: idleMs,
+        filter: (collected) => collected.user.id === ownerId,
+    });
+    collector.on("collect", handleCollected);
+    // One `end` listener for both ways out, so nothing an ending owes — inert
+    // controls, `onEnd` — depends on which one happened.
+    collector.on("end", handleEnd);
+    return {
+        stop() {
+            stoppedByCaller = true;
+            collector.stop();
+        },
+    };
+}
+//# sourceMappingURL=interactive-message-collector.js.map

package/dist/discord/components/interactive-message/interactive-message-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-message-collector.js","sourceRoot":"","sources":["../../../../src/discord/components/interactive-message/interactive-message-collector.ts"],"names":[],"mappings":";;;AA0GA,oDA4BC;AAaD,4CAQC;AA0GD,4EAgHC;AAtWD,0EAA4F;AAC5F,qCAAyC;AAGzC,kEAAkE;AACrD,QAAA,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAwE/C;;;;;;;;;;;;;GAaG;AACH,SAAgB,oBAAoB,CACnC,OAAqC,EACrC,QAA+B,EAC/B,KAAS;IAET,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,QAAQ,GAAG,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1E,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,4CAAsB,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEvF,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,kEAAkE;YAClE,qEAAqE;YACrE,8DAA8D;YAC9D,MAAM,IAAI,KAAK,CACd,6EAA6E;gBAC5E,uDAAuD,CACxD,CAAC;QACH,CAAC;QACD,OAAO;YACN,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC3E,GAAG,QAAQ;YACX,GAAG,WAAW;SACd,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAC;AAC5D,CAAC;AAYD,uDAAuD;AACvD,SAAgB,gBAAgB,CAAI,OAAU;IAC7C,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,OAAO;QACN,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;QACjB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;KACD,CAAC;AACH,CAAC;AA0GD,SAAgB,gCAAgC,CAC/C,IAAwC;IAExC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAEnC,SAAS,UAAU,CAAC,SAAsC,EAAE,IAAO;QAClE,OAAO,oBAAoB,CAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EACjB,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAC3C,IAAI,CACJ,CAAC;IACH,CAAC;IAED,SAAS,kBAAkB,CAAC,OAA0B;QACrD,OAAO;YACN,WAAW,EAAE,OAAO;YACpB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;YACnB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YACjD,CAAC;SACD,CAAC;IACH,CAAC;IAED,SAAS,iBAAiB,CAAC,MAAgC;QAC1D,OAAO;YACN,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;YACnB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YAC/C,CAAC;SACD,CAAC;IACH,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,SAAsC;QAC1D,IAAI,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxE,MAAM,MAAM,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;YACvD,OAAO;QACR,CAAC;QACD,IAAI,SAAS,CAAC,eAAe,EAAE,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC;YACxE,MAAM,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAED,KAAK,UAAU,eAAe,CAAC,SAAsC;QACpE,IAAI,CAAC;YACJ,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,yEAAyE;YACzE,kEAAkE;YAClE,wEAAwE;YACxE,wEAAwE;YACxE,0CAA0C;YAC1C,MAAM,CAAC,KAAK,CACX,EAAE,GAAG,EAAE,IAAA,sBAAa,EAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,EAC3D,sCAAsC,CACtC,CAAC;QACH,CAAC;IACF,CAAC;IAED,SAAS,YAAY;QACpB,0EAA0E;QAC1E,2CAA2C;QAC3C,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1E,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,sBAAa,EAAC,KAAK,CAAC,EAAE,EAAE,gDAAgD,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,KAAK,UAAU,SAAS;QACvB,IAAI,CAAC,eAAe,EAAE,CAAC;YACtB,YAAY,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAA,sBAAa,EAAC,KAAK,CAAC,EAAE,EAAE,qCAAqC,CAAC,CAAC;QACnF,CAAC;IACF,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,SAAS,GAAG,QAAQ,CAAC,+BAA+B,CAAC;QAC1D,uEAAuE;QACvE,gEAAgE;QAChE,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO;KACpD,CAAC,CAAC;IAEH,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACzC,0EAA0E;IAC1E,qDAAqD;IACrD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE/B,OAAO;QACN,IAAI;YACH,eAAe,GAAG,IAAI,CAAC;YACvB,SAAS,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/discord/components/interactive-message/mount-interactive-message.d.ts

@@ -0,0 +1,30 @@
+import { type ChatInputCommandInteraction } from "discord.js";
+import { type InteractiveMessageHandle, type InteractiveSelect, type InteractiveView, type StateStore } from "../../../discord/components/interactive-message/interactive-message-collector";
+import type { Button } from "../../../discord/interaction/button";
+import type { Logger } from "../../../logger";
+export interface InteractiveMessageOptions<S> {
+    initialState: S;
+    buttons: Button<S>[];
+    /** Omitted by a message whose controls are all buttons. */
+    selects?: InteractiveSelect<S>[];
+    view: InteractiveView<S>;
+    ownerId: string;
+    /** Run once the message stops reacting, whichever way it ended. */
+    onEnd?: () => Promise<void> | void;
+    logger: Logger;
+    idleMs?: number;
+}
+/**
+ * Send an interactive message and keep its controls live for a bounded time:
+ * renders the initial state, then hands the message to the collector.
+ *
+ * Callers that have already sent their message — or that decide case by case
+ * whether it is worth collecting at all — use
+ * {@link mountInteractiveMessageCollector} directly.
+ *
+ * Call it on an already-deferred interaction.
+ */
+export declare function mountInteractiveMessage<S>(interaction: ChatInputCommandInteraction, options: InteractiveMessageOptions<S>): Promise<InteractiveMessageHandle & {
+    readonly store: StateStore<S>;
+}>;
+//# sourceMappingURL=mount-interactive-message.d.ts.map

package/dist/discord/components/interactive-message/mount-interactive-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-interactive-message.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/interactive-message/mount-interactive-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,2BAA2B,EAAgB,MAAM,YAAY,CAAC;AAC5E,OAAO,EAGN,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAEpB,KAAK,UAAU,EAEf,MAAM,wEAAwE,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC9C,WAAW,EAAE,2BAA2B,EACxC,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,wBAAwB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CA8BvE"}

package/dist/discord/components/interactive-message/mount-interactive-message.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountInteractiveMessage = mountInteractiveMessage;
+const discord_js_1 = require("discord.js");
+const interactive_message_collector_1 = require("../../../discord/components/interactive-message/interactive-message-collector");
+/**
+ * Send an interactive message and keep its controls live for a bounded time:
+ * renders the initial state, then hands the message to the collector.
+ *
+ * Callers that have already sent their message — or that decide case by case
+ * whether it is worth collecting at all — use
+ * {@link mountInteractiveMessageCollector} directly.
+ *
+ * Call it on an already-deferred interaction.
+ */
+async function mountInteractiveMessage(interaction, options) {
+    const store = (0, interactive_message_collector_1.createStateStore)(options.initialState);
+    const initial = options.view.render(store.read());
+    // A deferred reply carries no attachment yet, so every file the first render
+    // states is uploaded — there is nothing up there that could be kept instead.
+    const editOptions = (0, interactive_message_collector_1.toMessageEditOptions)(initial, [], store.read());
+    const response = await interaction.editReply(
+    // `IS_COMPONENTS_V2` is set on the *first* send only, never again: Discord
+    // treats it as irreversible on a message — an edit can never clear it —
+    // so posing it here and only here is what keeps a later re-render from
+    // trying to flip a flag Discord would refuse to change.
+    initial.layout === "card"
+        ? { ...editOptions, flags: discord_js_1.MessageFlags.IsComponentsV2 }
+        : editOptions);
+    const handle = (0, interactive_message_collector_1.mountInteractiveMessageCollector)({
+        interaction,
+        response,
+        buttons: options.buttons,
+        selects: options.selects,
+        view: options.view,
+        store,
+        ownerId: options.ownerId,
+        ...(options.onEnd === undefined ? {} : { onEnd: options.onEnd }),
+        idleMs: options.idleMs ?? interactive_message_collector_1.COLLECTOR_IDLE_MS,
+        logger: options.logger,
+    });
+    return { ...handle, store };
+}
+//# sourceMappingURL=mount-interactive-message.js.map

package/dist/discord/components/interactive-message/mount-interactive-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-interactive-message.js","sourceRoot":"","sources":["../../../../src/discord/components/interactive-message/mount-interactive-message.ts"],"names":[],"mappings":";;AAqCA,0DAiCC;AAtED,2CAA4E;AAC5E,0HASgF;AAiBhF;;;;;;;;;GASG;AACI,KAAK,UAAU,uBAAuB,CAC5C,WAAwC,EACxC,OAAqC;IAErC,MAAM,KAAK,GAAG,IAAA,gDAAgB,EAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,WAAW,GAAG,IAAA,oDAAoB,EAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS;IAC3C,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,wDAAwD;IACxD,OAAO,CAAC,MAAM,KAAK,MAAM;QACxB,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE,yBAAY,CAAC,cAAc,EAAE;QACxD,CAAC,CAAC,WAAW,CACd,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,gEAAgC,EAAC;QAC/C,WAAW;QACX,QAAQ;QACR,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,iDAAiB;QAC3C,MAAM,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/discord/components/paginator/index.d.ts

@@ -0,0 +1,5 @@
+export { mountPaginator, type PaginatorOptions, } from "../../../discord/components/paginator/mount-paginator";
+export { clampPage, createPageState, isFirstPage, isLastPage, nextPage, type PageState, pageCount, previousPage, selectPageItems, } from "../../../discord/components/paginator/page-state";
+export type { PaginatorLabels } from "../../../discord/components/paginator/paginator-buttons";
+export type { PaginatorRender } from "../../../discord/components/paginator/paginator-view";
+//# sourceMappingURL=index.d.ts.map

package/dist/discord/components/paginator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/paginator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,KAAK,gBAAgB,GACrB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACN,SAAS,EACT,eAAe,EACf,WAAW,EACX,UAAU,EACV,QAAQ,EACR,KAAK,SAAS,EACd,SAAS,EACT,YAAY,EACZ,eAAe,GACf,MAAM,2CAA2C,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACxF,YAAY,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/discord/components/paginator/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectPageItems = exports.previousPage = exports.pageCount = exports.nextPage = exports.isLastPage = exports.isFirstPage = exports.createPageState = exports.clampPage = exports.mountPaginator = void 0;
+var mount_paginator_1 = require("../../../discord/components/paginator/mount-paginator");
+Object.defineProperty(exports, "mountPaginator", { enumerable: true, get: function () { return mount_paginator_1.mountPaginator; } });
+var page_state_1 = require("../../../discord/components/paginator/page-state");
+Object.defineProperty(exports, "clampPage", { enumerable: true, get: function () { return page_state_1.clampPage; } });
+Object.defineProperty(exports, "createPageState", { enumerable: true, get: function () { return page_state_1.createPageState; } });
+Object.defineProperty(exports, "isFirstPage", { enumerable: true, get: function () { return page_state_1.isFirstPage; } });
+Object.defineProperty(exports, "isLastPage", { enumerable: true, get: function () { return page_state_1.isLastPage; } });
+Object.defineProperty(exports, "nextPage", { enumerable: true, get: function () { return page_state_1.nextPage; } });
+Object.defineProperty(exports, "pageCount", { enumerable: true, get: function () { return page_state_1.pageCount; } });
+Object.defineProperty(exports, "previousPage", { enumerable: true, get: function () { return page_state_1.previousPage; } });
+Object.defineProperty(exports, "selectPageItems", { enumerable: true, get: function () { return page_state_1.selectPageItems; } });
+//# sourceMappingURL=index.js.map

package/dist/discord/components/paginator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/discord/components/paginator/index.ts"],"names":[],"mappings":";;;AAAA,kFAGwD;AAFvD,iHAAA,cAAc,OAAA;AAGf,wEAUmD;AATlD,uGAAA,SAAS,OAAA;AACT,6GAAA,eAAe,OAAA;AACf,yGAAA,WAAW,OAAA;AACX,wGAAA,UAAU,OAAA;AACV,sGAAA,QAAQ,OAAA;AAER,uGAAA,SAAS,OAAA;AACT,0GAAA,YAAY,OAAA;AACZ,6GAAA,eAAe,OAAA"}

package/dist/discord/components/paginator/mount-paginator.d.ts

@@ -0,0 +1,25 @@
+import type { ChatInputCommandInteraction } from "discord.js";
+import { type PaginatorLabels } from "../../../discord/components/paginator/paginator-buttons";
+import { type PaginatorRender } from "../../../discord/components/paginator/paginator-view";
+import type { Logger } from "../../../logger";
+export interface PaginatorOptions<T> {
+    items: T[];
+    pageSize: number;
+    ownerId: string;
+    logger: Logger;
+    initialPage?: number;
+    idleMs?: number;
+    labels?: Partial<PaginatorLabels>;
+    render: PaginatorRender<T>;
+}
+/**
+ * A composed component: an embed plus previous/next buttons plus a collector.
+ * The collector itself is the generic
+ * {@link import("../../../discord/components/interactive-message").mountInteractiveMessageCollector} —
+ * this module only contributes what is specific to pagination: the page state,
+ * the navigation buttons and the page view.
+ *
+ * Call it on an already-deferred interaction.
+ */
+export declare function mountPaginator<T>(interaction: ChatInputCommandInteraction, options: PaginatorOptions<T>): Promise<void>;
+//# sourceMappingURL=mount-paginator.d.ts.map

package/dist/discord/components/paginator/mount-paginator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-paginator.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/paginator/mount-paginator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAQ9D,OAAO,EAEN,KAAK,eAAe,EAEpB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACrC,WAAW,EAAE,2BAA2B,EACxC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/discord/components/paginator/mount-paginator.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountPaginator = mountPaginator;
+const interactive_message_1 = require("../../../discord/components/interactive-message");
+const page_state_1 = require("../../../discord/components/paginator/page-state");
+const paginator_buttons_1 = require("../../../discord/components/paginator/paginator-buttons");
+const paginator_view_1 = require("../../../discord/components/paginator/paginator-view");
+/**
+ * A composed component: an embed plus previous/next buttons plus a collector.
+ * The collector itself is the generic
+ * {@link import("../../../discord/components/interactive-message").mountInteractiveMessageCollector} —
+ * this module only contributes what is specific to pagination: the page state,
+ * the navigation buttons and the page view.
+ *
+ * Call it on an already-deferred interaction.
+ */
+async function mountPaginator(interaction, options) {
+    const { items, pageSize, ownerId, render, logger } = options;
+    const count = (0, page_state_1.pageCount)(items.length, pageSize);
+    const store = (0, interactive_message_1.createStateStore)((0, page_state_1.createPageState)(options.initialPage ?? 1, count));
+    const buttons = (0, paginator_buttons_1.createPaginatorButtons)(count, (0, paginator_buttons_1.resolveLabels)(options.labels));
+    const view = (0, paginator_view_1.createPaginatorView)({ items, pageSize, count, render, buttons });
+    const response = await interaction.editReply((0, interactive_message_1.toMessageEditOptions)(view.render(store.read()), []));
+    // A single page has nothing to navigate to, so it needs no collector at all —
+    // a pagination-specific rule, which is why it lives here and not in the
+    // generic mechanism.
+    if (count <= 1) {
+        return;
+    }
+    (0, interactive_message_1.mountInteractiveMessageCollector)({
+        interaction,
+        response,
+        buttons,
+        view,
+        store,
+        ownerId,
+        idleMs: options.idleMs ?? interactive_message_1.COLLECTOR_IDLE_MS,
+        logger,
+    });
+}
+//# sourceMappingURL=mount-paginator.js.map

package/dist/discord/components/paginator/mount-paginator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-paginator.js","sourceRoot":"","sources":["../../../../src/discord/components/paginator/mount-paginator.ts"],"names":[],"mappings":";;AAuCA,wCA6BC;AAnED,kFAKkD;AAClD,0EAAuF;AACvF,wFAI0D;AAC1D,kFAGuD;AAcvD;;;;;;;;GAQG;AACI,KAAK,UAAU,cAAc,CACnC,WAAwC,EACxC,OAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAA,sBAAS,EAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAA,sCAAgB,EAAC,IAAA,4BAAe,EAAC,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,IAAA,0CAAsB,EAAC,KAAK,EAAE,IAAA,iCAAa,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAA,oCAAmB,EAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,IAAA,0CAAoB,EAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAElG,8EAA8E;IAC9E,wEAAwE;IACxE,qBAAqB;IACrB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO;IACR,CAAC;IAED,IAAA,sDAAgC,EAAC;QAChC,WAAW;QACX,QAAQ;QACR,OAAO;QACP,IAAI;QACJ,KAAK;QACL,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,uCAAiB;QAC3C,MAAM;KACN,CAAC,CAAC;AACJ,CAAC"}

package/dist/discord/components/paginator/page-state.d.ts

@@ -0,0 +1,21 @@
+/** What the paginator remembers between two clicks: the page being displayed (1-based). */
+export interface PageState {
+    page: number;
+}
+/** Total number of pages for a collection, never below 1. */
+export declare function pageCount(total: number, pageSize: number): number;
+/** Clamp a page number into the valid `[1, count]` range. */
+export declare function clampPage(page: number, count: number): number;
+/** Opening state, clamped so a caller-supplied out-of-range page stays valid. */
+export declare function createPageState(page: number, count: number): PageState;
+/** Transition one page back; a no-op on the first page. */
+export declare function previousPage(state: PageState, count: number): PageState;
+/** Transition one page forward; a no-op on the last page. */
+export declare function nextPage(state: PageState, count: number): PageState;
+/** Whether the "previous" affordance has nothing left to go back to. */
+export declare function isFirstPage(state: PageState): boolean;
+/** Whether the "next" affordance has nothing left to go forward to. */
+export declare function isLastPage(state: PageState, count: number): boolean;
+/** Slice of the collection visible on the current page. */
+export declare function selectPageItems<T>(items: T[], state: PageState, pageSize: number): T[];
+//# sourceMappingURL=page-state.d.ts.map

package/dist/discord/components/paginator/page-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/paginator/page-state.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEtE;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEvE;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEnE;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAErD;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAGtF"}

package/dist/discord/components/paginator/page-state.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageCount = pageCount;
+exports.clampPage = clampPage;
+exports.createPageState = createPageState;
+exports.previousPage = previousPage;
+exports.nextPage = nextPage;
+exports.isFirstPage = isFirstPage;
+exports.isLastPage = isLastPage;
+exports.selectPageItems = selectPageItems;
+/** Total number of pages for a collection, never below 1. */
+function pageCount(total, pageSize) {
+    return Math.max(1, Math.ceil(total / pageSize));
+}
+/** Clamp a page number into the valid `[1, count]` range. */
+function clampPage(page, count) {
+    return Math.min(Math.max(page, 1), count);
+}
+/** Opening state, clamped so a caller-supplied out-of-range page stays valid. */
+function createPageState(page, count) {
+    return { page: clampPage(page, count) };
+}
+/** Transition one page back; a no-op on the first page. */
+function previousPage(state, count) {
+    return { page: clampPage(state.page - 1, count) };
+}
+/** Transition one page forward; a no-op on the last page. */
+function nextPage(state, count) {
+    return { page: clampPage(state.page + 1, count) };
+}
+/** Whether the "previous" affordance has nothing left to go back to. */
+function isFirstPage(state) {
+    return state.page <= 1;
+}
+/** Whether the "next" affordance has nothing left to go forward to. */
+function isLastPage(state, count) {
+    return state.page >= count;
+}
+/** Slice of the collection visible on the current page. */
+function selectPageItems(items, state, pageSize) {
+    const start = (state.page - 1) * pageSize;
+    return items.slice(start, start + pageSize);
+}
+//# sourceMappingURL=page-state.js.map

package/dist/discord/components/paginator/page-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-state.js","sourceRoot":"","sources":["../../../../src/discord/components/paginator/page-state.ts"],"names":[],"mappings":";;AAMA,8BAEC;AAGD,8BAEC;AAGD,0CAEC;AAGD,oCAEC;AAGD,4BAEC;AAGD,kCAEC;AAGD,gCAEC;AAGD,0CAGC;AAvCD,6DAA6D;AAC7D,SAAgB,SAAS,CAAC,KAAa,EAAE,QAAgB;IACxD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,6DAA6D;AAC7D,SAAgB,SAAS,CAAC,IAAY,EAAE,KAAa;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,iFAAiF;AACjF,SAAgB,eAAe,CAAC,IAAY,EAAE,KAAa;IAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,2DAA2D;AAC3D,SAAgB,YAAY,CAAC,KAAgB,EAAE,KAAa;IAC3D,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,6DAA6D;AAC7D,SAAgB,QAAQ,CAAC,KAAgB,EAAE,KAAa;IACvD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,wEAAwE;AACxE,SAAgB,WAAW,CAAC,KAAgB;IAC3C,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,SAAgB,UAAU,CAAC,KAAgB,EAAE,KAAa;IACzD,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED,2DAA2D;AAC3D,SAAgB,eAAe,CAAI,KAAU,EAAE,KAAgB,EAAE,QAAgB;IAChF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;AAC7C,CAAC"}