@cavuno/board 3.2.0 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,412 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 4.0.0 — 2026-08-03
+
+- **Lossy seams:** Resolution is fine;
+  discarding the input is not. After every call the application must
+  still be able to produce a different legitimate rendering.
+  - `resolveCustomFieldDisplay` multi-select returns
+    `{ kind: 'multi_select', values: string[] }` instead of a
+    pre-joined `kind: 'text'` sentence. `Intl.ListFormat` (or chips /
+    short style / disjunction) moves to the app — same reason numbers
+    stay raw. Leading `language` stays for signature stability; the SDK no longer reads it for multi-select.
+  - `buildSalaryFaq` average entries carry `avgMin`, `avgMax`, and
+    `currency` alongside the compact `range` convenience. FAQ prose can
+    reformat with `notation: 'standard'` without re-threading the detail
+    object. `label` is still echoed so FAQ mapping is a pure map over
+    entries (the SDK never reads it for formatting).
+  - `formatSalaryStat` / `formatSalaryStatRange` accept optional
+    `notation` with the same magnitude default as `formatSalaryRange`
+    (`|value| ≥ 1000` → compact; smaller → standard). `$90K` vs
+    `$90,000` is register, not locale.
+  - : remove `ListFormat` from "what the SDK keeps"; add the
+    mechanical recoverability test and worked table; document Google
+    controlled vocabularies (`EDUCATION_TO_CREDENTIAL`,
+    `EMPLOYMENT_TYPE_TO_GOOGLE`) as wire values, not copy; correct that
+    timeframe units ship as the wire enum, not unit words from `Intl`.
+
+- **Pre-publish blockers (salary format + SEO paths):** Closes the final
+  review that blocked publish.
+  - `formatSalaryStat` / `formatSalaryStatRange` null-guard currency
+    (`currency?.trim()`) so a runtime `null` returns `null` instead of
+    `TypeError` — matches `formatSalaryRange` and the skill/changelog
+    contract (`string | null`).
+  - Non-finite amounts (`NaN`, `±Infinity`) return `null` across
+    `formatSalaryStat`, `formatSalaryStatRange`, and `formatSalaryRange`
+    (they are `number` at the type level and slip past `== null`).
+  - Identical range ends (`min === max`) format as a fixed salary
+    (single amount), not ICU's `approximatelySign` form (`~$140K`). A
+    posted pin is not a degenerate range.
+  - `formatSalaryRange` defaults `notation` by **magnitude**: compact
+    only where ICU shortens (`|value| ≥ 1000`); smaller values stay
+    `standard` so hourly/day rates keep CLDR minor units (`$22.50`,
+    `KWD 22.567`). Explicit `notation` still wins.
+  - `listingJsonLd` builds job URLs via `jobDetailPath` / `boardUrl`
+    (drops company-less jobs rather than linking `/jobs/{slug}`); omits
+    `BreadcrumbList` when the trail has fewer than 2 crumbs. 
+    `buildJobBreadcrumbs` uses `paths/` helpers instead of hand-built
+    strings.
+  - `companySalaryJsonLd` / `locationSalaryJsonLd` accept omitted
+    `options` and return `null` (siblings already did; these threw).
+
+- **i18n audit (format / paths / skills):** Closes the specialist audit
+  against ICU/CLDR/W3C practice. Architecture (discriminant seams, no
+  composition, `Intl`-over-catalogs) stands; defects were concentrated in
+  timezone pinning, CLDR width choice, and structure-vs-support locale
+  validation.
+  - `formatMonthYear` pins `timeZone: 'UTC'` (and date-only inputs as UTC
+    midnight) so full ISO timestamps agree with `formatDate` under every
+    host zone — no more `"Mai 2023"` / `"Dec 2022"` for June / Jan UTC.
+  - `formatPublishedRelativeDate` uses RTF `style: 'short'` (not
+    `narrow`). English reads `"5 days ago"`; French / Russian / Romanian
+    no longer degrade to signed numbers (`-5 j`).
+  - `normalizeLocale` requires `Intl.NumberFormat.supportedLocalesOf` —
+    well-formed but unsupported tags (`xx`, `qqq`, `und`, …) return
+    `null` instead of silently using the host default. Contract in
+    `locale.ts`, `salary-range.ts`, and `skills/cavuno-board-format` is
+    now enforced.
+  - Currency fraction digits: compact notation keeps a one-digit cap
+    (documented); `notation: 'standard'` (optional override on
+    `formatSalaryRange`) lets each currency's CLDR minor units win.
+    Default notation is magnitude-selected (see pre-publish blockers
+    above), not unconditional compact.
+  - `resolveCustomFieldDisplay` emits `kind: 'number'` with the raw
+    value (not pre-stringified `kind: 'text'`), so the app formats with
+    `Intl.NumberFormat`.
+  - Path helpers percent-encode dynamic segments (non-ASCII board-language
+    slugs become URIs for sitemap `<loc>`, canonical, email). `:` is kept
+    for route-contract templates; already-encoded input is not
+    double-encoded.
+  - Filter / suggest Set keys NFC-normalize; suggest `minChars` counts
+    graphemes (`Intl.Segmenter`), so a single CJK character qualifies.
+  - `skills/cavuno-board-i18n` carries the five  obligations
+    (plural selection, gender, bidi isolation with FSI/PDI, grapheme
+    truncation, locale-aware case) and extends the completion gate.
+    Salary-range / format skills document bidi isolation at the join
+    site rather than returning `{ value, dir }`.
+
+- **Rule (word order):** The SDK never decides what goes next to what.
+  "No hardcoded strings" is the easy half. Word order is the half that
+  survives a grep, because every operand is data and only the
+  *arrangement* is English. A template with two data holes and a space
+  (or `|`, or `/`) between them is an English sentence with the words
+  removed. The SDK formats with `Intl`, returns structure, and leaves
+  composition — counters, particles, separators, prefix vs postfix — to
+  the application. Invalid locales prefer `null` over English-arranged
+  fallbacks; underscore tags (`ja_JP`) normalize to BCP-47 (`ja-JP`) so
+  one typo does not drop every formatter into English at once.
+
+- **Breaking:** `listingHead` requires a caller-supplied `title` (same
+  ownership as `description`). Removed `heading`, `boardName`, `count`,
+  and `language` from `ListingHeadOptions` — the SDK no longer composes
+  `` `${count} ${heading} | ${boardName}` `` (Japanese wants
+  `1,225件の求人`, not `1,225 求人 | …`). Pass the finished title from
+  the board's message catalog. Also removes the only unguarded
+  `Intl.NumberFormat` construction in the SDK (a malformed board
+  language no longer crashes the listing page).
+
+- **Breaking:** `formatSalaryRange` returns
+  `{ text, timeframe, bound } | null`. `text` is the `Intl`-formatted
+  amount/range only; `timeframe` is the **wire enum** (`per_year`,
+  `per_hour`, …) — never a unit word from `Intl` and never an owner
+  override. Applications map the enum through their own catalog and
+  compose amount↔timeframe order (`$90K / year` vs `年収900万〜1200万円`).
+  Missing currency, invalid locale, or rejected currency format →
+  `null` (no bare number, no English `M`/`k`/`$`).
+
+- **Breaking:** Removed `SalaryTimeframeOverrides` from
+  `@cavuno/board/format`. Owner-edited unit labels are application-side
+  copy keyed off the wire `timeframe` enum the helper returns; the SDK
+  no longer accepts an override map.
+
+- **Breaking:** `GET/POST …/me/saved-jobs` embeds a slim `job_card` (the
+  same shape as jobs list/search), not a full `public_job` with HTML
+  `description`. Fetch the job detail by slug when the full body is
+  needed. `remoteLocationLabel` is resolved server-side from
+  `remoteRules`, so region-limited remote jobs keep their real region
+  label instead of a client-side lossy guess.
+
+- **Breaking:** Removed `fullJobToCard` from `@cavuno/board/format`. The
+  saved-jobs endpoint now serves cards; convert with the same card VM as
+  listings (`toJobCardVM(saved.job, …)`). That helper was the last
+  user-facing hardcoded English in the SDK (`Remote`, `Worldwide`,
+  `(hybrid)`).
+
+- **Breaking:** `formatSalaryRange`'s board language is required — no
+  silent `en` default. `formatPublishedRelativeDate` under one minute uses
+  `Intl.RelativeTimeFormat` (`"now"` / `"jetzt"` / `"maintenant"`), not a
+  hardcoded English string. `resolveCustomFieldDisplay` takes the board
+  language as its leading parameter (signature stability). Multi-select
+  originally joined via `Intl.ListFormat`; that was lossy and now returns
+  `kind: 'multi_select'` with `values: string[]` (see Lossy seams above).
+
+- **Breaking:** Renamed and currency-aware salary-stat formatters:
+  `formatUsd` / `formatRange` → `formatSalaryStat(locale, value, currency)` /
+  `formatSalaryStatRange(locale, min, max, currency)`. The `/format`
+  aliases `formatSalaryStatUsd` / `formatSalaryStatRange` are replaced by
+  the same names (no USD-only alias). `buildSalaryFaq` takes `currency`
+  as a fourth argument so FAQ ranges match the board's money. Both formatters
+  return `string | null` (`null` when currency is empty or `Intl` rejects
+  the locale/currency) instead of inventing English `M`/`k` or a bare `$`.
+
+- **Breaking:** `formatSalaryRange` first moved from `string | null` to
+  `{ text; bound } | null` so open floors/ceilings are named by the app;
+  the timeframe is now a third field (see top of this heading) rather than
+  a suffix glued onto `text`.
+
+- **Breaking:** Unit, currency, and date *words* derive from `Intl`;
+  `skills/` snippets show shape (catalog placeholders), not pasteable
+  English copy or join templates. The SDK formats with `Intl` and returns
+  structure; it does not supply open-range chrome, nav/button copy, filter
+  labels, SEO sentence templates, or amount↔unit arrangement. Dropped the
+  private chrome-copy package dependency entirely. Closed ranges use
+  `Intl.NumberFormat.prototype.formatRange` (locale owns separator,
+  repeated currency/magnitude, and bidi marks). Open-range chrome and
+  amount↔timeframe order are application-owned via `bound` + `timeframe`.
+  `buildJobBreadcrumbs` no longer takes `language` or `labels` parameters —
+  it returns structural `kind`s for chrome crumbs (`home` / `jobs`) instead
+  of display names; applications supply the words when mapping to
+  `BreadcrumbList`. `seniorityLabels` / `sortLabels` / `formatSeniority`
+  are removed. Type exports removed with the chrome surface:
+  `AlertsCopy`, `ApplyCopy`, `BlogCopy`, `BoardLabelOverrides`,
+  `BreadcrumbsCopy`, `CopyLinkCopy`, `EntityCopy`, `FooterCopy`,
+  `JobCardCopy`, `JobDetailCopy`, `JobSearchCopy`, `NavCopy`,
+  `PaginationCopy`, `SalaryCopy`, `SalaryFrames`, `SalaryLexicon`,
+  `SeniorityKey`, `UiCopy`.
+
+- **Breaking:** `listingHead` requires a caller-supplied `description` (and
+  now `title` — see top of this heading). It no longer composes
+  `Browse … on …` (English on every locale) or case-folds the heading with
+  locale-blind `.toLowerCase()`.
+
+- **Breaking:** `buildSalaryFaq` returns structured
+  `SalaryFaqEntry` values (`kind: 'average' | 'methodology'` plus label,
+  `formatRange` range, and `jobCount`) instead of English FAQ prose.
+  Map entries to `{ q, a }` in the application (with proper plural rules),
+  then pass them to `faqJsonLd`.
+
+- **Breaking:** Salary JSON-LD builders
+  (`titleSalaryJsonLd`, `skillSalaryJsonLd`, `locationSalaryJsonLd`,
+  `crossAxisSalaryJsonLd`, `companySalaryJsonLd`,
+  `companyCategorySalaryJsonLd`) use data-only `name` fields (entity
+  names). Removed English framing
+  (`… salary (all levels)`, `Average Salary in …`, `Jobs at …`,
+  `… salary in …`, trailing ` salary`).
+
+- **Breaking:** Dropped the dead `locale` parameter from
+  `titleSalaryJsonLd`, `crossAxisSalaryJsonLd`, `companySalaryJsonLd`,
+  and `companyCategorySalaryJsonLd` — it was discarded (`void locale`)
+  and did not change output. Per-seniority distribution names are no
+  longer title-cased wire enums (`entry_level` → `Entry level`) and are
+  no longer joined as `` `${seniority} ${entity}` `` (English word order).
+  Pass optional `seniorityName({ seniority, entity })` that returns the
+  finished string in board-language order, or omit it so those
+  distributions ship without a `name` (valid structured data;
+  wrong-language / wrong-order names are not).
+
+- **Breaking:** `formatSalaryRange` never invents USD when
+  `salaryCurrency` is null/empty — returns `null`, matching
+  `createJobPostingJsonLd` which omits `baseSalary` without a currency.
+  Invalid locales and rejected currency formats also return `null` rather
+  than English `M`/`k`/`$` or a bare number.
+
+- **Breaking:** `formatMonthYear` returns `string | null` — `null` on
+  missing/unparseable input (never the English literal `"Invalid Date"`),
+  and accepts full ISO timestamps in addition to date-only forms.
+
+- **Breaking:** `locationSalaryJsonLd` and `companySalaryJsonLd` no
+  longer emit an `Occupation` / `OccupationAggregationByEmployer`
+  envelope with the place or employer as `name` (neither is an
+  occupation). They emit an `ItemList` of the occupations present on
+  that page (`topCategories` / `byCategory`), each linking to its own
+  occupation page via required `occupationUrl`. Return `null` when
+  there are no per-occupation rows (or when the location is not
+  city/locality). The other four builders keep `Occupation`.
+
+- **Breaking:** `board.taxonomy.suggestions.list` and
+  `GET /v1/boards/{identifier}/suggestions` are removed. Use
+  `board.search.suggest({ types: ['category', 'skill'], … })` instead. The
+  `taxonomy` namespace itself stays (`categories`, `skills`, `places`,
+  `remotePermits`, resolve methods).
+
+- `board.search.suggest` accepts
+  `types?: ('company' | 'category' | 'skill' | 'market' | 'post' | 'tag')[]`.
+  Omit for every kind. `limit` applies **after** type filtering, so
+  `{ types: ['skill'], limit: 10 }` returns up to ten skills.
+
+- `SuggestionItem` gains a `market` variant (`type: 'market'`, `slug`, `name`,
+  `companyCount`) for company-scope typeahead alongside companies.
+
+- `SuggestionItem` gains `post` (`type: 'post'`, `id`, `slug`, `title`) and
+  `tag` (`type: 'tag'`, `id`, `slug`, `name`) for blog typeahead. Blog posts
+  and tags are public, so no extra access control.
+
+- `@cavuno/board/paths` adds `suggestionPath(suggestion, { scope, location? })`
+  plus `jobsLocationCategoryPath` / `jobsLocationSkillPath`. A jobs-scope
+  company suggestion returns `null` — apply a `companySlug` filter; do not
+  invent `/jobs/companies/<slug>`. Blog scope routes posts via
+  `blogPostPath` and tags via `blogTagPath`.
+
+- Added `sdk/reference/search.mdoc` and a docs-contract gate that every
+  `BoardSdk` namespace has a matching reference page.
+
+- The sitemap no longer advertises `/talent` on boards whose talent directory
+  is `employers_only`. That page is gated behind an approved employer session,
+  so listing it pointed crawlers at the gate rather than the directory. Only a
+  `public` directory is listed.
+
+- **Breaking:** `board.context().customFields` is now keyed by model instead of
+  a flat job-only array. Today only `job` is present; `company` / `talent` keys
+  land when those models ship (absent keys are not empty arrays).
+
+  Before:
+
+  ```json
+  "customFields": [
+    { "key": "security_clearance", "label": "Security clearance", "type": "single_select", "required": false }
+  ]
+  ```
+
+  After:
+
+  ```json
+  "customFields": {
+    "job": [
+      { "key": "security_clearance", "label": "Security clearance", "type": "single_select", "required": false }
+    ]
+  }
+  ```
+
+  Resolve job values with `resolveCustomFieldDisplay(context.customFields.job, job.customFieldValues)`
+  — the helper still takes a definitions array and did not change.
+
+- **Breaking:** `features.talentDirectory` is now the tri-state access mode
+  (`off` | `public` | `employers_only`). The top-level
+  `talentDirectoryVisibility` field is removed — it duplicated the same gate.
+
+  Before:
+
+  ```json
+  "features": { "talentDirectory": true },
+  "talentDirectoryVisibility": "employers_only"
+  ```
+
+  After:
+
+  ```json
+  "features": { "talentDirectory": "employers_only" }
+  ```
+
+  Link `/talent` whenever `features.talentDirectory !== 'off'`. Do not treat
+  the field as a boolean — the string `'off'` is truthy in JavaScript.
+
+- **Breaking:** `board.seo()` no longer returns presentation. Removed
+  `icons` (ico/svg/appleTouch/icon192/icon512/iconMaskable512) and
+  `manifest.themeColor`. Kept `canonicalBase`, `adsTxt`, `indexNowKey`,
+  `googleSiteVerification`, and `manifest.name`. Applications own brand
+  assets and theme tokens.
+
+  Before:
+
+  ```json
+  {
+    "canonicalBase": "https://jobs.example.com",
+    "adsTxt": null,
+    "indexNowKey": null,
+    "googleSiteVerification": null,
+    "icons": { "ico": "…", "svg": null, "appleTouch": null, "icon192": null, "icon512": null, "iconMaskable512": null },
+    "manifest": { "name": "Acme Jobs", "themeColor": "#1d4ed8" }
+  }
+  ```
+
+  After:
+
+  ```json
+  {
+    "canonicalBase": "https://jobs.example.com",
+    "adsTxt": null,
+    "indexNowKey": null,
+    "googleSiteVerification": null,
+    "manifest": { "name": "Acme Jobs" }
+  }
+  ```
+
+- **Breaking:** `board.context().footer` is gone. Operator-authored contact
+  and social identity move to a top-level `contact` group; editor-authored
+  presentation (`description`, `navigationOrder`, `customLinks`) is removed
+  — applications own footer layout.
+
+  Before:
+
+  ```json
+  "footer": {
+    "description": "Roles from {{board_name}}.",
+    "contactEmail": "hello@acme.com",
+    "websiteUrl": "https://acme.com/",
+    "xUrl": "https://x.com/acmejobs",
+    "facebookUrl": null,
+    "linkedinUrl": "https://linkedin.com/company/acme",
+    "navigationOrder": ["home", "blog"],
+    "customLinks": [{ "id": "abc", "label": "Hub", "url": "/hub" }]
+  }
+  ```
+
+  After:
+
+  ```json
+  "contact": {
+    "email": "hello@acme.com",
+    "websiteUrl": "https://acme.com/",
+    "xUrl": "https://x.com/acmejobs",
+    "facebookUrl": null,
+    "linkedinUrl": "https://linkedin.com/company/acme"
+  }
+  ```
+
+  Brand/social URL sanitization is unchanged (absolute http(s) only).
+  `companyLegalName` / `companyAddress` were never on this public context
+  payload (they ride the legal/impressum surface); no `company` group was
+  invented here.
+
+- **Breaking:** Chrome copy leaves the public `@cavuno/board` surface. Removed from `@cavuno/board/format`: `uiCopy`,
+  `PUBLIC_LABEL_GROUPS`, `fieldLabel`, `getSalaryLexicon`, `locationLabel`,
+  `cardLocationLabel`, `companyIntro`, and the `UiCopy` type re-export.
+  Removed from `@cavuno/board/seo`: `formatSeniority`. Removed from
+  `@cavuno/board/filters`: `seniorityLabels`, `sortLabels`.
+
+  Hosted boards import chrome words from a private package. Third-party applications own their copy in code (or their
+  message catalogs). The published SDK no longer imports or bundles that
+  package.
+
+  What stays on `@cavuno/board/format`: `formatSalaryRange` (`Intl`-backed
+  amounts, wire `timeframe` enum, and a `bound` discriminant for open ranges),
+  date helpers, `resolveCustomFieldDisplay`, `normalizeWebsiteUrl`,
+  `buildJobBreadcrumbs` (kinds + data names; no `language`/`labels` args),
+  `COUNTRY_CODES` / `countryOptions`, and the salary-stat formatters. Filter
+  vocabularies (wire enums + parsers only) stay on `@cavuno/board/filters`.
+
+- **Breaking:** `board.legal.retrieve`, the legal types (`PublicLegalPage`,
+  `LegalPageType`, `LegalEntity`), and `GET /v1/boards/{identifier}/legal/{type}`
+  (`getBoardLegal`) are removed. Legal prose is editor-authored
+  application content, not a Board API concern.
+
+- **Breaking:** `board.context().labels` is removed. Operator label overrides
+  no longer ride the public Board API — applications own chrome words.
+  Hosted storage for operator overrides is unchanged (hosted chrome still
+  reads the bag).
+
+  Before:
+
+  ```json
+  "labels": {
+    "jobCardLabels": { "featuredLabel": "Top Job" },
+    "navLabels": { "home": "Jobs" }
+  }
+  ```
+
+  After: field absent.
+
 ## 3.2.0 — 2026-08-03
 
 - Added `formatSalaryStatUsd`, `formatSalaryStatRange`, `normalizeWebsiteUrl`,

