@seatlayer/core 0.8.0 → 0.10.0

package/dist/index.d.cts

@@ -267,7 +267,32 @@ interface TextObject {
     rotation: number;
     color?: string;
 }
-type ChartObject = RowObject | GAAreaObject | ShapeObject | TableObject | BoothObject | TextObject | SectionObject;
+/**
+ * A raster/vector decor graphic drawn IN the chart, beneath the seats and
+ * sections (ice rink, basketball court, stage art, pitch markings). Purely
+ * visual venue context — never bookable, never hit-tested, so it never steals a
+ * seat click. `href` is a self-contained data URL (image or SVG) produced by the
+ * same client-side downscale used for row photos, so it travels with the doc and
+ * caches as a single bitmap blit (zero per-frame cost). Placed by top-left
+ * (x,y) + size, rotated about its centre — the same handles a shape rect uses.
+ */
+interface DecorImageObject {
+    type: 'decorImage';
+    id: string;
+    /** Image or SVG data URL. */
+    href: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Degrees clockwise about the image centre (default 0). */
+    rotation?: number;
+    /** 0–1 (default 1). Multiplied by any chart-theme dimming at render time. */
+    opacity?: number;
+    /** Optional caption for the designer inspector / accessibility (not drawn). */
+    label?: string;
+}
+type ChartObject = RowObject | GAAreaObject | ShapeObject | TableObject | BoothObject | TextObject | SectionObject | DecorImageObject;
 /**
  * One floor / level of a multi-floor venue (Batch 5). Each floor owns its own
  * geometry, stage focal point, and trace image; categories/zones/tiers stay
@@ -423,8 +448,41 @@ interface ISeatmapRenderer {
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     /** Legend hover-highlight: dim free seats of other categories (null clears). */
     setCategoryHighlight?(key: string | null): void;
