@cavuno/board 3.2.0 → 4.0.0

package/dist/paths.d.mts

@@ -9,11 +9,27 @@
  * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
+ * Dynamic path segments are percent-encoded (URI, not bare IRI) so
+ * non-Latin board-language slugs (`SuggestionPathInput.canonicalSlug`)
+ * are legal in sitemap `<loc>`, canonical/`og:url`, and email links.
+ * Separators (`/`) are never encoded; already-encoded input is not
+ * double-encoded.
+ *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
  * cross-surface contract.
  */
+/**
+ * Percent-encode one path segment for use in a URL path.
+ * Round-trips already-encoded input so `%E6…` is not double-encoded.
+ * Does not touch path separators — callers encode segments only.
+ *
+ * `:` is left unencoded so route-contract / well-known templates built via
+ * `jobDetailPath(':companySlug', ':jobSlug')` stay RFC-6570-style. Real
+ * board slugs are alphanumeric-plus-hyphen; non-ASCII is still encoded.
+ */
+declare function encodePathSegment(segment: string): string;
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
 /** Category (keyword) job listing. */
@@ -22,10 +38,81 @@ declare function jobsCategoryPath(categorySlug: string): string;
 declare function jobsSkillPath(skillSlug: string): string;
 /** Location job listing. */
 declare function jobsLocationPath(placeSlug: string): string;
+/**
+ * Location + category combination job listing
+ * (`/jobs/locations/<place>/<category>`).
+ */
+declare function jobsLocationCategoryPath(placeSlug: string, categorySlug: string): string;
+/**
+ * Location + skill combination job listing
+ * (`/jobs/locations/<place>/skills/<skill>`).
+ */
+declare function jobsLocationSkillPath(placeSlug: string, skillSlug: string): string;
 /** Company profile. */
 declare function companyPath(companySlug: string): string;
 /** Company market (sector) listing. */
 declare function companyMarketPath(marketSlug: string): string;
+/**
+ * Suggestion kinds `suggestionPath` understands. Mirrors the wire
+ * `SuggestionItem` discriminators (and `termType` for terms) without
+ * importing generated OpenAPI types into the paths entry.
+ */
+type SuggestionPathInput = {
+    type: 'company';
+    slug: string;
+} | {
+    type: 'market';
+    slug: string;
+} | {
+    type: 'post';
+    slug: string;
+} | {
+    type: 'tag';
+    slug: string;
+} | {
+    type: 'term';
+    termType: 'category' | 'skill';
+    /** Board-language URL slug — use `canonicalSlug` from the wire item. */
+    canonicalSlug: string;
+};
+/** Search scopes that own different destinations for the same suggestion. */
+type SuggestionPathScope = 'jobs' | 'companies' | 'blog';
+type SuggestionPathOptions = {
+    scope: SuggestionPathScope;
+    /**
+     * Active place slug. When set on the `jobs` scope with a category or
+     * skill term, routes into the location combination pages.
+     */
+    location?: string;
+};
+/**
+ * Resolve a suggestion to a board-relative path for the given search scope
+ * The API never returns an `href` because the same
+ * `CompanySuggestion` means "navigate to the company page" under companies
+ * scope and "apply a `companySlug` filter" under jobs scope — only the app
+ * knows which.
+ *
+ * Returns `null` when the selection is not a navigation (jobs-scope company
+ * → filter, or a kind that has no path under the active scope). Compose from
+ * the existing `*Path` helpers; never string-build at the call site.
+ *
+ * | scope | suggestion | result |
+ * | --- | --- | --- |
+ * | jobs | skill | `/jobs/skills/<slug>` |
+ * | jobs | category | `/jobs/<slug>` |
+ * | jobs | skill + location | `/jobs/locations/<loc>/skills/<slug>` |
+ * | jobs | category + location | `/jobs/locations/<loc>/<slug>` |
+ * | jobs | company | `null` (apply `companySlug` filter) |
+ * | jobs | market | `null` |
+ * | jobs | post / tag | `null` |
+ * | companies | company | `/companies/<slug>` |
+ * | companies | market | `/companies/markets/<slug>` |
+ * | companies | term / post / tag | `null` |
+ * | blog | post | `/blog/<slug>` |
+ * | blog | tag | `/blog/tag/<slug>` |
+ * | blog | other | `null` |
+ */
+declare function suggestionPath(suggestion: SuggestionPathInput, options: SuggestionPathOptions): string | null;
 /** A company's salary overview. */
 declare function companySalaryPath(companySlug: string): string;
 /** Salary page for a job title. */
