@kerusiweb/core 3.0.0 → 3.1.0

package/README.md

@@ -48,8 +48,12 @@ const d = seatBodyPath(x, y, width, height); // → 'M4 8 …', ready for <path
 
 **`view/`: presentation policy, still framework-free.** The colour system
 (`DEFAULT_KERUSI_COLORS`, `seatFill`, `readableOn`), the ARIA strings
-(`seatAriaLabel`, `disallowedAnnouncement`), and the selection rules
-(`toggleSeatSelection`, `summarizeSelection`, `DisallowedReason`).
+(`seatAriaLabel`, `disallowedAnnouncement`), the selection rules
+(`toggleSeatSelection`, `summarizeSelection`, `DisallowedReason`), and the rules
+behind seat hover and seat cards: `reduceSeatHover()` (the pointer-type filter,
+the pause during a pan or zoom, the open and close delays) and `placeSeatCard()`
+(side, position and arrow offset, with flip and clamp), both pure, plus the
+`SeatClick` and `KerusiSeatCardContext` types.
 
 ## Server-side use
 

package/dist/view/index.d.ts

@@ -1,8 +1,9 @@
 /**
  * Presentation policy that is still framework-free: the colour system a
  * renderer resolves seat fills from, the ARIA strings it announces, the
- * selection rules that decide whether a seat may be toggled, and the zoom, pan
- * and gesture arithmetic behind a zoomable map.
+ * selection rules that decide whether a seat may be toggled, the zoom, pan and
+ * gesture arithmetic behind a zoomable map, and the hover rules and card
+ * placement behind seat events and seat cards.
  *
  * A binding turns these into markup; none of them know how.
  */
@@ -12,6 +13,9 @@ export * from './kerusi-seatmap-colors.js';
 export * from './rtl.js';
 export * from './seat-glyph.js';
 export * from './seat-aria.js';
+export * from './seat-card.js';
+export * from './seat-card-placement.js';
+export * from './seat-hover.js';
 export * from './selection.js';
 export * from './viewport.js';
 export * from './viewport-gesture.js';

package/dist/view/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}

package/dist/view/index.js

@@ -1,8 +1,9 @@
 /**
  * Presentation policy that is still framework-free: the colour system a
  * renderer resolves seat fills from, the ARIA strings it announces, the
- * selection rules that decide whether a seat may be toggled, and the zoom, pan
- * and gesture arithmetic behind a zoomable map.
+ * selection rules that decide whether a seat may be toggled, the zoom, pan and
+ * gesture arithmetic behind a zoomable map, and the hover rules and card
+ * placement behind seat events and seat cards.
  *
  * A binding turns these into markup; none of them know how.
  */
@@ -12,6 +13,9 @@ export * from './kerusi-seatmap-colors.js';
 export * from './rtl.js';
 export * from './seat-glyph.js';
 export * from './seat-aria.js';
+export * from './seat-card.js';
+export * from './seat-card-placement.js';
+export * from './seat-hover.js';
 export * from './selection.js';
 export * from './viewport.js';
 export * from './viewport-gesture.js';

package/dist/view/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}

package/dist/view/seat-card-placement.d.ts

@@ -0,0 +1,60 @@
+import type { SeatCardPlacement, SeatCardSide } from './seat-card.js';
+/**
+ * Where a seat card goes: the arithmetic only.
+ *
+ * A binding measures three boxes in CSS pixels, all in the same coordinate
+ * space (the map root's, in practice), and hands them in. Because the seat's box
+ * is its on-screen one, zoom, pan and rotation are already in it: a rotated
+ * seat is its bounding box, a zoomed one is as large as it is drawn.
+ */
+export interface CardRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface CardSize {
+    width: number;
+    height: number;
+}
+export interface SeatCardPlacementInput {
+    /** The seat's on-screen box. */
+    seat: CardRect;
+    /** The card's own size, borders included. */
+    card: CardSize;
+    /** The box the card must stay inside: the map's root. */
+    container: CardRect;
+    /** The side to try first. Default `top`. */
+    placement?: SeatCardPlacement;
+    /** Space left between the seat and the card, for the arrow. Default `8`. */
+    offset?: number;
+    /**
+     * How far in from a card's corner the arrow keeps, so it never sits on the
+     * rounded part. Default `12`.
+     */
+    arrowInset?: number;
+}
+export interface SeatCardPosition {
+    /** The side of the seat the card ended up on, after any flip. */
+    side: SeatCardSide;
+    /** The card's top-left corner, in the same space as the inputs. */
+    x: number;
+    y: number;
+    /**
+     * Where the arrow sits along the card's edge that faces the seat: measured
+     * from the card's left edge for `top` and `bottom`, from its top edge for
+     * `left` and `right`. Points at the seat's centre, kept off the corners.
+     */
+    arrowOffset: number;
+}
+/**
+ * Places a card against a seat.
+ *
+ * The card sits on the preferred side. If it would not fit there but would fit
+ * on the opposite side, it flips. `auto` takes the side with the most room.
+ * Either way the card is then clamped inside the container along the other
+ * axis, and, when no side fits at all, along both. A card larger than the
+ * container is pinned to its top-left.
+ */
+export declare function placeSeatCard(input: SeatCardPlacementInput): SeatCardPosition;
+//# sourceMappingURL=seat-card-placement.d.ts.map

package/dist/view/seat-card-placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-card-placement.d.ts","sourceRoot":"","sources":["../../src/view/seat-card-placement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtE;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,QAAQ,CAAC;IACf,yDAAyD;IACzD,SAAS,EAAE,QAAQ,CAAC;IACpB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,YAAY,CAAC;IACnB,mEAAmE;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,CAuC7E"}

package/dist/view/seat-card-placement.js

@@ -0,0 +1,94 @@
+const OPPOSITE = {
+    top: 'bottom',
+    bottom: 'top',
+    left: 'right',
+    right: 'left',
+};
+/** What `auto` tries, in order, when sides tie. */
+const AUTO_ORDER = ['top', 'bottom', 'right', 'left'];
+/**
+ * Places a card against a seat.
+ *
+ * The card sits on the preferred side. If it would not fit there but would fit
+ * on the opposite side, it flips. `auto` takes the side with the most room.
+ * Either way the card is then clamped inside the container along the other
+ * axis, and, when no side fits at all, along both. A card larger than the
+ * container is pinned to its top-left.
+ */
+export function placeSeatCard(input) {
+    const { seat, card, container } = input;
+    const offset = input.offset ?? 8;
+    const inset = input.arrowInset ?? 12;
+    const preferred = input.placement ?? 'top';
+    const side = chooseSide(preferred, input, offset);
+    const cx = seat.x + seat.width / 2;
+    const cy = seat.y + seat.height / 2;
+    let x;
+    let y;
+    switch (side) {
+        case 'top':
+            x = cx - card.width / 2;
+            y = seat.y - offset - card.height;
+            break;
+        case 'bottom':
+            x = cx - card.width / 2;
+            y = seat.y + seat.height + offset;
+            break;
+        case 'left':
+            x = seat.x - offset - card.width;
+            y = cy - card.height / 2;
+            break;
+        case 'right':
+            x = seat.x + seat.width + offset;
+            y = cy - card.height / 2;
+            break;
+    }
+    x = clamp(x, container.x, container.x + container.width - card.width);
+    y = clamp(y, container.y, container.y + container.height - card.height);
+    const vertical = side === 'top' || side === 'bottom';
+    const along = vertical ? cx - x : cy - y;
+    const extent = vertical ? card.width : card.height;
+    return { side, x, y, arrowOffset: clamp(along, Math.min(inset, extent / 2), extent - inset) };
+}
+/** Room on one side of the seat, inside the container. */
+function room(side, input) {
+    const { seat, container } = input;
+    switch (side) {
+        case 'top':
+            return seat.y - container.y;
+        case 'bottom':
+            return container.y + container.height - (seat.y + seat.height);
+        case 'left':
+            return seat.x - container.x;
+        case 'right':
+            return container.x + container.width - (seat.x + seat.width);
+    }
+}
+function fits(side, input, offset) {
+    const needed = side === 'top' || side === 'bottom' ? input.card.height + offset : input.card.width + offset;
+    return room(side, input) >= needed;
+}
+function chooseSide(preferred, input, offset) {
+    if (preferred === 'auto') {
+        const fitting = AUTO_ORDER.find((side) => fits(side, input, offset));
+        if (fitting) {
+            return fitting;
+        }
+        // Nothing fits whole: take the side with the most room.
+        return AUTO_ORDER.reduce((best, side) => (room(side, input) > room(best, input) ? side : best));
+    }
+    if (fits(preferred, input, offset)) {
+        return preferred;
+    }
+    const opposite = OPPOSITE[preferred];
+    if (fits(opposite, input, offset)) {
+        return opposite;
+    }
+    // Neither side fits: stay with whichever has more room, preferring the asked-for one.
+    return room(opposite, input) > room(preferred, input) ? opposite : preferred;
+}
+/** `min` wins when the range is inverted, which pins an oversized card to the top-left. */
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(value, max));
+}
+//# sourceMappingURL=seat-card-placement.js.map

