postext 1.8.5 → 1.9.0

package/dist/chineseNumerals.js

@@ -0,0 +1,192 @@
+/**
+ * Chinese numerals, written and read: the CSS Counter Styles 3 longhand
+ * (`simp-chinese-informal` 一百二十, `trad-chinese-formal` 壹佰貳拾), the
+ * digit-by-digit `cjk-decimal` (二〇二六), the heavenly stems and earthly
+ * branches, circled and fullwidth digits — and the reverse, for part numbers
+ * an author typed (`卷三`, `第十二`, `一二〇`).
+ */
+const INFORMAL_DIGITS = ['零', '一', '二', '三', '四', '五', '六', '七', '八', '九'];
+const SIMP_FORMAL_DIGITS = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
+const TRAD_FORMAL_DIGITS = ['零', '壹', '貳', '參', '肆', '伍', '陸', '柒', '捌', '玖'];
+/** 十 百 千 (informal) and 拾 佰 仟 (formal), for the tens, hundreds and
+ *  thousands of a four-digit group. */
+const INFORMAL_MARKERS = ['', '十', '百', '千'];
+const FORMAL_MARKERS = ['', '拾', '佰', '仟'];
+/** The units of the four-digit groups: 10⁴, 10⁸ and 10¹². Mainland usage
+ *  writes 10¹² 万亿, Taiwan 兆. */
+const SIMP_GROUP_UNITS = ['', '万', '亿', '万亿'];
+const TRAD_GROUP_UNITS = ['', '萬', '億', '兆'];
+/** Past this the numerals print in digits. */
+const MAX_CHINESE = 10 ** 16 - 1;
+/** One group of up to four digits (1–9999): each digit with its marker, a
+ *  zero inside the group written 零 once, zeros at the end dropped. */
+function groupText(g, digits, markers) {
+    let out = '';
+    let zero = false;
+    for (let pos = 3; pos >= 0; pos--) {
+        const d = Math.floor(g / 10 ** pos) % 10;
+        if (d === 0) {
+            if (out.length > 0)
+                zero = true;
+            continue;
+        }
+        if (zero) {
+            out += digits[0];
+            zero = false;
+        }
+        out += digits[d] + markers[pos];
+    }
+    return out;
+}
+/**
+ * `n` (a positive integer) in Chinese numerals, as CSS Counter Styles 3
+ * writes the Chinese longhand, extended past 9 999 with the group units
+ * 万/萬, 亿/億: each digit followed by its marker (十 百 千, formal 拾 佰 仟),
+ * the marker dropped after a zero, a run of zeros written 零 once, zeros at
+ * the end dropped; in the informal style 10–19 open with 十, not 一十
+ * (十二, but 一百一十). 101 一百零一, 1010 一千零一十, 10010 一万零一十.
+ * Past 10¹⁶ − 1 the number prints in digits.
+ */
+export function chineseNumeral(n, kind, traditional) {
+    if (!Number.isSafeInteger(n) || n < 1 || n > MAX_CHINESE)
+        return String(n);
+    const digits = kind === 'formal' ? (traditional ? TRAD_FORMAL_DIGITS : SIMP_FORMAL_DIGITS) : INFORMAL_DIGITS;
+    const markers = kind === 'formal' ? FORMAL_MARKERS : INFORMAL_MARKERS;
+    const units = traditional ? TRAD_GROUP_UNITS : SIMP_GROUP_UNITS;
+    const groups = [];
+    for (let x = n; x > 0; x = Math.floor(x / 10_000))
+        groups.push(x % 10_000);
+    let out = '';
+    let zero = false;
+    for (let i = groups.length - 1; i >= 0; i--) {
+        const g = groups[i];
+        if (g === 0) {
+            if (out.length > 0)
+                zero = true;
+            continue;
+        }
+        // A group after a higher one that does not fill its thousands starts
+        // with 零: 一万零一十 (10 010), 一亿零一万 (100 010 000).
+        if (out.length > 0 && (zero || g < 1000))
+            out += digits[0];
+        zero = false;
+        let text = groupText(g, digits, markers);
+        // 十, 十二 for 10–19 at the head of the number (十万 for 100 000).
+        if (kind === 'informal' && out.length === 0 && g >= 10 && g <= 19)
+            text = text.slice(1);
+        out += text + units[i];
+    }
+    return out;
+}
+const CJK_DECIMAL_DIGITS = ['〇', '一', '二', '三', '四', '五', '六', '七', '八', '九'];
+/** Digit by digit in Chinese numerals, with 〇 for zero: 2026 → 二〇二六
+ *  (GB/T 15835—2011 §5.2.5, as years and serial numbers are written). */
+export function cjkDecimal(n) {
+    return String(n).replace(/\d/g, (d) => CJK_DECIMAL_DIGITS[Number(d)]);
+}
+/** Fullwidth digits: 123 → １２３. */
+export function fullwidthDecimal(n) {
+    return String(n).replace(/\d/g, (d) => String.fromCharCode(0xff10 + Number(d)));
+}
+/** Circled digits ① … ㊿ (U+2460–2473, U+3251–325F, U+32B1–32BF), ⓪ for
+ *  zero; past 50 the number prints in digits. */
+export function circledDecimal(n) {
+    if (n === 0)
+        return '⓪';
+    if (!Number.isInteger(n) || n < 0 || n > 50)
+        return String(n);
+    if (n <= 20)
+        return String.fromCharCode(0x2460 + n - 1);
+    if (n <= 35)
+        return String.fromCharCode(0x3251 + n - 21);
+    return String.fromCharCode(0x32b1 + n - 36);
+}
+/** The ten heavenly stems, 甲 to 癸. */
+export const CJK_HEAVENLY_STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
+/** The twelve earthly branches, 子 to 亥. */
+export const CJK_EARTHLY_BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
+/** The `n`th symbol of a fixed series (1-based); past its end the number
+ *  prints in digits. */
+export function fixedSymbol(n, symbols) {
+    return Number.isInteger(n) && n >= 1 && n <= symbols.length ? symbols[n - 1] : String(n);
+}
+// ---------------------------------------------------------------------------
+// Reading
+// ---------------------------------------------------------------------------
+/** Value of each digit character, informal and formal, both scripts. */
+const DIGIT_VALUES = new Map([
+    ['〇', 0], ['零', 0], ['○', 0],
+    ['一', 1], ['壹', 1],
+    ['二', 2], ['贰', 2], ['貳', 2], ['两', 2], ['兩', 2],
+    ['三', 3], ['叁', 3], ['參', 3],
+    ['四', 4], ['肆', 4],
+    ['五', 5], ['伍', 5],
+    ['六', 6], ['陆', 6], ['陸', 6],
+    ['七', 7], ['柒', 7],
+    ['八', 8], ['捌', 8],
+    ['九', 9], ['玖', 9],
+]);
+const SMALL_MARKERS = new Map([
+    ['十', 10], ['拾', 10], ['百', 100], ['佰', 100], ['千', 1000], ['仟', 1000],
+]);
+/** Value of a group below 10 000 written with markers (十二, 一百零一,
+ *  壹佰贰拾); `undefined` when it is not one. */
+function readGroup(s) {
+    let total = 0;
+    let digit;
+    let lastMarker = 10_000;
+    for (const ch of s) {
+        const d = DIGIT_VALUES.get(ch);
+        if (d !== undefined) {
+            if (digit !== undefined && digit !== 0 && d !== 0)
+                return undefined;
+            digit = d;
+            continue;
+        }
+        const m = SMALL_MARKERS.get(ch);
+        if (m === undefined || m >= lastMarker)
+            return undefined;
+        total += (digit ?? 1) * m;
+        digit = undefined;
+        lastMarker = m;
+    }
+    return total + (digit ?? 0);
+}
+/** Value of a number written with the group units 万/萬, 亿/億, 兆
+ *  (一万零一十, 十二万, 一亿二千万). */
+function readWithUnits(s) {
+    for (const [units, value] of [[['兆'], 1e12], [['亿', '億'], 1e8], [['万', '萬'], 1e4]]) {
+        const at = Math.max(...units.map((u) => s.indexOf(u)));
+        if (at < 0)
+            continue;
+        const head = s.slice(0, at);
+        const tail = s.slice(at + 1);
+        const high = head.length === 0 ? 1 : readWithUnits(head);
+        const low = tail.length === 0 ? 0 : readWithUnits(tail);
+        return high === undefined || low === undefined ? undefined : high * value + low;
+    }
+    return readGroup(s);
+}
+/**
+ * The value of a number written in Chinese numerals: the longhand, informal
+ * or formal, in either script (三, 十二, 一百零一, 一万零一十, 壹佰贰拾), or
+ * digit by digit (一二〇, 二〇二六). `undefined` for anything else.
+ */
+export function parseChineseNumeral(text) {
+    const s = text.trim();
+    if (s.length === 0)
+        return undefined;
+    const chars = [...s];
+    // Digits only, more than one: read digit by digit (一二〇 = 120).
+    if (chars.length > 1 && chars.every((c) => DIGIT_VALUES.has(c) && c !== '两' && c !== '兩')) {
+        let n = 0;
+        for (const c of chars)
+            n = n * 10 + DIGIT_VALUES.get(c);
+        return n;
+    }
+    if (!chars.every((c) => DIGIT_VALUES.has(c) || SMALL_MARKERS.has(c) || c === '万' || c === '萬' || c === '亿' || c === '億' || c === '兆'))
+        return undefined;
+    const n = readWithUnits(s);
+    return n !== undefined && Number.isSafeInteger(n) ? n : undefined;
+}
+//# sourceMappingURL=chineseNumerals.js.map

