@escape-game-over/atlas 0.1.87 → 0.1.88

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.87",
+    "version": "0.1.88",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,

package/src/index.ts

@@ -215,14 +215,17 @@ export {
 export {
     type AudiencePrice,
     type AudienceTier,
+    amountAt,
     assertAudiences,
     assertPriceTiers,
     type CurrencyCode,
+    formatPrice,
     formatQuantities,
     type Price,
     type PriceTier,
     type Quantity,
     type QuantityRange,
+    quantitiesOf,
     type TieredPrice,
     tierRange,
 } from "./money.ts";

package/src/money.ts

@@ -480,3 +480,43 @@ export function assertPriceTiers(price: TieredPrice, at: string): void {
         );
     }
 }
+
+/**
+ * What one unit costs at `quantity`: the amount of the band that covers it, or
+ * `undefined` where the table has no band for it — a group too small, too
+ * large, or in a hole between bands.
+ *
+ * The first band that covers it wins. `assertPriceTiers` refuses overlapping
+ * bands, so in a table that passed it there is only ever one.
+ */
+export function amountAt(
+    price: TieredPrice,
+    quantity: number
+): number | undefined {
+    for (const tier of price.tiers) {
+        const band = tierRange(tier);
+        if (quantity >= band.min && quantity <= band.max) {
+            return tier.amountPerUnit;
+        }
+    }
+    return undefined;
+}
+
+/**
+ * A price as a reader in `locale` writes it: the currency's symbol and that
+ * language's separators, and no decimals on a whole amount — "£25", not
+ * "£25.00", while "€12.50" keeps its cents.
+ *
+ * Whole amounts drop the decimals because that is how a price list reads; a
+ * table of "25.00, 22.00, 20.00" says nothing "25, 22, 20" does not. An amount
+ * with cents shows two, so a price is never rounded on the way to the page.
+ */
+export function formatPrice(price: Price, locale: string): string {
+    const whole = Number.isInteger(price.amount);
+    return new Intl.NumberFormat(locale, {
+        style: "currency",
+        currency: price.currency,
+        minimumFractionDigits: whole ? 0 : 2,
+        maximumFractionDigits: whole ? 0 : 2,
+    }).format(price.amount);
+}