@encorekit/web-sdk 2.3.0 → 2.4.0

package/types/triggers/claimReminder/ClaimReminder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ClaimReminder, trigger plug-in #1: a card that reminds the user of their newest
+ * open claim, and on tap opens the Encore sheet for its use case and placement,
+ * where that offer is still listed. Behaviour is the cross-platform contract
+ * (contract.md, "Trigger behaviour"); the drawing is the served SDUI tree, fed by
+ * bindings.ts (trigger SDUI vocabulary contract §2). Everything every
+ * trigger shares (the config request, events, visibility, dismiss storage, identity
+ * re-runs, the sheet's presentation id) is the host's (triggers/host/TriggerHost.ts).
+ */
+import type { UseCase } from '../../types';
+import type { SheetCheck, TriggerPlugin } from '../host/types';
+import { type ReminderConfig } from './config';
+import type { ClaimReminderSource, ReminderClaim } from './source';
+import { type TriggerSduiModel } from '../host/sduiView';
+export declare const CLAIM_REMINDER_ID: "claimReminder";
+/** What the gate found: the open claims, and the campaigns the sheet holds for the tap. */
+export interface ReminderContent {
+    useCase: UseCase;
+    /** The open claims the sheet still holds; empty when only a completion is left. */
+    claims: ReminderClaim[];
+    campaignIds: ReadonlySet<string>;
+    /**
+     * No claim to remind about, and an offer finished today that was not thanked yet (the
+     * request's `completed` state): its claim's id. Encore answers with the thanks look or
+     * nothing, as the look's behavior says.
+     */
+    completion?: string;
+    /** The reminder window the gate used (the one last served here), in hours. */
+    windowHours?: number;
+}
+/** What one render of the card shows: the served tree and what it binds. */
+export interface ReminderModel extends TriggerSduiModel {
+    useCase: UseCase;
+    placement: string | undefined;
+    /** The thanks look is drawn: a tap opens the sheet and ends it. */
+    thanks?: true;
+}
+export interface ClaimReminderDeps {
+    /**
+     * The claims adapter, read at call time. The SDK's is never null: this browser's claim
+     * log, merged with the claims bank once one is bound. Null renders nothing.
+     */
+    source(): ClaimReminderSource | null;
+    /**
+     * Whether the sheet for `useCase` at `placement` would open with offers, and which
+     * campaigns it holds (the same gate as GiftsButton's). `fresh` skips the held search.
+     */
+    checkSheet(useCase: UseCase, placement: string | undefined, fresh: boolean): Promise<SheetCheck>;
+    /**
+     * A tap about to open the sheet: false when the shown claim is known to have ended
+     * (synchronous: the sheet opens inside the click). Absent: always open.
+     */
+    claimTapped?(transactionId: string): boolean;
+    /**
+     * An offer finished today with none claimed since, not thanked yet: its claim's id
+     * (the `completed` state). Absent or null: none.
+     */
+    thanksFor?(): string | null;
+    /** The thanks look was tapped: it ends for the user's latest completion. */
+    thanksTapped?(): void;
+    /** Device storage for the window last served at each placement. Absent: the 24 hour default. */
+    storage?(): Storage | null;
+}
+export declare function claimReminderPlugin(deps: ClaimReminderDeps): TriggerPlugin<ReminderContent, ReminderConfig, ReminderModel>;
+//# sourceMappingURL=ClaimReminder.d.ts.map

package/types/triggers/claimReminder/ClaimReminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimReminder.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/ClaimReminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAElF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAIvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,eAAO,MAAM,iBAAiB,iBAA2B,CAAC;AAK1D,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mEAAmE;IACnE,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,IAAI,mBAAmB,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjG;;;OAGG;IACH,WAAW,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C;;;OAGG;IACH,SAAS,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;IAC5B,4EAA4E;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,gGAAgG;IAChG,OAAO,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC;CAC5B;AA2BD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,GACtB,aAAa,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC,CAwO/D"}

package/types/triggers/claimReminder/bindings.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What the claim reminder hands the SDUI engine (trigger SDUI contract §2.2 to
+ * §2.5): its values, its two time keys and its lists, built from the eligible
+ * claims. The served tree draws them; nothing here draws.
+ */
+import type { TriggerIconValues } from '../host/theme';
+import type { SduiHostListItem } from '../../sdui/context';
+import type { ReminderCopy } from './config';
+import type { ReminderClaim } from './source';
+export interface ReminderBindings {
+    values: Record<string, string>;
+    times: {
+        start: number;
+        deadline: number;
+    };
+    lists: Record<string, SduiHostListItem[]>;
+}
+export interface ReminderBindingInput {
+    copy: ReminderCopy;
+    windowHours: number;
+    /** The served layout name, exposed as `${layout}`. */
+    layout: string;
+    /** The icon the look draws, exposed as `${icon}` and `${appIconUrl}`. */
+    icon: TriggerIconValues;
+    /** Every string the served look declares (`template.strings`), each exposed as a value. */
+    lookStrings?: Readonly<Record<string, string>>;
+    /** The look's value defaults with the mount's values over them, for `${values.K}`. */
+    lookValues?: Readonly<Record<string, string>>;
+    /**
+     * The string the look's headline text slot names (`textSlots.headline`), already holding
+     * the app's headline when it set one: the spoken title on a named claim, as the card draws it.
+     */
+    headlineKey?: string | null;
+}
+/**
+ * The bindings for the newest eligible claim. `eligible` is newest first, as
+ * `eligibleClaims` returns it, and not empty.
+ */
+export declare function reminderBindings(eligible: readonly ReminderClaim[], input: ReminderBindingInput): ReminderBindings;
+//# sourceMappingURL=bindings.d.ts.map

package/types/triggers/claimReminder/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/bindings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQ9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,IAAI,EAAE,iBAAiB,CAAC;IACxB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,sFAAsF;IACtF,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAsDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,KAAK,EAAE,oBAAoB,GAC1B,gBAAgB,CAqFlB"}

package/types/triggers/claimReminder/config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Reading the claim reminder's served template. The host has already checked the
+ * envelope (`template.trigger == 'claimReminder'`) and owns the variant ids and the
+ * served locale.
+ *
+ * The variant is an SDUI tree plus the keys the host reads (trigger SDUI
+ * vocabulary contract §1):
+ *
+ *   { trigger: 'claimReminder', layout, windowHours, dismissible, colors, strings, root }
+ *
+ * `root` is drawn by the engine; `layout` is only a label (events, `${layout}`).
+ * Everything here is tolerant: a missing or malformed field takes its default.
+ */
+import type { TriggerColors } from '../host/theme';
+/** The copy the trigger draws. `${advertiserName}` is filled at render. */
+export interface ReminderCopy {
+    title: string;
+    subtitle: string;
+    /** The open control's accessible name; the designs show no CTA text. */
+    cta: string;
+    /** The close control's accessible name. */
+    dismiss: string;
+    hours: string;
+    minutes: string;
+    seconds: string;
+    /** The title naming the claim's advertiser: "Finish your ${advertiserName} gift". */
+    offerTitle: string;
+    /** logoMarquee's title for several claims: "${claimCount} gifts still waiting". */
+    titleMany: string;
+    /** The word after the featured look's countdown: "23:32 left". */
+    left: string;
+}
+/**
+ * Built-in English, used per key when the template lacks one. Pinned across every
+ * platform to the backend fixture's values. The tone stays true for a reader who has
+ * already finished, and never says the offer ends or is lost.
+ */
+export declare const DEFAULT_REMINDER_COPY: Readonly<ReminderCopy>;
+export type ReminderColors = TriggerColors;
+export interface ReminderConfig {
+    /** The look's light colours (`lightColors`), used in the light scheme. */
+    lightColors: ReminderColors;
+    /** The served template, drawn by the SDUI engine. */
+    template: Record<string, unknown>;
+    /** The served layout name: a label, never a code path. */
+    layout: string;
+    windowHours: number;
+    dismissible: boolean;
+    colors: ReminderColors;
+    copy: ReminderCopy;
+}
+type Dict = Record<string, unknown>;
+/** The config to draw from the served `ui.template`. */
+export declare function decodeReminderTemplate(template: Dict): ReminderConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/types/triggers/claimReminder/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAWvD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,WAAW,EAAE,cAAc,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;CACpB;AAGD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoBpC,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAUrE"}

package/types/triggers/claimReminder/eligibility.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Which claims the reminder may show (contract.md, behaviour 2).
+ *
+ * Eligible = available, inside the reminder window, with an advertiser to name, and
+ * not dismissed on this device. The window is the REMINDER's, not the offer's: when
+ * it ends the banner hides and the claim itself is untouched.
+ */
+import type { ReminderClaim } from './source';
+/**
+ * How far ahead of this device's clock a claim time may be: the server stamps it, and
+ * a device clock running up to this far behind must still show a claim just made.
+ */
+export declare const CLOCK_SKEW_MS: number;
+/** When the reminder for this claim hides. NaN for an unparseable claim time. */
+export declare function reminderEndsAt(claim: ReminderClaim, windowHours: number): number;
+/** The eligible claims, newest first. The first one is the one to show. */
+export declare function eligibleClaims(claims: readonly ReminderClaim[], windowHours: number, nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}): ReminderClaim[];
+/** The longest reminder window any variant may serve (the backend validates 1..720). */
+export declare const MAX_WINDOW_HOURS = 720;
+/**
+ * Whether any claim could be shown: the gate before the config request, which assigns
+ * the experiment arm. Same rules as eligibility, under `windowHours`, the window last
+ * served at this placement (servedWindow.ts), capped at the longest any variant serves.
+ */
+export declare function hasReminderCandidate(claims: readonly ReminderClaim[], nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}, windowHours: number): boolean;
+/**
+ * When `hasReminderCandidate` next turns false by the clock alone: the first epoch ms past
+ * the window of the claim that leaves it first. Null when no claim is in it.
+ */
+export declare function reminderCandidateEnds(claims: readonly ReminderClaim[], nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}, windowHours: number): number | null;
+//# sourceMappingURL=eligibility.d.ts.map

