@kerusiweb/core 2.0.0

package/dist/render/build-render-model.d.ts

@@ -0,0 +1,36 @@
+import { KerusiMap } from '../kerusi/kerusi-map.model.js';
+import { KerusiState } from '../kerusi/kerusi-state.model.js';
+import { RenderMap, RenderSeat, SeatRenderStatus } from './render-model.js';
+/** Which statuses a seat may be picked in, unless the caller says otherwise. */
+export declare const DEFAULT_SELECTABLE_STATUSES: readonly SeatRenderStatus[];
+export interface BuildRenderModelOptions {
+    /** Overrides `KerusiMap.locale` for label resolution. */
+    locale?: string;
+    /** Render only these sections, in this order. Default: all, by `Section.index`. */
+    sectionIds?: readonly string[];
+    /** Statuses in which a seat may be picked. Default: `['available']`. */
+    selectableStatuses?: readonly SeatRenderStatus[];
+    /** A final say on whether a seat is selectable, applied after the status test. */
+    seatSelectable?: (seat: RenderSeat) => boolean;
+}
+/**
+ * Builds the renderer's view of a `KerusiMap` with its `KerusiState` merged in.
+ *
+ * Everything the standard makes a consumer resolve happens here, once:
+ *  - sections ordered by `Section.index`, and each given its own layout mode
+ *    per §4.5 — this is what lets a grid balcony and a freeform orchestra
+ *    coexist in one map;
+ *  - every row a section declares materialized, empty rows included, in the
+ *    §4.2.1 order, with seats grouped into them by `Seat.row` and ordered by
+ *    `col` (grid, mixed) or `x` (freeform);
+ *  - availability merged by `Seat.id`, honoring §5.1's sparse rule that an
+ *    absent seat is available;
+ *  - price resolved through the §4.9 precedence order;
+ *  - `Section.label` and `SeatType.label` localized against the map's locale.
+ *
+ * It does NOT validate — call `validateKerusiMap` or `checkKerusiMap` first.
+ * Given an invalid document it builds the best model it can rather than
+ * throwing, so a caller in "collect" mode can render and report at once.
+ */
+export declare function buildRenderModel(map: KerusiMap, state?: KerusiState, options?: BuildRenderModelOptions): RenderMap;
+//# sourceMappingURL=build-render-model.d.ts.map

package/dist/render/build-render-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-render-model.d.ts","sourceRoot":"","sources":["../../src/render/build-render-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0B,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAK9D,OAAO,EAIL,SAAS,EAET,UAAU,EAEV,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAK3B,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,EAAE,SAAS,gBAAgB,EAAkB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,kFAAkF;IAClF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,KAAK,CAAC,EAAE,WAAW,EACnB,OAAO,GAAE,uBAA4B,GACpC,SAAS,CA6CX"}

package/dist/render/build-render-model.js

@@ -0,0 +1,258 @@
+import { resolveSectionLayoutMode } from '../kerusi/kerusi-layout-mode.js';
+import { resolveLocalizedText, resolveMapLocale } from '../kerusi/kerusi-locale.js';
+import { resolveSeatPrice, resolveTierPrice } from '../kerusi/kerusi-price.js';
+import { orderRowMeta } from '../kerusi/kerusi-rows.js';
+/** The default section proportions when none is declared (§4.5). */
+const DEFAULT_ASPECT_RATIO = '1:1';
+/** Which statuses a seat may be picked in, unless the caller says otherwise. */
+export const DEFAULT_SELECTABLE_STATUSES = ['available'];
+/**
+ * Builds the renderer's view of a `KerusiMap` with its `KerusiState` merged in.
+ *
+ * Everything the standard makes a consumer resolve happens here, once:
+ *  - sections ordered by `Section.index`, and each given its own layout mode
+ *    per §4.5 — this is what lets a grid balcony and a freeform orchestra
+ *    coexist in one map;
+ *  - every row a section declares materialized, empty rows included, in the
+ *    §4.2.1 order, with seats grouped into them by `Seat.row` and ordered by
+ *    `col` (grid, mixed) or `x` (freeform);
+ *  - availability merged by `Seat.id`, honoring §5.1's sparse rule that an
+ *    absent seat is available;
+ *  - price resolved through the §4.9 precedence order;
+ *  - `Section.label` and `SeatType.label` localized against the map's locale.
+ *
+ * It does NOT validate — call `validateKerusiMap` or `checkKerusiMap` first.
+ * Given an invalid document it builds the best model it can rather than
+ * throwing, so a caller in "collect" mode can render and report at once.
+ */
+export function buildRenderModel(map, state, options = {}) {
+    const locale = resolveMapLocale(map, options.locale);
+    const selectableStatuses = new Set(options.selectableStatuses ?? DEFAULT_SELECTABLE_STATUSES);
+    const legendById = new Map((map.legend ?? []).map((t) => [t.id, t]));
+    const seatsById = new Map();
+    const typeCounts = new Map();
+    const currencies = new Set();
+    const sections = selectSections(map, options.sectionIds).map((section) => buildSection(section, {
+        map,
+        state,
+        locale,
+        selectableStatuses,
+        seatSelectable: options.seatSelectable,
+        legendById,
+        seatsById,
+        typeCounts,
+        currencies,
+    }));
+    const legend = (map.legend ?? []).map((type) => {
+        const price = resolveTierPrice(map, type.defaultPriceTier);
+        return {
+            id: type.id,
+            label: resolveLocalizedText(type.label, locale) ?? type.id,
+            color: type.color,
+            defaultTier: map.priceTiers?.find((t) => t.id === type.defaultPriceTier),
+            price,
+            seatCount: typeCounts.get(type.id) ?? 0,
+        };
+    });
+    return {
+        id: map.id,
+        name: map.name,
+        locale,
+        domain: map.domain,
+        sections,
+        legend,
+        // §4.9 forbids mixing currencies, so the first is the map's.
+        currency: [...currencies][0],
+        seatsById,
+    };
+}
+function buildSection(section, ctx) {
+    const layoutMode = resolveSectionLayoutMode(section);
+    const rows = buildRows(section, layoutMode, ctx);
+    return {
+        id: section.id,
+        label: resolveLocalizedText(section.label, ctx.locale),
+        layoutMode,
+        aspectRatio: section.aspectRatio ?? DEFAULT_ASPECT_RATIO,
+        rows,
+        seats: rows.flatMap((r) => r.seats),
+        elements: buildElements(section, rows),
+        directions: buildDirections(section, ctx.locale),
+        source: section,
+    };
+}
+/**
+ * Localizes `Section.directions` (§4.10) and carries it through. Both ends of a
+ * `Direction` may be a locale map, exactly as `Section.label` may be.
+ *
+ * Nothing downstream reads this — §4.10 forbids a renderer deciding layout or
+ * screen placement from it. It exists so an application can print "front of
+ * train" beside the axis the document says means that.
+ */
+function buildDirections(section, locale) {
+    if (!section.directions?.length) {
+        return undefined;
+    }
+    return section.directions.map((direction) => ({
+        axis: direction.axis,
+        low: resolveLocalizedText(direction.low, locale) ?? '',
+        high: resolveLocalizedText(direction.high, locale) ?? '',
+    }));
+}
+/**
+ * Materializes a section's rows and groups its flat seat list into them.
+ *
+ * `Section.rows` is not a container (§4.2) — seats never live inside a row — but
+ * where it is present it *is* the section's complete row registry (§4.2.2), so
+ * the rows come from it rather than from the seats that happen to reference
+ * one. That is what makes an **empty row** real: a `RowMeta` no seat mentions
+ * still takes a slot, and the grid layout reserves a row of vertical space for
+ * it. Without that, a document could not open the throw between a cinema screen
+ * and row A, because rows would exist only where seats did.
+ *
+ * With no registry, a seat's `row` is opaque free text (§4.6) and the rows are
+ * exactly those the seats name, in first-appearance order — a document that
+ * declares no row metadata still renders in the order its author wrote it.
+ */
+function buildRows(section, layoutMode, ctx) {
+    const byRowKey = new Map();
+    const firstSeen = new Map();
+    (section.seats ?? []).forEach((seat, i) => {
+        const key = seat.row ?? '';
+        if (!byRowKey.has(key)) {
+            byRowKey.set(key, []);
+            firstSeen.set(key, i);
+        }
+        byRowKey.get(key).push(seat);
+    });
+    const registry = section.rows;
+    const ordered = registry
+        ? orderRowMeta(registry).map((meta) => ({ key: meta.id, meta }))
+        : [...byRowKey.keys()]
+            .sort((a, b) => firstSeen.get(a) - firstSeen.get(b))
+            .map((key) => ({ key }));
+    if (registry) {
+        // A seat naming a row the registry does not declare is a §4.6 violation the
+        // validator reports. Render it anyway, after the declared rows — dropping
+        // seats would hide the error rather than show it.
+        const declared = new Set(registry.map((r) => r.id));
+        for (const key of byRowKey.keys()) {
+            if (!declared.has(key)) {
+                ordered.push({ key });
+            }
+        }
+    }
+    return ordered.map(({ key, meta }, rowIndex) => {
+        const seats = byRowKey.get(key) ?? [];
+        const label = meta?.label ?? (key || undefined);
+        const row = {
+            id: key,
+            label,
+            index: rowIndex,
+            seats: sortSeats(seats, layoutMode).map((seat) => buildSeat(seat, section, { rowIndex, rowLabel: label }, ctx)),
+            empty: seats.length === 0,
+        };
+        return row;
+    });
+}
+/**
+ * Orders seats within a row. `col` is the adjacency ordinal in grid and mixed
+ * sections — including mixed, where `x`/`y` places the seat but `col` is what
+ * "the seat to the right" means (§4.3.1). Freeform rows have no columns, so
+ * they order by `x`.
+ */
+function sortSeats(seats, layoutMode) {
+    const byCol = layoutMode !== 'freeform';
+    return [...seats]
+        .map((seat, order) => ({ seat, order }))
+        .sort((a, b) => {
+        const left = byCol ? a.seat.col : a.seat.x;
+        const right = byCol ? b.seat.col : b.seat.x;
+        if (left === undefined || right === undefined || left === right) {
+            return (a.seat.y ?? 0) - (b.seat.y ?? 0) || a.order - b.order;
+        }
+        return left - right;
+    })
+        .map((entry) => entry.seat);
+}
+function buildSeat(seat, section, row, ctx) {
+    const type = ctx.legendById.get(seat.type) ?? { id: seat.type };
+    const price = resolveSeatPrice(seat, ctx.map);
+    if (price?.currency) {
+        ctx.currencies.add(price.currency);
+    }
+    ctx.typeCounts.set(seat.type, (ctx.typeCounts.get(seat.type) ?? 0) + 1);
+    // §5.1: a seat absent from the state document is available.
+    const status = ctx.state?.seats?.[seat.id];
+    const rendered = {
+        id: seat.id,
+        sectionId: section.id,
+        label: seat.label ?? seat.id,
+        row: seat.row,
+        rowLabel: row.rowLabel,
+        rowIndex: row.rowIndex,
+        col: seat.col,
+        x: seat.x,
+        y: seat.y,
+        rotation: seat.rotation,
+        type,
+        typeLabel: resolveLocalizedText(type.label, ctx.locale) ?? type.id,
+        typeColor: type.color,
+        attributes: seat.attributes ?? [],
+        accessibility: seat.accessibility,
+        price,
+        companions: seat.companions ?? [],
+        status: status?.status ?? 'available',
+        holdExpires: status?.holdExpires,
+        selectable: false,
+        source: seat,
+    };
+    rendered.selectable =
+        ctx.selectableStatuses.has(rendered.status) && (ctx.seatSelectable?.(rendered) ?? true);
+    ctx.seatsById.set(rendered.id, rendered);
+    return rendered;
+}
+/**
+ * Carries elements through with their `id` intact — the pre-1.0 adapter dropped
+ * it, leaving the render model with no element identity. A grid-addressed
+ * element gets its row's index so the layout can place it in the cell grid.
+ */
+function buildElements(section, rows) {
+    const rowIndexById = new Map(rows.map((r) => [r.id, r.index]));
+    return (section.elements ?? []).map((element) => ({
+        id: element.id,
+        kind: element.kind,
+        label: element.label,
+        row: element.row,
+        rowIndex: element.row !== undefined ? rowIndexById.get(element.row) : undefined,
+        col: element.col,
+        x: element.x,
+        y: element.y,
+        width: element.width,
+        height: element.height,
+        rotation: element.rotation,
+        source: element,
+    }));
+}
+/** Sections in `Section.index` order, optionally filtered to an explicit set. */
+function selectSections(map, sectionIds) {
+    const all = map.sections ?? [];
+    if (sectionIds) {
+        // An explicit list is also an explicit order — honor it verbatim.
+        return sectionIds
+            .map((id) => all.find((s) => s.id === id))
+            .filter((s) => s !== undefined);
+    }
+    return [...all]
+        .map((section, order) => ({ section, order }))
+        .sort((a, b) => orderKey(a.section.index, a.order) - orderKey(b.section.index, b.order))
+        .map((entry) => entry.section);
+}
+/**
+ * A sort key that keeps entries without an explicit `index` in declaration
+ * order, and after every entry that has one.
+ */
+function orderKey(index, fallbackOrder) {
+    return index ?? Number.MAX_SAFE_INTEGER - 1_000_000 + fallbackOrder;
+}
+//# sourceMappingURL=build-render-model.js.map

