@tallyui/pos 0.1.0 → 2.0.0

package/src/register/__fixtures__/closure.json

@@ -0,0 +1,197 @@
+{
+  "closure": {
+    "number": 42,
+    "has_sales": true,
+    "has_payment_methods": true,
+    "has_tax_rates": true,
+    "has_perpetual": true,
+    "has_movements": true,
+
+    "store_id": 1,
+    "opened_at_gmt": "2026-09-11 08:00:00",
+    "closed_at_gmt": "2026-09-11 17:00:00",
+    "opened_by": 1,
+    "closed_by": 1,
+    "approved_by": 1,
+    "expected": {
+      "cash": "180.0000",
+      "card": "120.0000"
+    },
+    "counted": {
+      "cash": "178.0000",
+      "card": "120.0000"
+    },
+    "variance": {
+      "cash": "-2.0000",
+      "card": "0.0000"
+    },
+    "period_sales_total": "250.0000",
+    "period_refunds_total": "50.0000",
+    "perpetual_sales_total": "5250.0000",
+    "perpetual_refunds_total": "250.0000",
+    "unsynced_count": 2,
+    "unsynced_total": "12.0000",
+    "breakdowns": {
+      "currency": "USD",
+      "payment_methods": [
+        {
+          "method": "cash",
+          "name": "Cash",
+          "sales": "130.0000",
+          "refunds": "50.0000",
+          "sales_display": "$130.00",
+          "refunds_display": "$50.00"
+        },
+        {
+          "method": "card",
+          "name": "Card",
+          "sales": "120.0000",
+          "refunds": "0.0000",
+          "sales_display": "$120.00",
+          "refunds_display": "$0.00"
+        }
+      ],
+      "tax_rates": [
+        {
+          "name": "VAT 20%",
+          "net": "166.6667",
+          "tax": "33.3333",
+          "gross": "200.0000",
+          "net_display": "$166.67",
+          "tax_display": "$33.33",
+          "gross_display": "$200.00"
+        }
+      ],
+      "opening_float": {
+        "expected": "100.0000",
+        "counted": "100.0000",
+        "variance": "0.0000",
+        "expected_display": "$100.00",
+        "counted_display": "$100.00",
+        "variance_display": "$0.00"
+      },
+      "movements": [
+        {
+          "created_at_gmt": "2026-09-11 10:00:00",
+          "type": "paid_out",
+          "amount": "5.0000",
+          "reason": "Petty cash",
+          "voided_by": "sample-void",
+          "amount_display": "$5.00",
+          "created_at": {"datetime": "Sep 11, 2026, 12:00", "date": "Sep 11, 2026", "time": "12:00", "datetime_short": "9/11/26, 12:00", "datetime_long": "September 11, 2026 at 12:00 GMT+2", "datetime_full": "Friday, September 11, 2026 at 12:00 Central European Summer Time", "date_short": "9/11/26", "date_long": "September 11, 2026", "date_full": "Friday, September 11, 2026", "date_ymd": "2026-09-11", "date_dmy": "11/09/2026", "date_mdy": "09/11/2026", "weekday_short": "Fri", "weekday_long": "Friday", "day": "11", "month": "09", "month_short": "Sep", "month_long": "September", "year": "2026"},
+          "type_label": "Paid out",
+          "voided": true
+        }
+      ],
+      "transaction_count": 12,
+      "refund_count": 2,
+      "cashiers": [
+        {
+          "id": 1,
+          "name": "Alex"
+        }
+      ],
+      "labels": {
+        "opened_by_name": "Alex",
+        "closed_by_name": "Alex",
+        "approved_by_name": "Alex"
+      }
+    },
+    "tenders": [
+      {
+        "name": "cash",
+        "label": "Cash",
+        "has_variance": true,
+        "variance_absolute_display": "$2.00",
+        "expected": "180.0000",
+        "counted": "178.0000",
+        "variance": "-2.0000",
+        "variance_label": "Short",
+        "expected_display": "$180.00",
+        "counted_display": "$178.00",
+        "variance_display": "-$2.00"
+      },
+      {
+        "name": "card",
+        "label": "Card",
+        "has_variance": false,
+        "variance_absolute_display": "$0.00",
+        "expected": "120.0000",
+        "counted": "120.0000",
+        "variance": "0.0000",
+        "variance_label": "Exact",
+        "expected_display": "$120.00",
+        "counted_display": "$120.00",
+        "variance_display": "$0.00"
+      }
+    ],
+    "period_sales_total_display": "$250.00",
+    "period_refunds_total_display": "$50.00",
+    "perpetual_sales_total_display": "$5,250.00",
+    "perpetual_refunds_total_display": "$250.00",
+    "unsynced_total_display": "$12.00",
+    "opened_at": {"datetime": "Sep 11, 2026, 10:00", "date": "Sep 11, 2026", "time": "10:00", "datetime_short": "9/11/26, 10:00", "datetime_long": "September 11, 2026 at 10:00 GMT+2", "datetime_full": "Friday, September 11, 2026 at 10:00 Central European Summer Time", "date_short": "9/11/26", "date_long": "September 11, 2026", "date_full": "Friday, September 11, 2026", "date_ymd": "2026-09-11", "date_dmy": "11/09/2026", "date_mdy": "09/11/2026", "weekday_short": "Fri", "weekday_long": "Friday", "day": "11", "month": "09", "month_short": "Sep", "month_long": "September", "year": "2026"},
+    "closed_at": {"datetime": "Sep 11, 2026, 19:00", "date": "Sep 11, 2026", "time": "19:00", "datetime_short": "9/11/26, 19:00", "datetime_long": "September 11, 2026 at 19:00 GMT+2", "datetime_full": "Friday, September 11, 2026 at 19:00 Central European Summer Time", "date_short": "9/11/26", "date_long": "September 11, 2026", "date_full": "Friday, September 11, 2026", "date_ymd": "2026-09-11", "date_dmy": "11/09/2026", "date_mdy": "09/11/2026", "weekday_short": "Fri", "weekday_long": "Friday", "day": "11", "month": "09", "month_short": "Sep", "month_long": "September", "year": "2026"}
+  },
+  "order": { "currency": "USD" },
+  "i18n": {
+    "x_report": "X-report",
+    "closure": "Closure",
+    "opened": "Opened",
+    "closed": "Closed",
+    "approver": "Approver",
+    "opening_float": "Opening float",
+    "expected": "Expected",
+    "counted": "Counted",
+    "variance": "Variance",
+    "tenders": "Tenders",
+    "tender": "Tender",
+    "cash_movements": "Cash movements",
+    "time": "Time",
+    "type": "Type",
+    "amount": "Amount",
+    "reason": "Reason",
+    "sales": "Sales",
+    "period_sales": "Period sales",
+    "period_refunds": "Period refunds",
+    "transactions": "Transactions",
+    "refunds": "Refunds",
+    "payment_method": "Payment method",
+    "cashiers": "Cashiers",
+    "tax_rates": "Tax rates",
+    "tax_rate": "Tax rate",
+    "net": "Net",
+    "tax": "Tax",
+    "gross": "Gross",
+    "perpetual_totals": "Perpetual totals",
+    "perpetual_sales": "Perpetual sales",
+    "perpetual_refunds": "Perpetual refunds",
+    "unsynced_sales": "sales not yet on the server",
+    "short": "Short",
+    "over": "Over",
+    "exact": "Exact",
+    "voided": "Voided",
+    "paid_in": "Paid in",
+    "paid_out": "Paid out",
+    "no_sale": "No sale",
+    "void": "Void",
+    "copy": "COPY"
+},
+  "register": {
+    "name": "Main register"
+  },
+  "software": {
+    "name": "WCPOS",
+    "plugin_version": "preview"
+  },
+  "fiscal": {
+    "document_type": "closure",
+    "receipt_number": "42",
+    "is_sale_document": false,
+    "is_refund_document": false,
+    "is_closure_document": true,
+    "is_x_report": false,
+    "is_reprint": false,
+    "reprint_count": 0
+  }
+}

package/src/register/__fixtures__/corrections-dst.json

@@ -0,0 +1,63 @@
+{
+  "timezone": "America/Los_Angeles",
+  "now": "2026-11-01T20:00:00Z",
+  "closures": [
+    {
+      "id": "before-fallback",
+      "number": 42,
+      "business_day": "2026-10-31",
+      "opened_at": "2026-10-31T23:00:00Z",
+      "closed_at": "2026-11-01T08:30:00Z"
+    },
+    {
+      "id": "after-fallback",
+      "number": 43,
+      "business_day": "2026-11-01",
+      "opened_at": "2026-11-01T07:00:00Z",
+      "closed_at": "2026-11-01T09:30:00Z"
+    }
+  ],
+  "corrections": [
+    {
+      "id": 1,
+      "type": "late_sale",
+      "created_at": "2026-11-01 08:45:00",
+      "actor": { "id": "1", "name": "Alex" },
+      "approver": null,
+      "reason": "Overnight sale synced",
+      "figures": {
+        "expected_delta": { "cash": 1 },
+        "sales_delta": 1,
+        "refunds_delta": 0
+      }
+    },
+    {
+      "id": 2,
+      "type": "recount",
+      "created_at": "2026-11-01 09:45:00",
+      "actor": { "id": "1", "name": "Alex" },
+      "approver": { "id": "2", "name": "Manager" },
+      "reason": "Drawer recounted after the clock change",
+      "figures": {
+        "counted": { "cash": 18000 },
+        "variance": { "cash": 0 }
+      }
+    }
+  ],
+  "settled": {
+    "expected": { "cash": 18001, "card": 12000 },
+    "counted": { "cash": 18000, "card": 12000 },
+    "variance": { "cash": -1, "card": 0 },
+    "period_sales_total_minor": 25001,
+    "period_refunds_total_minor": 5000,
+    "perpetual_sales_total_minor": 525001,
+    "perpetual_refunds_total_minor": 25000
+  },
+  "touched": [
+    "counted.cash",
+    "expected.cash",
+    "period_sales_total_minor",
+    "perpetual_sales_total_minor",
+    "variance.cash"
+  ]
+}