package/dist/view/seat-card-placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-card-placement.js","sourceRoot":"","sources":["../../src/view/seat-card-placement.ts"],"names":[],"mappings":"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"}

package/dist/view/seat-card.d.ts

@@ -0,0 +1,83 @@
+import type { RenderSeat } from '../render/render-model.js';
+/**
+ * The vocabulary of seat hover and click, shared by both bindings.
+ *
+ * Hover and click are independent and optional (D10): a binding reports them as
+ * events, and can also show a card anchored to the seat on either one. What a
+ * card says is the consumer's; this module only names the pieces.
+ */
+/** Which side of the seat a card sits on. */
+export type SeatCardSide = 'top' | 'bottom' | 'left' | 'right';
+/** The side a card prefers. `auto` takes whichever side has the most room. */
+export type SeatCardPlacement = SeatCardSide | 'auto';
+/**
+ * What opened a card. `focus` only occurs with `hoverCardOnFocus` (D12).
+ */
+export type SeatCardTrigger = 'hover' | 'focus' | 'click';
+/**
+ * `default` draws the library's plain look; `none` drops the background, border,
+ * padding, shadow and arrow, leaving only positioning (D11).
+ */
+export type SeatCardAppearance = 'default' | 'none';
+/** What activated a seat. */
+export type SeatClickSource = 'pointer' | 'keyboard';
+/**
+ * What `onSeatClick` / `seatClick` reports (D13). A read-only notification: it
+ * cannot cancel or change what the click does.
+ */
+export interface SeatClick {
+    seat: RenderSeat;
+    /** Whether the seat was selected before this click. */
+    selected: boolean;
+    /** What activated it: a pointer click or tap, or Enter/Space on a focused seat. */
+    source: SeatClickSource;
+}
+/** What a card's content is handed. */
+export interface KerusiSeatCardContext {
+    /** Everything the document knows about the seat, already resolved. */
+    seat: RenderSeat;
+    /** Whether the seat is in the current selection. */
+    selected: boolean;
+    /** What opened the card. */
+    trigger: SeatCardTrigger;
+    /** Closes the card. Most useful for a click card's own buttons. */
+    close: () => void;
+}
+/** Milliseconds before a hover card opens and, after the pointer leaves, closes. */
+export interface HoverCardDelay {
+    open: number;
+    close: number;
+}
+export declare const DEFAULT_HOVER_CARD_DELAY: Readonly<HoverCardDelay>;
+/** Fills in whichever half of the delay the caller left out; negatives become 0. */
+export declare function resolveHoverCardDelay(delay?: Partial<HoverCardDelay>): HoverCardDelay;
+/** The pointer types that can hover. Touch has no hover (D10). */
+export declare function canHover(pointerType: string | undefined): boolean;
+/**
+ * The id a card element carries, from a per-map-instance prefix. A seat points
+ * at its hover card with `aria-describedby`; a click card is labelled by the seat
+ * through its own `aria-label`, so the id there is only a stable hook.
+ */
+export declare function seatCardId(prefix: string, kind: 'hover' | 'click'): string;
+/** The `data-*` attributes a card mirrors from its seat, so CSS can pick cards out by seat. */
+export interface SeatCardDataAttributes {
+    'data-seat-id': string;
+    'data-seat-status': string;
+    'data-seat-type': string;
+    'data-section-id': string;
+}
+export declare function seatCardDataAttributes(seat: RenderSeat): SeatCardDataAttributes;
+/** The class list for a card element: the hooks, then the consumer's own. */
+export declare function seatCardClassName(trigger: 'hover' | 'click', appearance: SeatCardAppearance, extra?: string): string;
+/**
+ * A CSS length as pixels, for the two tokens placement needs as numbers
+ * (`--kerusi-seat-card-offset`, `--kerusi-seat-card-arrow-size`).
+ *
+ * Reads `px`, `rem`, `em` and unitless numbers; anything else (a `calc()`, a
+ * percentage, an unset property) yields `fallback`.
+ */
+export declare function cssLengthToPx(value: string | null | undefined, fallback: number, fontSizes?: {
+    root?: number;
+    element?: number;
+}): number;
+//# sourceMappingURL=seat-card.d.ts.map