package/dist/render/build-render-model.js.map

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

package/dist/render/element-shapes.d.ts

@@ -0,0 +1,34 @@
+/**
+ * How each `Element.kind` is drawn.
+ *
+ * `kind` is open — the spec lists "screen" | "stage" | "exit" | "lavatory" |
+ * "gap" | "aisle" and explicitly allows implementation-defined values (§4.4) —
+ * so this is a lookup with a sensible default, never an exhaustive switch. An
+ * unrecognized kind draws as a labelled rectangle, which is what the pre-1.0
+ * renderer did for every kind including the ones it should have distinguished.
+ */
+export type ElementShape = 
+/** A rounded rectangle. The default. */
+'rect'
+/** A shallow arc bulging toward the audience — a cinema or theatre screen. */
+ | 'screen'
+/** A rectangle with a heavier outline, reading as a raised platform. */
+ | 'stage'
+/** A dashed outline: space that is deliberately empty. */
+ | 'void';
+export interface ElementStyle {
+    shape: ElementShape;
+    /** Which themed color the element takes. */
+    tone: 'neutral' | 'accent' | 'muted';
+    /** Whether the element's label is drawn on it. */
+    showLabel: boolean;
+}
+/** The style for an element kind. Unknown kinds get the labelled rectangle. */
+export declare function elementStyle(kind: string): ElementStyle;
+/**
+ * An SVG path for a screen: a shallow arc across the top of its box, bulging
+ * downward toward the seats. Drawn as a filled sliver rather than a stroke so
+ * it reads at any size.
+ */
+export declare function screenPath(x: number, y: number, width: number, height: number): string;
+//# sourceMappingURL=element-shapes.d.ts.map