package/types/triggers/claimReminder/eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAgB,CAAC;AAM3C,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACjD,aAAa,EAAE,CAYjB;AAED,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAClD,WAAW,EAAE,MAAM,GAClB,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAClD,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CASf"}

package/types/triggers/claimReminder/servedWindow.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The reminder window last served at each placement, kept on the device so it outlives
+ * a reload: an open claim asks for the reminder (`state=claimOpen`) only inside it. The
+ * window is only known from a served look, so before one is served here it is the
+ * 24 hour default. Storage that fails, or holds anything but a window of 1..720 hours,
+ * reads as that default; nothing here throws.
+ */
+export declare const SERVED_WINDOW_KEY = "encore.trigger.claimReminder.window";
+/** Before any window was served at a placement (also the decoder's default). */
+export declare const DEFAULT_WINDOW_HOURS = 24;
+/** The window last served at `placement` on this device, else the 24 hour default. */
+export declare function servedWindowHours(storage: Storage | null, placement: string | undefined): number;
+/** Keep the window a look at `placement` was served with. */
+export declare function rememberServedWindow(storage: Storage | null, placement: string | undefined, hours: number): void;
+//# sourceMappingURL=servedWindow.d.ts.map

package/types/triggers/claimReminder/servedWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servedWindow.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/servedWindow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,iBAAiB,wCAAwC,CAAC;AAEvE,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAqBvC,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhG;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWhH"}

