@seatlayer/core 0.110.1 → 0.111.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/dist/ar-IOQUWTKM.js +1 -0
  2. package/dist/be-XLR5WTXS.js +1 -0
  3. package/dist/bg-AVCWLASZ.js +1 -0
  4. package/dist/ca-TKG35ICB.js +1 -0
  5. package/dist/{chunk-5IADCFUU.js → chunk-5FIX35HN.js} +1 -1
  6. package/dist/{chunk-6CBJBESS.js → chunk-5GHPGPWE.js} +1 -1
  7. package/dist/{chunk-GWGWNBGU.js → chunk-AZWAP4OE.js} +1 -1
  8. package/dist/chunk-BXQQKDIX.js +1 -0
  9. package/dist/{chunk-NVAF2E7Q.js → chunk-FZ74MVKY.js} +1 -1
  10. package/dist/{chunk-GVVZR3YS.js → chunk-MN4M5QZ4.js} +1 -1
  11. package/dist/chunk-N6K5NQYG.js +1 -0
  12. package/dist/{chunk-2VYFNNYC.js → chunk-NQLQNJV2.js} +1 -1
  13. package/dist/{chunk-ZY6WTPTI.js → chunk-NXS6JFBI.js} +1 -1
  14. package/dist/{chunk-DLHW3UDD.js → chunk-XWTAFHYQ.js} +1 -1
  15. package/dist/{chunk-YRDOE3N7.js → chunk-Z6YGWTT3.js} +1 -1
  16. package/dist/core/chart-ops/index.cjs +1 -1
  17. package/dist/core/chart-ops/index.d.cts +1 -1
  18. package/dist/core/chart-ops/index.d.ts +1 -1
  19. package/dist/core/chart-ops/index.js +1 -1
  20. package/dist/core/inventory/index.cjs +1 -1
  21. package/dist/core/inventory/index.js +1 -1
  22. package/dist/core/layout/index.cjs +1 -1
  23. package/dist/core/layout/index.js +1 -1
  24. package/dist/core/sections/index.js +1 -1
  25. package/dist/cs-JRLKXXM5.js +1 -0
  26. package/dist/cy-W3CYXTOV.js +1 -0
  27. package/dist/da-HG4PFYWH.js +1 -0
  28. package/dist/de-KOM2AXXJ.js +1 -0
  29. package/dist/el-NBRQ66EQ.js +1 -0
  30. package/dist/es-AVEG4ZNM.js +1 -0
  31. package/dist/et-33PIOTI4.js +1 -0
  32. package/dist/fa-CDV2VTXV.js +1 -0
  33. package/dist/fi-TKATIOE6.js +1 -0
  34. package/dist/fr-TMDNSR5N.js +1 -0
  35. package/dist/he-4G7OVLJX.js +1 -0
  36. package/dist/hi-XKXNYPYF.js +1 -0
  37. package/dist/hr-BX444QNM.js +1 -0
  38. package/dist/hu-FM46JMDP.js +1 -0
  39. package/dist/id-CBVTYGFP.js +1 -0
  40. package/dist/index.cjs +1 -1
  41. package/dist/index.d.cts +33 -25
  42. package/dist/index.d.ts +33 -25
  43. package/dist/index.js +1 -1
  44. package/dist/it-ZOFOAG6E.js +1 -0
  45. package/dist/ja-NKEBMXTO.js +1 -0
  46. package/dist/ko-RUCELYV7.js +1 -0
  47. package/dist/ku-KKYBDVSA.js +1 -0
  48. package/dist/localeLoaders-YQXZZVNH.js +1 -0
  49. package/dist/lt-3CJ37W7A.js +1 -0
  50. package/dist/lv-H37RDMRX.js +1 -0
  51. package/dist/ms-E5RVBRE6.js +1 -0
  52. package/dist/nl-QHEOTQ7U.js +1 -0
  53. package/dist/no-43HJQ5MK.js +1 -0
  54. package/dist/pl-4LKJHMFJ.js +1 -0
  55. package/dist/pt-LSSE5QHE.js +1 -0
  56. package/dist/ro-U2QASPIY.js +1 -0
  57. package/dist/ru-PTMWREXY.js +1 -0
  58. package/dist/sk-AY2N2ORA.js +1 -0
  59. package/dist/sl-5MQJVNB7.js +1 -0
  60. package/dist/sr-25FTJPUA.js +1 -0
  61. package/dist/{stage-CKb7aNoH.d.cts → stage-BtqKu5aX.d.cts} +1 -1
  62. package/dist/{stage-CKb7aNoH.d.ts → stage-BtqKu5aX.d.ts} +1 -1
  63. package/dist/sv-7VQX4BFH.js +1 -0
  64. package/dist/th-E53HQMDC.js +1 -0
  65. package/dist/tr-IIR6E7OD.js +1 -0
  66. package/dist/uk-HBINQ4XE.js +1 -0
  67. package/dist/vi-TX6I5RWN.js +1 -0
  68. package/dist/view3d/index.cjs +195 -77
  69. package/dist/view3d/index.d.cts +259 -78
  70. package/dist/view3d/index.d.ts +259 -78
  71. package/dist/view3d/index.js +193 -75
  72. package/dist/view3d/scene/scene.worker.cjs +1 -1
  73. package/dist/view3d/scene/scene.worker.js +1 -1
  74. package/dist/zh-Hans-7QNBTEYC.js +1 -0
  75. package/dist/zh-Hant-6KK3D42X.js +1 -0
  76. package/package.json +1 -1
  77. package/dist/ar-C5PA2DVE.js +0 -1
  78. package/dist/be-TMKSMYPN.js +0 -1
  79. package/dist/bg-V6HTEDUB.js +0 -1
  80. package/dist/ca-CTZMHWW4.js +0 -1
  81. package/dist/chunk-3V32MDJI.js +0 -1
  82. package/dist/chunk-4AGC7B64.js +0 -1
  83. package/dist/cs-FUDGOUFL.js +0 -1
  84. package/dist/cy-5RRARIAP.js +0 -1
  85. package/dist/da-PONPPWKY.js +0 -1
  86. package/dist/de-PKG7AAB5.js +0 -1
  87. package/dist/el-H7OFU4QQ.js +0 -1
  88. package/dist/es-QSW5IZ6U.js +0 -1
  89. package/dist/et-GTMPSS72.js +0 -1
  90. package/dist/fa-SGLTFGJF.js +0 -1
  91. package/dist/fi-7YTEAVDM.js +0 -1
  92. package/dist/fr-ECCQ24MZ.js +0 -1
  93. package/dist/he-YHMMDOX7.js +0 -1
  94. package/dist/hi-GRAQX2E6.js +0 -1
  95. package/dist/hr-MN33LRIJ.js +0 -1
  96. package/dist/hu-NW3SMQVM.js +0 -1
  97. package/dist/id-3OPRAUF7.js +0 -1
  98. package/dist/it-RYM74YWO.js +0 -1
  99. package/dist/ja-4NI6DG5D.js +0 -1
  100. package/dist/ko-C4F6UEMK.js +0 -1
  101. package/dist/ku-DMSBMWTC.js +0 -1
  102. package/dist/localeLoaders-G3GCGLPW.js +0 -1
  103. package/dist/lt-3EXKKZFG.js +0 -1
  104. package/dist/lv-4EWNRDCG.js +0 -1
  105. package/dist/ms-7LJBSAEJ.js +0 -1
  106. package/dist/nl-GWTIWXRW.js +0 -1
  107. package/dist/no-T3FW2WLX.js +0 -1
  108. package/dist/pl-OG5OBRHR.js +0 -1
  109. package/dist/pt-YQ6VES5R.js +0 -1
  110. package/dist/ro-VK5MASYF.js +0 -1
  111. package/dist/ru-YU5CYR6T.js +0 -1
  112. package/dist/sk-CE7PXAYL.js +0 -1
  113. package/dist/sl-EYUPV4BG.js +0 -1
  114. package/dist/sr-PPXCN4IK.js +0 -1
  115. package/dist/sv-WR2BJBCJ.js +0 -1
  116. package/dist/th-JUB2DODR.js +0 -1
  117. package/dist/tr-GFHA7FT6.js +0 -1
  118. package/dist/uk-3FTS2SRK.js +0 -1
  119. package/dist/vi-7OTXPOQV.js +0 -1
  120. package/dist/zh-Hans-FD4XNYUA.js +0 -1
  121. package/dist/zh-Hant-7TXVJKJQ.js +0 -1
