@cavuno/board 1.33.0 → 1.34.0

package/dist/sitemap.js

@@ -164,6 +164,65 @@ function paginate(listFn, query, options) {
   };
 }
 
+// src/paths/index.ts
+function jobDetailPath(companySlug, jobSlug) {
+  return `/companies/${companySlug}/jobs/${jobSlug}`;
+}
+function jobsCategoryPath(categorySlug) {
+  return `/jobs/${categorySlug}`;
+}
+function jobsSkillPath(skillSlug) {
+  return `/jobs/skills/${skillSlug}`;
+}
+function jobsLocationPath(placeSlug) {
+  return `/jobs/locations/${placeSlug}`;
+}
+function companyPath(companySlug) {
+  return `/companies/${companySlug}`;
+}
+function companyMarketPath(marketSlug) {
+  return `/companies/markets/${marketSlug}`;
+}
+function companySalaryPath(companySlug) {
+  return `/companies/${companySlug}/salaries`;
+}
+function salaryTitlePath(titleSlug) {
+  return `/salaries/titles/${titleSlug}`;
+}
+function salarySkillPath(skillSlug) {
+  return `/salaries/skills/${skillSlug}`;
+}
+function salaryLocationPath(placeSlug) {
+  return `/salaries/locations/${placeSlug}`;
+}
+function blogPostPath(postSlug) {
+  return `/blog/${postSlug}`;
+}
+function blogTagPath(tagSlug) {
+  return `/blog/tag/${tagSlug}`;
+}
+function blogAuthorPath(authorSlug) {
+  return `/blog/author/${authorSlug}`;
+}
+var BOARD_PATHS = {
+  home: "/",
+  jobs: "/jobs",
+  companies: "/companies",
+  salaries: "/salaries",
+  salaryCompanies: "/salaries/companies",
+  salaryTitles: "/salaries/titles",
+  salarySkills: "/salaries/skills",
+  salaryLocations: "/salaries/locations",
+  blog: "/blog",
+  about: "/about",
+  privacyPolicy: "/privacy-policy",
+  termsOfService: "/terms-of-service",
+  cookiePolicy: "/cookie-policy",
+  impressum: "/impressum",
+  talent: "/talent",
+  employers: "/employers"
+};
+
 // src/sitemap/walker.ts
 var MIN_JOBS_PER_INDEXED_PAGE = 5;
 var MAX_PAGES = 200;
@@ -246,16 +305,16 @@ async function buildBucketUrls(board, origin, bucket) {
 async function marketing(board, origin) {
   const { features } = await board.context();
   const urls = [
-    `${origin}/`,
-    `${origin}/jobs`,
-    `${origin}/about`,
-    `${origin}/privacy-policy`,
-    `${origin}/terms-of-service`,
-    `${origin}/cookie-policy`
+    `${origin}${BOARD_PATHS.home}`,
+    `${origin}${BOARD_PATHS.jobs}`,
+    `${origin}${BOARD_PATHS.about}`,
+    `${origin}${BOARD_PATHS.privacyPolicy}`,
+    `${origin}${BOARD_PATHS.termsOfService}`,
+    `${origin}${BOARD_PATHS.cookiePolicy}`
   ];
-  if (features.impressum) urls.push(`${origin}/impressum`);
-  if (features.talentDirectory) urls.push(`${origin}/talent`);
-  if (features.employers) urls.push(`${origin}/employers`);
+  if (features.impressum) urls.push(`${origin}${BOARD_PATHS.impressum}`);
+  if (features.talentDirectory) urls.push(`${origin}${BOARD_PATHS.talent}`);
+  if (features.employers) urls.push(`${origin}${BOARD_PATHS.employers}`);
   return urls;
 }
 async function jobsTaxonomy(board, origin, kind) {
@@ -267,20 +326,20 @@ async function jobsTaxonomy(board, origin, kind) {
     );
     for (const slug of slugs) counts.set(slug, (counts.get(slug) ?? 0) + 1);
   }
-  const prefix = kind === "categories" ? `${origin}/jobs` : `${origin}/jobs/skills`;
-  return [...counts.entries()].filter(([, n]) => n >= MIN_JOBS_PER_INDEXED_PAGE).map(([slug]) => slug).sort().map((slug) => `${prefix}/${slug}`);
+  const toPath = kind === "categories" ? jobsCategoryPath : jobsSkillPath;
+  return [...counts.entries()].filter(([, n]) => n >= MIN_JOBS_PER_INDEXED_PAGE).map(([slug]) => slug).sort().map((slug) => `${origin}${toPath(slug)}`);
 }
 async function jobsLocations(board, origin) {
   const { language } = await board.context();
   const { data } = await board.salaries.locations.list({ locale: language });
-  return data.filter((l) => l.jobCount >= MIN_JOBS_PER_INDEXED_PAGE).map((l) => l.placeSlug).sort().map((slug) => `${origin}/jobs/locations/${slug}`);
+  return data.filter((l) => l.jobCount >= MIN_JOBS_PER_INDEXED_PAGE).map((l) => l.placeSlug).sort().map((slug) => `${origin}${jobsLocationPath(slug)}`);
 }
 async function jobDetails(board, origin) {
   const jobs = await enumerateJobs(board);
   const seen = /* @__PURE__ */ new Set();
   for (const job of jobs) {
     if (!job.company?.slug || !job.slug) continue;
-    seen.add(`${origin}/companies/${job.company.slug}/jobs/${job.slug}`);
+    seen.add(`${origin}${jobDetailPath(job.company.slug, job.slug)}`);
   }
   return [...seen].sort();
 }
