@chatwarden/player-react 0.0.0-stage → 0.1.2

package/dist/src/ReportDialog.js

@@ -0,0 +1,157 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useId, useRef, useState } from 'react';
+import { NOTE_MAX } from './constants.js';
+import { PlayerError } from './client.js';
+import { Dialog } from './Dialog.js';
+import { DETAIL_REFUSED_TEXT, FollowUp } from './FollowUp.js';
+import { Picker } from './Picker.js';
+import { groupReasons, readReporting } from './reporting.js';
+import { errorText, Portal, Root, useUi } from './ui.js';
+// One plain message for each refusal the kit has. Anything else (a refusal a newer kit adds) gets the last one.
+const REFUSED_TEXT = {
+    duplicate: 'player.report.refused.duplicate',
+    rate: 'player.report.refused.rate',
+    self: 'player.report.refused.self',
+    not_player: 'player.report.refused.not_player',
+    off: 'player.report.refused.off',
+    suspended: 'player.report.refused.suspended',
+    reason_required: 'player.report.refused.reason_required',
+    reason_unknown: 'player.report.refused.reason_unknown',
+};
+/** How much of the reported message is quoted on the screen. */
+const LINE_MAX = 280;
+/** A failure to send as an error the components can word: anything that is not already a PlayerError is a dropped connection. */
+const failureOf = (e) => e instanceof PlayerError ? e : new PlayerError({ status: 0, code: 'network', message: 'Could not reach the server.' });
+/** Anything that is not a result object (undefined, null, a string) is not a success and not a crash: it reads as an unknown refusal. */
+const resultOf = (answer, unknown) => (typeof answer === 'object' && answer !== null && !Array.isArray(answer) ? answer : unknown);
+const quoted = (line) => {
+    const plain = (line ?? '').replace(/\s+/g, ' ').trim();
+    return plain.length > LINE_MAX ? `${plain.slice(0, LINE_MAX).trimEnd()}…` : plain;
+};
+/**
+ * A dialog for reporting a message or a player. How it works is the studio's setting (`reporting`, from `GET /rules`):
+ * - `one_tap` (the default): one step, "Report this message?" and a Report button. The report is filed at once and the thank-you
+ *   shown; an optional "Add a reason" step then attaches a reason and a note to the same report (`onAddDetail`).
+ * - `reason_first`: the reasons in groups, then an optional note; a reason can be skipped.
+ * - `reason_required`: the same without the skip.
+ * The reason is only a hint for the moderators. Every refusal the kit can give has its own plain message. Render it when the player
+ * chooses to report, and unmount it in `onClose`.
+ */
+export function ReportDialog(props) {
+    const { onSubmit, onAddDetail, onClose, targetName, line, theme, className, container, returnFocusTo } = props;
+    const ui = useUi(props);
+    const { t } = ui;
+    const heading = useRef(null);
+    const picker = useRef(null);
+    // One thing on its way at a time, report or follow-up: a second click, or a second Enter, does nothing.
+    const sending = useRef(false);
+    const titleId = useId();
+    const groupName = useId();
+    const noteId = useId();
+    const hintId = useId();
+    const missingId = useId();
+    const [reason, setReason] = useState(null);
+    const [note, setNote] = useState('');
+    const [missing, setMissing] = useState(false);
+    const [busy, setBusy] = useState(false);
+    const [failure, setFailure] = useState(null);
+    const [result, setResult] = useState(null);
+    // How the follow-up after a one-tap report ended, and whether its time is up (the kit takes one until `detailUntil`).
+    const [dDone, setDDone] = useState(null);
+    const [expired, setExpired] = useState(false);
+    const screen = (() => {
+        // No `reporting` (or something that is not the payload): one tap with the dialog's own words, as when `GET /rules` cannot be loaded.
+        const read = readReporting(props.reporting) ?? { flow: 'one_tap', reasons: [], thanks: '' };
+        // A flow that asks for a reason has nothing to ask with when the list is empty: it is one tap.
+        return { flow: read.reasons.length === 0 ? 'one_tap' : read.flow, reasons: read.reasons, thanks: read.thanks.trim() };
+    })();
+    const { flow } = screen;
+    const groups = groupReasons(screen.reasons);
+    const chosen = screen.reasons.find((r) => r.id === reason);
+    // The note: when the chosen reason asks for it.
+    const showNote = chosen?.asksNote === true;
+    // The form is gone once there is an answer: focus goes back to the heading, so the answer is read and focus is not lost.
+    useEffect(() => {
+        if (result !== null)
+            heading.current?.focus();
+    }, [result]);
+    useEffect(() => {
+        if (dDone !== null)
+            heading.current?.focus();
+    }, [dDone]);
+    // The follow-up stops being offered when the kit would no longer take it.
+    const until = result?.ok === true && typeof result.detailUntil === 'number' && Number.isFinite(result.detailUntil) ? result.detailUntil : null;
+    useEffect(() => {
+        if (until === null)
+            return undefined;
+        let timer;
+        // Looks at the clock again when the time comes, so a clock that has not moved does not end the offer early.
+        const check = () => {
+            const left = until - ui.now();
+            if (left < 0)
+                setExpired(true);
+            else
+                timer = setTimeout(check, Math.min(Math.max(left + 1, 50), 2_000_000_000));
+        };
+        check();
+        return () => clearTimeout(timer);
+    }, [until]);
+    const send = async (draft) => {
+        sending.current = true;
+        setBusy(true);
+        setFailure(null);
+        try {
+            setResult(resultOf(await onSubmit(draft), { ok: false, refused: 'unknown' }));
+        }
+        catch (error) {
+            setFailure(failureOf(error));
+        }
+        finally {
+            sending.current = false;
+            setBusy(false);
+        }
+    };
+    const trimmed = note.trim();
+    const submit = (e) => {
+        e.preventDefault();
+        if (sending.current)
+            return;
+        if (flow !== 'one_tap' && reason === null) {
+            setMissing(true);
+            picker.current?.querySelector('input')?.focus();
+            return;
+        }
+        const draft = flow === 'one_tap' ? {} : { reason: reason };
+        if (showNote && trimmed !== '')
+            draft.note = trimmed;
+        void send(draft);
+    };
+    const skip = () => {
+        if (sending.current)
+            return;
+        void send(showNote && trimmed !== '' ? { note: trimmed } : {});
+    };
+    const reportId = result?.ok === true && typeof result.reportId === 'string' && result.reportId !== '' ? result.reportId : null;
+    const quote = quoted(line);
+    const oneTapTitle = quote !== '' ? t('player.report.titleOneTap') : targetName === undefined ? t('player.report.titleOneTapPlayer') : t('player.report.titleOneTapNamed', { name: targetName });
+    const title = flow === 'one_tap' ? oneTapTitle : targetName === undefined ? t('player.report.title') : t('player.report.titleNamed', { name: targetName });
+    const taken = result?.ok === true;
+    const refusal = result !== null && !taken ? result : null;
+    // After an answer the heading says what happened (a question would be stale), and focus is on it.
+    const shownTitle = result === null ? title : taken ? t('player.report.titleSent') : t('player.report.titleRefused');
+    const remaining = taken && typeof result.remaining === 'number' && Number.isFinite(result.remaining) && result.remaining >= 0 ? result.remaining : null;
+    const refusedKey = (r) => {
+        const refused = r.refused;
+        return typeof refused === 'string' && Object.hasOwn(REFUSED_TEXT, refused) ? REFUSED_TEXT[refused] : 'player.report.refused.unknown';
+    };
+    const detailRefusedKey = (refused) => (Object.hasOwn(DETAIL_REFUSED_TEXT, refused) ? DETAIL_REFUSED_TEXT[refused] : 'player.report.detail.failed');
+    const detailUntil = taken && typeof result.detailUntil === 'number' && Number.isFinite(result.detailUntil) ? result.detailUntil : null;
+    const timeUp = expired || (detailUntil !== null && ui.now() > detailUntil);
+    const canFollow = taken && flow === 'one_tap' && reportId !== null && onAddDetail !== undefined && screen.reasons.length > 0 && !timeUp;
+    const needText = flow === 'reason_first' ? 'player.report.needReasonOrSkip' : 'player.report.needReason';
+    return (_jsx(Portal, { container: container, children: _jsx(Root, { theme: theme, className: className, children: _jsxs(Dialog, { labelledBy: titleId, initialFocus: heading, onEscape: () => !sending.current && onClose(), ...(returnFocusTo === undefined ? {} : { returnFocusTo }), children: [_jsx("h2", { id: titleId, ref: heading, className: "cw-title", tabIndex: -1, children: shownTitle }), _jsxs("div", { role: "status", className: "cw-live", children: [taken && (_jsxs("p", { className: "cw-result", children: [screen.thanks === '' ? t('player.report.thanks') : screen.thanks, remaining !== null && ` ${t('player.report.remaining', { count: remaining })}`] })), dDone?.ok === true && _jsx("p", { className: "cw-result", children: t('player.report.detail.added') })] }), result === null ? (_jsxs("form", { onSubmit: submit, noValidate: true, children: [_jsx("p", { className: "cw-body", children: flow === 'one_tap' ? t('player.report.oneTap.intro') : t('player.report.intro') }), quote !== '' && _jsx("blockquote", { className: "cw-quote", children: t('player.report.quote', { line: quote }) }), flow !== 'one_tap' && (_jsx(Picker, { groups: groups, name: groupName, value: reason, legend: t('player.report.legend'), invalid: missing, describedBy: missingId, fieldset: picker, onChange: (id) => {
+                                    setReason(id);
+                                    setMissing(false);
+                                } })), missing && (_jsx("p", { id: missingId, className: "cw-field-error", role: "alert", children: t(needText) })), showNote && (_jsxs(_Fragment, { children: [_jsx("label", { className: "cw-label", htmlFor: noteId, children: t('player.report.note') }), _jsx("textarea", { id: noteId, className: "cw-textarea", rows: 4, maxLength: NOTE_MAX, value: note, "aria-describedby": hintId, onChange: (e) => setNote(e.target.value) }), _jsx("p", { id: hintId, className: "cw-hint", children: t('player.report.noteHint', { max: NOTE_MAX }) })] })), failure !== null && (_jsxs("p", { className: "cw-error", role: "alert", children: [t('player.report.failed'), " ", errorText(t, failure)] })), _jsxs("div", { className: "cw-actions", children: [_jsx("button", { type: "submit", className: "cw-btn cw-btn--primary", "aria-disabled": busy || undefined, "aria-busy": busy || undefined, children: flow === 'one_tap' ? t('player.report.oneTap.send') : t('player.report.send') }), flow === 'reason_first' && (_jsx("button", { type: "button", className: "cw-btn", "aria-disabled": busy || undefined, "aria-busy": busy || undefined, onClick: skip, children: t('player.report.skip') })), _jsx("button", { type: "button", className: "cw-btn", "aria-disabled": busy || undefined, onClick: () => !sending.current && onClose(), children: t('player.report.cancel') })] })] })) : (_jsxs(_Fragment, { children: [!taken && (_jsx("p", { className: "cw-error", role: "alert", children: t(refusedKey(refusal)) })), canFollow && dDone === null && (_jsx(FollowUp, { t: t, groups: groups, reportId: reportId, onAddDetail: onAddDetail, sending: sending, busy: busy, onBusy: setBusy, onDone: setDDone })), dDone !== null && !dDone.ok && (_jsx("p", { className: "cw-error", role: "alert", children: t(detailRefusedKey(dDone.refused)) })), _jsx("div", { className: "cw-actions", children: _jsx("button", { type: "button", className: "cw-btn cw-btn--primary", "aria-disabled": busy || undefined, onClick: () => !sending.current && onClose(), children: t('player.report.close') }) })] }))] }) }) }));
+}
+//# sourceMappingURL=ReportDialog.js.map

