@johnhenry/graceholder 0.0.0-stage → 0.1.0

package/src/packs/commerce.js

@@ -0,0 +1,83 @@
+// Commerce pack: products, categories and brands that agree with each other. One persona slot
+// ("category") picks a category; the product noun, the SKU prefix and the price band all come from
+// it, so "Trail Running Shoes" is in Footwear at a footwear price. Brands are invented; any
+// resemblance to a real trademark is coincidental. FROZEN at 1.0.0.
+
+const freeze = (o) => {
+  if (o !== null && typeof o === "object") for (const v of Object.values(o)) freeze(v);
+  return Object.freeze(o);
+};
+
+// [category, SKU prefix, min price, max price, nouns]
+const commerceCategories = [
+  ["Home & Kitchen", "HOM", 6, 180, ["Kettle", "Cutting Board", "Casserole Dish", "Tea Towel Set", "Storage Jar", "Mixing Bowl", "Table Lamp", "Throw Blanket"]],
+  ["Outdoors", "OUT", 15, 320, ["Daypack", "Camp Stove", "Sleeping Bag", "Headlamp", "Trekking Poles", "Water Bottle", "Hammock", "Rain Shell"]],
+  ["Electronics", "ELE", 12, 650, ["Bluetooth Speaker", "Desk Fan", "Power Bank", "Webcam", "Mechanical Keyboard", "Wireless Mouse", "Phone Stand", "USB Hub"]],
+  ["Apparel", "APP", 10, 140, ["Cotton T-Shirt", "Wool Sweater", "Canvas Jacket", "Denim Shorts", "Linen Shirt", "Knit Scarf", "Fleece Vest", "Rain Poncho"]],
+  ["Footwear", "FTW", 25, 220, ["Trail Running Shoes", "Leather Boots", "Canvas Sneakers", "Slip-On Loafers", "Hiking Sandals", "Wool Slippers", "Rain Boots", "Court Shoes"]],
+  ["Toys & Games", "TOY", 5, 90, ["Wooden Puzzle", "Card Game", "Building Blocks", "Board Game", "Kite", "Plush Bear", "Marble Run", "Dice Set"]],
+  ["Books & Stationery", "BKS", 3, 45, ["Hardcover Notebook", "Fountain Pen", "Sketchbook", "Desk Calendar", "Sticky Notes", "Pencil Set", "Atlas", "Cookbook"]],
+  ["Beauty & Personal Care", "BEA", 4, 85, ["Hand Cream", "Bath Salts", "Shaving Brush", "Lip Balm", "Face Mask", "Hair Brush", "Body Lotion", "Soap Bar"]],
+  ["Pet Supplies", "PET", 4, 110, ["Dog Leash", "Cat Tree", "Chew Toy", "Pet Bowl", "Travel Carrier", "Grooming Brush", "Bird Feeder", "Fish Tank Filter"]],
+  ["Garden", "GAR", 5, 260, ["Watering Can", "Pruning Shears", "Raised Planter", "Seed Starter Kit", "Garden Gloves", "Compost Bin", "Trellis", "Hose Reel"]],
+  ["Sports & Fitness", "SPT", 8, 300, ["Yoga Mat", "Resistance Bands", "Jump Rope", "Foam Roller", "Dumbbell Pair", "Tennis Racket", "Water Flask", "Gym Bag"]],
+  ["Office", "OFF", 6, 420, ["Standing Desk", "Desk Organizer", "Monitor Arm", "Task Chair", "Label Maker", "Paper Shredder", "Whiteboard", "Cable Tray"]],
+];
+
+const commerceBrands = [
+  "Quillon", "Brambleton", "Tidewell", "Ferngrove", "Oakhaven", "Kestrelle", "Marrowby", "Lumenfield", "Harrowgate", "Pennywick",
+  "Alderbrook", "Stonecroft", "Wrenfield", "Cinderlane", "Moorhaven", "Fallowmere", "Birchwell", "Thistledown", "Larkspur & Vale", "Copperfield Co",
+  "Northmere", "Ashgrove", "Tamsin & Rowe", "Halcyon Street", "Briarwood Supply", "Gullwing", "Saltmarsh", "Redfern Goods", "Ember & Oak", "Kingfisher Row",
+  "Windermoor", "Hollowell", "Sparrowhill", "Cloverdale Works", "Ironbridge Trading", "Maplecrest", "Dunmore & Finch", "Rushlight", "Elmstead", "Foxtail Provisions",
+];
+
+const commerceAdjectives = [
+  "Classic", "Everyday", "Compact", "Heritage", "Travel", "Studio", "Field", "Weekend", "Signature", "Essential",
+  "Artisan", "Lightweight", "Heavy-Duty", "Pocket", "Family-Size", "Limited", "Natural", "Recycled", "Foldable", "Insulated",
+];
+
+const ENDING = [[0, 3], [1, 4], [2, 2], [3, 3]];
+
+export const commerce = freeze({
+  name: "commerce",
+  version: 1,
+  vocab: { commerceCategories, commerceBrands, commerceAdjectives },
+  types: { "commerce.price": "Float" },
+  rules({ tokens, first, last, kind }) {
+    if (last === "category" || last === "department") return { sdl: "String", gen: "commerce.category" };
+    if (last === "brand" || last === "manufacturer") return { sdl: "String", gen: "commerce.brand" };
+    if (last === "sku") return { sdl: "String", gen: "commerce.sku" };
+    if (last === "price" && tokens.length === 1) return { sdl: "Float", gen: "commerce.price" };
+    if (kind === "product" && (last === "name" || last === "title") && tokens.length === 1) return { sdl: "String", gen: "commerce.product" };
+    if (tokens.join(" ") === "product name") return { sdl: "String", gen: "commerce.product" };
+    return null;
+  },
+  generators(V) {
+    const rows = V.commerceCategories.map(([name, sku, min, max, nouns]) => ({ name, sku, min, max, nouns }));
+    const row = (ctx) => ctx.slot("category").pick(rows);
+    return {
+      "commerce.category": (ctx) => row(ctx).name,
+      "commerce.brand": (ctx) => ctx.slot("brand").pick(V.commerceBrands),
+      "commerce.product": (ctx) => {
+        const r = row(ctx);
+        return `${ctx.slot("brand").pick(V.commerceBrands)} ${ctx.slot("adj").pick(V.commerceAdjectives)} ${ctx.slot("noun").pick(r.nouns)}`;
+      },
+      "commerce.sku": (ctx) => {
+        const s = ctx.slot("skuNum");
+        return `${row(ctx).sku}-${String(s.int(0, 99999)).padStart(5, "0")}`;
+      },
+      // whole cents inside the category's price band, with the same weighted endings as `money`
+      "commerce.price": ({ stream: s, args, slot }) => {
+        const r = slot("category").pick(rows);
+        const min = args.min ?? r.min;
+        const max = args.max ?? r.max;
+        const dollars = s.int(Math.ceil(min), Math.floor(max));
+        const e = s.weighted(ENDING);
+        const cents = e === 0 ? 0 : e === 1 ? 99 : e === 2 ? 49 : s.int(0, 99);
+        return Math.min(max * 100, Math.max(min * 100, dollars * 100 + cents)) / 100;
+      },
+    };
+  },
+});
+
+export default commerce;

