chaffjs 0.30.0 → 0.32.0

package/dist/structure/meter-usage-read.js

@@ -0,0 +1,116 @@
+import { cellsOf, tablesOf } from "../facts/table-facts.js";
+import { withoutEdgeMarks } from "../facts/trim-marks.js";
+import { linesOf } from "./lines.js";
+import { withoutTrailingNote } from "./meter-usage.js";
+const LIST_MARK = /^[-*+]\s/u;
+const DIGIT = /\d/u;
+const keyOf = (text) => withoutEdgeMarks(text).normalize("NFKC").toLowerCase().replace(/\s+/gu, " ").trim();
+const kindOf = (label, words) => {
+    const key = withoutTrailingNote(keyOf(label));
+    return words.labels.find((word) => keyOf(word.pattern) === key)?.kind;
+};
+/** The unit a column heading names: the heading itself ("kWh") or its bracket ("指示数（kWh）"). */
+const headerUnitOf = (heading, words) => {
+    const key = keyOf(heading);
+    const bracket = withoutTrailingNote(key);
+    const named = bracket === key ? key : key.slice(bracket.length).trim().slice(1, -1).trim();
+    return words.units.find((unit) => keyOf(unit.pattern) === named)?.unit;
+};
+/** "- 今回指示数：12,640" → the label and the value with where the value starts in the line; undefined without a colon. */
+const labelAndValue = (text) => {
+    const colon = [text.indexOf(":"), text.indexOf("：")].filter((index) => index > 0).reduce((first, index) => Math.min(first, index), Infinity);
+    if (colon === Infinity)
+        return undefined;
+    const label = text.slice(0, colon).trim().replace(LIST_MARK, "");
+    const rest = text.slice(colon + 1);
+    const value = rest.trim();
+    return value === "" ? undefined : { label, value, at: colon + 1 + rest.indexOf(value) };
+};
+const valueStart = (cell) => cell.start + (cell.text.length - cell.text.trimStart().length);
+const entryOf = (kind, cell, headerUnit) => ({
+    kind,
+    value: cell.text.trim(),
+    offset: valueStart(cell),
+    ...(headerUnit === undefined ? {} : { headerUnit }),
+});
+/** | 今回指示数 | 12,640 |: the row's one cell with a figure in it is the value. */
+const rowEntry = (row, headings, words) => {
+    const [label, ...rest] = cellsOf(row);
+    const kind = label === undefined ? undefined : kindOf(label.text, words);
+    if (kind === undefined)
+        return [];
+    const withFigure = rest.flatMap((cell, index) => (DIGIT.test(cell.text) ? [{ cell, heading: headings[index + 1] ?? "" }] : []));
+    const [only, ...more] = withFigure;
+    if (only === undefined || more.length > 0)
+        return [];
+    return [entryOf(kind, only.cell, headerUnitOf(only.heading, words))];
+};
+/** | 今回指示数 | 前回指示数 | ご使用量 | over one row of values: each named column gives the value under it. */
+const columnEntries = (row, headings, words) => cellsOf(row).flatMap((cell, index) => {
+    const kind = kindOf(headings[index] ?? "", words);
+    return kind === undefined ? [] : [entryOf(kind, cell, headerUnitOf(headings[index] ?? "", words))];
+});
+const MIN_NAMED_COLUMNS = 2;
+const tableEntries = (table, words) => {
+    const headings = cellsOf(table.header).map((cell) => cell.text);
+    const named = headings.filter((heading) => kindOf(heading, words) !== undefined).length;
+    if (named >= MIN_NAMED_COLUMNS) {
+        const alone = table.rows.length > 1;
+        return table.rows.map((row) => ({ line: row.number, entries: columnEntries(row, headings, words), alone, text: row.text }));
+    }
+    return table.rows.map((row) => ({ line: row.number, entries: rowEntry(row, headings, words), alone: false, text: row.text }));
+};
+const lineEntry = (line, words) => {
+    if (line.text.includes("|"))
+        return [];
+    const parts = labelAndValue(line.text);
+    const kind = parts === undefined ? undefined : kindOf(parts.label, words);
+    if (parts === undefined || kind === undefined)
+        return [];
+    return [{ line: line.number, entries: [{ kind, value: parts.value, offset: line.start + parts.at }], alone: false, text: line.text }];
+};
+/** Each line's section: how many headings start at or before it. Index 0 is unused (lines count from 1). */
+const sectionsOf = (lines, headingLines) => {
+    const headings = new Set(headingLines);
+    const sections = [0];
+    lines.forEach((line) => sections.push((sections.at(-1) ?? 0) + (headings.has(line.number) ? 1 : 0)));
+    return sections;
+};
+/**
+ * The groups of a document. text is the prose with its tables (headings blanked, offsets kept); headingLines are the line
+ * numbers of its headings, which split it into sections.
+ */
+export const meterGroups = (text, headingLines, words) => {
+    const lines = linesOf(text);
+    const tables = tablesOf(lines);
+    const inTable = new Set(tables.flatMap((table) => [table.header.number, ...table.rows.map((row) => row.number)]));
+    const placed = [
+        ...tables.flatMap((table) => tableEntries(table, words)),
+        ...lines.filter((line) => !inTable.has(line.number)).flatMap((line) => lineEntry(line, words)),
+    ].filter((entry) => entry.entries.length > 0);
+    if (placed.length === 0)
+        return [];
+    const sections = sectionsOf(lines, headingLines);
+    const sectionOf = (line) => sections[line] ?? 0;
+    const sectionLines = groupedBy(lines, (line) => sectionOf(line.number));
+    const alone = placed.filter((entry) => entry.alone).map((entry) => ({ entries: entry.entries, text: entry.text }));
+    const bySection = groupedBy(placed.filter((entry) => !entry.alone).toSorted((left, right) => left.line - right.line), (entry) => sectionOf(entry.line));
+    const shared = [...bySection].map(([section, entries]) => ({
+        entries: entries.flatMap((entry) => entry.entries),
+        text: (sectionLines.get(section) ?? []).map((line) => line.text).join("\n"),
+    }));
+    return [...shared, ...alone];
+};
+const groupedBy = (items, keyOf) => {
+    const groups = new Map();
+    items.forEach((item) => {
+        const key = keyOf(item);
+        const group = groups.get(key);
+        if (group === undefined)
+            groups.set(key, [item]);
+        else
+            group.push(item);
+    });
+    return groups;
+};
+//# sourceMappingURL=meter-usage-read.js.map

