@kerusiweb/react 2.3.0 → 3.1.0

package/dist/public-api.js

@@ -5,7 +5,7 @@
  * there, not re-exported here: the document types (`KerusiMap`, `KerusiState`,
  * `KerusiSession`), the conformance validator, the render model
  * (`buildRenderModel`, `RenderMap`, `RenderSeat`), the geometry
- * (`computeSectionLayout`), and the view helpers (`summarizeSelection`,
+ * (`computeMapLayout`), and the view helpers (`summarizeSelection`,
  * `seatAriaLabel`, `DEFAULT_KERUSI_COLORS`). This package supplies only what is
  * React's: components, hooks, and their props.
  *

package/dist/seat-card.d.ts

@@ -0,0 +1,36 @@
+import type { RenderSeat, SeatCardAppearance, SeatCardPlacement } from '@kerusiweb/core';
+import type { ReactNode, RefObject } from 'react';
+export interface SeatCardProps {
+    kind: 'hover' | 'click';
+    /** The card's `id`: a hover card is named by the seat's `aria-describedby`. */
+    id: string;
+    seat: RenderSeat;
+    /** Names a click card's dialog. */
+    label: string;
+    placement: SeatCardPlacement;
+    appearance: SeatCardAppearance;
+    className?: string;
+    /** The map's root element: the card is positioned in it and kept inside it. */
+    rootRef: RefObject<HTMLElement | null>;
+    getSeatNode: (seatId: string) => SVGGElement | null;
+    /** Moves focus into the card on mount; a click card opened from the keyboard. */
+    focusOnOpen?: boolean;
+    /** A hover card is hoverable (WCAG 1.4.13): the pointer may enter it. */
+    onPointerEnter?: () => void;
+    onPointerLeave?: () => void;
+    children: ReactNode;
+}
+/**
+ * One seat card: a floating element anchored to a seat.
+ *
+ * It sits inside the map's root, outside the clipped viewport, so it shows in
+ * full screen and inherits the `--kerusi-*` properties set on the map. Where it
+ * goes is `placeSeatCard()`'s; this component measures the seat, the card and
+ * the root, and re-measures after every render and whenever the root or the card
+ * changes size, which is how it follows zoom, pan, maximize and full screen.
+ *
+ * It sets no colour, no padding and no font: that is the stylesheet's, and then
+ * the consumer's (D11).
+ */
+export declare function SeatCard({ kind, id, seat, label, placement, appearance, className, rootRef, getSeatNode, focusOnOpen, onPointerEnter, onPointerLeave, children, }: SeatCardProps): import("react").JSX.Element;
+//# sourceMappingURL=seat-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seat-card.d.ts","sourceRoot":"","sources":["../src/seat-card.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAiB,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACpD,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,KAAK,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAmB,EACnB,cAAc,EACd,cAAc,EACd,QAAQ,GACT,EAAE,aAAa,+BAsHf"}

package/dist/seat-card.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cssLengthToPx, placeSeatCard, seatCardClassName, seatCardDataAttributes, } from '@kerusiweb/core';
+import { useLayoutEffect, useRef, useState } from 'react';
+const DEFAULT_OFFSET = 8;
+const DEFAULT_ARROW = 6;
+/**
+ * One seat card: a floating element anchored to a seat.
+ *
+ * It sits inside the map's root, outside the clipped viewport, so it shows in
+ * full screen and inherits the `--kerusi-*` properties set on the map. Where it
+ * goes is `placeSeatCard()`'s; this component measures the seat, the card and
+ * the root, and re-measures after every render and whenever the root or the card
+ * changes size, which is how it follows zoom, pan, maximize and full screen.
+ *
+ * It sets no colour, no padding and no font: that is the stylesheet's, and then
+ * the consumer's (D11).
+ */
+export function SeatCard({ kind, id, seat, label, placement, appearance, className, rootRef, getSeatNode, focusOnOpen = false, onPointerEnter, onPointerLeave, children, }) {
+    const cardRef = useRef(null);
+    const [position, setPosition] = useState(null);
+    /** False when the consumer set `--kerusi-seat-card-arrow-size: 0`. */
+    const [arrowShown, setArrowShown] = useState(true);
+    const measure = () => {
+        const root = rootRef.current;
+        const card = cardRef.current;
+        const seatNode = getSeatNode(seat.id);
+        if (!root || !card || !seatNode) {
+            return;
+        }
+        const rootBox = root.getBoundingClientRect();
+        const seatBox = seatNode.getBoundingClientRect();
+        // `position: absolute` is measured from the root's padding box.
+        const originX = rootBox.left + root.clientLeft;
+        const originY = rootBox.top + root.clientTop;
+        const styles = getComputedStyle(card);
+        const fontSizes = {
+            root: parseFloat(getComputedStyle(card.ownerDocument.documentElement).fontSize) || 16,
+            element: parseFloat(styles.fontSize) || 16,
+        };
+        const arrowSize = cssLengthToPx(styles.getPropertyValue('--kerusi-seat-card-arrow-size'), DEFAULT_ARROW, fontSizes);
+        setArrowShown(arrowSize > 0);
+        const next = placeSeatCard({
+            seat: {
+                x: seatBox.left - originX,
+                y: seatBox.top - originY,
+                width: seatBox.width,
+                height: seatBox.height,
+            },
+            card: { width: card.offsetWidth, height: card.offsetHeight },
+            container: { x: 0, y: 0, width: root.clientWidth, height: root.clientHeight },
+            placement,
+            offset: cssLengthToPx(styles.getPropertyValue('--kerusi-seat-card-offset'), DEFAULT_OFFSET, fontSizes),
+            arrowInset: Math.max(12, arrowSize * 2),
+        });
+        setPosition((current) => current &&
+            current.side === next.side &&
+            current.x === next.x &&
+            current.y === next.y &&
+            current.arrowOffset === next.arrowOffset
+            ? current
+            : next);
+    };
+    // After every render, before paint: the card is in place when it first shows,
+    // and a zoom or pan (which re-renders the map) moves it with the seat.
+    useLayoutEffect(measure);
+    // A change the render did not announce: the root resized (maximize, full
+    // screen, a rotated phone), or the card's own content did.
+    useLayoutEffect(() => {
+        const root = rootRef.current;
+        const card = cardRef.current;
+        if (!root || !card || typeof ResizeObserver === 'undefined') {
+            return;
+        }
+        const observer = new ResizeObserver(() => measure());
+        observer.observe(root);
+        observer.observe(card);
+        return () => observer.disconnect();
+        // `measure` closes over props that are stable for as long as the card is this seat's.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [seat.id, placement]);
+    useLayoutEffect(() => {
+        if (!focusOnOpen) {
+            return;
+        }
+        const card = cardRef.current;
+        if (!card) {
+            return;
+        }
+        const first = card.querySelector('a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])');
+        (first ?? card).focus({ preventScroll: true });
+    }, [focusOnOpen, seat.id]);
+    const style = {
+        left: position?.x ?? 0,
+        top: position?.y ?? 0,
+        '--kerusi-seat-card-arrow-shift': `${position?.arrowOffset ?? 0}px`,
+    };
+    return (_jsxs("div", { ref: cardRef, id: id, className: seatCardClassName(kind, appearance, className), role: kind === 'hover' ? 'tooltip' : 'dialog', "aria-label": kind === 'click' ? label : undefined, tabIndex: kind === 'click' ? -1 : undefined, "data-placement": position?.side ?? (placement === 'auto' ? 'top' : placement), ...seatCardDataAttributes(seat), style: style, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, children: [_jsx("div", { className: "kerusi-seat-card__body", children: children }), appearance === 'none' || !arrowShown ? null : (_jsx("span", { className: "kerusi-seat-card__arrow", "aria-hidden": "true" }))] }));
+}
+//# sourceMappingURL=seat-card.js.map

package/dist/seat-card.js.map

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

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { DisallowedReason, KerusiControlStrings, KerusiMap, KerusiSeatContext, KerusiSeatmapColors, KerusiSession, KerusiState, KerusiViewport, KerusiViolation, RenderSeat, SeatAriaStrings, SeatRenderStatus, SeatStyleFn, SeatTypeStyles, SelectionSummary } from '@kerusiweb/core';
+import type { DisallowedReason, HoverCardDelay, KerusiControlStrings, KerusiMap, KerusiSeatCardContext, KerusiSeatContext, KerusiSeatmapColors, KerusiSession, KerusiState, KerusiViewport, KerusiViolation, RenderSeat, SeatAriaStrings, SeatCardAppearance, SeatCardPlacement, SeatClick, SeatRenderStatus, SeatStyleFn, SeatTypeStyles, SelectionSummary } from '@kerusiweb/core';
 import type { CSSProperties, ReactNode } from 'react';
 /** How a document with validation errors is handled. */
 export type ValidationMode = 
@@ -10,11 +10,8 @@ export type ValidationMode =
  | 'off';
 /** Per-section rendering overrides, keyed by `Section.id`. */
 export interface SectionRenderOptions {
+    /** Leaves the section out. Its space on the canvas stays empty (D4). */
     hidden?: boolean;
-    /** Overrides `Section.aspectRatio`. */
-    aspectRatio?: string;
-    /** Overrides the seat size for this section only. */
-    seatSize?: number;
     /** Overrides the localized `Section.label`. */
     label?: string;
 }
@@ -47,14 +44,29 @@ export interface KerusiSeatmapHandle {
     readonly summary: SelectionSummary;
     /** Moves DOM focus to a seat, if it is rendered. */
     focusSeat(seatId: string): void;
+    /**
+     * Opens the click card for a seat, for example from a search result. No-op
+     * without `renderClickCard`, or for a seat that is not rendered.
+     */
+    openSeatCard(seatId: string): void;
+    /** Closes the click card. */
+    closeSeatCard(): void;
+    /** The seat whose click card is showing, or `null`. */
+    readonly openSeatCardId: string | null;
     /** The current zoom and pan. Fit (`{ zoom: 1, x: 0, y: 0 }`) unless `zoomable`. */
     readonly viewport: KerusiViewport;
     /** Zooms in one step about the centre. No-op unless `zoomable`. */
     zoomIn(): void;
     /** Zooms out one step about the centre. No-op unless `zoomable`. */
     zoomOut(): void;
-    /** Back to fit-to-container: the map's original view. No-op unless `zoomable`. */
+    /** Back to fit-to-container: the whole canvas. No-op unless `zoomable`. */
     resetZoom(): void;
+    /**
+     * Zooms to one section: its declared `bounds`, or the box around its seats
+     * and elements when it declares none. No-op unless `zoomable`, or for a
+     * section that is not rendered.
+     */
+    zoomToSection(sectionId: string): void;
     /** Whether the map is currently maximized. */
     readonly maximized: boolean;
     /** Maximizes or restores the map. Maximizing needs `maximizable`. */
@@ -97,23 +109,24 @@ export interface KerusiSeatmapProps {
     /**
      * Draws the inside of every seat yourself. The library keeps the seat's
      * `<g>`, with its role, ARIA state, tab stop, rotation and event handlers, and
-     * renders whatever this returns inside it, in viewBox units. Return
+     * renders whatever this returns inside it, in canvas units. Return
      * `ctx.defaultContent` for the stock seat, or add to it. While this is set the
      * library also draws a focus outline over your content, so keyboard focus
      * stays visible whatever you draw.
      */
     renderSeat?: (ctx: SeatRenderContext) => ReactNode;
-    /** Grid cell edge, in viewBox units. */
-    seatSize?: number;
-    /** Gap between grid cells, in viewBox units. */
-    seatGap?: number;
-    /** Freeform viewBox width; height follows the section's aspect ratio. */
-    freeformBasis?: number;
     /**
-     * CSS pixels per viewBox unit. Caps each section at its natural size so a
-     * narrow section and a wide one in the same map draw seats the same size.
+     * CSS pixels per canvas unit, at most: the map never draws wider than
+     * `canvas.width × unitScale`, and scales down to a narrower container. The
+     * document fixes every seat's size and position (§4.5); this is the only
+     * sizing control. Default `1`.
      */
     unitScale?: number;
+    /**
+     * Draws each section's label inside the map, at the top-left of its `bounds`.
+     * Only sections that declare `bounds` get one; every section's label is its
+     * group's accessible name either way. Default `true`.
+     */
     showSectionLabels?: boolean;
     showLegend?: boolean;
     showLegendPrices?: boolean;
@@ -131,7 +144,11 @@ export interface KerusiSeatmapProps {
      * Memoize it — an inline arrow rebuilds the whole render model every render.
      */
     seatSelectable?: (seat: RenderSeat) => boolean;
-    /** When false the map renders read-only: no pointer or keyboard interaction. */
+    /**
+     * `false` turns selection off. Seats still take clicks, and stay
+     * keyboard-reachable, while `onSeatClick` or `renderClickCard` is set (D14).
+     * With neither set, a read-only map has no pointer or keyboard interaction.
+     */
     interactive?: boolean;
     /**
      * Revert a lapsed `holdExpires` to available on a ticker (§5.1). Off by
@@ -159,11 +176,61 @@ export interface KerusiSeatmapProps {
      * Memoize it — a new object each render rebuilds the controls' strings.
      */
     controlStrings?: Partial<KerusiControlStrings>;
+    /**
+     * Shown while a seat is hovered, anchored to it. Return `null` for no card on
+     * this seat. Never shown for touch. With neither card function set, nothing is
+     * rendered and the markup is unchanged (D10).
+     *
+     * A hover card is pointer-only unless `hoverCardOnFocus` is set, so it must not
+     * be the only place important information lives.
+     */
+    renderHoverCard?: (ctx: KerusiSeatCardContext) => ReactNode;
+    /**
+     * Opened by a click, tap or Enter/Space on a seat, anchored to it. It stays
+     * open until dismissed: `Escape`, a press outside, a second click on the same
+     * seat, `ctx.close()`, or another seat's click card opening. Return `null` for
+     * no card on this seat.
+     *
+     * A click on a selectable seat still toggles it. To show details without
+     * selecting, turn selection off with `interactive={false}`,
+     * `selectableStatuses={[]}` or `seatSelectable`.
+     */
+    renderClickCard?: (ctx: KerusiSeatCardContext) => ReactNode;
+    /** The side a card prefers; it flips when it would overflow the map. Default `top`. */
+    seatCardPlacement?: SeatCardPlacement;
+    /** Extra classes on the card element, for Tailwind or a design-system class (D11). */
+    seatCardClassName?: string;
+    /**
+     * `none` drops the card's background, border, padding, shadow and arrow,
+     * leaving only positioning, so your content is the card (D11). Default `default`.
+     */
+    seatCardAppearance?: SeatCardAppearance;
+    /** Milliseconds before a hover card opens and closes. Default `{ open: 150, close: 100 }`. */
+    hoverCardDelay?: Partial<HoverCardDelay>;
+    /**
+     * Also show the hover card when a seat takes keyboard focus (D12). Default
+     * `false`. Setting it makes seats keyboard-reachable even on a read-only map.
+     */
+    hoverCardOnFocus?: boolean;
     validate?: ValidationMode;
     onSeatSelect?: (event: SeatInteraction) => void;
     onSeatDeselect?: (event: SeatInteraction) => void;
     onSeatDisallowed?: (event: SeatDisallowed) => void;
     onSeatFocus?: (seat: RenderSeat) => void;
+    /**
+     * The seat under the pointer when it enters a seat, and `null` when it leaves
+     * the seat or the map. Not repeated while the pointer moves within a seat.
+     * Pointer devices only (mouse and pen), never during a pan or zoom, and
+     * unaffected by `interactive` (D10).
+     */
+    onSeatHover?: (seat: RenderSeat | null) => void;
+    /**
+     * Every activation of any seat, whether or not it can be selected: booked,
+     * held and blocked seats included. Fires before the selection callbacks, with
+     * `selected` as it was before the click. A read-only notification: it cannot
+     * cancel or change what the click does (D13).
+     */
+    onSeatClick?: (event: SeatClick) => void;
     /** Called whenever the documents change, unless `validate` is `off`. */
     onValidationIssues?: (issues: readonly KerusiViolation[]) => void;
     /** The zoom and pan, whenever they change. For a host that persists or shows them. */
@@ -171,7 +238,7 @@ export interface KerusiSeatmapProps {
     onMaximizedChange?: (maximized: boolean) => void;
     className?: string;
     style?: CSSProperties;
-    /** Rendered inside the map's root element, after the sections and legend. */
+    /** Rendered inside the map's root element, after the map and legend. */
     children?: ReactNode;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/use-seat-cards.d.ts

@@ -0,0 +1,55 @@
+import type { HoverCardDelay, KerusiSeatCardContext, RenderMap, RenderSeat, SeatAriaStrings, SeatCardAppearance, SeatCardPlacement, SeatClickSource } from '@kerusiweb/core';
+import type { ReactNode, RefObject } from 'react';
+export interface UseSeatCardsOptions {
+    rootRef: RefObject<HTMLElement | null>;
+    renderMap: RenderMap;
+    selection: ReadonlySet<string>;
+    locale: string;
+    ariaStrings: SeatAriaStrings;
+    getSeatNode: (seatId: string) => SVGGElement | null;
+    focusSeat: (seatId: string) => void;
+    onSeatHover?: (seat: RenderSeat | null) => void;
+    renderHoverCard?: (ctx: KerusiSeatCardContext) => ReactNode;
+    renderClickCard?: (ctx: KerusiSeatCardContext) => ReactNode;
+    placement: SeatCardPlacement;
+    className?: string;
+    appearance: SeatCardAppearance;
+    hoverCardDelay?: Partial<HoverCardDelay>;
+    hoverCardOnFocus: boolean;
+}
+export interface SeatCards {
+    /** Whether seats need pointer listeners at all. */
+    tracksPointer: boolean;
+    /** Whether seats need focus and blur listeners for a hover card (D12). */
+    tracksFocus: boolean;
+    /** A click behaviour is configured: `onSeatClick` or a click card (D14). */
+    pointer(type: 'enter' | 'leave' | 'move', seatId: string, pointerType: string): void;
+    focus(seatId: string): void;
+    blur(seatId: string): void;
+    /** A pan, pinch or wheel zoom began. */
+    gesture(): void;
+    /** Opens or closes the click card for an activated seat. */
+    activate(seatId: string, source: SeatClickSource): void;
+    /** Closes what is open, hover card first. True if a card was showing. */
+    dismiss(): boolean;
+    openSeatCard(seatId: string): void;
+    closeSeatCard(): void;
+    /** The seat whose click card is showing. */
+    openSeatCardId: string | null;
+    /** The seat → card `id` link, for the seat showing a hover card. */
+    describedBy: {
+        seatId: string;
+        id: string;
+    } | null;
+    /** Both cards, as elements to render inside the map's root. */
+    elements: ReactNode;
+}
+/**
+ * Seat hover events and the two seat cards (D10).
+ *
+ * The rules are core's: `reduceSeatHover()` decides what a pointer, a key or a
+ * timer means, and `placeSeatCard()` where a card goes. This hook holds the
+ * state, runs the one timer the reducer asks for, and renders the cards.
+ */
+export declare function useSeatCards(options: UseSeatCardsOptions): SeatCards;
+//# sourceMappingURL=use-seat-cards.d.ts.map

package/dist/use-seat-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-seat-cards.d.ts","sourceRoot":"","sources":["../src/use-seat-cards.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAGhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IACpD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,SAAS,CAAC;IAC5D,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,SAAS,CAAC;IAC5D,SAAS,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACrF,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wCAAwC;IACxC,OAAO,IAAI,IAAI,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACxD,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC;IACnB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,IAAI,IAAI,CAAC;IACtB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oEAAoE;IACpE,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,EAAE,SAAS,CAAC;CACrB;AAUD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAiSpE"}

package/dist/use-seat-cards.js

@@ -0,0 +1,202 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { IDLE_SEAT_HOVER, reduceSeatHover, resolveHoverCardDelay, seatAriaLabel, seatCardId, } from '@kerusiweb/core';
+import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
+import { SeatCard } from './seat-card.js';
+/** `null`, `undefined`, `false`, `true`, `''` and `[]` draw nothing. */
+function isEmptyContent(node) {
+    if (node === null || node === undefined || typeof node === 'boolean' || node === '') {
+        return true;
+    }
+    return Array.isArray(node) && node.every(isEmptyContent);
+}
+/**
+ * Seat hover events and the two seat cards (D10).
+ *
+ * The rules are core's: `reduceSeatHover()` decides what a pointer, a key or a
+ * timer means, and `placeSeatCard()` where a card goes. This hook holds the
+ * state, runs the one timer the reducer asks for, and renders the cards.
+ */
+export function useSeatCards(options) {
+    const { rootRef, renderMap, selection, locale, ariaStrings, getSeatNode, focusSeat, renderHoverCard, renderClickCard, placement, className, appearance, hoverCardOnFocus, } = options;
+    const prefix = useId();
+    const delayOpen = options.hoverCardDelay?.open;
+    const delayClose = options.hoverCardDelay?.close;
+    const delay = useMemo(() => resolveHoverCardDelay({ open: delayOpen, close: delayClose }), [delayOpen, delayClose]);
+    // The latest of everything the long-lived callbacks read.
+    const live = useRef({ renderMap, delay, onSeatHover: options.onSeatHover });
+    live.current = { renderMap, delay, onSeatHover: options.onSeatHover };
+    // --- hover ----------------------------------------------------------------
+    const [hover, setHover] = useState(IDLE_SEAT_HOVER);
+    const hoverRef = useRef(IDLE_SEAT_HOVER);
+    const timer = useRef(undefined);
+    const feed = useCallback((event) => {
+        const result = reduceSeatHover(hoverRef.current, event, live.current.delay);
+        hoverRef.current = result.state;
+        setHover(result.state);
+        if (result.timer) {
+            clearTimeout(timer.current);
+            timer.current = undefined;
+            if (result.timer.action === 'start') {
+                const { kind, ms } = result.timer;
+                timer.current = setTimeout(() => feed({ type: 'timer', kind }), ms);
+            }
+        }
+        if (result.report) {
+            const { seatId } = result.report;
+            const seat = seatId === null ? null : (live.current.renderMap.seatsById.get(seatId) ?? null);
+            if (seatId === null || seat) {
+                live.current.onSeatHover?.(seat);
+            }
+        }
+    }, []);
+    useEffect(() => () => clearTimeout(timer.current), []);
+    const tracksPointer = !!options.onSeatHover || !!renderHoverCard;
+    const tracksFocus = hoverCardOnFocus && !!renderHoverCard;
+    const pointer = useCallback((type, seatId, pointerType) => feed({ type, seatId, pointerType }), [feed]);
+    const focus = useCallback((seatId) => feed({ type: 'focus', seatId }), [feed]);
+    const blur = useCallback((seatId) => feed({ type: 'blur', seatId }), [feed]);
+    const gesture = useCallback(() => feed({ type: 'gesture' }), [feed]);
+    // --- click ----------------------------------------------------------------
+    const [clickId, setClickId] = useState(null);
+    const clickRef = useRef(null);
+    clickRef.current = clickId;
+    /** Set when the card is opened from the keyboard, so focus moves into it. */
+    const [clickFromKeyboard, setClickFromKeyboard] = useState(false);
+    /**
+     * Closes the click card. Focus goes back to the seat only when it was inside
+     * the card, so a press elsewhere on the page keeps the focus it just took.
+     */
+    const closeClick = useCallback((restoreFocus) => {
+        const current = clickRef.current;
+        if (current !== null && restoreFocus) {
+            const card = rootRef.current?.querySelector('.kerusi-seat-card--click');
+            if (card?.contains(card.ownerDocument.activeElement)) {
+                // After the card is gone, so nothing fights the focus move.
+                queueMicrotask(() => focusSeat(current));
+            }
+        }
+        setClickId(null);
+        setClickFromKeyboard(false);
+    }, [rootRef, focusSeat]);
+    const activate = useCallback((seatId, source) => {
+        if (!renderClickCard) {
+            return;
+        }
+        if (clickId === seatId) {
+            closeClick(true);
+            return;
+        }
+        setClickId(seatId);
+        setClickFromKeyboard(source === 'keyboard');
+    }, [renderClickCard, clickId, closeClick]);
+    const openSeatCard = useCallback((seatId) => {
+        if (renderClickCard && live.current.renderMap.seatsById.has(seatId)) {
+            setClickId(seatId);
+            setClickFromKeyboard(false);
+        }
+    }, [renderClickCard]);
+    const closeSeatCard = useCallback(() => closeClick(true), [closeClick]);
+    // --- what is showing ------------------------------------------------------
+    const clickSeat = clickId ? renderMap.seatsById.get(clickId) : undefined;
+    const hoverSeat = hover.cardId ? renderMap.seatsById.get(hover.cardId) : undefined;
+    const contextFor = (seat, trigger, close) => ({ seat, selected: selection.has(seat.id), trigger, close });
+    const clickContent = renderClickCard && clickSeat
+        ? renderClickCard(contextFor(clickSeat, 'click', () => closeClick(true)))
+        : null;
+    const clickShowing = clickSeat !== undefined && !isEmptyContent(clickContent);
+    // A click card open for a seat hides that seat's hover card.
+    const hoverContent = renderHoverCard && hoverSeat && hoverSeat.id !== clickId
+        ? renderHoverCard(contextFor(hoverSeat, hover.cardTrigger === 'focus' ? 'focus' : 'hover', () => feed({ type: 'escape' })))
+        : null;
+    const hoverShowing = hoverSeat !== undefined && !isEmptyContent(hoverContent);
+    // A seat that goes away (a hidden section, a new map) takes its cards with it.
+    useEffect(() => {
+        if (clickId !== null && !renderMap.seatsById.has(clickId)) {
+            closeClick(false);
+        }
+        if (hover.cardId !== null && !renderMap.seatsById.has(hover.cardId)) {
+            feed({ type: 'reset' });
+        }
+    }, [renderMap, clickId, hover.cardId, closeClick, feed]);
+    // A card whose render function is taken away has nothing to show.
+    useEffect(() => {
+        if (!renderClickCard && clickId !== null) {
+            closeClick(false);
+        }
+    }, [renderClickCard, clickId, closeClick]);
+    useEffect(() => {
+        if (!tracksPointer && hoverRef.current !== IDLE_SEAT_HOVER) {
+            feed({ type: 'reset' });
+        }
+    }, [tracksPointer, feed]);
+    const dismiss = useCallback(() => {
+        if (clickId !== null) {
+            closeClick(true);
+            return clickShowing;
+        }
+        if (hoverRef.current.cardId !== null || hoverRef.current.pendingId !== null) {
+            feed({ type: 'escape' });
+            return hoverShowing;
+        }
+        return false;
+    }, [clickId, clickShowing, hoverShowing, closeClick, feed]);
+    const anyOpen = clickId !== null || hover.cardId !== null;
+    // Escape anywhere dismisses a card, including with focus outside the map: a
+    // hover card the pointer opened must be dismissible without moving it (WCAG
+    // 1.4.13). The map's own key handling runs first and marks the event handled.
+    useEffect(() => {
+        if (!anyOpen) {
+            return;
+        }
+        const doc = rootRef.current?.ownerDocument ?? document;
+        const onKeyDown = (event) => {
+            if (event.key === 'Escape' && !event.defaultPrevented && dismiss()) {
+                event.preventDefault();
+            }
+        };
+        doc.addEventListener('keydown', onKeyDown);
+        return () => doc.removeEventListener('keydown', onKeyDown);
+    }, [anyOpen, dismiss, rootRef]);
+    // A press outside the click card and outside every seat closes it. A press on
+    // a seat is that seat's own click, which opens or closes a card by itself.
+    useEffect(() => {
+        if (clickId === null) {
+            return;
+        }
+        const doc = rootRef.current?.ownerDocument ?? document;
+        const onPointerDown = (event) => {
+            const target = event.target;
+            const root = rootRef.current;
+            if (!target || !root) {
+                return;
+            }
+            const inCard = target.closest?.('.kerusi-seat-card--click');
+            const onSeat = root.contains(target) && target.closest?.('[data-seat-id]');
+            if (!inCard && !onSeat) {
+                closeClick(false);
+            }
+        };
+        doc.addEventListener('pointerdown', onPointerDown, true);
+        return () => doc.removeEventListener('pointerdown', onPointerDown, true);
+    }, [clickId, closeClick, rootRef]);
+    // --- render ---------------------------------------------------------------
+    const hoverId = seatCardId(prefix, 'hover');
+    const clickCardId = seatCardId(prefix, 'click');
+    const elements = (_jsxs(_Fragment, { children: [hoverShowing && hoverSeat && (_jsx(SeatCard, { kind: "hover", id: hoverId, seat: hoverSeat, label: "", placement: placement, appearance: appearance, className: className, rootRef: rootRef, getSeatNode: getSeatNode, onPointerEnter: () => feed({ type: 'card-enter' }), onPointerLeave: () => feed({ type: 'card-leave' }), children: hoverContent }, `hover:${hoverSeat.id}`)), clickShowing && clickSeat && (_jsx(SeatCard, { kind: "click", id: clickCardId, seat: clickSeat, label: seatAriaLabel(clickSeat, locale, ariaStrings), placement: placement, appearance: appearance, className: className, rootRef: rootRef, getSeatNode: getSeatNode, focusOnOpen: clickFromKeyboard, children: clickContent }, `click:${clickSeat.id}`))] }));
+    return {
+        tracksPointer,
+        tracksFocus,
+        pointer,
+        focus,
+        blur,
+        gesture,
+        activate,
+        dismiss,
+        openSeatCard,
+        closeSeatCard,
+        openSeatCardId: clickShowing ? clickId : null,
+        describedBy: hoverShowing && hoverSeat ? { seatId: hoverSeat.id, id: hoverId } : null,
+        elements,
+    };
+}
+//# sourceMappingURL=use-seat-cards.js.map

package/dist/use-seat-cards.js.map

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