@seatlayer/core 0.54.0 → 0.55.0

package/dist/view3d/index.d.cts

@@ -1,5 +1,5 @@
-import { C as ChartDoc } from '../types-COfJorq_.cjs';
-import { E as ExpandedSeat } from '../renderer-DhUHFtsI.cjs';
+import { C as ChartDoc } from '../types-DTSG6_Hq.cjs';
+import { E as ExpandedSeat } from '../renderer-DySMcKAR.cjs';
 import { SeatView } from './crossfade/panorama.cjs';
 
 /**
@@ -469,6 +469,106 @@ interface RenderLoopStats {
     idle: boolean;
 }
 
+declare const VENUE3D_QUALITY_REPORT_VERSION = 1;
+interface Venue3DLabelEvidence {
+    id: string;
+    kind: LabelKind;
+    text: string;
+    visible: boolean;
+    renderedFontPx: number;
+    contrast: number;
+    screenBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+interface Venue3DFramingEvidence {
+    /** Visible, viewport-clipped venue box in CSS pixels. */
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    horizontalFillRatio: number;
+    verticalFillRatio: number;
+    visibleAreaRatio: number;
+    clippedEdges: Array<'top' | 'right' | 'bottom' | 'left'>;
+}
+interface Venue3DQualityEvidence {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    context: {
+        webgl2: boolean;
+        lost: boolean;
+    };
+    frame: {
+        rendered: number;
+        idle: boolean;
+    };
+    camera: {
+        position: [number, number, number];
+        distance: number;
+        verticalFovDeg: number;
+    };
+    scene: {
+        seatCount: number;
+        floorCount: number;
+        zoneCount: number;
+        sectionCount: number;
+        authoredRelief: boolean;
+        renderedVerticalSpanM: number;
+        projectedReliefPx: number;
+    };
+    labels: Venue3DLabelEvidence[];
+    /** Measured for review; promotion thresholds remain an owner decision. */
+    framing?: Venue3DFramingEvidence;
+}
+type Venue3DQualityFindingCode = 'webgl2-unavailable' | 'context-lost' | 'frame-not-stable' | 'viewport-empty' | 'camera-invalid' | 'authored-relief-not-visible' | 'hierarchy-label-missing' | 'hierarchy-label-undersized' | 'hierarchy-label-contrast-low' | 'hierarchy-label-collision';
+interface Venue3DQualityFinding {
+    code: Venue3DQualityFindingCode;
+    message: string;
+    count: number;
+    samples: Array<{
+        primaryId: string;
+        primaryLabel: string;
+        secondaryId?: string;
+        measured?: number;
+        minimum?: number;
+    }>;
+}
+interface Venue3DQualityReport {
+    version: typeof VENUE3D_QUALITY_REPORT_VERSION;
+    state: 'venue3d';
+    passed: boolean;
+    resolvedRules: string[];
+    viewport: Venue3DQualityEvidence['viewport'];
+    context: Venue3DQualityEvidence['context'];
+    frame: Venue3DQualityEvidence['frame'];
+    camera: Venue3DQualityEvidence['camera'];
+    scene: Venue3DQualityEvidence['scene'];
+    composition: {
+        visibleLabels: Array<{
+            id: string;
+            kind: LabelKind;
+            text: string;
+        }>;
+        framing?: Venue3DFramingEvidence;
+    };
+    metrics: {
+        minimumHierarchyFontPx: number | null;
+        minimumHierarchyContrast: number | null;
+        projectedReliefPx: number;
+    };
+    findings: Venue3DQualityFinding[];
+}
+/** Inspect the actual parked WebGL scene, projected camera, and DOM label overlay. */
+declare function inspectVenue3DQualityEvidence(evidence: Venue3DQualityEvidence): Venue3DQualityReport;
+
 /**
  * The public contract of the lazy venue-view chunk: what you mount it with
  * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
@@ -528,6 +628,9 @@ interface Venue3DOptions {
      * contain framing; validated for the buyer across `/dev/3d` fixtures.
      */
     portraitOverviewCrop?: boolean;
