@seatsyoo/vue 1.1.0 → 1.2.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,24 @@ 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`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`, `unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures`, `minTargetSize` | 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
+
101
110
  **Lo que el comprador tiene retenido al volver a montar.** Si es en el mismo evento y con `session: "continue"` (por
102
111
  defecto), el visor nuevo lo recupera. Si el nuevo no puede recuperarlo (has cambiado de evento o de temporada, de
103
112
  `server` o de `publicKey`, usas `session: "start"`, le pasas un `holdToken` o el modo `"manager"`), el componente lo
@@ -144,6 +153,8 @@ Lo que se cobra lo calcula tu servidor con sus precios, no con lo que diga la p
144
153
  | `hold-expired` | — | Se acabó el tiempo de la retención. |
145
154
  | `hold-token-change` | `{ token, expiresAt }` o `null` | El token de retención ha cambiado. |
146
155
  | `floor-change` | `{ id, name }` | Se muestra otra planta. |
156
+ | `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. |
157
+ | `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
158
  | `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
159
 
149
160
  Los eventos llegan siempre a los oyentes de ese momento: cambiarlos no vuelve a montar el visor. En TypeScript (y
@@ -152,9 +163,49 @@ en las funciones `render`), los oyentes son `onReady`, `onChange`, `onHoldExpire
152
163
  ### Lo que expone
153
164
 
154
165
  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.
166
+ `holdExpiresAt`, `clearSelection()`, `selectBestAvailable(n, categorías?, sectores?)`, `setFloor(id)`,
167
+ `openSector(sector)`, `closeSector()`, `currentSector`, `show3d()`, `zoomToFit()`, `refresh()`… Vale `null` mientras
168
+ no hay visor: en el servidor, antes de montarlo y después de desmontarlo. Si cambia una opción que lo vuelve a montar,
169
+ `chart` pasa a ser el visor nuevo.
170
+
171
+ ### Sectores
172
+
173
+ En un plano con sectores (o en uno grande), de lejos cada sector se ve como una plancha con su nombre y sus plazas
174
+ 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
175
+ otro), y «← Todo el recinto» o Esc vuelven a verlo todo. `@sector-change` avisa al entrar en un sector, `{ id, name }`
176
+ (`SectorInfo`), y al salir, `null`; con `chart`, tus botones hacen lo mismo:
177
+
178
+ ```vue
179
+ <script setup lang="ts">
180
+ import { SeatsyooChart, type SectorInfo } from "@seatsyoo/vue";
181
+ import { ref } from "vue";
182
+
183
+ const plano = ref<InstanceType<typeof SeatsyooChart> | null>(null);
184
+ const sector = ref<SectorInfo | null>(null);
185
+ </script>
186
+
187
+ <template>
188
+ <!-- Al volver a montar el visor con un sector abierto, avisa null: el nuevo empieza con el recinto entero. -->
189
+ <SeatsyooChart
190
+ ref="plano"
191
+ server="https://seatsyoo.example"
192
+ public-key="pk_tu_clave_publica"
193
+ event="hamlet-2026-11-20"
194
+ style="height: 600px"
195
+ @sector-change="(s: SectorInfo | null) => (sector = s)"
196
+ />
197
+ <p>{{ sector ? sector.name : "Todo el recinto" }}</p>
198
+ <!-- Por el id de su sección o por su nombre; false si el plano no se ve por sectores o no lo tiene. -->
199
+ <button @click="plano?.chart?.openSector('Platea')">Platea</button>
200
+ <button :disabled="!sector" @click="plano?.chart?.closeSector()">Todo el recinto</button>
201
+ <!-- Con un sector abierto, en él; el tercer parámetro (ids o nombres) manda sobre el abierto y [] es todo. -->
202
+ <button @click="plano?.chart?.selectBestAvailable(2)">Las 2 mejores</button>
203
+ </template>
204
+ ```
205
+
206
+ `currentSector` es el sector abierto o `null`; su `id` es el de la sección dibujada del sector, o `null` si el sector
207
+ sale del nombre de sección de sus filas. Si «mejor disponible» encuentra plazas de otro sector, el visor pasa a él (y
208
+ avisa).
158
209
 
