@seatlayer/core 0.110.0 → 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 (162) 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/{categoryInventory-BfvwE3nC.d.cts → categoryInventory-BE1AThTx.d.cts} +1 -1
  6. package/dist/{categoryInventory-ClZ-68jI.d.ts → categoryInventory-DxciZQK_.d.ts} +1 -1
  7. package/dist/{chunk-ZYQXT5JP.js → chunk-5FIX35HN.js} +1 -1
  8. package/dist/{chunk-2JFCDE27.js → chunk-5GHPGPWE.js} +1 -1
  9. package/dist/{chunk-MRLWH6RC.js → chunk-AZWAP4OE.js} +1 -1
  10. package/dist/chunk-BXQQKDIX.js +1 -0
  11. package/dist/{chunk-OJSGMXJS.js → chunk-FZ74MVKY.js} +1 -1
  12. package/dist/chunk-JQBJZMLG.js +1 -0
  13. package/dist/{chunk-UUIZHJYL.js → chunk-MN4M5QZ4.js} +1 -1
  14. package/dist/chunk-N6K5NQYG.js +1 -0
  15. package/dist/{chunk-6VOUTNRV.js → chunk-NQLQNJV2.js} +1 -1
  16. package/dist/{chunk-BNLANXXZ.js → chunk-NXS6JFBI.js} +1 -1
  17. package/dist/{chunk-WUNZCUE6.js → chunk-XWTAFHYQ.js} +1 -1
  18. package/dist/{chunk-FBXZWNND.js → chunk-Z6YGWTT3.js} +1 -1
  19. package/dist/core/chart-ops/index.cjs +1 -1
  20. package/dist/core/chart-ops/index.d.cts +7 -5
  21. package/dist/core/chart-ops/index.d.ts +7 -5
  22. package/dist/core/chart-ops/index.js +1 -1
  23. package/dist/core/inventory/index.cjs +1 -1
  24. package/dist/core/inventory/index.d.cts +4 -4
  25. package/dist/core/inventory/index.d.ts +4 -4
  26. package/dist/core/inventory/index.js +1 -1
  27. package/dist/core/layout/index.cjs +1 -1
  28. package/dist/core/layout/index.d.cts +5 -5
  29. package/dist/core/layout/index.d.ts +5 -5
  30. package/dist/core/layout/index.js +1 -1
  31. package/dist/core/quality/index.cjs +1 -1
  32. package/dist/core/quality/index.d.cts +3 -3
  33. package/dist/core/quality/index.d.ts +3 -3
  34. package/dist/core/render-assets/index.cjs +1 -1
  35. package/dist/core/render-assets/index.d.cts +2 -2
  36. package/dist/core/render-assets/index.d.ts +2 -2
  37. package/dist/core/render-assets/index.js +1 -1
  38. package/dist/core/seatConfidence.d.cts +1 -1
  39. package/dist/core/seatConfidence.d.ts +1 -1
  40. package/dist/core/sections/index.d.cts +5 -5
  41. package/dist/core/sections/index.d.ts +5 -5
  42. package/dist/core/sections/index.js +1 -1
  43. package/dist/cs-JRLKXXM5.js +1 -0
  44. package/dist/cy-W3CYXTOV.js +1 -0
  45. package/dist/da-HG4PFYWH.js +1 -0
  46. package/dist/de-KOM2AXXJ.js +1 -0
  47. package/dist/el-NBRQ66EQ.js +1 -0
  48. package/dist/es-AVEG4ZNM.js +1 -0
  49. package/dist/et-33PIOTI4.js +1 -0
  50. package/dist/{eventConfigurations-DsW5Mj2e.d.ts → eventConfigurations-Cdt-e0uD.d.ts} +1 -1
  51. package/dist/{eventConfigurations-dmn9FClw.d.cts → eventConfigurations-D0us5j0K.d.cts} +1 -1
  52. package/dist/fa-CDV2VTXV.js +1 -0
  53. package/dist/fi-TKATIOE6.js +1 -0
  54. package/dist/fr-TMDNSR5N.js +1 -0
  55. package/dist/he-4G7OVLJX.js +1 -0
  56. package/dist/hi-XKXNYPYF.js +1 -0
  57. package/dist/hr-BX444QNM.js +1 -0
  58. package/dist/hu-FM46JMDP.js +1 -0
  59. package/dist/id-CBVTYGFP.js +1 -0
  60. package/dist/index.cjs +1 -1
  61. package/dist/index.d.cts +46 -38
  62. package/dist/index.d.ts +46 -38
  63. package/dist/index.js +1 -1
  64. package/dist/it-ZOFOAG6E.js +1 -0
  65. package/dist/ja-NKEBMXTO.js +1 -0
  66. package/dist/ko-RUCELYV7.js +1 -0
  67. package/dist/ku-KKYBDVSA.js +1 -0
  68. package/dist/{labeling-Bn41ByDd.d.ts → labeling-DXgkxMoi.d.ts} +1 -1
  69. package/dist/{labeling-BmEjVxFt.d.cts → labeling-eYKVPLMb.d.cts} +1 -1
  70. package/dist/localeLoaders-YQXZZVNH.js +1 -0
  71. package/dist/lt-3CJ37W7A.js +1 -0
  72. package/dist/lv-H37RDMRX.js +1 -0
  73. package/dist/ms-E5RVBRE6.js +1 -0
  74. package/dist/nl-QHEOTQ7U.js +1 -0
  75. package/dist/no-43HJQ5MK.js +1 -0
  76. package/dist/pl-4LKJHMFJ.js +1 -0
  77. package/dist/pt-LSSE5QHE.js +1 -0
  78. package/dist/{renderedQuality-MDkNe8GA.d.ts → renderedQuality-Dzo2_8f4.d.ts} +1 -1
  79. package/dist/{renderedQuality-Bt2d0uq1.d.cts → renderedQuality-Frgw6jdx.d.cts} +1 -1
  80. package/dist/{renderer-DH0yI32q.d.cts → renderer-DM2sv1un.d.cts} +1 -1
  81. package/dist/{renderer-BJrpMV6U.d.ts → renderer-DuieD7jP.d.ts} +1 -1
  82. package/dist/ro-U2QASPIY.js +1 -0
  83. package/dist/ru-PTMWREXY.js +1 -0
  84. package/dist/{seatTypeIcons-CG_Uzpaw.d.ts → seatTypeIcons-Bz0OJtEi.d.ts} +1 -1
  85. package/dist/{seatTypeIcons-Ck7oEFei.d.cts → seatTypeIcons-Cm8tjLYl.d.cts} +1 -1
  86. package/dist/{sections-C-UAqr1x.d.ts → sections-Bf_DV0oG.d.ts} +1 -1
  87. package/dist/{sections-C8HApYxd.d.cts → sections-PbQiqN0i.d.cts} +1 -1
  88. package/dist/{segmentedRowModel-DR1w9M13.d.ts → segmentedRowModel-CO7DD803.d.ts} +1 -1
  89. package/dist/{segmentedRowModel-CeoMsBnt.d.cts → segmentedRowModel-Co9LqS4i.d.cts} +1 -1
  90. package/dist/sk-AY2N2ORA.js +1 -0
  91. package/dist/sl-5MQJVNB7.js +1 -0
  92. package/dist/sr-25FTJPUA.js +1 -0
  93. package/dist/{stage-CKb7aNoH.d.cts → stage-BtqKu5aX.d.cts} +1 -1
  94. package/dist/{stage-CKb7aNoH.d.ts → stage-BtqKu5aX.d.ts} +1 -1
  95. package/dist/sv-7VQX4BFH.js +1 -0
  96. package/dist/{tableSizing-RRmpxOXl.d.ts → tableSizing-BDePQyPD.d.ts} +3 -3
  97. package/dist/{tableSizing-Bz-hxLza.d.cts → tableSizing-C6EjKNnk.d.cts} +3 -3
  98. package/dist/th-E53HQMDC.js +1 -0
  99. package/dist/{ticketRestrictions-lq4dH4k6.d.cts → ticketRestrictions-CgYwHQOf.d.cts} +2 -2
  100. package/dist/{ticketRestrictions-C7KUrulv.d.ts → ticketRestrictions-D5wgOq4P.d.ts} +2 -2
  101. package/dist/tr-IIR6E7OD.js +1 -0
  102. package/dist/{types-DM-OneoD.d.ts → types-CGOr0BpE.d.cts} +40 -16
  103. package/dist/{types-DM-OneoD.d.cts → types-CGOr0BpE.d.ts} +40 -16
  104. package/dist/uk-HBINQ4XE.js +1 -0
  105. package/dist/vi-TX6I5RWN.js +1 -0
  106. package/dist/view3d/crossfade/panorama.d.cts +1 -1
  107. package/dist/view3d/crossfade/panorama.d.ts +1 -1
  108. package/dist/view3d/index.cjs +531 -172
  109. package/dist/view3d/index.d.cts +350 -73
  110. package/dist/view3d/index.d.ts +350 -73
  111. package/dist/view3d/index.js +529 -170
  112. package/dist/view3d/scene/scene.worker.cjs +1 -1
  113. package/dist/view3d/scene/scene.worker.js +1 -1
  114. package/dist/zh-Hans-7QNBTEYC.js +1 -0
  115. package/dist/zh-Hant-6KK3D42X.js +1 -0
  116. package/package.json +1 -1
  117. package/dist/ar-O3RHQRH3.js +0 -1
  118. package/dist/be-SXFCG3F5.js +0 -1
  119. package/dist/bg-W7YBNYB2.js +0 -1
  120. package/dist/ca-FA7WHACR.js +0 -1
  121. package/dist/chunk-4N5CHKHD.js +0 -1
  122. package/dist/chunk-4QQG5EEP.js +0 -1
  123. package/dist/chunk-YE4NP3XB.js +0 -1
  124. package/dist/cs-RR3VIKRC.js +0 -1
  125. package/dist/cy-U4JJ5C47.js +0 -1
  126. package/dist/da-ATULGB2M.js +0 -1
  127. package/dist/de-VB543CPC.js +0 -1
  128. package/dist/el-7Y2KXU6N.js +0 -1
  129. package/dist/es-GUV5XIYC.js +0 -1
  130. package/dist/et-SZ6I4Z44.js +0 -1
  131. package/dist/fa-FM6ELEN7.js +0 -1
  132. package/dist/fi-6QQ2M5JI.js +0 -1
  133. package/dist/fr-2SEQSVLR.js +0 -1
  134. package/dist/he-V3EVB7IW.js +0 -1
  135. package/dist/hi-I4QIBK5Q.js +0 -1
  136. package/dist/hr-I5DNEVUU.js +0 -1
  137. package/dist/hu-KTFWBQMF.js +0 -1
  138. package/dist/id-RZWUH426.js +0 -1
  139. package/dist/it-CNQP36V4.js +0 -1
  140. package/dist/ja-JQZOYIHI.js +0 -1
  141. package/dist/ko-6YCWWHFQ.js +0 -1
  142. package/dist/ku-33PM4OWG.js +0 -1
  143. package/dist/localeLoaders-VFQOZMUH.js +0 -1
  144. package/dist/lt-24JO2B7V.js +0 -1
  145. package/dist/lv-HTSDEEAB.js +0 -1
  146. package/dist/ms-PUEZJJ3R.js +0 -1
  147. package/dist/nl-NQPDRSCW.js +0 -1
  148. package/dist/no-3N3MUMSA.js +0 -1
  149. package/dist/pl-YHBEO6ZF.js +0 -1
  150. package/dist/pt-5RPESNZB.js +0 -1
  151. package/dist/ro-XDFXIMHX.js +0 -1
  152. package/dist/ru-BIIALOM5.js +0 -1
  153. package/dist/sk-LHSFRUFT.js +0 -1
  154. package/dist/sl-MPE5TPI3.js +0 -1
  155. package/dist/sr-T3N67KTP.js +0 -1
  156. package/dist/sv-LJWWYUIY.js +0 -1
  157. package/dist/th-E5POGG37.js +0 -1
  158. package/dist/tr-2DCWQ2CY.js +0 -1
  159. package/dist/uk-C3VJP6EA.js +0 -1
  160. package/dist/vi-XVMTKCOL.js +0 -1
  161. package/dist/zh-Hans-RG4CQGBY.js +0 -1
  162. package/dist/zh-Hant-YHNTYPFS.js +0 -1