@@ -90,7 +177,8 @@ declare function goAlertsConfirmPath(): string;
 /**
  * Prefix a board-relative path with the board origin. A trailing slash on
  * the origin is tolerated (stripped) so callers need not normalise first.
+ * Paths from `*Path` helpers already percent-encode dynamic segments.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath };

package/dist/paths.d.ts

@@ -9,11 +9,27 @@
  * zero-dependency — safe to import in server runtimes, on the edge,
  * and in the browser.
  *
+ * Dynamic path segments are percent-encoded (URI, not bare IRI) so
+ * non-Latin board-language slugs (`SuggestionPathInput.canonicalSlug`)
+ * are legal in sitemap `<loc>`, canonical/`og:url`, and email links.
+ * Separators (`/`) are never encoded; already-encoded input is not
+ * double-encoded.
+ *
  * These paths mirror the hosted board's indexed URLs exactly (migration
  * parity). Do NOT change a pattern here without updating the hosted board
  * and the sitemap golden tests in lockstep — the structure is a locked
  * cross-surface contract.
  */
+/**
+ * Percent-encode one path segment for use in a URL path.
+ * Round-trips already-encoded input so `%E6…` is not double-encoded.
+ * Does not touch path separators — callers encode segments only.
+ *
+ * `:` is left unencoded so route-contract / well-known templates built via
+ * `jobDetailPath(':companySlug', ':jobSlug')` stay RFC-6570-style. Real
+ * board slugs are alphanumeric-plus-hyphen; non-ASCII is still encoded.
+ */
+declare function encodePathSegment(segment: string): string;
 /** Job detail — the canonical, indexed job URL. Requires BOTH slugs. */
 declare function jobDetailPath(companySlug: string, jobSlug: string): string;
 /** Category (keyword) job listing. */
@@ -22,10 +38,81 @@ declare function jobsCategoryPath(categorySlug: string): string;
 declare function jobsSkillPath(skillSlug: string): string;
 /** Location job listing. */
 declare function jobsLocationPath(placeSlug: string): string;
+/**
+ * Location + category combination job listing
+ * (`/jobs/locations/<place>/<category>`).
+ */
+declare function jobsLocationCategoryPath(placeSlug: string, categorySlug: string): string;
+/**
+ * Location + skill combination job listing
+ * (`/jobs/locations/<place>/skills/<skill>`).
+ */
+declare function jobsLocationSkillPath(placeSlug: string, skillSlug: string): string;
 /** Company profile. */
 declare function companyPath(companySlug: string): string;
 /** Company market (sector) listing. */
 declare function companyMarketPath(marketSlug: string): string;
+/**
+ * Suggestion kinds `suggestionPath` understands. Mirrors the wire
+ * `SuggestionItem` discriminators (and `termType` for terms) without
+ * importing generated OpenAPI types into the paths entry.
+ */
+type SuggestionPathInput = {
+    type: 'company';
+    slug: string;
+} | {
+    type: 'market';
+    slug: string;
+} | {
+    type: 'post';
+    slug: string;
+} | {
+    type: 'tag';
+    slug: string;
+} | {
+    type: 'term';
+    termType: 'category' | 'skill';
+    /** Board-language URL slug — use `canonicalSlug` from the wire item. */
+    canonicalSlug: string;
+};
+/** Search scopes that own different destinations for the same suggestion. */
+type SuggestionPathScope = 'jobs' | 'companies' | 'blog';
+type SuggestionPathOptions = {
+    scope: SuggestionPathScope;
+    /**
+     * Active place slug. When set on the `jobs` scope with a category or
+     * skill term, routes into the location combination pages.
+     */
+    location?: string;
+};
+/**
+ * Resolve a suggestion to a board-relative path for the given search scope
+ * The API never returns an `href` because the same
+ * `CompanySuggestion` means "navigate to the company page" under companies
+ * scope and "apply a `companySlug` filter" under jobs scope — only the app
+ * knows which.
+ *
+ * Returns `null` when the selection is not a navigation (jobs-scope company
+ * → filter, or a kind that has no path under the active scope). Compose from
+ * the existing `*Path` helpers; never string-build at the call site.
+ *
+ * | scope | suggestion | result |
+ * | --- | --- | --- |
+ * | jobs | skill | `/jobs/skills/<slug>` |
+ * | jobs | category | `/jobs/<slug>` |
+ * | jobs | skill + location | `/jobs/locations/<loc>/skills/<slug>` |
+ * | jobs | category + location | `/jobs/locations/<loc>/<slug>` |
+ * | jobs | company | `null` (apply `companySlug` filter) |
+ * | jobs | market | `null` |
+ * | jobs | post / tag | `null` |
+ * | companies | company | `/companies/<slug>` |
+ * | companies | market | `/companies/markets/<slug>` |
+ * | companies | term / post / tag | `null` |
+ * | blog | post | `/blog/<slug>` |
+ * | blog | tag | `/blog/tag/<slug>` |
+ * | blog | other | `null` |
+ */
+declare function suggestionPath(suggestion: SuggestionPathInput, options: SuggestionPathOptions): string | null;
 /** A company's salary overview. */
 declare function companySalaryPath(companySlug: string): string;
 /** Salary page for a job title. */
