chaffjs 0.29.0 → 0.31.0

package/dist/structure/requirement-lists.js

@@ -0,0 +1,89 @@
+// required-listed-as-preferred: one skill or qualification listed under a required heading or label and again under a
+// preferred one. The headings and labels, the units and words of a length of experience, and the words that only end an
+// item come from the lexicons. Pure.
+import { escapeRegExp } from "../orthography.js";
+const MARKS = /[*_`~]/gu;
+const LATIN = /^[a-z]/u;
+const plain = (text) => text.normalize("NFKC").toLowerCase().replace(MARKS, "").replace(/\s+/gu, " ").trim();
+/** A Latin word is matched at word edges; other scripts as written. */
+const wordPattern = (word) => {
+    const escaped = escapeRegExp(plain(word));
+    return LATIN.test(plain(word)) ? `(?<![a-z])${escaped}(?![a-z])` : escaped;
+};
+const alternation = (words) => words
+    .toSorted((left, right) => right.length - left.length)
+    .map(wordPattern)
+    .join("|");
+/** The text without the characters at either end that the test accepts (no backtracking regex on long lines). */
+const trimWhere = (text, isEdge) => {
+    const chars = [...text];
+    const start = chars.findIndex((char) => !isEdge(char));
+    return start === -1 ? "" : chars.slice(start, chars.findLastIndex((char) => !isEdge(char)) + 1).join("");
+};
+const LABEL_EDGE = /[\s【［[「(（】］\]」)）:：]/u;
+const asLabel = (text) => trimWhere(plain(text).replace(/[-‐–]/gu, " "), (char) => LABEL_EDGE.test(char)).replace(/\s+/gu, " ");
+const kindOfLabel = (label, words) => {
+    if (label === "")
+        return undefined;
+    if (words.required.some((word) => asLabel(word) === label))
+        return "required";
+    return words.preferred.some((word) => asLabel(word) === label) ? "preferred" : undefined;
+};
+const HEADING_PARTS = /[・/／、,，(（:：]/u;
+/** A heading names its kind by its first part (必須スキル・経験, 歓迎（あれば尚可）); a line standing alone, by all of it. */
+const kindOfHeading = (text, words) => kindOfLabel(asLabel(text.split(HEADING_PARTS)[0] ?? ""), words);
+/** A heading opens a scope that its subheadings inherit unless they name their own kind; a label holds until the next heading or label. */
+const step = (walk, block, words) => {
+    if (block.kind === "heading") {
+        const outer = walk.scopes.filter((scope) => scope.depth < block.depth);
+        const kind = kindOfHeading(block.text, words) ?? outer.at(-1)?.kind;
+        return { ...walk, scopes: [...outer, { depth: block.depth, kind, offset: block.offset }], label: undefined };
+    }
+    if (block.kind === "line") {
+        const kind = kindOfLabel(asLabel(block.text), words);
+        return kind === undefined ? walk : { ...walk, label: kind };
+    }
+    const kind = walk.label ?? walk.scopes.at(-1)?.kind;
+    const container = walk.scopes.findLast((scope) => scope.kind === undefined)?.offset ?? -1;
+    return kind === undefined ? walk : { ...walk, items: [...walk.items, { kind, text: block.text.trim(), offset: block.offset, container }] };
+};
+const numberPattern = (words) => [String.raw `\d+(?:\.\d+)?`, alternation(words.numbers.map((entry) => entry.word))].filter((part) => part !== "").join("|");
+const lengthPattern = (words) => {
+    if (words.units.length === 0)
+        return undefined;
+    const before = words.before.length === 0 ? "" : `(?:(?:${alternation(words.before)})\\s*)?`;
+    const after = words.after.length === 0 ? "" : `(?:\\s*(?:${alternation(words.after)}))*`;
+    return new RegExp(`${before}(${numberPattern(words)})\\s*\\+?\\s*(${alternation(words.units.map((unit) => unit.word))})['’]?${after}`, "gu");
+};
+const valueOf = (written, words) => words.find((entry) => plain(entry.word) === written)?.value ?? Number(written);
+/** Punctuation, symbols and spaces, but not the + and # that end a name (C++, C#). */
+const PUNCTUATION = /(?<![\p{L}\p{N}+#])[+#]|[^\p{L}\p{N}+#]/gu;
+const EDGE_PUNCTUATION = /[\p{P}\s]/u;
+const withoutEnding = (written, endings) => {
+    const text = trimWhere(written, (char) => char !== "#" && EDGE_PUNCTUATION.test(char));
+    const ending = endings.map(plain).find((word) => word !== "" && text.endsWith(word) && text.length > word.length);
+    return ending === undefined ? text : withoutEnding(text.slice(0, -ending.length), endings);
+};
+const readingOf = (text, words) => {
+    const written = plain(text);
+    const pattern = lengthPattern(words);
+    const lengths = pattern === undefined ? [] : [...written.matchAll(pattern)];
+    const months = lengths.map((match) => valueOf(match[1] ?? "", words.numbers) * (words.units.find((unit) => plain(unit.word) === match[2])?.value ?? 0));
+    const rest = pattern === undefined ? written : written.replace(pattern, " ");
+    return { core: withoutEnding(rest.replace(/\s+/gu, " ").trim(), words.endings).replace(PUNCTUATION, ""), months: Math.max(0, ...months) };
+};
+/** A preferred item repeats a required one when it names the same skill and asks for no longer experience. */
+const repeats = (preferred, required) => preferred.core !== "" && preferred.core === required.core && preferred.months <= required.months;
+/** The preferred items that repeat a required item of the same document, once each, in document order. */
+export const requiredListedAsPreferred = (blocks, words) => {
+    const { items } = blocks.reduce((walk, block) => step(walk, block, words), { scopes: [], label: undefined, items: [] });
+    const required = items.filter((item) => item.kind === "required").map((item) => ({ item, reading: readingOf(item.text, words) }));
+    return items
+        .filter((item) => item.kind === "preferred")
+        .flatMap((item) => {
+        const reading = readingOf(item.text, words);
+        const match = required.find((candidate) => candidate.item.container === item.container && repeats(reading, candidate.reading));
+        return match === undefined ? [] : [{ offset: item.offset, values: { item: item.text, required: match.item.text } }];
+    });
+};
+//# sourceMappingURL=requirement-lists.js.map

package/dist/structure/requirement-lists.js.map

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

package/dist/structure/scaled-quantities.d.ts

@@ -0,0 +1,50 @@
+import { type Cell } from "../facts/table-facts.ts";
+import { type MeasureUnit } from "../facts/measures.ts";
+import type { Mark } from "./time-marks.ts";
+/**
+ * A table with one column per number of servings or batch size (4人分 / 8人分, Serves 4 / Serves 8, ×1 / ×2), and the one
+ * row that does not grow by the columns' ratio while the others do. The words come from the language packages. Pure.
+ */
+export type ScaleWords = {
+    /** What marks a column as a number of servings (人分 after the number, Serves before it). */
+    readonly columns: readonly Mark[];
+    /** An amount that is left to the cook (少々, to taste): its row may stay as it is. */
+    readonly unscaled: readonly string[];
+    /** Spellings of one unit (teaspoon, teaspoons, tsp), each named by its group. */
+    readonly unitForms: readonly {
+        readonly pattern: string;
+        readonly group: string;
+    }[];
+    /** Units with a factor to a base unit (g and kg), so 1 kg and 1000 g read as one amount. */
+    readonly measures: readonly MeasureUnit[];
+};
+/** amount is in the base unit when the unit has a factor (1 kg is 1000); written is the number as written (1). */
+export type Amount = {
+    readonly amount: number;
+    readonly written: number;
+    readonly unit: string;
+};
+export type ScaleSlip = {
+    /** The row's first cell: the item. */
+    readonly item: Cell;
+    /** The cell that does not scale, and the column it is in. */
+    readonly cell: Cell;
+    readonly heading: string;
+    /** The cell it is compared with, and that column. */
+    readonly other: Cell;
+    readonly otherHeading: string;
+    /** What the cell would hold if it scaled like the other rows, in the unit it is written in. */
+    readonly expected: number;
+    readonly scaledRows: number;
+};
+/** Fewer rows than this that scale exactly are no evidence that the table scales at all. */
+export declare const MIN_SCALED_ROWS = 3;
+/** The number of servings a column heading names (4人分, Serves 8, ×2), or undefined. */
+export declare const servingsOf: (heading: string, marks: readonly Mark[]) => number | undefined;
+/** One cell's amount and the unit it is in. undefined when the cell holds no number, or more than one (1と1/2, 2 (300 g)). */
+export declare const amountOf: (cellText: string, words: ScaleWords) => Amount | undefined;
+/** What `amount` would be if it were `ratio` times `from`, in the unit `amount` is written in. */
+export declare const expectedOf: (from: Amount, amount: Amount, ratio: number) => number;
+/** Every table of the source with two or more servings columns, and the cells in them that do not scale. */
+export declare const scaleSlips: (source: string, words: ScaleWords) => ScaleSlip[];
+//# sourceMappingURL=scaled-quantities.d.ts.map

package/dist/structure/scaled-quantities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaled-quantities.d.ts","sourceRoot":"","sources":["../../src/structure/scaled-quantities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpF,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C,CAAC;AAEF,kHAAkH;AAClH,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,MAAM,MAAM,SAAS,GAAG;IACtB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAI,CAAC;AAMjC,uFAAuF;AACvF,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,OAAO,SAAS,IAAI,EAAE,KAAG,MAAM,GAAG,SAW7E,CAAC;AAoCF,6HAA6H;AAC7H,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,OAAO,UAAU,KAAG,MAAM,GAAG,SAavE,CAAC;AAmDF,kGAAkG;AAClG,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,MAGxE,CAAC;AAsDF,4GAA4G;AAC5G,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,OAAO,UAAU,KAAG,SAAS,EAKpE,CAAC"}

package/dist/structure/scaled-quantities.js

@@ -0,0 +1,153 @@
+import { escapeRegExp } from "../orthography.js";
+import { cellsOf, tablesOf } from "../facts/table-facts.js";
+import { measuredValues } from "../facts/measures.js";
+import { withoutEdgeMarks } from "../facts/trim-marks.js";
+import { linesOf } from "./lines.js";
+/** Fewer rows than this that scale exactly are no evidence that the table scales at all. */
+export const MIN_SCALED_ROWS = 3;
+const SAME = 1e-9;
+const MIN_COLUMNS = 2;
+const NUMBER_TEXT = "[0-9]+(?:\\.[0-9]+)?";
+/** The number of servings a column heading names (4人分, Serves 8, ×2), or undefined. */
+export const servingsOf = (heading, marks) => {
+    const text = withoutEdgeMarks(heading.normalize("NFKC").trim()).toLowerCase();
+    const read = marks
+        .map((mark) => {
+        const word = escapeRegExp(mark.pattern.normalize("NFKC").toLowerCase());
+        const pattern = mark.position === "before" ? `^${word}\\s*(${NUMBER_TEXT})$` : `^(${NUMBER_TEXT})\\s*${word}$`;
+        return new RegExp(pattern, "u").exec(text)?.[1];
+    })
+        .find((number) => number !== undefined);
+    const servings = read === undefined ? undefined : Number(read);
+    return servings === undefined || !Number.isFinite(servings) || servings <= 0 ? undefined : servings;
+};
+/** A whole or decimal number (1,000 and 1.5), with a fraction after it (1 1/2) or as a fraction (1/2, ½). */
+const WHOLE = String.raw `[0-9]+(?:,[0-9]{3})*(?:\.[0-9]+)?`;
+const FRACTION = String.raw `(?:\s([0-9]+)[/⁄]([0-9]+)|[/⁄]([0-9]+))?`;
+const AMOUNT = new RegExp(String.raw `(?<![\p{N}.,/⁄])(${WHOLE})${FRACTION}(?![\p{N}/⁄])`, "gu");
+const valueOf = (match) => {
+    const whole = Number((match[1] ?? "").replace(/,/gu, ""));
+    if (match[4] !== undefined)
+        return whole / Number(match[4]);
+    return match[2] === undefined ? whole : whole + Number(match[2]) / Number(match[3]);
+};
+const LETTER_BEFORE = "(?<!\\p{L})";
+const LETTER_AFTER = "(?!\\p{L})";
+/** The cell's text with its number taken out and each spelling of a unit written as its group: "2 teaspoons" is "#teaspoon". */
+const unitKey = (text, numberAt, forms) => {
+    const rest = `${text.slice(0, numberAt.start)}#${text.slice(numberAt.end)}`.toLowerCase();
+    const groups = new Map(forms.map((form) => [form.pattern.toLowerCase(), form.group]));
+    const spellings = [...groups.keys()].filter((pattern) => pattern !== "").toSorted((left, right) => right.length - left.length);
+    const grouped = spellings.length === 0
+        ? rest
+        : rest.replace(new RegExp(`${LETTER_BEFORE}(?:${spellings.map(escapeRegExp).join("|")})${LETTER_AFTER}`, "gu"), (spelling) => `<${groups.get(spelling) ?? spelling}>`);
+    return grouped.replace(/\s+/gu, "");
+};
+/** NFKC writes ½ as 1⁄2, so 1½ would read as 11⁄2: a space keeps the whole number apart (1 1⁄2). */
+const VULGAR_AFTER_DIGIT = /([0-9０-９])([¼½¾⅐-⅞])/gu;
+const normalized = (cellText) => withoutEdgeMarks(cellText.replace(VULGAR_AFTER_DIGIT, "$1 $2").normalize("NFKC").trim());
+/** One cell's amount and the unit it is in. undefined when the cell holds no number, or more than one (1と1/2, 2 (300 g)). */
+export const amountOf = (cellText, words) => {
+    const text = normalized(cellText);
+    const numbers = [...text.matchAll(AMOUNT)];
+    const [only] = numbers;
+    if (numbers.length !== 1 || only === undefined)
+        return undefined;
+    const written = valueOf(only);
+    if (!Number.isFinite(written))
+        return undefined;
+    const [measured] = measuredValues(text, words.measures);
+    const factor = measured?.factors[0];
+    if (measured !== undefined && factor !== undefined && measured.start === only.index && measured.end === text.length) {
+        return { amount: measured.amount * factor, written: measured.amount, unit: `=${measured.dimension}` };
+    }
+    return { amount: written, written, unit: unitKey(text, { start: only.index, end: only.index + only[0].length }, words.unitForms) };
+};
+const isUnscaled = (text, unscaled) => {
+    const lower = text.normalize("NFKC").toLowerCase();
+    return unscaled.some((word) => word !== "" && lower.includes(word.normalize("NFKC").toLowerCase()));
+};
+/** The rows of one table whose item is named, as cells. */
+const rowsOf = (rows) => rows.flatMap((line) => {
+    const cells = cellsOf(line);
+    const [item] = cells;
+    return item === undefined || withoutEdgeMarks(item.text) === "" ? [] : [{ item, cells }];
+});
+/** Each row's two cells, when both are amounts in one unit and the row is not left to the cook. */
+const readablePairs = (rows, base, other, words) => rows.flatMap((row) => {
+    const [baseCell, cell] = [row.cells[base.index], row.cells[other.index]];
+    if (baseCell === undefined || cell === undefined)
+        return [];
+    if (isUnscaled(baseCell.text, words.unscaled) || isUnscaled(cell.text, words.unscaled))
+        return [];
+    const [from, to] = [amountOf(baseCell.text, words), amountOf(cell.text, words)];
+    if (from === undefined || to === undefined || from.unit !== to.unit)
+        return [];
+    const scaled = (from.amount * other.servings) / base.servings;
+    return [{ row, baseCell, cell, from, to, scales: Math.abs(to.amount - scaled) <= SAME * Math.max(Math.abs(scaled), 1) }];
+});
+/** The one row of a column that departs from the base column while at least MIN_SCALED_ROWS others scale exactly. */
+const departureOf = (rows, base, other, words) => {
+    const pairs = readablePairs(rows, base, other, words);
+    const departing = pairs.filter((pair) => !pair.scales);
+    const [only] = departing;
+    const scaled = pairs.length - departing.length;
+    return departing.length === 1 && only !== undefined && scaled >= MIN_SCALED_ROWS ? { pair: only, scaled } : undefined;
+};
+/** What `amount` would be if it were `ratio` times `from`, in the unit `amount` is written in. */
+export const expectedOf = (from, amount, ratio) => {
+    const perWritten = amount.written === 0 || amount.amount === 0 ? 1 : amount.amount / amount.written;
+    return (from.amount * ratio) / perWritten;
+};
+const columnSlip = (base, other, { pair, scaled }) => ({
+    item: pair.row.item,
+    cell: pair.cell,
+    heading: other.heading,
+    other: pair.baseCell,
+    otherHeading: base.heading,
+    expected: expectedOf(pair.from, pair.to, other.servings / base.servings),
+    scaledRows: scaled,
+});
+const baseSlip = (base, other, { pair, scaled }) => ({
+    item: pair.row.item,
+    cell: pair.baseCell,
+    heading: base.heading,
+    other: pair.cell,
+    otherHeading: other.heading,
+    expected: expectedOf(pair.to, pair.from, base.servings / other.servings),
+    scaledRows: scaled,
+});
+/** Whether the row's cells outside the first column scale with each other (a row fixed in every column does not). */
+const othersAgree = (found) => {
+    const perServing = found.map(({ other, departure }) => (departure === undefined ? Number.NaN : departure.pair.to.amount / other.servings));
+    const [first] = perServing;
+    return first !== undefined && perServing.every((value) => Math.abs(value - first) <= SAME * Math.max(Math.abs(first), 1));
+};
+/**
+ * One table's slips. Each column is compared with the first servings column. When the same row departs in every other column
+ * (three or more columns) and those columns scale with each other, it is the first column's cell that is off, and that cell is
+ * reported once; a row that departs everywhere without that (the same amount in every column) may be fixed on purpose.
+ */
+const tableSlips = (columns, rows, words) => {
+    const [base, ...others] = columns;
+    if (base === undefined)
+        return [];
+    const found = others.map((other) => ({ other, departure: departureOf(rows, base, other, words) }));
+    const [first] = found;
+    const offRows = new Set(found.map(({ departure }) => departure?.pair.row));
+    if (others.length > 1 && offRows.size === 1 && first?.departure !== undefined) {
+        return othersAgree(found) ? [baseSlip(base, first.other, first.departure)] : [];
+    }
+    return found.flatMap(({ other, departure }) => (departure === undefined ? [] : [columnSlip(base, other, departure)]));
+};
+const columnsOf = (header, marks) => cellsOf(header).flatMap((cell, index) => {
+    const servings = index === 0 ? undefined : servingsOf(cell.text, marks);
+    return servings === undefined ? [] : [{ index, servings, heading: withoutEdgeMarks(cell.text.trim()) }];
+});
+/** Every table of the source with two or more servings columns, and the cells in them that do not scale. */
+export const scaleSlips = (source, words) => tablesOf(linesOf(source)).flatMap((table) => {
+    const columns = columnsOf(table.header, words.columns);
+    const distinct = new Set(columns.map((column) => column.servings));
+    return distinct.size === columns.length && columns.length >= MIN_COLUMNS ? tableSlips(columns, rowsOf(table.rows), words) : [];
+});
+//# sourceMappingURL=scaled-quantities.js.map

package/dist/structure/scaled-quantities.js.map

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

package/dist/structure/stamp-order.d.ts

@@ -0,0 +1,16 @@
+import type { DatedSpan } from "./date-range.ts";
+import type { StructureIssue } from "./issues.ts";
+/**
+ * A document's stamp dates out of order: an established date (2024年10月1日 制定, Established: April 1, 2023) later than an
+ * update (2024年9月1日 最終改定, Last updated: September 1, 2024). A stamp line (or one part of a line that holds several dates)
+ * holds one full date and, once the date is taken out, nothing but one stamp word (with colons, brackets, emphasis or a list
+ * marker around it). Only stamps written together are compared. Both stamps are reported, each naming the other: nothing tells
+ * which of the two dates is the wrong one. Pure; the stamp words come from the caller.
+ */
+export type StampWords = {
+    readonly established: readonly string[];
+    readonly updated: readonly string[];
+};
+/** Each established stamp later than an update of its block, and each such update, the one naming the other. */
+export declare const stampOrderIssues: (source: string, dates: readonly DatedSpan[], words: StampWords) => StructureIssue[];
+//# sourceMappingURL=stamp-order.d.ts.map

package/dist/structure/stamp-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-order.d.ts","sourceRoot":"","sources":["../../src/structure/stamp-order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAkF1G,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,OAAO,SAAS,SAAS,EAAE,EAAE,OAAO,UAAU,KAAG,cAAc,EAK/G,CAAC"}

package/dist/structure/stamp-order.js

@@ -0,0 +1,78 @@
+import { linesOf } from "./lines.js";
+const FULL_DATE = /^\d{4}-\d{2}-\d{2}$/u;
+/** How many lines apart two stamps may be and still be one document's stamp block; further apart, they date two documents. */
+const MAX_LINE_GAP = 6;
+/** What may stand around a stamp word: spaces, colons, brackets, table bars, Markdown emphasis and list markers. */
+const AROUND_WORD = /[\s:：*_()（）[\]「」【】|｜\-‐−・]/u;
+/** A part of a line between a wide space, a tab or a bar. */
+const FIELD = /[^\t\u3000|｜]+/gu;
+const bareWord = (text) => {
+    const chars = [...text];
+    const first = chars.findIndex((char) => !AROUND_WORD.test(char));
+    const last = chars.findLastIndex((char) => !AROUND_WORD.test(char));
+    return first === -1
+        ? ""
+        : chars
+            .slice(first, last + 1)
+            .join("")
+            .toLowerCase();
+};
+const kindOf = (word, words) => {
+    const isOne = (list) => list.some((entry) => entry.toLowerCase() === word);
+    if (isOne(words.established))
+        return "established";
+    return isOne(words.updated) ? "updated" : undefined;
+};
+const datesIn = (dates, field) => dates.filter((date) => date.offset >= field.start && date.end <= field.end);
+/** A line, or, when it holds more than one date, its parts between wide spaces, tabs and bars (作成：平成16年2月4日, a wide space, 最終改定：令和3年11月19日). */
+const fieldsOf = (source, dates) => linesOf(source).flatMap((line) => {
+    const whole = { start: line.start, end: line.start + line.text.length, line: line.number };
+    if (datesIn(dates, whole).length < 2)
+        return [whole];
+    return [...line.text.matchAll(FIELD)].map((match) => ({
+        start: line.start + match.index,
+        end: line.start + match.index + match[0].length,
+        line: line.number,
+    }));
+});
+/** The stamps of a text: a line or field holding one full date and one stamp word, nothing else. */
+const stampsOf = (source, dates, words) => fieldsOf(source, dates).flatMap((field) => {
+    const [date, ...more] = datesIn(dates, field);
+    if (date === undefined || more.length > 0 || !FULL_DATE.test(date.value))
+        return [];
+    const rest = `${source.slice(field.start, date.offset)} ${source.slice(date.end, field.end)}`;
+    const kind = kindOf(bareWord(rest), words);
+    return kind === undefined ? [] : [{ kind, date, line: field.line }];
+});
+/** Stamps written together, each within MAX_LINE_GAP lines of the one before: one document's stamp block. */
+const blocksOf = (stamps) => stamps.reduce((blocks, stamp, index) => {
+    const previous = stamps[index - 1];
+    const last = blocks.at(-1);
+    if (previous === undefined || last === undefined || stamp.line - previous.line > MAX_LINE_GAP)
+        return [...blocks, [stamp]];
+    return [...blocks.slice(0, -1), [...last, stamp]];
+}, []);
+const valuesOf = (established, updated) => ({ established: established.date.value, updated: updated.date.value });
+/** In one block: each established stamp later than an update, against the latest such update, and each such update against the first such established stamp. */
+const blockIssues = (block) => {
+    const established = block.filter((stamp) => stamp.kind === "established");
+    const updates = block.filter((stamp) => stamp.kind === "updated").toSorted((a, b) => b.date.value.localeCompare(a.date.value));
+    const ofEstablished = established.flatMap((stamp) => {
+        const latest = updates.find((updated) => updated.date.value < stamp.date.value);
+        return latest === undefined ? [] : [{ offset: stamp.date.offset, values: valuesOf(stamp, latest) }];
+    });
+    const ofUpdates = updates.flatMap((updated) => {
+        const later = established.find((stamp) => stamp.date.value > updated.date.value);
+        return later === undefined ? [] : [{ offset: updated.date.offset, values: { ...valuesOf(later, updated), side: "updated" } }];
+    });
+    return [...ofEstablished, ...ofUpdates];
+};
+/** Each established stamp later than an update of its block, and each such update, the one naming the other. */
+export const stampOrderIssues = (source, dates, words) => {
+    if (words.established.length === 0 || words.updated.length === 0)
+        return [];
+    return blocksOf(stampsOf(source, dates, words))
+        .flatMap(blockIssues)
+        .toSorted((a, b) => a.offset - b.offset);
+};
+//# sourceMappingURL=stamp-order.js.map

package/dist/structure/stamp-order.js.map

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

package/dist/structure/step-times.d.ts

@@ -0,0 +1,49 @@
+import type { Span } from "../plugin.ts";
+import { type LengthWords } from "../derived/time-lengths.ts";
+import { type Mark } from "./time-marks.ts";
+/**
+ * A stated total time (所要時間：80分, Total time: 1 hr 20 min) against the sum of the times written in the numbered steps
+ * ((10分), bake for 40 minutes). The words come from the language packages; nothing here knows a language. Pure.
+ */
+export type StepTimeWords = {
+    readonly lengths: LengthWords;
+    /** Labels of a total time (所要時間, Total time), written before the length. */
+    readonly totals: readonly Mark[];
+    /** Marks of a rough figure (約, about, 程度): the total or a step that carries one is compared with a margin. */
+    readonly approximate: readonly Mark[];
+    /** Marks of a time that is not how long the step takes (10分後, every 5 minutes, after 10 minutes). */
+    readonly notOwn: readonly Mark[];
+    /** What joins the two ends of a range (10〜15分, 10 to 15 minutes): a step or total with a range is not read. */
+    readonly rangeJoiners: readonly string[];
+};
+/** A length of time with whether it was written as a rough figure. */
+export type ReadTime = Span & {
+    readonly minutes: number;
+    readonly approximate: boolean;
+};
+export type StepTimeSlip = {
+    readonly total: ReadTime;
+    readonly sum: number;
+    readonly steps: number;
+    /** How far the sum may be from the total and still agree, in minutes: 0 unless a rough figure is involved. */
+    readonly margin: number;
+};
+/** A rough total agrees with a sum within this share of the total, and never less than ROUGH_MINUTES. */
+export declare const ROUGH_SHARE = 0.1;
+export declare const ROUGH_MINUTES = 5;
+/** The numbered lists of the source, each a run of items with only blank or indented lines between them. An item holds its line and the indented lines right under it. */
+export declare const stepLists: (source: string) => Span[][];
+/** Every numbered step of the source. */
+export declare const stepItems: (source: string) => Span[];
+/** How long one step takes: its one own length of time. undefined when it has none, more than one, or a range. */
+export declare const stepTime: (text: string, words: StepTimeWords) => ReadTime | undefined;
+/** The total time the source states outside its steps: a length with a total label right before it. Only one value is read. */
+export declare const statedTotal: (source: string, items: readonly Span[], words: StepTimeWords) => ReadTime | undefined;
+/** The margin a rough figure allows: ROUGH_SHARE of the total, at least ROUGH_MINUTES. */
+export declare const marginOf: (total: number, rough: boolean) => number;
+/**
+ * The stated total against the sum of the steps' times, when the document has one numbered list, every step's time is readable,
+ * and they do not agree. Two lists may be two procedures, or one of them no procedure, so a document with two is not read.
+ */
+export declare const stepTimeSlip: (source: string, words: StepTimeWords) => StepTimeSlip | undefined;
+//# sourceMappingURL=step-times.d.ts.map

package/dist/structure/step-times.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-times.d.ts","sourceRoot":"","sources":["../../src/structure/step-times.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAwB,KAAK,WAAW,EAAmB,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,8GAA8G;IAC9G,QAAQ,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC;IACtC,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,+GAA+G;IAC/G,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1F,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8GAA8G;IAC9G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,yGAAyG;AACzG,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,aAAa,IAAI,CAAC;AA2B/B,0KAA0K;AAC1K,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAAI,EAAE,EAA+F,CAAC;AAEjJ,yCAAyC;AACzC,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAAI,EAA8B,CAAC;AAuD9E,kHAAkH;AAClH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,OAAO,aAAa,KAAG,QAAQ,GAAG,SAKxE,CAAC;AAeF,+HAA+H;AAC/H,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,OAAO,SAAS,IAAI,EAAE,EAAE,OAAO,aAAa,KAAG,QAAQ,GAAG,SAMrG,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,OAAO,OAAO,KAAG,MAAoE,CAAC;AAE9H;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,OAAO,aAAa,KAAG,YAAY,GAAG,SAWlF,CAAC"}