@seatsyoo/vue 1.0.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
 
@@ -240,7 +291,43 @@ hidrata y monta el visor. En Nuxt funciona tal cual (también dentro de `<Client
240
291
  No va en el paquete: el visor la descarga de `${server}/sdk/butacas-3d.js` cuando alguien la abre. Si tu web
241
292
  tiene una política de seguridad de contenidos (CSP), añade esa dirección a `script-src`, o pasa `:view3d="false"`.
242
293
 
243
- La referencia completa de opciones, avisos y métodos está en la documentación de Seatsyoo (**/docs/visor** y
294
+ ## El diseñador de planos
295
+
296
+ `<SeatsyooDesigner>` abre en tu web el diseñador de planos de Seatsyoo, para que tus clientes dibujen sus recintos.
297
+ Tu servidor abre una sesión para un plano con su clave secreta (`POST /api/v1/charts/{plano}/designer-sessions`, o
298
+ `charts.designerSession` de `@seatsyoo/node`) y le da el token a tu web:
299
+
300
+ ```vue
301
+ <script setup lang="ts">
302
+ import { SeatsyooDesigner } from "@seatsyoo/vue";
303
+
304
+ defineProps<{ token: string }>();
305
+ const emit = defineEmits<{ cerrar: [] }>();
306
+ // Tu servidor abre otra sesión del mismo plano y te da el token (aquí, una ruta tuya).
307
+ const pedirToken = (): Promise<string> =>
308
+ fetch("/mi-api/disenador/teatro", { method: "POST" }).then((r) => r.json()).then((s: { token: string }) => s.token);
309
+ </script>
310
+
311
+ <template>
312
+ <SeatsyooDesigner
313
+ server="https://seatsyoo.example"
314
+ :token="token"
315
+ :refresh-token="pedirToken"
316
+ style="height: 80vh"
317
+ @publish="({ version }) => console.log('Publicada la versión', version)"
318
+ @close="emit('cerrar')"
319
+ />
320
+ </template>
321
+ ```
322
+
323
+ Props: `server`, `token`, `language` y `refreshToken` (pide a tu servidor otro token del mismo plano antes de que
324
+ caduque: sin ella, al caducar deja de guardar). Eventos: `ready`, `save`, `publish`, `close` («←» sale si hay quien
325
+ escuche `@close` al montarse) y `error`. `class`, `style` e `id` van al `<div>`, que necesita alto. Un `token` nuevo se le
326
+ manda sin volver a montarlo; cambiar `server` o `language`, o pasar o quitar `refreshToken`, lo vuelve a montar. Con
327
+ una ref de plantilla, `disenador.value.designer` es el diseñador (`setToken()`, `iframe`). `app.use(SeatsyooPlugin)`
328
+ también lo registra. En el servidor (SSR) pinta solo el `<div>`.
329
+
330
+ La referencia completa de opciones, avisos y métodos está en la documentación de Seatsyoo (**/docs/visor**, **/docs/disenador** y
244
331
  **/docs/frameworks**).
245
332
 
246
333
  ## Licencia
@@ -273,17 +360,27 @@ npm install @seatsyoo/vue
273
360
  (never the selected keys). -->
274
361
  ```
275
362
 
363
+ - **Embedded designer**: `<SeatsyooDesigner server :token :refresh-token @publish @close style="height: 80vh" />` opens
364
+ the Seatsyoo chart designer in your website, with a session token your server opens with its secret key
365
+ (`POST /api/v1/charts/{chart}/designer-sessions`).
276
366
  - **Props**: every viewer option except `container` and the callbacks; `class`, `style`, `id` and other attributes
277
367
  go to the wrapping `<div>`. `app.use(SeatsyooPlugin)` registers `<SeatsyooChart>` globally.
278
368
  - **Events**: `ready`, `change`, `select`, `deselect`, `error`, `hold-expired`, `hold-token-change`,
279
- `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.
280
370
  - **Re-mounting**: changing `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`,
281
371
  `channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`,
282
- `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
283
374
  and objects are compared by value). `theme` and `colorBy` are applied live (`setTheme`, `setColorBy`), and so
