@lediv/fonts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EMYL LABS, SL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# @lediv/fonts
+
+Variable web font assets and utilities for Lediv projects. Includes 20 curated fonts (Inter, Roboto Flex, Playfair Display, JetBrains Mono, and more) pre-bundled as WOFF2 files, with helpers for CSS `@font-face` generation, preload link tags, and Vite integration.
+
+## Install
+
+```sh
+npm install @lediv/fonts
+```
+
+## Entry points
+
+| Import path         | Environment | Description                                    |
+| ------------------- | ----------- | ---------------------------------------------- |
+| `@lediv/fonts`      | any         | Font catalog, CSS helpers, used-font detection |
+| `@lediv/fonts/node` | Node.js     | Resolves local WOFF2 file paths on disk        |
+| `@lediv/fonts/vite` | Vite        | Dev-server middleware + build output plugin    |
+
+## Usage
+
+### Font catalog
+
+```ts
+import { CUSTOM_FONTS, getFontById, CUSTOM_FONT_PATHS } from '@lediv/fonts';
+
+const inter = getFontById('inter');
+```
+
+### Generate CSS
+
+```ts
+import { buildFontFaceCSS, buildFontFaceCSSAll, buildFontPreloadLinks } from '@lediv/fonts';
+
+const css = buildFontFaceCSSAll(CUSTOM_FONTS);
+const preload = buildFontPreloadLinks([inter]);
+```
+
+### Detect used fonts
+
+```ts
+import { getUsedFonts } from '@lediv/fonts';
+
+const used = getUsedFonts(htmlString);
+```
+
+Scans `<style>` blocks and inline `style` attributes in the given HTML string for any `font-family` references matching the catalog.
+
+### Vite plugin (dev + build)
+
+```ts
+import { serveFonts } from '@lediv/fonts/vite';
+
+export default {
+  plugins: [serveFonts()],
+};
+```
+
+`serveFonts()` serves `/fonts/:id/latin-wght-normal.woff2` requests in dev and copies all font files to the output directory on build.
+
+### Node file paths
+
+```ts
+import { getFontFilePath } from '@lediv/fonts/node';
+import { getFontById } from '@lediv/fonts';
+
+const path = getFontFilePath(getFontById('inter'));
+```
+
+## Types
+
+```ts
+import type { CustomFont } from '@lediv/fonts';
+```
+
+| Field      | Type      | Description                                    |
+| ---------- | --------- | ---------------------------------------------- |
+| `id`       | `string`  | URL-safe identifier, e.g. `inter`              |
+| `label`    | `string`  | Display name, e.g. `Inter`                     |
+| `fontName` | `string`  | CSS `font-family` value, e.g. `Inter Variable` |
+| `weight`   | `string`  | Weight range, e.g. `100 900`                   |
+| `fallback` | `string?` | Generic fallback: `serif` or `monospace`       |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+//#region src/index.d.ts
+declare const UNICODE_RANGE_LATIN = "U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD";
+type CustomFont = {
+  label: string;
+  id: string;
+  fontName: string;
+  weight: string;
+  fallback?: string;
+};
+declare const CUSTOM_FONTS: CustomFont[];
+declare function buildFontFaceCSS(f: CustomFont): string;
+declare function buildFontFaceCSSAll(fonts: CustomFont[]): string;
+declare function buildFontPreloadLinks(fonts: CustomFont[]): string;
+declare function getUsedFonts(text: string): CustomFont[];
+declare function getFontById(id: string): CustomFont | undefined;
+declare const CUSTOM_FONT_PATHS: Set<string>;
+declare const CUSTOM_FONT_LOCAL_CSS: Record<string, string>;
+//#endregion
+export { CUSTOM_FONTS, CUSTOM_FONT_LOCAL_CSS, CUSTOM_FONT_PATHS, CustomFont, UNICODE_RANGE_LATIN, buildFontFaceCSS, buildFontFaceCSSAll, buildFontPreloadLinks, getFontById, getUsedFonts };

package/dist/index.js