package/types/triggers/claimReminder/source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The claim reminder's view of the user's claims. INTERNAL.
+ *
+ * The trigger never reads the claims bank directly. It reads this adapter, so the
+ * trigger can be built and tested before the bank's `claims()` lands on main, and so
+ * the binding to it is one thin mapper (contract.md, "Dependency strategy"). The SDK's
+ * source is the claim log (the claims this browser saw), merged with the claims bank
+ * once one is bound (core/claimLog.ts).
+ *
+ * The same adapter exists on iOS and Android. A tap opens the Encore sheet, so
+ * the adapter only reads; nothing here reopens a claim.
+ */
+/** One open claim, reduced to what the reminder needs. */
+export interface ReminderClaim {
+    transactionId: string;
+    campaignId: string;
+    advertiserName: string;
+    advertiserLogoUrl?: string | null;
+    /** The claimed offer's perk ("3 months free"), when known. */
+    perk?: string;
+    /** ISO-8601. The latest claim time when the server exposes it, else the creation time. */
+    claimedAt: string;
+    availability: 'available' | 'unavailable';
+}
+export interface ClaimReminderSource {
+    /** The user's open claims, freshly read. Rejects when the read fails. */
+    openClaims(): Promise<ReminderClaim[]>;
+}
+//# sourceMappingURL=source.d.ts.map

