@things-factory/invoice 10.1.223 → 10.1.227

package/dist-shared/invoice-standing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-standing.js","sourceRoot":"","sources":["../shared/invoice-standing.ts"],"names":[],"mappings":"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","sourcesContent":["import { currencyDigits } from './currency-digits.js'\n\n/*\n * How the invoice list reads its rows (ADR-0170 decision 11). Pure.\n */\n\ntype Row = { status?: string | null; dueDate?: string | null; direction?: string | null; currency?: string | null; totalAmount?: number | string | null }\n\n/**\n * Whether an invoice is past its due date: issued and due before `today`. Read only from its status and due date - the\n * invoice module keeps no payments (an application ties them, as Office does), so a paid invoice past its day reads\n * overdue here too.\n */\nexport function overdue(row: Row, today: string): boolean {\n  return row.status === 'ISSUED' && !!row.dueDate && row.dueDate < today\n}\n\n/**\n * The total of the rows by direction and currency - the sales and the purchases apart, each currency apart, voided\n * invoices left out: an invoice cancelled bills nothing. Counted in the currency's minor unit.\n */\nexport function totalsOf(rows: readonly Row[]): { direction: string; currency: string; amount: number }[] {\n  const sums = new Map<string, { direction: string; currency: string; minor: number; digits: number }>()\n  for (const row of rows) {\n    if (row.status === 'VOID') continue\n    const currency = row.currency || 'KRW'\n    const direction = row.direction === 'PURCHASE' ? 'PURCHASE' : 'SALES'\n    const digits = currencyDigits(currency) ?? 0\n    const key = `${direction}:${currency}`\n    const sum = sums.get(key) ?? { direction, currency, minor: 0, digits }\n    sum.minor += Math.round(Number(row.totalAmount ?? 0) * 10 ** digits)\n    sums.set(key, sum)\n  }\n  return [...sums.values()]\n    .sort((a, b) => a.direction.localeCompare(b.direction, 'en') * -1 || a.currency.localeCompare(b.currency, 'en'))\n    .map(({ direction, currency, minor, digits }) => ({ direction, currency, amount: minor / 10 ** digits }))\n}\n\n/** The first and last day (YYYY-MM-DD) of a period the list is narrowed to, around `day`; undefined for every period. */\nexport function issuePeriodOf(period: string, day: string): [string, string] | undefined {\n  const [year, month] = day.split('-').map(Number)\n  const pad = (n: number) => String(n).padStart(2, '0')\n  const monthOf = (y: number, m: number): [string, string] => [`${y}-${pad(m)}-01`, `${y}-${pad(m)}-${pad(new Date(Date.UTC(y, m, 0)).getUTCDate())}`]\n  if (period === 'this-month') return monthOf(year, month)\n  if (period === 'last-month') return month === 1 ? monthOf(year - 1, 12) : monthOf(year, month - 1)\n  if (period === 'this-year') return [`${year}-01-01`, `${year}-12-31`]\n  if (period === 'last-year') return [`${year - 1}-01-01`, `${year - 1}-12-31`]\n  return undefined\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/invoice",
-  "version": "10.1.223",
+  "version": "10.1.227",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -32,11 +32,13 @@
     "@operato/shell": "^10.0.0",
     "@operato/styles": "^10.29.1",
     "@operato/utils": "^10.0.0",
-    "@things-factory/ai-assistant": "^10.1.223",
-    "@things-factory/attachment-base": "^10.1.223",
-    "@things-factory/auth-base": "^10.1.223",
-    "@things-factory/biz-base": "^10.1.223",
-    "@things-factory/shell": "^10.1.208",
+    "@things-factory/ai-assistant": "^10.1.227",
+    "@things-factory/attachment-base": "^10.1.227",
+    "@things-factory/auth-base": "^10.1.227",
+    "@things-factory/biz-base": "^10.1.227",
+    "@things-factory/pdf": "^10.1.227",
+    "@things-factory/setting-base": "^10.1.227",
+    "@things-factory/shell": "^10.1.227",
     "graphql-upload": "^15.0.2"
   },
   "publishConfig": {
@@ -49,5 +51,5 @@
     "url": "git+https://github.com/hatiolab/things-factory.git",
     "directory": "packages/invoice"
   },
-  "gitHead": "868f2026b8373371ad04f42b0a097964d0d0ed0f"
+  "gitHead": "f66591e3864aab08a6fb93fb1fcf1c9de6b546ac"
 }

package/shared/document-amounts.ts

