@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 +110 -8
- package/dist/SeatsyooChart.d.ts +57 -5
- package/dist/SeatsyooChart.js +54 -4
- package/dist/SeatsyooDesigner.d.ts +71 -0
- package/dist/SeatsyooDesigner.js +138 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.js +2 -1
- package/dist/opciones.d.ts +19 -11
- package/dist/opciones.js +39 -6
- package/package.json +2 -2
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)`,
|
|
156
|
-
`refresh()`… Vale `null` mientras
|
|
157
|
-
cambia una opción que lo vuelve a montar,
|
|
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
|
-
|
|
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
|
|
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 `
|
|
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
|
package/dist/SeatsyooChart.d.ts
CHANGED
|
@@ -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
|
-
/**
|
|
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`…),
|
|
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 {};
|
package/dist/SeatsyooChart.js
CHANGED
|
@@ -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(() => ({
|
|
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`…),
|
|
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
|
|
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
|
|
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";
|
package/dist/opciones.d.ts
CHANGED
|
@@ -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)
|
|
9
|
-
* el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks)
|
|
10
|
-
*
|
|
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
|
|
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)
|
|
32
|
-
* el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks)
|
|
33
|
-
*
|
|
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.
|
|
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.
|
|
30
|
+
"@seatsyoo/visor": "^1.2.0"
|
|
31
31
|
},
|
|
32
32
|
"peerDependencies": {
|
|
33
33
|
"vue": "^3.3.0"
|