@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 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 `minTargetSize` destroys the viewer and mounts a new one (arrays
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
@@ -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
  };
@@ -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
  };
@@ -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) y con `onSectorChange` (un evento, del mismo día).
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.2.0",
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.2.0"
30
+ "@seatsyoo/visor": "^1.3.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "vue": "^3.3.0"