@seatsyoo/vue 1.1.0 → 1.3.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.
package/README.md CHANGED
@@ -89,15 +89,39 @@ Cómo reacciona a los cambios de props:
89
89
 
90
90
  | Qué cambia | Qué pasa |
91
91
  | --- | --- |
92
- | `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`, `channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`, `showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance`, `texts` | Se desmonta el visor y se monta otro con lo nuevo. Los arrays y objetos se comparan **por su valor**: `:channels="['web']"` no lo vuelve a montar en cada render, y cambiar un array reactivo en el sitio (`canales.push("taquilla")`) sí. |
92
+ | `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`, `channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`, `showLegend`, `showSelectionBar`, `showHoldTimer`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`, `unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures`, `minTargetSize`, `keyboardHint` | Se desmonta el visor y se monta otro con lo nuevo. Los arrays y objetos se comparan **por su valor**: `:channels="['web']"` no lo vuelve a montar en cada render, y cambiar un array reactivo en el sitio (`canales.push("taquilla")`) sí. |
93
93
  | `theme`, `colorBy` | Se aplica al visor montado (`setTheme`, `setColorBy`), sin volver a montarlo. |
94
94
  | `statusStyles`, `marks` | Solo con `mode="manager"` (un panel de gestión): cómo se ve cada estado y las marcas sobre plazas libres (ver «Estados propios y marcas»). Se aplican al visor montado (`setStatusStyles`, `setMarks`), sin volver a montarlo, solo si cambia su valor: se comparan como datos (da igual el prototipo, y una clave que vale `undefined` es como si no estuviera), así que un objeto nuevo con lo mismo no hace nada, y cambiar uno reactivo en el sitio (`marcas["Platea-A-1"] = "reducida"`) sí cuenta. Quitarlas es dejar el visor sin estilos ni marcas. |
95
+ | `spotlight`, `objectColor` | Se aplican al visor montado (`setSpotlight`, `setObjectColor`), sin volver a montarlo. El foco se compara por valor; `objectColor`, por referencia: otra función repinta todo el plano. Quitarlos es quitar el foco y el color propio. |
95
96
  | `load3d` | Se usa la última función; ponerlo o quitarlo vuelve a montar. |
96
97
 
97
98
  El plano (`document`) no se copia, porque puede ser muy grande: un plano nuevo con lo mismo no vuelve a montar el
98
99
  visor, pero si cambias el que ya pasaste (en el sitio), no se nota, ni aunque después pases una copia. Pasa un plano
99
100
  nuevo sin tocar el anterior.
100
101
 
102
+ **La rueda y los dedos.** Por defecto (`gestures="auto"`), si tu página se desplaza (o el visor va en un iframe), la
103
+ rueda sola y un dedo desplazan la página aunque pasen por encima del plano: el plano se acerca con Ctrl o ⌘ + rueda (o
104
+ pellizcando) y se mueve arrastrando con el ratón o con dos dedos, y un aviso breve encima del plano lo dice. Con
105
+ `"free"` el plano se queda la rueda y los dedos (una página donde lo ocupa todo; también en pantalla completa) y con
106
+ `"cooperative"`, siempre la página. `min-target-size` (`{ touch: 24, mouse: 6 }` píxeles por defecto) hace que, si las
107
+ butacas se ven más pequeñas, el primer toque acerque la zona (al menos al doble) en vez de elegir; el siguiente elige.
108
+ Con `false`, nunca.
109
+
110
+ **El teclado y el lector de pantalla.** No hay nada que activar: el plano es una sola parada del tabulador y, dentro,
111
+ las flechas mueven un cursor por las butacas (por la fila y a la fila vecina; `Inicio` y `Fin`, a sus extremos).
112
+ `Intro` o `Espacio` eligen o quitan como un toque, con los mismos avisos y los mismos topes. De lejos, por sectores, el
113
+ cursor va de sector en sector: `Intro` entra y `Esc` vuelve. **Las flechas solas ya no mueven el plano: lo mueve
114
+ `Mayús` + flechas** (`+`, `−` y `0`, el zoom; `?` enseña los atajos). La primera vez que el foco entra en el plano con
115
+ el teclado (una vez por sesión del navegador), una pista discreta enseña esas teclas y un lector de pantalla las oye; se
116
+ va sola. `:keyboard-hint="false"` la quita, para una web que ya explica sus atajos (la tecla `?` la enseña igual). Para
117
+ un lector de pantalla el plano es una cuadrícula (`role="grid"`; la raíz ya no es `role="application"`) y cada butaca,
118
+ una celda con `aria-selected` y `aria-disabled` (antes, un botón con `aria-pressed`): si tus pruebas las buscaban por
119
+ su papel, búscalas por `[data-key]`.
120
+
121
+ **El reloj de la retención.** La barra de lo elegido enseña cuántas plazas llevas, el total y el tiempo que queda de la
122
+ retención. `:show-hold-timer="false"` quita solo el reloj y `:show-selection-bar="false"`, la barra entera (para una web con su
123
+ propio carrito). Lo retenido caduca igual: `@hold-expired`.
124
+
101
125
  **Lo que el comprador tiene retenido al volver a montar.** Si es en el mismo evento y con `session: "continue"` (por
102
126
  defecto), el visor nuevo lo recupera. Si el nuevo no puede recuperarlo (has cambiado de evento o de temporada, de
103
127
  `server` o de `publicKey`, usas `session: "start"`, le pasas un `holdToken` o el modo `"manager"`), el componente lo
@@ -144,6 +168,8 @@ Lo que se cobra lo calcula tu servidor con sus precios, no con lo que diga la p
144
168
  | `hold-expired` | — | Se acabó el tiempo de la retención. |
145
169
  | `hold-token-change` | `{ token, expiresAt }` o `null` | El token de retención ha cambiado. |
146
170
  | `floor-change` | `{ id, name }` | Se muestra otra planta. |
171
+ | `selection-invalid`, `selection-valid` | las butacas sueltas (`[{ type: "orphan-seats", objects }]`), o nada | Con `no-orphan-seats`: la selección deja butacas sueltas, o ya no. |
172
+ | `sector-change` | `{ id, name }` (`SectorInfo`) o `null` | Se entra en un sector (al pulsar su plancha, con el teclado o con `openSector`), se pasa a otro o se sale (`null`). Ver «Sectores». |
147
173
  | `error` | `{ code, message }` | Algo ha fallado, o se ha llegado a un tope de retención (ver «Topes de retención»). Sin oyente de `@error`, se escribe en la consola. |
148
174
 
149
175
  Los eventos llegan siempre a los oyentes de ese momento: cambiarlos no vuelve a montar el visor. En TypeScript (y
@@ -152,9 +178,49 @@ en las funciones `render`), los oyentes son `onReady`, `onChange`, `onHoldExpire
152
178
  ### Lo que expone