package/types/triggers/claimReminder/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACxC"}

package/types/triggers/giftsButton/GiftsButton.d.ts

@@ -0,0 +1,60 @@
+/**
+ * GiftsButton, trigger plug-in #2: a button the app shows at a reward moment instead
+ * of popping the Encore sheet itself. A tap opens the sheet for the mount's use case and
+ * placement.
+ *
+ * Opening by itself is the served look's (`behavior.autoOpen: on`, an experiment arm
+ * only), on a mount that may (`mayOpenByItself`: it neither said `autoOpen: 'off'` nor
+ * pinned a layout). Such a look draws nothing until it pops the sheet, once per mount and
+ * at most once per placement per local day across mounts, then draws itself, its events
+ * keeping its own layout and ids. Every look is its served SDUI tree (host/sduiView.ts).
+ * Everything every trigger shares is the host's.
+ */
+import type { UseCase } from '../../types';
+import type { SduiHostListItem } from '../../sdui/context';
+import type { TriggerMountState, SheetCheck, TriggerPlugin } from '../host/types';
+import { type TriggerRequest } from '../request';
+import { type TriggerSduiModel } from '../host/sduiView';
+import { type GiftsButtonConfig } from './config';
+export declare const GIFTS_BUTTON_ID: "giftsButton";
+export { AUTO_POP_STORAGE_KEY, forgetAutoPops } from '../host/autoPops';
+/**
+ * A spot drew another look (the reminder, a thanks look) on a mount that may open the
+ * sheet by itself: it never pops after that, so its one decision is spent as given up and
+ * it draws its own look when it is the gifts button again.
+ */
+export declare function giveUpAutoOpen(mountState: TriggerMountState, request: TriggerRequest): void;
+export interface GiftsButtonDeps {
+    /**
+     * Whether the sheet for `useCase` at `placement` would open with offers, by the SDK's
+     * own path: the sheet's config (`sheet_unavailable` when it has nothing to serve),
+     * then an offer search sent with the sheet's variant and `purpose: 'prefetch'`, held
+     * for the tap. `fresh` skips the held search (after a claim). `none` for no offers or
+     * any failure.
+     */
+    checkSheet(useCase: UseCase, placement: string | undefined, fresh: boolean): Promise<SheetCheck>;
+    storage(): Storage | null;
+    /** The thanks look was tapped: it ends for the user's latest completion. */
+    thanksTapped?(): void;
+}
+interface GiftsButtonContent {
+    useCase: UseCase;
+    /** The held offers' logos, for `offerLogos`. */
+    offerLogos: readonly SduiHostListItem[];
+    /**
+     * A completion today, not yet thanked (the request's `completed` state): its claim's id.
+     * The thanks look, when Encore serves it for this state, is keyed by it, so each
+     * completion counts its own view.
+     */
+    thanks?: string;
+}
+/** One render: a served look and what it binds, or nothing (`template` null). */
+export interface GiftsButtonModel extends Omit<TriggerSduiModel, 'template'> {
+    useCase: UseCase;
+    placement: string | undefined;
+    template: Record<string, unknown> | null;
+    /** The thanks look is drawn: a tap on it ends the thanks state. */
+    thanks?: true;
+}
+export declare function giftsButtonPlugin(deps: GiftsButtonDeps): TriggerPlugin<GiftsButtonContent, GiftsButtonConfig, GiftsButtonModel>;
+//# sourceMappingURL=GiftsButton.d.ts.map