@@ -0,0 +1,209 @@
+import { currencyDigits } from './currency-digits.js'
+
+/*
+ * A commercial document's arithmetic - the one place it is decided, read by the invoice and quotation services when a
+ * document is saved and by their screens while it is typed, so a line's supply and the totals on screen are the
+ * ones the document will keep (ADR-0120 decision 4).
+ *
+ *   - Lines carry supply and a tax kind and rate; the tax is reckoned once per (kind, rate) group: the group's supply
+ *     total × rate ÷ 100, rounded half-up to the currency's minor unit. The document tax is the sum of the groups.
+ *   - A discount of the whole document comes off the lines' supply before tax (ADR-0170 decision 8): it is spread over
+ *     the groups in proportion to each group's supply, in minor units, the remainder going one unit at a time to the
+ *     groups whose share was cut most (largest remainder), so the parts add up to the discount exactly. Each group's
+ *     tax is reckoned on its supply after its part.
+ *   - Everything is counted in integers: quantities, prices and rates to four decimals, money in minor units.
+ *   - A received document keeps the tax its sender printed on each line; nothing recomputes it.
+ *
+ * No imports but the currency's digits and no throwing: a line that cannot be reckoned says why (`problem`), and is
+ * left out of the totals. The server refuses such a document; a screen shows the rest while the line is typed.
+ */
+
+export type TaxKindCode = 'TAXABLE' | 'ZERO_RATED' | 'EXEMPT'
+
+export const TAX_KINDS: readonly TaxKindCode[] = ['TAXABLE', 'ZERO_RATED', 'EXEMPT']
+
+export interface DocumentLine {
+  description?: string | null
+  quantity?: number | string | null
+  unitPrice?: number | string | null
+  discount?: number | string | null
+  taxKind?: string | null
+  taxRate?: number | string | null
+  /** The tax the sender printed on the line - only on a received document. */
+  receivedTaxAmount?: number | string | null
+}
+
+/** Why a line cannot be reckoned - the server's refusal codes, `invoice-<problem>`. */
+export type LineProblem = 'item-invalid' | 'discount-exceeds' | 'amount-too-large' | 'received-tax-required'
+
+export interface ReckonedLine {
+  /** The line's supply - quantity × unit price, less the discount - in the currency. Absent when the line has a problem. */
+  supplyAmount?: number
+  /** The tax the sender printed, on a received document. */
+  receivedTaxAmount?: number | null
+  problem?: LineProblem
+}
+
+export interface TaxGroup {
+  taxKind: string
+  taxRate: number
+  supplyAmount: number
+  taxAmount: number
+}
+
+/** Why the discount of the whole document cannot be taken - the server's refusal code, `invoice-<problem>`. */
+export type DiscountProblem = 'document-discount-invalid'
+
+export interface DocumentAmounts {
+  lines: ReckonedLine[]
+  /** Each group's supply after its part of the document discount, and its tax. */
+  taxGroups: TaxGroup[]
+  /** The lines' supply before the document discount. */
+  lineSupplyAmount: number
+  /** The discount of the whole document taken off the lines' supply - none when it has a problem. */
+  discountAmount: number
+  /** A discount below zero, past the lines' supply or finer than the currency's minor unit; it is not taken. */
+  discountProblem?: DiscountProblem
+  /** The lines' supply less the document discount - the supply tax is reckoned on. */
+  supplyAmount: number
+  taxAmount: number
+  totalAmount: number
+  /** The totals pass the largest amount a document may carry. */
+  tooLarge: boolean
+}
+
+/** The rate a tax kind takes unless the person writes another: the standard VAT for a taxable line, none otherwise. */
+export function defaultTaxRate(taxKind: string | null | undefined, standard = 10): number {
+  return taxKind === 'ZERO_RATED' || taxKind === 'EXEMPT' ? 0 : standard
+}
+
+const MAX_MINOR = 10n ** 14n
+const SCALE = 10_000n
+
+const numberOf = (value: unknown): number => (typeof value === 'number' ? value : value === null || value === undefined || value === '' ? NaN : Number(value))
+
+/** A number with at most four decimals, as an integer of ten-thousandths; undefined when it has more. */
+function scaled(value: unknown): bigint | undefined {
+  const number = numberOf(value)
+  if (!Number.isFinite(number)) return undefined
+  const whole = Math.round(number * 10_000)
+  return Math.abs(number * 10_000 - whole) > 1e-6 ? undefined : BigInt(whole)
+}
+
+function minorOf(value: unknown, digits: number): bigint | undefined {
+  const number = numberOf(value)
+  if (!Number.isFinite(number)) return undefined
+  const factor = 10 ** digits
+  const whole = Math.round(number * factor)
+  return Math.abs(number * factor - whole) > 1e-6 ? undefined : BigInt(whole)
+}
+
+/** numerator ÷ denominator, rounded half-up; both non-negative. */
+function divideHalfUp(numerator: bigint, denominator: bigint): bigint {
+  return (numerator * 2n + denominator) / (denominator * 2n)
+}
+
+const amountOf = (minor: bigint, digits: number) => Number(minor) / 10 ** digits
+
+/**
+ * Each line's supply, the tax of each (kind, rate) group and the document totals, in the currency (whose digits must
+ * be known - `currencyDigits`). `received` keeps the line tax the sender printed; otherwise the groups reckon it. A
+ * blank discount is none; a blank quantity, price, kind or rate is a line not yet reckonable. `discountAmount` is the
+ * discount of the whole document; a blank one is none. On a received document it lowers the supply, and the tax stays
+ * as printed.
+ */
+export function documentAmounts(lines: readonly DocumentLine[], currency: string, received = false, discountAmount: unknown = 0): DocumentAmounts {
+  const digits = currencyDigits(currency) ?? 0
+  const factor = 10n ** BigInt(digits)
+  const groups = new Map<string, { taxKind: string; rate: bigint; supply: bigint; tax: bigint }>()
+
+  const reckoned = lines.map((line): ReckonedLine => {
+    const quantity = scaled(line.quantity)
+    const unitPrice = scaled(line.unitPrice)
+    const rate = scaled(line.taxRate)
+    const discount = line.discount === null || line.discount === undefined || line.discount === '' ? 0n : minorOf(line.discount, digits)
+    const kind = String(line.taxKind ?? '')
+    if (
+      !String(line.description ?? '').trim() ||
+      quantity === undefined ||
+      unitPrice === undefined ||
+      rate === undefined ||
+      discount === undefined ||
+      quantity <= 0n ||
+      unitPrice < 0n ||
+      discount < 0n ||
+      rate < 0n ||
+      rate > 100n * SCALE ||
+      !TAX_KINDS.includes(kind as TaxKindCode) ||
+      (kind !== 'TAXABLE' && rate !== 0n)
+    ) {
+      return { problem: 'item-invalid' }
+    }
+
+    const gross = divideHalfUp(quantity * unitPrice * factor, SCALE * SCALE)
+    if (discount > gross) return { problem: 'discount-exceeds' }
+    const supply = gross - discount
+    if (supply > MAX_MINOR) return { problem: 'amount-too-large' }
+
+    let printed: bigint | undefined
+    if (received) {
+      printed = line.receivedTaxAmount === null || line.receivedTaxAmount === undefined || line.receivedTaxAmount === '' ? undefined : minorOf(line.receivedTaxAmount, digits)
+      if (printed === undefined || printed < 0n) return { supplyAmount: amountOf(supply, digits), problem: 'received-tax-required' }
+    }
+
+    const key = `${kind}:${rate}`
+    const group = groups.get(key) ?? { taxKind: kind, rate, supply: 0n, tax: 0n }
+    group.supply += supply
+    if (printed !== undefined) group.tax += printed
+    groups.set(key, group)
+
+    return { supplyAmount: amountOf(supply, digits), receivedTaxAmount: printed === undefined ? null : amountOf(printed, digits) }
+  })
+
+  const kept = [...groups.values()]
+  const lineSupply = kept.reduce((sum, group) => sum + group.supply, 0n)
+  const asked = discountAmount === null || discountAmount === undefined || discountAmount === '' ? 0n : minorOf(discountAmount, digits)
+  const discountProblem: DiscountProblem | undefined = asked === undefined || asked < 0n || asked > lineSupply ? 'document-discount-invalid' : undefined
+  const discount = discountProblem ? 0n : asked!
+  const parts = shares(discount, kept.map(group => group.supply))
+
+  let supply = 0n
+  let tax = 0n
+  const taxGroups = kept.map((group, index) => {
+    group.supply -= parts[index]
+    if (!received) group.tax = divideHalfUp(group.supply * group.rate, 100n * SCALE)
+    supply += group.supply
+    tax += group.tax
+    return { taxKind: group.taxKind, taxRate: Number(group.rate) / 10_000, supplyAmount: amountOf(group.supply, digits), taxAmount: amountOf(group.tax, digits) }
+  })
+
+  return {
+    lines: reckoned,
+    taxGroups,
+    lineSupplyAmount: amountOf(lineSupply, digits),
+    discountAmount: amountOf(discount, digits),
+    ...(discountProblem ? { discountProblem } : {}),
+    supplyAmount: amountOf(supply, digits),
+    taxAmount: amountOf(tax, digits),
+    totalAmount: amountOf(supply + tax, digits),
+    tooLarge: lineSupply > MAX_MINOR || supply + tax > MAX_MINOR
+  }
+}
+
+/**
+ * `total` split in proportion to `weights`, in whole units: each its share cut down, then the units left over one
+ * at a time to the largest cut-off remainders (the first of equal ones first), so the parts add up to `total`.
+ */
+function shares(total: bigint, weights: readonly bigint[]): bigint[] {
+  const whole = weights.reduce((sum, weight) => sum + weight, 0n)
+  if (!total || !whole) return weights.map(() => 0n)
+  const parts = weights.map(weight => (total * weight) / whole)
+  let left = total - parts.reduce((sum, part) => sum + part, 0n)
+  const byRemainder = weights.map((weight, index) => ({ index, remainder: (total * weight) % whole })).sort((a, b) => (a.remainder === b.remainder ? a.index - b.index : a.remainder > b.remainder ? -1 : 1))
+  for (const { index } of byRemainder) {
+    if (left <= 0n) break
+    parts[index] += 1n
+    left -= 1n
+  }
+  return parts
+}