package/dist/render/element-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-shapes.d.ts","sourceRoot":"","sources":["../../src/render/element-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY;AACtB,wCAAwC;AACtC,MAAM;AACR,8EAA8E;GAC5E,QAAQ;AACV,wEAAwE;GACtE,OAAO;AACT,0DAA0D;GACxD,MAAM,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;CACpB;AAmBD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQtF"}

package/dist/render/element-shapes.js

@@ -0,0 +1,41 @@
+/**
+ * How each `Element.kind` is drawn.
+ *
+ * `kind` is open — the spec lists "screen" | "stage" | "exit" | "lavatory" |
+ * "gap" | "aisle" and explicitly allows implementation-defined values (§4.4) —
+ * so this is a lookup with a sensible default, never an exhaustive switch. An
+ * unrecognized kind draws as a labelled rectangle, which is what the pre-1.0
+ * renderer did for every kind including the ones it should have distinguished.
+ */
+const DEFAULT_STYLE = { shape: 'rect', tone: 'neutral', showLabel: true };
+const STYLES = {
+    screen: { shape: 'screen', tone: 'neutral', showLabel: true },
+    stage: { shape: 'stage', tone: 'neutral', showLabel: true },
+    pitch: { shape: 'stage', tone: 'muted', showLabel: true },
+    field: { shape: 'stage', tone: 'muted', showLabel: true },
+    exit: { shape: 'rect', tone: 'accent', showLabel: true },
+    door: { shape: 'rect', tone: 'accent', showLabel: true },
+    lavatory: { shape: 'rect', tone: 'muted', showLabel: true },
+    galley: { shape: 'rect', tone: 'muted', showLabel: true },
+    table: { shape: 'rect', tone: 'muted', showLabel: true },
+    aisle: { shape: 'void', tone: 'muted', showLabel: false },
+    gap: { shape: 'void', tone: 'muted', showLabel: true },
+    stairs: { shape: 'void', tone: 'muted', showLabel: true },
+};
+/** The style for an element kind. Unknown kinds get the labelled rectangle. */
+export function elementStyle(kind) {
+    return STYLES[kind?.toLowerCase()] ?? DEFAULT_STYLE;
+}
+/**
+ * An SVG path for a screen: a shallow arc across the top of its box, bulging
+ * downward toward the seats. Drawn as a filled sliver rather than a stroke so
+ * it reads at any size.
+ */
+export function screenPath(x, y, width, height) {
+    const bulge = height * 1.6;
+    return (`M ${x} ${y} ` +
+        `Q ${x + width / 2} ${y + bulge} ${x + width} ${y} ` +
+        `L ${x + width} ${y + height} ` +
+        `Q ${x + width / 2} ${y + height + bulge} ${x} ${y + height} Z`);
+}
+//# sourceMappingURL=element-shapes.js.map

