@seatsyoo/vue 1.1.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +70 -7
- package/dist/SeatsyooChart.d.ts +53 -4
- package/dist/SeatsyooChart.js +51 -3
- package/dist/index.d.ts +1 -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
|
|
|
@@ -315,14 +366,21 @@ npm install @seatsyoo/vue
|
|
|
315
366
|
- **Props**: every viewer option except `container` and the callbacks; `class`, `style`, `id` and other attributes
|
|
316
367
|
go to the wrapping `<div>`. `app.use(SeatsyooPlugin)` registers `<SeatsyooChart>` globally.
|
|
317
368
|
- **Events**: `ready`, `change`, `select`, `deselect`, `error`, `hold-expired`, `hold-token-change`,
|
|
318
|
-
`floor-change`. They always reach the current listeners; without an `@error` listener, errors go to the console.
|
|
369
|
+
`floor-change`, `selection-invalid`, `selection-valid` (with `noOrphanSeats`), `sector-change`. They always reach the current listeners; without an `@error` listener, errors go to the console.
|
|
319
370
|
- **Re-mounting**: changing `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`,
|
|
320
371
|
`channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`,
|
|
321
|
-
`showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance
|
|
372
|
+
`showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`,
|
|
373
|
+
`unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures` or `minTargetSize` destroys the viewer and mounts a new one (arrays
|
|
322
374
|
and objects are compared by value). `theme` and `colorBy` are applied live (`setTheme`, `setColorBy`), and so
|
|
323
|
-
are `
|
|
375
|
+
are `spotlight` (`setSpotlight`), `objectColor` (`setObjectColor`, when it is another function) and
|
|
376
|
+
`statusStyles` and `marks` (`"manager"` mode: `setStatusStyles`, `setMarks`), only when their value changes
|
|
324
377
|
(compared as data: the prototype doesn't matter and a key set to `undefined` counts as missing; a reactive object
|
|
325
378
|
changed in place counts too).
|
|
379
|
+
- **Wheel and fingers**: with `gestures` `"auto"` (the default), if your page scrolls (or the viewer is in an iframe),
|
|
380
|
+
the wheel alone and one finger scroll the page; the chart zooms with Ctrl/⌘ + scroll or a pinch and pans by dragging
|
|
381
|
+
with the mouse or two fingers, and a short hint says so. `"free"` gives them to the chart, `"cooperative"` always
|
|
382
|
+
to the page. `minTargetSize` (`{ touch: 24, mouse: 6 }` px) makes the first tap zoom in (at least ×2) instead of
|
|
383
|
+
picking when seats look smaller; `false` turns it off.
|
|
326
384
|
- **Prices**: Seatsyoo does not store prices. Pass yours with `pricing` (per category key, with `currency` and
|
|
327
385
|
`locale`): the viewer shows them and they come in `price` of each selected object (`null` without `pricing`).
|
|
328
386
|
`price` is what each unit of `quantity` costs (per place; a whole table, all its chairs), so `price × quantity` adds
|
|
@@ -357,6 +415,11 @@ npm install @seatsyoo/vue
|
|
|
357
415
|
(your server books or releases them, e.g. a multi-show cart), and nothing is released on unmount.
|
|
358
416
|
- **`document`** is not copied: changing it in place goes unnoticed; pass a new object without mutating the old one.
|
|
359
417
|
- **Exposed**: `chart`, the mounted `SeatingChart` (or `null` on the server, before mounting and after unmounting).
|
|
418
|
+
- **Sectors**: `sector-change` fires with `{ id, name }` (`SectorInfo`) when a sector is entered and `null` when it is
|
|
419
|
+
left; through `chart`, `openSector(idOrName)` (`false` if the chart is not shown by sectors or has no such sector),
|
|
420
|
+
`closeSector()`, `currentSector` and `selectBestAvailable(n, categories?, sectors?)` (with a sector open, it searches
|
|
421
|
+
there; `sectors` overrides it and `[]` is the whole venue). A remounted viewer starts with the whole venue; if a sector was
|
|
422
|
+
open, `sector-change` with `null` reports it.
|
|
360
423
|
- **Invalid options** don't throw: the `error` event gets `{ code: "invalid-options", message }`.
|
|
361
424
|
- **SSR**: renders an empty `<div>` on the server and mounts the viewer in `onMounted`.
|
|
362
425
|
- **3D view**: downloaded from `${server}/sdk/butacas-3d.js` when opened (allow it in your CSP `script-src`, or
|
package/dist/SeatsyooChart.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type ChartDocument, type Language, type SeatingChart, type SelectedObject, type StatusStyle, type View3DModule } from "@seatsyoo/visor";
|
|
1
|
+
import { type ChartDocument, type Language, type RenderOptions, type SeatingChart, type SectorInfo, type SelectedObject, type StatusStyle, type View3DModule } from "@seatsyoo/visor";
|
|
2
2
|
import { type ComponentOptionsMixin, type DefineComponent, type ExtractPublicPropTypes, type Plugin, type PropType } from "vue";
|
|
3
3
|
import { SeatsyooDesigner } from "./SeatsyooDesigner.js";
|
|
4
4
|
declare const props: {
|
|
@@ -81,6 +81,46 @@ declare const props: {
|
|
|
81
81
|
* `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
|
|
82
82
|
*/
|
|
83
83
|
texts: PropType<Record<string, string>>;
|
|
84
|
+
/**
|
|
85
|
+
* Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
|
|
86
|
+
* `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
|
|
87
|
+
*/
|
|
88
|
+
noOrphanSeats: {
|
|
89
|
+
type: PropType<RenderOptions["noOrphanSeats"]>;
|
|
90
|
+
default: undefined;
|
|
91
|
+
};
|
|
92
|
+
/**
|
|
93
|
+
* Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
|
|
94
|
+
* montar (setObjectColor): otra función repinta el plano.
|
|
95
|
+
*/
|
|
96
|
+
objectColor: PropType<RenderOptions["objectColor"]>;
|
|
97
|
+
/** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
|
|
98
|
+
spotlight: PropType<string[]>;
|
|
99
|
+
/** Categorías que no se pueden elegir: se ven como no disponibles. */
|
|
100
|
+
unavailableCategories: PropType<string[]>;
|
|
101
|
+
/** Botón de pantalla completa (por defecto, no). */
|
|
102
|
+
fullscreenButton: {
|
|
103
|
+
type: BooleanConstructor;
|
|
104
|
+
default: undefined;
|
|
105
|
+
};
|
|
106
|
+
/** Selección por rectángulo (por defecto, no). */
|
|
107
|
+
multiSelect: {
|
|
108
|
+
type: BooleanConstructor;
|
|
109
|
+
default: undefined;
|
|
110
|
+
};
|
|
111
|
+
/**
|
|
112
|
+
* La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
|
|
113
|
+
* pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
|
|
114
|
+
*/
|
|
115
|
+
gestures: PropType<NonNullable<RenderOptions["gestures"]>>;
|
|
116
|
+
/**
|
|
117
|
+
* Tamaño mínimo en píxeles de lo que se elige (por defecto `{ touch: 24, mouse: 6 }`): más pequeño, el primer toque
|
|
118
|
+
* acerca. Un número vale para el dedo y el ratón; `false` lo quita.
|
|
119
|
+
*/
|
|
120
|
+
minTargetSize: {
|
|
121
|
+
type: PropType<RenderOptions["minTargetSize"]>;
|
|
122
|
+
default: undefined;
|
|
123
|
+
};
|
|
84
124
|
/** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
|
|
85
125
|
load3d: PropType<() => Promise<View3DModule>>;
|
|
86
126
|
};
|
|
@@ -108,12 +148,21 @@ declare const emits: {
|
|
|
108
148
|
id: string;
|
|
109
149
|
name: string;
|
|
110
150
|
}) => boolean;
|
|
151
|
+
/** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
|
|
152
|
+
selectionValid: () => boolean;
|
|
153
|
+
/** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
|
|
154
|
+
selectionInvalid: (problems: Parameters<NonNullable<RenderOptions["onSelectionInvalid"]>>[0]) => boolean;
|
|
155
|
+
/** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
|
|
156
|
+
sectorChange: (sector: SectorInfo | null) => boolean;
|
|
111
157
|
};
|
|
112
158
|
/** Props de SeatsyooChart: las opciones del visor, sin `container` ni los avisos (que son eventos). */
|
|
113
159
|
export type SeatsyooChartProps = ExtractPublicPropTypes<typeof props>;
|
|
114
160
|
/** Lo que expone el componente a una ref de plantilla. */
|
|
115
161
|
export interface SeatsyooChartExposed {
|
|
116
|
-
/**
|
|
162
|
+
/**
|
|
163
|
+
* El visor montado (`getSelection()`, `holdToken`, `openSector()`, `currentSector`…), o null mientras no hay
|
|
164
|
+
* ninguno.
|
|
165
|
+
*/
|
|
117
166
|
chart: SeatingChart | null;
|
|
118
167
|
}
|
|
119
168
|
/**
|
|
@@ -136,8 +185,8 @@ export type SeatsyooChartComponent = DefineComponent<typeof props, SeatsyooChart
|
|
|
136
185
|
* />
|
|
137
186
|
* ```
|
|
138
187
|
*
|
|
139
|
-
* Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…),
|
|
140
|
-
* mientras no hay ninguno.
|
|
188
|
+
* Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
|
|
189
|
+
* o `null` mientras no hay ninguno.
|
|
141
190
|
*/
|
|
142
191
|
export declare const SeatsyooChart: SeatsyooChartComponent;
|
|
143
192
|
/** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
|
package/dist/SeatsyooChart.js
CHANGED
|
@@ -77,6 +77,34 @@ const props = {
|
|
|
77
77
|
* `{ Platea: "Stalls" }`. Solo cambia lo que se ve: claves, selección y eventos siguen siendo los del plano.
|
|
78
78
|
*/
|
|
79
79
|
texts: Object,
|
|
80
|
+
/**
|
|
81
|
+
* Avisa de las butacas que la selección deja sueltas: las marca y emite `@selection-invalid` o `@selection-valid`.
|
|
82
|
+
* `{ ignoreCategories, highlight }` para afinarlo. Cambiarla vuelve a montar el visor.
|
|
83
|
+
*/
|
|
84
|
+
noOrphanSeats: { type: [Boolean, Object], default: undefined },
|
|
85
|
+
/**
|
|
86
|
+
* Color de cada objeto a tu gusto: devuelve un color de CSS, o nada para el de siempre. Se aplica sin volver a
|
|
87
|
+
* montar (setObjectColor): otra función repinta el plano.
|
|
88
|
+
*/
|
|
89
|
+
objectColor: Function,
|
|
90
|
+
/** Foco: solo estos objetos se ven con su color y se pueden elegir. Se aplica sin volver a montar (setSpotlight). */
|
|
91
|
+
spotlight: Array,
|
|
92
|
+
/** Categorías que no se pueden elegir: se ven como no disponibles. */
|
|
93
|
+
unavailableCategories: Array,
|
|
94
|
+
/** Botón de pantalla completa (por defecto, no). */
|
|
95
|
+
fullscreenButton: { type: Boolean, default: undefined },
|
|
96
|
+
/** Selección por rectángulo (por defecto, no). */
|
|
97
|
+
multiSelect: { type: Boolean, default: undefined },
|
|
98
|
+
/**
|
|
99
|
+
* La rueda y los dedos: «cooperative» (la rueda sola y un dedo desplazan la página; el plano, con Ctrl/⌘ + rueda,
|
|
100
|
+
* pellizco o dos dedos), «free» (el plano se los queda) o «auto» (por defecto: cooperativo si la página se desplaza).
|
|
101
|
+
*/
|
|
102
|
+
gestures: String,
|
|
103
|
+
/**
|
|
104
|
+
* Tamaño mínimo en píxeles de lo que se elige (por defecto `{ touch: 24, mouse: 6 }`): más pequeño, el primer toque
|
|
105
|
+
* acerca. Un número vale para el dedo y el ratón; `false` lo quita.
|
|
106
|
+
*/
|
|
107
|
+
minTargetSize: { type: [Number, Boolean, Object], default: undefined },
|
|
80
108
|
/** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
|
|
81
109
|
load3d: Function,
|
|
82
110
|
};
|
|
@@ -96,6 +124,12 @@ const emits = {
|
|
|
96
124
|
holdTokenChange: (token) => true,
|
|
97
125
|
/** Se muestra otra planta (`@floor-change`). */
|
|
98
126
|
floorChange: (floor) => true,
|
|
127
|
+
/** Con `noOrphanSeats`: la selección ya no deja butacas sueltas (`@selection-valid`). */
|
|
128
|
+
selectionValid: () => true,
|
|
129
|
+
/** Con `noOrphanSeats`: la selección deja butacas sueltas, cuáles (`@selection-invalid`). */
|
|
130
|
+
selectionInvalid: (problems) => true,
|
|
131
|
+
/** Se entra en un sector, `{ id, name }`, o se sale de él, `null` (`@sector-change`). */
|
|
132
|
+
sectorChange: (sector) => true,
|
|
99
133
|
};
|
|
100
134
|
// El componente; su tipo público es SeatsyooChartComponent (abajo).
|
|
101
135
|
const componente = defineComponent({
|
|
@@ -137,7 +171,11 @@ const componente = defineComponent({
|
|
|
137
171
|
// que se va, con sus avisos (deselect y change con la selección vacía). Al desmontar el componente, no.
|
|
138
172
|
if (chart.value && montada && sueltaAlCambiar(montada, nueva))
|
|
139
173
|
void chart.value.clearSelection();
|
|
174
|
+
// El visor nuevo empieza con el recinto entero: si había un sector abierto, se avisa null (como al salir de él).
|
|
175
|
+
const salDelSector = chart.value?.currentSector != null;
|
|
140
176
|
desmontar();
|
|
177
|
+
if (salDelSector)
|
|
178
|
+
emit("sectorChange", null);
|
|
141
179
|
const div = el.value;
|
|
142
180
|
if (!div)
|
|
143
181
|
return;
|
|
@@ -158,6 +196,9 @@ const componente = defineComponent({
|
|
|
158
196
|
onHoldExpired: () => emit("holdExpired"),
|
|
159
197
|
onHoldTokenChange: (t) => emit("holdTokenChange", t),
|
|
160
198
|
onFloorChange: (f) => emit("floorChange", f),
|
|
199
|
+
onSelectionValid: () => emit("selectionValid"),
|
|
200
|
+
onSelectionInvalid: (p) => emit("selectionInvalid", p),
|
|
201
|
+
onSectorChange: (s) => emit("sectorChange", s),
|
|
161
202
|
onError: (e) => (escuchanError() ? emit("error", e) : avisarEnConsola(e)),
|
|
162
203
|
// Solo si hay load3d (si no, el visor pide la 3D al servidor); ponerlo o quitarlo cambia la identidad.
|
|
163
204
|
...(hayLoad3d && load3d ? { load3d: () => (props.load3d ?? load3d)() } : {}),
|
|
@@ -187,7 +228,14 @@ const componente = defineComponent({
|
|
|
187
228
|
montar(nueva);
|
|
188
229
|
});
|
|
189
230
|
// Copiar statusStyles y marks lee todo lo que tienen: así también avisa si se cambian en el sitio (reactivos).
|
|
190
|
-
watch(() => ({
|
|
231
|
+
watch(() => ({
|
|
232
|
+
theme: props.theme,
|
|
233
|
+
colorBy: props.colorBy,
|
|
234
|
+
statusStyles: copiaDeDatos(props.statusStyles),
|
|
235
|
+
marks: copiaDeDatos(props.marks),
|
|
236
|
+
spotlight: props.spotlight && [...props.spotlight],
|
|
237
|
+
objectColor: props.objectColor,
|
|
238
|
+
}), (vivas) => {
|
|
191
239
|
const c = chart.value;
|
|
192
240
|
if (c)
|
|
193
241
|
aplicarEnVivo(c, aplicadas, vivas);
|
|
@@ -213,8 +261,8 @@ const componente = defineComponent({
|
|
|
213
261
|
* />
|
|
214
262
|
* ```
|
|
215
263
|
*
|
|
216
|
-
* Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`…),
|
|
217
|
-
* mientras no hay ninguno.
|
|
264
|
+
* Con una ref de plantilla, `plano.value.chart` es el visor montado (`getSelection()`, `holdToken`, `openSector()`…),
|
|
265
|
+
* o `null` mientras no hay ninguno.
|
|
218
266
|
*/
|
|
219
267
|
export const SeatsyooChart = componente;
|
|
220
268
|
/** Plugin que registra <SeatsyooChart> y <SeatsyooDesigner> en toda la aplicación: `app.use(SeatsyooPlugin)`. */
|
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
export { SeatsyooChart, type SeatsyooChartExposed, type SeatsyooChartProps, SeatsyooPlugin } from "./SeatsyooChart.js";
|
|
2
2
|
export { SeatsyooDesigner, type SeatsyooDesignerExposed, type SeatsyooDesignerProps } from "./SeatsyooDesigner.js";
|
|
3
|
-
export type { ChartDocument, EmbeddedDesigner, EmbeddedDesignerOptions, Language, RenderOptions, SeatingChart, SelectedObject, StatusStyle, } from "@seatsyoo/visor";
|
|
3
|
+
export type { ChartDocument, EmbeddedDesigner, EmbeddedDesignerOptions, Language, RenderOptions, SeatingChart, SectorInfo, SelectedObject, StatusStyle, } from "@seatsyoo/visor";
|
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"
|