@cavuno/board 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 This changelog records changes that affect Board API compatibility, exported
 types, runtime behavior, or supported integration patterns.
 
+## 3.2.0 — 2026-08-03
+
+- Added `formatSalaryStatUsd`, `formatSalaryStatRange`, `normalizeWebsiteUrl`,
+  and `buildJobBreadcrumbs` to `@cavuno/board/format`. These presentation
+  helpers previously required importing `@cavuno/board/seo`, which pulled the
+  structured-data builders into client bundles; frontends can now keep the SEO
+  entry server-only. The `@cavuno/board/seo` exports are unchanged.
+- Split the ESM builds of the isomorphic entries into shared chunks, so a
+  selective import no longer carries unrelated builders. CommonJS output is
+  unchanged.
+- `listingHead` accepts an optional `language` and groups the result count for
+  that locale in the title and meta description (`1,225 Jobs` / `1.225 Jobs`),
+  matching how listing bodies render the same number. Callers that omit
+  `language` keep byte-identical output.
+
+## 3.1.0 — 2026-08-03
+
+- Added direct skills.sh installation guidance and repository grouping for all
+  22 Cavuno Board SDK skills.
+- Linked every independently installable skill to the Cavuno SDK documentation.
+
 ## 3.0.0 — 2026-08-03
 
 - Removed runtime theme data from `board.context()` and removed the

package/README.md

@@ -19,6 +19,17 @@ other compatible coding agents. It teaches them how to wire a board correctly
 auth and session ownership, pagination, gating, error handling, and a
 runtime smoke test:
 
+Install the latest skills directly from the public SDK repository:
+
+```bash
+npx skills add wollemiahq/cavuno-sdk --skill cavuno-board-setup
+# Or install the complete Cavuno skill set:
+npx skills add wollemiahq/cavuno-sdk --skill '*'
+```
+
+For skills matched exactly to an installed SDK version, copy them from the
+package instead:
+
 ```bash
 npm install @cavuno/board     # or: pnpm add / yarn add / bun add
 npx @cavuno/board setup       # copies version-matched Agent Skills

package/dist/blog-DGBHmExV.d.mts

@@ -0,0 +1,29 @@
+import { S as Schemas } from './_spec-nkWAraS0.mjs';
+
+/** Author shape embedded on posts (no `object` discriminator). */
+type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
+/** Tag shape embedded on posts (no `object` discriminator). */
+type BlogTagEmbed = Schemas['PublicBlogTagEmbed'];
+type PublicBlogAuthor = Schemas['PublicBlogAuthor'];
+type PublicBlogTag = Schemas['PublicBlogTag'];
+type PublicBlogPostSummary = Schemas['PublicBlogPostSummary'];
+/** Detail shape — `html` appears on the single read only, never on summaries. */
+type PublicBlogPost = Schemas['PublicBlogPost'];
+/** Previous (older) + next (newer) posts for the detail prev/next nav. */
+type PublicBlogAdjacentPosts = Schemas['PublicBlogAdjacentPosts'];
+type BlogPostsListQuery = {
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    tagSlug?: string;
+    authorSlug?: string;
+    /** Opt-in only: pass `'true'` to restrict to featured posts. */
+    featured?: 'true';
+};
+type BlogSimilarQuery = {
+    /** 1–20; default 6. */
+    limit?: number;
+};
+type BlogSearchBody = Schemas['PublicBlogSearchBody'];
+
+export type { BlogAuthorEmbed as B, PublicBlogPostSummary as P, BlogPostsListQuery as a, BlogSimilarQuery as b, BlogSearchBody as c, BlogTagEmbed as d, PublicBlogAdjacentPosts as e, PublicBlogAuthor as f, PublicBlogPost as g, PublicBlogTag as h };

package/dist/blog-iV9XEIGf.d.ts

@@ -0,0 +1,29 @@
+import { S as Schemas } from './_spec-nkWAraS0.js';
+
+/** Author shape embedded on posts (no `object` discriminator). */
+type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
+/** Tag shape embedded on posts (no `object` discriminator). */
+type BlogTagEmbed = Schemas['PublicBlogTagEmbed'];
+type PublicBlogAuthor = Schemas['PublicBlogAuthor'];
+type PublicBlogTag = Schemas['PublicBlogTag'];
+type PublicBlogPostSummary = Schemas['PublicBlogPostSummary'];
+/** Detail shape — `html` appears on the single read only, never on summaries. */
+type PublicBlogPost = Schemas['PublicBlogPost'];
+/** Previous (older) + next (newer) posts for the detail prev/next nav. */
+type PublicBlogAdjacentPosts = Schemas['PublicBlogAdjacentPosts'];
+type BlogPostsListQuery = {
+    cursor?: string;
+    /** 1–100. */
+    limit?: number;
+    tagSlug?: string;
+    authorSlug?: string;
+    /** Opt-in only: pass `'true'` to restrict to featured posts. */
+    featured?: 'true';
+};
+type BlogSimilarQuery = {
+    /** 1–20; default 6. */
+    limit?: number;
+};
+type BlogSearchBody = Schemas['PublicBlogSearchBody'];
+
+export type { BlogAuthorEmbed as B, PublicBlogPostSummary as P, BlogPostsListQuery as a, BlogSimilarQuery as b, BlogSearchBody as c, BlogTagEmbed as d, PublicBlogAdjacentPosts as e, PublicBlogAuthor as f, PublicBlogPost as g, PublicBlogTag as h };

package/dist/{salaries-ChSqDBAM.d.mts → board-BJbXd_9_.d.mts}

@@ -1,32 +1,6 @@
 import { S as Schemas } from './_spec-nkWAraS0.mjs';
 import { L as ListEnvelope, m as RelatedSearch } from './jobs-lVvKCBCU.mjs';
 
-/** Author shape embedded on posts (no `object` discriminator). */
-type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
-/** Tag shape embedded on posts (no `object` discriminator). */
-type BlogTagEmbed = Schemas['PublicBlogTagEmbed'];
-type PublicBlogAuthor = Schemas['PublicBlogAuthor'];
-type PublicBlogTag = Schemas['PublicBlogTag'];
-type PublicBlogPostSummary = Schemas['PublicBlogPostSummary'];
-/** Detail shape — `html` appears on the single read only, never on summaries. */
-type PublicBlogPost = Schemas['PublicBlogPost'];
-/** Previous (older) + next (newer) posts for the detail prev/next nav. */
-type PublicBlogAdjacentPosts = Schemas['PublicBlogAdjacentPosts'];
-type BlogPostsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    tagSlug?: string;
-    authorSlug?: string;
-    /** Opt-in only: pass `'true'` to restrict to featured posts. */
-    featured?: 'true';
-};
-type BlogSimilarQuery = {
-    /** 1–20; default 6. */
-    limit?: number;
-};
-type BlogSearchBody = Schemas['PublicBlogSearchBody'];
-
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
 type CompanyMarketRef = Schemas['CompanyMarketRef'];
@@ -114,4 +88,17 @@ type SalaryDetailQuery = {
     locale?: string;
 };
 
-export type { SkillLocationSalary as A, BlogAuthorEmbed as B, CompanyCategorySalary as C, SkillLocationsIndex as D, TitleLocationSalary as E, TitleLocationsIndex as F, LocationSalaryDetail as L, PublicBlogPostSummary as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanySalary as a, CompaniesListQuery as b, CompanyListEnvelope as c, CompaniesSearchBody as d, CompanyJobsListQuery as e, CompanySimilarQuery as f, CompanyMarketsListQuery as g, SalaryDetailQuery as h, BlogPostsListQuery as i, BlogSimilarQuery as j, BlogSearchBody as k, BlogTagEmbed as l, CompanyMarket as m, CompanyMarketRef as n, LocationSkillsIndex as o, LocationTitlesIndex as p, PublicBlogAdjacentPosts as q, PublicBlogAuthor as r, PublicBlogPost as s, PublicBlogTag as t, PublicCompany as u, PublicCompanyDetail as v, SalaryCompany as w, SalaryLocation as x, SalarySkill as y, SalaryTitle as z };
+type PublicBoard = Schemas['PublicBoardContext'];
+type PublicBoardFeatures = PublicBoard['features'];
+type PublicBoardAnalytics = PublicBoard['analytics'];
+/**
+ * An operator-defined custom job-field definition. Board-wide;
+ * use it to render and localize a job's opaque `customFieldValues` (resolve
+ * option `key`s → labels, honour field `type` and display order). Shared with
+ * the Operator API's custom-field surface (one canonical schema).
+ */
+type CustomFieldDefinition = Schemas['CustomFieldDefinition'];
+type CustomFieldType = CustomFieldDefinition['type'];
+type CustomFieldOption = Schemas['CustomFieldOption'];
+
+export type { TitleLocationsIndex as A, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CustomFieldOption as l, CustomFieldType as m, LocationSkillsIndex as n, LocationTitlesIndex as o, PublicBoardAnalytics as p, PublicBoardFeatures as q, PublicCompany as r, PublicCompanyDetail as s, SalaryCompany as t, SalaryLocation as u, SalarySkill as v, SalaryTitle as w, SkillLocationSalary as x, SkillLocationsIndex as y, TitleLocationSalary as z };

package/dist/{salaries-BahBpxWT.d.ts → board-JhdUWIoq.d.ts}

@@ -1,32 +1,6 @@
 import { S as Schemas } from './_spec-nkWAraS0.js';
 import { L as ListEnvelope, m as RelatedSearch } from './jobs-BiEvL9d7.js';
 
-/** Author shape embedded on posts (no `object` discriminator). */
-type BlogAuthorEmbed = Schemas['PublicBlogAuthorEmbed'];
-/** Tag shape embedded on posts (no `object` discriminator). */
-type BlogTagEmbed = Schemas['PublicBlogTagEmbed'];
-type PublicBlogAuthor = Schemas['PublicBlogAuthor'];
-type PublicBlogTag = Schemas['PublicBlogTag'];
-type PublicBlogPostSummary = Schemas['PublicBlogPostSummary'];
-/** Detail shape — `html` appears on the single read only, never on summaries. */
-type PublicBlogPost = Schemas['PublicBlogPost'];
-/** Previous (older) + next (newer) posts for the detail prev/next nav. */
-type PublicBlogAdjacentPosts = Schemas['PublicBlogAdjacentPosts'];
-type BlogPostsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    tagSlug?: string;
-    authorSlug?: string;
-    /** Opt-in only: pass `'true'` to restrict to featured posts. */
-    featured?: 'true';
-};
-type BlogSimilarQuery = {
-    /** 1–20; default 6. */
-    limit?: number;
-};
-type BlogSearchBody = Schemas['PublicBlogSearchBody'];
-
 type PublicCompany = Schemas['CompanyPublic'];
 /** A market (sector) a company operates in — name + its source slug. */
 type CompanyMarketRef = Schemas['CompanyMarketRef'];
@@ -114,4 +88,17 @@ type SalaryDetailQuery = {
     locale?: string;
 };
 
-export type { SkillLocationSalary as A, BlogAuthorEmbed as B, CompanyCategorySalary as C, SkillLocationsIndex as D, TitleLocationSalary as E, TitleLocationsIndex as F, LocationSalaryDetail as L, PublicBlogPostSummary as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanySalary as a, CompaniesListQuery as b, CompanyListEnvelope as c, CompaniesSearchBody as d, CompanyJobsListQuery as e, CompanySimilarQuery as f, CompanyMarketsListQuery as g, SalaryDetailQuery as h, BlogPostsListQuery as i, BlogSimilarQuery as j, BlogSearchBody as k, BlogTagEmbed as l, CompanyMarket as m, CompanyMarketRef as n, LocationSkillsIndex as o, LocationTitlesIndex as p, PublicBlogAdjacentPosts as q, PublicBlogAuthor as r, PublicBlogPost as s, PublicBlogTag as t, PublicCompany as u, PublicCompanyDetail as v, SalaryCompany as w, SalaryLocation as x, SalarySkill as y, SalaryTitle as z };
+type PublicBoard = Schemas['PublicBoardContext'];
+type PublicBoardFeatures = PublicBoard['features'];
+type PublicBoardAnalytics = PublicBoard['analytics'];
+/**
+ * An operator-defined custom job-field definition. Board-wide;
+ * use it to render and localize a job's opaque `customFieldValues` (resolve
+ * option `key`s → labels, honour field `type` and display order). Shared with
+ * the Operator API's custom-field surface (one canonical schema).
+ */
+type CustomFieldDefinition = Schemas['CustomFieldDefinition'];
+type CustomFieldType = CustomFieldDefinition['type'];
+type CustomFieldOption = Schemas['CustomFieldOption'];
+
+export type { TitleLocationsIndex as A, CustomFieldDefinition as C, LocationSalaryDetail as L, PublicBoard as P, SkillSalaryDetail as S, TitleSalaryDetail as T, CompanyCategorySalary as a, CompanySalary as b, CompaniesListQuery as c, CompanyListEnvelope as d, CompaniesSearchBody as e, CompanyJobsListQuery as f, CompanySimilarQuery as g, CompanyMarketsListQuery as h, SalaryDetailQuery as i, CompanyMarket as j, CompanyMarketRef as k, CustomFieldOption as l, CustomFieldType as m, LocationSkillsIndex as n, LocationTitlesIndex as o, PublicBoardAnalytics as p, PublicBoardFeatures as q, PublicCompany as r, PublicCompanyDetail as s, SalaryCompany as t, SalaryLocation as u, SalarySkill as v, SalaryTitle as w, SkillLocationSalary as x, SkillLocationsIndex as y, TitleLocationSalary as z };

package/dist/breadcrumbs-1hMjcsqA.d.mts

@@ -0,0 +1,171 @@
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BJbXd_9_.mjs';
+import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.mjs';
+import { P as PublicJob } from './jobs-lVvKCBCU.mjs';
+
+/**
+ * Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
+ * types, transcribed field-by-field from the hosted board's generator
+ * (the hosted board implementation + `job-posting-location-json-ld.ts`) and
+ * tested against the hosted behavior.
+ *
+ * JSON-LD structure is locale-neutral per schema.org — no board-language
+ * parameter here; the only display strings are wire values passed through.
+ *
+ * Named exclusions (hosted behaviours with no wire twin, recorded in the
+ * public API contract):
+ *   - `board.companyLegalName` — hosted falls back to it for the
+ *     organization name between `company.name` and `board.name`; the wire
+ *     board context does not expose it.
+ *   - `board.companyWebsiteUrl` — hosted falls back to it for `sameAs` when
+ *     the company has no website; not on the wire.
+ *   - the hosted `job.place`/`locationLabel` jobLocation fallback (used when
+ *     a job has no office locations) — the wire `PublicJob` carries no
+ *     resolved place geo, only `officeLocations`.
+ */
+
+type JsonLdObject = Record<string, unknown>;
+/** The only board fields JSON-LD needs — keeps callers' shapes flexible. */
+type JsonLdBoard = Pick<PublicBoard, 'name' | 'logoUrl'>;
+/**
+ * Worldwide-remote jobs must still emit `applicantLocationRequirements`
+ * next to TELECOMMUTE (Google requires a location signal), so the hosted
+ * board — and this transcription — lists every country it recognises.
+ *
+ * This is the hosted board's exact country catalog: sorted by English common
+ * name, includes `XK` (Kosovo), and excludes `KP` (North Korea). tested
+ * against the hosted list so the two cannot drift.
+ */
+declare const ALL_COUNTRY_CODES: readonly ["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "CD", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "VI", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"];
+/**
+ * Build the Google for Jobs `JobPosting` JSON-LD object for a job detail
+ * page, or `null` when nothing renderable remains after pruning. Embed the
+ * result in a `<script type="application/ld+json">` tag.
+ */
+declare function createJobPostingJsonLd({ job, board, shareUrl, }: {
+    job: PublicJob;
+    board: JsonLdBoard;
+    shareUrl: string;
+}): JsonLdObject | null;
+/**
+ * Prefix `https://` onto scheme-less company websites; `null` for
+ * blank input (hosted shape — a whitespace-only website never becomes
+ * a bare `https://` `sameAs`).
+ */
+declare function normalizeWebsiteUrl(website: string): string | null;
+
+/**
+ * Compact USD amount in the board language (`$90K`, de: `90.000 $`) — the
+ * hosted salary-page money formatter. USD-hardcoded (hosted quirk); the
+ * locale drives digits, grouping, and symbol placement only.
+ */
+declare function formatUsd(locale: string, value: number): string;
+/** `formatUsd(min) – formatUsd(max)` with the hosted spaced en dash. */
+declare function formatRange(locale: string, min: number, max: number): string;
+/**
+ * Seniority display label. Precedence (hosted shape): owner override >
+ * board-language lexicon (en = the English source labels) > title-case
+ * fallback for an unknown key.
+ */
+declare function formatSeniority(locale: string, value: string, overrides?: Record<string, string>): string;
+/** The canonical seniority ladder order the hosted salary pages sort by. */
+declare const SENIORITY_ORDER: readonly ["entry_level", "associate", "mid_level", "senior", "lead", "principal", "director", "executive"];
+/** Sort rows by `SENIORITY_ORDER` (unknown keys sink to the end). Non-mutating. */
+declare function sortBySeniority<T extends {
+    seniority: string;
+}>(items: T[]): T[];
+interface FaqItem {
+    q: string;
+    a: string;
+}
+/**
+ * A templated salary FAQ (interim — see the module doc). The sentences are
+ * English; the embedded range is board-language-formatted via `formatRange`
+ * (the only part hosted localizes). Empty when there is no overall figure.
+ */
+declare function buildSalaryFaq(locale: string, label: string, overall: {
+    avgMin: number;
+    avgMax: number;
+    jobCount: number;
+} | null): FaqItem[];
+/** An `ItemList` for a salary index page (the listing's items + their URLs). */
+declare function itemListJsonLd(items: {
+    name: string;
+    url: string;
+}[]): JsonLdObject | null;
+/** A `FAQPage` from `buildSalaryFaq` items (or any `{q,a}` list). */
+declare function faqJsonLd(faqs: FaqItem[]): JsonLdObject | null;
+/**
+ * `Occupation` for a job-title salary page. Per-seniority distribution
+ * names embed the board-language seniority label (`formatSeniority`).
+ */
+declare function titleSalaryJsonLd(locale: string, d: TitleSalaryDetail): JsonLdObject | null;
+/** `Occupation` for a skill salary page (overall distribution + median). */
+declare function skillSalaryJsonLd(d: SkillSalaryDetail): JsonLdObject | null;
+/**
+ * `Occupation` for a location salary page. City-level pages only (the
+ * hosted page gates on city/locality); `null` otherwise.
+ */
+declare function locationSalaryJsonLd(d: LocationSalaryDetail): JsonLdObject | null;
+/**
+ * Cross-axis (title×location / skill×location) `Occupation` JSON-LD. Takes
+ * primitives to stay decoupled from the two cross-axis detail wire types.
+ */
+declare function crossAxisSalaryJsonLd(locale: string, args: {
+    name: string;
+    placeName: string;
+    countryCode: string;
+    overall: {
+        avgMin: number;
+        avgMax: number;
+        p25Min: number | null;
+        p75Max: number | null;
+    } | null;
+    bySeniority: {
+        seniority: string;
+        avgSalaryMin: number;
+        avgSalaryMax: number;
+    }[];
+    currency: string;
+}): JsonLdObject | null;
+/**
+ * `OccupationAggregationByEmployer` for a company's salary overview —
+ * mirrors the hosted company-salary page's Google-salary structured data
+ * (base + per-seniority distributions, the board median/IQR baseline as
+ * the aggregate stats).
+ */
+declare function companySalaryJsonLd(locale: string, d: CompanySalary): JsonLdObject | null;
+/** `Occupation` for one job category at a company (the hosted category page). */
+declare function companyCategorySalaryJsonLd(locale: string, d: CompanyCategorySalary): JsonLdObject | null;
+
+interface BreadcrumbItemInput {
+    label: string | null | undefined;
+    href?: string | null;
+}
+/**
+ * Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
+ * items dropped; fewer than 2 surviving items → `null` (a single crumb is
+ * not a trail); the current page (no `href`) omits `item` per schema.org.
+ * Relative hrefs resolve against `options.origin`; without an origin a
+ * relative item is omitted (never emit a relative `item` URL).
+ */
+declare function createBreadcrumbJsonLd(items: BreadcrumbItemInput[], options?: {
+    origin?: string | null;
+}): JsonLdObject | null;
+/**
+ * Home › Jobs › [country › region › city] › primaryCategory › Title.
+ * The place crumbs link into the listing routes (`/jobs/locations/:slug`);
+ * the category crumb nests under the most-specific place when present
+ * (`/jobs/locations/:place/:category`), else `/jobs/:category`. The last
+ * crumb (the job title) carries no `path` — the current page. Mirrors
+ * page.tsx:336-367.
+ *
+ * The Home/Jobs crumb names resolve from the copy catalog per board
+ * language ⊕ operator overrides; omitting `language` keeps the
+ * English source, so existing call sites render unchanged.
+ */
+declare function buildJobBreadcrumbs(job: PublicJob, language?: string, labels?: BoardLabelOverrides): Array<{
+    name: string;
+    path?: string;
+}>;
+
+export { ALL_COUNTRY_CODES as A, type BreadcrumbItemInput as B, type FaqItem as F, type JsonLdObject as J, SENIORITY_ORDER as S, formatUsd as a, buildJobBreadcrumbs as b, type JsonLdBoard as c, buildSalaryFaq as d, companyCategorySalaryJsonLd as e, formatRange as f, companySalaryJsonLd as g, createBreadcrumbJsonLd as h, createJobPostingJsonLd as i, crossAxisSalaryJsonLd as j, faqJsonLd as k, formatSeniority as l, itemListJsonLd as m, normalizeWebsiteUrl as n, locationSalaryJsonLd as o, sortBySeniority as p, skillSalaryJsonLd as s, titleSalaryJsonLd as t };