package/types/triggers/giftsButton/GiftsButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GiftsButton.d.ts","sourceRoot":"","sources":["../../../src/triggers/giftsButton/GiftsButton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EAGd,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAuC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE9F,eAAO,MAAM,eAAe,eAAyB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYxE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAI3F;AAKD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjG,OAAO,IAAI,OAAO,GAAG,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmBD,iFAAiF;AACjF,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,mEAAmE;IACnE,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAgBD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,GACpB,aAAa,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAmMxE"}

package/types/triggers/giftsButton/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Reading GiftsButton's served template. The host has already checked the envelope
+ * (`template.trigger == 'giftsButton'`), run the strict pre-check, and owns the variant
+ * ids and the served locale.
+ *
+ *   { trigger: 'giftsButton', version, layout, colors, strings: { title, subtitle, cta }, root }
+ *
+ * `root` is drawn by the SDUI engine; `layout` is a label (events, `${layout}`). Whether
+ * the look opens the sheet by itself is its `behavior.autoOpen` (§2.8), never its layout.
+ */
+import type { TriggerColors } from '../host/theme';
+export interface GiftsButtonStrings {
+    title?: string;
+    subtitle?: string;
+    cta?: string;
+    offersTitle?: string;
+}
+export interface GiftsButtonConfig {
+    /** The served template, drawn by the SDUI engine. */
+    template: Record<string, unknown>;
+    /** The served layout name: a label, never a code path. */
+    layout: string;
+    /** The look's dark colours (`colors`). */
+    colors: TriggerColors;
+    /** The look's light colours (`lightColors`), used in the light scheme. */
+    lightColors: TriggerColors;
+    /** Only the served, non-blank strings; the look's own English fills the rest. */
+    strings: GiftsButtonStrings;
+    /**
+     * The look's `behavior.autoOpen` is `on`: it opens the sheet once by itself, then draws
+     * itself. Applied only on a mount that may (`mayOpenByItself`), within the device's bounds.
+     */
+    autoOpen: boolean;
+}
+export declare function decodeGiftsButtonTemplate(template: Record<string, unknown>): GiftsButtonConfig;
+/** The copy one look binds. */
+export interface GiftsButtonCopy {
+    title: string;
+    subtitle: string;
+    cta: string;
+    /** The title over the held offers' logos (offerMarquee). */
+    offersTitle: string;
+}
+/** The built-in English for `offersTitle`, on every look. */
+export declare const DEFAULT_OFFERS_TITLE = "Pick a gift, on us";
+/**
+ * Built-in English per look, used per key when the variant has none. Never names a
+ * reward, an amount, "free" or an expiry; no dash punctuation. A look this table does
+ * not name takes the card's.
+ */
+export declare const GIFTS_BUTTON_COPY: Readonly<Record<string, Omit<GiftsButtonCopy, 'offersTitle'>>>;
+export declare function giftsButtonCopy(layout: string, strings: GiftsButtonStrings): GiftsButtonCopy;
+//# sourceMappingURL=config.d.ts.map

