@cavuno/board 4.26.0 → 4.28.0

package/dist/filters.d.mts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CfrxlDMU.mjs';
-import './_spec-EgN7VmAI.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-DjMcghv6.mjs';
+import './_spec-DQvmsp5o.mjs';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL
@@ -15,6 +15,8 @@ import './_spec-EgN7VmAI.mjs';
  * seniority: filters.seniority,
  * remoteOption: filters.remoteOption ? [filters.remoteOption] : undefined,
  * ```
+ * Category is a `jobs.search` filter only: pass `filters.category` as
+ * `filters.categories` in the search body.
  * Company slugs are the URL identity; the API accepts them directly via
  * `companySlug` — never resolve slug→id client-side.
  *
@@ -45,6 +47,12 @@ interface ListingFilters {
      * wire as `companySlug` (`jobs.list` query / `jobs.search` filters).
      */
     company?: string[];
+    /**
+     * Category filter as category SLUGS (a term's `sourceSlug` or
+     * `canonicalSlug`). Multi-select, comma-joined in URLs, matched as any-of.
+     * Map to the wire as `categories` in `jobs.search` filters.
+     */
+    category?: string[];
     /** Result ordering; absent ⇒ `relevance`. */
     sort?: JobSort;
 }
@@ -61,6 +69,12 @@ declare function parseSeniority(raw: unknown): Seniority[] | undefined;
  * (the wire max; keep FIRST 10). Open value set (no vocabulary).
  */
 declare function parseCompany(raw: unknown): string[] | undefined;
+/**
+ * Normalise raw category-slug input with the same semantics as
+ * {@link parseCompany}: an array or comma-string; trim, lowercase, drop
+ * empties, dedupe preserving order, cap at 10 (the wire max; keep FIRST 10).
+ */
+declare function parseCategory(raw: unknown): string[] | undefined;
 /**
  * Validate raw URL search params into the supported listing filters,
  * dropping unknown values (never throwing — listing URLs are public input).
@@ -68,7 +82,9 @@ declare function parseCompany(raw: unknown): string[] | undefined;
  * @example
  * parseListingFilters({ seniority: 'senior,lead', company: 'acme', sort: 'newest' });
  * // { seniority: ['senior', 'lead'], company: ['acme'], sort: 'newest' }
+ * parseListingFilters({ category: 'engineering,design' });
+ * // { category: ['engineering', 'design'] }
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCategory, parseCompany, parseListingFilters, parseSeniority };

package/dist/filters.d.ts

@@ -1,5 +1,5 @@
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-ub3gywNQ.js';
-import './_spec-EgN7VmAI.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CEIuahbz.js';
+import './_spec-DQvmsp5o.js';
 
 /**
  * `@cavuno/board/filters` — the canonical listing-filter vocabulary and URL
@@ -15,6 +15,8 @@ import './_spec-EgN7VmAI.js';
  * seniority: filters.seniority,
  * remoteOption: filters.remoteOption ? [filters.remoteOption] : undefined,
  * ```
+ * Category is a `jobs.search` filter only: pass `filters.category` as
+ * `filters.categories` in the search body.
  * Company slugs are the URL identity; the API accepts them directly via
  * `companySlug` — never resolve slug→id client-side.
  *
@@ -45,6 +47,12 @@ interface ListingFilters {
      * wire as `companySlug` (`jobs.list` query / `jobs.search` filters).
      */
     company?: string[];
+    /**
+     * Category filter as category SLUGS (a term's `sourceSlug` or
+     * `canonicalSlug`). Multi-select, comma-joined in URLs, matched as any-of.
+     * Map to the wire as `categories` in `jobs.search` filters.
+     */
+    category?: string[];
     /** Result ordering; absent ⇒ `relevance`. */
     sort?: JobSort;
 }
@@ -61,6 +69,12 @@ declare function parseSeniority(raw: unknown): Seniority[] | undefined;
  * (the wire max; keep FIRST 10). Open value set (no vocabulary).
  */
 declare function parseCompany(raw: unknown): string[] | undefined;