package/src/register/closure-document.ts

@@ -0,0 +1,270 @@
+/**
+ * The register's closure and X-report documents (ADR-032): WCPOS's receipt-template envelope, so
+ * its shipped templates and renderer can be copied in later (ADR-032, backlog 48). Port
+ * provenance (ADR-032 amendment 1): WCPOS `next` `3b5331b5c` `closure-document.ts`.
+ *
+ * Neutral changes: money is a2's integer minor units on input, from `Closure`'s/`RegisterSession`'s
+ * own fields AND from `breakdowns` (`writeClosure` freezes `payment_methods`, `opening_float`,
+ * `movements` and `tax_rates` in the same minor-unit convention as the closure row itself — it is
+ * not an opaque, already-decimal blob). `buildClosureDocument` converts every `*_minor`/`amountMinor`
+ * breakdown field to the decimal strings the envelope carries with `minorToDecimal` at
+ * `ClosureContext.exponent` (b1's `exportCsv` does the same); `number` is a2's `Closure.number`
+ * (`printed_number`/`server_number` don't exist); `store_id` is sourced from a2's `store_key`;
+ * date-fns/`@date-fns/tz` become `Intl`, following a2's `businessDayOf`; a cashier id stays a2's
+ * string id (not WCPOS's numeric one).
+ */
+import { minorToDecimal } from './money';
+import type { Closure, RegisterSession } from './schemas';
+
+type Values = Record<string, unknown>;
+/** `writeClosure`'s own `breakdowns.movements` shape (session-store.ts): every entry carries at
+ * least a string `id` and `reason`, so callers can read them without a cast. */
+type BreakdownMovement = Values & { id: string; reason: string };
+
+export type ClosureContext = {
+  store: Values;
+  currency: string;
+  timezone: string;
+  locale: string;
+  printedAt: string;
+  /** Minor-unit decimal places for every money field the envelope carries. */
+  exponent: number;
+  formatMoney: (value: string) => string;
+  i18n: Record<string, string>;
+  /** Overrides an X-report's `server_expected` tender map, in minor units. */
+  expected?: Record<string, number>;
+  /**
+   * `buildXReportDocument`'s own breakdowns merge only (unlike `buildClosureDocument`'s frozen
+   * `Closure.breakdowns`): its money fields are still expected as decimal strings, not minor
+   * units. Job c's X-report caller, once it exists, converts them before passing this in.
+   */
+  breakdowns?: Values;
+};
+
+const decimalMap = (minor: Record<string, number>, exponent: number): Record<string, string> =>
+  Object.fromEntries(Object.entries(minor).map(([key, value]) => [key, minorToDecimal(value, exponent)]));
+
+/** `writeClosure`'s frozen minor-unit breakdown money (`payment_methods`, `tax_rates`,
+ * `opening_float`, `movements[].amountMinor`) → the decimal strings the envelope carries. */
+function decimalizeBreakdowns(breakdowns: Values, exponent: number): Values {
+  const dec = (m: unknown) => (typeof m === 'number' ? minorToDecimal(m, exponent) : m);
+  const group = (key: string, pairs: [string, string][]) => {
+    const source = breakdowns[key] as Record<string, Values> | undefined;
+    return (
+      source &&
+      Object.fromEntries(
+        Object.entries(source).map(([id, entry]) => [
+          id,
+          { ...entry, ...Object.fromEntries(pairs.map(([from, to]) => [to, dec(entry[from])])) },
+        ]),
+      )
+    );
+  };
+  const openingFloat = breakdowns.opening_float as Values | undefined;
+  return {
+    ...breakdowns,
+    ...(breakdowns.payment_methods
+      ? { payment_methods: group('payment_methods', [['sales_minor', 'sales'], ['refunds_minor', 'refunds']]) }
+      : {}),
+    ...(breakdowns.tax_rates
+      ? { tax_rates: group('tax_rates', [['net_minor', 'net'], ['tax_minor', 'tax'], ['gross_minor', 'gross']]) }
+      : {}),
+    ...(openingFloat
+      ? {
+          opening_float: {
+            ...openingFloat, expected: dec(openingFloat.expected_minor), counted: dec(openingFloat.counted_minor),
+            variance: dec(openingFloat.variance_minor),
+          },
+        }
+      : {}),
+    ...(breakdowns.movements
+      ? { movements: (breakdowns.movements as BreakdownMovement[]).map((m) => ({ ...m, amount: dec(m.amountMinor) })) }
+      : {}),
+  };
+}
+
+// Server Receipt_Date_Formatter keys; absent dates remain empty, not today's date.
+export function formatClosureDate(
+  value: string | null | undefined,
+  context: Pick<ClosureContext, 'timezone' | 'locale'>,
+) {
+  const date = value
+    ? new Date(/[Zz]|[+-]\d\d:\d\d$/.test(value) ? value : `${value.replace(' ', 'T')}Z`)
+    : null;
+  const timeZone = context.timezone === 'device' ? undefined : context.timezone;
+  const display = (settings: Intl.DateTimeFormatOptions) =>
+    date ? new Intl.DateTimeFormat(context.locale, { timeZone, ...settings, hour12: false }).format(date) : '';
+  const result: Record<string, string> = {
+    datetime: display({ dateStyle: 'medium', timeStyle: 'short' }),
+    date: display({ dateStyle: 'medium' }),
+    time: display({ timeStyle: 'short' }),
+  };
+  for (const style of ['short', 'long', 'full'] as const) {
+    result[`datetime_${style}`] = display({ dateStyle: style, timeStyle: style === 'short' ? 'short' : style });
+    result[`date_${style}`] = display({ dateStyle: style });
+  }
+  const parts = date
+    ? Object.fromEntries(
+        new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' })
+          .formatToParts(date)
+          .map(({ type, value: v }) => [type, v]),
+      )
+    : ({} as Record<string, string>);
+  result.date_ymd = date ? `${parts.year}-${parts.month}-${parts.day}` : '';
+  result.date_dmy = date ? `${parts.day}/${parts.month}/${parts.year}` : '';
+  result.date_mdy = date ? `${parts.month}/${parts.day}/${parts.year}` : '';
+  result.day = date ? parts.day : '';
+  result.month = date ? parts.month : '';
+  result.year = date ? parts.year : '';
+  for (const style of ['short', 'long'] as const) {
+    result[`weekday_${style}`] = display({ weekday: style });
+    result[`month_${style}`] = display({ month: style });
+  }
+  return result;
+}
+
+// Generic over the row so its own literal fields (e.g. `Closure`'s `unsynced_count: number`)
+// survive the `money(row, [...])` spread below into the return type, instead of widening to
+// `Values`'s `unknown` — the same reason `BreakdownMovement` types the movements mapping.
+function envelope<R extends Values>(row: R, context: ClosureContext, xreport = false) {
+  const money = <T extends Values, K extends string>(values: T, fields: K[]) =>
+    Object.assign(
+      {},
+      values,
+      Object.fromEntries(fields.map((key) => [`${key}_display`, context.formatMoney(String(values[key] ?? ''))])),
+    ) as T & Record<`${K}_display`, string>;
+  const breakdowns = (row.breakdowns ?? {}) as Values;
+  const labels: Values = {
+    opened_by_name: '', closed_by_name: '', approved_by_name: '',
+    ...Object.fromEntries(Object.entries(breakdowns).filter(([key]) => key.endsWith('_name'))),
+    ...(breakdowns.labels as Values),
+  };
+  const rows = (key: string, fields: string[]) =>
+    Object.entries((breakdowns[key] ?? {}) as Record<string, Values>).map(([entryKey, value]) =>
+      money({ ...value, name: value.name ?? value.method ?? value.rate ?? entryKey }, fields),
+    );
+  const methods = (breakdowns.payment_methods ?? {}) as Record<string, Values>;
+  const counted = (row.counted ?? {}) as Record<string, string>;
+  const expected = (row.expected ?? {}) as Record<string, string>;
+  const variances = (row.variance ?? {}) as Record<string, string>;
+  const tenders = [...new Set([...Object.keys(counted), ...Object.keys(expected)])].map((name) => {
+    const variance = variances[name] ?? '';
+    const method = Object.values(methods).find((m) => m.method === name) ?? methods[name];
+    return money(
+      {
+        name,
+        label: method?.name || name.charAt(0).toUpperCase() + name.slice(1),
+        expected: expected[name] ?? '', counted: counted[name] ?? '', variance,
+        has_variance: Number(variance || 0) !== 0,
+        variance_label:
+          variance === '' ? '' : context.i18n[Number(variance) > 0 ? 'over' : Number(variance) < 0 ? 'short' : 'exact'],
+        variance_absolute_display: context.formatMoney(variance.replace('-', '')),
+      },
+      ['expected', 'counted', 'variance'],
+    );
+  });
+  return {
+    closure: {
+      has_sales:
+        row.period_sales_total != null || row.period_refunds_total != null || Number(breakdowns.transaction_count) > 0,
+      has_perpetual: row.perpetual_sales_total != null || row.perpetual_refunds_total != null,
+      ...Object.fromEntries(
+        ['payment_methods', 'tax_rates', 'movements'].map((key) => [`has_${key}`, Object.keys((breakdowns[key] as Values) ?? {}).length > 0]),
+      ),
+      ...money(row, ['period_sales_total', 'period_refunds_total', 'perpetual_sales_total', 'perpetual_refunds_total', 'unsynced_total']),
+      opened_at_gmt: row.opened_at,
+      opened_by: breakdowns.opened_by ?? null,
+      closed_by: row.closed_by ?? null,
+      approved_by: breakdowns.approved_by ?? null,
+      closed_at_gmt: row.closed_at,
+      opened_at: formatClosureDate(row.opened_at as string, context),
+      closed_at: formatClosureDate(row.closed_at as string, context),
+      tenders,
+      breakdowns: {
+        ...breakdowns,
+        labels,
+        payment_methods: rows('payment_methods', ['sales', 'refunds']),
+        tax_rates: rows('tax_rates', ['net', 'tax', 'gross']),
+        opening_float: money((breakdowns.opening_float ?? {}) as Values, ['expected', 'counted', 'variance']),
+        movements: ((breakdowns.movements ?? []) as BreakdownMovement[]).map((m) => ({
+          ...money(m, ['amount']),
+          created_at: formatClosureDate((m.created_at_gmt ?? m.created_at) as string, context),
+          type_label: context.i18n[String(m.type)] ?? m.type,
+          voided: !!m.voided_by,
+        })),
+        cashiers: ((breakdowns.cashiers ?? []) as (Values | string)[]).map((c) => (typeof c === 'string' ? { id: c, name: c } : c)),
+      },
+    },
+    store: context.store,
+    register: { id: row.register_id, name: labels.register_name ?? '' },
+    software: { name: 'WCPOS', plugin_version: row.software_version ?? '' },
+    order: { currency: context.currency, printed: formatClosureDate(context.printedAt, context) },
+    fiscal: {
+      immutable_id: '', hash: '', qr_payload: '', tax_agency_code: '', signature_excerpt: '',
+      document_label: '', sequence: null, signed_at: null, extra_fields: [],
+      document_type: xreport ? 'xreport' : 'closure',
+      receipt_number: xreport ? '' : String(row.number),
+      is_sale_document: false, is_refund_document: false, is_closure_document: true,
+      is_x_report: xreport,
+      is_reprint: !xreport && !!row.print_count,
+      reprint_count: xreport ? 0 : ((row.print_count as number) ?? 0),
+    },
+    i18n: context.i18n,
+  };
+}
+
+export function buildClosureDocument(row: Closure, context: ClosureContext) {
+  const { exponent } = context;
+  const dec = (m: number) => minorToDecimal(m, exponent);
+  const {
+    store_key, till_expected, expected, counted, variance, period_sales_total_minor, period_refunds_total_minor,
+    perpetual_sales_total_minor, perpetual_refunds_total_minor, unsynced_total_minor, ...rest
+  } = row;
+  return envelope(
+    {
+      ...rest,
+      breakdowns: decimalizeBreakdowns(rest.breakdowns, exponent),
+      store_id: store_key,
+      till_expected: decimalMap(till_expected, exponent),
+      expected: decimalMap(expected, exponent),
+      counted: decimalMap(counted, exponent),
+      variance: decimalMap(variance, exponent),
+      period_sales_total: dec(period_sales_total_minor),
+      period_refunds_total: dec(period_refunds_total_minor),
+      perpetual_sales_total: dec(perpetual_sales_total_minor),
+      perpetual_refunds_total: dec(perpetual_refunds_total_minor),
+      unsynced_total: dec(unsynced_total_minor),
+    },
+    context,
+  );
+}
+
+export function buildXReportDocument(session: RegisterSession, context: ClosureContext) {
+  const { exponent } = context;
+  const dec = (m: number | null | undefined) => (m == null ? undefined : minorToDecimal(m, exponent));
+  const expectedMinor = context.expected ?? session.server_expected ?? {};
+  const countedMinor = session.counted ?? {};
+  const varianceMinor = Object.fromEntries(
+    Object.entries(countedMinor).map(([key, value]) => [key, value - (expectedMinor[key] ?? 0)]),
+  );
+  return envelope(
+    {
+      id: session.id,
+      register_id: session.register_id,
+      store_id: session.store_key,
+      opened_at: session.opened_at_gmt,
+      expected: decimalMap(expectedMinor, exponent),
+      counted: decimalMap(countedMinor, exponent),
+      variance: decimalMap(varianceMinor, exponent),
+      breakdowns: {
+        ...context.breakdowns,
+        opening_float: {
+          expected: dec(session.expected_float_minor), counted: dec(session.counted_float_minor),
+          variance: dec(session.opening_variance_minor),
+        },
+      },
+    },
+    context,
+    true,
+  );
+}