package/types/triggers/giftsButton/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/triggers/giftsButton/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,aAAa,CAAC;IACtB,0EAA0E;IAC1E,WAAW,EAAE,aAAa,CAAC;IAC3B,iFAAiF;IACjF,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAe9F;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAM3F,CAAC;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAU5F"}

package/types/triggers/giftsButton/spot.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A GiftsButton spot: one mount, one `/config` request, and whatever look Encore answers
+ * it with (§2.8). The spot tells Encore what happened on the device (`state`): a claim
+ * the reminder could show (`claimOpen`) or an offer finished today and not yet thanked
+ * (`completed`). The served look's behavior decides the step, so the answer may be the
+ * gifts button, its thanks look, nothing, or the claim reminder's look
+ * (`ui.template.trigger` claimReminder). This plug-in draws whichever arrives with the
+ * GiftsButton or ClaimReminder plug-in, so the two are one spot with one request.
+ */
+import type { ReminderConfig } from '../claimReminder/config';
+import type { ReminderContent, ReminderModel } from '../claimReminder/ClaimReminder';
+import type { TriggerPlugin } from '../host/types';
+type Plugin<C, F, M> = TriggerPlugin<C, F, M>;
+export interface GiftsSpotDeps {
+    /**
+     * Ask the server whether the claims the reminder would draw ended (bounded, cached),
+     * before the spot says what happened. `dismissed`: the reminder's dismissed claims,
+     * never asked about. Absent: the claim log alone decides.
+     */
+    checkClaims?(dismissed: (transactionId: string) => boolean): Promise<void>;
+    /** An offer finished today, none claimed since, not thanked yet: its claim's id. */
+    thanksFor?(): string | null;
+}
+export interface GiftsSpotContent<G> {
+    /** The gifts button's content (its offers), with the completion when there is one. */
+    gifts: G;
+    /** The reminder's content, when the user has a claim it could show. */
+    reminder: ReminderContent | null;
+    /** The completion the `completed` state is about, when there is no claim to show. */
+    completion: string | null;
+}
+export type GiftsSpotConfig<F> = {
+    of: 'gifts';
+    config: F;
+} | {
+    of: 'reminder';
+    config: ReminderConfig;
+};
+export type GiftsSpotModel<M> = {
+    of: 'gifts';
+    model: M;
+} | {
+    of: 'reminder';
+    model: ReminderModel;
+};
+/**
+ * The spot over the two plug-ins. `gifts` is the GiftsButton plug-in (its content takes
+ * an optional `thanks` completion), `reminder` the ClaimReminder plug-in.
+ */
+export declare function giftsSpotPlugin<G extends {
+    thanks?: string;
+}, F, M>(gifts: Plugin<G, F, M>, reminder: Plugin<ReminderContent, ReminderConfig, ReminderModel>, deps: GiftsSpotDeps): Plugin<GiftsSpotContent<G>, GiftsSpotConfig<F>, GiftsSpotModel<M>>;
+export {};
+//# sourceMappingURL=spot.d.ts.map

package/types/triggers/giftsButton/spot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spot.d.ts","sourceRoot":"","sources":["../../../src/triggers/giftsButton/spot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,eAAe,CAAC;AAMhE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,oFAAoF;IACpF,SAAS,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,sFAAsF;IACtF,KAAK,EAAE,CAAC,CAAC;IACT,uEAAuE;IACvE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzG,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAErG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE,CAAC,EACjE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC,EAChE,IAAI,EAAE,aAAa,GAClB,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAyHpE"}

package/types/triggers/host/TriggerHost.d.ts