package/README.md

@@ -53,8 +53,12 @@ const { name, language, features } = await board.context();
 const page = await board.jobs.list({ limit: 20 });
 const job = await board.jobs.retrieve('senior-chef');
 
-// Federated search-dropdown suggestions (companies + taxonomy terms).
-const { items } = await board.search.suggest({ q: 'acme', limit: 10 });
+// Federated search-dropdown suggestions (companies, markets, taxonomy terms).
+const { items } = await board.search.suggest({
+  q: 'acme',
+  limit: 10,
+  types: ['company', 'skill'],
+});
 // Or the headless controller (debounce / abort / stale-drop built in):
 // import { createSuggestController } from '@cavuno/board/suggest';
 // const suggest = createSuggestController(board);

package/dist/{_spec-nkWAraS0.d.mts → _spec-GVe6WAfT.d.mts}

@@ -245,19 +245,9 @@ interface components {
              * @description The board's canonical base URL (honours a configured custom domain). Build `robots.txt`'s `Sitemap:` line (`${canonicalBase}/sitemap.xml`) and canonical links from it.
              */
             canonicalBase: string;
-            /** @description Absolute URLs for the board's configured favicons / app icons (null when unset). The variant key implies the role + size; build `<link rel="icon">` tags + the web-manifest icon list from these. */
-            icons: {
-                ico: string | null;
-                svg: string | null;
-                appleTouch: string | null;
-                icon192: string | null;
-                icon512: string | null;
-                iconMaskable512: string | null;
-            };
-            /** @description Web-manifest metadata; assemble `site.webmanifest` from this + `icons`. */
+            /** @description Web-manifest name only. Theme color and icons left the surface in 4.0.0: applications own brand assets and presentation tokens. */
             manifest: {
                 name: string;
-                themeColor: string;
             };
         };
         BoardUser: {
@@ -1339,23 +1329,6 @@ interface components {
             /** Format: email */
             email: string;
         };
-        LegalPage: {
-            /** @enum {string} */
-            object: "legal_page";
-            /** @description The resolved legal page type. */
-            type: string;
-            /** @description Page heading (H1), with `{{board_name}}` resolved. */
-            title: string;
-            /** @description Owner-authored prose as portable HTML. Empty string when the page has no text body. */
-            content: string;
-            /** @enum {string} */
-            contentFormat: "html";
-            /** @description Structured impressum legal-entity facts; `null` for non-impressum pages. */
-            legalEntity: {
-                legalName: string | null;
-                address: string | null;
-            } | null;
-        };
         LocationSalaryDetail: {
             /** @enum {string} */
             object: "location_salary_detail";
@@ -1465,6 +1438,23 @@ interface components {
                 jobCount: number;
             }[];
         };
+        MarketSuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "market";
+            /** @description Stable market identity (source slug; markets are slug-keyed). */
+            id: string;
+            /** @description Public market URL slug. */
+            slug: string;
+            /** @description Market display name. */
+            name: string;
+            /** @description Number of companies on the board in this market. */
+            companyCount: number;
+        };
         Message: {
             id: string;
             /** @enum {string} */
@@ -1561,6 +1551,21 @@ interface components {
                 messagesPerPeriod: string;
             };
         };
