@seatsyoo/vue 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -3
- package/dist/SeatsyooChart.d.ts +13 -0
- package/dist/SeatsyooChart.js +7 -0
- package/dist/opciones.d.ts +2 -2
- package/dist/opciones.js +4 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -89,7 +89,7 @@ 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`, `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í. |
|
|
92
|
+
| `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`, `channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`, `showLegend`, `showSelectionBar`, `showHoldTimer`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`, `unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures`, `minTargetSize`, `keyboardHint` | Se desmonta el visor y se monta otro con lo nuevo. Los arrays y objetos se comparan **por su valor**: `:channels="['web']"` no lo vuelve a montar en cada render, y cambiar un array reactivo en el sitio (`canales.push("taquilla")`) sí. |
|
|
93
93
|
| `theme`, `colorBy` | Se aplica al visor montado (`setTheme`, `setColorBy`), sin volver a montarlo. |
|
|
94
94
|
| `statusStyles`, `marks` | Solo con `mode="manager"` (un panel de gestión): cómo se ve cada estado y las marcas sobre plazas libres (ver «Estados propios y marcas»). Se aplican al visor montado (`setStatusStyles`, `setMarks`), sin volver a montarlo, solo si cambia su valor: se comparan como datos (da igual el prototipo, y una clave que vale `undefined` es como si no estuviera), así que un objeto nuevo con lo mismo no hace nada, y cambiar uno reactivo en el sitio (`marcas["Platea-A-1"] = "reducida"`) sí cuenta. Quitarlas es dejar el visor sin estilos ni marcas. |
|
|
95
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. |
|
|
@@ -107,6 +107,21 @@ pellizcando) y se mueve arrastrando con el ratón o con dos dedos, y un aviso br
|
|
|
107
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
108
|
Con `false`, nunca.
|
|
109
109
|
|
|
110
|
+
**El teclado y el lector de pantalla.** No hay nada que activar: el plano es una sola parada del tabulador y, dentro,
|
|
111
|
+
las flechas mueven un cursor por las butacas (por la fila y a la fila vecina; `Inicio` y `Fin`, a sus extremos).
|
|
112
|
+
`Intro` o `Espacio` eligen o quitan como un toque, con los mismos avisos y los mismos topes. De lejos, por sectores, el
|
|
113
|
+
cursor va de sector en sector: `Intro` entra y `Esc` vuelve. **Las flechas solas ya no mueven el plano: lo mueve
|
|
114
|
+
`Mayús` + flechas** (`+`, `−` y `0`, el zoom; `?` enseña los atajos). La primera vez que el foco entra en el plano con
|
|
115
|
+
el teclado (una vez por sesión del navegador), una pista discreta enseña esas teclas y un lector de pantalla las oye; se
|
|
116
|
+
va sola. `:keyboard-hint="false"` la quita, para una web que ya explica sus atajos (la tecla `?` la enseña igual). Para
|
|
117
|
+
un lector de pantalla el plano es una cuadrícula (`role="grid"`; la raíz ya no es `role="application"`) y cada butaca,
|
|
118
|
+
una celda con `aria-selected` y `aria-disabled` (antes, un botón con `aria-pressed`): si tus pruebas las buscaban por
|
|
119
|
+
su papel, búscalas por `[data-key]`.
|
|
120
|
+
|
|
121
|
+
**El reloj de la retención.** La barra de lo elegido enseña cuántas plazas llevas, el total y el tiempo que queda de la
|
|
122
|
+
retención. `:show-hold-timer="false"` quita solo el reloj y `:show-selection-bar="false"`, la barra entera (para una web con su
|
|
123
|
+
propio carrito). Lo retenido caduca igual: `@hold-expired`.
|
|
124
|
+
|
|
110
125
|
**Lo que el comprador tiene retenido al volver a montar.** Si es en el mismo evento y con `session: "continue"` (por
|
|
111
126
|
defecto), el visor nuevo lo recupera. Si el nuevo no puede recuperarlo (has cambiado de evento o de temporada, de
|
|
112
127
|
`server` o de `publicKey`, usas `session: "start"`, le pasas un `holdToken` o el modo `"manager"`), el componente lo
|
|
@@ -369,8 +384,8 @@ npm install @seatsyoo/vue
|
|
|
369
384
|
`floor-change`, `selection-invalid`, `selection-valid` (with `noOrphanSeats`), `sector-change`. They always reach the current listeners; without an `@error` listener, errors go to the console.
|
|
370
385
|
- **Re-mounting**: changing `server`, `publicKey`, `event`, `link`, `document`, `season`, `seasonEvents`,
|
|
371
386
|
`channels`, `pricing`, `currency`, `locale`, `language`, `maxSelected`, `session`, `holdToken`, `mode`,
|
|
372
|
-
`showLegend`, `showSelectionBar`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`,
|
|
373
|
-
`unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures` or `
|
|
387
|
+
`showLegend`, `showSelectionBar`, `showHoldTimer`, `floor`, `sectors`, `view3d`, `entrance`, `texts`, `noOrphanSeats`,
|
|
388
|
+
`unavailableCategories`, `fullscreenButton`, `multiSelect`, `gestures`, `minTargetSize` or `keyboardHint` destroys the viewer and mounts a new one (arrays
|
|
374
389
|
and objects are compared by value). `theme` and `colorBy` are applied live (`setTheme`, `setColorBy`), and so
|
|
375
390
|
are `spotlight` (`setSpotlight`), `objectColor` (`setObjectColor`, when it is another function) and
|
|
376
391
|
`statusStyles` and `marks` (`"manager"` mode: `setStatusStyles`, `setMarks`), only when their value changes
|
|
@@ -381,6 +396,15 @@ npm install @seatsyoo/vue
|
|
|
381
396
|
with the mouse or two fingers, and a short hint says so. `"free"` gives them to the chart, `"cooperative"` always
|
|
382
397
|
to the page. `minTargetSize` (`{ touch: 24, mouse: 6 }` px) makes the first tap zoom in (at least ×2) instead of
|
|
383
398
|
picking when seats look smaller; `false` turns it off.
|
|
399
|
+
- **Keyboard and screen reader**: nothing to turn on. The chart is a single Tab stop; inside, the arrow keys move a
|
|
400
|
+
cursor over the seats, `Enter` or `Space` selects or removes like a tap, and from afar the cursor moves between
|
|
401
|
+
sectors (`Enter` goes in, `Esc` comes back). **Plain arrows no longer pan the chart: `Shift` + arrows does**; `?`
|
|
402
|
+
shows the shortcuts. The first time the keyboard reaches the chart (once per browser session) a short hint shows the
|
|
403
|
+
keys: `:keyboard-hint="false"` removes it. For screen readers the chart is a `role="grid"` (no longer
|
|
404
|
+
`role="application"`) and seats are cells with `aria-selected` and `aria-disabled` (they were buttons with
|
|
405
|
+
`aria-pressed`).
|
|
406
|
+
- **Hold timer**: `:show-hold-timer="false"` removes the countdown from the selection bar and keeps the rest;
|
|
407
|
+
`:show-selection-bar="false"` removes the whole bar. The hold still expires: `@hold-expired`.
|
|
384
408
|
- **Prices**: Seatsyoo does not store prices. Pass yours with `pricing` (per category key, with `currency` and
|
|
385
409
|
`locale`): the viewer shows them and they come in `price` of each selected object (`null` without `pricing`).
|
|
386
410
|
`price` is what each unit of `quantity` costs (per place; a whole table, all its chairs), so `price × quantity` adds
|
package/dist/SeatsyooChart.d.ts
CHANGED
|
@@ -60,6 +60,11 @@ declare const props: {
|
|
|
60
60
|
type: BooleanConstructor;
|
|
61
61
|
default: undefined;
|
|
62
62
|
};
|
|
63
|
+
/** El reloj de la retención en la barra de lo elegido (por defecto sí): `false` lo quita y deja el resto. */
|
|
64
|
+
showHoldTimer: {
|
|
65
|
+
type: BooleanConstructor;
|
|
66
|
+
default: undefined;
|
|
67
|
+
};
|
|
63
68
|
/** Planta que se muestra al abrir (id). */
|
|
64
69
|
floor: StringConstructor;
|
|
65
70
|
sectors: {
|
|
@@ -121,6 +126,14 @@ declare const props: {
|
|
|
121
126
|
type: PropType<RenderOptions["minTargetSize"]>;
|
|
122
127
|
default: undefined;
|
|
123
128
|
};
|
|
129
|
+
/**
|
|
130
|
+
* La pista de atajos del teclado, que sale la primera vez que se entra en el plano con el teclado (por defecto sí):
|
|
131
|
+
* `false` la quita (la tecla «?» la enseña igual). El teclado funciona siempre.
|
|
132
|
+
*/
|
|
133
|
+
keyboardHint: {
|
|
134
|
+
type: BooleanConstructor;
|
|
135
|
+
default: undefined;
|
|
136
|
+
};
|
|
124
137
|
/** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
|
|
125
138
|
load3d: PropType<() => Promise<View3DModule>>;
|
|
126
139
|
};
|
package/dist/SeatsyooChart.js
CHANGED
|
@@ -65,6 +65,8 @@ const props = {
|
|
|
65
65
|
marks: Object,
|
|
66
66
|
showLegend: { type: Boolean, default: undefined },
|
|
67
67
|
showSelectionBar: { type: Boolean, default: undefined },
|
|
68
|
+
/** El reloj de la retención en la barra de lo elegido (por defecto sí): `false` lo quita y deja el resto. */
|
|
69
|
+
showHoldTimer: { type: Boolean, default: undefined },
|
|
68
70
|
/** Planta que se muestra al abrir (id). */
|
|
69
71
|
floor: String,
|
|
70
72
|
sectors: { type: Boolean, default: undefined },
|
|
@@ -105,6 +107,11 @@ const props = {
|
|
|
105
107
|
* acerca. Un número vale para el dedo y el ratón; `false` lo quita.
|
|
106
108
|
*/
|
|
107
109
|
minTargetSize: { type: [Number, Boolean, Object], default: undefined },
|
|
110
|
+
/**
|
|
111
|
+
* La pista de atajos del teclado, que sale la primera vez que se entra en el plano con el teclado (por defecto sí):
|
|
112
|
+
* `false` la quita (la tecla «?» la enseña igual). El teclado funciona siempre.
|
|
113
|
+
*/
|
|
114
|
+
keyboardHint: { type: Boolean, default: undefined },
|
|
108
115
|
/** Cómo cargar el módulo 3D (por defecto se pide al servidor). */
|
|
109
116
|
load3d: Function,
|
|
110
117
|
};
|
package/dist/opciones.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ 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", "noOrphanSeats", "unavailableCategories", "fullscreenButton", "multiSelect", "gestures", "minTargetSize"];
|
|
6
|
+
export declare const OPCIONES_DE_IDENTIDAD: readonly ["server", "publicKey", "event", "link", "document", "season", "seasonEvents", "channels", "pricing", "currency", "locale", "language", "maxSelected", "session", "holdToken", "mode", "showLegend", "showSelectionBar", "floor", "sectors", "view3d", "entrance", "texts", "noOrphanSeats", "unavailableCategories", "fullscreenButton", "multiSelect", "gestures", "minTargetSize", "showHoldTimer", "keyboardHint"];
|
|
7
7
|
/**
|
|
8
8
|
* Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy); para
|
|
9
9
|
* el modo «manager», los estilos de los estados y las marcas sobre plazas libres (setStatusStyles y setMarks); y, del
|
|
@@ -20,7 +20,7 @@ type ClaveDeIdentidad = (typeof OPCIONES_DE_IDENTIDAD)[number];
|
|
|
20
20
|
* opción nueva, esto deja de compilar hasta decidir qué hace el componente con ella: pasó con `entrance` y `texts`,
|
|
21
21
|
* que llegaron al visor sin que el componente las pasara; con `statusStyles` y `marks` (en vivo: el visor tiene
|
|
22
22
|
* setStatusStyles y setMarks); con las del visor de main del 25 oct 2026, con `gestures` y `minTargetSize`
|
|
23
|
-
* (13 nov 2026)
|
|
23
|
+
* (13 nov 2026), con `onSectorChange` (un evento, del mismo día) y con `showHoldTimer` y `keyboardHint` (22 nov 2026).
|
|
24
24
|
*/
|
|
25
25
|
type SinRegla = Exclude<keyof RenderOptions, ClaveDeIdentidad | (typeof OPCIONES_EN_VIVO)[number] | (typeof AVISOS)[number] | "container" | "load3d">;
|
|
26
26
|
type DebeSerNever<T extends never> = T;
|
package/dist/opciones.js
CHANGED
|
@@ -34,6 +34,10 @@ export const OPCIONES_DE_IDENTIDAD = [
|
|
|
34
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
35
|
"gestures",
|
|
36
36
|
"minTargetSize",
|
|
37
|
+
// Del visor de main (22 nov 2026): el reloj de la retención en la barra de lo elegido y la pista de atajos del
|
|
38
|
+
// teclado. Tampoco tienen método para cambiarlas en el visor montado.
|
|
39
|
+
"showHoldTimer",
|
|
40
|
+
"keyboardHint",
|
|
37
41
|
];
|
|
38
42
|
/**
|
|
39
43
|
* Opciones que se aplican al visor ya montado, sin volver a montarlo: theme y colorBy (setTheme y setColorBy); para
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@seatsyoo/vue",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Componente de Vue para el visor de mapas de asientos de Seatsyoo: elegir butacas, retenerlas y venderlas en tiempo real.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"keywords": [
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"dist/*.d.ts"
|
|
28
28
|
],
|
|
29
29
|
"dependencies": {
|
|
30
|
-
"@seatsyoo/visor": "^1.
|
|
30
|
+
"@seatsyoo/visor": "^1.3.0"
|
|
31
31
|
},
|
|
32
32
|
"peerDependencies": {
|
|
33
33
|
"vue": "^3.3.0"
|