@cavuno/board 1.37.0 → 1.39.0

package/README.md

@@ -39,6 +39,13 @@ const board = createBoardClient({
 const { name, theme, features } = await board.context();
 const page = await board.jobs.list({ limit: 20 });
 const job = await board.jobs.retrieve('senior-chef');
+
+// Federated search-dropdown suggestions (companies + taxonomy terms).
+const { items } = await board.search.suggest({ q: 'acme', limit: 10 });
+// Or the headless controller (debounce / abort / stale-drop built in):
+// import { createSuggestController } from '@cavuno/board/suggest';
+// const suggest = createSuggestController(board);
+// suggest.setQuery('acme');
 ```
 
 Every method accepts trailing `FetchOptions` — `signal`, `headers`, and

package/dist/{jobs-CMCADU_-.d.mts → _spec-DxC1ze93.d.mts}

@@ -962,6 +962,25 @@ interface components {
             boardP75Max: number | null;
             currency: string;
         };
+        CompanySuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "company";
+            /** @description Stable company identity. */
+            id: string;
+            /** @description Public company URL slug. */
+            slug: string;
+            /** @description Company display name. */
+            name: string;
+            /** @description Company logo URL, or `null` when none is set. */
+            logoUrl: string | null;
+            /** @description Live published-job count for this company on the board. */
+            jobCount: number;
+        };
         CompanySummary: {
             /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
             id: string;
@@ -1707,8 +1726,8 @@ interface components {
              * @enum {string}
              */
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). */
-            applicationUrl: string;
+            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Omit to collect applications on the board (built-in applications). */
+            applicationUrl?: string;
             /** @description Minimum salary, in `salaryCurrency` units. */
             salaryMin?: number;
             /** @description Maximum salary, in `salaryCurrency` units. */
@@ -1938,8 +1957,8 @@ interface components {
              * @enum {string}
              */
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (which is normalized to `mailto:` form). */
-            applicationUrl?: string;
+            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Pass `null` to clear the stored value and switch the job to on-board (built-in) applications. Omitted means unchanged. */
+            applicationUrl?: string | null;
             /** @description Minimum salary, in `salaryCurrency` units. */
             salaryMin?: number;
             /** @description Maximum salary, in `salaryCurrency` units. */
@@ -3449,6 +3468,8 @@ interface components {
             filters?: {
                 /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
                 companyId?: string[];
+                /** @description Company slugs (the public URL identity). Up to 10. Resolved server-side; unknown slugs are dropped. Combined with `companyId` as a union. If the provided company filter resolves to no known companies, the result is empty. */
+                companySlug?: string[];
                 /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
                 remoteOption?: ("on_site" | "hybrid" | "remote")[];
                 /** @description Only return jobs with any of the given employment types. Up to 10 values. */
@@ -4172,6 +4193,15 @@ interface components {
                 createdAt: string;
             })[];
         };
+        SuggestResult: {
+            /** @enum {string} */
+            object: "suggest_result";
+            /** @description The trimmed query string that produced these suggestions. */
+            query: string;
+            /** @description Interleaved company + taxonomy-term suggestions. Order is server-ranked; clients must not re-sort. */
+            items: components["schemas"]["SuggestionItem"][];
+        };
+        SuggestionItem: components["schemas"]["CompanySuggestion"] | components["schemas"]["TermSuggestion"];
         TalentDirectoryEntry: {
             /** @enum {string} */
             object: "talent_directory_entry";
@@ -4254,6 +4284,28 @@ interface components {
             locality: string | null;
             placeType: string | null;
         } | null;
+        TermSuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "term";
+            /**
+             * @description Whether this taxonomy term is a category or a skill.
+             * @enum {string}
+             */
+            termType: "category" | "skill";
+            /** @description Stable taxonomy entity ID. */
+            id: string;
+            /** @description Current source-locale slug used by job search; old slugs may remain aliases. */
+            sourceSlug: string;
+            /** @description Board-language canonical URL slug. */
+            canonicalSlug: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
+        };
         TitleLocationSalary: {
             /** @enum {string} */
             object: "title_location_salary";
@@ -4784,99 +4836,4 @@ interface components {
 
 type Schemas = components['schemas'];
 
-/**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
- */
-/**
- * Optional offset-pagination metadata generated from the Board API contract.
- * `nextCursor` is preserved alongside for forward cursor iteration.
- */
-type OffsetPagination = Schemas['OffsetPagination'];
-/** @deprecated Use `OffsetPagination`. */
-type StorefrontPagination = OffsetPagination;
-/** @deprecated Use `OffsetPagination`. */
-type JobCatalogPagination = OffsetPagination;
-type ListEnvelope<T> = OffsetPagination & {
-    object: 'list';
-    url: string;
-    hasMore: boolean;
-    /** `null` when `hasMore` is false — always present, never undefined. */
-    nextCursor: string | null;
-    data: T[];
-};
-type SearchEnvelope<T> = OffsetPagination & {
-    object: 'search_result';
-    url: string;
-    hasMore: boolean;
-    nextCursor: string | null;
-    data: T[];
-};
-
-type PublicJob = Schemas['PublicJob'];
-type PublicJobCard = Schemas['PublicJobCard'];
-/**
- * A job's opaque, display-only custom-field values (CAV-294), keyed by each
- * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
- * (`board.context().customFields`).
- */
-type CustomFieldValues = PublicJob['customFieldValues'];
-type CustomFieldValue = CustomFieldValues[string];
-type JobCompany = Schemas['JobCompany'];
-type OfficeLocation = Schemas['JobOfficeLocation'];
-type RemoteOption = NonNullable<PublicJob['remoteOption']>;
-type EmploymentType = NonNullable<PublicJob['employmentType']>;
-type Seniority = NonNullable<PublicJob['seniority']>;
-/** Candidate-facing result ordering (ADR-0048); `relevance` is the default. */
-type JobSort = NonNullable<Schemas['PublicSearchJobsBody']['sort']>;
-type EducationRequirement = PublicJob['educationRequirements'][number];
-type RemotePermit = PublicJob['remotePermits'][number];
-type RemoteTimezone = PublicJob['remoteTimezones'][number];
-/**
- * Derived suggestion on a browse list (ADR-0037 §8): jobs surface `category`
- * and `skill` terms; the companies list surfaces `market` terms.
- */
-interface RelatedSearch {
-    type: 'category' | 'skill' | 'market';
-    slug: string;
-    term: string;
-    count: number;
-}
-/** The browse list envelope — `PublicJobCard`s + job catalog pagination + `relatedSearches`. */
-type JobCardListEnvelope = ListEnvelope<PublicJobCard> & {
-    relatedSearches?: RelatedSearch[];
-};
-/** The search envelope — `PublicJobCard`s + job catalog pagination. */
-type JobCardSearchEnvelope = SearchEnvelope<PublicJobCard>;
-type JobsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    /** Job catalog page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
-    offset?: number;
-    /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
-    companyId?: string[];
-    remoteOption?: RemoteOption[];
-    employmentType?: EmploymentType[];
-    seniority?: Seniority[];
-    /** Result ordering (ADR-0048). Absent ⇒ `relevance` (the featured-ranked browse). */
-    sort?: JobSort;
-    /** Place slug for a geo radius search; unresolvable slugs are ignored. */
-    location?: string;
-    /** Radius in km around `location` (10–250; default 50). */
-    radius?: number;
-    /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
-    category?: string;
-    /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
-    skill?: string;
-    /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
-    fields?: string;
-};
-type JobsSimilarQuery = {
-    /** How many similar jobs to return (1–20; default 5). */
-    limit?: number;
-};
-type JobsSearchBody = Schemas['PublicSearchJobsBody'];
-
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, PublicJobCard as a, Schemas as b, components as c, JobsListQuery as d, JobCardListEnvelope as e, JobsSearchBody as f, JobCardSearchEnvelope as g, JobsSimilarQuery as h, SearchEnvelope as i, CustomFieldValue as j, EducationRequirement as k, JobCatalogPagination as l, JobCompany as m, OffsetPagination as n, RelatedSearch as o, RemotePermit as p, RemoteTimezone as q, StorefrontPagination as r };
+export type { Schemas as S, components as c };

package/dist/{jobs-CMCADU_-.d.ts → _spec-DxC1ze93.d.ts}

@@ -962,6 +962,25 @@ interface components {
             boardP75Max: number | null;
             currency: string;
         };
+        CompanySuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "company";
+            /** @description Stable company identity. */
+            id: string;
+            /** @description Public company URL slug. */
+            slug: string;
+            /** @description Company display name. */
+            name: string;
+            /** @description Company logo URL, or `null` when none is set. */
+            logoUrl: string | null;
+            /** @description Live published-job count for this company on the board. */
+            jobCount: number;
+        };
         CompanySummary: {
             /** @description Unique identifier for the object. Use this value as the `{id}` path parameter for the company endpoints (e.g. `GET /v1/companies/{id}`). */
             id: string;
@@ -1707,8 +1726,8 @@ interface components {
              * @enum {string}
              */
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). */
-            applicationUrl: string;
+            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Omit to collect applications on the board (built-in applications). */
+            applicationUrl?: string;
             /** @description Minimum salary, in `salaryCurrency` units. */
             salaryMin?: number;
             /** @description Maximum salary, in `salaryCurrency` units. */
@@ -1938,8 +1957,8 @@ interface components {
              * @enum {string}
              */
             seniority?: "entry_level" | "associate" | "mid_level" | "senior" | "lead" | "principal" | "director" | "executive";
-            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (which is normalized to `mailto:` form). */
-            applicationUrl?: string;
+            /** @description Where candidates apply. Accepts an HTTPS URL, a `mailto:` URI, or a bare email address (normalized to `mailto:` form). Pass `null` to clear the stored value and switch the job to on-board (built-in) applications. Omitted means unchanged. */
+            applicationUrl?: string | null;
             /** @description Minimum salary, in `salaryCurrency` units. */
             salaryMin?: number;
             /** @description Maximum salary, in `salaryCurrency` units. */
@@ -3449,6 +3468,8 @@ interface components {
             filters?: {
                 /** @description Only return jobs at any of the given company IDs. Up to 10 values. */
                 companyId?: string[];
+                /** @description Company slugs (the public URL identity). Up to 10. Resolved server-side; unknown slugs are dropped. Combined with `companyId` as a union. If the provided company filter resolves to no known companies, the result is empty. */
+                companySlug?: string[];
                 /** @description Only return jobs with any of the given remote-work options. Up to 10 values. */
                 remoteOption?: ("on_site" | "hybrid" | "remote")[];
                 /** @description Only return jobs with any of the given employment types. Up to 10 values. */
@@ -4172,6 +4193,15 @@ interface components {
                 createdAt: string;
             })[];
         };
+        SuggestResult: {
+            /** @enum {string} */
+            object: "suggest_result";
+            /** @description The trimmed query string that produced these suggestions. */
+            query: string;
+            /** @description Interleaved company + taxonomy-term suggestions. Order is server-ranked; clients must not re-sort. */
+            items: components["schemas"]["SuggestionItem"][];
+        };
+        SuggestionItem: components["schemas"]["CompanySuggestion"] | components["schemas"]["TermSuggestion"];
         TalentDirectoryEntry: {
             /** @enum {string} */
             object: "talent_directory_entry";
@@ -4254,6 +4284,28 @@ interface components {
             locality: string | null;
             placeType: string | null;
         } | null;
+        TermSuggestion: {
+            /** @enum {string} */
+            object: "suggestion";
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "term";
+            /**
+             * @description Whether this taxonomy term is a category or a skill.
+             * @enum {string}
+             */
+            termType: "category" | "skill";
+            /** @description Stable taxonomy entity ID. */
+            id: string;
+            /** @description Current source-locale slug used by job search; old slugs may remain aliases. */
+            sourceSlug: string;
+            /** @description Board-language canonical URL slug. */
+            canonicalSlug: string;
+            /** @description Board-language name with source-name fallback. */
+            displayName: string;
+        };
         TitleLocationSalary: {
             /** @enum {string} */
             object: "title_location_salary";
@@ -4784,99 +4836,4 @@ interface components {
 
 type Schemas = components['schemas'];
 
-/**
- * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The
- * server MAY add top-level fields; consumers MUST ignore unknown
- * fields.
- */
-/**
- * Optional offset-pagination metadata generated from the Board API contract.
- * `nextCursor` is preserved alongside for forward cursor iteration.
- */
-type OffsetPagination = Schemas['OffsetPagination'];
-/** @deprecated Use `OffsetPagination`. */
-type StorefrontPagination = OffsetPagination;
-/** @deprecated Use `OffsetPagination`. */
-type JobCatalogPagination = OffsetPagination;
-type ListEnvelope<T> = OffsetPagination & {
-    object: 'list';
-    url: string;
-    hasMore: boolean;
-    /** `null` when `hasMore` is false — always present, never undefined. */
-    nextCursor: string | null;
-    data: T[];
-};
-type SearchEnvelope<T> = OffsetPagination & {
-    object: 'search_result';
-    url: string;
-    hasMore: boolean;
-    nextCursor: string | null;
-    data: T[];
-};
-
-type PublicJob = Schemas['PublicJob'];
-type PublicJobCard = Schemas['PublicJobCard'];
-/**
- * A job's opaque, display-only custom-field values (CAV-294), keyed by each
- * field's `key`. Resolve labels via the board's `CustomFieldDefinition`s
- * (`board.context().customFields`).
- */
-type CustomFieldValues = PublicJob['customFieldValues'];
-type CustomFieldValue = CustomFieldValues[string];
-type JobCompany = Schemas['JobCompany'];
-type OfficeLocation = Schemas['JobOfficeLocation'];
-type RemoteOption = NonNullable<PublicJob['remoteOption']>;
-type EmploymentType = NonNullable<PublicJob['employmentType']>;
-type Seniority = NonNullable<PublicJob['seniority']>;
-/** Candidate-facing result ordering (ADR-0048); `relevance` is the default. */
-type JobSort = NonNullable<Schemas['PublicSearchJobsBody']['sort']>;
-type EducationRequirement = PublicJob['educationRequirements'][number];
-type RemotePermit = PublicJob['remotePermits'][number];
-type RemoteTimezone = PublicJob['remoteTimezones'][number];
-/**
- * Derived suggestion on a browse list (ADR-0037 §8): jobs surface `category`
- * and `skill` terms; the companies list surfaces `market` terms.
- */
-interface RelatedSearch {
-    type: 'category' | 'skill' | 'market';
-    slug: string;
-    term: string;
-    count: number;
-}
-/** The browse list envelope — `PublicJobCard`s + job catalog pagination + `relatedSearches`. */
-type JobCardListEnvelope = ListEnvelope<PublicJobCard> & {
-    relatedSearches?: RelatedSearch[];
-};
-/** The search envelope — `PublicJobCard`s + job catalog pagination. */
-type JobCardSearchEnvelope = SearchEnvelope<PublicJobCard>;
-type JobsListQuery = {
-    cursor?: string;
-    /** 1–100. */
-    limit?: number;
-    /** Job catalog page offset; takes precedence over `cursor`. `offset + limit` ≤ 10,000. */
-    offset?: number;
-    /** Repeated param (up to 10) — OR-matched. Repeat `companyId` per value. */
-    companyId?: string[];
-    remoteOption?: RemoteOption[];
-    employmentType?: EmploymentType[];
-    seniority?: Seniority[];
-    /** Result ordering (ADR-0048). Absent ⇒ `relevance` (the featured-ranked browse). */
-    sort?: JobSort;
-    /** Place slug for a geo radius search; unresolvable slugs are ignored. */
-    location?: string;
-    /** Radius in km around `location` (10–250; default 50). */
-    radius?: number;
-    /** Category slug seed (the `/jobs/[keyword]` page) — server resolves it to the English source name; unresolvable → 404. */
-    category?: string;
-    /** Skill slug seed (the `/jobs/skills/[skill]` page) — server-resolved; unresolvable → 404. */
-    skill?: string;
-    /** Sparse fieldset (Medusa-style `+field`). Only `'+description'` is supported — adds `description` to each card. */
-    fields?: string;
-};
-type JobsSimilarQuery = {
-    /** How many similar jobs to return (1–20; default 5). */
-    limit?: number;
-};
-type JobsSearchBody = Schemas['PublicSearchJobsBody'];
-
-export type { CustomFieldValues as C, EmploymentType as E, JobSort as J, ListEnvelope as L, OfficeLocation as O, PublicJob as P, RemoteOption as R, Seniority as S, PublicJobCard as a, Schemas as b, components as c, JobsListQuery as d, JobCardListEnvelope as e, JobsSearchBody as f, JobCardSearchEnvelope as g, JobsSimilarQuery as h, SearchEnvelope as i, CustomFieldValue as j, EducationRequirement as k, JobCatalogPagination as l, JobCompany as m, OffsetPagination as n, RelatedSearch as o, RemotePermit as p, RemoteTimezone as q, StorefrontPagination as r };
+export type { Schemas as S, components as c };

package/dist/{board-D_BRa2zC.d.ts → board-CqYibYUA.d.mts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-CMCADU_-.js';
+import { S as Schemas } from './_spec-DxC1ze93.mjs';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/{board-D0guOBYy.d.mts → board-RfZEAJse.d.ts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-CMCADU_-.mjs';
+import { S as Schemas } from './_spec-DxC1ze93.js';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/filters.d.mts

@@ -1,5 +1,6 @@
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.mjs';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CMCADU_-.mjs';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-DPPA1Nev.mjs';
+import './_spec-DxC1ze93.mjs';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**
@@ -33,6 +34,12 @@ interface ListingFilters {
     employmentType?: EmploymentType;
     /** Multi-select (parity with the hosted board's seniority checkboxes). */
     seniority?: Seniority[];
+    /**
+     * Company filter as PUBLIC SLUGS (the URL identity). Multi-select tolerated
+     * in URLs (comma-joined); the hosted UI applies single-replace. Map to the
+     * wire as `companySlug` (`jobs.list` query / `jobs.search` filters).
+     */
+    company?: string[];
     /** Result ordering (ADR-0048); absent ⇒ `relevance`. */
     sort?: JobSort;
 }
@@ -42,14 +49,21 @@ interface ListingFilters {
  * semantics: trim, lowercase, drop unknowns, dedupe preserving order.
  */
 declare function parseSeniority(raw: unknown): Seniority[] | undefined;
+/**
+ * Normalise raw company-slug input — an array (repeated params) or a
+ * comma-string (hand-typed URL) — with the hosted semantics: trim,
+ * lowercase, drop empties, dedupe preserving order, then cap at 10
+ * (the wire max; keep FIRST 10). Open value set (no vocabulary).
+ */
+declare function parseCompany(raw: unknown): string[] | undefined;
 /**
  * Validate raw URL search params into the supported listing filters,
  * dropping unknown values (never throwing — listing URLs are public input).
  *
  * @example
- * parseListingFilters({ seniority: 'senior,lead', sort: 'newest' });
- * // { seniority: ['senior', 'lead'], sort: 'newest' }
+ * parseListingFilters({ seniority: 'senior,lead', company: 'acme', sort: 'newest' });
+ * // { seniority: ['senior', 'lead'], company: ['acme'], sort: 'newest' }
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };

package/dist/filters.d.ts

@@ -1,5 +1,6 @@
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.js';
-import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CMCADU_-.js';
+import { J as JobSort, E as EmploymentType, R as RemoteOption, S as Seniority } from './jobs-CLLIvtMc.js';
+import './_spec-DxC1ze93.js';
 
 declare const REMOTE_OPTIONS: readonly RemoteOption[];
 /**
@@ -33,6 +34,12 @@ interface ListingFilters {
     employmentType?: EmploymentType;
     /** Multi-select (parity with the hosted board's seniority checkboxes). */
     seniority?: Seniority[];
+    /**
+     * Company filter as PUBLIC SLUGS (the URL identity). Multi-select tolerated
+     * in URLs (comma-joined); the hosted UI applies single-replace. Map to the
+     * wire as `companySlug` (`jobs.list` query / `jobs.search` filters).
+     */
+    company?: string[];
     /** Result ordering (ADR-0048); absent ⇒ `relevance`. */
     sort?: JobSort;
 }
@@ -42,14 +49,21 @@ interface ListingFilters {
  * semantics: trim, lowercase, drop unknowns, dedupe preserving order.
  */
 declare function parseSeniority(raw: unknown): Seniority[] | undefined;
+/**
+ * Normalise raw company-slug input — an array (repeated params) or a
+ * comma-string (hand-typed URL) — with the hosted semantics: trim,
+ * lowercase, drop empties, dedupe preserving order, then cap at 10
+ * (the wire max; keep FIRST 10). Open value set (no vocabulary).
+ */
+declare function parseCompany(raw: unknown): string[] | undefined;
 /**
  * Validate raw URL search params into the supported listing filters,
  * dropping unknown values (never throwing — listing URLs are public input).
  *
  * @example
- * parseListingFilters({ seniority: 'senior,lead', sort: 'newest' });
- * // { seniority: ['senior', 'lead'], sort: 'newest' }
+ * parseListingFilters({ seniority: 'senior,lead', company: 'acme', sort: 'newest' });
+ * // { seniority: ['senior', 'lead'], company: ['acme'], sort: 'newest' }
  */
 declare function parseListingFilters(search: Record<string, unknown>): ListingFilters;
 
-export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };
+export { DEFAULT_SORT, EMPLOYMENT_TYPES, JOB_SORTS, type ListingFilters, REMOTE_OPTIONS, SENIORITIES, parseCompany, parseListingFilters, parseSeniority, seniorityLabels, sortLabels };

package/dist/filters.js

@@ -25,6 +25,7 @@ __export(filters_exports, {
   JOB_SORTS: () => JOB_SORTS,
   REMOTE_OPTIONS: () => REMOTE_OPTIONS,
   SENIORITIES: () => SENIORITIES,
+  parseCompany: () => parseCompany,
   parseListingFilters: () => parseListingFilters,
   parseSeniority: () => parseSeniority,
   seniorityLabels: () => seniorityLabels,
@@ -746,6 +747,7 @@ function sortLabels(locale, labels) {
     salary_high: copy.sortSalaryHighLabel
   };
 }
+var COMPANY_SLUG_MAX = 10;
 var SENIORITY_LOOKUP = new Set(SENIORITIES);
 function parseSeniority(raw) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
@@ -761,6 +763,20 @@ function parseSeniority(raw) {
   }
   return result.length > 0 ? result : void 0;
 }
+function parseCompany(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;
+    seen.add(normalized);
+    result.push(normalized);
+    if (result.length >= COMPANY_SLUG_MAX) break;
+  }
+  return result.length > 0 ? result : void 0;
+}
 function parseListingFilters(search) {
   return {
     q: typeof search.q === "string" && search.q ? search.q : void 0,
@@ -769,6 +785,7 @@ function parseListingFilters(search) {
       search.employmentType
     ) ? search.employmentType : void 0,
     seniority: parseSeniority(search.seniority),
+    company: parseCompany(search.company),
     sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
   };
 }

package/dist/filters.mjs

@@ -712,6 +712,7 @@ function sortLabels(locale, labels) {
     salary_high: copy.sortSalaryHighLabel
   };
 }
+var COMPANY_SLUG_MAX = 10;
 var SENIORITY_LOOKUP = new Set(SENIORITIES);
 function parseSeniority(raw) {
   const values = Array.isArray(raw) ? raw : typeof raw === "string" && raw ? raw.split(",") : [];
@@ -727,6 +728,20 @@ function parseSeniority(raw) {
   }
   return result.length > 0 ? result : void 0;
 }
+function parseCompany(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;
+    seen.add(normalized);
+    result.push(normalized);
+    if (result.length >= COMPANY_SLUG_MAX) break;
+  }
+  return result.length > 0 ? result : void 0;
+}
 function parseListingFilters(search) {
   return {
     q: typeof search.q === "string" && search.q ? search.q : void 0,
@@ -735,6 +750,7 @@ function parseListingFilters(search) {
       search.employmentType
     ) ? search.employmentType : void 0,
     seniority: parseSeniority(search.seniority),
+    company: parseCompany(search.company),
     sort: JOB_SORTS.includes(search.sort) ? search.sort : void 0
   };
 }
@@ -744,6 +760,7 @@ export {
   JOB_SORTS,
   REMOTE_OPTIONS,
   SENIORITIES,
+  parseCompany,
   parseListingFilters,
   parseSeniority,
   seniorityLabels,

package/dist/format.d.mts

@@ -1,7 +1,8 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-CMCADU_-.mjs';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-DPPA1Nev.mjs';
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.mjs';
 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-CKfFTtLk.mjs';
-import { C as CustomFieldDefinition } from './board-D0guOBYy.mjs';
+import { C as CustomFieldDefinition } from './board-CqYibYUA.mjs';
+import './_spec-DxC1ze93.mjs';
 
 /**
  * Date display helpers in the board language (required leading parameter,

package/dist/format.d.ts

@@ -1,7 +1,8 @@
-import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-CMCADU_-.js';
+import { P as PublicJob, a as PublicJobCard, C as CustomFieldValues } from './jobs-CLLIvtMc.js';
 import { B as BoardLabelOverrides } from './ui-copy-CKfFTtLk.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-CKfFTtLk.js';
-import { C as CustomFieldDefinition } from './board-D_BRa2zC.js';
+import { C as CustomFieldDefinition } from './board-RfZEAJse.js';
+import './_spec-DxC1ze93.js';
 
 /**
  * Date display helpers in the board language (required leading parameter,