159
210
  ### Errores
160
211
 
@@ -315,14 +366,21 @@ npm install @seatsyoo/vue
315
366
  - **Props**: every viewer option except `container` and the callbacks; `class`, `style`, `id` and other attributes
316
367
  go to the wrapping `<div>`. `app.use(SeatsyooPlugin)` registers `<SeatsyooChart>` globally.
317
368
  - **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.
369
+ `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
370
  - **Re-mounting**: changing `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`,
320
371
  `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
372
+ `showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`,
373
+ `unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures` or `minTargetSize` destroys the viewer and mounts a new one (arrays
322
374
  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
375
+ are `spotlight` (`setSpotlight`), `objectColor` (`setObjectColor`, when it is another function) and
376
+ `statusStyles` and `marks` (`"manager"` mode: `setStatusStyles`, `setMarks`), only when their value changes
324
377
  (compared as data: the prototype doesn't matter and a key set to `undefined` counts as missing; a reactive object
325
378
  changed in place counts too).
379
+ - **Wheel and fingers**: with `gestures` `"auto"` (the default), if your page scrolls (or the viewer is in an iframe),
380
+ the wheel alone and one finger scroll the page; the chart zooms with Ctrl/⌘ + scroll or a pinch and pans by dragging
381
+ with the mouse or two fingers, and a short hint says so. `"free"` gives them to the chart, `"cooperative"` always
382
+ to the page. `minTargetSize` (`{ touch: 24, mouse: 6 }` px) makes the first tap zoom in (at least ×2) instead of
383
+ picking when seats look smaller; `false` turns it off.
326
384
  - **Prices**: Seatsyoo does not store prices. Pass yours with `pricing` (per category key, with `currency` and
327
385
  `locale`): the viewer shows them and they come in `price` of each selected object (`null` without `pricing`).
328
386
  `price` is what each unit of `quantity` costs (per place; a whole table, all its chairs), so `price × quantity` adds
@@ -357,6 +415,11 @@ npm install @seatsyoo/vue
357
415
  (your server books or releases them, e.g. a multi-show cart), and nothing is released on unmount.
358
416
  - **`document`** is not copied: changing it in place goes unnoticed; pass a new object without mutating the old one.
359
417
  - **Exposed**: `chart`, the mounted `SeatingChart` (or `null` on the server, before mounting and after unmounting).
418
+ - **Sectors**: `sector-change` fires with `{ id, name }` (`SectorInfo`) when a sector is entered and `null` when it is
419
+ left; through `chart`, `openSector(idOrName)` (`false` if the chart is not shown by sectors or has no such sector),
420
+ `closeSector()`, `currentSector` and `selectBestAvailable(n, categories?, sectors?)` (with a sector open, it searches
421
+ there; `sectors` overrides it and `[]` is the whole venue). A remounted viewer starts with the whole venue; if a sector was
422
+ open, `sector-change` with `null` reports it.
360
423
  - **Invalid options** don't throw: the `error` event gets `{ code: "invalid-options", message }`.
361
424
  - **SSR**: renders an empty `<div>` on the server and mounts the viewer in `onMounted`.
362
425
  - **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: {
@@ -81,6 +81,46 @@ declare const props: {
81
81
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
82
82
  */
83
83
  texts: PropType<Record<string, string>>;
84
+ /**
85
+ * Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
86
+ * `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
87
+ */
88
+ noOrphanSeats: {
89
+ type: PropType<RenderOptions["noOrphanSeats"]>;
90
+ default: undefined;
91
+ };
92
+ /**
93
+ * Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
94
+ * montar (setObjectColor): otra función repinta el plano.
95
+ */
96
+ objectColor: PropType<RenderOptions["objectColor"]>;
97
+ /** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
98
+ spotlight: PropType<string[]>;
99
+ /** Categorías que no se pueden elegir: se ven como no disponibles. */
100
+ unavailableCategories: PropType<string[]>;
101
+ /** Botón de pantalla completa (por defecto, no). */
102
+ fullscreenButton: {
103
+ type: BooleanConstructor;
104
+ default: undefined;
105
+ };
106
+ /** Selección por rectángulo (por defecto, no). */
107
+ multiSelect: {
108
+ type: BooleanConstructor;
109
+ default: undefined;
110
+ };
111
+ /**
112
+ * La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
113
+ * pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
114
+ */
115
+ gestures: PropType<NonNullable<RenderOptions["gestures"]>>;
116
+ /**
117
+ * 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
118
+ * acerca. Un número vale para el dedo y el ratón; `false` lo quita.
119
+ */
120
+ minTargetSize: {
121
+ type: PropType<RenderOptions["minTargetSize"]>;
122
+ default: undefined;
123
+ };
84
124
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
85
125
  load3d: PropType<() => Promise<View3DModule>>;
86
126
  };
@@ -108,12 +148,21 @@ declare const emits: {
108
148
  id: string;
109
149
  name: string;
110
150
  }) => boolean;
151
+ /** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
152
+ selectionValid: () => boolean;
153
+ /** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
154
+ selectionInvalid: (problems: Parameters<NonNullable<RenderOptions["onSelectionInvalid"]>>[0]) => boolean;
155
+ /** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
156
+ sectorChange: (sector: SectorInfo | null) => boolean;
111
157
  };
112
158
  /** Props de SeatsyooChart: las opciones del visor, sin `container` ni los avisos (que son eventos). */
113
159
  export type SeatsyooChartProps = ExtractPublicPropTypes<typeof props>;
114
160
  /** Lo que expone el componente a una ref de plantilla. */
115
161
  export interface SeatsyooChartExposed {
116
- /** El visor montado (`getSelection()`, `holdToken`…), o null mientras no hay ninguno. */
162
+ /**
163
+ * El visor montado (`getSelection()`, `holdToken`, `openSector()`, `currentSector`…), o null mientras no hay
164
+ * ninguno.
165
+ */
117
166
  chart: SeatingChart | null;
118
167
  }
119
168
  /**
@@ -136,8 +185,8 @@ export type SeatsyooChartComponent = DefineComponent<typeof props, SeatsyooChart
136
185
  * />
137
186
  * ```
138
187
  *
139
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
140
- * mientras no hay ninguno.
188
+ * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
189
+ * o `null` mientras no hay ninguno.
141
190
  */
142
191
  export declare const SeatsyooChart: SeatsyooChartComponent;
143
192
  /** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
@@ -77,6 +77,34 @@ const props = {
77
77
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
78
78
  */
79
79
  texts: Object,
80
+ /**
81
+ * Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
82
+ * `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
83
+ */
84
+ noOrphanSeats: { type: [Boolean, Object], default: undefined },
85
+ /**
86
+ * Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
87
+ * montar (setObjectColor): otra función repinta el plano.
88
+ */
89
+ objectColor: Function,
90
+ /** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
91
+ spotlight: Array,
92
+ /** Categorías que no se pueden elegir: se ven como no disponibles. */
93
+ unavailableCategories: Array,
94
+ /** Botón de pantalla completa (por defecto, no). */
95
+ fullscreenButton: { type: Boolean, default: undefined },
96
+ /** Selección por rectángulo (por defecto, no). */
97
+ multiSelect: { type: Boolean, default: undefined },
98
+ /**
99
+ * La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
100
+ * pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
101
+ */
102
+ gestures: String,
103
+ /**
104
+ * 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
105
+ * acerca. Un número vale para el dedo y el ratón; `false` lo quita.
106
+ */
107
+ minTargetSize: { type: [Number, Boolean, Object], default: undefined },
80
108
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
81
109
  load3d: Function,
82
110
  };