package/dist/view/seat-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-card.d.ts","sourceRoot":"","sources":["../../src/view/seat-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,IAAI,EAAE,UAAU,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,mEAAmE;IACnE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,cAAc,CAG5D,CAAC;AAEH,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAOrF;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAE1E;AAED,+FAA+F;AAC/F,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAQ/E;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1B,UAAU,EAAE,kBAAkB,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,MAAM,CAcR"}

package/dist/view/seat-card.js

@@ -0,0 +1,68 @@
+import { seatDataAttributes } from './seat-glyph.js';
+export const DEFAULT_HOVER_CARD_DELAY = Object.freeze({
+    open: 150,
+    close: 100,
+});
+/** Fills in whichever half of the delay the caller left out; negatives become 0. */
+export function resolveHoverCardDelay(delay) {
+    const pick = (value, fallback) => typeof value === 'number' && Number.isFinite(value) ? Math.max(0, value) : fallback;
+    return {
+        open: pick(delay?.open, DEFAULT_HOVER_CARD_DELAY.open),
+        close: pick(delay?.close, DEFAULT_HOVER_CARD_DELAY.close),
+    };
+}
+/** The pointer types that can hover. Touch has no hover (D10). */
+export function canHover(pointerType) {
+    return pointerType === 'mouse' || pointerType === 'pen';
+}
+/**
+ * The id a card element carries, from a per-map-instance prefix. A seat points
+ * at its hover card with `aria-describedby`; a click card is labelled by the seat
+ * through its own `aria-label`, so the id there is only a stable hook.
+ */
+export function seatCardId(prefix, kind) {
+    return `${prefix}-seat-card-${kind}`;
+}
+export function seatCardDataAttributes(seat) {
+    const data = seatDataAttributes(seat);
+    return {
+        'data-seat-id': seat.id,
+        'data-seat-status': data.status,
+        'data-seat-type': data.type,
+        'data-section-id': data.section,
+    };
+}
+/** The class list for a card element: the hooks, then the consumer's own. */
+export function seatCardClassName(trigger, appearance, extra) {
+    return [
+        'kerusi-seat-card',
+        `kerusi-seat-card--${trigger}`,
+        appearance === 'none' ? 'kerusi-seat-card--bare' : '',
+        extra ?? '',
+    ]
+        .filter(Boolean)
+        .join(' ');
+}
+/**
+ * A CSS length as pixels, for the two tokens placement needs as numbers
+ * (`--kerusi-seat-card-offset`, `--kerusi-seat-card-arrow-size`).
+ *
+ * Reads `px`, `rem`, `em` and unitless numbers; anything else (a `calc()`, a
+ * percentage, an unset property) yields `fallback`.
+ */
+export function cssLengthToPx(value, fallback, fontSizes = {}) {
+    const match = /^\s*(-?\d*\.?\d+)\s*(px|rem|em)?\s*$/i.exec(value ?? '');
+    if (!match) {
+        return fallback;
+    }
+    const amount = Number(match[1]);
+    switch ((match[2] ?? 'px').toLowerCase()) {
+        case 'rem':
+            return amount * (fontSizes.root ?? 16);
+        case 'em':
+            return amount * (fontSizes.element ?? fontSizes.root ?? 16);
+        default:
+            return amount;
+    }
+}
+//# sourceMappingURL=seat-card.js.map

