@cavuno/board 3.2.0 → 4.0.0

package/dist/format.d.ts

@@ -1,9 +1,7 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-BiEvL9d7.js';
-import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.js';
-export { A as AlertsCopy, a as ApplyCopy, b as BlogCopy, c as BreadcrumbsCopy, C as CopyLinkCopy, E as EntityCopy, F as FooterCopy, J as JobCardCopy, d as JobDetailCopy, e as JobSearchCopy, N as NavCopy, P as PUBLIC_LABEL_GROUPS, f as PaginationCopy, S as SalaryCopy, U as UiCopy, u as uiCopy } from './ui-copy-CCkz6CVF.js';
-export { b as buildJobBreadcrumbs, f as formatSalaryStatRange, a as formatSalaryStatUsd, n as normalizeWebsiteUrl } from './breadcrumbs-DexU07TT.js';
-import { C as CustomFieldDefinition } from './board-JhdUWIoq.js';
-import './_spec-nkWAraS0.js';
+export { C as CurrencyDisplay, F as FormattedSalaryRange, J as JobBreadcrumb, N as NumberNotation, S as SalaryTimeframeInput, a as SalaryTimeframeValue, b as buildJobBreadcrumbs, f as formatSalaryRange, c as formatSalaryStat, d as formatSalaryStatRange, n as normalizeWebsiteUrl } from './breadcrumbs-DiccJhk4.js';
+import { C as CustomFieldDefinition } from './board-DUhgiacm.js';
+import { C as CustomFieldValues } from './jobs-QrbXOYB9.js';
+import './_spec-GVe6WAfT.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,
@@ -11,8 +9,12 @@ import './_spec-nkWAraS0.js';
  * tested against the hosted behavior.
  *
  * Job cards and the job-detail header render the RELATIVE form
- * (`formatPublishedRelativeDate` — "5d ago"); the absolute medium date
+ * (`formatPublishedRelativeDate` — "5 days ago"); the absolute medium date
  * (`formatDate`) is what hosted uses for blog metadata and detail facts.
+ *
+ * Invalid locales return `null` rather than English unit abbreviations
+ * (`5d` / `5mo`) or a sign-stripped digit string. Past vs future is kept
+ * (negative → past) so RTF can own the word.
  */
 /**
  * Absolute medium date in the board language, UTC-pinned — e.g.
@@ -22,229 +24,28 @@ import './_spec-nkWAraS0.js';
  */
 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.
+ * Relative published label — "5 days ago" (en) / "vor 5 Tagen" (de) — the
+ * form the hosted board renders on job cards and the job-detail header.
+ * Under one minute uses `Intl.RelativeTimeFormat` with `numeric: 'auto'` so
+ * the board language owns "now" / "jetzt" / "maintenant". `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`. 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.
- */
-declare function fullJobToCard(locale: string, job: PublicJob): PublicJobCard;
-
-/**
- * Display label for a job enum value (`remoteOption`, `employmentType`,
- * `seniority`) in the board language, ⊕ the board's stored operator
- * overrides when the `labels` bag is passed. Unknown values pass through
- * unchanged (enums grow additively within v1); unseeded languages fall back
- * to the English source vocabulary.
+ * `formatMonthYear`.
  *
- * @example
- * fieldLabel('en', 'mid_level'); // "Mid-level"
- * fieldLabel('de', 'executive'); // "Führungskraft"
- * fieldLabel('de', 'full_time'); // "Vollzeit"
- * fieldLabel('de', 'full_time', board.labels); // operator override when set
- */
-declare function fieldLabel(locale: string, value: string | null, labels?: BoardLabelOverrides): string | null;
-
-/**
- * Location display labels for job cards and detail pages, in the board
- * language. 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`  and tested against it : 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 ).
- * 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;
-
-declare function companyIntro(summary: string | null, description: string | null): string | null;
+ * - Date-only inputs (`YYYY-MM`, `YYYY-MM-DD`) get a UTC midnight pin
+ *   (`T00:00:00.000Z`) so the UTC formatter below keeps the same calendar
+ *   month. Local midnight + `timeZone: 'UTC'` would shift western zones
+ *   back a day (e.g. Jun 1 AEST → May 31 UTC).
+ * - Full ISO timestamps are formatted with `timeZone: 'UTC'` (same pin as
+ *   `formatDate`) so a UTC midnight never renders as the previous month
+ *   under America/Los_Angeles.
+ * - Missing or unparseable input returns `null`, matching `formatDate` —
+ *   never the English literal `"Invalid Date"`.
+ */
+declare function formatMonthYear(locale: string, dateStr: string | null | undefined): string | null;
 
 /**
  * ISO 3166-1 alpha-2 country lexicon — the `country` slice of the remote-
@@ -265,7 +66,9 @@ interface CountryOption {
  * The complete country option list, display-named in the BOARD language
  * and sorted by that language's
  * collation — the shape a country picker renders. Falls back to the bare
- * code when the runtime cannot resolve the language or name a region.
+ * code when the runtime cannot name a region. When the board language is
+ * invalid or unsupported (`normalizeLocale` → `null`), returns ISO codes
+ * as names sorted by code — never host-default English names/collation.
  */
 declare function countryOptions(language: string): CountryOption[];
 
