@kerusiweb/core

Framework-agnostic core for the Kerusi Seat Map & Availability Format: the document types, a conformance validator, and the render model and geometry a seat-map renderer consumes.

Pure TypeScript. No Angular, no React, no RxJS, no DOM — so it runs in a browser, in a build step, or on a server.

npm install @kerusiweb/core

For a UI on top of it, add the binding for your framework: @kerusiweb/angular or @kerusiweb/react. Both expose the same surface and emit the same SVG.

What's in it

kerusi/ — the format. KerusiMap, KerusiState, KerusiSession, Seat, Section, Money and friends, plus the logic the standard defines over them:

import { validateDocumentSet, errorsOf, resolveSeatPrice, expireHolds } from '@kerusiweb/core';

const violations = validateDocumentSet({ map, state, session });
if (errorsOf(violations).length) throw new Error('non-conformant documents');

render/ — the resolved view and its geometry. buildRenderModel() merges a state onto a map and resolves prices, locale, row order and layout mode into a RenderMap; computeSectionLayout() turns a section into placed seats with coordinates; seatBodyPath() and friends return SVG path d strings.

import { buildRenderModel, computeSectionLayout, seatBodyPath } from '@kerusiweb/core';

const model = buildRenderModel(map, state);
const layout = computeSectionLayout(model.sections[0], { seatSize: 28, seatGap: 6 });
// layout.width / layout.height → the section's intrinsic viewBox
// layout.seats[0] → { seat, x, y, width, height, centerX, centerY, ... }
const { x, y, width, height } = layout.seats[0];
const d = seatBodyPath(x, y, width, height); // → 'M4 8 …', ready for <path d>

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).

Server-side use

Core is "type": "module" and its emitted imports carry explicit extensions, so it loads under plain Node ESM with no bundler:

import { validateDocumentSet } from '@kerusiweb/core';

Contributing

See docs/architecture.md for what belongs here and what belongs in a framework binding.

MIT © Arsyad "Shad Ahm" Ahmad