package/dist/view/seat-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-card.js","sourceRoot":"","sources":["../../src/view/seat-card.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AA4DrD,MAAM,CAAC,MAAM,wBAAwB,GAA6B,MAAM,CAAC,MAAM,CAAC;IAC9E,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;CACX,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,KAA+B;IACnE,MAAM,IAAI,GAAG,CAAC,KAAyB,EAAE,QAAgB,EAAE,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC;QACtD,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,WAA+B;IACtD,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,KAAK,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,IAAuB;IAChE,OAAO,GAAG,MAAM,cAAc,IAAI,EAAE,CAAC;AACvC,CAAC;AAUD,MAAM,UAAU,sBAAsB,CAAC,IAAgB;IACrD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,EAAE;QACvB,kBAAkB,EAAE,IAAI,CAAC,MAAM;QAC/B,gBAAgB,EAAE,IAAI,CAAC,IAAI;QAC3B,iBAAiB,EAAE,IAAI,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAC/B,OAA0B,EAC1B,UAA8B,EAC9B,KAAc;IAEd,OAAO;QACL,kBAAkB;QAClB,qBAAqB,OAAO,EAAE;QAC9B,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE;QACrD,KAAK,IAAI,EAAE;KACZ;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgC,EAChC,QAAgB,EAChB,YAAiD,EAAE;IAEnD,MAAM,KAAK,GAAG,uCAAuC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,KAAK,KAAK;YACR,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACzC,KAAK,IAAI;YACP,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9D;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/view/seat-hover.d.ts

