@cavuno/board 3.2.0 → 4.0.0

package/dist/{chunk-STE77MAT.mjs → chunk-YEAQ3JEI.mjs}

@@ -1,51 +1,83 @@
 import {
-  getSalaryLexicon,
-  uiCopy
-} from "./chunk-IJCJ26SQ.mjs";
+  BOARD_PATHS,
+  jobsCategoryPath,
+  jobsLocationCategoryPath,
+  jobsLocationPath
+} from "./chunk-BGKNXG4H.mjs";
 
-// src/seo/salary.ts
-var compactCurrencyCache = /* @__PURE__ */ new Map();
-function getCompactCurrencyFormatter(language) {
-  const cached = compactCurrencyCache.get(language);
-  if (cached) return cached;
-  const formatter = new Intl.NumberFormat(language, {
-    style: "currency",
-    currency: "USD",
-    notation: "compact",
-    compactDisplay: "short",
-    minimumFractionDigits: 0,
-    maximumFractionDigits: 1
-  });
-  compactCurrencyCache.set(language, formatter);
-  return formatter;
-}
-function formatUsd(locale, value) {
+// src/format/locale.ts
+function normalizeLocale(language) {
+  const trimmed = language.trim();
+  if (!trimmed) return null;
   try {
-    return getCompactCurrencyFormatter(locale).format(value);
+    const candidate = trimmed.replace(/_/g, "-");
+    const [canonical] = Intl.getCanonicalLocales(candidate);
+    if (!canonical) return null;
+    const [supported] = Intl.NumberFormat.supportedLocalesOf([canonical]);
+    return supported ?? null;
   } catch {
-    if (value >= 1e6) {
-      const millions = value / 1e6;
-      return `$${millions % 1 === 0 ? millions : millions.toFixed(1)}M`;
-    }
-    if (value >= 1e3) {
-      const thousands = value / 1e3;
-      return `$${thousands % 1 === 0 ? thousands : thousands.toFixed(1)}k`;
-    }
-    return `$${value}`;
+    return null;
   }
 }
-function formatRange(locale, min, max) {
-  return `${formatUsd(locale, min)} \u2013 ${formatUsd(locale, max)}`;
-}
-function formatSeniority(locale, value, overrides) {
-  if (overrides?.[value]) {
-    return overrides[value];
+
+// src/seo/salary.ts
+var currencyFormatterCache = /* @__PURE__ */ new Map();
+function notationForMagnitude(...values) {
+  let anyFinite = false;
+  for (const v of values) {
+    if (v == null || !Number.isFinite(v)) continue;
+    anyFinite = true;
+    if (Math.abs(v) >= 1e3) return "compact";
   }
-  const lexiconLabel = getSalaryLexicon(locale).seniority[value];
-  if (lexiconLabel) {
-    return lexiconLabel;
+  return anyFinite ? "standard" : "compact";
+}
+function getCurrencyFormatter(language, currencyCode, notation) {
+  const key = `${language}:${currencyCode}:${notation}`;
+  const cached = currencyFormatterCache.get(key);
+  if (cached !== void 0) return cached;
+  let formatter;
+  try {
+    const options = {
+      style: "currency",
+      currency: currencyCode,
+      notation
+    };
+    if (notation === "compact") {
+      options.compactDisplay = "short";
+      options.minimumFractionDigits = 0;
+      options.maximumFractionDigits = 1;
+    }
+    formatter = new Intl.NumberFormat(language, options);
+  } catch {
+    formatter = null;
   }
-  return value.replace(/_/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+  currencyFormatterCache.set(key, formatter);
+  return formatter;
+}
+function formatSalaryStat(locale, value, currency, notation) {
+  if (!Number.isFinite(value)) return null;
+  const currencyCode = currency?.trim().toUpperCase() || null;
+  if (!currencyCode) return null;
+  const normalized = normalizeLocale(locale);
+  if (!normalized) return null;
+  const resolved = notation ?? notationForMagnitude(value);
+  const formatter = getCurrencyFormatter(normalized, currencyCode, resolved);
+  if (!formatter) return null;
+  return formatter.format(value);
+}
+function formatSalaryStatRange(locale, min, max, currency, notation) {
+  if (!Number.isFinite(min) || !Number.isFinite(max)) return null;
+  const currencyCode = currency?.trim().toUpperCase() || null;
+  if (!currencyCode) return null;
+  const normalized = normalizeLocale(locale);
+  if (!normalized) return null;
+  const resolved = notation ?? notationForMagnitude(min, max);
+  const formatter = getCurrencyFormatter(normalized, currencyCode, resolved);
+  if (!formatter) return null;
+  const low = Math.min(min, max);
+  const high = Math.max(min, max);
+  if (low === high) return formatter.format(low);
+  return formatter.formatRange(low, high);
 }
 var SENIORITY_ORDER = [
   "entry_level",
@@ -75,7 +107,7 @@ var yearly = {
 function distribution(name, currency, minValue, maxValue, stats = {}) {
   return {
     "@type": "MonetaryAmountDistribution",
-    name,
+    ...name !== void 0 ? { name } : {},
     currency,
     minValue,
     maxValue,
@@ -83,15 +115,19 @@ function distribution(name, currency, minValue, maxValue, stats = {}) {
     ...yearly
   };
 }
-function seniorityDistributions(locale, rows, currency, nameFor) {
-  return rows.map(
-    (row) => distribution(
-      nameFor(formatSeniority(locale, row.seniority)),
+function seniorityDistributions(rows, currency, entity, options) {
+  return rows.map((row) => {
+    const name = options?.seniorityName?.({
+      seniority: row.seniority,
+      entity
+    });
+    return distribution(
+      name,
       currency,
       row.avgSalaryMin,
       row.avgSalaryMax
-    )
-  );
+    );
+  });
 }
 function salaryEnvelope(type, name, extra, estimatedSalary) {
   return {
@@ -102,17 +138,27 @@ function salaryEnvelope(type, name, extra, estimatedSalary) {
     estimatedSalary
   };
 }
-function buildSalaryFaq(locale, label, overall) {
+function buildSalaryFaq(locale, label, overall, currency) {
   if (!overall) return [];
-  const range = formatRange(locale, overall.avgMin, overall.avgMax);
+  const range = formatSalaryStatRange(
+    locale,
+    overall.avgMin,
+    overall.avgMax,
+    currency
+  );
   return [
     {
-      q: `What is the average salary for ${label}?`,
-      a: `The average salary for ${label} is ${range} per year, based on ${overall.jobCount} job ${overall.jobCount === 1 ? "posting" : "postings"} on this board that disclose pay.`
+      kind: "average",
+      label,
+      range,
+      avgMin: overall.avgMin,
+      avgMax: overall.avgMax,
+      currency,
+      jobCount: overall.jobCount
     },
     {
-      q: `How is the salary figure for ${label} calculated?`,
-      a: `These figures are aggregated from current and recent job postings on this board that disclose pay, then averaged across roles. They are estimates, not guarantees of compensation.`
+      kind: "methodology",
+      label
     }
   ];
 }
@@ -142,11 +188,11 @@ function faqJsonLd(faqs) {
     }))
   };
 }
-function titleSalaryJsonLd(locale, d) {
+function titleSalaryJsonLd(d, options) {
   if (!d.overallSalary) return null;
   return salaryEnvelope("Occupation", d.categoryName, {}, [
     distribution(
-      `${d.categoryName} salary (all levels)`,
+      d.categoryName,
       d.currency,
       d.overallSalary.avgMin,
       d.overallSalary.avgMax,
@@ -156,10 +202,10 @@ function titleSalaryJsonLd(locale, d) {
       }
     ),
     ...seniorityDistributions(
-      locale,
       d.bySeniority,
       d.currency,
-      (label) => `${label} ${d.categoryName}`
+      d.categoryName,
+      options
     )
   ]);
 }
@@ -167,7 +213,7 @@ function skillSalaryJsonLd(d) {
   if (!d.overallSalary) return null;
   return salaryEnvelope("Occupation", d.skillName, {}, [
     distribution(
-      `${d.skillName} salary (all levels)`,
+      d.skillName,
       d.currency,
       d.overallSalary.avgMin,
       d.overallSalary.avgMax,
@@ -179,42 +225,22 @@ function skillSalaryJsonLd(d) {
     )
   ]);
 }
-function locationSalaryJsonLd(d) {
+function locationSalaryJsonLd(d, options) {
+  if (!options?.occupationUrl) return null;
   const isCity = d.adminLevel === "city" || d.adminLevel === "locality";
-  if (!isCity || !d.overallSalary) return null;
-  return salaryEnvelope(
-    "Occupation",
-    `Average Salary in ${d.placeName}`,
-    {
-      occupationLocation: {
-        "@type": "City",
-        name: d.placeName,
-        address: { "@type": "PostalAddress", addressCountry: d.countryCode }
-      }
-    },
-    [
-      distribution(
-        `Average salary in ${d.placeName}`,
-        d.currency,
-        d.overallSalary.avgMin,
-        d.overallSalary.avgMax,
-        {
-          median: Math.round(
-            (d.overallSalary.medianMin + d.overallSalary.medianMax) / 2
-          ),
-          // Hosted includes these unconditionally, nulls and all.
-          percentile25: d.overallSalary.p25Min,
-          percentile75: d.overallSalary.p75Max
-        }
-      )
-    ]
+  if (!isCity) return null;
+  return itemListJsonLd(
+    d.topCategories.map((c) => ({
+      name: c.categoryName,
+      url: options.occupationUrl(c)
+    }))
   );
 }
-function crossAxisSalaryJsonLd(locale, args) {
+function crossAxisSalaryJsonLd(args, options) {
   if (!args.overall) return null;
   return salaryEnvelope(
     "Occupation",
-    `${args.name} salary in ${args.placeName}`,
+    args.name,
     {
       occupationLocation: {
         "@type": "AdministrativeArea",
@@ -227,7 +253,7 @@ function crossAxisSalaryJsonLd(locale, args) {
     },
     [
       distribution(
-        `${args.name} salary in ${args.placeName} (all levels)`,
+        args.name,
         args.currency,
         args.overall.avgMin,
         args.overall.avgMax,
@@ -237,56 +263,35 @@ function crossAxisSalaryJsonLd(locale, args) {
         }
       ),
       ...seniorityDistributions(
-        locale,
         args.bySeniority,
         args.currency,
-        (label) => `${label} ${args.name} in ${args.placeName}`
+        args.name,
+        options
       )
     ]
   );
 }
-function companySalaryJsonLd(locale, d) {
-  if (!d.overallSalary) return null;
-  return salaryEnvelope(
-    "OccupationAggregationByEmployer",
-    `Jobs at ${d.companyName}`,
-    {
-      sampleSize: d.overallSalary.jobCount,
-      hiringOrganization: { "@type": "Organization", name: d.companyName }
-    },
-    [
-      distribution(
-        "base",
-        d.currency,
-        d.overallSalary.avgMin,
-        d.overallSalary.avgMax,
-        {
-          ...d.boardMedianMin && d.boardMedianMax ? { median: Math.round((d.boardMedianMin + d.boardMedianMax) / 2) } : {},
-          ...d.boardP25Min ? { percentile25: d.boardP25Min } : {},
-          ...d.boardP75Max ? { percentile75: d.boardP75Max } : {}
-        }
-      ),
-      ...seniorityDistributions(
-        locale,
-        d.bySeniority,
-        d.currency,
-        (label) => `${label} salary`
-      )
-    ]
+function companySalaryJsonLd(d, options) {
+  if (!options?.occupationUrl) return null;
+  return itemListJsonLd(
+    d.byCategory.map((c) => ({
+      name: c.categoryName,
+      url: options.occupationUrl(c)
+    }))
   );
 }
-function companyCategorySalaryJsonLd(locale, d) {
+function companyCategorySalaryJsonLd(d, options) {
   if (!d.overallSalary) return null;
   return salaryEnvelope(
     "Occupation",
-    `${d.categoryName} at ${d.companyName}`,
+    d.categoryName,
     {
       occupationalCategory: d.categoryName,
       hiringOrganization: { "@type": "Organization", name: d.companyName }
     },
     [
       distribution(
-        `${d.categoryName} salary (all levels)`,
+        d.categoryName,
         d.currency,
         d.overallSalary.avgMin,
         d.overallSalary.avgMax,
@@ -296,10 +301,10 @@ function companyCategorySalaryJsonLd(locale, d) {
         }
       ),
       ...seniorityDistributions(
-        locale,
         d.bySeniority,
         d.currency,
-        (label) => `${label} ${d.categoryName}`
+        d.categoryName,
+        options
       )
     ]
   );
@@ -799,32 +804,36 @@ function resolveBreadcrumbHref(href, origin) {
 function isAbsoluteUrl(href) {
   return /^https?:\/\//i.test(href);
 }
-function buildJobBreadcrumbs(job, language, labels) {
-  const copy = uiCopy(language, labels).breadcrumbs;
+function buildJobBreadcrumbs(job) {
   const crumbs = [
-    { name: copy.home, path: "/" },
-    { name: copy.jobs, path: "/jobs" }
+    { kind: "home", path: BOARD_PATHS.home },
+    { kind: "jobs", path: BOARD_PATHS.jobs }
   ];
   let lastPlaceSlug = null;
   for (const place of job.placeHierarchy) {
     lastPlaceSlug = place.slug;
-    crumbs.push({ name: place.name, path: `/jobs/locations/${place.slug}` });
+    crumbs.push({
+      kind: "place",
+      name: place.name,
+      path: jobsLocationPath(place.slug)
+    });
   }
   const primaryCategory = job.categories[0];
   if (primaryCategory) {
     crumbs.push({
+      kind: "category",
       name: primaryCategory.name,
-      path: lastPlaceSlug ? `/jobs/locations/${lastPlaceSlug}/${primaryCategory.slug}` : `/jobs/${primaryCategory.slug}`
+      path: lastPlaceSlug ? jobsLocationCategoryPath(lastPlaceSlug, primaryCategory.slug) : jobsCategoryPath(primaryCategory.slug)
     });
   }
-  crumbs.push({ name: job.title });
+  crumbs.push({ kind: "job", name: job.title });
   return crumbs;
 }
 
 export {
-  formatUsd,
-  formatRange,
-  formatSeniority,
+  normalizeLocale,
+  formatSalaryStat,
+  formatSalaryStatRange,
   SENIORITY_ORDER,
   sortBySeniority,
   buildSalaryFaq,

package/dist/doctor.js

@@ -57,7 +57,7 @@ function loadSkillCorpus(baseDir) {
       ).map((entry) => ({
         path: entry.name,
         content: (0, import_node_fs.readFileSync)((0, import_node_path.resolve)(skillDir, entry.name), "utf8")
-      })).sort((a, b) => a.path.localeCompare(b.path));
+      })).sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
       return {
         ...skill,
         content: (0, import_node_fs.readFileSync)(skillPath, "utf8"),

package/dist/doctor.mjs

@@ -27,7 +27,7 @@ function loadSkillCorpus(baseDir) {
       ).map((entry) => ({
         path: entry.name,
         content: readFileSync(resolve(skillDir, entry.name), "utf8")
-      })).sort((a, b) => a.path.localeCompare(b.path));
+      })).sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
       return {
         ...skill,
         content: readFileSync(skillPath, "utf8"),

package/dist/filters.d.mts

@@ -1,6 +1,27 @@
-import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.mjs';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-lVvKCBCU.mjs';
-import './_spec-nkWAraS0.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-BuLpV8iy.mjs';
+import './_spec-GVe6WAfT.mjs';
+
+/**
+ * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL
+ * search-param parsing for jobs-listing routes.
+ *
+ * One greppable convention across every tenant frontend: the vocabulary
+ * arrays mirror the hosted board; seniority URL parsing follows the hosted
+ * semantics exactly (trim, lowercase, dedupe — hand-typed URLs are messy).
+ *
+ * Map parsed filters onto the wire like:
+ * ```
+ * companySlug: filters.company,
+ * seniority: filters.seniority,
+ * remoteOption: filters.remoteOption ? [filters.remoteOption] : undefined,
+ * ```
+ * Company slugs are the URL identity; the API accepts them directly via
+ * `companySlug` — never resolve slug→id client-side.
+ *
+ * Display labels for seniority / sort / remote options are application-owned
+ * chrome words — this entry only ships the wire vocabulary and
+ * parsers.
+ */
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**
@@ -12,22 +33,6 @@ declare const EMPLOYMENT_TYPES: readonly EmploymentType[];
 declare const SENIORITIES: readonly Seniority[];
 declare const JOB_SORTS: readonly JobSort[];
 declare const DEFAULT_SORT: JobSort;
-/**
- * Seniority display labels in the board language (lexicon-backed, en+de),
- * ⊕ stored operator overrides (`jobCardLabels.seniority*`) when the
- * `labels` bag is passed.
- *
- * @example
- * seniorityLabels('de').executive; // "Führungskraft"
- */
-declare function seniorityLabels(locale: string, labels?: BoardLabelOverrides): Record<Seniority, string>;
-/**
- * Sort-dropdown labels in the board language, resolved from the copy
- * catalog (`uiCopy(locale).jobCard`) ⊕ stored operator overrides
- * (`jobCardLabels.aiRankedLabel` / `sortNewestLabel` / `sortSalaryHighLabel`)
- * when the `labels` bag is passed.
- */
-declare function sortLabels(locale: string, labels?: BoardLabelOverrides): Record<JobSort, string>;
 interface ListingFilters {
     q?: string;
     remoteOption?: RemoteOption;
@@ -66,4 +71,4 @@ declare function parseCompany(raw: unknown): string[] | undefined;
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority };

package/dist/filters.d.ts

@@ -1,6 +1,27 @@
-import { B as BoardLabelOverrides } from './ui-copy-CCkz6CVF.js';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-BiEvL9d7.js';
-import './_spec-nkWAraS0.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-QrbXOYB9.js';
+import './_spec-GVe6WAfT.js';
+
+/**
+ * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL
+ * search-param parsing for jobs-listing routes.
+ *
+ * One greppable convention across every tenant frontend: the vocabulary
+ * arrays mirror the hosted board; seniority URL parsing follows the hosted
+ * semantics exactly (trim, lowercase, dedupe — hand-typed URLs are messy).
+ *
+ * Map parsed filters onto the wire like:
+ * ```
+ * companySlug: filters.company,
+ * seniority: filters.seniority,
+ * remoteOption: filters.remoteOption ? [filters.remoteOption] : undefined,
+ * ```
+ * Company slugs are the URL identity; the API accepts them directly via
+ * `companySlug` — never resolve slug→id client-side.
+ *
+ * Display labels for seniority / sort / remote options are application-owned
+ * chrome words — this entry only ships the wire vocabulary and
+ * parsers.
+ */
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**
@@ -12,22 +33,6 @@ declare const EMPLOYMENT_TYPES: readonly EmploymentType[];
 declare const SENIORITIES: readonly Seniority[];
 declare const JOB_SORTS: readonly JobSort[];
 declare const DEFAULT_SORT: JobSort;
-/**
- * Seniority display labels in the board language (lexicon-backed, en+de),
- * ⊕ stored operator overrides (`jobCardLabels.seniority*`) when the
- * `labels` bag is passed.
- *
- * @example
- * seniorityLabels('de').executive; // "Führungskraft"
- */
-declare function seniorityLabels(locale: string, labels?: BoardLabelOverrides): Record<Seniority, string>;
-/**
- * Sort-dropdown labels in the board language, resolved from the copy
- * catalog (`uiCopy(locale).jobCard`) ⊕ stored operator overrides
- * (`jobCardLabels.aiRankedLabel` / `sortNewestLabel` / `sortSalaryHighLabel`)
- * when the `labels` bag is passed.
- */
-declare function sortLabels(locale: string, labels?: BoardLabelOverrides): Record<JobSort, string>;
 interface ListingFilters {
     q?: string;
     remoteOption?: RemoteOption;
@@ -66,4 +71,4 @@ declare function parseCompany(raw: unknown): string[] | undefined;
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority };