@cavuno/board 3.2.0 → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +433 -0
- package/README.md +6 -2
- package/dist/{_spec-nkWAraS0.d.mts → _spec-BZDv2dc5.d.mts} +100 -68
- package/dist/{_spec-nkWAraS0.d.ts → _spec-BZDv2dc5.d.ts} +100 -68
- package/dist/bin.mjs +7 -2
- package/dist/{blog-iV9XEIGf.d.ts → blog-BHx6iH3Z.d.ts} +1 -1
- package/dist/{blog-DGBHmExV.d.mts → blog-DyDvyQrI.d.mts} +1 -1
- package/dist/{board-JhdUWIoq.d.ts → board-BF3Qao6J.d.mts} +7 -6
- package/dist/{board-BJbXd_9_.d.mts → board-BTEZ0uiI.d.ts} +7 -6
- package/dist/breadcrumbs-SGaWth6C.d.ts +372 -0
- package/dist/breadcrumbs-icxRVydh.d.mts +372 -0
- package/dist/chunk-BGKNXG4H.mjs +146 -0
- package/dist/{chunk-NXY3OWGF.mjs → chunk-T2KC6XGV.mjs} +1 -1
- package/dist/{chunk-STE77MAT.mjs → chunk-YEAQ3JEI.mjs} +143 -134
- package/dist/doctor.js +1 -1
- package/dist/doctor.mjs +1 -1
- package/dist/filters.d.mts +25 -20
- package/dist/filters.d.ts +25 -20
- package/dist/filters.js +3 -692
- package/dist/filters.mjs +3 -29
- package/dist/format.d.mts +57 -231
- package/dist/format.d.ts +57 -231
- package/dist/format.js +327 -968
- package/dist/format.mjs +207 -264
- package/dist/go.js +11 -1
- package/dist/go.mjs +1 -1
- package/dist/index.d.mts +67 -76
- package/dist/index.d.ts +67 -76
- package/dist/index.js +45 -36
- package/dist/index.mjs +45 -36
- package/dist/{jobs-BiEvL9d7.d.ts → jobs-BX6d_sdd.d.mts} +4 -4
- package/dist/{jobs-lVvKCBCU.d.mts → jobs-BbLJfz1z.d.ts} +4 -4
- package/dist/paths.d.mts +89 -1
- package/dist/paths.d.ts +89 -1
- package/dist/paths.js +62 -14
- package/dist/paths.mjs +11 -3
- package/dist/route-contract.js +23 -13
- package/dist/route-contract.mjs +2 -2
- package/dist/{search-CCyFWPi3.d.mts → search-7B-mVRNA.d.ts} +14 -3
- package/dist/{search-CyRvVMUp.d.ts → search-OKrdAHv8.d.mts} +14 -3
- package/dist/seo.d.mts +30 -29
- package/dist/seo.d.ts +30 -29
- package/dist/seo.js +197 -718
- package/dist/seo.mjs +26 -24
- package/dist/server.d.mts +5 -5
- package/dist/server.d.ts +5 -5
- package/dist/sitemap.d.mts +5 -5
- package/dist/sitemap.d.ts +5 -5
- package/dist/sitemap.js +25 -14
- package/dist/sitemap.mjs +3 -2
- package/dist/skills.js +1 -1
- package/dist/skills.mjs +1 -1
- package/dist/suggest.d.mts +2 -2
- package/dist/suggest.d.ts +2 -2
- package/dist/suggest.js +17 -3
- package/dist/suggest.mjs +17 -3
- package/dist/well-known.js +23 -13
- package/dist/well-known.mjs +2 -2
- package/package.json +2 -4
- package/skills/cavuno-board-api-client/SKILL.md +42 -0
- package/skills/cavuno-board-applications/SKILL.md +4 -1
- package/skills/cavuno-board-filters/SKILL.md +11 -12
- package/skills/cavuno-board-format/SKILL.md +68 -56
- package/skills/cavuno-board-i18n/SKILL.md +102 -21
- package/skills/cavuno-board-search-suggestions/SKILL.md +8 -3
- package/skills/cavuno-board-seo/BLOG.md +4 -1
- package/skills/cavuno-board-seo/JOB_AND_BREADCRUMBS.md +5 -2
- package/skills/cavuno-board-seo/LISTING.md +35 -12
- package/skills/cavuno-board-seo/SALARY.md +83 -18
- package/skills/cavuno-board-seo/SKILL.md +3 -2
- package/skills/manifest.json +3 -3
- package/dist/breadcrumbs-1hMjcsqA.d.mts +0 -171
- package/dist/breadcrumbs-DexU07TT.d.ts +0 -171
- package/dist/chunk-IJCJ26SQ.mjs +0 -596
- package/dist/chunk-L7ZOYWHW.mjs +0 -98
- package/dist/chunk-LUGJWOT7.mjs +0 -96
- package/dist/ui-copy-CCkz6CVF.d.mts +0 -230
- package/dist/ui-copy-CCkz6CVF.d.ts +0 -230
|
@@ -1,171 +0,0 @@
|
|
|
1
|
-
import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-BJbXd_9_.mjs';
|
|
2
|
-
import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.mjs';
|
|
3
|
-
import { P as PublicJob } from './jobs-lVvKCBCU.mjs';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
|
|
7
|
-
* types, transcribed field-by-field from the hosted board's generator
|
|
8
|
-
* (the hosted board implementation + `job-posting-location-json-ld.ts`) and
|
|
9
|
-
* tested against the hosted behavior.
|
|
10
|
-
*
|
|
11
|
-
* JSON-LD structure is locale-neutral per schema.org — no board-language
|
|
12
|
-
* parameter here; the only display strings are wire values passed through.
|
|
13
|
-
*
|
|
14
|
-
* Named exclusions (hosted behaviours with no wire twin, recorded in the
|
|
15
|
-
* public API contract):
|
|
16
|
-
* - `board.companyLegalName` — hosted falls back to it for the
|
|
17
|
-
* organization name between `company.name` and `board.name`; the wire
|
|
18
|
-
* board context does not expose it.
|
|
19
|
-
* - `board.companyWebsiteUrl` — hosted falls back to it for `sameAs` when
|
|
20
|
-
* the company has no website; not on the wire.
|
|
21
|
-
* - the hosted `job.place`/`locationLabel` jobLocation fallback (used when
|
|
22
|
-
* a job has no office locations) — the wire `PublicJob` carries no
|
|
23
|
-
* resolved place geo, only `officeLocations`.
|
|
24
|
-
*/
|
|
25
|
-
|
|
26
|
-
type JsonLdObject = Record<string, unknown>;
|
|
27
|
-
/** The only board fields JSON-LD needs — keeps callers' shapes flexible. */
|
|
28
|
-
type JsonLdBoard = Pick<PublicBoard, 'name' | 'logoUrl'>;
|
|
29
|
-
/**
|
|
30
|
-
* Worldwide-remote jobs must still emit `applicantLocationRequirements`
|
|
31
|
-
* next to TELECOMMUTE (Google requires a location signal), so the hosted
|
|
32
|
-
* board — and this transcription — lists every country it recognises.
|
|
33
|
-
*
|
|
34
|
-
* This is the hosted board's exact country catalog: sorted by English common
|
|
35
|
-
* name, includes `XK` (Kosovo), and excludes `KP` (North Korea). tested
|
|
36
|
-
* against the hosted list so the two cannot drift.
|
|
37
|
-
*/
|
|
38
|
-
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"];
|
|
39
|
-
/**
|
|
40
|
-
* Build the Google for Jobs `JobPosting` JSON-LD object for a job detail
|
|
41
|
-
* page, or `null` when nothing renderable remains after pruning. Embed the
|
|
42
|
-
* result in a `<script type="application/ld+json">` tag.
|
|
43
|
-
*/
|
|
44
|
-
declare function createJobPostingJsonLd({ job, board, shareUrl, }: {
|
|
45
|
-
job: PublicJob;
|
|
46
|
-
board: JsonLdBoard;
|
|
47
|
-
shareUrl: string;
|
|
48
|
-
}): JsonLdObject | null;
|
|
49
|
-
/**
|
|
50
|
-
* Prefix `https://` onto scheme-less company websites; `null` for
|
|
51
|
-
* blank input (hosted shape — a whitespace-only website never becomes
|
|
52
|
-
* a bare `https://` `sameAs`).
|
|
53
|
-
*/
|
|
54
|
-
declare function normalizeWebsiteUrl(website: string): string | null;
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* Compact USD amount in the board language (`$90K`, de: `90.000 $`) — the
|
|
58
|
-
* hosted salary-page money formatter. USD-hardcoded (hosted quirk); the
|
|
59
|
-
* locale drives digits, grouping, and symbol placement only.
|
|
60
|
-
*/
|
|
61
|
-
declare function formatUsd(locale: string, value: number): string;
|
|
62
|
-
/** `formatUsd(min) – formatUsd(max)` with the hosted spaced en dash. */
|
|
63
|
-
declare function formatRange(locale: string, min: number, max: number): string;
|
|
64
|
-
/**
|
|
65
|
-
* Seniority display label. Precedence (hosted shape): owner override >
|
|
66
|
-
* board-language lexicon (en = the English source labels) > title-case
|
|
67
|
-
* fallback for an unknown key.
|
|
68
|
-
*/
|
|
69
|
-
declare function formatSeniority(locale: string, value: string, overrides?: Record<string, string>): string;
|
|
70
|
-
/** The canonical seniority ladder order the hosted salary pages sort by. */
|
|
71
|
-
declare const SENIORITY_ORDER: readonly ["entry_level", "associate", "mid_level", "senior", "lead", "principal", "director", "executive"];
|
|
72
|
-
/** Sort rows by `SENIORITY_ORDER` (unknown keys sink to the end). Non-mutating. */
|
|
73
|
-
declare function sortBySeniority<T extends {
|
|
74
|
-
seniority: string;
|
|
75
|
-
}>(items: T[]): T[];
|
|
76
|
-
interface FaqItem {
|
|
77
|
-
q: string;
|
|
78
|
-
a: string;
|
|
79
|
-
}
|
|
80
|
-
/**
|
|
81
|
-
* A templated salary FAQ (interim — see the module doc). The sentences are
|
|
82
|
-
* English; the embedded range is board-language-formatted via `formatRange`
|
|
83
|
-
* (the only part hosted localizes). Empty when there is no overall figure.
|
|
84
|
-
*/
|
|
85
|
-
declare function buildSalaryFaq(locale: string, label: string, overall: {
|
|
86
|
-
avgMin: number;
|
|
87
|
-
avgMax: number;
|
|
88
|
-
jobCount: number;
|
|
89
|
-
} | null): FaqItem[];
|
|
90
|
-
/** An `ItemList` for a salary index page (the listing's items + their URLs). */
|
|
91
|
-
declare function itemListJsonLd(items: {
|
|
92
|
-
name: string;
|
|
93
|
-
url: string;
|
|
94
|
-
}[]): JsonLdObject | null;
|
|
95
|
-
/** A `FAQPage` from `buildSalaryFaq` items (or any `{q,a}` list). */
|
|
96
|
-
declare function faqJsonLd(faqs: FaqItem[]): JsonLdObject | null;
|
|
97
|
-
/**
|
|
98
|
-
* `Occupation` for a job-title salary page. Per-seniority distribution
|
|
99
|
-
* names embed the board-language seniority label (`formatSeniority`).
|
|
100
|
-
*/
|
|
101
|
-
declare function titleSalaryJsonLd(locale: string, d: TitleSalaryDetail): JsonLdObject | null;
|
|
102
|
-
/** `Occupation` for a skill salary page (overall distribution + median). */
|
|
103
|
-
declare function skillSalaryJsonLd(d: SkillSalaryDetail): JsonLdObject | null;
|
|
104
|
-
/**
|
|
105
|
-
* `Occupation` for a location salary page. City-level pages only (the
|
|
106
|
-
* hosted page gates on city/locality); `null` otherwise.
|
|
107
|
-
*/
|
|
108
|
-
declare function locationSalaryJsonLd(d: LocationSalaryDetail): JsonLdObject | null;
|
|
109
|
-
/**
|
|
110
|
-
* Cross-axis (title×location / skill×location) `Occupation` JSON-LD. Takes
|
|
111
|
-
* primitives to stay decoupled from the two cross-axis detail wire types.
|
|
112
|
-
*/
|
|
113
|
-
declare function crossAxisSalaryJsonLd(locale: string, args: {
|
|
114
|
-
name: string;
|
|
115
|
-
placeName: string;
|
|
116
|
-
countryCode: string;
|
|
117
|
-
overall: {
|
|
118
|
-
avgMin: number;
|
|
119
|
-
avgMax: number;
|
|
120
|
-
p25Min: number | null;
|
|
121
|
-
p75Max: number | null;
|
|
122
|
-
} | null;
|
|
123
|
-
bySeniority: {
|
|
124
|
-
seniority: string;
|
|
125
|
-
avgSalaryMin: number;
|
|
126
|
-
avgSalaryMax: number;
|
|
127
|
-
}[];
|
|
128
|
-
currency: string;
|
|
129
|
-
}): JsonLdObject | null;
|
|
130
|
-
/**
|
|
131
|
-
* `OccupationAggregationByEmployer` for a company's salary overview —
|
|
132
|
-
* mirrors the hosted company-salary page's Google-salary structured data
|
|
133
|
-
* (base + per-seniority distributions, the board median/IQR baseline as
|
|
134
|
-
* the aggregate stats).
|
|
135
|
-
*/
|
|
136
|
-
declare function companySalaryJsonLd(locale: string, d: CompanySalary): JsonLdObject | null;
|
|
137
|
-
/** `Occupation` for one job category at a company (the hosted category page). */
|
|
138
|
-
declare function companyCategorySalaryJsonLd(locale: string, d: CompanyCategorySalary): JsonLdObject | null;
|
|
139
|
-
|
|
140
|
-
interface BreadcrumbItemInput {
|
|
141
|
-
label: string | null | undefined;
|
|
142
|
-
href?: string | null;
|
|
143
|
-
}
|
|
144
|
-
/**
|
|
145
|
-
* Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
|
|
146
|
-
* items dropped; fewer than 2 surviving items → `null` (a single crumb is
|
|
147
|
-
* not a trail); the current page (no `href`) omits `item` per schema.org.
|
|
148
|
-
* Relative hrefs resolve against `options.origin`; without an origin a
|
|
149
|
-
* relative item is omitted (never emit a relative `item` URL).
|
|
150
|
-
*/
|
|
151
|
-
declare function createBreadcrumbJsonLd(items: BreadcrumbItemInput[], options?: {
|
|
152
|
-
origin?: string | null;
|
|
153
|
-
}): JsonLdObject | null;
|
|
154
|
-
/**
|
|
155
|
-
* Home › Jobs › [country › region › city] › primaryCategory › Title.
|
|
156
|
-
* The place crumbs link into the listing routes (`/jobs/locations/:slug`);
|
|
157
|
-
* the category crumb nests under the most-specific place when present
|
|
158
|
-
* (`/jobs/locations/:place/:category`), else `/jobs/:category`. The last
|
|
159
|
-
* crumb (the job title) carries no `path` — the current page. Mirrors
|
|
160
|
-
* page.tsx:336-367.
|
|
161
|
-
*
|
|
162
|
-
* The Home/Jobs crumb names resolve from the copy catalog per board
|
|
163
|
-
* language ⊕ operator overrides; omitting `language` keeps the
|
|
164
|
-
* English source, so existing call sites render unchanged.
|
|
165
|
-
*/
|
|
166
|
-
declare function buildJobBreadcrumbs(job: PublicJob, language?: string, labels?: BoardLabelOverrides): Array<{
|
|
167
|
-
name: string;
|
|
168
|
-
path?: string;
|
|
169
|
-
}>;
|
|
170
|
-
|
|
171
|
-
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 };
|
|
@@ -1,171 +0,0 @@
|
|
|
1
|
-
import { P as PublicBoard, a as CompanyCategorySalary, b as CompanySalary, L as LocationSalaryDetail, S as SkillSalaryDetail, T as TitleSalaryDetail } from './board-JhdUWIoq.js';
|
|
2
|
-
import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.js';
|
|
3
|
-
import { P as PublicJob } from './jobs-BiEvL9d7.js';
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
* Google for Jobs `JobPosting` structured data on the `@cavuno/board` wire
|
|
7
|
-
* types, transcribed field-by-field from the hosted board's generator
|
|
8
|
-
* (the hosted board implementation + `job-posting-location-json-ld.ts`) and
|
|
9
|
-
* tested against the hosted behavior.
|
|
10
|
-
*
|
|
11
|
-
* JSON-LD structure is locale-neutral per schema.org — no board-language
|
|
12
|
-
* parameter here; the only display strings are wire values passed through.
|
|
13
|
-
*
|
|
14
|
-
* Named exclusions (hosted behaviours with no wire twin, recorded in the
|
|
15
|
-
* public API contract):
|
|
16
|
-
* - `board.companyLegalName` — hosted falls back to it for the
|
|
17
|
-
* organization name between `company.name` and `board.name`; the wire
|
|
18
|
-
* board context does not expose it.
|
|
19
|
-
* - `board.companyWebsiteUrl` — hosted falls back to it for `sameAs` when
|
|
20
|
-
* the company has no website; not on the wire.
|
|
21
|
-
* - the hosted `job.place`/`locationLabel` jobLocation fallback (used when
|
|
22
|
-
* a job has no office locations) — the wire `PublicJob` carries no
|
|
23
|
-
* resolved place geo, only `officeLocations`.
|
|
24
|
-
*/
|
|
25
|
-
|
|
26
|
-
type JsonLdObject = Record<string, unknown>;
|
|
27
|
-
/** The only board fields JSON-LD needs — keeps callers' shapes flexible. */
|
|
28
|
-
type JsonLdBoard = Pick<PublicBoard, 'name' | 'logoUrl'>;
|
|
29
|
-
/**
|
|
30
|
-
* Worldwide-remote jobs must still emit `applicantLocationRequirements`
|
|
31
|
-
* next to TELECOMMUTE (Google requires a location signal), so the hosted
|
|
32
|
-
* board — and this transcription — lists every country it recognises.
|
|
33
|
-
*
|
|
34
|
-
* This is the hosted board's exact country catalog: sorted by English common
|
|
35
|
-
* name, includes `XK` (Kosovo), and excludes `KP` (North Korea). tested
|
|
36
|
-
* against the hosted list so the two cannot drift.
|
|
37
|
-
*/
|
|
38
|
-
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"];
|
|
39
|
-
/**
|
|
40
|
-
* Build the Google for Jobs `JobPosting` JSON-LD object for a job detail
|
|
41
|
-
* page, or `null` when nothing renderable remains after pruning. Embed the
|
|
42
|
-
* result in a `<script type="application/ld+json">` tag.
|
|
43
|
-
*/
|
|
44
|
-
declare function createJobPostingJsonLd({ job, board, shareUrl, }: {
|
|
45
|
-
job: PublicJob;
|
|
46
|
-
board: JsonLdBoard;
|
|
47
|
-
shareUrl: string;
|
|
48
|
-
}): JsonLdObject | null;
|
|
49
|
-
/**
|
|
50
|
-
* Prefix `https://` onto scheme-less company websites; `null` for
|
|
51
|
-
* blank input (hosted shape — a whitespace-only website never becomes
|
|
52
|
-
* a bare `https://` `sameAs`).
|
|
53
|
-
*/
|
|
54
|
-
declare function normalizeWebsiteUrl(website: string): string | null;
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* Compact USD amount in the board language (`$90K`, de: `90.000 $`) — the
|
|
58
|
-
* hosted salary-page money formatter. USD-hardcoded (hosted quirk); the
|
|
59
|
-
* locale drives digits, grouping, and symbol placement only.
|
|
60
|
-
*/
|
|
61
|
-
declare function formatUsd(locale: string, value: number): string;
|
|
62
|
-
/** `formatUsd(min) – formatUsd(max)` with the hosted spaced en dash. */
|
|
63
|
-
declare function formatRange(locale: string, min: number, max: number): string;
|
|
64
|
-
/**
|
|
65
|
-
* Seniority display label. Precedence (hosted shape): owner override >
|
|
66
|
-
* board-language lexicon (en = the English source labels) > title-case
|
|
67
|
-
* fallback for an unknown key.
|
|
68
|
-
*/
|
|
69
|
-
declare function formatSeniority(locale: string, value: string, overrides?: Record<string, string>): string;
|
|
70
|
-
/** The canonical seniority ladder order the hosted salary pages sort by. */
|
|
71
|
-
declare const SENIORITY_ORDER: readonly ["entry_level", "associate", "mid_level", "senior", "lead", "principal", "director", "executive"];
|
|
72
|
-
/** Sort rows by `SENIORITY_ORDER` (unknown keys sink to the end). Non-mutating. */
|
|
73
|
-
declare function sortBySeniority<T extends {
|
|
74
|
-
seniority: string;
|
|
75
|
-
}>(items: T[]): T[];
|
|
76
|
-
interface FaqItem {
|
|
77
|
-
q: string;
|
|
78
|
-
a: string;
|
|
79
|
-
}
|
|
80
|
-
/**
|
|
81
|
-
* A templated salary FAQ (interim — see the module doc). The sentences are
|
|
82
|
-
* English; the embedded range is board-language-formatted via `formatRange`
|
|
83
|
-
* (the only part hosted localizes). Empty when there is no overall figure.
|
|
84
|
-
*/
|
|
85
|
-
declare function buildSalaryFaq(locale: string, label: string, overall: {
|
|
86
|
-
avgMin: number;
|
|
87
|
-
avgMax: number;
|
|
88
|
-
jobCount: number;
|
|
89
|
-
} | null): FaqItem[];
|
|
90
|
-
/** An `ItemList` for a salary index page (the listing's items + their URLs). */
|
|
91
|
-
declare function itemListJsonLd(items: {
|
|
92
|
-
name: string;
|
|
93
|
-
url: string;
|
|
94
|
-
}[]): JsonLdObject | null;
|
|
95
|
-
/** A `FAQPage` from `buildSalaryFaq` items (or any `{q,a}` list). */
|
|
96
|
-
declare function faqJsonLd(faqs: FaqItem[]): JsonLdObject | null;
|
|
97
|
-
/**
|
|
98
|
-
* `Occupation` for a job-title salary page. Per-seniority distribution
|
|
99
|
-
* names embed the board-language seniority label (`formatSeniority`).
|
|
100
|
-
*/
|
|
101
|
-
declare function titleSalaryJsonLd(locale: string, d: TitleSalaryDetail): JsonLdObject | null;
|
|
102
|
-
/** `Occupation` for a skill salary page (overall distribution + median). */
|
|
103
|
-
declare function skillSalaryJsonLd(d: SkillSalaryDetail): JsonLdObject | null;
|
|
104
|
-
/**
|
|
105
|
-
* `Occupation` for a location salary page. City-level pages only (the
|
|
106
|
-
* hosted page gates on city/locality); `null` otherwise.
|
|
107
|
-
*/
|
|
108
|
-
declare function locationSalaryJsonLd(d: LocationSalaryDetail): JsonLdObject | null;
|
|
109
|
-
/**
|
|
110
|
-
* Cross-axis (title×location / skill×location) `Occupation` JSON-LD. Takes
|
|
111
|
-
* primitives to stay decoupled from the two cross-axis detail wire types.
|
|
112
|
-
*/
|
|
113
|
-
declare function crossAxisSalaryJsonLd(locale: string, args: {
|
|
114
|
-
name: string;
|
|
115
|
-
placeName: string;
|
|
116
|
-
countryCode: string;
|
|
117
|
-
overall: {
|
|
118
|
-
avgMin: number;
|
|
119
|
-
avgMax: number;
|
|
120
|
-
p25Min: number | null;
|
|
121
|
-
p75Max: number | null;
|
|
122
|
-
} | null;
|
|
123
|
-
bySeniority: {
|
|
124
|
-
seniority: string;
|
|
125
|
-
avgSalaryMin: number;
|
|
126
|
-
avgSalaryMax: number;
|
|
127
|
-
}[];
|
|
128
|
-
currency: string;
|
|
129
|
-
}): JsonLdObject | null;
|
|
130
|
-
/**
|
|
131
|
-
* `OccupationAggregationByEmployer` for a company's salary overview —
|
|
132
|
-
* mirrors the hosted company-salary page's Google-salary structured data
|
|
133
|
-
* (base + per-seniority distributions, the board median/IQR baseline as
|
|
134
|
-
* the aggregate stats).
|
|
135
|
-
*/
|
|
136
|
-
declare function companySalaryJsonLd(locale: string, d: CompanySalary): JsonLdObject | null;
|
|
137
|
-
/** `Occupation` for one job category at a company (the hosted category page). */
|
|
138
|
-
declare function companyCategorySalaryJsonLd(locale: string, d: CompanyCategorySalary): JsonLdObject | null;
|
|
139
|
-
|
|
140
|
-
interface BreadcrumbItemInput {
|
|
141
|
-
label: string | null | undefined;
|
|
142
|
-
href?: string | null;
|
|
143
|
-
}
|
|
144
|
-
/**
|
|
145
|
-
* Build a `BreadcrumbList`, hosted semantics: labels are trimmed and empty
|
|
146
|
-
* items dropped; fewer than 2 surviving items → `null` (a single crumb is
|
|
147
|
-
* not a trail); the current page (no `href`) omits `item` per schema.org.
|
|
148
|
-
* Relative hrefs resolve against `options.origin`; without an origin a
|
|
149
|
-
* relative item is omitted (never emit a relative `item` URL).
|
|
150
|
-
*/
|
|
151
|
-
declare function createBreadcrumbJsonLd(items: BreadcrumbItemInput[], options?: {
|
|
152
|
-
origin?: string | null;
|
|
153
|
-
}): JsonLdObject | null;
|
|
154
|
-
/**
|
|
155
|
-
* Home › Jobs › [country › region › city] › primaryCategory › Title.
|
|
156
|
-
* The place crumbs link into the listing routes (`/jobs/locations/:slug`);
|
|
157
|
-
* the category crumb nests under the most-specific place when present
|
|
158
|
-
* (`/jobs/locations/:place/:category`), else `/jobs/:category`. The last
|
|
159
|
-
* crumb (the job title) carries no `path` — the current page. Mirrors
|
|
160
|
-
* page.tsx:336-367.
|
|
161
|
-
*
|
|
162
|
-
* The Home/Jobs crumb names resolve from the copy catalog per board
|
|
163
|
-
* language ⊕ operator overrides; omitting `language` keeps the
|
|
164
|
-
* English source, so existing call sites render unchanged.
|
|
165
|
-
*/
|
|
166
|
-
declare function buildJobBreadcrumbs(job: PublicJob, language?: string, labels?: BoardLabelOverrides): Array<{
|
|
167
|
-
name: string;
|
|
168
|
-
path?: string;
|
|
169
|
-
}>;
|
|
170
|
-
|
|
171
|
-
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 };
|