@@ -1,9 +1,127 @@
1
1
  import { P as Point, C as ChartDoc } from '../types-CGOr0BpE.cjs';
2
2
  import { E as EventConfigurationProductionElementKind, a as EventConfigurationOcclusion, b as EventConfigurationVersion } from '../eventConfigurations-D0us5j0K.cjs';
3
3
  import { E as ExpandedSeat } from '../renderer-DM2sv1un.cjs';
4
- import { S as StageKind } from '../stage-CKb7aNoH.cjs';
4
+ import { S as StageKind } from '../stage-BtqKu5aX.cjs';
5
5
  import { SeatView } from './crossfade/panorama.cjs';
6
6
 
7
+ /**
8
+ * Venue labels — anchors, level-of-detail, and world→screen projection.
9
+ *
10
+ * ## Why labels are DOM, not geometry
11
+ *
12
+ * The renderer is deliberately texture-free at three draw calls. Drawing text on
13
+ * the GPU means a signed-distance font atlas: a texture, another shader, a build
14
+ * asset, and a resolution ceiling — a lot of machinery for the few dozen labels a
15
+ * venue actually needs. Projecting anchors and positioning DOM elements costs
16
+ * nothing when a chart has no labels, and buys properties the GPU path cannot:
17
+ *
18
+ * - **Real text.** A screen reader can read the venue's structure. That is the
19
+ * accessibility gap in 3D, not just a rendering convenience.
20
+ * - Crisp at any device pixel ratio and any zoom, with no atlas to outgrow.
21
+ * - `ChartTheme.fontFamily`, i18n and RTL come from the browser.
22
+ *
23
+ * This module is the pure half — what to label, where its anchor sits, and when
24
+ * it should show. The overlay that positions elements lives in `index.ts`.
25
+ *
26
+ * ## Why the rungs mirror 2D
27
+ *
28
+ * 2D melts through zones → sections → seats. Labels follow the same idea for the
29
+ * same reason: at a distance a buyer needs to know which part of the venue they
30
+ * are looking at, and up close they need to know which block and which door. A
31
+ * label set that does not thin out with distance turns a 51-section arena into
32
+ * unreadable confetti.
33
+ */
34
+
35
+ type LabelKind = 'floor' | 'stage' | 'zone' | 'section' | 'ga' | 'gate' | 'annotation' | 'booth' | 'row' | 'seat' | 'access';
36
+ interface SceneLabel {
37
+ id: string;
38
+ kind: LabelKind;
39
+ text: string;
40
+ /** World-metre anchor the label is pinned to. */
41
+ anchor: [number, number, number];
42
+ /** Authored colour (`#rrggbb`), when the object carries one. */
43
+ color?: string;
44
+ /** Physical chair width, used to reveal numbers only at readable scale. */
45
+ seatWidthM?: number;
46
+ /** Authored rotation in degrees, for annotations that specify one. */
47
+ rotation?: number;
48
+ /** Owning physical level, so a focused floor never keeps another level's text. */
49
+ floorIndex?: number;
50
+ /** A picked seat's pin base (scene/seatPin): its tag rides the pin's stem. */
51
+ pinBase?: [number, number, number];
52
+ /** A seat label's row, so the row under the pointer can show its numbers. */
53
+ rowId?: string;
54
+ /** An `access` label's pictogram (a seat-type icon key, e.g. `wheelchair`). */
55
+ icon?: string;
56
+ /** An authored venue icon's registry key: its annotation wears the map badge. */
57
+ venueIcon?: string;
58
+ /** A gate with step-free access: its sign leads with the wheelchair mark. */
59
+ stepFree?: boolean;
60
+ /** Icon ink on an `access` chip; white when absent. */
61
+ ink?: string;
62
+ /**
63
+ * A section tag's category colour (the one most of its seats sell in), so
64
+ * the tag reads as its price band before it is read, as on seats.io's
65
+ * stadium (owner comparison, 2026-09-25).
66
+ */
67
+ tint?: string;
68
+ /** A section tag's wheelchair places, as seat instance indices, for its free-count badge. */
69
+ wheelchairSeats?: number[];
70
+ /**
71
+ * A standing area's tag: how many places the buyer has chosen there (the 2D
72
+ * map's count chip), and whether the 2D map would dim it: sold out, closed
73
+ * to this buyer, or filtered out. Set from the host's `setAreaStates`.
74
+ */
75
+ count?: number;
76
+ muted?: boolean;
77
+ /** A standing area's name alone ('' when the chart hides it), so its state can follow it in place of the capacity. */
78
+ areaName?: string;
79
+ }
80
+
81
+ /** A standing area's floor, as the scene model keeps it for taps. */
82
+ interface PickArea {
83
+ /** The chart object's id: what the host's chooser is opened for. */
84
+ id: string;
85
+ /** Outline and holes, chart units. */
86
+ points: readonly Point[];
87
+ holes?: readonly (readonly Point[])[];
88
+ /** Top of the area's deck, world metres. */
89
+ floorY: number;
90
+ floorIndex: number;
91
+ }
92
+ /**
93
+ * A standing area's live state, pushed by the host (`Venue3DHandle.setAreaStates`).
94
+ *
95
+ * It is the record the 2D map takes (`GAAreaState`: `available`, `selected`,
96
+ * `wheelchairFree`) with the two things the 2D map works out for itself and
97
+ * this engine cannot: the words, and whether the host's price filter leaves
98
+ * the area out. From these the 3D view applies the 2D map's own rules
99
+ * (engine/render/gaPaint.ts), so an area is closed, quiet and worded in 3D
100
+ * exactly when it is in 2D.
101
+ */
102
+ interface AreaState3D {
103
+ /** Places still free. `0` is sold out. Absent = no live count yet: the tag keeps its capacity. */
104
+ available?: number;
105
+ /** Places this buyer has chosen or holds here: the tag carries the count. */
106
+ selected?: number;
107
+ /**
108
+ * Wheelchair filter on: the wheelchair places this buyer can take here.
109
+ * `0` with places still free is closed to THIS buyer: drawn quiet, but the
110
+ * tap is still reported, and the host answers it ("No wheelchair space"),
111
+ * as on the 2D map. `null` or absent = filter off.
112
+ */
113
+ wheelchairFree?: number | null;
114
+ /** The host's price or category filter leaves this area out: drawn quiet and not for sale from the view until the filter is cleared. */
115
+ filteredOut?: boolean;
116
+ /**
117
+ * What the tag says after the area's name, in the buyer's language, in place
118
+ * of the capacity: the 2D map's second line ("480 LEFT", "SOLD OUT", "NO
119
+ * WHEELCHAIR SPACE"). The host owns the words (this engine has none) and
120
+ * sends them with every state that has a live count; `''` for one that has not.
121
+ */
122
+ statusText: string;
123
+ }
124
+
7
125
  /**
8
126
  * view3d palette + seat-state model — the single source of colour truth for the
9
127
  * OGL venue view. Pure data (no GPU, no DOM) so the scene builder and the unit
@@ -48,6 +166,38 @@ declare const STRUCTURE: {
48
166
  readonly tableWall: RGB;
49
167
  };
50
168
 
169
+ /**
170
+ * The people in a standing area: where each one stands, which way they face,
171
+ * how tall they are and what they wear.
172
+ *
173
+ * A standing area was an empty floor (demo walk, 2026-11-13). It now holds a
174
+ * crowd drawn from its own outline and capacity: no chart field is added, and
175
+ * a chart with no standing area gets none of this. The crowd shows the area's
176
+ * CAPACITY, never live sales.
177
+ *
178
+ * Placement only: pure numbers out, drawn by `crowdFigures.ts`. Nothing here
179
+ * is in a tap pass, so a crowd can never take or block a tap.
180
+ *
181
+ * The same chart gives the same crowd on every machine. Which places are used
182
+ * is decided by an integer hash; inside-or-outside and every distance use add,
183
+ * multiply, divide and square root only. No `Math.random`, no library trig:
184
+ * a last-bit difference between two CPUs' `sin` once turned a whole stand
185
+ * round (view3dTierDirection, 2026-08-17).
186
+ */
187
+
188
+ /** Per-figure buffers, one entry per figure. Eight floats a figure. */
189
+ interface StandingCrowd {
190
+ count: number;
191
+ /** Feet, world metres (x, y, z). */
192
+ iPosition: Float32Array;
193
+ /** Unit vector the figure faces, world (x, z). */
194
+ iFacing: Float32Array;
195
+ iHeight: Float32Array;
196
+ /** `hair * 32 + clothes * 4 + skin`: one of each, by index. */
197
+ iTone: Float32Array;
198
+ iFloor: Float32Array;
199
+ }
200
+
51
201
  /**
52
202
  * Pure geometry primitives for the view3d scene — no OGL, no DOM, so the whole
53
203
  * scene-model builder is unit-testable in a plain runtime.
@@ -203,71 +353,6 @@ interface Theme3D {
203
353
  } | null;
204
354
  }
205
355
 
206
- /**
207
- * Venue labels — anchors, level-of-detail, and world→screen projection.
208
- *
209
- * ## Why labels are DOM, not geometry
210
- *
211
- * The renderer is deliberately texture-free at three draw calls. Drawing text on
212
- * the GPU means a signed-distance font atlas: a texture, another shader, a build
213
- * asset, and a resolution ceiling — a lot of machinery for the few dozen labels a
214
- * venue actually needs. Projecting anchors and positioning DOM elements costs
215
- * nothing when a chart has no labels, and buys properties the GPU path cannot:
216
- *
217
- * - **Real text.** A screen reader can read the venue's structure. That is the
218
- * accessibility gap in 3D, not just a rendering convenience.
219
- * - Crisp at any device pixel ratio and any zoom, with no atlas to outgrow.
220
- * - `ChartTheme.fontFamily`, i18n and RTL come from the browser.
221
- *
222
- * This module is the pure half — what to label, where its anchor sits, and when
223
- * it should show. The overlay that positions elements lives in `index.ts`.
224
- *
225
- * ## Why the rungs mirror 2D
226
- *
227
- * 2D melts through zones → sections → seats. Labels follow the same idea for the
228
- * same reason: at a distance a buyer needs to know which part of the venue they
229
- * are looking at, and up close they need to know which block and which door. A
230
- * label set that does not thin out with distance turns a 51-section arena into
231
- * unreadable confetti.
232
- */
233
-
234
- type LabelKind = 'floor' | 'stage' | 'zone' | 'section' | 'ga' | 'gate' | 'annotation' | 'booth' | 'row' | 'seat' | 'access';
235
- interface SceneLabel {
236
- id: string;
237
- kind: LabelKind;
238
- text: string;
239
- /** World-metre anchor the label is pinned to. */
240
- anchor: [number, number, number];
241
- /** Authored colour (`#rrggbb`), when the object carries one. */
242
- color?: string;
243
- /** Physical chair width, used to reveal numbers only at readable scale. */
244
- seatWidthM?: number;
245
- /** Authored rotation in degrees, for annotations that specify one. */
246
- rotation?: number;
247
- /** Owning physical level, so a focused floor never keeps another level's text. */
248
- floorIndex?: number;
249
- /** A picked seat's pin base (scene/seatPin): its tag rides the pin's stem. */
250
- pinBase?: [number, number, number];
251
- /** A seat label's row, so the row under the pointer can show its numbers. */
252
- rowId?: string;
253
- /** An `access` label's pictogram (a seat-type icon key, e.g. `wheelchair`). */
254
- icon?: string;
255
- /** An authored venue icon's registry key: its annotation wears the map badge. */
256
- venueIcon?: string;
257
- /** A gate with step-free access: its sign leads with the wheelchair mark. */
258
- stepFree?: boolean;
259
- /** Icon ink on an `access` chip; white when absent. */
260
- ink?: string;
261
- /**
262
- * A section tag's category colour (the one most of its seats sell in), so
263
- * the tag reads as its price band before it is read, as on seats.io's
264
- * stadium (owner comparison, 2026-09-25).
265
- */
266
- tint?: string;
267
- /** A section tag's wheelchair places, as seat instance indices, for its free-count badge. */
268
- wheelchairSeats?: number[];
269
- }
270
-
271
356
  /**
272
357
  * The house: the room an indoor venue is seen in from inside.
273
358
  *
@@ -296,6 +381,12 @@ interface HouseBounds {
296
381
  radii: [number, number];
297
382
  floorY: number;
298
383
  ceilingY: number;
384
+ /**
385
+ * The room of a chart that draws a theatre stage (theatreStage.ts): its wall is painted
386
+ * with pilasters, wall lights, a dado and a cornice. Paint on the backdrop
387
+ * like the rest of the room; nothing stands in it.
388
+ */
389
+ theatre?: boolean;
299
390
  }