@@ -1,9 +1,127 @@
1
- import { P as Point, C as ChartDoc } from '../types-DM-OneoD.cjs';
2
- import { E as EventConfigurationProductionElementKind, a as EventConfigurationOcclusion, b as EventConfigurationVersion } from '../eventConfigurations-dmn9FClw.cjs';
3
- import { E as ExpandedSeat } from '../renderer-DH0yI32q.cjs';
4
- import { S as StageKind } from '../stage-CKb7aNoH.cjs';
1
+ import { P as Point, C as ChartDoc } from '../types-CGOr0BpE.cjs';
2
+ import { E as EventConfigurationProductionElementKind, a as EventConfigurationOcclusion, b as EventConfigurationVersion } from '../eventConfigurations-D0us5j0K.cjs';
3
+ import { E as ExpandedSeat } from '../renderer-DM2sv1un.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.
@@ -77,7 +227,8 @@ interface MeshData {
77
227
  /**
78
228
  * Small renderer material class per vertex:
79
229
  * 0 = ordinary structure, 1 = authored powered display,
80
- * 2 = row riser, 3 = row tread, 4 = football turf, 5 = generated concrete.
230
+ * 2 = row riser, 3 = row tread, 4 = football turf, 5 = generated concrete,
231
+ * 6 = a walled room's wall, 7 = an aisle step's nosing strip.
81
232
  */
82
233
  material: Float32Array;
83
234
  /** Vertex count (position.length / 3). */
@@ -97,6 +248,41 @@ interface SharedAisleCandidate {
97
248
  outline: Point[];
98
249
  }
99
250
 
251
+ /**
252
+ * Venue looks: named presentations for the 3D view.
253
+ *
254
+ * A look is what a lighting designer would call the state of the house: what
255
+ * colour the light is, how dark the room around the venue is, and which way the
256
+ * bare surfaces lean. It is NOT a second theme system. A look only supplies
257
+ * what a chart leaves unset, field by field, and everything it supplies still
258
+ * passes through `resolveTheme3D`: structure is pinned to the day or night
259
+ * lightness targets (`VENUE_LIGHTNESS`) and keeps only a hint of hue
260
+ * (`STRUCTURE_CHROMA_CAP`), seats stay in their band, and the colours that
261
+ * carry meaning (available, held, sold, selected) are never a look's to change.
262
+ *
263
+ * What a look adds that a theme could not express is the LIGHT. Until now the
264
+ * rig was white whatever the venue: a theatre under house lights and a stadium
265
+ * at noon were lit identically and differed only in paint. `light.key` tints
266
+ * the one directional light and `light.ambient` the sky-and-bounce term, as
267
+ * multipliers around 1, so a look changes the mood of a venue without moving a
268
+ * single surface off its lightness target.
269
+ *
270
+ * WHERE A LOOK COMES FROM. A chart may name one (`theme.venue3d.look`), which
271
+ * also gives it the look's background if it has none of its own. A chart that
272
+ * names none gets one chosen from the kind of venue it draws
273
+ * (`automaticVenueLook`): the light and the unset surfaces, but NOT the
274
+ * background, so the 3D view keeps the same backdrop as the 2D map it is
275
+ * switched from. `'plain'` switches looks off: white light, as before looks
276
+ * existed.
277
+ */
278
+
279
+ interface VenueLookLight {
280
+ /** Tint of the directional key light, a multiplier per channel. */
281
+ key: RGB;
282
+ /** Tint of the ambient (sky and bounce) and fill light, a multiplier per channel. */
283
+ ambient: RGB;
284
+ }
285
+
100
286
  /**
101
287
  * Resolve a chart's authored theme into the 3D scene's colours.
102
288
  *
@@ -146,71 +332,61 @@ interface Theme3D {
146
332
  shell: RGB | null;
147
333
  roughness: number;
148
334
  };
335
+ /**
336
+ * Tint of the rig, from the chart's look (see looks.ts): multipliers on the
337
+ * key light and on the ambient and fill. White for a chart with no look.
338
+ */
339
+ light: VenueLookLight;
340
+ /**
341
+ * The room an indoor venue shows above and behind its stands from a seat
342
+ * (scene/model/house.ts): its ceiling, its wall and its house lights.
343
+ * `indoor` is whether the venue stands under a roof: the chosen look's own
344
+ * answer, or, for a chart that chose none, what it draws (`drawnIndoors`).
345
+ * A venue whose drawn walls make it a room is closed whatever this says.
346
+ * Null for a chart with no look.
347
+ */
348
+ house: {
349
+ indoor: boolean;
350
+ ceiling: RGB;
351
+ wall: RGB;
352
+ lamp: RGB;
353
+ } | null;
149
354
  }