@@ -96,6 +124,12 @@ const emits = {
96
124
  holdTokenChange: (token) => true,
97
125
  /** Se muestra otra planta (`@floor-change`). */
98
126
  floorChange: (floor) => true,
127
+ /** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
128
+ selectionValid: () => true,
129
+ /** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
130
+ selectionInvalid: (problems) => true,
131
+ /** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
132
+ sectorChange: (sector) => true,
99
133
  };
100
134
  // El componente; su tipo público es SeatsyooChartComponent (abajo).
101
135
  const componente = defineComponent({
@@ -137,7 +171,11 @@ const componente = defineComponent({
137
171
  // que se va, con sus avisos (deselect y change con la selección vacía). Al desmontar el componente, no.
138
172
  if (chart.value && montada && sueltaAlCambiar(montada, nueva))
139
173
  void chart.value.clearSelection();
174
+ // El visor nuevo empieza con el recinto entero: si había un sector abierto, se avisa null (como al salir de él).
175
+ const salDelSector = chart.value?.currentSector != null;
140
176
  desmontar();
177
+ if (salDelSector)
178
+ emit("sectorChange", null);
141
179
  const div = el.value;
142
180
  if (!div)
143
181
  return;
@@ -158,6 +196,9 @@ const componente = defineComponent({
158
196
  onHoldExpired: () => emit("holdExpired"),
159
197
  onHoldTokenChange: (t) => emit("holdTokenChange", t),
160
198
  onFloorChange: (f) => emit("floorChange", f),
199
+ onSelectionValid: () => emit("selectionValid"),
200
+ onSelectionInvalid: (p) => emit("selectionInvalid", p),
201
+ onSectorChange: (s) => emit("sectorChange", s),
161
202
  onError: (e) => (escuchanError() ? emit("error", e) : avisarEnConsola(e)),
162
203
  // Solo si hay load3d (si no, el visor pide la 3D al servidor); ponerlo o quitarlo cambia la identidad.
163
204
  ...(hayLoad3d && load3d ? { load3d: () => (props.load3d ?? load3d)() } : {}),
@@ -187,7 +228,14 @@ const componente = defineComponent({
187
228
  montar(nueva);
188
229
  });
189
230
  // 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) => {
231
+ watch(() => ({
232
+ theme: props.theme,
233
+ colorBy: props.colorBy,
234
+ statusStyles: copiaDeDatos(props.statusStyles),
235
+ marks: copiaDeDatos(props.marks),
236
+ spotlight: props.spotlight && [...props.spotlight],
237
+ objectColor: props.objectColor,
238
+ }), (vivas) => {
191
239
  const c = chart.value;
192
240
  if (c)
193
241
  aplicarEnVivo(c, aplicadas, vivas);
@@ -213,8 +261,8 @@ const componente = defineComponent({
213
261
  * />
214
262
  * ```
215
263
  *
216
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
217
- * mientras no hay ninguno.
264
+ * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
265
+ * o `null` mientras no hay ninguno.
218
266
  */
219
267
  export const SeatsyooChart = componente;
220
268
  /** 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"];
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) y con `onSectorChange` (un evento, del mismo día).
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,23 @@ 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",
29
37
  ];
30
38
  /**
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.
39
+ * Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy); para
40
+ * el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks); y, del
41
+ * visor de main del 25 oct 2026, el foco (setSpotlight) y el color propio de cada objeto (setObjectColor). Se comparan por
42
+ * valor, como las de identidad: un objeto nuevo con lo mismo no llama a nada. objectColor es una función: cuenta si es
43
+ * otra (y entonces el visor repinta).
34
44
  */
35
- export const OPCIONES_EN_VIVO = ["theme", "colorBy", "statusStyles", "marks"];
45
+ export const OPCIONES_EN_VIVO = ["theme", "colorBy", "statusStyles", "marks", "spotlight", "objectColor"];
36
46
  /** Avisos del visor: siempre llaman a la última función recibida, sin volver a montar. */
37
47
  export const AVISOS = [
38
48
  "onReady",
@@ -43,6 +53,11 @@ export const AVISOS = [
43
53
  "onHoldExpired",
44
54
  "onHoldTokenChange",
45
55
  "onFloorChange",
56
+ // Con noOrphanSeats (del visor de main, 25 oct 2026).
57
+ "onSelectionValid",
58
+ "onSelectionInvalid",
59
+ // Se entra en un sector o se sale de él (del visor de la rama sectores-subplano, 13 nov 2026).
60
+ "onSectorChange",
46
61
  ];
47
62
  export function identidadDe(opciones) {
48
63
  const identidad = { load3d: typeof opciones.load3d === "function" };
@@ -108,7 +123,7 @@ export function copiaDeDatos(valor) {
108
123
  }
109
124
  /**
110
125
  * 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).
126
+ * marks, ninguno (`{}`, que para el visor es lo mismo que no pasarlas); sin spotlight ni objectColor, null.
112
127
  */
113
128
  export function enVivoDe(opciones) {
114
129
  return {
@@ -116,6 +131,8 @@ export function enVivoDe(opciones) {
116
131
  colorBy: opciones.colorBy ?? "category",
117
132
  statusStyles: copiaDeDatos(opciones.statusStyles ?? {}),
118
133
  marks: copiaDeDatos(opciones.marks ?? {}),
134
+ spotlight: opciones.spotlight ? [...opciones.spotlight] : null,
135
+ objectColor: opciones.objectColor ?? null,
119
136
  };
120
137
  }
121
138
  /** Lo que hay que añadir a las opciones de `render` para montar con estas opciones en vivo (las copias guardadas). */
@@ -125,11 +142,14 @@ export function opcionesEnVivo(opciones, enVivo) {
125
142
  colorBy: opciones.colorBy,
126
143
  statusStyles: opciones.statusStyles && enVivo.statusStyles,
127
144
  marks: opciones.marks && enVivo.marks,
145
+ spotlight: enVivo.spotlight ?? undefined,
146
+ objectColor: enVivo.objectColor ?? undefined,
128
147
  });
129
148
  }
130
149
  /**
131
150
  * 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.
151
+ * `aplicadas`. Quitar una es volver a la de por defecto: el tema claro, el color por categoría, sin estilos ni marcas,
152
+ * sin foco y sin color propio.
133
153
  */
134
154
  export function aplicarEnVivo(visor, aplicadas, opciones) {
135
155
  const tema = opciones.theme ?? "light";
@@ -154,6 +174,19 @@ export function aplicarEnVivo(visor, aplicadas, opciones) {
154
174
  aplicadas.marks = marcas;
155
175
  visor.setMarks(marcas);
156
176
  }
177
+ // El foco, por valor (una lista nueva con lo mismo no repinta); el visor recibe su propia copia.
178
+ const foco = opciones.spotlight ? [...opciones.spotlight] : null;
179
+ if (!igual(foco, aplicadas.spotlight)) {
180
+ aplicadas.spotlight = foco;
181
+ visor.setSpotlight(foco && [...foco]);
182
+ }
183
+ // El color propio, por referencia: otra función repinta todo el plano (en React, con useCallback no cambia en cada
184
+ // render).
185
+ const colorPropio = opciones.objectColor ?? null;
186
+ if (colorPropio !== aplicadas.objectColor) {
187
+ aplicadas.objectColor = colorPropio;
188
+ visor.setObjectColor(colorPropio);
189
+ }
157
190
  }
158
191
  /** Las opciones sin las que valen `undefined` (el visor usa entonces su valor por defecto). */
159
192
  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.2.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.2.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "vue": "^3.3.0"