153
179
 
154
180
  Con una ref de plantilla, `chart` es el visor montado (un `SeatingChart`): `getSelection()`, `holdToken`,
155
- `holdExpiresAt`, `clearSelection()`, `selectBestAvailable(n)`, `setFloor(id)`, `show3d()`, `zoomToFit()`,
156
- `refresh()`… Vale `null` mientras no hay visor: en el servidor, antes de montarlo y después de desmontarlo. Si
157
- cambia una opción que lo vuelve a montar, `chart` pasa a ser el visor nuevo.
181
+ `holdExpiresAt`, `clearSelection()`, `selectBestAvailable(n, categorías?, sectores?)`, `setFloor(id)`,
182
+ `openSector(sector)`, `closeSector()`, `currentSector`, `show3d()`, `zoomToFit()`, `refresh()`… Vale `null` mientras
183
+ no hay visor: en el servidor, antes de montarlo y después de desmontarlo. Si cambia una opción que lo vuelve a montar,
184
+ `chart` pasa a ser el visor nuevo.
185
+
186
+ ### Sectores
187
+
188
+ En un plano con sectores (o en uno grande), de lejos cada sector se ve como una plancha con su nombre y sus plazas
189
+ libres; al pulsarla se entra en él (solo lo suyo se ve vivo, y los demás sectores se quedan como planchas para pasar a
190
+ otro), y «← Todo el recinto» o Esc vuelven a verlo todo. `@sector-change` avisa al entrar en un sector, `{ id, name }`
191
+ (`SectorInfo`), y al salir, `null`; con `chart`, tus botones hacen lo mismo:
192
+
193
+ ```vue
194
+ <script setup lang="ts">
195
+ import { SeatsyooChart, type SectorInfo } from "@seatsyoo/vue";
196
+ import { ref } from "vue";
197
+
198
+ const plano = ref<InstanceType<typeof SeatsyooChart> | null>(null);
199
+ const sector = ref<SectorInfo | null>(null);
200
+ </script>
201
+
202
+ <template>
203
+ <!-- Al volver a montar el visor con un sector abierto, avisa null: el nuevo empieza con el recinto entero. -->
204
+ <SeatsyooChart
205
+ ref="plano"
206
+ server="https://seatsyoo.example"
207
+ public-key="pk_tu_clave_publica"
208
+ event="hamlet-2026-11-20"
209
+ style="height: 600px"
210
+ @sector-change="(s: SectorInfo | null) => (sector = s)"
211
+ />
212
+ <p>{{ sector ? sector.name : "Todo el recinto" }}</p>
213
+ <!-- Por el id de su sección o por su nombre; false si el plano no se ve por sectores o no lo tiene. -->
214
+ <button @click="plano?.chart?.openSector('Platea')">Platea</button>
215
+ <button :disabled="!sector" @click="plano?.chart?.closeSector()">Todo el recinto</button>
216
+ <!-- Con un sector abierto, en él; el tercer parámetro (ids o nombres) manda sobre el abierto y [] es todo. -->
217
+ <button @click="plano?.chart?.selectBestAvailable(2)">Las 2 mejores</button>
218
+ </template>
219
+ ```
220
+
221
+ `currentSector` es el sector abierto o `null`; su `id` es el de la sección dibujada del sector, o `null` si el sector
222
+ sale del nombre de sección de sus filas. Si «mejor disponible» encuentra plazas de otro sector, el visor pasa a él (y
223
+ avisa).
158
224
 