package/shared/document-money.ts

@@ -0,0 +1,33 @@
+import { currencyDigits } from './currency-digits.js'
+
+/*
+ * How a commercial document writes money - the one place it is decided, read by the screens (in the screen's
+ * language, client/document/document-amount.ts) and by the print the server makes (in the print's language,
+ * document-print.ts). No i18n: the language comes in as a parameter.
+ */
+
+const unset = (value: unknown) => value === null || value === undefined || value === '' || !Number.isFinite(Number(value))
+
+/**
+ * An amount in its currency as the language writes money (2026-10-28, the user: 「한글인 경우에는 KRW보다는 '원'이 더 좋을
+ * 것 같다」): won in Korean reads 「5,000,000원」; every other pair takes the language's own currency form - 「₩5,000,000」
+ * and 「$12,000.00」 in English, 「US$12,000.00」 in Korean - with exactly the currency's decimal places. A code the
+ * platform does not know is written plainly.
+ */
+export function documentAmount(value: number | string | null | undefined, currency: string, lng: string): string {
+  if (unset(value)) return ''
+  const digits = currencyDigits(currency)
+  if (digits === undefined) return `${currency} ${Number(value).toLocaleString(lng)}`
+  if (lng.split('-')[0] === 'ko' && currency === 'KRW') return `${Number(value).toLocaleString('ko', { minimumFractionDigits: digits, maximumFractionDigits: digits })}원`
+  return new Intl.NumberFormat(lng, { style: 'currency', currency, minimumFractionDigits: digits, maximumFractionDigits: digits }).format(Number(value))
+}
+
+/**
+ * A number without the currency - a price or a discount in a table of lines: as typed (up to four decimals), or with
+ * exactly the currency's decimal places when `exact` (a printed amount).
+ */
+export function documentNumber(value: number | string | null | undefined, currency: string, lng: string, exact = false): string {
+  if (unset(value)) return ''
+  const digits = currencyDigits(currency) ?? 0
+  return Number(value).toLocaleString(lng, exact ? { minimumFractionDigits: digits, maximumFractionDigits: digits } : { minimumFractionDigits: 0, maximumFractionDigits: Math.max(digits, 4) })
+}

