Initial commit

node_modules/fontace/dist/index.d.ts

@@ -0,0 +1,39 @@
+//#region src/types.d.ts
+type FontStyle = 'auto' | 'normal' | 'italic' | 'oblique' | `oblique ${number}deg` | `oblique ${number}deg ${number}deg`;
+type FontWeightAbsolute = 'normal' | 'bold' | `${number}`;
+type FontWeight = 'auto' | FontWeightAbsolute | `${FontWeightAbsolute} ${FontWeightAbsolute}`;
+interface FontMetadata {
+  /** The font family name as stored in the font file, e.g. `"Inter"`. */
+  family: string;
+  /** The range of Unicode code points this font file contains, e.g. `"U+0-10FFFF"`. */
+  unicodeRange: string;
+  /**
+   * Array of Unicode code point ranges this font file contains, e.g. `["U+0-10FFFF"]`,
+   * equivalent to `unicodeRange.split(', ')`.
+   */
+  unicodeRangeArray: string[];
+  /** The style of this font file, e.g. `"normal"` or `"italic"`. */
+  style: FontStyle;
+  /** The font weight(s) this file supports, which can be a range for variable fonts, e.g. `"400"` or `"100 900"`. */
+  weight: FontWeight;
+  /** Font format compatible with `format()` values in `@font-face` `src` properties. */
+  format: 'truetype' | 'woff' | 'woff2';
+  /** Whether or not this font is variable. */
+  isVariable: boolean;
+}
+//#endregion
+//#region src/index.d.ts
+/**
+ * Infer font-face properties from a buffer containing font file data.
+ * @param fontBuffer Buffer containing font file data.
+ * @example
+ * import { fontace } from 'fontace';
+ * import fs from 'node:fs';
+ *
+ * const fontBuffer = fs.readFileSync('./Inter.ttf');
+ * const fontMetaData = fontace(fontBuffer);
+ * // { family: "Inter", style: "normal", weight: "400", unicodeRange: "U+0, U+20-7E...
+ */
+declare function fontace(fontBuffer: Buffer): FontMetadata;
+//#endregion
+export { fontace };

node_modules/fontace/dist/index.js

@@ -0,0 +1,81 @@
+import { create } from "fontkitten";
+
+//#region src/index.ts
+/** Get CSS weight for a font. */
+function getWeight(font) {
+	if (font.variationAxes.wght) return `${font.variationAxes.wght.min} ${font.variationAxes.wght.max}`;
+	return `${font["OS/2"]?.usWeightClass || (font["OS/2"]?.fsSelection?.["bold"] ? 700 : 400)}`;
+}
+/** Get CSS style for a font. */
+function getStyle(font) {
+	return font["OS/2"]?.fsSelection?.italic || font.italicAngle !== 0 ? "italic" : "normal";
+}
+/**
+* Infer font-face properties from a buffer containing font file data.
+* @param fontBuffer Buffer containing font file data.
+* @example
+* import { fontace } from 'fontace';
+* import fs from 'node:fs';
+*
+* const fontBuffer = fs.readFileSync('./Inter.ttf');
+* const fontMetaData = fontace(fontBuffer);
+* // { family: "Inter", style: "normal", weight: "400", unicodeRange: "U+0, U+20-7E...
+*/
+function fontace(fontBuffer) {
+	const font = create(fontBuffer);
+	if (font.isCollection) throw new Error(`${font.type} files are not supported.`);
+	return {
+		...getUnicodeRange(font),
+		family: font.familyName,
+		style: getStyle(font),
+		weight: getWeight(font),
+		format: {
+			TTF: "truetype",
+			WOFF: "woff",
+			WOFF2: "woff2"
+		}[font.type],
+		isVariable: Object.keys(font.variationAxes).length > 0
+	};
+}
+/**
+* Convert an array of unicode code points to a CSS unicode-range string.
+* @param font A font object.
+* @returns A CSS unicode-range string, e.g. `"U+20-22, U+4E-50"`.
+*/
+function getUnicodeRange({ characterSet }) {
+	if (!characterSet || characterSet.length === 0) {
+		/** The default value of `unicodeRange` is U+0-10FFFF, which represents all Unicode characters. */
+		const defaultRange = "U+0-10FFFF";
+		return {
+			unicodeRange: defaultRange,
+			unicodeRangeArray: [defaultRange]
+		};
+	}
+	characterSet.sort((a, b) => a - b);
+	const ranges = [];
+	let start = characterSet[0];
+	let end = start;
+	for (let i = 1; i < characterSet.length; i++) if (characterSet[i] === end + 1) end = characterSet[i];
+	else {
+		ranges.push(formatRange(start, end));
+		start = characterSet[i];
+		end = start;
+	}
+	ranges.push(formatRange(start, end));
+	return {
+		unicodeRange: ranges.join(", "),
+		unicodeRangeArray: ranges
+	};
+}
+/**
+* Format a range of unicode code points as a CSS unicode-range string.
+* @param start The start of the range, e.g. `32`.
+* @param end The end of the range, e.g. `34`.
+* @returns A CSS unicode-range string, e.g. `"U+20-22"`.
+*/
+function formatRange(start, end) {
+	return start === end ? `U+${start.toString(16).toUpperCase()}` : `U+${start.toString(16).toUpperCase()}-${end.toString(16).toUpperCase()}`;
+}
+
+//#endregion
+export { fontace };