postext 1.8.6 → 1.9.0

package/dist/measure/cjkAnnotate.js

@@ -0,0 +1,237 @@
+/**
+ * Geometry of ruby readings (#194) and warichu notes (#195) inside a line,
+ * for the CJK composer.
+ *
+ * Everything is in the flow frame: `dx` along the line from where the
+ * annotated segment starts, `dy` across it from the line's baseline to the
+ * annotation's baseline, positive towards the line's foot (down in
+ * horizontal text, left in vertical text). A character's em box is centred
+ * on the font's central axis, {@link CENTRAL} em above the baseline, the
+ * axis vertical text is set on (`VDTFlowFrame.centralBaselines`) and the
+ * middle of a CJK face's ideographic em box in horizontal text.
+ *
+ * - Ruby over or under the base sits in the line gap, against the base's em
+ *   box, centred on the base; a reading wider than its base widens the base's
+ *   box (the base is centred in it) less what it may pass the base by: a
+ *   quarter of the ruby em onto a neighbour without ruby, none past a line
+ *   edge (the composer shifts it back), and it keeps a quarter of the ruby
+ *   em from a neighbour's reading (two zhuyin readings: a quarter of the
+ *   symbols' em).
+ * - Zhuyin right of the base (horizontal text) stacks its symbols in a
+ *   column beside each character, at 60 % of the ruby size (0.3 em by
+ *   default, clreq §5.5.3.2), the tone mark right of the column with half
+ *   of its ink above the top of the last symbol (§5.5.3.3), the
+ *   neutral-tone dot above the first in a tenth of an em; the character's
+ *   box grows by the column. Zhuyin over the base of vertical text is the
+ *   same column down the line, its tone mark and dot standing upright.
+ *   Tone marks and the dot are placed by their ink (the measurer's ink
+ *   box): fonts set these modifier letters high in their em box.
+ * - A warichu note's part on a line folds into two rows of the note size,
+ *   centred on the line's axis with no gap between them: the upper row
+ *   takes characters until it is at least half the part (the second row is
+ *   never the longer), and one more while the lower row would open with a
+ *   mark that may not start a line or the upper row would end with one
+ *   that may not end a line (an opening bracket).
+ */
+import { DEFAULT_CENTRAL_BASELINE } from '../vdt';
+import { measureInkBox, measureTextWidth, onTextWidthCacheClear } from './canvas';
+import { flowTextWidth, fontEm, measuringVertically } from './vertical';
+import { graphemesOf } from './graphemes';
+import { latinReadingLift } from './rubyLift';
+/** The central axis of a face, in em above its baseline. */
+export const CENTRAL = DEFAULT_CENTRAL_BASELINE;
+/** Zhuyin is set at this fraction of the ruby size (0.3 em of the text for
+ *  the default half-em ruby). */
+export const ZHUYIN_SIZE_RATIO = 0.6;
+const BOPOMOFO_RE = /[㄀-ㄯㆠ-ㆿ]/;
+/** The zhuyin tone marks: ˊ ˇ ˋ (second to fourth tone), ˉ (first, rarely
+ *  written) and the neutral-tone dot ˙. */
+const TONE_MARKS = new Set(['ˊ', 'ˇ', 'ˋ', 'ˉ']);
+const NEUTRAL_TONE = '˙';
+/** Whether a reading is zhuyin (bopomofo). */
+export function isZhuyin(reading) {
+    return BOPOMOFO_RE.test(reading);
+}
+/** `font` at `sizePx`, style, weight and family kept. */
+export function withFontSize(font, sizePx) {
+    const m = /^(.*?)(\d*\.?\d+)px(\s*\/\s*[^\s]+)?\s+(.+)$/.exec(font);
+    if (!m)
+        return font;
+    return `${m[1]}${sizePx}px ${m[4]}`;
+}
+/** The baseline, px from the line's baseline, of text of em `rowEm` whose
+ *  em box is centred `axis` px from the line's baseline. */
+function baselineOf(axis, rowEm) {
+    return axis + CENTRAL * rowEm;
+}
+/** Gap between a base and its zhuyin column, in em of the text. */
+const ZHUYIN_GAP_EM = 0.04;
+/** The space the neutral-tone dot takes along the column, in em of the
+ *  text (clreq §5.5.3.3: a tenth of the base). */
+const NEUTRAL_SPACE_EM = 0.1;
+/** Where the ink of a tone mark or of the neutral-tone dot is centred, in
+ *  em above its baseline, when the measurer gives no ink box. */
+const TONE_INK_MID_EM = 0.65;
+const inkMids = new Map();
+onTextWidthCacheClear(() => inkMids.clear());
+/** How far above its baseline the ink of `g` is centred in `font`, px. */
+function inkMid(g, font) {
+    const key = `${font}\n${g}`;
+    let mid = inkMids.get(key);
+    if (mid === undefined) {
+        const box = measureInkBox(g, font);
+        mid = box && box.ascent + box.descent > 0 ? (box.ascent - box.descent) / 2 : TONE_INK_MID_EM * fontEm(font);
+        inkMids.set(key, mid);
+    }
+    return mid;
+}
+/** The start (`dx`) of an upright cell of em `cellEm` on a vertical line
+ *  whose glyph's ink is centred `mid` px above its baseline, for the ink
+ *  to be centred `along` px down the line (see `VDTAnnotationRun.upright`:
+ *  the cell's glyph stands on the font's central axis). */
+function uprightCellAt(along, cellEm, mid) {
+    return along - cellEm / 2 - CENTRAL * cellEm + mid;
+}
+/**
+ * The geometry of a ruby base (see the module comment). Measured in the
+ * writing mode the composer runs in: a vertical reading advances cell by
+ * cell down the line.
+ */
+export function rubyGeometry(input) {
+    const { reading, fontString, position, baseWidth, em, allowLeft, allowRight } = input;
+    const allow = { allowLeft, allowRight };
+    const rtEm = fontEm(fontString);
+    const zhuyin = isZhuyin(reading);
+    const axis = -CENTRAL * em;
+    if (zhuyin) {
+        const zEm = rtEm * ZHUYIN_SIZE_RATIO;
+        const zFont = withFontSize(fontString, zEm);
+        const graphemes = graphemesOf(reading);
+        const symbols = graphemes.filter((g) => !TONE_MARKS.has(g) && g !== NEUTRAL_TONE);
+        const tone = graphemes.find((g) => TONE_MARKS.has(g));
+        const neutral = graphemes.includes(NEUTRAL_TONE);
+        const dot = neutral ? NEUTRAL_SPACE_EM * em : 0;
+        const runs = [];
+        if (position === 'right') {
+            // A column right of the character, symbols stacked down it, the
+            // column (the dot's space above it included) centred on the
+            // character's axis.
+            const x0 = baseWidth + ZHUYIN_GAP_EM * em;
+            const n = Math.max(1, symbols.length);
+            const start = axis - (n * zEm + dot) / 2;
+            const top = start + dot;
+            symbols.forEach((g, i) => {
+                const w = measureTextWidth(g, zFont);
+                runs.push({ text: g, dx: x0 + (zEm - w) / 2, dy: baselineOf(top + (i + 0.5) * zEm, zEm), fontString: zFont });
+            });
+            let width = x0 + zEm;
+            if (tone) {
+                // Right of the column, half of its ink above the last symbol's top.
+                const tw = measureTextWidth(tone, zFont);
+                runs.push({ text: tone, dx: x0 + zEm, dy: top + (n - 1) * zEm + inkMid(tone, zFont), fontString: zFont });
+                width += tw;
+            }
+            if (neutral) {
+                const nw = measureTextWidth(NEUTRAL_TONE, zFont);
+                runs.push({ text: NEUTRAL_TONE, dx: x0 + (zEm - nw) / 2, dy: start + dot / 2 + inkMid(NEUTRAL_TONE, zFont), fontString: zFont });
+            }
+            return { width, inset: 0, rtWidth: width - baseWidth, runs, ...allow };
+        }
+        // Over or under the base. In vertical text (over is the right of the
+        // column) the symbols make a column down the line beside the base, the
+        // tone mark upright beside the column, half of its ink above the last
+        // symbol's top, and the dot upright before the first symbol; in
+        // horizontal text a row, the tone mark over (under) the right end of
+        // the last symbol, half of it past the symbol.
+        const vertical = measuringVertically();
+        const text = symbols.join('');
+        const rtWidth = flowTextWidth(text, zFont);
+        const need = rtWidth - 2 * Math.min(allowLeft, allowRight);
+        const width = Math.max(baseWidth, need);
+        const inset = (width - baseWidth) / 2;
+        const dx = (width - rtWidth) / 2;
+        const side = position === 'under' ? 1 : -1;
+        const rtAxis = axis + side * (em / 2 + zEm / 2);
+        runs.push({ text, dx, dy: baselineOf(rtAxis, zEm), fontString: zFont });
+        if (tone) {
+            const tw = measureTextWidth(tone, zFont);
+            const mid = inkMid(tone, zFont);
+            if (vertical) {
+                const lastTop = dx + (symbols.length > 0 ? rtWidth - flowTextWidth(symbols[symbols.length - 1], zFont) : 0);
+                runs.push({ text: tone, dx: uprightCellAt(lastTop, zEm, mid), dy: baselineOf(rtAxis + side * (zEm / 2 + tw / 2), zEm), fontString: zFont, upright: true });
+            }
+            else {
+                runs.push({ text: tone, dx: dx + rtWidth - tw / 2, dy: rtAxis + (side * zEm) / 2 + mid, fontString: zFont });
+            }
+        }
+        if (neutral) {
+            const mid = inkMid(NEUTRAL_TONE, zFont);
+            if (vertical) {
+                runs.push({ text: NEUTRAL_TONE, dx: uprightCellAt(dx - dot / 2, zEm, mid), dy: baselineOf(rtAxis, zEm), fontString: zFont, upright: true });
+            }
+            else {
+                const nw = measureTextWidth(NEUTRAL_TONE, zFont);
+                runs.push({ text: NEUTRAL_TONE, dx: dx - dot / 2 - nw / 2, dy: rtAxis + mid, fontString: zFont });
+            }
+        }
+        return { width, inset, rtWidth, runs, ...allow };
+    }
+    const rtWidth = flowTextWidth(reading, fontString);
+    const need = rtWidth - 2 * Math.min(allowLeft, allowRight);
+    const width = Math.max(baseWidth, need);
+    const inset = (width - baseWidth) / 2;
+    // `right` outside zhuyin (pinyin asked right of horizontal text): over.
+    const side = position === 'under' ? 1 : -1;
+    const rtAxis = axis + side * (em / 2 + rtEm / 2);
+    // A Latin reading over the base: its descenders clear the base (rubyLift.ts).
+    const lift = side < 0 ? latinReadingLift(reading, fontString, em) : 0;
+    return { width, inset, rtWidth, runs: [{ text: reading, dx: (width - rtWidth) / 2, dy: baselineOf(rtAxis, rtEm) - lift, fontString }], ...allow };
+}
+/** The advance of a reading along the line (a zhuyin reading: its
+ *  symbols' column, tone marks aside), before its base is sized. */
+export function readingAdvance(reading, fontString, position) {
+    if (!isZhuyin(reading))
+        return flowTextWidth(reading, fontString);
+    const zEm = fontEm(fontString) * ZHUYIN_SIZE_RATIO;
+    if (position === 'right')
+        return zEm;
+    const symbols = graphemesOf(reading).filter((g) => !TONE_MARKS.has(g) && g !== NEUTRAL_TONE).join('');
+    return flowTextWidth(symbols, withFontSize(fontString, zEm));
+}
+/** Where the upper row of a warichu part ends (units `[0, at)`): see the
+ *  module comment. `startProhibited[i]`: unit `i` may not open a row;
+ *  `endProhibited[i]`: unit `i` may not close one (an opening bracket), so
+ *  the upper row takes the unit after it too. */
+export function splitNote(widths, startProhibited, endProhibited) {
+    const n = widths.length;
+    let total = 0;
+    for (const w of widths)
+        total += w;
+    let prefix = 0;
+    let at = 0;
+    while (at < n && prefix < total / 2 - 1e-9)
+        prefix += widths[at++];
+    while (at < n && (startProhibited[at] || (at > 0 && endProhibited?.[at - 1])))
+        prefix += widths[at++];
+    return at;
+}
+/** The advance of a warichu part folded at `at`: the wider row. */
+export function foldWidth(widths, at) {
+    let upper = 0;
+    let lower = 0;
+    widths.forEach((w, i) => {
+        if (i < at)
+            upper += w;
+        else
+            lower += w;
+    });
+    return Math.max(upper, lower);
+}
+/** The baselines of a warichu part's rows (px from the line's baseline):
+ *  the upper row's em box ends at the line's axis, the lower one's starts
+ *  there. */
+export function noteRowBaselines(em, noteEm) {
+    const axis = -CENTRAL * em;
+    return { upper: baselineOf(axis - noteEm / 2, noteEm), lower: baselineOf(axis + noteEm / 2, noteEm) };
+}
+//# sourceMappingURL=cjkAnnotate.js.map

