{"version":3,"file":"render.cjs","sources":["webpack://thai-qr-payment/../assets/src/generated.ts","webpack://thai-qr-payment/../assets/src/index.ts","webpack://thai-qr-payment/../payload/src/amount.ts","webpack://thai-qr-payment/../payload/src/barcode.ts","webpack://thai-qr-payment/../payload/src/builder.ts","webpack://thai-qr-payment/../payload/src/crc.ts","webpack://thai-qr-payment/../payload/src/index.ts","webpack://thai-qr-payment/../payload/src/message.ts","webpack://thai-qr-payment/../payload/src/parser.ts","webpack://thai-qr-payment/../payload/src/recipient.ts","webpack://thai-qr-payment/../payload/src/slip-verify.ts","webpack://thai-qr-payment/../payload/src/tags.ts","webpack://thai-qr-payment/../payload/src/tlv.ts","webpack://thai-qr-payment/../qr/src/bitbuffer.ts","webpack://thai-qr-payment/../qr/src/encoder.ts","webpack://thai-qr-payment/../qr/src/format-info.ts","webpack://thai-qr-payment/../qr/src/gf.ts","webpack://thai-qr-payment/../qr/src/index.ts","webpack://thai-qr-payment/../qr/src/mask.ts","webpack://thai-qr-payment/../qr/src/matrix.ts","webpack://thai-qr-payment/../qr/src/mode.ts","webpack://thai-qr-payment/../qr/src/patterns.ts","webpack://thai-qr-payment/../qr/src/placement.ts","webpack://thai-qr-payment/../qr/src/rs.ts","webpack://thai-qr-payment/../qr/src/version.ts","webpack://thai-qr-payment/../render/src/card.ts","webpack://thai-qr-payment/../render/src/index.ts","webpack://thai-qr-payment/../render/src/matrix-svg.ts","webpack://thai-qr-payment/./src/render.ts"],"sourcesContent":["// Generated by scripts/build-svg-module.mjs — do not edit by hand.\n// Run `pnpm --filter @thai-qr-payment/assets build` to regenerate.\n\nexport const PromptPay1_silhouette = \"\";\nexport const PromptPay1 = \"\";\nexport const PromptPay2 = \"\";\nexport const Thai_QR_Payment_Logo_01_silhouette = \"\";\nexport const Thai_QR_Payment_Logo_01 = \"\";\n\nexport const COLOR_LOGOS = {\n \"PromptPay1\": PromptPay1,\n \"PromptPay2\": PromptPay2,\n \"Thai_QR_Payment_Logo-01\": Thai_QR_Payment_Logo_01,\n} as const;\n\nexport const SILHOUETTE_LOGOS = {\n \"PromptPay1\": PromptPay1_silhouette,\n \"Thai_QR_Payment_Logo-01\": Thai_QR_Payment_Logo_01_silhouette,\n} as const;\n\nexport type ColorLogoName = keyof typeof COLOR_LOGOS;\nexport type SilhouetteLogoName = keyof typeof SILHOUETTE_LOGOS;\n","/**\n * `@thai-qr-payment/assets` — SVG brand marks for Thai QR Payment.\n *\n * Each mark ships in two flavors:\n * - `COLOR_LOGOS[name]` — full-colour SVG path traced via vtracer.\n * True vector (no embedded raster), small enough to inline anywhere.\n * - `SILHOUETTE_LOGOS[name]` — monochrome path traced via potrace.\n * Even smaller, suitable for masks / icons / dark mode.\n *\n * Only the canonical marks ship by default — `Thai_QR_Payment_Logo-01`\n * (the BOT/TBA primary Thai QR Payment logo) and `PromptPay1` (the\n * National ITMX PromptPay mark). If you need an alternative layout,\n * trace your own asset via the supplied `scripts/build-assets.sh` and\n * drop the result into `packages/assets/src/svg/`.\n *\n * All exports are plain SVG strings — drop them into innerHTML, write\n * them to disk, or serve them with `Content-Type: image/svg+xml`.\n *\n * Marks belong to their respective rights-holders:\n * - Thai QR Payment logo — Bank of Thailand / Thai Bankers' Association\n * - PromptPay logo — Bank of Thailand / National ITMX\n *\n * Use of these marks is governed by Thai QR Payment Brand Guidelines.\n * This package merely redistributes the bitmap → SVG conversion;\n * downstream apps must comply with the official brand book.\n */\n\nexport {\n COLOR_LOGOS,\n SILHOUETTE_LOGOS,\n type ColorLogoName,\n type SilhouetteLogoName,\n} from './generated.js';\n\nimport { COLOR_LOGOS, SILHOUETTE_LOGOS } from './generated.js';\nimport type { ColorLogoName, SilhouetteLogoName } from './generated.js';\n\n/** Get a color logo by name (returns the SVG string). */\nexport function colorLogo(name: ColorLogoName): string {\n return COLOR_LOGOS[name];\n}\n\n/** Get a silhouette logo by name. */\nexport function silhouetteLogo(name: SilhouetteLogoName): string {\n return SILHOUETTE_LOGOS[name];\n}\n\n/** Default mark recommendations for downstream use. */\nexport const DEFAULT_LOGOS = {\n thaiQrPayment: 'Thai_QR_Payment_Logo-01',\n thaiQrPaymentSilhouette: 'Thai_QR_Payment_Logo-01',\n promptpay: 'PromptPay1',\n promptpaySilhouette: 'PromptPay1',\n} as const;\n","/**\n * Amount formatting for tag 54 (Transaction Amount).\n *\n * EMVCo allows up to 13 chars including the decimal point — Thai banks\n * cap the integer part at 10 digits + 2 decimals. We accept either a\n * number (in baht) or a satang-int + flag, and always emit 2 decimals\n * because that's what every Thai banking app re-displays consistently.\n */\n\nconst MAX_BAHT = 9_999_999_999.99; // 13 chars: \"9999999999.99\"\n\nexport interface FormatAmountOptions {\n /** When true, treat the input as integer satang (1 baht = 100 satang). */\n fromSatang?: boolean;\n}\n\n/**\n * Format an amount for the wire. Returns `null` for static QR (caller\n * intends a \"scan and enter any amount\" code).\n */\nexport function formatAmount(\n value: number | bigint | undefined | null,\n options: FormatAmountOptions = {},\n): string | null {\n if (value == null) return null;\n\n let baht: number;\n if (typeof value === 'bigint') {\n baht = options.fromSatang ? Number(value) / 100 : Number(value);\n } else {\n baht = options.fromSatang ? value / 100 : value;\n }\n\n if (!Number.isFinite(baht)) {\n throw new TypeError('Amount must be a finite number');\n }\n if (baht <= 0) return null;\n if (baht > MAX_BAHT) {\n throw new RangeError(`Amount ${baht} exceeds max wire value ${MAX_BAHT}`);\n }\n\n // Round to 2 decimals using integer math to dodge float-printout\n // surprises like 0.1 + 0.2 → \"0.30000000000000004\".\n const cents = Math.round(baht * 100);\n const baht10 = Math.floor(cents / 100);\n const sub = cents - baht10 * 100;\n return `${baht10}.${sub.toString(10).padStart(2, '0')}`;\n}\n","/**\n * Bank of Thailand 1D barcode (bill-payment, counter-scanned).\n *\n * This is intentionally not part of the EMVCo TLV machinery in the rest\n * of the package. The BOT barcode is a `|`-led, `\\r`-delimited ASCII\n * string scanned at bank counters and 7-Eleven cashier stations for\n * over-the-counter bill payments — not a QR, not TLV, no CRC. It shares\n * the cross-bank biller-id concept with EMVCo tag 30 but the wire\n * format is otherwise unrelated, so it lives in its own module to keep\n * the TLV builder + parser tree-shake cleanly when callers only need\n * one or the other.\n *\n * Wire shape: `|\\r\\r\\r`\n * - leading pipe is a fixed sentinel\n * - billerId is 15 chars (Tax ID + suffix), zero-padded if shorter\n * - ref1 is mandatory (customer/invoice number)\n * - ref2 may be the empty string if unused\n * - amount is integer satang (baht × 100), or the literal \"0\" when\n * the cashier is expected to key the amount in by hand\n */\n\nconst FIELD_SEPARATOR = '\\r';\nconst PAYLOAD_PREFIX = '|';\nconst BILLER_ID_LENGTH = 15;\nconst NO_AMOUNT_SENTINEL = '0';\n/** 13 chars: \"9999999999.99\" — matches `formatAmount`'s cap for consistency. */\nconst MAX_BAHT = 9_999_999_999.99;\n\nexport interface BOTBarcodeInput {\n /** Cross-bank biller id (Tax ID + suffix). ≤ 15 chars, zero-padded on emit. */\n billerId: string;\n /** Customer / invoice reference. Must be non-empty. */\n ref1: string;\n /** Optional secondary reference. Empty string on the wire if omitted. */\n ref2?: string;\n /**\n * Baht amount. Omit (or pass `undefined`) for a counter-keyed total —\n * the literal \"0\" is then written and the cashier types the amount.\n */\n amount?: number;\n}\n\nexport interface ParsedBOTBarcode {\n billerId: string;\n ref1: string;\n ref2?: string;\n amount?: number;\n}\n\n/**\n * Build a BOT 1D bill-payment barcode payload.\n *\n * Throws `TypeError` / `RangeError` for malformed input — the caller\n * never silently produces an unscannable barcode.\n *\n * @example\n * buildBOTBarcode({ billerId: '099999999999990', ref1: '111222333444' })\n * // → '|099999999999990\\r111222333444\\r\\r0'\n *\n * @example\n * buildBOTBarcode({\n * billerId: '099400016550100',\n * ref1: '123456789012',\n * ref2: '670429',\n * amount: 3649.22,\n * })\n * // → '|099400016550100\\r123456789012\\r670429\\r364922'\n */\nexport function buildBOTBarcode(input: BOTBarcodeInput): string {\n const billerId = normaliseBillerId(input.billerId);\n const ref1 = ensureRef('ref1', input.ref1, { allowEmpty: false });\n const ref2 = ensureRef('ref2', input.ref2 ?? '', { allowEmpty: true });\n const amountField = formatAmountField(input.amount);\n\n return (\n PAYLOAD_PREFIX +\n billerId +\n FIELD_SEPARATOR +\n ref1 +\n FIELD_SEPARATOR +\n ref2 +\n FIELD_SEPARATOR +\n amountField\n );\n}\n\n/**\n * Parse a BOT 1D bill-payment barcode back into its component fields.\n *\n * Returns `null` for any structural issue (missing prefix, wrong field\n * count, biller-id too short) so callers can branch without `try/catch`.\n * The trailing amount is decoded back to baht (e.g. `'364922'` → `3649.22`),\n * and the literal \"0\" sentinel surfaces as `undefined`.\n *\n * @example\n * parseBOTBarcode('|099999999999990\\r111222333444\\r\\r0')\n * // → { billerId: '099999999999990', ref1: '111222333444' }\n *\n * @example\n * parseBOTBarcode('|099400016550100\\r123456789012\\r670429\\r364922')\n * // → {\n * // billerId: '099400016550100',\n * // ref1: '123456789012',\n * // ref2: '670429',\n * // amount: 3649.22,\n * // }\n */\nexport function parseBOTBarcode(barcode: string): ParsedBOTBarcode | null {\n if (typeof barcode !== 'string') return null;\n if (!barcode.startsWith(PAYLOAD_PREFIX)) return null;\n\n // `\\r` delimiters resolve the otherwise-ambiguous variable-length\n // ref1/ref2/amount tail. Four parts exactly — no more, no less.\n const parts = barcode.slice(PAYLOAD_PREFIX.length).split(FIELD_SEPARATOR);\n if (parts.length !== 4) return null;\n\n const billerId = parts[0]!;\n const ref1 = parts[1]!;\n const ref2 = parts[2]!;\n const amountField = parts[3]!;\n\n if (billerId.length < BILLER_ID_LENGTH) return null;\n if (ref1.length === 0) return null;\n\n const result: ParsedBOTBarcode = { billerId, ref1 };\n if (ref2.length > 0) result.ref2 = ref2;\n\n const amount = decodeAmountField(amountField);\n if (amount === 'invalid') return null;\n if (amount != null) result.amount = amount;\n\n return result;\n}\n\n/** Pad short biller ids to the 15-char wire width; reject overlong ones. */\nfunction normaliseBillerId(raw: string): string {\n if (typeof raw !== 'string' || raw.length === 0) {\n throw new TypeError('billerId must be a non-empty string');\n }\n if (raw.includes(FIELD_SEPARATOR)) {\n throw new TypeError('billerId must not contain a carriage return');\n }\n if (raw.length > BILLER_ID_LENGTH) {\n throw new RangeError(`billerId is ${raw.length} chars; max is ${BILLER_ID_LENGTH}`);\n }\n return raw.padStart(BILLER_ID_LENGTH, '0');\n}\n\n/** Reject CR and (optionally) empty refs without inventing extra rules. */\nfunction ensureRef(name: 'ref1' | 'ref2', value: string, options: { allowEmpty: boolean }): string {\n if (typeof value !== 'string') {\n throw new TypeError(`${name} must be a string`);\n }\n if (!options.allowEmpty && value.length === 0) {\n throw new TypeError(`${name} must be a non-empty string`);\n }\n if (value.includes(FIELD_SEPARATOR)) {\n throw new TypeError(`${name} must not contain a carriage return`);\n }\n return value;\n}\n\n/** Encode the trailing amount field as integer satang, or the \"0\" sentinel. */\nfunction formatAmountField(amount: number | undefined): string {\n if (amount == null) return NO_AMOUNT_SENTINEL;\n if (!Number.isFinite(amount)) {\n throw new TypeError('amount must be a finite number');\n }\n if (amount < 0) {\n throw new RangeError('amount must be non-negative');\n }\n if (amount > MAX_BAHT) {\n throw new RangeError(`amount ${amount} exceeds max wire value ${MAX_BAHT}`);\n }\n // Integer math so 0.1 + 0.2 → \"30\" instead of \"30.0000000004\".\n const satang = Math.round(amount * 100);\n return satang === 0 ? NO_AMOUNT_SENTINEL : satang.toString(10);\n}\n\n/**\n * Decode the trailing amount field.\n *\n * Returns `'invalid'` (a discriminator, not a value) for malformed input,\n * `null` for the \"amount entered at counter\" sentinel, or the decoded\n * baht number otherwise.\n */\nfunction decodeAmountField(field: string): number | null | 'invalid' {\n if (field.length === 0) return 'invalid';\n if (field === NO_AMOUNT_SENTINEL) return null;\n // BOT spec specifies the amount field as integer satang. Reject any\n // non-digit content (including a stray decimal point or sign).\n for (let i = 0; i < field.length; i += 1) {\n const code = field.charCodeAt(i);\n if (code < 0x30 || code > 0x39) return 'invalid';\n }\n const satang = Number.parseInt(field, 10);\n if (!Number.isFinite(satang)) return 'invalid';\n if (satang === 0) return null;\n // Round-trip through integer math to keep the baht side exact.\n const baht = Math.floor(satang / 100);\n const sub = satang - baht * 100;\n return baht + sub / 100;\n}\n","/**\n * Fluent builder for the Thai QR Payment wire payload.\n *\n * The builder collects field assignments in an ordered list, then renders\n * the final string in one pass with the CRC computed over the body plus\n * the CRC tag header (`6304`) — that header is part of the hashed input\n * per EMVCo §4, which surprises everyone who reads the spec for the\n * first time.\n *\n * Order on the wire is fixed by tag id (lowest first). The builder\n * stores fields in a Map keyed by tag id and emits them sorted at\n * `build()`-time so callers can set them in any order without breaking\n * the resulting checksum.\n */\n\nimport { formatAmount, type FormatAmountOptions } from './amount.js';\nimport { checksum } from './crc.js';\nimport { encodePersonalMessage } from './message.js';\nimport {\n normaliseBankAccount,\n normaliseRecipient,\n type NormalisedRecipient,\n type PromptPayRecipientType,\n} from './recipient.js';\nimport {\n COUNTRY_TH,\n CURRENCY_THB,\n GUID_BILL_PAYMENT,\n GUID_BILL_PAYMENT_CROSS_BORDER,\n GUID_PROMPTPAY,\n GUID_PROMPTPAY_OTA,\n PAYLOAD_FORMAT_VERSION,\n POI_DYNAMIC,\n POI_STATIC,\n SUB_ADD_BILL_NUMBER,\n SUB_ADD_CONSUMER_DATA_REQUEST,\n SUB_ADD_CUSTOMER_LABEL,\n SUB_ADD_LOYALTY_NUMBER,\n SUB_ADD_MOBILE_NUMBER,\n SUB_ADD_PURPOSE_OF_TRANSACTION,\n SUB_ADD_REFERENCE_LABEL,\n SUB_ADD_STORE_LABEL,\n SUB_ADD_TERMINAL_LABEL,\n SUB_BILL_BILLER_ID,\n SUB_BILL_REFERENCE_1,\n SUB_BILL_REFERENCE_2,\n SUB_GUID,\n SUB_PROMPTPAY_OTA,\n SUB_TRUE_MONEY,\n SUB_VAT_AMOUNT,\n SUB_VAT_RATE,\n SUB_VAT_SELLER_TAX_BRANCH_ID,\n TAG_ADDITIONAL_DATA,\n TAG_CHECKSUM,\n TAG_COUNTRY_CODE,\n TAG_MERCHANT_ACCOUNT_BILL_PAYMENT,\n TAG_MERCHANT_ACCOUNT_PROMPTPAY,\n TAG_MERCHANT_CATEGORY_CODE,\n TAG_MERCHANT_CITY,\n TAG_MERCHANT_NAME,\n TAG_PAYLOAD_FORMAT,\n TAG_PERSONAL_MESSAGE,\n TAG_POINT_OF_INITIATION,\n TAG_POSTAL_CODE,\n TAG_TIP_FIXED,\n TAG_TIP_OR_CONVENIENCE_INDICATOR,\n TAG_TIP_PERCENTAGE,\n TAG_TRANSACTION_AMOUNT,\n TAG_TRANSACTION_CURRENCY,\n TAG_VAT_TQRC,\n TIP_FIXED,\n TIP_PERCENTAGE,\n TIP_PROMPT,\n TRUE_MONEY_PREFIX,\n} from './tags.js';\nimport { encodeField, encodeFields } from './tlv.js';\n\nconst OTA_CODE_LENGTH = 10;\n\nexport interface AdditionalDataFields {\n billNumber?: string;\n mobileNumber?: string;\n storeLabel?: string;\n loyaltyNumber?: string;\n referenceLabel?: string;\n customerLabel?: string;\n terminalLabel?: string;\n purposeOfTransaction?: string;\n consumerDataRequest?: string;\n}\n\nexport type TipMode =\n | { mode: 'prompt' }\n | { mode: 'fixed'; value: number; fromSatang?: boolean }\n | { mode: 'percentage'; value: number };\n\nexport interface MerchantInfo {\n /** Up to 25 alphanumeric characters; truncated by the builder. */\n name?: string;\n /** Up to 15 alphanumeric characters. */\n city?: string;\n /** Up to 10 chars. */\n postalCode?: string;\n /** 4-digit Merchant Category Code from ISO 18245. */\n categoryCode?: string;\n}\n\nexport interface VATTQRCInput {\n /** Seller's tax branch identifier — exactly 4 characters. */\n sellerTaxBranchId: string;\n /** VAT rate as displayed on the receipt (e.g. \"7\" or \"7.00\"); 1–5 chars. */\n vatRate?: string;\n /** VAT amount as displayed on the receipt; 1–13 chars, required. */\n vatAmount: string;\n}\n\n/**\n * Thai QR Payment payload builder.\n *\n * Three terminal methods:\n * - `.build()` returns the wire-format string ready for QR encoding.\n * - `.buildWithChecksum()` returns both the body and the checksum\n * separately — useful for debugging the CRC step.\n * - `.toBytes()` returns a `Uint8Array` of the ASCII-encoded payload\n * for callers that want to hash or sign it.\n */\nexport class ThaiQRPaymentBuilder {\n private readonly fields = new Map();\n private readonly additional: AdditionalDataFields = {};\n private tip: TipMode | undefined;\n private personalMessage: string | undefined;\n private promptPayRecipient: NormalisedRecipient | undefined;\n private otaCode: string | undefined;\n private vat: VATTQRCInput | undefined;\n\n constructor() {\n this.fields.set(TAG_PAYLOAD_FORMAT, PAYLOAD_FORMAT_VERSION);\n this.fields.set(TAG_POINT_OF_INITIATION, POI_STATIC);\n this.fields.set(TAG_COUNTRY_CODE, COUNTRY_TH);\n this.fields.set(TAG_TRANSACTION_CURRENCY, CURRENCY_THB);\n }\n\n /**\n * Configure a PromptPay recipient (mobile, national ID, or e-wallet).\n * Overrides any previously-set BillPayment / KShop template. Use\n * `.bankAccount()` for credit-transfer payloads — its wire value needs\n * the (bankCode, accountNo) split this single-string form cannot carry.\n */\n promptpay(recipient: string, type?: PromptPayRecipientType): this {\n if (type === 'bankAccount') {\n throw new TypeError('Use .bankAccount(bankCode, accountNo) for bank-account recipients');\n }\n this.promptPayRecipient = normaliseRecipient(recipient, type);\n this.refreshPromptPayTemplate();\n this.fields.delete(TAG_MERCHANT_ACCOUNT_BILL_PAYMENT);\n return this;\n }\n\n /**\n * Configure a PromptPay credit transfer to a bank account (sub-tag 04).\n * `bankCode` is the 3-digit BoT bank identifier; `accountNo` is the\n * variable-length numeric account.\n *\n * @example\n * new ThaiQRPaymentBuilder().bankAccount('014', '1234567890').amount(100).build()\n */\n bankAccount(bankCode: string, accountNo: string): this {\n this.promptPayRecipient = normaliseBankAccount(bankCode, accountNo);\n this.refreshPromptPayTemplate();\n this.fields.delete(TAG_MERCHANT_ACCOUNT_BILL_PAYMENT);\n return this;\n }\n\n /**\n * Attach a One-Time Authorization code (sub-tag 05, fixed 10 chars).\n * Flips the merchant template's AID from the standard PromptPay GUID to\n * the OTA GUID so scanners route the payload to the single-use flow.\n *\n * @example\n * new ThaiQRPaymentBuilder().promptpay('0812345678').ota('1234567890').amount(50).build()\n */\n ota(otaCode: string): this {\n if (otaCode.length !== OTA_CODE_LENGTH) {\n throw new RangeError(`OTA code must be ${OTA_CODE_LENGTH} chars, got ${otaCode.length}`);\n }\n this.otaCode = otaCode;\n this.refreshPromptPayTemplate();\n return this;\n }\n\n /** Re-emit tag 29 from the current recipient + OTA state. */\n private refreshPromptPayTemplate(): void {\n if (this.promptPayRecipient == null) return;\n const aid = this.otaCode != null ? GUID_PROMPTPAY_OTA : GUID_PROMPTPAY;\n const template = encodeFields([\n [SUB_GUID, aid],\n [this.promptPayRecipient.subTag, this.promptPayRecipient.value],\n [SUB_PROMPTPAY_OTA, this.otaCode],\n ]);\n this.fields.set(TAG_MERCHANT_ACCOUNT_PROMPTPAY, template);\n }\n\n /**\n * Configure a TrueMoney Wallet recipient. Same merchant template tag\n * (29) as PromptPay but with the literal `14` prefix on sub-tag 03 so\n * the TrueMoney app can disambiguate its own payloads from a plain\n * e-wallet QR. The mobile is zero-padded on the left to 13 digits\n * before the prefix is added (final value length is always 15).\n *\n * The optional `message` is carried in tag 81 (UTF-16BE hex) and is\n * surfaced inside the TrueMoney app only; other scanners ignore it.\n */\n trueMoney(mobileNo: string, options: { amount?: number; message?: string } = {}): this {\n const digits = mobileNo.replace(/\\D/g, '');\n if (digits.length === 0) {\n throw new TypeError('TrueMoney mobile number must contain at least one digit');\n }\n if (digits.length > 13) {\n throw new RangeError(`TrueMoney mobile number too long (${digits.length} digits)`);\n }\n const wireMobile = TRUE_MONEY_PREFIX + digits.padStart(13, '0');\n const template = encodeFields([\n [SUB_GUID, GUID_PROMPTPAY],\n [SUB_TRUE_MONEY, wireMobile],\n ]);\n this.fields.set(TAG_MERCHANT_ACCOUNT_PROMPTPAY, template);\n this.fields.delete(TAG_MERCHANT_ACCOUNT_BILL_PAYMENT);\n this.promptPayRecipient = undefined;\n this.otaCode = undefined;\n this.personalMessage = options.message;\n if (options.amount != null) {\n this.amount(options.amount);\n } else {\n this.amount(undefined);\n }\n return this;\n }\n\n /**\n * Configure a BillPayment recipient (Cross-Bank BillPayment / R-Bill).\n *\n * Pass `crossBorder: true` to emit the ASEAN-region remittance AID\n * (`A000000677012006`) instead of the domestic one (`A000000677010112`).\n * The template layout is otherwise identical — same sub-tags, same\n * value rules. Pair with the `purposeOfTransaction` additional-data\n * field (tag 62 sub-tag 08), which carries an 18-char triple in this\n * mode: currencyCode (3 digits) + localAmount (13 digits) +\n * countryCode (2 digits). The builder treats that field as opaque;\n * compose / parse the triple at the call site.\n */\n billPayment(input: {\n billerId: string;\n reference1?: string;\n reference2?: string;\n crossBorder?: boolean;\n }): this {\n const aid = input.crossBorder === true ? GUID_BILL_PAYMENT_CROSS_BORDER : GUID_BILL_PAYMENT;\n const template = encodeFields([\n [SUB_GUID, aid],\n [SUB_BILL_BILLER_ID, input.billerId],\n [SUB_BILL_REFERENCE_1, input.reference1],\n [SUB_BILL_REFERENCE_2, input.reference2],\n ]);\n this.fields.set(TAG_MERCHANT_ACCOUNT_BILL_PAYMENT, template);\n this.fields.delete(TAG_MERCHANT_ACCOUNT_PROMPTPAY);\n this.promptPayRecipient = undefined;\n this.otaCode = undefined;\n return this;\n }\n\n /**\n * Set the transaction amount in baht. Pass `{fromSatang: true}` to\n * supply integer satang instead. Omit / pass `undefined` to keep the\n * QR static (the consumer's banking app will prompt for an amount).\n */\n amount(value: number | bigint | undefined, options?: FormatAmountOptions): this {\n const formatted = formatAmount(value, options);\n if (formatted == null) {\n this.fields.delete(TAG_TRANSACTION_AMOUNT);\n this.fields.set(TAG_POINT_OF_INITIATION, POI_STATIC);\n } else {\n this.fields.set(TAG_TRANSACTION_AMOUNT, formatted);\n this.fields.set(TAG_POINT_OF_INITIATION, POI_DYNAMIC);\n }\n return this;\n }\n\n /** Set the tip / convenience-fee policy (tags 55-57). */\n tipPolicy(mode: TipMode | undefined): this {\n this.tip = mode;\n return this;\n }\n\n /** Set merchant display info (tags 52, 59, 60, 61). */\n merchant(info: MerchantInfo): this {\n if (info.categoryCode != null) this.fields.set(TAG_MERCHANT_CATEGORY_CODE, info.categoryCode);\n if (info.name != null) this.fields.set(TAG_MERCHANT_NAME, info.name.slice(0, 25));\n if (info.city != null) this.fields.set(TAG_MERCHANT_CITY, info.city.slice(0, 15));\n if (info.postalCode != null) this.fields.set(TAG_POSTAL_CODE, info.postalCode);\n return this;\n }\n\n /** Set sub-fields of the additional-data template (tag 62). */\n additionalData(fields: AdditionalDataFields): this {\n Object.assign(this.additional, fields);\n return this;\n }\n\n /**\n * Attach the Bank of Thailand VAT TQRC extension (tag 80). Promotes the\n * payment QR to an e-tax-receipt source. Pass `undefined` to clear.\n *\n * Field-length rules come from the BOT extension spec:\n * - `sellerTaxBranchId` is exactly 4 characters\n * - `vatRate` is 1–5 characters when present (e.g. \"7\" or \"7.00\")\n * - `vatAmount` is 1–13 characters and required\n */\n vatTqrc(input: VATTQRCInput | undefined): this {\n if (input == null) {\n this.vat = undefined;\n return this;\n }\n if (input.sellerTaxBranchId.length !== 4) {\n throw new RangeError(\n `VAT TQRC sellerTaxBranchId must be exactly 4 chars (got ${input.sellerTaxBranchId.length})`,\n );\n }\n if (input.vatRate != null && (input.vatRate.length < 1 || input.vatRate.length > 5)) {\n throw new RangeError(`VAT TQRC vatRate must be 1–5 chars (got ${input.vatRate.length})`);\n }\n if (input.vatAmount.length < 1 || input.vatAmount.length > 13) {\n throw new RangeError(`VAT TQRC vatAmount must be 1–13 chars (got ${input.vatAmount.length})`);\n }\n this.vat = { ...input };\n return this;\n }\n\n /** Force the point-of-initiation flag regardless of amount presence. */\n pointOfInitiation(method: 'static' | 'dynamic'): this {\n this.fields.set(TAG_POINT_OF_INITIATION, method === 'static' ? POI_STATIC : POI_DYNAMIC);\n return this;\n }\n\n /** Compose the additional-data template if any sub-fields are set. */\n private composeAdditionalData(): string | null {\n const pairs: ReadonlyArray = [\n [SUB_ADD_BILL_NUMBER, this.additional.billNumber],\n [SUB_ADD_MOBILE_NUMBER, this.additional.mobileNumber],\n [SUB_ADD_STORE_LABEL, this.additional.storeLabel],\n [SUB_ADD_LOYALTY_NUMBER, this.additional.loyaltyNumber],\n [SUB_ADD_REFERENCE_LABEL, this.additional.referenceLabel],\n [SUB_ADD_CUSTOMER_LABEL, this.additional.customerLabel],\n [SUB_ADD_TERMINAL_LABEL, this.additional.terminalLabel],\n [SUB_ADD_PURPOSE_OF_TRANSACTION, this.additional.purposeOfTransaction],\n [SUB_ADD_CONSUMER_DATA_REQUEST, this.additional.consumerDataRequest],\n ];\n const body = encodeFields(pairs);\n return body === '' ? null : body;\n }\n\n /** Apply the tip policy to tags 55-57 just before emit. */\n private applyTip(): void {\n if (this.tip == null) {\n this.fields.delete(TAG_TIP_OR_CONVENIENCE_INDICATOR);\n this.fields.delete(TAG_TIP_FIXED);\n this.fields.delete(TAG_TIP_PERCENTAGE);\n return;\n }\n switch (this.tip.mode) {\n case 'prompt':\n this.fields.set(TAG_TIP_OR_CONVENIENCE_INDICATOR, TIP_PROMPT);\n this.fields.delete(TAG_TIP_FIXED);\n this.fields.delete(TAG_TIP_PERCENTAGE);\n break;\n case 'fixed': {\n const formatted = formatAmount(this.tip.value, { fromSatang: this.tip.fromSatang });\n if (formatted == null) {\n throw new TypeError('Tip fixed amount must be positive');\n }\n this.fields.set(TAG_TIP_OR_CONVENIENCE_INDICATOR, TIP_FIXED);\n this.fields.set(TAG_TIP_FIXED, formatted);\n this.fields.delete(TAG_TIP_PERCENTAGE);\n break;\n }\n case 'percentage':\n this.fields.set(TAG_TIP_OR_CONVENIENCE_INDICATOR, TIP_PERCENTAGE);\n this.fields.set(TAG_TIP_PERCENTAGE, this.tip.value.toFixed(2));\n this.fields.delete(TAG_TIP_FIXED);\n break;\n }\n }\n\n /** Render the full wire-format payload with checksum appended. */\n build(): string {\n this.applyTip();\n const additional = this.composeAdditionalData();\n if (additional != null) {\n this.fields.set(TAG_ADDITIONAL_DATA, additional);\n } else {\n this.fields.delete(TAG_ADDITIONAL_DATA);\n }\n if (this.personalMessage != null && this.personalMessage !== '') {\n this.fields.set(TAG_PERSONAL_MESSAGE, encodePersonalMessage(this.personalMessage));\n } else {\n this.fields.delete(TAG_PERSONAL_MESSAGE);\n }\n if (this.vat != null) {\n // Sub-tag order inside tag 80 is 00 → 01 → 02 per the BOT\n // supplement; `encodeFields` drops the optional rate cleanly.\n this.fields.set(\n TAG_VAT_TQRC,\n encodeFields([\n [SUB_VAT_SELLER_TAX_BRANCH_ID, this.vat.sellerTaxBranchId],\n [SUB_VAT_RATE, this.vat.vatRate],\n [SUB_VAT_AMOUNT, this.vat.vatAmount],\n ]),\n );\n } else {\n this.fields.delete(TAG_VAT_TQRC);\n }\n\n // Spec mandates ascending tag order on the wire. Map iteration\n // preserves insertion order, so we sort explicitly here instead.\n // Tag 80 (VAT TQRC) sorts naturally after tag 64; the CRC tag 63 is\n // appended below regardless of sort order so it always lands last.\n const sorted = [...this.fields.entries()]\n .filter(([tag]) => tag !== TAG_CHECKSUM)\n .toSorted(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n\n let body = '';\n for (const [tag, value] of sorted) {\n body += encodeField(tag, value);\n }\n\n // The CRC is taken over `body + \"6304\"` — the tag header for the\n // checksum is part of the hashed input. Off-by-one if you miss it.\n const seed = body + TAG_CHECKSUM + '04';\n return seed + checksum(seed);\n }\n\n /** Render and split the body/CRC for inspection. */\n buildWithChecksum(): { body: string; checksum: string; payload: string } {\n const payload = this.build();\n return {\n body: payload.slice(0, -4),\n checksum: payload.slice(-4),\n payload,\n };\n }\n\n /** UTF-8 byte view of the payload — useful for hashing or transport. */\n toBytes(): Uint8Array {\n const text = this.build();\n const out = new Uint8Array(text.length);\n for (let i = 0; i < text.length; i += 1) {\n out[i] = text.charCodeAt(i) & 0xff;\n }\n return out;\n }\n}\n","/**\n * CRC-16/CCITT-FALSE — the variant mandated by EMVCo MPM §4 for the\n * trailing checksum tag (poly 0x1021, init 0xFFFF, no reflect, no XOR out).\n *\n * Table-driven implementation: pre-compute the 256-entry lookup at module\n * load, then xor-shift one byte per loop iteration. Roughly 4× faster than\n * the per-bit loop for typical payload sizes (~120-180 chars), and the\n * 512-byte table is dwarfed by the JS function objects around it.\n */\n\nconst CRC_TABLE: Uint16Array = (() => {\n const table = new Uint16Array(256);\n for (let byte = 0; byte < 256; byte += 1) {\n let acc = byte << 8;\n for (let bit = 0; bit < 8; bit += 1) {\n acc = (acc & 0x8000) !== 0 ? ((acc << 1) ^ 0x1021) & 0xffff : (acc << 1) & 0xffff;\n }\n table[byte] = acc;\n }\n return table;\n})();\n\n/**\n * Compute the CRC-16/CCITT-FALSE checksum of an ASCII-encoded payload\n * and return it as a 4-character uppercase hex string. The EMVCo spec\n * requires the trailing zero-padding to keep the QR payload length stable.\n */\nexport function checksum(input: string): string {\n let acc = 0xffff;\n for (let i = 0; i < input.length; i += 1) {\n const byte = input.charCodeAt(i) & 0xff;\n acc = ((acc << 8) ^ (CRC_TABLE[(acc >> 8) ^ byte] ?? 0)) & 0xffff;\n }\n return acc.toString(16).toUpperCase().padStart(4, '0');\n}\n","/**\n * `@thai-qr-payment/payload` — public surface.\n *\n * Wire-format helpers for the Thai QR Payment EMVCo MPM standard. Zero\n * runtime dependencies; works in browsers, Node, Bun, Deno, and edge\n * runtimes (Cloudflare Workers, Vercel Edge, Netlify, Deno Deploy).\n */\n\nexport { ThaiQRPaymentBuilder } from './builder.js';\nexport type { AdditionalDataFields, MerchantInfo, TipMode, VATTQRCInput } from './builder.js';\n\nexport { parsePayload } from './parser.js';\nexport type {\n ParsedAdditionalData,\n ParsedBillPayment,\n ParsedCRC,\n ParsedPayload,\n ParsedPromptPay,\n ParsedTrueMoney,\n ParsedVATTQRC,\n ParsePayloadOptions,\n} from './parser.js';\n\nexport { normaliseBankAccount, normaliseRecipient } from './recipient.js';\nexport type { NormalisedRecipient, PromptPayRecipientType } from './recipient.js';\n\nexport { formatAmount } from './amount.js';\nexport type { FormatAmountOptions } from './amount.js';\n\nexport { checksum } from './crc.js';\n\nexport { decodePersonalMessage, encodePersonalMessage } from './message.js';\n\nexport {\n buildSlipVerify,\n buildTrueMoneySlipVerify,\n parseSlipVerify,\n parseTrueMoneySlipVerify,\n} from './slip-verify.js';\nexport type {\n ParsedSlipVerify,\n ParsedTrueMoneySlipVerify,\n SlipVerifyInput,\n TrueMoneySlipVerifyInput,\n} from './slip-verify.js';\n\nexport { buildBOTBarcode, parseBOTBarcode } from './barcode.js';\nexport type { BOTBarcodeInput, ParsedBOTBarcode } from './barcode.js';\n\nexport { encodeField, encodeFields, parseFields, iterateFields } from './tlv.js';\nexport type { TLVField } from './tlv.js';\n\nexport * as Tags from './tags.js';\n\nimport { ThaiQRPaymentBuilder } from './builder.js';\nimport type { PromptPayRecipientType } from './recipient.js';\nimport type { FormatAmountOptions } from './amount.js';\n\n/**\n * Shorthand for the common \"make me a PromptPay QR for this recipient\n * with this amount\" use case. Returns the wire payload string.\n *\n * @example\n * payloadFor({ recipient: '0812345678', amount: 100 })\n * // → '00020101021229370016A00000067701011101130066812345678530376454...'\n */\nexport function payloadFor(input: {\n recipient: string;\n amount?: number;\n type?: PromptPayRecipientType;\n fromSatang?: boolean;\n}): string {\n const opts: FormatAmountOptions | undefined = input.fromSatang ? { fromSatang: true } : undefined;\n return new ThaiQRPaymentBuilder()\n .promptpay(input.recipient, input.type)\n .amount(input.amount, opts)\n .build();\n}\n","/**\n * Personal-message codec for tag 81 (TrueMoney Wallet).\n *\n * The wire format is the UTF-16BE encoding of the message, expressed as\n * uppercase hex. Each Unicode code unit becomes 4 hex chars; `Hello` →\n * `00480065006C006C006F`. Length on the TLV header counts the hex chars,\n * not the source characters.\n *\n * Browser/edge-safe — no `node:buffer` reach-through.\n */\n\n/** Encode a personal message string to UTF-16BE hex (uppercase). */\nexport function encodePersonalMessage(message: string): string {\n let out = '';\n for (let i = 0; i < message.length; i += 1) {\n const code = message.charCodeAt(i);\n out += code.toString(16).padStart(4, '0').toUpperCase();\n }\n return out;\n}\n\n/** Decode a UTF-16BE hex string back to its source message. */\nexport function decodePersonalMessage(hex: string): string {\n if (hex.length % 4 !== 0) {\n throw new SyntaxError(`Personal-message hex must be a multiple of 4 chars; got ${hex.length}`);\n }\n let out = '';\n for (let i = 0; i < hex.length; i += 4) {\n const unit = Number.parseInt(hex.slice(i, i + 4), 16);\n if (!Number.isFinite(unit)) {\n throw new SyntaxError(`Invalid hex unit \"${hex.slice(i, i + 4)}\" at offset ${i}`);\n }\n out += String.fromCharCode(unit);\n }\n return out;\n}\n","/**\n * Decoder for Thai QR Payment wire payloads.\n *\n * Validates the trailing CRC, walks the TLV tree, and surfaces a typed\n * view of the merchant template + amount + additional-data sub-fields.\n * Useful for tests, debugging, and reading back QR codes captured by a\n * scanner.\n *\n * Two non-obvious behaviours live here:\n * - `strict` opt-in surfaces a CRC failure as an exception instead of a\n * silent pass; older code without the flag stays backwards-compatible.\n * - Truncated-CRC auto-fix recovers payloads that some Thai banking\n * apps emit with the last 1–2 hex chars chopped off. We left-pad the\n * chopped value with zeros and accept it if the result hashes back to\n * the same body. The flag survives on the parsed object so callers\n * can warn the user about the source app's bug.\n */\n\nimport { checksum } from './crc.js';\nimport { decodePersonalMessage } from './message.js';\nimport type { PromptPayRecipientType } from './recipient.js';\nimport {\n COUNTRY_TH,\n CURRENCY_THB,\n GUID_BILL_PAYMENT,\n GUID_BILL_PAYMENT_CROSS_BORDER,\n GUID_PROMPTPAY,\n GUID_PROMPTPAY_OTA,\n POI_DYNAMIC,\n SUB_ADD_BILL_NUMBER,\n SUB_ADD_CONSUMER_DATA_REQUEST,\n SUB_ADD_CUSTOMER_LABEL,\n SUB_ADD_LOYALTY_NUMBER,\n SUB_ADD_MOBILE_NUMBER,\n SUB_ADD_PURPOSE_OF_TRANSACTION,\n SUB_ADD_REFERENCE_LABEL,\n SUB_ADD_STORE_LABEL,\n SUB_ADD_TERMINAL_LABEL,\n SUB_BILL_BILLER_ID,\n SUB_BILL_REFERENCE_1,\n SUB_BILL_REFERENCE_2,\n SUB_GUID,\n SUB_PROMPTPAY_BANK_ACCOUNT,\n SUB_PROMPTPAY_EWALLET,\n SUB_PROMPTPAY_MOBILE,\n SUB_PROMPTPAY_NATIONAL_ID,\n SUB_PROMPTPAY_OTA,\n SUB_TRUE_MONEY,\n SUB_VAT_AMOUNT,\n SUB_VAT_RATE,\n SUB_VAT_SELLER_TAX_BRANCH_ID,\n TAG_ADDITIONAL_DATA,\n TAG_CHECKSUM,\n TAG_COUNTRY_CODE,\n TAG_MERCHANT_ACCOUNT_BILL_PAYMENT,\n TAG_MERCHANT_ACCOUNT_PROMPTPAY,\n TAG_MERCHANT_CATEGORY_CODE,\n TAG_MERCHANT_CITY,\n TAG_MERCHANT_NAME,\n TAG_PAYLOAD_FORMAT,\n TAG_PERSONAL_MESSAGE,\n TAG_POINT_OF_INITIATION,\n TAG_POSTAL_CODE,\n TAG_TRANSACTION_AMOUNT,\n TAG_TRANSACTION_CURRENCY,\n TAG_VAT_TQRC,\n TRUE_MONEY_PREFIX,\n} from './tags.js';\nimport { iterateFields, parseFields, type TLVField } from './tlv.js';\n\nconst BANK_CODE_LENGTH = 3;\n\nexport interface ParsedPromptPay {\n readonly kind: 'promptpay';\n readonly recipientType: PromptPayRecipientType;\n /**\n * Wire value for the recipient sub-tag. For `bankAccount` this is the\n * full `bankCode + accountNo` concatenation — split fields are exposed\n * separately below.\n */\n readonly recipient: string;\n /** Bank code (3 digits). Present only when `recipientType === 'bankAccount'`. */\n readonly bankCode?: string;\n /** Account number. Present only when `recipientType === 'bankAccount'`. */\n readonly accountNo?: string;\n /** One-Time Authorization code from sub-tag 05. Present only on OTA payloads. */\n readonly ota?: string;\n}\n\nexport interface ParsedBillPayment {\n readonly kind: 'billPayment';\n readonly billerId: string;\n readonly reference1?: string;\n readonly reference2?: string;\n /**\n * `true` when the merchant template uses the ASEAN cross-border AID\n * (`A000000677012006`). In that mode the `purposeOfTransaction` field\n * (tag 62 sub-tag 08) carries an 18-char triple of currency + local\n * amount + country; the parser surfaces it verbatim under\n * `additionalData.purposeOfTransaction`.\n */\n readonly crossBorder: boolean;\n}\n\nexport interface ParsedTrueMoney {\n readonly kind: 'trueMoney';\n readonly mobileNo: string;\n readonly message?: string;\n}\n\nexport interface ParsedAdditionalData {\n billNumber?: string;\n mobileNumber?: string;\n storeLabel?: string;\n loyaltyNumber?: string;\n referenceLabel?: string;\n customerLabel?: string;\n terminalLabel?: string;\n purposeOfTransaction?: string;\n consumerDataRequest?: string;\n}\n\n/** Decoded VAT TQRC template (tag 80). */\nexport interface ParsedVATTQRC {\n readonly sellerTaxBranchId: string;\n readonly vatRate?: string;\n readonly vatAmount: string;\n}\n\n/** Bookkeeping for the trailing checksum — useful when reporting auto-fix. */\nexport interface ParsedCRC {\n /** The CRC text as it appeared on the wire (may be 1–4 chars). */\n readonly value: string;\n /** True when the wire CRC matches the recomputed value (possibly after padding). */\n readonly valid: boolean;\n /** True when zero-padding was needed to recover a valid CRC. */\n readonly truncated: boolean;\n}\n\nexport interface ParsedPayload {\n readonly payloadFormat: string;\n readonly pointOfInitiation: 'static' | 'dynamic';\n readonly merchant: ParsedPromptPay | ParsedBillPayment | ParsedTrueMoney | null;\n readonly amount: number | null;\n readonly currency: string;\n readonly country: string;\n readonly merchantName?: string;\n readonly merchantCity?: string;\n readonly merchantCategoryCode?: string;\n readonly postalCode?: string;\n readonly additionalData?: ParsedAdditionalData;\n readonly vatTqrc?: ParsedVATTQRC;\n readonly crc: ParsedCRC;\n /** All top-level TLV fields, in wire order. Use for unknown / future tags. */\n readonly rawTags: readonly TLVField[];\n /** Lookup a top-level TLV field by id. Returns `undefined` if absent. */\n getTag(id: string): TLVField | undefined;\n /**\n * Lookup a value by id. Pass `subId` to descend one level into a nested\n * template (tags 29–31, 62, 64 are templated). Returns `undefined` if\n * either the parent or the sub-field is missing.\n */\n getTagValue(id: string, subId?: string): string | undefined;\n}\n\nexport interface ParsePayloadOptions {\n /**\n * When true, throw if the CRC tag is missing or its on-wire value\n * doesn't match the recomputed checksum. Defaults to false for\n * backwards compatibility with callers that need to consume the\n * truncated-CRC auto-fix path.\n */\n readonly strict?: boolean;\n}\n\n/** Recover the human-readable mobile (drop the `0066` prefix and re-add `0`). */\nfunction fromMobileWire(wire: string): string {\n // Wire: 13-char zero-padded, starts with 0066 for THB. Strip leading\n // zeros, drop the 66 country code, prepend a 0.\n const trimmed = wire.replace(/^0+/, '');\n if (trimmed.startsWith('66')) return `0${trimmed.slice(2)}`;\n return trimmed;\n}\n\n/** Reverse the TrueMoney mobile-wire transform (drop `14` + restore the leading 0). */\nfunction fromTrueMoneyWire(wire: string): string {\n // Wire layout: \"14\" + 13-char zero-padded mobile. Thai mobiles\n // canonically start with a leading 0, so strip the zero-padding and\n // re-add the 0 the same way `fromMobileWire` does for PromptPay.\n const trimmed = wire.slice(TRUE_MONEY_PREFIX.length).replace(/^0+/, '');\n return trimmed === '' ? '0' : `0${trimmed}`;\n}\n\nfunction parsePromptPayTemplate(template: string): ParsedPromptPay | null {\n const sub = parseFields(template);\n const guid = sub.get(SUB_GUID);\n // OTA payloads use the `…0114` AID; everything else rides the standard\n // PromptPay `…0111` AID. The AID is the sole discriminator — sub-tags\n // 01-04 carry the same recipient shapes in either envelope.\n const isOta = guid === GUID_PROMPTPAY_OTA;\n if (guid !== GUID_PROMPTPAY && !isOta) return null;\n const ota = isOta ? sub.get(SUB_PROMPTPAY_OTA) : undefined;\n\n const bankAccount = sub.get(SUB_PROMPTPAY_BANK_ACCOUNT);\n if (bankAccount != null) {\n return {\n kind: 'promptpay',\n recipientType: 'bankAccount',\n recipient: bankAccount,\n bankCode: bankAccount.slice(0, BANK_CODE_LENGTH),\n accountNo: bankAccount.slice(BANK_CODE_LENGTH),\n ...(ota != null ? { ota } : {}),\n };\n }\n const mobile = sub.get(SUB_PROMPTPAY_MOBILE);\n if (mobile != null) {\n return {\n kind: 'promptpay',\n recipientType: 'mobile',\n recipient: fromMobileWire(mobile),\n ...(ota != null ? { ota } : {}),\n };\n }\n const nationalId = sub.get(SUB_PROMPTPAY_NATIONAL_ID);\n if (nationalId != null) {\n return {\n kind: 'promptpay',\n recipientType: 'nationalId',\n recipient: nationalId,\n ...(ota != null ? { ota } : {}),\n };\n }\n const eWallet = sub.get(SUB_PROMPTPAY_EWALLET);\n if (eWallet != null) {\n return {\n kind: 'promptpay',\n recipientType: 'eWallet',\n recipient: eWallet,\n ...(ota != null ? { ota } : {}),\n };\n }\n return null;\n}\n\nfunction parseTrueMoneyTemplate(template: string): ParsedTrueMoney | null {\n const sub = parseFields(template);\n const guid = sub.get(SUB_GUID);\n if (guid !== GUID_PROMPTPAY) return null;\n const wireValue = sub.get(SUB_TRUE_MONEY);\n if (wireValue == null) return null;\n if (!wireValue.startsWith(TRUE_MONEY_PREFIX)) return null;\n return { kind: 'trueMoney', mobileNo: fromTrueMoneyWire(wireValue) };\n}\n\nfunction parseBillPaymentTemplate(template: string): ParsedBillPayment | null {\n const sub = parseFields(template);\n const guid = sub.get(SUB_GUID);\n // Two recognised AIDs: domestic and cross-border (ASEAN remittance).\n // Anything else is an unknown AID — return null so the parser leaves\n // `merchant` as null, matching how the PromptPay branch handles a\n // strange GUID.\n let crossBorder: boolean;\n if (guid === GUID_BILL_PAYMENT) {\n crossBorder = false;\n } else if (guid === GUID_BILL_PAYMENT_CROSS_BORDER) {\n crossBorder = true;\n } else {\n return null;\n }\n const billerId = sub.get(SUB_BILL_BILLER_ID);\n if (billerId == null) return null;\n return {\n kind: 'billPayment',\n billerId,\n reference1: sub.get(SUB_BILL_REFERENCE_1) ?? undefined,\n reference2: sub.get(SUB_BILL_REFERENCE_2) ?? undefined,\n crossBorder,\n };\n}\n\nfunction parseAdditionalDataTemplate(template: string): ParsedAdditionalData {\n const sub = parseFields(template);\n return {\n billNumber: sub.get(SUB_ADD_BILL_NUMBER),\n mobileNumber: sub.get(SUB_ADD_MOBILE_NUMBER),\n storeLabel: sub.get(SUB_ADD_STORE_LABEL),\n loyaltyNumber: sub.get(SUB_ADD_LOYALTY_NUMBER),\n referenceLabel: sub.get(SUB_ADD_REFERENCE_LABEL),\n customerLabel: sub.get(SUB_ADD_CUSTOMER_LABEL),\n terminalLabel: sub.get(SUB_ADD_TERMINAL_LABEL),\n purposeOfTransaction: sub.get(SUB_ADD_PURPOSE_OF_TRANSACTION),\n consumerDataRequest: sub.get(SUB_ADD_CONSUMER_DATA_REQUEST),\n };\n}\n\n/**\n * Parse the VAT TQRC template (tag 80). Returns `null` when the required\n * `vatAmount` sub-tag (02) is absent — callers in strict mode escalate\n * that to an exception, lax callers surface it as `vatTqrc: undefined`.\n */\nfunction parseVatTqrcTemplate(template: string): ParsedVATTQRC | null {\n const sub = parseFields(template);\n const sellerTaxBranchId = sub.get(SUB_VAT_SELLER_TAX_BRANCH_ID);\n const vatAmount = sub.get(SUB_VAT_AMOUNT);\n if (sellerTaxBranchId == null || vatAmount == null) return null;\n const vatRate = sub.get(SUB_VAT_RATE);\n return vatRate != null\n ? { sellerTaxBranchId, vatRate, vatAmount }\n : { sellerTaxBranchId, vatAmount };\n}\n\n/**\n * Split off the CRC. Returns the canonical (possibly zero-padded) wire\n * representation when an auto-fix landed; downstream TLV parsing always\n * sees a well-formed `6304XXXX` tail so it never needs to special-case\n * the truncated path.\n */\nfunction extractCrc(payload: string, strict: boolean): { canonical: string; crc: ParsedCRC } {\n // Standard case: payload ends with \"6304XXXX\" where XXXX is the CRC.\n // Verify first because it's the >99% path.\n const fullCrc = payload.slice(-4);\n const fullSeed = payload.slice(0, -4);\n if (fullSeed.endsWith(TAG_CHECKSUM + '04')) {\n const expected = checksum(fullSeed);\n if (expected === fullCrc) {\n return {\n canonical: payload,\n crc: { value: fullCrc, valid: true, truncated: false },\n };\n }\n if (strict) {\n throw new Error('Invalid CRC');\n }\n }\n\n // Truncated-CRC fallback: walk back 1, 2, 3 chars and try padding the\n // tail with leading zeros. The seed includes the `6304` header per the\n // EMVCo spec, so it stays constant and only the value grows back.\n if (!strict) {\n for (let dropped = 1; dropped <= 3; dropped += 1) {\n const candidateEnd = payload.length - (4 - dropped);\n const candidateSeed = payload.slice(0, candidateEnd);\n if (!candidateSeed.endsWith(TAG_CHECKSUM + '04')) continue;\n const wireCrc = payload.slice(candidateEnd);\n const padded = wireCrc.padStart(4, '0');\n if (checksum(candidateSeed) === padded) {\n return {\n canonical: candidateSeed + padded,\n crc: { value: wireCrc, valid: true, truncated: true },\n };\n }\n }\n }\n\n if (strict) {\n throw new Error('Invalid CRC');\n }\n\n // Non-strict fall-through: surface the original checksum-mismatch\n // error for backwards compatibility with the previous parser.\n throw new Error(\n `Checksum mismatch: payload trails \"${fullCrc}\" but recomputes to \"${checksum(fullSeed)}\"`,\n );\n}\n\n/**\n * Parse a wire-format payload. By default throws on structural errors or\n * a hard checksum mismatch (with truncated-CRC auto-fix applied when\n * possible). In `strict: true` mode also throws when the CRC tag is\n * missing or its value fails to match.\n */\nexport function parsePayload(payload: string, options: ParsePayloadOptions = {}): ParsedPayload {\n if (payload.length < 8) {\n throw new SyntaxError(\n `Payload too short (${payload.length} chars); not a Thai QR Payment string`,\n );\n }\n\n const strict = options.strict === true;\n const { canonical, crc } = extractCrc(payload, strict);\n\n // Iterate the canonical (possibly zero-padded) payload so rawTags\n // reflect what the spec says the merchant intended, not the truncated\n // wire byte-for-byte. Tag 63 still appears in rawTags for completeness.\n const rawTags = [...iterateFields(canonical)];\n const root = new Map();\n for (const field of rawTags) {\n if (field.tag !== TAG_CHECKSUM) root.set(field.tag, field.value);\n }\n\n const promptpayTemplate = root.get(TAG_MERCHANT_ACCOUNT_PROMPTPAY);\n const billPaymentTemplate = root.get(TAG_MERCHANT_ACCOUNT_BILL_PAYMENT);\n let merchant: ParsedPromptPay | ParsedBillPayment | ParsedTrueMoney | null = null;\n if (promptpayTemplate != null) {\n // TrueMoney rides on the same AID as PromptPay; the literal \"14\"\n // prefix on sub-tag 03 is the disambiguator.\n merchant =\n parseTrueMoneyTemplate(promptpayTemplate) ?? parsePromptPayTemplate(promptpayTemplate);\n } else if (billPaymentTemplate != null) {\n merchant = parseBillPaymentTemplate(billPaymentTemplate);\n }\n\n // Personal message lives at tag 81 — TrueMoney's only place to put a\n // human-readable note. Other wallets ignore it.\n let trueMoneyWithMessage: ParsedTrueMoney | null = null;\n if (merchant != null && merchant.kind === 'trueMoney') {\n const messageHex = root.get(TAG_PERSONAL_MESSAGE);\n if (messageHex != null && messageHex !== '') {\n try {\n trueMoneyWithMessage = { ...merchant, message: decodePersonalMessage(messageHex) };\n } catch {\n // Malformed message hex shouldn't kill the whole parse — drop\n // silently and surface via `rawTags` for callers that care.\n }\n }\n }\n\n const amountText = root.get(TAG_TRANSACTION_AMOUNT);\n const additional = root.get(TAG_ADDITIONAL_DATA);\n const vatTemplate = root.get(TAG_VAT_TQRC);\n let vatTqrc: ParsedVATTQRC | undefined;\n if (vatTemplate != null) {\n const decoded = parseVatTqrcTemplate(vatTemplate);\n if (decoded == null && strict) {\n throw new Error('VAT TQRC template is missing required sub-tags');\n }\n vatTqrc = decoded ?? undefined;\n }\n\n const result: ParsedPayload = {\n payloadFormat: root.get(TAG_PAYLOAD_FORMAT) ?? '',\n pointOfInitiation: root.get(TAG_POINT_OF_INITIATION) === POI_DYNAMIC ? 'dynamic' : 'static',\n merchant: trueMoneyWithMessage ?? merchant,\n amount: amountText != null ? Number.parseFloat(amountText) : null,\n currency: root.get(TAG_TRANSACTION_CURRENCY) ?? CURRENCY_THB,\n country: root.get(TAG_COUNTRY_CODE) ?? COUNTRY_TH,\n merchantName: root.get(TAG_MERCHANT_NAME),\n merchantCity: root.get(TAG_MERCHANT_CITY),\n merchantCategoryCode: root.get(TAG_MERCHANT_CATEGORY_CODE),\n postalCode: root.get(TAG_POSTAL_CODE),\n additionalData: additional != null ? parseAdditionalDataTemplate(additional) : undefined,\n vatTqrc,\n crc,\n rawTags,\n getTag(id: string): TLVField | undefined {\n for (const field of rawTags) {\n if (field.tag === id) return field;\n }\n return undefined;\n },\n getTagValue(id: string, subId?: string): string | undefined {\n const parent = this.getTag(id);\n if (parent == null) return undefined;\n if (subId == null) return parent.value;\n for (const sub of iterateFields(parent.value)) {\n if (sub.tag === subId) return sub.value;\n }\n return undefined;\n },\n };\n return result;\n}\n","/**\n * Recipient normalisation for the PromptPay merchant template.\n *\n * The wire format under tag 29 has four sub-tags (01 phone, 02 national\n * ID, 03 e-wallet, 04 bank account). The expected length determines which\n * sub-tag a single-string recipient lands in, and phone numbers get the\n * country prefix swap `0` → `66`. Bank account values are composed from\n * two pieces (bank code + account number) and have their own helper.\n */\n\nimport {\n SUB_PROMPTPAY_BANK_ACCOUNT,\n SUB_PROMPTPAY_EWALLET,\n SUB_PROMPTPAY_MOBILE,\n SUB_PROMPTPAY_NATIONAL_ID,\n} from './tags.js';\n\nexport type PromptPayRecipientType = 'mobile' | 'nationalId' | 'eWallet' | 'bankAccount';\n\nexport interface NormalisedRecipient {\n readonly subTag:\n | typeof SUB_PROMPTPAY_MOBILE\n | typeof SUB_PROMPTPAY_NATIONAL_ID\n | typeof SUB_PROMPTPAY_EWALLET\n | typeof SUB_PROMPTPAY_BANK_ACCOUNT;\n readonly value: string;\n readonly type: PromptPayRecipientType;\n}\n\nconst BANK_CODE_LENGTH = 3;\nconst BANK_ACCOUNT_MAX_LENGTH = 43;\n\n/** Strip every non-digit character. */\nfunction stripNonDigits(input: string): string {\n let out = '';\n for (let i = 0; i < input.length; i += 1) {\n const code = input.charCodeAt(i);\n if (code >= 0x30 && code <= 0x39) out += input[i];\n }\n return out;\n}\n\n/** Convert a mobile number to the 13-char `0066xxxxxxxxxx` wire form. */\nfunction toMobileWire(digits: string): string {\n // Phones in Thailand are 9-10 digits (e.g. 0812345678). Replace the\n // leading 0 with 66 (Thailand country code), then zero-pad to 13.\n const trimmed = digits.replace(/^0/, '66');\n return trimmed.padStart(13, '0');\n}\n\n/**\n * Decide the recipient type from the digit count, then format the wire\n * value. Explicit `type` arg overrides the inference — useful if a\n * national ID happens to look like a long e-wallet id or vice versa.\n * Pass `'bankAccount'` to `normaliseBankAccount` instead; it needs two\n * pieces (bank code + account number) the single-string form can't carry.\n */\nexport function normaliseRecipient(\n raw: string,\n explicit?: Exclude,\n): NormalisedRecipient {\n const digits = stripNonDigits(raw);\n if (digits.length === 0) {\n throw new TypeError('PromptPay recipient must contain at least one digit');\n }\n\n const inferred: Exclude =\n explicit ?? (digits.length >= 15 ? 'eWallet' : digits.length >= 13 ? 'nationalId' : 'mobile');\n\n switch (inferred) {\n case 'mobile':\n return { subTag: SUB_PROMPTPAY_MOBILE, value: toMobileWire(digits), type: 'mobile' };\n case 'nationalId':\n if (digits.length !== 13) {\n throw new RangeError(`National ID must be 13 digits, got ${digits.length}`);\n }\n return { subTag: SUB_PROMPTPAY_NATIONAL_ID, value: digits, type: 'nationalId' };\n case 'eWallet':\n if (digits.length !== 15) {\n throw new RangeError(`e-Wallet ID must be 15 digits, got ${digits.length}`);\n }\n return { subTag: SUB_PROMPTPAY_EWALLET, value: digits, type: 'eWallet' };\n }\n}\n\n/**\n * Format a bank-account recipient for sub-tag 04 under the PromptPay\n * merchant template. The wire value is the 3-digit bank code followed by\n * the (variable-length, numeric) account number; total length must fit\n * EMVCo's 1–43-character cap on the sub-tag.\n *\n * @example\n * normaliseBankAccount('014', '1234567890')\n * // → { subTag: '04', value: '0141234567890', type: 'bankAccount' }\n */\nexport function normaliseBankAccount(bankCode: string, accountNo: string): NormalisedRecipient {\n const codeDigits = stripNonDigits(bankCode);\n const accountDigits = stripNonDigits(accountNo);\n if (codeDigits.length !== BANK_CODE_LENGTH) {\n throw new RangeError(`Bank code must be ${BANK_CODE_LENGTH} digits, got ${codeDigits.length}`);\n }\n if (accountDigits.length === 0) {\n throw new TypeError('Bank account number must contain at least one digit');\n }\n const value = codeDigits + accountDigits;\n if (value.length > BANK_ACCOUNT_MAX_LENGTH) {\n throw new RangeError(\n `Bank account wire value exceeds ${BANK_ACCOUNT_MAX_LENGTH} chars (got ${value.length})`,\n );\n }\n return { subTag: SUB_PROMPTPAY_BANK_ACCOUNT, value, type: 'bankAccount' };\n}\n","/**\n * Slip Verify Mini-QR — a different envelope from PromptPay payments.\n *\n * Banks print a small \"Mini-QR\" on transfer slips (and inside the PromptPay\n * mobile-app slip view) so an Open API lookup can resolve the transaction\n * after an OCR / scan. The envelope shares the EMVCo TLV grammar but uses\n * its own root tags: a single nested template at tag 00, a country tag 51,\n * and a CRC at tag 91 — not tag 63 like a payment QR. This module wraps\n * the build / parse round-trip for the standard slip-verify shape and the\n * TrueMoney variant (different sub-fields, lowercase CRC hex).\n *\n * The parsers reject any payload that doesn't carry the slip-verify\n * envelope, and tolerate banks that ship a 1-3 character CRC by padding\n * with leading zeros until the checksum matches.\n */\n\nimport { checksum } from './crc.js';\nimport { encodeField, encodeFields, parseFields } from './tlv.js';\n\n// ── Envelope tags shared by both slip-verify variants ───────────────────\nconst TAG_ROOT_TEMPLATE = '00';\nconst TAG_COUNTRY = '51';\nconst TAG_CRC = '91';\n\n// ── Standard slip-verify sub-tags (under root template) ─────────────────\nconst SUB_API_TYPE = '00';\nconst SUB_SENDING_BANK = '01';\nconst SUB_TRANS_REF = '02';\nconst SLIP_VERIFY_API_TYPE = '000001';\nconst COUNTRY_TH = 'TH';\n\n// ── TrueMoney variant sub-tags (under root template) ────────────────────\nconst SUB_TM_MARKER_A = '00';\nconst SUB_TM_MARKER_B = '01';\nconst SUB_TM_EVENT_TYPE = '02';\nconst SUB_TM_TRANSACTION_ID = '03';\nconst SUB_TM_DATE = '04';\nconst TM_MARKER_VALUE = '01';\n\nconst CRC_HEADER = TAG_CRC + '04';\nconst TM_DATE_LENGTH = 8;\n\n/** Input for `buildSlipVerify`. */\nexport interface SlipVerifyInput {\n /** Bank code that issued the slip (e.g. `'002'` for Bangkok Bank). */\n readonly sendingBank: string;\n /** Transaction reference printed on the slip. */\n readonly transRef: string;\n}\n\n/** Decoded payload from `parseSlipVerify`. */\nexport interface ParsedSlipVerify {\n readonly sendingBank: string;\n readonly transRef: string;\n}\n\n/** Input for `buildTrueMoneySlipVerify`. */\nexport interface TrueMoneySlipVerifyInput {\n /** Event classification (e.g. `'P2P'`). */\n readonly eventType: string;\n /** Wallet transaction identifier. */\n readonly transactionId: string;\n /** Transfer date as a `DDMMYYYY` 8-character string. */\n readonly date: string;\n}\n\n/** Decoded payload from `parseTrueMoneySlipVerify`. */\nexport interface ParsedTrueMoneySlipVerify {\n readonly eventType: string;\n readonly transactionId: string;\n readonly date: string;\n}\n\n/**\n * Build a Slip Verify Mini-QR payload. The output is a TLV string ending\n * in a tag-91 CRC (uppercase hex), suitable for embedding in a printed\n * slip and looking the transaction up via bank Open APIs.\n *\n * @example\n * buildSlipVerify({ sendingBank: '002', transRef: '0002123123121200011' })\n * // → '004000060000010103002021900021231231212000115102TH91049C30'\n */\nexport function buildSlipVerify(input: SlipVerifyInput): string {\n const inner = encodeFields([\n [SUB_API_TYPE, SLIP_VERIFY_API_TYPE],\n [SUB_SENDING_BANK, input.sendingBank],\n [SUB_TRANS_REF, input.transRef],\n ]);\n const body = encodeField(TAG_ROOT_TEMPLATE, inner) + encodeField(TAG_COUNTRY, COUNTRY_TH);\n const seed = body + CRC_HEADER;\n return seed + checksum(seed);\n}\n\n/**\n * Parse a Slip Verify Mini-QR payload. Returns `null` for any string that\n * isn't a valid slip-verify envelope — wrong root tag, wrong CRC tag, or\n * checksum mismatch. CRCs of 1-3 hex chars are auto-padded with leading\n * zeros (some bank apps drop characters when re-encoding).\n *\n * @example\n * parseSlipVerify('004000060000010103002021900021231231212000115102TH91049C30')\n * // → { sendingBank: '002', transRef: '0002123123121200011' }\n */\nexport function parseSlipVerify(payload: string): ParsedSlipVerify | null {\n const repaired = repairCrcEnvelope(payload, true);\n if (repaired == null) return null;\n\n let root: Map;\n try {\n root = parseFields(repaired.body);\n } catch {\n return null;\n }\n\n const template = root.get(TAG_ROOT_TEMPLATE);\n if (template == null) return null;\n\n let sub: Map;\n try {\n sub = parseFields(template);\n } catch {\n return null;\n }\n\n if (sub.get(SUB_API_TYPE) !== SLIP_VERIFY_API_TYPE) return null;\n const sendingBank = sub.get(SUB_SENDING_BANK);\n const transRef = sub.get(SUB_TRANS_REF);\n if (sendingBank == null || transRef == null) return null;\n\n return { sendingBank, transRef };\n}\n\n/**\n * Build a TrueMoney Slip Verify Mini-QR payload. Uses the same TLV\n * envelope as the standard variant but with a different sub-tag layout\n * and a **lowercase** hex CRC at tag 91.\n *\n * @example\n * buildTrueMoneySlipVerify({ eventType: 'P2P', transactionId: 'TXN0001234567', date: '25012024' })\n * // → '00480002010102010203P2P0313TXN00012345670408250120249104b425'\n */\nexport function buildTrueMoneySlipVerify(input: TrueMoneySlipVerifyInput): string {\n if (input.date.length !== TM_DATE_LENGTH) {\n throw new RangeError(\n `TrueMoney slip-verify date must be ${TM_DATE_LENGTH} chars (DDMMYYYY); got ${input.date.length}`,\n );\n }\n const inner = encodeFields([\n [SUB_TM_MARKER_A, TM_MARKER_VALUE],\n [SUB_TM_MARKER_B, TM_MARKER_VALUE],\n [SUB_TM_EVENT_TYPE, input.eventType],\n [SUB_TM_TRANSACTION_ID, input.transactionId],\n [SUB_TM_DATE, input.date],\n ]);\n const body = encodeField(TAG_ROOT_TEMPLATE, inner);\n const seed = body + CRC_HEADER;\n return seed + checksum(seed).toLowerCase();\n}\n\n/**\n * Parse a TrueMoney Slip Verify Mini-QR payload. Returns `null` for any\n * string that doesn't carry the TrueMoney marker pair (sub-tags 00 + 01\n * both `'01'`) or whose CRC fails to verify. Comparison is\n * case-insensitive; truncated CRCs (1-3 chars) are auto-padded.\n *\n * @example\n * parseTrueMoneySlipVerify('00480002010102010203P2P0313TXN00012345670408250120249104b425')\n * // → { eventType: 'P2P', transactionId: 'TXN0001234567', date: '25012024' }\n */\nexport function parseTrueMoneySlipVerify(payload: string): ParsedTrueMoneySlipVerify | null {\n const repaired = repairCrcEnvelope(payload, false);\n if (repaired == null) return null;\n\n let root: Map;\n try {\n root = parseFields(repaired.body);\n } catch {\n return null;\n }\n\n const template = root.get(TAG_ROOT_TEMPLATE);\n if (template == null) return null;\n\n let sub: Map;\n try {\n sub = parseFields(template);\n } catch {\n return null;\n }\n\n if (sub.get(SUB_TM_MARKER_A) !== TM_MARKER_VALUE) return null;\n if (sub.get(SUB_TM_MARKER_B) !== TM_MARKER_VALUE) return null;\n const eventType = sub.get(SUB_TM_EVENT_TYPE);\n const transactionId = sub.get(SUB_TM_TRANSACTION_ID);\n const date = sub.get(SUB_TM_DATE);\n if (eventType == null || transactionId == null || date == null) return null;\n\n return { eventType, transactionId, date };\n}\n\n/**\n * Locate the tag-91 CRC at the tail of the payload, repair a truncated\n * checksum (1-3 hex chars get padded with leading zeros until a candidate\n * matches), and return the verified body. Returns `null` if no candidate\n * passes the CRC check.\n *\n * `caseSensitive=true` enforces uppercase hex equality (standard slip\n * verify). `false` lower-cases both sides before comparing (TrueMoney\n * accepts either case on the wire).\n */\nfunction repairCrcEnvelope(payload: string, caseSensitive: boolean): { body: string } | null {\n const headerIdx = payload.lastIndexOf(CRC_HEADER);\n if (headerIdx === -1) return null;\n\n const seedEnd = headerIdx + CRC_HEADER.length;\n const seed = payload.slice(0, seedEnd);\n const tail = payload.slice(seedEnd);\n if (tail.length === 0 || tail.length > 4) return null;\n\n const expected = caseSensitive ? checksum(seed) : checksum(seed).toLowerCase();\n const padded = tail.padStart(4, '0');\n const normalised = caseSensitive ? padded : padded.toLowerCase();\n if (normalised === expected) {\n return { body: payload.slice(0, headerIdx) };\n }\n return null;\n}\n","/**\n * EMVCo Merchant-Presented-Mode QR Code Specification — tag registry.\n *\n * Source: EMVCo MPM v1.1 §3 — public spec; Bank of Thailand and KASIKORN\n * adopt the same numbering with Thai-specific GUIDs under templates 29-31.\n *\n * Tags are stringly-typed (two-character zero-padded decimal) on the wire\n * but exposed here as named constants so call sites stay readable.\n */\n\n// ── Primary tags (root TLVs) ────────────────────────────────────────────\nexport const TAG_PAYLOAD_FORMAT = '00';\nexport const TAG_POINT_OF_INITIATION = '01';\nexport const TAG_MERCHANT_ACCOUNT_PROMPTPAY = '29';\nexport const TAG_MERCHANT_ACCOUNT_BILL_PAYMENT = '30';\nexport const TAG_MERCHANT_ACCOUNT_KSHOP = '31';\nexport const TAG_MERCHANT_CATEGORY_CODE = '52';\nexport const TAG_TRANSACTION_CURRENCY = '53';\nexport const TAG_TRANSACTION_AMOUNT = '54';\nexport const TAG_TIP_OR_CONVENIENCE_INDICATOR = '55';\nexport const TAG_TIP_FIXED = '56';\nexport const TAG_TIP_PERCENTAGE = '57';\nexport const TAG_COUNTRY_CODE = '58';\nexport const TAG_MERCHANT_NAME = '59';\nexport const TAG_MERCHANT_CITY = '60';\nexport const TAG_POSTAL_CODE = '61';\nexport const TAG_ADDITIONAL_DATA = '62';\nexport const TAG_CHECKSUM = '63';\nexport const TAG_LANGUAGE_TEMPLATE = '64';\nexport const TAG_PERSONAL_MESSAGE = '81';\n\n// ── PromptPay merchant template (under tag 29) sub-fields ──────────────\nexport const SUB_GUID = '00';\nexport const SUB_PROMPTPAY_MOBILE = '01';\nexport const SUB_PROMPTPAY_NATIONAL_ID = '02';\nexport const SUB_PROMPTPAY_EWALLET = '03';\nexport const SUB_PROMPTPAY_BANK_ACCOUNT = '04';\nexport const SUB_PROMPTPAY_OTA = '05';\n\n// ── TrueMoney Wallet (also under tag 29, shares the PromptPay AID) ─────\n// Distinguished from PromptPay e-wallet by the literal \"14\" prefix in\n// sub-tag 03's value. The remaining 13 chars are the merchant's mobile,\n// zero-padded on the left.\nexport const SUB_TRUE_MONEY = '03';\nexport const TRUE_MONEY_PREFIX = '14';\n\n// ── BillPayment merchant template (under tag 30) sub-fields ────────────\nexport const SUB_BILL_BILLER_ID = '01';\nexport const SUB_BILL_REFERENCE_1 = '02';\nexport const SUB_BILL_REFERENCE_2 = '03';\n\n// ── Additional-data template (under tag 62) sub-fields ──────────────────\nexport const SUB_ADD_BILL_NUMBER = '01';\nexport const SUB_ADD_MOBILE_NUMBER = '02';\nexport const SUB_ADD_STORE_LABEL = '03';\nexport const SUB_ADD_LOYALTY_NUMBER = '04';\nexport const SUB_ADD_REFERENCE_LABEL = '05';\nexport const SUB_ADD_CUSTOMER_LABEL = '06';\nexport const SUB_ADD_TERMINAL_LABEL = '07';\nexport const SUB_ADD_PURPOSE_OF_TRANSACTION = '08';\nexport const SUB_ADD_CONSUMER_DATA_REQUEST = '09';\n\n// ── Constants from the Thai QR Payment supplement ──────────────────────\nexport const PAYLOAD_FORMAT_VERSION = '01';\nexport const POI_STATIC = '11';\nexport const POI_DYNAMIC = '12';\nexport const CURRENCY_THB = '764';\nexport const COUNTRY_TH = 'TH';\nexport const GUID_PROMPTPAY = 'A000000677010111';\nexport const GUID_BILL_PAYMENT = 'A000000677010112';\n// One-Time Authorization rides the PromptPay envelope but swaps the AID\n// so scanners can distinguish a single-use credit transfer from a\n// repeatable PromptPay payment.\nexport const GUID_PROMPTPAY_OTA = 'A000000677010114';\n// Cross-border bill payment shares tag 30 with the domestic variant but\n// flags itself with a distinct AID so scanners route the payload through\n// the ASEAN remittance rails (PayNow/DuitNow/QRIS interop) instead of the\n// local PromptPay biller switch.\nexport const GUID_BILL_PAYMENT_CROSS_BORDER = 'A000000677012006';\n\n// ── Tip handling ────────────────────────────────────────────────────────\nexport const TIP_PROMPT = '01';\nexport const TIP_FIXED = '02';\nexport const TIP_PERCENTAGE = '03';\n\n// ── VAT TQRC template (Bank of Thailand Tax-Qualified QR extension) ────\n// Tag 80 carries a nested TLV that turns a regular payment QR into an\n// e-tax-receipt source. The \"ascending tag id\" wire rule places it after\n// tag 64 and before tag 63 — the CRC-last rule wins over ordering.\nexport const TAG_VAT_TQRC = '80';\nexport const SUB_VAT_SELLER_TAX_BRANCH_ID = '00';\nexport const SUB_VAT_RATE = '01';\nexport const SUB_VAT_AMOUNT = '02';\n","/**\n * TLV (Tag-Length-Value) primitives for the EMVCo QR wire format.\n *\n * Every field on the wire is `IILLDDDD…` where `II` is the 2-char tag id,\n * `LL` is the 2-char zero-padded byte length, and `DDDD…` is the value.\n * Nested templates (tags 29-31, 62, 64) contain TLV runs in their value\n * slot recursively.\n */\n\n/** A parsed TLV field with its (possibly-nested) value text. */\nexport interface TLVField {\n readonly tag: string;\n readonly value: string;\n}\n\n/** Encode one TLV. The caller guarantees that `tag` is a valid 2-digit id. */\nexport function encodeField(tag: string, value: string): string {\n const length = value.length.toString(10).padStart(2, '0');\n if (value.length > 99) {\n throw new RangeError(\n `TLV value for tag ${tag} exceeds 99 bytes (got ${value.length}); split across multiple tags`,\n );\n }\n return tag + length + value;\n}\n\n/**\n * Encode an array of `[tag, value]` pairs in registration order. Empty or\n * `null`/`undefined` values are filtered out so callers can compose\n * optional fields without an `if` chain.\n */\nexport function encodeFields(\n pairs: ReadonlyArray,\n): string {\n let out = '';\n for (const [tag, value] of pairs) {\n if (value == null || value === '') continue;\n out += encodeField(tag, value);\n }\n return out;\n}\n\n/**\n * Walk a TLV-encoded string and return one field at a time. Stops cleanly\n * at end-of-input; throws on malformed length headers or truncated values.\n *\n * Designed for parsing both the root payload and nested template values\n * — the same algorithm applies at any depth.\n */\nexport function* iterateFields(input: string): IterableIterator {\n let cursor = 0;\n while (cursor < input.length) {\n if (cursor + 4 > input.length) {\n throw new SyntaxError(`Truncated TLV header at offset ${cursor}`);\n }\n const tag = input.slice(cursor, cursor + 2);\n const lengthText = input.slice(cursor + 2, cursor + 4);\n const length = Number.parseInt(lengthText, 10);\n if (!Number.isFinite(length) || lengthText.length !== 2) {\n throw new SyntaxError(`Invalid TLV length \"${lengthText}\" at offset ${cursor + 2}`);\n }\n const valueStart = cursor + 4;\n const valueEnd = valueStart + length;\n if (valueEnd > input.length) {\n throw new SyntaxError(\n `TLV value for tag ${tag} runs past end of input (need ${length} bytes from offset ${valueStart})`,\n );\n }\n yield { tag, value: input.slice(valueStart, valueEnd) };\n cursor = valueEnd;\n }\n}\n\n/** Convenience over `iterateFields` — collect into a Map by tag id. */\nexport function parseFields(input: string): Map {\n const map = new Map();\n for (const field of iterateFields(input)) {\n map.set(field.tag, field.value);\n }\n return map;\n}\n","/**\n * Append-only bit buffer used during QR data encoding.\n *\n * QR streams pack each segment's mode indicator, character-count\n * indicator, and payload bits into a continuous bit run that's later\n * sliced into 8-bit codewords. A typed-array-backed buffer keeps the\n * allocations down compared to JS array of booleans.\n */\n\nexport class BitBuffer {\n private storage: Uint8Array;\n private bitLength = 0;\n\n constructor(initialCapacityBits = 256) {\n this.storage = new Uint8Array(Math.ceil(initialCapacityBits / 8));\n }\n\n get length(): number {\n return this.bitLength;\n }\n\n /** Push the low `count` bits of `value`, MSB first. */\n push(value: number, count: number): void {\n if (count < 0 || count > 31) {\n throw new RangeError(`Bit width ${count} out of range (1-31)`);\n }\n this.ensureCapacity(this.bitLength + count);\n for (let i = count - 1; i >= 0; i -= 1) {\n const bit = (value >>> i) & 1;\n const byteIdx = this.bitLength >>> 3;\n const bitIdx = 7 - (this.bitLength & 7);\n if (bit === 1) {\n const current = this.storage[byteIdx] ?? 0;\n this.storage[byteIdx] = current | (1 << bitIdx);\n }\n this.bitLength += 1;\n }\n }\n\n /** Materialise the buffer as a packed byte view (LSB of each byte is the rightmost bit). */\n toBytes(): Uint8Array {\n const byteCount = Math.ceil(this.bitLength / 8);\n return this.storage.slice(0, byteCount);\n }\n\n private ensureCapacity(neededBits: number): void {\n const neededBytes = Math.ceil(neededBits / 8);\n if (neededBytes <= this.storage.length) return;\n let nextSize = this.storage.length === 0 ? 1 : this.storage.length;\n while (nextSize < neededBytes) nextSize *= 2;\n const expanded = new Uint8Array(nextSize);\n expanded.set(this.storage);\n this.storage = expanded;\n }\n}\n","/**\n * Top-level QR encoder.\n *\n * Pipeline:\n * 1. Detect the narrowest mode for the input.\n * 2. Find the smallest version that fits the (mode, ECC) bit budget.\n * 3. Pack data → codewords → split into blocks → append Reed-Solomon ECC.\n * 4. Interleave codewords into the final byte stream + remainder bits.\n * 5. Lay down fixed patterns, place data in zigzag, try all 8 masks,\n * pick the one with the lowest penalty.\n * 6. Embed format-info and (for v7+) version-info, then return.\n */\n\nimport { BitBuffer } from './bitbuffer.js';\nimport { buildBaseMatrix } from './patterns.js';\nimport { applyMask, MASK_COUNT, scoreMask } from './mask.js';\nimport { placeData, placeFormatInfo, placeVersionInfo } from './placement.js';\nimport { dataBitLength, detectMode, emitSegment } from './mode.js';\nimport { encodeBlock } from './rs.js';\nimport {\n type BlockSpec,\n type ErrorCorrectionLevel,\n getBlockSpec,\n totalCodewords,\n} from './version.js';\n\nexport interface EncodeOptions {\n errorCorrectionLevel?: ErrorCorrectionLevel;\n minVersion?: number;\n maxVersion?: number;\n forceMask?: number;\n}\n\nexport interface QRMatrix {\n readonly size: number;\n readonly modules: boolean[][];\n readonly version: number;\n readonly errorCorrectionLevel: ErrorCorrectionLevel;\n readonly mask: number;\n}\n\n/** Pad a partial last codeword with 0 bits, then alternate `0xEC 0x11` filler. */\nfunction padToCapacity(bits: BitBuffer, dataCodewords: number): Uint8Array {\n const target = dataCodewords * 8;\n // Terminator: up to 4 trailing 0 bits.\n const terminator = Math.min(4, target - bits.length);\n if (terminator > 0) bits.push(0, terminator);\n // Pad to byte boundary.\n if (bits.length % 8 !== 0) bits.push(0, 8 - (bits.length % 8));\n // Filler bytes alternate 0xEC / 0x11 per spec until full.\n const bytes = new Uint8Array(dataCodewords);\n const partial = bits.toBytes();\n bytes.set(partial.slice(0, dataCodewords));\n let toggle = false;\n for (let i = partial.length; i < dataCodewords; i += 1) {\n bytes[i] = toggle ? 0x11 : 0xec;\n toggle = !toggle;\n }\n return bytes;\n}\n\n/** Split data into ECC blocks and append Reed-Solomon parity to each. */\nfunction buildCodewordBlocks(\n spec: BlockSpec,\n data: Uint8Array,\n): {\n dataBlocks: Uint8Array[];\n ecBlocks: Uint8Array[];\n} {\n const dataBlocks: Uint8Array[] = [];\n const ecBlocks: Uint8Array[] = [];\n let offset = 0;\n for (const [count, perBlock] of spec.groups) {\n for (let i = 0; i < count; i += 1) {\n const block = data.slice(offset, offset + perBlock);\n offset += perBlock;\n dataBlocks.push(block);\n ecBlocks.push(encodeBlock(block, spec.ecPerBlock));\n }\n }\n return { dataBlocks, ecBlocks };\n}\n\n/** Interleave data + ECC blocks column-major per ISO/IEC 18004 §7.6. */\nfunction interleave(dataBlocks: Uint8Array[], ecBlocks: Uint8Array[]): Uint8Array {\n const maxDataLen = Math.max(...dataBlocks.map((b) => b.length));\n const maxEcLen = Math.max(...ecBlocks.map((b) => b.length));\n const out: number[] = [];\n for (let i = 0; i < maxDataLen; i += 1) {\n for (const block of dataBlocks) if (i < block.length) out.push(block[i] ?? 0);\n }\n for (let i = 0; i < maxEcLen; i += 1) {\n for (const block of ecBlocks) if (i < block.length) out.push(block[i] ?? 0);\n }\n return Uint8Array.from(out);\n}\n\n/** Select the smallest version that can hold the encoded segment. */\nfunction pickVersion(\n text: string,\n mode: ReturnType,\n ecc: ErrorCorrectionLevel,\n min: number,\n max: number,\n): number {\n for (let version = min; version <= max; version += 1) {\n const needBits = dataBitLength(mode, text, version);\n const capacity = getBlockSpec(version, ecc).dataCodewords * 8;\n if (needBits <= capacity) return version;\n }\n throw new RangeError(\n `Input does not fit in versions ${min}-${max} at ECC ${ecc} (${text.length} chars)`,\n );\n}\n\n/**\n * Encode `text` as a QR Code matrix.\n *\n * The returned matrix is a square 2-D boolean array (`true` = dark\n * module). Render with any output (SVG, canvas, PNG, terminal).\n */\nexport function encodeQR(text: string, options: EncodeOptions = {}): QRMatrix {\n const ecc = options.errorCorrectionLevel ?? 'M';\n const minVersion = options.minVersion ?? 1;\n const maxVersion = options.maxVersion ?? 40;\n\n const mode = detectMode(text);\n const version = pickVersion(text, mode, ecc, minVersion, maxVersion);\n const spec = getBlockSpec(version, ecc);\n\n // 1) Bit-encode the segment + pad to full data-codeword capacity.\n const bits = new BitBuffer();\n emitSegment(text, mode, version, bits);\n const codewords = padToCapacity(bits, spec.dataCodewords);\n\n // 2) ECC + interleave into final byte stream.\n const { dataBlocks, ecBlocks } = buildCodewordBlocks(spec, codewords);\n const finalBytes = interleave(dataBlocks, ecBlocks);\n\n // QR may require a few zero \"remainder bits\" at the end of the stream.\n const totalBytesNeeded = Math.ceil(\n (totalCodewords(version, ecc) * 8 + REMAINDER_BITS[version]!) / 8,\n );\n const padded = new Uint8Array(totalBytesNeeded);\n padded.set(finalBytes);\n\n // 3) Build the base matrix and place data, format, version info.\n const base = buildBaseMatrix(version);\n placeData(base, padded);\n\n // 4) Pick the lowest-penalty mask.\n const snapshot = base.snapshot();\n let bestMask = options.forceMask ?? 0;\n let bestScore = Number.POSITIVE_INFINITY;\n if (options.forceMask == null) {\n for (let mask = 0; mask < MASK_COUNT; mask += 1) {\n base.restore(snapshot);\n placeFormatInfo(base, ecc, mask);\n placeVersionInfo(base, version);\n applyMask(base, mask);\n const score = scoreMask(base);\n if (score < bestScore) {\n bestScore = score;\n bestMask = mask;\n }\n }\n }\n\n base.restore(snapshot);\n placeFormatInfo(base, ecc, bestMask);\n placeVersionInfo(base, version);\n applyMask(base, bestMask);\n\n return {\n size: base.dim,\n modules: base.toBooleans(),\n version,\n errorCorrectionLevel: ecc,\n mask: bestMask,\n };\n}\n\n// Remainder-bit table per ISO/IEC 18004 §7.7.\nconst REMAINDER_BITS: Record = {\n 1: 0,\n 2: 7,\n 3: 7,\n 4: 7,\n 5: 7,\n 6: 7,\n 7: 0,\n 8: 0,\n 9: 0,\n 10: 0,\n 11: 0,\n 12: 0,\n 13: 0,\n 14: 3,\n 15: 3,\n 16: 3,\n 17: 3,\n 18: 3,\n 19: 3,\n 20: 3,\n 21: 4,\n 22: 4,\n 23: 4,\n 24: 4,\n 25: 4,\n 26: 4,\n 27: 4,\n 28: 3,\n 29: 3,\n 30: 3,\n 31: 3,\n 32: 3,\n 33: 3,\n 34: 3,\n 35: 0,\n 36: 0,\n 37: 0,\n 38: 0,\n 39: 0,\n 40: 0,\n};\n","/**\n * Format-information and version-information bit strings.\n *\n * Format info encodes (ECC level, mask index) as a 15-bit BCH (15, 5)\n * codeword XOR'd with the spec's fixed mask `0x5412`. Version info\n * encodes the version as an 18-bit BCH (18, 6) codeword for v7+.\n */\n\nimport { ECC_BITS, type ErrorCorrectionLevel } from './version.js';\n\nconst FORMAT_MASK = 0x5412;\nconst FORMAT_GENERATOR = 0x537; // 0b10100110111\nconst VERSION_GENERATOR = 0x1f25;\n\n/** BCH(15,5) encode the (ecc, mask) tuple and XOR with the format mask. */\nexport function encodeFormatBits(ecc: ErrorCorrectionLevel, mask: number): number {\n const data = ((ECC_BITS[ecc] & 0b11) << 3) | (mask & 0b111);\n let value = data << 10;\n for (let i = 4; i >= 0; i -= 1) {\n if (((value >> (i + 10)) & 1) !== 0) {\n value ^= FORMAT_GENERATOR << i;\n }\n }\n const bch = (data << 10) | (value & 0x3ff);\n return bch ^ FORMAT_MASK;\n}\n\n/** BCH(18,6) encode the version number (only used for v7+). */\nexport function encodeVersionBits(version: number): number {\n let value = version << 12;\n for (let i = 5; i >= 0; i -= 1) {\n if (((value >> (i + 12)) & 1) !== 0) {\n value ^= VERSION_GENERATOR << i;\n }\n }\n return (version << 12) | (value & 0xfff);\n}\n","/**\n * Galois field GF(2^8) arithmetic over the QR-spec primitive polynomial\n * 0x11D (binary 100011101) — the same field used by Reed-Solomon error\n * correction throughout ISO/IEC 18004.\n *\n * Lookup tables (`EXP` / `LOG`) trade 512 bytes for constant-time\n * multiplication and inversion. We build them once at module load using\n * the standard alpha-power generator.\n */\n\nconst PRIMITIVE = 0x11d;\n\nexport const EXP: Uint8Array = new Uint8Array(512);\nexport const LOG: Uint8Array = new Uint8Array(256);\n\n(() => {\n let x = 1;\n for (let i = 0; i < 255; i += 1) {\n EXP[i] = x;\n LOG[x] = i;\n x <<= 1;\n if (x & 0x100) x ^= PRIMITIVE;\n }\n // Mirror the first 255 entries into [255, 510] so callers can compute\n // (LOG[a] + LOG[b]) without modulo.\n for (let i = 255; i < 512; i += 1) {\n EXP[i] = EXP[i - 255] ?? 0;\n }\n})();\n\n/** Multiply two field elements. Returns 0 when either operand is 0. */\nexport function mul(a: number, b: number): number {\n if (a === 0 || b === 0) return 0;\n return EXP[(LOG[a] ?? 0) + (LOG[b] ?? 0)] ?? 0;\n}\n","/**\n * `@thai-qr-payment/qr` — zero-dependency QR Code encoder.\n *\n * ISO/IEC 18004 Model-2 implementation tuned for Thai QR Payment\n * (EMVCo MPM) payloads. Returns a boolean matrix; rendering is the\n * caller's responsibility (use `@thai-qr-payment/render` for SVG).\n */\n\nexport { encodeQR } from './encoder.js';\nexport type { EncodeOptions, QRMatrix } from './encoder.js';\nexport type { ErrorCorrectionLevel } from './version.js';\nexport { detectMode } from './mode.js';\nexport type { EncodingMode } from './mode.js';\n","/**\n * Mask pattern selection + penalty scoring per ISO/IEC 18004 §7.8.\n *\n * QR defines 8 mask patterns. After data placement, each candidate mask\n * is applied to the free-data modules and scored on four rule\n * categories; the lowest-scoring mask wins.\n */\n\nimport type { Matrix } from './matrix.js';\n\nconst MASK_PREDICATES: ReadonlyArray<(x: number, y: number) => boolean> = [\n (x, y) => (x + y) % 2 === 0,\n (_x, y) => y % 2 === 0,\n (x) => x % 3 === 0,\n (x, y) => (x + y) % 3 === 0,\n (x, y) => (Math.floor(y / 2) + Math.floor(x / 3)) % 2 === 0,\n (x, y) => ((x * y) % 2) + ((x * y) % 3) === 0,\n (x, y) => (((x * y) % 2) + ((x * y) % 3)) % 2 === 0,\n (x, y) => (((x + y) % 2) + ((x * y) % 3)) % 2 === 0,\n];\n\n/** Toggle every free-data module that matches the mask predicate. */\nexport function applyMask(matrix: Matrix, maskIndex: number): void {\n const predicate = MASK_PREDICATES[maskIndex];\n if (!predicate) throw new RangeError(`Mask index ${maskIndex} out of range`);\n for (let y = 0; y < matrix.dim; y += 1) {\n for (let x = 0; x < matrix.dim; x += 1) {\n if (matrix.isReserved(x, y)) continue;\n if (predicate(x, y)) matrix.set(x, y, !matrix.get(x, y));\n }\n }\n}\n\n// ── Penalty rules ─────────────────────────────────────────────────────\n\n/** Rule 1: penalty for consecutive runs of same-colour modules. */\nfunction penaltyRunLength(matrix: Matrix): number {\n let total = 0;\n const { dim } = matrix;\n for (let y = 0; y < dim; y += 1) {\n let runColor = matrix.get(0, y);\n let runLen = 1;\n for (let x = 1; x < dim; x += 1) {\n const c = matrix.get(x, y);\n if (c === runColor) {\n runLen += 1;\n } else {\n if (runLen >= 5) total += runLen - 2;\n runColor = c;\n runLen = 1;\n }\n }\n if (runLen >= 5) total += runLen - 2;\n }\n for (let x = 0; x < dim; x += 1) {\n let runColor = matrix.get(x, 0);\n let runLen = 1;\n for (let y = 1; y < dim; y += 1) {\n const c = matrix.get(x, y);\n if (c === runColor) {\n runLen += 1;\n } else {\n if (runLen >= 5) total += runLen - 2;\n runColor = c;\n runLen = 1;\n }\n }\n if (runLen >= 5) total += runLen - 2;\n }\n return total;\n}\n\n/** Rule 2: penalty for 2×2 blocks of same-colour modules. */\nfunction penaltyBlocks(matrix: Matrix): number {\n let count = 0;\n const { dim } = matrix;\n for (let y = 0; y < dim - 1; y += 1) {\n for (let x = 0; x < dim - 1; x += 1) {\n const c = matrix.get(x, y);\n if (\n matrix.get(x + 1, y) === c &&\n matrix.get(x, y + 1) === c &&\n matrix.get(x + 1, y + 1) === c\n ) {\n count += 1;\n }\n }\n }\n return count * 3;\n}\n\n/** Rule 3: penalty for finder-like patterns 10111010000 / 00001011101. */\nfunction penaltyFinderLike(matrix: Matrix): number {\n const { dim } = matrix;\n let count = 0;\n const pattern1 = [1, 0, 1, 1, 1, 0, 1, 0, 0, 0, 0];\n const pattern2 = [0, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1];\n const matches = (line: number[]): number => {\n let hits = 0;\n for (let i = 0; i <= line.length - 11; i += 1) {\n let ok1 = true;\n let ok2 = true;\n for (let j = 0; j < 11; j += 1) {\n if (line[i + j] !== pattern1[j]) ok1 = false;\n if (line[i + j] !== pattern2[j]) ok2 = false;\n if (!ok1 && !ok2) break;\n }\n if (ok1) hits += 1;\n if (ok2) hits += 1;\n }\n return hits;\n };\n for (let y = 0; y < dim; y += 1) {\n const row: number[] = [];\n for (let x = 0; x < dim; x += 1) row.push(matrix.get(x, y) ? 1 : 0);\n count += matches(row);\n }\n for (let x = 0; x < dim; x += 1) {\n const col: number[] = [];\n for (let y = 0; y < dim; y += 1) col.push(matrix.get(x, y) ? 1 : 0);\n count += matches(col);\n }\n return count * 40;\n}\n\n/** Rule 4: penalty for dark/light imbalance. */\nfunction penaltyBalance(matrix: Matrix): number {\n let dark = 0;\n const total = matrix.dim * matrix.dim;\n for (let y = 0; y < matrix.dim; y += 1) {\n for (let x = 0; x < matrix.dim; x += 1) {\n if (matrix.get(x, y)) dark += 1;\n }\n }\n const ratio = (dark * 100) / total;\n const off = Math.floor(Math.abs(ratio - 50) / 5);\n return off * 10;\n}\n\n/** Total penalty (lower is better). */\nexport function scoreMask(matrix: Matrix): number {\n return (\n penaltyRunLength(matrix) +\n penaltyBlocks(matrix) +\n penaltyFinderLike(matrix) +\n penaltyBalance(matrix)\n );\n}\n\nexport const MASK_COUNT = MASK_PREDICATES.length;\n","/**\n * Module-grid layout for a single QR code.\n *\n * Wraps a `Uint8Array` of size `dim*dim` storing one bit per module.\n * A parallel \"reserved\" mask tracks which modules belong to fixed\n * patterns (finders, alignment, timing, format, version) so the data\n * placement skips them during the zigzag walk.\n */\n\nconst DARK = 1;\nconst LIGHT = 0;\nconst RESERVED = 1;\nconst FREE = 0;\n\nexport class Matrix {\n readonly dim: number;\n private readonly modules: Uint8Array;\n private readonly reserved: Uint8Array;\n\n constructor(dim: number) {\n this.dim = dim;\n this.modules = new Uint8Array(dim * dim);\n this.reserved = new Uint8Array(dim * dim);\n }\n\n get(x: number, y: number): boolean {\n return (this.modules[y * this.dim + x] ?? 0) === DARK;\n }\n\n set(x: number, y: number, dark: boolean): void {\n this.modules[y * this.dim + x] = dark ? DARK : LIGHT;\n }\n\n reserve(x: number, y: number): void {\n this.reserved[y * this.dim + x] = RESERVED;\n }\n\n isReserved(x: number, y: number): boolean {\n return (this.reserved[y * this.dim + x] ?? 0) === RESERVED;\n }\n\n /** Export as a 2-D boolean array; useful for renderers. */\n toBooleans(): boolean[][] {\n const rows: boolean[][] = [];\n for (let y = 0; y < this.dim; y += 1) {\n const row: boolean[] = Array.from({ length: this.dim }, () => false);\n for (let x = 0; x < this.dim; x += 1) {\n row[x] = this.get(x, y);\n }\n rows.push(row);\n }\n return rows;\n }\n\n /** Snapshot just the data-module bits (used during mask scoring). */\n snapshot(): Uint8Array {\n return this.modules.slice();\n }\n\n restore(snapshot: Uint8Array): void {\n this.modules.set(snapshot);\n }\n\n /** True if a module at (x, y) is on the free-data path. */\n isFree(x: number, y: number): boolean {\n return !this.isReserved(x, y);\n }\n\n fillReserved(x: number, y: number, dark: boolean): void {\n this.set(x, y, dark);\n this.reserve(x, y);\n }\n}\n\nexport { DARK, LIGHT, RESERVED, FREE };\n","/**\n * Encoding mode detection + bit emission for QR data segments.\n *\n * We support the three modes that matter for Thai QR Payment:\n * - **Numeric** (3 chars → 10 bits): for amount-only payloads\n * - **Alphanumeric** (2 chars → 11 bits): the EMVCo payload character\n * set fits entirely here ([0-9A-Z $%*+-./:])\n * - **Byte** (1 char → 8 bits): fallback for arbitrary text\n *\n * Mode indicators are 4-bit constants prefixed to each segment.\n */\n\nimport type { BitBuffer } from './bitbuffer.js';\n\nexport type EncodingMode = 'numeric' | 'alphanumeric' | 'byte';\n\nexport const MODE_INDICATOR: Record = {\n numeric: 0b0001,\n alphanumeric: 0b0010,\n byte: 0b0100,\n};\n\nconst ALPHANUMERIC_CHARS = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ $%*+-./:';\n\n/** Reverse-lookup map for alphanumeric encoding. */\nconst ALPHANUMERIC_INDEX: ReadonlyMap = (() => {\n const map = new Map();\n for (let i = 0; i < ALPHANUMERIC_CHARS.length; i += 1) {\n map.set(ALPHANUMERIC_CHARS[i]!, i);\n }\n return map;\n})();\n\n/** Width of the character-count indicator (depends on mode + version range). */\nexport function charCountBits(mode: EncodingMode, version: number): number {\n if (version <= 9) {\n return mode === 'numeric' ? 10 : mode === 'alphanumeric' ? 9 : 8;\n }\n if (version <= 26) {\n return mode === 'numeric' ? 12 : mode === 'alphanumeric' ? 11 : 16;\n }\n return mode === 'numeric' ? 14 : mode === 'alphanumeric' ? 13 : 16;\n}\n\nconst DIGITS_RE = /^[0-9]+$/;\nconst ALPHANUM_RE = /^[0-9A-Z $%*+\\-./:]+$/;\n\n/** Detect the narrowest mode that can encode the entire input. */\nexport function detectMode(text: string): EncodingMode {\n if (DIGITS_RE.test(text)) return 'numeric';\n if (ALPHANUM_RE.test(text)) return 'alphanumeric';\n return 'byte';\n}\n\n/** Bit length of the encoded payload (mode indicator + counter + data). */\nexport function dataBitLength(mode: EncodingMode, text: string, version: number): number {\n const header = 4 + charCountBits(mode, version);\n switch (mode) {\n case 'numeric': {\n const full = Math.floor(text.length / 3);\n const remainder = text.length - full * 3;\n const tail = remainder === 0 ? 0 : remainder === 1 ? 4 : 7;\n return header + full * 10 + tail;\n }\n case 'alphanumeric': {\n const pairs = Math.floor(text.length / 2);\n const remainder = text.length - pairs * 2;\n return header + pairs * 11 + (remainder === 0 ? 0 : 6);\n }\n case 'byte':\n return header + utf8Length(text) * 8;\n }\n}\n\nfunction utf8Length(text: string): number {\n // Most Thai QR payloads are ASCII; this branch keeps correctness for\n // hypothetical UTF-8 byte-mode segments without paying for a full\n // TextEncoder allocation on the hot path.\n if (typeof TextEncoder !== 'undefined') return new TextEncoder().encode(text).length;\n let count = 0;\n for (let i = 0; i < text.length; i += 1) {\n const code = text.charCodeAt(i);\n if (code < 0x80) count += 1;\n else if (code < 0x800) count += 2;\n else if (code >= 0xd800 && code <= 0xdbff) {\n count += 4;\n i += 1; // surrogate pair\n } else count += 3;\n }\n return count;\n}\n\n/** Emit a numeric segment. */\nfunction emitNumeric(text: string, bits: BitBuffer): void {\n let i = 0;\n while (i + 3 <= text.length) {\n const triple = Number.parseInt(text.slice(i, i + 3), 10);\n bits.push(triple, 10);\n i += 3;\n }\n const remainder = text.length - i;\n if (remainder === 2) bits.push(Number.parseInt(text.slice(i), 10), 7);\n else if (remainder === 1) bits.push(Number.parseInt(text.slice(i), 10), 4);\n}\n\n/** Emit an alphanumeric segment. */\nfunction emitAlphanumeric(text: string, bits: BitBuffer): void {\n let i = 0;\n while (i + 2 <= text.length) {\n const high = ALPHANUMERIC_INDEX.get(text[i]!);\n const low = ALPHANUMERIC_INDEX.get(text[i + 1]!);\n if (high == null || low == null) throw new TypeError(`Char outside alphanumeric set at ${i}`);\n bits.push(high * 45 + low, 11);\n i += 2;\n }\n if (i < text.length) {\n const value = ALPHANUMERIC_INDEX.get(text[i]!);\n if (value == null) throw new TypeError(`Char outside alphanumeric set at ${i}`);\n bits.push(value, 6);\n }\n}\n\n/** Emit a byte segment (UTF-8 encoded). */\nfunction emitByte(text: string, bits: BitBuffer): void {\n const encoded =\n typeof TextEncoder !== 'undefined' ? new TextEncoder().encode(text) : utf8EncodeFallback(text);\n for (let i = 0; i < encoded.length; i += 1) {\n bits.push(encoded[i] ?? 0, 8);\n }\n}\n\nfunction utf8EncodeFallback(text: string): Uint8Array {\n const out: number[] = [];\n for (let i = 0; i < text.length; i += 1) {\n let code = text.charCodeAt(i);\n if (code >= 0xd800 && code <= 0xdbff && i + 1 < text.length) {\n const low = text.charCodeAt(i + 1);\n if (low >= 0xdc00 && low <= 0xdfff) {\n code = 0x10000 + ((code - 0xd800) << 10) + (low - 0xdc00);\n i += 1;\n }\n }\n if (code < 0x80) out.push(code);\n else if (code < 0x800) out.push(0xc0 | (code >> 6), 0x80 | (code & 0x3f));\n else if (code < 0x10000) {\n out.push(0xe0 | (code >> 12), 0x80 | ((code >> 6) & 0x3f), 0x80 | (code & 0x3f));\n } else {\n out.push(\n 0xf0 | (code >> 18),\n 0x80 | ((code >> 12) & 0x3f),\n 0x80 | ((code >> 6) & 0x3f),\n 0x80 | (code & 0x3f),\n );\n }\n }\n return Uint8Array.from(out);\n}\n\n/** Append the full segment (mode + count + data) to the bit buffer. */\nexport function emitSegment(\n text: string,\n mode: EncodingMode,\n version: number,\n bits: BitBuffer,\n): void {\n bits.push(MODE_INDICATOR[mode], 4);\n bits.push(text.length, charCountBits(mode, version));\n switch (mode) {\n case 'numeric':\n emitNumeric(text, bits);\n return;\n case 'alphanumeric':\n emitAlphanumeric(text, bits);\n return;\n case 'byte':\n emitByte(text, bits);\n return;\n }\n}\n","/**\n * Fixed-pattern placement: finder, separator, alignment, timing, dark\n * module, format-info reservation, and version-info reservation.\n *\n * Each routine reserves the modules it touches so the data placement\n * pass can skip over them.\n */\n\nimport { Matrix } from './matrix.js';\nimport { alignmentCentres, moduleCount } from './version.js';\n\nfunction placeFinder(m: Matrix, originX: number, originY: number): void {\n for (let dy = -1; dy <= 7; dy += 1) {\n for (let dx = -1; dx <= 7; dx += 1) {\n const x = originX + dx;\n const y = originY + dy;\n if (x < 0 || y < 0 || x >= m.dim || y >= m.dim) continue;\n const onEdge = dx === 0 || dx === 6 || dy === 0 || dy === 6;\n const insideCore = dx >= 2 && dx <= 4 && dy >= 2 && dy <= 4;\n const isBorder = dx === -1 || dx === 7 || dy === -1 || dy === 7;\n const dark = !isBorder && (onEdge || insideCore);\n m.fillReserved(x, y, dark);\n }\n }\n}\n\nfunction placeAlignment(m: Matrix, cx: number, cy: number): void {\n for (let dy = -2; dy <= 2; dy += 1) {\n for (let dx = -2; dx <= 2; dx += 1) {\n const dark = Math.max(Math.abs(dx), Math.abs(dy)) !== 1;\n m.fillReserved(cx + dx, cy + dy, dark);\n }\n }\n}\n\nfunction placeTimingPatterns(m: Matrix): void {\n for (let i = 8; i < m.dim - 8; i += 1) {\n const dark = i % 2 === 0;\n m.fillReserved(i, 6, dark);\n m.fillReserved(6, i, dark);\n }\n}\n\nfunction placeDarkModule(m: Matrix, version: number): void {\n // The dark module is the single forced-on module at (8, 4*v + 9).\n m.fillReserved(8, 4 * version + 9, true);\n}\n\nfunction reserveFormatInfo(m: Matrix): void {\n const dim = m.dim;\n // Around top-left finder\n for (let i = 0; i <= 8; i += 1) {\n if (i !== 6) m.reserve(i, 8);\n if (i !== 6) m.reserve(8, i);\n }\n // Bottom-left + top-right format strips\n for (let i = 0; i < 7; i += 1) m.reserve(8, dim - 1 - i);\n for (let i = 0; i < 8; i += 1) m.reserve(dim - 1 - i, 8);\n}\n\nfunction reserveVersionInfo(m: Matrix, version: number): void {\n if (version < 7) return;\n const dim = m.dim;\n for (let row = 0; row < 6; row += 1) {\n for (let col = dim - 11; col < dim - 8; col += 1) {\n m.reserve(col, row);\n m.reserve(row, col);\n }\n }\n}\n\n/**\n * Lay down every fixed pattern for the given version. Returns the\n * matrix in a state where the only unreserved modules are those\n * available for data placement (still empty / 0).\n */\nexport function buildBaseMatrix(version: number): Matrix {\n const dim = moduleCount(version);\n const m = new Matrix(dim);\n\n placeFinder(m, 0, 0);\n placeFinder(m, dim - 7, 0);\n placeFinder(m, 0, dim - 7);\n\n for (const cx of alignmentCentres(version)) {\n for (const cy of alignmentCentres(version)) {\n // Skip alignment patterns that overlap finder patterns.\n const onTopLeftFinder = cx <= 8 && cy <= 8;\n const onTopRightFinder = cx >= dim - 9 && cy <= 8;\n const onBottomLeftFinder = cx <= 8 && cy >= dim - 9;\n if (onTopLeftFinder || onTopRightFinder || onBottomLeftFinder) continue;\n placeAlignment(m, cx, cy);\n }\n }\n\n placeTimingPatterns(m);\n placeDarkModule(m, version);\n reserveFormatInfo(m);\n reserveVersionInfo(m, version);\n\n return m;\n}\n","/**\n * Module placement: data zigzag, format-info embed, version-info embed.\n */\n\nimport { encodeFormatBits, encodeVersionBits } from './format-info.js';\nimport type { Matrix } from './matrix.js';\nimport type { ErrorCorrectionLevel } from './version.js';\n\n/**\n * Walk the QR data area right-to-left in 2-column vertical zigzag and\n * place data bits. Columns at x=6 are skipped (timing pattern lives there).\n */\nexport function placeData(matrix: Matrix, bytes: Uint8Array): void {\n const { dim } = matrix;\n let bitIndex = 0;\n let upward = true;\n\n for (let right = dim - 1; right >= 1; right -= 2) {\n if (right === 6) right -= 1; // skip the vertical timing column\n\n for (let v = 0; v < dim; v += 1) {\n const y = upward ? dim - 1 - v : v;\n for (let off = 0; off < 2; off += 1) {\n const x = right - off;\n if (matrix.isReserved(x, y)) continue;\n const byteIdx = bitIndex >>> 3;\n const bitOffset = 7 - (bitIndex & 7);\n const bit = (((bytes[byteIdx] ?? 0) >>> bitOffset) & 1) === 1;\n matrix.set(x, y, bit);\n bitIndex += 1;\n }\n }\n\n upward = !upward;\n }\n}\n\n/** Embed the 15-bit format-info word in the two canonical strips. */\nexport function placeFormatInfo(matrix: Matrix, ecc: ErrorCorrectionLevel, mask: number): void {\n const bits = encodeFormatBits(ecc, mask);\n const { dim } = matrix;\n\n // Top-left strip (around the top-left finder)\n for (let i = 0; i < 6; i += 1) matrix.set(8, i, ((bits >>> i) & 1) === 1);\n matrix.set(8, 7, ((bits >>> 6) & 1) === 1);\n matrix.set(8, 8, ((bits >>> 7) & 1) === 1);\n matrix.set(7, 8, ((bits >>> 8) & 1) === 1);\n for (let i = 9; i < 15; i += 1) matrix.set(14 - i, 8, ((bits >>> i) & 1) === 1);\n\n // Bottom-left + top-right strips\n for (let i = 0; i < 8; i += 1) matrix.set(dim - 1 - i, 8, ((bits >>> i) & 1) === 1);\n for (let i = 8; i < 15; i += 1) matrix.set(8, dim - 15 + i, ((bits >>> i) & 1) === 1);\n}\n\n/** Embed the version-info word for v7+. No-op for v1-6. */\nexport function placeVersionInfo(matrix: Matrix, version: number): void {\n if (version < 7) return;\n const bits = encodeVersionBits(version);\n const { dim } = matrix;\n for (let i = 0; i < 18; i += 1) {\n const bit = ((bits >>> i) & 1) === 1;\n const row = Math.floor(i / 3);\n const col = (i % 3) + dim - 11;\n matrix.set(col, row, bit);\n matrix.set(row, col, bit);\n }\n}\n","/**\n * Reed-Solomon error correction over GF(2^8).\n *\n * QR uses a punctured Reed-Solomon code with the generator polynomial\n * g(x) = ∏ (x − α^i) for i ∈ [0, ecLen)\n * built incrementally from the alpha exponents in `gf.EXP`. The encoder\n * computes the codeword remainder via long division and appends it to\n * the data stream.\n */\n\nimport { EXP, LOG, mul } from './gf.js';\n\n/** Pre-compute the RS generator polynomial of the requested length. */\nfunction buildGenerator(ecLen: number): Uint8Array {\n // Start with the constant polynomial g(x) = 1.\n let poly = new Uint8Array([1]);\n for (let i = 0; i < ecLen; i += 1) {\n // Multiply by (x − α^i): new coefficients have length+1 entries.\n const next = new Uint8Array(poly.length + 1);\n const alphaI = EXP[i] ?? 0;\n for (let j = 0; j < poly.length; j += 1) {\n const coeff = poly[j] ?? 0;\n const carry = next[j] ?? 0;\n next[j] = carry ^ coeff;\n const tail = next[j + 1] ?? 0;\n next[j + 1] = tail ^ mul(coeff, alphaI);\n }\n poly = next;\n }\n return poly;\n}\n\n/**\n * Encode a data block with `ecLen` ECC codewords appended. The output\n * is `data.length + ecLen` bytes long and matches the per-block format\n * used by QR's interleaved data layout.\n */\nexport function encodeBlock(data: Uint8Array, ecLen: number): Uint8Array {\n const generator = buildGenerator(ecLen);\n const buffer = new Uint8Array(data.length + ecLen);\n buffer.set(data, 0);\n\n for (let i = 0; i < data.length; i += 1) {\n const lead = buffer[i] ?? 0;\n if (lead === 0) continue;\n const leadLog = LOG[lead] ?? 0;\n for (let j = 0; j < generator.length; j += 1) {\n const coeff = generator[j] ?? 0;\n if (coeff === 0) continue;\n const slot = buffer[i + j] ?? 0;\n buffer[i + j] = slot ^ (EXP[leadLog + (LOG[coeff] ?? 0)] ?? 0);\n }\n }\n\n return buffer.slice(data.length);\n}\n","/**\n * Capacity tables + version metadata from ISO/IEC 18004 §6.5 and Annex D.\n *\n * Each version 1-40 has 4 ECC levels (L, M, Q, H). For each (version, ECC)\n * the spec defines:\n * - Total data codewords (`dataCodewords`)\n * - Number of error-correction blocks (groups)\n * - Block sizes within each group\n *\n * The matrix dimension is `(version - 1) * 4 + 21`.\n */\n\nexport type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';\n\nexport interface BlockSpec {\n /** Total data codewords across all blocks at this (version, ECC). */\n readonly dataCodewords: number;\n /** ECC codewords per block. */\n readonly ecPerBlock: number;\n /** `[count, dataPerBlock]` group entries (1 or 2 groups). */\n readonly groups: ReadonlyArray;\n}\n\n// Format-bit prefix per ECC level (used by format-info encoding too).\nexport const ECC_BITS: Record = {\n L: 0b01,\n M: 0b00,\n Q: 0b11,\n H: 0b10,\n};\n\n/** Matrix dimension in modules. */\nexport function moduleCount(version: number): number {\n return (version - 1) * 4 + 21;\n}\n\n// Block layout per (version, ECC). Sourced from ISO/IEC 18004:2015 Table 9.\n// Compactly encoded as a 2-D lookup keyed by (version, ECC).\n//\n// Each entry = [dataCodewords, ecPerBlock, groupCount1, dataPerBlock1,\n// groupCount2?, dataPerBlock2?]\n// ecBlocks[version-1][ecc] → row above.\nconst ECC_INDEX: Record = { L: 0, M: 1, Q: 2, H: 3 };\n\n// prettier-ignore\nconst ECC_TABLE: ReadonlyArray>> = [\n // v1\n [\n [19, 7, 1, 19],\n [16, 10, 1, 16],\n [13, 13, 1, 13],\n [9, 17, 1, 9],\n ],\n // v2\n [\n [34, 10, 1, 34],\n [28, 16, 1, 28],\n [22, 22, 1, 22],\n [16, 28, 1, 16],\n ],\n // v3\n [\n [55, 15, 1, 55],\n [44, 26, 1, 44],\n [34, 18, 2, 17],\n [26, 22, 2, 13],\n ],\n // v4\n [\n [80, 20, 1, 80],\n [64, 18, 2, 32],\n [48, 26, 2, 24],\n [36, 16, 4, 9],\n ],\n // v5\n [\n [108, 26, 1, 108],\n [86, 24, 2, 43],\n [62, 18, 2, 15, 2, 16],\n [46, 22, 2, 11, 2, 12],\n ],\n // v6\n [\n [136, 18, 2, 68],\n [108, 16, 4, 27],\n [76, 24, 4, 19],\n [60, 28, 4, 15],\n ],\n // v7\n [\n [156, 20, 2, 78],\n [124, 18, 4, 31],\n [88, 18, 2, 14, 4, 15],\n [66, 26, 4, 13, 1, 14],\n ],\n // v8\n [\n [194, 24, 2, 97],\n [154, 22, 2, 38, 2, 39],\n [110, 22, 4, 18, 2, 19],\n [86, 26, 4, 14, 2, 15],\n ],\n // v9\n [\n [232, 30, 2, 116],\n [182, 22, 3, 36, 2, 37],\n [132, 20, 4, 16, 4, 17],\n [100, 24, 4, 12, 4, 13],\n ],\n // v10\n [\n [274, 18, 2, 68, 2, 69],\n [216, 26, 4, 43, 1, 44],\n [154, 24, 6, 19, 2, 20],\n [122, 28, 6, 15, 2, 16],\n ],\n // v11\n [\n [324, 20, 4, 81],\n [254, 30, 1, 50, 4, 51],\n [180, 28, 4, 22, 4, 23],\n [140, 24, 3, 12, 8, 13],\n ],\n // v12\n [\n [370, 24, 2, 92, 2, 93],\n [290, 22, 6, 36, 2, 37],\n [206, 26, 4, 20, 6, 21],\n [158, 28, 7, 14, 4, 15],\n ],\n // v13\n [\n [428, 26, 4, 107],\n [334, 22, 8, 37, 1, 38],\n [244, 24, 8, 20, 4, 21],\n [180, 22, 12, 11, 4, 12],\n ],\n // v14\n [\n [461, 30, 3, 115, 1, 116],\n [365, 24, 4, 40, 5, 41],\n [261, 20, 11, 16, 5, 17],\n [197, 24, 11, 12, 5, 13],\n ],\n // v15\n [\n [523, 22, 5, 87, 1, 88],\n [415, 24, 5, 41, 5, 42],\n [295, 30, 5, 24, 7, 25],\n [223, 24, 11, 12, 7, 13],\n ],\n // v16\n [\n [589, 24, 5, 98, 1, 99],\n [453, 28, 7, 45, 3, 46],\n [325, 24, 15, 19, 2, 20],\n [253, 30, 3, 15, 13, 16],\n ],\n // v17\n [\n [647, 28, 1, 107, 5, 108],\n [507, 28, 10, 46, 1, 47],\n [367, 28, 1, 22, 15, 23],\n [283, 28, 2, 14, 17, 15],\n ],\n // v18\n [\n [721, 30, 5, 120, 1, 121],\n [563, 26, 9, 43, 4, 44],\n [397, 28, 17, 22, 1, 23],\n [313, 28, 2, 14, 19, 15],\n ],\n // v19\n [\n [795, 28, 3, 113, 4, 114],\n [627, 26, 3, 44, 11, 45],\n [445, 26, 17, 21, 4, 22],\n [341, 26, 9, 13, 16, 14],\n ],\n // v20\n [\n [861, 28, 3, 107, 5, 108],\n [669, 26, 3, 41, 13, 42],\n [485, 30, 15, 24, 5, 25],\n [385, 28, 15, 15, 10, 16],\n ],\n // v21\n [\n [932, 28, 4, 116, 4, 117],\n [714, 26, 17, 42],\n [512, 28, 17, 22, 6, 23],\n [406, 30, 19, 16, 6, 17],\n ],\n // v22\n [\n [1006, 28, 2, 111, 7, 112],\n [782, 28, 17, 46],\n [568, 30, 7, 24, 16, 25],\n [442, 24, 34, 13],\n ],\n // v23\n [\n [1094, 30, 4, 121, 5, 122],\n [860, 28, 4, 47, 14, 48],\n [614, 30, 11, 24, 14, 25],\n [464, 30, 16, 15, 14, 16],\n ],\n // v24\n [\n [1174, 30, 6, 117, 4, 118],\n [914, 28, 6, 45, 14, 46],\n [664, 30, 11, 24, 16, 25],\n [514, 30, 30, 16, 2, 17],\n ],\n // v25\n [\n [1276, 26, 8, 106, 4, 107],\n [1000, 28, 8, 47, 13, 48],\n [718, 30, 7, 24, 22, 25],\n [538, 30, 22, 15, 13, 16],\n ],\n // v26\n [\n [1370, 28, 10, 114, 2, 115],\n [1062, 28, 19, 46, 4, 47],\n [754, 28, 28, 22, 6, 23],\n [596, 30, 33, 16, 4, 17],\n ],\n // v27\n [\n [1468, 30, 8, 122, 4, 123],\n [1128, 28, 22, 45, 3, 46],\n [808, 30, 8, 23, 26, 24],\n [628, 30, 12, 15, 28, 16],\n ],\n // v28\n [\n [1531, 30, 3, 117, 10, 118],\n [1193, 28, 3, 45, 23, 46],\n [871, 30, 4, 24, 31, 25],\n [661, 30, 11, 15, 31, 16],\n ],\n // v29\n [\n [1631, 30, 7, 116, 7, 117],\n [1267, 28, 21, 45, 7, 46],\n [911, 30, 1, 23, 37, 24],\n [701, 30, 19, 15, 26, 16],\n ],\n // v30\n [\n [1735, 30, 5, 115, 10, 116],\n [1373, 28, 19, 47, 10, 48],\n [985, 30, 15, 24, 25, 25],\n [745, 30, 23, 15, 25, 16],\n ],\n // v31\n [\n [1843, 30, 13, 115, 3, 116],\n [1455, 28, 2, 46, 29, 47],\n [1033, 30, 42, 24, 1, 25],\n [793, 30, 23, 15, 28, 16],\n ],\n // v32\n [\n [1955, 30, 17, 115],\n [1541, 28, 10, 46, 23, 47],\n [1115, 30, 10, 24, 35, 25],\n [845, 30, 19, 15, 35, 16],\n ],\n // v33\n [\n [2071, 30, 17, 115, 1, 116],\n [1631, 28, 14, 46, 21, 47],\n [1171, 30, 29, 24, 19, 25],\n [901, 30, 11, 15, 46, 16],\n ],\n // v34\n [\n [2191, 30, 13, 115, 6, 116],\n [1725, 28, 14, 46, 23, 47],\n [1231, 30, 44, 24, 7, 25],\n [961, 30, 59, 16, 1, 17],\n ],\n // v35\n [\n [2306, 30, 12, 121, 7, 122],\n [1812, 28, 12, 47, 26, 48],\n [1286, 30, 39, 24, 14, 25],\n [986, 30, 22, 15, 41, 16],\n ],\n // v36\n [\n [2434, 30, 6, 121, 14, 122],\n [1914, 28, 6, 47, 34, 48],\n [1354, 30, 46, 24, 10, 25],\n [1054, 30, 2, 15, 64, 16],\n ],\n // v37\n [\n [2566, 30, 17, 122, 4, 123],\n [1992, 28, 29, 46, 14, 47],\n [1426, 30, 49, 24, 10, 25],\n [1096, 30, 24, 15, 46, 16],\n ],\n // v38\n [\n [2702, 30, 4, 122, 18, 123],\n [2102, 28, 13, 46, 32, 47],\n [1502, 30, 48, 24, 14, 25],\n [1142, 30, 42, 15, 32, 16],\n ],\n // v39\n [\n [2812, 30, 20, 117, 4, 118],\n [2216, 28, 40, 47, 7, 48],\n [1582, 30, 43, 24, 22, 25],\n [1222, 30, 10, 15, 67, 16],\n ],\n // v40\n [\n [2956, 30, 19, 118, 6, 119],\n [2334, 28, 18, 47, 31, 48],\n [1666, 30, 34, 24, 34, 25],\n [1276, 30, 20, 15, 61, 16],\n ],\n];\n\n/** Look up the block specification for a (version, ECC) pair. */\nexport function getBlockSpec(version: number, ecc: ErrorCorrectionLevel): BlockSpec {\n const row = ECC_TABLE[version - 1];\n if (!row) throw new RangeError(`Version ${version} out of range (1-40)`);\n const entry = row[ECC_INDEX[ecc]];\n if (!entry) throw new RangeError(`No spec for version ${version} ECC ${ecc}`);\n const dataCodewords = entry[0] ?? 0;\n const ecPerBlock = entry[1] ?? 0;\n const groups: Array = [];\n for (let i = 2; i < entry.length; i += 2) {\n const count = entry[i] ?? 0;\n const dataPerBlock = entry[i + 1] ?? 0;\n groups.push([count, dataPerBlock]);\n }\n return { dataCodewords, ecPerBlock, groups };\n}\n\n/** Total codewords (data + ECC) on the wire for a given version. */\nexport function totalCodewords(version: number, ecc: ErrorCorrectionLevel): number {\n const spec = getBlockSpec(version, ecc);\n let blocks = 0;\n for (const [count] of spec.groups) blocks += count;\n return spec.dataCodewords + blocks * spec.ecPerBlock;\n}\n\n/** Locations of alignment-pattern centres for a given version. */\nexport function alignmentCentres(version: number): readonly number[] {\n if (version === 1) return [];\n const count = Math.floor(version / 7) + 2;\n const dim = moduleCount(version);\n const last = dim - 7;\n const step = version === 32 ? 26 : 2 * Math.ceil((last - 6) / (2 * (count - 1)));\n // Walk backwards from `last` toward 6, prepending each centre until we\n // have `count` entries (the first being the fixed 6 at the top-left\n // finder edge). Returned in ascending order so callers can iterate\n // predictably.\n const centres: number[] = [6];\n for (let pos = last; centres.length < count; pos -= step) {\n centres.unshift(pos);\n }\n return centres.sort((a, b) => a - b);\n}\n","/**\n * Card composer: Thai QR Payment header + PromptPay sub-mark + QR\n * matrix + centre-overlay icon. Layout + sizing follows the official\n * BOT/TBA Thai QR Payment brand guideline:\n *\n * - Card aspect 7.4 cm × 10.5 cm (0.7048) — portrait-ish\n * - Navy `#00427A` (\"TQR Maximum Blue\", brand book §4)\n * - Header band ~75 % of card width, ~3.5 : 1 aspect\n * - PromptPay sub-mark *left-aligned* under the header (narrow strip)\n * - QR ~85 % of card width, centred\n * - Centre-overlay icon ~10 % of QR (ECC-H recovers the obscured modules)\n *\n * ┌──────────────────────────┐\n * │ ▓ THAI QR PAYMENT ▓ │ navy band, tight content crop\n * │ ⎡Pmt⎤ │ left-aligned narrow sub-mark\n * ├──────────────────────────┤\n * │ ▓▓▓▓▓▓▓▓▓▓▓▓▓ │\n * │ ▓▓▓▓▓ ┌┐ ▓▓▓▓▓ │\n * │ ▓▓▓▓▓ └┘ ▓▓▓▓▓ │ small icon overlay (~10%)\n * │ ▓▓▓▓▓▓▓▓▓▓▓▓▓ │\n * ├──────────────────────────┤\n * │ optional merchant name │\n * │ optional amount label │\n * └──────────────────────────┘\n *\n * Theme rules:\n * - `theme: 'color'` (default) → Thai_QR_Payment_Logo-01 + PromptPay2 (navy)\n * - `theme: 'silhouette'` → silhouette variant + PromptPay1 (black/white)\n *\n * Default PromptPay variant is `PromptPay2` (color theme) because the\n * brand book pairs the navy header with the navy PromptPay sub-mark.\n * Callers can override with `promptpayLogo` to pick `PromptPay1` (the\n * monochrome rounded-border variant) regardless of theme.\n */\n\nimport { COLOR_LOGOS, SILHOUETTE_LOGOS } from '@thai-qr-payment/assets';\nimport type { QRMatrix } from '@thai-qr-payment/qr';\nimport { escapeXmlAttribute, matrixToPath } from './matrix-svg.js';\n\nexport type CardTheme = 'color' | 'silhouette';\n\nexport interface CardOptions {\n /** Brand artwork flavor. `color` keeps full fidelity, `silhouette` is monochrome. */\n theme?: CardTheme;\n /**\n * Render the caption block (merchant name + amount) below the QR.\n * Defaults to `false` — opt in explicitly, then supply the text via\n * `merchantName` / `amountLabel`.\n */\n showCaption?: boolean;\n /** Optional amount label rendered below the QR. Requires `showCaption`. */\n amountLabel?: string;\n /** Optional merchant name rendered below the QR (above the amount). Requires `showCaption`. */\n merchantName?: string;\n /** Background colour of the entire card. */\n background?: string;\n /** Foreground / accent colour for text + silhouette artwork. */\n accent?: string;\n /** QR module fill colour. Defaults to `#000000` for max scanner contrast. */\n qrColor?: string;\n /** Override the Thai QR Payment header logo by registry name. */\n headerLogo?: keyof typeof COLOR_LOGOS;\n /** Override the PromptPay sub-mark by registry name. */\n promptpayLogo?: keyof typeof COLOR_LOGOS;\n /**\n * Overlay the Thai QR Payment icon at the centre of the QR matrix.\n * Defaults to `true` for `theme: 'color'`, `false` for `'silhouette'`.\n * Always pair with `encodeQR({ errorCorrectionLevel: 'Q' | 'H' })`\n * so the obscured modules are recoverable.\n */\n centerOverlay?: boolean;\n}\n\n// Canvas 600 × 800 (3 : 4). Mirrors kittinan's 1000×1200 5:6 plus 80 px\n// of footer room for optional merchant + amount labels.\nconst CANVAS = { width: 600, height: 800 } as const;\n\n// Header band — full canvas width, ~6:1 aspect (BOT/TBA reference).\n// Acts as a solid navy strip; the logo sits centred inside with\n// generous padding rather than filling the band edge-to-edge.\nconst HEADER_BAND = { x: 0, y: 0, width: 600, height: 110 } as const;\n\n// Logo placement inside the header band — 40 % of canvas width,\n// centred horizontally with vertical padding.\nconst HEADER_LOGO = { x: 195, y: 15, width: 210, height: 80 } as const;\n\n// PromptPay sub-mark — centred under the header. PromptPay2 native\n// aspect 384 : 130 ≈ 2.95 : 1; we scale to 260 × 88 for a chunky\n// readable mark matching the brand reference.\nconst PROMPTPAY_BAND = { x: 170, y: 140, width: 260, height: 88 } as const;\n\n// QR frame — 500 × 500 (83 % of canvas width, larger than v6 to\n// match the brand reference's QR-dominant layout).\nconst QR_FRAME = { x: 50, y: 250, width: 500, height: 500 } as const;\nconst QR_INSET = 14;\nconst QR_BAND = {\n x: QR_FRAME.x + QR_INSET,\n y: QR_FRAME.y + QR_INSET,\n width: QR_FRAME.width - QR_INSET * 2,\n height: QR_FRAME.height - QR_INSET * 2,\n} as const;\n\n// Tight content bbox of `Thai_QR_Payment_Logo-01.svg`. The raw asset\n// is 913 × 376 with ~90 px of empty navy padding top/bottom and ~80 px\n// each side. Cropping to the actual icon+wordmark bbox yields the\n// brand-guide aspect (~3.55 : 1) and removes the floating-in-empty-navy\n// look the previous full-viewBox render produced.\nconst HEADER_VIEWBOX_CROP = '88 75 750 210';\n\n// Icon-only viewBox for the centre overlay. The icon glyph lives at\n// roughly x = 88..318 of the original 0..913 viewBox; we keep the full\n// vertical extent so the navy bg paints the centre overlay square.\nconst ICON_WIDTH = 325;\nconst ICON_HEIGHT = 376;\nconst ICON_VIEWBOX = `0 0 ${ICON_WIDTH} ${ICON_HEIGHT}`;\n/** White breathing room between the centre logo and the QR modules. */\nconst OVERLAY_PAD = 4;\n\n/** Strip the outer `` wrapper so the contents can be reused inside a ``. */\nfunction unwrapSvg(svg: string): { viewBox: string; inner: string } {\n const viewBoxMatch = svg.match(/viewBox=\"([^\"]+)\"/);\n let viewBox = viewBoxMatch?.[1];\n if (viewBox == null) {\n // Asset has no explicit viewBox — derive from width/height. Many\n // hand-authored / Illustrator-exported SVGs omit the viewBox and\n // rely on width/height alone; without this fallback the symbol\n // defaults to \"0 0 100 100\" and the artwork renders 0.5-px tall.\n const widthMatch = svg.match(/]*\\swidth=\"([\\d.]+)\"/);\n const heightMatch = svg.match(/]*\\sheight=\"([\\d.]+)\"/);\n if (widthMatch != null && heightMatch != null) {\n viewBox = `0 0 ${widthMatch[1]} ${heightMatch[1]}`;\n } else {\n viewBox = '0 0 100 100';\n }\n }\n // Some assets (vtracer output) ship with leading ``\n // and/or `` comments before the `