webfont 12.0.0 → 12.1.0

package/dist/index.js

@@ -1 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,a)=>(a=n==null?{}:e(i(n)),s(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let l=require("cosmiconfig"),u=require("crypto");u=c(u);let d=require("deepmerge");d=c(d);let f=require("nunjucks");f=c(f);let p=require("path");p=c(p);let m=require("stream"),h=require("ttf2woff");h=c(h);let g=require("wawoff2");g=c(g);let _=require("globby"),v=require("svgicons2svgfont"),y=require("ttf2eot");y=c(y);let b=require("fontverter");b=c(b);let x=require("fs/promises");x=c(x);let S=require("fs"),C=require("xml2js");C=c(C);let w=require("p-limit");w=c(w);let T=require("svg2ttf");T=c(T);var E=()=>p.default.resolve(__dirname,`../templates`),D=e=>`${E()}/template.${e}.njk`,O=()=>{let e=E();return{css:{path:p.default.join(e,`template.css.njk`)},html:{path:p.default.join(e,`template.html.njk`)},json:{path:p.default.join(e,`template.json.njk`)},scss:{path:p.default.join(e,`template.scss.njk`)},styl:{path:p.default.join(e,`template.styl.njk`)}}},k=/^https?:\/\//iu,A=e=>k.test(e),j=e=>{if(A(e))try{return p.default.extname(new URL(e).pathname).toLowerCase()}catch{return``}return p.default.extname(e).toLowerCase()},M=async e=>(await Promise.all(e.map(e=>A(e)?Promise.resolve([e]):(0,_.globby)(e)))).flat(),ee=e=>({prependUnicode:!!e.prependUnicode,startUnicode:Number(e.startUnicode)}),te=e=>({ascent:e.ascent,centerHorizontally:e.centerHorizontally,descent:e.descent,fixedWidth:e.fixedWidth,fontHeight:e.fontHeight,fontId:e.fontId,fontName:e.fontName,fontStyle:e.fontStyle,fontWeight:e.fontWeight,metadata:e.metadata,normalize:e.normalize,round:e.round}),ne=e=>Buffer.from((0,y.default)(e)),N=1330926671,P=1953658213,F=65536,I=e=>{if(e.length<4)throw Error(`SFNT buffer is too short to read flavor`);let t=e.readUInt32BE(0);if(t===N)return`otf`;if(t===P||t===F)return`ttf`;throw Error(`Unsupported SFNT flavor 0x${t.toString(16)}`)},L=o(((e,t)=>{t.exports=function(e){return!e||e.length<8?!1:e[0]===119&&e[1]===79&&e[2]===70&&e[3]===70&&e[4]===0&&e[5]===1&&e[6]===0&&e[7]===0||e[4]===79&&e[5]===84&&e[6]===84&&e[7]===79}})),R=o(((e,t)=>{t.exports=function(e){return!e||e.length<8?!1:e[0]===119&&e[1]===79&&e[2]===70&&e[3]===50&&e[4]===0&&e[5]===1&&e[6]===0&&e[7]===0}})),z=c(L()),B=c(R()),V=(e,t)=>{let n=j(t);if(n===`.woff2`&&!(0,B.default)(e))throw Error(`URL did not return a valid WOFF2 font: ${t}`);if(n===`.woff`&&!(0,z.default)(e))throw Error(`URL did not return a valid WOFF font: ${t}`);if(e.length===0)throw Error(`URL returned an empty response: ${t}`)},H=async e=>{let t;try{t=await fetch(e)}catch(t){let n=String(t);throw t instanceof Error&&(n=t.message),Error(`Failed to fetch font URL ${e}: ${n}`)}if(!t.ok)throw Error(`Failed to fetch font URL ${e}: HTTP ${t.status} ${t.statusText}`);let n=await t.arrayBuffer(),r=Buffer.from(n);return V(r,e),r},U=new Set([`.woff`,`.woff2`]),W=`.svg`,G=[`svg`,`ttf`,`eot`,`woff`,`woff2`],K=e=>e===W,q=e=>U.has(e),J=e=>K(e)||q(e),Y=e=>{if(e.length===0)return`empty`;let t=e.map(e=>j(e));if(!t.every(J))return`empty`;let n=t.some(K),r=t.some(q);return n&&r?`mixed`:r?`webfont`:n?`svg`:`empty`},X=e=>{if(e.includes(`otf`))throw Error(`OTF output is only supported when converting WOFF/WOFF2 input. Request "ttf" for SVG icons, or pass a .woff/.woff2 file.`)},Z=(e,t)=>t===`svg`?e.filter(e=>j(e)===W):t===`webfont`?e.filter(e=>U.has(j(e))):[],re=e=>{let t=e.filter(e=>e===`ttf`||e===`otf`);if(e.length===G.length&&G.every(t=>e.includes(t)))return[`ttf`];if(t.length===0)throw Error(`formats must include "ttf" and/or "otf" when converting WOFF/WOFF2 input`);return[...new Set(t)]},ie=e=>{if(e.length===0)throw Error(`No WOFF or WOFF2 files matched`)},ae=e=>{if(e.template)throw Error(`Templates are not supported when converting WOFF/WOFF2 input`);if(e.glyphTransformFn)throw Error(`glyphTransformFn is not supported when converting WOFF/WOFF2 input`)},oe=e=>{let{decompressed:t,sfnt:n,format:r,flavor:i,source:a}=e;if(r===`ttf`&&i!==`ttf`)throw Error(`Input decompresses to OpenType (OTF). Request "otf" format instead of "ttf" for ${a}.`);if(r===`otf`&&i!==`otf`)throw Error(`Input decompresses to TrueType (TTF). Request "ttf" format instead of "otf" for ${a}.`);if(r===`ttf`){t.ttf=n;return}t.otf=n},se=e=>A(e)?H(e):x.readFile(e),ce=async(e,t,n)=>{n&&console.log(`Decompressing ${e}...`);let r=await se(e),i=Buffer.from(await b.default.convert(r,`sfnt`)),a=I(i),o={source:e};for(let n of t)oe({decompressed:o,sfnt:i,format:n,flavor:a,source:e});return o},le=async(e,t)=>{ae(t),ie(e);let n=re(t.formats),r=await Promise.all(e.map(e=>ce(e,n,t.verbose))),i={config:{...t},decompressedFonts:r};return r.length===1&&(i.ttf=r[0].ttf,i.otf=r[0].otf),i},ue=w.default,de=e=>e===void 0?[]:Array.isArray(e)?e:[e],fe=e=>({name:e.name,unicode:de(e.unicode)}),pe=(e,t)=>{let n=t.metadataProvider||(0,v.getMetadataService)(ee(t)),r=new C.default.Parser,i=ue(t.maxConcurrency);return Promise.all(e.map(e=>i(()=>new Promise((t,n)=>{let i=(0,S.createReadStream)(e),a=``;i.on(`error`,e=>n(e)).on(`data`,e=>{a+=e.toString()}).on(`end`,()=>a.length===0?n(Error(`Empty file ${e}`)):r.parseString(a,r=>r?n(r):t({contents:a,srcPath:e})))})))).then(e=>{let r=e;t.sort&&(r=e.sort((e,t)=>(0,v.fileSorter)(e.srcPath,t.srcPath)));let{ligatures:i}=t;return Promise.all(r.map(e=>new Promise((t,r)=>{n(e.srcPath,(n,a)=>{if(n)return r(n);if(!a)return r(Error(`Missing metadata for ${e.srcPath}`));let o=fe(a);return i&&o.unicode.push(a.name.replace(/-/gu,`_`)),e.metadata=o,t(e)})})))})},me=e=>{if(!e?.files)throw Error("You must pass webfont a `files` glob");return{centerHorizontally:!1,descent:0,fixedWidth:!1,fontHeight:void 0,fontId:void 0,fontName:`webfont`,fontStyle:``,fontWeight:``,formats:[`svg`,`ttf`,`eot`,`woff`,`woff2`],formatsOptions:{ttf:{copyright:null,ts:null,version:null}},ligatures:!0,maxConcurrency:100,metadata:void 0,normalize:!1,prependUnicode:!1,round:0x9184e72a000,sort:!0,startUnicode:59905,templateFontPath:`./`,verbose:!1,...e}},Q=(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`)},he=(e,t={})=>Buffer.from((0,T.default)(e,t).buffer),ge=e=>`filepath`in e,_e=async e=>{let t=(0,l.cosmiconfig)(`webfont`,{searchStrategy:`global`});if(e.configFile){let n=p.default.resolve(process.cwd(),e.configFile);return await t.load(n)??{}}return await t.search(process.cwd())??{}},ve=(e,t)=>{let n=``;return new Promise((r,i)=>{t.verbose&&console.log(`Generating SVG font...`);let a=new v.SVGIcons2SVGFontStream(te(t)).on(`finish`,()=>r(n)).on(`data`,e=>{n+=e}).on(`error`,e=>i(e));e.forEach(e=>{let t=new m.Readable;t.push(e.contents),t.push(null),t.metadata=e.metadata??{name:``,unicode:[]},a.write(t)}),a.end()})},ye=e=>ne(e),be=(e,t)=>Buffer.from((0,h.default)(e,t).buffer),xe=e=>g.default.compress(e),$=async e=>{let t=me(e);delete t.filePath;let n=await _e({configFile:t.configFile}),r;ge(n)&&(t=(0,d.default)(t,n.config,{arrayMerge:(e,t)=>t}),r=n.filepath);let i;i=Array.isArray(t.files)?t.files:[t.files];let a=await M(i),o=Y(a);if(o===`mixed`)throw Error(`Cannot mix SVG icons with WOFF/WOFF2 font files in the same run`);if(o===`empty`)throw Error(`Files glob patterns specified did not match any supported files`);if(o===`webfont`){let e=await le(Z(a,o),t);return r&&(e.config={...t,filePath:r}),e}X(t.formats);let s=await pe(Z(a,`svg`),t);if(t.glyphTransformFn){let e=t.glyphTransformFn,n=s.map(async t=>{let n=await e(t.metadata??{name:``,unicode:[]});return{...t,metadata:n}});s=await Promise.all(n)}let c={};t.formatsOptions?.ttf&&(c=t.formatsOptions.ttf);let l=await ve(s,t),m=he(l,c),h={glyphsData:s,hash:u.default.createHash(`md5`).update(l).digest(`hex`),svg:l,ttf:m},{formats:g}=t;if(g.includes(`eot`)&&(h.eot=ye(m)),g.includes(`woff`)){let e;typeof t.metadata==`string`&&(e=t.metadata),h.woff=be(m,{metadata:e})}if(g.includes(`woff2`)&&(h.woff2=Buffer.from(await xe(m))),t.template){let e=O(),n;if(Object.keys(e).includes(t.template)){h.usedBuildInTemplate=!0;let e=p.default.resolve(__dirname,`../..`);f.default.configure(e),n=D(t.template)}else{let e=p.default.resolve(t.template);f.default.configure(p.default.dirname(e)),n=p.default.resolve(e)}let r={};t.addHashInFontUrl&&(r={hash:h.hash});let i=d.default.all([{glyphs:h.glyphsData?.map(e=>e.metadata)??[]},t,{cacheString:t.templateCacheString||Date.now(),className:t.templateClassName||t.fontName,fontName:t.templateFontName||t.fontName,fontPath:t.templateFontPath.replace(/\/?$/u,`/`)},r,{fonts:Object.fromEntries(new Map(g.map(e=>[e,()=>Q(e,h)])))}]);h.template=f.default.render(n,i)}return g.includes(`svg`)||delete h.svg,g.includes(`ttf`)||delete h.ttf,g.includes(`otf`)||delete h.otf,r?h.config={...t,filePath:r}:h.config=t,h},Se=$;exports.default=Se,exports.webfont=$;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./parseTemplateOption-BmH_pcQh.js");let t=require("cosmiconfig"),n=require("deepmerge");n=e.r(n);let r=require("path");r=e.r(r);let i=require("globby"),a=require("fs/promises");a=e.r(a);let o=require("ttf2woff");o=e.r(o);let s=require("wawoff2");s=e.r(s);let c=require("ttf2eot");c=e.r(c);let l=require("fontverter");l=e.r(l);let u=require("fs"),d=require("xml2js");d=e.r(d);let f=require("p-limit");f=e.r(f);let p=require("svgicons2svgfont"),m=require("crypto");m=e.r(m);let ee=require("svgo"),te=require("stream"),h=require("svg2ttf");h=e.r(h);var ne=/^https?:\/\//iu,g=e=>ne.test(e),_=e=>{if(g(e))try{return r.default.extname(new URL(e).pathname).toLowerCase()}catch{return``}return r.default.extname(e).toLowerCase()},v=async e=>(await Promise.all(e.map(e=>g(e)?Promise.resolve([e]):(0,i.globby)(e)))).flat(),re=1330926671,ie=1953658213,ae=65536,y=e=>{if(e.length<4)throw Error(`SFNT buffer is too short to read flavor`);let t=e.readUInt32BE(0);if(t===re)return`otf`;if(t===ie||t===ae)return`ttf`;throw Error(`Unsupported SFNT flavor 0x${t.toString(16)}`)},oe=e=>Buffer.from((0,c.default)(e)),b=e=>oe(e),x=(e,t={})=>Buffer.from((0,o.default)(e,t).buffer),S=async e=>Buffer.from(await s.default.compress(e)),C=new Set([`.woff`,`.woff2`]),w=`.svg`,T=`.ttf`,E=[`svg`,`ttf`,`eot`,`woff`,`woff2`],D=e=>e===w,O=e=>e===T,k=e=>C.has(e),se=e=>D(e)||k(e)||O(e),ce=e=>{if(e.length===0)return`empty`;let t=e.map(e=>_(e));if(!t.every(se))return`empty`;let n=t.some(D),r=t.some(k),i=t.some(O);return[n,r,i].filter(Boolean).length>1?`mixed`:r?`webfont`:i?`ttf`:n?`svg`:`empty`},A=e=>{if(e.includes(`otf`))throw Error(`OTF output is only supported when converting WOFF/WOFF2 input. Request "ttf" for SVG icons, or pass a .woff/.woff2 file.`)},j=(e,t)=>t===`svg`?e.filter(e=>_(e)===w):t===`webfont`?e.filter(e=>C.has(_(e))):t===`ttf`?e.filter(e=>_(e)===T):[],M=new Set([`ttf`,`eot`,`woff`,`woff2`]),N=e=>{let t=e.filter(e=>M.has(e));if(e.length===E.length&&E.every(t=>e.includes(t)))return[`woff`,`woff2`];if(t.length===0)throw Error(`formats must include at least one of "ttf", "eot", "woff", or "woff2" when converting TTF input`);return[...new Set(t)]},P=e=>{let t=e.filter(e=>e===`ttf`||e===`otf`);if(e.length===E.length&&E.every(t=>e.includes(t)))return[`ttf`];if(t.length===0)throw Error(`formats must include "ttf" and/or "otf" when converting WOFF/WOFF2 input`);return[...new Set(t)]},F=e=>{if(e.length===0)throw Error(`No TTF files matched`)},I=e=>{if(e.template)throw Error(`Templates are not supported when converting TTF input`);if(e.glyphTransformFn)throw Error(`glyphTransformFn is not supported when converting TTF input`);if(e.glyphContentTransformFn)throw Error(`glyphContentTransformFn is not supported when converting TTF input`)},L=(e,t)=>{let n;try{n=y(e)}catch{throw Error(`Input is not a valid TrueType font: ${t}`)}if(n!==`ttf`)throw Error(`OpenType (OTF) input is not supported for webfont encoding. Use a .ttf file for ${t}.`)},R=async(e,t,n,r)=>{if(n===`ttf`){e.ttf=t;return}if(n===`eot`){e.eot=b(t);return}if(n===`woff`){let n;typeof r.metadata==`string`&&(n=r.metadata),e.woff=x(t,{metadata:n});return}e.woff2=await S(t)},z=async(e,t,n,r)=>{if(g(e))throw Error(`Remote TTF URLs are not supported. Download the file first: ${e}`);r&&console.log(`Encoding ${e}...`);let i=await a.readFile(e);L(i,e);let o={source:e};return await Promise.all(t.map(e=>R(o,i,e,n))),o},B=async(e,t)=>{I(t),F(e);let n=N(t.formats),r=await Promise.all(e.map(e=>z(e,n,t,t.verbose))),i={config:{...t},transcodedFonts:r};if(r.length===1){let[e]=r;i.ttf=e.ttf,i.eot=e.eot,i.woff=e.woff,i.woff2=e.woff2}return i},V=e.n(((e,t)=>{t.exports=function(e){return!e||e.length<8?!1:e[0]===119&&e[1]===79&&e[2]===70&&e[3]===70&&e[4]===0&&e[5]===1&&e[6]===0&&e[7]===0||e[4]===79&&e[5]===84&&e[6]===84&&e[7]===79}})),H=e.n(((e,t)=>{t.exports=function(e){return!e||e.length<8?!1:e[0]===119&&e[1]===79&&e[2]===70&&e[3]===50&&e[4]===0&&e[5]===1&&e[6]===0&&e[7]===0}})),U=e.r(V()),W=e.r(H()),G=(e,t)=>{let n=_(t);if(n===`.woff2`&&!(0,W.default)(e))throw Error(`URL did not return a valid WOFF2 font: ${t}`);if(n===`.woff`&&!(0,U.default)(e))throw Error(`URL did not return a valid WOFF font: ${t}`);if(e.length===0)throw Error(`URL returned an empty response: ${t}`)},le=async e=>{let t;try{t=await fetch(e)}catch(t){let n=String(t);throw t instanceof Error&&(n=t.message),Error(`Failed to fetch font URL ${e}: ${n}`)}if(!t.ok)throw Error(`Failed to fetch font URL ${e}: HTTP ${t.status} ${t.statusText}`);let n=await t.arrayBuffer(),r=Buffer.from(n);return G(r,e),r},ue=e=>{if(e.length===0)throw Error(`No WOFF or WOFF2 files matched`)},de=e=>{if(e.template)throw Error(`Templates are not supported when converting WOFF/WOFF2 input`);if(e.glyphTransformFn)throw Error(`glyphTransformFn is not supported when converting WOFF/WOFF2 input`);if(e.glyphContentTransformFn)throw Error(`glyphContentTransformFn is not supported when converting WOFF/WOFF2 input`)},fe=e=>{let{decompressed:t,sfnt:n,format:r,flavor:i,source:a}=e;if(r===`ttf`&&i!==`ttf`)throw Error(`Input decompresses to OpenType (OTF). Request "otf" format instead of "ttf" for ${a}.`);if(r===`otf`&&i!==`otf`)throw Error(`Input decompresses to TrueType (TTF). Request "ttf" format instead of "otf" for ${a}.`);if(r===`ttf`){t.ttf=n;return}t.otf=n},pe=e=>g(e)?le(e):a.readFile(e),me=async(e,t,n)=>{n&&console.log(`Decompressing ${e}...`);let r=await pe(e),i=Buffer.from(await l.default.convert(r,`sfnt`)),a=y(i),o={source:e};for(let n of t)fe({decompressed:o,sfnt:i,format:n,flavor:a,source:e});return o},he=async(e,t)=>{de(t),ue(e);let n=P(t.formats),r=await Promise.all(e.map(e=>me(e,n,t.verbose))),i={config:{...t},decompressedFonts:r};return r.length===1&&(i.ttf=r[0].ttf,i.otf=r[0].otf),i},ge=f.default,_e=e=>({prependUnicode:!!e.prependUnicode,startUnicode:Number(e.startUnicode)}),ve=e=>{if(e==null)return;if(typeof e==`number`)return Number.isFinite(e)?e:void 0;let t=e.trim();if(t.length===0)return;let n=Number(t);if(Number.isFinite(n))return n},ye=e=>({ascent:e.ascent,centerHorizontally:e.centerHorizontally,descent:e.descent,fixedWidth:e.fixedWidth,fontHeight:e.fontHeight,fontId:e.fontId,fontName:e.fontName,fontStyle:e.fontStyle,fontWeight:e.fontWeight,metadata:e.metadata,normalize:e.normalize,round:ve(e.round)}),be=e=>e===void 0?[]:Array.isArray(e)?e:[e],xe=e=>({name:e.name,unicode:be(e.unicode)}),Se=(e,t)=>{let n=t.metadataProvider||(0,p.getMetadataService)(_e(t)),r=new d.default.Parser,i=ge(t.maxConcurrency);return Promise.all(e.map(e=>i(()=>new Promise((t,n)=>{let i=(0,u.createReadStream)(e),a=``;i.on(`error`,e=>n(e)).on(`data`,e=>{a+=e.toString()}).on(`end`,()=>a.length===0?n(Error(`Empty file ${e}`)):r.parseString(a,r=>r?n(r):t({contents:a,srcPath:e})))})))).then(e=>{let r=e;t.sort&&(r=e.sort((e,t)=>(0,p.fileSorter)(e.srcPath,t.srcPath)));let{ligatures:i}=t;return Promise.all(r.map(e=>new Promise((t,r)=>{n(e.srcPath,(n,a)=>{if(n)return r(n);if(!a)return r(Error(`Missing metadata for ${e.srcPath}`));let o=xe(a);return i&&o.unicode.push(a.name.replace(/-/gu,`_`)),e.metadata=o,t(e)})})))})},Ce=()=>({centerHorizontally:!1,descent:0,fixedWidth:!1,fontHeight:void 0,fontId:void 0,fontName:`webfont`,fontStyle:``,fontWeight:``,formats:[`svg`,`ttf`,`eot`,`woff`,`woff2`],formatsOptions:{ttf:{copyright:null,ts:null,version:null}},ligatures:!1,maxConcurrency:100,metadata:void 0,normalize:!1,prependUnicode:!1,round:0x9184e72a000,sort:!0,startUnicode:59905,templateFontPath:`./`,unicodeRange:!1,verbose:!1}),we=e=>{if(!e?.files)throw Error("You must pass webfont a `files` glob");return{...Ce(),...e}},Te=()=>({multipass:!1,plugins:[`removeDoctype`,`removeXMLProcInst`,`removeComments`,`removeMetadata`,`removeEditorsNSData`,`removeDesc`,`cleanupAttrs`,`removeUnusedNS`]}),Ee=e=>{let t=Te();return e?{...t,...e,plugins:e.plugins??t.plugins}:t},De=(e,t,n)=>(0,ee.optimize)(e,{...Ee(n),path:t}).data,Oe=(e,t)=>e.map(e=>({...e,contents:De(e.contents,e.srcPath,t)})),ke=(e,t)=>t&&e>2e3,Ae=e=>`Warning: ${e} glyphs with ligatures enabled may cause severe browser slowdown or hangs (especially Firefox on Windows). Ligatures are off by default; enable only if needed: --ligatures or ligatures: true. See TROUBLESHOOTING.md and https://github.com/itgalaxy/webfont/issues/558`,je=/<glyph\b([^>/]*)(?:\/>|>)/giu,Me=/\bglyph-name=["']([^"']+)["']/iu,Ne=/\bd=["']([^"']*)["']/iu,Pe=e=>{let t=[];for(let n of e.matchAll(je)){let e=n[1]??``,r=Me.exec(e);r&&(Ne.exec(e)?.[1]??``).trim().length===0&&t.push(r[1])}return t},Fe=(e,t)=>{for(let n of t){let t=n.metadata?.name;if(t&&(e===t||e.startsWith(`${t}-`)))return n.srcPath}},Ie=(e,t)=>{let n=new Set,r=[];for(let i of e){let e=Fe(i,t),a=e??i;n.has(a)||(n.add(a),e?r.push(`${i} (${e})`):r.push(i))}return r.join(`; `)},Le=(e,t)=>{let n=Pe(e);if(n.length===0)return;let r=Ie(n,t);throw Error(`Empty glyph path(s) in SVG font output for: ${r}. Stroke-only SVGs (fill="none" with stroke) often produce empty glyphs because svgicons2svgfont does not convert strokes. Convert strokes to filled paths in your design tool, preprocess with glyphContentTransformFn (for example svg-outline-stroke), or run with --svg-diagnose for compatibility warnings. See TROUBLESHOOTING.md ("Stroke-only SVGs produce blank icons").`)},Re=/fill-rule\s*:\s*evenodd|fill-rule\s*=\s*["']evenodd["']/iu,ze=e=>Re.test(e),Be=/\bstroke\s*=|\bstroke\s*:/iu,Ve=/fill\s*=\s*["']none["']|fill\s*:\s*none/iu,He=/<(line|polyline|clipPath)\b/iu,Ue=e=>Be.test(e)?Ve.test(e):!1,We=e=>He.test(e),K=(e,t)=>{switch(e){case`evenodd-fill-rule`:return`[webfont:diagnose] ${t} uses fill-rule: evenodd. Icon fonts render glyphs with the nonzero fill rule, so holes and counter-shapes can disappear. See TROUBLESHOOTING.md ("Icon details missing after export").`;case`stroke-only`:return`[webfont:diagnose] ${t} uses stroke-based paths (fill="none"). svgicons2svgfont ignores stroke; outlines may render as solid shapes or lose detail. Preprocess with glyphContentTransformFn (for example svg-outline-stroke) before conversion. See TROUBLESHOOTING.md ("Icon details missing after export").`;case`unsupported-element`:return`[webfont:diagnose] ${t} contains <line>, <polyline>, or <clipPath>. These elements are poorly supported in icon fonts; results may differ from the browser preview. Convert to filled paths or preprocess with glyphContentTransformFn.`;default:return e}},q=(e,t)=>{let n=[];return ze(t)&&n.push({code:`evenodd-fill-rule`,message:K(`evenodd-fill-rule`,e),srcPath:e}),Ue(t)&&n.push({code:`stroke-only`,message:K(`stroke-only`,e),srcPath:e}),We(t)&&n.push({code:`unsupported-element`,message:K(`unsupported-element`,e),srcPath:e}),n},J=e=>e.flatMap(e=>q(e.srcPath,e.contents)),Ge=(e,t)=>t.diagnose?!0:!!(t.verbose&&e.code===`evenodd-fill-rule`),Ke=e=>{if(!e||!e.diagnose)return;let t={diagnose:!0};return e.onMessage&&(t.onMessage=e.onMessage),t},qe=(e,t,n={})=>{let r=Ke(t),i=J(e),{reporter:a,verbose:o=!1}=n;for(let e of i)Ge(e,{diagnose:r?.diagnose,verbose:o})&&a?.(e.message);let s=[];return r?.diagnose&&(s=i),{diagnostics:s,glyphs:e}},Je=(e,t,n={})=>{let{diagnostics:r,glyphs:i}=qe(e,t,n);return{diagnostics:r,glyphs:i}},Ye=(e,t)=>{let n=``;return new Promise((r,i)=>{t.verbose&&console.log(`Generating SVG font...`);let a=new p.SVGIcons2SVGFontStream(ye(t)).on(`finish`,()=>r(n)).on(`data`,e=>{n+=e}).on(`error`,e=>i(e));e.forEach(e=>{let t=new te.Readable;t.push(e.contents),t.push(null),t.metadata=e.metadata??{name:``,unicode:[]},a.write(t)}),a.end()})},Xe=(e,t={})=>Buffer.from((0,h.default)(e,t).buffer),Ze=e=>b(e),Qe=(e,t)=>x(e,t),Y=e=>S(e),$e=async(e,t)=>{let n=e=>{if(t.svgTools?.onMessage){t.svgTools.onMessage(e);return}(t.svgTools?.diagnose||t.verbose)&&console.log(e)},r=!!(t.svgTools?.onMessage||t.svgTools?.diagnose||t.verbose),i;r&&(i=n);let{diagnostics:a,glyphs:o}=Je(e,t.svgTools,{reporter:i,verbose:t.verbose}),s=o;if(t.optimizeSvg&&(s=Oe(s,t.svgoConfig)),t.glyphContentTransformFn){let e=t.glyphContentTransformFn;s=await Promise.all(s.map(async t=>{let n=await e(t);return{...t,contents:n}}))}if(t.glyphTransformFn){let e=t.glyphTransformFn;s=await Promise.all(s.map(async t=>{let n=await e(t.metadata??{name:``,unicode:[]});return{...t,metadata:n}}))}ke(s.length,t.ligatures)&&console.log(Ae(s.length));let c={};t.formatsOptions?.ttf&&(c=t.formatsOptions.ttf);let l=await Ye(s,t);Le(l,s);let u=Xe(l,c),d={config:t,glyphsData:s,hash:m.default.createHash(`md5`).update(l).digest(`hex`),svg:l,ttf:u};a.length>0&&(d.svgDiagnostics=a);let{formats:f}=t;if(f.includes(`eot`)&&(d.eot=Ze(u)),f.includes(`woff`)){let e;typeof t.metadata==`string`&&(e=t.metadata),d.woff=Qe(u,{metadata:e})}if(f.includes(`woff2`)&&(d.woff2=Buffer.from(await Y(u))),t.template){let{renderTemplates:e}=await Promise.resolve().then(()=>require("./renderTemplates-zCYCzeOt.js")),{templates:n,usedBuildInTemplate:r}=e(t,d,f);n.length>0&&(d.templates=n,d.template=n[0]?.content,d.usedBuildInTemplate=r)}return f.includes(`svg`)||delete d.svg,f.includes(`ttf`)||delete d.ttf,f.includes(`otf`)||delete d.otf,d},X=new Set([`eot`,`otf`,`svg`,`ttf`,`woff`,`woff2`]),et=[...X].join(`, `),tt=e=>{if(typeof e!=`string`||!X.has(e))throw Error(`Invalid format "${String(e)}". Expected one of: ${et}`);return e},nt=e=>{if(e.length===0)throw Error(`formats must not be empty`);return e.map(tt)},rt=e=>{if(!Array.isArray(e))throw Error(`formats must be an array of format names (e.g. ["woff2", "svg"])`);return nt(e)},Z=(e,t)=>{if(t!==void 0&&typeof t!=`string`)throw Error(`${e} must be a string`)},it=(e,t)=>{if(t!==void 0&&typeof t!=`boolean`&&typeof t!=`string`)throw Error(`${e} must be a boolean or string`)},Q=(e,t)=>{if(t!==void 0&&typeof t!=`boolean`)throw Error(`${e} must be a boolean`)},at=(e,t)=>{if(t!==void 0&&(typeof t!=`object`||!t||Array.isArray(t)))throw Error(`${e} must be an object`)},ot=e=>{if(typeof e==`string`){if(e.length===0)throw Error(`files must not be empty`);return}if(Array.isArray(e)){if(e.length===0)throw Error(`files must not be empty`);if(!e.every(e=>typeof e==`string`))throw Error(`files must be a string or an array of strings`);return}throw Error(`files must be a string or an array of strings`)},st=t=>(ot(t.files),t.formats=rt(t.formats),Z(`fontName`,t.fontName),it(`unicodeRange`,t.unicodeRange),Q(`optimizeSvg`,t.optimizeSvg),at(`svgoConfig`,t.svgoConfig),Q(`templateFontLigatures`,t.templateFontLigatures),t.template!==void 0&&e.t(t.template),Z(`templateFontPath`,t.templateFontPath),t),ct=e=>`filepath`in e,lt=async e=>{let n=(0,t.cosmiconfig)(`webfont`,{searchStrategy:`global`});if(e.configFile){let t=r.default.resolve(process.cwd(),e.configFile);return await n.load(t)??{}}return await n.search(process.cwd())??{}},$=async e=>{let t=we(e);delete t.filePath;let r=await lt({configFile:t.configFile}),i;ct(r)&&(t=(0,n.default)(t,r.config,{arrayMerge:(e,t)=>t}),i=r.filepath),t=st(t);let a;a=Array.isArray(t.files)?t.files:[t.files];let o=await v(a),s=ce(o);if(s===`mixed`)throw Error(`Cannot mix SVG icons, TTF fonts, and WOFF/WOFF2 files in the same run`);if(s===`empty`)throw Error(`Files glob patterns specified did not match any supported files`);if(s===`webfont`){let e=await he(j(o,s),t);return i&&(e.config={...t,filePath:i}),e}if(s===`ttf`){let e=await B(j(o,s),t);return i&&(e.config={...t,filePath:i}),e}A(t.formats);let c=await $e(await Se(j(o,`svg`),t),t);return i?c.config={...t,filePath:i}:c.config=t,c},ut=$;exports.default=ut,exports.diagnoseGlyphsData=J,exports.diagnoseSvgContents=q,exports.webfont=$;

package/dist/parseTemplateOption-5T7rSw5J.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { fileURLToPath as e } from "node:url";
+e(import.meta.url), e(new URL(".", import.meta.url));
+//#region src/lib/parseTemplateOption.ts
+var t = (e) => {
+	if (e == null) return [];
+	if (typeof e == "string") {
+		let t = e.trim();
+		if (t.length === 0) throw Error("template must not be empty");
+		return [t];
+	}
+	if (Array.isArray(e)) {
+		if (e.length === 0) throw Error("template must not be empty");
+		if (!e.every((e) => typeof e == "string" && e.trim().length > 0)) throw Error("template must be a string or an array of non-empty strings");
+		return e.map((e) => e.trim());
+	}
+	throw Error("template must be a string or an array of strings");
+};
+//#endregion
+export { t };

package/dist/parseTemplateOption-BmH_pcQh.js

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,a)=>(a=n==null?{}:e(i(n)),s(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),l=e=>{if(e==null)return[];if(typeof e==`string`){let t=e.trim();if(t.length===0)throw Error(`template must not be empty`);return[t]}if(Array.isArray(e)){if(e.length===0)throw Error(`template must not be empty`);if(!e.every(e=>typeof e==`string`&&e.trim().length>0))throw Error(`template must be a string or an array of non-empty strings`);return e.map(e=>e.trim())}throw Error(`template must be a string or an array of strings`)};Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});

