reamkit 1.29.0 → 1.31.0

package/dist/esm/pdf-reader/glyf-outline.d.ts

@@ -41,3 +41,36 @@ export declare function outlineSource(program: Uint8Array): OutlineSource | unde
  *          states no names of its own (formats 1.0 and 3.0).
  */
 export declare function postGlyphNames(program: Uint8Array): Map<string, number> | undefined;
+/**
+ * OS/2 `fsType` — the embedding a TrueType or OpenType program's licence allows
+ * (ISO/IEC 14496-22, OS/2 table).
+ *
+ * @param program The raw sfnt bytes.
+ * @returns The field, or `undefined` where the program carries no OS/2 table —
+ *          a subsetter may drop it, and then the program states nothing.
+ */
+export declare function sfntFsType(program: Uint8Array): number | undefined;
+/**
+ * How far the pen moves after an sfnt program's space, in thousandths of an em:
+ * the glyph its `cmap` (or its `post` names) gives U+0020, measured in `hmtx`.
+ * A subset keeps the metrics of glyphs it dropped the outlines of, and the
+ * width a page's words were set apart by is the one a writer should give the
+ * space the page never showed.
+ *
+ * @param program The raw sfnt bytes.
+ * @returns The advance, or `undefined` where the program says nothing of a space.
+ */
+export declare function sfntSpaceAdvance(program: Uint8Array): number | undefined;
+/**
+ * Every `cmap` subtable an sfnt program carries, keyed `platform,encoding` —
+ * `3,1` for Windows Unicode, `3,0` for Windows symbol, `1,0` for Mac Roman.
+ *
+ * A simple TrueType font reaches its glyphs through whichever of these it has,
+ * and which one decides what a code is looked up AS (§9.6.6.4): a character, a
+ * symbol code, a Mac Roman byte.
+ *
+ * @param program The raw sfnt bytes.
+ * @returns Subtable → code-to-glyph lookup (0 where it maps nothing). Formats
+ *          0, 4, 6 and 12 are read; any other is left out.
+ */
+export declare function cmapSubtables(program: Uint8Array): Map<string, (code: number) => number>;

package/dist/esm/pdf-reader/glyf-outline.js

