@seatlayer/core 0.51.0 → 0.53.0

package/dist/picker/minimapGeometry.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var x=(n,i)=>{for(var t in i)c(n,t,{get:i[t],enumerable:!0})},l=(n,i,t,o)=>{if(i&&typeof i=="object"||typeof i=="function")for(let e of f(i))!M.call(n,e)&&e!==t&&c(n,e,{get:()=>i[e],enumerable:!(o=b(i,e))||o.enumerable});return n};var y=n=>l(c({},"__esModule",{value:!0}),n);var R={};x(R,{createMinimapTransform:()=>g,minimapPointToWorld:()=>w,minimapViewportPlan:()=>d,worldRectToMinimap:()=>u});module.exports=y(R);function g(n,i,t,o,e=6){let a=e*o,m=Math.min((i-a*2)/Math.max(1,n.width),(t-a*2)/Math.max(1,n.height));return{scale:m,offX:(i-n.width*m)/2-n.x*m,offY:(t-n.height*m)/2-n.y*m,dpr:o}}function u(n,i){return{x:n.x*i.scale+i.offX,y:n.y*i.scale+i.offY,width:n.width*i.scale,height:n.height*i.scale}}function d(n,i,t,o,e=2){let a=u(n,i),m=Math.max(e,a.x),p=Math.max(e,a.y),h=Math.min(t-e,a.x+a.width),r=Math.min(o-e,a.y+a.height);return{raw:a,clipped:h>m&&r>p?{x:m,y:p,width:h-m,height:r-p}:null,clippedEdges:{left:a.x<e,top:a.y<e,right:a.x+a.width>t-e,bottom:a.y+a.height>o-e}}}function w(n,i){return{x:(n.x-i.offX)/i.scale,y:(n.y-i.offY)/i.scale}}0&&(module.exports={createMinimapTransform,minimapPointToWorld,minimapViewportPlan,worldRectToMinimap});

package/dist/picker/minimapGeometry.d.cts

@@ -0,0 +1,37 @@
+/** Geometry helpers shared by the buyer minimap renderer and its focused tests. */
+interface MinimapRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface MinimapTransform {
+    scale: number;
+    offX: number;
+    offY: number;
+    dpr: number;
+}
+interface MinimapViewportPlan {
+    /** The camera rectangle under the unchanged full-world transform. */
+    raw: MinimapRect;
+    /** The visible portion of `raw`; drawing it never loses every edge off-canvas. */
+    clipped: MinimapRect | null;
+    clippedEdges: {
+        left: boolean;
+        top: boolean;
+        right: boolean;
+        bottom: boolean;
+    };
+}
+declare function createMinimapTransform(world: MinimapRect, pixelWidth: number, pixelHeight: number, dpr: number, cssPadding?: number): MinimapTransform;
+declare function worldRectToMinimap(rect: MinimapRect, transform: MinimapTransform): MinimapRect;
+declare function minimapViewportPlan(visible: MinimapRect, transform: MinimapTransform, pixelWidth: number, pixelHeight: number, strokeInset?: number): MinimapViewportPlan;
+declare function minimapPointToWorld(pixel: {
+    x: number;
+    y: number;
+}, transform: MinimapTransform): {
+    x: number;
+    y: number;
+};
+
+export { type MinimapRect, type MinimapTransform, type MinimapViewportPlan, createMinimapTransform, minimapPointToWorld, minimapViewportPlan, worldRectToMinimap };

package/dist/picker/minimapGeometry.d.ts

@@ -0,0 +1,37 @@
+/** Geometry helpers shared by the buyer minimap renderer and its focused tests. */
+interface MinimapRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface MinimapTransform {
+    scale: number;
+    offX: number;
+    offY: number;
+    dpr: number;
+}
+interface MinimapViewportPlan {
+    /** The camera rectangle under the unchanged full-world transform. */
+    raw: MinimapRect;
+    /** The visible portion of `raw`; drawing it never loses every edge off-canvas. */
+    clipped: MinimapRect | null;
+    clippedEdges: {
+        left: boolean;
+        top: boolean;
+        right: boolean;
+        bottom: boolean;
+    };
+}
+declare function createMinimapTransform(world: MinimapRect, pixelWidth: number, pixelHeight: number, dpr: number, cssPadding?: number): MinimapTransform;
+declare function worldRectToMinimap(rect: MinimapRect, transform: MinimapTransform): MinimapRect;
+declare function minimapViewportPlan(visible: MinimapRect, transform: MinimapTransform, pixelWidth: number, pixelHeight: number, strokeInset?: number): MinimapViewportPlan;
+declare function minimapPointToWorld(pixel: {
+    x: number;
+    y: number;
+}, transform: MinimapTransform): {
+    x: number;
+    y: number;
+};
+
+export { type MinimapRect, type MinimapTransform, type MinimapViewportPlan, createMinimapTransform, minimapPointToWorld, minimapViewportPlan, worldRectToMinimap };