159
225
  ### Errores
160
226
 
@@ -315,14 +381,30 @@ npm install @seatsyoo/vue
315
381
  - **Props**: every viewer option except `container` and the callbacks; `class`, `style`, `id` and other attributes
316
382
  go to the wrapping `<div>`. `app.use(SeatsyooPlugin)` registers `<SeatsyooChart>` globally.
317
383
  - **Events**: `ready`, `change`, `select`, `deselect`, `error`, `hold-expired`, `hold-token-change`,
318
- `floor-change`. They always reach the current listeners; without an `@error` listener, errors go to the console.
384
+ `floor-change`, `selection-invalid`, `selection-valid` (with `noOrphanSeats`), `sector-change`. They always reach the current listeners; without an `@error` listener, errors go to the console.
319
385
  - **Re-mounting**: changing `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`,
320
386
  `channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`,
321
- `showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance` or `texts` destroys the viewer and mounts a new one (arrays
387
+ `showLegend`, `showSelectionBar`, `showHoldTimer`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`,
388
+ `unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures`, `minTargetSize` or `keyboardHint` destroys the viewer and mounts a new one (arrays
322
389
  and objects are compared by value). `theme` and `colorBy` are applied live (`setTheme`, `setColorBy`), and so
323
- are `statusStyles` and `marks` (`"manager"` mode: `setStatusStyles`, `setMarks`), only when their value changes
390
+ are `spotlight` (`setSpotlight`), `objectColor` (`setObjectColor`, when it is another function) and
391
+ `statusStyles` and `marks` (`"manager"` mode: `setStatusStyles`, `setMarks`), only when their value changes
324
392
  (compared as data: the prototype doesn't matter and a key set to `undefined` counts as missing; a reactive object
325
393
  changed in place counts too).
394
+ - **Wheel and fingers**: with `gestures` `"auto"` (the default), if your page scrolls (or the viewer is in an iframe),
395
+ the wheel alone and one finger scroll the page; the chart zooms with Ctrl/⌘ + scroll or a pinch and pans by dragging
396
+ with the mouse or two fingers, and a short hint says so. `"free"` gives them to the chart, `"cooperative"` always
397
+ to the page. `minTargetSize` (`{ touch: 24, mouse: 6 }` px) makes the first tap zoom in (at least ×2) instead of
398
+ picking when seats look smaller; `false` turns it off.
399
+ - **Keyboard and screen reader**: nothing to turn on. The chart is a single Tab stop; inside, the arrow keys move a
400
+ cursor over the seats, `Enter` or `Space` selects or removes like a tap, and from afar the cursor moves between
401
+ sectors (`Enter` goes in, `Esc` comes back). **Plain arrows no longer pan the chart: `Shift` + arrows does**; `?`
402
+ shows the shortcuts. The first time the keyboard reaches the chart (once per browser session) a short hint shows the
403
+ keys: `:keyboard-hint="false"` removes it. For screen readers the chart is a `role="grid"` (no longer
404
+ `role="application"`) and seats are cells with `aria-selected` and `aria-disabled` (they were buttons with
405
+ `aria-pressed`).
406
+ - **Hold timer**: `:show-hold-timer="false"` removes the countdown from the selection bar and keeps the rest;
407
+ `:show-selection-bar="false"` removes the whole bar. The hold still expires: `@hold-expired`.
326
408
  - **Prices**: Seatsyoo does not store prices. Pass yours with `pricing` (per category key, with `currency` and
327
409
  `locale`): the viewer shows them and they come in `price` of each selected object (`null` without `pricing`).
328
410
  `price` is what each unit of `quantity` costs (per place; a whole table, all its chairs), so `price × quantity` adds
@@ -357,6 +439,11 @@ npm install @seatsyoo/vue
357
439
  (your server books or releases them, e.g. a multi-show cart), and nothing is released on unmount.
358
440
  - **`document`** is not copied: changing it in place goes unnoticed; pass a new object without mutating the old one.
359
441
  - **Exposed**: `chart`, the mounted `SeatingChart` (or `null` on the server, before mounting and after unmounting).
442
+ - **Sectors**: `sector-change` fires with `{ id, name }` (`SectorInfo`) when a sector is entered and `null` when it is
443
+ left; through `chart`, `openSector(idOrName)` (`false` if the chart is not shown by sectors or has no such sector),
444
+ `closeSector()`, `currentSector` and `selectBestAvailable(n, categories?, sectors?)` (with a sector open, it searches
445
+ there; `sectors` overrides it and `[]` is the whole venue). A remounted viewer starts with the whole venue; if a sector was
446
+ open, `sector-change` with `null` reports it.
360
447
  - **Invalid options** don't throw: the `error` event gets `{ code: "invalid-options", message }`.
361
448
  - **SSR**: renders an empty `<div>` on the server and mounts the viewer in `onMounted`.
362
449
  - **3D view**: downloaded from `${server}/sdk/butacas-3d.js` when opened (allow it in your CSP `script-src`, or
@@ -1,4 +1,4 @@
1
- import { type ChartDocument, type Language, type SeatingChart, type SelectedObject, type StatusStyle, type View3DModule } from "@seatsyoo/visor";
1
+ import { type ChartDocument, type Language, type RenderOptions, type SeatingChart, type SectorInfo, type SelectedObject, type StatusStyle, type View3DModule } from "@seatsyoo/visor";
2
2
  import { type ComponentOptionsMixin, type DefineComponent, type ExtractPublicPropTypes, type Plugin, type PropType } from "vue";
3
3
  import { SeatsyooDesigner } from "./SeatsyooDesigner.js";
4
4
  declare const props: {
@@ -60,6 +60,11 @@ declare const props: {
60
60
  type: BooleanConstructor;
61
61
  default: undefined;
62
62
  };
63
+ /** El reloj de la retención en la barra de lo elegido (por defecto sí): `false` lo quita y deja el resto. */
64
+ showHoldTimer: {
65
+ type: BooleanConstructor;
66
+ default: undefined;
67
+ };
63
68
  /** Planta que se muestra al abrir (id). */
64
69
  floor: StringConstructor;
65
70
  sectors: {
@@ -81,6 +86,54 @@ declare const props: {
81
86
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
82
87
  */
83
88
  texts: PropType<Record<string, string>>;
89
+ /**
90
+ * Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
91
+ * `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
92
+ */
93
+ noOrphanSeats: {
94
+ type: PropType<RenderOptions["noOrphanSeats"]>;
95
+ default: undefined;
96
+ };
97
+ /**
98
+ * Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
99
+ * montar (setObjectColor): otra función repinta el plano.
100
+ */
101
+ objectColor: PropType<RenderOptions["objectColor"]>;
102
+ /** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
103
+ spotlight: PropType<string[]>;
104
+ /** Categorías que no se pueden elegir: se ven como no disponibles. */
105
+ unavailableCategories: PropType<string[]>;
106
+ /** Botón de pantalla completa (por defecto, no). */
107
+ fullscreenButton: {
108
+ type: BooleanConstructor;
109
+ default: undefined;
110
+ };
111
+ /** Selección por rectángulo (por defecto, no). */
112
+ multiSelect: {
113
+ type: BooleanConstructor;
114
+ default: undefined;
115
+ };
116
+ /**
117
+ * La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
118
+ * pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
119
+ */
120
+ gestures: PropType<NonNullable<RenderOptions["gestures"]>>;
121
+ /**
122
+ * Tamaño mínimo en píxeles de lo que se elige (por defecto `{ touch: 24, mouse: 6 }`): más pequeño, el primer toque
123
+ * acerca. Un número vale para el dedo y el ratón; `false` lo quita.
124
+ */
125
+ minTargetSize: {
126
+ type: PropType<RenderOptions["minTargetSize"]>;
127
+ default: undefined;
128
+ };
129
+ /**
130
+ * La pista de atajos del teclado, que sale la primera vez que se entra en el plano con el teclado (por defecto sí):
131
+ * `false` la quita (la tecla «?» la enseña igual). El teclado funciona siempre.
132
+ */
133
+ keyboardHint: {
134
+ type: BooleanConstructor;
135
+ default: undefined;
136
+ };
84
137
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
85
138
  load3d: PropType<() => Promise<View3DModule>>;
86
139
  };
