@seatlayer/core 0.46.0 → 0.47.0

package/dist/view3d/crossfade/panorama.d.cts

@@ -0,0 +1,110 @@
+import { a9 as SeatViewCoverage } from '../../types-CE63BK0j.cjs';
+
+/**
+ * Slice 3 hand-off — the DOM panorama overlay the fly-to-seat cinematic
+ * dissolves into. Decoupled by design: the CALLER supplies the equirectangular
+ * image (via mountVenue3D's getSeatView), so view3d never imports the app's
+ * panorama generator and the chunk stays lean.
+ *
+ * Technique (mirrors SeatPicker.openSeatView, reimplemented small): an equirect
+ * image panned with `repeat-x`; the initial horizontal offset is set so the
+ * panorama's bearing matches the final camera yaw — the dissolve reads as the
+ * same view sharpening, not a cut. CSS opacity fade is compositor-only.
+ */
+
+interface SeatView {
+    url: string;
+    /** Lightweight equirect used for first paint before `url` replaces it. */
+    previewUrl?: string;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    previewWidth?: number;
+    previewHeight?: number;
+    /**
+     * True when `url` is a SYNTHESISED panorama rather than a real photograph.
+     *
+     * It decides which of two very different things the buyer gets, so the caller
+     * must say rather than the renderer guess. A generated equirect is a picture
+     * of a 3D scene the renderer already has: at 2048×1024 it covers 106° of
+     * horizontal view in ~600 source pixels, which a 3072-device-pixel viewport
+     * magnifies FIVE times, and no amount of art survives that. So a generated
+     * view is not drawn as an image at all — the camera simply looks around the
+     * real scene, which has no resolution ceiling.
+     *
+     * A real photo has no such substitute and goes on the sphere, where a 5760 or
+     * 8192-wide capture has three to four times the detail to give.
+     */
+    generated?: boolean;
+    /** Bearing (deg, 0 = facing the focal/stage) the panorama should open centred
+     * on, to match the camera's final yaw. Default 0 (both face the stage). */
+    initialBearingDeg?: number;
+    /** Initial vertical orientation. Positive looks up; clamped to the viewer's
+     * safe pitch range. Uploaded captures use this to match the live seat pose. */
+    initialPitchDeg?: number;
+    /** How specifically this image represents the selected inventory unit. */
+    coverage?: SeatViewCoverage;
+    /** ISO capture date/time when known. Unknown is preferable to invented age. */
+    capturedAt?: string;
+    /** Optional buyer-safe provenance, for example "Provided by the venue". */
+    sourceLabel?: string;
+}
+/** Honest, compact buyer disclosure for the panorama currently on screen. */
+declare function seatViewDisclosure(view: SeatView): string;
+/** True only when the panorama should be presented as organizer-authored media.
+ * Representative AI demo assets travel through the same URL field as venue
+ * photos, so provenance—not URL presence—must decide the buyer badge. */
+declare function isAuthoredSeatView(view: SeatView): boolean;
+interface PanoramaHandle {
+    /** Fade out and return to the (frozen) 3D view; calls opts.onClose after. */
+    close(): void;
+    /** Immediate teardown (dispose) — no fade, no onClose. */
+    dispose(): void;
+}
+/**
+ * Vertical field of view (deg) the windowed panorama shows. The source image is
+ * a full 180° equirect sphere; showing it raw wastes ~⅔ of the frame on dead sky
+ * and black floor, with the horizon content band squished into the middle. We
+ * instead scale the image so only this central slice fills the viewport height,
+ * horizon-centred, and let the user drag pitch within ±`MAX_PITCH_DEG`.
+ */
+declare const VFOV_DEG = 70;
+declare const MIN_VFOV_DEG = 35;
+declare const MAX_VFOV_DEG = 90;
+/** Keep wheel, keyboard and pinch zoom inside a useful, non-disorienting range. */
+declare function clampPanoramaFov(fovDeg: number): number;
+/** Users may look this far up/down from the horizon; well inside the image so
+ *  the clamp never reveals past its top/bottom edge. */
+declare const MAX_PITCH_DEG = 35;
+/**
+ * Horizontal background-position (px) that centres `bearingDeg` in the viewport,
+ * assuming the equirect image's yaw 0 sits at its horizontal centre. `bgW` is the
+ * full scaled image width representing 360° — so this is invariant to the vertical
+ * FOV windowing (which scales width and height by the same factor). `repeat-x`
+ * handles the wrap, so any real value is valid.
+ */
+declare function bearingToOffsetPx(bearingDeg: number, viewportW: number, bgW: number): number;
+/**
+ * Full scaled image height (px) so that a `vfovDeg`-tall slice fills `viewportH`.
+ * The image spans 180° vertically, so height = viewportH · 180/vfov.
+ */
+declare function windowedBgHeight(viewportH: number, vfovDeg?: number): number;
+/**
+ * background-position Y (px) that centres the image's horizon (its vertical
+ * centre) in the viewport, offset by `pitchPx` (deviation from the horizon,
+ * clamped to ±`MAX_PITCH_DEG`). Positive `pitchPx` looks up.
+ */
+declare function horizonOffsetPy(viewportH: number, bgH: number, pitchPx: number): number;
+/** Clamp a pitch drag (px) to ±MAX_PITCH_DEG of image travel, and never past the
+ *  image edge. `bgH` px map the full 180°, so a degree is `bgH/180` px. */
+declare function clampPitchPx(pitchPx: number, bgH: number): number;
+interface PanoramaOptions {
+    fadeMs?: number;
+    seatLabel?: string;
+    disclosure?: string;
+    onClose?: () => void;
+    /** Cancels stale preview/full-resolution image work when a flight is retargeted. */
+    signal?: AbortSignal;
+}
+declare function mountPanorama(container: HTMLElement, view: SeatView, opts?: PanoramaOptions): PanoramaHandle;
+
+export { MAX_PITCH_DEG, MAX_VFOV_DEG, MIN_VFOV_DEG, type PanoramaHandle, type PanoramaOptions, type SeatView, VFOV_DEG, bearingToOffsetPx, clampPanoramaFov, clampPitchPx, horizonOffsetPy, isAuthoredSeatView, mountPanorama, seatViewDisclosure, windowedBgHeight };