package/dist/picker/minimapGeometry.js

@@ -0,0 +1 @@
+function u(i,n,m,o,a=6){let e=a*o,t=Math.min((n-e*2)/Math.max(1,i.width),(m-e*2)/Math.max(1,i.height));return{scale:t,offX:(n-i.width*t)/2-i.x*t,offY:(m-i.height*t)/2-i.y*t,dpr:o}}function r(i,n){return{x:i.x*n.scale+n.offX,y:i.y*n.scale+n.offY,width:i.width*n.scale,height:i.height*n.scale}}function b(i,n,m,o,a=2){let e=r(i,n),t=Math.max(a,e.x),p=Math.max(a,e.y),c=Math.min(m-a,e.x+e.width),h=Math.min(o-a,e.y+e.height);return{raw:e,clipped:c>t&&h>p?{x:t,y:p,width:c-t,height:h-p}:null,clippedEdges:{left:e.x<a,top:e.y<a,right:e.x+e.width>m-a,bottom:e.y+e.height>o-a}}}function f(i,n){return{x:(i.x-n.offX)/n.scale,y:(i.y-n.offY)/n.scale}}export{u as createMinimapTransform,f as minimapPointToWorld,b as minimapViewportPlan,r as worldRectToMinimap};

package/dist/{types-DR54nqKL.d.cts → types-tLOunI-B.d.cts}