+    /** Price-band filter (F4): dim free seats whose category is NOT in `keys`
+     *  (null clears). The widget resolves which categories fall in the band. */
+    setCategoryFilter?(keys: string[] | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Phase 2 event-level section states: mark these section/zone ids `closed` —
+     * flat grey block, seats greyed + not pickable, section stays rendered.
+     * `null`/empty clears. (Distinct from the buyer's applyHidden seat-strip.)
+     */
+    setClosedSections?(ids: string[] | null): void;
+    /**
+     * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
+     * behind this section, and glide the camera to frame it. Seat-picking is gated
+     * until seats are large enough on screen (≥ LABEL_SCALE). Slice 5 / Phase 2 §4.
+     */
+    focusSection?(id: string): void;
+    /** Clear an AXS section focus (restore full-bowl brightness + drop backdrop). */
+    clearSectionFocus?(): void;
+    /** The currently AXS-focused section id, or null. */
+    getFocusedSection?(): string | null;
+    /** World-space rect currently visible in the viewport (minimap viewport frame). */
+    getVisibleWorldRect?(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Axis-aligned world bounds of all seats + section outlines (minimap frame). */
+    getWorldBounds?(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     /**
      * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
      * booked seats render hollow (a non-color cue), so seat state never relies
@@ -579,11 +637,13 @@ declare const UNGROUPED_ID = "__ungrouped__";
  *   'hidden'    — manual: hidden until the organizer reveals it (3.3).
  *   'timed'     — hidden until `revealAt` (epoch ms), then auto-reveals.
  *   'threshold' — auto-reveals once the on-sale inventory is `thresholdPct`% sold.
+ *   'closed'    — visible to buyers but not purchasable (rendered flat grey);
+ *                 unlike 'hidden', the seats stay on the map, just off sale.
  * `labels` are the seat labels the id governs, so a threshold's denominator can
  * exclude still-hidden seats.
  */
 interface AvailabilityRule {
-    mode: 'hidden' | 'timed' | 'threshold';
+    mode: 'hidden' | 'timed' | 'threshold' | 'closed';
     revealAt?: number;
     thresholdPct?: number;
     labels?: string[];
@@ -678,6 +738,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private accessFilter;
     /** Category highlight (legend hover): dims free seats NOT of this category. */
     private categoryHighlight;
+    /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
+    private categoryFilter;
     private sections;
     private zones;
     private seatSection;
@@ -686,6 +748,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private currency;
     /** Section/zone ids to render dimmed (organizer manager: held-back inventory). */
     private dimmedSections;
+    /** Phase 2: section/zone ids in the event-level `closed` state — flat grey
+     *  block, seats greyed + not pickable, but the section stays rendered. */
+    private closedSections;
+    /** AXS section-focus: the currently-focused section id (others dim), or null. */
+    private focusedSectionId;
+    /** Light backdrop panel drawn behind the focused section (removed on clear). */
+    private focusBackdrop;
     /** Object id → floor id (multi-floor only) — resolves a deck tap in the 3D stack. */
     private objectFloor;
     /** Zone id → colour (drives extruded side faces in iso view). */
@@ -769,6 +838,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setAccessibleFilter(on: boolean): void;
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     private sameAccessFilter;
+    /**
+     * Price-band filter (F4): dim free, unselected seats whose category key is NOT
+     * in `keys`. `null` clears the filter (all categories fully visible). The
+     * widget resolves which categories fall inside the buyer's chosen band.
+     */
+    setCategoryFilter(keys: string[] | null): void;
     /**
      * Switch the projection between flat top-down and the isometric "3D" view
      * (rotate + y-squash about the chart centre, plus per-elevation lift). Tweens
@@ -821,6 +896,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /** True when a seat sits in a section/zone currently marked `closed`. */
+    private seatInClosedSection;
     /**
      * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
      * render booked seats hollow. Off restores the exact default rendering.
@@ -832,11 +909,53 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * clears. Unlike the buyer's applyHidden, the sections stay rendered.
      */
     setDimmedSections(ids: string[] | null): void;
+    /**
+     * Phase 2 event-level section states: mark these section/zone ids `closed` —
+     * flat grey block, seats greyed + not pickable, but the section stays rendered
+     * (unlike the buyer's applyHidden which strips it). `null`/empty clears.
+     */
+    setClosedSections(ids: string[] | null): void;
+    /**
+     * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
+     * panel behind this section's seats, and glide the camera in to frame it (the
+     * seat-pick gate below only lets buyers pick once seats are ≥ LABEL_SCALE big).
+     */
+    focusSection(id: string): void;
+    /** Clear an AXS section focus — restore full-bowl brightness + drop the backdrop. */
+    clearSectionFocus(): void;
+    /** The currently AXS-focused section id, or null. */
+    getFocusedSection(): string | null;
+    /** Draw (or replace) the light backdrop panel behind the focused section. */
+    private drawFocusBackdrop;
+    /** Repaint every seat + section block to reflect closed/focus state, then redraw. */
+    private repaintSectionsAndSeats;
+    /** The world-space rectangle currently visible in the viewport (minimap F3). */
+    getVisibleWorldRect(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Axis-aligned world bounds of all seats + section outlines (minimap F3 frame). */
+    getWorldBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
     /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
     private renderBackgroundImage;
+    /**
+     * A decor graphic (rink / court / stage art). The KImage node is added to the
+     * bgLayer synchronously so it keeps its z-slot beneath the sections drawn right
+     * after; the bitmap is decoded async and pasted in on load. A single node = a
+     * single drawImage per frame, and it rides the same layer cache — effectively
+     * zero per-frame cost. Never listens, so it can't intercept a seat click.
+     */
+    private renderDecorImage;
     private renderTable;
     private renderText;
     private renderShape;
@@ -854,6 +973,14 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSection;
     /** Recompute a section's availability-tinted fill + "N LEFT" (cheap; on status change). */
     private refreshSectionFill;
+    /** True when a section/zone is currently in the `closed` event-state. */
+    private isSectionClosed;
+    /**
+     * The block-fill colour for a section: flat desaturated grey when `closed`,
+     * else the availability-darkened category mix; then desaturated toward neutral
+     * when another section holds focus (AXS dim treatment).
+     */
+    private sectionBlockFill;
     /**
      * Zone rung: one giant screen-constant label per zone (+ optional "FROM $n"),
      * shown at the farthest zoom in place of per-section detail. Skipped entirely
@@ -870,6 +997,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * Section/zone labels are scale-compensated to hold a roughly constant screen size.
      */
     private applySectionLod;
+    /**
+     * Greedy label de-collision for the zone/section rungs (same approach as the
+     * designer's cullRowLabels): price/"N LEFT" sublabels are lowest priority and
+     * drop first; name labels keep top-to-bottom, left-to-right; anything whose
+     * on-screen box (+4px gap) overlaps an already-kept box hides. Recomputed on
+     * every LOD pass so hidden labels reappear as zoom spreads them apart.
+     * Culling multiplies the opacity applySectionLod just assigned (never raises).
+     */
+    private decollideRungLabels;
     /** Set a centred label's world fontSize (for a target screen px) and re-anchor it. */
     private sizeLabel;
     /**
@@ -1056,12 +1192,19 @@ interface PickerTransport {
     objects(key: string): Promise<{
         seats: Record<string, string>;
         hidden?: string[];
+        closed?: string[];
     }>;
     hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
     book?(key: string, labels: string[], holdId: string, bookingRef: string): Promise<unknown>;
+    /** Optional (P4) — push an active hold's expiry out ("need more time?"). */
+    extend?(key: string, holdId: string, ttlMs?: number): Promise<{
+        holdId: string;
+        expiresAt: number;
+        extends?: number;
+    }>;
     socketUrl(key: string): string;
 }
 interface PickerCallbacks extends RendererCallbacks {
@@ -1121,6 +1264,9 @@ declare class PickerController {
     private _doc;
     /** Section/zone ids hidden from buyers this event (3.3) — seats vanish, not grey. */
     private hidden;
+    /** Section/zone ids in the `closed` event-state (Phase 2) — seats stay, greyed
+     *  + not pickable. Kept separate from `hidden` (which strips them). */
+    private closedSections;
     /** label ⇄ id maps — backend speaks labels, the engine speaks ids. */
     private labelToId;
     private labelToSeat;
@@ -1143,6 +1289,11 @@ declare class PickerController {
     private visibleDoc;
     /** Adopt a new hidden set; rebuild the visible chart only if it differs. */
     private syncHidden;
+    /** Adopt a new closed-section set; restyle (grey + non-pickable) if it differs.
+     *  Cheap restyle — no chart rebuild — so mid-sale open/close repaints live. */
+    private syncClosed;
+    /** Whether a section is currently in the `closed` state (card must not open). */
+    isSectionClosed(id: string): boolean;
     currentHold(): HoldInfo | null;
     getRenderer(): ISeatmapRenderer | null;
     seatByLabel(label: string): ExpandedSeat | undefined;
@@ -1168,12 +1319,23 @@ declare class PickerController {
      * there's nothing to hold.
      */
     hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /**
+     * P4 "need more time?": extend the OPEN hold's server-side expiry and re-arm
+     * the client expiry timer to match (via setHold), so the controller doesn't
+     * fire a false expiry and start polling. Returns the new hold, or null if
+     * there's no open hold or the transport can't extend / the server refused
+     * (hold gone, expired, or at its renewal cap). Never throws for the refusal
+     * case — the caller decides the copy.
+     */
+    extendHold(ttlMs?: number): Promise<HoldInfo | null>;
     /** Public GA inventory derived from the live synthetic-unit status stream. */
     /**
      * Live seats-left per category key (status 'free' right now). Recompute on
      * onStatusChange — this is what a price panel's "N left" counters read.
      */
     categoryAvailability(): Record<string, number>;
+    /** Seat ids belonging to a currently-closed section (excluded from counts). */
+    private closedMemberIds;
     getGAAreas(): {
         id: string;
         label: string;
@@ -1242,11 +1404,31 @@ declare class PickerController {
     getRung(): LodRung;
     /** Jump to a rung; ZONES clears any focused summary (back to overview). */
     setRung(rung: LodRung): void;
+    /** Price-band filter (F4): dim free seats whose category is outside `keys`
+     *  (null clears). The widget resolves which categories fall in the band. */
+    setCategoryFilter(keys: string[] | null): void;
+    /** World-space rect currently visible + full chart bounds (F3 minimap frame). */
+    getViewport(): {
+        visible: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    } | null;
     /** Glide in on a section and surface its summary (same path as a section tap). */
     focusSection(id: string): void;
-    /** Zoom back out to the whole chart and clear the section-summary card. */
+    /** Zoom back out to the whole chart and clear the section-summary card + focus. */
     overview(): void;
-    /** Glide the camera into a tapped section and emit its computed summary. */
+    /** Glide the camera into a tapped section and emit its computed summary. Uses
+     *  the AXS focus treatment (dim + backdrop) when the engine supports it; a
+     *  closed section is framed but never opens a buyer card. */
     private handleSectionTap;
     /**
      * Build a section summary from the renderer's spatial membership: section +
@@ -1387,4 +1569,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };

package/dist/index.d.ts

@@ -267,7 +267,32 @@ interface TextObject {
     rotation: number;
     color?: string;
 }
-type ChartObject = RowObject | GAAreaObject | ShapeObject | TableObject | BoothObject | TextObject | SectionObject;
+/**
+ * A raster/vector decor graphic drawn IN the chart, beneath the seats and
+ * sections (ice rink, basketball court, stage art, pitch markings). Purely
+ * visual venue context — never bookable, never hit-tested, so it never steals a
+ * seat click. `href` is a self-contained data URL (image or SVG) produced by the
+ * same client-side downscale used for row photos, so it travels with the doc and
+ * caches as a single bitmap blit (zero per-frame cost). Placed by top-left
+ * (x,y) + size, rotated about its centre — the same handles a shape rect uses.
+ */
+interface DecorImageObject {
+    type: 'decorImage';
+    id: string;
+    /** Image or SVG data URL. */
+    href: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Degrees clockwise about the image centre (default 0). */
+    rotation?: number;
+    /** 0–1 (default 1). Multiplied by any chart-theme dimming at render time. */
+    opacity?: number;
+    /** Optional caption for the designer inspector / accessibility (not drawn). */
+    label?: string;
+}
+type ChartObject = RowObject | GAAreaObject | ShapeObject | TableObject | BoothObject | TextObject | SectionObject | DecorImageObject;
 /**
  * One floor / level of a multi-floor venue (Batch 5). Each floor owns its own
  * geometry, stage focal point, and trace image; categories/zones/tiers stay
@@ -423,8 +448,41 @@ interface ISeatmapRenderer {
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     /** Legend hover-highlight: dim free seats of other categories (null clears). */
     setCategoryHighlight?(key: string | null): void;
+    /** Price-band filter (F4): dim free seats whose category is NOT in `keys`
+     *  (null clears). The widget resolves which categories fall in the band. */
+    setCategoryFilter?(keys: string[] | null): void;
     /** Dim the seats of these section/zone ids (organizer manager: held-back inventory). */
     setDimmedSections?(ids: string[] | null): void;
+    /**
+     * Phase 2 event-level section states: mark these section/zone ids `closed` —
+     * flat grey block, seats greyed + not pickable, section stays rendered.
+     * `null`/empty clears. (Distinct from the buyer's applyHidden seat-strip.)
+     */
+    setClosedSections?(ids: string[] | null): void;
+    /**
+     * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
+     * behind this section, and glide the camera to frame it. Seat-picking is gated
+     * until seats are large enough on screen (≥ LABEL_SCALE). Slice 5 / Phase 2 §4.
+     */
+    focusSection?(id: string): void;
+    /** Clear an AXS section focus (restore full-bowl brightness + drop backdrop). */
+    clearSectionFocus?(): void;
+    /** The currently AXS-focused section id, or null. */
+    getFocusedSection?(): string | null;
+    /** World-space rect currently visible in the viewport (minimap viewport frame). */
+    getVisibleWorldRect?(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Axis-aligned world bounds of all seats + section outlines (minimap frame). */
+    getWorldBounds?(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     /**
      * Colorblind-safe mode: category hues switch to an Okabe-Ito palette and
      * booked seats render hollow (a non-color cue), so seat state never relies
@@ -579,11 +637,13 @@ declare const UNGROUPED_ID = "__ungrouped__";
  *   'hidden'    — manual: hidden until the organizer reveals it (3.3).
  *   'timed'     — hidden until `revealAt` (epoch ms), then auto-reveals.
  *   'threshold' — auto-reveals once the on-sale inventory is `thresholdPct`% sold.
+ *   'closed'    — visible to buyers but not purchasable (rendered flat grey);
+ *                 unlike 'hidden', the seats stay on the map, just off sale.
  * `labels` are the seat labels the id governs, so a threshold's denominator can
  * exclude still-hidden seats.
  */
 interface AvailabilityRule {
-    mode: 'hidden' | 'timed' | 'threshold';
+    mode: 'hidden' | 'timed' | 'threshold' | 'closed';
     revealAt?: number;
     thresholdPct?: number;
     labels?: string[];
@@ -678,6 +738,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private accessFilter;
     /** Category highlight (legend hover): dims free seats NOT of this category. */
     private categoryHighlight;
+    /** Price-band filter (F4): dim free seats whose category is NOT in this set. */
+    private categoryFilter;
     private sections;
     private zones;
     private seatSection;
@@ -686,6 +748,13 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private currency;
     /** Section/zone ids to render dimmed (organizer manager: held-back inventory). */
     private dimmedSections;
+    /** Phase 2: section/zone ids in the event-level `closed` state — flat grey
+     *  block, seats greyed + not pickable, but the section stays rendered. */
+    private closedSections;
+    /** AXS section-focus: the currently-focused section id (others dim), or null. */
+    private focusedSectionId;
+    /** Light backdrop panel drawn behind the focused section (removed on clear). */
+    private focusBackdrop;
     /** Object id → floor id (multi-floor only) — resolves a deck tap in the 3D stack. */
     private objectFloor;
     /** Zone id → colour (drives extruded side faces in iso view). */
@@ -769,6 +838,12 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     setAccessibleFilter(on: boolean): void;
     setAccessibilityFilter(types: AccessibilityType[] | null): void;
     private sameAccessFilter;
+    /**
+     * Price-band filter (F4): dim free, unselected seats whose category key is NOT
+     * in `keys`. `null` clears the filter (all categories fully visible). The
+     * widget resolves which categories fall inside the buyer's chosen band.
+     */
+    setCategoryFilter(keys: string[] | null): void;
     /**
      * Switch the projection between flat top-down and the isometric "3D" view
      * (rotate + y-squash about the chart centre, plus per-elevation lift). Tweens
@@ -821,6 +896,8 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private seatBaseColor;
     /** Apply fill/stroke/opacity for a seat's current status + selection. */
     private paintSeat;
+    /** True when a seat sits in a section/zone currently marked `closed`. */
+    private seatInClosedSection;
     /**
      * Colorblind-safe mode: swap category hues for the Okabe-Ito palette and
      * render booked seats hollow. Off restores the exact default rendering.
@@ -832,11 +909,53 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * clears. Unlike the buyer's applyHidden, the sections stay rendered.
      */
     setDimmedSections(ids: string[] | null): void;
+    /**
+     * Phase 2 event-level section states: mark these section/zone ids `closed` —
+     * flat grey block, seats greyed + not pickable, but the section stays rendered
+     * (unlike the buyer's applyHidden which strips it). `null`/empty clears.
+     */
+    setClosedSections(ids: string[] | null): void;
+    /**
+     * AXS section-focus: dim + desaturate every other section, draw a calm backdrop
+     * panel behind this section's seats, and glide the camera in to frame it (the
+     * seat-pick gate below only lets buyers pick once seats are ≥ LABEL_SCALE big).
+     */
+    focusSection(id: string): void;
+    /** Clear an AXS section focus — restore full-bowl brightness + drop the backdrop. */
+    clearSectionFocus(): void;
+    /** The currently AXS-focused section id, or null. */
+    getFocusedSection(): string | null;
+    /** Draw (or replace) the light backdrop panel behind the focused section. */
+    private drawFocusBackdrop;
+    /** Repaint every seat + section block to reflect closed/focus state, then redraw. */
+    private repaintSectionsAndSeats;
+    /** The world-space rectangle currently visible in the viewport (minimap F3). */
+    getVisibleWorldRect(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Axis-aligned world bounds of all seats + section outlines (minimap F3 frame). */
+    getWorldBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
     /** Legend hover: highlight one category (dim the rest), or null to clear. */
     setCategoryHighlight(key: string | null): void;
     private renderBackground;
     /** Organizer floor-plan photo, dimmed, at the very bottom of the bg layer. */
     private renderBackgroundImage;
+    /**
+     * A decor graphic (rink / court / stage art). The KImage node is added to the
+     * bgLayer synchronously so it keeps its z-slot beneath the sections drawn right
+     * after; the bitmap is decoded async and pasted in on load. A single node = a
+     * single drawImage per frame, and it rides the same layer cache — effectively
+     * zero per-frame cost. Never listens, so it can't intercept a seat click.
+     */
+    private renderDecorImage;
     private renderTable;
     private renderText;
     private renderShape;
@@ -854,6 +973,14 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
     private renderSection;
     /** Recompute a section's availability-tinted fill + "N LEFT" (cheap; on status change). */
     private refreshSectionFill;
+    /** True when a section/zone is currently in the `closed` event-state. */
+    private isSectionClosed;
+    /**
+     * The block-fill colour for a section: flat desaturated grey when `closed`,
+     * else the availability-darkened category mix; then desaturated toward neutral
+     * when another section holds focus (AXS dim treatment).
+     */
+    private sectionBlockFill;
     /**
      * Zone rung: one giant screen-constant label per zone (+ optional "FROM $n"),
      * shown at the farthest zoom in place of per-section detail. Skipped entirely
@@ -870,6 +997,15 @@ declare class SeatmapRenderer implements ISeatmapRenderer {
      * Section/zone labels are scale-compensated to hold a roughly constant screen size.
      */
     private applySectionLod;
+    /**
+     * Greedy label de-collision for the zone/section rungs (same approach as the
+     * designer's cullRowLabels): price/"N LEFT" sublabels are lowest priority and
+     * drop first; name labels keep top-to-bottom, left-to-right; anything whose
+     * on-screen box (+4px gap) overlaps an already-kept box hides. Recomputed on
+     * every LOD pass so hidden labels reappear as zoom spreads them apart.
+     * Culling multiplies the opacity applySectionLod just assigned (never raises).
+     */
+    private decollideRungLabels;
     /** Set a centred label's world fontSize (for a target screen px) and re-anchor it. */
     private sizeLabel;
     /**
@@ -1056,12 +1192,19 @@ interface PickerTransport {
     objects(key: string): Promise<{
         seats: Record<string, string>;
         hidden?: string[];
+        closed?: string[];
     }>;
     hold(key: string, selections: HoldSelectionRequest[], ttlMs?: number, replaceHoldId?: string): Promise<HoldResponse>;
     bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResponse>;
     release(key: string, labels: string[], holdId: string): Promise<unknown>;
     /** Optional — the SDK omits booking (it hands the holdId to the host page). */
     book?(key: string, labels: string[], holdId: string, bookingRef: string): Promise<unknown>;
+    /** Optional (P4) — push an active hold's expiry out ("need more time?"). */
+    extend?(key: string, holdId: string, ttlMs?: number): Promise<{
+        holdId: string;
+        expiresAt: number;
+        extends?: number;
+    }>;
     socketUrl(key: string): string;
 }
 interface PickerCallbacks extends RendererCallbacks {
@@ -1121,6 +1264,9 @@ declare class PickerController {
     private _doc;
     /** Section/zone ids hidden from buyers this event (3.3) — seats vanish, not grey. */
     private hidden;
+    /** Section/zone ids in the `closed` event-state (Phase 2) — seats stay, greyed
+     *  + not pickable. Kept separate from `hidden` (which strips them). */
+    private closedSections;
     /** label ⇄ id maps — backend speaks labels, the engine speaks ids. */
     private labelToId;
     private labelToSeat;
@@ -1143,6 +1289,11 @@ declare class PickerController {
     private visibleDoc;
     /** Adopt a new hidden set; rebuild the visible chart only if it differs. */
     private syncHidden;
+    /** Adopt a new closed-section set; restyle (grey + non-pickable) if it differs.
+     *  Cheap restyle — no chart rebuild — so mid-sale open/close repaints live. */
+    private syncClosed;
+    /** Whether a section is currently in the `closed` state (card must not open). */
+    isSectionClosed(id: string): boolean;
     currentHold(): HoldInfo | null;
     getRenderer(): ISeatmapRenderer | null;
     seatByLabel(label: string): ExpandedSeat | undefined;
@@ -1168,12 +1319,23 @@ declare class PickerController {
      * there's nothing to hold.
      */
     hold(labelsArg?: string[], ttlMs?: number): Promise<HoldInfo | null>;
+    /**
+     * P4 "need more time?": extend the OPEN hold's server-side expiry and re-arm
+     * the client expiry timer to match (via setHold), so the controller doesn't
+     * fire a false expiry and start polling. Returns the new hold, or null if
+     * there's no open hold or the transport can't extend / the server refused
+     * (hold gone, expired, or at its renewal cap). Never throws for the refusal
+     * case — the caller decides the copy.
+     */
+    extendHold(ttlMs?: number): Promise<HoldInfo | null>;
     /** Public GA inventory derived from the live synthetic-unit status stream. */
     /**
      * Live seats-left per category key (status 'free' right now). Recompute on
      * onStatusChange — this is what a price panel's "N left" counters read.
      */
     categoryAvailability(): Record<string, number>;
+    /** Seat ids belonging to a currently-closed section (excluded from counts). */
+    private closedMemberIds;
     getGAAreas(): {
         id: string;
         label: string;
@@ -1242,11 +1404,31 @@ declare class PickerController {
     getRung(): LodRung;
     /** Jump to a rung; ZONES clears any focused summary (back to overview). */
     setRung(rung: LodRung): void;
+    /** Price-band filter (F4): dim free seats whose category is outside `keys`
+     *  (null clears). The widget resolves which categories fall in the band. */
+    setCategoryFilter(keys: string[] | null): void;
+    /** World-space rect currently visible + full chart bounds (F3 minimap frame). */
+    getViewport(): {
+        visible: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    } | null;
     /** Glide in on a section and surface its summary (same path as a section tap). */
     focusSection(id: string): void;
-    /** Zoom back out to the whole chart and clear the section-summary card. */
+    /** Zoom back out to the whole chart and clear the section-summary card + focus. */
     overview(): void;
-    /** Glide the camera into a tapped section and emit its computed summary. */
+    /** Glide the camera into a tapped section and emit its computed summary. Uses
+     *  the AXS focus treatment (dim + backdrop) when the engine supports it; a
+     *  closed section is framed but never opens a buyer card. */
     private handleSectionTap;
     /**
      * Build a section summary from the renderer's spatial membership: section +
@@ -1387,4 +1569,4 @@ declare function formatMoney(amount: number, currency?: string, fractionDigits?:
 /** Bare symbol for input adornments ("€", "$", "₹"). */
 declare function currencySymbol(currency?: string): string;
 
-export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };
+export { ACCESSIBILITY_TYPES, type AccessibilityMeta, type AccessibilityType, type AvailabilityRule, type BoothObject, CHART_STORAGE_KEY, type Category, type CategoryTier, type ChartDoc, type ChartObject, type ChartTheme, DEFAULT_CURRENCY, type DecorImageObject, type Dict, type ExpandedSeat, type Floor, type GAAreaObject, type HoldConflict, type HoldInfo, type HoldSelectionRequest, type HoldServerItem, type ISeatmapRenderer, type Locale, type LodRung, MAX_EVENT_INVENTORY, MAX_GA_CAPACITY, type PanoramaResult, type PickerCallbacks, PickerController, type PickerOptions, type PickerSeat, type PickerTransport, type Point, type RendererCallbacks, type RendererOptions, type RowObject, type RowSeatSlot, SUPPORTED_LOCALES, type SeatHoverDetails, type SeatOverride, type SeatStatus, SeatmapRenderer, type SectionCategory, type SectionNode, type SectionObject, type SectionSummary, type SelectionLayer, type ShapeObject, type TableObject, type TextObject, UNGROUPED_ID, type ZoneDef, accessibilityMeta, allObjects, applyHidden, chartBounds, computeSections, createRenderer, currencySymbol, expandBooth, expandChart, expandRow, expandRowSlots, expandTable, floorObjects, floorsOf, formatDate, formatMoney, gaAreasOf, gaUnitLabel, gaUnitLabels, generateSeatPanorama, generateSeatThumb, getLocale, hiddenObjectIds, isGaUnitLabel, isSectionHidden, layerOf, loadLocale, objectCenter, pointInPolygon, resolveLocale, setLocale, setMoneyLocale, setStringOverrides, stackFloors, t, tCount };