@ctrliq/quantic-fonts 1.70.1 → 1.71.0

package/README.md

@@ -0,0 +1,35 @@
+# @ctrliq/quantic-fonts
+
+Packaged Quantic webfonts with helpers for registering them.
+
+## Registering fonts
+
+Each font exposes three registerers. Pick by rendering model:
+
+```ts
+import { inter, satoshi } from '@ctrliq/quantic-fonts';
+
+inter.inject(); // client-only: appends a <style> to document.head
+inter.css(); // server-rendered: returns @font-face text to inline
+inter.preload(); // returns <link rel=preload> attributes
+```
+
+Pass a filter to narrow which variants load. Without one you ship all 40 files:
+
+```ts
+const FILTER = { weights: [400, 500, 600], styles: ['normal', 'italic'] } as const;
+inter.css(FILTER);
+```
+
+## Serving the font files
+
+`css()` and `preload()` reference fonts at a fixed URL path, so the build must serve the
+packaged directory there. Both values come from the package:
+
+```ts
+import { FONT_ASSETS_URL_PATH, fontAssetsDir } from '@ctrliq/quantic-fonts/assets-dir';
+```
+
+`fontAssetsDir` is an absolute path to the `.woff2` files; `FONT_ASSETS_URL_PATH` is the
+URL they must be served at. Wire them with whatever your bundler provides — Vite and
+Astro use `vite-plugin-static-copy`, and other builds copy the directory directly.

package/dist/assets-dir.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Absolute path to the directory holding the packaged `.woff2` files.
+ *
+ * The generated `@font-face` rules and preload hints reference fonts at
+ * {@link FONT_ASSETS_URL_PATH}, so a consuming build must serve this directory
+ * there. Resolve it at build time and copy or alias it — every bundler has its
+ * own mechanism, but the source and destination are always these two values.
+ */
+export declare const fontAssetsDir: string;
+/** URL path that `css()` and `preload()` point at. */
+export declare const FONT_ASSETS_URL_PATH = "/assets";

package/dist/assets-dir.js

@@ -0,0 +1,16 @@
+import { fileURLToPath } from 'url';
+
+/**
+ * Absolute path to the directory holding the packaged `.woff2` files.
+ *
+ * The generated `@font-face` rules and preload hints reference fonts at
+ * {@link FONT_ASSETS_URL_PATH}, so a consuming build must serve this directory
+ * there. Resolve it at build time and copy or alias it — every bundler has its
+ * own mechanism, but the source and destination are always these two values.
+ */
+const fontAssetsDir = fileURLToPath(new URL('./assets', import.meta.url));
+/** URL path that `css()` and `preload()` point at. */
+const FONT_ASSETS_URL_PATH = '/assets';
+
+export { FONT_ASSETS_URL_PATH, fontAssetsDir };
+//# sourceMappingURL=assets-dir.js.map

package/dist/assets-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets-dir.js","sources":["../src/assets-dir.ts"],"sourcesContent":["import { fileURLToPath } from 'url';\n\n/**\n * Absolute path to the directory holding the packaged `.woff2` files.\n *\n * The generated `@font-face` rules and preload hints reference fonts at\n * {@link FONT_ASSETS_URL_PATH}, so a consuming build must serve this directory\n * there. Resolve it at build time and copy or alias it — every bundler has its\n * own mechanism, but the source and destination are always these two values.\n */\nexport const fontAssetsDir = fileURLToPath(new URL('./assets', import.meta.url));\n\n/** URL path that `css()` and `preload()` point at. */\nexport const FONT_ASSETS_URL_PATH = '/assets';\n"],"names":[],"mappings":";;AAEA;;;;;;;AAOG;AACI,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AAE/E;AACO,MAAM,oBAAoB,GAAG;;;;"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export * from './__generated__';
-export type * from './types';
+export type { FontFilter, FontRegisterer, FontRegisterers } from './types';

package/dist/register.d.ts

@@ -1,5 +1,5 @@
 import type { Font, FontRegisterer } from './types';
-export type { FontRegisterer, FontRegisterers } from './types';
+export type { FontFilter, FontRegisterer, FontRegisterers } from './types';
 export declare function buildRegisterers(font: Font): {
     readonly [x: string]: FontRegisterer;
 };