+/**
+ * Normalise raw category-slug input with the same semantics as
+ * {@link parseCompany}: an array or comma-string; trim, lowercase, drop
+ * empties, dedupe preserving order, cap at 10 (the wire max; keep FIRST 10).
+ */
+declare function parseCategory(raw: unknown): string[] | undefined;
 /**
  * Validate raw URL search params into the supported listing filters,
  * dropping unknown values (never throwing — listing URLs are public input).
@@ -68,7 +82,9 @@ declare function parseCompany(raw: unknown): string[] | undefined;
  * @example
  * parseListingFilters({ seniority: 'senior,lead', company: 'acme', sort: 'newest' });
  * // { seniority: ['senior', 'lead'], company: ['acme'], sort: 'newest' }
+ * parseListingFilters({ category: 'engineering,design' });
+ * // { category: ['engineering', 'design'] }
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCategory, parseCompany, parseListingFilters, parseSeniority };

package/dist/filters.js

@@ -25,6 +25,7 @@ __export(filters_exports, {
   JOB_SORTS: () => JOB_SORTS,
   REMOTE_OPTIONS: () => REMOTE_OPTIONS,
   SENIORITIES: () => SENIORITIES,
+  parseCategory: () => parseCategory,
   parseCompany: () => parseCompany,
   parseListingFilters: () => parseListingFilters,
   parseSeniority: () => parseSeniority
@@ -59,6 +60,7 @@ var JOB_SORTS = [
 ];
 var DEFAULT_SORT = "relevance";
 var COMPANY_SLUG_MAX = 10;
+var CATEGORY_SLUG_MAX = 10;
 var SENIORITY_LOOKUP = new Set(SENIORITIES);
 function parseSeniority(raw) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
@@ -75,6 +77,12 @@ function parseSeniority(raw) {
   return result.length > 0 ? result : void 0;
 }
 function parseCompany(raw) {
+  return parseSlugList(raw, COMPANY_SLUG_MAX);
+}
+function parseCategory(raw) {
+  return parseSlugList(raw, CATEGORY_SLUG_MAX);
+}
+function parseSlugList(raw, max) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
   const result = [];
   const seen = /* @__PURE__ */ new Set();
@@ -84,7 +92,7 @@ function parseCompany(raw) {
     if (!normalized || seen.has(normalized)) continue;
     seen.add(normalized);
     result.push(normalized);
-    if (result.length >= COMPANY_SLUG_MAX) break;
+    if (result.length >= max) break;
   }
   return result.length > 0 ? result : void 0;
 }
@@ -97,6 +105,7 @@ function parseListingFilters(search) {
     ) ? search.employmentType : void 0,
     seniority: parseSeniority(search.seniority),
     company: parseCompany(search.company),
+    category: parseCategory(search.category),
     sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
   };
 }

package/dist/filters.mjs

@@ -28,6 +28,7 @@ var JOB_SORTS = [
 ];
 var DEFAULT_SORT = "relevance";
 var COMPANY_SLUG_MAX = 10;
+var CATEGORY_SLUG_MAX = 10;
 var SENIORITY_LOOKUP = new Set(SENIORITIES);
 function parseSeniority(raw) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
@@ -44,6 +45,12 @@ function parseSeniority(raw) {
   return result.length > 0 ? result : void 0;
 }
 function parseCompany(raw) {
+  return parseSlugList(raw, COMPANY_SLUG_MAX);
+}
+function parseCategory(raw) {
+  return parseSlugList(raw, CATEGORY_SLUG_MAX);
+}
+function parseSlugList(raw, max) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
   const result = [];
   const seen = /* @__PURE__ */ new Set();
@@ -53,7 +60,7 @@ function parseCompany(raw) {
     if (!normalized || seen.has(normalized)) continue;
     seen.add(normalized);
     result.push(normalized);
-    if (result.length >= COMPANY_SLUG_MAX) break;
+    if (result.length >= max) break;
   }
   return result.length > 0 ? result : void 0;
 }
@@ -66,6 +73,7 @@ function parseListingFilters(search) {
     ) ? search.employmentType : void 0,
     seniority: parseSeniority(search.seniority),
     company: parseCompany(search.company),
+    category: parseCategory(search.category),
     sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
   };
 }
@@ -75,6 +83,7 @@ export {
   JOB_SORTS,
   REMOTE_OPTIONS,
   SENIORITIES,
+  parseCategory,
   parseCompany,
   parseListingFilters,
   parseSeniority

package/dist/format.d.mts

@@ -1,7 +1,7 @@
-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-CFcCjuG7.mjs';
-import { C as CustomFieldDefinition } from './board-q0svBKW3.mjs';
-import { C as CustomFieldValues } from './jobs-CfrxlDMU.mjs';
-import './_spec-EgN7VmAI.mjs';
+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-BBvJ5gq-.mjs';
+import { C as CustomFieldDefinition } from './board-D6xOidUX.mjs';
+import { C as CustomFieldValues } from './jobs-DjMcghv6.mjs';
+import './_spec-DQvmsp5o.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,7 +1,7 @@
-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-xuDid8BS.js';
-import { C as CustomFieldDefinition } from './board-CsEAgsKh.js';
-import { C as CustomFieldValues } from './jobs-ub3gywNQ.js';
-import './_spec-EgN7VmAI.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-D2Cwrju4.js';
+import { C as CustomFieldDefinition } from './board-CCG1pO6r.js';
+import { C as CustomFieldValues } from './jobs-CEIuahbz.js';
+import './_spec-DQvmsp5o.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,