package/dist/breadcrumbs-DexU07TT.d.ts

@@ -0,0 +1,171 @@
+import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-JhdUWIoq.js';
+import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.js';
+import { P as PublicJob } from './jobs-BiEvL9d7.js';
+
+/**
+ * Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
+ * types, transcribed field-by-field from the hosted board's generator
+ * (the hosted board implementation + `job-posting-location-json-ld.ts`) and
+ * tested against the hosted behavior.
+ *
+ * JSON-LD structure is locale-neutral per schema.org — no board-language
+ * parameter here; the only display strings are wire values passed through.
+ *
+ * Named exclusions (hosted behaviours with no wire twin, recorded in the
+ * public API contract):
+ *   - `board.companyLegalName` — hosted falls back to it for the
+ *     organization name between `company.name` and `board.name`; the wire
+ *     board context does not expose it.
+ *   - `board.companyWebsiteUrl` — hosted falls back to it for `sameAs` when
+ *     the company has no website; not on the wire.
+ *   - the hosted `job.place`/`locationLabel` jobLocation fallback (used when
+ *     a job has no office locations) — the wire `PublicJob` carries no
+ *     resolved place geo, only `officeLocations`.
+ */
+
+type JsonLdObject = Record<string, unknown>;
+/** The only board fields JSON-LD needs — keeps callers' shapes flexible. */
+type JsonLdBoard = Pick<PublicBoard, 'name' | 'logoUrl'>;
+/**
+ * Worldwide-remote jobs must still emit `applicantLocationRequirements`
+ * next to TELECOMMUTE (Google requires a location signal), so the hosted
+ * board — and this transcription — lists every country it recognises.
+ *
+ * This is the hosted board's exact country catalog: sorted by English common
+ * name, includes `XK` (Kosovo), and excludes `KP` (North Korea). tested
+ * against the hosted list so the two cannot drift.
+ */
+declare const ALL_COUNTRY_CODES: readonly ["AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "CD", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "CI", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "VI", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW"];
+/**
+ * Build the Google for Jobs `JobPosting` JSON-LD object for a job detail
+ * page, or `null` when nothing renderable remains after pruning. Embed the
+ * result in a `<script type="application/ld+json">` tag.
+ */
+declare function createJobPostingJsonLd({ job, board, shareUrl, }: {
+    job: PublicJob;
+    board: JsonLdBoard;
+    shareUrl: string;
+}): JsonLdObject | null;
+/**
+ * Prefix `https://` onto scheme-less company websites; `null` for
+ * blank input (hosted shape — a whitespace-only website never becomes
+ * a bare `https://` `sameAs`).
+ */
+declare function normalizeWebsiteUrl(website: string): string | null;
+
+/**
+ * Compact USD amount in the board language (`$90K`, de: `90.000 $`) — the
+ * hosted salary-page money formatter. USD-hardcoded (hosted quirk); the
+ * locale drives digits, grouping, and symbol placement only.
+ */
+declare function formatUsd(locale: string, value: number): string;
+/** `formatUsd(min) – formatUsd(max)` with the hosted spaced en dash. */
+declare function formatRange(locale: string, min: number, max: number): string;
+/**
+ * Seniority display label. Precedence (hosted shape): owner override >
+ * board-language lexicon (en = the English source labels) > title-case
+ * fallback for an unknown key.
+ */
+declare function formatSeniority(locale: string, value: string, overrides?: Record<string, string>): string;
+/** The canonical seniority ladder order the hosted salary pages sort by. */
+declare const SENIORITY_ORDER: readonly ["entry_level", "associate", "mid_level", "senior", "lead", "principal", "director", "executive"];
+/** Sort rows by `SENIORITY_ORDER` (unknown keys sink to the end). Non-mutating. */
+declare function sortBySeniority<T extends {
+    seniority: string;
+}>(items: T[]): T[];
+interface FaqItem {
+    q: string;
+    a: string;
+}
+/**
+ * A templated salary FAQ (interim — see the module doc). The sentences are
+ * English; the embedded range is board-language-formatted via `formatRange`
+ * (the only part hosted localizes). Empty when there is no overall figure.
+ */
+declare function buildSalaryFaq(locale: string, label: string, overall: {
+    avgMin: number;
+    avgMax: number;
+    jobCount: number;
+} | null): FaqItem[];
+/** An `ItemList` for a salary index page (the listing's items + their URLs). */
+declare function itemListJsonLd(items: {
+    name: string;
+    url: string;
+}[]): JsonLdObject | null;
+/** A `FAQPage` from `buildSalaryFaq` items (or any `{q,a}` list). */
+declare function faqJsonLd(faqs: FaqItem[]): JsonLdObject | null;
+/**
+ * `Occupation` for a job-title salary page. Per-seniority distribution
+ * names embed the board-language seniority label (`formatSeniority`).
+ */
+declare function titleSalaryJsonLd(locale: string, d: TitleSalaryDetail): JsonLdObject | null;
+/** `Occupation` for a skill salary page (overall distribution + median). */
+declare function skillSalaryJsonLd(d: SkillSalaryDetail): JsonLdObject | null;
+/**
+ * `Occupation` for a location salary page. City-level pages only (the
+ * hosted page gates on city/locality); `null` otherwise.
+ */
+declare function locationSalaryJsonLd(d: LocationSalaryDetail): JsonLdObject | null;
+/**
+ * Cross-axis (title×location / skill×location) `Occupation` JSON-LD. Takes
+ * primitives to stay decoupled from the two cross-axis detail wire types.
+ */
+declare function crossAxisSalaryJsonLd(locale: string, args: {
+    name: string;
+    placeName: string;
+    countryCode: string;
+    overall: {
+        avgMin: number;
+        avgMax: number;
+        p25Min: number | null;
+        p75Max: number | null;
+    } | null;
+    bySeniority: {
+        seniority: string;
+        avgSalaryMin: number;
+        avgSalaryMax: number;
+    }[];
+    currency: string;
+}): JsonLdObject | null;
+/**
+ * `OccupationAggregationByEmployer` for a company's salary overview —
+ * mirrors the hosted company-salary page's Google-salary structured data
+ * (base + per-seniority distributions, the board median/IQR baseline as
+ * the aggregate stats).
+ */
+declare function companySalaryJsonLd(locale: string, d: CompanySalary): JsonLdObject | null;
+/** `Occupation` for one job category at a company (the hosted category page). */
+declare function companyCategorySalaryJsonLd(locale: string, d: CompanyCategorySalary): JsonLdObject | null;
+
+interface BreadcrumbItemInput {
+    label: string | null | undefined;
+    href?: string | null;
+}
+/**
+ * Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
+ * items dropped; fewer than 2 surviving items → `null` (a single crumb is
+ * not a trail); the current page (no `href`) omits `item` per schema.org.
+ * Relative hrefs resolve against `options.origin`; without an origin a
+ * relative item is omitted (never emit a relative `item` URL).
+ */
+declare function createBreadcrumbJsonLd(items: BreadcrumbItemInput[], options?: {
+    origin?: string | null;
+}): JsonLdObject | null;
+/**
+ * Home › Jobs › [country › region › city] › primaryCategory › Title.
+ * The place crumbs link into the listing routes (`/jobs/locations/:slug`);
+ * the category crumb nests under the most-specific place when present
+ * (`/jobs/locations/:place/:category`), else `/jobs/:category`. The last
+ * crumb (the job title) carries no `path` — the current page. Mirrors
+ * page.tsx:336-367.
+ *
+ * The Home/Jobs crumb names resolve from the copy catalog per board
+ * language ⊕ operator overrides; omitting `language` keeps the
+ * English source, so existing call sites render unchanged.
+ */
+declare function buildJobBreadcrumbs(job: PublicJob, language?: string, labels?: BoardLabelOverrides): Array<{
+    name: string;
+    path?: string;
+}>;
+
+export { ALL_COUNTRY_CODES as A, type BreadcrumbItemInput as B, type FaqItem as F, type JsonLdObject as J, SENIORITY_ORDER as S, formatUsd as a, buildJobBreadcrumbs as b, type JsonLdBoard as c, buildSalaryFaq as d, companyCategorySalaryJsonLd as e, formatRange as f, companySalaryJsonLd as g, createBreadcrumbJsonLd as h, createJobPostingJsonLd as i, crossAxisSalaryJsonLd as j, faqJsonLd as k, formatSeniority as l, itemListJsonLd as m, normalizeWebsiteUrl as n, locationSalaryJsonLd as o, sortBySeniority as p, skillSalaryJsonLd as s, titleSalaryJsonLd as t };