package/dist/src/ReportDialog.js.map

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

package/dist/src/RestrictedChatLine.d.ts

@@ -0,0 +1,12 @@
+import type { PlayerUiProps } from './ui.js';
+export interface RestrictedChatLineProps extends PlayerUiProps {
+    /** When the restriction ends (epoch ms), or `null` for no end. From `cw.chat.restricted(...)`. */
+    until: number | null;
+    /** `true` when a moderator turned the chat off, `false` when the automatic filter did (kind `auto`). */
+    byModerator: boolean;
+    /** The reference code to quote to a moderator, when you have one. */
+    refCode?: string;
+}
+/** One line for the place a chat box would be, saying why the player cannot type, until when, and who did it. */
+export declare function RestrictedChatLine(props: RestrictedChatLineProps): import("react").JSX.Element;
+//# sourceMappingURL=RestrictedChatLine.d.ts.map

package/dist/src/RestrictedChatLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestrictedChatLine.d.ts","sourceRoot":"","sources":["../../src/RestrictedChatLine.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,kGAAkG;IAClG,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wGAAwG;IACxG,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,+BA2BhE"}

package/dist/src/RestrictedChatLine.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { timeLeft, untilText } from './format.js';
+import { Card, Root, useUi } from './ui.js';
+/** One line for the place a chat box would be, saying why the player cannot type, until when, and who did it. */
+export function RestrictedChatLine(props) {
+    const { until, byModerator, refCode, theme, className } = props;
+    const ui = useUi(props);
+    const { t, locale, timeZone } = ui;
+    const ends = typeof until === 'number' && Number.isFinite(until);
+    const when = ends ? untilText(until, locale, timeZone) : '';
+    const left = ends ? timeLeft(until, ui.now(), locale) : null;
+    const text = !ends
+        ? t(byModerator ? 'player.restricted.moderator.noEnd' : 'player.restricted.filter.noEnd')
+        : left === null
+            ? t('player.restricted.ended', { when })
+            : t(byModerator ? 'player.restricted.moderator.until' : 'player.restricted.filter.until', { when, left });
+    return (_jsx(Root, { theme: theme, className: className, children: _jsxs("p", { className: "cw-restricted", role: "status", children: [_jsx(Card, { kind: "chat" }), _jsx("span", { className: "cw-text", children: text }), refCode !== undefined && (_jsxs(_Fragment, { children: [' ', _jsx("span", { className: "cw-ref", children: t('player.restricted.ref', { code: refCode }) })] }))] }) }));
+}
+//# sourceMappingURL=RestrictedChatLine.js.map