@@ -289,10 +348,11 @@ async function companies(board, origin) {
     enumerateCompanies(board),
     board.companies.markets()
   ]);
-  const urls = [`${origin}/companies`];
-  for (const company of list) urls.push(`${origin}/companies/${company.slug}`);
+  const urls = [`${origin}${BOARD_PATHS.companies}`];
+  for (const company of list)
+    urls.push(`${origin}${companyPath(company.slug)}`);
   for (const market of markets.data) {
-    urls.push(`${origin}/companies/markets/${market.slug}`);
+    urls.push(`${origin}${companyMarketPath(market.slug)}`);
   }
   return urls;
 }
@@ -307,27 +367,27 @@ async function salaries(board, origin) {
   if (!salaryCompanies.data.length && !titles.data.length && !skills.data.length && !locations.data.length) {
     return [];
   }
-  const urls = [`${origin}/salaries`];
+  const urls = [`${origin}${BOARD_PATHS.salaries}`];
   if (salaryCompanies.data.length) {
-    urls.push(`${origin}/salaries/companies`);
+    urls.push(`${origin}${BOARD_PATHS.salaryCompanies}`);
     for (const c of salaryCompanies.data) {
-      urls.push(`${origin}/companies/${c.companySlug}/salaries`);
+      urls.push(`${origin}${companySalaryPath(c.companySlug)}`);
     }
   }
   if (titles.data.length) {
-    urls.push(`${origin}/salaries/titles`);
+    urls.push(`${origin}${BOARD_PATHS.salaryTitles}`);
     for (const t of titles.data)
-      urls.push(`${origin}/salaries/titles/${t.slug}`);
+      urls.push(`${origin}${salaryTitlePath(t.slug)}`);
   }
   if (skills.data.length) {
-    urls.push(`${origin}/salaries/skills`);
+    urls.push(`${origin}${BOARD_PATHS.salarySkills}`);
     for (const s of skills.data)
-      urls.push(`${origin}/salaries/skills/${s.slug}`);
+      urls.push(`${origin}${salarySkillPath(s.slug)}`);
   }
   if (locations.data.length) {
-    urls.push(`${origin}/salaries/locations`);
+    urls.push(`${origin}${BOARD_PATHS.salaryLocations}`);
     for (const l of locations.data) {
-      urls.push(`${origin}/salaries/locations/${l.placeSlug}`);
+      urls.push(`${origin}${salaryLocationPath(l.placeSlug)}`);
     }
   }
   return urls;
@@ -336,18 +396,18 @@ async function blog(board, origin) {
   const posts = await drainPages(
     paginate(board.blog.posts.list, { limit: 100 }).pages()
   );
-  const urls = [`${origin}/blog`];
+  const urls = [`${origin}${BOARD_PATHS.blog}`];
   const tagSlugs = /* @__PURE__ */ new Set();
   const authorSlugs = /* @__PURE__ */ new Set();
   for (const post of posts) {
-    urls.push(`${origin}/blog/${post.slug}`);
+    urls.push(`${origin}${blogPostPath(post.slug)}`);
     for (const tag of post.tags) tagSlugs.add(tag.slug);
     for (const author of post.authors) authorSlugs.add(author.slug);
   }
   for (const slug of [...tagSlugs].sort())
-    urls.push(`${origin}/blog/tag/${slug}`);
+    urls.push(`${origin}${blogTagPath(slug)}`);
   for (const slug of [...authorSlugs].sort()) {
-    urls.push(`${origin}/blog/author/${slug}`);
+    urls.push(`${origin}${blogAuthorPath(slug)}`);
   }
   return urls;
 }

package/dist/sitemap.mjs

@@ -128,6 +128,65 @@ function paginate(listFn, query, options) {
   };
 }
 
