@tiledev/sdk-apptile-live-selling 0.13.0 → 0.15.0

package/dist/react/useLiveGiveawaysAndPolls.d.ts

@@ -0,0 +1,95 @@
+import type { LiveGiveawayPrize } from '../pageTypes';
+/**
+ * The Live screen's giveaways and polls, so the screen stays plain tiles. Reads the app's live session
+ * for the show the route names, as `useLiveShop` does.
+ *
+ * - **Only while the show is on air** (playing, or waiting for its host) and the session holds this
+ *   show's record (`useLiveShow`; never a hidden show the shopper can't see). Once the show has ended,
+ *   all three tiles go.
+ * - **The session does the work:** the giveaway and poll, from the room and from the show's record for
+ *   a shopper who arrives late; the entry count; whether this shopper has entered
+ *   (`giveaway.registered`); the entry itself (`actions.enterGiveaway`); the draw's roster, waited for
+ *   and kept (`giveaway.result.entrantNamesReady`, ENG-705); one vote a poll, kept on the phone
+ *   (`actions.voteInPoll`), the tally hidden until this phone votes; a giveaway this phone watched end
+ *   never coming back from an out-of-date record, and a poll the record says has closed never raised;
+ *   the entry's flow (`useGiveawayEntry`), "YOU WON!" (`giveaway.result.isYou`) and the prize's
+ *   catalogue read (`useGiveawayPrize`). Nothing here repeats it.
+ * - **The giveaway** (`giveawayButton`): the pill while a giveaway is open and not drawn yet. Its sheet
+ *   shows the prize from the catalogue (Freckled Poppy's: the host picks it from the whole store, not
+ *   from this show's lots), its variant's photo and price, and the record's own name and variant; until
+ *   the catalogue answers, the record's variant photo and price (`variantImageUrl`, `variantPrice`). A
+ *   catalogue read that fails goes to `onWarning`.
+ *   - **Entering needs sign-in** (Freckled Poppy's rule). Signed out, Enter closes the sheet and starts
+ *     the app's sign-in (sdk-shopify's `useSignIn`; the app's Sign In page is `routes.openSignIn`); back
+ *     here signed in, the sheet opens again if the giveaway is still open and not drawn (Freckled
+ *     Poppy's ENG-583 fix), and the shopper taps Enter themselves. Back without signing in (the Sign In
+ *     page closed, or the system's sheet dismissed), nothing reopens. `useGiveawayEntry` does this;
+ *     "back here" is this screen focused with no system sheet up.
+ *   - **The entry carries the room's name for the shopper** (`session.viewerName`: their account's
+ *     name, never an email). While their account loads, Enter waits; if the room has none, the sheet
+ *     asks ("Entering As:", old Amore's) and the entry goes once the session holds the name.
+ *   - **An account with no first name is asked for one, and it goes on the account** (0.15.0; amore-v2's
+ *     ENG-686, decided 2026-10-19 by its Head of Engineering, the comment box's way: `useAccountName`).
+ *     "Entering As:" asks for a first and a last name (`accountName`, starting from what the account
+ *     has); Enter puts them on the account (sdk-shopify's `updateProfile`) and then enters under that
+ *     name (`onEnterWithAccountName`). So a shopper is asked once, by a giveaway or a comment. A name
+ *     that didn't go on the account says so in the sheet (`nameSaveFailed`) and enters nothing. A name
+ *     the show's team goes by (`LiveSellingProvider`'s `blockedNames`) is refused as it is typed
+ *     (`isNameAllowed`); the session refuses it too.
+ *   - An entry the host didn't confirm (`enterGiveaway` answers `{ entered: false }`) says so in the
+ *     sheet, and Enter can be tried again.
+ *   - The host's draw closes the sheet (Freckled Poppy's).
+ * - **The draw** (`giveawayDraw`): handed over once the roster is ready; "YOU WON!" for the shopper who
+ *   won (`giveaway.result.isYou`: by customer id when the record names the winner, else among those who
+ *   entered by name, the gateway naming the winner only by name). A draw already on the session when
+ *   this screen opens happened while the shopper was elsewhere: it is let go rather than played late.
+ * - **Where the prize goes is the server's, by the kind of show** (corrected 2026-10-19 in k-marie-v2,
+ *   ENG-928). On an auction show the server writes the win to the customer's `auction.winner` metafield
+ *   only, and Items You Won shows it. On a live show (not an auction) it adds the prize line, with its
+ *   `GIVEAWAY-…` discount code, to the cart id the shopper entered with (`cartId`, below) and writes no
+ *   metafield: Items You Won never sees it, and if that cart has been replaced since (a new cart after
+ *   an order, a dead cart replaced at launch) the prize is lost.
+ * - **The poll** (`pollButton`): the chip while a poll is open; its sheet closes when the poll ends or
+ *   the host opens another (Freckled Poppy's). Voting needs no sign-in.
+ */
+export declare function useLiveGiveawaysAndPolls(): {
+    giveawayButton: {
+        visible: boolean;
+        prize: LiveGiveawayPrize | null;
+        entryCount: number;
+        entered: boolean;
+        entering: boolean;
+        signInToEnter: boolean;
+        waitingForName: boolean;
+        askForName: boolean;
+        accountName: import("../pageTypes").NameOnAccount | null;
+        nameSaveFailed: boolean;
+        isNameAllowed: (name: string) => boolean;
+        nameMaxLength: number;
+        entryFailed: boolean;
+        sheetVisible: boolean;
+        onOpenSheet: () => void;
+        onCloseSheet: () => void;
+        onEnter: (typedName?: string) => void;
+        onEnterWithAccountName: (firstName: string, lastName: string) => undefined;
+        onSignInToEnter: () => void;
+    };
+    giveawayDraw: {
+        visible: boolean;
+        draw: import("./useGiveawayEntry").GiveawayDraw | null;
+        isWinner: boolean;
+        onDone: () => void;
+    };
+    pollButton: {
+        visible: boolean;
+        poll: import("../sessionTypes").LivePollView | null;
+        logoUrl: string | null;
+        sheetVisible: boolean;
+        onOpenSheet: () => void;
+        onCloseSheet: () => void;
+        onVote: (optionId: string) => void;
+    };
+};
+/** What `useLiveGiveawaysAndPolls` hands the Live screen's giveaway and poll tiles. */
+export type LiveGiveawaysAndPolls = ReturnType<typeof useLiveGiveawaysAndPolls>;
+//# sourceMappingURL=useLiveGiveawaysAndPolls.d.ts.map