@@ -276,9 +79,22 @@ declare function countryOptions(language: string): CountryOption[];
  * context) in config order, so display order is operator-controlled, orphan
  * values (deleted definitions) are never inspected, and empty values drop per
  * field. Select values resolve their stored option KEY to the current label
- * (rename-safe); an option with no current match is dropped. Booleans stay raw
- * (a discriminated `kind`) — the render layer authors the "Yes"/"No" chrome
- * (English; localized copy is the use-intl future release).
+ * (rename-safe); an option with no current match is dropped. Booleans and
+ * numbers stay raw (discriminated `kind`) — the render layer formats them
+ * with the board locale (`Intl.NumberFormat`, Yes/No chrome). Pre-stringifying
+ * numbers would ship `kind: 'text'` and foreclose locale-aware formatting.
+ *
+ * Multi-select stays an array of resolved labels (`kind: 'multi_select'`).
+ * Pre-joining with `Intl.ListFormat` would ship `kind: 'text'` and foreclose
+ * locale-aware **list** formatting (short style, disjunction, separate chips)
+ * for the same reason numbers must not be pre-stringified. The application
+ * joins when it wants a sentence:
+ * `new Intl.ListFormat(language, { style: 'long', type: 'conjunction' }).format(values)`.
+ *
+ * `language` remains the required leading parameter ( call-site
+ * pattern / signature stability). It is not read here — multi-select no
+ * longer joins in the SDK — but callers already pass `board.context().language`
+ * and removing it would be a delete from the published surface.
  */
 type CustomFieldDisplayEntry = {
     key: string;
@@ -290,7 +106,17 @@ type CustomFieldDisplayEntry = {
     label: string;
     kind: 'boolean';
     value: boolean;
+} | {
+    key: string;
+    label: string;
+    kind: 'number';
+    value: number;
+} | {
+    key: string;
+    label: string;
+    kind: 'multi_select';
+    values: string[];
 };
-declare function resolveCustomFieldDisplay(definitions: CustomFieldDefinition[] | undefined, values: CustomFieldValues | undefined): CustomFieldDisplayEntry[];
+declare function resolveCustomFieldDisplay(language: string, definitions: CustomFieldDefinition[] | undefined, values: CustomFieldValues | undefined): CustomFieldDisplayEntry[];
 
-export { BoardLabelOverrides, COUNTRY_CODES, type CountryOption, type CustomFieldDisplayEntry, type IsoCountryCode, type SalaryFrames, type SalaryLexicon, type SalaryTimeframeInput, type SalaryTimeframeOverrides, type SalaryTimeframeValue, type SeniorityKey, cardLocationLabel, companyIntro, countryOptions, fieldLabel, formatDate, formatMonthYear, formatPublishedRelativeDate, formatSalaryRange, fullJobToCard, getSalaryLexicon, locationLabel, resolveCustomFieldDisplay };
+export { COUNTRY_CODES, type CountryOption, type CustomFieldDisplayEntry, type IsoCountryCode, countryOptions, formatDate, formatMonthYear, formatPublishedRelativeDate, resolveCustomFieldDisplay };