package/dist/view3d/crossfade/panorama.d.ts

@@ -0,0 +1,110 @@
+import { a9 as SeatViewCoverage } from '../../types-CE63BK0j.js';
+
+/**
+ * Slice 3 hand-off — the DOM panorama overlay the fly-to-seat cinematic
+ * dissolves into. Decoupled by design: the CALLER supplies the equirectangular
+ * image (via mountVenue3D's getSeatView), so view3d never imports the app's
+ * panorama generator and the chunk stays lean.
+ *
+ * Technique (mirrors SeatPicker.openSeatView, reimplemented small): an equirect
+ * image panned with `repeat-x`; the initial horizontal offset is set so the
+ * panorama's bearing matches the final camera yaw — the dissolve reads as the
+ * same view sharpening, not a cut. CSS opacity fade is compositor-only.
+ */
+
+interface SeatView {
+    url: string;
+    /** Lightweight equirect used for first paint before `url` replaces it. */
+    previewUrl?: string;
+    sourceWidth?: number;
+    sourceHeight?: number;
+    previewWidth?: number;
+    previewHeight?: number;
+    /**
+     * True when `url` is a SYNTHESISED panorama rather than a real photograph.
+     *
+     * It decides which of two very different things the buyer gets, so the caller
+     * must say rather than the renderer guess. A generated equirect is a picture
+     * of a 3D scene the renderer already has: at 2048×1024 it covers 106° of
+     * horizontal view in ~600 source pixels, which a 3072-device-pixel viewport
+     * magnifies FIVE times, and no amount of art survives that. So a generated
+     * view is not drawn as an image at all — the camera simply looks around the
+     * real scene, which has no resolution ceiling.
+     *
+     * A real photo has no such substitute and goes on the sphere, where a 5760 or
+     * 8192-wide capture has three to four times the detail to give.
+     */
+    generated?: boolean;
+    /** Bearing (deg, 0 = facing the focal/stage) the panorama should open centred
+     * on, to match the camera's final yaw. Default 0 (both face the stage). */
+    initialBearingDeg?: number;
+    /** Initial vertical orientation. Positive looks up; clamped to the viewer's
+     * safe pitch range. Uploaded captures use this to match the live seat pose. */
+    initialPitchDeg?: number;
+    /** How specifically this image represents the selected inventory unit. */
+    coverage?: SeatViewCoverage;
+    /** ISO capture date/time when known. Unknown is preferable to invented age. */
+    capturedAt?: string;
+    /** Optional buyer-safe provenance, for example "Provided by the venue". */
+    sourceLabel?: string;
+}
+/** Honest, compact buyer disclosure for the panorama currently on screen. */
+declare function seatViewDisclosure(view: SeatView): string;
+/** True only when the panorama should be presented as organizer-authored media.
+ * Representative AI demo assets travel through the same URL field as venue
+ * photos, so provenance—not URL presence—must decide the buyer badge. */
+declare function isAuthoredSeatView(view: SeatView): boolean;
+interface PanoramaHandle {
+    /** Fade out and return to the (frozen) 3D view; calls opts.onClose after. */
+    close(): void;
+    /** Immediate teardown (dispose) — no fade, no onClose. */
+    dispose(): void;
+}
+/**
+ * Vertical field of view (deg) the windowed panorama shows. The source image is
+ * a full 180° equirect sphere; showing it raw wastes ~⅔ of the frame on dead sky
+ * and black floor, with the horizon content band squished into the middle. We
+ * instead scale the image so only this central slice fills the viewport height,
+ * horizon-centred, and let the user drag pitch within ±`MAX_PITCH_DEG`.
+ */
+declare const VFOV_DEG = 70;
+declare const MIN_VFOV_DEG = 35;
+declare const MAX_VFOV_DEG = 90;
+/** Keep wheel, keyboard and pinch zoom inside a useful, non-disorienting range. */
+declare function clampPanoramaFov(fovDeg: number): number;
+/** Users may look this far up/down from the horizon; well inside the image so
+ *  the clamp never reveals past its top/bottom edge. */
+declare const MAX_PITCH_DEG = 35;
+/**
+ * Horizontal background-position (px) that centres `bearingDeg` in the viewport,
+ * assuming the equirect image's yaw 0 sits at its horizontal centre. `bgW` is the
+ * full scaled image width representing 360° — so this is invariant to the vertical
+ * FOV windowing (which scales width and height by the same factor). `repeat-x`
+ * handles the wrap, so any real value is valid.
+ */
+declare function bearingToOffsetPx(bearingDeg: number, viewportW: number, bgW: number): number;
+/**
+ * Full scaled image height (px) so that a `vfovDeg`-tall slice fills `viewportH`.
+ * The image spans 180° vertically, so height = viewportH · 180/vfov.
+ */
+declare function windowedBgHeight(viewportH: number, vfovDeg?: number): number;
+/**
+ * background-position Y (px) that centres the image's horizon (its vertical
+ * centre) in the viewport, offset by `pitchPx` (deviation from the horizon,
+ * clamped to ±`MAX_PITCH_DEG`). Positive `pitchPx` looks up.
+ */
+declare function horizonOffsetPy(viewportH: number, bgH: number, pitchPx: number): number;
+/** Clamp a pitch drag (px) to ±MAX_PITCH_DEG of image travel, and never past the
+ *  image edge. `bgH` px map the full 180°, so a degree is `bgH/180` px. */
+declare function clampPitchPx(pitchPx: number, bgH: number): number;
+interface PanoramaOptions {
+    fadeMs?: number;
+    seatLabel?: string;
+    disclosure?: string;
+    onClose?: () => void;
+    /** Cancels stale preview/full-resolution image work when a flight is retargeted. */
+    signal?: AbortSignal;
+}
+declare function mountPanorama(container: HTMLElement, view: SeatView, opts?: PanoramaOptions): PanoramaHandle;
+
+export { MAX_PITCH_DEG, MAX_VFOV_DEG, MIN_VFOV_DEG, type PanoramaHandle, type PanoramaOptions, type SeatView, VFOV_DEG, bearingToOffsetPx, clampPanoramaFov, clampPitchPx, horizonOffsetPy, isAuthoredSeatView, mountPanorama, seatViewDisclosure, windowedBgHeight };

package/dist/view3d/crossfade/panorama.js

@@ -0,0 +1,30 @@
+import {
+  MAX_PITCH_DEG,
+  MAX_VFOV_DEG,
+  MIN_VFOV_DEG,
+  VFOV_DEG,
+  bearingToOffsetPx,
+  clampPanoramaFov,
+  clampPitchPx,
+  horizonOffsetPy,
+  isAuthoredSeatView,
+  mountPanorama,
+  seatViewDisclosure,
+  windowedBgHeight
+} from "../../chunk-FVCOOLJO.js";
+import "../../chunk-AZODENEL.js";
+export {
+  MAX_PITCH_DEG,
+  MAX_VFOV_DEG,
+  MIN_VFOV_DEG,
+  VFOV_DEG,
+  bearingToOffsetPx,
+  clampPanoramaFov,
+  clampPitchPx,
+  horizonOffsetPy,
+  isAuthoredSeatView,
+  mountPanorama,
+  seatViewDisclosure,
+  windowedBgHeight
+};
+//# sourceMappingURL=panorama.js.map

package/dist/view3d/crossfade/panorama.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}