package/src/packs/finance.d.ts

@@ -0,0 +1,4 @@
+import type { Pack } from "../index.js";
+/** The finance pack. Import from "@johnhenry/graceholder/packs/finance". */
+export declare const finance: Pack;
+export default finance;

package/src/packs/finance.js

@@ -0,0 +1,180 @@
+// Finance pack: account and transaction vocabulary, currencies, and identifiers whose check
+// digits are valid: IBAN (ISO 13616 mod-97), payment card numbers (Luhn) and US ABA routing
+// numbers (3-7-1 weights). The digits themselves are random: the IBAN's national bank code and
+// national check part are NOT validated by the country's own scheme (FR RIB key, IT CIN, ES DC), and a
+// card or account number may coincide with a real one by chance. Never use these to test payments
+// against real systems. FROZEN at 1.0.0.
+
+const freeze = (o) => {
+  if (o !== null && typeof o === "object") for (const v of Object.values(o)) freeze(v);
+  return Object.freeze(o);
+};
+
+// [code, name, symbol, minor units]
+const financeCurrencies = [
+  ["USD", "US Dollar", "$", 2], ["EUR", "Euro", "€", 2], ["GBP", "Pound Sterling", "£", 2], ["CHF", "Swiss Franc", "CHF", 2],
+  ["SEK", "Swedish Krona", "kr", 2], ["NOK", "Norwegian Krone", "kr", 2], ["PLN", "Polish Zloty", "zł", 2], ["JPY", "Japanese Yen", "¥", 0],
+  ["CAD", "Canadian Dollar", "$", 2], ["AUD", "Australian Dollar", "$", 2], ["NZD", "New Zealand Dollar", "$", 2], ["BRL", "Brazilian Real", "R$", 2],
+  ["MXN", "Mexican Peso", "$", 2], ["INR", "Indian Rupee", "\u20b9", 2], ["NGN", "Nigerian Naira", "\u20a6", 2], ["ZAR", "South African Rand", "R", 2],
+];
+
+// currency by country code, for the countries of the geo pack (used when the geo pack is also enabled)
+const financeCountryCurrency = [
+  ["US", "USD"], ["CA", "CAD"], ["GB", "GBP"], ["DE", "EUR"], ["FR", "EUR"], ["ES", "EUR"], ["IT", "EUR"], ["NL", "EUR"], ["SE", "SEK"],
+  ["CH", "CHF"], ["AU", "AUD"], ["NZ", "NZD"], ["JP", "JPY"], ["BR", "BRL"], ["MX", "MXN"], ["IN", "INR"], ["NG", "NGN"], ["ZA", "ZAR"],
+];
+
+// IBAN countries: [country code, currency, BBAN layout]; layout "8n,10n" = 8 digits then 10 digits,
+// "4a" = 4 letters, "11c" = 11 letters or digits. Lengths follow ISO 13616 / the SWIFT registry.
+const financeIbanCountries = [
+  ["DE", "EUR", "8n,10n"], ["GB", "GBP", "4a,6n,8n"], ["FR", "EUR", "5n,5n,11c,2n"], ["ES", "EUR", "4n,4n,2n,10n"],
+  ["IT", "EUR", "1a,5n,5n,12c"], ["NL", "EUR", "4a,10n"], ["BE", "EUR", "3n,7n,2n"], ["CH", "CHF", "5n,12c"],
+  ["SE", "SEK", "20n"], ["AT", "EUR", "5n,11n"], ["IE", "EUR", "4a,6n,8n"], ["PL", "PLN", "8n,16n"],
+  ["PT", "EUR", "4n,4n,11n,2n"], ["NO", "NOK", "4n,6n,1n"],
+];
+
+const financeAccountTypes = ["Checking", "Savings", "Money Market", "Credit Card", "Line of Credit", "Certificate of Deposit", "Business Checking", "Joint Account"];
+
+// [transaction type, direction] where direction is -1 for money out and 1 for money in
+const financeTransactionTypes = [
+  ["Card Purchase", -1], ["ATM Withdrawal", -1], ["Direct Deposit", 1], ["Wire Transfer", -1], ["Wire Transfer Received", 1], ["Standing Order", -1],
+  ["Direct Debit", -1], ["Refund", 1], ["Interest Payment", 1], ["Account Fee", -1], ["Cheque Deposit", 1], ["Peer Transfer", -1],
+];
+
+const financeMerchants = [
+  "Marlow Grocers", "Pinecrest Fuel", "Lanternside Cafe", "Harborline Transit", "Westgate Pharmacy", "Brightwater Utilities", "Corner Bakehouse",
+  "Summit Hardware", "Riverbend Books", "Oakmont Cinema", "Greenleaf Market", "Foxglove Florist", "Ironclad Gym", "Seabright Laundry",
+  "Millstone Pizza", "Lakeview Parking", "Tallow & Wick", "Dovetail Furniture", "Crescent Cleaners", "Pennant Sports",
+  "Meadowbank Dental", "Larder & Lime", "Kestrel Telecom", "Bluepine Insurance", "Anchor Hardware", "Birchline Optics",
+  "Copperkettle Diner", "Sundial Travel", "Halfmoon Records", "Wickerwood Gifts",
+];
+
+const LOWER = "abcdefghijklmnopqrstuvwxyz";
+const UPPER = LOWER.toUpperCase();
+const ALNUM = UPPER + "0123456789";
+
+/** Random characters for a layout like "5n,5n,11c,2n". */
+function bban(layout, s) {
+  let out = "";
+  for (const part of layout.split(",")) {
+    const n = Number.parseInt(part, 10);
+    const kind = part[part.length - 1];
+    for (let i = 0; i < n; i++) out += kind === "n" ? s.int(0, 9) : kind === "a" ? UPPER[s.int(0, 25)] : ALNUM[s.int(0, ALNUM.length - 1)];
+  }
+  return out;
+}
+
+/** ISO 7064 mod 97-10 over a string of digits and letters (A=10 ... Z=35), without big integers. */
+export function mod97(text) {
+  let rem = 0;
+  for (const ch of text) {
+    const v = ch >= "0" && ch <= "9" ? ch.charCodeAt(0) - 48 : ch.charCodeAt(0) - 55;
+    rem = (v > 9 ? rem * 100 + v : rem * 10 + v) % 97;
+  }
+  return rem;
+}
+
+/** A structurally valid IBAN: country, two check digits so that mod97(rearranged) is 1, then the BBAN. */
+export function makeIban(country, body) {
+  const check = 98 - mod97(`${body}${country}00`);
+  return `${country}${String(check).padStart(2, "0")}${body}`;
+}
+
+/** Luhn check digit for a string of digits. */
+export function luhnDigit(partial) {
+  let sum = 0;
+  for (let i = partial.length - 1, double = true; i >= 0; i--, double = !double) {
+    let d = partial.charCodeAt(i) - 48;
+    if (double) {
+      d *= 2;
+      if (d > 9) d -= 9;
+    }
+    sum += d;
+  }
+  return (10 - (sum % 10)) % 10;
+}
+
+// [network, prefixes, length]
+const CARDS = [["visa", ["4"], 16], ["mastercard", ["51", "52", "53", "54", "55"], 16], ["amex", ["34", "37"], 15]];
+
+export const finance = freeze({
+  name: "finance",
+  version: 1,
+  vocab: { financeCountryCurrency, financeCurrencies, financeIbanCountries, financeAccountTypes, financeTransactionTypes, financeMerchants },
+  rules({ tokens, last }) {
+    const key = tokens.join(" ");
+    if (last === "iban") return { sdl: "String", gen: "finance.iban" };
+    if (last === "bic" || last === "swift") return { sdl: "String", gen: "finance.bic" };
+    if (key === "card number" || key === "credit card" || key === "credit card number" || key === "cc number" || key === "pan") return { sdl: "String", gen: "finance.cardNumber" };
+    if (key === "routing number" || key === "aba" || key === "routing") return { sdl: "String", gen: "finance.routingNumber" };
+    if (key === "account number" || key === "account no") return { sdl: "String", gen: "finance.accountNumber" };
+    if (key === "account type") return { sdl: "String", gen: "finance.accountType" };
+    if (key === "transaction type" || key === "txn type") return { sdl: "String", gen: "finance.transactionType" };
+    if (last === "merchant" || key === "merchant name" || key === "payee") return { sdl: "String", gen: "finance.merchant" };
+    if (key === "currency" || key === "currency code") return { sdl: "String", gen: "finance.currency" };
+    if (key === "currency name") return { sdl: "String", gen: "finance.currencyName" };
+    if (key === "currency symbol") return { sdl: "String", gen: "finance.currencySymbol" };
+    return null;
+  },
+  generators(V, base) {
+    const ccy = new Map(V.financeCurrencies.map((c) => [c[0], c]));
+    const byCountry = new Map(V.financeCountryCurrency);
+    // With the geo pack enabled, the entity's country is its place's country (a persona slot shared
+    // with every place field), so its IBAN country and currency agree with its address. Otherwise one
+    // "fcountry" slot per entity keeps the IBAN country and the currency consistent with each other.
+    const geoCountry = (ctx) => base["geo.countryCode"]?.(ctx);
+    const home = (ctx) => {
+      const cc = geoCountry(ctx);
+      return (cc && V.financeIbanCountries.find((r) => r[0] === cc)) || ctx.slot("fcountry").pick(V.financeIbanCountries);
+    };
+    const currencyCode = (ctx) => {
+      const cc = geoCountry(ctx);
+      return (cc && byCountry.get(cc)) || home(ctx)[1];
+    };
+    return {
+      "finance.iban": (ctx) => {
+        const [cc, , layout] = home(ctx);
+        return makeIban(cc, bban(layout, ctx.slot("ibanDigits")));
+      },
+      "finance.bic": (ctx) => {
+        const s = ctx.slot("bic");
+        const [cc] = home(ctx);
+        let bank = "";
+        for (let i = 0; i < 4; i++) bank += UPPER[s.int(0, 25)];
+        return `${bank}${cc}${ALNUM[s.int(0, 35)]}${ALNUM[s.int(0, 35)]}`;
+      },
+      "finance.cardNumber": (ctx) => {
+        const s = ctx.slot("card");
+        const [, prefixes, len] = s.pick(CARDS);
+        let digits = s.pick(prefixes);
+        while (digits.length < len - 1) digits += s.int(0, 9);
+        return digits + luhnDigit(digits);
+      },
+      "finance.routingNumber": (ctx) => {
+        const s = ctx.slot("routing");
+        // first two digits: Federal Reserve routing symbols 01-12 (the range of ordinary banks)
+        let d = String(s.int(1, 12)).padStart(2, "0");
+        while (d.length < 8) d += s.int(0, 9);
+        const w = [3, 7, 1, 3, 7, 1, 3, 7];
+        let sum = 0;
+        for (let i = 0; i < 8; i++) sum += (d.charCodeAt(i) - 48) * w[i];
+        return d + ((10 - (sum % 10)) % 10);
+      },
+      "finance.accountNumber": (ctx) => {
+        const s = ctx.slot("acct");
+        let out = "";
+        const n = s.int(8, 12);
+        for (let i = 0; i < n; i++) out += s.int(0, 9);
+        return out;
+      },
+      "finance.accountType": (ctx) => ctx.slot("accountType").pick(V.financeAccountTypes),
+      "finance.transactionType": (ctx) => ctx.slot("txnType").pick(V.financeTransactionTypes)[0],
+      "finance.merchant": (ctx) => ctx.slot("merchant").pick(V.financeMerchants),
+      "finance.currency": (ctx) => currencyCode(ctx),
+      "finance.currencyName": (ctx) => ccy.get(currencyCode(ctx))[1],
+      "finance.currencySymbol": (ctx) => ccy.get(currencyCode(ctx))[2],
+    };
+  },
+});
+
+export default finance;