package/dist/chineseNumerals.js.map

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

package/dist/cjkMarks.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The Chinese interlinear marks of a laid-out document (#193): emphasis dots
+ * (着重号), the proper-name line (专名号) and the wavy book-title line
+ * (书名号甲式), as `VDTLine.marks` — primitives the renderers draw as they
+ * are — and the leading checks of marks and ruby (#194).
+ *
+ * The measurer flags the segments (`VDTLineSegment.cjkMarks`); the marks are
+ * placed once the document is laid out, where the renderers paint each
+ * segment ({@link segmentPositions}: alignment and the justified word
+ * spaces of a line included), in the flow frame of the line. Dots are
+ * centred on each character, spacing after it left out, and skip
+ * punctuation and spaces; a line spans its run's characters, and where two
+ * runs meet each end gives up an eighth of an em (clreq §5.6.1). Marks sit
+ * against the characters' em box, centred on the font's central axis:
+ * under in horizontal text (left in vertical text), emphasis dots over in
+ * vertical text (right); when dots and a line mark the same text on one
+ * side, the line is nearer the text.
+ */
+import type { ContentWarning, VDTBlock, VDTDocument, VDTLine, VDTLineMark, VDTLineSegment } from './vdt';
+import type { CjkRegion, ResolvedCjkConfig } from './types';
+/** What a block contributes to its lines' painting. */
+type BlockLike = Pick<VDTBlock, 'bbox' | 'textAlign' | 'letterSpacing' | 'fontString' | 'boldFontString' | 'italicFontString' | 'boldItalicFontString'>;
+/**
+ * Where the renderers paint each segment of a line: its x (absolute, in
+ * the flow frame) and the advance they give it — a word space of a
+ * justified line its share of the slack, a centred or right-aligned line
+ * shifted by its slack. Mirrors the line painters of the canvas, PDF and
+ * HTML backends.
+ */
+export declare function segmentPositions(line: VDTLine, block: BlockLike): {
+    xs: number[];
+    widths: number[];
+};
+/** The font a segment is painted in. */
+export declare function segmentFont(seg: VDTLineSegment, block: BlockLike): string;
+/** What a vertical line's dots need to find its upright cells. */
+interface VerticalMarks {
+    region: CjkRegion;
+    uprightDigits: number;
+}
+/** The marks of one line (see the module comment), relative to it; empty
+ *  when it has none. `color` is `cjk.annotationColor` (hex), if set;
+ *  `vertical` is set on a vertical page. */
+export declare function lineMarks(line: VDTLine, block: BlockLike, color?: string, vertical?: VerticalMarks): VDTLineMark[];
+/**
+ * Set `VDTLine.marks` on every line of the document that holds Chinese
+ * marks, and report the paragraphs whose line gap is narrower than their
+ * marks or readings need (`cjkMarksExceedLeading`, `rubyExceedsLeading`),
+ * once per paragraph. `cjk` is the resolved configuration (its
+ * `annotationColor`).
+ *
+ * The gap between two lines of a column is shared: what the upper line
+ * sets under it and the lower one over it (dots under one line and the
+ * readings over the next, in one paragraph or across two) must fit in it
+ * together. Where they do not, the lower line's paragraph is reported
+ * (`rubyExceedsLeading` when readings take part, else
+ * `cjkMarksExceedLeading`).
+ */
+export declare function annotateDocument(doc: VDTDocument, cjk: ResolvedCjkConfig | undefined): ContentWarning[];
+export {};
+//# sourceMappingURL=cjkMarks.d.ts.map

package/dist/cjkMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjkMarks.d.ts","sourceRoot":"","sources":["../src/cjkMarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAU5D,uDAAuD;AACvD,KAAK,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,sBAAsB,CAAC,CAAC;AAExJ;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAiCpG;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAMzE;AAiED,kEAAkE;AAClE,UAAU,aAAa;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;4CAE4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,WAAW,EAAE,CAoGlH;AAiFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,SAAS,GAAG,cAAc,EAAE,CAmFvG"}