@@ -0,0 +1,90 @@
+import { type HoverCardDelay } from './seat-card.js';
+/**
+ * Seat hover as a reducer, the way `reduceGesture()` does pan and pinch.
+ *
+ * A binding feeds in what the pointer, the keyboard and its timers did, and
+ * applies what comes back: the seat to report to `onSeatHover` / `seatHover`,
+ * which hover card should be showing, and the one timer it should be running.
+ * The rules live here, once, so the two bindings cannot drift apart (D10):
+ *
+ * - Only a mouse or a pen hovers. Touch has no hover, and a tap stays a tap.
+ * - The seat is reported once on entry and once, as `null`, on leave. Moving
+ *   within a seat reports nothing.
+ * - While the map is panned or zoomed the hover is cleared once. It resumes on
+ *   the first pointer move after the gesture ends, not before.
+ * - A hover card opens after `delay.open`, stays while the pointer is on the
+ *   seat or on the card (WCAG 1.4.13 "hoverable"), and closes `delay.close`
+ *   after the pointer leaves both. `Escape` dismisses it, and it stays dismissed
+ *   until the pointer or focus has left that seat (WCAG 1.4.13 "dismissible").
+ * - Keyboard focus shows the card only when the binding feeds `focus` events,
+ *   which it does only with `hoverCardOnFocus` (D12).
+ */
+export interface SeatHoverState {
+    /** The seat the pointer is over, as last reported. */
+    readonly hoveredId: string | null;
+    /** True from the start of a pan or zoom until the next pointer move. */
+    readonly suppressed: boolean;
+    /** The seat whose hover card is showing. */
+    readonly cardId: string | null;
+    /** Why the card is showing. */
+    readonly cardTrigger: 'hover' | 'focus' | null;
+    /** The seat a running open timer will show a card for. */
+    readonly pendingId: string | null;
+    /** True while a close timer is running. */
+    readonly closing: boolean;
+    /** True while the pointer is on the card itself. */
+    readonly overCard: boolean;
+    /** The seat the focus is on, when focus is being followed. */
+    readonly focusedId: string | null;
+    /** A seat whose card `Escape` dismissed, until the pointer and focus leave it. */
+    readonly dismissedId: string | null;
+}
+export declare const IDLE_SEAT_HOVER: SeatHoverState;
+export type SeatHoverEvent = {
+    type: 'enter' | 'move';
+    seatId: string;
+    pointerType: string;
+} | {
+    type: 'leave';
+    seatId: string;
+    pointerType: string;
+}
+/** A pan, pinch or wheel zoom began. */
+ | {
+    type: 'gesture';
+} | {
+    type: 'card-enter' | 'card-leave';
+} | {
+    type: 'focus' | 'blur';
+    seatId: string;
+} | {
+    type: 'escape';
+}
+/** The open or close timer the reducer asked for has run out. */
+ | {
+    type: 'timer';
+    kind: 'open' | 'close';
+}
+/** The seat the card is for no longer exists, or the feature was turned off. */
+ | {
+    type: 'reset';
+};
+/** The one timer the binding should be running, if any. */
+export type SeatHoverTimer = {
+    action: 'start';
+    kind: 'open' | 'close';
+    ms: number;
+} | {
+    action: 'clear';
+};
+export interface SeatHoverResult {
+    state: SeatHoverState;
+    /** Present when `onSeatHover` should be called: with this seat, or `null`. */
+    report?: {
+        seatId: string | null;
+    };
+    /** Absent when the timer is to be left as it is. */
+    timer?: SeatHoverTimer;
+}
+export declare function reduceSeatHover(state: SeatHoverState, event: SeatHoverEvent, delay: HoverCardDelay): SeatHoverResult;
+//# sourceMappingURL=seat-hover.d.ts.map

package/dist/view/seat-hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-hover.d.ts","sourceRoot":"","sources":["../../src/view/seat-hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,eAAe,EAAE,cAU5B,CAAC;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACxD,wCAAwC;GACtC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE;AACpB,iEAAiE;GAC/D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAC3C,gFAAgF;GAC9E;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACnC,oDAAoD;IACpD,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,cAAc,GACpB,eAAe,CAgCjB"}

package/dist/view/seat-hover.js