@@ -108,12 +161,21 @@ declare const emits: {
108
161
  id: string;
109
162
  name: string;
110
163
  }) => boolean;
164
+ /** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
165
+ selectionValid: () => boolean;
166
+ /** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
167
+ selectionInvalid: (problems: Parameters<NonNullable<RenderOptions["onSelectionInvalid"]>>[0]) => boolean;
168
+ /** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
169
+ sectorChange: (sector: SectorInfo | null) => boolean;
111
170
  };
112
171
  /** Props de SeatsyooChart: las opciones del visor, sin `container` ni los avisos (que son eventos). */
113
172
  export type SeatsyooChartProps = ExtractPublicPropTypes<typeof props>;
114
173
  /** Lo que expone el componente a una ref de plantilla. */
115
174
  export interface SeatsyooChartExposed {
116
- /** El visor montado (`getSelection()`, `holdToken`…), o null mientras no hay ninguno. */
175
+ /**
176
+ * El visor montado (`getSelection()`, `holdToken`, `openSector()`, `currentSector`…), o null mientras no hay
177
+ * ninguno.
178
+ */
117
179
  chart: SeatingChart | null;
118
180
  }
119
181
  /**
@@ -136,8 +198,8 @@ export type SeatsyooChartComponent = DefineComponent<typeof props, SeatsyooChart
136
198
  * />
137
199
  * ```
138
200
  *
139
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
140
- * mientras no hay ninguno.
201
+ * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
202
+ * o `null` mientras no hay ninguno.
141
203
  */