package/dist/renderTemplates-DvRlS58E.mjs

@@ -0,0 +1,93 @@
+#!/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 a from "nunjucks";
+//#region templates/index.ts
+var o = () => r.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") }
+	};
+}, l = (e) => {
+	let t = 4;
+	return e > 65535 && (t = 6), e.toString(16).toUpperCase().padStart(t, "0");
+}, u = (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;
+}, d = (e) => {
+	let t = [];
+	for (let n of e) for (let e of n.unicode ?? []) {
+		let n = u(e);
+		n !== void 0 && t.push(n);
+	}
+	return t;
+}, f = (e) => {
+	let t = d(e);
+	if (t.length === 0) return;
+	let n = Math.min(...t), r = Math.max(...t);
+	return n === r ? `U+${l(n)}` : `U+${l(n)}-${l(r)}`;
+}, p = (e, t) => {
+	if (!(e === !1 || e === void 0)) return typeof e == "string" ? e : f(t);
+}, m = (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");
+}, h = (e, o, l) => {
+	let u = n(e.template);
+	if (u.length === 0) return {
+		templates: [],
+		usedBuildInTemplate: !1
+	};
+	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([
+		{ glyphs: _ },
+		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
+		},
+		g,
+		{ fonts: Object.fromEntries(new Map(l.map((e) => [e, () => m(e, o)]))) },
+		{ unicodeRange: p(e.unicodeRange, _) },
+		{ templateFontLigatures: e.templateFontLigatures !== !1 }
+	]);
+	for (let e of u) {
+		let n, i;
+		if (Object.keys(d).includes(e)) {
+			h = !0, i = e;
+			let o = r.resolve(t, "../..");
+			a.configure(o), n = s(e);
+		} else {
+			let t = r.resolve(e);
+			a.configure(r.dirname(t)), n = r.resolve(t);
+		}
+		f.push({
+			template: e,
+			content: a.render(n, v),
+			builtIn: i
+		});
+	}
+	return {
+		templates: f,
+		usedBuildInTemplate: h
+	};
+};
+//#endregion
+export { h as renderTemplates };

