@nubisco/ui 1.39.1 → 1.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubisco/ui",
-  "version": "1.39.1",
+  "version": "1.41.0",
   "description": "Vue 3 UI component library",
   "packageManager": "pnpm@11.0.8",
   "repository": {
@@ -109,11 +109,19 @@
     "*.{json,md,mts,mjs,scss}": "prettier --write"
   },
   "peerDependencies": {
+    "pixi.js": "^8.0.0",
     "vue": "^3.5.30",
     "vue-i18n": "^11.3.0"
   },
+  "peerDependenciesMeta": {
+    "pixi.js": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@fontsource/fira-code": "^5.2.7",
+    "@fontsource/plus-jakarta-sans": "^5.2.8",
     "@phosphor-icons/core": "^2.1.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
@@ -129,6 +137,7 @@
     "lint-staged": "^16.4.0",
     "markdown-it-container": "^4.0.0",
     "mermaid": "^11.13.0",
+    "pixi.js": "^8.19.0",
     "prettier": "^3.8.1",
     "sass-embedded": "^1.98.0",
     "semantic-release": "^25.0.3",

package/src/plugins/fonts.ts

@@ -1,19 +1,71 @@
 import Unfonts from 'unplugin-fonts/vite'
 
-export const fonts = () =>
-  Unfonts({
-    google: {
-      injectTo: 'head-prepend',
+/**
+ * Options accepted by {@link fonts}. This is the exact option object that
+ * `unplugin-fonts` exposes, so any provider it supports (`fontsource`,
+ * `custom`, `google`, `typekit`) can be configured here.
+ */
+export type TFontsOptions = NonNullable<Parameters<typeof Unfonts>[0]>
 
-      families: [
-        {
-          name: 'Plus+Jakarta+Sans',
-          styles: 'ital,wght@0,200..800;1,200..800',
-        },
-        {
-          name: 'Fira+Code',
-          styles: 'wght@300..700',
-        },
-      ],
-    },
-  })
+/**
+ * Default font configuration for NubiscoUI.
+ *
+ * Self-hosted via the `fontsource` provider (RGPD-friendly, no third-party
+ * CDN). These are the two families declared as the library defaults in
+ * `src/styles/variables/_type.scss` (`--nb-font-family-sans` / `-mono`):
+ *
+ * - Plus Jakarta Sans: weights 400, 500, 600, 700 (sans default)
+ * - Fira Code: weights 400, 600 (mono default)
+ *
+ * Only `normal` styles are loaded. Every subset shipped by Fontsource is
+ * imported, but each `@font-face` carries a `unicode-range`, so the browser
+ * only downloads the subsets a page actually needs. `font-display: swap` is
+ * baked into the Fontsource stylesheets.
+ *
+ * Consumers must install the source packages themselves:
+ * `pnpm add -D @fontsource/plus-jakarta-sans @fontsource/fira-code`.
+ */
+export const DEFAULT_FONTS: TFontsOptions = {
+  fontsource: {
+    families: [
+      {
+        name: 'Plus Jakarta Sans',
+        weights: [400, 500, 600, 700],
+        styles: ['normal'],
+      },
+      {
+        name: 'Fira Code',
+        weights: [400, 600],
+        styles: ['normal'],
+      },
+    ],
+  },
+}
+
+/**
+ * Vite plugin that loads NubiscoUI's typefaces.
+ *
+ * Called with no arguments it self-hosts the library defaults (Plus Jakarta
+ * Sans + Fira Code) via Fontsource, keeping every existing consumer's output
+ * unchanged. Pass an options object to fully replace that configuration: load
+ * different families/weights, point the `custom` provider at your own woff2
+ * files, or use any other provider `unplugin-fonts` supports.
+ *
+ * @example
+ * // vite.config.ts (keep the NubiscoUI defaults)
+ * import { fonts } from '@nubisco/ui/plugins/fonts'
+ * export default defineConfig({ plugins: [fonts()] })
+ *
+ * @example
+ * // bring your own families/weights
+ * fonts({
+ *   fontsource: {
+ *     families: [
+ *       { name: 'Inter', weights: [400, 600], styles: ['normal'] },
+ *       { name: 'JetBrains Mono', weights: [400], styles: ['normal'] },
+ *     ],
+ *   },
+ * })
+ */
+export const fonts = (options: TFontsOptions = DEFAULT_FONTS) =>
+  Unfonts(options)