@seatlayer/core 0.46.0 → 0.47.1

package/dist/{types-DBnRO2hX.d.cts → types-CE63BK0j.d.cts}

@@ -117,6 +117,28 @@ declare function accessibilityMeta(key: AccessibilityType): AccessibilityMeta |
 declare const ACCESSIBILITY_RING_COLOR: Record<AccessibilityType, string>;
 /** Ring colour for a seat's accessibility set (first-listed type wins). */
 declare function accessibilityRingColor(types: AccessibilityType[] | undefined): string;
+type SeatViewCoverage = 'exact-seat' | 'row-representative' | 'section-representative' | 'venue-representative';
+/** Calibration and truth metadata that travels with an organizer panorama.
+ * The URL remains separate for backward compatibility with existing charts. */
+interface SeatViewMetadata {
+    projection?: 'equirectangular';
+    coverage?: SeatViewCoverage;
+    /** Optional lightweight first paint. `viewFromSeatUrl` remains the sharp source. */
+    previewUrl?: string;
+    previewWidth?: number;
+    previewHeight?: number;
+    /** Degrees relative to the authored focal/stage direction. */
+    initialBearingDeg?: number;
+    /** Positive looks up. The viewer clamps to its safe pitch range. */
+    initialPitchDeg?: number;
+    capturedAt?: string;
+    /** Buyer-safe provenance, e.g. "Provided by the venue". */
+    sourceLabel?: string;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    captureEyeHeightM?: number;
+    eventConfigurationId?: string;
+}
 interface SeatOverride {
     /** 0-based seat index within the row. */
     index: number;
@@ -146,6 +168,8 @@ interface SeatOverride {
     commercial?: SeatCommercialAttributes;
     /** Seat-specific view photo; falls back to the row photo. */
     viewFromSeatUrl?: string;
+    /** Calibration/truth for `viewFromSeatUrl`; ignored when the URL is absent. */
+    viewFromSeatMeta?: SeatViewMetadata;
     /** Per-seat label size/color override; falls back to the row/theme default.
      *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
      *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
@@ -219,6 +243,19 @@ interface LabelPresentation {
      */
     positionPreset?: 'start' | 'end' | 'both' | 'none';
 }
+/** Persisted authoring ergonomics that must not change buyer inventory or
+ * rendering. Buyer projections strip this object before a chart is served. */
+interface ObjectEditorState {
+    /** Objects sharing this id select and transform as one authoring unit. */
+    groupId?: string;
+    /** Protect canvas geometry while keeping ordinary Inspector properties editable. */
+    locked?: boolean;
+    /** Remove the object from the authoring scene until Reveal hidden is used. */
+    hidden?: boolean;
+}
+interface AuthoringObjectState {
+    editor?: ObjectEditorState;
+}
 /** Brand/venue theming — applied by the renderer in both designer and picker. */
 interface ChartTheme {
     /** Canvas background color (default dark: #0e1117-ish radial). */
@@ -248,7 +285,7 @@ interface ChartTheme {
     /** Paid-tier flag: hide the "Powered by SeatMap" badge. */
     hideBadge?: boolean;
 }
-interface RowObject {
+interface RowObject extends AuthoringObjectState {
     type: 'row';
     id: string;
     /** Present when this row was materialized by the in-canvas reference scan.
@@ -338,6 +375,7 @@ interface RowObject {
         displayType?: string;
         labelPresentation?: LabelPresentation;
         viewFromSeatUrl?: string;
+        viewFromSeatMeta?: SeatViewMetadata;
         /** Presentation intent for a continuous node-defined centreline. */
         smoothing?: boolean;
     };
@@ -413,10 +451,11 @@ interface RowObject {
      * generates a synthetic panorama from chart geometry.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
     /** Default commercial attributes inherited by seats without an override. */
     commercial?: SeatCommercialAttributes;
 }
-interface GAAreaObject {
+interface GAAreaObject extends AuthoringObjectState {
     type: 'gaArea';
     id: string;
     /** Stable technical/inventory label. */
@@ -514,7 +553,7 @@ type ShapeLineCap = 'butt' | 'round' | 'square';
 type ShapeLineJoin = 'miter' | 'round' | 'bevel';
 type ShapeLineEnding = 'none' | 'arrow';
 /** Non-bookable décor: stage, walls, exits. */
-interface ShapeObject {
+interface ShapeObject extends AuthoringObjectState {
     type: 'shape';
     id: string;
     /**
@@ -548,6 +587,14 @@ interface ShapeObject {
     cornerRadius?: number;
     /** Whole-shape opacity 0.1–1 (default 1). */
     opacity?: number;
+    /** Optional physical extrusion height used by the 3D venue renderer. */
+    heightM?: number;
+    /**
+     * Event configurations in which this architecture is present. Absent means
+     * the shape belongs to every configuration; a scoped shape is hidden until
+     * one of these ids is active on the chart or 3D scene input.
+     */
+    eventConfigurationIds?: string[];
     /** Degrees clockwise about the shape's center (default 0). Applied at render time. */
     rotation?: number;
     /**
@@ -574,7 +621,7 @@ interface RectTableSeatCounts {
 /** Seats arranged around a table. Grouped selling is activated only by an
  * event's explicit inventory-model-2 snapshot; model-1 events continue to
  * treat every authored chair as an independent unit. */
-interface TableObject {
+interface TableObject extends AuthoringObjectState {
     type: 'table';
     id: string;
     /** e.g. "T1" — seat labels are `${label}-${n}`. */
@@ -623,7 +670,7 @@ interface TableObject {
     referenceInventorySource?: ReferenceInventorySource;
 }
 /** A booth: one bookable unit rendered as a block (trade shows, VIP boxes). */
-interface BoothObject {
+interface BoothObject extends AuthoringObjectState {
     type: 'booth';
     id: string;
     /** Stable technical/inventory label. */
@@ -657,7 +704,7 @@ interface BoothObject {
  * Renderer: far zoom shows section shapes/labels instead of seats; clicking
  * a section zooms into it.
  */
-interface SectionObject {
+interface SectionObject extends AuthoringObjectState {
     type: 'section';
     id: string;
     label: string;
@@ -675,6 +722,7 @@ interface SectionObject {
      * metadata operation.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
     labelPresentation?: LabelPresentation;
     /**
      * Stable management/inventory identity shared by disconnected visual
@@ -826,11 +874,21 @@ type SelectionLayer = 'interactive' | 'background' | 'foreground' | 'surrounding
  * lockstep with `DECOR_PRESETS`; the selection-layer unit test fails if either
  * vocabulary changes without an explicit routing decision. `reference-focal`
  * is source-backed venue context rather than an authoring-palette preset. */
-declare const SURROUNDINGS_SHAPE_ROLES: readonly ["reference-focal", "bar", "entrance", "exit", "restroom", "screen", "sound", "concession", "coat", "wall"];
+declare const SURROUNDINGS_SHAPE_ROLES: readonly ["reference-focal", "bar", "entrance", "exit", "restroom", "screen", "sound", "concession", "coat", "wall", "rail", "suite", "obstruction"];
 /** Derive an object's selection layer from its type. */
 declare function layerOf(obj: ChartObject): SelectionLayer;
 /** Free-standing text on the chart (aisle names, door labels…). */
-interface TextObject {
+type TextAlignment = 'left' | 'center' | 'right';
+interface TextBackground {
+    color: string;
+    /** Space inside the background in chart units; default 6. */
+    padding?: number;
+    /** Rounded background corners in chart units; default 4. */
+    cornerRadius?: number;
+    /** Background-only opacity multiplied by the text object's overall opacity. */
+    opacity?: number;
+}
+interface TextObject extends AuthoringObjectState {
     type: 'text';
     id: string;
     /** Persisted provenance for objects created from the venue-icon palette. */
@@ -853,6 +911,20 @@ interface TextObject {
     bold?: boolean;
     /** Render slant (default false). Maps to Konva fontStyle italic. */
     italic?: boolean;
+    /** Fixed text-box width in chart units. Absent keeps legacy auto width. */
+    width?: number;
+    /** Horizontal alignment inside a fixed-width text box. */
+    align?: TextAlignment;
+    /** Multiplier over the font's natural line height; default 1.2. */
+    lineHeight?: number;
+    /** Added chart units between glyphs; default 0. */
+    letterSpacing?: number;
+    /** Underline decoration. Absent is off. */
+    underline?: boolean;
+    /** Whole text-object opacity; default 1. */
+    opacity?: number;
+    /** Optional padded background painted behind the exact text box. */
+    background?: TextBackground;
 }
 /**
  * A raster/vector decor graphic drawn IN the chart, beneath the seats and
@@ -863,7 +935,7 @@ interface TextObject {
  * 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 {
+interface DecorImageObject extends AuthoringObjectState {
     type: 'decorImage';
     id: string;
     /** Image or SVG data URL. */
@@ -923,6 +995,7 @@ interface Floor {
      * panorama) applies.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
 }
 interface ReferenceCalibration {
     type: 'two-point';
@@ -1134,6 +1207,8 @@ interface ChartDoc {
     /** The stage / point every seat looks at. Anchors seat-view + sightlines.
      *  Multi-floor: mirrors floor 0; each floor also carries its own focalPoint. */
     focalPoint: Point;
+    /** Active event layout used by configuration-scoped 3D architecture. */
+    eventConfigurationId?: string;
     categories: Category[];
     /** Section groupings for far-zoom navigation + pricing (optional; sections reference by id). */
     zones?: ZoneDef[];
@@ -1168,6 +1243,7 @@ interface ChartDoc {
      * the picker generates a synthetic panorama.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
 }
 interface ExpandedSeat {
     /** Stable id: `${rowId}:${index}` */
@@ -1203,6 +1279,8 @@ interface ExpandedSeat {
     commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Calibration/truth inherited from the same scope that supplied `viewUrl`. */
+    viewMeta?: SeatViewMetadata;
     /** Per-seat label size/color override; absent = inherit the row/theme default. */
     labelStyle?: LabelStyle;
     /**
@@ -1643,4 +1721,4 @@ interface ISeatmapRenderer {
 /** localStorage key the Designer writes and the Picker reads. */
 declare const CHART_STORAGE_KEY = "seatmap.chart";
 
-export { type RenderedGAAreaEvidence 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, type ReferenceCalibration as H, type ISeatmapRenderer as I, type ReferenceCategorySource as J, type ReferenceDerivedScale as K, type LabelStyle as L, type ReferenceInventoryExclusionSource as M, type ReferenceInventorySource as N, type ReferenceScanProposal as O, type Point as P, type ReferenceScanRowProposal as Q, type RowObject as R, type SeatOverride as S, type TableObject as T, type ReferenceScanSectionProposal as U, type ReferenceSeatSeed as V, type ReferenceSectionTraceBatchInput as W, type ReferenceSectionTraceBatchProposal as X, type ReferenceSectionTraceInput as Y, type ReferenceSectionTraceProposal as Z, type RenderedBookableLabelEvidence as _, type RectTableSide as a, type RenderedHierarchyLabelEvidence as a0, type RenderedLabelHiddenReason as a1, SEAT_COMMERCIAL_MARKS as a2, SURROUNDINGS_SHAPE_ROLES as a3, type SeatCommercialMark as a4, type SeatCommercialMeta as a5, type SectionOutlinePath as a6, type SectionPathSegment as a7, type SelectionLayer as a8, type ShapeLineCap as a9, type ShapeLineEnding as aa, type ShapeLineJoin as ab, type ShapeObject as ac, type TextObject as ad, type ZoneDef as ae, accessibilityMeta as af, accessibilityRingColor as ag, layerOf as ah, seatCommercialMeta as ai, type ChartObject as b, type SectionObject as c, type RectTableSeatCounts as d, type GAInventorySegment as e, type RendererQualityEvidence as f, type RenderedFreeTextEvidence as g, type RendererOptions as h, type SeatStatus as i, type RendererViewMode as j, type LodRung as k, type CategoryTier as l, type SeatCommercialAttributes as m, type RendererCallbacks as n, ACCESSIBILITY_RING_COLOR as o, ACCESSIBILITY_TYPES as p, type AccessibilityMeta as q, CHART_STORAGE_KEY as r, type Category as s, type ChartReferenceImage as t, type ChartTheme as u, type CubicPath as v, LABEL_STYLE_MAX_SIZE as w, LABEL_STYLE_MIN_SIZE as x, type LabelPresentation as y, type ReferenceAccessibilitySource as z };
+export { type ReferenceSectionTraceInput 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, type LabelPresentation as H, type ISeatmapRenderer as I, type ReferenceAccessibilitySource as J, type ReferenceCalibration as K, type LabelStyle as L, type ReferenceCategorySource as M, type ReferenceDerivedScale as N, type ObjectEditorState as O, type Point as P, type ReferenceInventoryExclusionSource as Q, type RowObject as R, type SeatOverride as S, type TableObject as T, type ReferenceInventorySource as U, type ReferenceScanProposal as V, type ReferenceScanRowProposal as W, type ReferenceScanSectionProposal as X, type ReferenceSeatSeed as Y, type ReferenceSectionTraceBatchInput as Z, type ReferenceSectionTraceBatchProposal as _, type SeatViewMetadata as a, type ReferenceSectionTraceProposal as a0, type RenderedBookableLabelEvidence as a1, type RenderedGAAreaEvidence as a2, type RenderedHierarchyLabelEvidence as a3, type RenderedLabelHiddenReason as a4, SEAT_COMMERCIAL_MARKS as a5, SURROUNDINGS_SHAPE_ROLES as a6, type SeatCommercialMark as a7, type SeatCommercialMeta as a8, type SeatViewCoverage as a9, type SectionOutlinePath as aa, type SectionPathSegment as ab, type SelectionLayer as ac, type ShapeLineCap as ad, type ShapeLineEnding as ae, type ShapeLineJoin as af, type ShapeObject as ag, type TextAlignment as ah, type TextBackground as ai, type TextObject as aj, type ZoneDef as ak, accessibilityMeta as al, accessibilityRingColor as am, layerOf as an, seatCommercialMeta as ao, type RectTableSide as b, type ChartObject as c, type SectionObject as d, type RectTableSeatCounts as e, type GAInventorySegment as f, type RendererQualityEvidence as g, type RenderedFreeTextEvidence as h, type RendererOptions as i, type SeatStatus as j, type RendererViewMode as k, type LodRung as l, type CategoryTier as m, type SeatCommercialAttributes as n, type RendererCallbacks as o, ACCESSIBILITY_RING_COLOR as p, ACCESSIBILITY_TYPES as q, type AccessibilityMeta as r, type AuthoringObjectState as s, CHART_STORAGE_KEY as t, type Category as u, type ChartReferenceImage as v, type ChartTheme as w, type CubicPath as x, LABEL_STYLE_MAX_SIZE as y, LABEL_STYLE_MIN_SIZE as z };

package/dist/{types-DBnRO2hX.d.ts → types-CE63BK0j.d.ts}

@@ -117,6 +117,28 @@ declare function accessibilityMeta(key: AccessibilityType): AccessibilityMeta |
 declare const ACCESSIBILITY_RING_COLOR: Record<AccessibilityType, string>;
 /** Ring colour for a seat's accessibility set (first-listed type wins). */
 declare function accessibilityRingColor(types: AccessibilityType[] | undefined): string;
+type SeatViewCoverage = 'exact-seat' | 'row-representative' | 'section-representative' | 'venue-representative';
+/** Calibration and truth metadata that travels with an organizer panorama.
+ * The URL remains separate for backward compatibility with existing charts. */
+interface SeatViewMetadata {
+    projection?: 'equirectangular';
+    coverage?: SeatViewCoverage;
+    /** Optional lightweight first paint. `viewFromSeatUrl` remains the sharp source. */
+    previewUrl?: string;
+    previewWidth?: number;
+    previewHeight?: number;
+    /** Degrees relative to the authored focal/stage direction. */
+    initialBearingDeg?: number;
+    /** Positive looks up. The viewer clamps to its safe pitch range. */
+    initialPitchDeg?: number;
+    capturedAt?: string;
+    /** Buyer-safe provenance, e.g. "Provided by the venue". */
+    sourceLabel?: string;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    captureEyeHeightM?: number;
+    eventConfigurationId?: string;
+}
 interface SeatOverride {
     /** 0-based seat index within the row. */
     index: number;
@@ -146,6 +168,8 @@ interface SeatOverride {
     commercial?: SeatCommercialAttributes;
     /** Seat-specific view photo; falls back to the row photo. */
     viewFromSeatUrl?: string;
+    /** Calibration/truth for `viewFromSeatUrl`; ignored when the URL is absent. */
+    viewFromSeatMeta?: SeatViewMetadata;
     /** Per-seat label size/color override; falls back to the row/theme default.
      *  Size is clamped to LABEL_STYLE_MIN_SIZE..MAX_SIZE; color is passed through
      *  the shared auto-contrast rule at paint time (see {@link LabelStyle}). */
@@ -219,6 +243,19 @@ interface LabelPresentation {
      */
     positionPreset?: 'start' | 'end' | 'both' | 'none';
 }
+/** Persisted authoring ergonomics that must not change buyer inventory or
+ * rendering. Buyer projections strip this object before a chart is served. */
+interface ObjectEditorState {
+    /** Objects sharing this id select and transform as one authoring unit. */
+    groupId?: string;
+    /** Protect canvas geometry while keeping ordinary Inspector properties editable. */
+    locked?: boolean;
+    /** Remove the object from the authoring scene until Reveal hidden is used. */
+    hidden?: boolean;
+}
+interface AuthoringObjectState {
+    editor?: ObjectEditorState;
+}
 /** Brand/venue theming — applied by the renderer in both designer and picker. */
 interface ChartTheme {
     /** Canvas background color (default dark: #0e1117-ish radial). */
@@ -248,7 +285,7 @@ interface ChartTheme {
     /** Paid-tier flag: hide the "Powered by SeatMap" badge. */
     hideBadge?: boolean;
 }
-interface RowObject {
+interface RowObject extends AuthoringObjectState {
     type: 'row';
     id: string;
     /** Present when this row was materialized by the in-canvas reference scan.
@@ -338,6 +375,7 @@ interface RowObject {
         displayType?: string;
         labelPresentation?: LabelPresentation;
         viewFromSeatUrl?: string;
+        viewFromSeatMeta?: SeatViewMetadata;
         /** Presentation intent for a continuous node-defined centreline. */
         smoothing?: boolean;
     };
@@ -413,10 +451,11 @@ interface RowObject {
      * generates a synthetic panorama from chart geometry.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
     /** Default commercial attributes inherited by seats without an override. */
     commercial?: SeatCommercialAttributes;
 }
-interface GAAreaObject {
+interface GAAreaObject extends AuthoringObjectState {
     type: 'gaArea';
     id: string;
     /** Stable technical/inventory label. */
@@ -514,7 +553,7 @@ type ShapeLineCap = 'butt' | 'round' | 'square';
 type ShapeLineJoin = 'miter' | 'round' | 'bevel';
 type ShapeLineEnding = 'none' | 'arrow';
 /** Non-bookable décor: stage, walls, exits. */
-interface ShapeObject {
+interface ShapeObject extends AuthoringObjectState {
     type: 'shape';
     id: string;
     /**
@@ -548,6 +587,14 @@ interface ShapeObject {
     cornerRadius?: number;
     /** Whole-shape opacity 0.1–1 (default 1). */
     opacity?: number;
+    /** Optional physical extrusion height used by the 3D venue renderer. */
+    heightM?: number;
+    /**
+     * Event configurations in which this architecture is present. Absent means
+     * the shape belongs to every configuration; a scoped shape is hidden until
+     * one of these ids is active on the chart or 3D scene input.
+     */
+    eventConfigurationIds?: string[];
     /** Degrees clockwise about the shape's center (default 0). Applied at render time. */
     rotation?: number;
     /**
@@ -574,7 +621,7 @@ interface RectTableSeatCounts {
 /** Seats arranged around a table. Grouped selling is activated only by an
  * event's explicit inventory-model-2 snapshot; model-1 events continue to
  * treat every authored chair as an independent unit. */
-interface TableObject {
+interface TableObject extends AuthoringObjectState {
     type: 'table';
     id: string;
     /** e.g. "T1" — seat labels are `${label}-${n}`. */
@@ -623,7 +670,7 @@ interface TableObject {
     referenceInventorySource?: ReferenceInventorySource;
 }
 /** A booth: one bookable unit rendered as a block (trade shows, VIP boxes). */
-interface BoothObject {
+interface BoothObject extends AuthoringObjectState {
     type: 'booth';
     id: string;
     /** Stable technical/inventory label. */
@@ -657,7 +704,7 @@ interface BoothObject {
  * Renderer: far zoom shows section shapes/labels instead of seats; clicking
  * a section zooms into it.
  */
-interface SectionObject {
+interface SectionObject extends AuthoringObjectState {
     type: 'section';
     id: string;
     label: string;
@@ -675,6 +722,7 @@ interface SectionObject {
      * metadata operation.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
     labelPresentation?: LabelPresentation;
     /**
      * Stable management/inventory identity shared by disconnected visual
@@ -826,11 +874,21 @@ type SelectionLayer = 'interactive' | 'background' | 'foreground' | 'surrounding
  * lockstep with `DECOR_PRESETS`; the selection-layer unit test fails if either
  * vocabulary changes without an explicit routing decision. `reference-focal`
  * is source-backed venue context rather than an authoring-palette preset. */
-declare const SURROUNDINGS_SHAPE_ROLES: readonly ["reference-focal", "bar", "entrance", "exit", "restroom", "screen", "sound", "concession", "coat", "wall"];
+declare const SURROUNDINGS_SHAPE_ROLES: readonly ["reference-focal", "bar", "entrance", "exit", "restroom", "screen", "sound", "concession", "coat", "wall", "rail", "suite", "obstruction"];
 /** Derive an object's selection layer from its type. */
 declare function layerOf(obj: ChartObject): SelectionLayer;
 /** Free-standing text on the chart (aisle names, door labels…). */
-interface TextObject {
+type TextAlignment = 'left' | 'center' | 'right';
+interface TextBackground {
+    color: string;
+    /** Space inside the background in chart units; default 6. */
+    padding?: number;
+    /** Rounded background corners in chart units; default 4. */
+    cornerRadius?: number;
+    /** Background-only opacity multiplied by the text object's overall opacity. */
+    opacity?: number;
+}
+interface TextObject extends AuthoringObjectState {
     type: 'text';
     id: string;
     /** Persisted provenance for objects created from the venue-icon palette. */
@@ -853,6 +911,20 @@ interface TextObject {
     bold?: boolean;
     /** Render slant (default false). Maps to Konva fontStyle italic. */
     italic?: boolean;
+    /** Fixed text-box width in chart units. Absent keeps legacy auto width. */
+    width?: number;
+    /** Horizontal alignment inside a fixed-width text box. */
+    align?: TextAlignment;
+    /** Multiplier over the font's natural line height; default 1.2. */
+    lineHeight?: number;
+    /** Added chart units between glyphs; default 0. */
+    letterSpacing?: number;
+    /** Underline decoration. Absent is off. */
+    underline?: boolean;
+    /** Whole text-object opacity; default 1. */
+    opacity?: number;
+    /** Optional padded background painted behind the exact text box. */
+    background?: TextBackground;
 }
 /**
  * A raster/vector decor graphic drawn IN the chart, beneath the seats and
@@ -863,7 +935,7 @@ interface TextObject {
  * 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 {
+interface DecorImageObject extends AuthoringObjectState {
     type: 'decorImage';
     id: string;
     /** Image or SVG data URL. */
@@ -923,6 +995,7 @@ interface Floor {
      * panorama) applies.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
 }
 interface ReferenceCalibration {
     type: 'two-point';
@@ -1134,6 +1207,8 @@ interface ChartDoc {
     /** The stage / point every seat looks at. Anchors seat-view + sightlines.
      *  Multi-floor: mirrors floor 0; each floor also carries its own focalPoint. */
     focalPoint: Point;
+    /** Active event layout used by configuration-scoped 3D architecture. */
+    eventConfigurationId?: string;
     categories: Category[];
     /** Section groupings for far-zoom navigation + pricing (optional; sections reference by id). */
     zones?: ZoneDef[];
@@ -1168,6 +1243,7 @@ interface ChartDoc {
      * the picker generates a synthetic panorama.
      */
     viewFromSeatUrl?: string;
+    viewFromSeatMeta?: SeatViewMetadata;
 }
 interface ExpandedSeat {
     /** Stable id: `${rowId}:${index}` */
@@ -1203,6 +1279,8 @@ interface ExpandedSeat {
     commercial?: SeatCommercialAttributes;
     /** Organizer-supplied view-from-seat image (inherited from the row). */
     viewUrl?: string;
+    /** Calibration/truth inherited from the same scope that supplied `viewUrl`. */
+    viewMeta?: SeatViewMetadata;
     /** Per-seat label size/color override; absent = inherit the row/theme default. */
     labelStyle?: LabelStyle;
     /**
@@ -1643,4 +1721,4 @@ interface ISeatmapRenderer {
 /** localStorage key the Designer writes and the Picker reads. */
 declare const CHART_STORAGE_KEY = "seatmap.chart";
 
-export { type RenderedGAAreaEvidence 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, type ReferenceCalibration as H, type ISeatmapRenderer as I, type ReferenceCategorySource as J, type ReferenceDerivedScale as K, type LabelStyle as L, type ReferenceInventoryExclusionSource as M, type ReferenceInventorySource as N, type ReferenceScanProposal as O, type Point as P, type ReferenceScanRowProposal as Q, type RowObject as R, type SeatOverride as S, type TableObject as T, type ReferenceScanSectionProposal as U, type ReferenceSeatSeed as V, type ReferenceSectionTraceBatchInput as W, type ReferenceSectionTraceBatchProposal as X, type ReferenceSectionTraceInput as Y, type ReferenceSectionTraceProposal as Z, type RenderedBookableLabelEvidence as _, type RectTableSide as a, type RenderedHierarchyLabelEvidence as a0, type RenderedLabelHiddenReason as a1, SEAT_COMMERCIAL_MARKS as a2, SURROUNDINGS_SHAPE_ROLES as a3, type SeatCommercialMark as a4, type SeatCommercialMeta as a5, type SectionOutlinePath as a6, type SectionPathSegment as a7, type SelectionLayer as a8, type ShapeLineCap as a9, type ShapeLineEnding as aa, type ShapeLineJoin as ab, type ShapeObject as ac, type TextObject as ad, type ZoneDef as ae, accessibilityMeta as af, accessibilityRingColor as ag, layerOf as ah, seatCommercialMeta as ai, type ChartObject as b, type SectionObject as c, type RectTableSeatCounts as d, type GAInventorySegment as e, type RendererQualityEvidence as f, type RenderedFreeTextEvidence as g, type RendererOptions as h, type SeatStatus as i, type RendererViewMode as j, type LodRung as k, type CategoryTier as l, type SeatCommercialAttributes as m, type RendererCallbacks as n, ACCESSIBILITY_RING_COLOR as o, ACCESSIBILITY_TYPES as p, type AccessibilityMeta as q, CHART_STORAGE_KEY as r, type Category as s, type ChartReferenceImage as t, type ChartTheme as u, type CubicPath as v, LABEL_STYLE_MAX_SIZE as w, LABEL_STYLE_MIN_SIZE as x, type LabelPresentation as y, type ReferenceAccessibilitySource as z };
+export { type ReferenceSectionTraceInput 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, type LabelPresentation as H, type ISeatmapRenderer as I, type ReferenceAccessibilitySource as J, type ReferenceCalibration as K, type LabelStyle as L, type ReferenceCategorySource as M, type ReferenceDerivedScale as N, type ObjectEditorState as O, type Point as P, type ReferenceInventoryExclusionSource as Q, type RowObject as R, type SeatOverride as S, type TableObject as T, type ReferenceInventorySource as U, type ReferenceScanProposal as V, type ReferenceScanRowProposal as W, type ReferenceScanSectionProposal as X, type ReferenceSeatSeed as Y, type ReferenceSectionTraceBatchInput as Z, type ReferenceSectionTraceBatchProposal as _, type SeatViewMetadata as a, type ReferenceSectionTraceProposal as a0, type RenderedBookableLabelEvidence as a1, type RenderedGAAreaEvidence as a2, type RenderedHierarchyLabelEvidence as a3, type RenderedLabelHiddenReason as a4, SEAT_COMMERCIAL_MARKS as a5, SURROUNDINGS_SHAPE_ROLES as a6, type SeatCommercialMark as a7, type SeatCommercialMeta as a8, type SeatViewCoverage as a9, type SectionOutlinePath as aa, type SectionPathSegment as ab, type SelectionLayer as ac, type ShapeLineCap as ad, type ShapeLineEnding as ae, type ShapeLineJoin as af, type ShapeObject as ag, type TextAlignment as ah, type TextBackground as ai, type TextObject as aj, type ZoneDef as ak, accessibilityMeta as al, accessibilityRingColor as am, layerOf as an, seatCommercialMeta as ao, type RectTableSide as b, type ChartObject as c, type SectionObject as d, type RectTableSeatCounts as e, type GAInventorySegment as f, type RendererQualityEvidence as g, type RenderedFreeTextEvidence as h, type RendererOptions as i, type SeatStatus as j, type RendererViewMode as k, type LodRung as l, type CategoryTier as m, type SeatCommercialAttributes as n, type RendererCallbacks as o, ACCESSIBILITY_RING_COLOR as p, ACCESSIBILITY_TYPES as q, type AccessibilityMeta as r, type AuthoringObjectState as s, CHART_STORAGE_KEY as t, type Category as u, type ChartReferenceImage as v, type ChartTheme as w, type CubicPath as x, LABEL_STYLE_MAX_SIZE as y, LABEL_STYLE_MIN_SIZE as z };

package/dist/view/panoramaDelivery.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/view/panoramaDelivery.ts
+var panoramaDelivery_exports = {};
+__export(panoramaDelivery_exports, {
+  browserPanoramaConstraints: () => browserPanoramaConstraints,
+  estimatePanoramaTextureBytes: () => estimatePanoramaTextureBytes,
+  loadPanoramaImage: () => loadPanoramaImage,
+  panoramaTextureBudgetBytes: () => panoramaTextureBudgetBytes,
+  planPanoramaDelivery: () => planPanoramaDelivery,
+  schedulePanoramaUpgrade: () => schedulePanoramaUpgrade
+});
+module.exports = __toCommonJS(panoramaDelivery_exports);
+function estimatePanoramaTextureBytes(width, height) {
+  if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return 0;
+  return Math.ceil(width * height * 4 * (4 / 3));
+}
+function panoramaTextureBudgetBytes(deviceMemoryGb) {
+  const mib = deviceMemoryGb !== void 0 && deviceMemoryGb <= 2 ? 32 : deviceMemoryGb !== void 0 && deviceMemoryGb >= 8 ? 192 : 96;
+  return mib * 1024 * 1024;
+}
+function browserPanoramaConstraints(maxTextureSize) {
+  const nav = typeof navigator === "undefined" ? void 0 : navigator;
+  return {
+    saveData: nav?.connection?.saveData === true,
+    maxTextureSize,
+    maxDecodedBytes: panoramaTextureBudgetBytes(nav?.deviceMemory)
+  };
+}
+function planPanoramaDelivery(source, constraints = {}) {
+  const previewUrl = source.previewUrl?.trim();
+  if (!previewUrl || previewUrl === source.url) {
+    return {
+      initialUrl: source.url,
+      initialWidth: source.sourceWidth,
+      initialHeight: source.sourceHeight,
+      reason: "full-only"
+    };
+  }
+  const initial = {
+    initialUrl: previewUrl,
+    initialWidth: source.previewWidth,
+    initialHeight: source.previewHeight
+  };
+  if (constraints.saveData) return { ...initial, reason: "save-data" };
+  if (constraints.maxTextureSize !== void 0 && source.sourceWidth !== void 0 && source.sourceHeight !== void 0 && Math.max(source.sourceWidth, source.sourceHeight) > constraints.maxTextureSize) {
+    return { ...initial, reason: "texture-limit" };
+  }
+  if (constraints.maxDecodedBytes !== void 0 && source.sourceWidth !== void 0 && source.sourceHeight !== void 0 && estimatePanoramaTextureBytes(source.sourceWidth, source.sourceHeight) > constraints.maxDecodedBytes) {
+    return { ...initial, reason: "memory-limit" };
+  }
+  return { ...initial, upgradeUrl: source.url, reason: "progressive" };
+}
+function abortError() {
+  return new DOMException("Panorama image load aborted", "AbortError");
+}
+function loadPanoramaImage(url, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(abortError());
+      return;
+    }
+    const image = new Image();
+    image.crossOrigin = "anonymous";
+    let settled = false;
+    const cleanup = () => {
+      image.onload = null;
+      image.onerror = null;
+      signal?.removeEventListener("abort", onAbort);
+    };
+    const finish = (error) => {
+      if (settled) return;
+      settled = true;
+      cleanup();
+      if (error) reject(error);
+      else resolve(image);
+    };
+    const onAbort = () => {
+      image.src = "";
+      finish(abortError());
+    };
+    image.onload = () => {
+      const decoded = typeof image.decode === "function" ? image.decode() : Promise.resolve();
+      void decoded.then(() => finish(), () => finish());
+    };
+    image.onerror = () => finish(new Error("panorama_image_failed"));
+    signal?.addEventListener("abort", onAbort, { once: true });
+    image.src = url;
+  });
+}
+function schedulePanoramaUpgrade(work) {
+  const host = globalThis;
+  if (host.requestIdleCallback) {
+    const id2 = host.requestIdleCallback(work, { timeout: 1200 });
+    return () => host.cancelIdleCallback?.(id2);
+  }
+  const id = globalThis.setTimeout(work, 32);
+  return () => globalThis.clearTimeout(id);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  browserPanoramaConstraints,
+  estimatePanoramaTextureBytes,
+  loadPanoramaImage,
+  panoramaTextureBudgetBytes,
+  planPanoramaDelivery,
+  schedulePanoramaUpgrade
+});
+//# sourceMappingURL=panoramaDelivery.cjs.map

package/dist/view/panoramaDelivery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/view/panoramaDelivery.ts"],"sourcesContent":["/** Progressive delivery policy shared by the WebGL and DOM panorama viewers. */\n\nexport interface PanoramaDeliverySource {\n  url: string;\n  previewUrl?: string;\n  sourceWidth?: number;\n  sourceHeight?: number;\n  previewWidth?: number;\n  previewHeight?: number;\n}\n\nexport interface PanoramaDeliveryConstraints {\n  saveData?: boolean;\n  maxTextureSize?: number;\n  maxDecodedBytes?: number;\n}\n\nexport interface PanoramaDeliveryPlan {\n  initialUrl: string;\n  upgradeUrl?: string;\n  initialWidth?: number;\n  initialHeight?: number;\n  reason: 'full-only' | 'progressive' | 'save-data' | 'texture-limit' | 'memory-limit';\n}\n\n/** Approximate GPU allocation including a complete mip chain (4/3 overhead). */\nexport function estimatePanoramaTextureBytes(width: number, height: number): number {\n  if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) return 0;\n  return Math.ceil(width * height * 4 * (4 / 3));\n}\n\n/** Conservative per-panorama budget, raised only on devices reporting ample RAM. */\nexport function panoramaTextureBudgetBytes(deviceMemoryGb?: number): number {\n  const mib = deviceMemoryGb !== undefined && deviceMemoryGb <= 2\n    ? 32\n    : deviceMemoryGb !== undefined && deviceMemoryGb >= 8\n      ? 192\n      : 96;\n  return mib * 1024 * 1024;\n}\n\nexport function browserPanoramaConstraints(maxTextureSize?: number): PanoramaDeliveryConstraints {\n  const nav = typeof navigator === 'undefined'\n    ? undefined\n    : navigator as Navigator & { deviceMemory?: number; connection?: { saveData?: boolean } };\n  return {\n    saveData: nav?.connection?.saveData === true,\n    maxTextureSize,\n    maxDecodedBytes: panoramaTextureBudgetBytes(nav?.deviceMemory),\n  };\n}\n\n/** Select the first image and whether a later sharp-image upgrade is safe. */\nexport function planPanoramaDelivery(\n  source: PanoramaDeliverySource,\n  constraints: PanoramaDeliveryConstraints = {},\n): PanoramaDeliveryPlan {\n  const previewUrl = source.previewUrl?.trim();\n  if (!previewUrl || previewUrl === source.url) {\n    return {\n      initialUrl: source.url,\n      initialWidth: source.sourceWidth,\n      initialHeight: source.sourceHeight,\n      reason: 'full-only',\n    };\n  }\n\n  const initial = {\n    initialUrl: previewUrl,\n    initialWidth: source.previewWidth,\n    initialHeight: source.previewHeight,\n  };\n  if (constraints.saveData) return { ...initial, reason: 'save-data' };\n  if (constraints.maxTextureSize !== undefined && source.sourceWidth !== undefined && source.sourceHeight !== undefined\n    && Math.max(source.sourceWidth, source.sourceHeight) > constraints.maxTextureSize) {\n    return { ...initial, reason: 'texture-limit' };\n  }\n  if (constraints.maxDecodedBytes !== undefined && source.sourceWidth !== undefined && source.sourceHeight !== undefined\n    && estimatePanoramaTextureBytes(source.sourceWidth, source.sourceHeight) > constraints.maxDecodedBytes) {\n    return { ...initial, reason: 'memory-limit' };\n  }\n  return { ...initial, upgradeUrl: source.url, reason: 'progressive' };\n}\n\nfunction abortError(): DOMException {\n  return new DOMException('Panorama image load aborted', 'AbortError');\n}\n\n/** Decode before resolving so callers never upload or reveal a partial image. */\nexport function loadPanoramaImage(url: string, signal?: AbortSignal): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) { reject(abortError()); return; }\n    const image = new Image();\n    image.crossOrigin = 'anonymous';\n    let settled = false;\n    const cleanup = (): void => {\n      image.onload = null;\n      image.onerror = null;\n      signal?.removeEventListener('abort', onAbort);\n    };\n    const finish = (error?: unknown): void => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      if (error) reject(error);\n      else resolve(image);\n    };\n    const onAbort = (): void => {\n      image.src = '';\n      finish(abortError());\n    };\n    image.onload = () => {\n      const decoded = typeof image.decode === 'function' ? image.decode() : Promise.resolve();\n      void decoded.then(() => finish(), () => finish());\n    };\n    image.onerror = () => finish(new Error('panorama_image_failed'));\n    signal?.addEventListener('abort', onAbort, { once: true });\n    image.src = url;\n  });\n}\n\n/** Let the preview paint before starting a potentially large decode. */\nexport function schedulePanoramaUpgrade(work: () => void): () => void {\n  const host = globalThis as typeof globalThis & {\n    requestIdleCallback?: (cb: () => void, opts?: { timeout: number }) => number;\n    cancelIdleCallback?: (id: number) => void;\n  };\n  if (host.requestIdleCallback) {\n    const id = host.requestIdleCallback(work, { timeout: 1200 });\n    return () => host.cancelIdleCallback?.(id);\n  }\n  const id = globalThis.setTimeout(work, 32);\n  return () => globalThis.clearTimeout(id);\n}\n"],"mappings":"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","names":["id"]}