@tiledev/sdk-apptile-live-selling 0.1.0

package/dist/polls.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.polls = void 0;
+exports.toLivePoll = toLivePoll;
+exports.toLivePollResults = toLivePollResults;
+exports.toEmbeddedResults = toEmbeddedResults;
+/**
+ * Live polls.
+ *
+ * The host owns a poll end to end: it creates one, starts it, then republishes the tally to the room.
+ * A viewer reads those broadcasts and POSTs a vote — there is no poll GET on the viewer path, so
+ * despite the name nothing here polls anything.
+ *
+ * Two normalisations on the way in: option ids become strings (the dashboard sends numbers in the poll
+ * but strings in the tally), and the pre-rendered `percentage` is dropped in favour of deriving from
+ * the raw counts.
+ */
+const client_1 = require("./client");
+const wire_1 = require("./wire");
+/** The dashboard numbers its options in the poll and stringifies them in the tally. */
+function toOptionId(raw) {
+    return (0, wire_1.str)(raw);
+}
+function toCount(raw) {
+    const value = (0, wire_1.num)(raw);
+    return value !== null && value > 0 ? Math.floor(value) : 0;
+}
+function toLivePoll(raw) {
+    var _a, _b, _c;
+    const wire = raw;
+    const pollUuid = (0, wire_1.str)((0, wire_1.get)(wire, 'poll_uuid'));
+    if (!pollUuid)
+        return null;
+    const options = [];
+    const wireOptionIds = {};
+    for (const entry of (0, wire_1.arr)((0, wire_1.get)(wire, 'options'))) {
+        const option = entry;
+        // Kept exactly as it arrived: a vote has to echo the original type, and sending `"1"` where every
+        // other viewer sends `1` risks the service tallying the two apart.
+        const original = (_a = (0, wire_1.get)(option, 'optionId')) !== null && _a !== void 0 ? _a : (0, wire_1.get)(option, 'option_id');
+        if (typeof original !== 'string' && typeof original !== 'number')
+            continue;
+        const optionId = toOptionId(original);
+        if (!optionId)
+            continue;
+        options.push({ optionId, text: (_b = (0, wire_1.str)((0, wire_1.get)(option, 'text'))) !== null && _b !== void 0 ? _b : '' });
+        wireOptionIds[optionId] = original;
+    }
+    // A poll with nothing to vote on is not one; an empty sheet is worse than none.
+    if (!options.length)
+        return null;
+    return {
+        pollUuid,
+        streamingId: (0, wire_1.str)((0, wire_1.get)(wire, 'streaming_id')),
+        question: (_c = (0, wire_1.str)((0, wire_1.get)(wire, 'question'))) !== null && _c !== void 0 ? _c : '',
+        options,
+        wireOptionIds,
+    };
+}
+function toLivePollResults(raw) {
+    var _a;
+    if (!(0, wire_1.isRecord)(raw))
+        return null;
+    const votes = {};
+    let counted = 0;
+    for (const entry of (0, wire_1.arr)(raw.options)) {
+        const option = entry;
+        const optionId = toOptionId((_a = (0, wire_1.get)(option, 'optionId')) !== null && _a !== void 0 ? _a : (0, wire_1.get)(option, 'option_id'));
+        if (!optionId)
+            continue;
+        votes[optionId] = toCount((0, wire_1.get)(option, 'votes'));
+        counted += votes[optionId];
+    }
+    const total = toCount(raw.total_votes);
+    return {
+        pollUuid: (0, wire_1.str)(raw.poll_uuid),
+        // The host's own sum wins, but never below what the options add up to.
+        totalVotes: Math.max(total, counted),
+        votes,
+    };
+}
+/**
+ * The tally a poll payload carries with it, or null when it carries none. A tally of zero is treated
+ * as absent — a plain `START_POLL` would otherwise wipe a real count with an authoritative "nobody
+ * voted".
+ */
+function toEmbeddedResults(raw) {
+    var _a;
+    const results = (_a = toLivePollResults((0, wire_1.get)(raw, 'pollResults'))) !== null && _a !== void 0 ? _a : toLivePollResults(raw);
+    return results && results.totalVotes > 0 ? results : null;
+}
+// ─── Remembering the vote ────────────────────────────────────────────────────
+const VOTES_KEY = 'live.pollVotes';
+const MAX_REMEMBERED = 20;
+async function readVotes() {
+    try {
+        const raw = await (0, client_1.storageGet)(VOTES_KEY);
+        const parsed = raw ? JSON.parse(raw) : null;
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Namespace ─────────────────────────────────────────────────────────────
+exports.polls = {
+    async vote(params) {
+        var _a;
+        await (0, client_1.liveSellingRequest)('/live-streaming/poll/vote', {
+            method: 'POST',
+            body: {
+                streaming_id: params.streamingId,
+                company_id: (_a = (0, client_1.getCompanyId)()) !== null && _a !== void 0 ? _a : (0, client_1.getConfig)().companyId,
+                poll_uuid: params.pollUuid,
+                viewer_id: params.viewerId,
+                option_id: params.optionId,
+            },
+        });
+    },
+    async loadVotedOption(pollUuid) {
+        var _a, _b;
+        const votes = await readVotes();
+        return (_b = (_a = votes.find(([uuid]) => uuid === pollUuid)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : null;
+    },
+    async rememberVote(pollUuid, optionId) {
+        const votes = (await readVotes()).filter(([uuid]) => uuid !== pollUuid);
+        votes.push([pollUuid, optionId]);
+        await (0, client_1.storageSet)(VOTES_KEY, JSON.stringify(votes.slice(-MAX_REMEMBERED)));
+    },
+    async forgetVote(pollUuid) {
+        const votes = (await readVotes()).filter(([uuid]) => uuid !== pollUuid);
+        await (0, client_1.storageSet)(VOTES_KEY, JSON.stringify(votes));
+    },
+};
+//# sourceMappingURL=polls.js.map

package/dist/polls.js.map

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

package/dist/react/LiveSellingProvider.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import type { LiveEvent, LiveSellingClient, LiveSellingConfig } from '../types';
+export interface LiveSellingContextType {
+    ready: boolean;
+    error: string | null;
+    client: LiveSellingClient;
+}
+export interface LiveSellingProviderProps {
+    children: ReactNode;
+    config: LiveSellingConfig;
+    /** Every live-engine event, for a host that wants to react without subscribing to the engine. */
+    onEvent?: (event: LiveEvent) => void;
+}
+export declare function LiveSellingProvider({ children, config, onEvent }: LiveSellingProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<LiveSellingContextType | undefined>>;
+export declare function useLiveSelling(): LiveSellingContextType;
+//# sourceMappingURL=LiveSellingProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LiveSellingProvider.d.ts","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iGAAiG;IACjG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAID,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,wBAAwB,+GA6B1F;AAED,wBAAgB,cAAc,IAAI,sBAAsB,CAIvD"}

package/dist/react/LiveSellingProvider.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveSellingProvider = LiveSellingProvider;
+exports.useLiveSelling = useLiveSelling;
+/**
+ * `LiveSellingProvider` — configures the client once and exposes readiness + the client to the tree.
+ *
+ * Mirrors `@apptile/sdk-shopify`'s `ShopifyProvider`: wrap the app once, then read the namespaces through
+ * hooks. Written with `createElement` rather than JSX so the file stays a plain `.ts` and needs no JSX
+ * runtime configured in a consumer's build.
+ *
+ * `onEvent` is a passthrough of the live engine's `LiveEvent` union, so a host can react to comments,
+ * bids, sold announcements and co-host signals without subscribing to the engine directly.
+ */
+const react_1 = require("react");
+const liveSelling_1 = require("../liveSelling");
+const LiveSellingContext = (0, react_1.createContext)(undefined);
+function LiveSellingProvider({ children, config, onEvent }) {
+    const [ready, setReady] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        try {
+            liveSelling_1.liveSelling.configure(config);
+            setError(null);
+            setReady(true);
+        }
+        catch (caught) {
+            setError(caught instanceof Error ? caught.message : String(caught));
+            // Ready so downstream UIs render an error state rather than an indefinite spinner.
+            setReady(true);
+        }
+        // Re-run only when the identifying config fields change.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [config.apiUrl, config.companyId, config.videoCollectionId]);
+    (0, react_1.useEffect)(() => {
+        if (!onEvent)
+            return;
+        return liveSelling_1.liveSelling.engine.subscribe(onEvent);
+    }, [onEvent]);
+    const value = (0, react_1.useMemo)(() => ({ ready, error, client: liveSelling_1.liveSelling }), [ready, error]);
+    return (0, react_1.createElement)(LiveSellingContext.Provider, { value }, children);
+}
+function useLiveSelling() {
+    const ctx = (0, react_1.useContext)(LiveSellingContext);
+    if (!ctx)
+        throw new Error('useLiveSelling must be used within a LiveSellingProvider');
+    return ctx;
+}
+//# sourceMappingURL=LiveSellingProvider.js.map

package/dist/react/LiveSellingProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveSellingProvider.js","sourceRoot":"","sources":["../../src/react/LiveSellingProvider.ts"],"names":[],"mappings":";;AA+BA,kDA6BC;AAED,wCAIC;AAlED;;;;;;;;;GASG;AACH,iCAA+F;AAG/F,gDAA6C;AAgB7C,MAAM,kBAAkB,GAAG,IAAA,qBAAa,EAAqC,SAAS,CAAC,CAAC;AAExF,SAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAA4B;IACzF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAC;IAExD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC;YACH,yBAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACpE,mFAAmF;YACnF,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,yDAAyD;QACzD,uDAAuD;IACzD,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAEhE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,OAAO,yBAAW,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAW,EAAE,CAAC,EAC7C,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAC;IAEF,OAAO,IAAA,qBAAa,EAAC,kBAAkB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,kBAAkB,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/react/LiveVideoTarget.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import { View } from 'react-native';
+import type { ViewProps, ViewStyle } from 'react-native';
+/** Whether real video can be rendered at all. False off-device, and on any build without the SDK. */
+export declare const isNativeVideoSupported: boolean;
+/**
+ * Falls back to a plain `View` rather than to null: callers position this and usually draw a poster
+ * over the top, and a missing child would collapse that layout instead of leaving the poster the
+ * right shape.
+ */
+export declare const NativeVideoView: import("react").ForwardRefExoticComponent<ViewProps & import("react").RefAttributes<unknown>>;
+export interface LiveVideoTargetProps {
+    /** Claim the picture while true. Exactly one mounted target should ever have this set. */
+    active: boolean;
+    /** A card usually wants picture without sound; the full-screen player and PIP want both. */
+    muted?: boolean;
+    style?: ViewStyle;
+    /** Rendered above the video — a poster, a spinner, a "waiting for the host" panel. */
+    children?: ReactNode;
+}
+export declare function LiveVideoTarget({ active, muted, style, children, }: LiveVideoTargetProps): import("react").CElement<ViewProps, View>;
+//# sourceMappingURL=LiveVideoTarget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LiveVideoTarget.d.ts","sourceRoot":"","sources":["../../src/react/LiveVideoTarget.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAiB,SAAS,EAAO,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAY,IAAI,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAsBzD,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,SAA4B,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,eAAe,+FAG1B,CAAC;AAEH,MAAM,WAAW,oBAAoB;IACnC,0FAA0F;IAC1F,MAAM,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,KAAa,EACb,KAAK,EACL,QAAQ,GACT,EAAE,oBAAoB,6CA2BtB"}

package/dist/react/LiveVideoTarget.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeVideoView = exports.isNativeVideoSupported = void 0;
+exports.LiveVideoTarget = LiveVideoTarget;
+/**
+ * `LiveVideoTarget` — the one primitive this package draws.
+ *
+ * A render target, not a player: it mounts the engine's native texture view and hands its tag to the
+ * session, which points the room's video at it. Everything else on a live screen — the header, the
+ * comments, the bid bar, the poster shown while there is no picture — is the host app's, by design.
+ *
+ * Ownership comes from the `active` prop rather than navigation focus, because a picture-in-picture
+ * surface is drawn *outside* the navigator where there is no route to read focus from. Exactly one
+ * mounted target should have it set; the usual expression is
+ * `active={isFocused && session.pipMode === 'none'}`.
+ *
+ * `createElement` rather than JSX, like the providers, so this stays a plain `.ts`.
+ */
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const nativeViewTag_1 = require("../nativeViewTag");
+const useLiveSession_1 = require("./useLiveSession");
+/**
+ * The engine's texture view, or undefined where there is no engine.
+ *
+ * `require` inside the branch rather than a top-level import, and the decision made in source rather
+ * than left to a bundler alias: a static import is evaluated whichever branch runs, and the Zego entry
+ * module touches `NativeModules.ZegoExpressNativeModule` while it loads. A resolver alias fixes that
+ * only where that resolver does the bundling — a runtime-transpiling host (a web preview that ships
+ * `src/**`) resolves the real module, finds no `ZegoTextureView` on it, and rendering an element of
+ * type `undefined` throws. So the branch has to be something every bundler honours.
+ */
+/** A host component, so it takes a ref — that ref's tag is what the engine renders into. */
+const NativeTextureView = react_native_1.Platform.OS === 'web'
+    ? undefined
+    : // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('zego-express-engine-reactnative').ZegoTextureView;
+/** Whether real video can be rendered at all. False off-device, and on any build without the SDK. */
+exports.isNativeVideoSupported = NativeTextureView != null;
+/**
+ * Falls back to a plain `View` rather than to null: callers position this and usually draw a poster
+ * over the top, and a missing child would collapse that layout instead of leaving the poster the
+ * right shape.
+ */
+exports.NativeVideoView = (0, react_1.forwardRef)(function NativeVideoView(props, ref) {
+    if (!NativeTextureView)
+        return (0, react_1.createElement)(react_native_1.View, props);
+    return (0, react_1.createElement)(NativeTextureView, { ...props, ref });
+});
+function LiveVideoTarget({ active, muted = false, style, children, }) {
+    const viewRef = (0, react_1.useRef)(null);
+    const { status, actions } = (0, useLiveSession_1.useLiveSession)();
+    const claim = (0, react_1.useCallback)(() => {
+        if (!active)
+            return;
+        if (status !== 'playing' && status !== 'connecting')
+            return;
+        const tag = (0, nativeViewTag_1.nativeViewTag)(viewRef.current);
+        if (tag == null)
+            return;
+        // Forced: this runs when the surface takes ownership, and the engine may still believe it is
+        // rendering into this view when in fact the view was torn down behind another screen.
+        actions.bindVideoView(tag, true);
+        actions.setMuted(muted);
+    }, [active, status, muted, actions]);
+    (0, react_1.useEffect)(claim, [claim]);
+    return (0, react_1.createElement)(react_native_1.View, { style: style !== null && style !== void 0 ? style : { flex: 1 } }, (0, react_1.createElement)(exports.NativeVideoView, {
+        ref: viewRef,
+        style: { position: 'absolute', top: 0, left: 0, right: 0, bottom: 0 },
+        onLayout: claim,
+    }), children);
+}
+//# sourceMappingURL=LiveVideoTarget.js.map

package/dist/react/LiveVideoTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveVideoTarget.js","sourceRoot":"","sources":["../../src/react/LiveVideoTarget.ts"],"names":[],"mappings":";;;AA8DA,0CAgCC;AA9FD;;;;;;;;;;;;;GAaG;AACH,iCAAkF;AAElF,+CAA8C;AAG9C,oDAAiD;AACjD,qDAAkD;AAElD;;;;;;;;;GASG;AACH,4FAA4F;AAC5F,MAAM,iBAAiB,GACrB,uBAAQ,CAAC,EAAE,KAAK,KAAK;IACnB,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,8DAA8D;QAC9D,OAAO,CAAC,iCAAiC,CAAC,CAAC,eAAe,CAAC;AAEjE,qGAAqG;AACxF,QAAA,sBAAsB,GAAG,iBAAiB,IAAI,IAAI,CAAC;AAEhE;;;;GAIG;AACU,QAAA,eAAe,GAAG,IAAA,kBAAU,EAAqB,SAAS,eAAe,CAAC,KAAK,EAAE,GAAG;IAC/F,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAA,qBAAa,EAAC,mBAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,IAAA,qBAAa,EAAC,iBAAiB,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAYH,SAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,KAAK,GAAG,KAAK,EACb,KAAK,EACL,QAAQ,GACa;IACrB,MAAM,OAAO,GAAG,IAAA,cAAM,EAAU,IAAI,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,+BAAc,GAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,YAAY;YAAE,OAAO;QAC5D,MAAM,GAAG,GAAG,IAAA,6BAAa,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO;QACxB,6FAA6F;QAC7F,sFAAsF;QACtF,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAErC,IAAA,iBAAS,EAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1B,OAAO,IAAA,qBAAa,EAClB,mBAAI,EACJ,EAAE,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAC/B,IAAA,qBAAa,EAAC,uBAAe,EAAE;QAC7B,GAAG,EAAE,OAAuB;QAC5B,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QACrE,QAAQ,EAAE,KAAK;KAChB,CAAC,EACF,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * React helpers for `@tiledev/sdk-apptile-live-selling` — the provider and the read hooks.
+ *
+ * Ships under the `/react` subpath so a consumer only pays for `react` if it uses them; the pure data
+ * client and the native engine work without React entirely.
+ */
+export { LiveSellingProvider, useLiveSelling, type LiveSellingProviderProps, type LiveSellingContextType, } from './LiveSellingProvider';
+export { useOngoingLive, type UseOngoingLiveOptions, type UseOngoingLiveState } from './useOngoingLive';
+export { useLiveStreams, type UseLiveStreamsState } from './useLiveStreams';
+export { useAuction, type UseAuctionState } from './useAuction';
+export { useReplays, type UseReplaysOptions, type UseReplaysState } from './useReplays';
+export { useClips, type UseClipsState } from './useClips';
+export { LiveSessionProvider, useLiveSession, type LiveSessionProviderProps, } from './useLiveSession';
+export { useStreamInfo, refreshStreamRecords, refreshStreamRecordsIfStale, } from './useStreamInfo';
+export { LiveVideoTarget, NativeVideoView, isNativeVideoSupported, type LiveVideoTargetProps, } from './LiveVideoTarget';
+export { useAuctionBidGate, SHEET_HANDOFF_MS, type AuctionBidGate, type BidBlocker } from './useAuctionBidGate';
+export { useAuctionWins, type AuctionWinRow, type UseAuctionWinsOptions, type UseAuctionWinsState, } from './useAuctionWins';
+export { nativeViewTag } from '../nativeViewTag';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nativeViewTag = exports.useAuctionWins = exports.SHEET_HANDOFF_MS = exports.useAuctionBidGate = exports.isNativeVideoSupported = exports.NativeVideoView = exports.LiveVideoTarget = exports.refreshStreamRecordsIfStale = exports.refreshStreamRecords = exports.useStreamInfo = exports.useLiveSession = exports.LiveSessionProvider = exports.useClips = exports.useReplays = exports.useAuction = exports.useLiveStreams = exports.useOngoingLive = exports.useLiveSelling = exports.LiveSellingProvider = void 0;
+/**
+ * React helpers for `@tiledev/sdk-apptile-live-selling` — the provider and the read hooks.
+ *
+ * Ships under the `/react` subpath so a consumer only pays for `react` if it uses them; the pure data
+ * client and the native engine work without React entirely.
+ */
+var LiveSellingProvider_1 = require("./LiveSellingProvider");
+Object.defineProperty(exports, "LiveSellingProvider", { enumerable: true, get: function () { return LiveSellingProvider_1.LiveSellingProvider; } });
+Object.defineProperty(exports, "useLiveSelling", { enumerable: true, get: function () { return LiveSellingProvider_1.useLiveSelling; } });
+var useOngoingLive_1 = require("./useOngoingLive");
+Object.defineProperty(exports, "useOngoingLive", { enumerable: true, get: function () { return useOngoingLive_1.useOngoingLive; } });
+var useLiveStreams_1 = require("./useLiveStreams");
+Object.defineProperty(exports, "useLiveStreams", { enumerable: true, get: function () { return useLiveStreams_1.useLiveStreams; } });
+var useAuction_1 = require("./useAuction");
+Object.defineProperty(exports, "useAuction", { enumerable: true, get: function () { return useAuction_1.useAuction; } });
+var useReplays_1 = require("./useReplays");
+Object.defineProperty(exports, "useReplays", { enumerable: true, get: function () { return useReplays_1.useReplays; } });
+var useClips_1 = require("./useClips");
+Object.defineProperty(exports, "useClips", { enumerable: true, get: function () { return useClips_1.useClips; } });
+// The assembled session: the engine's events plus the polled record, folded into one state.
+var useLiveSession_1 = require("./useLiveSession");
+Object.defineProperty(exports, "LiveSessionProvider", { enumerable: true, get: function () { return useLiveSession_1.LiveSessionProvider; } });
+Object.defineProperty(exports, "useLiveSession", { enumerable: true, get: function () { return useLiveSession_1.useLiveSession; } });
+var useStreamInfo_1 = require("./useStreamInfo");
+Object.defineProperty(exports, "useStreamInfo", { enumerable: true, get: function () { return useStreamInfo_1.useStreamInfo; } });
+Object.defineProperty(exports, "refreshStreamRecords", { enumerable: true, get: function () { return useStreamInfo_1.refreshStreamRecords; } });
+Object.defineProperty(exports, "refreshStreamRecordsIfStale", { enumerable: true, get: function () { return useStreamInfo_1.refreshStreamRecordsIfStale; } });
+var LiveVideoTarget_1 = require("./LiveVideoTarget");
+Object.defineProperty(exports, "LiveVideoTarget", { enumerable: true, get: function () { return LiveVideoTarget_1.LiveVideoTarget; } });
+Object.defineProperty(exports, "NativeVideoView", { enumerable: true, get: function () { return LiveVideoTarget_1.NativeVideoView; } });
+Object.defineProperty(exports, "isNativeVideoSupported", { enumerable: true, get: function () { return LiveVideoTarget_1.isNativeVideoSupported; } });
+var useAuctionBidGate_1 = require("./useAuctionBidGate");
+Object.defineProperty(exports, "useAuctionBidGate", { enumerable: true, get: function () { return useAuctionBidGate_1.useAuctionBidGate; } });
+Object.defineProperty(exports, "SHEET_HANDOFF_MS", { enumerable: true, get: function () { return useAuctionBidGate_1.SHEET_HANDOFF_MS; } });
+var useAuctionWins_1 = require("./useAuctionWins");
+Object.defineProperty(exports, "useAuctionWins", { enumerable: true, get: function () { return useAuctionWins_1.useAuctionWins; } });
+// React Native only, so it lives here rather than on the root entry.
+var nativeViewTag_1 = require("../nativeViewTag");
+Object.defineProperty(exports, "nativeViewTag", { enumerable: true, get: function () { return nativeViewTag_1.nativeViewTag; } });
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6DAK+B;AAJ7B,0HAAA,mBAAmB,OAAA;AACnB,qHAAA,cAAc,OAAA;AAIhB,mDAAwG;AAA/F,gHAAA,cAAc,OAAA;AACvB,mDAA4E;AAAnE,gHAAA,cAAc,OAAA;AACvB,2CAAgE;AAAvD,wGAAA,UAAU,OAAA;AACnB,2CAAwF;AAA/E,wGAAA,UAAU,OAAA;AACnB,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAEjB,4FAA4F;AAC5F,mDAI0B;AAHxB,qHAAA,mBAAmB,OAAA;AACnB,gHAAA,cAAc,OAAA;AAGhB,iDAIyB;AAHvB,8GAAA,aAAa,OAAA;AACb,qHAAA,oBAAoB,OAAA;AACpB,4HAAA,2BAA2B,OAAA;AAE7B,qDAK2B;AAJzB,kHAAA,eAAe,OAAA;AACf,kHAAA,eAAe,OAAA;AACf,yHAAA,sBAAsB,OAAA;AAGxB,yDAAgH;AAAvG,sHAAA,iBAAiB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAC5C,mDAK0B;AAJxB,gHAAA,cAAc,OAAA;AAKhB,qEAAqE;AACrE,kDAAiD;AAAxC,8GAAA,aAAa,OAAA"}

package/dist/react/useAuction.d.ts

@@ -0,0 +1,28 @@
+import type { AuctionWins } from '../types';
+export interface UseAuctionState {
+    /** Null until the first read; true once this install has accepted the bidding rules. */
+    acceptedTerms: boolean | null;
+    acceptTerms: () => Promise<void>;
+    /** Records a bid to the ledger. The round is still decided by the host's broadcast. */
+    recordBid: (params: {
+        amount: number;
+        bidderId: string;
+        bidderName: string;
+        storeProductId: string | null;
+    }) => Promise<void>;
+    enterGiveaway: (params: {
+        storeProductId: string;
+        customerGid: string;
+        displayName: string;
+        viewerId: string;
+    }) => Promise<boolean>;
+    /** Streams the customer owes on. Empty without `customerAccountRequest`. */
+    unpaidStreamIds: string[];
+    /** Everything won and not checked out. Null without `customerAccountRequest`. */
+    wins: AuctionWins | null;
+    /** Whether an unsettled previous auction blocks bidding on this stream. */
+    biddingBlocked: boolean;
+    refreshWins: () => Promise<void>;
+}
+export declare function useAuction(streamingId?: string | null): UseAuctionState;
+//# sourceMappingURL=useAuction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuction.d.ts","sourceRoot":"","sources":["../../src/react/useAuction.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uFAAuF;IACvF,SAAS,EAAE,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,aAAa,EAAE,CAAC,MAAM,EAAE;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iFAAiF;IACjF,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CAyDvE"}

package/dist/react/useAuction.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAuction = useAuction;
+/**
+ * `useAuction` — the durable (REST) side of bidding, bound for a screen.
+ *
+ * The interactive round — who is leading, the countdown, the hammer — arrives over the live engine's
+ * `LiveEvent` stream (subscribe via the provider's `onEvent` or `client.engine.subscribe`). This hook
+ * owns the parts that outlive a socket: the one-time terms acceptance, recording a bid to the ledger,
+ * entering a giveaway, and the unpaid-wins gate that decides whether this customer may bid at all.
+ *
+ * The wins/gate reads need `customerAccountRequest` in the config; without it they stay empty and
+ * `biddingBlocked` is always false.
+ */
+const react_1 = require("react");
+const liveSelling_1 = require("../liveSelling");
+const LiveSellingProvider_1 = require("./LiveSellingProvider");
+function useAuction(streamingId) {
+    const { ready } = (0, LiveSellingProvider_1.useLiveSelling)();
+    const [acceptedTerms, setAcceptedTerms] = (0, react_1.useState)(null);
+    const [unpaidStreamIds, setUnpaidStreamIds] = (0, react_1.useState)([]);
+    const [wins, setWins] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        if (!ready)
+            return;
+        void liveSelling_1.liveSelling.auctions.hasAcceptedTerms().then(setAcceptedTerms);
+    }, [ready]);
+    const refreshWins = (0, react_1.useCallback)(async () => {
+        const [ids, won] = await Promise.all([
+            liveSelling_1.liveSelling.auctions.unpaidStreamIds(),
+            liveSelling_1.liveSelling.auctions.wins(),
+        ]);
+        setUnpaidStreamIds(ids);
+        setWins(won);
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (ready)
+            void refreshWins();
+    }, [ready, refreshWins]);
+    const acceptTerms = (0, react_1.useCallback)(async () => {
+        await liveSelling_1.liveSelling.auctions.acceptTerms();
+        setAcceptedTerms(true);
+    }, []);
+    const recordBid = (0, react_1.useCallback)((params) => {
+        if (!streamingId)
+            return Promise.resolve();
+        return liveSelling_1.liveSelling.auctions.recordBid({ streamingId, ...params });
+    }, [streamingId]);
+    const enterGiveaway = (0, react_1.useCallback)((params) => {
+        if (!streamingId)
+            return Promise.resolve(false);
+        return liveSelling_1.liveSelling.auctions.enterGiveaway({ streamingId, ...params });
+    }, [streamingId]);
+    const biddingBlocked = liveSelling_1.liveSelling.auctions.isBiddingBlocked(unpaidStreamIds, streamingId !== null && streamingId !== void 0 ? streamingId : null);
+    return {
+        acceptedTerms,
+        acceptTerms,
+        recordBid,
+        enterGiveaway,
+        unpaidStreamIds,
+        wins,
+        biddingBlocked,
+        refreshWins,
+    };
+}
+//# sourceMappingURL=useAuction.js.map

package/dist/react/useAuction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuction.js","sourceRoot":"","sources":["../../src/react/useAuction.ts"],"names":[],"mappings":";;AA2CA,gCAyDC;AApGD;;;;;;;;;;GAUG;AACH,iCAAyD;AAEzD,gDAA6C;AAE7C,+DAAuD;AA4BvD,SAAgB,UAAU,CAAC,WAA2B;IACpD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,oCAAc,GAAE,CAAC;IACnC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,IAAA,gBAAQ,EAAiB,IAAI,CAAC,CAAC;IACzE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,IAAA,gBAAQ,EAAW,EAAE,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAAqB,IAAI,CAAC,CAAC;IAE3D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,KAAK,yBAAW,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE;QACzC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnC,yBAAW,CAAC,QAAQ,CAAC,eAAe,EAAE;YACtC,yBAAW,CAAC,QAAQ,CAAC,IAAI,EAAE;SAC5B,CAAC,CAAC;QACH,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,KAAK;YAAE,KAAK,WAAW,EAAE,CAAC;IAChC,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzB,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE;QACzC,MAAM,yBAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,IAAA,mBAAW,EAC3B,CAAC,MAAM,EAAE,EAAE;QACT,IAAI,CAAC,WAAW;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3C,OAAO,yBAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,aAAa,GAAG,IAAA,mBAAW,EAC/B,CAAC,MAAM,EAAE,EAAE;QACT,IAAI,CAAC,WAAW;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,yBAAW,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,cAAc,GAAG,yBAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,IAAI,CAAC,CAAC;IAEnG,OAAO;QACL,aAAa;QACb,WAAW;QACX,SAAS;QACT,aAAa;QACb,eAAe;QACf,IAAI;QACJ,cAAc;QACd,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/react/useAuctionBidGate.d.ts

@@ -0,0 +1,48 @@
+/**
+ * How long to leave between one panel closing and the next opening.
+ *
+ * Not cosmetic, if the host renders these as React Native `Modal`s: presenting one while another is
+ * still dismissing throws `Attempt to present … which is already presenting` on iOS — a native
+ * exception, so the app disappears rather than showing an error. The gate chains panels by design
+ * (rules, then the variant), so this is the one place that has to be careful about it.
+ *
+ * Long enough to outlast a slide-out, short enough not to read as a pause.
+ */
+export declare const SHEET_HANDOFF_MS = 380;
+/** What is standing between the viewer and the bid they asked for. */
+export type BidBlocker = 'signIn' | 'unpaidWins' | 'terms' | 'variant' | null;
+export interface AuctionBidGate {
+    blocker: BidBlocker;
+    /** The variant chosen for this round, once asked. */
+    variantId: string | null;
+    /** Runs the gate. `amount` omitted means the round's minimum — the slide gesture. */
+    requestBid: (amount?: number) => void;
+    /** Rules accepted: persists, then completes the held bid. */
+    acceptTerms: () => void;
+    /** A variant picked: remembers it for the round, then completes the held bid. */
+    chooseVariant: (variantId: string) => void;
+    /** Abandons the held bid and clears the blocker. */
+    dismiss: () => void;
+    /**
+     * Re-read the unpaid-wins gate.
+     *
+     * Call it when the live screen regains focus: the blocked state sends the customer to a cart to
+     * settle their tab, and on their return this is what unblocks them without an app restart. The SDK
+     * cannot hook navigation focus itself.
+     */
+    refreshUnpaidWins: () => void;
+}
+export interface UseAuctionBidGateOptions {
+    streamingId: string | null;
+    isLoggedIn: boolean;
+    /** True while a round is open. Closing one forgets the chosen variant. */
+    biddingOpen: boolean;
+    /** How many variants the lot under the hammer has. 1 or 0 skips the variant step. */
+    variantCount: number;
+    placeBid: (options?: {
+        amount?: number;
+        variantId?: string | null;
+    }) => Promise<void>;
+}
+export declare function useAuctionBidGate({ streamingId, isLoggedIn, biddingOpen, variantCount, placeBid, }: UseAuctionBidGateOptions): AuctionBidGate;
+//# sourceMappingURL=useAuctionBidGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuctionBidGate.d.ts","sourceRoot":"","sources":["../../src/react/useAuctionBidGate.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,CAAC;IACpB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qFAAqF;IACrF,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,iFAAiF;IACjF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,oDAAoD;IACpD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AAED,wBAAgB,iBAAiB,CAAC,EAChC,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,EAAE,wBAAwB,GAAG,cAAc,CAyH3C"}