package/dist/render/element-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-shapes.js","sourceRoot":"","sources":["../../src/render/element-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,MAAM,aAAa,GAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAExF,MAAM,MAAM,GAA2C;IACrD,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IAC7D,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IAC3D,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IACzD,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;IACxD,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;IACxD,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IAC3D,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IACzD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE;IACzD,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;IACtD,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;CAC1D,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,aAAa,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,KAAa,EAAE,MAAc;IAC5E,MAAM,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC;IAC3B,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,GAAG;QACd,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG;QACpD,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,GAAG;QAC/B,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAChE,CAAC;AACJ,CAAC"}

package/dist/render/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The pure render model: a `KerusiMap` + `KerusiState` resolved into everything
+ * a renderer needs, and the geometry to place it.
+ *
+ * Nothing here imports a framework — the model can be built in a test, a
+ * build step, or on a server.
+ */
+export * from './render-model.js';
+export * from './build-render-model.js';
+export * from './section-layout.js';
+export * from './navigation-order.js';
+export * from './element-shapes.js';
+export * from './seat-shapes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,14 @@
+/**
+ * The pure render model: a `KerusiMap` + `KerusiState` resolved into everything
+ * a renderer needs, and the geometry to place it.
+ *
+ * Nothing here imports a framework — the model can be built in a test, a
+ * build step, or on a server.
+ */
+export * from './render-model.js';
+export * from './build-render-model.js';
+export * from './section-layout.js';
+export * from './navigation-order.js';
+export * from './element-shapes.js';
+export * from './seat-shapes.js';
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/render/navigation-order.d.ts

