@chatwarden/player-react 0.0.0-stage → 0.1.3

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"}

package/dist/src/i18n.d.ts

@@ -0,0 +1,153 @@
+export declare const en: {
+    readonly 'player.error.network': "Could not reach the server. Check your connection and try again.";
+    readonly 'player.error.unauthorized': "You are signed out. Sign in again, then try again.";
+    readonly 'player.error.forbidden': "This account cannot do that.";
+    readonly 'player.error.notFound': "That could not be found.";
+    readonly 'player.error.rateLimited': "Too many requests. Try again in a moment.";
+    readonly 'player.error.rateLimited.after.one': "Too many requests. Try again in {count} second.";
+    readonly 'player.error.rateLimited.after.other': "Too many requests. Try again in {count} seconds.";
+    readonly 'player.error.server': "The server had a problem. Try again in a moment.";
+    readonly 'player.error.generic': "Something went wrong.";
+    readonly 'player.state.retry': "Try again";
+    readonly 'player.notices.loadFailed': "We could not check for notices.";
+    readonly 'player.notice.title.warning': "You have a warning";
+    readonly 'player.notice.title.chat': "Your chat is turned off";
+    readonly 'player.notice.title.area': "You cannot join public rooms";
+    readonly 'player.notice.title.ban': "You are banned";
+    readonly 'player.notice.title.report_outcome': "Thanks for your report";
+    readonly 'player.notice.title.fallback': "A message from the moderators";
+    readonly 'player.notice.body.warning': "A moderator gave you a warning for something you wrote. You can keep playing.";
+    readonly 'player.notice.body.chat': "A moderator turned off your chat. You can still play.";
+    readonly 'player.notice.body.area': "A moderator stopped you joining public rooms and matchmaking. You can still play in private rooms.";
+    readonly 'player.notice.body.ban': "A moderator banned you from playing.";
+    readonly 'player.notice.body.report_outcome': "A moderator looked at your report and took action. We do not share what was done.";
+    readonly 'player.notice.body.fallback': "There is a new message about your account.";
+    readonly 'player.notice.position': "Notice {n} of {total}";
+    readonly 'player.notice.rule': "Rule";
+    readonly 'player.notice.given': "Given";
+    readonly 'player.notice.until': "Until";
+    readonly 'player.notice.ended': "Ended";
+    readonly 'player.notice.noEnd': "No end date";
+    readonly 'player.notice.onRecordUntil': "On your record until";
+    readonly 'player.notice.untilLeft': "{when} ({left})";
+    readonly 'player.notice.ref': "Reference";
+    readonly 'player.notice.refHint': "Quote this code if you contact us.";
+    readonly 'player.notice.lines': "Your messages that led to this";
+    readonly 'player.notice.todo.warning': "Press Acknowledge to confirm you saw this.";
+    readonly 'player.notice.acknowledge': "Acknowledge";
+    readonly 'player.notice.gotIt': "Got it";
+    readonly 'player.notice.appeal': "Think this is a mistake?";
+    readonly 'player.notice.ackFailed': "Your notice is still here.";
+    readonly 'player.notice.closeForNow': "Close for now";
+    readonly 'player.record.title': "Your record";
+    readonly 'player.record.loading': "Loading your record";
+    readonly 'player.record.loadFailed': "We could not load your record.";
+    readonly 'player.record.intro': "This is what is on your record now. A warning stays for {days} days.";
+    readonly 'player.record.empty': "Your record is clear. Nothing is on it right now.";
+    readonly 'player.record.kind.warning': "Warning";
+    readonly 'player.record.kind.chat': "Chat restriction";
+    readonly 'player.record.kind.area': "Public rooms restriction";
+    readonly 'player.record.kind.ban': "Ban";
+    readonly 'player.record.kind.fallback': "Notice";
+    readonly 'player.rules.title': "Community rules";
+    readonly 'player.rules.loading': "Loading the rules";
+    readonly 'player.rules.loadFailed': "We could not load the rules.";
+    readonly 'player.rules.empty': "No rules are published yet.";
+    readonly 'player.restricted.moderator.until': "A moderator turned off your chat until {when} ({left}).";
+    readonly 'player.restricted.moderator.noEnd': "A moderator turned off your chat. It does not end on its own.";
+    readonly 'player.restricted.filter.until': "Your chat is off until {when} ({left}). The automatic filter caught a message.";
+    readonly 'player.restricted.filter.noEnd': "Your chat is off. It does not end on its own. The automatic filter caught a message.";
+    readonly 'player.restricted.ended': "Your chat is back on. The restriction ended {when}.";
+    readonly 'player.restricted.ref': "Reference {code}";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.title': "Report a player";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.titleNamed': "Report {name}";
+    readonly 'player.report.intro': "Tell us why and a moderator will look at it.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.legend': "What happened?";
+    readonly 'player.report.titleOneTap': "Report this message?";
+    readonly 'player.report.titleOneTapNamed': "Report {name}?";
+    readonly 'player.report.titleOneTapPlayer': "Report this player?";
+    readonly 'player.report.titleSent': "Report sent";
+    readonly 'player.report.titleRefused': "Couldn't send the report";
+    readonly 'player.report.oneTap.intro': "We will pass it to the moderators. You do not need to say why.";
+    readonly 'player.report.oneTap.send': "Report";
+    readonly 'player.report.quote': "“{line}”";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.skip': "Skip and report";
+    readonly 'player.report.needReason': "Choose a reason.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.needReasonOrSkip': "Choose what happened, or skip.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.addReason': "Add a reason";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.addReasonHint': "This helps, but the moderators decide what it really is. You can add this for a few minutes after you report.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.legend': "What was it about?";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.send': "Add to my report";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.need': "Choose a reason or write a note.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.added': "Added. Thanks.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.failed': "We could not add that.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.off': "Adding to a report is not available right now.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.not_found': "We cannot find that report any more.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.not_reporter': "Only the player who sent a report can add to it.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.too_late': "It is too late to add to this report. We still have the report.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.already_added': "You already added to this report.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.detail.refused.reason_unknown': "That reason is not available any more. Your report is still with us.";
+    readonly 'player.report.note': "Note (optional)";
+    readonly 'player.report.addNote': "Add a note";
+    readonly 'player.report.why': "Why? (optional)";
+    readonly 'player.report.whyRequired': "Why?";
+    readonly 'player.report.choose': "Choose a reason (optional)";
+    readonly 'player.report.chooseRequired': "Choose a reason";
+    readonly 'player.report.noteHint': "A moderator will read this. Up to {max} characters. Do not include passwords or personal details.";
+    /** @deprecated unused since 0.1.3; removed in a later minor */
+    readonly 'player.report.send': "Send report";
+    readonly 'player.report.cancel': "Cancel";
+    readonly 'player.report.close': "Close";
+    readonly 'player.report.failed': "Your report was not sent.";
+    readonly 'player.report.thanks': "Thanks. We got your report.";
+    readonly 'player.report.remaining.zero': "You have no more reports left today.";
+    readonly 'player.report.remaining.one': "You can send {count} more report today.";
+    readonly 'player.report.remaining.other': "You can send {count} more reports today.";
+    readonly 'player.report.refused.duplicate': "You already reported this player here. We have your report.";
+    readonly 'player.report.refused.rate': "You have sent as many reports as you can today. You can send more tomorrow.";
+    readonly 'player.report.refused.self': "You cannot report yourself.";
+    readonly 'player.report.refused.not_player': "We cannot find that player any more. They may have left.";
+    readonly 'player.report.refused.off': "Reports are not available right now. Try again later.";
+    readonly 'player.report.refused.suspended': "You cannot send reports from this account for now.";
+    readonly 'player.report.refused.reason_required': "This report needs a reason. Close this and report again to choose one.";
+    readonly 'player.report.refused.reason_unknown': "That reason is not available any more. Close this and report again.";
+    readonly 'player.report.refused.unknown': "We could not take that report.";
+};
+/** A catalog: keys to English (or translated) text. Any object of strings will do. */
+export type PlayerCatalog = Readonly<Record<string, string>>;
+type PluralForm = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+type BaseKey<K extends string> = K extends `${infer B}.${PluralForm}` ? B : K;
+/** Every key a component may ask for: the English catalog's keys with the plural suffix taken off. */
+export type PlayerText = BaseKey<keyof typeof en>;
+export type PlayerParams = Readonly<Record<string, string | number>>;
+/** The `t` the components take: a key and optional values, always a string back. */
+export type PlayerT = (key: PlayerText, params?: PlayerParams) => string;
+/**
+ * Builds the `t` function for a catalog and a locale.
+ * - `{name}` is replaced by `params.name`; a name with no value stays as written; a value is never expanded again.
+ * - Numbers are formatted for the locale (`1,234`).
+ * - With a numeric `count`, the plural form for the locale is used (`key.one`, `key.other`, ...), `key.zero` for 0 if it
+ *   exists, and `key.other` when the locale's form is missing.
+ * - A key with no text comes back as the key itself, so a gap in a translation is visible instead of blank.
+ */
+export declare function createT(catalog: PlayerCatalog, locale?: string): PlayerT;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/i18n.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoEb,+DAA+D;;IAE/D,+DAA+D;;;IAG/D,+DAA+D;;;;;;;;;;IAU/D,+DAA+D;;;IAG/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;IAE/D,+DAA+D;;;;;;;;;IAS/D,+DAA+D;;;;;;;;;;;;;;;;;;CAkBvD,CAAC;AAEX,sFAAsF;AACtF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D,KAAK,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AACpE,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9E,sGAAsG;AACtG,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAErE,oFAAoF;AACpF,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,MAAM,CAAC;AAIzE;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAO,GAAG,OAAO,CAiCtE"}