142
204
  export declare const SeatsyooChart: SeatsyooChartComponent;
143
205
  /** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
@@ -65,6 +65,8 @@ const props = {
65
65
  marks: Object,
66
66
  showLegend: { type: Boolean, default: undefined },
67
67
  showSelectionBar: { type: Boolean, default: undefined },
68
+ /** El reloj de la retención en la barra de lo elegido (por defecto sí): `false` lo quita y deja el resto. */
69
+ showHoldTimer: { type: Boolean, default: undefined },
68
70
  /** Planta que se muestra al abrir (id). */
69
71
  floor: String,
70
72
  sectors: { type: Boolean, default: undefined },
@@ -77,6 +79,39 @@ const props = {
77
79
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
78
80
  */
79
81
  texts: Object,
82
+ /**
83
+ * Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
84
+ * `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
85
+ */
86
+ noOrphanSeats: { type: [Boolean, Object], default: undefined },
87
+ /**
88
+ * Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
89
+ * montar (setObjectColor): otra función repinta el plano.
90
+ */
91
+ objectColor: Function,
92
+ /** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
93
+ spotlight: Array,
94
+ /** Categorías que no se pueden elegir: se ven como no disponibles. */
95
+ unavailableCategories: Array,
96
+ /** Botón de pantalla completa (por defecto, no). */
97
+ fullscreenButton: { type: Boolean, default: undefined },
98
+ /** Selección por rectángulo (por defecto, no). */
99
+ multiSelect: { type: Boolean, default: undefined },
100
+ /**
101
+ * La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
102
+ * pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
103
+ */
104
+ gestures: String,
105
+ /**
106
+ * Tamaño mínimo en píxeles de lo que se elige (por defecto `{ touch: 24, mouse: 6 }`): más pequeño, el primer toque
107
+ * acerca. Un número vale para el dedo y el ratón; `false` lo quita.
108
+ */
109
+ minTargetSize: { type: [Number, Boolean, Object], default: undefined },
110
+ /**
111
+ * La pista de atajos del teclado, que sale la primera vez que se entra en el plano con el teclado (por defecto sí):
112
+ * `false` la quita (la tecla «?» la enseña igual). El teclado funciona siempre.
113
+ */
114
+ keyboardHint: { type: Boolean, default: undefined },
80
115
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
81
116
  load3d: Function,
82
117
  };