package/dist/measure/cjkAnnotate.js.map

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

package/dist/measure/cjkClasses.d.ts

@@ -0,0 +1,133 @@
+import type { CjkLineBreak } from '../types';
+/**
+ * Character classes of Chinese (and Japanese) text layout, after the W3C
+ * "Requirements for Chinese Text Layout" (clreq §3.1 and §6.1) and GB/T
+ * 15834—2011: what a line may not start or end with at each strictness
+ * level, which marks never part (—— ……), and which characters take no
+ * inter-character space when a justified line is spread.
+ *
+ * A class is read from the first code point of a grapheme. The marks Latin
+ * text shares with Chinese (— … · “ ” ‘ ’) are classed as Chinese marks
+ * here: the table is only consulted for paragraphs set by the CJK composer
+ * (`cjkCompose.ts`) and for the joints of words that hold CJK, where they
+ * are Chinese punctuation. The apostrophe of a Latin word ("don’t") and the
+ * interpunct inside one ("l·l") are kept in their word by the unit builder.
+ */
+/** How strictly lines avoid starting or ending with punctuation (clreq
+ *  §6.1.1). `none`: anywhere between characters (Taiwan and Hong Kong
+ *  newspapers). `basic`: no pause or stop mark, closing bracket or quote,
+ *  connector, interpunct or iteration mark opens a line, and no opening
+ *  bracket or quote closes one. `gb`: `basic` plus the solidus at either
+ *  end (GB/T 15834—2011 §5.1.9). `strict`: `gb` plus the two-em dash and
+ *  the ellipsis at the start of a line. */
+export type CjkLineBreakLevel = CjkLineBreak;
+export declare const CJK_LINE_BREAK_LEVELS: readonly CjkLineBreakLevel[];
+export type CjkClass = 
+/** Han, kana, hangul, bopomofo, fullwidth letters and digits, 〇, emoji
+ *  and the CJK symbols: a line may break before and after each (the
+ *  composer keeps a run of fullwidth digits or letters together, see
+ *  {@link isFullwidthAlnum}). */
+'ideograph'
+/** Opening brackets and quotes: （〔［｛【〖《〈「『“‘ and ASCII ( [ {. */
+ | 'opening'
+/** Closing brackets and quotes: ）〕］｝】〗》〉」』”’ and ASCII ) ] }. */
+ | 'closing'
+/** Pause marks: 、，；： and ASCII , ; : */
+ | 'pause'
+/** Stop marks: 。．！？‼⁇⁈⁉ and ASCII . ! ? */
+ | 'stop'
+/** Interpuncts: · ‧ ・ ･ */
+ | 'interpunct'
+/** Iteration marks and the prolonged sound mark: 々〻ゝゞヽヾー */
+ | 'iteration'
+/** Dashes: — ― ⸺ ⸻ (two U+2014 in a row are one unit, 破折号). */
+ | 'dash'
+/** Ellipses: … ‥ ⋯ (two in a row are one unit, 省略号). */
+ | 'ellipsis'
+/** Connectors: – ～ 〜 ~ 〰 ゠ */
+ | 'connector'
+/** Solidus: / ／ */
+ | 'solidus'
+/** The ideographic space U+3000: a fixed character one em wide; a line
+ *  may break after it, never before. */
+ | 'ideoSpace'
+/** Signs a number takes before it: ¥ $ € £ ₩ ￥ ＄ ￡ ± − ＋ (the ASCII
+ *  plus is Western text: `C++` may end a line). */
+ | 'prefix'
+/** Signs a number takes after it: % ‰ ‱ ° ℃ ℉ ′ ″ ％ and the unit
+ *  squares ㎡ ㎏ ㎞ ㏄ (U+3371–337A, U+3380–33DF, U+33FF), which are set
+ *  in the Western run of their number. */
+ | 'postfix'
+/** Latin, Greek, Cyrillic letters, digits and everything else: set in
+ *  runs a line never breaks inside. */
+ | 'western'
+/** U+200B, the zero-width space: a break opportunity, not printed. */
+ | 'zwsp';
+/** Set the level {@link getCjkLineBreak} returns (the build does, from the
+ *  resolved `cjk.lineBreak`). */
+export declare function setCjkLineBreak(level: CjkLineBreakLevel): void;
+/** The document's line-break level for CJK text (see
+ *  {@link setCjkLineBreak}); `gb` until a build sets another. */
+export declare function getCjkLineBreak(): CjkLineBreakLevel;
+/** Whether a line may break between two graphemes that touch: `a` (class
+ *  `aCls`, a CJK grapheme when `aCjk`) and `b` after it. Only next to a CJK
+ *  grapheme — two Western graphemes never part here — and never before the
+ *  ideographic space; at `level`, no prohibited mark opens or closes a
+ *  line. */
+export declare function cjkBreakAllowed(aCls: CjkClass, aCjk: boolean, bCls: CjkClass, bCjk: boolean, level: CjkLineBreakLevel): boolean;
+/** Whether a grapheme of `cls` may not open a line at `level`. */
+export declare function isLineStartProhibited(cls: CjkClass, level: CjkLineBreakLevel): boolean;
+/** Whether a grapheme of `cls` may not close a line at `level`. */
+export declare function isLineEndProhibited(cls: CjkClass, level: CjkLineBreakLevel): boolean;
+/** The squared Latin abbreviations of units in the CJK compatibility
+ *  block: ㍱ hPa to ㍺ IU, ㎀ pA to ㏟ A∕m, ㏿ gal. They follow a number as
+ *  % does, in any script, and are no CJK text. */
+export declare function isUnitSquare(cp: number): boolean;
+/** Fullwidth digits ０–９. */
+export declare function isFullwidthDigit(cp: number): boolean;
+/** Fullwidth digits and Latin letters (０–９, Ａ–Ｚ, ａ–ｚ): set one em
+ *  wide like ideographs, but a number or a word a line never breaks
+ *  inside. */
+export declare function isFullwidthAlnum(cp: number): boolean;
+/** The class of a grapheme, read from its first code point. */
+export declare function cjkClassOf(grapheme: string): CjkClass;
+/** Whether a grapheme is set as a Chinese character in a CJK paragraph: it
+ *  opens a unit of its own instead of joining a Western run. The ASCII
+ *  marks (`,` `.` `(` `%`…) and the signs of numbers stay in the Western
+ *  run they touch; the marks Chinese shares with Latin text (— … · “ ” ‘ ’
+ *  – ~) are Chinese marks, except the apostrophe or the interpunct of a
+ *  Latin word, which the unit builder keeps in it. */
+export declare function isCjkGrapheme(grapheme: string): boolean;
+/** Whether a grapheme is a letter or digit of Western text (the neighbours
+ *  of an apostrophe or an interpunct kept inside a word). */
+export declare function isWesternWordChar(grapheme: string | undefined): boolean;
+/** Whether an apostrophe or an interpunct sits inside a Latin word
+ *  ("don’t", "l·l"): between two letters or digits of Western text. It
+ *  belongs to the word then — the composer keeps it in the word's run, and
+ *  vertical text sets it sideways with the word — not to the Chinese text
+ *  around it. */
+export declare function isWordInnerMark(grapheme: string, prev: string | undefined, next: string | undefined): boolean;
+/** Whether a code point is a mark a browser sets half width when it meets
+ *  another (CSS `text-spacing-trim`, OpenType `chws`/`halt`): an opening or
+ *  closing bracket or quote, a pause or stop mark, an interpunct, the
+ *  ideographic space. The marks of the CJK blocks always; the marks Latin
+ *  text shares with Chinese (“ ” ‘ ’ · ‧ « »…) only when `shared` is set
+ *  (the text is Chinese). ASCII never. */
+export declare function isTrimmableMark(cp: number, shared: boolean): boolean;
+/**
+ * Where to cut `text` so that no piece holds two CJK marks side by side:
+ * the offsets (UTF-16) between each such pair. Chrome (CSS
+ * `text-spacing-trim: normal`, and fonts with `chws`) sets the first of
+ * `）》`, `”“`, `》。` or `。《` half width when a run is measured or painted
+ * whole — `本）》录` in Noto Serif SC is 3.5 em as one run and 4 em
+ * character by character — while the CJK composer measures every
+ * character alone and adjusts the marks itself (`cjk.punctuationWidth`).
+ * Measuring and painting such text piece by piece keeps the browser out of
+ * it. `shared` counts the marks Latin text shares with Chinese (“ ” ‘ ’ ·):
+ * set it for Chinese text only, so a Latin `’”` is never cut. Empty for
+ * text with no such pair.
+ */
+export declare function cjkMarkCuts(text: string, shared: boolean): number[];
+/** `text` cut at {@link cjkMarkCuts}: one piece when there is no cut. */
+export declare function cjkMarkPieces(text: string, shared: boolean): string[];
+//# sourceMappingURL=cjkClasses.d.ts.map