150
355
 
151
356
  /**
152
- * Venue labels — anchors, level-of-detail, and world→screen projection.
153
- *
154
- * ## Why labels are DOM, not geometry
357
+ * The house: the room an indoor venue is seen in from inside.
155
358
  *
156
- * The renderer is deliberately texture-free at three draw calls. Drawing text on
157
- * the GPU means a signed-distance font atlas: a texture, another shader, a build
158
- * asset, and a resolution ceiling — a lot of machinery for the few dozen labels a
159
- * venue actually needs. Projecting anchors and positioning DOM elements costs
160
- * nothing when a chart has no labels, and buys properties the GPU path cannot:
161
- *
162
- * - **Real text.** A screen reader can read the venue's structure. That is the
163
- * accessibility gap in 3D, not just a rendering convenience.
164
- * - Crisp at any device pixel ratio and any zoom, with no atlas to outgrow.
165
- * - `ChartTheme.fontFamily`, i18n and RTL come from the browser.
359
+ * From a seat in an arena or a theatre the stands used to end in the chart's
360
+ * flat backdrop: no ceiling, no wall above the top row, a black void where the
361
+ * room should be (reference walk, 2026-11-11, gap C1). An open-air venue
362
+ * already shows a sky there (`SceneModel.outdoor`); this is the indoor
363
+ * counterpart.
166
364
  *
167
- * This module is the pure half — what to label, where its anchor sits, and when
168
- * it should show. The overlay that positions elements lives in `index.ts`.
365
+ * It is a BACKDROP, not a building. Nothing here adds a triangle: the
366
+ * background pass works out, for each pixel, where that line of sight meets a
367
+ * ceiling plane or an elliptical wall and paints it (materials.ts BG_FRAG).
368
+ * So it is always behind everything drawn, cannot stand between a seat and the
369
+ * stage, casts no shadow, takes no tap and does not move the camera's framing.
370
+ * That is the line the September audit drew ("no invented roof, balcony,
371
+ * support columns or skyline in an asserted seat view"): the room is closed,
372
+ * and nothing is invented that a buyer could mistake for an obstruction.
169
373
  *
170
- * ## Why the rungs mirror 2D
171
- *
172
- * 2D melts through zones → sections → seats. Labels follow the same idea for the
173
- * same reason: at a distance a buyer needs to know which part of the venue they
174
- * are looking at, and up close they need to know which block and which door. A
175
- * label set that does not thin out with distance turns a 51-section arena into
176
- * unreadable confetti.
374
+ * It shows only while the camera is inside it and under its ceiling. Every
375
+ * overview stands outside or above, and is unchanged.
177
376
  */
