@kerusiweb/core 2.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2026 Arsyad "Shad Ahm" Ahmad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,68 @@
+# @kerusiweb/core
+
+Framework-agnostic core for the **[Kerusi Seat Map & Availability
+Format](https://github.com/ShadAhm/kerusi)**: 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.
+
+```bash
+npm install @kerusiweb/core
+```
+
+For a UI on top of it, add the binding for your framework:
+[`@kerusiweb/angular`](https://www.npmjs.com/package/@kerusiweb/angular) or
+[`@kerusiweb/react`](https://www.npmjs.com/package/@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:
+
+```ts
+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.
+
+```ts
+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:
+
+```js
+import { validateDocumentSet } from '@kerusiweb/core';
+```
+
+## Contributing
+
+See [docs/architecture.md](../../docs/architecture.md) for what belongs here and
+what belongs in a framework binding.
+
+---
+
+MIT © Arsyad "Shad Ahm" Ahmad

package/dist/kerusi/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Kerusi Seat Map & Availability Format support.
+ *
+ * The document types, a conformance validator, and the price, locale and
+ * layout-mode resolution the renderer is built on. Everything here is pure —
+ * no framework import — so it can be used server-side or in a build step.
+ *
+ * See docs/kerusi.md and the full standard for details.
+ */
+export * from './kerusi-map.model.js';
+export * from './kerusi-state.model.js';
+export * from './kerusi-violation.js';
+export * from './kerusi-layout-mode.js';
+export * from './kerusi-rows.js';
+export * from './kerusi-locale.js';
+export * from './kerusi-price.js';
+export * from './kerusi-validator.js';
+export * from './kerusi-state.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/kerusi/index.js

@@ -0,0 +1,19 @@
+/**
+ * Kerusi Seat Map & Availability Format support.
+ *
+ * The document types, a conformance validator, and the price, locale and
+ * layout-mode resolution the renderer is built on. Everything here is pure —
+ * no framework import — so it can be used server-side or in a build step.
+ *
+ * See docs/kerusi.md and the full standard for details.
+ */
+export * from './kerusi-map.model.js';
+export * from './kerusi-state.model.js';
+export * from './kerusi-violation.js';
+export * from './kerusi-layout-mode.js';
+export * from './kerusi-rows.js';
+export * from './kerusi-locale.js';
+export * from './kerusi-price.js';
+export * from './kerusi-validator.js';
+export * from './kerusi-state.js';
+//# sourceMappingURL=index.js.map

package/dist/kerusi/index.js.map

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

package/dist/kerusi/kerusi-layout-mode.d.ts

@@ -0,0 +1,58 @@
+import { Section } from './kerusi-map.model.js';
+import { KerusiViolation } from './kerusi-violation.js';
+/** The three positioning modes a section may use (§4.5). */
+export type SectionLayoutMode = 'grid' | 'freeform' | 'mixed';
+/**
+ * `Section.layout` is a strict, validated constraint — not a rendering hint.
+ * This module is the single implementation of §4.5, shared by the validator and
+ * the render-model builder so the two can never disagree about what mode a
+ * section is in.
+ *
+ * Per §4.5:
+ *  - `grid`     — every seat MUST have `col`; no seat may have `x` or `y`.
+ *  - `freeform` — every seat MUST have both `x` and `y`; no seat may have `col`.
+ *  - `mixed`    — every seat MUST have `col` AND both `x` and `y`.
+ *
+ * A free-text `row` is permitted in every mode: it carries no positional
+ * information, so it never participates in the constraint.
+ */
+/**
+ * The positional members a seat or element may carry. Elements are positioned
+ * the same way seats are (§4.4), so these predicates take the shape rather than
+ * the full `Seat`.
+ */
+export interface Positioned {
+    col?: number;
+    x?: number;
+    y?: number;
+}
+/** True when the item carries a usable grid column. */
+export declare function hasCol(item: Positioned): boolean;
+/** True when the item carries both freeform coordinates. Neither alone counts. */
+export declare function hasXY(item: Positioned): boolean;
+/** True when the item carries either coordinate — the `grid` prohibition. */
+export declare function hasAnyCoordinate(item: Positioned): boolean;
+/**
+ * Infers a section's mode from its seats when `Section.layout` is omitted
+ * (§4.5). Returns `undefined` when the seats are inconsistent — the caller MUST
+ * reject such a section.
+ *
+ * An empty section infers `grid`: it satisfies "every seat has `col`" vacuously
+ * and grid is the cheaper mode to render.
+ */
+export declare function inferSectionLayoutMode(section: Section): SectionLayoutMode | undefined;
+/**
+ * The mode a section renders in: its declared `layout`, or the inferred one.
+ * Falls back to `grid` for an inconsistent section so a renderer can still draw
+ * *something* after the validator has reported the fault. Callers that must not
+ * render an invalid document should check {@link checkSectionLayout} first.
+ */
+export declare function resolveSectionLayoutMode(section: Section): SectionLayoutMode;
+/**
+ * Validates a section against §4.5. Returns every violation found, in seat
+ * declaration order; an empty array means the section conforms.
+ *
+ * @param path Document path prefix for the violations, e.g. `sections[1]`.
+ */
+export declare function checkSectionLayout(section: Section, path?: string): KerusiViolation[];
+//# sourceMappingURL=kerusi-layout-mode.d.ts.map

package/dist/kerusi/kerusi-layout-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kerusi-layout-mode.d.ts","sourceRoot":"","sources":["../../src/kerusi/kerusi-layout-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAS,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/D,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEhD;AAED,kFAAkF;AAClF,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE/C;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CActF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CA4FrF"}

package/dist/kerusi/kerusi-layout-mode.js

@@ -0,0 +1,117 @@
+import { error } from './kerusi-violation.js';
+/** True when the item carries a usable grid column. */
+export function hasCol(item) {
+    return item.col !== undefined && item.col !== null;
+}
+/** True when the item carries both freeform coordinates. Neither alone counts. */
+export function hasXY(item) {
+    return item.x !== undefined && item.x !== null && item.y !== undefined && item.y !== null;
+}
+/** True when the item carries either coordinate — the `grid` prohibition. */
+export function hasAnyCoordinate(item) {
+    return (item.x !== undefined && item.x !== null) || (item.y !== undefined && item.y !== null);
+}
+/**
+ * Infers a section's mode from its seats when `Section.layout` is omitted
+ * (§4.5). Returns `undefined` when the seats are inconsistent — the caller MUST
+ * reject such a section.
+ *
+ * An empty section infers `grid`: it satisfies "every seat has `col`" vacuously
+ * and grid is the cheaper mode to render.
+ */
+export function inferSectionLayoutMode(section) {
+    const seats = section.seats ?? [];
+    if (seats.length === 0) {
+        return 'grid';
+    }
+    if (seats.every((s) => hasCol(s) && !hasAnyCoordinate(s))) {
+        return 'grid';
+    }
+    if (seats.every((s) => hasXY(s) && !hasCol(s))) {
+        return 'freeform';
+    }
+    // The spec defines no inference for `mixed`; declaring it is required. Every
+    // other shape is inconsistent.
+    return undefined;
+}
+/**
+ * The mode a section renders in: its declared `layout`, or the inferred one.
+ * Falls back to `grid` for an inconsistent section so a renderer can still draw
+ * *something* after the validator has reported the fault. Callers that must not
+ * render an invalid document should check {@link checkSectionLayout} first.
+ */
+export function resolveSectionLayoutMode(section) {
+    return section.layout ?? inferSectionLayoutMode(section) ?? 'grid';
+}
+/**
+ * Validates a section against §4.5. Returns every violation found, in seat
+ * declaration order; an empty array means the section conforms.
+ *
+ * @param path Document path prefix for the violations, e.g. `sections[1]`.
+ */
+export function checkSectionLayout(section, path) {
+    const seats = section.seats ?? [];
+    if (section.layout === undefined) {
+        if (inferSectionLayoutMode(section) === undefined) {
+            const offender = firstInconsistentSeat(seats);
+            return [
+                error('section-layout-inconsistent', `Section "${section.id}" omits "layout" and its seats mix positioning ` +
+                    `methods, so no mode can be inferred: seat "${offender?.id}" does not ` +
+                    'match the section\'s prevailing method. Declare "layout" explicitly, ' +
+                    'or make every seat use the same method (§4.5).', { id: section.id, path }),
+            ];
+        }
+        // An inferred mode is, by construction, satisfied by every seat.
+        return [];
+    }
+    const violations = [];
+    seats.forEach((seat, i) => {
+        const seatPath = path ? `${path}.seats[${i}]` : undefined;
+        switch (section.layout) {
+            case 'grid':
+                if (!hasCol(seat)) {
+                    violations.push(error('section-layout-grid', `Seat "${seat.id}" is in grid section "${section.id}" but has no ` +
+                        '"col". Every seat in a grid section must declare "col" ' +
+                        'explicitly; it is never inferred from array order (§4.5).', { id: seat.id, path: seatPath }));
+                }
+                if (hasAnyCoordinate(seat)) {
+                    violations.push(error('section-layout-grid', `Seat "${seat.id}" is in grid section "${section.id}" but carries ` +
+                        '"x"/"y". No seat in a grid section may have freeform ' +
+                        'coordinates; use layout "mixed" to combine both (§4.5).', { id: seat.id, path: seatPath }));
+                }
+                break;
+            case 'freeform':
+                if (!hasXY(seat)) {
+                    violations.push(error('section-layout-freeform', `Seat "${seat.id}" is in freeform section "${section.id}" but is ` +
+                        'missing "x" or "y". Every seat in a freeform section must have ' +
+                        'both (§4.5).', { id: seat.id, path: seatPath }));
+                }
+                if (hasCol(seat)) {
+                    violations.push(error('section-layout-freeform', `Seat "${seat.id}" is in freeform section "${section.id}" but ` +
+                        'carries "col". No seat in a freeform section may have a grid ' +
+                        'column; use layout "mixed" to combine both (§4.5).', { id: seat.id, path: seatPath }));
+                }
+                break;
+            case 'mixed':
+                if (!hasCol(seat) || !hasXY(seat)) {
+                    violations.push(error('section-layout-mixed', `Seat "${seat.id}" is in mixed section "${section.id}" but does not ` +
+                        'have all of "col", "x" and "y". A mixed section requires every ' +
+                        'seat to carry both addressing methods (§4.5).', { id: seat.id, path: seatPath }));
+                }
+                break;
+        }
+    });
+    return violations;
+}
+/**
+ * The first seat that breaks the section's prevailing positioning method, used
+ * to make an "inconsistent" message point at something concrete.
+ */
+function firstInconsistentSeat(seats) {
+    const gridLike = seats.filter((s) => hasCol(s) && !hasAnyCoordinate(s)).length;
+    const freeformLike = seats.filter((s) => hasXY(s) && !hasCol(s)).length;
+    return gridLike >= freeformLike
+        ? seats.find((s) => !(hasCol(s) && !hasAnyCoordinate(s)))
+        : seats.find((s) => !(hasXY(s) && !hasCol(s)));
+}
+//# sourceMappingURL=kerusi-layout-mode.js.map

package/dist/kerusi/kerusi-layout-mode.js.map

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

package/dist/kerusi/kerusi-locale.d.ts

@@ -0,0 +1,43 @@
+import { KerusiMap, LocalizedText, Money } from './kerusi-map.model.js';
+/**
+ * Label and money resolution for Kerusi documents.
+ *
+ * The standard lets `Section.label` and `SeatType.label` be either a plain
+ * string or a BCP-47 locale map (§4.1, §4.7), and states amounts in minor units
+ * (§4.8). Both need resolving before anything can be rendered or announced.
+ */
+/** The default when a map declares no `locale` (§4). */
+export declare const DEFAULT_LOCALE = "en";
+/** The locale a map renders in: an explicit override, else the map's, else "en". */
+export declare function resolveMapLocale(map: KerusiMap | undefined, override?: string): string;
+/**
+ * Resolves a `string | Record<string, string>` label for the given locale.
+ *
+ * A plain string is returned as-is. A locale map is matched, in order, against:
+ * the exact tag, progressively shorter prefixes of it (`ms-MY` → `ms`), the
+ * fallback locale and its prefixes, and finally the first key in insertion
+ * order — so a map that localizes into languages the caller didn't ask for
+ * still renders something rather than nothing. Tag matching is
+ * case-insensitive.
+ *
+ * Returns `undefined` for an absent or empty label, so callers can fall back to
+ * an id.
+ */
+export declare function resolveLocalizedText(value: LocalizedText | undefined, locale: string, fallbackLocale?: string): string | undefined;
+/**
+ * The number of minor-unit digits for an ISO 4217 code — 2 for MYR/USD, 0 for
+ * JPY, 3 for KWD/BHD. Read from `Intl` rather than hardcoded, because
+ * `Money.amount` is in minor units and dividing everything by 100 renders JPY
+ * 100× too small and KWD 10× too large (§4.8).
+ */
+export declare function minorUnitDigits(currency: string): number;
+/** A `Money` as a major-unit number, e.g. `{ amount: 4500, currency: 'MYR' }` → `45`. */
+export declare function toMajorUnits(money: Money): number;
+/**
+ * Formats a `Money` for display, e.g. `RM 45.00`, `¥1,200`, `KD 12.500`.
+ * Falls back to `"<amount> <currency>"` when the runtime rejects the code.
+ */
+export declare function formatMoney(money: Money | undefined, locale?: string): string;
+/** Sums money of one currency. Returns `undefined` for an empty list. */
+export declare function sumMoney(amounts: readonly Money[]): Money | undefined;
+//# sourceMappingURL=kerusi-locale.d.ts.map

package/dist/kerusi/kerusi-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kerusi-locale.d.ts","sourceRoot":"","sources":["../../src/kerusi/kerusi-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;GAMG;AAEH,wDAAwD;AACxD,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAuB,GACtC,MAAM,GAAG,SAAS,CAyBpB;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,MAAM,GAAE,MAAuB,GAAG,MAAM,CAa7F;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,GAAG,SAAS,CAQrE"}

package/dist/kerusi/kerusi-locale.js

@@ -0,0 +1,111 @@
+/**
+ * Label and money resolution for Kerusi documents.
+ *
+ * The standard lets `Section.label` and `SeatType.label` be either a plain
+ * string or a BCP-47 locale map (§4.1, §4.7), and states amounts in minor units
+ * (§4.8). Both need resolving before anything can be rendered or announced.
+ */
+/** The default when a map declares no `locale` (§4). */
+export const DEFAULT_LOCALE = 'en';
+/** The locale a map renders in: an explicit override, else the map's, else "en". */
+export function resolveMapLocale(map, override) {
+    return override ?? map?.locale ?? DEFAULT_LOCALE;
+}
+/**
+ * Resolves a `string | Record<string, string>` label for the given locale.
+ *
+ * A plain string is returned as-is. A locale map is matched, in order, against:
+ * the exact tag, progressively shorter prefixes of it (`ms-MY` → `ms`), the
+ * fallback locale and its prefixes, and finally the first key in insertion
+ * order — so a map that localizes into languages the caller didn't ask for
+ * still renders something rather than nothing. Tag matching is
+ * case-insensitive.
+ *
+ * Returns `undefined` for an absent or empty label, so callers can fall back to
+ * an id.
+ */
+export function resolveLocalizedText(value, locale, fallbackLocale = DEFAULT_LOCALE) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    const byLowerKey = new Map();
+    for (const [key, text] of Object.entries(value)) {
+        // First key wins, so insertion order decides between "en" and "EN".
+        if (!byLowerKey.has(key.toLowerCase())) {
+            byLowerKey.set(key.toLowerCase(), text);
+        }
+    }
+    for (const candidate of [...tagChain(locale), ...tagChain(fallbackLocale)]) {
+        const hit = byLowerKey.get(candidate);
+        if (hit !== undefined) {
+            return hit;
+        }
+    }
+    const first = Object.values(value)[0];
+    return first ?? undefined;
+}
+/**
+ * A BCP-47 tag and its progressively shorter prefixes, lowercased:
+ * `"zh-Hant-TW"` → `["zh-hant-tw", "zh-hant", "zh"]`.
+ */
+function tagChain(tag) {
+    const parts = tag.toLowerCase().split('-').filter(Boolean);
+    const chain = [];
+    for (let i = parts.length; i > 0; i--) {
+        chain.push(parts.slice(0, i).join('-'));
+    }
+    return chain;
+}
+/**
+ * The number of minor-unit digits for an ISO 4217 code — 2 for MYR/USD, 0 for
+ * JPY, 3 for KWD/BHD. Read from `Intl` rather than hardcoded, because
+ * `Money.amount` is in minor units and dividing everything by 100 renders JPY
+ * 100× too small and KWD 10× too large (§4.8).
+ */
+export function minorUnitDigits(currency) {
+    try {
+        return (new Intl.NumberFormat('en', { style: 'currency', currency }).resolvedOptions()
+            .maximumFractionDigits ?? 2);
+    }
+    catch {
+        // An unknown or malformed code: assume the common case rather than throw.
+        return 2;
+    }
+}
+/** A `Money` as a major-unit number, e.g. `{ amount: 4500, currency: 'MYR' }` → `45`. */
+export function toMajorUnits(money) {
+    return money.amount / 10 ** minorUnitDigits(money.currency);
+}
+/**
+ * Formats a `Money` for display, e.g. `RM 45.00`, `¥1,200`, `KD 12.500`.
+ * Falls back to `"<amount> <currency>"` when the runtime rejects the code.
+ */
+export function formatMoney(money, locale = DEFAULT_LOCALE) {
+    if (!money) {
+        return '';
+    }
+    const major = toMajorUnits(money);
+    try {
+        return new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency: money.currency,
+        }).format(major);
+    }
+    catch {
+        return `${major} ${money.currency}`;
+    }
+}
+/** Sums money of one currency. Returns `undefined` for an empty list. */
+export function sumMoney(amounts) {
+    if (amounts.length === 0) {
+        return undefined;
+    }
+    return {
+        amount: amounts.reduce((sum, m) => sum + m.amount, 0),
+        currency: amounts[0].currency,
+    };
+}
+//# sourceMappingURL=kerusi-locale.js.map

package/dist/kerusi/kerusi-locale.js.map

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