package/dist/measure/cjkClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjkClasses.d.ts","sourceRoot":"","sources":["../../src/measure/cjkClasses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AAEH;;;;;;2CAM2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE7C,eAAO,MAAM,qBAAqB,EAAE,SAAS,iBAAiB,EAAsC,CAAC;AAErG,MAAM,MAAM,QAAQ;AAClB;;;iCAGiC;AAC/B,WAAW;AACb,iEAAiE;GAC/D,SAAS;AACX,iEAAiE;GAC/D,SAAS;AACX,wCAAwC;GACtC,OAAO;AACT,2CAA2C;GACzC,MAAM;AACR,2BAA2B;GACzB,YAAY;AACd,4DAA4D;GAC1D,WAAW;AACb,+DAA+D;GAC7D,MAAM;AACR,wDAAwD;GACtD,UAAU;AACZ,8BAA8B;GAC5B,WAAW;AACb,mBAAmB;GACjB,SAAS;AACX;wCACwC;GACtC,WAAW;AACb;mDACmD;GACjD,QAAQ;AACV;;0CAE0C;GACxC,SAAS;AACX;uCACuC;GACrC,SAAS;AACX,sEAAsE;GACpE,MAAM,CAAC;AAQX;iCACiC;AACjC,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAE9D;AAED;iEACiE;AACjE,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED;;;;YAIY;AACZ,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAK/H;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CActF;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAWpF;AAeD;;kDAEkD;AAClD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,4BAA4B;AAC5B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;cAEc;AACd,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEpD;AA+BD,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAqBrD;AAED;;;;;sDAKsD;AACtD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAcvD;AAED;6DAC6D;AAC7D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKvE;AAED;;;;iBAIiB;AACjB,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE7G;AAED;;;;;0CAK0C;AAC1C,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CASpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAWnE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAWrE"}