+// src/paths/index.ts
+function jobDetailPath(companySlug, jobSlug) {
+  return `/companies/${companySlug}/jobs/${jobSlug}`;
+}
+function jobsCategoryPath(categorySlug) {
+  return `/jobs/${categorySlug}`;
+}
+function jobsSkillPath(skillSlug) {
+  return `/jobs/skills/${skillSlug}`;
+}
+function jobsLocationPath(placeSlug) {
+  return `/jobs/locations/${placeSlug}`;
+}
+function companyPath(companySlug) {
+  return `/companies/${companySlug}`;
+}
+function companyMarketPath(marketSlug) {
+  return `/companies/markets/${marketSlug}`;
+}
+function companySalaryPath(companySlug) {
+  return `/companies/${companySlug}/salaries`;
+}
+function salaryTitlePath(titleSlug) {
+  return `/salaries/titles/${titleSlug}`;
+}
+function salarySkillPath(skillSlug) {
+  return `/salaries/skills/${skillSlug}`;
+}
+function salaryLocationPath(placeSlug) {
+  return `/salaries/locations/${placeSlug}`;
+}
+function blogPostPath(postSlug) {
+  return `/blog/${postSlug}`;
+}
+function blogTagPath(tagSlug) {
+  return `/blog/tag/${tagSlug}`;
+}
+function blogAuthorPath(authorSlug) {
+  return `/blog/author/${authorSlug}`;
+}
+var BOARD_PATHS = {
+  home: "/",
+  jobs: "/jobs",
+  companies: "/companies",
+  salaries: "/salaries",
+  salaryCompanies: "/salaries/companies",
+  salaryTitles: "/salaries/titles",
+  salarySkills: "/salaries/skills",
+  salaryLocations: "/salaries/locations",
+  blog: "/blog",
+  about: "/about",
+  privacyPolicy: "/privacy-policy",
+  termsOfService: "/terms-of-service",
+  cookiePolicy: "/cookie-policy",
+  impressum: "/impressum",
+  talent: "/talent",
+  employers: "/employers"
+};
+
 // src/sitemap/walker.ts
 var MIN_JOBS_PER_INDEXED_PAGE = 5;
 var MAX_PAGES = 200;
@@ -210,16 +269,16 @@ async function buildBucketUrls(board, origin, bucket) {
 async function marketing(board, origin) {
   const { features } = await board.context();
   const urls = [
-    `${origin}/`,
-    `${origin}/jobs`,
-    `${origin}/about`,
-    `${origin}/privacy-policy`,
-    `${origin}/terms-of-service`,
-    `${origin}/cookie-policy`
+    `${origin}${BOARD_PATHS.home}`,
+    `${origin}${BOARD_PATHS.jobs}`,
+    `${origin}${BOARD_PATHS.about}`,
+    `${origin}${BOARD_PATHS.privacyPolicy}`,
+    `${origin}${BOARD_PATHS.termsOfService}`,
+    `${origin}${BOARD_PATHS.cookiePolicy}`
   ];
-  if (features.impressum) urls.push(`${origin}/impressum`);
-  if (features.talentDirectory) urls.push(`${origin}/talent`);
-  if (features.employers) urls.push(`${origin}/employers`);
+  if (features.impressum) urls.push(`${origin}${BOARD_PATHS.impressum}`);
+  if (features.talentDirectory) urls.push(`${origin}${BOARD_PATHS.talent}`);
+  if (features.employers) urls.push(`${origin}${BOARD_PATHS.employers}`);
   return urls;
 }
 async function jobsTaxonomy(board, origin, kind) {
@@ -231,20 +290,20 @@ async function jobsTaxonomy(board, origin, kind) {
     );
     for (const slug of slugs) counts.set(slug, (counts.get(slug) ?? 0) + 1);
   }
-  const prefix = kind === "categories" ? `${origin}/jobs` : `${origin}/jobs/skills`;
-  return [...counts.entries()].filter(([, n]) => n >= MIN_JOBS_PER_INDEXED_PAGE).map(([slug]) => slug).sort().map((slug) => `${prefix}/${slug}`);
+  const toPath = kind === "categories" ? jobsCategoryPath : jobsSkillPath;
+  return [...counts.entries()].filter(([, n]) => n >= MIN_JOBS_PER_INDEXED_PAGE).map(([slug]) => slug).sort().map((slug) => `${origin}${toPath(slug)}`);
 }
 async function jobsLocations(board, origin) {
   const { language } = await board.context();
   const { data } = await board.salaries.locations.list({ locale: language });
-  return data.filter((l) => l.jobCount >= MIN_JOBS_PER_INDEXED_PAGE).map((l) => l.placeSlug).sort().map((slug) => `${origin}/jobs/locations/${slug}`);
+  return data.filter((l) => l.jobCount >= MIN_JOBS_PER_INDEXED_PAGE).map((l) => l.placeSlug).sort().map((slug) => `${origin}${jobsLocationPath(slug)}`);
 }
 async function jobDetails(board, origin) {
   const jobs = await enumerateJobs(board);
   const seen = /* @__PURE__ */ new Set();
   for (const job of jobs) {
     if (!job.company?.slug || !job.slug) continue;
-    seen.add(`${origin}/companies/${job.company.slug}/jobs/${job.slug}`);
+    seen.add(`${origin}${jobDetailPath(job.company.slug, job.slug)}`);
   }
   return [...seen].sort();
 }