@@ -0,0 +1,49 @@
+import { RenderSection } from './render-model.js';
+/**
+ * Keyboard navigation order over a seat map.
+ *
+ * §4.3.1 gives `col` a second job beyond drawing: it is the *logical adjacency
+ * ordinal*, which is exactly what "the seat to my right" must mean for a
+ * keyboard or a screen reader. That holds in `mixed` sections too, where
+ * `x`/`y` places the seat but `col` still orders it — so a stand curving away
+ * from the pitch still reads seat 1, 2, 3.
+ *
+ * Freeform sections have no columns. Where their seats carry a `row` label,
+ * that grouping is used; where they carry nothing, seats are banded by `y` and
+ * ordered by `x`. That last case is a heuristic, and documented as one.
+ */
+/** The seats reachable from a given seat, by id. */
+export interface SeatNeighbours {
+    left?: string;
+    right?: string;
+    up?: string;
+    down?: string;
+    rowStart?: string;
+    rowEnd?: string;
+}
+export interface NavigationGraph {
+    /** Seats in traversal order: row by row, position by position. */
+    order: readonly string[];
+    /** Per-seat neighbours. */
+    neighbours: ReadonlyMap<string, SeatNeighbours>;
+    /** The first seat in the section, or `undefined` when it has none. */
+    first?: string;
+    /** The last seat in the section. */
+    last?: string;
+}
+export interface NavigationOptions {
+    /** Swaps left/right so arrow keys stay visually correct in RTL locales. */
+    rtl?: boolean;
+    /**
+     * Restrict traversal to seats passing this test — e.g. to skip unselectable
+     * seats. Default: every seat is reachable, since a screen-reader user needs
+     * to hear that a seat is booked, not have it hidden.
+     */
+    includes?: (seatId: string) => boolean;
+}
+/**
+ * Builds the navigation graph for one section. Sections are navigated
+ * independently: Tab moves between them, arrows move within.
+ */
+export declare function buildNavigationGraph(section: RenderSection, options?: NavigationOptions): NavigationGraph;
+//# sourceMappingURL=navigation-order.d.ts.map

package/dist/render/navigation-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-order.d.ts","sourceRoot":"","sources":["../../src/render/navigation-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,2BAA2B;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,iBAAsB,GAC9B,eAAe,CAkCjB"}

package/dist/render/navigation-order.js