@@ -90,7 +177,8 @@ declare function goAlertsConfirmPath(): string;
 /**
  * Prefix a board-relative path with the board origin. A trailing slash on
  * the origin is tolerated (stripped) so callers need not normalise first.
+ * Paths from `*Path` helpers already percent-encode dynamic segments.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, type SuggestionPathInput, type SuggestionPathOptions, type SuggestionPathScope, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, encodePathSegment, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationCategoryPath, jobsLocationPath, jobsLocationSkillPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath, suggestionPath };

package/dist/paths.js

@@ -28,56 +28,104 @@ __export(paths_exports, {
   companyMarketPath: () => companyMarketPath,
   companyPath: () => companyPath,
   companySalaryPath: () => companySalaryPath,
+  encodePathSegment: () => encodePathSegment,
   goAlertsConfirmPath: () => goAlertsConfirmPath,
   goAlertsManagePath: () => goAlertsManagePath,
   goJobPath: () => goJobPath,
   jobDetailPath: () => jobDetailPath,
   jobsCategoryPath: () => jobsCategoryPath,
+  jobsLocationCategoryPath: () => jobsLocationCategoryPath,
   jobsLocationPath: () => jobsLocationPath,
+  jobsLocationSkillPath: () => jobsLocationSkillPath,
   jobsSkillPath: () => jobsSkillPath,
   salaryLocationPath: () => salaryLocationPath,
   salarySkillPath: () => salarySkillPath,
-  salaryTitlePath: () => salaryTitlePath
+  salaryTitlePath: () => salaryTitlePath,
+  suggestionPath: () => suggestionPath
 });
 module.exports = __toCommonJS(paths_exports);
+function encodePathSegment(segment) {
+  try {
+    return encodeURIComponent(decodeURIComponent(segment)).replace(
+      /%3A/gi,
+      ":"
+    );
+  } catch {
+    return encodeURIComponent(segment).replace(/%3A/gi, ":");
+  }
+}
 function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
+  return `/companies/${encodePathSegment(companySlug)}/jobs/${encodePathSegment(jobSlug)}`;
 }
 function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
+  return `/jobs/${encodePathSegment(categorySlug)}`;
 }
 function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
+  return `/jobs/skills/${encodePathSegment(skillSlug)}`;
 }
 function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
+  return `/jobs/locations/${encodePathSegment(placeSlug)}`;
+}
+function jobsLocationCategoryPath(placeSlug, categorySlug) {
+  return `${jobsLocationPath(placeSlug)}/${encodePathSegment(categorySlug)}`;
+}
+function jobsLocationSkillPath(placeSlug, skillSlug) {
+  return `${jobsLocationPath(placeSlug)}/skills/${encodePathSegment(skillSlug)}`;
 }
 function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
+  return `/companies/${encodePathSegment(companySlug)}`;
 }
 function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
+  return `/companies/markets/${encodePathSegment(marketSlug)}`;
+}
+function suggestionPath(suggestion, options) {
+  const location = options.location?.trim() || void 0;
+  if (options.scope === "blog") {
+    if (suggestion.type === "post") {
+      return blogPostPath(suggestion.slug);
+    }
+    if (suggestion.type === "tag") {
+      return blogTagPath(suggestion.slug);
+    }
+    return null;
+  }
+  if (options.scope === "jobs") {
+    if (suggestion.type === "company" || suggestion.type === "market" || suggestion.type === "post" || suggestion.type === "tag") {
+      return null;
+    }
+    if (suggestion.termType === "skill") {
+      return location ? jobsLocationSkillPath(location, suggestion.canonicalSlug) : jobsSkillPath(suggestion.canonicalSlug);
+    }
+    return location ? jobsLocationCategoryPath(location, suggestion.canonicalSlug) : jobsCategoryPath(suggestion.canonicalSlug);
+  }
+  if (suggestion.type === "company") {
+    return companyPath(suggestion.slug);
+  }
+  if (suggestion.type === "market") {
+    return companyMarketPath(suggestion.slug);
+  }
+  return null;
 }
 function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
+  return `/companies/${encodePathSegment(companySlug)}/salaries`;
 }
 function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
+  return `/salaries/titles/${encodePathSegment(titleSlug)}`;
 }
 function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
+  return `/salaries/skills/${encodePathSegment(skillSlug)}`;
 }
 function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
+  return `/salaries/locations/${encodePathSegment(placeSlug)}`;
 }
 function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
+  return `/blog/${encodePathSegment(postSlug)}`;
 }
 function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
+  return `/blog/tag/${encodePathSegment(tagSlug)}`;
 }
 function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
+  return `/blog/author/${encodePathSegment(authorSlug)}`;
 }
 var BOARD_PATHS = {
   home: "/",

package/dist/paths.mjs

@@ -7,17 +7,21 @@ import {
   companyMarketPath,
   companyPath,
   companySalaryPath,
+  encodePathSegment,
   goAlertsConfirmPath,
   goAlertsManagePath,
   goJobPath,
   jobDetailPath,
   jobsCategoryPath,
+  jobsLocationCategoryPath,
   jobsLocationPath,
+  jobsLocationSkillPath,
   jobsSkillPath,
   salaryLocationPath,
   salarySkillPath,
-  salaryTitlePath
-} from "./chunk-L7ZOYWHW.mjs";
+  salaryTitlePath,
+  suggestionPath
+} from "./chunk-BGKNXG4H.mjs";
 export {
   BOARD_PATHS,
   blogAuthorPath,
@@ -27,14 +31,18 @@ export {
   companyMarketPath,
   companyPath,
   companySalaryPath,
+  encodePathSegment,
   goAlertsConfirmPath,
   goAlertsManagePath,
   goJobPath,
   jobDetailPath,
   jobsCategoryPath,
+  jobsLocationCategoryPath,
   jobsLocationPath,
+  jobsLocationSkillPath,
   jobsSkillPath,
   salaryLocationPath,
   salarySkillPath,
-  salaryTitlePath
+  salaryTitlePath,
+  suggestionPath
 };

package/dist/route-contract.js

@@ -51,44 +51,54 @@ __export(route_contract_exports, {
 module.exports = __toCommonJS(route_contract_exports);
 
 // src/paths/index.ts
+function encodePathSegment(segment) {
+  try {
+    return encodeURIComponent(decodeURIComponent(segment)).replace(
+      /%3A/gi,
+      ":"
+    );
+  } catch {
+    return encodeURIComponent(segment).replace(/%3A/gi, ":");
+  }
+}
 function jobDetailPath(companySlug, jobSlug) {
-  return `/companies/${companySlug}/jobs/${jobSlug}`;
+  return `/companies/${encodePathSegment(companySlug)}/jobs/${encodePathSegment(jobSlug)}`;
 }
 function jobsCategoryPath(categorySlug) {
-  return `/jobs/${categorySlug}`;
+  return `/jobs/${encodePathSegment(categorySlug)}`;
 }
 function jobsSkillPath(skillSlug) {
-  return `/jobs/skills/${skillSlug}`;
+  return `/jobs/skills/${encodePathSegment(skillSlug)}`;
 }
 function jobsLocationPath(placeSlug) {
-  return `/jobs/locations/${placeSlug}`;
+  return `/jobs/locations/${encodePathSegment(placeSlug)}`;
 }
 function companyPath(companySlug) {
-  return `/companies/${companySlug}`;
+  return `/companies/${encodePathSegment(companySlug)}`;
 }
 function companyMarketPath(marketSlug) {
-  return `/companies/markets/${marketSlug}`;
+  return `/companies/markets/${encodePathSegment(marketSlug)}`;
 }
 function companySalaryPath(companySlug) {
-  return `/companies/${companySlug}/salaries`;
+  return `/companies/${encodePathSegment(companySlug)}/salaries`;
 }
 function salaryTitlePath(titleSlug) {
-  return `/salaries/titles/${titleSlug}`;
+  return `/salaries/titles/${encodePathSegment(titleSlug)}`;
 }
 function salarySkillPath(skillSlug) {
-  return `/salaries/skills/${skillSlug}`;
+  return `/salaries/skills/${encodePathSegment(skillSlug)}`;
 }
 function salaryLocationPath(placeSlug) {
-  return `/salaries/locations/${placeSlug}`;
+  return `/salaries/locations/${encodePathSegment(placeSlug)}`;
 }
 function blogPostPath(postSlug) {
-  return `/blog/${postSlug}`;
+  return `/blog/${encodePathSegment(postSlug)}`;
 }
 function blogTagPath(tagSlug) {
-  return `/blog/tag/${tagSlug}`;
+  return `/blog/tag/${encodePathSegment(tagSlug)}`;
 }
 function blogAuthorPath(authorSlug) {
-  return `/blog/author/${authorSlug}`;
+  return `/blog/author/${encodePathSegment(authorSlug)}`;
 }
 var BOARD_PATHS = {
   home: "/",

package/dist/route-contract.mjs

@@ -26,8 +26,8 @@ import {
   parseTanStackRoutes,
   sameParamSet,
   validateManifest
-} from "./chunk-NXY3OWGF.mjs";
-import "./chunk-L7ZOYWHW.mjs";
+} from "./chunk-T2KC6XGV.mjs";
+import "./chunk-BGKNXG4H.mjs";
 export {
   ALL_ROLES,
   CANONICAL_MANIFEST,

package/dist/{search-CyRvVMUp.d.ts → search-Cr4noJJZ.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.js';
+import { S as Schemas } from './_spec-GVe6WAfT.mjs';
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -69,13 +69,24 @@ declare class BoardClient {
 type SuggestResult = Schemas['SuggestResult'];
 type SuggestionItem = Schemas['SuggestionItem'];
 type CompanySuggestion = Schemas['CompanySuggestion'];
+type MarketSuggestion = Schemas['MarketSuggestion'];
 type TermSuggestion = Schemas['TermSuggestion'];
+/** Kinds accepted by `SearchSuggestQuery.types`. */
+type SearchSuggestType = 'company' | 'category' | 'skill' | 'market' | 'post' | 'tag';
 /** Query for `board.search.suggest()`. */
 type SearchSuggestQuery = {
     /** Keyword; under 2 chars the server returns an empty `items` array. */
     q?: string;
-    /** Max interleaved suggestions (1–25; default 25). */
+    /**
+     * Max interleaved suggestions after type filtering (1–25; default 25).
+     * With `types: ['skill']`, this is "up to N skills", not N of a mixed pool.
+     */
     limit?: number;
+    /**
+     * Include only these suggestion kinds. Omit for every kind (company,
+     * category, skill, market, post, tag). Repeated query keys on the wire.
+     */
+    types?: SearchSuggestType[];
 };
 