284
- 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
285
377
  (compared as data: the prototype doesn't matter and a key set to `undefined` counts as missing; a reactive object
286
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.
287
384
  - **Prices**: Seatsyoo does not store prices. Pass yours with `pricing` (per category key, with `currency` and
288
385
  `locale`): the viewer shows them and they come in `price` of each selected object (`null` without `pricing`).
289
386
  `price` is what each unit of `quantity` costs (per place; a whole table, all its chairs), so `price × quantity` adds
@@ -318,6 +415,11 @@ npm install @seatsyoo/vue
318
415
  (your server books or releases them, e.g. a multi-show cart), and nothing is released on unmount.
319
416
  - **`document`** is not copied: changing it in place goes unnoticed; pass a new object without mutating the old one.
320
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.
321
423
  - **Invalid options** don't throw: the `error` event gets `{ code: "invalid-options", message }`.
322
424
  - **SSR**: renders an empty `<div>` on the server and mounts the viewer in `onMounted`.
323
425
  - **3D view**: downloaded from `${server}/sdk/butacas-3d.js` when opened (allow it in your CSP `script-src`, or
@@ -1,5 +1,6 @@
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
+ import { SeatsyooDesigner } from "./SeatsyooDesigner.js";
3
4
  declare const props: {
4
5
  /** URL base del servidor de Seatsyoo, p. ej. https://seatsyoo.example */
5
6
  server: {
@@ -80,6 +81,46 @@ declare const props: {
80
81
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
81
82
  */
82
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
+ };
83
124
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
84
125
  load3d: PropType<() => Promise<View3DModule>>;
85
126
  };
@@ -107,12 +148,21 @@ declare const emits: {
107
148
  id: string;
108
149
  name: string;
109
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;
110
157
  };
111
158
  /** Props de SeatsyooChart: las opciones del visor, sin `container` ni los avisos (que son eventos). */
112
159
  export type SeatsyooChartProps = ExtractPublicPropTypes<typeof props>;
113
160
  /** Lo que expone el componente a una ref de plantilla. */
114
161
  export interface SeatsyooChartExposed {
115
- /** 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
+ */
116
166
  chart: SeatingChart | null;
117
167
  }
118
168
  /**
@@ -135,16 +185,18 @@ export type SeatsyooChartComponent = DefineComponent<typeof props, SeatsyooChart
135
185
  * />
136
186
  * ```
137
187
  *
138
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
139
- * 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.
140
190
  */
141
191
  export declare const SeatsyooChart: SeatsyooChartComponent;
142
- /** Plugin que registra <SeatsyooChart> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
192
+ /** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
143
193
  export declare const SeatsyooPlugin: Plugin;
144
194
  declare module "vue" {
145
195
  interface GlobalComponents {
146
196
  /** El visor de Seatsyoo (registrado con `app.use(SeatsyooPlugin)`). */
147
197
  SeatsyooChart: typeof SeatsyooChart;
198
+ /** El diseñador de planos de Seatsyoo (registrado con `app.use(SeatsyooPlugin)`). */
199
+ SeatsyooDesigner: typeof SeatsyooDesigner;
148
200
  }
149
201
  }
150
202
  export {};
@@ -11,6 +11,7 @@
11
11
  // ese momento, sin volver a montar.
12
12
  import { render, } from "@seatsyoo/visor";
13
13
  import { defineComponent, getCurrentInstance, h, onBeforeUnmount, onMounted, shallowRef, toRaw, watch, } from "vue";
14
+ import { SeatsyooDesigner } from "./SeatsyooDesigner.js";
14
15
  import { aplicarEnVivo, avisarEnConsola, copiaDeDatos, enVivoDe, errorDeOpciones, identidadDe, igual, opcionesEnVivo, sinIndefinidos, sueltaAlCambiar, } from "./opciones.js";
15
16
  // Los booleanos con `default: undefined`: sin él, Vue los pone a false si no se pasan, y el visor los quiere
16
17
  // sin indicar (su valor por defecto es «sí»).
@@ -76,6 +77,34 @@ const props = {
76
77
  * `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
77
78
  */
78
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 },
79
108
  /** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
80
109
  load3d: Function,
81
110
  };
@@ -95,6 +124,12 @@ const emits = {
95
124
  holdTokenChange: (token) => true,
96
125
  /** Se muestra otra planta (`@floor-change`). */
97
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,
98
133
  };
99
134
  // El componente; su tipo público es SeatsyooChartComponent (abajo).
100
135
  const componente = defineComponent({
@@ -136,7 +171,11 @@ const componente = defineComponent({
136
171
  // que se va, con sus avisos (deselect y change con la selección vacía). Al desmontar el componente, no.
137
172
  if (chart.value && montada && sueltaAlCambiar(montada, nueva))
138
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;
139
176
  desmontar();
177
+ if (salDelSector)
178
+ emit("sectorChange", null);
140
179
  const div = el.value;
141
180
  if (!div)
142
181
  return;
@@ -157,6 +196,9 @@ const componente = defineComponent({
157
196
  onHoldExpired: () => emit("holdExpired"),
158
197
  onHoldTokenChange: (t) => emit("holdTokenChange", t),
159
198
  onFloorChange: (f) => emit("floorChange", f),
199
+ onSelectionValid: () => emit("selectionValid"),
200
+ onSelectionInvalid: (p) => emit("selectionInvalid", p),
201
+ onSectorChange: (s) => emit("sectorChange", s),
160
202
  onError: (e) => (escuchanError() ? emit("error", e) : avisarEnConsola(e)),
161
203
  // Solo si hay load3d (si no, el visor pide la 3D al servidor); ponerlo o quitarlo cambia la identidad.
162
204
  ...(hayLoad3d && load3d ? { load3d: () => (props.load3d ?? load3d)() } : {}),
@@ -186,7 +228,14 @@ const componente = defineComponent({
186
228
  montar(nueva);
187
229
  });
188
230
  // Copiar statusStyles y marks lee todo lo que tienen: así también avisa si se cambian en el sitio (reactivos).
189
- 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) => {
190
239
  const c = chart.value;
191
240
  if (c)
192
241
  aplicarEnVivo(c, aplicadas, vivas);
@@ -212,13 +261,14 @@ const componente = defineComponent({
212
261
  * />
213
262
  * ```
214
263
  *
215
- * Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…), o `null`
216
- * 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.
217
266
  */
218
267
  export const SeatsyooChart = componente;
219
- /** Plugin que registra <SeatsyooChart> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
268
+ /** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
220
269
  export const SeatsyooPlugin = {
221
270
  install(app) {
222
271
  app.component("SeatsyooChart", SeatsyooChart);
272
+ app.component("SeatsyooDesigner", SeatsyooDesigner);
223
273
  },
224
274
  };
@@ -0,0 +1,71 @@
1
+ import { type EmbeddedDesigner, type Language } from "@seatsyoo/visor";
2
+ import { type ComponentOptionsMixin, type DefineComponent, type ExtractPublicPropTypes, type PropType } from "vue";
3
+ type Estado = "draft" | "published" | "published-with-draft";
4
+ declare const props: {
5
+ /** URL base del servidor de Seatsyoo, p. ej. https://seatsyoo.example */
6
+ server: {
7
+ type: StringConstructor;
8
+ required: true;
9
+ };
10
+ /** El token de la sesión del diseñador (dsg_…), que abre tu servidor con su clave secreta. */
11
+ token: {
12
+ type: StringConstructor;
13
+ required: true;
14
+ };
15
+ /** Idioma del diseñador: «es» (por defecto) o «en». */
16
+ language: PropType<Language>;
17
+ /** Pide a tu servidor otro token del mismo plano antes de que caduque (sin ella, al caducar deja de guardar). */
18
+ refreshToken: PropType<() => Promise<string>>;
19
+ };
20
+ declare const emits: {
21
+ /** El diseñador está abierto con el plano. */
22
+ ready: (info: {
23
+ chart: string;
24
+ status: Estado;
25
+ publishedVersion: number | null;
26
+ canPublish: boolean;
27
+ }) => boolean;
28
+ /** Se han guardado los cambios en el borrador. */
29
+ save: (info: {
30
+ chart: string;
31
+ status: Estado;
32
+ }) => boolean;
33
+ /** Se ha publicado una versión nueva. */
34
+ publish: (info: {
35
+ chart: string;
36
+ version: number;
37
+ }) => boolean;
38
+ /** Se ha pulsado «←» (sale solo si hay quien escuche @close al montarse). */
39
+ close: () => boolean;
40
+ /** Algo ha fallado: `{ code, message }`. Sin oyente, se escribe en la consola. */
41
+ error: (error: {
42
+ code: string;
43
+ message: string;
44
+ }) => boolean;
45
+ };
46
+ /** Props de SeatsyooDesigner: las opciones del diseñador, sin `container` ni los avisos (que son eventos). */
47
+ export type SeatsyooDesignerProps = ExtractPublicPropTypes<typeof props>;
48
+ /** Lo que expone el componente a una ref de plantilla. */
49
+ export interface SeatsyooDesignerExposed {
50
+ /** El diseñador abierto (`setToken()`, `iframe`), o null mientras no hay ninguno. */
51
+ designer: EmbeddedDesigner | null;
52
+ }
53
+ /** Su tipo público, escrito a mano como el de SeatsyooChart (con los parámetros que no han cambiado desde Vue 3.3). */
54
+ export type SeatsyooDesignerComponent = DefineComponent<typeof props, SeatsyooDesignerExposed, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, typeof emits>;
55
+ /**
56
+ * El diseñador de planos de Seatsyoo en tu web, con el token de una sesión que abre tu servidor con su clave secreta
57
+ * (`POST /api/v1/charts/{plano}/designer-sessions`, o `charts.designerSession` de `@seatsyoo/node`).
58
+ *
59
+ * ```vue
60
+ * <SeatsyooDesigner
61
+ * server="https://seatsyoo.example"
62
+ * :token="token"
63
+ * :refresh-token="pedirToken"
64
+ * style="height: 80vh"
65
+ * @publish="({ version }) => console.log(version)"
66
+ * @close="abierto = false"
67
+ * />
68
+ * ```
69
+ */
70
+ export declare const SeatsyooDesigner: SeatsyooDesignerComponent;
71
+ export {};
@@ -0,0 +1,138 @@
1
+ // SeatsyooDesigner: el diseñador de planos de Seatsyoo, incrustado en tu web, como componente de Vue 3 (3.3 o posterior),
2
+ // sin SFC (defineComponent y una función render), como SeatsyooChart.
3
+ //
4
+ // - Se monta en onMounted: en el servidor (SSR) solo se pinta el <div> vacío. Antes de desmontar, destroy().
5
+ // - Vuelve a montarse si cambia `server` o `language`, o si se pasa o se quita `refreshToken`: la página del diseñador
6
+ // sabe al abrirse si puede pedir tokens nuevos. «←» sale si al montarse hay quien escuche @close.
7
+ // - Un `token` nuevo con el diseñador abierto no lo vuelve a montar: se le manda (setToken), como al renovarlo.
8
+ // - Los avisos salen como eventos de Vue (ready, save, publish, close, error); refreshToken es una prop (devuelve el
9
+ // token) y se llama siempre la última recibida.
10
+ import { designer } from "@seatsyoo/visor";
11
+ import { defineComponent, getCurrentInstance, h, onBeforeUnmount, onMounted, shallowRef, watch, } from "vue";
12
+ import { avisarEnConsola, errorDeOpciones } from "./opciones.js";
13
+ const props = {
14
+ /** URL base del servidor de Seatsyoo, p. ej. https://seatsyoo.example */
15
+ server: { type: String, required: true },
16
+ /** El token de la sesión del diseñador (dsg_…), que abre tu servidor con su clave secreta. */
17
+ token: { type: String, required: true },
18
+ /** Idioma del diseñador: «es» (por defecto) o «en». */
19
+ language: String,
20
+ /** Pide a tu servidor otro token del mismo plano antes de que caduque (sin ella, al caducar deja de guardar). */
21
+ refreshToken: Function,
22
+ };
23
+ // Los parámetros solo dan el tipo de cada evento (Vue valida con lo que devuelven: siempre sí).
24
+ const emits = {
25
+ /** El diseñador está abierto con el plano. */
26
+ ready: (info) => true,
27
+ /** Se han guardado los cambios en el borrador. */
28
+ save: (info) => true,
29
+ /** Se ha publicado una versión nueva. */
30
+ publish: (info) => true,
31
+ /** Se ha pulsado «←» (sale solo si hay quien escuche @close al montarse). */
32
+ close: () => true,
33
+ /** Algo ha fallado: `{ code, message }`. Sin oyente, se escribe en la consola. */
34
+ error: (error) => true,
35
+ };
36
+ const componente = defineComponent({
37
+ name: "SeatsyooDesigner",
38
+ props,
39
+ emits,
40
+ expose: ["designer"],
41
+ setup(props, { emit }) {
42
+ const abierto = shallowRef(null);
43
+ const el = shallowRef(null);
44
+ const instancia = getCurrentInstance();
45
+ let vivo = false;
46
+ /** El último token que se le dio al diseñador abierto. */
47
+ let token = "";
48
+ /** ¿Hay alguien escuchando ese evento ahora mismo? */
49
+ function escuchan(evento) {
50
+ const p = instancia?.vnode.props;
51
+ const f = p?.[evento] ?? p?.[`${evento}Once`];
52
+ return typeof f === "function" || Array.isArray(f);
53
+ }
54
+ function desmontar() {
55
+ const anterior = abierto.value;
56
+ abierto.value = null;
57
+ anterior?.destroy();
58
+ }
59
+ function montar() {
60
+ desmontar();
61
+ const div = el.value;
62
+ if (!div)
63
+ return;
64
+ const refresh = props.refreshToken;
65
+ try {
66
+ abierto.value = designer({
67
+ container: div,
68
+ server: props.server,
69
+ token: props.token,
70
+ ...(props.language ? { language: props.language } : {}),
71
+ ...(refresh ? { refreshToken: () => (props.refreshToken ?? refresh)() } : {}),
72
+ ...(escuchan("onClose") ? { onClose: () => emit("close") } : {}),
73
+ onReady: (i) => emit("ready", i),
74
+ onSave: (i) => emit("save", i),
75
+ onPublish: (i) => emit("publish", i),
76
+ onError: (e) => (escuchan("onError") ? emit("error", e) : avisarEnConsola(e)),
77
+ });
78
+ token = props.token;
79
+ }
80
+ catch (err) {
81
+ const error = errorDeOpciones(err);
82
+ if (escuchan("onError"))
83
+ emit("error", error);
84
+ else
85
+ console.error("[seatsyoo]", error.message);
86
+ }
87
+ }
88
+ onMounted(() => {
89
+ vivo = true;
90
+ montar();
91
+ });
92
+ onBeforeUnmount(() => {
93
+ vivo = false;
94
+ desmontar();
95
+ });
96
+ watch(() => [props.server, props.language, !!props.refreshToken], () => {
97
+ if (vivo)
98
+ montar();
99
+ });
100
+ watch(() => props.token, (nuevo) => {
101
+ const d = abierto.value;
102
+ if (!vivo || !d || nuevo === token)
103
+ return;
104
+ try {
105
+ d.setToken(nuevo);
106
+ token = nuevo;
107
+ }
108
+ catch (err) {
109
+ const error = errorDeOpciones(err);
110
+ if (escuchan("onError"))
111
+ emit("error", error);
112
+ else
113
+ avisarEnConsola(error);
114
+ }
115
+ });
116
+ return { designer: abierto, el };
117
+ },
118
+ render() {
119
+ // class, style, id y demás atributos pasan solos a este <div> (inheritAttrs).
120
+ return h("div", { ref: "el" });
121
+ },
122
+ });
123
+ /**
124
+ * El diseñador de planos de Seatsyoo en tu web, con el token de una sesión que abre tu servidor con su clave secreta
125
+ * (`POST /api/v1/charts/{plano}/designer-sessions`, o `charts.designerSession` de `@seatsyoo/node`).
126
+ *
127
+ * ```vue
128
+ * <SeatsyooDesigner
129
+ * server="https://seatsyoo.example"
130
+ * :token="token"
131
+ * :refresh-token="pedirToken"
132
+ * style="height: 80vh"
133
+ * @publish="({ version }) => console.log(version)"
134
+ * @close="abierto = false"
135
+ * />
136
+ * ```
137
+ */
138
+ export const SeatsyooDesigner = componente;
package/dist/index.d.ts CHANGED
@@ -1,2 +1,3 @@
1
1
  export { SeatsyooChart, type SeatsyooChartExposed, type SeatsyooChartProps, SeatsyooPlugin } from "./SeatsyooChart.js";
2
- export type { ChartDocument, Language, RenderOptions, SeatingChart, SelectedObject, StatusStyle } from "@seatsyoo/visor";
2
+ export { SeatsyooDesigner, type SeatsyooDesignerExposed, type SeatsyooDesignerProps } from "./SeatsyooDesigner.js";
3
+ export type { ChartDocument, EmbeddedDesigner, EmbeddedDesignerOptions, Language, RenderOptions, SeatingChart, SectorInfo, SelectedObject, StatusStyle, } from "@seatsyoo/visor";
package/dist/index.js CHANGED
@@ -1,2 +1,3 @@
1
- // @seatsyoo/vue: el visor de mapas de asientos de Seatsyoo como componente de Vue 3.
1
+ // @seatsyoo/vue: el visor de mapas de asientos de Seatsyoo y su diseñador de planos como componentes de Vue 3.
2
2
  export { SeatsyooChart, SeatsyooPlugin } from "./SeatsyooChart.js";
3
+ export { SeatsyooDesigner } from "./SeatsyooDesigner.js";
@@ -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.0.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.0.0"
30
+ "@seatsyoo/visor": "^1.2.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "vue": "^3.3.0"