package/dist/src/RestrictedChatLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestrictedChatLine.js","sourceRoot":"","sources":["../../src/RestrictedChatLine.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAY5C,iHAAiH;AACjH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAChE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,IAAI;QAChB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,gCAAgC,CAAC;QACzF,CAAC,CAAC,IAAI,KAAK,IAAI;YACb,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9G,OAAO,CACL,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,YACtC,aAAG,SAAS,EAAC,eAAe,EAAC,IAAI,EAAC,QAAQ,aACxC,KAAC,IAAI,IAAC,IAAI,EAAC,MAAM,GAAG,EACpB,eAAM,SAAS,EAAC,SAAS,YAAE,IAAI,GAAQ,EACtC,OAAO,KAAK,SAAS,IAAI,CACxB,8BACG,GAAG,EACJ,eAAM,SAAS,EAAC,QAAQ,YAAE,CAAC,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAQ,IAC9E,CACJ,IACC,GACC,CACR,CAAC;AACJ,CAAC"}

package/dist/src/RulesPage.d.ts

@@ -0,0 +1,10 @@
+import type { PlayerClient } from './client.js';
+import type { PlayerUiProps } from './ui.js';
+export interface RulesPageProps extends PlayerUiProps {
+    client: PlayerClient;
+    /** Change it to load the rules again. */
+    refreshKey?: number | string;
+}
+/** The community rules: the profile's summary and the numbered rules from `GET /rules`. Text only, never HTML. */
+export declare function RulesPage(props: RulesPageProps): import("react").JSX.Element;
+//# sourceMappingURL=RulesPage.d.ts.map