178
-
179
- type LabelKind = 'floor' | 'stage' | 'zone' | 'section' | 'ga' | 'gate' | 'annotation' | 'booth' | 'row' | 'seat' | 'access';
180
- interface SceneLabel {
181
- id: string;
182
- kind: LabelKind;
183
- text: string;
184
- /** World-metre anchor the label is pinned to. */
185
- anchor: [number, number, number];
186
- /** Authored colour (`#rrggbb`), when the object carries one. */
187
- color?: string;
188
- /** Physical chair width, used to reveal numbers only at readable scale. */
189
- seatWidthM?: number;
190
- /** Authored rotation in degrees, for annotations that specify one. */
191
- rotation?: number;
192
- /** Owning physical level, so a focused floor never keeps another level's text. */
193
- floorIndex?: number;
194
- /** A picked seat's pin base (scene/seatPin): its tag rides the pin's stem. */
195
- pinBase?: [number, number, number];
196
- /** A seat label's row, so the row under the pointer can show its numbers. */
197
- rowId?: string;
198
- /** An `access` label's pictogram (a seat-type icon key, e.g. `wheelchair`). */
199
- icon?: string;
200
- /** An authored venue icon's registry key: its annotation wears the map badge. */
201
- venueIcon?: string;
202
- /** A gate with step-free access: its sign leads with the wheelchair mark. */
203
- stepFree?: boolean;
204
- /** Icon ink on an `access` chip; white when absent. */
205
- ink?: string;
377
+ interface HouseBounds {
378
+ /** Centre of the room, world metres (x, z). */
379
+ centre: [number, number];
380
+ /** Half-widths of the elliptical wall, world metres (x, z). */
381
+ radii: [number, number];
382
+ floorY: number;
383
+ ceilingY: number;
206
384
  /**
207
- * A section tag's category colour (the one most of its seats sell in), so
208
- * the tag reads as its price band before it is read, as on seats.io's
209
- * stadium (owner comparison, 2026-09-25).
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.
210
388
  */
211
- tint?: string;
212
- /** A section tag's wheelchair places, as seat instance indices, for its free-count badge. */
213
- wheelchairSeats?: number[];
389
+ theatre?: boolean;
214
390
  }
215
391
 
216
392
  /**
@@ -292,6 +468,11 @@ interface SeatInstanceData {
292
468
  iGlyph: Float32Array;
293
469
  /** 1 = physical chair; 0 = sellable empty wheelchair bay. */
294
470
  iPhysicalSeat: Float32Array;
471
+ /** vec4 per instance: where this seat's armrests stand, as two world offsets
472
+ * (x, z) in metres from the seat: xy = the one it shares with the next seat
473
+ * in its row, zw = the one on its other side, carried only where no seat
474
+ * before it carries it. (0, 0) = no armrest there. See `fixedRowSeating`. */
475
+ iArmrests: Float32Array;
295
476
  /** seatId → instance index (drives targeted availability updates). */
296
477
  idToIndex: Map<string, number>;
297
478
  }