package/src/register/closure-rows.ts

@@ -0,0 +1,65 @@
+/**
+ * The closures list's pure selectors (ADR-032): a requested scope clamped to the local history
+ * window, and its rows within that scope, newest first. Port provenance (ADR-032 amendment 1):
+ * WCPOS `next` `3b5331b5c` `use-closure-rows.ts` — `ClosureScope`, `clampClosureScope` and
+ * `selectClosureRows` only. The React hook that pages the server and merges local/remote rows is
+ * registers job c, not ported here.
+ */
+import { businessDayOf } from './session-store';
+import type { Closure } from './schemas';
+
+export type ClosureScope = {
+  from: string;
+  to: string;
+  registerId: string;
+  storeKey?: string;
+  cashier?: string;
+};
+
+/**
+ * WCPOS's `HISTORY_DAYS` (`@wcpos/sync-core`) bounds how far back local report history reaches
+ * without a server aggregation call. Its value is 92 (wcpos/roadmap#332, "the 92-day reach").
+ */
+const DEFAULT_HISTORY_DAYS = 92;
+
+/** `day` minus `days` calendar days, both `yyyy-MM-dd`: calendar arithmetic, not a zone conversion. */
+function daysBefore(day: string, days: number): string {
+  const at = new Date(`${day}T00:00:00Z`);
+  at.setUTCDate(at.getUTCDate() - days);
+  return at.toISOString().slice(0, 10);
+}
+
+/** Clamps a requested scope's `from`/`to` to `today` and to `historyDays` before it. */
+export function clampClosureScope(
+  scope: ClosureScope,
+  today: string,
+  historyDays = DEFAULT_HISTORY_DAYS,
+): ClosureScope {
+  const min = daysBefore(today, historyDays);
+  const clamp = (day: string) => (day < min ? min : day > today ? today : day);
+  return { ...scope, from: clamp(scope.from), to: clamp(scope.to) };
+}
+
+/**
+ * Rows within `scope`, newest business day first, then newest `closed_at`. A row with no
+ * `business_day` (a legacy or remote row) gets one from `opened_at` in `timezone`, reusing a2's
+ * `businessDayOf` rather than duplicating it. Register and cashier are optional filters; the
+ * store is not — a row's `store_key` must equal `scope.storeKey` (both `null` when neither is
+ * set), as WCPOS always compared `store_id`.
+ */
+export function selectClosureRows(rows: readonly Closure[], scope: ClosureScope, timezone: string) {
+  return rows
+    .map((row) => ({
+      ...row,
+      business_day: row.business_day || businessDayOf(row.opened_at, timezone),
+    }))
+    .filter(
+      (row) =>
+        row.business_day >= scope.from &&
+        row.business_day <= scope.to &&
+        (!scope.registerId || row.register_id === scope.registerId) &&
+        (row.store_key ?? null) === (scope.storeKey ?? null) &&
+        (scope.cashier === undefined || row.closed_by === scope.cashier),
+    )
+    .sort((a, b) => b.business_day.localeCompare(a.business_day) || b.closed_at.localeCompare(a.closed_at));
+}

