webfont 12.1.0 → 12.2.0

package/dist/{renderTemplates-DvRlS58E.mjs → renderTemplates-Biyrk6t-.mjs}

@@ -1,20 +1,19 @@
-#!/usr/bin/env node
 import { fileURLToPath as e } from "node:url";
 e(import.meta.url);
 const t = e(new URL(".", import.meta.url));
-import { t as n } from "./parseTemplateOption-5T7rSw5J.mjs";
-import r from "path";
-import i from "deepmerge";
+import { t as n } from "./parseTemplateOption-Bvbie1SQ.mjs";
+import r from "deepmerge";
+import i from "path";
 import a from "nunjucks";
 //#region templates/index.ts
-var o = () => r.resolve(t, "../templates"), s = (e) => `${o()}/template.${e}.njk`, c = () => {
+var o = () => i.resolve(t, "../templates"), s = (e) => `${o()}/template.${e}.njk`, c = () => {
 	let e = o();
 	return {
-		css: { path: r.join(e, "template.css.njk") },
-		html: { path: r.join(e, "template.html.njk") },
-		json: { path: r.join(e, "template.json.njk") },
-		scss: { path: r.join(e, "template.scss.njk") },
-		styl: { path: r.join(e, "template.styl.njk") }
+		css: { path: i.join(e, "template.css.njk") },
+		html: { path: i.join(e, "template.html.njk") },
+		json: { path: i.join(e, "template.json.njk") },
+		scss: { path: i.join(e, "template.scss.njk") },
+		styl: { path: i.join(e, "template.styl.njk") }
 	};
 }, l = (e) => {
 	let t = 4;
@@ -53,7 +52,7 @@ var o = () => r.resolve(t, "../templates"), s = (e) => `${o()}/template.${e}.njk
 	};
 	let d = c(), f = [], h = !1, g = {};
 	e.addHashInFontUrl && (g = { hash: o.hash });
-	let _ = o.glyphsData?.map((e) => e.metadata).filter((e) => e !== void 0) ?? [], v = i.all([
+	let _ = o.glyphsData?.map((e) => e.metadata).filter((e) => e !== void 0) ?? [], v = r.all([
 		{ glyphs: _ },
 		e,
 		{
@@ -69,19 +68,19 @@ var o = () => r.resolve(t, "../templates"), s = (e) => `${o()}/template.${e}.njk
 		{ templateFontLigatures: e.templateFontLigatures !== !1 }
 	]);
 	for (let e of u) {
-		let n, i;
+		let n, r;
 		if (Object.keys(d).includes(e)) {
-			h = !0, i = e;
-			let o = r.resolve(t, "../..");
+			h = !0, r = e;
+			let o = i.resolve(t, "../..");
 			a.configure(o), n = s(e);
 		} else {
-			let t = r.resolve(e);
-			a.configure(r.dirname(t)), n = r.resolve(t);
+			let t = i.resolve(e);
+			a.configure(i.dirname(t)), n = i.resolve(t);
 		}
 		f.push({
 			template: e,
 			content: a.render(n, v),
-			builtIn: i
+			builtIn: r
 		});
 	}
 	return {

package/dist/renderTemplates-CXVKq3Op.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+import { fileURLToPath as e } from "node:url";
+e(import.meta.url);
+const t = e(new URL(".", import.meta.url));
+import { i as n, n as r, t as i } from "./parseTemplateOption-DLNu6PPx.mjs";
+import a from "path";
+import o from "deepmerge";
+import s from "nunjucks";
+//#region templates/index.ts
+var c, l, u, d = n((() => {
+	c = () => a.resolve(t, "../templates"), l = (e) => `${c()}/template.${e}.njk`, u = () => {
+		let e = c();
+		return {
+			css: { path: a.join(e, "template.css.njk") },
+			html: { path: a.join(e, "template.html.njk") },
+			json: { path: a.join(e, "template.json.njk") },
+			scss: { path: a.join(e, "template.scss.njk") },
+			styl: { path: a.join(e, "template.styl.njk") }
+		};
+	};
+})), f, p, m, h, g, _ = n((() => {
+	f = (e) => {
+		let t = 4;
+		return e > 65535 && (t = 6), e.toString(16).toUpperCase().padStart(t, "0");
+	}, p = (e) => {
+		if (e.length === 0 || e.length > 2) return;
+		let t = e.codePointAt(0);
+		if (t !== void 0 && !(e.length > 1 && t < 128)) return t;
+	}, m = (e) => {
+		let t = [];
+		for (let n of e) for (let e of n.unicode ?? []) {
+			let n = p(e);
+			n !== void 0 && t.push(n);
+		}
+		return t;
+	}, h = (e) => {
+		let t = m(e);
+		if (t.length === 0) return;
+		let n = Math.min(...t), r = Math.max(...t);
+		return n === r ? `U+${f(n)}` : `U+${f(n)}-${f(r)}`;
+	}, g = (e, t) => {
+		if (!(e === !1 || e === void 0)) return typeof e == "string" ? e : h(t);
+	};
+})), v, y = n((() => {
+	v = (e, t) => {
+		if (e === "woff2") {
+			if (!t.woff2) throw Error("Missing woff2 buffer for template rendering");
+			return Buffer.from(t.woff2).toString("base64");
+		}
+		let n = t[e];
+		if (!n) throw Error(`Missing ${e} buffer for template rendering`);
+		return n.toString("base64");
+	};
+})), b;
+//#endregion
+n((() => {
+	d(), i(), _(), y(), b = (e, n, i) => {
+		let c = r(e.template);
+		if (c.length === 0) return {
+			templates: [],
+			usedBuildInTemplate: !1
+		};
+		let d = u(), f = [], p = !1, m = {};
+		e.addHashInFontUrl && (m = { hash: n.hash });
+		let h = n.glyphsData?.map((e) => e.metadata).filter((e) => e !== void 0) ?? [], _ = o.all([
+			{ glyphs: h },
+			e,
+			{
+				cacheString: e.templateCacheString || Date.now(),
+				className: e.templateClassName || e.fontName,
+				fontFamily: e.templateFontName || e.fontName,
+				fontPath: e.templateFontPath.replace(/\/?$/u, "/"),
+				svgFontId: e.fontId || e.fontName
+			},
+			m,
+			{ fonts: Object.fromEntries(new Map(i.map((e) => [e, () => v(e, n)]))) },
+			{ unicodeRange: g(e.unicodeRange, h) },
+			{ templateFontLigatures: e.templateFontLigatures !== !1 }
+		]);
+		for (let e of c) {
+			let n, r;
+			if (Object.keys(d).includes(e)) {
+				p = !0, r = e;
+				let i = a.resolve(t, "../..");
+				s.configure(i), n = l(e);
+			} else {
+				let t = a.resolve(e);
+				s.configure(a.dirname(t)), n = a.resolve(t);
+			}
+			f.push({
+				template: e,
+				content: s.render(n, _),
+				builtIn: r
+			});
+		}
+		return {
+			templates: f,
+			usedBuildInTemplate: p
+		};
+	};
+}))();
+export { b as renderTemplates };

package/dist/src/browser.d.mts

@@ -0,0 +1,2 @@
+export declare const webfont: () => Promise<never>;
+export default webfont;

package/dist/src/index.d.mts

@@ -0,0 +1,5 @@
+import { webfont } from './standalone/index.mjs';
+export { diagnoseGlyphsData, diagnoseSvgContents } from './lib/svgDiagnostics/diagnoseSvgContents.mjs';
+export { webfont } from './standalone/index.mjs';
+export type { SvgDiagnosticCode, SvgGlyphDiagnostic, SvgToolsOptions } from './types/SvgToolsOptions.mjs';
+export default webfont;

package/dist/src/lib/applyOptimizeSvgToGlyphs.d.mts

@@ -0,0 +1,3 @@
+import { Config } from 'svgo';
+import { GlyphData } from '../types/GlyphData.mjs';
+export declare const applyOptimizeSvgToGlyphs: (glyphs: GlyphData[], svgoConfig?: Config) => GlyphData[];

package/dist/src/lib/evenoddFillRule.d.mts

@@ -0,0 +1,2 @@
+export declare const hasEvenoddFillRule: (svgContents: string) => boolean;
+export declare const evenoddFillRuleWarning: (srcPath: string) => string;

package/dist/src/lib/execCLI/index.d.mts

@@ -0,0 +1,24 @@
+import { ExecException } from 'child_process';
+export type Output = {
+    code?: number;
+    error: ExecException | null;
+    files: string[];
+    stderr?: string;
+    stdout?: string;
+};
+export type ExecCLI = (_args?: string, _destination?: string) => Promise<Output>;
+/**
+ * @name execCLI
+ * @description Execute webfont CLI commands using child_process.
+ *
+ * @param {String} args - Arguments to pass to the CLI.
+ * @param {String} destination - Path to read/write files
+ * @return {Promise.<Object>} - Contains CLI error, stdout, stderr data.
+ * @example
+ *
+ * execCLI("--help").then((output) => {
+ *  console.log(output.stdout) // => Outputs usage information.
+ * })
+ *
+ */
+export declare const execCLI: ExecCLI;

package/dist/src/lib/inputSource.d.mts

@@ -0,0 +1,2 @@
+export { getInputExtension, getWebfontSourceBasename, isHttpUrl, resolveDecompressedFontBasenames, } from './inputSourceUtils.mjs';
+export declare const resolveInputSources: (patterns: readonly string[]) => Promise<string[]>;

package/dist/src/lib/inputSourceUtils.d.mts

@@ -0,0 +1,4 @@
+export declare const isHttpUrl: (value: string) => boolean;
+export declare const getInputExtension: (source: string) => string;
+export declare const getWebfontSourceBasename: (source: string) => string;
+export declare const resolveDecompressedFontBasenames: (sources: readonly string[]) => string[];

package/dist/src/lib/largeFontLigatures.d.mts

@@ -0,0 +1,4 @@
+/** Glyph count above which OpenType ligatures often hurt browser layout (Firefox / DirectWrite). */
+export declare const LARGE_FONT_LIGATURE_GLYPH_THRESHOLD = 2000;
+export declare const shouldWarnLargeFontLigatures: (glyphCount: number, ligaturesEnabled: boolean) => boolean;
+export declare const formatLargeFontLigatureWarning: (glyphCount: number) => string;

package/dist/src/lib/optimizeSvgGlyphs.d.mts

@@ -0,0 +1,4 @@
+import { Config } from 'svgo';
+/** Conservative SVGO preset: cleanup cruft without rewriting paths or removing viewBox. */
+export declare const defaultWebfontSvgoConfig: () => Config;
+export declare const optimizeSvgContents: (contents: string, srcPath: string, config?: Config) => string;

package/dist/src/lib/p-limit/index.d.mts

@@ -0,0 +1,2 @@
+import { default as pLimit } from 'p-limit';
+export default pLimit;

package/dist/src/lib/parseFormats.d.mts

@@ -0,0 +1,4 @@
+import { Format, Formats } from '../types/Format.mjs';
+export declare const assertValidFormat: (value: unknown) => Format;
+export declare const parseFormatsList: (values: readonly unknown[]) => Formats;
+export declare const assertFormatsOption: (formats: unknown) => Formats;

package/dist/src/lib/parseTemplateOption.d.mts

@@ -0,0 +1,2 @@
+export type TemplateOption = string | string[];
+export declare const normalizeTemplateOption: (template: unknown) => string[];

package/dist/src/lib/runtimeEnvironment.d.mts

@@ -0,0 +1,4 @@
+/** True in browser tabs and Web Workers (including Vite `process` polyfills). */
+export declare const isBrowserOrWorkerRuntime: () => boolean;
+/** True only in real Node.js — not in browser tabs or Web Workers. */
+export declare const isNodeRuntime: () => boolean;

package/dist/src/lib/sfnt/flavor.d.mts

@@ -0,0 +1,2 @@
+export type SfntFlavor = "otf" | "ttf";
+export declare const getSfntFlavor: (buffer: Buffer) => SfntFlavor;

package/dist/src/lib/svgDiagnostics/diagnoseSvgContents.d.mts

@@ -0,0 +1,13 @@
+import { SvgGlyphDiagnostic } from '../../types/SvgToolsOptions.mjs';
+export declare const hasStrokeOnlySvg: (svgContents: string) => boolean;
+export declare const hasUnsupportedSvgElements: (svgContents: string) => boolean;
+export declare const hasUseReference: (svgContents: string) => boolean;
+export declare const diagnoseSvgContents: (srcPath: string, svgContents: string) => SvgGlyphDiagnostic[];
+export declare const diagnoseGlyphsData: (glyphs: ReadonlyArray<{
+    contents: string;
+    srcPath: string;
+}>) => SvgGlyphDiagnostic[];
+export declare const shouldLogDiagnostic: (diagnostic: SvgGlyphDiagnostic, options: {
+    diagnose?: boolean;
+    verbose?: boolean;
+}) => boolean;

package/dist/src/lib/svgDiagnostics/diagnoseSvgContents.d.ts

@@ -1,6 +1,7 @@
 import { SvgGlyphDiagnostic } from '../../types/SvgToolsOptions';
 export declare const hasStrokeOnlySvg: (svgContents: string) => boolean;
 export declare const hasUnsupportedSvgElements: (svgContents: string) => boolean;
+export declare const hasUseReference: (svgContents: string) => boolean;
 export declare const diagnoseSvgContents: (srcPath: string, svgContents: string) => SvgGlyphDiagnostic[];
 export declare const diagnoseGlyphsData: (glyphs: ReadonlyArray<{
     contents: string;

package/dist/src/lib/svgFontOutput/emptyGlyphPaths.d.mts

@@ -0,0 +1,3 @@
+import { GlyphData } from '../../types/GlyphData.mjs';
+export declare const findEmptySvgFontGlyphNames: (svgFont: string) => string[];
+export declare const assertNonEmptySvgFontGlyphs: (svgFont: string, glyphsData: ReadonlyArray<Pick<GlyphData, "metadata" | "srcPath">>) => void;

package/dist/src/lib/svgTools/applySvgDiagnostics.d.mts

@@ -0,0 +1,13 @@
+import { GlyphData } from '../../types/GlyphData.mjs';
+import { SvgGlyphDiagnostic } from '../../types/SvgToolsOptions.mjs';
+export type SvgToolsReporter = (message: string) => void;
+export type ApplySvgDiagnosticsResult = {
+    diagnostics: SvgGlyphDiagnostic[];
+    glyphs: GlyphData[];
+};
+export declare const applySvgDiagnosticsToGlyphs: (glyphsData: GlyphData[], svgToolsInput: {
+    diagnose?: boolean;
+} | undefined, runtime?: {
+    reporter?: SvgToolsReporter;
+    verbose?: boolean;
+}) => ApplySvgDiagnosticsResult;

package/dist/src/lib/svgTools/applySvgTools.d.mts

@@ -0,0 +1,14 @@
+import { GlyphData } from '../../types/GlyphData.mjs';
+import { SvgGlyphDiagnostic, SvgToolsOptions } from '../../types/SvgToolsOptions.mjs';
+import { SvgToolsReporter } from './applySvgDiagnostics.mjs';
+export type { SvgToolsReporter } from './applySvgDiagnostics.mjs';
+export type ApplySvgToolsResult = {
+    diagnostics: SvgGlyphDiagnostic[];
+    glyphs: GlyphData[];
+};
+export type ApplySvgToolsRuntime = {
+    reporter?: SvgToolsReporter;
+    /** When true, logs evenodd diagnostics even if svgTools.diagnose is off (backward compatible with --verbose). */
+    verbose?: boolean;
+};
+export declare const applySvgToolsToGlyphs: (glyphsData: GlyphData[], svgToolsInput: SvgToolsOptions | undefined, runtime?: ApplySvgToolsRuntime) => ApplySvgToolsResult;

package/dist/src/lib/svgTools/normalizeSvgToolsOptions.d.mts

@@ -0,0 +1,2 @@
+import { SvgToolsOptions } from '../../types/SvgToolsOptions.mjs';
+export declare const normalizeSvgToolsOptions: (svgTools?: SvgToolsOptions) => SvgToolsOptions | undefined;

package/dist/src/lib/svgicons2svgfont/index.d.mts

@@ -0,0 +1,14 @@
+import { SVGIcons2SVGFontStreamOptions, fileSorter, getMetadataService, SVGIcons2SVGFontStream } from 'svgicons2svgfont';
+import { WebfontOptions } from '../../types/index.mjs';
+export { fileSorter, getMetadataService, SVGIcons2SVGFontStream };
+type MetadataServiceOptions = {
+    prependUnicode: boolean;
+    startUnicode: number;
+};
+export declare const getMetadataServiceOptions: (options: WebfontOptions) => MetadataServiceOptions;
+/**
+ * Coerce `round` for svgicons2svgfont; accepts number or numeric string (CLI/config).
+ * Returns undefined for undefined/null/empty/non-numeric/non-finite inputs.
+ */
+export declare const normalizeRoundOption: (round: string | number | null | undefined) => number | undefined;
+export declare const getFontStreamOptions: (options: WebfontOptions) => Partial<SVGIcons2SVGFontStreamOptions>;

package/dist/src/lib/svgicons2svgfont/metadataFromSrcPath.d.mts

@@ -0,0 +1,11 @@
+import { MetadataProvider } from '../../types/MetadataProvider.mjs';
+type MetadataServiceOptions = {
+    prependUnicode: boolean;
+    startUnicode: number;
+};
+/**
+ * Browser-safe metadata lookup from a virtual `srcPath` (no `fs`, no file rename).
+ * Mirrors {@link https://github.com/nfroidure/svgicons2svgfont | svgicons2svgfont} filename rules.
+ */
+export declare const createMetadataFromSrcPathService: (options?: Partial<MetadataServiceOptions>) => MetadataProvider;
+export {};

package/dist/src/lib/templateUnicodeRange.d.mts

@@ -0,0 +1,4 @@
+import { GlyphMetadata } from '../types/GlyphMetadata.mjs';
+export declare const collectCodePointsFromGlyphs: (glyphs: readonly Pick<GlyphMetadata, "unicode">[]) => number[];
+export declare const computeUnicodeRangeFromGlyphs: (glyphs: readonly Pick<GlyphMetadata, "unicode">[]) => string | undefined;
+export declare const resolveTemplateUnicodeRange: (unicodeRange: boolean | string | undefined, glyphs: readonly Pick<GlyphMetadata, "unicode">[]) => string | undefined;

package/dist/src/lib/ttf2eot/index.d.mts

@@ -0,0 +1,2 @@
+declare const convertTtfToEot: (ttf: Buffer) => Buffer;
+export default convertTtfToEot;

package/dist/src/lib/ttfEncode.d.mts

@@ -0,0 +1,5 @@
+export declare const encodeTtfToEot: (buffer: Buffer) => Buffer;
+export declare const encodeTtfToWoff: (buffer: Buffer, options?: {
+    metadata?: string;
+}) => Buffer;
+export declare const encodeTtfToWoff2: (buffer: Buffer) => Promise<Buffer>;

package/dist/src/standalone/convertTtfInput.d.mts

@@ -0,0 +1,3 @@
+import { Result } from '../types/Result.mjs';
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+export declare const convertTtfInput: (fontFiles: readonly string[], options: WebfontOptions) => Promise<Result>;

package/dist/src/standalone/convertWebfontInput.d.mts

@@ -0,0 +1,3 @@
+import { Result } from '../types/Result.mjs';
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+export declare const convertWebfontInput: (fontFiles: readonly string[], options: WebfontOptions) => Promise<Result>;

package/dist/src/standalone/defaultOptions.d.mts

@@ -0,0 +1,3 @@
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+/** Shared defaults for Node (`files`) and in-memory (`glyphs`) entry points. */
+export declare const defaultWebfontOptions: () => Omit<WebfontOptions, "files">;

package/dist/src/standalone/fetchWebfontUrl.d.mts

@@ -0,0 +1 @@
+export declare const fetchWebfontFromUrl: (url: string) => Promise<Buffer>;

package/dist/src/standalone/generateSvgFont.d.mts

@@ -0,0 +1,2 @@
+import { GlyphData, WebfontOptions } from '../types/index.mjs';
+export declare const generateSvgFont: (glyphsData: GlyphData[], options: WebfontOptions) => Promise<string>;

package/dist/src/standalone/getGlyphsDataFromInputs.d.mts

@@ -0,0 +1,3 @@
+import { GlyphData, WebfontOptions } from '../types/index.mjs';
+import { GlyphInput } from '../types/GlyphInput.mjs';
+export declare const getGlyphsDataFromInputs: (inputs: readonly GlyphInput[], options: WebfontOptions) => Promise<GlyphData[]>;

package/dist/src/standalone/glyphsData.d.mts

@@ -0,0 +1,4 @@
+import { GlyphData, WebfontOptions } from '../types/index.mjs';
+type GlyphsDataGetter = (_files: Array<GlyphData["srcPath"]>, _options: WebfontOptions) => Promise<GlyphData[]>;
+export declare const getGlyphsData: GlyphsDataGetter;
+export {};

package/dist/src/standalone/index.d.mts

@@ -0,0 +1,10 @@
+import { cosmiconfig } from 'cosmiconfig';
+import { InitialOptions } from '../types/index.mjs';
+import { Result } from '../types/Result.mjs';
+type CosmiconfigLoaded = NonNullable<Awaited<ReturnType<ReturnType<typeof cosmiconfig>["search"]>>>;
+export declare const loadWebfontConfig: (options: {
+    configFile?: string;
+}) => Promise<CosmiconfigLoaded | Record<string, never>>;
+type Webfont = (_initialOptions?: InitialOptions) => Promise<Result>;
+export declare const webfont: Webfont;
+export default webfont;

package/dist/src/standalone/inputMode.d.mts

@@ -0,0 +1,9 @@
+import { Format } from '../types/Format.mjs';
+export type InputMode = "empty" | "mixed" | "svg" | "ttf" | "webfont";
+export declare const classifyInputFiles: (filePaths: readonly string[]) => InputMode;
+export declare const assertSvgPipelineFormats: (formats: readonly Format[]) => void;
+export declare const filterInputFilesByMode: (filePaths: readonly string[], mode: InputMode) => string[];
+export type ConversionFormat = "otf" | "ttf";
+export type TtfEncodeFormat = "eot" | "ttf" | "woff" | "woff2";
+export declare const resolveTtfConversionFormats: (formats: readonly Format[]) => TtfEncodeFormat[];
+export declare const resolveWebfontConversionFormats: (formats: readonly Format[]) => ConversionFormat[];

package/dist/src/standalone/options.d.mts

@@ -0,0 +1,5 @@
+import { InitialOptions } from '../types/InitialOptions.mjs';
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+type OptionsGetter = (_initialOptions?: InitialOptions) => WebfontOptions;
+export declare const getOptions: OptionsGetter;
+export {};

package/dist/src/standalone/optionsFromGlyphs.d.mts

@@ -0,0 +1,3 @@
+import { WebfontFromGlyphsOptions } from '../types/WebfontFromGlyphsOptions.mjs';
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+export declare const getOptionsFromGlyphs: (initialOptions: WebfontFromGlyphsOptions) => WebfontOptions;

package/dist/src/standalone/renderTemplates.d.mts

@@ -0,0 +1,10 @@
+import { Format } from '../types/Format.mjs';
+import { RenderedTemplate } from '../types/RenderedTemplate.mjs';
+import { Result } from '../types/Result.mjs';
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+type RenderTemplatesResult = {
+    templates: RenderedTemplate[];
+    usedBuildInTemplate: boolean;
+};
+export declare const renderTemplates: (options: WebfontOptions, result: Pick<Result, "glyphsData" | "hash"> & Partial<Result>, formats: readonly Format[]) => RenderTemplatesResult;
+export {};

package/dist/src/standalone/runSvgPipeline.d.mts

@@ -0,0 +1,3 @@
+import { GlyphData, WebfontOptions } from '../types/index.mjs';
+import { Result } from '../types/Result.mjs';
+export declare const runSvgPipeline: (glyphsData: GlyphData[], options: WebfontOptions) => Promise<Result>;

package/dist/src/standalone/templateFonts.d.mts

@@ -0,0 +1,3 @@
+import { Format } from '../types/Format.mjs';
+import { Result } from '../types/Result.mjs';
+export declare const getTemplateFontBase64: (format: Format, result: Result) => string;

package/dist/src/standalone/toTtf.d.mts

@@ -0,0 +1,4 @@
+import { default as svg2ttf } from 'svg2ttf';
+export type ToTtfOptions = Parameters<typeof svg2ttf>[1];
+declare const toTtf: (svgFontString: string, options?: ToTtfOptions) => Buffer;
+export default toTtf;

package/dist/src/standalone/validateWebfontOptions.d.mts

@@ -0,0 +1,6 @@
+import { WebfontOptions } from '../types/WebfontOptions.mjs';
+/**
+ * Runtime validation for merged webfont options (API, cosmiconfig, CLI).
+ * Rejects mis-typed or unknown format names before running a pipeline (#133).
+ */
+export declare const validateWebfontOptions: (options: WebfontOptions) => WebfontOptions;

package/dist/src/standalone/webfontFromGlyphs.d.mts

@@ -0,0 +1,3 @@
+import { Result } from '../types/Result.mjs';
+import { WebfontFromGlyphsOptions } from '../types/WebfontFromGlyphsOptions.mjs';
+export declare const webfontFromGlyphs: (initialOptions: WebfontFromGlyphsOptions) => Promise<Result>;

package/dist/src/types/DecompressedFont.d.mts

@@ -0,0 +1,5 @@
+export type DecompressedFont = {
+    source: string;
+    ttf?: Buffer;
+    otf?: Buffer;
+};

package/dist/src/types/Format.d.mts

@@ -0,0 +1,11 @@
+export type Format = "eot" | "otf" | "woff" | "woff2" | "svg" | "ttf";
+export type Formats = Array<Format>;
+type FormatOption = {
+    copyright?: string | null;
+    description?: string | null;
+    ts?: number | null;
+    url?: string | null;
+    version?: string | null;
+};
+export type FormatsOptions = Partial<Record<Format, FormatOption>>;
+export {};

package/dist/src/types/Format.d.ts

@@ -1,9 +1,11 @@
 export type Format = "eot" | "otf" | "woff" | "woff2" | "svg" | "ttf";
 export type Formats = Array<Format>;
 type FormatOption = {
-    copyright: null;
-    ts: null;
-    version: null;
+    copyright?: string | null;
+    description?: string | null;
+    ts?: number | null;
+    url?: string | null;
+    version?: string | null;
 };
 export type FormatsOptions = Partial<Record<Format, FormatOption>>;
 export {};

package/dist/src/types/GlyphContentTransformFn.d.mts

@@ -0,0 +1,2 @@
+import { GlyphData } from './GlyphData.mjs';
+export type GlyphContentTransformFn = (_glyph: GlyphData) => string | Promise<string>;

package/dist/src/types/GlyphData.d.mts

@@ -0,0 +1,6 @@
+import { GlyphMetadata } from './GlyphMetadata.mjs';
+export type GlyphData = {
+    contents: string;
+    metadata?: GlyphMetadata;
+    srcPath: string;
+};

package/dist/src/types/GlyphInput.d.mts

@@ -0,0 +1,6 @@
+export type GlyphInput = {
+    /** SVG source text. */
+    contents: string;
+    /** Logical path or filename used for metadata (defaults to `icon.svg`). */
+    srcPath?: string;
+};

package/dist/src/types/GlyphMetadata.d.mts

@@ -0,0 +1,10 @@
+export type GlyphMetadata = {
+    name: string;
+    /**
+     * @example
+     * ```
+     * obj.unicode = ["\u0001"]
+     * ```
+     */
+    unicode?: string[];
+};

package/dist/src/types/GlyphTransformFn.d.mts

@@ -0,0 +1,2 @@
+import { GlyphMetadata } from './GlyphMetadata.mjs';
+export type GlyphTransformFn = (_obj: GlyphMetadata) => GlyphMetadata | Promise<GlyphMetadata>;

package/dist/src/types/InitialOptions.d.mts

@@ -0,0 +1,12 @@
+import { GlyphContentTransformFn } from './GlyphContentTransformFn.mjs';
+import { GlyphTransformFn } from './GlyphTransformFn.mjs';
+import { MetadataProvider } from './MetadataProvider.mjs';
+import { OptionsBase } from './OptionsBase.mjs';
+import { TtfPostProcessFn } from './TtfPostProcessFn.mjs';
+export type InitialOptions = OptionsBase & {
+    files: string | Array<string>;
+    glyphContentTransformFn?: GlyphContentTransformFn;
+    glyphTransformFn?: GlyphTransformFn;
+    metadataProvider?: MetadataProvider;
+    ttfPostProcess?: TtfPostProcessFn;
+};

package/dist/src/types/InitialOptions.d.ts

@@ -2,9 +2,11 @@ import { GlyphContentTransformFn } from './GlyphContentTransformFn';
 import { GlyphTransformFn } from './GlyphTransformFn';
 import { MetadataProvider } from './MetadataProvider';
 import { OptionsBase } from './OptionsBase';
+import { TtfPostProcessFn } from './TtfPostProcessFn';
 export type InitialOptions = OptionsBase & {
     files: string | Array<string>;
     glyphContentTransformFn?: GlyphContentTransformFn;
     glyphTransformFn?: GlyphTransformFn;
     metadataProvider?: MetadataProvider;
+    ttfPostProcess?: TtfPostProcessFn;
 };

package/dist/src/types/MetadataProvider.d.mts

@@ -0,0 +1,5 @@
+export type FileMetadata = {
+    name: string;
+    unicode?: string | string[];
+};
+export type MetadataProvider = (srcPath: string, callback: (error: Error | null, metadata?: FileMetadata) => void) => void;

package/dist/src/types/OptionsBase.d.mts

@@ -0,0 +1,41 @@
+import { TemplateOption } from '../lib/parseTemplateOption.mjs';
+import { Formats, FormatsOptions } from './Format.mjs';
+import { SvgToolsOptions } from './SvgToolsOptions.mjs';
+export type OptionsBase = {
+    configFile?: string;
+    dest?: string;
+    destCreate?: boolean;
+    fontName?: string | unknown;
+    formats?: Formats;
+    formatsOptions?: FormatsOptions;
+    template?: TemplateOption;
+    templateClassName?: string | unknown;
+    templateFontPath?: string;
+    templateFontName?: string | unknown;
+    templateCacheString?: string | unknown;
+    destTemplate?: string | unknown;
+    verbose?: boolean;
+    fontId?: string | unknown;
+    fontStyle?: string | unknown;
+    fontWeight?: string | unknown;
+    fixedWidth?: string | unknown;
+    centerHorizontally?: boolean | unknown;
+    centerVertically?: boolean | unknown;
+    normalize?: boolean;
+    fontHeight?: string | unknown;
+    round?: string | number;
+    descent?: string | number;
+    ascent?: string;
+    startUnicode?: string | unknown;
+    prependUnicode?: boolean | unknown;
+    metadata?: unknown;
+    sort?: boolean;
+    ligatures?: boolean;
+    addHashInFontUrl?: boolean | unknown;
+    unicodeRange?: boolean | string | unknown;
+    optimizeSvg?: boolean | unknown;
+    svgoConfig?: unknown;
+    templateFontLigatures?: boolean | unknown;
+    /** Alpha. SVG diagnostics and optional pre-conversion fixes. */
+    svgTools?: SvgToolsOptions;
+};