@cavuno/board 3.2.0 → 4.1.0

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-CCyFWPi3.d.mts → search-7B-mVRNA.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.mjs';
+import { S as Schemas } from './_spec-BZDv2dc5.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/{search-CyRvVMUp.d.ts → search-OKrdAHv8.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-nkWAraS0.js';
+import { S as Schemas } from './_spec-BZDv2dc5.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/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-DyDvyQrI.mjs';
+import { e as JsonLdObject } from './breadcrumbs-icxRVydh.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-icxRVydh.mjs';
+import './_spec-BZDv2dc5.mjs';
+import './board-BF3Qao6J.mjs';
+import './jobs-BX6d_sdd.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;

package/dist/seo.d.ts

@@ -1,10 +1,9 @@
-import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-iV9XEIGf.js';
-import { J as JsonLdObject } from './breadcrumbs-DexU07TT.js';
-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-DexU07TT.js';
-import './_spec-nkWAraS0.js';
-import './board-JhdUWIoq.js';
-import './jobs-BiEvL9d7.js';
-import './ui-copy-CCkz6CVF.js';
+import { P as PublicBlogPostSummary, B as BlogAuthorEmbed } from './blog-BHx6iH3Z.js';
+import { e as JsonLdObject } from './breadcrumbs-SGaWth6C.js';
+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-SGaWth6C.js';
+import './_spec-BZDv2dc5.js';
+import './board-BTEZ0uiI.js';
+import './jobs-BbLJfz1z.js';
 
 /**
  * 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;