package/dist/src/RulesPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RulesPage.d.ts","sourceRoot":"","sources":["../../src/RulesPage.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,kHAAkH;AAClH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,+BAmC9C"}

package/dist/src/RulesPage.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from 'react';
+import { usePlayerData } from './hooks.js';
+import { ErrorBlock, Root, useUi } from './ui.js';
+/** The community rules: the profile's summary and the numbered rules from `GET /rules`. Text only, never HTML. */
+export function RulesPage(props) {
+    const { client, refreshKey, theme, className } = props;
+    const ui = useUi(props);
+    const { t } = ui;
+    const state = usePlayerData(() => client.rules(), refreshKey);
+    const titleId = useId();
+    const data = state.data;
+    return (_jsx(Root, { theme: theme, className: className, children: _jsxs("section", { className: "cw-section", "aria-labelledby": titleId, children: [_jsx("h2", { id: titleId, className: "cw-title", children: t('player.rules.title') }), state.error !== null && _jsx(ErrorBlock, { ui: ui, what: t('player.rules.loadFailed'), error: state.error, onRetry: state.reload }), data === undefined && state.error === null && (_jsx("p", { className: "cw-state", role: "status", children: t('player.rules.loading') })), data !== undefined && data.summary !== '' && _jsx("p", { className: "cw-summary", children: data.summary }), data !== undefined && data.rules.length === 0 && _jsx("p", { className: "cw-state", children: t('player.rules.empty') }), data !== undefined && data.rules.length > 0 && (
+                // The kit's own numbers, so a retired rule leaves a gap instead of renumbering the ones after it.
+                _jsx("ol", { className: "cw-rules", "aria-labelledby": titleId, children: data.rules.map((rule) => (_jsxs("li", { value: rule.number, children: [_jsx("strong", { className: "cw-rule-title", children: rule.title }), " ", _jsx("span", { className: "cw-rule-text", children: rule.text })] }, rule.number))) }))] }) }));
+}
+//# sourceMappingURL=RulesPage.js.map