package/dist/react/useLiveGiveawaysAndPolls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveGiveawaysAndPolls.d.ts","sourceRoot":"","sources":["../../src/react/useLiveGiveawaysAndPolls.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,wBAAwB;;;;;;;;;;;;8BA6FG,MAAM;;;;;;;4CAuCP,MAAM,YAAY,MAAM;;;;;;;;;;;;;;;;2BA1BnD,MAAM;;EA8CpB;AAED,uFAAuF;AACvF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/react/useLiveGiveawaysAndPolls.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLiveGiveawaysAndPolls = useLiveGiveawaysAndPolls;
+/**
+ * The Live screen's giveaways and polls (0.14.0, moved from amore-v2's
+ * `src/core/hooks/useLiveGiveawaysAndPolls.ts`: phase 5 of its "Live player plan", Freckled Poppy's
+ * behaviour, old Amore's look; 0.15.0 adds its account names and blocked names, from amore-v2's
+ * `eng928/integration`). The routes are the app's (`LiveSellingProvider`'s `routes`); the route's
+ * `streamId` param is read here.
+ */
+const sdk_shopify_1 = require("@tiledev/sdk-shopify");
+const react_1 = require("react");
+const livePages_1 = require("../livePages");
+const pageOptions_1 = require("../pageOptions");
+const sessionTypes_1 = require("../sessionTypes");
+const showNames_1 = require("../showNames");
+const viewer_1 = require("../viewer");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+const platformSession_1 = require("./platformSession");
+const useAccountName_1 = require("./useAccountName");
+const useGiveawayEntry_1 = require("./useGiveawayEntry");
+const useGiveawayPrize_1 = require("./useGiveawayPrize");
+const navigation_1 = require("./navigation");
+/**
+ * The Live screen's giveaways and polls, so the screen stays plain tiles. Reads the app's live session
+ * for the show the route names, as `useLiveShop` does.
+ *
+ * - **Only while the show is on air** (playing, or waiting for its host) and the session holds this
+ *   show's record (`useLiveShow`; never a hidden show the shopper can't see). Once the show has ended,
+ *   all three tiles go.
+ * - **The session does the work:** the giveaway and poll, from the room and from the show's record for
+ *   a shopper who arrives late; the entry count; whether this shopper has entered
+ *   (`giveaway.registered`); the entry itself (`actions.enterGiveaway`); the draw's roster, waited for
+ *   and kept (`giveaway.result.entrantNamesReady`, ENG-705); one vote a poll, kept on the phone
+ *   (`actions.voteInPoll`), the tally hidden until this phone votes; a giveaway this phone watched end
+ *   never coming back from an out-of-date record, and a poll the record says has closed never raised;
+ *   the entry's flow (`useGiveawayEntry`), "YOU WON!" (`giveaway.result.isYou`) and the prize's
+ *   catalogue read (`useGiveawayPrize`). Nothing here repeats it.
+ * - **The giveaway** (`giveawayButton`): the pill while a giveaway is open and not drawn yet. Its sheet
+ *   shows the prize from the catalogue (Freckled Poppy's: the host picks it from the whole store, not
+ *   from this show's lots), its variant's photo and price, and the record's own name and variant; until
+ *   the catalogue answers, the record's variant photo and price (`variantImageUrl`, `variantPrice`). A
+ *   catalogue read that fails goes to `onWarning`.
+ *   - **Entering needs sign-in** (Freckled Poppy's rule). Signed out, Enter closes the sheet and starts
+ *     the app's sign-in (sdk-shopify's `useSignIn`; the app's Sign In page is `routes.openSignIn`); back
+ *     here signed in, the sheet opens again if the giveaway is still open and not drawn (Freckled
+ *     Poppy's ENG-583 fix), and the shopper taps Enter themselves. Back without signing in (the Sign In
+ *     page closed, or the system's sheet dismissed), nothing reopens. `useGiveawayEntry` does this;
+ *     "back here" is this screen focused with no system sheet up.
+ *   - **The entry carries the room's name for the shopper** (`session.viewerName`: their account's
+ *     name, never an email). While their account loads, Enter waits; if the room has none, the sheet
+ *     asks ("Entering As:", old Amore's) and the entry goes once the session holds the name.
+ *   - **An account with no first name is asked for one, and it goes on the account** (0.15.0; amore-v2's
+ *     ENG-686, decided 2026-10-19 by its Head of Engineering, the comment box's way: `useAccountName`).
+ *     "Entering As:" asks for a first and a last name (`accountName`, starting from what the account
+ *     has); Enter puts them on the account (sdk-shopify's `updateProfile`) and then enters under that
+ *     name (`onEnterWithAccountName`). So a shopper is asked once, by a giveaway or a comment. A name
+ *     that didn't go on the account says so in the sheet (`nameSaveFailed`) and enters nothing. A name
+ *     the show's team goes by (`LiveSellingProvider`'s `blockedNames`) is refused as it is typed
+ *     (`isNameAllowed`); the session refuses it too.
+ *   - An entry the host didn't confirm (`enterGiveaway` answers `{ entered: false }`) says so in the
+ *     sheet, and Enter can be tried again.
+ *   - The host's draw closes the sheet (Freckled Poppy's).
+ * - **The draw** (`giveawayDraw`): handed over once the roster is ready; "YOU WON!" for the shopper who
+ *   won (`giveaway.result.isYou`: by customer id when the record names the winner, else among those who
+ *   entered by name, the gateway naming the winner only by name). A draw already on the session when
+ *   this screen opens happened while the shopper was elsewhere: it is let go rather than played late.
+ * - **Where the prize goes is the server's, by the kind of show** (corrected 2026-10-19 in k-marie-v2,
+ *   ENG-928). On an auction show the server writes the win to the customer's `auction.winner` metafield
+ *   only, and Items You Won shows it. On a live show (not an auction) it adds the prize line, with its
+ *   `GIVEAWAY-…` discount code, to the cart id the shopper entered with (`cartId`, below) and writes no
+ *   metafield: Items You Won never sees it, and if that cart has been replaced since (a new cart after
+ *   an order, a dead cart replaced at launch) the prize is lost.
+ * - **The poll** (`pollButton`): the chip while a poll is open; its sheet closes when the poll ends or
+ *   the host opens another (Freckled Poppy's). Voting needs no sign-in.
+ */
+function useLiveGiveawaysAndPolls() {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+    const streamId = (_b = (_a = (0, navigation_1.useRoute)().params) === null || _a === void 0 ? void 0 : _a.streamId) !== null && _b !== void 0 ? _b : '';
+    const isFocused = (0, navigation_1.useIsFocused)();
+    // The session changes only on the room's events, never on a clock.
+    const session = (0, platformSession_1.useLiveSession)();
+    const { voteInPoll } = session.actions;
+    const { loggedIn, restoring, customer } = (0, sdk_shopify_1.useCustomer)();
+    const { accountLoading, nameToComplete, saveNameToAccount } = (0, useAccountName_1.useAccountName)();
+    const cartId = (_d = (_c = (0, sdk_shopify_1.useCart)().cart) === null || _c === void 0 ? void 0 : _c.id) !== null && _d !== void 0 ? _d : null;
+    const nav = (0, navigation_1.useNavigation)();
+    const { routes, blockedNames } = (0, LiveSellingProvider_1.useLivePageOptions)();
+    const signIn = (0, sdk_shopify_1.useSignIn)({ onOpenSignInPage: (method) => routes.openSignIn(method, nav) });
+    // ─── Which show ────────────────────────────────────────────────────────────────────────────────
+    // The session's record once it is this show's: right after the pin it can still hold the last show's.
+    const { show, onAir, capabilities } = (0, platformSession_1.useLiveShow)(streamId);
+    const showing = onAir && !!show;
+    const giveaway = (_e = session.giveaway) !== null && _e !== void 0 ? _e : sessionTypes_1.IDLE_GIVEAWAY;
+    // ─── The giveaway: the entry's flow ────────────────────────────────────────────────────────────
+    const entry = (0, useGiveawayEntry_1.useGiveawayEntry)({
+        session,
+        canEnter: showing && capabilities.canEnterGiveaway,
+        isLoggedIn: !!loggedIn,
+        startSignIn: signIn.start,
+        // Back here: this screen focused (the Sign In page closed), and no system sign-in sheet up.
+        screenOnShow: isFocused && !signIn.signingIn,
+        // The shopper's ordinary cart, which the gateway ties the entry to (Freckled Poppy's). On a live
+        // show the server puts a won prize in this cart, even if the app has moved to another by the draw
+        // ("Where the prize goes", above).
+        cartId,
+    });
+    const openGiveaway = entry.open;
+    /** The prize from the catalogue: the description, and the given-away variant's photo and price. */
+    const { product: prizeProduct, variant: prizeVariant, readError: prizeReadError } = (0, useGiveawayPrize_1.useGiveawayPrize)(openGiveaway);
+    (0, react_1.useEffect)(() => {
+        var _a;
+        if (prizeReadError)
+            (0, pageOptions_1.reportLiveWarning)(prizeReadError, { at: 'live.giveawayPrize', storeProductId: (_a = openGiveaway === null || openGiveaway === void 0 ? void 0 : openGiveaway.storeProductId) !== null && _a !== void 0 ? _a : null });
+        // Reported once per failed read, for the prize it was for.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [prizeReadError]);
+    // The record's own price, should the catalogue not answer, priced in the show's currency.
+    const showCurrency = (_k = (_g = (_f = session.activeProduct) === null || _f === void 0 ? void 0 : _f.currencyCode) !== null && _g !== void 0 ? _g : (_j = (_h = session.products) === null || _h === void 0 ? void 0 : _h[0]) === null || _j === void 0 ? void 0 : _j.currencyCode) !== null && _k !== void 0 ? _k : null;
+    const prize = (0, react_1.useMemo)(() => {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        if (!openGiveaway)
+            return null;
+        const recordPrice = openGiveaway.variantPrice && showCurrency ? (0, sdk_shopify_1.formatMoney)({ amount: openGiveaway.variantPrice, currencyCode: showCurrency }) : null;
+        const variantPrice = (prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.price) && (prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.currencyCode) ? (0, sdk_shopify_1.formatMoney)({ amount: prizeVariant.price, currencyCode: prizeProduct.currencyCode }) : null;
+        return {
+            productName: openGiveaway.productName || (prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.title) || '',
+            variantTitle: (_b = (_a = openGiveaway.variantTitle) !== null && _a !== void 0 ? _a : prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.title) !== null && _b !== void 0 ? _b : null,
+            retailPrice: prizeVariant ? variantPrice : recordPrice,
+            // The catalogue's variant photo, else its product photo; until it answers, the record's variant photo.
+            imageUrl: (_f = (_e = (_d = (_c = prizeVariant === null || prizeVariant === void 0 ? void 0 : prizeVariant.imageUrl) !== null && _c !== void 0 ? _c : prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.imageUrl) !== null && _d !== void 0 ? _d : openGiveaway.variantImageUrl) !== null && _e !== void 0 ? _e : openGiveaway.thumbnailUrl) !== null && _f !== void 0 ? _f : null,
+            description: ((_h = (_g = prizeProduct === null || prizeProduct === void 0 ? void 0 : prizeProduct.raw) === null || _g === void 0 ? void 0 : _g.description) === null || _h === void 0 ? void 0 : _h.trim()) || null,
+        };
+    }, [openGiveaway, prizeProduct, prizeVariant, showCurrency]);
+    // ─── Who the shopper is to the giveaway ────────────────────────────────────────────────────────
+    const signInToEnter = !loggedIn && !restoring;
+    // A stored sign-in still being read, or a signed-in shopper's account (and so their name) still on its
+    // way: Enter waits. No first name on the account: asked, and saved to it. Else the room's own ask.
+    const { askForName, waitingForName } = (0, livePages_1.giveawayNameAsk)({
+        named: !!((_l = session.viewerName) === null || _l === void 0 ? void 0 : _l.trim()),
+        loggedIn: !!loggedIn,
+        hasCustomer: !!customer,
+        accountLoading,
+        nameToComplete,
+    });
+    // "Entering As:" for the account: the name goes on the account, then the entry goes under it.
+    const [savingAccountName, setSavingAccountName] = (0, react_1.useState)(false);
+    const [accountNameNotSaved, setAccountNameNotSaved] = (0, react_1.useState)(false);
+    const enterUnder = entry.enter;
+    const enterWithAccountName = (0, react_1.useCallback)(async (firstName, lastName) => {
+        setSavingAccountName(true);
+        setAccountNameNotSaved(false);
+        try {
+            const savedName = await saveNameToAccount(firstName, lastName);
+            if (savedName)
+                enterUnder(savedName);
+            else
+                setAccountNameNotSaved(true);
+        }
+        finally {
+            setSavingAccountName(false);
+        }
+    }, [saveNameToAccount, enterUnder]);
+    // A failure belongs to the sheet it happened in.
+    (0, react_1.useEffect)(() => {
+        if (!entry.sheetOpen)
+            setAccountNameNotSaved(false);
+    }, [entry.sheetOpen]);
+    const isNameAllowed = (0, react_1.useCallback)((name) => !(0, showNames_1.isBlockedViewerName)(name, blockedNames), [blockedNames]);
+    // ─── The poll ──────────────────────────────────────────────────────────────────────────────────
+    const poll = showing ? ((_m = session.poll) !== null && _m !== void 0 ? _m : null) : null;
+    const pollId = (_p = (_o = session.poll) === null || _o === void 0 ? void 0 : _o.pollUuid) !== null && _p !== void 0 ? _p : null;
+    const [pollSheetOpen, setPollSheetOpen] = (0, react_1.useState)(false);
+    // Closed whenever the poll changes, ended or replaced by the host's next: an empty sheet, or a
+    // question the shopper never chose to answer, would be in front of them.
+    (0, react_1.useEffect)(() => {
+        setPollSheetOpen(false);
+    }, [pollId]);
+    const votedAlready = !!((_q = session.poll) === null || _q === void 0 ? void 0 : _q.votedOptionId);
+    const vote = (0, react_1.useCallback)((optionId) => {
+        // One vote a poll (the session keeps it on the phone and ignores another); the sheet's choices are off once voted.
+        if (!votedAlready)
+            void voteInPoll(optionId);
+    }, [votedAlready, voteInPoll]);
+    return {
+        giveawayButton: {
+            visible: !!openGiveaway,
+            prize,
+            entryCount: giveaway.entryCount,
+            entered: giveaway.registered,
+            entering: entry.entering || savingAccountName,
+            signInToEnter,
+            waitingForName,
+            askForName,
+            accountName: nameToComplete,
+            nameSaveFailed: accountNameNotSaved,
+            isNameAllowed,
+            nameMaxLength: viewer_1.MAX_VIEWER_NAME,
+            entryFailed: entry.entryFailed,
+            sheetVisible: entry.sheetOpen,
+            onOpenSheet: entry.openSheet,
+            onCloseSheet: entry.closeSheet,
+            onEnter: entry.enter,
+            onEnterWithAccountName: (firstName, lastName) => void enterWithAccountName(firstName, lastName),
+            onSignInToEnter: entry.signInToEnter,
+        },
+        giveawayDraw: {
+            visible: showing,
+            draw: entry.draw,
+            isWinner: entry.youWon,
+            onDone: entry.drawDone,
+        },
+        pollButton: {
+            visible: !!poll,
+            poll,
+            // The show's poster stands in for a brand mark beside the question (old Amore's).
+            logoUrl: (_r = show === null || show === void 0 ? void 0 : show.thumbnailUrl) !== null && _r !== void 0 ? _r : null,
+            sheetVisible: pollSheetOpen && !!poll,
+            onOpenSheet: () => setPollSheetOpen(true),
+            onCloseSheet: () => setPollSheetOpen(false),
+            onVote: vote,
+        },
+    };
+}
+//# sourceMappingURL=useLiveGiveawaysAndPolls.js.map

package/dist/react/useLiveGiveawaysAndPolls.js.map

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

package/dist/react/useLivePage.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Everything the Live screen wires, so the screen stays plain tiles. Call it from the Live screen and
+ * from each of its tiles' wiring: every call reads the same session.
+ *
+ * - **The session is the app's** (`ShopifyLiveSessionProvider`), joined above the navigator; this
+ *   screen binds to its picture (the player tile's `LiveVideoTarget`) and never owns the room.
+ * - **Pinned to the route's show** while watching (`holdStream(streamId)`, at every arrival), so a host
+ *   restarting the broadcast can't swap the room underneath; released when the shopper closes the show
+ *   (back on a show that has ended or is still joining, ✕ on the bubble, or leaving any other way
+ *   without the bubble), and kept when the bubble takes the show.
+ * - **Which show** (`useLiveShow`): the session's record once it is this show's (just after the pin it
+ *   can still hold the last show's), where it stands, and whether it is on air.
+ * - **Where the link lands** (`streams.destinationFor`, one read of the show's record on arrival): a
+ *   show on air stays; an ended show with a recording is replaced by its Replay
+ *   (`routes.replaceWithReplay`); anything else (a rehearsal this shopper can't see included) by the
+ *   Live tab (`routes.backToLiveTab`). Not on the web, where nothing can play: the Tile preview stays on
+ *   this page to show its tiles, with the record's poster and the ended words.
+ * - **Every arrival** reads the record again (`refreshStreamRecords`, which restarts the session's
+ *   off-air wait, so a push tapped in the foreground can't be declared over on a stale record) and ends
+ *   the bubble: this screen shows the picture again.
+ * - **Back, every kind** (the header's arrow, the iOS swipe, Android's back; decided 2026-10-05,
+ *   amore-v2's Head of Engineering) shrinks a show that is playing or waiting for its host into the
+ *   bubble as the screen leaves, and closes one that has ended. One path: the screen's `beforeRemove`,
+ *   for the navigation's back actions (`BACK_ACTIONS`). Picture-in-picture is a back that always
+ *   shrinks; the cart shrinks the show and opens the Cart over this screen (Items You Won on an auction
+ *   show: `routes.openCart`). Android's back with nothing behind this screen (a link on a cold start)
+ *   does what the arrow does: back to the Live tab.
+ * - **A link from the show** (`openLink`, 0.15.0; decided 2026-10-19 by amore-v2's Head of Engineering)
+ *   opens inside the app, never the phone's browser: the show goes into the bubble, as for the cart, and
+ *   the app's `routes.openLink` opens the page (amore-v2: the store's product or collection on its
+ *   screen, any other page in its web page). Leaving the app for the phone's browser is what left the
+ *   player dark on the way back (ENG-629) and the phone's window blank (ENG-580). A link that isn't https
+ *   (`opensInApp`), or an app without `routes.openLink`, opens nothing, and the show stays.
+ * - **The cart's holds** (0.15.0, amore-v2's ENG-691): the header shows a timer under the cart button in
+ *   the soonest hold's last minutes; this hands it when each hold ends (`header.holdEndTimes`,
+ *   `holdEndTimesOf` over sdk-shopify's cart and its `cartExtensions`), and the header counts.
+ * - **One shrunk show at a time:** arriving here stops a replay's bubble (and the Replay screen stops
+ *   this show's bubble).
+ * - **The screen stays on** while it shows the show playing or waiting for its host.
+ * - **Under a sheet** (`routes.sheets`: the variant page, opened from the shop; the Sign In page) the
+ *   show plays on here, with the screen on and the light status bar, as Replay's does.
+ * - **Put away** while the show plays here (a sheet over it included), it goes on in the phone's own
+ *   floating window (`systemWindowWhenAway`); coming back finds it here again.
+ * - **`liveJoin`** (`track`) once per show per app run; never for a rehearsal, a show the config's
+ *   `hiddenShows` names, whoever watches it.
+ * - **Hidden shows** (`hiddenShows`): for a shopper who isn't on the team the session never holds one,
+ *   so it is never on air here (the link goes to the Live tab).
+ * - **Chat and reactions** are `useLiveChat`'s, shown only while the show is on air; a host's or
+ *   moderator's link in the chat opens through `openLink`.
+ */
+export declare function useLivePage(): {
+    /**
+     * Android's own picture-in-picture window is up. It shrinks the whole app, and every sheet on the
+     * Live screen (poll, giveaway, shop, custom bid, name, reactions) is a window of its own above the
+     * app, so it rode the shrink and covered the video (fixed 2026-10-08; Freckled Poppy hides its
+     * sheets the same way). The screen then draws only the player; the sheets' open state is the
+     * hooks', so they come back. iOS's window shows the video alone.
+     */
+    inSystemWindow: boolean;
+    /** The screen is on show (or under a sheet), over the dark video: light status bar text. */
+    lightStatusBar: boolean;
+    player: {
+        status: import("..").LiveShowStatus;
+        posterUrl: string | null;
+        isAuction: boolean;
+        videoActive: boolean;
+        systemWindowWhenAway: boolean;
+    };
+    header: {
+        ended: boolean;
+        isAuction: boolean;
+        startedAt: number | null;
+        viewerCount: number | null;
+        muted: boolean;
+        canMute: boolean;
+        canPip: boolean;
+        backShrinks: boolean;
+        cartCount: number;
+        holdEndTimes: number[];
+        onBack: () => void;
+        onToggleMute: () => void;
+        onPip: () => void;
+        onCart: () => void;
+    };
+    /** The chat, the comment box, reactions and the pinned comment: one set of props per tile (`useLiveChat`). */
+    chat: {
+        keyboardUp: boolean;
+        typing: boolean;
+        comments: {
+            visible: boolean;
+            comments: import("../types").LiveComment[];
+            hidden: boolean;
+            onToggleHidden: () => void;
+            onPressName: ((name: string) => void) | undefined;
+            onOpenLink: ((url: string) => void) | undefined;
+        };
+        commentBox: {
+            visible: boolean;
+            askForName: boolean;
+            accountName: import("..").NameOnAccount | null;
+            waitingForName: boolean;
+            signedOut: boolean;
+            auction: boolean;
+            keyboardRequest: number;
+            onSignInToComment: () => void;
+            sending: boolean;
+            mention: import("..").LiveCommentMention | null;
+            nameMaxLength: number;
+            onSend: (text: string) => Promise<void>;
+            onSaveName: (name: string) => Promise<boolean>;
+            onSaveAccountName: (firstName: string, lastName: string) => Promise<boolean>;
+            isNameAllowed: (name: string) => boolean;
+            onTypingChange: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+        };
+        reactionButton: {
+            visible: boolean;
+            onReact: (reactionUrl: string) => undefined;
+        };
+        reactions: {
+            visible: boolean;
+            reactions: import("../sessionTypes").FloatingReaction[];
+            reactionStyle: import("../types").ReactionStyle;
+        };
+        pinnedComment: {
+            visible: boolean;
+            pinnedComment: import("../types").LivePinnedComment | null;
+        };
+    };
+    /** A link from the show (0.15.0): its page inside the app, the show in the bubble. `useLiveShop` takes it. */
+    openLink: (url: string, title?: string | null) => void;
+};
+/** What `useLivePage` hands the Live screen and its tiles. */
+export type LivePage = ReturnType<typeof useLivePage>;
+//# sourceMappingURL=useLivePage.d.ts.map

package/dist/react/useLivePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLivePage.d.ts","sourceRoot":"","sources":["../../src/react/useLivePage.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,WAAW;IA2LvB;;;;;;OAMG;;IAEH,4FAA4F;;;;;;;;;;;;;;;;;;;;;;;;;IAgC5F,8GAA8G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE9G,8GAA8G;oBA7HxG,MAAM,UAAU,MAAM,GAAG,IAAI;EAgItC;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC"}