package/src/packs/geo.d.ts

@@ -0,0 +1,4 @@
+import type { Pack } from "../index.js";
+/** The geo pack. Import from "@johnhenry/graceholder/packs/geo". */
+export declare const geo: Pack;
+export default geo;

package/src/packs/geo.js

@@ -0,0 +1,227 @@
+// Geo pack: coherent place data. One persona slot ("place") selects a real city; the city's
+// region, country, coordinates, time zone, postal prefix and area code all come from that row, so
+// every field of an entity agrees. Hand-entered facts (see src/packs/PROVENANCE.md). FROZEN at 1.0.0.
+//
+// Coordinates are approximate city centres (about 0.01 degree); they are placeholders, not for navigation.
+// Phone numbers use the right country code and shape. Reserved fictional ranges are used for the
+// US and Canada (555-01xx), the United Kingdom (Ofcom drama ranges) and Australia (5550 xxxx); for
+// every other country the numbers are well-formed but NOT guaranteed to be unassigned.
+
+const freeze = (o) => {
+  if (o !== null && typeof o === "object") for (const v of Object.values(o)) freeze(v);
+  return Object.freeze(o);
+};
+
+// [code, name, calling code, postal suffix pattern, phone template ({ac} = the city's area code), address style]
+// postal = the city's prefix + the suffix pattern ("#" digit, "A" letter, anything else literal).
+// address style "us": street, city, REGION postal. "eu": street, postal city.
+const geoCountries = [
+  ["US", "United States", "1", "##", "+1 {ac}-555-01##", "us"],
+  ["CA", "Canada", "1", " #A#", "+1 {ac}-555-01##", "us"],
+  ["GB", "United Kingdom", "44", " #AA", "+44 20 7946 0###", "eu"],
+  ["DE", "Germany", "49", "###", "+49 {ac} ######", "eu"],
+  ["FR", "France", "33", "##", "+33 {ac} ## ## ## ##", "eu"],
+  ["ES", "Spain", "34", "###", "+34 {ac}# ### ###", "eu"],
+  ["IT", "Italy", "39", "###", "+39 {ac} ### ####", "eu"],
+  ["NL", "Netherlands", "31", "## AA", "+31 {ac} ### ####", "eu"],
+  ["SE", "Sweden", "46", "# ##", "+46 {ac} ### ## ##", "eu"],
+  ["CH", "Switzerland", "41", "##", "+41 {ac} ### ## ##", "eu"],
+  ["AU", "Australia", "61", "##", "+61 {ac} 5550 ####", "us"],
+  ["NZ", "New Zealand", "64", "##", "+64 {ac} ### ####", "us"],
+  ["JP", "Japan", "81", "-####", "+81 {ac}-####-####", "eu"],
+  ["BR", "Brazil", "55", "###-###", "+55 {ac} ####-####", "eu"],
+  ["MX", "Mexico", "52", "###", "+52 {ac} #### ####", "eu"],
+  ["IN", "India", "91", "###", "+91 {ac} #### ####", "eu"],
+  ["NG", "Nigeria", "234", "###", "+234 {ac} ### ####", "eu"],
+  ["ZA", "South Africa", "27", "##", "+27 {ac} ### ####", "eu"],
+];
+
+// [city, region, region code, country code, latitude, longitude, IANA time zone, postal prefix, area code, phone template override?]
+const geoCities = [
+  ["New York", "New York", "NY", "US", 40.71, -74.01, "America/New_York", "100", "212"],
+  ["Los Angeles", "California", "CA", "US", 34.05, -118.24, "America/Los_Angeles", "900", "213"],
+  ["Chicago", "Illinois", "IL", "US", 41.88, -87.63, "America/Chicago", "606", "312"],
+  ["Houston", "Texas", "TX", "US", 29.76, -95.37, "America/Chicago", "770", "713"],
+  ["Phoenix", "Arizona", "AZ", "US", 33.45, -112.07, "America/Phoenix", "850", "602"],
+  ["Philadelphia", "Pennsylvania", "PA", "US", 39.95, -75.17, "America/New_York", "191", "215"],
+  ["San Antonio", "Texas", "TX", "US", 29.42, -98.49, "America/Chicago", "782", "210"],
+  ["San Diego", "California", "CA", "US", 32.72, -117.16, "America/Los_Angeles", "921", "619"],
+  ["Dallas", "Texas", "TX", "US", 32.78, -96.8, "America/Chicago", "752", "214"],
+  ["San Jose", "California", "CA", "US", 37.34, -121.89, "America/Los_Angeles", "951", "408"],
+  ["Austin", "Texas", "TX", "US", 30.27, -97.74, "America/Chicago", "787", "512"],
+  ["Seattle", "Washington", "WA", "US", 47.61, -122.33, "America/Los_Angeles", "981", "206"],
+  ["Denver", "Colorado", "CO", "US", 39.74, -104.99, "America/Denver", "802", "303"],
+  ["Boston", "Massachusetts", "MA", "US", 42.36, -71.06, "America/New_York", "021", "617"],
+  ["Atlanta", "Georgia", "GA", "US", 33.75, -84.39, "America/New_York", "303", "404"],
+  ["Miami", "Florida", "FL", "US", 25.76, -80.19, "America/New_York", "331", "305"],
+  ["Portland", "Oregon", "OR", "US", 45.52, -122.68, "America/Los_Angeles", "972", "503"],
+  ["Minneapolis", "Minnesota", "MN", "US", 44.98, -93.27, "America/Chicago", "554", "612"],
+  ["Nashville", "Tennessee", "TN", "US", 36.16, -86.78, "America/Chicago", "372", "615"],
+  ["Anchorage", "Alaska", "AK", "US", 61.22, -149.9, "America/Anchorage", "995", "907"],
+  ["Honolulu", "Hawaii", "HI", "US", 21.31, -157.86, "Pacific/Honolulu", "968", "808"],
+  ["Salt Lake City", "Utah", "UT", "US", 40.76, -111.89, "America/Denver", "841", "801"],
+  ["Detroit", "Michigan", "MI", "US", 42.33, -83.05, "America/Detroit", "482", "313"],
+  ["New Orleans", "Louisiana", "LA", "US", 29.95, -90.07, "America/Chicago", "701", "504"],
+  ["Toronto", "Ontario", "ON", "CA", 43.65, -79.38, "America/Toronto", "M5V", "416"],
+  ["Vancouver", "British Columbia", "BC", "CA", 49.28, -123.12, "America/Vancouver", "V6B", "604"],
+  ["Montreal", "Quebec", "QC", "CA", 45.5, -73.57, "America/Toronto", "H2Y", "514"],
+  ["Calgary", "Alberta", "AB", "CA", 51.05, -114.07, "America/Edmonton", "T2P", "403"],
+  ["Ottawa", "Ontario", "ON", "CA", 45.42, -75.7, "America/Toronto", "K1P", "613"],
+  ["Winnipeg", "Manitoba", "MB", "CA", 49.9, -97.14, "America/Winnipeg", "R3C", "204"],
+  ["Halifax", "Nova Scotia", "NS", "CA", 44.65, -63.58, "America/Halifax", "B3J", "902"],
+  ["London", "England", "ENG", "GB", 51.51, -0.13, "Europe/London", "EC1A", "20"],
+  ["Manchester", "England", "ENG", "GB", 53.48, -2.24, "Europe/London", "M1", "161", "+44 161 496 0###"],
+  ["Birmingham", "England", "ENG", "GB", 52.49, -1.89, "Europe/London", "B1", "121", "+44 121 496 0###"],
+  ["Leeds", "England", "ENG", "GB", 53.8, -1.55, "Europe/London", "LS1", "113", "+44 113 496 0###"],
+  ["Liverpool", "England", "ENG", "GB", 53.41, -2.98, "Europe/London", "L1", "151", "+44 151 496 0###"],
+  ["Bristol", "England", "ENG", "GB", 51.45, -2.59, "Europe/London", "BS1", "117", "+44 117 496 0###"],
+  ["Edinburgh", "Scotland", "SCT", "GB", 55.95, -3.19, "Europe/London", "EH1", "131", "+44 131 496 0###"],
+  ["Glasgow", "Scotland", "SCT", "GB", 55.86, -4.25, "Europe/London", "G1", "141", "+44 141 496 0###"],
+  ["Cardiff", "Wales", "WLS", "GB", 51.48, -3.18, "Europe/London", "CF10", "29", "+44 29 2018 0###"],
+  ["Belfast", "Northern Ireland", "NIR", "GB", 54.6, -5.93, "Europe/London", "BT1", "28", "+44 28 9649 6###"],
+  ["Berlin", "Berlin", "BE", "DE", 52.52, 13.41, "Europe/Berlin", "10", "30"],
+  ["Hamburg", "Hamburg", "HH", "DE", 53.55, 9.99, "Europe/Berlin", "20", "40"],
+  ["Munich", "Bavaria", "BY", "DE", 48.14, 11.58, "Europe/Berlin", "80", "89"],
+  ["Cologne", "North Rhine-Westphalia", "NW", "DE", 50.94, 6.96, "Europe/Berlin", "50", "221"],
+  ["Frankfurt", "Hesse", "HE", "DE", 50.11, 8.68, "Europe/Berlin", "60", "69"],
+  ["Stuttgart", "Baden-Württemberg", "BW", "DE", 48.78, 9.18, "Europe/Berlin", "70", "711"],
+  ["Dresden", "Saxony", "SN", "DE", 51.05, 13.74, "Europe/Berlin", "01", "351"],
+  ["Leipzig", "Saxony", "SN", "DE", 51.34, 12.37, "Europe/Berlin", "04", "341"],
+  ["Paris", "Île-de-France", "IDF", "FR", 48.86, 2.35, "Europe/Paris", "750", "1", "+33 1 99 00 ## ##"],
+  ["Lyon", "Auvergne-Rhône-Alpes", "ARA", "FR", 45.76, 4.84, "Europe/Paris", "690", "4"],
+  ["Marseille", "Provence-Alpes-Côte d'Azur", "PAC", "FR", 43.3, 5.37, "Europe/Paris", "130", "4"],
+  ["Toulouse", "Occitanie", "OCC", "FR", 43.6, 1.44, "Europe/Paris", "310", "5"],
+  ["Nice", "Provence-Alpes-Côte d'Azur", "PAC", "FR", 43.7, 7.27, "Europe/Paris", "060", "4"],
+  ["Bordeaux", "Nouvelle-Aquitaine", "NAQ", "FR", 44.84, -0.58, "Europe/Paris", "330", "5"],
+  ["Nantes", "Pays de la Loire", "PDL", "FR", 47.22, -1.55, "Europe/Paris", "440", "2"],
+  ["Strasbourg", "Grand Est", "GES", "FR", 48.57, 7.75, "Europe/Paris", "670", "3"],
+  ["Madrid", "Community of Madrid", "MD", "ES", 40.42, -3.7, "Europe/Madrid", "28", "91"],
+  ["Barcelona", "Catalonia", "CT", "ES", 41.39, 2.17, "Europe/Madrid", "08", "93"],
+  ["Valencia", "Valencian Community", "VC", "ES", 39.47, -0.38, "Europe/Madrid", "46", "96"],
+  ["Seville", "Andalusia", "AN", "ES", 37.39, -5.98, "Europe/Madrid", "41", "95"],
+  ["Bilbao", "Basque Country", "PV", "ES", 43.26, -2.93, "Europe/Madrid", "48", "94"],
+  ["Zaragoza", "Aragon", "AR", "ES", 41.65, -0.89, "Europe/Madrid", "50", "97"],
+  ["Rome", "Lazio", "62", "IT", 41.9, 12.5, "Europe/Rome", "00", "06"],
+  ["Milan", "Lombardy", "25", "IT", 45.46, 9.19, "Europe/Rome", "20", "02"],
+  ["Naples", "Campania", "72", "IT", 40.85, 14.27, "Europe/Rome", "80", "081"],
+  ["Turin", "Piedmont", "21", "IT", 45.07, 7.69, "Europe/Rome", "10", "011"],
+  ["Florence", "Tuscany", "52", "IT", 43.77, 11.26, "Europe/Rome", "50", "055"],
+  ["Palermo", "Sicily", "82", "IT", 38.12, 13.36, "Europe/Rome", "90", "091"],
+  ["Amsterdam", "North Holland", "NH", "NL", 52.37, 4.9, "Europe/Amsterdam", "10", "20"],
+  ["Rotterdam", "South Holland", "ZH", "NL", 51.92, 4.48, "Europe/Amsterdam", "30", "10"],
+  ["Utrecht", "Utrecht", "UT", "NL", 52.09, 5.12, "Europe/Amsterdam", "35", "30"],
+  ["Eindhoven", "North Brabant", "NB", "NL", 51.44, 5.48, "Europe/Amsterdam", "56", "40"],
+  ["Stockholm", "Stockholm County", "AB", "SE", 59.33, 18.07, "Europe/Stockholm", "11", "8"],
+  ["Gothenburg", "Västra Götaland", "O", "SE", 57.71, 11.97, "Europe/Stockholm", "41", "31"],
+  ["Malmö", "Skåne", "M", "SE", 55.6, 13.0, "Europe/Stockholm", "21", "40"],
+  ["Zurich", "Zurich", "ZH", "CH", 47.38, 8.54, "Europe/Zurich", "80", "44"],
+  ["Geneva", "Geneva", "GE", "CH", 46.2, 6.14, "Europe/Zurich", "12", "22"],
+  ["Bern", "Bern", "BE", "CH", 46.95, 7.45, "Europe/Zurich", "30", "31"],
+  ["Sydney", "New South Wales", "NSW", "AU", -33.87, 151.21, "Australia/Sydney", "20", "2"],
+  ["Melbourne", "Victoria", "VIC", "AU", -37.81, 144.96, "Australia/Melbourne", "30", "3"],
+  ["Brisbane", "Queensland", "QLD", "AU", -27.47, 153.03, "Australia/Brisbane", "40", "7"],
+  ["Perth", "Western Australia", "WA", "AU", -31.95, 115.86, "Australia/Perth", "60", "8"],
+  ["Adelaide", "South Australia", "SA", "AU", -34.93, 138.6, "Australia/Adelaide", "50", "8"],
+  ["Auckland", "Auckland", "AUK", "NZ", -36.85, 174.76, "Pacific/Auckland", "10", "9"],
+  ["Wellington", "Wellington", "WGN", "NZ", -41.29, 174.78, "Pacific/Auckland", "61", "4"],
+  ["Christchurch", "Canterbury", "CAN", "NZ", -43.53, 172.64, "Pacific/Auckland", "80", "3"],
+  ["Tokyo", "Tokyo", "13", "JP", 35.68, 139.69, "Asia/Tokyo", "100", "3"],
+  ["Osaka", "Osaka", "27", "JP", 34.69, 135.5, "Asia/Tokyo", "530", "6"],
+  ["Kyoto", "Kyoto", "26", "JP", 35.01, 135.77, "Asia/Tokyo", "600", "75"],
+  ["Sapporo", "Hokkaido", "01", "JP", 43.06, 141.35, "Asia/Tokyo", "060", "11"],
+  ["Fukuoka", "Fukuoka", "40", "JP", 33.59, 130.4, "Asia/Tokyo", "810", "92"],
+  ["Nagoya", "Aichi", "23", "JP", 35.18, 136.91, "Asia/Tokyo", "460", "52"],
+  ["São Paulo", "São Paulo", "SP", "BR", -23.55, -46.63, "America/Sao_Paulo", "01", "11"],
+  ["Rio de Janeiro", "Rio de Janeiro", "RJ", "BR", -22.91, -43.17, "America/Sao_Paulo", "20", "21"],
+  ["Brasília", "Federal District", "DF", "BR", -15.79, -47.88, "America/Sao_Paulo", "70", "61"],
+  ["Salvador", "Bahia", "BA", "BR", -12.97, -38.5, "America/Bahia", "40", "71"],
+  ["Manaus", "Amazonas", "AM", "BR", -3.12, -60.02, "America/Manaus", "69", "92"],
+  ["Mexico City", "Mexico City", "CMX", "MX", 19.43, -99.13, "America/Mexico_City", "06", "55"],
+  ["Guadalajara", "Jalisco", "JAL", "MX", 20.67, -103.35, "America/Mexico_City", "44", "33"],
+  ["Monterrey", "Nuevo León", "NLE", "MX", 25.69, -100.32, "America/Monterrey", "64", "81"],
+  ["Mérida", "Yucatán", "YUC", "MX", 20.97, -89.62, "America/Merida", "97", "999"],
+  ["Mumbai", "Maharashtra", "MH", "IN", 19.08, 72.88, "Asia/Kolkata", "400", "22"],
+  ["Delhi", "Delhi", "DL", "IN", 28.61, 77.21, "Asia/Kolkata", "110", "11"],
+  ["Bengaluru", "Karnataka", "KA", "IN", 12.97, 77.59, "Asia/Kolkata", "560", "80"],
+  ["Chennai", "Tamil Nadu", "TN", "IN", 13.08, 80.27, "Asia/Kolkata", "600", "44"],
+  ["Kolkata", "West Bengal", "WB", "IN", 22.57, 88.36, "Asia/Kolkata", "700", "33"],
+  ["Hyderabad", "Telangana", "TS", "IN", 17.39, 78.49, "Asia/Kolkata", "500", "40"],
+  ["Lagos", "Lagos", "LA", "NG", 6.52, 3.38, "Africa/Lagos", "100", "1"],
+  ["Abuja", "Federal Capital Territory", "FC", "NG", 9.08, 7.4, "Africa/Lagos", "900", "9"],
+  ["Kano", "Kano", "KN", "NG", 12.0, 8.52, "Africa/Lagos", "700", "64"],
+  ["Johannesburg", "Gauteng", "GP", "ZA", -26.2, 28.05, "Africa/Johannesburg", "20", "11"],
+  ["Cape Town", "Western Cape", "WC", "ZA", -33.92, 18.42, "Africa/Johannesburg", "80", "21"],
+  ["Durban", "KwaZulu-Natal", "KZN", "ZA", -29.86, 31.02, "Africa/Johannesburg", "40", "31"],
+];
+
+const LOWER = "abcdefghijklmnopqrstuvwxyz";
+const UPPER = LOWER.toUpperCase();
+const round4 = (x) => Math.round(x * 10000) / 10000;
+
+/** Fill a pattern: "#" digit, "A" letter, anything else literal. */
+function fill(pattern, s) {
+  let out = "";
+  for (const c of pattern) out += c === "#" ? s.int(0, 9) : c === "A" ? UPPER[s.int(0, 25)] : c;
+  return out;
+}
+
+const INHERIT = new Set(["address", "location", "coordinates", "coords", "geo", "geolocation", "position", "place", "residence"]);
+
+export const geo = freeze({
+  name: "geo",
+  version: 1,
+  vocab: { geoCountries, geoCities },
+  types: { "place.lat": "Float", "place.lng": "Float" },
+  // a type called `address`, `location`, ... shares the persona of the entity that holds it
+  inherit: (typeName) => INHERIT.has(typeName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).pop().toLowerCase()),
+  rules({ tokens, last }) {
+    const key = tokens.join(" ");
+    if (last === "timezone" || last === "tz" || key.endsWith("time zone")) return { sdl: "String", gen: "geo.timezone" };
+    if (last === "latitude" || last === "lat") return { sdl: "Float", gen: "place.lat" };
+    if (last === "longitude" || last === "lng" || last === "lon" || last === "long") return { sdl: "Float", gen: "place.lng" };
+    if (last === "region" || last === "province") return { sdl: "String", gen: "geo.region" };
+    if (key.endsWith("country code")) return { sdl: "String", gen: "geo.countryCode" };
+    if (key.endsWith("region code") || key.endsWith("state code") || key.endsWith("province code")) return { sdl: "String", gen: "geo.regionCode" };
+    if (key.endsWith("calling code") || key.endsWith("dial code")) return { sdl: "String", gen: "geo.callingCode" };
+    if (last === "postcode") return { sdl: "String", gen: "place.zip" };
+    return null;
+  },
+  generators(V) {
+    const countries = new Map(V.geoCountries.map((c) => [c[0], { code: c[0], name: c[1], dial: c[2], pf: c[3], ph: c[4], style: c[5] }]));
+    const cities = V.geoCities.map((c) => ({
+      city: c[0], region: c[1], regionCode: c[2], country: countries.get(c[3]), lat: c[4], lng: c[5], tz: c[6], pc: c[7], ac: c[8], ph: c[9],
+    }));
+    const place = (ctx) => ctx.slot("place").pick(cities);
+    const postal = (ctx, row) => row.pc + fill(row.country.pf, ctx.slot("zip"));
+    const street = (ctx) => {
+      const s = ctx.slot("street");
+      return `${s.int(1, 999)} ${s.pick(V.streets)} ${s.pick(V.streetSuffixes)}`;
+    };
+    return {
+      "place.city": (ctx) => place(ctx).city,
+      "place.state": (ctx) => place(ctx).region,
+      "place.country": (ctx) => place(ctx).country.name,
+      "place.zip": (ctx) => postal(ctx, place(ctx)),
+      "place.street": (ctx) => street(ctx),
+      "place.address": (ctx) => {
+        const row = place(ctx);
+        const p = postal(ctx, row);
+        return row.country.style === "us" ? `${street(ctx)}, ${row.city}, ${row.regionCode} ${p}` : `${street(ctx)}, ${p} ${row.city}`;
+      },
+      // within about 0.1 degree (roughly 10 km) of the city centre
+      "place.lat": (ctx) => round4(place(ctx).lat + (ctx.slot("latJitter").float() - 0.5) * 0.2),
+      "place.lng": (ctx) => round4(place(ctx).lng + (ctx.slot("lngJitter").float() - 0.5) * 0.2),
+      "person.phone": (ctx) => {
+        const row = place(ctx);
+        return fill((row.ph ?? row.country.ph).replace("{ac}", row.ac), ctx.slot("phoneLine"));
+      },
+      "geo.region": (ctx) => place(ctx).region,
+      "geo.regionCode": (ctx) => place(ctx).regionCode,
+      "geo.countryCode": (ctx) => place(ctx).country.code,
+      "geo.callingCode": (ctx) => `+${place(ctx).country.dial}`,
+      "geo.timezone": (ctx) => place(ctx).tz,
+    };
+  },
+});
+
+export default geo;