@@ -303,6 +484,8 @@ interface StageBounds {
303
484
  y: number;
304
485
  halfX: number;
305
486
  halfZ: number;
487
+ /** The deck's own top colour, as built: what light laid on it fades out to. */
488
+ top?: [number, number, number];
306
489
  }
307
490
  /** Event-specific semantics resolved onto base-chart geometry in world metres. */
308
491
  interface SceneProductionElement {
@@ -424,6 +607,20 @@ interface SceneModel {
424
607
  */
425
608
  sectionSolidRanges: SectionSolidRange[];
426
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[];
427
624
  /** Physical section ownership in input-seat order; absent on older prepared models. */
428
625
  seatSectionIds?: Array<string | null>;
429
626
  bounds: {
@@ -452,6 +649,8 @@ interface SceneModel {
452
649
  room?: {
453
650
  centre: [number, number];
454
651
  };
652
+ /** An indoor venue's room, seen from inside it: a ceiling and a wall (see house.ts). */
653
+ house?: HouseBounds;
455
654
  /** Exact enclosing sphere for rendered solids plus near-field seat detail. */
456
655
  renderBounds: {
457
656
  center: [number, number, number];
@@ -514,6 +713,10 @@ interface SceneModelInput {
514
713
  registeredShellGlb?: ArrayBuffer;
515
714
  /** Optional initial per-seat state (default all available). */
516
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;
517
720
  }
518
721
 
519
722
  declare function buildSceneModel(input: SceneModelInput): SceneModel;
@@ -624,6 +827,10 @@ interface PrepareVenue3DInput {
624
827
  registeredShellGlb?: ArrayBuffer;
625
828
  /** False renders the chart exactly as saved, with no estimated heights. */
626
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;
627
834
  }
628
835
  type PrepareVenue3DFromChartInput = Omit<PrepareVenue3DInput, 'seats'>;
629
836
  /** Designer-friendly result: expansion and scene compilation both happened
@@ -730,9 +937,11 @@ interface Venue3DQualityEvidence {
730
937
  webgl2: boolean;
731
938
  lost: boolean;
732
939
  };
940
+ /** `smoothed`: the frame on screen was drawn with edge smoothing (gl/frameSmoothing.ts). */
733
941
  frame: {
734
942
  rendered: number;
735
943
  idle: boolean;
944
+ smoothed?: boolean;
736
945
  };
737
946
  camera: {
738
947
  position: [number, number, number];
@@ -806,17 +1015,6 @@ interface Venue3DQualityReport {
806
1015
  /** Inspect the actual parked WebGL scene, projected camera, and DOM label overlay. */
807
1016
  declare function inspectVenue3DQualityEvidence(evidence: Venue3DQualityEvidence): Venue3DQualityReport;
808
1017
 
809
- /**
810
- * The public contract of the lazy venue-view chunk: what you mount it with
811
- * (`Venue3DInput`), how you configure it (`Venue3DOptions`), and what you get
812
- * back (`Venue3DHandle`).
813
- *
814
- * Split out of `index.ts` so the mount closure and the UI/interaction modules
815
- * can share them without importing the entry. `index.ts` re-exports all four —
816
- * that is the path the SDK (`@seatlayer/core/view3d`), the picker, the designer
817
- * preview and the harness import from, and it must never move.
818
- */
819
-
820
1018
  interface Venue3DInput {
821
1019
  doc: ChartDoc;
822
1020
  /** Expanded seats (from `expandChart`) — carry x/y + resolved eyeHeightM. */
@@ -832,7 +1030,26 @@ interface Venue3DInput {
832
1030
  /** False renders the chart exactly as saved, with no estimated heights.
833
1031
  * Ignored with `prepared`, which already made that choice. */
834
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
+ };
835
1051
  }
1052
+
836
1053
  interface Venue3DOptions {
837
1054
  /** Fired on a tap that hits a seat (GPU color-pick). Not fired on empty taps. */
838
1055
  onSeatPick?: (seatId: string) => void;
@@ -850,6 +1067,22 @@ interface Venue3DOptions {
850
1067
  x: number;
851
1068
  y: number;
852
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;
853
1086
  /** Overview → section drill state. A stand tap reports its owning section;
854
1087
  * Overview reports null so host navigation can stay in sync. */
855
1088
  onSectionFocusChange?: (sectionId: string | null) => void;
@@ -936,6 +1169,17 @@ interface Venue3DOptions {
936
1169
  /** Start on the final overview pose without the decorative stand-up intro.
937
1170
  * Intended for deterministic rendered review and screenshot capture. */
938
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';
939
1183
  /**
940
1184
  * Which of the scene's OWN DOM overlays it should draw.
941
1185
  *
@@ -973,6 +1217,17 @@ interface Venue3DHandle {
973
1217
  state: SeatState3D;
974
1218
  }[]): void;
975
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;
976
1231
  /** Select what a one-finger / primary-pointer drag controls. Touch buyers can
977
1232
  * still use two fingers to move in either mode; this exists so native SDKs
978
1233
  * can expose the same explicit Rotate / Move controls as the web picker. */
@@ -1059,6 +1314,28 @@ interface Venue3DHandle {
1059
1314
  focusFloor(index: number | null): boolean;
1060
1315
  }
1061
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
+
1062
1339
  declare function mountVenue3D(container: HTMLElement, input: Venue3DInput, opts?: Venue3DOptions): Venue3DHandle;
1063
1340
 
1064
- 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 };