postext 1.8.6 → 1.9.0

package/dist/measure/vertical.js

@@ -0,0 +1,184 @@
+/**
+ * Measurement in vertical text (`layout.writingMode: 'vertical-rl'`).
+ *
+ * A vertical line is measured as a horizontal one in the turned flow frame
+ * (see `VDTPage.flow`), cut into the runs the renderers paint
+ * (`verticalRuns`): a Latin word or number set sideways keeps its
+ * horizontal advance, and every character that stands in a cell of its own
+ * (Han, Chinese punctuation, dashes, ellipses, and the symbols Unicode sets
+ * upright — × © ± ℃ ① —, inside a Latin word or number too) advances its
+ * cell down the line, whatever its horizontal width. {@link cellAdvance} is
+ * the one place a cell's advance is decided; the composer then applies the
+ * punctuation widths (`cjkPunctuation.ts`: compression, line-edge trims,
+ * hanging, the Han–Latin space) to the cells as it does to horizontal
+ * advances, along the line. {@link verticalTextWidth} measures any run of
+ * text with it.
+ */
+import { measureTextWidth, measureInkBox, onTextWidthCacheClear } from './canvas';
+import { isVerticalCell, verticalCellEms, verticalRuns } from '../writingMode';
+import { graphemesOf } from './graphemes';
+import { DEFAULT_CENTRAL_BASELINE } from '../vdt';
+const FONT_SIZE_RE = /(\d*\.?\d+)px/;
+let measureWritingMode = 'horizontal-tb';
+let measureRegion = 'mainland';
+let measureUprightDigits = 2;
+/** Set the writing mode text is measured in, and the Chinese region whose
+ *  cells it uses (the mainland interpunct takes half a cell). The build
+ *  does, from the layout of the pages it is placing (a styled section may
+ *  change it), and puts back what it found when it is done. */
+export function setMeasureWritingMode(mode, region = measureRegion) {
+    measureWritingMode = mode === 'vertical-rl' ? 'vertical-rl' : 'horizontal-tb';
+    measureRegion = region;
+}
+/** The writing mode text is measured in (see {@link setMeasureWritingMode});
+ *  horizontal outside a build. */
+export function getMeasureWritingMode() {
+    return measureWritingMode;
+}
+/** Set how many ASCII digits a number may have to be set in one upright
+ *  cell in vertical text (`cjk.uprightDigits`; 0: none). The build does,
+ *  from the document's configuration, and puts back what it found. */
+export function setMeasureUprightDigits(digits) {
+    measureUprightDigits = digits;
+}
+/** See {@link setMeasureUprightDigits}; 2 outside a build. */
+export function getMeasureUprightDigits() {
+    return measureUprightDigits;
+}
+/** The Chinese region vertical cells are measured for. */
+export function getMeasureRegion() {
+    return measureRegion;
+}
+/** Whether text is measured vertically now. */
+export function measuringVertically() {
+    return measureWritingMode === 'vertical-rl';
+}
+/** Run `fn` with text measured in `mode` (and `region`), then put back the
+ *  mode in force before — also when `fn` throws. */
+export function withMeasureWritingMode(mode, fn, region = measureRegion) {
+    const prevMode = measureWritingMode;
+    const prevRegion = measureRegion;
+    if (prevMode === mode && prevRegion === region)
+        return fn();
+    setMeasureWritingMode(mode, region);
+    try {
+        return fn();
+    }
+    finally {
+        measureWritingMode = prevMode;
+        measureRegion = prevRegion;
+    }
+}
+/** The em of a font string (its size in px), 16 when it names none. */
+export function fontEm(font) {
+    const m = FONT_SIZE_RE.exec(font);
+    return m ? parseFloat(m[1]) : 16;
+}
+/**
+ * The advance of one CJK grapheme along its line. Horizontal: its measured
+ * width. Vertical: its cell for every character that stands in one (one
+ * em; half an em for the mainland interpunct, `verticalCellEms`); a
+ * character set sideways keeps its horizontal width. `cls` is the
+ * grapheme's line-break class, when the caller has it. This is a mark's
+ * full advance: the composition takes its blank off afterwards
+ * (`punctuationBox`), in either writing mode.
+ */
+export function cellAdvance(grapheme, font, vertical, cls) {
+    if (vertical && isVerticalCell(grapheme))
+        return fontEm(font) * verticalCellEms(grapheme, measureRegion, cls);
+    return measureTextWidth(grapheme, font);
+}
+/**
+ * The advance of `text` along a vertical line: its sideways runs at
+ * `measureRun`'s width (the horizontal one), each cell at
+ * {@link cellAdvance}. The same runs the renderers paint
+ * (`verticalRuns`), so what is measured is what is painted. Text with no
+ * cell is one sideways run: `measureRun(text)`.
+ */
+export function verticalTextWidth(text, font, measureRun = (run) => measureTextWidth(run, font)) {
+    let width = 0;
+    for (const run of verticalRuns(graphemesOf(text), measureRegion, measureUprightDigits)) {
+        width += run.cell === undefined ? measureRun(run.text) : run.glyph.orient === 'tcy' ? fontEm(font) : cellAdvance(run.text, font, true);
+    }
+    return width;
+}
+/** How many times tracking follows the characters of `text` in a vertical
+ *  line: once per grapheme, a number set in one cell (tate-chu-yoko)
+ *  counting as one. */
+export function verticalTrackCount(text) {
+    let n = 0;
+    for (const run of verticalRuns(graphemesOf(text), measureRegion, measureUprightDigits)) {
+        n += run.glyph.orient === 'tcy' ? 1 : graphemesOf(run.text).length;
+    }
+    return n;
+}
+/**
+ * The advance of text painted in the page's flow (design text, list
+ * markers, contents rows, box titles): `measureTextWidth`, except in
+ * vertical text, where what stands in a cell advances its cell
+ * ({@link verticalTextWidth}), as the renderers paint it. ASCII text reads
+ * the same either way.
+ */
+export function flowTextWidth(text, font) {
+    if (measureWritingMode === 'vertical-rl' && (/[^\u0000-\u007F]/.test(text) || (measureUprightDigits > 0 && /[0-9]/.test(text))))
+        return verticalTextWidth(text, font);
+    return measureTextWidth(text, font);
+}
+/** A font string's first family, unquoted: the key of
+ *  `VDTFlowFrame.centralBaselines`. */
+export function fontFamilyOf(font) {
+    const m = FONT_SIZE_RE.exec(font);
+    const rest = (m ? font.slice(m.index + m[0].length) : font).replace(/^\s*(\/\s*\S+\s*)?/, '');
+    const first = rest.split(',')[0].trim();
+    return first.length >= 2 && /^["']/.test(first) && first.endsWith(first[0]) ? first.slice(1, -1) : first;
+}
+const centralCache = new Map();
+/** Drop the measured axes (fonts changed). */
+export function clearCentralBaselineCache() {
+    centralCache.clear();
+}
+/**
+ * Where the ideographic em box's centre sits above the alphabetic baseline
+ * of `family`, in ems: the axis upright characters are centred on. Read
+ * from the ink of 中 at 100 px, whose long stroke runs the height of the
+ * em box: the centre of its ink is the centre of the box within a few
+ * hundredths of an em (0.380 in Noto Serif and Sans SC and TC, whose box
+ * centre is 0.38; 0.357 in LXGW WenKai) — and every Chinese, Japanese and
+ * Korean face has the character, where a face for one script lacks the
+ * other's (國 is not in a Simplified Chinese font: the canvas measured a
+ * fallback face's, 0.04 em off). Kept between 0.25 and 0.5 em; a measurer
+ * with no ink metrics gives {@link DEFAULT_CENTRAL_BASELINE}.
+ */
+export function measureCentralBaseline(family) {
+    const hit = centralCache.get(family);
+    if (hit !== undefined)
+        return hit;
+    let value = DEFAULT_CENTRAL_BASELINE;
+    const box = measureInkBox('中', `100px ${/^[\w -]+$/.test(family) && !/^\d/.test(family) ? family : JSON.stringify(family)}`);
+    if (box && box.ascent + box.descent > 60) {
+        const centre = (box.ascent - box.descent) / 2 / 100;
+        if (centre >= 0.25 && centre <= 0.5)
+            value = Math.round(centre * 1000) / 1000;
+    }
+    centralCache.set(family, value);
+    return value;
+}
+onTextWidthCacheClear(clearCentralBaselineCache);
+/**
+ * How far below the top of its line box a line of `font` has its baseline,
+ * for a line box `lineHeightPx` tall. Horizontal text: 0.8 of the line
+ * height, as it always was. Vertical text: the line box runs down the
+ * column and its height is the pitch across it, and the characters stand
+ * centred on the font's central axis ({@link measureCentralBaseline}), so
+ * the baseline goes where that axis falls in the middle of the box: a
+ * column of characters in the middle of its pitch, as CSS sets a vertical
+ * line and as a rule drawn between two columns expects. `font`'s family
+ * and size decide the axis; the renderers turn each character about the
+ * same one (`VDTFlowFrame.centralBaselines`).
+ */
+export function lineBaselineOffset(lineHeightPx, font) {
+    if (measureWritingMode !== 'vertical-rl')
+        return lineHeightPx * 0.8;
+    return lineHeightPx / 2 + measureCentralBaseline(fontFamilyOf(font)) * fontEm(font);
+}
+//# sourceMappingURL=vertical.js.map

package/dist/measure/vertical.js.map

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

package/dist/numberWords.d.ts

@@ -1,17 +1,10 @@
-/**
- * Numbers spelled out in words — "twenty-one", "twenty-first", "veintiuno",
- * "vigesimoprimero" — for heading numbering templates (`{1:words}`,
- * `{1:ordinal}`) and the `{numberWords}` / `{numberOrdinalWords}` design
- * placeholders. English and Spanish; any other language takes the English
- * words, like the other localised strings (table continuation labels).
- * Masculine forms, as a chapter or a part is numbered ("capítulo primero").
- */
 /** Cardinal ("twenty-one") or ordinal ("twenty-first"). */
 export type NumberWordsKind = 'cardinal' | 'ordinal';
 /**
  * `n` spelled out in lower case, in the document language (`locale`:
- * `'es'` or a Spanish tag gives Spanish, anything else English). Numbers
- * past 999 999 (Spanish ordinals: past 999) print in digits; zero and
+ * `'es'` or a Spanish tag gives Spanish, a Chinese tag Chinese numerals in
+ * its script, anything else English). Numbers past 999 999 (Spanish
+ * ordinals: past 999; Chinese: past 10¹⁶ − 1) print in digits; zero and
  * below print nothing, like the other numeral formats.
  */
 export declare function numberToWords(n: number, kind?: NumberWordsKind, locale?: string): string;

package/dist/numberWords.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numberWords.d.ts","sourceRoot":"","sources":["../src/numberWords.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;AA6HrD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,eAA4B,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CASpG;AAED;oBACoB;AACpB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtF"}
+{"version":3,"file":"numberWords.d.ts","sourceRoot":"","sources":["../src/numberWords.ts"],"names":[],"mappings":"AAaA,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;AA8HrD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,eAA4B,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAcpG;AAED;oBACoB;AACpB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtF"}

package/dist/numberWords.js

@@ -1,16 +1,21 @@
 /**
  * Numbers spelled out in words — "twenty-one", "twenty-first", "veintiuno",
- * "vigesimoprimero" — for heading numbering templates (`{1:words}`,
- * `{1:ordinal}`) and the `{numberWords}` / `{numberOrdinalWords}` design
- * placeholders. English and Spanish; any other language takes the English
- * words, like the other localised strings (table continuation labels).
- * Masculine forms, as a chapter or a part is numbered ("capítulo primero").
+ * "vigesimoprimero", 二十一, 第二十一 — for heading numbering templates
+ * (`{1:words}`, `{1:ordinal}`) and the `{numberWords}` /
+ * `{numberOrdinalWords}` design placeholders. English, Spanish and Chinese
+ * (in the document's script: 一万 / 一萬); any other language takes the
+ * English words, like the other localised strings (table continuation
+ * labels). Masculine forms, as a chapter or a part is numbered ("capítulo
+ * primero").
  */
+import { stringsKeyOf } from './locale';
+import { chineseNumeral } from './chineseNumerals';
 /** Largest number spelled out; anything past it prints in digits. */
 const MAX_CARDINAL = 999_999;
 const MAX_ORDINAL_ES = 999;
 function language(locale) {
-    return (locale ?? 'en').toLowerCase().split(/[-_]/)[0] === 'es' ? 'es' : 'en';
+    const key = stringsKeyOf(locale ?? 'en');
+    return key === 'es' || key === 'zh-hans' || key === 'zh-hant' ? key : 'en';
 }
 // --- English ---------------------------------------------------------------
 const EN_ONES = [
@@ -127,14 +132,20 @@ function esOrdinal(n) {
 }
 /**
  * `n` spelled out in lower case, in the document language (`locale`:
- * `'es'` or a Spanish tag gives Spanish, anything else English). Numbers
- * past 999 999 (Spanish ordinals: past 999) print in digits; zero and
+ * `'es'` or a Spanish tag gives Spanish, a Chinese tag Chinese numerals in
+ * its script, anything else English). Numbers past 999 999 (Spanish
+ * ordinals: past 999; Chinese: past 10¹⁶ − 1) print in digits; zero and
  * below print nothing, like the other numeral formats.
  */
 export function numberToWords(n, kind = 'cardinal', locale) {
     if (!Number.isInteger(n) || n < 1)
         return n > 0 ? String(n) : '';
     const lang = language(locale);
+    if (lang === 'zh-hans' || lang === 'zh-hant') {
+        // Informal numerals; the ordinal is 第 before them (第十二).
+        const numeral = chineseNumeral(n, 'informal', lang === 'zh-hant');
+        return kind === 'ordinal' ? `第${numeral}` : numeral;
+    }
     if (kind === 'ordinal') {
         if (lang === 'es')
             return n <= MAX_ORDINAL_ES ? esOrdinal(n) : String(n);
@@ -145,7 +156,8 @@ export function numberToWords(n, kind = 'cardinal', locale) {
     return lang === 'es' ? esCardinal(n) : enCardinal(n);
 }
 export function caseWords(words, wordsCase, locale) {
-    const tag = language(locale);
+    // Han characters have no case: the variants print alike.
+    const tag = language(locale) === 'es' ? 'es' : 'en';
     if (wordsCase === 'upper')
         return words.toLocaleUpperCase(tag);
     if (wordsCase === 'capital')

package/dist/numberWords.js.map

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

package/dist/numbering.d.ts

@@ -1,6 +1,14 @@
 import type { ContentBlock } from './parse';
 import type { OrderedListNumberFormat } from './types';
-export type NumeralStyle = 'decimal' | 'decimal-02' | 'upper-alpha' | 'lower-alpha' | 'upper-roman' | 'lower-roman';
+/** The East Asian numeral styles, named as in CSS Counter Styles 3: Chinese
+ *  numerals in the informal (一百二十) and formal (壹佰贰拾) longhand of
+ *  either script, digit by digit (`cjk-decimal`, 二〇二六), the heavenly
+ *  stems (甲乙丙) and earthly branches (子丑寅), circled (①) and fullwidth
+ *  (１２３) digits. Every numbering setting takes them. */
+export type EastAsianNumeralStyle = 'simp-chinese-informal' | 'trad-chinese-informal' | 'simp-chinese-formal' | 'trad-chinese-formal' | 'cjk-decimal' | 'cjk-heavenly-stem' | 'cjk-earthly-branch' | 'circled-decimal' | 'fullwidth-decimal';
+/** Every {@link EastAsianNumeralStyle}, in the order a picker lists them. */
+export declare const EAST_ASIAN_NUMERAL_STYLES: readonly EastAsianNumeralStyle[];
+export type NumeralStyle = 'decimal' | 'decimal-02' | 'upper-alpha' | 'lower-alpha' | 'upper-roman' | 'lower-roman' | EastAsianNumeralStyle;
 /** A counter spelled out in words (heading templates only): cardinal
  *  (`words`) or ordinal (`ordinal`), the case of the suffix picking the
  *  case of the words — `{1:words}` "twenty-one", `{1:Words}` "Twenty-one",
@@ -19,20 +27,30 @@ type Token = {
 /** The numeral styles a format field can name: every {@link NumeralStyle}
  *  but the template-only zero-padded `decimal-02`. */
 export type NumberFormatStyle = Exclude<NumeralStyle, 'decimal-02'>;
+/** The informal Chinese style of a document's script: `trad-chinese-informal`
+ *  for a Traditional tag, else `simp-chinese-informal`. What `{1:一}`, the
+ *  `{numberHan}` placeholder and spelled-out Chinese numbers use. */
+export declare function chineseInformalStyle(locale?: string): 'simp-chinese-informal' | 'trad-chinese-informal';
 /**
  * The numeral style a numbering-format value names, in any of the
  * spellings the engine accepts (see `NUMBER_FORMAT_NAMES`: `decimal` /
  * `arabic`, `lower-roman` / `roman-lower` / `i`, `upper-alpha` /
- * `alpha-upper` / `upper-latin` / `A`…; names are case-insensitive).
- * `undefined` for anything else — the caller numbers in decimal.
+ * `alpha-upper` / `upper-latin` / `A`, the CSS names of the East Asian
+ * styles and their one-character tokens `〇`, `①`, `甲`, `子`, `１`…; names
+ * are case-insensitive). `一` and `壹` name the informal and formal Chinese
+ * numerals of the document's script: Traditional when `locale` is
+ * (`zh-Hant`, `zh-TW`…), else Simplified. `undefined` for anything else —
+ * the caller numbers in decimal.
  */
-export declare function parseNumberFormat(value: unknown): NumberFormatStyle | undefined;
+export declare function parseNumberFormat(value: unknown, locale?: string): NumberFormatStyle | undefined;
 /** A numeral style in the ordered-list vocabulary (`arabic` for decimal). */
 export declare function toOrderedListNumberFormat(style: NumberFormatStyle): OrderedListNumberFormat;
 /** A counter value in a template style; spelled-out styles use the
  *  document language `locale`. */
 export declare function formatCounter(n: number, style: CounterStyle, locale?: string): string;
-export declare function parseTemplate(tpl: string): Token[];
+/** The tokens of a numbering template. `locale` (the document language)
+ *  decides the script of the `{1:一}` and `{1:壹}` tokens. */
+export declare function parseTemplate(tpl: string, locale?: string): Token[];
 export declare function formatNumeral(n: number, style: NumeralStyle): string;
 /** A pre-resolved template piece fed to {@link renderCounterTemplate}. A
  *  `counter` piece whose `text` is empty is treated as a "missing" counter and

package/dist/numbering.d.ts.map

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

package/dist/numbering.js

@@ -1,4 +1,18 @@
 import { caseWords, numberToWords } from './numberWords';
+import { localeScript } from './locale';
+import { chineseNumeral, cjkDecimal, circledDecimal, fullwidthDecimal, fixedSymbol, CJK_HEAVENLY_STEMS, CJK_EARTHLY_BRANCHES } from './chineseNumerals';
+/** Every {@link EastAsianNumeralStyle}, in the order a picker lists them. */
+export const EAST_ASIAN_NUMERAL_STYLES = Object.freeze([
+    'simp-chinese-informal',
+    'trad-chinese-informal',
+    'simp-chinese-formal',
+    'trad-chinese-formal',
+    'cjk-decimal',
+    'cjk-heavenly-stem',
+    'cjk-earthly-branch',
+    'circled-decimal',
+    'fullwidth-decimal',
+]);
 const STYLE_ALIASES = {
     '1': 'decimal',
     decimal: 'decimal',
@@ -31,27 +45,56 @@ const NUMBER_FORMAT_NAMES = new Map([
     ['upper-alpha', 'upper-alpha'],
     ['alpha-upper', 'upper-alpha'],
     ['upper-latin', 'upper-alpha'],
+    ...EAST_ASIAN_NUMERAL_STYLES.map((name) => [name, name]),
+    // CSS keeps `cjk-ideographic` as another name of the traditional informal.
+    ['cjk-ideographic', 'trad-chinese-informal'],
 ]);
 /** The one-character tokens of the heading templates (`{1:i}`), which the
- *  format fields accept as well. Case-sensitive: `i` and `I` differ. */
+ *  format fields accept as well. Case-sensitive: `i` and `I` differ. The
+ *  Chinese tokens `一` and `壹` are read apart: they follow the document's
+ *  script (see {@link parseNumberFormat}). */
 const NUMBER_FORMAT_TOKENS = new Map([
     ['1', 'decimal'],
     ['i', 'lower-roman'],
     ['I', 'upper-roman'],
     ['a', 'lower-alpha'],
     ['A', 'upper-alpha'],
+    ['〇', 'cjk-decimal'],
+    ['①', 'circled-decimal'],
+    ['甲', 'cjk-heavenly-stem'],
+    ['子', 'cjk-earthly-branch'],
+    ['１', 'fullwidth-decimal'],
 ]);
+/** Whether `locale` is written in Traditional characters (`zh-Hant`,
+ *  `zh-TW`, `zh-HK`…). */
+function traditional(locale) {
+    return localeScript(locale) === 'Hant';
+}
+/** The informal Chinese style of a document's script: `trad-chinese-informal`
+ *  for a Traditional tag, else `simp-chinese-informal`. What `{1:一}`, the
+ *  `{numberHan}` placeholder and spelled-out Chinese numbers use. */
+export function chineseInformalStyle(locale) {
+    return traditional(locale) ? 'trad-chinese-informal' : 'simp-chinese-informal';
+}
 /**
  * The numeral style a numbering-format value names, in any of the
  * spellings the engine accepts (see `NUMBER_FORMAT_NAMES`: `decimal` /
  * `arabic`, `lower-roman` / `roman-lower` / `i`, `upper-alpha` /
- * `alpha-upper` / `upper-latin` / `A`…; names are case-insensitive).
- * `undefined` for anything else — the caller numbers in decimal.
+ * `alpha-upper` / `upper-latin` / `A`, the CSS names of the East Asian
+ * styles and their one-character tokens `〇`, `①`, `甲`, `子`, `１`…; names
+ * are case-insensitive). `一` and `壹` name the informal and formal Chinese
+ * numerals of the document's script: Traditional when `locale` is
+ * (`zh-Hant`, `zh-TW`…), else Simplified. `undefined` for anything else —
+ * the caller numbers in decimal.
  */
-export function parseNumberFormat(value) {
+export function parseNumberFormat(value, locale) {
     if (typeof value !== 'string')
         return undefined;
     const v = value.trim();
+    if (v === '一')
+        return chineseInformalStyle(locale);
+    if (v === '壹')
+        return traditional(locale) ? 'trad-chinese-formal' : 'simp-chinese-formal';
     return NUMBER_FORMAT_TOKENS.get(v) ?? NUMBER_FORMAT_NAMES.get(v.toLowerCase());
 }
 /** A numeral style in the ordered-list vocabulary (`arabic` for decimal). */
@@ -59,19 +102,20 @@ export function toOrderedListNumberFormat(style) {
     return style === 'decimal' ? 'arabic' : style;
 }
 /** A template token's style: its own alias, else any format-field
- *  spelling (`{1:roman-lower}`), else decimal. */
-function templateStyle(raw) {
+ *  spelling (`{1:roman-lower}`, `{1:一}` in the script of `locale`), else
+ *  decimal. */
+function templateStyle(raw, locale) {
     const s = raw.trim();
-    return Object.prototype.hasOwnProperty.call(STYLE_ALIASES, s) ? STYLE_ALIASES[s] : parseNumberFormat(s) ?? 'decimal';
+    return Object.prototype.hasOwnProperty.call(STYLE_ALIASES, s) ? STYLE_ALIASES[s] : parseNumberFormat(s, locale) ?? 'decimal';
 }
 const SPELLED_STYLES = new Set(['words', 'Words', 'WORDS', 'ordinal', 'Ordinal', 'ORDINAL']);
-function counterStyleOf(raw) {
+function counterStyleOf(raw, locale) {
     if (!raw)
         return 'decimal';
     const key = raw.trim();
     if (SPELLED_STYLES.has(key))
         return key;
-    return templateStyle(key);
+    return templateStyle(key, locale);
 }
 /** A counter value in a template style; spelled-out styles use the
  *  document language `locale`. */
@@ -84,7 +128,9 @@ export function formatCounter(n, style, locale) {
     const wordsCase = style === style.toUpperCase() ? 'upper' : style[0] === style[0].toUpperCase() ? 'capital' : 'lower';
     return caseWords(numberToWords(n, kind, locale), wordsCase, locale);
 }
-export function parseTemplate(tpl) {
+/** The tokens of a numbering template. `locale` (the document language)
+ *  decides the script of the `{1:一}` and `{1:壹}` tokens. */
+export function parseTemplate(tpl, locale) {
     const tokens = [];
     let buf = '';
     let i = 0;
@@ -115,7 +161,7 @@ export function parseTemplate(tpl) {
             const [rawLevel, rawStyle] = body.split(':');
             const level = Number(rawLevel);
             if (Number.isInteger(level) && level >= 1 && level <= 6) {
-                const style = counterStyleOf(rawStyle);
+                const style = counterStyleOf(rawStyle, locale);
                 flush();
                 tokens.push({ kind: 'counter', level, style });
                 i = end + 1;
@@ -162,7 +208,26 @@ function toRoman(n) {
     return s;
 }
 export function formatNumeral(n, style) {
-    if (n <= 0)
+    if (n === 0) {
+        // The positional East Asian styles have a zero; the others print
+        // nothing for it, as before.
+        switch (style) {
+            case 'simp-chinese-informal':
+            case 'trad-chinese-informal':
+            case 'simp-chinese-formal':
+            case 'trad-chinese-formal':
+                return '零';
+            case 'cjk-decimal':
+                return '〇';
+            case 'circled-decimal':
+                return '⓪';
+            case 'fullwidth-decimal':
+                return '０';
+            default:
+                return '';
+        }
+    }
+    if (n < 0)
         return '';
     switch (style) {
         case 'decimal':
@@ -177,6 +242,24 @@ export function formatNumeral(n, style) {
             return toRoman(n);
         case 'lower-roman':
             return toRoman(n).toLowerCase();
+        case 'simp-chinese-informal':
+            return chineseNumeral(n, 'informal', false);
+        case 'trad-chinese-informal':
+            return chineseNumeral(n, 'informal', true);
+        case 'simp-chinese-formal':
+            return chineseNumeral(n, 'formal', false);
+        case 'trad-chinese-formal':
+            return chineseNumeral(n, 'formal', true);
+        case 'cjk-decimal':
+            return cjkDecimal(n);
+        case 'cjk-heavenly-stem':
+            return fixedSymbol(n, CJK_HEAVENLY_STEMS);
+        case 'cjk-earthly-branch':
+            return fixedSymbol(n, CJK_EARTHLY_BRANCHES);
+        case 'circled-decimal':
+            return circledDecimal(n);
+        case 'fullwidth-decimal':
+            return fullwidthDecimal(n);
         default:
             // A style from outside the type (a hand-written config, a stale
             // continuation) numbers in decimal rather than printing "undefined".
@@ -202,7 +285,9 @@ export function renderCounterTemplate(pieces) {
                 continue;
             }
             if (prev.length > 0 && work[i - 1]?.kind === 'literal') {
-                out = out.replace(/[^A-Za-z0-9]+$/, '');
+                // Punctuation and spaces go; letters and numerals of any script
+                // stay (第 before a missing counter is text, not a separator).
+                out = out.replace(/[^\p{L}\p{N}]+$/u, '');
             }
             continue;
         }
@@ -322,7 +407,7 @@ isNumbered = () => true, options = {}) {
     const tokensOf = (tpl) => {
         let tokens = parsed.get(tpl);
         if (tokens === undefined) {
-            tokens = tpl.length > 0 ? parseTemplate(tpl) : null;
+            tokens = tpl.length > 0 ? parseTemplate(tpl, options.locale) : null;
             parsed.set(tpl, tokens);
         }
         return tokens;