package/src/register/document-labels.ts

@@ -0,0 +1,46 @@
+// Offline defaults use the same label keys as the shipped server closure template. Port
+// provenance (ADR-032 amendment 1): WCPOS `next` `3b5331b5c` `document-labels.ts`, unchanged —
+// no money, no imports.
+export const labelKeys = {
+  x_report: 'register.x_report',
+  closure: 'reports.document.closure',
+  opened: 'reports.document.opened',
+  closed: 'register.closed',
+  approver: 'reports.document.approver',
+  opening_float: 'reports.document.opening_float',
+  expected: 'reports.document.expected',
+  counted: 'register.counted',
+  variance: 'register.variance',
+  tenders: 'reports.document.tenders',
+  tender: 'reports.document.tender',
+  cash_movements: 'reports.document.cash_movements',
+  time: 'common.time',
+  type: 'common.type',
+  amount: 'register.amount',
+  reason: 'register.reason',
+  sales: 'reports.sales',
+  period_sales: 'register.period_sales',
+  period_refunds: 'register.period_refunds',
+  transactions: 'reports.document.transactions',
+  refunds: 'common.refunds',
+  payment_method: 'reports.document.payment_method',
+  cashiers: 'reports.document.cashiers',
+  tax_rates: 'common.tax_rates',
+  tax_rate: 'reports.document.tax_rate',
+  net: 'reports.document.net',
+  tax: 'common.tax',
+  gross: 'reports.document.gross',
+  perpetual_totals: 'reports.document.perpetual_totals',
+  perpetual_sales: 'register.perpetual_sales',
+  perpetual_refunds: 'register.perpetual_refunds',
+  unsynced_sales: 'reports.document.unsynced_sales',
+  short: 'reports.document.short',
+  over: 'reports.document.over',
+  exact: 'reports.exact',
+  voided: 'pos_checkout.status_voided',
+  paid_in: 'register.paid_in',
+  paid_out: 'register.paid_out',
+  no_sale: 'register.no_sale',
+  void: 'register.void',
+  copy: 'reports.document.copy',
+};