+    /** Start on the final overview pose without the decorative stand-up intro.
+     * Intended for deterministic rendered review and screenshot capture. */
+    skipInitialOverviewAnimation?: boolean;
 }
 interface Venue3DStats extends RenderLoopStats {
     drawCalls: number;
@@ -548,6 +651,9 @@ interface Venue3DHandle {
     focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
+    /** Machine-readable evidence from the exact parked WebGL frame and DOM labels. */
+    getQualityEvidence(): Venue3DQualityEvidence;
+    getQualityReport(): Venue3DQualityReport;
     loseContextForTest(): void;
     /** Test hook: force (or clear) the reduced-motion path. */
     setReducedMotionForTest(value: boolean | null): void;
@@ -609,4 +715,4 @@ interface Venue3DHandle {
 
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
-export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D, prepareVenue3D };
+export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, VENUE3D_QUALITY_REPORT_VERSION, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DQualityEvidence, type Venue3DQualityReport, type Venue3DStats, buildSceneModel, inspectVenue3DQualityEvidence, mountVenue3D, prepareVenue3D };

package/dist/view3d/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ChartDoc } from '../types-COfJorq_.js';
-import { E as ExpandedSeat } from '../renderer-IBi9YKWR.js';
+import { C as ChartDoc } from '../types-DTSG6_Hq.js';
+import { E as ExpandedSeat } from '../renderer-B_g-W_QB.js';
 import { SeatView } from './crossfade/panorama.js';
 
 /**
@@ -469,6 +469,106 @@ interface RenderLoopStats {
     idle: boolean;
 }
 
+declare const VENUE3D_QUALITY_REPORT_VERSION = 1;
+interface Venue3DLabelEvidence {
+    id: string;
+    kind: LabelKind;
+    text: string;
+    visible: boolean;
+    renderedFontPx: number;
+    contrast: number;
+    screenBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+interface Venue3DFramingEvidence {
+    /** Visible, viewport-clipped venue box in CSS pixels. */
+    box: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    horizontalFillRatio: number;
+    verticalFillRatio: number;
+    visibleAreaRatio: number;
+    clippedEdges: Array<'top' | 'right' | 'bottom' | 'left'>;
+}
+interface Venue3DQualityEvidence {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    context: {
+        webgl2: boolean;
+        lost: boolean;
+    };
+    frame: {
+        rendered: number;
+        idle: boolean;
+    };
+    camera: {
+        position: [number, number, number];
+        distance: number;
+        verticalFovDeg: number;
+    };
+    scene: {
+        seatCount: number;
+        floorCount: number;
+        zoneCount: number;
+        sectionCount: number;
+        authoredRelief: boolean;
+        renderedVerticalSpanM: number;
+        projectedReliefPx: number;
+    };
+    labels: Venue3DLabelEvidence[];
+    /** Measured for review; promotion thresholds remain an owner decision. */
+    framing?: Venue3DFramingEvidence;
+}
+type Venue3DQualityFindingCode = 'webgl2-unavailable' | 'context-lost' | 'frame-not-stable' | 'viewport-empty' | 'camera-invalid' | 'authored-relief-not-visible' | 'hierarchy-label-missing' | 'hierarchy-label-undersized' | 'hierarchy-label-contrast-low' | 'hierarchy-label-collision';
+interface Venue3DQualityFinding {
+    code: Venue3DQualityFindingCode;
+    message: string;
+    count: number;
+    samples: Array<{
+        primaryId: string;
+        primaryLabel: string;
+        secondaryId?: string;
+        measured?: number;
+        minimum?: number;
+    }>;
+}
+interface Venue3DQualityReport {
+    version: typeof VENUE3D_QUALITY_REPORT_VERSION;
+    state: 'venue3d';
+    passed: boolean;
+    resolvedRules: string[];
+    viewport: Venue3DQualityEvidence['viewport'];
+    context: Venue3DQualityEvidence['context'];
+    frame: Venue3DQualityEvidence['frame'];
+    camera: Venue3DQualityEvidence['camera'];
+    scene: Venue3DQualityEvidence['scene'];
+    composition: {
+        visibleLabels: Array<{
+            id: string;
+            kind: LabelKind;
+            text: string;
+        }>;
+        framing?: Venue3DFramingEvidence;
+    };
+    metrics: {
+        minimumHierarchyFontPx: number | null;
+        minimumHierarchyContrast: number | null;
+        projectedReliefPx: number;
+    };
+    findings: Venue3DQualityFinding[];
+}
+/** Inspect the actual parked WebGL scene, projected camera, and DOM label overlay. */
+declare function inspectVenue3DQualityEvidence(evidence: Venue3DQualityEvidence): Venue3DQualityReport;
+
 /**
  * The public contract of the lazy venue-view chunk: what you mount it with
  * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
@@ -528,6 +628,9 @@ interface Venue3DOptions {
      * contain framing; validated for the buyer across `/dev/3d` fixtures.
      */
     portraitOverviewCrop?: boolean;
+    /** Start on the final overview pose without the decorative stand-up intro.
+     * Intended for deterministic rendered review and screenshot capture. */
+    skipInitialOverviewAnimation?: boolean;
 }
 interface Venue3DStats extends RenderLoopStats {
     drawCalls: number;
@@ -548,6 +651,9 @@ interface Venue3DHandle {
     focusOverview(): void;
     resize(): void;
     stats(): Venue3DStats;
+    /** Machine-readable evidence from the exact parked WebGL frame and DOM labels. */
+    getQualityEvidence(): Venue3DQualityEvidence;
+    getQualityReport(): Venue3DQualityReport;
     loseContextForTest(): void;
     /** Test hook: force (or clear) the reduced-motion path. */
     setReducedMotionForTest(value: boolean | null): void;
@@ -609,4 +715,4 @@ interface Venue3DHandle {
 
 declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
 
-export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DStats, buildSceneModel, mountVenue3D, prepareVenue3D };
+export { type Analytics3DCallback, type Scene3DPrepSource, type SeatState3D, SeatView, VENUE3D_QUALITY_REPORT_VERSION, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DQualityEvidence, type Venue3DQualityReport, type Venue3DStats, buildSceneModel, inspectVenue3DQualityEvidence, mountVenue3D, prepareVenue3D };