@@ -96,6 +131,12 @@ const emits = {
96
131
  holdTokenChange: (token) => true,
97
132
  /** Se muestra otra planta (`@floor-change`). */
98
133
  floorChange: (floor) => true,
134
+ /** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
135
+ selectionValid: () => true,
136
+ /** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
137
+ selectionInvalid: (problems) => true,
138
+ /** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
139
+ sectorChange: (sector) => true,
99
140
  };
100
141
  // El componente; su tipo público es SeatsyooChartComponent (abajo).
101
142
  const componente = defineComponent({
@@ -137,7 +178,11 @@ const componente = defineComponent({
137
178
  // que se va, con sus avisos (deselect y change con la selección vacía). Al desmontar el componente, no.
138
179
  if (chart.value && montada && sueltaAlCambiar(montada, nueva))
139
180
  void chart.value.clearSelection();
181
+ // El visor nuevo empieza con el recinto entero: si había un sector abierto, se avisa null (como al salir de él).
182
+ const salDelSector = chart.value?.currentSector != null;
140
183
  desmontar();
184
+ if (salDelSector)
185
+ emit("sectorChange", null);
141
186
  const div = el.value;
142
187
  if (!div)
143
188
  return;
@@ -158,6 +203,9 @@ const componente = defineComponent({
158
203
  onHoldExpired: () => emit("holdExpired"),
159
204
  onHoldTokenChange: (t) => emit("holdTokenChange", t),
160
205
  onFloorChange: (f) => emit("floorChange", f),
206
+ onSelectionValid: () => emit("selectionValid"),
207
+ onSelectionInvalid: (p) => emit("selectionInvalid", p),
208
+ onSectorChange: (s) => emit("sectorChange", s),
161
209
  onError: (e) => (escuchanError() ? emit("error", e) : avisarEnConsola(e)),
162
210
  // Solo si hay load3d (si no, el visor pide la 3D al servidor); ponerlo o quitarlo cambia la identidad.
163
211
  ...(hayLoad3d && load3d ? { load3d: () => (props.load3d ?? load3d)() } : {}),
@@ -187,7 +235,14 @@ const componente = defineComponent({
187
235
  montar(nueva);
188
236
  });
189
237
  // Copiar statusStyles y marks lee todo lo que tienen: así también avisa si se cambian en el sitio (reactivos).
190
- watch(() => ({ theme: props.theme, colorBy: props.colorBy, statusStyles: copiaDeDatos(props.statusStyles), marks: copiaDeDatos(props.marks) }), (vivas) => {
238
+ watch(() => ({
239
+ theme: props.theme,
240
+ colorBy: props.colorBy,
241
+ statusStyles: copiaDeDatos(props.statusStyles),
242
+ marks: copiaDeDatos(props.marks),
243
+ spotlight: props.spotlight && [...props.spotlight],
244
+ objectColor: props.objectColor,
245
+ }), (vivas) => {
191
246
  const c = chart.value;
192
247
  if (c)
193
248
  aplicarEnVivo(c, aplicadas, vivas);
@@ -213,8 +268,8 @@ const componente = defineComponent({
213
268
  * />
214
269
  * ```
215
270
  *
216
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
217
- * mientras no hay ninguno.
271
+ * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
272
+ * o `null` mientras no hay ninguno.
218
273
  */
219
274
  export const SeatsyooChart = componente;
220
275
  /** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
package/dist/index.d.ts CHANGED
@@ -1,3 +1,3 @@
1
1
  export { SeatsyooChart, type SeatsyooChartExposed, type SeatsyooChartProps, SeatsyooPlugin } from "./SeatsyooChart.js";
2
2
  export { SeatsyooDesigner, type SeatsyooDesignerExposed, type SeatsyooDesignerProps } from "./SeatsyooDesigner.js";
3
- export type { ChartDocument, EmbeddedDesigner, EmbeddedDesignerOptions, Language, RenderOptions, SeatingChart, SelectedObject, StatusStyle, } from "@seatsyoo/visor";
3
+ export type { ChartDocument, EmbeddedDesigner, EmbeddedDesignerOptions, Language, RenderOptions, SeatingChart, SectorInfo, SelectedObject, StatusStyle, } from "@seatsyoo/visor";
@@ -3,21 +3,24 @@ import type { RenderOptions, SeatingChart } from "@seatsyoo/visor";
3
3
  * Opciones que, si cambian, vuelven a montar el visor: deciden qué se carga y cómo se vende. Los arrays y los
4
4
  * objetos se comparan por su valor, no por la referencia: `:channels="['web']"` en cada render no remonta.
5
5
  */
6
- export declare const OPCIONES_DE_IDENTIDAD: readonly ["server", "publicKey", "event", "link", "document", "season", "seasonEvents", "channels", "pricing", "currency", "locale", "language", "maxSelected", "session", "holdToken", "mode", "showLegend", "showSelectionBar", "floor", "sectors", "view3d", "entrance", "texts"];
6
+ export declare const OPCIONES_DE_IDENTIDAD: readonly ["server", "publicKey", "event", "link", "document", "season", "seasonEvents", "channels", "pricing", "currency", "locale", "language", "maxSelected", "session", "holdToken", "mode", "showLegend", "showSelectionBar", "floor", "sectors", "view3d", "entrance", "texts", "noOrphanSeats", "unavailableCategories", "fullscreenButton", "multiSelect", "gestures", "minTargetSize", "showHoldTimer", "keyboardHint"];
7
7
  /**
8
- * Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy) y, para
9
- * el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks). Se
10
- * comparan por valor, como las de identidad: un objeto nuevo con lo mismo no llama a nada.
8
+ * Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy); para
9
+ * el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks); y, del
10
+ * visor de main del 25 oct 2026, el foco (setSpotlight) y el color propio de cada objeto (setObjectColor). Se comparan por
11
+ * valor, como las de identidad: un objeto nuevo con lo mismo no llama a nada. objectColor es una función: cuenta si es
12
+ * otra (y entonces el visor repinta).
11
13
  */
12
- export declare const OPCIONES_EN_VIVO: readonly ["theme", "colorBy", "statusStyles", "marks"];
14
+ export declare const OPCIONES_EN_VIVO: readonly ["theme", "colorBy", "statusStyles", "marks", "spotlight", "objectColor"];
13
15
  /** Avisos del visor: siempre llaman a la última función recibida, sin volver a montar. */
14
- export declare const AVISOS: readonly ["onReady", "onChange", "onSelect", "onDeselect", "onError", "onHoldExpired", "onHoldTokenChange", "onFloorChange"];
16
+ export declare const AVISOS: readonly ["onReady", "onChange", "onSelect", "onDeselect", "onError", "onHoldExpired", "onHoldTokenChange", "onFloorChange", "onSelectionValid", "onSelectionInvalid", "onSectorChange"];
15
17
  type ClaveDeIdentidad = (typeof OPCIONES_DE_IDENTIDAD)[number];
16
18
  /**
17
19
  * Cada opción del visor tiene aquí su regla (vuelve a montar, se aplica en vivo o es un aviso). Si el visor gana una
18
20
  * opción nueva, esto deja de compilar hasta decidir qué hace el componente con ella: pasó con `entrance` y `texts`,
19
- * que llegaron al visor sin que el componente las pasara, y con `statusStyles` y `marks` (en vivo: el visor tiene
20
- * setStatusStyles y setMarks).
21
+ * que llegaron al visor sin que el componente las pasara; con `statusStyles` y `marks` (en vivo: el visor tiene
22
+ * setStatusStyles y setMarks); con las del visor de main del 25 oct 2026, con `gestures` y `minTargetSize`
23
+ * (13 nov 2026), con `onSectorChange` (un evento, del mismo día) y con `showHoldTimer` y `keyboardHint` (22 nov 2026).
21
24
  */
22
25
  type SinRegla = Exclude<keyof RenderOptions, ClaveDeIdentidad | (typeof OPCIONES_EN_VIVO)[number] | (typeof AVISOS)[number] | "container" | "load3d">;
23
26
  type DebeSerNever<T extends never> = T;
@@ -52,19 +55,24 @@ export interface EnVivo {
52
55
  colorBy: NonNullable<RenderOptions["colorBy"]>;
53
56
  statusStyles: NonNullable<RenderOptions["statusStyles"]>;
54
57
  marks: NonNullable<RenderOptions["marks"]>;
58
+ /** El foco: una copia de la lista, o null sin foco. */
59
+ spotlight: string[] | null;
60
+ /** La función de color propia, la misma que llegó (se compara por referencia), o null. */
61
+ objectColor: NonNullable<RenderOptions["objectColor"]> | null;
55
62
  }
56
63
  /**
57
64
  * Las opciones en vivo con que se monta un visor. Sin theme ni colorBy, los del visor por defecto; sin statusStyles ni
58
- * marks, ninguno (`{}`, que para el visor es lo mismo que no pasarlas).
65
+ * marks, ninguno (`{}`, que para el visor es lo mismo que no pasarlas); sin spotlight ni objectColor, null.
59
66
  */
60
67
  export declare function enVivoDe(opciones: Partial<RenderOptions>): EnVivo;
61
68
  /** Lo que hay que añadir a las opciones de `render` para montar con estas opciones en vivo (las copias guardadas). */
62
69
  export declare function opcionesEnVivo(opciones: Partial<RenderOptions>, enVivo: EnVivo): Partial<RenderOptions>;
63
70
  /** Los métodos del visor con que se aplican las opciones en vivo. */
64
- export type VisorEnVivo = Pick<SeatingChart, "setTheme" | "setColorBy" | "setStatusStyles" | "setMarks">;
71
+ export type VisorEnVivo = Pick<SeatingChart, "setTheme" | "setColorBy" | "setStatusStyles" | "setMarks" | "setSpotlight" | "setObjectColor">;
65
72
  /**
66
73
  * Lleva al visor montado las opciones en vivo que han cambiado (por valor) desde `aplicadas`, y las apunta en
67
- * `aplicadas`. Quitar una es volver a la de por defecto: el tema claro, el color por categoría, sin estilos ni marcas.
74
+ * `aplicadas`. Quitar una es volver a la de por defecto: el tema claro, el color por categoría, sin estilos ni marcas,
75
+ * sin foco y sin color propio.
68
76
  */
69
77
  export declare function aplicarEnVivo(visor: VisorEnVivo, aplicadas: EnVivo, opciones: Partial<RenderOptions>): void;
70
78
  /** Las opciones sin las que valen `undefined` (el visor usa entonces su valor por defecto). */
package/dist/opciones.js CHANGED
@@ -26,13 +26,27 @@ export const OPCIONES_DE_IDENTIDAD = [
26
26
  "view3d",
27
27
  "entrance",
28
28
  "texts",
29
+ // Del visor de main (25 oct 2026): no tienen método para cambiarlas en el visor montado.
30
+ "noOrphanSeats",
31
+ "unavailableCategories",
32
+ "fullscreenButton",
33
+ "multiSelect",
34
+ // Del visor de main (13 nov 2026): cómo se reparten la rueda y los dedos, y el tamaño mínimo para elegir.
35
+ "gestures",
36
+ "minTargetSize",
37
+ // Del visor de main (22 nov 2026): el reloj de la retención en la barra de lo elegido y la pista de atajos del
38
+ // teclado. Tampoco tienen método para cambiarlas en el visor montado.
39
+ "showHoldTimer",
40
+ "keyboardHint",
29
41
  ];
30
42
  /**
31
- * Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy) y, para
32
- * el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks). Se
33
- * comparan por valor, como las de identidad: un objeto nuevo con lo mismo no llama a nada.
43
+ * Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy); para
44
+ * el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks); y, del
45
+ * visor de main del 25 oct 2026, el foco (setSpotlight) y el color propio de cada objeto (setObjectColor). Se comparan por
46
+ * valor, como las de identidad: un objeto nuevo con lo mismo no llama a nada. objectColor es una función: cuenta si es
47
+ * otra (y entonces el visor repinta).
34
48
  */
35
- export const OPCIONES_EN_VIVO = ["theme", "colorBy", "statusStyles", "marks"];
49
+ export const OPCIONES_EN_VIVO = ["theme", "colorBy", "statusStyles", "marks", "spotlight", "objectColor"];
36
50
  /** Avisos del visor: siempre llaman a la última función recibida, sin volver a montar. */
37
51
  export const AVISOS = [
38
52
  "onReady",
@@ -43,6 +57,11 @@ export const AVISOS = [
43
57
  "onHoldExpired",
44
58
  "onHoldTokenChange",
45
59
  "onFloorChange",
60
+ // Con noOrphanSeats (del visor de main, 25 oct 2026).
61
+ "onSelectionValid",
62
+ "onSelectionInvalid",
63
+ // Se entra en un sector o se sale de él (del visor de la rama sectores-subplano, 13 nov 2026).
64
+ "onSectorChange",
46
65
  ];
47
66
  export function identidadDe(opciones) {
48
67
  const identidad = { load3d: typeof opciones.load3d === "function" };
@@ -108,7 +127,7 @@ export function copiaDeDatos(valor) {
108
127
  }
109
128
  /**
110
129
  * Las opciones en vivo con que se monta un visor. Sin theme ni colorBy, los del visor por defecto; sin statusStyles ni
111
- * marks, ninguno (`{}`, que para el visor es lo mismo que no pasarlas).
130
+ * marks, ninguno (`{}`, que para el visor es lo mismo que no pasarlas); sin spotlight ni objectColor, null.
112
131
  */
113
132
  export function enVivoDe(opciones) {
114
133
  return {
@@ -116,6 +135,8 @@ export function enVivoDe(opciones) {
116
135
  colorBy: opciones.colorBy ?? "category",
117
136
  statusStyles: copiaDeDatos(opciones.statusStyles ?? {}),
118
137
  marks: copiaDeDatos(opciones.marks ?? {}),
138
+ spotlight: opciones.spotlight ? [...opciones.spotlight] : null,
139
+ objectColor: opciones.objectColor ?? null,
119
140
  };
120
141
  }
121
142
  /** Lo que hay que añadir a las opciones de `render` para montar con estas opciones en vivo (las copias guardadas). */
@@ -125,11 +146,14 @@ export function opcionesEnVivo(opciones, enVivo) {
125
146
  colorBy: opciones.colorBy,
126
147
  statusStyles: opciones.statusStyles && enVivo.statusStyles,
127
148
  marks: opciones.marks && enVivo.marks,
149
+ spotlight: enVivo.spotlight ?? undefined,
150
+ objectColor: enVivo.objectColor ?? undefined,
128
151
  });
129
152
  }
130
153
  /**
131
154
  * Lleva al visor montado las opciones en vivo que han cambiado (por valor) desde `aplicadas`, y las apunta en
132
- * `aplicadas`. Quitar una es volver a la de por defecto: el tema claro, el color por categoría, sin estilos ni marcas.
155
+ * `aplicadas`. Quitar una es volver a la de por defecto: el tema claro, el color por categoría, sin estilos ni marcas,
156
+ * sin foco y sin color propio.
133
157
  */
134
158
  export function aplicarEnVivo(visor, aplicadas, opciones) {
135
159
  const tema = opciones.theme ?? "light";
@@ -154,6 +178,19 @@ export function aplicarEnVivo(visor, aplicadas, opciones) {
154
178
  aplicadas.marks = marcas;
155
179
  visor.setMarks(marcas);
156
180
  }
181
+ // El foco, por valor (una lista nueva con lo mismo no repinta); el visor recibe su propia copia.
182
+ const foco = opciones.spotlight ? [...opciones.spotlight] : null;
183
+ if (!igual(foco, aplicadas.spotlight)) {
184
+ aplicadas.spotlight = foco;
185
+ visor.setSpotlight(foco && [...foco]);
186
+ }
187
+ // El color propio, por referencia: otra función repinta todo el plano (en React, con useCallback no cambia en cada
188
+ // render).
189
+ const colorPropio = opciones.objectColor ?? null;
190
+ if (colorPropio !== aplicadas.objectColor) {
191
+ aplicadas.objectColor = colorPropio;
192
+ visor.setObjectColor(colorPropio);
193
+ }
157
194
  }
158
195
  /** Las opciones sin las que valen `undefined` (el visor usa entonces su valor por defecto). */
159
196
  export function sinIndefinidos(opciones) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seatsyoo/vue",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "description": "Componente de Vue para el visor de mapas de asientos de Seatsyoo: elegir butacas, retenerlas y venderlas en tiempo real.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -27,7 +27,7 @@
27
27
  "dist/*.d.ts"
28
28
  ],
29
29
  "dependencies": {
30
- "@seatsyoo/visor": "^1.1.0"
30
+ "@seatsyoo/visor": "^1.3.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "vue": "^3.3.0"