reamkit 1.33.1 → 1.34.0

package/dist/esm/core/font/indic-table.d.ts

@@ -0,0 +1,12 @@
+/** Category and position of U+0900..U+0D7F, two base-32 digits each. */
+export declare const MAIN: string;
+/** …of U+1CD0..U+1CFF, the Vedic extensions. */
+export declare const VEDIC = "adadad0eadadadadadadadadadadadadadadadadadadadadadididididadidididid1414adj4j4adadadb40e0e0e0e0e";
+/** …of U+A8E0..U+A8FF, Devanagari extended. */
+export declare const EXTENDED = "adadadadadadadadadadadadadadadadadadidididididid0e0e0e0e0e0e2479";
+/** The code points outside those blocks that take part: [code point, category, position]. */
+export declare const SINGLES: ReadonlyArray<readonly [number, number, number]>;
+/** Canonical decompositions in the blocks: [composite, first, second, excluded from composition]. */
+export declare const DECOMPOSITIONS: ReadonlyArray<readonly [number, number, number, boolean]>;
+/** Canonical combining classes other than 0. */
+export declare const COMBINING: ReadonlyArray<readonly [number, number]>;

package/dist/esm/core/font/indic-table.js

@@ -0,0 +1,463 @@
+//#region src/core/font/indic-table.ts
+/** Category and position of U+0900..U+0D7F, two base-32 digits each. */
+var MAIN = "8d8d8d8d2424242424242424242424242424242424141414141414141414141414141414141414141414141414141414g4141414141414141414797938id7972797979797979797979797979794872790eadad8d8d7979791414141414141414242479790e0eb4b4b4b4b4b4b4b4b4b40e0e2424242424241414141414141414b48d8d8d0e24242424242424240e0e24240e0e242414141414141414141414141414141414141414140e141414141414g40e140e0e0e141414140e0e38id7c727c797979790e0e72720e0e7c7c48140e0e0e0e0e0e0e0e7c0e0e0e0e14140e14242479790e0eb4b4b4b4b4b4b4b4b4b4g4140e0e0e0e0e0e0e0e0e0eb40e8d0e0e8d8d8d0e2424242424240e0e0e0e24240e0e242414141414141414141414141414141414141414140e141414141414g40e14140e14140e14140e0e380e7c72ec7c7c0e0e0e0e7c7c0e0e7c7c480e0e0e780e0e0e0e0e0e0e141414140e140e0e0e0e0e0e0eb4b4b4b4b4b4b4b4b4b48d8d14140eh40e0e0e0e0e0e0e0e0e0e0e8d8d8d0e2424242424242424240e2424240e242414141414141414141414141414141414141414140e141414141414g40e14140e14141414140e0e38id7c727c7c7c7c7c790e79797c0e7c7c480e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e24247c7c0e0eb4b4b4b4b4b4b4b4b4b40e0e0e0e0e0e0e0e0e14ad36ad3636360e878d8d0e24242424242424240e0e24240e0e242414141414141414141414141414141414141414140e141414141414g40e14140e14141414140e0e38id7c757c797979790e0e72750e0e7c7c480e0e0e0e0e757536757c0e0e0e0e14140e14242479790e0eb4b4b4b4b4b4b4b4b4b40e140e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e8d0e0e2424242424240e0e0e2424240e242424140e0e0e14140e140e14140e0e0e14140e0e0e1414140e0e0e1414g41414141414141414140e0e0e0e7c7c797c7c0e0e0e7272720e7c7c7c460e0e0e0e0e0e0e0e0e7c0e0e0e0e0e0e0e0e0e0e0e0e0e0eb4b4b4b4b4b4b4b4b4b40e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0e8d8d8d8d8d24242424242424240e2424240e24242414141414141414141414141414141414141414140e141414141414g41414141414141414140e0e38id777777777779790e7777770e777777460e0e0e0e0e0e0e77770e1414140e0e140e0e242477770e0eb4b4b4b4b4b4b4b4b4b40e0e0e0e0e0e0e0e0e0e0e0e0e0e0e0eb48d8d8d0e24242424242424240e2424240e24242414141414141414141414141414141414141414140e141414141414g41414140e14141414140e0e38id777777777779790e7779790e797977460e0e0e0e0e0e0e79790e0e0e0e0e0e14140e242477770e0eb4b4b4b4b4b4b4b4b4b40ej4j48d0e0e0e0e0e0e0e0e0e0e0e0e8d8d8d8d8d24242424242424240e2424240e242424141414141414141414141414141414141414141414141414141414g4141414141414141414147979id7c7c7c7c7c7c7c0e7272720e7c7c7c46f60e0e0e0e0e1414147c0e0e0e0e0e0e0e2424247c7c0e0eb4b4b4b4b4b4b4b4b4b40e0e0e0e0e0e0e0e0e0e141414141414";
+/** …of U+1CD0..U+1CFF, the Vedic extensions. */
+var VEDIC = "adadad0eadadadadadadadadadadadadadadadadadadadadadididididadidididid1414adj4j4adadadb40e0e0e0e0e";
+/** …of U+A8E0..U+A8FF, Devanagari extended. */
+var EXTENDED = "adadadadadadadadadadadadadadadadadadidididididid0e0e0e0e0e0e2479";
+/** The code points outside those blocks that take part: [code point, category, position]. */
+var SINGLES = [
+	[
+		45,
+		11,
+		4
+	],
+	[
+		48,
+		11,
+		4
+	],
+	[
+		49,
+		11,
+		4
+	],
+	[
+		50,
+		11,
+		4
+	],
+	[
+		51,
+		11,
+		4
+	],
+	[
+		52,
+		11,
+		4
+	],
+	[
+		53,
+		11,
+		4
+	],
+	[
+		54,
+		11,
+		4
+	],
+	[
+		55,
+		11,
+		4
+	],
+	[
+		56,
+		11,
+		4
+	],
+	[
+		57,
+		11,
+		4
+	],
+	[
+		160,
+		11,
+		4
+	],
+	[
+		178,
+		8,
+		13
+	],
+	[
+		179,
+		8,
+		13
+	],
+	[
+		215,
+		11,
+		4
+	],
+	[
+		8204,
+		5,
+		14
+	],
+	[
+		8205,
+		6,
+		14
+	],
+	[
+		8208,
+		11,
+		4
+	],
+	[
+		8209,
+		11,
+		4
+	],
+	[
+		8210,
+		11,
+		4
+	],
+	[
+		8211,
+		11,
+		4
+	],
+	[
+		8212,
+		11,
+		4
+	],
+	[
+		8308,
+		8,
+		13
+	],
+	[
+		8322,
+		8,
+		13
+	],
+	[
+		8323,
+		8,
+		13
+	],
+	[
+		8324,
+		8,
+		13
+	],
+	[
+		9676,
+		12,
+		4
+	]
+];
+/** Canonical decompositions in the blocks: [composite, first, second, excluded from composition]. */
+var DECOMPOSITIONS = [
+	[
+		2345,
+		2344,
+		2364,
+		false
+	],
+	[
+		2353,
+		2352,
+		2364,
+		false
+	],
+	[
+		2356,
+		2355,
+		2364,
+		false
+	],
+	[
+		2392,
+		2325,
+		2364,
+		true
+	],
+	[
+		2393,
+		2326,
+		2364,
+		true
+	],
+	[
+		2394,
+		2327,
+		2364,
+		true
+	],
+	[
+		2395,
+		2332,
+		2364,
+		true
+	],
+	[
+		2396,
+		2337,
+		2364,
+		true
+	],
+	[
+		2397,
+		2338,
+		2364,
+		true
+	],
+	[
+		2398,
+		2347,
+		2364,
+		true
+	],
+	[
+		2399,
+		2351,
+		2364,
+		true
+	],
+	[
+		2507,
+		2503,
+		2494,
+		false
+	],
+	[
+		2508,
+		2503,
+		2519,
+		false
+	],
+	[
+		2524,
+		2465,
+		2492,
+		true
+	],
+	[
+		2525,
+		2466,
+		2492,
+		true
+	],
+	[
+		2527,
+		2479,
+		2492,
+		true
+	],
+	[
+		2611,
+		2610,
+		2620,
+		true
+	],
+	[
+		2614,
+		2616,
+		2620,
+		true
+	],
+	[
+		2649,
+		2582,
+		2620,
+		true
+	],
+	[
+		2650,
+		2583,
+		2620,
+		true
+	],
+	[
+		2651,
+		2588,
+		2620,
+		true
+	],
+	[
+		2654,
+		2603,
+		2620,
+		true
+	],
+	[
+		2888,
+		2887,
+		2902,
+		false
+	],
+	[
+		2891,
+		2887,
+		2878,
+		false
+	],
+	[
+		2892,
+		2887,
+		2903,
+		false
+	],
+	[
+		2908,
+		2849,
+		2876,
+		true
+	],
+	[
+		2909,
+		2850,
+		2876,
+		true
+	],
+	[
+		2964,
+		2962,
+		3031,
+		false
+	],
+	[
+		3018,
+		3014,
+		3006,
+		false
+	],
+	[
+		3019,
+		3015,
+		3006,
+		false
+	],
+	[
+		3020,
+		3014,
+		3031,
+		false
+	],
+	[
+		3144,
+		3142,
+		3158,
+		false
+	],
+	[
+		3264,
+		3263,
+		3285,
+		false
+	],
+	[
+		3271,
+		3270,
+		3285,
+		false
+	],
+	[
+		3272,
+		3270,
+		3286,
+		false
+	],
+	[
+		3274,
+		3270,
+		3266,
+		false
+	],
+	[
+		3275,
+		3274,
+		3285,
+		false
+	],
+	[
+		3402,
+		3398,
+		3390,
+		false
+	],
+	[
+		3403,
+		3399,
+		3390,
+		false
+	],
+	[
+		3404,
+		3398,
+		3415,
+		false
+	]
+];
+/** Canonical combining classes other than 0. */
+var COMBINING = [
+	[2364, 7],
+	[2381, 9],
+	[2385, 230],
+	[2386, 220],
+	[2387, 230],
+	[2388, 230],
+	[2492, 7],
+	[2509, 9],
+	[2558, 230],
+	[2620, 7],
+	[2637, 9],
+	[2748, 7],
+	[2765, 9],
+	[2876, 7],
+	[2893, 9],
+	[3021, 9],
+	[3132, 7],
+	[3149, 9],
+	[3157, 84],
+	[3158, 91],
+	[3260, 7],
+	[3277, 9],
+	[3387, 9],
+	[3388, 9],
+	[3405, 9],
+	[7376, 230],
+	[7377, 230],
+	[7378, 230],
+	[7380, 1],
+	[7381, 220],
+	[7382, 220],
+	[7383, 220],
+	[7384, 220],
+	[7385, 220],
+	[7386, 230],
+	[7387, 230],
+	[7388, 220],
+	[7389, 220],
+	[7390, 220],
+	[7391, 220],
+	[7392, 230],
+	[7394, 1],
+	[7395, 1],
+	[7396, 1],
+	[7397, 1],
+	[7398, 1],
+	[7399, 1],
+	[7400, 1],
+	[7405, 220],
+	[7412, 230],
+	[7416, 230],
+	[7417, 230],
+	[43232, 230],
+	[43233, 230],
+	[43234, 230],
+	[43235, 230],
+	[43236, 230],
+	[43237, 230],
+	[43238, 230],
+	[43239, 230],
+	[43240, 230],
+	[43241, 230],
+	[43242, 230],
+	[43243, 230],
+	[43244, 230],
+	[43245, 230],
+	[43246, 230],
+	[43247, 230],
+	[43248, 230],
+	[43249, 230]
+];
+//#endregion
+export { COMBINING, DECOMPOSITIONS, EXTENDED, MAIN, SINGLES, VEDIC };