package/src/packs/health.d.ts

@@ -0,0 +1,4 @@
+import type { Pack } from "../index.js";
+/** The health pack. Import from "@johnhenry/graceholder/packs/health". */
+export declare const health: Pack;
+export default health;

package/src/packs/health.js

@@ -0,0 +1,76 @@
+// Health pack: CLEARLY FICTIONAL conditions and medications for demos and tests. Every condition and
+// medication is an invented, whimsical name that is not a real diagnosis or drug, and by default the
+// generators append "(fictional)" so a value can never be mistaken for medical data. Medical
+// specialties are ordinary category names. Nothing here is medical information or advice.
+// FROZEN at 1.0.0.
+
+const freeze = (o) => {
+  if (o !== null && typeof o === "object") for (const v of Object.values(o)) freeze(v);
+  return Object.freeze(o);
+};
+
+// [condition, specialty, medication A, medication B]
+const healthConditions = [
+  ["Wibblefern Syndrome", "Neurology", "Glimmerol", "Wobblex"],
+  ["Grumblecough", "Pulmonology", "Snoozeprax", "Puffadine"],
+  ["Snorkelitis", "Otolaryngology", "Bubblenase", "Flumpazine"],
+  ["Quibblepox", "Dermatology", "Dabbacream", "Spotless Plink"],
+  ["Mumbleknee", "Orthopedics", "Creakaway", "Jointibop"],
+  ["Flutterhiccup Disorder", "Gastroenterology", "Hiccuban", "Glugstop"],
+  ["Marmalade Fever", "Infectious Disease", "Jamzolve", "Sticktoast"],
+  ["Gigglepox", "Pediatrics", "Chuckleron", "Tickleflux"],
+  ["Sillybone Disorder", "Rheumatology", "Funnymax", "Boneroo"],
+  ["Twiddlethumb Palsy", "Neurology", "Fidgetol", "Thumbwell"],
+  ["Noodleback", "Physical Medicine", "Stiffnot", "Wigglorin"],
+  ["Dizzlewhirl", "Otolaryngology", "Spinabate", "Steadyfloop"],
+  ["Pumpernickel Rash", "Dermatology", "Crumbicide", "Smoothaloo"],
+  ["Hullabaloo Headache", "Neurology", "Quietane", "Hushabye Forte"],
+  ["Gloomcloud Fatigue", "Psychiatry", "Sunbeamol", "Brightify"],
+  ["Tumbleweed Cough", "Pulmonology", "Rollaway", "Breezeomin"],
+  ["Fidgetwing Syndrome", "Cardiology", "Calmwing", "Steadybeat"],
+  ["Plinkerton Allergy", "Allergy", "Sneezeless", "Pollenpuff"],
+  ["Blinkblot Strain", "Ophthalmology", "Clearglance", "Eyebrite Mist"],
+  ["Crumplekidney Ache", "Nephrology", "Flushwell", "Filterfun"],
+  ["Hiccup-in-the-Heart", "Cardiology", "Thumpaway", "Rhythmoo"],
+  ["Mossback Stiffness", "Rheumatology", "Limberol", "Unkinkazine"],
+  ["Pillowcase Insomnia", "Sleep Medicine", "Drowsabell", "Dreamlux"],
+  ["Teacup Tremor", "Neurology", "Steadysip", "Shakeaway"],
+];
+
+const healthDoses = ["5 mg", "10 mg", "20 mg", "25 mg", "50 mg", "100 mg", "250 mg", "500 mg", "2 mL", "5 mL"];
+const healthSeverities = ["mild", "moderate", "severe"];
+
+export const health = freeze({
+  name: "health",
+  version: 1,
+  vocab: { healthConditions, healthDoses, healthSeverities },
+  rules({ tokens, last, kind }) {
+    const key = tokens.join(" ");
+    if (last === "diagnosis" || last === "illness" || last === "disease" || (last === "condition" && kind !== "product")) return { sdl: "String", gen: "health.condition" };
+    if (last === "medication" || last === "drug" || last === "medicine" || last === "prescription") return { sdl: "String", gen: "health.medication" };
+    if (last === "dosage" || last === "dose") return { sdl: "String", gen: "health.dosage" };
+    if (last === "specialty" || last === "speciality") return { sdl: "String", gen: "health.specialty" };
+    if (key === "severity" || key === "condition severity") return { sdl: "String", gen: "health.severity" };
+    if (key === "mrn" || key === "record number" || key === "medical record number") return { sdl: "String", gen: "health.recordNumber" };
+    return null;
+  },
+  generators(V) {
+    // one "condition" slot per entity: condition, medication and specialty agree
+    const row = (ctx) => ctx.slot("condition").pick(V.healthConditions);
+    const tag = (text, args) => (args.tag === false ? text : `${text} (fictional)`);
+    return {
+      "health.condition": (ctx) => tag(row(ctx)[0], ctx.args),
+      "health.medication": (ctx) => {
+        const r = row(ctx);
+        return tag(r[2 + ctx.slot("medChoice").int(0, 1)], ctx.args);
+      },
+      "health.dosage": (ctx) => ctx.slot("dose").pick(V.healthDoses),
+      "health.specialty": (ctx) => row(ctx)[1],
+      "health.severity": (ctx) => ctx.slot("severity").pick(V.healthSeverities),
+      // not a real identifier format: the FX prefix marks it as fictional
+      "health.recordNumber": (ctx) => `FX-${String(ctx.slot("mrn").int(0, 9999999)).padStart(7, "0")}`,
+    };
+  },
+});
+
+export default health;

package/src/packs/index.d.ts

@@ -0,0 +1,7 @@
+import type { Pack } from "../index.js";
+export { geo } from "./geo.js";
+export { commerce } from "./commerce.js";
+export { finance } from "./finance.js";
+export { health } from "./health.js";
+/** Every pack, in registration order. */
+export declare const allPacks: readonly Pack[];

package/src/packs/index.js

@@ -0,0 +1,9 @@
+// All packs. Import this entry to get every pack; import `@johnhenry/graceholder/packs/<name>` to ship one.
+import { geo } from "./geo.js";
+import { commerce } from "./commerce.js";
+import { finance } from "./finance.js";
+import { health } from "./health.js";
+
+export { geo, commerce, finance, health };
+/** Every pack, in registration order. */
+export const allPacks = Object.freeze([geo, commerce, finance, health]);