package/dist/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sources":["../src/register.ts"],"sourcesContent":["import type { Font, FontVariant, FontRegisterer, FontFilter } from './types';\nexport type { FontRegisterer, FontRegisterers } from './types';\n\nconst camelCase = (str: string) =>\n  str\n    .replace(/[-_ ]+(\\w)/g, (_, c) => c.toUpperCase())\n    .replace(/^./, (match) => match.toLowerCase());\n\nfunction getFontFaceId(name: string, variant: FontVariant) {\n  return `__ciq-font-${name}-${variant.weight}-${variant.style}`;\n}\n\nfunction getFontFace(name: string, variant: FontVariant) {\n  return `\n    @font-face {\n      font-family: '${name}';\n      font-style: ${variant.style};\n      font-weight: ${variant.weight};\n      src: url('${variant.file}') format('woff2');\n      font-display: swap;\n    }\n  `;\n}\n\nfunction preload(name: string, variant: FontVariant) {\n  return {\n    href: variant.file,\n    type: 'font/woff2',\n    as: 'font',\n    crossOrigin: 'anonymous',\n  };\n}\n\nfunction inject(name: string, variant: FontVariant) {\n  const { id } = variant;\n  const tagId = id ?? getFontFaceId(name, variant);\n\n  if (document.getElementById(tagId)) return;\n\n  const styleEl = document.createElement('style');\n  styleEl.id = tagId;\n  styleEl.textContent = getFontFace(name, variant);\n  document.head.appendChild(styleEl);\n}\n\nconst filterVariants = (variants: FontVariant[], filter?: FontFilter) => {\n  if (!filter) return variants;\n  return variants.filter((variant) => {\n    const matchesWeight =\n      !filter.weights || filter.weights.includes(variant.weight);\n    const matchesStyle =\n      !filter.styles || filter.styles.includes(variant.style);\n    return matchesWeight && matchesStyle;\n  });\n};\n\nexport function buildRegisterers(font: Font) {\n  const independent = Object.fromEntries(\n    font.variants.map((variant) => {\n      const { weight, style } = variant;\n      const id = [font.name, weight, style === 'normal' ? '' : style]\n        .filter(Boolean)\n        .join('-');\n      return [\n        camelCase(id),\n        {\n          css: () => getFontFace(font.name, variant),\n          preload: () => [preload(font.name, variant)],\n          inject: () => inject(font.name, variant),\n        } as FontRegisterer,\n      ];\n    })\n  );\n\n  const combined = {\n    [camelCase(font.name)]: {\n      css: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter)\n          .map((variant) => getFontFace(font.name, variant))\n          .join('\\n'),\n      preload: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter).map((variant) =>\n          preload(font.name, variant)\n        ),\n      inject: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter).forEach((variant) =>\n          inject(font.name, variant)\n        ),\n    } as FontRegisterer,\n  };\n\n  return {\n    ...independent,\n    ...combined,\n  } as const;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"register.js","sources":["../src/register.ts"],"sourcesContent":["import type { Font, FontVariant, FontRegisterer, FontFilter } from './types';\nexport type { FontFilter, FontRegisterer, FontRegisterers } from './types';\n\nconst camelCase = (str: string) =>\n  str\n    .replace(/[-_ ]+(\\w)/g, (_, c) => c.toUpperCase())\n    .replace(/^./, (match) => match.toLowerCase());\n\nfunction getFontFaceId(name: string, variant: FontVariant) {\n  return `__ciq-font-${name}-${variant.weight}-${variant.style}`;\n}\n\nfunction getFontFace(name: string, variant: FontVariant) {\n  return `\n    @font-face {\n      font-family: '${name}';\n      font-style: ${variant.style};\n      font-weight: ${variant.weight};\n      src: url('${variant.file}') format('woff2');\n      font-display: swap;\n    }\n  `;\n}\n\nfunction preload(name: string, variant: FontVariant) {\n  return {\n    href: variant.file,\n    type: 'font/woff2',\n    as: 'font',\n    crossOrigin: 'anonymous',\n  };\n}\n\nfunction inject(name: string, variant: FontVariant) {\n  const { id } = variant;\n  const tagId = id ?? getFontFaceId(name, variant);\n\n  if (document.getElementById(tagId)) return;\n\n  const styleEl = document.createElement('style');\n  styleEl.id = tagId;\n  styleEl.textContent = getFontFace(name, variant);\n  document.head.appendChild(styleEl);\n}\n\nconst filterVariants = (variants: FontVariant[], filter?: FontFilter) => {\n  if (!filter) return variants;\n  return variants.filter((variant) => {\n    const matchesWeight =\n      !filter.weights || filter.weights.includes(variant.weight);\n    const matchesStyle =\n      !filter.styles || filter.styles.includes(variant.style);\n    return matchesWeight && matchesStyle;\n  });\n};\n\nexport function buildRegisterers(font: Font) {\n  const independent = Object.fromEntries(\n    font.variants.map((variant) => {\n      const { weight, style } = variant;\n      const id = [font.name, weight, style === 'normal' ? '' : style]\n        .filter(Boolean)\n        .join('-');\n      return [\n        camelCase(id),\n        {\n          css: () => getFontFace(font.name, variant),\n          preload: () => [preload(font.name, variant)],\n          inject: () => inject(font.name, variant),\n        } as FontRegisterer,\n      ];\n    })\n  );\n\n  const combined = {\n    [camelCase(font.name)]: {\n      css: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter)\n          .map((variant) => getFontFace(font.name, variant))\n          .join('\\n'),\n      preload: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter).map((variant) =>\n          preload(font.name, variant)\n        ),\n      inject: (filter?: FontFilter) =>\n        filterVariants(font.variants, filter).forEach((variant) =>\n          inject(font.name, variant)\n        ),\n    } as FontRegisterer,\n  };\n\n  return {\n    ...independent,\n    ...combined,\n  } as const;\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctrliq/quantic-fonts",
-  "version": "1.70.1",
+  "version": "1.71.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -12,18 +12,24 @@
       "import": "./dist/index.js",
       "require": "./dist/index.js"
     },
+    "./assets-dir": {
+      "types": "./dist/assets-dir.d.ts",
+      "import": "./dist/assets-dir.js"
+    },
     "./assets": "./dist/assets",
     "./assets/*": "./dist/assets/*"
   },
   "types": "./dist/index.d.ts",
   "type": "module",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "devDependencies": {
     "@rollup/plugin-node-resolve": "16.0.3",
     "@rollup/plugin-typescript": "12.3.0",
     "@rollup/plugin-url": "^8.0.2",
+    "@types/node": "22.20.1",
     "rollup": "4.62.2",
     "typescript": "5.9.3"
   },