package/dist/src/RulesPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RulesPage.js","sourceRoot":"","sources":["../../src/RulesPage.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AASlD,kHAAkH;AAClH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IACvD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAExB,OAAO,CACL,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,YACtC,mBAAS,SAAS,EAAC,YAAY,qBAAkB,OAAO,aACtD,aAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAC,UAAU,YAClC,CAAC,CAAC,oBAAoB,CAAC,GACrB,EACJ,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAC,UAAU,IAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,GAAI,EAC7H,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,CAC7C,YAAG,SAAS,EAAC,UAAU,EAAC,IAAI,EAAC,QAAQ,YAClC,CAAC,CAAC,sBAAsB,CAAC,GACxB,CACL,EACA,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE,IAAI,YAAG,SAAS,EAAC,YAAY,YAAE,IAAI,CAAC,OAAO,GAAK,EACzF,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,YAAG,SAAS,EAAC,UAAU,YAAE,CAAC,CAAC,oBAAoB,CAAC,GAAK,EACtG,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI;gBAC9C,kGAAkG;gBAClG,aAAI,SAAS,EAAC,UAAU,qBAAkB,OAAO,YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACxB,cAAsB,KAAK,EAAE,IAAI,CAAC,MAAM,aACtC,iBAAQ,SAAS,EAAC,eAAe,YAAE,IAAI,CAAC,KAAK,GAAU,OAAC,eAAM,SAAS,EAAC,cAAc,YAAE,IAAI,CAAC,IAAI,GAAQ,KADlG,IAAI,CAAC,MAAM,CAEf,CACN,CAAC,GACC,CACN,IACO,GACL,CACR,CAAC;AACJ,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,51 @@
+import type { PlayerNotice, PlayerReporting } from '@chatwarden/core';
+import type { Transport } from './transport.js';
+/**
+ * Why a call to the player routes failed. `status` is the HTTP status, or 0 when no answer arrived. `code` is the kit's error
+ * code (`not_found`, `rate_limited`, ...), `network` for a dropped connection, `bad_response` for an answer that is not the
+ * shape the components expect, `unexpected` for anything else, and `http_<status>` when the body is not a kit error.
+ * `retryAfter` is the seconds from a `retry-after` header (a 429).
+ */
+export declare class PlayerError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly retryAfter: number | undefined;
+    constructor(init: {
+        status: number;
+        code: string;
+        message: string;
+        retryAfter?: number;
+    });
+}
+/** A `PlayerError` as is; anything else (a bug in the caller's code, say) becomes status 0, code `unexpected`. */
+export declare function toPlayerError(e: unknown): PlayerError;
+/** One rule as `GET /rules` gives it. */
+export interface PlayerRule {
+    number: number;
+    title: string;
+    text: string;
+}
+/** `GET /rules`: the profile's one-line summary, the active rules and how reporting works here (`undefined` from an older server). */
+export interface PlayerRules {
+    summary: string;
+    rules: PlayerRule[];
+    /** The flow, the reasons a player may give and the thank-you: pass it to `ReportDialog` as `reporting`. */
+    reporting?: PlayerReporting;
+}
+export interface PlayerClient {
+    /** `GET /notices`: notices not yet acknowledged, as the kit sends them (oldest first). */
+    notices(): Promise<PlayerNotice[]>;
+    /** `POST /notices/:id/ack`: `true` when it was this player's live notice, `false` (still a 200) when it was not, or it is gone. */
+    ack(id: string): Promise<boolean>;
+    /** `GET /record`: the player's sanctions that still apply (seen or not). */
+    record(): Promise<PlayerNotice[]>;
+    /** `GET /rules`: the summary, the numbered rules and the reporting settings. */
+    rules(): Promise<PlayerRules>;
+}
+export interface PlayerClientOptions {
+    /** How to reach the player routes: `fetchTransport({ baseUrl: '/player' })`, or any function with the same shape. */
+    transport: Transport;
+}
+/** A client over the kit's player routes. It resolves with typed values and rejects with a `PlayerError`. */
+export declare function createPlayerClient({ transport }: PlayerClientOptions): PlayerClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAuC,MAAM,gBAAgB,CAAC;AAErF;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAOzF;AAED,kHAAkH;AAClH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,CAGrD;AAmDD,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sIAAsI;AACtI,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2GAA2G;IAC3G,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,0FAA0F;IAC1F,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnC,mIAAmI;IACnI,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAClC,gFAAgF;IAChF,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,qHAAqH;IACrH,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,EAAE,EAAE,mBAAmB,GAAG,YAAY,CAoBnF"}