300
391
 
301
392
  /**
@@ -516,6 +607,20 @@ interface SceneModel {
516
607
  */
517
608
  sectionSolidRanges: SectionSolidRange[];
518
609
  seats: SeatInstanceData;
610
+ /** The people in the standing areas; absent when the chart has none, or the crowd is off. */
611
+ crowd?: StandingCrowd;
612
+ /**
613
+ * Every standing area's floor, for taps (interaction/areaUnderPointer.ts).
614
+ * Kept whether or not a crowd is drawn; absent on older prepared models and
615
+ * on a chart with no standing area.
616
+ */
617
+ areas?: PickArea[];
618
+ /**
619
+ * Each standing area's slice of the merged solid buffer (`sectionId` holds
620
+ * the AREA's id), so a sold-out floor can be drawn quieter the way a
621
+ * filtered-out section's shell is. See `GpuScene.setAreaFloorsQuiet`.
622
+ */
623
+ areaSolidRanges?: SectionSolidRange[];
519
624
  /** Physical section ownership in input-seat order; absent on older prepared models. */
520
625
  seatSectionIds?: Array<string | null>;
521
626
  bounds: {
@@ -608,6 +713,10 @@ interface SceneModelInput {
608
713
  registeredShellGlb?: ArrayBuffer;
609
714
  /** Optional initial per-seat state (default all available). */
610
715
  initialState?: (seat: ExpandedSeat) => SeatState3D;
716
+ /** Most figures a standing crowd may hold; 0 draws none. Default: as many as the limits allow. Always held to what `crowdSeatCeiling` leaves room for. */
717
+ crowdFigures?: number;
718
+ /** The host's 3D seat ceiling: figures count toward it with the seats. Default: this device's (standingCrowd.ts). */
719
+ crowdSeatCeiling?: number;
611
720
  }
612
721
 
613
722
  declare function buildSceneModel(input: SceneModelInput): SceneModel;
@@ -718,6 +827,10 @@ interface PrepareVenue3DInput {
718
827
  registeredShellGlb?: ArrayBuffer;
719
828
  /** False renders the chart exactly as saved, with no estimated heights. */
720
829
  estimate?: boolean;
830
+ /** Most figures a standing crowd may hold; 0 draws none. Default: as many as the device limits allow. */
831
+ crowdFigures?: number;
832
+ /** The host's 3D seat ceiling (the picker's `max3DSeats`): figures count toward it. Default: this device's. */
833
+ crowdSeatCeiling?: number;
721
834
  }
722
835
  type PrepareVenue3DFromChartInput = Omit<PrepareVenue3DInput, 'seats'>;
723
836
  /** Designer-friendly result: expansion and scene compilation both happened
@@ -902,17 +1015,6 @@ interface Venue3DQualityReport {
902
1015
  /** Inspect the actual parked WebGL scene, projected camera, and DOM label overlay. */
903
1016
  declare function inspectVenue3DQualityEvidence(evidence: Venue3DQualityEvidence): Venue3DQualityReport;
904
1017
 
905
- /**
906
- * The public contract of the lazy venue-view chunk: what you mount it with
907
- * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
908
- * back (`Venue3DHandle`).
909
- *
910
- * Split out of `index.ts` so the mount closure and the UI/interaction modules
911
- * can share them without importing the entry. `index.ts` re-exports all four —
912
- * that is the path the SDK (`@seatlayer/core/view3d`), the picker, the designer
913
- * preview and the harness import from, and it must never move.
914
- */
915
-
916
1018
  interface Venue3DInput {
917
1019
  doc: ChartDoc;
918
1020
  /** Expanded seats (from `expandChart`) — carry x/y + resolved eyeHeightM. */
@@ -928,7 +1030,26 @@ interface Venue3DInput {
928
1030
  /** False renders the chart exactly as saved, with no estimated heights.
929
1031
  * Ignored with `prepared`, which already made that choice. */
930
1032
  estimate?: boolean;
1033
+ /** Most figures a standing crowd may hold; 0 draws none: the crowd's off switch.
1034
+ * It is further held to what `crowdSeatCeiling` leaves room for, to 6,000
1035
+ * (2,000 on a small device). Default: as many as those limits allow; there is
1036
+ * no other way to turn the crowd off. Ignored with `prepared`, which already made that choice. */
1037
+ crowdFigures?: number;
1038
+ /** The host's 3D seat ceiling (the picker's `max3DSeats`): figures count toward
1039
+ * it with the seats, so a crowd is thinned or dropped to fit. Default: this device's. */
1040
+ crowdSeatCeiling?: number;
1041
+ }
1042
+ /** What a tap on a bookable object that is not a seat reports (`Venue3DOptions.onObjectPick`). */
1043
+ interface ObjectPick3D {
1044
+ kind: 'area';
1045
+ id: string;
1046
+ /** Where the tap was, in the page's viewport: a host's chooser can open there, as on the 2D map. */
1047
+ point: {
1048
+ x: number;
1049
+ y: number;
1050
+ };
931
1051
  }
1052
+
932
1053
  interface Venue3DOptions {
933
1054
  /** Fired on a tap that hits a seat (GPU color-pick). Not fired on empty taps. */
934
1055
  onSeatPick?: (seatId: string) => void;
@@ -946,6 +1067,22 @@ interface Venue3DOptions {
946
1067
  x: number;
947
1068
  y: number;
948
1069
  } | null) => void;
1070
+ /**
1071
+ * A tap on something bookable that is not a seat. Today that is a standing
1072
+ * area (`kind: 'area'`, `id` = the chart object's id): the host opens the
1073
+ * same "how many" chooser its 2D map opens. One report with a kind, so a
1074
+ * table or a booth can use it later without another option.
1075
+ *
1076
+ * A seat always wins: this fires only when no seat is under the pointer, and
1077
+ * only when the floor is the surface the buyer sees there (a tier, a wall or
1078
+ * the stage in front of it takes the tap, as it does for a seat; so does
1079
+ * another object's name tag drawn over the floor). Inside a section the
1080
+ * buyer entered, that section's seats keep their finger reach.
1081
+ * An area that is sold out or left out by the host's filter (`setAreaStates`)
1082
+ * is not reported and the tap does nothing, as on the 2D map; its tag says
1083
+ * why. Without this option a tap on a standing floor does what it did before.
1084
+ */
1085
+ onObjectPick?: (pick: ObjectPick3D) => void;
949
1086
  /** Overview → section drill state. A stand tap reports its owning section;
950
1087
  * Overview reports null so host navigation can stay in sync. */
951
1088
  onSectionFocusChange?: (sectionId: string | null) => void;
@@ -1032,6 +1169,17 @@ interface Venue3DOptions {
1032
1169
  /** Start on the final overview pose without the decorative stand-up intro.
1033
1170
  * Intended for deterministic rendered review and screenshot capture. */
1034
1171
  skipInitialOverviewAnimation?: boolean;
1172
+ /**
1173
+ * How fingers navigate. `map`: a swipe always moves the view with the point
1174
+ * under the finger, a pinch follows the finger ratio, a twist turns, and two
1175
+ * fingers dragged up or down together tilt, like the 2D map. `classic`: one
1176
+ * finger turns the venue at the overview and moves it once zoomed in. Unset
1177
+ * is `map` (camera/touchNavigation.ts). A mouse and the wheel
1178
+ * keep their own gestures. One thing `map` changes for every input: after a
1179
+ * move the view settles in the same TIME on a slow frame as on a fast one
1180
+ * (a frame longer than 16.7 ms covers the frames it replaced).
1181
+ */
1182
+ touchNavigation?: 'map' | 'classic';
1035
1183
  /**
1036
1184
  * Which of the scene's OWN DOM overlays it should draw.
1037
1185
  *
@@ -1069,6 +1217,17 @@ interface Venue3DHandle {
1069
1217
  state: SeatState3D;
1070
1218
  }[]): void;
1071
1219
  setSelection(seatIds: string[]): void;
1220
+ /**
1221
+ * Each standing area's live state, by chart object id: the record the 2D
1222
+ * map's `setGAStates` takes (`available`, `selected`, `wheelchairFree`),
1223
+ * plus `filteredOut` and the words (`statusText`: send the 2D map's second
1224
+ * line for every area with a live count). The view then applies the 2D
1225
+ * map's rules: the tag reads `name · statusText` with the buyer's count; a
1226
+ * sold-out, wheelchair-closed or filtered-out area is drawn quieter; a
1227
+ * sold-out or filtered-out one stops reporting taps. An id left out keeps
1228
+ * its state; an area never named shows its capacity, as before.
1229
+ */
1230
+ setAreaStates(states: Readonly<Record<string, AreaState3D>>): void;
1072
1231
  /** Select what a one-finger / primary-pointer drag controls. Touch buyers can
1073
1232
  * still use two fingers to move in either mode; this exists so native SDKs
1074
1233
  * can expose the same explicit Rotate / Move controls as the web picker. */
@@ -1155,6 +1314,28 @@ interface Venue3DHandle {
1155
1314
  focusFloor(index: number | null): boolean;
1156
1315
  }
1157
1316
 
1317
+ /**
1318
+ * Touch navigation that behaves like the 2D map.
1319
+ *
1320
+ * Owner, on an Android phone, 13 Nov 2026: "in 2D if user want to move to any
1321
+ * place from any section they can swipe any direction pinch etc but in 3D
1322
+ * sometime it start rotate around and get difficult to move to certain area".
1323
+ *
1324
+ * The rules, all pure here so they can be tested without a canvas:
1325
+ *
1326
+ * - A finger takes hold of the point under it (the ground, or the seat it
1327
+ * landed on) and that point stays under the finger while it moves.
1328
+ * - A pinch zooms by the ratio of the finger distances, as the map does.
1329
+ * - A twist turns the venue only once it is plainly a twist, so a pinch does
1330
+ * not turn the venue by accident.
1331
+ * - Two fingers side by side, dragged up or down together, tilt.
1332
+ * - The view cannot leave the venue (the 2D map's leash, `engine/panBounds`).
1333
+ *
1334
+ * `orbit.ts` owns the camera state and calls these.
1335
+ */
1336
+ /** `map`: the rules above. `classic`: one finger turns at the overview and moves once zoomed in. */
1337
+ type TouchNavigation = 'map' | 'classic';
1338
+
1158
1339
  declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
1159
1340
 
1160
- export { type Analytics3DCallback, type AutoVenueReport, type PreparedVenue3D, type PreparedVenue3DFromChart, type Scene3DPrepSource, type SeatState3D, SeatView, type SeatViewStopName, VENUE3D_QUALITY_REPORT_VERSION, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DQualityEvidence, type Venue3DQualityReport, type Venue3DStats, autoVenue3d, buildSceneModel, estimateVenue3D, inspectVenue3DQualityEvidence, mountVenue3D, prepareVenue3D, prepareVenue3DFromChart };
1341
+ export { type Analytics3DCallback, type AreaState3D, type AutoVenueReport, type ObjectPick3D, type PreparedVenue3D, type PreparedVenue3DFromChart, type Scene3DPrepSource, type SeatState3D, SeatView, type SeatViewStopName, type TouchNavigation, VENUE3D_QUALITY_REPORT_VERSION, type Venue3DHandle, type Venue3DInput, type Venue3DOptions, type Venue3DQualityEvidence, type Venue3DQualityReport, type Venue3DStats, autoVenue3d, buildSceneModel, estimateVenue3D, inspectVenue3DQualityEvidence, mountVenue3D, prepareVenue3D, prepareVenue3DFromChart };