@@ -0,0 +1,205 @@
+import { canHover } from './seat-card.js';
+export const IDLE_SEAT_HOVER = Object.freeze({
+    hoveredId: null,
+    suppressed: false,
+    cardId: null,
+    cardTrigger: null,
+    pendingId: null,
+    closing: false,
+    overCard: false,
+    focusedId: null,
+    dismissedId: null,
+});
+export function reduceSeatHover(state, event, delay) {
+    switch (event.type) {
+        case 'enter':
+        case 'move':
+            return canHover(event.pointerType) ? onPointerOver(state, event.seatId, delay) : { state };
+        case 'leave':
+            return canHover(event.pointerType) ? onPointerOut(state, event.seatId, delay) : { state };
+        case 'gesture':
+            return onGesture(state);
+        case 'card-enter':
+            return state.cardId === null
+                ? { state }
+                : { state: { ...state, overCard: true, closing: false }, timer: { action: 'clear' } };
+        case 'card-leave':
+            return onCardLeave(state, delay);
+        case 'focus':
+            return onFocus(state, event.seatId);
+        case 'blur':
+            return onBlur(state, event.seatId);
+        case 'escape':
+            return onEscape(state);
+        case 'timer':
+            return onTimer(state, event.kind);
+        case 'reset':
+            return state === IDLE_SEAT_HOVER
+                ? { state }
+                : {
+                    state: IDLE_SEAT_HOVER,
+                    timer: { action: 'clear' },
+                    report: state.hoveredId === null ? undefined : { seatId: null },
+                };
+    }
+}
+function onPointerOver(state, seatId, delay) {
+    if (state.hoveredId === seatId && !state.suppressed) {
+        return { state };
+    }
+    const resumed = { ...state, suppressed: false, hoveredId: seatId };
+    const report = { seatId };
+    if (state.dismissedId === seatId) {
+        return { state: resumed, report };
+    }
+    // Already showing this seat's card (the pointer came back during the close
+    // delay, or the card was opened by focus): keep it.
+    if (state.cardId === seatId) {
+        return {
+            state: { ...resumed, closing: false, pendingId: null },
+            report,
+            timer: { action: 'clear' },
+        };
+    }
+    // Another seat's card is showing: move to this one at once, so sweeping
+    // across a row does not flicker the card through its open delay each time.
+    if (state.cardId !== null) {
+        return {
+            state: {
+                ...resumed,
+                cardId: seatId,
+                cardTrigger: 'hover',
+                closing: false,
+                overCard: false,
+                pendingId: null,
+            },
+            report,
+            timer: { action: 'clear' },
+        };
+    }
+    if (delay.open <= 0) {
+        return {
+            state: { ...resumed, cardId: seatId, cardTrigger: 'hover', pendingId: null },
+            report,
+            timer: { action: 'clear' },
+        };
+    }
+    return {
+        state: { ...resumed, pendingId: seatId },
+        report,
+        timer: { action: 'start', kind: 'open', ms: delay.open },
+    };
+}
+function onPointerOut(state, seatId, delay) {
+    if (state.hoveredId !== seatId) {
+        return { state };
+    }
+    const left = {
+        ...state,
+        hoveredId: null,
+        pendingId: null,
+        dismissedId: state.dismissedId === seatId && state.focusedId !== seatId ? null : state.dismissedId,
+    };
+    const report = { seatId: null };
+    // A card the pointer opened lingers for the close delay, so the pointer can
+    // travel into it. One that focus opened stays with the focus.
+    if (state.cardId === seatId && state.cardTrigger === 'hover' && !state.overCard) {
+        if (delay.close <= 0) {
+            return { state: closeCard(left), report, timer: { action: 'clear' } };
+        }
+        return {
+            state: { ...left, closing: true },
+            report,
+            timer: { action: 'start', kind: 'close', ms: delay.close },
+        };
+    }
+    return {
+        state: left,
+        report,
+        timer: state.pendingId === null && !state.closing ? undefined : { action: 'clear' },
+    };
+}
+function onGesture(state) {
+    const hadHover = state.hoveredId !== null;
+    return {
+        state: { ...closeCard(state), hoveredId: null, pendingId: null, suppressed: true },
+        report: hadHover ? { seatId: null } : undefined,
+        timer: { action: 'clear' },
+    };
+}
+function onCardLeave(state, delay) {
+    if (!state.overCard) {
+        return { state };
+    }
+    const off = { ...state, overCard: false };
+    // Back on the seat, or the card is held open by focus: nothing to close.
+    if (state.cardId === null || state.cardTrigger !== 'hover' || state.hoveredId === state.cardId) {
+        return { state: off };
+    }
+    if (delay.close <= 0) {
+        return { state: closeCard(off), timer: { action: 'clear' } };
+    }
+    return {
+        state: { ...off, closing: true },
+        timer: { action: 'start', kind: 'close', ms: delay.close },
+    };
+}
+function onFocus(state, seatId) {
+    const focused = { ...state, focusedId: seatId };
+    if (state.dismissedId === seatId || state.cardId === seatId) {
+        return { state: focused };
+    }
+    return {
+        state: {
+            ...focused,
+            cardId: seatId,
+            cardTrigger: 'focus',
+            pendingId: null,
+            closing: false,
+            overCard: false,
+        },
+        timer: { action: 'clear' },
+    };
+}
+function onBlur(state, seatId) {
+    if (state.focusedId !== seatId) {
+        return { state };
+    }
+    const blurred = {
+        ...state,
+        focusedId: null,
+        dismissedId: state.dismissedId === seatId && state.hoveredId !== seatId ? null : state.dismissedId,
+    };
+    if (state.cardId !== seatId || state.cardTrigger !== 'focus') {
+        return { state: blurred };
+    }
+    // The pointer is still on the seat: the card carries on as a hover card.
+    if (state.hoveredId === seatId) {
+        return { state: { ...blurred, cardTrigger: 'hover' } };
+    }
+    return { state: closeCard(blurred), timer: { action: 'clear' } };
+}
+function onEscape(state) {
+    if (state.cardId === null && state.pendingId === null) {
+        return { state };
+    }
+    return {
+        state: { ...closeCard(state), pendingId: null, dismissedId: state.cardId ?? state.pendingId },
+        timer: { action: 'clear' },
+    };
+}
+function onTimer(state, kind) {
+    if (kind === 'open' && state.pendingId !== null) {
+        return {
+            state: { ...state, cardId: state.pendingId, cardTrigger: 'hover', pendingId: null },
+        };
+    }
+    if (kind === 'close' && state.closing) {
+        return { state: closeCard(state) };
+    }
+    return { state };
+}
+function closeCard(state) {
+    return { ...state, cardId: null, cardTrigger: null, closing: false, overCard: false };
+}
+//# sourceMappingURL=seat-hover.js.map

