@seatlayer/js 0.60.0 → 0.61.0

package/dist/index.d.cts

@@ -660,6 +660,16 @@ interface SeatingChartOptions {
      * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.
      */
     messages?: Record<string, string>;
+    /**
+     * Show an in-chart language switcher offering exactly these languages.
+     *
+     * Opt-in and curated on purpose: the chart sits inside someone else's page,
+     * a multilingual host already has its own switcher, and two that can
+     * disagree is worse than either alone. A curated list also beats all 37 — a
+     * German venue wants de/en/pl in the menu, not Welsh. Fewer than two
+     * resolvable entries renders nothing.
+     */
+    languages?: string[];
     /** ISO 4217 currency for on-map prices (default USD). */
     currency?: string;
     /**
@@ -761,6 +771,8 @@ declare class SeatingChart {
     readonly publicKey?: string;
     private mount;
     private hostEl;
+    /** The organizer's language for this event, learned when the chart resolves. */
+    private eventLocale;
     private rendered;
     private mode_;
     private tipEl;
@@ -794,6 +806,32 @@ declare class SeatingChart {
      * wrapper, which must be able to tell an integrator that the build they are
      * about to ship is pointed at a test event.
      */
+    /**
+     * The opt-in language switcher, offering exactly the languages the host
+     * named. Absent unless `languages` lists at least two — a menu with one
+     * entry is furniture, and an unrequested one duplicates the switcher a
+     * multilingual host site already has.
+     *
+     * Each language names itself (`LOCALE_NAMES`): a reader scanning for their
+     * own language finds "Deutsch", never "German". An English list is
+     * unreadable to exactly the people who need it.
+     */
+    private buildLanguageSwitcher;
+    /**
+     * Change the language of a LIVE chart, keeping the buyer's selection.
+     *
+     * `locale` is otherwise read once at render, which is fine for a page that
+     * knows its language up front and useless for one with a language switcher.
+     * The competing embed API can only `rerender()`, and that clears the
+     * selection — losing someone's seats because they changed language is not an
+     * acceptable trade, so this rebuilds the map through `refreshMapCopy()`,
+     * which restores the selection on the far side.
+     *
+     * Returns the locale that actually became active: an unsupported or
+     * not-yet-translated tag resolves to English rather than throwing, exactly as
+     * it does at first render.
+     */
+    setLocale(next: string | null | undefined): Promise<string>;
     getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
@@ -1604,6 +1642,18 @@ interface SeatPickerOptions {
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
     messages?: Record<string, string>;
+    /**
+     * Show an in-picker language switcher offering exactly these languages.
+     *
+     * Opt-in and curated on purpose. Omit it and there is no control: the widget
+     * sits inside someone else's page, and a multilingual host site already has
+     * its own switcher — two that can disagree is worse than either alone. A
+     * curated list also beats offering all 37: a German venue wants de/en/pl in
+     * the menu, not Welsh.
+     *
+     * Switching keeps the buyer's selection; it does not re-render the chart.
+     */
+    languages?: string[];
     /** ISO 4217 currency fallback (the org/event currency on the chart wins). */
     currency?: string;
     /** Colorblind-safe rendering (Okabe-Ito palette, hollow booked seats). */
@@ -2058,6 +2108,8 @@ declare class SeatPicker implements GaPromptPicker {
     private secCardShownAt;
     /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
     private lastTrayCount;
+    /** The opt-in language switcher, when `languages` named at least two. */
+    private langSel;
     /** Previous computed total — drives a single explanatory value bump. */
     private lastTrayTotal;
     /** Stable item keys prevent tray chips re-animating on unrelated realtime syncs. */
@@ -2068,6 +2120,8 @@ declare class SeatPicker implements GaPromptPicker {
     private holdingLabels;
     private ctaPhase;
     private a11yChipsEl;
+    /** Rail scroll listener attached once; the rail repaints many times. */
+    private railEdgesBound;
     private fsFallback;
     private fsChangeHandler;
     private fsEscHandler;
@@ -2526,6 +2580,12 @@ declare class SeatPicker implements GaPromptPicker {
      * colours have not changed; safe to call on every render.
      */
     setMapTheme(map: PickerMapTheme | null): void;
+    /**
+     * Chrome docked on the map follows the MAP's ground, not the picker's — see
+     * resolveMapChromeTokens. The map ground resolves the way the renderer does:
+     * host map override → chart theme → the picker's own background.
+     */
+    private applyMapChromeTokens;
     /**
      * Let a host suppress duplicate event identity after mount without remounting
      * the live picker (and therefore without disturbing a selection or hold).
@@ -2553,6 +2613,49 @@ declare class SeatPicker implements GaPromptPicker {
      * A no-op when the map is unchanged, so a host may call it on every poll.
      */
     setPricing(pricing: SeatPickerPricing | undefined): void;
+    /**
+     * The opt-in language switcher.
+     *
+     * Rendered only when `languages` resolves to at least two distinct locales.
+     * Curated rather than all 37 on purpose — a German venue wants de/en/pl in
+     * the menu, not Welsh — and absent by default, because a multilingual host
+     * site already has its own switcher and two that can disagree is worse than
+     * either alone.
+     *
+     * Each language names itself: a reader scanning for their own finds
+     * "Deutsch", never "German". An English list is unreadable to exactly the
+     * people who need it.
+     */
+    private buildLanguageSwitcher;
+    /**
+     * Change the language of a mounted picker, keeping the buyer's seats.
+     *
+     * `locale` is otherwise read once, before the chrome is built. That is fine
+     * for a page that knows its language up front and useless for one with a
+     * language switcher — and the competing embed API's only answer, `rerender()`,
+     * clears the selection. Losing someone's held seats because they changed
+     * language is not a trade worth making, so nothing here is destroyed and
+     * rebuilt: the copy is re-applied in place.
+     *
+     * Three passes, because the picker's ~195 `tf()` sites fall into three kinds:
+     *
+     * 1. The skeleton's static labels and aria — set once inside one `innerHTML`
+     *    template. Re-applied from the `data-sl-*` markers on those nodes.
+     * 2. The painters (tray, prices, CTA, offer, rails, rungs, floors) — these
+     *    already rebuild their HTML from `tf()` whenever state moves, so calling
+     *    them again is all it takes.
+     * 3. Everything transient — toasts, dialogs, screen-reader announcements,
+     *    tooltips. Those read `tf()` at the moment they fire, so they are already
+     *    correct the next time they run and must NOT be forced now.
+     *
+     * The map is last and goes through the controller, because its labels are
+     * baked into Konva `Text` at build time — a repaint would faithfully redraw
+     * the old language.
+     *
+     * Returns the locale that actually became active; an unsupported or
+     * untranslated tag resolves to English rather than throwing.
+     */
+    setLocale(next: string | null | undefined): Promise<string>;
     /** Current colorblind-safe render state, resolved from the stored buyer
      *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
      *  surface the state rather than rendering colorblind colors silently. */

package/dist/index.d.ts

@@ -660,6 +660,16 @@ interface SeatingChartOptions {
      * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.
      */
     messages?: Record<string, string>;
+    /**
+     * Show an in-chart language switcher offering exactly these languages.
+     *
+     * Opt-in and curated on purpose: the chart sits inside someone else's page,
+     * a multilingual host already has its own switcher, and two that can
+     * disagree is worse than either alone. A curated list also beats all 37 — a
+     * German venue wants de/en/pl in the menu, not Welsh. Fewer than two
+     * resolvable entries renders nothing.
+     */
+    languages?: string[];
     /** ISO 4217 currency for on-map prices (default USD). */
     currency?: string;
     /**
@@ -761,6 +771,8 @@ declare class SeatingChart {
     readonly publicKey?: string;
     private mount;
     private hostEl;
+    /** The organizer's language for this event, learned when the chart resolves. */
+    private eventLocale;
     private rendered;
     private mode_;
     private tipEl;
@@ -794,6 +806,32 @@ declare class SeatingChart {
      * wrapper, which must be able to tell an integrator that the build they are
      * about to ship is pointed at a test event.
      */
+    /**
+     * The opt-in language switcher, offering exactly the languages the host
+     * named. Absent unless `languages` lists at least two — a menu with one
+     * entry is furniture, and an unrequested one duplicates the switcher a
+     * multilingual host site already has.
+     *
+     * Each language names itself (`LOCALE_NAMES`): a reader scanning for their
+     * own language finds "Deutsch", never "German". An English list is
+     * unreadable to exactly the people who need it.
+     */
+    private buildLanguageSwitcher;
+    /**
+     * Change the language of a LIVE chart, keeping the buyer's selection.
+     *
+     * `locale` is otherwise read once at render, which is fine for a page that
+     * knows its language up front and useless for one with a language switcher.
+     * The competing embed API can only `rerender()`, and that clears the
+     * selection — losing someone's seats because they changed language is not an
+     * acceptable trade, so this rebuilds the map through `refreshMapCopy()`,
+     * which restores the selection on the far side.
+     *
+     * Returns the locale that actually became active: an unsupported or
+     * not-yet-translated tag resolves to English rather than throwing, exactly as
+     * it does at first render.
+     */
+    setLocale(next: string | null | undefined): Promise<string>;
     getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
@@ -1604,6 +1642,18 @@ interface SeatPickerOptions {
     locale?: string;
     /** Per-key string overrides layered over the active locale. */
     messages?: Record<string, string>;
+    /**
+     * Show an in-picker language switcher offering exactly these languages.
+     *
+     * Opt-in and curated on purpose. Omit it and there is no control: the widget
+     * sits inside someone else's page, and a multilingual host site already has
+     * its own switcher — two that can disagree is worse than either alone. A
+     * curated list also beats offering all 37: a German venue wants de/en/pl in
+     * the menu, not Welsh.
+     *
+     * Switching keeps the buyer's selection; it does not re-render the chart.
+     */
+    languages?: string[];
     /** ISO 4217 currency fallback (the org/event currency on the chart wins). */
     currency?: string;
     /** Colorblind-safe rendering (Okabe-Ito palette, hollow booked seats). */
@@ -2058,6 +2108,8 @@ declare class SeatPicker implements GaPromptPicker {
     private secCardShownAt;
     /** Previous tray ticket count — first 0→n transition auto-expands the mobile sheet. */
     private lastTrayCount;
+    /** The opt-in language switcher, when `languages` named at least two. */
+    private langSel;
     /** Previous computed total — drives a single explanatory value bump. */
     private lastTrayTotal;
     /** Stable item keys prevent tray chips re-animating on unrelated realtime syncs. */
@@ -2068,6 +2120,8 @@ declare class SeatPicker implements GaPromptPicker {
     private holdingLabels;
     private ctaPhase;
     private a11yChipsEl;
+    /** Rail scroll listener attached once; the rail repaints many times. */
+    private railEdgesBound;
     private fsFallback;
     private fsChangeHandler;
     private fsEscHandler;
@@ -2526,6 +2580,12 @@ declare class SeatPicker implements GaPromptPicker {
      * colours have not changed; safe to call on every render.
      */
     setMapTheme(map: PickerMapTheme | null): void;
+    /**
+     * Chrome docked on the map follows the MAP's ground, not the picker's — see
+     * resolveMapChromeTokens. The map ground resolves the way the renderer does:
+     * host map override → chart theme → the picker's own background.
+     */
+    private applyMapChromeTokens;
     /**
      * Let a host suppress duplicate event identity after mount without remounting
      * the live picker (and therefore without disturbing a selection or hold).
@@ -2553,6 +2613,49 @@ declare class SeatPicker implements GaPromptPicker {
      * A no-op when the map is unchanged, so a host may call it on every poll.
      */
     setPricing(pricing: SeatPickerPricing | undefined): void;
+    /**
+     * The opt-in language switcher.
+     *
+     * Rendered only when `languages` resolves to at least two distinct locales.
+     * Curated rather than all 37 on purpose — a German venue wants de/en/pl in
+     * the menu, not Welsh — and absent by default, because a multilingual host
+     * site already has its own switcher and two that can disagree is worse than
+     * either alone.
+     *
+     * Each language names itself: a reader scanning for their own finds
+     * "Deutsch", never "German". An English list is unreadable to exactly the
+     * people who need it.
+     */
+    private buildLanguageSwitcher;
+    /**
+     * Change the language of a mounted picker, keeping the buyer's seats.
+     *
+     * `locale` is otherwise read once, before the chrome is built. That is fine
+     * for a page that knows its language up front and useless for one with a
+     * language switcher — and the competing embed API's only answer, `rerender()`,
+     * clears the selection. Losing someone's held seats because they changed
+     * language is not a trade worth making, so nothing here is destroyed and
+     * rebuilt: the copy is re-applied in place.
+     *
+     * Three passes, because the picker's ~195 `tf()` sites fall into three kinds:
+     *
+     * 1. The skeleton's static labels and aria — set once inside one `innerHTML`
+     *    template. Re-applied from the `data-sl-*` markers on those nodes.
+     * 2. The painters (tray, prices, CTA, offer, rails, rungs, floors) — these
+     *    already rebuild their HTML from `tf()` whenever state moves, so calling
+     *    them again is all it takes.
+     * 3. Everything transient — toasts, dialogs, screen-reader announcements,
+     *    tooltips. Those read `tf()` at the moment they fire, so they are already
+     *    correct the next time they run and must NOT be forced now.
+     *
+     * The map is last and goes through the controller, because its labels are
+     * baked into Konva `Text` at build time — a repaint would faithfully redraw
+     * the old language.
+     *
+     * Returns the locale that actually became active; an unsupported or
+     * untranslated tag resolves to English rather than throwing.
+     */
+    setLocale(next: string | null | undefined): Promise<string>;
     /** Current colorblind-safe render state, resolved from the stored buyer
      *  preference at mount. Host chrome (e.g. the Designer preview) reads this to
      *  surface the state rather than rendering colorblind colors silently. */