-export { type Awaitable as A, type BoardRequest as B, type CompanySuggestion as C, type FetchOptions as F, type Logger as L, REFRESH_TOKEN_KEY as R, type StorageMode as S, type TermSuggestion as T, BoardClient as a, type SearchSuggestQuery as b, ACCESS_TOKEN_KEY as c, BOARD_ACCESS_GRANT_KEY as d, type CustomStorage as e, type SuggestResult as f, type SuggestionItem as g };
+export { type Awaitable as A, type BoardRequest as B, type CompanySuggestion as C, type FetchOptions as F, type Logger as L, type MarketSuggestion as M, REFRESH_TOKEN_KEY as R, type StorageMode as S, type TermSuggestion as T, BoardClient as a, type SearchSuggestQuery as b, ACCESS_TOKEN_KEY as c, BOARD_ACCESS_GRANT_KEY as d, type CustomStorage as e, type SearchSuggestType as f, type SuggestResult as g, type SuggestionItem as h };

package/dist/{search-CCyFWPi3.d.mts → search-DdsniXQv.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.mjs';
+import { S as Schemas } from './_spec-GVe6WAfT.js';
 
 type Awaitable<T> = T | Promise<T>;
 /**
@@ -69,13 +69,24 @@ declare class BoardClient {
 type SuggestResult = Schemas['SuggestResult'];
 type SuggestionItem = Schemas['SuggestionItem'];
 type CompanySuggestion = Schemas['CompanySuggestion'];
+type MarketSuggestion = Schemas['MarketSuggestion'];
 type TermSuggestion = Schemas['TermSuggestion'];
+/** Kinds accepted by `SearchSuggestQuery.types`. */
+type SearchSuggestType = 'company' | 'category' | 'skill' | 'market' | 'post' | 'tag';
 /** Query for `board.search.suggest()`. */
 type SearchSuggestQuery = {
     /** Keyword; under 2 chars the server returns an empty `items` array. */
     q?: string;
-    /** Max interleaved suggestions (1–25; default 25). */
+    /**
+     * Max interleaved suggestions after type filtering (1–25; default 25).
+     * With `types: ['skill']`, this is "up to N skills", not N of a mixed pool.
+     */
     limit?: number;
+    /**
+     * Include only these suggestion kinds. Omit for every kind (company,
+     * category, skill, market, post, tag). Repeated query keys on the wire.
+     */
+    types?: SearchSuggestType[];
 };
 
-export { type Awaitable as A, type BoardRequest as B, type CompanySuggestion as C, type FetchOptions as F, type Logger as L, REFRESH_TOKEN_KEY as R, type StorageMode as S, type TermSuggestion as T, BoardClient as a, type SearchSuggestQuery as b, ACCESS_TOKEN_KEY as c, BOARD_ACCESS_GRANT_KEY as d, type CustomStorage as e, type SuggestResult as f, type SuggestionItem as g };
+export { type Awaitable as A, type BoardRequest as B, type CompanySuggestion as C, type FetchOptions as F, type Logger as L, type MarketSuggestion as M, REFRESH_TOKEN_KEY as R, type StorageMode as S, type TermSuggestion as T, BoardClient as a, type SearchSuggestQuery as b, ACCESS_TOKEN_KEY as c, BOARD_ACCESS_GRANT_KEY as d, type CustomStorage as e, type SearchSuggestType as f, type SuggestResult as g, type SuggestionItem as h };

package/dist/seo.d.mts

@@ -1,10 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-DGBHmExV.mjs';
-import { J as JsonLdObject } from './breadcrumbs-1hMjcsqA.mjs';
-export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, F as FaqItem, c as JsonLdBoard, S as SENIORITY_ORDER, b as buildJobBreadcrumbs, d as buildSalaryFaq, e as companyCategorySalaryJsonLd, g as companySalaryJsonLd, h as createBreadcrumbJsonLd, i as createJobPostingJsonLd, j as crossAxisSalaryJsonLd, k as faqJsonLd, f as formatRange, l as formatSeniority, a as formatUsd, m as itemListJsonLd, o as locationSalaryJsonLd, n as normalizeWebsiteUrl, s as skillSalaryJsonLd, p as sortBySeniority, t as titleSalaryJsonLd } from './breadcrumbs-1hMjcsqA.mjs';
-import './_spec-nkWAraS0.mjs';
-import './board-BJbXd_9_.mjs';
-import './jobs-lVvKCBCU.mjs';
-import './ui-copy-CCkz6CVF.mjs';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-Cf64mI8A.mjs';
+import { e as JsonLdObject } from './breadcrumbs-DFKr0HzU.mjs';
+export { A as ALL_COUNTRY_CODES, B as BreadcrumbItemInput, g as FaqItem, J as JobBreadcrumb, h as JsonLdBoard, N as NumberNotation, i as SENIORITY_ORDER, j as SalaryFaqEntry, k as SalaryJsonLdOptions, l as SalaryOccupationListOptions, b as buildJobBreadcrumbs, m as buildSalaryFaq, o as companyCategorySalaryJsonLd, p as companySalaryJsonLd, q as createBreadcrumbJsonLd, r as createJobPostingJsonLd, s as crossAxisSalaryJsonLd, t as faqJsonLd, c as formatSalaryStat, d as formatSalaryStatRange, u as itemListJsonLd, v as locationSalaryJsonLd, n as normalizeWebsiteUrl, w as skillSalaryJsonLd, x as sortBySeniority, y as titleSalaryJsonLd } from './breadcrumbs-DFKr0HzU.mjs';
+import './_spec-GVe6WAfT.mjs';
+import './board-GGWJ4coe.mjs';
+import './jobs-BuLpV8iy.mjs';
 
 /**
  * Blog structured data on the `@cavuno/board` wire types, transcribed from
@@ -59,36 +58,32 @@ declare function createAuthorProfileJsonLd({ author, canonical, description, ori
     totalPosts: number;
 }): JsonLdObject | null;
 
-/**
- * Framework-neutral `<head>` + structural JSON-LD builders for jobs-listing
- * pages. Locale-neutral pass-through: the caller supplies the
- * heading/board copy (title/description COPY is board-SEO-config +
- * localized — a named exclusion; these builders replicate the hosted
- * STRUCTURE: title with result count, canonical, Open Graph, breadcrumb +
- * job `ItemList`).
- */
-
 interface ListingHeadOptions {
-    boardName: string;
+    /**
+     * Fully composed document title — application owns counters, particles,
+     * word order, and separators (e.g. `1,225 Jobs | Acme`, `1.225 Jobs | Acme`,
+     * `1,225件の求人 | 求人ボード`). The SDK does not join count/heading/board.
+     */
+    title: string;
     origin: string;
     /** Absolute path of THIS page, for canonical / og:url, e.g. `/jobs/robotik`. */
     path: string;
-    /** Human heading, e.g. `Robotik jobs in Berlin` or `Jobs`. */
-    heading: string;
-    /** Result count — prefixed into the title (`N heading`). */
-    count?: number;
     /**
-     * Board language (BCP-47). When supplied, `count` is grouped for that
-     * locale in the title and description — `1,225 Jobs` / `1.225 Jobs` —
-     * matching how listing bodies render the same number. Omit to keep the
-     * ungrouped digits the hosted structure has always emitted.
+     * Meta description — fully owned by the application. Pass a sentence from
+     * the board's copy source (page config, message catalog, template). The SDK
+     * does not invent or case-fold this string.
      */
-    language?: string;
+    description: string;
 }
 /**
- * Meta/link descriptors for a jobs-listing page — title (with result
- * count), meta description, Open Graph, and `<link rel=canonical>`.
- * Framework-neutral: map `meta`/`links` into your head manager.
+ * Meta/link descriptors for a jobs-listing page — caller-supplied title and
+ * meta description, Open Graph, and `<link rel=canonical>`. Framework-neutral:
+ * map `meta`/`links` into your head manager.
+ *
+ * **Why `title` and `description` are both accepted composed:** a function
+ * that takes a finished description but still composes its own title from
+ * count/heading/boardName is incoherent — both are display sentences whose
+ * arrangement is locale-dependent (Japanese counters, RTL order, …).
  */
 declare function listingHead(options: ListingHeadOptions): {
     meta: ({
@@ -123,6 +118,12 @@ interface JobLink {
  * page, mirroring the structural JSON-LD the hosted board emits. The rich
  * category set (`Occupation`/`FAQPage`/`MonetaryAmountDistribution`) lives
  * in `./salary` — feed it the salary detail reads.
+ *
+ * Empty / single-crumb trails omit `BreadcrumbList` (same min-2 rule as
+ * `createBreadcrumbJsonLd` — an empty `itemListElement` is invalid structured
+ * data). Job URLs go through `jobDetailPath` — `/jobs/{slug}` is always a
+ * listing route, never a job detail; company-less jobs are dropped from the
+ * ItemList rather than linked to an invalid path.
  */
 declare function listingJsonLd(options: {
     origin: string;