@@ -56,6 +56,12 @@ interface Category {
      * a single price (the `price` above).
      */
     tiers?: CategoryTier[];
+    /**
+     * This category's inventory is never sellable (press, camera platforms,
+     * kills, promoter allocations). It needs no price to publish, buyers never
+     * see it as a ticket type, and holds on its seats are refused server-side.
+     */
+    notForSale?: boolean;
 }
 interface ReferenceCategorySource {
     assetId: string;
@@ -89,7 +95,35 @@ interface CategoryTier {
     id: string;
     name: string;
     price: number;
+    /** ISO-4217 currency observed or confirmed for this option. Events still
+     * settle in one currency; an importer must ask for review when observed
+     * option currencies disagree instead of silently converting them. */
+    currency?: string;
+    /** Explicit buyer eligibility/booking meaning. Importers must never infer
+     * this from the tier's display name. Only `companion` has an automatic
+     * inventory pairing rule; the remaining values surface organizer guidance. */
+    restriction?: TicketTierRestriction;
+    /** Short organizer-authored guidance shown beside this ticket choice. */
+    buyerMessage?: string;
+    /** Optional evidence-backed scope. Absent means every seat in the category;
+     * present fields are ANDed. Booking labels remain the stable public identity. */
+    applicability?: TicketTierApplicability;
+    /** Why this option's label, price, currency and scope may be trusted. */
+    evidence?: TicketTierEvidence;
+}
+interface TicketTierApplicability {
+    /** Exact public booking labels for which this option was observed/approved. */
+    seatLabels?: string[];
+    /** At least one of these authored accommodations must be present. */
+    accessibility?: AccessibilityType[];
 }
+interface TicketTierEvidence {
+    provenance: 'public-host' | 'public-event' | 'user-confirmed';
+    /** Buyer-safe evidence description; never a secret URL or credential. */
+    sourceDescription: string;
+    capturedAt?: string;
+}
+type TicketTierRestriction = 'companion' | 'child' | 'senior' | 'student' | 'membership' | 'custom';
 /**
  * Accessibility accommodations a seat can carry. Mirrors the taxonomy real
  * venues (and seats.io) expose so buyers can filter for exactly what they need
@@ -418,6 +452,15 @@ interface RowObject extends AuthoringObjectState {
         boundaryBefore: 'start' | 'continuous' | 'break';
         /** Buyer-facing row name; technical component `label` values never change. */
         displayLabel: string;
+        /**
+         * Some imported venue formats author label placement independently on every
+         * physical row component (for example, a split row can show its name on
+         * both sides of each aisle). When true, the buyer renderer uses each
+         * component's own `labelPresentation` instead of collapsing the group to
+         * one logical label. Ordinary SeatLayer-authored segmented rows omit this
+         * and retain the single logical-row label contract.
+         */
+        repeatLabelOnComponents?: boolean;
         displayType?: string;
         labelPresentation?: LabelPresentation;
         viewFromSeatUrl?: string;
@@ -865,6 +908,11 @@ interface SectionObject extends AuthoringObjectState {
      * the same kind as {@link height} and {@link rake}.
      */
     surfaceKind?: 'flat' | 'rakedRows';
+    /** Evidence for physical 3D values that cannot be read directly from a 2D
+     * drawing. Importers mark conservative defaults as inferred; editing any of
+     * these properties through Designer/Copilot promotes that property to a
+     * reviewed, user-confirmed value without changing the 2D topology. */
+    physical3dProvenance?: Partial<Record<'height' | 'rake' | 'surfaceKind', Physical3dEvidence>>;
     /** Uniform scale about the outline centroid (1 = as drawn). Scales members too. */
     scale?: number;
     /** 0–100: reviewed strength last used to bend member rows toward a common fitted arc. */
@@ -1025,6 +1073,10 @@ interface Floor {
      * Range 0–120 m.
      */
     baseHeightM?: number;
+    /** Evidence for the absolute physical deck height. */
+    physical3dProvenance?: {
+        baseHeightM?: Physical3dEvidence;
+    };
     objects: ChartObject[];
     focalPoint: Point;
     /**
@@ -1050,6 +1102,12 @@ interface Floor {
     /** Floor-scoped confidence evidence inherited before the venue default. */
     confidenceEvidence?: SeatConfidenceEvidence;
 }
+/** Durable publishing-review evidence for an editable physical 3D property. */
+interface Physical3dEvidence {
+    status: 'inferred' | 'confirmed';
+    source: 'public-2d-topology' | 'user-review';
+    note: string;
+}
 interface ReferenceCalibration {
     type: 'two-point';
     /** Points in immutable source-image pixels, selected by a human or trusted detector. */
@@ -1253,6 +1311,26 @@ interface ChartReferenceImage {
     /** Server-derived semantic calibration without source-image coordinates. */
     derivedScale?: ReferenceDerivedScale;
 }
+/**
+ * Durable responsive-layout rule for a venue arranged around a focal object.
+ * Sections are rigid groups: their internal rows/seats never scale or deform;
+ * only each group's anchor moves radially when the focal footprint needs more
+ * room. Importers and authoring tools can rerun the same rule after a pitch,
+ * stage or court changes size, even for very large section counts.
+ */
+interface RadialClearanceLayoutConstraint {
+    id: string;
+    kind: 'radial-clearance-v1';
+    focalObjectIds: string[];
+    sectionIds: string[];
+    clearance: number;
+    movement: 'rigid-section-groups';
+    /** Last solved proportional expansion, retained as useful audit evidence. */
+    resolvedExpansion: number;
+    /** Focal center used for the last solve, allowing the authored ring to be reconstructed after edits. */
+    resolvedFocalCenter?: Point;
+}
+type ChartLayoutConstraint = RadialClearanceLayoutConstraint;
 interface ChartDoc {
     version: 1;
     name: string;
@@ -1270,6 +1348,8 @@ interface ChartDoc {
      *  is kept mirroring floor 0 so single-floor readers never branch. */
     floors?: Floor[];
     objects: ChartObject[];
+    /** Re-runnable geometric relationships between focal components and sections. */
+    layoutConstraints?: ChartLayoutConstraint[];
     /**
      * Private floor-plan source used for tracing, calibration, scanning and
      * reference-backed generation. Buyer projections always remove this field.
@@ -1396,6 +1476,15 @@ interface RendererOptions extends RendererCallbacks {
     exportMode?: boolean;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /**
+     * Buyer-surface fit refinement: on containers much taller than the venue's
+     * projection (phones in portrait), zoomToFit may zoom past the strict
+     * width-contain by a bounded amount (≤30%) so the venue is not a thin band
+     * in a dark field. The overflow crops equally on both sides and the buyer
+     * pans freely. Off for the designer and export pipeline, which must always
+     * show the complete chart.
+     */
+    portraitFitCrop?: boolean;
     /** Only these statuses are clickable (default ['free']). */
     selectableStatuses?: SeatStatus[];
     /**
@@ -1509,6 +1598,18 @@ interface RenderedFreeTextEvidence {
     };
     hiddenReason?: 'below-minimum-size' | 'outside-viewport' | 'renderer-hidden';
 }
+interface RenderedRowLabelEvidence {
+    text: string;
+    visible: boolean;
+    renderedFontPx: number;
+    ink: string;
+    screenBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
 interface RenderedGAAreaEvidence {
     areaId: string;
     label: string;
@@ -1569,6 +1670,7 @@ interface RendererQualityEvidence {
     gaAreas: RenderedGAAreaEvidence[];
     hierarchyLabels: RenderedHierarchyLabelEvidence[];
     freeTextLabels: RenderedFreeTextEvidence[];
+    rowLabels: RenderedRowLabelEvidence[];
 }
 interface ISeatmapRenderer {
     /** Replace the chart. Resets selection and statuses, zooms to fit.
@@ -1654,6 +1756,8 @@ interface ISeatmapRenderer {
      */
     flashSection?(sectionId: string, color?: string): void;
     zoomToFit(): void;
+    /** Refit the active section when focused; otherwise frame the current floor/view. */
+    refitCurrentView?(): void;
     /** Zoom in one step about the viewport center, clamped to the usual zoom bounds. */
     zoomIn(): void;
     /** Zoom out one step about the viewport center, clamped to the usual zoom bounds. */
@@ -1719,6 +1823,11 @@ interface ISeatmapRenderer {
         width: number;
         height: number;
     };
+    /** Current rendered (not raw-source) geometry for an interactive overview.
+     * Multi-floor overview transforms are already applied to these coordinates. */
+    getMinimapSnapshot?(): RendererMinimapSnapshot;
+    /** Pan without changing zoom so `point` becomes the viewport centre. */
+    panToWorld?(point: Point): void;
     /**
      * 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
@@ -1744,6 +1853,9 @@ interface ISeatmapRenderer {
     /** Render all floors stacked (3D overview) vs the active floor. No-op single-floor. */
     setStacked?(on: boolean): void;
     isStacked?(): boolean;
+    /** Render every floor in its authored 2D coordinates so the buyer can choose a level. */
+    setFloorOverview?(on: boolean): void;
+    isFloorOverview?(): boolean;
     /**
      * Section id whose outline contains a container-relative screen point (or null).
      * Feeds the far-zoom "tap a section to zoom in" flow (Slice 5).
@@ -1775,7 +1887,25 @@ interface ISeatmapRenderer {
     getRenderedQualityEvidence(): RendererQualityEvidence;
     destroy(): void;
 }
+interface RendererMinimapSection {
+    id: string;
+    label: string;
+    outline: Point[];
+    floorId?: string;
+    state: 'selected' | 'available' | 'inactive';
+    active: boolean;
+}
+interface RendererMinimapSeat {
+    x: number;
+    y: number;
+    categoryKey: string;
+    state: 'selected' | 'available' | 'inactive';
+}
+interface RendererMinimapSnapshot {
+    sections: RendererMinimapSection[];
+    seats: RendererMinimapSeat[];
+}
 /** localStorage key the Designer writes and the Picker reads. */
 declare const CHART_STORAGE_KEY = "seatmap.chart";
 
-export { type ReferenceSectionTraceBatchProposal as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type DecorImageObject as D, type ExpandedSeat as E, type Floor as F, type GAAreaObject as G, LABEL_STYLE_MIN_SIZE as H, type ISeatmapRenderer as I, type LabelPresentation as J, type ReferenceAccessibilitySource as K, type LabelStyle as L, type ReferenceCalibration as M, type ReferenceCategorySource as N, type ObjectEditorState as O, type Point as P, type ReferenceDerivedScale as Q, type ResolvedSeatConfidenceEvidence as R, type SeatOverride as S, type TableObject as T, type ReferenceInventoryExclusionSource as U, type ReferenceInventorySource as V, type ReferenceScanProposal as W, type ReferenceScanRowProposal as X, type ReferenceScanSectionProposal as Y, type ReferenceSeatSeed as Z, type ReferenceSectionTraceBatchInput as _, type RowObject as a, type ReferenceSectionTraceInput as a0, type ReferenceSectionTraceProposal as a1, type RenderedBookableLabelEvidence as a2, type RenderedGAAreaEvidence as a3, type RenderedHierarchyLabelEvidence as a4, type RenderedLabelHiddenReason as a5, SEAT_COMMERCIAL_MARKS as a6, SURROUNDINGS_SHAPE_ROLES as a7, type SeatCommercialMark as a8, type SeatCommercialMeta as a9, type SeatConfidenceCoverage as aa, type SeatConfidenceEvidence as ab, type SeatConfidenceModelLevel as ac, type SeatConfidenceModeledTarget as ad, type SeatConfidenceRealityLevel as ae, type SeatViewCoverage as af, type SectionOutlinePath as ag, type SectionPathSegment as ah, type SelectionLayer as ai, type ShapeLineCap as aj, type ShapeLineEnding as ak, type ShapeLineJoin as al, type ShapeObject as am, type TextAlignment as an, type TextBackground as ao, type TextObject as ap, type ZoneDef as aq, accessibilityMeta as ar, accessibilityRingColor as as, layerOf as at, seatCommercialMeta as au, type SeatViewMetadata as b, type RectTableSide as c, type ChartObject as d, type SectionObject as e, type RectTableSeatCounts as f, type GAInventorySegment as g, type RendererQualityEvidence as h, type RenderedFreeTextEvidence as i, type RendererOptions as j, type SeatStatus as k, type RendererViewMode as l, type LodRung as m, type CategoryTier as n, type SeatCommercialAttributes as o, type RendererCallbacks as p, ACCESSIBILITY_RING_COLOR as q, ACCESSIBILITY_TYPES as r, type AccessibilityMeta as s, type AuthoringObjectState as t, CHART_STORAGE_KEY as u, type Category as v, type ChartReferenceImage as w, type ChartTheme as x, type CubicPath as y, LABEL_STYLE_MAX_SIZE as z };
+export { type ReferenceScanRowProposal as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type CubicPath as D, type ExpandedSeat as E, type Floor as F, type GAAreaObject as G, type DecorImageObject as H, type ISeatmapRenderer as I, LABEL_STYLE_MAX_SIZE as J, LABEL_STYLE_MIN_SIZE as K, type LabelStyle as L, type LabelPresentation as M, type Physical3dEvidence as N, type ObjectEditorState as O, type Point as P, type RadialClearanceLayoutConstraint as Q, type ResolvedSeatConfidenceEvidence as R, type SeatOverride as S, type TableObject as T, type ReferenceAccessibilitySource as U, type ReferenceCalibration as V, type ReferenceCategorySource as W, type ReferenceDerivedScale as X, type ReferenceInventoryExclusionSource as Y, type ReferenceInventorySource as Z, type ReferenceScanProposal as _, type RowObject as a, type ReferenceScanSectionProposal as a0, type ReferenceSeatSeed as a1, type ReferenceSectionTraceBatchInput as a2, type ReferenceSectionTraceBatchProposal as a3, type ReferenceSectionTraceInput as a4, type ReferenceSectionTraceProposal as a5, type RenderedBookableLabelEvidence as a6, type RenderedGAAreaEvidence as a7, type RenderedHierarchyLabelEvidence as a8, type RenderedLabelHiddenReason as a9, type ZoneDef as aA, accessibilityMeta as aB, accessibilityRingColor as aC, layerOf as aD, seatCommercialMeta as aE, type RenderedRowLabelEvidence as aa, type RendererMinimapSeat as ab, type RendererMinimapSection as ac, SEAT_COMMERCIAL_MARKS as ad, SURROUNDINGS_SHAPE_ROLES as ae, type SeatCommercialMark as af, type SeatCommercialMeta as ag, type SeatConfidenceCoverage as ah, type SeatConfidenceEvidence as ai, type SeatConfidenceModelLevel as aj, type SeatConfidenceModeledTarget as ak, type SeatConfidenceRealityLevel as al, type SeatViewCoverage as am, type SectionOutlinePath as an, type SectionPathSegment as ao, type SelectionLayer as ap, type ShapeLineCap as aq, type ShapeLineEnding as ar, type ShapeLineJoin as as, type ShapeObject as at, type TextAlignment as au, type TextBackground as av, type TextObject as aw, type TicketTierApplicability as ax, type TicketTierEvidence as ay, type TicketTierRestriction as az, type SeatViewMetadata as b, type RectTableSide as c, type ChartObject as d, type SectionObject as e, type RectTableSeatCounts as f, type GAInventorySegment as g, type RendererQualityEvidence as h, type RenderedFreeTextEvidence as i, type RendererOptions as j, type SeatStatus as k, type RendererViewMode as l, type RendererMinimapSnapshot as m, type LodRung as n, type CategoryTier as o, type SeatCommercialAttributes as p, type RendererCallbacks as q, ACCESSIBILITY_RING_COLOR as r, ACCESSIBILITY_TYPES as s, type AccessibilityMeta as t, type AuthoringObjectState as u, CHART_STORAGE_KEY as v, type Category as w, type ChartLayoutConstraint as x, type ChartReferenceImage as y, type ChartTheme as z };

package/dist/{types-DR54nqKL.d.ts → types-tLOunI-B.d.ts}

@@ -56,6 +56,12 @@ interface Category {
      * a single price (the `price` above).
      */
     tiers?: CategoryTier[];
+    /**
+     * This category's inventory is never sellable (press, camera platforms,
+     * kills, promoter allocations). It needs no price to publish, buyers never
+     * see it as a ticket type, and holds on its seats are refused server-side.
+     */
+    notForSale?: boolean;
 }
 interface ReferenceCategorySource {
     assetId: string;
@@ -89,7 +95,35 @@ interface CategoryTier {
     id: string;
     name: string;
     price: number;
+    /** ISO-4217 currency observed or confirmed for this option. Events still
+     * settle in one currency; an importer must ask for review when observed
+     * option currencies disagree instead of silently converting them. */
+    currency?: string;
+    /** Explicit buyer eligibility/booking meaning. Importers must never infer
+     * this from the tier's display name. Only `companion` has an automatic
+     * inventory pairing rule; the remaining values surface organizer guidance. */
+    restriction?: TicketTierRestriction;
+    /** Short organizer-authored guidance shown beside this ticket choice. */
+    buyerMessage?: string;
+    /** Optional evidence-backed scope. Absent means every seat in the category;
+     * present fields are ANDed. Booking labels remain the stable public identity. */
+    applicability?: TicketTierApplicability;
+    /** Why this option's label, price, currency and scope may be trusted. */
+    evidence?: TicketTierEvidence;
+}
+interface TicketTierApplicability {
+    /** Exact public booking labels for which this option was observed/approved. */
+    seatLabels?: string[];
+    /** At least one of these authored accommodations must be present. */
+    accessibility?: AccessibilityType[];
 }
+interface TicketTierEvidence {
+    provenance: 'public-host' | 'public-event' | 'user-confirmed';
+    /** Buyer-safe evidence description; never a secret URL or credential. */
+    sourceDescription: string;
+    capturedAt?: string;
+}
+type TicketTierRestriction = 'companion' | 'child' | 'senior' | 'student' | 'membership' | 'custom';
 /**
  * Accessibility accommodations a seat can carry. Mirrors the taxonomy real
  * venues (and seats.io) expose so buyers can filter for exactly what they need
@@ -418,6 +452,15 @@ interface RowObject extends AuthoringObjectState {
         boundaryBefore: 'start' | 'continuous' | 'break';
         /** Buyer-facing row name; technical component `label` values never change. */
         displayLabel: string;
+        /**
+         * Some imported venue formats author label placement independently on every
+         * physical row component (for example, a split row can show its name on
+         * both sides of each aisle). When true, the buyer renderer uses each
+         * component's own `labelPresentation` instead of collapsing the group to
+         * one logical label. Ordinary SeatLayer-authored segmented rows omit this
+         * and retain the single logical-row label contract.
+         */
+        repeatLabelOnComponents?: boolean;
         displayType?: string;
         labelPresentation?: LabelPresentation;
         viewFromSeatUrl?: string;
@@ -865,6 +908,11 @@ interface SectionObject extends AuthoringObjectState {
      * the same kind as {@link height} and {@link rake}.
      */
     surfaceKind?: 'flat' | 'rakedRows';
+    /** Evidence for physical 3D values that cannot be read directly from a 2D
+     * drawing. Importers mark conservative defaults as inferred; editing any of
+     * these properties through Designer/Copilot promotes that property to a
+     * reviewed, user-confirmed value without changing the 2D topology. */
+    physical3dProvenance?: Partial<Record<'height' | 'rake' | 'surfaceKind', Physical3dEvidence>>;
     /** Uniform scale about the outline centroid (1 = as drawn). Scales members too. */
     scale?: number;
     /** 0–100: reviewed strength last used to bend member rows toward a common fitted arc. */
@@ -1025,6 +1073,10 @@ interface Floor {
      * Range 0–120 m.
      */
     baseHeightM?: number;
+    /** Evidence for the absolute physical deck height. */
+    physical3dProvenance?: {
+        baseHeightM?: Physical3dEvidence;
+    };
     objects: ChartObject[];
     focalPoint: Point;
     /**
@@ -1050,6 +1102,12 @@ interface Floor {
     /** Floor-scoped confidence evidence inherited before the venue default. */
     confidenceEvidence?: SeatConfidenceEvidence;
 }
+/** Durable publishing-review evidence for an editable physical 3D property. */
+interface Physical3dEvidence {
+    status: 'inferred' | 'confirmed';
+    source: 'public-2d-topology' | 'user-review';
+    note: string;
+}
 interface ReferenceCalibration {
     type: 'two-point';
     /** Points in immutable source-image pixels, selected by a human or trusted detector. */
@@ -1253,6 +1311,26 @@ interface ChartReferenceImage {
     /** Server-derived semantic calibration without source-image coordinates. */
     derivedScale?: ReferenceDerivedScale;
 }
+/**
+ * Durable responsive-layout rule for a venue arranged around a focal object.
+ * Sections are rigid groups: their internal rows/seats never scale or deform;
+ * only each group's anchor moves radially when the focal footprint needs more
+ * room. Importers and authoring tools can rerun the same rule after a pitch,
+ * stage or court changes size, even for very large section counts.
+ */
+interface RadialClearanceLayoutConstraint {
+    id: string;
+    kind: 'radial-clearance-v1';
+    focalObjectIds: string[];
+    sectionIds: string[];
+    clearance: number;
+    movement: 'rigid-section-groups';
+    /** Last solved proportional expansion, retained as useful audit evidence. */
+    resolvedExpansion: number;
+    /** Focal center used for the last solve, allowing the authored ring to be reconstructed after edits. */
+    resolvedFocalCenter?: Point;
+}
+type ChartLayoutConstraint = RadialClearanceLayoutConstraint;
 interface ChartDoc {
     version: 1;
     name: string;
@@ -1270,6 +1348,8 @@ interface ChartDoc {
      *  is kept mirroring floor 0 so single-floor readers never branch. */
     floors?: Floor[];
     objects: ChartObject[];
+    /** Re-runnable geometric relationships between focal components and sections. */
+    layoutConstraints?: ChartLayoutConstraint[];
     /**
      * Private floor-plan source used for tracing, calibration, scanning and
      * reference-backed generation. Buyer projections always remove this field.
@@ -1396,6 +1476,15 @@ interface RendererOptions extends RendererCallbacks {
     exportMode?: boolean;
     /** Max seats selectable at once (default 10). */
     maxSelection?: number;
+    /**
+     * Buyer-surface fit refinement: on containers much taller than the venue's
+     * projection (phones in portrait), zoomToFit may zoom past the strict
+     * width-contain by a bounded amount (≤30%) so the venue is not a thin band
+     * in a dark field. The overflow crops equally on both sides and the buyer
+     * pans freely. Off for the designer and export pipeline, which must always
+     * show the complete chart.
+     */
+    portraitFitCrop?: boolean;
     /** Only these statuses are clickable (default ['free']). */
     selectableStatuses?: SeatStatus[];
     /**
@@ -1509,6 +1598,18 @@ interface RenderedFreeTextEvidence {
     };
     hiddenReason?: 'below-minimum-size' | 'outside-viewport' | 'renderer-hidden';
 }
+interface RenderedRowLabelEvidence {
+    text: string;
+    visible: boolean;
+    renderedFontPx: number;
+    ink: string;
+    screenBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
 interface RenderedGAAreaEvidence {
     areaId: string;
     label: string;
@@ -1569,6 +1670,7 @@ interface RendererQualityEvidence {
     gaAreas: RenderedGAAreaEvidence[];
     hierarchyLabels: RenderedHierarchyLabelEvidence[];
     freeTextLabels: RenderedFreeTextEvidence[];
+    rowLabels: RenderedRowLabelEvidence[];
 }
 interface ISeatmapRenderer {
     /** Replace the chart. Resets selection and statuses, zooms to fit.
@@ -1654,6 +1756,8 @@ interface ISeatmapRenderer {
      */
     flashSection?(sectionId: string, color?: string): void;
     zoomToFit(): void;
+    /** Refit the active section when focused; otherwise frame the current floor/view. */
+    refitCurrentView?(): void;
     /** Zoom in one step about the viewport center, clamped to the usual zoom bounds. */
     zoomIn(): void;
     /** Zoom out one step about the viewport center, clamped to the usual zoom bounds. */
@@ -1719,6 +1823,11 @@ interface ISeatmapRenderer {
         width: number;
         height: number;
     };
+    /** Current rendered (not raw-source) geometry for an interactive overview.
+     * Multi-floor overview transforms are already applied to these coordinates. */
+    getMinimapSnapshot?(): RendererMinimapSnapshot;
+    /** Pan without changing zoom so `point` becomes the viewport centre. */
+    panToWorld?(point: Point): void;
     /**
      * 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
@@ -1744,6 +1853,9 @@ interface ISeatmapRenderer {
     /** Render all floors stacked (3D overview) vs the active floor. No-op single-floor. */
     setStacked?(on: boolean): void;
     isStacked?(): boolean;
+    /** Render every floor in its authored 2D coordinates so the buyer can choose a level. */
+    setFloorOverview?(on: boolean): void;
+    isFloorOverview?(): boolean;
     /**
      * Section id whose outline contains a container-relative screen point (or null).
      * Feeds the far-zoom "tap a section to zoom in" flow (Slice 5).
@@ -1775,7 +1887,25 @@ interface ISeatmapRenderer {
     getRenderedQualityEvidence(): RendererQualityEvidence;
     destroy(): void;
 }
+interface RendererMinimapSection {
+    id: string;
+    label: string;
+    outline: Point[];
+    floorId?: string;
+    state: 'selected' | 'available' | 'inactive';
+    active: boolean;
+}
+interface RendererMinimapSeat {
+    x: number;
+    y: number;
+    categoryKey: string;
+    state: 'selected' | 'available' | 'inactive';
+}
+interface RendererMinimapSnapshot {
+    sections: RendererMinimapSection[];
+    seats: RendererMinimapSeat[];
+}
 /** localStorage key the Designer writes and the Picker reads. */
 declare const CHART_STORAGE_KEY = "seatmap.chart";
 
-export { type ReferenceSectionTraceBatchProposal as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type DecorImageObject as D, type ExpandedSeat as E, type Floor as F, type GAAreaObject as G, LABEL_STYLE_MIN_SIZE as H, type ISeatmapRenderer as I, type LabelPresentation as J, type ReferenceAccessibilitySource as K, type LabelStyle as L, type ReferenceCalibration as M, type ReferenceCategorySource as N, type ObjectEditorState as O, type Point as P, type ReferenceDerivedScale as Q, type ResolvedSeatConfidenceEvidence as R, type SeatOverride as S, type TableObject as T, type ReferenceInventoryExclusionSource as U, type ReferenceInventorySource as V, type ReferenceScanProposal as W, type ReferenceScanRowProposal as X, type ReferenceScanSectionProposal as Y, type ReferenceSeatSeed as Z, type ReferenceSectionTraceBatchInput as _, type RowObject as a, type ReferenceSectionTraceInput as a0, type ReferenceSectionTraceProposal as a1, type RenderedBookableLabelEvidence as a2, type RenderedGAAreaEvidence as a3, type RenderedHierarchyLabelEvidence as a4, type RenderedLabelHiddenReason as a5, SEAT_COMMERCIAL_MARKS as a6, SURROUNDINGS_SHAPE_ROLES as a7, type SeatCommercialMark as a8, type SeatCommercialMeta as a9, type SeatConfidenceCoverage as aa, type SeatConfidenceEvidence as ab, type SeatConfidenceModelLevel as ac, type SeatConfidenceModeledTarget as ad, type SeatConfidenceRealityLevel as ae, type SeatViewCoverage as af, type SectionOutlinePath as ag, type SectionPathSegment as ah, type SelectionLayer as ai, type ShapeLineCap as aj, type ShapeLineEnding as ak, type ShapeLineJoin as al, type ShapeObject as am, type TextAlignment as an, type TextBackground as ao, type TextObject as ap, type ZoneDef as aq, accessibilityMeta as ar, accessibilityRingColor as as, layerOf as at, seatCommercialMeta as au, type SeatViewMetadata as b, type RectTableSide as c, type ChartObject as d, type SectionObject as e, type RectTableSeatCounts as f, type GAInventorySegment as g, type RendererQualityEvidence as h, type RenderedFreeTextEvidence as i, type RendererOptions as j, type SeatStatus as k, type RendererViewMode as l, type LodRung as m, type CategoryTier as n, type SeatCommercialAttributes as o, type RendererCallbacks as p, ACCESSIBILITY_RING_COLOR as q, ACCESSIBILITY_TYPES as r, type AccessibilityMeta as s, type AuthoringObjectState as t, CHART_STORAGE_KEY as u, type Category as v, type ChartReferenceImage as w, type ChartTheme as x, type CubicPath as y, LABEL_STYLE_MAX_SIZE as z };
+export { type ReferenceScanRowProposal as $, type AccessibilityType as A, type BoothObject as B, type ChartDoc as C, type CubicPath as D, type ExpandedSeat as E, type Floor as F, type GAAreaObject as G, type DecorImageObject as H, type ISeatmapRenderer as I, LABEL_STYLE_MAX_SIZE as J, LABEL_STYLE_MIN_SIZE as K, type LabelStyle as L, type LabelPresentation as M, type Physical3dEvidence as N, type ObjectEditorState as O, type Point as P, type RadialClearanceLayoutConstraint as Q, type ResolvedSeatConfidenceEvidence as R, type SeatOverride as S, type TableObject as T, type ReferenceAccessibilitySource as U, type ReferenceCalibration as V, type ReferenceCategorySource as W, type ReferenceDerivedScale as X, type ReferenceInventoryExclusionSource as Y, type ReferenceInventorySource as Z, type ReferenceScanProposal as _, type RowObject as a, type ReferenceScanSectionProposal as a0, type ReferenceSeatSeed as a1, type ReferenceSectionTraceBatchInput as a2, type ReferenceSectionTraceBatchProposal as a3, type ReferenceSectionTraceInput as a4, type ReferenceSectionTraceProposal as a5, type RenderedBookableLabelEvidence as a6, type RenderedGAAreaEvidence as a7, type RenderedHierarchyLabelEvidence as a8, type RenderedLabelHiddenReason as a9, type ZoneDef as aA, accessibilityMeta as aB, accessibilityRingColor as aC, layerOf as aD, seatCommercialMeta as aE, type RenderedRowLabelEvidence as aa, type RendererMinimapSeat as ab, type RendererMinimapSection as ac, SEAT_COMMERCIAL_MARKS as ad, SURROUNDINGS_SHAPE_ROLES as ae, type SeatCommercialMark as af, type SeatCommercialMeta as ag, type SeatConfidenceCoverage as ah, type SeatConfidenceEvidence as ai, type SeatConfidenceModelLevel as aj, type SeatConfidenceModeledTarget as ak, type SeatConfidenceRealityLevel as al, type SeatViewCoverage as am, type SectionOutlinePath as an, type SectionPathSegment as ao, type SelectionLayer as ap, type ShapeLineCap as aq, type ShapeLineEnding as ar, type ShapeLineJoin as as, type ShapeObject as at, type TextAlignment as au, type TextBackground as av, type TextObject as aw, type TicketTierApplicability as ax, type TicketTierEvidence as ay, type TicketTierRestriction as az, type SeatViewMetadata as b, type RectTableSide as c, type ChartObject as d, type SectionObject as e, type RectTableSeatCounts as f, type GAInventorySegment as g, type RendererQualityEvidence as h, type RenderedFreeTextEvidence as i, type RendererOptions as j, type SeatStatus as k, type RendererViewMode as l, type RendererMinimapSnapshot as m, type LodRung as n, type CategoryTier as o, type SeatCommercialAttributes as p, type RendererCallbacks as q, ACCESSIBILITY_RING_COLOR as r, ACCESSIBILITY_TYPES as s, type AccessibilityMeta as t, type AuthoringObjectState as u, CHART_STORAGE_KEY as v, type Category as w, type ChartLayoutConstraint as x, type ChartReferenceImage as y, type ChartTheme as z };