package/dist/src/client.js

@@ -0,0 +1,98 @@
+import { readReporting } from './reporting.js';
+/**
+ * Why a call to the player routes failed. `status` is the HTTP status, or 0 when no answer arrived. `code` is the kit's error
+ * code (`not_found`, `rate_limited`, ...), `network` for a dropped connection, `bad_response` for an answer that is not the
+ * shape the components expect, `unexpected` for anything else, and `http_<status>` when the body is not a kit error.
+ * `retryAfter` is the seconds from a `retry-after` header (a 429).
+ */
+export class PlayerError extends Error {
+    status;
+    code;
+    retryAfter;
+    constructor(init) {
+        super(init.message);
+        this.name = 'PlayerError';
+        this.status = init.status;
+        this.code = init.code;
+        this.retryAfter = init.retryAfter;
+    }
+}
+/** A `PlayerError` as is; anything else (a bug in the caller's code, say) becomes status 0, code `unexpected`. */
+export function toPlayerError(e) {
+    if (e instanceof PlayerError)
+        return e;
+    return new PlayerError({ status: 0, code: 'unexpected', message: e instanceof Error ? e.message : 'Something went wrong.' });
+}
+const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+const text = (v) => typeof v === 'string';
+function errorOf(res) {
+    const b = res.body;
+    const raw = res.headers['retry-after'];
+    const rest = raw !== undefined && /^\d{1,9}$/.test(raw) ? { retryAfter: Number(raw) } : {};
+    if (isObject(b) && text(b.error) && text(b.message))
+        return new PlayerError({ status: res.status, code: b.error, message: b.message, ...rest });
+    // A proxy's HTML page, or an empty body: say the status, never echo the body.
+    return new PlayerError({ status: res.status, code: `http_${res.status}`, message: `The server answered with status ${res.status}.`, ...rest });
+}
+async function send(transport, req) {
+    let res;
+    try {
+        res = await transport(req);
+    }
+    catch (e) {
+        throw new PlayerError({ status: 0, code: 'network', message: e instanceof Error && e.name === 'AbortError' ? 'The request was cancelled.' : 'Could not reach the server.' });
+    }
+    if (res.status < 200 || res.status > 299)
+        throw errorOf(res);
+    return res.body;
+}
+const bad = () => new PlayerError({ status: 200, code: 'bad_response', message: 'The server sent an answer these components do not understand.' });
+/** One notice, keeping only the fields the kit documents for a player. Anything else the server sent never reaches the page. */
+function noticeOf(raw) {
+    if (!isObject(raw) || !text(raw.id) || !text(raw.kind))
+        return null;
+    const excerpt = Array.isArray(raw.excerpt)
+        ? raw.excerpt.filter(isObject).filter((l) => text(l.text) && text(l.day)).map((l) => ({ text: l.text, day: l.day }))
+        : [];
+    return {
+        id: raw.id,
+        kind: raw.kind,
+        rule: typeof raw.rule === 'number' || raw.rule === 'uncovered' ? raw.rule : null,
+        ruleLabel: text(raw.ruleLabel) ? raw.ruleLabel : null,
+        until: typeof raw.until === 'number' && Number.isFinite(raw.until) ? raw.until : null,
+        refCode: text(raw.refCode) ? raw.refCode : null,
+        excerpt,
+        createdAt: typeof raw.createdAt === 'number' && Number.isFinite(raw.createdAt) ? raw.createdAt : 0,
+        mustAcknowledge: raw.mustAcknowledge === true,
+    };
+}
+function noticesOf(body, key) {
+    if (!isObject(body) || !Array.isArray(body[key]))
+        throw bad();
+    return body[key].map(noticeOf).filter((n) => n !== null);
+}
+/** A client over the kit's player routes. It resolves with typed values and rejects with a `PlayerError`. */
+export function createPlayerClient({ transport }) {
+    return {
+        notices: async () => noticesOf(await send(transport, { method: 'GET', path: '/notices' }), 'notices'),
+        record: async () => noticesOf(await send(transport, { method: 'GET', path: '/record' }), 'record'),
+        ack: async (id) => {
+            const body = await send(transport, { method: 'POST', path: `/notices/${encodeURIComponent(id)}/ack` });
+            if (!isObject(body) || typeof body.ok !== 'boolean')
+                throw bad();
+            return body.ok;
+        },
+        rules: async () => {
+            const body = await send(transport, { method: 'GET', path: '/rules' });
+            if (!isObject(body) || !text(body.summary) || !Array.isArray(body.rules))
+                throw bad();
+            const rules = body.rules
+                .filter(isObject)
+                .filter((r) => typeof r.number === 'number' && text(r.title) && text(r.text))
+                .map((r) => ({ number: r.number, title: r.title, text: r.text }));
+            const reporting = readReporting(body.reporting);
+            return { summary: body.summary, rules, ...(reporting === undefined ? {} : { reporting }) };
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/constants.d.ts

@@ -0,0 +1,5 @@
+/** The longest note the kit keeps (a test keeps this the same as core's `REPORT_NOTE_MAX`). */
+export declare const NOTE_MAX = 500;
+/** How many days a warning stays on a record (a test keeps this the same as core's notice record window). */
+export declare const WARNING_DAYS = 90;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,MAAM,CAAC;AAE5B,6GAA6G;AAC7G,eAAO,MAAM,YAAY,KAAK,CAAC"}

package/dist/src/constants.js

@@ -0,0 +1,5 @@
+/** The longest note the kit keeps (a test keeps this the same as core's `REPORT_NOTE_MAX`). */
+export const NOTE_MAX = 500;
+/** How many days a warning stays on a record (a test keeps this the same as core's notice record window). */
+export const WARNING_DAYS = 90;
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAE5B,6GAA6G;AAC7G,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC"}

package/dist/src/format.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A UTC day from the kit (`2027-01-15`) as the locale writes a date (`Jan 15, 2027`), in UTC whatever the viewer's zone: the kit
+ * names the day in UTC, so a notice never shows a different day than the moderator's tools. A value that is not a day comes back
+ * as it was; it is never shown as "Invalid Date".
+ */
+export declare function dayText(day: string, locale: string): string;
+/** A date and time: `Jan 15, 2027, 8:30 PM`. Pass a time zone for a fixed one; the default is the viewer's. An unknown zone is ignored. */
+export declare function untilText(at: number, locale: string, timeZone?: string): string;
+/**
+ * How long is left until `at`, as the locale says it ("in 3 hours"): minutes under an hour (a part of a minute counts as a whole
+ * one, so a live restriction never reads "in 0 minutes"), hours under two days, then days. Null when `at` is now or has passed.
+ */
+export declare function timeLeft(at: number, now: number, locale: string): string | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/format.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,2IAA2I;AAC3I,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/E"}

package/dist/src/format.js

@@ -0,0 +1,55 @@
+// Small pure helpers for showing days, times and waits. Times use Intl with the component's `locale`; none holds English.
+const MIN = 60_000;
+const HOUR = 60 * MIN;
+const DAY = 24 * HOUR;
+function safeLocale(locale) {
+    try {
+        return Intl.getCanonicalLocales(locale)[0] ?? 'en';
+    }
+    catch {
+        return 'en';
+    }
+}
+/** Some runtimes put a narrow no-break space before "PM". A plain space reads the same and survives a copy. */
+const plain = (text) => text.replace(/[\u202f\u00a0]/g, ' ');
+/**
+ * A UTC day from the kit (`2027-01-15`) as the locale writes a date (`Jan 15, 2027`), in UTC whatever the viewer's zone: the kit
+ * names the day in UTC, so a notice never shows a different day than the moderator's tools. A value that is not a day comes back
+ * as it was; it is never shown as "Invalid Date".
+ */
+export function dayText(day, locale) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(day);
+    if (m === null)
+        return day;
+    const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
+    const date = new Date(Date.UTC(y, mo - 1, d));
+    if (date.getUTCFullYear() !== y || date.getUTCMonth() !== mo - 1 || date.getUTCDate() !== d)
+        return day;
+    return new Intl.DateTimeFormat(safeLocale(locale), { dateStyle: 'medium', timeZone: 'UTC' }).format(date);
+}
+/** A date and time: `Jan 15, 2027, 8:30 PM`. Pass a time zone for a fixed one; the default is the viewer's. An unknown zone is ignored. */
+export function untilText(at, locale, timeZone) {
+    const options = { dateStyle: 'medium', timeStyle: 'short' };
+    try {
+        return plain(new Intl.DateTimeFormat(safeLocale(locale), { ...options, ...(timeZone === undefined ? {} : { timeZone }) }).format(at));
+    }
+    catch {
+        return plain(new Intl.DateTimeFormat(safeLocale(locale), options).format(at));
+    }
+}
+/**
+ * How long is left until `at`, as the locale says it ("in 3 hours"): minutes under an hour (a part of a minute counts as a whole
+ * one, so a live restriction never reads "in 0 minutes"), hours under two days, then days. Null when `at` is now or has passed.
+ */
+export function timeLeft(at, now, locale) {
+    const left = at - now;
+    if (!(left > 0))
+        return null;
+    const rtf = new Intl.RelativeTimeFormat(safeLocale(locale), { numeric: 'always' });
+    if (left < HOUR)
+        return rtf.format(Math.max(1, Math.ceil(left / MIN)), 'minute');
+    if (left < 2 * DAY)
+        return rtf.format(Math.round(left / HOUR), 'hour');
+    return rtf.format(Math.round(left / DAY), 'day');
+}
+//# sourceMappingURL=format.js.map

package/dist/src/format.js.map

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

package/dist/src/hooks.d.ts

@@ -0,0 +1,15 @@
+import { PlayerError } from './client.js';
+export interface PlayerData<T> {
+    /** The last answer, kept when a later load fails. */
+    data: T | undefined;
+    /** The last failure, or null. Cleared when a load starts. */
+    error: PlayerError | null;
+    /** Starts the same load again. */
+    reload: () => void;
+}
+/**
+ * Runs `load` on mount, again when `refreshKey` changes, and again on `reload()`. An answer from a load that has been replaced
+ * (or from a component that is gone) is dropped, so a slow old request never overwrites a newer one.
+ */
+export declare function usePlayerData<T>(load: () => Promise<T>, refreshKey: unknown): PlayerData<T>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,qDAAqD;IACrD,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,kCAAkC;IAClC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAwB3F"}

package/dist/src/hooks.js

@@ -0,0 +1,29 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { PlayerError, toPlayerError } from './client.js';
+/**
+ * Runs `load` on mount, again when `refreshKey` changes, and again on `reload()`. An answer from a load that has been replaced
+ * (or from a component that is gone) is dropped, so a slow old request never overwrites a newer one.
+ */
+export function usePlayerData(load, refreshKey) {
+    const [state, setState] = useState({ data: undefined, error: null });
+    const [again, setAgain] = useState(0);
+    const loader = useRef(load);
+    loader.current = load;
+    useEffect(() => {
+        let live = true;
+        setState((s) => (s.error === null ? s : { ...s, error: null }));
+        loader.current().then((data) => {
+            if (live)
+                setState({ data, error: null });
+        }, (e) => {
+            if (live)
+                setState((s) => ({ data: s.data, error: toPlayerError(e) }));
+        });
+        return () => {
+            live = false;
+        };
+    }, [refreshKey, again]);
+    const reload = useCallback(() => setAgain((n) => n + 1), []);
+    return { data: state.data, error: state.error, reload };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWzD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAI,IAAsB,EAAE,UAAmB;IAC1E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqD,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAEtB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CACnB,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,IAAI;gBAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC,EACD,CAAC,CAAU,EAAE,EAAE;YACb,IAAI,IAAI;gBAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,IAAI,GAAG,KAAK,CAAC;QACf,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC"}