package/dist/structure/meter-usage-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-usage-read.js","sourceRoot":"","sources":["../../src/structure/meter-usage-read.ts"],"names":[],"mappings":"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"}

package/dist/structure/meter-usage.d.ts

@@ -0,0 +1,62 @@
+import type { StructureIssue } from "./issues.ts";
+/**
+ * 検針票で、今回の指示数 − 前回の指示数（乗率があれば × 乗率）が、書いた使用量と合わない所。読む側（meter-usage-read.ts）が
+ * 一つのまとまり（見出しから見出しまで、または表の一行）ごとに、語彙表 meter-reading-label の名前の付いた値を集めて渡す。
+ * 今回・前回・使用量が一つずつそろい、どれも単位が読めて食い違わないときだけ比べる。今回が前回より小さいのは、メーターが
+ * 一巡したと書いてあるとき（同じ節で打ち消していないとき）だけ、前回の桁数の上限を足して読む。乗率が書いてあって読めないとき、メーターを取り替えたと書いて
+ * あるときは比べない。使用量は書いた桁までの丸め（切り捨て・四捨五入・切り上げ）を認める。Pure.
+ */
+export type MeterKind = "current" | "previous" | "usage" | "multiplier";
+export type MeterEntry = {
+    readonly kind: MeterKind;
+    /** The value as written after its label, or the cell's text. */
+    readonly value: string;
+    /** Where the value starts in the document. */
+    readonly offset: number;
+    /** The unit a table heading gives its column ("kWh"), when it gives one. */
+    readonly headerUnit?: string;
+};
+/** One bill's readings: the named values of a section or a table row, and the section's text (for a stated rollover). */
+export type MeterGroup = {
+    readonly entries: readonly MeterEntry[];
+    readonly text: string;
+};
+export type MeterUnitWord = {
+    readonly pattern: string;
+    readonly unit: string;
+};
+export type MeterWords = {
+    /** Unit words and the unit they name (meter-unit): "m³" and "立方メートル" are both m3. */
+    readonly units: readonly MeterUnitWord[];
+    /** Words saying the meter went past its last figure (meter-event, group rollover). */
+    readonly rollover: readonly string[];
+    /** Words after a rollover word, in its clause, that deny it (「一巡していません」): meter-event, group rollover-negation-after. */
+    readonly rolloverNegationAfter: readonly string[];
+    /** Words before a rollover word, in its clause, that deny it ("has not rolled over"): group rollover-negation-before. */
+    readonly rolloverNegationBefore: readonly string[];
+    /** Words saying the meter was replaced (meter-event, group replaced): the two readings are of different meters. */
+    readonly replaced: readonly string[];
+};
+/** A number as written: its value in units of its last digit, and how many decimals it has. */
+type Reading = {
+    readonly scaled: bigint;
+    readonly decimals: number;
+    readonly digits: number;
+    readonly unit: string;
+    readonly grouped: boolean;
+    readonly written: string;
+};
+/** "36m3 (2か月分)" → "36m3": the bracket a value or a name ends with is a note. Brackets are ASCII once NFKC-normalised. */
+export declare const withoutTrailingNote: (text: string) => string;
+/** "12,640", "350kWh", "36m³（2か月分）". Undefined when the value is not one number, or its word is not a meter unit. */
+export declare const readingOf: (entry: MeterEntry, words: MeterWords) => Reading | undefined;
+/** The multiplier as a scaled number ("×10" → 10, "1.5" → 15 with one decimal); undefined when it cannot be read. */
+export declare const multiplierOf: (value: string) => {
+    readonly scaled: bigint;
+    readonly decimals: number;
+} | undefined;
+/** Some rollover word is written and not denied in its clause. */
+export declare const statesRollover: (text: string, words: MeterWords) => boolean;
+export declare const meterUsageMismatches: (groups: readonly MeterGroup[], words: MeterWords) => StructureIssue[];
+export {};
+//# sourceMappingURL=meter-usage.d.ts.map

