@cavuno/board 1.25.0 → 1.26.0

package/dist/filters.mjs

@@ -0,0 +1,170 @@
+// src/format/salary-lexicon.ts
+var EN = {
+  timeframe: {
+    per_year: "Yearly",
+    per_month: "Monthly",
+    per_week: "Weekly",
+    per_day: "Daily",
+    per_hour: "Hourly"
+  },
+  rangePrefix: { from: "From", upTo: "Up to" },
+  seniority: {
+    entry_level: "Entry level",
+    associate: "Associate",
+    mid_level: "Mid-level",
+    senior: "Senior",
+    lead: "Lead",
+    principal: "Principal",
+    director: "Director",
+    executive: "Executive"
+  },
+  frames: {
+    entitySalariesTitle: ({ entity, range }) => `${entity} Salaries (${range}/yr)`,
+    salariesInPlaceTitle: ({ place, range }) => `Salaries in ${place} (${range}/yr)`,
+    salariesInPlaceTitleNoRange: ({ place }) => `Salaries in ${place}`,
+    entitySalariesInPlaceTitle: ({ entity, place, range }) => `${entity} Salaries in ${place} (${range}/yr)`,
+    companySalariesTitle: ({ company, range }) => `${company} Salaries${range ? ` (${range}/yr)` : ""}`,
+    companyCategorySalariesTitle: ({ company, category, range }) => `${company} ${category} Salaries${range ? ` (${range}/yr)` : ""}`,
+    professionalsEarn: ({ entity, range, count }) => `${entity} professionals earn ${range}/yr on average across ${count} job postings.`,
+    rolesPay: ({ entity, range, count }) => `${entity} roles pay ${range}/yr on average across ${count} job postings.`,
+    professionalsInLocationEarn: ({ entity, place, range, count }) => `${entity} professionals in ${place} earn ${range}/yr on average across ${count} job postings.`,
+    seniorityRange: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel} roles start at ${lowAmount}, ${highLabel} roles reach ${highAmount}.`,
+    seniorityRangeWhile: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel} salaries start at ${lowAmount}, while ${highLabel} roles reach ${highAmount}.`,
+    compareAcrossTopPaying: ({ count }) => `Compare across ${count} top-paying ${count === 1 ? "company" : "companies"}.`,
+    compareAcrossTop: ({ count }) => `Compare across ${count} top ${count === 1 ? "company" : "companies"}.`,
+    boardWideAverage: ({ entity, range }) => `Board-wide ${entity} average: ${range}/yr.`,
+    averageSalaryInCity: ({ place, range, count }) => `Average salary in ${place} is ${range}/yr across ${count} jobs. Browse salary data by title and skill.`,
+    browseLocationsInRegion: ({ count, place }) => `Browse salary data across ${count} locations in ${place}. Compare salaries by title, skill, and company.`,
+    companyPays: ({ company, range, count }) => `${company} pays ${range}/yr on average across ${count} job postings.`,
+    breakdownAcrossCategories: ({ count }) => `Breakdown across ${count} job ${count === 1 ? "category" : "categories"}.`,
+    compareWithSimilar: ({ count }) => `Compare with ${count} similar ${count === 1 ? "company" : "companies"}.`,
+    salaryInfoFor: ({ company, board }) => `Salary information for ${company} on ${board}.`,
+    categoryRolesAtCompanyPay: ({ category, company, range, count }) => `${category} roles at ${company} pay ${range}/yr based on ${count} job postings.`,
+    categorySalaryDataFor: ({ category, company, board }) => `${category} salary data for ${company} on ${board}.`
+  }
+};
+var DE = {
+  timeframe: {
+    per_year: "pro Jahr",
+    per_month: "pro Monat",
+    per_week: "pro Woche",
+    per_day: "pro Tag",
+    per_hour: "pro Stunde"
+  },
+  rangePrefix: { from: "ab", upTo: "bis zu" },
+  seniority: {
+    entry_level: "Entry-Level",
+    associate: "Associate",
+    mid_level: "Mid-Level",
+    senior: "Senior",
+    lead: "Lead",
+    principal: "Principal",
+    director: "Director",
+    executive: "F\xFChrungskraft"
+  },
+  frames: {
+    entitySalariesTitle: ({ entity, range }) => `${entity} Geh\xE4lter (${range}/Jahr)`,
+    salariesInPlaceTitle: ({ place, range }) => `Geh\xE4lter in ${place} (${range}/Jahr)`,
+    salariesInPlaceTitleNoRange: ({ place }) => `Geh\xE4lter in ${place}`,
+    entitySalariesInPlaceTitle: ({ entity, place, range }) => `${entity} Geh\xE4lter in ${place} (${range}/Jahr)`,
+    companySalariesTitle: ({ company, range }) => `${company} Geh\xE4lter${range ? ` (${range}/Jahr)` : ""}`,
+    companyCategorySalariesTitle: ({ company, category, range }) => `${company} ${category} Geh\xE4lter${range ? ` (${range}/Jahr)` : ""}`,
+    professionalsEarn: ({ entity, range, count }) => `${entity}-Fachkr\xE4fte verdienen durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    rolesPay: ({ entity, range, count }) => `${entity}-Positionen werden mit durchschnittlich ${range}/Jahr verg\xFCtet, basierend auf ${count} Stellenanzeigen.`,
+    professionalsInLocationEarn: ({ entity, place, range, count }) => `${entity}-Fachkr\xE4fte in ${place} verdienen durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    seniorityRange: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel}-Positionen beginnen bei ${lowAmount}, ${highLabel}-Positionen erreichen ${highAmount}.`,
+    seniorityRangeWhile: ({ lowLabel, lowAmount, highLabel, highAmount }) => `${lowLabel}-Geh\xE4lter beginnen bei ${lowAmount}, w\xE4hrend ${highLabel}-Positionen ${highAmount} erreichen.`,
+    compareAcrossTopPaying: ({ count }) => `Vergleichen Sie ${count} ${count === 1 ? "bestzahlendes" : "bestzahlende"} Unternehmen.`,
+    compareAcrossTop: ({ count }) => `Vergleichen Sie ${count} Top-Unternehmen.`,
+    boardWideAverage: ({ entity, range }) => `Gesamtdurchschnitt ${entity}: ${range}/Jahr.`,
+    averageSalaryInCity: ({ place, range, count }) => `Das Durchschnittsgehalt in ${place} betr\xE4gt ${range}/Jahr, basierend auf ${count} Stellen. Gehaltsdaten nach Titel und F\xE4higkeiten durchsuchen.`,
+    browseLocationsInRegion: ({ count, place }) => `Gehaltsdaten f\xFCr ${count} Standorte in ${place} durchsuchen. Geh\xE4lter nach Titel, F\xE4higkeiten und Unternehmen vergleichen.`,
+    companyPays: ({ company, range, count }) => `${company} zahlt durchschnittlich ${range}/Jahr, basierend auf ${count} Stellenanzeigen.`,
+    breakdownAcrossCategories: ({ count }) => `Aufschl\xFCsselung \xFCber ${count} Job-${count === 1 ? "Kategorie" : "Kategorien"}.`,
+    compareWithSimilar: ({ count }) => `Vergleichen Sie mit ${count} \xE4hnlichen Unternehmen.`,
+    salaryInfoFor: ({ company, board }) => `Gehaltsinformationen f\xFCr ${company} auf ${board}.`,
+    categoryRolesAtCompanyPay: ({ category, company, range, count }) => `${category}-Positionen bei ${company} werden mit ${range}/Jahr verg\xFCtet, basierend auf ${count} Stellenanzeigen.`,
+    categorySalaryDataFor: ({ category, company, board }) => `${category}-Gehaltsdaten f\xFCr ${company} auf ${board}.`
+  }
+};
+var LEXICONS = { en: EN, de: DE };
+function getSalaryLexicon(locale) {
+  return locale && LEXICONS[locale] || EN;
+}
+
+// src/filters/index.ts
+var REMOTE_OPTIONS = [
+  "on_site",
+  "hybrid",
+  "remote"
+];
+var EMPLOYMENT_TYPES = [
+  "full_time",
+  "part_time",
+  "contract",
+  "internship",
+  "temporary"
+];
+var SENIORITIES = [
+  "entry_level",
+  "associate",
+  "mid_level",
+  "senior",
+  "lead",
+  "principal",
+  "director",
+  "executive"
+];
+var JOB_SORTS = [
+  "relevance",
+  "newest",
+  "salary_high"
+];
+var DEFAULT_SORT = "relevance";
+function seniorityLabels(locale) {
+  return getSalaryLexicon(locale).seniority;
+}
+function sortLabels(_locale) {
+  return {
+    relevance: "AI-ranked",
+    newest: "Most recent",
+    salary_high: "Salary: high to low"
+  };
+}
+var SENIORITY_LOOKUP = new Set(SENIORITIES);
+function parseSeniority(raw) {
+  const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (typeof value !== "string") continue;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized || seen.has(normalized)) continue;
+    if (!SENIORITY_LOOKUP.has(normalized)) continue;
+    seen.add(normalized);
+    result.push(normalized);
+  }
+  return result.length > 0 ? result : void 0;
+}
+function parseListingFilters(search) {
+  return {
+    q: typeof search.q === "string" && search.q ? search.q : void 0,
+    remoteOption: REMOTE_OPTIONS.includes(search.remoteOption) ? search.remoteOption : void 0,
+    employmentType: EMPLOYMENT_TYPES.includes(
+      search.employmentType
+    ) ? search.employmentType : void 0,
+    seniority: parseSeniority(search.seniority),
+    sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
+  };
+}
+export {
+  DEFAULT_SORT,
+  EMPLOYMENT_TYPES,
+  JOB_SORTS,
+  REMOTE_OPTIONS,
+  SENIORITIES,
+  parseListingFilters,
+  parseSeniority,
+  seniorityLabels,
+  sortLabels
+};

package/dist/format.d.mts

@@ -0,0 +1,240 @@
+import { P as PublicJob, m as PublicJobCard } from './jobs-CM67_J6H.mjs';
+
+/**
+ * Date display helpers in the board language (required leading parameter,
+ * ADR-0057) — transcribed from the hosted board's `date-labels.ts` and
+ * golden-tested against it in-monorepo.
+ *
+ * Job cards and the job-detail header render the RELATIVE form
+ * (`formatPublishedRelativeDate` — "5d ago"); the absolute medium date
+ * (`formatDate`) is what hosted uses for blog metadata and detail facts.
+ */
+/**
+ * Absolute medium date in the board language, UTC-pinned — e.g.
+ * "Jun 24, 2026" (`en`) / "24.06.2026"-style per locale. What hosted uses
+ * for blog metadata and detail facts; job CARDS use the relative form.
+ * Returns `null` for missing/unparseable input.
+ */
+declare function formatDate(locale: string, value: string | number | null): string | null;
+/**
+ * Relative published label — "5d ago" (en) / "vor 5 T." (de) — the form the
+ * hosted board renders on job cards and the job-detail header. Under one
+ * minute renders "now". `referenceNowMs` exists for deterministic tests.
+ */
+declare function formatPublishedRelativeDate(locale: string, value: string | number | null, referenceNowMs?: number): string | null;
+/**
+ * Month-year label, e.g. "Jun 2023" — transcribed from the hosted board's
+ * `formatMonthYear` (golden-tested in-monorepo). The `T00:00:00` suffix
+ * prevents timezone-related off-by-one-month issues on date-only strings.
+ */
+declare function formatMonthYear(locale: string, dateStr: string): string;
+
+/**
+ * Adapt a full `PublicJob` (e.g. an embedded saved job) to the slim
+ * `PublicJobCard` shape a list card renders — computing the card's
+ * pre-resolved `locationLabel`/`remoteLocationLabel` from the full job's
+ * fields. Board language is required because the computed location label is
+ * display text (ADR-0057).
+ */
+declare function fullJobToCard(locale: string, job: PublicJob): PublicJobCard;
+
+/**
+ * Display label for a job enum value (`remoteOption`, `employmentType`,
+ * `seniority`) in the board language. Unknown values pass through unchanged
+ * (enums grow additively within v1).
+ *
+ * @example
+ * fieldLabel('en', 'mid_level'); // "Mid-level"
+ * fieldLabel('de', 'executive'); // "Führungskraft"
+ * fieldLabel('de', 'full_time'); // "Full-time" (hosted parity: en-only vocab)
+ */
+declare function fieldLabel(locale: string, value: string | null): string | null;
+
+/**
+ * Location display labels for job cards and detail pages, in the board
+ * language (required leading parameter, ADR-0057). The wrapper words
+ * ("Remote", "(hybrid)", "Worldwide") follow the hosted board's current
+ * English-only rendering; place names arrive already board-language from the
+ * wire (the API serves canonical, localized labels).
+ */
+/**
+ * Location label for the full `PublicJob` (detail pages, embedded saved
+ * jobs): first office location's display name, remote/hybrid wrapping per
+ * `remoteOption`.
+ */
+declare function locationLabel(locale: string, job: PublicJob): string;
+/**
+ * Location label for a list CARD. The card read-model pre-computes
+ * `locationLabel` and (for remote jobs) `remoteLocationLabel` server-side —
+ * the slim card carries no `officeLocations`/`remoteWorldwide` — so those
+ * wire fields are used directly, matching what the hosted card renders.
+ */
+declare function cardLocationLabel(locale: string, job: Pick<PublicJobCard, 'remoteOption' | 'remoteLocationLabel' | 'locationLabel'>): string;
+
+/**
+ * The closed, board-language salary LEXICON — the fixed salary words:
+ * timeframe labels + range prefixes, seniority labels, and metadata
+ * `<title>`/`<description>` sentence FRAMES, keyed by the board language
+ * (`board.context().language`), NOT by any visitor locale.
+ *
+ * Transcribed from the hosted board's `salary-lexicon.ts` (CAV-352 /
+ * ADR-0012) and golden-tested against it in-monorepo (ADR-0057): the two
+ * copies cannot drift silently. The `de` strings are native-reviewed.
+ * Unseeded locales fall back to the English source WORDS while number and
+ * currency formatting stays locale-correct.
+ */
+/** Wire enum for `salaryTimeframe`. */
+type SalaryTimeframeValue = 'per_year' | 'per_month' | 'per_week' | 'per_day' | 'per_hour';
+type SeniorityKey = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
+/**
+ * Board-language builders for the salary-page metadata sentence frames. Each
+ * receives already-formatted parts (entity name, board-language `range`/amount
+ * strings, counts) and returns one localized sentence. The numbers are
+ * formatted upstream (`formatSalaryRange`); the FRAME is the words.
+ */
+interface SalaryFrames {
+    entitySalariesTitle(a: {
+        entity: string;
+        range: string;
+    }): string;
+    salariesInPlaceTitle(a: {
+        place: string;
+        range: string;
+    }): string;
+    salariesInPlaceTitleNoRange(a: {
+        place: string;
+    }): string;
+    entitySalariesInPlaceTitle(a: {
+        entity: string;
+        place: string;
+        range: string;
+    }): string;
+    companySalariesTitle(a: {
+        company: string;
+        range: string | null;
+    }): string;
+    companyCategorySalariesTitle(a: {
+        company: string;
+        category: string;
+        range: string | null;
+    }): string;
+    professionalsEarn(a: {
+        entity: string;
+        range: string;
+        count: number;
+    }): string;
+    rolesPay(a: {
+        entity: string;
+        range: string;
+        count: number;
+    }): string;
+    professionalsInLocationEarn(a: {
+        entity: string;
+        place: string;
+        range: string;
+        count: number;
+    }): string;
+    seniorityRange(a: {
+        lowLabel: string;
+        lowAmount: string;
+        highLabel: string;
+        highAmount: string;
+    }): string;
+    seniorityRangeWhile(a: {
+        lowLabel: string;
+        lowAmount: string;
+        highLabel: string;
+        highAmount: string;
+    }): string;
+    compareAcrossTopPaying(a: {
+        count: number;
+    }): string;
+    compareAcrossTop(a: {
+        count: number;
+    }): string;
+    boardWideAverage(a: {
+        entity: string;
+        range: string;
+    }): string;
+    averageSalaryInCity(a: {
+        place: string;
+        range: string;
+        count: number;
+    }): string;
+    browseLocationsInRegion(a: {
+        count: number;
+        place: string;
+    }): string;
+    companyPays(a: {
+        company: string;
+        range: string;
+        count: number;
+    }): string;
+    breakdownAcrossCategories(a: {
+        count: number;
+    }): string;
+    compareWithSimilar(a: {
+        count: number;
+    }): string;
+    salaryInfoFor(a: {
+        company: string;
+        board: string;
+    }): string;
+    categoryRolesAtCompanyPay(a: {
+        category: string;
+        company: string;
+        range: string;
+        count: number;
+    }): string;
+    categorySalaryDataFor(a: {
+        category: string;
+        company: string;
+        board: string;
+    }): string;
+}
+interface SalaryLexicon {
+    /** Per-timeframe display word, e.g. `per_year` → "Yearly" / "pro Jahr". */
+    timeframe: Record<SalaryTimeframeValue, string>;
+    /** Open-ended range prefixes, e.g. "From" / "ab", "Up to" / "bis zu". */
+    rangePrefix: {
+        from: string;
+        upTo: string;
+    };
+    /** Seniority-level labels, e.g. `senior` → "Senior". */
+    seniority: Record<SeniorityKey, string>;
+    /** Metadata `<title>`/`<description>` sentence builders. */
+    frames: SalaryFrames;
+}
+/**
+ * Resolve the salary lexicon for a board language; unseeded locales fall back
+ * to the English source.
+ */
+declare function getSalaryLexicon(locale: string | undefined): SalaryLexicon;
+
+type SalaryTimeframeInput = SalaryTimeframeValue | string | null | undefined;
+/** Owner-customized timeframe words (board settings) — from the board's SEO/labels config. */
+interface SalaryTimeframeOverrides {
+    yearlyLabel?: string;
+    monthlyLabel?: string;
+    weeklyLabel?: string;
+    dailyLabel?: string;
+    hourlyLabel?: string;
+}
+/**
+ * Format a per-job salary range in the BOARD language
+ * (`board.context().language` — required, never defaulted; see ADR-0057).
+ * The fixed words (timeframe, "From"/"Up to") come from
+ * `getSalaryLexicon(language)` with precedence owner-override > lexicon >
+ * English source. Currency placement is gated: `en` keeps the legacy manual
+ * symbol-before form (byte-identical to the hosted board); non-`en` uses
+ * `Intl` `style:'currency'` so the symbol sits per locale.
+ *
+ * @example
+ * formatSalaryRange('en', 90000, 120000, 'per_year', 'USD');
+ * // "$90K – $120K Yearly"
+ * formatSalaryRange('de', 90000, null, 'per_year', 'EUR');
+ * // "ab 90.000 € pro Jahr"
+ */
+declare function formatSalaryRange(language: string | undefined, min: number | null, max: number | null, timeframe: SalaryTimeframeInput, currency?: string | null, timeframeOverrides?: SalaryTimeframeOverrides): string | null;
+
+export { type SalaryFrames, type SalaryLexicon, type SalaryTimeframeInput, type SalaryTimeframeOverrides, type SalaryTimeframeValue, type SeniorityKey, cardLocationLabel, fieldLabel, formatDate, formatMonthYear, formatPublishedRelativeDate, formatSalaryRange, fullJobToCard, getSalaryLexicon, locationLabel };

package/dist/format.d.ts

@@ -0,0 +1,240 @@
+import { P as PublicJob, m as PublicJobCard } from './jobs-CM67_J6H.js';
+
+/**
+ * Date display helpers in the board language (required leading parameter,
+ * ADR-0057) — transcribed from the hosted board's `date-labels.ts` and
+ * golden-tested against it in-monorepo.
+ *
+ * Job cards and the job-detail header render the RELATIVE form
+ * (`formatPublishedRelativeDate` — "5d ago"); the absolute medium date
+ * (`formatDate`) is what hosted uses for blog metadata and detail facts.
+ */
+/**
+ * Absolute medium date in the board language, UTC-pinned — e.g.
+ * "Jun 24, 2026" (`en`) / "24.06.2026"-style per locale. What hosted uses
+ * for blog metadata and detail facts; job CARDS use the relative form.
+ * Returns `null` for missing/unparseable input.
+ */
+declare function formatDate(locale: string, value: string | number | null): string | null;
+/**
+ * Relative published label — "5d ago" (en) / "vor 5 T." (de) — the form the
+ * hosted board renders on job cards and the job-detail header. Under one
+ * minute renders "now". `referenceNowMs` exists for deterministic tests.
+ */
+declare function formatPublishedRelativeDate(locale: string, value: string | number | null, referenceNowMs?: number): string | null;
+/**
+ * Month-year label, e.g. "Jun 2023" — transcribed from the hosted board's
+ * `formatMonthYear` (golden-tested in-monorepo). The `T00:00:00` suffix
+ * prevents timezone-related off-by-one-month issues on date-only strings.
+ */
+declare function formatMonthYear(locale: string, dateStr: string): string;
+
+/**
+ * Adapt a full `PublicJob` (e.g. an embedded saved job) to the slim
+ * `PublicJobCard` shape a list card renders — computing the card's
+ * pre-resolved `locationLabel`/`remoteLocationLabel` from the full job's
+ * fields. Board language is required because the computed location label is
+ * display text (ADR-0057).
+ */
+declare function fullJobToCard(locale: string, job: PublicJob): PublicJobCard;
+
+/**
+ * Display label for a job enum value (`remoteOption`, `employmentType`,
+ * `seniority`) in the board language. Unknown values pass through unchanged
+ * (enums grow additively within v1).
+ *
+ * @example
+ * fieldLabel('en', 'mid_level'); // "Mid-level"
+ * fieldLabel('de', 'executive'); // "Führungskraft"
+ * fieldLabel('de', 'full_time'); // "Full-time" (hosted parity: en-only vocab)
+ */
+declare function fieldLabel(locale: string, value: string | null): string | null;
+
+/**
+ * Location display labels for job cards and detail pages, in the board
+ * language (required leading parameter, ADR-0057). The wrapper words
+ * ("Remote", "(hybrid)", "Worldwide") follow the hosted board's current
+ * English-only rendering; place names arrive already board-language from the
+ * wire (the API serves canonical, localized labels).
+ */
+/**
+ * Location label for the full `PublicJob` (detail pages, embedded saved
+ * jobs): first office location's display name, remote/hybrid wrapping per
+ * `remoteOption`.
+ */
+declare function locationLabel(locale: string, job: PublicJob): string;
+/**
+ * Location label for a list CARD. The card read-model pre-computes
+ * `locationLabel` and (for remote jobs) `remoteLocationLabel` server-side —
+ * the slim card carries no `officeLocations`/`remoteWorldwide` — so those
+ * wire fields are used directly, matching what the hosted card renders.
+ */
+declare function cardLocationLabel(locale: string, job: Pick<PublicJobCard, 'remoteOption' | 'remoteLocationLabel' | 'locationLabel'>): string;
+
+/**
+ * The closed, board-language salary LEXICON — the fixed salary words:
+ * timeframe labels + range prefixes, seniority labels, and metadata
+ * `<title>`/`<description>` sentence FRAMES, keyed by the board language
+ * (`board.context().language`), NOT by any visitor locale.
+ *
+ * Transcribed from the hosted board's `salary-lexicon.ts` (CAV-352 /
+ * ADR-0012) and golden-tested against it in-monorepo (ADR-0057): the two
+ * copies cannot drift silently. The `de` strings are native-reviewed.
+ * Unseeded locales fall back to the English source WORDS while number and
+ * currency formatting stays locale-correct.
+ */
+/** Wire enum for `salaryTimeframe`. */
+type SalaryTimeframeValue = 'per_year' | 'per_month' | 'per_week' | 'per_day' | 'per_hour';
+type SeniorityKey = 'entry_level' | 'associate' | 'mid_level' | 'senior' | 'lead' | 'principal' | 'director' | 'executive';
+/**
+ * Board-language builders for the salary-page metadata sentence frames. Each
+ * receives already-formatted parts (entity name, board-language `range`/amount
+ * strings, counts) and returns one localized sentence. The numbers are
+ * formatted upstream (`formatSalaryRange`); the FRAME is the words.
+ */
+interface SalaryFrames {
+    entitySalariesTitle(a: {
+        entity: string;
+        range: string;
+    }): string;
+    salariesInPlaceTitle(a: {
+        place: string;
+        range: string;
+    }): string;
+    salariesInPlaceTitleNoRange(a: {
+        place: string;
+    }): string;
+    entitySalariesInPlaceTitle(a: {
+        entity: string;
+        place: string;
+        range: string;
+    }): string;
+    companySalariesTitle(a: {
+        company: string;
+        range: string | null;
+    }): string;
+    companyCategorySalariesTitle(a: {
+        company: string;
+        category: string;
+        range: string | null;
+    }): string;
+    professionalsEarn(a: {
+        entity: string;
+        range: string;
+        count: number;
+    }): string;
+    rolesPay(a: {
+        entity: string;
+        range: string;
+        count: number;
+    }): string;
+    professionalsInLocationEarn(a: {
+        entity: string;
+        place: string;
+        range: string;
+        count: number;
+    }): string;
+    seniorityRange(a: {
+        lowLabel: string;
+        lowAmount: string;
+        highLabel: string;
+        highAmount: string;
+    }): string;
+    seniorityRangeWhile(a: {
+        lowLabel: string;
+        lowAmount: string;
+        highLabel: string;
+        highAmount: string;
+    }): string;
+    compareAcrossTopPaying(a: {
+        count: number;
+    }): string;
+    compareAcrossTop(a: {
+        count: number;
+    }): string;
+    boardWideAverage(a: {
+        entity: string;
+        range: string;
+    }): string;
+    averageSalaryInCity(a: {
+        place: string;
+        range: string;
+        count: number;
+    }): string;
+    browseLocationsInRegion(a: {
+        count: number;
+        place: string;
+    }): string;
+    companyPays(a: {
+        company: string;
+        range: string;
+        count: number;
+    }): string;
+    breakdownAcrossCategories(a: {
+        count: number;
+    }): string;
+    compareWithSimilar(a: {
+        count: number;
+    }): string;
+    salaryInfoFor(a: {
+        company: string;
+        board: string;
+    }): string;
+    categoryRolesAtCompanyPay(a: {
+        category: string;
+        company: string;
+        range: string;
+        count: number;
+    }): string;
+    categorySalaryDataFor(a: {
+        category: string;
+        company: string;
+        board: string;
+    }): string;
+}
+interface SalaryLexicon {
+    /** Per-timeframe display word, e.g. `per_year` → "Yearly" / "pro Jahr". */
+    timeframe: Record<SalaryTimeframeValue, string>;
+    /** Open-ended range prefixes, e.g. "From" / "ab", "Up to" / "bis zu". */
+    rangePrefix: {
+        from: string;
+        upTo: string;
+    };
+    /** Seniority-level labels, e.g. `senior` → "Senior". */
+    seniority: Record<SeniorityKey, string>;
+    /** Metadata `<title>`/`<description>` sentence builders. */
+    frames: SalaryFrames;
+}
+/**
+ * Resolve the salary lexicon for a board language; unseeded locales fall back
+ * to the English source.
+ */
+declare function getSalaryLexicon(locale: string | undefined): SalaryLexicon;
+
+type SalaryTimeframeInput = SalaryTimeframeValue | string | null | undefined;
+/** Owner-customized timeframe words (board settings) — from the board's SEO/labels config. */
+interface SalaryTimeframeOverrides {
+    yearlyLabel?: string;
+    monthlyLabel?: string;
+    weeklyLabel?: string;
+    dailyLabel?: string;
+    hourlyLabel?: string;
+}
+/**
+ * Format a per-job salary range in the BOARD language
+ * (`board.context().language` — required, never defaulted; see ADR-0057).
+ * The fixed words (timeframe, "From"/"Up to") come from
+ * `getSalaryLexicon(language)` with precedence owner-override > lexicon >
+ * English source. Currency placement is gated: `en` keeps the legacy manual
+ * symbol-before form (byte-identical to the hosted board); non-`en` uses
+ * `Intl` `style:'currency'` so the symbol sits per locale.
+ *
+ * @example
+ * formatSalaryRange('en', 90000, 120000, 'per_year', 'USD');
+ * // "$90K – $120K Yearly"
+ * formatSalaryRange('de', 90000, null, 'per_year', 'EUR');
+ * // "ab 90.000 € pro Jahr"
+ */
+declare function formatSalaryRange(language: string | undefined, min: number | null, max: number | null, timeframe: SalaryTimeframeInput, currency?: string | null, timeframeOverrides?: SalaryTimeframeOverrides): string | null;
+
+export { type SalaryFrames, type SalaryLexicon, type SalaryTimeframeInput, type SalaryTimeframeOverrides, type SalaryTimeframeValue, type SeniorityKey, cardLocationLabel, fieldLabel, formatDate, formatMonthYear, formatPublishedRelativeDate, formatSalaryRange, fullJobToCard, getSalaryLexicon, locationLabel };