@@ -29,8 +29,19 @@ function outlineSource(program) {
 		if (at + stride * 2 > loca.offset + loca.length) return void 0;
 		const read = (o) => longLoca ? safeUint32(view, o) : safeUint16(view, o) * 2;
 		const start = read(at);
-		const end = read(at + stride);
-		if (end <= start) return void 0;
+		let end = read(at + stride);
+		if (end === start) return void 0;
+		if (end < start) {
+			end = glyf.length;
+			for (let o = at + stride * 2; o + stride <= loca.offset + loca.length; o += stride) {
+				const next = read(o);
+				if (next > start) {
+					end = Math.min(next, glyf.length);
+					break;
+				}
+			}
+			if (end <= start) return void 0;
+		}
 		if (glyf.offset + end > program.length) return void 0;
 		return {
 			start: glyf.offset + start,
@@ -109,6 +120,140 @@ function postGlyphNames(program) {
 	}
 	return out.size > 0 ? out : void 0;
 }
+/**
+* OS/2 `fsType` — the embedding a TrueType or OpenType program's licence allows
+* (ISO/IEC 14496-22, OS/2 table).
+*
+* @param program The raw sfnt bytes.
+* @returns The field, or `undefined` where the program carries no OS/2 table —
+*          a subsetter may drop it, and then the program states nothing.
+*/
+function sfntFsType(program) {
+	let tables;
+	try {
+		tables = sfntTables(program);
+	} catch {
+		return;
+	}
+	const os2 = tables.get("OS/2");
+	if (!os2 || os2.length < 10 || os2.offset + 10 > program.length) return void 0;
+	return new DataView(program.buffer, program.byteOffset, program.byteLength).getUint16(os2.offset + 8);
+}
+/**
+* How far the pen moves after an sfnt program's space, in thousandths of an em:
+* the glyph its `cmap` (or its `post` names) gives U+0020, measured in `hmtx`.
+* A subset keeps the metrics of glyphs it dropped the outlines of, and the
+* width a page's words were set apart by is the one a writer should give the
+* space the page never showed.
+*
+* @param program The raw sfnt bytes.
+* @returns The advance, or `undefined` where the program says nothing of a space.
+*/
+function sfntSpaceAdvance(program) {
+	let tables;
+	try {
+		tables = sfntTables(program);
+	} catch {
+		return;
+	}
+	const head = tables.get("head");
+	const hhea = tables.get("hhea");
+	const hmtx = tables.get("hmtx");
+	if (!head || !hhea || !hmtx) return void 0;
+	const view = new DataView(program.buffer, program.byteOffset, program.byteLength);
+	const cmaps = cmapSubtables(program);
+	const gid = [
+		cmaps.get("3,1")?.(32),
+		cmaps.get("0,3")?.(32),
+		cmaps.get("3,0")?.(61472),
+		cmaps.get("3,0")?.(32),
+		cmaps.get("1,0")?.(32)
+	].find((gid) => gid !== void 0 && gid > 0) ?? postGlyphNames(program)?.get("space");
+	if (gid === void 0 || gid <= 0) return void 0;
+	const unitsPerEm = safeUint16(view, head.offset + 18) || 1e3;
+	const metrics = safeUint16(view, hhea.offset + 34);
+	if (metrics === 0) return void 0;
+	const at = hmtx.offset + Math.min(gid, metrics - 1) * 4;
+	if (at + 2 > hmtx.offset + hmtx.length) return void 0;
+	const advance = safeUint16(view, at);
+	return advance > 0 ? advance / unitsPerEm * 1e3 : void 0;
+}
+/**
+* Every `cmap` subtable an sfnt program carries, keyed `platform,encoding` —
+* `3,1` for Windows Unicode, `3,0` for Windows symbol, `1,0` for Mac Roman.
+*
+* A simple TrueType font reaches its glyphs through whichever of these it has,
+* and which one decides what a code is looked up AS (§9.6.6.4): a character, a
+* symbol code, a Mac Roman byte.
+*
+* @param program The raw sfnt bytes.
+* @returns Subtable → code-to-glyph lookup (0 where it maps nothing). Formats
+*          0, 4, 6 and 12 are read; any other is left out.
+*/
+function cmapSubtables(program) {
+	const out = /* @__PURE__ */ new Map();
+	let tables;
+	try {
+		tables = sfntTables(program);
+	} catch {
+		return out;
+	}
+	const cmap = tables.get("cmap");
+	if (!cmap) return out;
+	const view = new DataView(program.buffer, program.byteOffset, program.byteLength);
+	const count = safeUint16(view, cmap.offset + 2);
+	for (let i = 0; i < count; i++) {
+		const at = cmap.offset + 4 + i * 8;
+		const key = `${safeUint16(view, at)},${safeUint16(view, at + 2)}`;
+		if (out.has(key)) continue;
+		const lookup = cmapLookup(view, cmap.offset + safeUint32(view, at + 4));
+		if (lookup) out.set(key, lookup);
+	}
+	return out;
+}
+/** One `cmap` subtable as a lookup, for the formats a simple font's program uses. */
+function cmapLookup(view, at) {
+	const format = safeUint16(view, at);
+	if (format === 0) return (code) => code >= 0 && code < 256 ? safeUint8(view, at + 6 + code) : 0;
+	if (format === 6) {
+		const first = safeUint16(view, at + 6);
+		const entries = safeUint16(view, at + 8);
+		return (code) => code >= first && code < first + entries ? safeUint16(view, at + 10 + (code - first) * 2) : 0;
+	}
+	if (format === 4) {
+		const segments = safeUint16(view, at + 6) >> 1;
+		const ends = at + 14;
+		const starts = ends + segments * 2 + 2;
+		const deltas = starts + segments * 2;
+		const ranges = deltas + segments * 2;
+		return (code) => {
+			if (code < 0 || code > 65535) return 0;
+			for (let s = 0; s < segments; s++) {
+				if (safeUint16(view, ends + s * 2) < code) continue;
+				const start = safeUint16(view, starts + s * 2);
+				if (start > code) return 0;
+				const delta = safeUint16(view, deltas + s * 2);
+				const range = safeUint16(view, ranges + s * 2);
+				if (range === 0) return code + delta & 65535;
+				const gid = safeUint16(view, ranges + s * 2 + range + (code - start) * 2);
+				return gid === 0 ? 0 : gid + delta & 65535;
+			}
+			return 0;
+		};
+	}
+	if (format === 12) {
+		const groups = safeUint32(view, at + 12);
+		return (code) => {
+			for (let g = 0; g < groups; g++) {
+				const entry = at + 16 + g * 12;
+				const start = safeUint32(view, entry);
+				const end = safeUint32(view, entry + 4);
+				if (code >= start && code <= end) return safeUint32(view, entry + 8) + (code - start);
+			}
+			return 0;
+		};
+	}
+}
 /** `post` version 2.0 — the only one that states names of its own. */
 var POST_NAMED = 131072;
 /** How many names the Macintosh standard order holds (§post). */
@@ -348,4 +493,4 @@ function safeUint32(view, at) {
 	return at >= 0 && at + 4 <= view.byteLength ? view.getUint32(at) : 0;
 }
 //#endregion
-export { outlineSource, postGlyphNames };
+export { cmapSubtables, outlineSource, postGlyphNames, sfntFsType, sfntSpaceAdvance };

package/dist/esm/pdf-reader/glyph-names.js

@@ -10,16 +10,19 @@ var GLYPHS = {
 	Adieresis: "Ä",
 	Adotaccent: "Ȧ",
 	Agrave: "À",
+	Alpha: "Α",
 	Amacron: "Ā",
 	Aogonek: "Ą",
 	Aring: "Å",
 	Atilde: "Ã",
 	Bdotaccent: "Ḃ",
+	Beta: "Β",
 	Cacute: "Ć",
 	Ccaron: "Č",
 	Ccedilla: "Ç",
 	Ccircumflex: "Ĉ",
 	Cdotaccent: "Ċ",
+	Chi: "Χ",
 	Dcaron: "Ď",
 	Dcedilla: "Ḑ",
 	Ddotaccent: "Ḋ",
@@ -34,11 +37,14 @@ var GLYPHS = {
 	Egrave: "È",
 	Emacron: "Ē",
 	Eogonek: "Ę",
+	Epsilon: "Ε",
+	Eta: "Η",
 	Eth: "Ð",
 	Etilde: "Ẽ",
 	Euro: "€",
 	Fdotaccent: "Ḟ",
 	Gacute: "Ǵ",
+	Gamma: "Γ",
 	Gbreve: "Ğ",
 	Gcaron: "Ǧ",
 	Gcedilla: "Ģ",
@@ -56,26 +62,32 @@ var GLYPHS = {
 	Icircumflex: "Î",
 	Idieresis: "Ï",
 	Idotaccent: "İ",
+	Ifractur: "ℑ",
 	Igrave: "Ì",
 	Imacron: "Ī",
 	Iogonek: "Į",
+	Iota: "Ι",
 	Itilde: "Ĩ",
 	Jcircumflex: "Ĵ",
 	Kacute: "Ḱ",
+	Kappa: "Κ",
 	Kcaron: "Ǩ",
 	Kcedilla: "Ķ",
 	Lacute: "Ĺ",
+	Lambda: "Λ",
 	Lcaron: "Ľ",
 	Lcedilla: "Ļ",
 	Lslash: "Ł",
 	Macute: "Ḿ",
 	Mdotaccent: "Ṁ",
+	Mu: "Μ",
 	Nacute: "Ń",
 	Ncaron: "Ň",
 	Ncedilla: "Ņ",
 	Ndotaccent: "Ṅ",
 	Ngrave: "Ǹ",
 	Ntilde: "Ñ",
+	Nu: "Ν",
 	OE: "Œ",
 	Oacute: "Ó",
 	Obreve: "Ŏ",
@@ -87,23 +99,32 @@ var GLYPHS = {
 	Ohungarumlaut: "Ő",
 	Omacron: "Ō",
 	Omega: "Ω",
+	Omicron: "Ο",
 	Oogonek: "Ǫ",
 	Oslash: "Ø",
 	Otilde: "Õ",
 	Pacute: "Ṕ",
 	Pdotaccent: "Ṗ",
+	Phi: "Φ",
+	Pi: "Π",
+	Psi: "Ψ",
 	Racute: "Ŕ",
 	Rcaron: "Ř",
 	Rcedilla: "Ŗ",
 	Rdotaccent: "Ṙ",
+	Rfractur: "ℜ",
+	Rho: "Ρ",
 	Sacute: "Ś",
 	Scaron: "Š",
 	Scedilla: "Ş",
 	Scircumflex: "Ŝ",
 	Sdotaccent: "Ṡ",
+	Sigma: "Σ",
+	Tau: "Τ",
 	Tcaron: "Ť",
 	Tcedilla: "Ţ",
 	Tdotaccent: "Ṫ",
+	Theta: "Θ",
 	Thorn: "Þ",
 	Uacute: "Ú",
 	Ubreve: "Ŭ",
@@ -114,6 +135,8 @@ var GLYPHS = {
 	Uhungarumlaut: "Ű",
 	Umacron: "Ū",
 	Uogonek: "Ų",
+	Upsilon: "Υ",
+	Upsilon1: "ϒ",
 	Uring: "Ů",
 	Utilde: "Ũ",
 	Vtilde: "Ṽ",
@@ -124,6 +147,7 @@ var GLYPHS = {
 	Wgrave: "Ẁ",
 	Xdieresis: "Ẍ",
 	Xdotaccent: "Ẋ",
+	Xi: "Ξ",
 	Yacute: "Ý",
 	Ycircumflex: "Ŷ",
 	Ydieresis: "Ÿ",
@@ -135,6 +159,7 @@ var GLYPHS = {
 	Zcaron: "Ž",
 	Zcircumflex: "Ẑ",
 	Zdotaccent: "Ż",
+	Zeta: "Ζ",
 	aacute: "á",
 	abreve: "ă",
 	acaron: "ǎ",
@@ -144,19 +169,46 @@ var GLYPHS = {
 	adotaccent: "ȧ",
 	ae: "æ",
 	agrave: "à",
+	aleph: "ℵ",
+	alpha: "α",
 	amacron: "ā",
 	ampersand: "&",
+	angbracketleft: "⟨",
+	angbracketright: "⟩",
+	angle: "∠",
+	angleleft: "〈",
+	angleright: "〉",
 	aogonek: "ą",
 	approxequal: "≈",
 	aring: "å",
+	arrowboth: "↔",
+	arrowbothv: "↕",
+	arrowdblboth: "⇔",
+	arrowdblbothv: "⇕",
+	arrowdbldown: "⇓",
+	arrowdblleft: "⇐",
+	arrowdblright: "⇒",
+	arrowdblup: "⇑",
+	arrowdown: "↓",
+	arrowleft: "←",
+	arrownortheast: "↗",
+	arrownorthwest: "↖",
+	arrowright: "→",
+	arrowsoutheast: "↘",
+	arrowsouthwest: "↙",
+	arrowup: "↑",
+	arrowupdn: "↕",
 	asciicircum: "^",
 	asciitilde: "~",
 	asterisk: "*",
+	asteriskmath: "∗",
 	at: "@",
 	atilde: "ã",
 	backslash: "\\",
 	bar: "|",
+	bardbl: "‖",
 	bdotaccent: "ḃ",
+	beta: "β",
 	braceleft: "{",
 	braceright: "}",
 	bracketleft: "[",
@@ -171,10 +223,22 @@ var GLYPHS = {
 	ccircumflex: "ĉ",
 	cdotaccent: "ċ",
 	cedilla: "¸",
+	ceilingleft: "⌈",
+	ceilingright: "⌉",
 	cent: "¢",
+	chi: "χ",
+	circlecopyrt: "◯",
+	circledivide: "⊘",
+	circledot: "⊙",
+	circleminus: "⊖",
+	circlemultiply: "⊗",
+	circleplus: "⊕",
 	circumflex: "ˆ",
+	club: "♣",
 	colon: ":",
 	comma: ",",
+	congruent: "≅",
+	coproduct: "⨿",
 	copyright: "©",
 	currency: "¤",
 	dagger: "†",
@@ -183,11 +247,16 @@ var GLYPHS = {
 	dcedilla: "ḑ",
 	ddotaccent: "ḋ",
 	degree: "°",
+	delta: "δ",
+	diamond: "♢",
+	diamondmath: "⋄",
 	dieresis: "¨",
 	divide: "÷",
 	dollar: "$",
 	dotaccent: "˙",
 	dotlessi: "ı",
+	dotlessj: "ȷ",
+	dotmath: "⋅",
 	eacute: "é",
 	ebreve: "ĕ",
 	ecaron: "ě",
@@ -197,17 +266,25 @@ var GLYPHS = {
 	edotaccent: "ė",
 	egrave: "è",
 	eight: "8",
+	element: "∈",
 	ellipsis: "…",
 	emacron: "ē",
 	emdash: "—",
+	emptyset: "∅",
 	endash: "–",
 	eogonek: "ę",
+	epsilon: "ε",
+	epsilon1: "ϵ",
 	equal: "=",
+	equivalence: "≡",
+	equivasymptotic: "≍",
+	eta: "η",
 	eth: "ð",
 	etilde: "ẽ",
 	euro: "€",
 	exclam: "!",
 	exclamdown: "¡",
+	existential: "∃",
 	fdotaccent: "ḟ",
 	ff: "ff",
 	ffi: "ffi",
@@ -215,10 +292,16 @@ var GLYPHS = {
 	fi: "fi",
 	five: "5",
 	fl: "fl",
+	flat: "♭",
+	floorleft: "⌊",
+	floorright: "⌋",
 	florin: "ƒ",
+	follows: "≻",
+	followsequal: "⪰",
 	four: "4",
 	fraction: "⁄",
 	gacute: "ǵ",
+	gamma: "γ",
 	gbreve: "ğ",
 	gcaron: "ǧ",
 	gcedilla: "ģ",
@@ -226,9 +309,11 @@ var GLYPHS = {
 	gdotaccent: "ġ",
 	germandbls: "ß",
 	gmacron: "ḡ",
+	gradient: "∇",
 	grave: "`",
 	greater: ">",
 	greaterequal: "≥",
+	greatermuch: "≫",
 	guillemotleft: "«",
 	guillemotright: "»",
 	guilsinglleft: "‹",
@@ -238,6 +323,7 @@ var GLYPHS = {
 	hcircumflex: "ĥ",
 	hdieresis: "ḧ",
 	hdotaccent: "ḣ",
+	heart: "♡",
 	hungarumlaut: "˝",
 	hyphen: "-",
 	iacute: "í",
@@ -249,36 +335,54 @@ var GLYPHS = {
 	infinity: "∞",
 	integral: "∫",
 	imacron: "ī",
+	intersection: "∩",
+	intersectionsq: "⊓",
 	iogonek: "į",
+	iota: "ι",
 	itilde: "ĩ",
 	jcaron: "ǰ",
 	jcircumflex: "ĵ",
 	kacute: "ḱ",
+	kappa: "κ",
 	kcaron: "ǩ",
 	kcedilla: "ķ",
 	lacute: "ĺ",
+	lambda: "λ",
+	latticetop: "⊤",
 	lcaron: "ľ",
 	lcedilla: "ļ",
 	less: "<",
 	lessequal: "≤",
+	lessmuch: "≪",
+	logicaland: "∧",
 	logicalnot: "¬",
+	logicalor: "∨",
 	lozenge: "◊",
+	lscript: "ℓ",
 	lslash: "ł",
 	macron: "¯",
 	macute: "ḿ",
+	mapsto: "↦",
 	mdotaccent: "ṁ",
 	minus: "−",
+	minusplus: "∓",
 	mu: "µ",
 	multiply: "×",
+	nabla: "∇",
 	nacute: "ń",
+	natural: "♮",
 	nbspace: "\xA0",
 	ncaron: "ň",
 	ncedilla: "ņ",
 	ndotaccent: "ṅ",
+	negationslash: "̸",
 	ngrave: "ǹ",
 	nine: "9",
+	notelement: "∉",
 	notequal: "≠",
+	notsubset: "⊄",
 	ntilde: "ñ",
+	nu: "ν",
 	numbersign: "#",
 	oacute: "ó",
 	obreve: "ŏ",
@@ -291,15 +395,20 @@ var GLYPHS = {
 	ograve: "ò",
 	ohungarumlaut: "ő",
 	omacron: "ō",
+	omega: "ω",
+	omega1: "ϖ",
+	omicron: "ο",
 	one: "1",
 	onehalf: "½",
 	onequarter: "¼",
 	onesuperior: "¹",
 	oogonek: "ǫ",
+	openbullet: "◦",
 	ordfeminine: "ª",
 	ordmasculine: "º",
 	oslash: "ø",
 	otilde: "õ",
+	owner: "∋",
 	pacute: "ṕ",
 	paragraph: "¶",
 	parenleft: "(",
@@ -309,11 +418,22 @@ var GLYPHS = {
 	percent: "%",
 	period: ".",
 	periodcentered: "·",
+	perpendicular: "⊥",
 	perthousand: "‰",
+	phi: "φ",
+	phi1: "ϕ",
 	pi: "π",
+	pi1: "ϖ",
 	plus: "+",
 	plusminus: "±",
+	precedes: "≺",
+	precedesequal: "⪯",
+	prime: "′",
 	product: "∏",
+	propersubset: "⊂",
+	propersuperset: "⊃",
+	proportional: "∝",
+	psi: "ψ",
 	question: "?",
 	questiondown: "¿",
 	quotedbl: "\"",
@@ -329,7 +449,11 @@ var GLYPHS = {
 	rcaron: "ř",
 	rcedilla: "ŗ",
 	rdotaccent: "ṙ",
+	reflexsubset: "⊆",
+	reflexsuperset: "⊇",
 	registered: "®",
+	rho: "ρ",
+	rho1: "ϱ",
 	ring: "˚",
 	sacute: "ś",
 	scaron: "š",
@@ -340,22 +464,42 @@ var GLYPHS = {
 	semicolon: ";",
 	seven: "7",
 	sfthyphen: "­",
+	sharp: "♯",
+	sigma: "σ",
+	sigma1: "ς",
+	similar: "∼",
+	similarequal: "≃",
 	six: "6",
 	slash: "/",
 	softhyphen: "­",
 	space: " ",
+	spade: "♠",
+	star: "⋆",
 	sterling: "£",
+	subsetsqequal: "⊑",
+	suchthat: "∋",
 	summation: "∑",
+	supersetsqequal: "⊒",
+	tau: "τ",
 	tcaron: "ť",
 	tcedilla: "ţ",
 	tdieresis: "ẗ",
 	tdotaccent: "ṫ",
+	therefore: "∴",
+	theta: "θ",
+	theta1: "ϑ",
 	thorn: "þ",
 	three: "3",
 	threequarters: "¾",
 	threesuperior: "³",
 	tilde: "˜",
 	trademark: "™",
+	triangle: "△",
+	triangleinv: "▽",
+	triangleleft: "◁",
+	triangleright: "▷",
+	turnstileleft: "⊢",
+	turnstileright: "⊣",
 	two: "2",
 	twosuperior: "²",
 	uacute: "ú",
@@ -367,7 +511,12 @@ var GLYPHS = {
 	uhungarumlaut: "ű",
 	umacron: "ū",
 	underscore: "_",
+	union: "∪",
+	unionmulti: "⊎",
+	unionsq: "⊔",
+	universal: "∀",
 	uogonek: "ų",
+	upsilon: "υ",
 	uring: "ů",
 	utilde: "ũ",
 	vtilde: "ṽ",
@@ -375,10 +524,13 @@ var GLYPHS = {
 	wcircumflex: "ŵ",
 	wdieresis: "ẅ",
 	wdotaccent: "ẇ",
+	weierstrass: "℘",
 	wgrave: "ẁ",
+	wreathproduct: "≀",
 	wring: "ẘ",
 	xdieresis: "ẍ",
 	xdotaccent: "ẋ",
+	xi: "ξ",
 	yacute: "ý",
 	ycircumflex: "ŷ",
 	ydieresis: "ÿ",
@@ -392,7 +544,8 @@ var GLYPHS = {
 	zcaron: "ž",
 	zcircumflex: "ẑ",
 	zdotaccent: "ż",
-	zero: "0"
+	zero: "0",
+	zeta: "ζ"
 };
 /**
 * The text a glyph name stands for, or `undefined` when the name says nothing.

package/dist/esm/pdf-reader/glyph-shapes.d.ts

@@ -0,0 +1,18 @@
+import { PathSeg } from './content.js';
+/** A glyph's contours, and the box they fill, in the page's y-up space. */
+export interface GlyphShape {
+    readonly segs: ReadonlyArray<PathSeg>;
+    readonly minX: number;
+    readonly minY: number;
+    readonly maxX: number;
+    readonly maxY: number;
+}
+/**
+ * The punctuation mark a glyph's shape is, where it can be only one.
+ *
+ * @param glyph    The glyph as the page draws it.
+ * @param baseline The y of the line it stands on.
+ * @param size     The size the line is set at, which the shape is measured in.
+ * @returns The character, or `undefined` where the shape does not say.
+ */
+export declare function punctuationOf(glyph: GlyphShape, baseline: number, size: number): string | undefined;