@cavuno/board 1.32.0 → 1.33.1

package/dist/bin.mjs

@@ -40,6 +40,9 @@ function record(id, tier) {
 var ENV_API_URL = record("env.api-url", 1);
 var ENV_BOARD_KEY = record("env.board-key", 1);
 var PK_RE = /^pk_[0-9a-f]{32}$/;
+function apiBase(apiUrl) {
+  return apiUrl.replace(/\/+$/, "");
+}
 function checkEnv(env) {
   const results = [];
   if (!env.apiUrl) {
@@ -307,8 +310,7 @@ async function observeVerificationEmail(fetchImpl, apiKey, recipient, pollMs, ti
 }
 async function runWriteProbes(options) {
   const { fetchImpl } = options;
-  const origin = new URL(options.env.apiUrl).origin;
-  const base = `${origin}/v1/boards/${encodeURIComponent(options.env.boardKey)}`;
+  const base = `${apiBase(options.env.apiUrl)}/v1/boards/${encodeURIComponent(options.env.boardKey)}`;
   const nonce = options.nonce ?? `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;
   const email = `doctor+${nonce}@cavuno.com`;
   const password = `doctor-probe-${nonce}-A1!`;
@@ -429,14 +431,12 @@ var STATIC_API = record("static.api", 1);
 var STATIC_BOARD = record("static.board", 1);
 var STATIC_SKILLS = record("static.skills", 1);
 async function checkApiReachable(fetchImpl, apiUrl) {
-  let origin;
   try {
-    origin = new URL(apiUrl).origin;
+    new URL(apiUrl);
   } catch {
     return null;
   }
-  const spec = await probe(fetchImpl, `${origin}/api/v1/openapi.json`);
-  const result = spec.ok ? spec : await probe(fetchImpl, `${origin}/v1/openapi.json`);
+  const result = await probe(fetchImpl, `${apiBase(apiUrl)}/v1/openapi.json`);
   if (!result.ok) {
     return STATIC_API(
       "fail",
@@ -455,10 +455,9 @@ async function checkApiReachable(fetchImpl, apiUrl) {
   return STATIC_API("pass", "OpenAPI spec reachable");
 }
 async function checkBoardResolves(fetchImpl, env) {
-  const origin = new URL(env.apiUrl).origin;
   const result = await probe(
     fetchImpl,
-    `${origin}/v1/boards/${encodeURIComponent(env.boardKey)}`
+    `${apiBase(env.apiUrl)}/v1/boards/${encodeURIComponent(env.boardKey)}`
   );
   if (!result.ok) {
     return {

package/dist/index.d.mts

@@ -204,7 +204,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.32.0";
+declare const SDK_VERSION = "1.33.1";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {

package/dist/index.d.ts

@@ -204,7 +204,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.32.0";
+declare const SDK_VERSION = "1.33.1";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {

package/dist/index.js

@@ -312,7 +312,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.32.0";
+var SDK_VERSION = "1.33.1";
 
 // src/client.ts
 function isRawBody(body) {

package/dist/index.mjs

@@ -265,7 +265,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.32.0";
+var SDK_VERSION = "1.33.1";
 
 // src/client.ts
 function isRawBody(body) {

package/dist/theme.js

@@ -94,9 +94,15 @@ function boardThemeToCss(theme) {
   const light = tokenLines(theme.colors.light ?? {});
   const dark = tokenLines(theme.colors.dark ?? {});
   const fontSans = theme.typography?.fontSans;
+  const genericStack = "ui-sans-serif, system-ui, sans-serif";
+  const sansStack = fontSans ? `'${themeFontFamily(fontSans)}', ${genericStack}` : genericStack;
   if (fontSans) {
+    light.push(`  --font-sans: ${sansStack};`);
+  }
+  const fontHeading = theme.typography?.fontHeading;
+  if (fontHeading) {
     light.push(
-      `  --font-sans: '${themeFontFamily(fontSans)}', ui-sans-serif, system-ui, sans-serif;`
+      `  --font-heading: '${themeFontFamily(fontHeading)}', ${sansStack};`
     );
   }
   const blocks = [];

package/dist/theme.mjs

@@ -64,9 +64,15 @@ function boardThemeToCss(theme) {
   const light = tokenLines(theme.colors.light ?? {});
   const dark = tokenLines(theme.colors.dark ?? {});
   const fontSans = theme.typography?.fontSans;
+  const genericStack = "ui-sans-serif, system-ui, sans-serif";
+  const sansStack = fontSans ? `'${themeFontFamily(fontSans)}', ${genericStack}` : genericStack;
   if (fontSans) {
+    light.push(`  --font-sans: ${sansStack};`);
+  }
+  const fontHeading = theme.typography?.fontHeading;
+  if (fontHeading) {
     light.push(
-      `  --font-sans: '${themeFontFamily(fontSans)}', ui-sans-serif, system-ui, sans-serif;`
+      `  --font-heading: '${themeFontFamily(fontHeading)}', ${sansStack};`
     );
   }
   const blocks = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "1.32.0",
+  "version": "1.33.1",
   "description": "Typed isomorphic client for the Cavuno Board API",
   "license": "MIT",
   "type": "commonjs",

package/skills/cavuno-board-i18n/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: cavuno-board-i18n
+description: Multi-language chrome for a board frontend — the single-language board model, the uiCopy catalog ⊕ operator labels ⊕ generated copy layering, the one copy seam, and how to add path-prefixed locales (/de/, /fr/) with Paraglide JS on TanStack Start. Use when localizing a starter's chrome, adding a language, or wiring locale routing. Do NOT use to translate job content — that stays the board's language.
+---
+
+# Board i18n: localize the chrome, never the content
+
+A Cavuno board has **one content language** (`board.context().language`).
+Job titles, descriptions, and company text are that single language and
+never translated by the frontend. What you localize is the **chrome** —
+labels, headings, FAQ scaffolding, filter vocabulary — plus the entity
+data the API already translates (taxonomy, places, salary names).
+
+So there are two separate things:
+- **Content** (jobs, companies, blog): board-language, API-served, single.
+- **Chrome** (your authored UI strings): can be multi-locale, path-routed.
+
+## The copy layers (resolve in order)
+
+1. **`uiCopy(language)`** — the versioned SDK catalog (`@cavuno/board/format`,
+   `en`/`de`/`fr`, functions-per-key for plurals; no runtime, no provider).
+   The floor.
+2. **`⊕ board.context().labels`** — the operator's per-board overrides,
+   API-served (e.g. `featuredLabel` → "Top Job").
+3. **`⊕ generated code`** — per-board copy the AI builder ejects to native
+   code (ADR-0059 layer 3). Supersedes the catalog for that board.
+
+Every surface resolves copy through **one seam module** (`src/copy.ts`),
+never by calling the catalog inline:
+
+```ts snippet
+import { uiCopy, type BoardLabelOverrides } from '@cavuno/board/format'
+export function boardCopy(language: string | undefined, labels?: BoardLabelOverrides) {
+  return uiCopy(language, labels)
+}
+```
+
+The seam is the **single swap point** for the whole copy lifecycle: catalog
+today → Paraglide messages (below) → builder-generated code later. Components
+never change; only the seam's backing source does.
+
+## Add path-prefixed locales with Paraglide JS (TanStack Start)
+
+The starters are TanStack Start, and the TanStack-recommended i18n is
+**Paraglide JS** — compile-time (messages become tree-shakeable functions),
+**no runtime provider** (matches the catalog's no-provider stance), with
+built-in locale routing. The board's language is served unprefixed at `/`;
+extra locales are prefixed (`/de/`, `/fr/`).
+
+1. **Init.** `npx @inlang/paraglide-js@latest init` — creates the inlang
+   project, `messages/{en,de,fr}.json`, the `paraglide/` output, and the Vite
+   plugin. Add the plugin to `vite.config.ts`.
+2. **Generate messages FROM `uiCopy` — never hand-translate.** The catalog is
+   the source of truth. Emit `messages/{locale}.json` from
+   `uiCopy(locale)` so `de`/`fr` come from the reviewed SDK catalog, not a
+   second copy. (This generator is the `uiCopy → Paraglide` adapter.)
+3. **Route.** Wire the router's `rewrite` with Paraglide's `deLocalizeUrl` /
+   `localizeUrl` so `/de/jobs` routes internally as `/jobs` and every `Link`
+   auto-prefixes the active locale. Default-locale-no-prefix: the board
+   language stays at `/`.
+4. **SSR.** Add `paraglideMiddleware` in the server entry; set `<html lang>`
+   from `getLocale()` (it replaces the static `board.language` in the root).
+5. **Seam.** Point `boardCopy` at the URL locale (`getLocale()`) instead of
+   only `board.language`, so `/de/` renders German chrome even on an English
+   board. This is the opt-in that ADR-0063 adds over the single-language model.
+6. **SEO slice.** Per-locale `hreflang`, canonical, and sitemap entries are
+   part of completing multi-language — do them when you add real locales, not
+   in the foundation.
+
+## Do not
+
+- **Do not translate job content** (titles/descriptions). Fully multi-language
+  listings is a data-model change, out of scope.
+- **Do not hand-author translations** in the starter — generate messages from
+  `uiCopy` so there is one reviewed source.
+- **Do not add a runtime i18n provider** (e.g. use-intl's context). Paraglide
+  is compile-time; keep the no-provider property.
+- **Do not scatter catalog calls** through markup — everything imports the one
+  seam, so the catalog→code migration is a single-file change.
+
+Reference: ADR-0063 (starter i18n), ADR-0059 (copy catalog), ADR-0010 (entity
+translation). Wiring flavor: `cavuno-board-tanstack-start`.

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.32.0",
+  "version": "1.33.1",
   "skills": [
     {
       "name": "cavuno-board-account",
@@ -64,6 +64,13 @@
       "framework": null,
       "category": "core"
     },
+    {
+      "name": "cavuno-board-i18n",
+      "description": "Multi-language chrome for a board frontend — the single-language board model, the uiCopy catalog ⊕ operator labels ⊕ generated copy layering, the one copy seam, and how to add path-prefixed locales (/de/, /fr/) with Paraglide JS on TanStack Start. Use when localizing a starter's chrome, adding a language, or wiring locale routing. Do NOT use to translate job content — that stays the board's language.",
+      "path": "skills/cavuno-board-i18n/SKILL.md",
+      "framework": null,
+      "category": "core"
+    },
     {
       "name": "cavuno-board-job-alerts",
       "description": "Build job-alert flows with the @cavuno/board SDK — the anonymous double-opt-in surface (jobAlerts.subscribe/confirm/resendConfirmation + HMAC-token manage/unsubscribe/resubscribe/updatePreference/deletePreference) and the authenticated board.me.alerts CRUD. Covers which surface to use when, how the manage token rides, which filters actually scope delivery, and the full-replace update trap.",