@@ -0,0 +1,127 @@
+/**
+ * The one trigger host: mounts any registered trigger plug-in into an element.
+ *
+ * Owns everything triggers share (generic-contract.md, "Host responsibilities"):
+ * the pre-config gate (`prepare`), `/config?trigger=<id>&useCase=<real>` once per
+ * identity, the envelope check, decode, present, the served locale, visibility and the
+ * `sdk_trigger_*` events with their common fields, one tap at a time, the
+ * per-trigger dismiss store, foreground re-prepare, and a full re-run on identity
+ * or language change (`reload()`).
+ *
+ * It never throws into the host page and renders nothing (no element, so zero height)
+ * whenever there is nothing to show.
+ */
+import type { AnalyticsEvent } from '../../analytics/models';
+import type { EncoreAlignment, TriggerHandle, TriggerMountOptions, ShowResult } from '../../types';
+import { type TriggerRequest } from '../request';
+import type { TriggerPortalTheme } from './theme';
+import type { AnyTriggerPlugin, TriggerEntry, HostSheetRequest } from './types';
+/** What the host needs from the SDK. Encore builds one per mount. */
+export interface TriggerHostDeps {
+    /** `GET /config?trigger=<id>&useCase=…` for this placement and request. Rejects on failure. */
+    fetchConfig(triggerId: string, placementId: string | undefined, request: TriggerRequest): Promise<unknown>;
+    track(build: (distinctId: string) => AnalyticsEvent): void;
+    /** Where dismissals persist. May throw (blocked storage) or return null. */
+    storage(): Storage | null;
+    /** The SDK's sheet, for a plug-in whose tap presents it. Absent: resolves unavailable. */
+    presentSheet?(request: HostSheetRequest): Promise<ShowResult>;
+    /** Whether a sheet the app opened itself is up now. An automatic tap waits while it is. */
+    sheetBusy?(): boolean;
+}
+/** What a reload starts over for: another person, or the same person in another language. */
+export type ReloadScope = 'identity' | 'language';
+/** The public handle, plus the SDK's own hook for an identity or language change. */
+export interface HostHandle extends TriggerHandle {
+    /** The mounted trigger's id. */
+    readonly triggerId: string;
+    /**
+     * INTERNAL: start over (fresh prepare and /config). Encore calls it from reset() and
+     * identify() (`identity`), and from setLanguage() and clearLanguage() (`language`).
+     */
+    reload(scope?: ReloadScope): void;
+    /** INTERNAL: read the content again, keeping the variant (targeting attributes changed). */
+    refresh(): void;
+}
+export declare const NOOP_HANDLE: HostHandle;
+/** A handle that does nothing, for a mount that never started. */
+export declare function noopHandle(): TriggerHandle;
+/** The alignment a mount asked for; anything else is the default, centre. */
+export declare function triggerAlignmentOf(value: unknown): EncoreAlignment;
+/** What the served response says, once checked. */
+interface Served {
+    config: unknown;
+    variantId?: string;
+    experimentId?: string;
+    /** The step a look's behavior chose this for (`ui.step`), with the experiment that decided it. */
+    step?: 'afterClaim' | 'afterComplete';
+    stepExperimentId?: string | null;
+    locale?: string;
+    /** The app's theme from the portal (`ui.values`). */
+    portal?: TriggerPortalTheme;
+    /** The text slots this mount's text replaced in the served look, sorted. */
+    textSlots?: readonly string[];
+}
+/**
+ * A sheet the app opened itself ended in a claim: a pop held behind it is dropped, as
+ * after a trigger's own sheet. Encore calls it, once the host is loaded.
+ */
+export declare function appSheetClaimed(): void;
+/**
+ * A custom claim handle's tap (`Encore.claim`) takes the same page-wide lock as a
+ * trigger's: one sheet at a time. Null when another tap is in flight.
+ */
+export declare function takePageTap(): symbol | null;
+/**
+ * The sheet a custom handle's tap opened closed: release the lock as a trigger's tap
+ * does (a held pop is dropped after a claim, else the first one runs), and every
+ * mounted trigger reads again, afresh after a claim.
+ */
+export declare function settlePageTap(token: symbol, claimed: boolean): void;
+/** Hear every dismiss in a trigger mount. Returns an unsubscribe. */
+export declare function onTriggerDismissed(listener: (triggerId: string) => void): () => void;
+/**
+ * A custom handle dismissed `triggerId`'s content: every mount that draws it (its own, or a
+ * spot drawing its look) catches up, and every other custom handle hears it. `source`, the
+ * handle's own listener, is not told again.
+ */
+export declare function dismissedByCustom(triggerId: string, source?: (triggerId: string) => void): void;
+/** Test hook: forget a tap a previous test left in flight. */
+export declare function forgetPageTap(): void;
+type Dict = Record<string, unknown>;
+/**
+ * The served config for `triggerId`, or null to render nothing: no template (the
+ * holdout, or no experiment), or a template for another trigger (a server that does
+ * not know `trigger` answers with the sheet's own config, which names none).
+ */
+export declare function readTriggerResponse(response: unknown, 
+/** The triggers whose looks may answer: the mounted one first, then those it may render. */
+drawable: string | readonly string[], decode: (template: Dict) => unknown): Served | null;
+/** The fade when the spot switches between its components (the gifts button and its reminder). */
+export declare const SWITCH_FADE_MS = 200;
+/**
+ * Whether `key` (placement and reason) was already reported today for this trigger,
+ * marking it reported if not. localStorage when it works, a page-wide record always.
+ * Only today's entries are kept.
+ */
+export declare function claimNotShownToday(storage: Storage | null, triggerId: string, key: string): boolean;
+/**
+ * Mount a trigger (a plug-in, or a registry entry that loads it) into `element`.
+ * `deps` is null when the SDK is not configured, which renders nothing. Never throws.
+ */
+export declare function mountTrigger(trigger: AnyTriggerPlugin | TriggerEntry, element: HTMLElement | null | undefined, options: TriggerMountOptions, deps: TriggerHostDeps | null, 
+/** Called once when the mount is torn down by any path, including the host removing it. */
+onReleased?: () => void): HostHandle;
+/**
+ * reset(): forget what this page holds for the previous person beside storage: the
+ * dismissals and the day's not-shown reports kept while storage could not take them.
+ */
+export declare function forgetTriggerMemory(): void;
+/**
+ * The user's claims changed (a claim just happened, a completion landed, or the claims
+ * API was bound): every mount reads again, afresh. Its device state may have changed
+ * (a GiftsButton spot now has a claim to remind about, or a completed one to thank for),
+ * and a held set may still list the claimed offer. Encore calls it.
+ */
+export declare function claimsChanged(): void;
+export {};
+//# sourceMappingURL=TriggerHost.d.ts.map

package/types/triggers/host/TriggerHost.d.ts.map

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

package/types/triggers/host/autoPops.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The device's one pop a day per placement: a GiftsButton look and an `Encore.claim`
+ * view whose rules open the sheet by themselves share it, so a placement opens by itself
+ * at most once per local day whichever drew it.
+ */
+/** Where the pops are remembered: `{ [placement]: 'YYYY-MM-DD' }`, local days. */
+export declare const AUTO_POP_STORAGE_KEY = "encore.trigger.giftsButton.autoPopped";
+/** Forget the page-wide pops: reset(), and tests. */
+export declare function forgetAutoPops(): void;
+export declare function localDay(ms: number): string;
+/** The pop store over `storage` (read at each call; null or throwing falls back to the page). */
+export declare function autoPops(storage: () => Storage | null): {
+    reservePop: (placement: string | undefined, now: number) => boolean;
+    releasePop: (placement: string | undefined, day: string) => void;
+};
+//# sourceMappingURL=autoPops.d.ts.map

package/types/triggers/host/autoPops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoPops.d.ts","sourceRoot":"","sources":["../../../src/triggers/host/autoPops.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,0CAA0C,CAAC;AAU5E,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI3C;AAuBD,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG;IACvD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE,CA2DA"}