@@ -253,10 +312,11 @@ async function companies(board, origin) {
     enumerateCompanies(board),
     board.companies.markets()
   ]);
-  const urls = [`${origin}/companies`];
-  for (const company of list) urls.push(`${origin}/companies/${company.slug}`);
+  const urls = [`${origin}${BOARD_PATHS.companies}`];
+  for (const company of list)
+    urls.push(`${origin}${companyPath(company.slug)}`);
   for (const market of markets.data) {
-    urls.push(`${origin}/companies/markets/${market.slug}`);
+    urls.push(`${origin}${companyMarketPath(market.slug)}`);
   }
   return urls;
 }
@@ -271,27 +331,27 @@ async function salaries(board, origin) {
   if (!salaryCompanies.data.length && !titles.data.length && !skills.data.length && !locations.data.length) {
     return [];
   }
-  const urls = [`${origin}/salaries`];
+  const urls = [`${origin}${BOARD_PATHS.salaries}`];
   if (salaryCompanies.data.length) {
-    urls.push(`${origin}/salaries/companies`);
+    urls.push(`${origin}${BOARD_PATHS.salaryCompanies}`);
     for (const c of salaryCompanies.data) {
-      urls.push(`${origin}/companies/${c.companySlug}/salaries`);
+      urls.push(`${origin}${companySalaryPath(c.companySlug)}`);
     }
   }
   if (titles.data.length) {
-    urls.push(`${origin}/salaries/titles`);
+    urls.push(`${origin}${BOARD_PATHS.salaryTitles}`);
     for (const t of titles.data)
-      urls.push(`${origin}/salaries/titles/${t.slug}`);
+      urls.push(`${origin}${salaryTitlePath(t.slug)}`);
   }
   if (skills.data.length) {
-    urls.push(`${origin}/salaries/skills`);
+    urls.push(`${origin}${BOARD_PATHS.salarySkills}`);
     for (const s of skills.data)
-      urls.push(`${origin}/salaries/skills/${s.slug}`);
+      urls.push(`${origin}${salarySkillPath(s.slug)}`);
   }
   if (locations.data.length) {
-    urls.push(`${origin}/salaries/locations`);
+    urls.push(`${origin}${BOARD_PATHS.salaryLocations}`);
     for (const l of locations.data) {
-      urls.push(`${origin}/salaries/locations/${l.placeSlug}`);
+      urls.push(`${origin}${salaryLocationPath(l.placeSlug)}`);
     }
   }
   return urls;
@@ -300,18 +360,18 @@ async function blog(board, origin) {
   const posts = await drainPages(
     paginate(board.blog.posts.list, { limit: 100 }).pages()
   );
-  const urls = [`${origin}/blog`];
+  const urls = [`${origin}${BOARD_PATHS.blog}`];
   const tagSlugs = /* @__PURE__ */ new Set();
   const authorSlugs = /* @__PURE__ */ new Set();
   for (const post of posts) {
-    urls.push(`${origin}/blog/${post.slug}`);
+    urls.push(`${origin}${blogPostPath(post.slug)}`);
     for (const tag of post.tags) tagSlugs.add(tag.slug);
     for (const author of post.authors) authorSlugs.add(author.slug);
   }
   for (const slug of [...tagSlugs].sort())
-    urls.push(`${origin}/blog/tag/${slug}`);
+    urls.push(`${origin}${blogTagPath(slug)}`);
   for (const slug of [...authorSlugs].sort()) {
-    urls.push(`${origin}/blog/author/${slug}`);
+    urls.push(`${origin}${blogAuthorPath(slug)}`);
   }
   return urls;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "1.33.0",
+  "version": "1.34.0",
   "description": "Typed isomorphic client for the Cavuno Board API",
   "license": "MIT",
   "type": "commonjs",
@@ -80,6 +80,16 @@
         "default": "./dist/sitemap.js"
       }
     },
+    "./paths": {
+      "import": {
+        "types": "./dist/paths.d.mts",
+        "default": "./dist/paths.mjs"
+      },
+      "require": {
+        "types": "./dist/paths.d.ts",
+        "default": "./dist/paths.js"
+      }
+    },
     "./server": {
       "import": {
         "types": "./dist/server.d.mts",

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.33.0",
+  "version": "1.34.0",
   "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.",