@@ -0,0 +1,4 @@
+const e=`U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD`,t=[{label:`Inter`,id:`inter`,fontName:`Inter Variable`,weight:`100 900`},{label:`Open Sans`,id:`open-sans`,fontName:`Open Sans Variable`,weight:`300 800`},{label:`Roboto Flex`,id:`roboto-flex`,fontName:`Roboto Flex Variable`,weight:`100 1000`},{label:`Montserrat`,id:`montserrat`,fontName:`Montserrat Variable`,weight:`100 900`},{label:`Raleway`,id:`raleway`,fontName:`Raleway Variable`,weight:`100 900`},{label:`DM Sans`,id:`dm-sans`,fontName:`DM Sans Variable`,weight:`100 1000`},{label:`Plus Jakarta Sans`,id:`plus-jakarta-sans`,fontName:`Plus Jakarta Sans Variable`,weight:`200 800`},{label:`Space Grotesk`,id:`space-grotesk`,fontName:`Space Grotesk Variable`,weight:`300 700`},{label:`Outfit`,id:`outfit`,fontName:`Outfit Variable`,weight:`100 900`},{label:`Nunito`,id:`nunito`,fontName:`Nunito Variable`,weight:`200 1000`},{label:`Work Sans`,id:`work-sans`,fontName:`Work Sans Variable`,weight:`100 900`},{label:`Quicksand`,id:`quicksand`,fontName:`Quicksand Variable`,weight:`300 700`},{label:`Rubik`,id:`rubik`,fontName:`Rubik Variable`,weight:`300 900`},{label:`Sora`,id:`sora`,fontName:`Sora Variable`,weight:`100 800`},{label:`Playfair Display`,id:`playfair-display`,fontName:`Playfair Display Variable`,weight:`400 900`,fallback:`serif`},{label:`Lora`,id:`lora`,fontName:`Lora Variable`,weight:`400 700`,fallback:`serif`},{label:`Source Serif 4`,id:`source-serif-4`,fontName:`Source Serif 4 Variable`,weight:`200 900`,fallback:`serif`},{label:`EB Garamond`,id:`eb-garamond`,fontName:`EB Garamond Variable`,weight:`400 800`,fallback:`serif`},{label:`JetBrains Mono`,id:`jetbrains-mono`,fontName:`JetBrains Mono Variable`,weight:`100 800`,fallback:`monospace`},{label:`Fira Code`,id:`fira-code`,fontName:`Fira Code Variable`,weight:`300 700`,fallback:`monospace`}];function n(t){return`@font-face{font-family:'${t.fontName}';font-style:normal;font-display:swap;font-weight:${t.weight};src:url('/fonts/${t.id}/latin-wght-normal.woff2') format('woff2-variations');unicode-range:${e}}`}function r(e){return e.map(n).join(`
+`)}function i(e){return e.map(e=>`<link rel="preload" as="font" type="font/woff2" href="/fonts/${e.id}/latin-wght-normal.woff2" crossorigin>`).join(`
+`)}function a(e){let t=[],n=/<style\b[^>]*>([\s\S]*?)<\/style\s*>/gi,r=/\sstyle\s*=\s*(["'])([\s\S]*?)\1/gi,i;for(;i=n.exec(e);)t.push(i[1]);for(;i=r.exec(e);)t.push(i[2]);return t.join(`
+`)}function o(e){return e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)}function s(e){let n=a(e);return n?t.filter(e=>{let t=o(e.fontName).replace(/\s+/g,`\\s+`);return RegExp(`['"]${t}['"]`,`i`).test(n)}):[]}function c(e){return t.find(t=>t.id===e)}const l=new Set(t.map(e=>`/fonts/${e.id}/latin-wght-normal.woff2`)),u=Object.fromEntries(t.map(e=>[e.fontName,n(e)]));export{t as CUSTOM_FONTS,u as CUSTOM_FONT_LOCAL_CSS,l as CUSTOM_FONT_PATHS,e as UNICODE_RANGE_LATIN,n as buildFontFaceCSS,r as buildFontFaceCSSAll,i as buildFontPreloadLinks,c as getFontById,s as getUsedFonts};

package/dist/node.d.ts

@@ -0,0 +1,5 @@
+import { CustomFont } from "./index.js";
+//#region src/node.d.ts
+declare function getFontFilePath(font: CustomFont): string;
+//#endregion
+export { getFontFilePath };

package/dist/node.js

@@ -0,0 +1 @@
+import{dirname as e,join as t}from"node:path";import{fileURLToPath as n}from"node:url";const r=e(n(import.meta.url));function i(e){return t(r,`..`,`fonts`,e.id,`latin-wght-normal.woff2`)}export{i as getFontFilePath};

package/dist/vite.d.ts

@@ -0,0 +1,5 @@
+import { Plugin } from "vite";
+//#region src/vite.d.ts
+declare function serveFonts(): Plugin;
+//#endregion
+export { serveFonts };

package/dist/vite.js

@@ -0,0 +1 @@
+import{CUSTOM_FONTS as e,getFontById as t}from"./index.js";import{getFontFilePath as n}from"./node.js";import{dirname as r,join as i}from"node:path";import{copyFileSync as a,mkdirSync as o,readFileSync as s}from"node:fs";function c(){return{name:`serve-lediv-fonts`,configureServer(e){e.middlewares.use((e,r,i)=>{let a=(e.url?.split(`?`)[0]||`/`).match(/^\/fonts\/([^/]+)\/latin-wght-normal\.woff2$/);if(!a)return i();let o=t(a[1]);if(!o)return i();try{let e=s(n(o));r.setHeader(`Content-Type`,`font/woff2`),r.setHeader(`Cache-Control`,`public, max-age=31536000, immutable`),r.statusCode=200,r.end(e)}catch{i()}})},writeBundle(t){let s=t.dir;if(s)for(let t of e){let e=n(t),c=i(s,`fonts`,t.id,`latin-wght-normal.woff2`);o(r(c),{recursive:!0}),a(e,c)}}}}export{c as serveFonts};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@lediv/fonts",
+  "version": "0.1.0",
+  "description": "Web font assets and utilities for Lediv projects",
+  "keywords": [
+    "lediv",
+    "fonts",
+    "variable-fonts",
+    "woff2",
+    "vite",
+    "css"
+  ],
+  "license": "MIT",
+  "author": "EMYL LABS, SL",
+  "homepage": "https://lediv.com",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "fonts/",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js",
+      "default": "./dist/vite.js"
+    }
+  },
+  "types": "dist/index.d.ts",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "fontkit": "^2.0.4",
+    "typescript": "^6.0.0",
+    "vite": "^8.0.0",
+    "wawoff2": "^2.0.1"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}