package/shared/document-print.ts

@@ -0,0 +1,131 @@
+import { documentAmount, documentNumber } from './document-money.js'
+
+/*
+ * A commercial document as the buyer reads it - the one layout every print of an invoice or a quotation is, made by
+ * the server from the stored document (ADR-0170 decision 10): the preview's page, the PDF to download and what the
+ * browser prints are this page. Pure - no i18next: the words come in as a translator of the print's language.
+ */
+
+export type PrintedDocument = Record<string, any>
+
+/** The languages the print has words for - this package's and sales' print words in each (ADR-0170 decision 9). */
+export const PRINT_LANGUAGES = ['ko', 'en'] as const
+export type PrintLanguage = (typeof PRINT_LANGUAGES)[number]
+
+/** The language as one the print has words for, or undefined - the caller refuses it or falls back. */
+export function printLanguageOf(language: unknown): PrintLanguage | undefined {
+  return (PRINT_LANGUAGES as readonly unknown[]).includes(language) ? (language as PrintLanguage) : undefined
+}
+
+export type PrintOptions = {
+  /** The language of the print - its words and how it writes money. */
+  language: PrintLanguage
+  /** The words of the print, in `language`. */
+  t: (key: string) => string
+  /** The kind's title - 「청구서」, 「견적서」. */
+  title: string
+  /** The kind's own terms beside the number - the due date; the version and the last day of an offer. */
+  terms: { label: string; value?: string | null }[]
+  /** How the kind names its number. */
+  numberLabel?: string
+}
+
+const escape = (text: unknown) => String(text ?? '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c]!)
+
+/** The look of the printed page - A4 with its margins. */
+export const DOCUMENT_CSS = `
+  @page{size:A4;margin:18mm}
+  body{font:13px/1.5 system-ui,sans-serif;color:#000}
+  h1{font-size:26px;margin:0}
+  h2{font-size:13px;color:#555;margin:0 0 4px}
+  header,.parties{display:flex;justify-content:space-between;gap:32px}
+  .parties section{flex:1}
+  table{width:100%;border-collapse:collapse;margin:24px 0}
+  th,td{padding:8px;border-bottom:1px solid #999;text-align:right;font-variant-numeric:tabular-nums}
+  th:first-child,td:first-child{text-align:left}
+  .text{white-space:pre-wrap}
+  .totals{width:50%;margin-left:auto}
+  .grand td{font-weight:600;font-size:15px}
+  tr{break-inside:avoid}
+`
+
+/**
+ * On a screen, the page as a sheet of A4 on a grey desk with the print's margins - the preview reads as the PDF will.
+ * Printing and the PDF read the print media, where none of this applies.
+ */
+export const DOCUMENT_SCREEN_CSS = `
+@media screen {
+  html{background:#e9edf1}
+  body{margin:0;padding:24px 0}
+  .sheet{box-sizing:border-box;width:210mm;min-height:297mm;margin:0 auto;padding:18mm;background:#fff;
+    box-shadow:0 1px 3px rgba(23,36,44,.12),0 8px 24px rgba(23,36,44,.08)}
+}
+@media screen and (max-width:210mm) {
+  .sheet{width:auto;min-height:0;margin:0 8px;padding:8mm}
+}
+`
+
+/** The document's sheet - the head, the parties, the lines, the totals and the terms - without a page around it. */
+export function documentBody(document: PrintedDocument, { language, t: word, title, terms, numberLabel = 'field.invoice-number' }: PrintOptions): string {
+  const t = (key: string) => escape(word(key))
+  /* A table's cells carry numbers; the total carries its currency, as the print's language writes money. */
+  const amount = (value: number) => escape(documentNumber(value ?? 0, document.currency, language, true))
+  const money = (value: number) => escape(documentAmount(value ?? 0, document.currency, language))
+  const kind = (taxKind: string) =>
+    taxKind === 'ZERO_RATED' ? t('text.invoice-tax-kind-zero-rated') : taxKind === 'EXEMPT' ? t('text.invoice-tax-kind-exempt') : t('text.invoice-tax-kind-taxable')
+  const party = (label: string, name: string, address: string, number: string) =>
+    `<section><h2>${label}</h2><strong>${escape(name)}</strong><p class="text">${escape(address)}</p><p>${escape(number)}</p></section>`
+
+  return `<div class="sheet">
+  <header><h1>${escape(title)}</h1><div><p>${t(numberLabel)}: ${escape(document.number)}</p><p>${t('field.invoice-issue-date')}: ${escape(document.issueDate)}</p>${terms
+    .map(one => `<p>${escape(one.label)}: ${escape(one.value)}</p>`)
+    .join('')}</div></header>
+  <div class="parties">${party(t('field.invoice-supplier-name'), document.supplierName, document.supplierAddress, document.supplierRegistrationNumber)}${party(
+    t('field.invoice-buyer-name'),
+    document.buyerName,
+    document.buyerAddress,
+    document.buyerRegistrationNumber
+  )}</div>
+  ${document.purchaseOrder ? `<p>${t('field.invoice-purchase-order')}: ${escape(document.purchaseOrder)}</p>` : ''}
+  <table><thead><tr><th>${t('field.invoice-line-description')}</th><th>${t('field.invoice-quantity')}</th><th>${t('field.invoice-unit')}</th><th>${t('field.invoice-unit-price')}</th><th>${t(
+    'field.invoice-discount'
+  )}</th><th>${t('field.invoice-tax-kind')}</th><th>${t('field.invoice-supply-amount')}</th></tr></thead><tbody>${(document.items ?? [])
+    .map(
+      (item: any) =>
+        `<tr><td>${escape(item.description)}</td><td>${escape(item.quantity)}</td><td>${escape(item.unit)}</td><td>${amount(item.unitPrice)}</td><td>${amount(item.discount)}</td><td>${kind(item.taxKind)} ${escape(
+          item.taxRate
+        )}%</td><td>${amount(item.supplyAmount)}</td></tr>`
+    )
+    .join('')}</tbody></table>
+  <table class="totals"><tbody>${
+    Number(document.discountAmount) > 0
+      ? `<tr><td>${t('field.invoice-line-sum')}</td><td>${amount(document.lineSupplyAmount)}</td><td></td></tr><tr><td>${t('field.invoice-discount')}</td><td>− ${amount(document.discountAmount)}</td><td></td></tr>`
+      : ''
+  }${(document.taxGroups ?? [])
+    .map((group: any) => `<tr><td>${kind(group.taxKind)} ${escape(group.taxRate)}%</td><td>${amount(group.supplyAmount)}</td><td>${amount(group.taxAmount)}</td></tr>`)
+    .join('')}<tr><td>${t('field.invoice-sum')}</td><td>${amount(document.supplyAmount)}</td><td>${amount(document.taxAmount)}</td></tr><tr class="grand"><td colspan="2">${t(
+    'field.invoice-total-amount'
+  )}</td><td>${money(document.totalAmount)}</td></tr></tbody></table>
+  ${['paymentTerms', 'bankDetails', 'notes']
+    .filter(key => document[key])
+    .map(key => `<p class="text">${escape(document[key])}</p>`)
+    .join('')}
+  </div>`
+}
+
+/**
+ * The document as one HTML page - what the preview shows and the browser prints. Only escaped business data enters
+ * the page.
+ */
+export function documentHtml(document: PrintedDocument, options: PrintOptions): string {
+  return `<!doctype html><html lang="${options.language}"><head><meta charset="utf-8"><title>${escape(document.number)}</title><style>${DOCUMENT_CSS}${DOCUMENT_SCREEN_CSS}</style></head><body>${documentBody(
+    document,
+    options
+  )}</body></html>`
+}
+
+/** 「견적서-Q2026-001.pdf」 - the kind's word and the number, without what a file name may not hold. */
+export function documentFileName(word: string, number: string, extension: 'html' | 'pdf'): string {
+  const safe = (text: string) => String(text ?? '').trim().replace(/[\\/:*?"<>|\s]+/g, '-')
+  return `${[safe(word), safe(number)].filter(Boolean).join('-')}.${extension}`
+}

package/shared/document-start.ts

@@ -0,0 +1,46 @@
+/*
+ * What a new commercial document starts with, so a person writes only what is new (ADR-0170 decisions 5 · 11) - the
+ * next number, the day a term ends, the counterparty its party's name is. Pure: the screens ask the server for what
+ * these read and test them without a browser.
+ */
+
+/** The day `days` after `day` (YYYY-MM-DD), counted in calendar days. */
+export function daysAfter(day: string, days: number): string {
+  const at = new Date(`${day}T00:00:00Z`)
+  if (Number.isNaN(at.getTime())) return ''
+  at.setUTCDate(at.getUTCDate() + days)
+  return at.toISOString().slice(0, 10)
+}
+
+/**
+ * The number after `last`, the domain's most recent invoice number: its trailing digits one up, keeping their width
+ * and what comes before them - 「INV-2026-007」 → 「INV-2026-008」, 「A99」 → 「A100」. A year of four digits standing
+ * apart in it that is not `year` becomes `year` and the count starts again at one - 「INV-2025-017」 →
+ * 「INV-2026-001」. With nothing to follow - no number, or none ending in digits - 「INV-<year>-001」.
+ */
+export function nextInvoiceNumber(last: string | null | undefined, year: number): string {
+  const match = /^(.*?)(\d+)$/.exec(String(last ?? '').trim())
+  if (!match) return `INV-${year}-001`
+  const [, prefix, count] = match
+  const pad = (n: number) => String(n).padStart(count.length, '0')
+  /* A year apart from other digits - not the count itself, not part of a longer number. */
+  const years = [...prefix.matchAll(/(?<!\d)((?:19|20)\d{2})(?!\d)/g)]
+  const stale = years.find(one => Number(one[1]) !== year)
+  if (stale && !years.some(one => Number(one[1]) === year)) {
+    const at = stale.index!
+    return `${prefix.slice(0, at)}${year}${prefix.slice(at + 4)}${pad(1)}`
+  }
+  return `${prefix}${pad(Number(count) + 1)}`
+}
+
+/** Two names as the same name - case and spaces aside: 「(주) 하티오랩」 is 「(주)하티오랩」. */
+export function sameName(a: unknown, b: unknown): boolean {
+  const plain = (text: unknown) => String(text ?? '').replace(/\s+/g, '').toLowerCase()
+  return !!plain(a) && plain(a) === plain(b)
+}
+
+/** The one choice named `name`; none when no choice or more than one is - a guess would link the wrong party. */
+export function partyNamed<T extends { name?: string | null }>(name: unknown, choices: readonly T[]): T | undefined {
+  const named = choices.filter(one => sameName(one.name, name))
+  return named.length === 1 ? named[0] : undefined
+}

package/shared/invoice-standing.ts

@@ -0,0 +1,49 @@
+import { currencyDigits } from './currency-digits.js'
+
+/*
+ * How the invoice list reads its rows (ADR-0170 decision 11). Pure.
+ */
+
+type Row = { status?: string | null; dueDate?: string | null; direction?: string | null; currency?: string | null; totalAmount?: number | string | null }
+
+/**
+ * Whether an invoice is past its due date: issued and due before `today`. Read only from its status and due date - the
+ * invoice module keeps no payments (an application ties them, as Office does), so a paid invoice past its day reads
+ * overdue here too.
+ */
+export function overdue(row: Row, today: string): boolean {
+  return row.status === 'ISSUED' && !!row.dueDate && row.dueDate < today
+}
+
+/**
+ * The total of the rows by direction and currency - the sales and the purchases apart, each currency apart, voided
+ * invoices left out: an invoice cancelled bills nothing. Counted in the currency's minor unit.
+ */
+export function totalsOf(rows: readonly Row[]): { direction: string; currency: string; amount: number }[] {
+  const sums = new Map<string, { direction: string; currency: string; minor: number; digits: number }>()
+  for (const row of rows) {
+    if (row.status === 'VOID') continue
+    const currency = row.currency || 'KRW'
+    const direction = row.direction === 'PURCHASE' ? 'PURCHASE' : 'SALES'
+    const digits = currencyDigits(currency) ?? 0
+    const key = `${direction}:${currency}`
+    const sum = sums.get(key) ?? { direction, currency, minor: 0, digits }
+    sum.minor += Math.round(Number(row.totalAmount ?? 0) * 10 ** digits)
+    sums.set(key, sum)
+  }
+  return [...sums.values()]
+    .sort((a, b) => a.direction.localeCompare(b.direction, 'en') * -1 || a.currency.localeCompare(b.currency, 'en'))
+    .map(({ direction, currency, minor, digits }) => ({ direction, currency, amount: minor / 10 ** digits }))
+}
+
+/** The first and last day (YYYY-MM-DD) of a period the list is narrowed to, around `day`; undefined for every period. */
+export function issuePeriodOf(period: string, day: string): [string, string] | undefined {
+  const [year, month] = day.split('-').map(Number)
+  const pad = (n: number) => String(n).padStart(2, '0')
+  const monthOf = (y: number, m: number): [string, string] => [`${y}-${pad(m)}-01`, `${y}-${pad(m)}-${pad(new Date(Date.UTC(y, m, 0)).getUTCDate())}`]
+  if (period === 'this-month') return monthOf(year, month)
+  if (period === 'last-month') return month === 1 ? monthOf(year - 1, 12) : monthOf(year, month - 1)
+  if (period === 'this-year') return [`${year}-01-01`, `${year}-12-31`]
+  if (period === 'last-year') return [`${year - 1}-01-01`, `${year - 1}-12-31`]
+  return undefined
+}

package/translations/en.json

@@ -22,9 +22,7 @@
   "error.invoice-counterparty-not-found": "The counterparty was not found. Reload and choose again.",
   "error.invoice-file-not-on-invoice": "A file is not on this invoice. Reload and try again.",
   "field.invoice-bank-details": "Bank details",
-  "field.invoice-buyer-address": "Buyer address",
   "field.invoice-buyer-name": "Buyer",
-  "field.invoice-buyer-registration-number": "Buyer registration number",
   "field.invoice-counterpart": "Counterparty",
   "field.invoice-currency": "Currency",
   "field.invoice-direction": "Direction",
@@ -42,20 +40,25 @@
   "text.invoice-files-none": "No files attached.",
   "text.invoice-section-files": "Files",
   "button.invoice-counterparty-clear": "Clear",
-  "button.invoice-counterparty-find": "Find",
+  "button.invoice-download-pdf": "Download PDF",
+  "button.invoice-preview": "Preview",
   "text.invoice-counterparty-search": "Find by name or business number",
   "field.invoice-counterparty": "Counterparty",
   "field.invoice-payment-terms": "Payment terms",
   "field.invoice-purchase-order": "Purchase order",
   "field.invoice-quantity": "Quantity",
+  "field.invoice-unit": "Unit",
   "field.invoice-received-tax-amount": "Printed tax",
   "field.invoice-source-reference": "Source reference",
   "field.invoice-status": "Status",
   "field.invoice-sum": "Sum",
-  "field.invoice-supplier-address": "Supplier address",
   "field.invoice-supplier-name": "Supplier",
-  "field.invoice-supplier-registration-number": "Supplier registration number",
   "field.invoice-supply-amount": "Supply amount",
+  "field.invoice-document-discount": "Discount on the whole",
+  "field.invoice-line-sum": "Lines total",
+  "error.invoice-document-discount-invalid": "The discount is zero or more and at most the lines' supply.",
+  "error.invoice-print-language-invalid": "Print in Korean or English.",
+  "field.invoice-defaults-payment-days": "days an invoice is due",
   "field.invoice-tax-amount": "Tax",
   "field.invoice-tax-basis": "Tax basis",
   "field.invoice-tax-kind": "Taxation",
@@ -90,8 +93,31 @@
   "title.invoice-list": "Invoices",
   "title.invoice-new": "New invoice",
   "title.invoice-print": "INVOICE",
+  "title.invoice-print-language": "Print language",
   "task.invoice.reading.name": "Reading invoices",
   "task.invoice.reading.description": "Reads invoices.",
   "task.invoice.keeping.name": "Keeping invoices",
-  "task.invoice.keeping.description": "Reads and changes invoices."
+  "task.invoice.keeping.description": "Reads and changes invoices.",
+  "text.invoice-counterparty-none": "no counterparty found",
+  "field.invoice-party-name": "name",
+  "field.invoice-party-registration-number": "registration no.",
+  "field.invoice-party-address": "address",
+  "title.invoice-document-defaults": "quotation and invoice defaults",
+  "text.invoice-defaults-terms-hint": "One a line. The first is a new document's payment terms; the others are picked on the document.",
+  "field.invoice-defaults-valid-days": "days a quotation holds",
+  "task.invoice.defaults-reading.name": "reading the document defaults",
+  "task.invoice.defaults-reading.description": "Reads the company's words new quotations and invoices start with - our side, the account to pay into, the payment terms.",
+  "text.invoice-counterparty-unlinked": "Not linked to a counterparty - pick one above to link it.",
+  "text.invoice-filter-all-directions": "Sales and purchases",
+  "text.invoice-filter-all-statuses": "Any status",
+  "text.invoice-issue-confirm": "To {party} · total {total}. Once issued, its amounts cannot be changed.",
+  "text.invoice-issue-confirm-purchase": "From {party} · total {total}. Once issued, its amounts cannot be changed.",
+  "text.invoice-overdue": "Overdue",
+  "text.invoice-period-all": "Any period",
+  "text.invoice-period-last-month": "Last month",
+  "text.invoice-period-last-year": "Last year",
+  "text.invoice-period-this-month": "This month",
+  "text.invoice-period-this-year": "This year",
+  "text.invoice-totals-shown": "Totals on this page (voided left out)",
+  "title.invoice-preview": "Preview"
 }

package/translations/es.json

@@ -43,11 +43,14 @@
   "text.invoice-section-files": "Archivos",
   "button.invoice-counterparty-clear": "Quitar",
   "button.invoice-counterparty-find": "Buscar",
+  "button.invoice-download-pdf": "Descargar PDF",
+  "button.invoice-preview": "Vista previa",
   "text.invoice-counterparty-search": "Buscar por nombre o número fiscal",
   "field.invoice-counterparty": "Contraparte",
   "field.invoice-payment-terms": "Condiciones de pago",
   "field.invoice-purchase-order": "Pedido de compra",
   "field.invoice-quantity": "Cantidad",
+  "field.invoice-unit": "Unidad",
   "field.invoice-received-tax-amount": "Impuesto impreso",
   "field.invoice-source-reference": "Documento de origen",
   "field.invoice-status": "Estado",
@@ -56,6 +59,10 @@
   "field.invoice-supplier-name": "Proveedor",
   "field.invoice-supplier-registration-number": "Número de registro del proveedor",
   "field.invoice-supply-amount": "Importe del suministro",
+  "field.invoice-document-discount": "Descuento total",
+  "field.invoice-line-sum": "Total de líneas",
+  "error.invoice-document-discount-invalid": "El descuento debe ser cero o más y no superar el total de las líneas.",
+  "error.invoice-print-language-invalid": "Imprima en coreano o inglés.",
   "field.invoice-tax-amount": "Impuesto",
   "field.invoice-tax-basis": "Base del impuesto",
   "field.invoice-tax-kind": "Tributación",
@@ -90,8 +97,22 @@
   "title.invoice-list": "Facturas",
   "title.invoice-new": "Nueva factura",
   "title.invoice-print": "FACTURA",
+  "title.invoice-print-language": "Idioma de impresión",
   "task.invoice.reading.name": "Leer facturas",
   "task.invoice.reading.description": "Lee las facturas.",
   "task.invoice.keeping.name": "Mantener facturas",
-  "task.invoice.keeping.description": "Lee y modifica las facturas."
+  "task.invoice.keeping.description": "Lee y modifica las facturas.",
+  "text.invoice-counterparty-unlinked": "No vinculada a una contraparte: elija una arriba para vincularla.",
+  "text.invoice-filter-all-directions": "Ventas y compras",
+  "text.invoice-filter-all-statuses": "Cualquier estado",
+  "text.invoice-issue-confirm": "Para {party} · total {total}. Una vez emitida, sus importes no se pueden cambiar.",
+  "text.invoice-issue-confirm-purchase": "De {party} · total {total}. Una vez emitida, sus importes no se pueden cambiar.",
+  "text.invoice-overdue": "Vencida",
+  "text.invoice-period-all": "Cualquier periodo",
+  "text.invoice-period-last-month": "Mes pasado",
+  "text.invoice-period-last-year": "Año pasado",
+  "text.invoice-period-this-month": "Este mes",
+  "text.invoice-period-this-year": "Este año",
+  "text.invoice-totals-shown": "Totales de esta página (sin anuladas)",
+  "title.invoice-preview": "Vista previa"
 }