package/dist/esm/core/font/measure.d.ts

@@ -25,20 +25,61 @@ export interface FontMeasure {
     /** Encode `text` as a hex string of 4-digit glyph ids (Identity-H addressing). */
     readonly encodeTextAsCidHex: (text: string) => string;
     /**
-     * The complete PDF text-showing operator for `text` — `<hex> Tj`, or a
-     * `[…] TJ` array when shaping moved a glyph off its own advance.
+     * The complete PDF text-showing operators for `text` — `<hex> Tj`, or a
+     * `[…] TJ` array when shaping moved a glyph off its own advance. Text the
+     * Indic shaper set (see {@link clustered}) may place a glyph off its pen
+     * position and off the baseline, and takes its letter spacing after each
+     * cluster rather than each glyph: give it the size it is set at and that
+     * spacing, and leave the text state's `Tc` at 0 for it.
+     *
+     * For such text, `before` puts an operator of the writer's own — a colour,
+     * say — before a glyph, keyed by the glyph's index in {@link glyphRun}'s
+     * order: the show is cut there, its pen moves and rise kept.
      */
-    readonly showText: (text: string) => string;
+    readonly showText: (text: string, fontSizePt?: number, clusterSpacingPt?: number, before?: ReadonlyMap<number, string>) => string;
     /**
      * The glyphs `text` is drawn with and the advance each one takes, in font
      * units — exactly what {@link showText} shows, kerning and ligatures
-     * included — for a writer that places each glyph itself.
+     * included — for a writer that places each glyph itself. For text the Indic
+     * shaper set, each glyph's offset off its pen position, and which glyphs end
+     * a cluster.
      */
     readonly glyphRun: (text: string) => {
         readonly gids: ReadonlyArray<number>;
         readonly advances: ReadonlyArray<number>;
+        readonly xOffsets?: ReadonlyArray<number>;
+        readonly yOffsets?: ReadonlyArray<number>;
+        readonly clusterEnds?: ReadonlyArray<boolean>;
     };
+    /**
+     * Whether `text` is set by the Indic shaper in this face: its glyphs are not
+     * in the order of its characters, and a cluster of them is one letter that
+     * spacing must not split.
+     */
+    readonly clustered: (text: string) => boolean;
+    /**
+     * For text the Indic shaper set, per glyph in {@link glyphRun}'s order, the
+     * index in code points of the first character it stands for: the one a
+     * writer takes a glyph's formatting from. Undefined for any other text.
+     */
+    readonly glyphSources: (text: string) => ReadonlyArray<number> | undefined;
+    /** How many places letter spacing goes in `text`: one per character, or per cluster. */
+    readonly spacingSlots: (text: string) => number;
 }
+/**
+ * The glyphs a face draws a string with, and for each glyph the Indic shaper
+ * made out of several characters (a conjunct, a reph, a vowel sign's
+ * contextual form), the text it stands for — which a PDF's /ToUnicode has to
+ * name, since no character maps to it.
+ *
+ * @param parsed The face.
+ * @param text   The text.
+ * @returns The glyph ids, and the text of each glyph no character reaches.
+ */
+export declare function shapeGlyphs(parsed: ParsedTtf, text: string): {
+    readonly gids: ReadonlyArray<number>;
+    readonly glyphText?: ReadonlyMap<number, string>;
+};
 /**
  * Build a {@link FontMeasure} over a parsed font.
  *