+        PostSuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "post";
+            /** @description Stable published blog post identity. */
+            id: string;
+            /** @description Public blog post URL slug. */
+            slug: string;
+            /** @description Post title. */
+            title: string;
+        };
         PublicBlogAdjacentPosts: {
             /** @enum {string} */
             object: "blog_adjacent_posts";
@@ -1651,7 +1656,11 @@ interface components {
                 candidates: boolean;
                 employers: boolean;
                 blog: boolean;
-                talentDirectory: boolean;
+                /**
+                 * @description Talent directory access mode. Link /talent whenever this is not `'off'`. An employers-only directory renders a sign-in upsell for anonymous visitors, matching the hosted chrome. Replaces the former top-level `talentDirectoryVisibility` and the boolean `features.talentDirectory`.
+                 * @enum {string}
+                 */
+                talentDirectory: "off" | "public" | "employers_only";
                 registrationWall: boolean;
                 passwordProtected: boolean;
                 publicJobSubmission: boolean;
@@ -1662,11 +1671,6 @@ interface components {
                 /** @description Whether applicant↔employer messaging is enabled on the board. `false` means the `me/conversations` route family rejects with `messaging_disabled` (403). Hide inbox/dock/Message CTAs. */
                 messaging: boolean;
             };
-            /**
-             * @description The tri-state behind `features.talentDirectory` (which is `visibility === 'public'`). Link /talent whenever this is not `'off'`. An employers-only directory renders a sign-in upsell for anonymous visitors, matching the hosted chrome.
-             * @enum {string}
-             */
-            talentDirectoryVisibility: "off" | "public" | "employers_only";
             analytics: {
                 ga4MeasurementId: string | null;
                 gtmId: string | null;
@@ -1674,33 +1678,23 @@ interface components {
                 linkedInPartnerId: string | null;
                 cookieConsentRequired: boolean;
             };
-            /** @description Operator-defined custom job-field definitions, in display order. Board-wide; the frontend uses these to render and localize each job's opaque `customFieldValues`. Empty when the board defines none. Display-only: not filterable or searchable in v1. */
-            customFields: components["schemas"]["CustomFieldDefinition"][];
-            /** @description Stored operator label overrides by config group (`jobCardLabels`, `navLabels`, `breadcrumbsLabels`, …): plain-text chrome copy to merge over the `@cavuno/board` `uiCopy(language)` catalog via `uiCopy(language, labels)`. Empty object when the board stores none. */
-            labels: {
-                [key: string]: {
-                    [key: string]: string;
-                };
+            /** @description Operator-defined custom field definitions keyed by model (currently only `job`). Each key holds that model's definitions in display order. Company and talent keys are added when those models ship. The frontend uses these to render and localize each record's opaque `customFieldValues`. Display-only: not filterable or searchable in v1. */
+            customFields: {
+                /** @description This model's custom-field definitions in display order. Empty when the board defines none for the model. */
+                job: components["schemas"]["CustomFieldDefinition"][];
             };
-            /** @description Footer/brand data the hosted board footer renders (description, contact, website + social links, navigation order). The brand/social URLs (`websiteUrl`, `facebookUrl`, `linkedinUrl`, `xUrl`) are sanitized to absolute http(s); `customLinks[].url` is served verbatim (see its own note). */
-            footer: {
-                /** @description Operator-written footer brand description. May carry a `{{board_name}}` placeholder. Resolve it before rendering. When null, fall back to the label catalog's `footer.defaultDescription` template. */
-                description: string | null;
-                /** @description Public contact email for the footer About column (render as `mailto:`). */
-                contactEmail: string | null;
+            /** @description Operator-authored contact and social identity (settings › Contact & company details). Extracted from the former `footer` group in 4.0.0: contact is identity data, not layout. Brand/social URLs are sanitized to absolute http(s). */
+            contact: {
+                /** @description Public contact email (render as `mailto:`). Operator-set in settings › Contact & company details. */
+                email: string | null;
+                /** @description Company website URL, sanitized to absolute http(s). Null when unset or non-http(s). */
                 websiteUrl: string | null;
                 /** @description X (Twitter) profile URL, normalized from the stored handle. */
                 xUrl: string | null;
+                /** @description Facebook profile URL, sanitized to absolute http(s). Null when unset or non-http(s). */
                 facebookUrl: string | null;
+                /** @description LinkedIn profile URL, sanitized to absolute http(s). Null when unset or non-http(s). */
                 linkedinUrl: string | null;
-                /** @description Operator-configured navigation order: system item ids (`home`, `companies`, `pricing`, `blog`) and `custom:<id>` refs into `customLinks`. Empty when the operator never reordered. Render the system defaults. System items still gate on their feature flags (e.g. `blog` only when `features.blog`). */
-                navigationOrder: string[];
-                /** @description Operator-defined navigation links referenced from `navigationOrder` as `custom:<id>`; links not referenced there append after the system items (hosted-footer behavior). Each `url` is served verbatim (trimmed only) and may be a relative path (e.g. `/hub`): unlike the brand/social URLs it is NOT run through http(s) sanitization (matching the hosted footer, which supports relative links), so a consumer MUST sanitize it before binding to an anchor href. */
-                customLinks: {
-                    id: string;
-                    label: string;
-                    url: string;
-                }[];
             };
         };
         PublicCompaniesSearchBody: {
@@ -1841,7 +1835,7 @@ interface components {
                 slug: string;
                 name: string;
             }[];
-            /** @description Opaque, display-only custom-field values, keyed by each field's `key`. Values are the option `key`(s) for select fields, or the raw boolean/number/text otherwise. Resolve labels via the board's `customFields` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Not filterable or searchable in v1. */
+            /** @description Opaque, display-only custom-field values, keyed by each field's `key`. Values are the option `key`(s) for select fields, or the raw boolean/number/text otherwise. Resolve labels via the board's `customFields.job` definitions (see `GET /v1/boards/:identifier`). `{}` when the board defines no custom fields. Not filterable or searchable in v1. */
             customFieldValues: {
                 [key: string]: string | string[] | boolean | number;
             };
@@ -2186,7 +2180,7 @@ interface components {
             jobId: string;
             /** Format: date-time */
             savedAt: string;
-            job: components["schemas"]["PublicJob"];
+            job: components["schemas"]["PublicJobCard"];
         };
         SendWorkEmailBody: {
             /** Format: email */
@@ -2347,10 +2341,25 @@ interface components {
             object: "suggest_result";
             /** @description The trimmed query string that produced these suggestions. */
             query: string;
-            /** @description Interleaved company + taxonomy-term suggestions. Order is server-ranked; clients must not re-sort. */
+            /** @description Interleaved company, market, taxonomy-term, blog-post, and tag suggestions. Order is server-ranked; clients must not re-sort. When `types` is set, only the requested kinds appear and `limit` applies after that filter. */
             items: components["schemas"]["SuggestionItem"][];
         };
-        SuggestionItem: components["schemas"]["CompanySuggestion"] | components["schemas"]["TermSuggestion"];
+        SuggestionItem: components["schemas"]["CompanySuggestion"] | components["schemas"]["MarketSuggestion"] | components["schemas"]["TermSuggestion"] | components["schemas"]["PostSuggestion"] | components["schemas"]["TagSuggestion"];
+        TagSuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "tag";
+            /** @description Stable tag identity (source slug; tags are slug-keyed). */
+            id: string;
+            /** @description Public blog tag URL slug. */
+            slug: string;
+            /** @description Tag display name. */
+            name: string;
+        };
         TalentAccess: {
             /** @enum {string} */
             object: "talent_access";