package/dist/view/seat-hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-hover.js","sourceRoot":"","sources":["../../src/view/seat-hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,gBAAgB,CAAC;AA4C/D,MAAM,CAAC,MAAM,eAAe,GAAmB,MAAM,CAAC,MAAM,CAAC;IAC3D,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AA2BH,MAAM,UAAU,eAAe,CAC7B,KAAqB,EACrB,KAAqB,EACrB,KAAqB;IAErB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAC7F,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QAC5F,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI;gBAC1B,CAAC,CAAC,EAAE,KAAK,EAAE;gBACX,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1F,KAAK,YAAY;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,KAAK,KAAK,eAAe;gBAC9B,CAAC,CAAC,EAAE,KAAK,EAAE;gBACX,CAAC,CAAC;oBACE,KAAK,EAAE,eAAe;oBACtB,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;oBAC1B,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;iBAChE,CAAC;IACV,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,KAAqB,EACrB,MAAc,EACd,KAAqB;IAErB,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACpD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC;IAE1B,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpC,CAAC;IAED,2EAA2E;IAC3E,oDAAoD;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE;YACtD,MAAM;YACN,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,OAAO;gBACpB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,IAAI;aAChB;YACD,MAAM;YACN,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;YAC5E,MAAM;YACN,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;SAC3B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;QACxC,MAAM;QACN,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,KAAqB,EACrB,MAAc,EACd,KAAqB;IAErB,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAmB;QAC3B,GAAG,KAAK;QACR,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EACT,KAAK,CAAC,WAAW,KAAK,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW;KACxF,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAEhC,4EAA4E;IAC5E,8DAA8D;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChF,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QACxE,CAAC;QACD,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACjC,MAAM;YACN,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE;SAC3D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,IAAI;QACX,MAAM;QACN,KAAK,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE;KACpF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IAC1C,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAClF,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;QAC/C,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB,EAAE,KAAqB;IAC/D,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1C,yEAAyE;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/F,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;QAChC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE;KAC3D,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB,EAAE,MAAc;IACpD,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAChD,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,GAAG,OAAO;YACV,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,KAAK;SAChB;QACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAqB,EAAE,MAAc;IACnD,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAmB;QAC9B,GAAG,KAAK;QACR,SAAS,EAAE,IAAI;QACf,WAAW,EACT,KAAK,CAAC,WAAW,KAAK,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW;KACxF,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,yEAAyE;IACzE,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAqB;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE;QAC7F,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAqB,EAAE,IAAsB;IAC5D,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;SACpF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAAqB;IACtC,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACxF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kerusiweb/core",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Framework-agnostic core for the Kerusi Seat Map & Availability Format: document types, a conformance validator, and the render model and geometry a seat-map renderer consumes.",
   "keywords": [
     "kerusi",