package/dist/renderTemplates-zCYCzeOt.js

@@ -0,0 +1 @@
+const e=require("./parseTemplateOption-BmH_pcQh.js");let t=require("deepmerge");t=e.r(t);let n=require("path");n=e.r(n);let r=require("nunjucks");r=e.r(r);var i=()=>n.default.resolve(__dirname,`../templates`),a=e=>`${i()}/template.${e}.njk`,o=()=>{let e=i();return{css:{path:n.default.join(e,`template.css.njk`)},html:{path:n.default.join(e,`template.html.njk`)},json:{path:n.default.join(e,`template.json.njk`)},scss:{path:n.default.join(e,`template.scss.njk`)},styl:{path:n.default.join(e,`template.styl.njk`)}}},s=e=>{let t=4;return e>65535&&(t=6),e.toString(16).toUpperCase().padStart(t,`0`)},c=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},l=e=>{let t=[];for(let n of e)for(let e of n.unicode??[]){let n=c(e);n!==void 0&&t.push(n)}return t},u=e=>{let t=l(e);if(t.length===0)return;let n=Math.min(...t),r=Math.max(...t);return n===r?`U+${s(n)}`:`U+${s(n)}-${s(r)}`},d=(e,t)=>{if(!(e===!1||e===void 0))return typeof e==`string`?e:u(t)},f=(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`)},p=(i,s,c)=>{let l=e.t(i.template);if(l.length===0)return{templates:[],usedBuildInTemplate:!1};let u=o(),p=[],m=!1,h={};i.addHashInFontUrl&&(h={hash:s.hash});let g=s.glyphsData?.map(e=>e.metadata).filter(e=>e!==void 0)??[],_=t.default.all([{glyphs:g},i,{cacheString:i.templateCacheString||Date.now(),className:i.templateClassName||i.fontName,fontFamily:i.templateFontName||i.fontName,fontPath:i.templateFontPath.replace(/\/?$/u,`/`),svgFontId:i.fontId||i.fontName},h,{fonts:Object.fromEntries(new Map(c.map(e=>[e,()=>f(e,s)])))},{unicodeRange:d(i.unicodeRange,g)},{templateFontLigatures:i.templateFontLigatures!==!1}]);for(let e of l){let t,i;if(Object.keys(u).includes(e)){m=!0,i=e;let o=n.default.resolve(__dirname,`../..`);r.default.configure(o),t=a(e)}else{let i=n.default.resolve(e);r.default.configure(n.default.dirname(i)),t=n.default.resolve(i)}p.push({template:e,content:r.default.render(t,_),builtIn:i})}return{templates:p,usedBuildInTemplate:m}};exports.renderTemplates=p;

package/dist/src/browser.d.ts

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

package/dist/src/index.d.ts

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

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

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

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

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

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

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

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

@@ -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.ts

@@ -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.ts

@@ -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/parseFormats.d.ts

@@ -0,0 +1,4 @@
+import { Format, Formats } from '../types/Format';
+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.ts

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

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

@@ -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/svgDiagnostics/diagnoseSvgContents.d.ts

@@ -0,0 +1,12 @@
+import { SvgGlyphDiagnostic } from '../../types/SvgToolsOptions';
+export declare const hasStrokeOnlySvg: (svgContents: string) => boolean;
+export declare const hasUnsupportedSvgElements: (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/svgFontOutput/emptyGlyphPaths.d.ts

@@ -0,0 +1,3 @@
+import { GlyphData } from '../../types/GlyphData';
+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.ts

@@ -0,0 +1,13 @@
+import { GlyphData } from '../../types/GlyphData';
+import { SvgGlyphDiagnostic } from '../../types/SvgToolsOptions';
+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.ts

@@ -0,0 +1,14 @@
+import { GlyphData } from '../../types/GlyphData';
+import { SvgGlyphDiagnostic, SvgToolsOptions } from '../../types/SvgToolsOptions';
+import { SvgToolsReporter } from './applySvgDiagnostics';
+export type { SvgToolsReporter } from './applySvgDiagnostics';
+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.ts

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

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

@@ -6,4 +6,9 @@ type MetadataServiceOptions = {
     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.ts

@@ -0,0 +1,11 @@
+import { MetadataProvider } from '../../types/MetadataProvider';
+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.ts

@@ -0,0 +1,4 @@
+import { GlyphMetadata } from '../types/GlyphMetadata';
+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/ttfEncode.d.ts

@@ -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.ts

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

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

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

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

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

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

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

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

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

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

@@ -1,5 +1,10 @@
+import { cosmiconfig } from 'cosmiconfig';
 import { InitialOptions } from '../types';
 import { Result } from '../types/Result';
+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.ts

@@ -1,7 +1,9 @@
 import { Format } from '../types/Format';
-export type InputMode = "empty" | "mixed" | "svg" | "webfont";
+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/optionsFromGlyphs.d.ts

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

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

@@ -0,0 +1,10 @@
+import { Format } from '../types/Format';
+import { RenderedTemplate } from '../types/RenderedTemplate';
+import { Result } from '../types/Result';
+import { WebfontOptions } from '../types/WebfontOptions';
+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.ts

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

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

@@ -0,0 +1,6 @@
+import { WebfontOptions } from '../types/WebfontOptions';
+/**
+ * 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.ts

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

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

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

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

@@ -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/InitialOptions.d.ts

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

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

@@ -1,11 +1,13 @@
+import { TemplateOption } from '../lib/parseTemplateOption';
 import { Formats } from './Format';
+import { SvgToolsOptions } from './SvgToolsOptions';
 export type OptionsBase = {
     configFile?: string;
     dest?: string;
     destCreate?: boolean;
     fontName?: string | unknown;
     formats?: Formats;
-    template?: "css" | string;
+    template?: TemplateOption;
     templateClassName?: string | unknown;
     templateFontPath?: string;
     templateFontName?: string | unknown;
@@ -28,4 +30,10 @@ export type OptionsBase = {
     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;
 };

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

@@ -0,0 +1,7 @@
+export type RenderedTemplate = {
+    /** Original template option (built-in name or custom path). */
+    template: string;
+    content: string;
+    /** Built-in template id when applicable (css, html, scss, …). */
+    builtIn?: string;
+};

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

@@ -1,18 +1,26 @@
 import { DecompressedFont } from './DecompressedFont';
 import { GlyphData } from './GlyphData';
+import { RenderedTemplate } from './RenderedTemplate';
 import { ResultConfig } from './ResultConfig';
+import { SvgGlyphDiagnostic } from './SvgToolsOptions';
+import { TranscodedFont } from './TranscodedFont';
 export type { DecompressedFont } from './DecompressedFont';
+export type { TranscodedFont } from './TranscodedFont';
 export type Result = {
     config?: ResultConfig;
     decompressedFonts?: DecompressedFont[];
+    transcodedFonts?: TranscodedFont[];
     eot?: Buffer;
     glyphsData?: Array<GlyphData>;
     hash?: string;
     otf?: Buffer;
     svg?: string | Buffer;
     template?: string;
+    templates?: RenderedTemplate[];
     ttf?: Buffer;
     usedBuildInTemplate?: boolean;
     woff?: Buffer;
     woff2?: Buffer;
+    /** Alpha. Populated when `svgTools.diagnose` is enabled. */
+    svgDiagnostics?: SvgGlyphDiagnostic[];
 };

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

@@ -0,0 +1,13 @@
+export type SvgDiagnosticCode = "evenodd-fill-rule" | "stroke-only" | "unsupported-element";
+export type SvgGlyphDiagnostic = {
+    code: SvgDiagnosticCode;
+    message: string;
+    srcPath: string;
+};
+/** Alpha. SVG diagnostics for the icon-font pipeline (see ADR 0011 — no bundled stroke-to-fill fixes). */
+export type SvgToolsOptions = {
+    /** Scan source SVGs for known icon-font incompatibilities and report warnings. */
+    diagnose?: boolean;
+    /** Optional sink for diagnostic log lines (for example a web worker or test spy). */
+    onMessage?: (message: string) => void;
+};

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

@@ -0,0 +1,7 @@
+export type TranscodedFont = {
+    source: string;
+    eot?: Buffer;
+    ttf?: Buffer;
+    woff?: Buffer;
+    woff2?: Buffer;
+};

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

@@ -0,0 +1,11 @@
+import { GlyphContentTransformFn } from './GlyphContentTransformFn';
+import { GlyphInput } from './GlyphInput';
+import { GlyphTransformFn } from './GlyphTransformFn';
+import { MetadataProvider } from './MetadataProvider';
+import { OptionsBase } from './OptionsBase';
+export type WebfontFromGlyphsOptions = OptionsBase & {
+    glyphs: GlyphInput[];
+    glyphContentTransformFn?: GlyphContentTransformFn;
+    glyphTransformFn?: GlyphTransformFn;
+    metadataProvider?: MetadataProvider;
+};

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

@@ -1,7 +1,11 @@
+import { Config as SvgoConfig } from 'svgo';
+import { TemplateOption } from '../lib/parseTemplateOption';
 import { Formats, FormatsOptions } from './Format';
+import { GlyphContentTransformFn } from './GlyphContentTransformFn';
 import { GlyphTransformFn } from './GlyphTransformFn';
 import { InitialOptions } from './InitialOptions';
 import { MetadataProvider } from './MetadataProvider';
+import { SvgToolsOptions } from './SvgToolsOptions';
 export interface WebfontOptions extends InitialOptions {
     centerHorizontally: boolean;
     descent: number;
@@ -14,20 +18,26 @@ export interface WebfontOptions extends InitialOptions {
     formats: Formats;
     formatsOptions: FormatsOptions;
     glyphTransformFn?: GlyphTransformFn;
+    glyphContentTransformFn?: GlyphContentTransformFn;
     ligatures: boolean;
     maxConcurrency: number;
     metadata: unknown;
     metadataProvider?: MetadataProvider;
     normalize: boolean;
     prependUnicode: boolean;
-    round: number;
+    round: string | number;
     sort: boolean;
     startUnicode: number;
-    template?: string;
+    template?: TemplateOption;
     templateCacheString?: unknown;
     templateClassName?: unknown;
     templateFontName?: unknown;
     templateFontPath: string;
     verbose: boolean;
     addHashInFontUrl?: boolean;
+    unicodeRange?: boolean | string;
+    optimizeSvg?: boolean;
+    svgoConfig?: SvgoConfig;
+    templateFontLigatures?: boolean;
+    svgTools?: SvgToolsOptions;
 }

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

@@ -1,4 +1,5 @@
-export type { Format } from '../types/Format';
+export type { Format, FormatsOptions } from '../types/Format';
+export type { GlyphContentTransformFn } from './GlyphContentTransformFn';
 export type { GlyphData } from './GlyphData';
 export type { GlyphMetadata } from './GlyphMetadata';
 export type { GlyphTransformFn } from './GlyphTransformFn';