@ptlm-azulejo/fonts-adeo 0.1.0-alpha.49

package/README.md

@@ -0,0 +1,74 @@
+# @ptlm-azulejo/fonts-adeo
+
+Roboto — the **`.preset-adeo`** typeface of
+[`@ptlm-azulejo/themes`](../themes/README.md) — loaded from the **Google Fonts
+CDN**.
+
+The theme names the typeface in `--font-family` but ships no `@font-face`, same
+contract as upstream Mozaic. This package is one `@import`.
+
+## ⚠️ Read this before installing
+
+This package makes your app fetch `fonts.googleapis.com` **at runtime**. Two
+consequences you inherit:
+
+- **Your end users' IP addresses reach Google.** In the EU that is a GDPR
+  consideration, and it has already cost sites fines.
+- **Your app needs network access to Google** to render on-brand — it degrades to
+  the fallback stack offline or behind a firewall that blocks it.
+
+For a production app with real users, **prefer self-hosting** — which is also
+what [`@ptlm-azulejo/themes`](../themes/README.md#self-host-or-cdn) recommends:
+
+```bash
+yarn add @fontsource/roboto
+```
+
+```js
+import '@fontsource/roboto/400.css'
+import '@fontsource/roboto/600.css'
+import '@fontsource/roboto/700.css'
+```
+
+`@fontsource` serves the same OFL files from your own domain. Use **5.2.x or
+newer**: earlier versions predate Roboto's variable release and ship no 600 cut,
+so `--font-weight-semi-bold` silently matches 700 and semi-bold renders bold.
+
+This package exists for the cases where the CDN is genuinely the right call —
+internal tools, prototypes, documentation sites.
+
+## Installation
+
+```bash
+yarn add @ptlm-azulejo/fonts-adeo
+```
+
+## Usage
+
+```js
+import '@ptlm-azulejo/themes/presets/adeo.css'
+import '@ptlm-azulejo/fonts-adeo'
+```
+
+### What you get
+
+The three cuts the theme tokens reference:
+
+| Token | Weight |
+|---|---|
+| `--font-weight-regular` | 400 |
+| `--font-weight-semi-bold` | 600 |
+| `--font-weight-bold` | 700 |
+
+Need another weight? Roboto is a variable font on Google Fonts (`wght` 100–900),
+so add your own `@import` with the axis you want — or self-host via
+`@fontsource/roboto/<weight>.css`.
+
+## Why Roboto is not vendored here
+
+Unlike LeroyMerlinSans (see
+[`@ptlm-azulejo/fonts-leroy-merlin`](../fonts-leroy-merlin/README.md)), Roboto is
+a **catalogued OFL-1.1** font — `Copyright 2011 The Roboto Project Authors`,
+licence at [openfontlicense.org](https://openfontlicense.org). Anyone may
+redistribute it, and `@fontsource` already does that well, so copying the
+binaries into this package would only duplicate a maintained package.

package/index.css

@@ -0,0 +1,32 @@
+/**
+ * Roboto — the .preset-adeo typeface, from the Google Fonts CDN.
+ *
+ * Roboto is not vendored here: it is a catalogued OFL-1.1 family that Google
+ * serves in every cut the theme tokens reference, so this package is a single
+ * @import rather than a copy of the binaries.
+ *
+ * Weights map to @ptlm-azulejo/themes tokens: --font-weight-regular (400),
+ * --font-weight-semi-bold (600) and --font-weight-bold (700).
+ *
+ * ── Read this before adopting ────────────────────────────────────────────────
+ * This file makes your app fetch fonts.googleapis.com at runtime. That means the
+ * IP address of YOUR end users reaches Google, which is a GDPR consideration in
+ * the EU, and your app will not render on-brand offline or behind a firewall
+ * that blocks Google.
+ *
+ * If that is not acceptable — which is the normal case for a production app —
+ * do NOT use this package. Self-host instead:
+ *
+ *   yarn add @fontsource/roboto
+ *
+ *   import '@fontsource/roboto/400.css'
+ *   import '@fontsource/roboto/600.css'
+ *   import '@fontsource/roboto/700.css'
+ *
+ * @fontsource serves the same OFL files from your own domain. Use 5.2.x or
+ * newer: earlier versions predate Roboto's variable release and ship no 600
+ * cut, so semi-bold silently matches 700 and renders bold.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+
+@import url("https://fonts.googleapis.com/css2?family=Roboto:wght@400;600;700&display=swap");

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@ptlm-azulejo/fonts-adeo",
+  "version": "0.1.0-alpha.49",
+  "description": "Roboto web font for the .preset-adeo brand of @ptlm-azulejo/themes, loaded from the Google Fonts CDN.",
+  "type": "module",
+  "exports": {
+    ".": "./index.css",
+    "./index.css": "./index.css"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "*.css"
+  ]
+}