@@ -0,0 +1,109 @@
+/**
+ * Builds the navigation graph for one section. Sections are navigated
+ * independently: Tab moves between them, arrows move within.
+ */
+export function buildNavigationGraph(section, options = {}) {
+    const bands = section.layoutMode === 'freeform' ? freeformBands(section) : gridBands(section);
+    const included = options.includes;
+    const filtered = bands
+        .map((band) => band.filter((s) => !included || included(s.id)))
+        .filter((band) => band.length > 0);
+    const neighbours = new Map();
+    const order = [];
+    filtered.forEach((band, bandIndex) => {
+        band.forEach((seat, i) => {
+            order.push(seat.id);
+            const prev = band[i - 1]?.id;
+            const next = band[i + 1]?.id;
+            neighbours.set(seat.id, {
+                left: options.rtl ? next : prev,
+                right: options.rtl ? prev : next,
+                up: nearest(filtered[bandIndex - 1], seat),
+                down: nearest(filtered[bandIndex + 1], seat),
+                rowStart: band[0]?.id,
+                rowEnd: band[band.length - 1]?.id,
+            });
+        });
+    });
+    return {
+        order,
+        neighbours,
+        first: order[0],
+        last: order[order.length - 1],
+    };
+}
+/**
+ * Grid and mixed sections: the rows the render model already grouped, with
+ * seats ordered by `col`. `RenderRow.seats` is already in that order.
+ *
+ * Empty rows (§4.2.2) are skipped: they reserve space on the canvas but hold
+ * nothing to move to, and an empty band would strand an arrow press between two
+ * rows of seats.
+ */
+function gridBands(section) {
+    return section.rows
+        .filter((row) => row.seats.length > 0)
+        .map((row) => row.seats.map((seat, i) => ({ id: seat.id, ordinal: seat.col ?? i })));
+}
+/**
+ * Freeform sections: group by the seats' `row` labels when they have them,
+ * since §4.5 permits `row` as a pure label in freeform mode and an author who
+ * supplied one has told us how the seats group.
+ *
+ * With no row labels at all, seats are banded by `y`: sorted top to bottom and
+ * split wherever the vertical step exceeds the median step, which separates
+ * distinct arcs without assuming they are level. This is a heuristic; a
+ * document that wants exact reading order should carry `row` labels.
+ */
+function freeformBands(section) {
+    const toNav = (seats) => [...seats]
+        .sort((a, b) => (a.x ?? 0) - (b.x ?? 0))
+        .map((seat) => ({ id: seat.id, ordinal: seat.x ?? 0 }));
+    const hasRowLabels = section.seats.some((s) => s.row !== undefined && s.row !== '');
+    if (hasRowLabels) {
+        return section.rows.filter((row) => row.seats.length > 0).map((row) => toNav(row.seats));
+    }
+    const sorted = [...section.seats].sort((a, b) => (a.y ?? 0) - (b.y ?? 0));
+    if (sorted.length === 0) {
+        return [];
+    }
+    // Split where the vertical step is far larger than a typical one. "Typical"
+    // is the 25th percentile rather than the median: the between-row jumps are
+    // themselves steps, and in a section with few rows they drag the median up
+    // until no jump looks unusual any more.
+    const steps = sorted.slice(1).map((seat, i) => (seat.y ?? 0) - (sorted[i].y ?? 0));
+    const threshold = Math.max(percentile(steps, 0.25) * 4, 1);
+    const bands = [[sorted[0]]];
+    for (let i = 1; i < sorted.length; i++) {
+        const gap = (sorted[i].y ?? 0) - (sorted[i - 1].y ?? 0);
+        if (gap > threshold) {
+            bands.push([]);
+        }
+        bands[bands.length - 1].push(sorted[i]);
+    }
+    return bands.map(toNav);
+}
+/** The seat in `band` whose ordinal is closest to `from`'s — vertical movement. */
+function nearest(band, from) {
+    if (!band || band.length === 0) {
+        return undefined;
+    }
+    let best = band[0];
+    let bestDistance = Math.abs(best.ordinal - from.ordinal);
+    for (const candidate of band.slice(1)) {
+        const distance = Math.abs(candidate.ordinal - from.ordinal);
+        if (distance < bestDistance) {
+            best = candidate;
+            bestDistance = distance;
+        }
+    }
+    return best.id;
+}
+function percentile(values, fraction) {
+    if (values.length === 0) {
+        return 0;
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    return sorted[Math.min(Math.floor(sorted.length * fraction), sorted.length - 1)];
+}
+//# sourceMappingURL=navigation-order.js.map

package/dist/render/navigation-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-order.js","sourceRoot":"","sources":["../../src/render/navigation-order.ts"],"names":[],"mappings":"AAgDA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsB,EACtB,UAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,MAAM,QAAQ,GAAG,KAAK;SACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SAC9D,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QACnC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACtB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAC/B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAChC,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC;gBAC1C,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC;gBAC5C,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE;aAClC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,UAAU;QACV,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;KAC9B,CAAC;AACJ,CAAC;AASD;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,OAAsB;IACvC,OAAO,OAAO,CAAC,IAAI;SAChB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,OAAsB;IAC3C,MAAM,KAAK,GAAG,CAAC,KAA4B,EAAa,EAAE,CACxD,CAAC,GAAG,KAAK,CAAC;SACP,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IACpF,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,wCAAwC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CACd,IAA2B,EAC3B,IAAmC;IAEnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,IAAI,GAAG,SAAS,CAAC;YACjB,YAAY,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB,EAAE,QAAgB;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}