package/dist/structure/meter-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-usage.d.ts","sourceRoot":"","sources":["../../src/structure/meter-usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,yHAAyH;AACzH,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,UAAU,GAAG;IACvB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,yHAAyH;IACzH,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,yHAAyH;IACzH,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,+FAA+F;AAC/F,KAAK,OAAO,GAAG;IACb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAQF,0HAA0H;AAC1H,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAGlD,CAAC;AAQF,qHAAqH;AACrH,eAAO,MAAM,SAAS,GAAI,OAAO,UAAU,EAAE,OAAO,UAAU,KAAG,OAAO,GAAG,SAiB1E,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAKrG,CAAC;AAoDF,kEAAkE;AAClE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,UAAU,KAAG,OAMhE,CAAC;AAsEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,UAAU,EAAE,EAAE,OAAO,UAAU,KAAG,cAAc,EAAyD,CAAC"}

package/dist/structure/meter-usage.js

@@ -0,0 +1,157 @@
+import { escapeRegExp } from "../orthography.js";
+const LEADING_NUMBER = /^(\d{1,3}(?:,\d{3})+|\d+)(?:\.(\d+))?(?![\d,])/u;
+const MULTIPLIER = /^[×x*]?\s*(\d+(?:\.\d+)?)\s*(?:倍|times)?$/u;
+const TEN = 10n;
+const normal = (text) => text.normalize("NFKC").replace(/[*_`]/gu, "").trim();
+/** "36m3 (2か月分)" → "36m3": the bracket a value or a name ends with is a note. Brackets are ASCII once NFKC-normalised. */
+export const withoutTrailingNote = (text) => {
+    const open = text.lastIndexOf("(");
+    return text.endsWith(")") && open >= 0 ? text.slice(0, open).trimEnd() : text;
+};
+const unitOf = (word, words) => {
+    const wanted = word.toLowerCase();
+    if (wanted === "")
+        return "";
+    return words.units.find((unit) => unit.pattern.normalize("NFKC").toLowerCase() === wanted)?.unit;
+};
+/** "12,640", "350kWh", "36m³（2か月分）". Undefined when the value is not one number, or its word is not a meter unit. */
+export const readingOf = (entry, words) => {
+    const written = normal(entry.value);
+    const number = withoutTrailingNote(written);
+    const match = LEADING_NUMBER.exec(number);
+    if (match === null)
+        return undefined;
+    const [matched, whole = "", fraction = ""] = match;
+    const own = unitOf(number.slice(matched.length).trim(), words);
+    if (own === undefined)
+        return undefined;
+    const digits = whole.replaceAll(",", "");
+    return {
+        scaled: BigInt(`${digits}${fraction}`),
+        decimals: fraction.length,
+        digits: digits.length,
+        unit: own === "" ? (entry.headerUnit ?? "") : own,
+        grouped: whole.includes(","),
+        written,
+    };
+};
+/** The multiplier as a scaled number ("×10" → 10, "1.5" → 15 with one decimal); undefined when it cannot be read. */
+export const multiplierOf = (value) => {
+    const match = MULTIPLIER.exec(normal(value).toLowerCase());
+    if (match === null)
+        return undefined;
+    const [whole = "", fraction = ""] = (match[1] ?? "").split(".");
+    return { scaled: BigInt(`${whole}${fraction}`), decimals: fraction.length };
+};
+const rescaled = (scaled, from, to) => scaled * TEN ** BigInt(to - from);
+const ofKind = (entries, kind) => entries.filter((entry) => entry.kind === kind);
+const folded = (text) => text.normalize("NFKC").toLowerCase().replaceAll("\u2019", "'");
+const mentions = (text, phrases) => {
+    const lowered = folded(text);
+    return phrases.some((phrase) => lowered.includes(folded(phrase)));
+};
+/** A negation across one of these is about something else: 「一巡しましたが、交換はしていません」. */
+const CLAUSE_END = /[、。,.;:!?\n]/u;
+const LATIN_LETTER = /\p{Script=Latin}/u;
+const startsOf = (text, phrase) => phrase === "" ? [] : [...text.matchAll(new RegExp(escapeRegExp(phrase), "gu"))].map((match) => match.index);
+/** A Latin edge of the phrase must not run on into a letter: "not" is not in "notice", "never" not in "whenever". */
+const isWordAt = (text, phrase, start) => {
+    const joins = (edge, neighbour) => LATIN_LETTER.test(edge) && LATIN_LETTER.test(neighbour);
+    return !joins(phrase.at(0) ?? "", text[start - 1] ?? "") && !joins(phrase.at(-1) ?? "", text[start + phrase.length] ?? "");
+};
+/** "has not yet rolled over"; in "was not replaced and rolled over" the "not" is about something else. */
+const MAX_WORDS_AFTER_NEGATION = 1;
+const anywhere = () => true;
+const nextToEnd = (text, end) => text
+    .slice(end)
+    .split(/\s+/u)
+    .filter((word) => word !== "").length <= MAX_WORDS_AFTER_NEGATION;
+const hasWord = (text, phrases, reaches) => phrases.some((phrase) => {
+    const wanted = folded(phrase);
+    return startsOf(text, wanted).some((start) => isWordAt(text, wanted, start) && reaches(text, start + wanted.length));
+});
+/** The rollover word at start is denied by a negation in its own clause: after it, or (in English) just before it. */
+const isDenied = (text, start, length, words) => {
+    const before = text.slice(0, start).split(CLAUSE_END).at(-1) ?? "";
+    const after = text.slice(start + length).split(CLAUSE_END)[0] ?? "";
+    return hasWord(after, words.rolloverNegationAfter, anywhere) || hasWord(before, words.rolloverNegationBefore, nextToEnd);
+};
+/** Some rollover word is written and not denied in its clause. */
+export const statesRollover = (text, words) => {
+    const lowered = folded(text);
+    return words.rollover.some((phrase) => {
+        const wanted = folded(phrase);
+        return startsOf(lowered, wanted).some((start) => !isDenied(lowered, start, wanted.length, words));
+    });
+};
+/** The units of the three agree: each is unstated or the same one. */
+const unitsAgree = (readings) => new Set(readings.map((reading) => reading.unit).filter((unit) => unit !== "")).size <= 1;
+/** current − previous at the readings' common scale; a stated rollover adds the previous reading's next power of ten. */
+const difference = (current, previous, scale, group, words) => {
+    const plain = rescaled(current.scaled, current.decimals, scale) - rescaled(previous.scaled, previous.decimals, scale);
+    if (plain >= 0n)
+        return plain;
+    if (!statesRollover(group.text, words))
+        return undefined;
+    return plain + rescaled(TEN ** BigInt(previous.digits), 0, scale);
+};
+/** Usage is written to its last digit, so any value within one step of it, either side, is a rounding of it. */
+const withinRounding = (expected, usage, scale) => {
+    const gap = expected - rescaled(usage.scaled, usage.decimals, scale);
+    const step = TEN ** BigInt(scale - usage.decimals);
+    return gap < step && gap > -step;
+};
+const shown = (scaled, decimals, grouped) => {
+    const text = scaled.toString().padStart(decimals + 1, "0");
+    const whole = text.slice(0, text.length - decimals);
+    const groupedWhole = grouped ? BigInt(whole).toLocaleString("en-US") : whole;
+    return decimals === 0 ? groupedWhole : `${groupedWhole}.${text.slice(text.length - decimals)}`;
+};
+/** One of each of the three, and at most one multiplier; two meters in one place are not told apart. */
+const partsOf = (group) => {
+    const [current, ...moreCurrent] = ofKind(group.entries, "current");
+    const [previous, ...morePrevious] = ofKind(group.entries, "previous");
+    const [usage, ...moreUsage] = ofKind(group.entries, "usage");
+    const [multiplier, ...moreMultiplier] = ofKind(group.entries, "multiplier");
+    if (current === undefined || previous === undefined || usage === undefined)
+        return undefined;
+    if (moreCurrent.length + morePrevious.length + moreUsage.length + moreMultiplier.length > 0)
+        return undefined;
+    return { current, previous, usage, multiplier };
+};
+const groupIssue = (group, words) => {
+    const parts = partsOf(group);
+    if (parts === undefined || mentions(group.text, words.replaced))
+        return [];
+    const current = readingOf(parts.current, words);
+    const previous = readingOf(parts.previous, words);
+    const usage = readingOf(parts.usage, words);
+    const factor = parts.multiplier === undefined ? { scaled: 1n, decimals: 0 } : multiplierOf(parts.multiplier.value);
+    if (current === undefined || previous === undefined || usage === undefined || factor === undefined)
+        return [];
+    if (!unitsAgree([current, previous, usage]))
+        return [];
+    const readScale = Math.max(current.decimals, previous.decimals);
+    const diff = difference(current, previous, readScale, group, words);
+    if (diff === undefined)
+        return [];
+    const scale = Math.max(readScale + factor.decimals, usage.decimals);
+    const expected = rescaled(diff * factor.scaled, readScale + factor.decimals, scale);
+    if (withinRounding(expected, usage, scale))
+        return [];
+    const times = parts.multiplier === undefined ? "" : ` × ${shown(factor.scaled, factor.decimals, false)}`;
+    return [
+        {
+            offset: parts.current.offset,
+            values: {
+                current: current.written,
+                previous: previous.written,
+                times,
+                expected: shown(expected, scale, current.grouped || usage.grouped),
+                usage: usage.written,
+            },
+        },
+    ];
+};
+export const meterUsageMismatches = (groups, words) => groups.flatMap((group) => groupIssue(group, words));
+//# sourceMappingURL=meter-usage.js.map

package/dist/structure/meter-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-usage.js","sourceRoot":"","sources":["../../src/structure/meter-usage.ts"],"names":[],"mappings":"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"}

package/dist/structure/net-amount.d.ts

@@ -0,0 +1,81 @@
+import { type TotalQualifier } from "./total-line.ts";
+export declare const NET_ROLES: readonly ["gross", "deduction", "deduction-part", "net", "taxable"];
+export type NetRole = (typeof NET_ROLES)[number];
+/** A period word; group names its term, so "Fall" and "for the fall" are one term. */
+export type NetPeriod = TotalQualifier & {
+    readonly group?: string | undefined;
+};
+export type NetWords = {
+    readonly labels: Readonly<Record<NetRole, readonly string[]>>;
+    /** Words of the term an amount is for (net-amount-period: 前期分の, Fall, for the fall), cut off a label before it is read. */
+    readonly periods: readonly NetPeriod[];
+    /** Names read only with a period on them (Charges, as Fall charges): alone, the word is too common to name a role. */
+    readonly periodLabels?: Readonly<Partial<Record<NetRole, readonly string[]>>> | undefined;
+    /** Words of magnitude (千, million): an amount written in them is rounded. */
+    readonly magnitudes: readonly string[];
+    readonly percentUnits: readonly string[];
+};
+/** An amount as written in a cell or after a label: the text around its number is its unit. */
+export type NetAmount = {
+    readonly start: number;
+    readonly value: number;
+    readonly decimals: number;
+    readonly prefix: string;
+    readonly suffix: string;
+    /** What the amount is compared on: the marks around the number and the note of its label (Net pay (USD)). */
+    readonly unit: string;
+    /** The amount as written, and whether its number groups thousands with commas. */
+    readonly written: string;
+    readonly grouped: boolean;
+};
+/** label is the role's word, its note aside: amounts of one label are one value, and parts of different labels add up. */
+export type LabelledAmount = NetAmount & {
+    readonly role: NetRole;
+    readonly period?: string | undefined;
+    readonly label?: string;
+};
+export type NetIssue = {
+    readonly offset: number;
+    readonly values: Readonly<Record<string, string>>;
+};
+/** A label read: the role it names and, when a period was cut off it, which term that period is. */
+export type LabelRead = {
+    readonly role: NetRole;
+    readonly period?: string;
+};
+/** The role a label names: the word alone or with a period on its side (前期分の納入額), its note in brackets aside. */
+export declare const readLabel: (label: string, words: NetWords) => LabelRead | undefined;
+export declare const roleOf: (label: string, words: NetWords) => NetRole | undefined;
+/** One plain number with its marks ("256,287円", "$4,301.01"); a percentage, a signed or a bracketed value is not an amount. */
+export declare const amountOf: (text: string, start: number, labelNote: string, words: Pick<NetWords, "percentUnits" | "magnitudes">) => NetAmount | undefined;
+/** A mark of currency and no word of magnitude: the amount is exact. Anything else may be rounded to its last digit. */
+export declare const isExact: (amount: NetAmount, words: Pick<NetWords, "magnitudes">) => boolean;
+/**
+ * How far the written net may be from gross minus deductions. Exact amounts must agree to their last digit. Rounded ones
+ * (千円, $ million, a bare number whose unit is in a heading) may be off by one step of the coarsest last digit: each of
+ * the three is rounded on its own, and a difference of one step is what rounding down or to nearest can leave.
+ */
+export declare const allowedGap: (amounts: readonly NetAmount[], words: NetWords) => number;
+/** The expected net, written the way the net is: the marks around its number, its digits, its decimals, its grouping. */
+export declare const shown: (value: number, like: NetAmount, decimals: number) => string;
+/**
+ * One scope (a table column, a table row, a section's labelled lines): gross, deductions and net (or taxable) each found,
+ * each with one value, all in one unit. The net is reported when it is not gross minus deductions beyond rounding.
+ * netNamed is whether the scope has a net label, even one whose value is not a plain amount (a net written as —).
+ */
+export declare const netMismatch: (amounts: readonly LabelledAmount[], words: NetWords, netNamed?: boolean) => NetIssue | undefined;
+/** A table line read as its cells, each without its edge marks, by where it starts. */
+export type NetCell = {
+    readonly start: number;
+    readonly text: string;
+};
+/** One table, read both ways: its header naming the columns, and its first column naming the rows. */
+export declare const tableNetMismatches: (header: readonly NetCell[], rows: readonly (readonly NetCell[])[], words: NetWords) => NetIssue[];
+/** A line that is a label and its amount (総支給額：117,380円, - Net pay: $1,396.41). */
+export type LabelledLine = {
+    readonly label: string;
+    readonly value: NetCell;
+};
+/** The labelled lines of one section: each label that names a role, with its amount. */
+export declare const sectionNetMismatch: (lines: readonly LabelledLine[], words: NetWords) => NetIssue | undefined;
+//# sourceMappingURL=net-amount.d.ts.map

package/dist/structure/net-amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"net-amount.d.ts","sourceRoot":"","sources":["../../src/structure/net-amount.ts"],"names":[],"mappings":"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"}

package/dist/structure/net-amount.js

@@ -0,0 +1,161 @@
+/**
+ * net-amount-mismatch: the deciding half. A net amount (差引支給額, Net pay) or a taxable amount (課税対象額, Taxable income)
+ * against the gross amount (総支給額, Gross pay) minus the total of deductions (控除合計, Total deductions) written in the same
+ * table or the same section, or minus the parts of the deductions added up (手付金, 融資金). Which words name them is data
+ * (lexicon net-amount-label, grouped gross / deduction / deduction-part / net / taxable); nothing here knows a word of payroll or tax. Pure.
+ */
+import { keyOf, labelKey, noteOf, readNumber } from "./ratio.js";
+import { withoutPeriod } from "./total-line.js";
+export const NET_ROLES = ["gross", "deduction", "deduction-part", "net", "taxable"];
+const DECIMAL_BASE = 10;
+const HALF = 0.5;
+const roleOfKey = (key, words, afterPeriod = false) => NET_ROLES.find((role) => [...words.labels[role], ...(afterPeriod ? (words.periodLabels?.[role] ?? []) : [])].some((pattern) => keyOf(pattern) === key));
+const withPeriodCut = (key, period, words) => {
+    const rest = withoutPeriod(key, { ...period, pattern: keyOf(period.pattern) });
+    const role = rest === undefined || rest === "" ? undefined : roleOfKey(rest, words, true);
+    return role === undefined ? [] : [{ role, period: period.group ?? keyOf(period.pattern) }];
+};
+/** The role a label names: the word alone or with a period on its side (前期分の納入額), its note in brackets aside. */
+export const readLabel = (label, words) => {
+    const key = labelKey(label);
+    const role = roleOfKey(key, words);
+    return role === undefined ? words.periods.flatMap((period) => withPeriodCut(key, period, words))[0] : { role };
+};
+export const roleOf = (label, words) => readLabel(label, words)?.role;
+/** A note that may name a unit: no digit in it (手付金（契約時100万円支払済） describes), and a magnitude or a currency code. */
+const CURRENCY_CODE = /^[(（]\s*[A-Z]{3}\s*[)）]$/u;
+const DIGIT_IN_NOTE = /\d/u;
+/**
+ * The part of a label's note that is a unit. An amount without marks takes its unit from the note (総支給額（千円）). An
+ * amount with its own mark keeps only a note naming a magnitude or a currency (Gross pay ($ million), Net pay (USD)); any
+ * other note says what the amount is (手付金（契約時にお支払い済み）, Loan proceeds (from the buyer's lender)) and is not its unit.
+ */
+const unitNote = (marks, labelNote, words) => {
+    const note = keyOf(labelNote);
+    if (marks === "")
+        return note;
+    const raw = labelNote.normalize("NFKC").trim();
+    const namesUnit = CURRENCY_CODE.test(raw) || words.magnitudes.some((word) => note.includes(keyOf(word)));
+    return namesUnit && !DIGIT_IN_NOTE.test(raw) ? note : "";
+};
+/** One plain number with its marks ("256,287円", "$4,301.01"); a percentage, a signed or a bracketed value is not an amount. */
+export const amountOf = (text, start, labelNote, words) => {
+    const cell = readNumber(text);
+    if (cell === undefined || words.percentUnits.some((unit) => keyOf(unit) === keyOf(cell.suffix)))
+        return undefined;
+    const [prefix, suffix] = [keyOf(cell.prefix), keyOf(cell.suffix)];
+    const unit = `${prefix}|${suffix}|${unitNote(prefix + suffix, labelNote, words)}`;
+    return { start, value: cell.value, decimals: cell.decimals, prefix, suffix, unit, written: text.trim(), grouped: text.normalize("NFKC").includes(",") };
+};
+/** The one value of a role: all its amounts the same value in the same unit; undefined when there is none or they differ. */
+const onlyAmount = (amounts, role) => {
+    const mine = amounts.filter((amount) => amount.role === role);
+    const [first] = mine;
+    if (first === undefined)
+        return undefined;
+    return mine.every((amount) => amount.value === first.value && amount.unit === first.unit) ? (mine.at(-1) ?? first) : undefined;
+};
+/** The parts of the deductions added up: one value per label (手付金 and 融資金), all in one unit; undefined otherwise. */
+const partsTotal = (amounts) => {
+    const parts = amounts.filter((amount) => amount.role === "deduction-part");
+    const labels = [...new Set(parts.map((amount) => amount.label ?? ""))];
+    const perLabel = labels.map((label) => onlyAmount(parts.filter((amount) => (amount.label ?? "") === label), "deduction-part"));
+    const values = perLabel.filter((amount) => amount !== undefined);
+    const [first] = values;
+    if (first === undefined || values.length !== perLabel.length || values.some((value) => value.unit !== first.unit))
+        return undefined;
+    const value = values.reduce((total, part) => total + part.value, 0);
+    return { ...first, value, decimals: Math.max(...values.map((part) => part.decimals)) };
+};
+/**
+ * What is taken off the gross: the total of deductions when the scope names one (控除合計), so parts written beside it are
+ * not counted twice; otherwise the parts added up (売買代金 − 手付金 − 融資金 = 残代金).
+ */
+const deductionOf = (amounts) => amounts.some((amount) => amount.role === "deduction") ? onlyAmount(amounts, "deduction") : partsTotal(amounts);
+/**
+ * The amount gross minus deductions is compared with: the net, or the taxable amount when the scope names no net. A scope
+ * that names both is a payslip whose deductions are what is paid out, not what tax is figured on, so its taxable amount
+ * is not compared.
+ */
+const resultOf = (amounts, netNamed) => onlyAmount(amounts, netNamed ? "net" : "taxable");
+/** A mark of currency and no word of magnitude: the amount is exact. Anything else may be rounded to its last digit. */
+export const isExact = (amount, words) => amount.prefix + amount.suffix !== "" && !words.magnitudes.some((word) => `${amount.prefix} ${amount.suffix}`.includes(keyOf(word)));
+/**
+ * How far the written net may be from gross minus deductions. Exact amounts must agree to their last digit. Rounded ones
+ * (千円, $ million, a bare number whose unit is in a heading) may be off by one step of the coarsest last digit: each of
+ * the three is rounded on its own, and a difference of one step is what rounding down or to nearest can leave.
+ */
+export const allowedGap = (amounts, words) => {
+    const finest = Math.max(...amounts.map((amount) => amount.decimals));
+    const coarsest = Math.min(...amounts.map((amount) => amount.decimals));
+    return amounts.every((amount) => isExact(amount, words)) ? HALF * DECIMAL_BASE ** -finest : DECIMAL_BASE ** -coarsest + HALF * DECIMAL_BASE ** -finest;
+};
+const DIGIT = /\p{Nd}/u;
+const FULL_WIDTH_DIGIT = /[０-９]/u;
+/** The distance from an ASCII digit, comma or point to its full-width form (0 → ０, , → ，). */
+const FULL_WIDTH_OFFSET = 0xfee0;
+const toFullWidth = (number) => [...number].map((char) => String.fromCodePoint((char.codePointAt(0) ?? 0) + FULL_WIDTH_OFFSET)).join("");
+/** The expected net, written the way the net is: the marks around its number, its digits, its decimals, its grouping. */
+export const shown = (value, like, decimals) => {
+    const ascii = value.toLocaleString("en-US", { minimumFractionDigits: decimals, maximumFractionDigits: decimals, useGrouping: like.grouped });
+    const number = FULL_WIDTH_DIGIT.test(like.written) ? toFullWidth(ascii) : ascii;
+    const digits = [...like.written].flatMap((char, index) => (DIGIT.test(char) ? [index] : []));
+    const [first = 0, last = like.written.length - 1] = [digits[0], digits.at(-1)];
+    return `${like.written.slice(0, first)}${number}${like.written.slice(last + 1)}`;
+};
+/**
+ * One scope (a table column, a table row, a section's labelled lines): gross, deductions and net (or taxable) each found,
+ * each with one value, all in one unit. The net is reported when it is not gross minus deductions beyond rounding.
+ * netNamed is whether the scope has a net label, even one whose value is not a plain amount (a net written as —).
+ */
+export const netMismatch = (amounts, words, netNamed = amounts.some((amount) => amount.role === "net")) => {
+    const [gross, deduction, net] = [onlyAmount(amounts, "gross"), deductionOf(amounts), resultOf(amounts, netNamed)];
+    if (gross === undefined || deduction === undefined || net === undefined)
+        return undefined;
+    if (new Set([gross, deduction, net].flatMap((amount) => amount.period ?? [])).size > 1)
+        return undefined;
+    if (gross.unit !== deduction.unit || gross.unit !== net.unit)
+        return undefined;
+    const expected = gross.value - deduction.value;
+    if (!Number.isSafeInteger(Math.round(gross.value * DECIMAL_BASE ** gross.decimals)))
+        return undefined;
+    if (expected < 0 || Math.abs(expected - net.value) <= allowedGap([gross, deduction, net], words))
+        return undefined;
+    const decimals = Math.max(gross.decimals, deduction.decimals, net.decimals);
+    return { offset: net.start, values: { written: net.written, expected: shown(expected, net, decimals) } };
+};
+const namesNet = (labels, words) => labels.some((label) => roleOf(label.text, words) === "net");
+const labelCellsOf = (lines) => lines.map((line) => ({ start: 0, text: line.label }));
+const labelledCells = (labels, values, words) => labels.flatMap((label, column) => {
+    const read = readLabel(label.text, words);
+    const value = values[column];
+    const amount = read === undefined || value === undefined ? undefined : amountOf(value.text, value.start, noteOf(label.text), words);
+    return read === undefined || amount === undefined ? [] : [{ ...amount, ...read, label: labelKey(label.text) }];
+});
+/** A table whose header names the three columns: each body row of the same width is one scope. */
+const byColumns = (header, rows, words) => rows.flatMap((row) => {
+    if (row.length !== header.length)
+        return [];
+    const issue = netMismatch(labelledCells(header, row, words), words, namesNet(header, words));
+    return issue === undefined ? [] : [issue];
+});
+/** A table whose rows are labelled in their first cell: each column after the labels is one scope. */
+const byRows = (rows, words) => {
+    const labelled = rows.filter((row) => row[0] !== undefined && roleOf(row[0].text, words) !== undefined);
+    const width = labelled[0]?.length ?? 0;
+    if (labelled.length === 0 || labelled.some((row) => row.length !== width))
+        return [];
+    return Array.from({ length: width - 1 }, (_, index) => index + 1).flatMap((column) => {
+        const amounts = labelled.flatMap((row) => labelledCells([row[0] ?? { start: 0, text: "" }], [row[column] ?? { start: 0, text: "" }], words));
+        const issue = netMismatch(amounts, words, namesNet(labelled.flatMap((row) => row.slice(0, 1)), words));
+        return issue === undefined ? [] : [issue];
+    });
+};
+/** One table, read both ways: its header naming the columns, and its first column naming the rows. */
+export const tableNetMismatches = (header, rows, words) => {
+    const issues = [...byColumns(header, rows, words), ...byRows(rows, words)];
+    return issues.filter((issue, index) => issues.findIndex((other) => other.offset === issue.offset) === index);
+};
+/** The labelled lines of one section: each label that names a role, with its amount. */
+export const sectionNetMismatch = (lines, words) => netMismatch(lines.flatMap((line) => labelledCells([{ start: 0, text: line.label }], [line.value], words)), words, namesNet(labelCellsOf(lines), words));
+//# sourceMappingURL=net-amount.js.map