@humanforest/fonts 0.1.0

package/LICENSE

@@ -0,0 +1,67 @@
+Forest Design System — Licence
+Copyright (c) 2026 HumanForest Ltd. All rights reserved.
+
+This software is published openly so that people building Forest products can install it
+without access to its source repository. It is not open-source software.
+
+
+1. GRANT
+
+You may install, use, copy and modify this software, and incorporate it into applications,
+prototypes, documents and presentations, for the purpose of building or operating Forest
+products, services and communications.
+
+This grant is free of charge and requires no separate agreement. It runs to anyone who
+obtains the software from a public registry.
+
+
+2. RESERVED
+
+All rights not granted above are reserved. In particular, you may not:
+
+  (a) redistribute this software, modified or unmodified, as a design system, component
+      library, template or theme of your own;
+
+  (b) use the HumanForest and Forest names, logos, wordmarks, sub-brand marks or any
+      confusingly similar mark. Nothing here grants any trademark right. The brand marks
+      included in these packages are provided to render Forest's own products correctly,
+      not as artwork you may adopt;
+
+  (c) represent your product as being made, endorsed or approved by HumanForest.
+
+
+3. THIRD-PARTY MATERIAL
+
+Parts of these packages are not HumanForest's to license, and the grant in section 1 does
+not extend to them. Each keeps its own terms:
+
+  TYPEFACES — Mohr and GT Haptik are licensed to HumanForest by their foundries and are NOT
+  sublicensed to you. No font binary is included in any published package. The stylesheets
+  reference https://assets.forest.bike/fonts/, which serves them to those entitled to use
+  them. If you are not covered by Forest's licences, substitute your own faces. JetBrains
+  Mono is licensed under the SIL Open Font License 1.1 and may be used under those terms.
+
+  GLYPH OUTLINES — packages/tokens ships `glyphs/glyphs.json`, letterforms of the above
+  typefaces outlined as vector paths so sub-brand lockups can be composed at runtime. It is
+  covered by the same foundry terms as the typefaces themselves, not by section 1.
+
+  DEVICE ARTWORK — packages/frames ships device renders from Wikimedia Commons under the
+  Creative Commons Attribution-ShareAlike 4.0 International licence
+  (https://creativecommons.org/licenses/by-sa/4.0/). They are unmodified. Attribution is a
+  condition of that licence: see ATTRIBUTION.md in that package, and keep it with the art
+  wherever the art travels. Works derived from the artwork must themselves be CC BY-SA 4.0.
+
+  DEPENDENCIES — third-party packages installed alongside these keep their own licences.
+
+
+4. NO WARRANTY
+
+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.
+
+
+Questions about use beyond this grant: design@forest.bike

package/README.md

@@ -0,0 +1,109 @@
+# @humanforest/fonts
+
+Brand fonts for Forest: **GT Haptik** (body/UI), **Mohr** (display), **JetBrains Mono**
+(code). This package is **built for public npm but not published yet** — `npm publish` has
+never been run, so it currently 404s on the registry. When it does ship it is **CSS-only**:
+only `forest-fonts.cdn.css`, never the `files/*` woff/woff2 themselves and never the other
+generated stylesheets (those are repo-internal, see below). The Mohr licence limits
+redistribution of the actual font files, so those stay out of the published tarball; they
+are consumed internally as a *build source* (e.g. by the private Nuxt layer, which bundles
+them directly — see `packages/nuxt-layer/README.md`).
+
+Licence, in short:
+- **GT Haptik** — unrestricted (body/labels/UI).
+- **Mohr** — used only **Black + UPPERCASE**. `MohrAlt` (upright) web only; `Mohr-BlackIt`
+  (italic) mobile/core. Do **not** redistribute the files without written rights.
+- **JetBrains Mono** — OFL, free to redistribute.
+
+## Three stylesheet builds (from the same `files/*.woff2`)
+
+`bun run build:fonts` (→ `scripts/fonts.ts`) emits, alongside the hand-kept relative one. Only
+`forest-fonts.cdn.css` ships in the published package — the other two are repo-internal (used
+by the docs app and the artifact kit respectively, never installed by a consumer). All three:
+
+| File | `@font-face src` | Use | Published? |
+|---|---|---|---|
+| `forest-fonts.css` | `url('./files/…')` relative | self-hosting via a bundler (docs, real apps) | no — repo-internal |
+| `forest-fonts.cdn.css` | absolute CDN urls | runnable pages — fonts stay on the CDN | yes |
+
+CDN base is `FOREST_FONT_CDN` (default `https://assets.forest.bike/fonts`; `assets.forest.me`
+serves the same bucket). The bucket has an R2 CORS policy returning
+`Access-Control-Allow-Origin: *`, which is what makes cross-origin `@font-face` work — verified by
+loading all three families cross-origin from a different host. Without it the file still returns
+`200` but the browser rejects it and silently paints the fallback, so if fonts ever go missing,
+check the CORS header before anything else:
+
+```bash
+curl -sI -H "Origin: https://example.com" https://assets.forest.bike/fonts/GTHaptik-Bold.woff2 | grep -i access-control
+```
+
+Because the responses carry `Vary: Origin`, each origin is cached separately — a request made
+*before* a CORS change keeps its header-less cached copy until it expires or is purged.
+
+---
+
+## If you *have* installed the package
+
+One line in your entry CSS — the stylesheet comes from npm, the font binaries from the CDN:
+
+```css
+@import "@humanforest/fonts/forest-fonts.cdn.css";
+```
+
+This is the companion to the public npm packages: `@humanforest/ui` and friends ship no font files
+(the licence forbids redistributing Mohr publicly), so the fonts arrive over the CDN instead.
+
+---
+
+## Using the fonts in a Nuxt project **without this package**
+
+You don't need `@humanforest/fonts` installed. Two options.
+
+### Option A — load from the CDN (recommended, EULA-clean)
+
+Fonts live on the CDN and are never copied into your repo. In `nuxt.config.ts`:
+
+```ts
+export default defineNuxtConfig({
+  app: {
+    head: {
+      link: [
+        { rel: 'stylesheet', href: 'https://assets.forest.bike/fonts/forest-fonts.cdn.css' },
+      ],
+    },
+  },
+})
+```
+
+Then reference the families in your CSS / Tailwind theme:
+
+```css
+@theme {
+  --font-sans: 'GT Haptik', system-ui, sans-serif;
+  --font-display: 'MohrAlt', 'GT Haptik', system-ui, sans-serif; /* uppercase only */
+  --font-mono: 'JetBrains Mono', ui-monospace, monospace;
+}
+```
+
+Requires `Access-Control-Allow-Origin` on the CDN. This is the only route that renders
+**real Mohr** without shipping the files.
+
+### Option B — self-host the woff2 files
+
+Copy the `woff2` files into your app (e.g. `public/fonts/`) and declare `@font-face`
+yourself, pointing `src` at your own paths. Keep Mohr to Black + UPPERCASE per licence.
+This redistributes the files into your app — only do it for internal/authorised apps.
+
+```css
+@font-face {
+  font-family: 'GT Haptik';
+  src: url('/fonts/GTHaptik-Regular.woff2') format('woff2');
+  font-weight: normal; font-style: normal; font-display: swap;
+}
+/* …repeat for bold/italic, MohrAlt (900), JetBrains Mono… */
+```
+
+Bring your own licensed woff/woff2 files and write your own `@font-face` rules — the
+installed package does not carry them. The canonical `@font-face` set lives in the repo's
+`packages/fonts/forest-fonts.css`, not in the installed package; use it as a reference for the
+family names, weights and styles to declare.

package/forest-fonts.cdn.css

@@ -0,0 +1,83 @@
+/* Forest brand fonts — CDN build (absolute urls — host must send Access-Control-Allow-Origin).
+   GENERATED by scripts/fonts.ts from packages/fonts/files/*. Do not edit by hand.
+   Licence: Mohr = Black + UPPERCASE only; GT Haptik unrestricted; JetBrains Mono OFL. */
+
+/* Mohr's caps sit above its own box centre; these re-hang the face so the box matches
+   GT Haptik's (ascent + descent) and the cap band lands centred (ascent − descent = cap height). */
+@font-face {
+  font-family: 'MohrAlt';
+  src: url('https://assets.forest.bike/fonts/MohrAlt-Black.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/MohrAlt-Black.woff') format('woff');
+  font-weight: 900;
+  font-style: normal;
+  ascent-override: 98.7549%;
+  descent-override: 26.7334%;
+  line-gap-override: 0%;
+  font-display: swap;
+}
+
+/* Mohr's caps sit above its own box centre; these re-hang the face so the box matches
+   GT Haptik's (ascent + descent) and the cap band lands centred (ascent − descent = cap height). */
+@font-face {
+  font-family: 'Mohr-BlackIt';
+  src: url('https://assets.forest.bike/fonts/Mohr-BlackIt.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/Mohr-BlackIt.woff') format('woff');
+  font-weight: 900;
+  font-style: italic;
+  ascent-override: 98.7549%;
+  descent-override: 26.7334%;
+  line-gap-override: 0%;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'GT Haptik';
+  src: url('https://assets.forest.bike/fonts/GTHaptik-Regular.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/GTHaptik-Regular.woff') format('woff');
+  font-weight: normal;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'GT Haptik';
+  src: url('https://assets.forest.bike/fonts/GTHaptik-RegularOblique.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/GTHaptik-RegularOblique.woff') format('woff');
+  font-weight: normal;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'GT Haptik';
+  src: url('https://assets.forest.bike/fonts/GTHaptik-Bold.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/GTHaptik-Bold.woff') format('woff');
+  font-weight: bold;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'GT Haptik';
+  src: url('https://assets.forest.bike/fonts/GTHaptik-BoldOblique.woff2') format('woff2'),
+       url('https://assets.forest.bike/fonts/GTHaptik-BoldOblique.woff') format('woff');
+  font-weight: bold;
+  font-style: italic;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://assets.forest.bike/fonts/JetBrainsMono-Regular.woff2') format('woff2');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+
+@font-face {
+  font-family: 'JetBrains Mono';
+  src: url('https://assets.forest.bike/fonts/JetBrainsMono-Bold.woff2') format('woff2');
+  font-weight: 700;
+  font-style: normal;
+  font-display: swap;
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@humanforest/fonts",
+  "version": "0.1.0",
+  "files": [
+    "forest-fonts.cdn.css",
+    "README.md"
+  ],
+  "exports": {
+    "./forest-fonts.cdn.css": "./forest-fonts.cdn.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "SEE LICENSE IN LICENSE"
+}