@cavuno/board 1.41.0 → 1.43.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { S as Schemas, c as components } from './_spec-l_596ZwW.js';
-import { F as FetchOptions, c as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, d as BoardClient, a as SearchSuggestQuery } from './search-DZrq-k76.js';
-export { e as ACCESS_TOKEN_KEY, f as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, g as CustomStorage, R as REFRESH_TOKEN_KEY, b as SuggestResult, S as SuggestionItem, T as TermSuggestion } from './search-DZrq-k76.js';
-export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-BzK5j73O.js';
-import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, b as JobsListQuery, c as JobCardListEnvelope, d as JobsSearchBody, e as JobCardSearchEnvelope, f as JobsSimilarQuery, g as SearchEnvelope } from './jobs-CXudz1Y4.js';
-export { h as CustomFieldValue, C as CustomFieldValues, i as EducationRequirement, j as JobCatalogPagination, k as JobCompany, J as JobSort, O as OfficeLocation, l as OffsetPagination, P as PublicJob, a as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-CXudz1Y4.js';
-import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-ByBuHCLH.js';
-export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-ByBuHCLH.js';
+import { S as Schemas, c as components } from './_spec-DQ2GR9lq.js';
+import { F as FetchOptions, c as StorageMode, B as BoardRequest, A as Awaitable, L as Logger, d as BoardClient, a as SearchSuggestQuery } from './search-B1GtdfAm.js';
+export { e as ACCESS_TOKEN_KEY, f as BOARD_ACCESS_GRANT_KEY, C as CompanySuggestion, g as CustomStorage, R as REFRESH_TOKEN_KEY, b as SuggestResult, S as SuggestionItem, T as TermSuggestion } from './search-B1GtdfAm.js';
+export { C as CustomFieldDefinition, a as CustomFieldOption, b as CustomFieldType, P as PublicBoard, c as PublicBoardAnalytics, d as PublicBoardFeatures, e as PublicBoardTheme } from './board-DpBlk05S.js';
+import { R as RemoteOption, E as EmploymentType, S as Seniority, L as ListEnvelope, b as JobsListQuery, c as JobCardListEnvelope, d as JobsSearchBody, e as JobCardSearchEnvelope, f as JobsSimilarQuery, g as SearchEnvelope } from './jobs-BlnV6hmC.js';
+export { h as CustomFieldValue, C as CustomFieldValues, i as EducationRequirement, j as JobCatalogPagination, k as JobCompany, J as JobSort, O as OfficeLocation, l as OffsetPagination, P as PublicJob, a as PublicJobCard, m as RelatedSearch, n as RemotePermit, o as RemoteTimezone, p as StorefrontPagination } from './jobs-BlnV6hmC.js';
+import { b as CompaniesListQuery, c as CompanyListEnvelope, d as CompaniesSearchBody, e as CompanyJobsListQuery, f as CompanySimilarQuery, g as CompanyMarketsListQuery, h as SalaryDetailQuery, i as BlogPostsListQuery, j as BlogSimilarQuery, k as BlogSearchBody } from './salaries-DzM7rbXp.js';
+export { B as BlogAuthorEmbed, l as BlogTagEmbed, C as CompanyCategorySalary, m as CompanyMarket, n as CompanyMarketRef, a as CompanySalary, L as LocationSalaryDetail, o as LocationSkillsIndex, p as LocationTitlesIndex, q as PublicBlogAdjacentPosts, r as PublicBlogAuthor, s as PublicBlogPost, P as PublicBlogPostSummary, t as PublicBlogTag, u as PublicCompany, v as PublicCompanyDetail, w as SalaryCompany, x as SalaryLocation, y as SalarySkill, z as SalaryTitle, A as SkillLocationSalary, D as SkillLocationsIndex, S as SkillSalaryDetail, E as TitleLocationSalary, F as TitleLocationsIndex, T as TitleSalaryDetail } from './salaries-DzM7rbXp.js';
 
 /**
  * Well-known `<domain>_<snake_reason>` codes the Board API sends, grouped by
@@ -141,7 +141,7 @@ declare function paginate<Q extends Record<string, unknown>, P extends PageShape
  * constant because the package is platform-neutral and cannot read
  * package.json at runtime.
  */
-declare const SDK_VERSION = "1.41.0";
+declare const SDK_VERSION = "1.43.0";
 
 type SavedJob = Schemas['SavedJob'];
 type SavedJobsListQuery = {

package/dist/index.js

@@ -312,7 +312,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.41.0";
+var SDK_VERSION = "1.43.0";
 
 // src/client.ts
 function isRawBody(body) {

package/dist/index.mjs

@@ -265,7 +265,7 @@ async function clearSession(storage) {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.41.0";
+var SDK_VERSION = "1.43.0";
 
 // src/client.ts
 function isRawBody(body) {

package/dist/{jobs-CXudz1Y4.d.ts → jobs-BlnV6hmC.d.ts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-l_596ZwW.js';
+import { S as Schemas } from './_spec-DQ2GR9lq.js';
 
 /**
  * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The

package/dist/{jobs-BhthvMkA.d.mts → jobs-DqujLqGk.d.mts}

@@ -1,4 +1,4 @@
-import { S as Schemas } from './_spec-l_596ZwW.mjs';
+import { S as Schemas } from './_spec-DQ2GR9lq.mjs';
 
 /**
  * Stripe-shaped success envelopes (`01-conventions.md` §5.1). The

package/dist/paths.d.mts

@@ -62,11 +62,35 @@ declare const BOARD_PATHS: {
     readonly impressum: "/impressum";
     readonly talent: "/talent";
     readonly employers: "/employers";
+    /**
+     * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+     * the job-alerts composer so /go indirection and email composition share
+     * one definition.
+     */
+    readonly alertsManage: "/alerts/manage";
+    readonly alertsConfirm: "/alerts/confirm";
 };
+/**
+ * Email `/go` indirection paths (ADR-0090 D4 / LNK-05). Pure builders so
+ * Convex email composers can emit structure-independent links without
+ * importing `@cavuno/board/go` (handler code is not safe in that runtime).
+ *
+ * Shapes match the hosted handler + SDK `createGoHandler` contracts:
+ *   /go/job/<immutableId>
+ *   /go/alerts-manage
+ *   /go/alerts-confirm
+ *
+ * No encoding — callers pass opaque Convex ids / static role segments that
+ * are already URL-safe path segments. Query strings are composed by the
+ * caller (tokens must ride through verbatim).
+ */
+declare function goJobPath(jobId: string): string;
+declare function goAlertsManagePath(): string;
+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.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };

package/dist/paths.d.ts

@@ -62,11 +62,35 @@ declare const BOARD_PATHS: {
     readonly impressum: "/impressum";
     readonly talent: "/talent";
     readonly employers: "/employers";
+    /**
+     * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+     * the job-alerts composer so /go indirection and email composition share
+     * one definition.
+     */
+    readonly alertsManage: "/alerts/manage";
+    readonly alertsConfirm: "/alerts/confirm";
 };
+/**
+ * Email `/go` indirection paths (ADR-0090 D4 / LNK-05). Pure builders so
+ * Convex email composers can emit structure-independent links without
+ * importing `@cavuno/board/go` (handler code is not safe in that runtime).
+ *
+ * Shapes match the hosted handler + SDK `createGoHandler` contracts:
+ *   /go/job/<immutableId>
+ *   /go/alerts-manage
+ *   /go/alerts-confirm
+ *
+ * No encoding — callers pass opaque Convex ids / static role segments that
+ * are already URL-safe path segments. Query strings are composed by the
+ * caller (tokens must ride through verbatim).
+ */
+declare function goJobPath(jobId: string): string;
+declare function goAlertsManagePath(): string;
+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.
  */
 declare function boardUrl(origin: string, path: string): string;
 
-export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };
+export { BOARD_PATHS, blogAuthorPath, blogPostPath, blogTagPath, boardUrl, companyMarketPath, companyPath, companySalaryPath, goAlertsConfirmPath, goAlertsManagePath, goJobPath, jobDetailPath, jobsCategoryPath, jobsLocationPath, jobsSkillPath, salaryLocationPath, salarySkillPath, salaryTitlePath };

package/dist/paths.js

@@ -28,6 +28,9 @@ __export(paths_exports, {
   companyMarketPath: () => companyMarketPath,
   companyPath: () => companyPath,
   companySalaryPath: () => companySalaryPath,
+  goAlertsConfirmPath: () => goAlertsConfirmPath,
+  goAlertsManagePath: () => goAlertsManagePath,
+  goJobPath: () => goJobPath,
   jobDetailPath: () => jobDetailPath,
   jobsCategoryPath: () => jobsCategoryPath,
   jobsLocationPath: () => jobsLocationPath,
@@ -92,8 +95,24 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
-  employers: "/employers"
+  employers: "/employers",
+  /**
+   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * the job-alerts composer so /go indirection and email composition share
+   * one definition.
+   */
+  alertsManage: "/alerts/manage",
+  alertsConfirm: "/alerts/confirm"
 };
+function goJobPath(jobId) {
+  return `/go/job/${jobId}`;
+}
+function goAlertsManagePath() {
+  return "/go/alerts-manage";
+}
+function goAlertsConfirmPath() {
+  return "/go/alerts-confirm";
+}
 function boardUrl(origin, path) {
   return `${origin.replace(/\/+$/, "")}${path}`;
 }

package/dist/paths.mjs

@@ -54,8 +54,24 @@ var BOARD_PATHS = {
   cookiePolicy: "/cookie-policy",
   impressum: "/impressum",
   talent: "/talent",
-  employers: "/employers"
+  employers: "/employers",
+  /**
+   * Alert-email surfaces (ADR-0090 D1/D4). Promoted out of raw literals in
+   * the job-alerts composer so /go indirection and email composition share
+   * one definition.
+   */
+  alertsManage: "/alerts/manage",
+  alertsConfirm: "/alerts/confirm"
 };
+function goJobPath(jobId) {
+  return `/go/job/${jobId}`;
+}
+function goAlertsManagePath() {
+  return "/go/alerts-manage";
+}
+function goAlertsConfirmPath() {
+  return "/go/alerts-confirm";
+}
 function boardUrl(origin, path) {
   return `${origin.replace(/\/+$/, "")}${path}`;
 }
@@ -68,6 +84,9 @@ export {
   companyMarketPath,
   companyPath,
   companySalaryPath,
+  goAlertsConfirmPath,
+  goAlertsManagePath,
+  goJobPath,
   jobDetailPath,
   jobsCategoryPath,
   jobsLocationPath,

package/dist/roles-vY0AXhoc.d.mts

@@ -0,0 +1,82 @@
+/**
+ * One discovered route. `template` uses URLPattern `:param` syntax
+ * (e.g. `/companies/:companySlug/jobs/:jobSlug`). Callers on other
+ * runtimes instantiate matchers; this module only emits strings.
+ */
+type RouteEntry = {
+    template: string;
+    /** Absolute or project-relative source path — keys the marker map. */
+    sourcePath?: string;
+};
+/** Versioned role → template map. Additive schema evolution only. */
+type ManifestV1 = {
+    version: 1;
+    roles: Partial<Record<RouteRole, string>>;
+};
+type Ambiguity = {
+    role: RouteRole;
+    candidates: RouteEntry[];
+};
+type ClassifyResult = {
+    assignments: Partial<Record<RouteRole, RouteEntry>>;
+    ambiguities: Ambiguity[];
+    missingRequired: RouteRole[];
+};
+type CompileResult = {
+    manifest: ManifestV1;
+    blockingMissing: RouteRole[];
+    warnings: string[];
+    ambiguities: Ambiguity[];
+};
+type ValidateManifestError = {
+    code: 'invalid_shape' | 'invalid_version' | 'unknown_role' | 'unregistered_param' | 'missing_entity_param' | 'static_has_params' | 'invalid_template'
+    /** Protocol-relative or double-slash path (open redirect / SSRF shape). */
+     | 'template_double_slash'
+    /** '.' or '..' path segments. */
+     | 'template_dot_segment'
+    /** Query string or fragment in a path template. */
+     | 'template_query_or_fragment'
+    /** Characters outside the allowed path/token charset. */
+     | 'template_illegal_charset';
+    message: string;
+    role?: string;
+    token?: string;
+};
+type ValidateManifestResult = {
+    ok: true;
+    manifest: ManifestV1;
+} | {
+    ok: false;
+    errors: ValidateManifestError[];
+};
+
+/**
+ * Role vocabulary for the per-board route manifest (ADR-0090 D1).
+ *
+ * Parameterized roles mirror the helpers in `../paths`; static roles mirror
+ * `BOARD_PATHS` keys; `alertsManage` / `alertsConfirm` are promoted out of
+ * raw literals in the job-alerts composer.
+ *
+ * Pure + isomorphic — imports only the sibling paths module.
+ */
+
+/** Every role the compiler can assign. */
+type RouteRole = 'jobDetail' | 'jobsCategory' | 'jobsSkill' | 'jobsLocation' | 'company' | 'companyMarket' | 'companySalary' | 'salaryTitle' | 'salarySkill' | 'salaryLocation' | 'blogPost' | 'blogTag' | 'blogAuthor' | 'home' | 'jobs' | 'companies' | 'salaries' | 'salaryCompanies' | 'salaryTitles' | 'salarySkills' | 'salaryLocations' | 'blog' | 'about' | 'privacyPolicy' | 'termsOfService' | 'cookiePolicy' | 'impressum' | 'talent' | 'employers' | 'alertsManage' | 'alertsConfirm';
+/**
+ * Exact param-name set per role, derived from each helper's signature.
+ * Empty arrays = static / zero-param roles (never inferred by signature).
+ */
+declare const ROLE_PARAM_REGISTRY: Record<RouteRole, readonly string[]>;
+/** Email-emitting roles — a missing one blocks publish (ADR-0090 D1/D6). */
+declare const REQUIRED_ROLES: readonly RouteRole[];
+/** All known roles (stable iteration order = registry key order). */
+declare const ALL_ROLES: readonly RouteRole[];
+declare function isRouteRole(value: string): value is RouteRole;
+/**
+ * Identity manifest reproducing the current canonical structure from the
+ * paths module. Built by calling helpers with `:param` placeholders so the
+ * templates stay locked to the helpers (ADR-0070 / ADR-0090).
+ */
+declare const CANONICAL_MANIFEST: ManifestV1;
+
+export { ALL_ROLES as A, type ClassifyResult as C, type ManifestV1 as M, type RouteEntry as R, type ValidateManifestError as V, type RouteRole as a, type CompileResult as b, type ValidateManifestResult as c, type Ambiguity as d, CANONICAL_MANIFEST as e, REQUIRED_ROLES as f, ROLE_PARAM_REGISTRY as g, isRouteRole as i };

package/dist/roles-vY0AXhoc.d.ts

@@ -0,0 +1,82 @@
+/**
+ * One discovered route. `template` uses URLPattern `:param` syntax
+ * (e.g. `/companies/:companySlug/jobs/:jobSlug`). Callers on other
+ * runtimes instantiate matchers; this module only emits strings.
+ */
+type RouteEntry = {
+    template: string;
+    /** Absolute or project-relative source path — keys the marker map. */
+    sourcePath?: string;
+};
+/** Versioned role → template map. Additive schema evolution only. */
+type ManifestV1 = {
+    version: 1;
+    roles: Partial<Record<RouteRole, string>>;
+};
+type Ambiguity = {
+    role: RouteRole;
+    candidates: RouteEntry[];
+};
+type ClassifyResult = {
+    assignments: Partial<Record<RouteRole, RouteEntry>>;
+    ambiguities: Ambiguity[];
+    missingRequired: RouteRole[];
+};
+type CompileResult = {
+    manifest: ManifestV1;
+    blockingMissing: RouteRole[];
+    warnings: string[];
+    ambiguities: Ambiguity[];
+};
+type ValidateManifestError = {
+    code: 'invalid_shape' | 'invalid_version' | 'unknown_role' | 'unregistered_param' | 'missing_entity_param' | 'static_has_params' | 'invalid_template'
+    /** Protocol-relative or double-slash path (open redirect / SSRF shape). */
+     | 'template_double_slash'
+    /** '.' or '..' path segments. */
+     | 'template_dot_segment'
+    /** Query string or fragment in a path template. */
+     | 'template_query_or_fragment'
+    /** Characters outside the allowed path/token charset. */
+     | 'template_illegal_charset';
+    message: string;
+    role?: string;
+    token?: string;
+};
+type ValidateManifestResult = {
+    ok: true;
+    manifest: ManifestV1;
+} | {
+    ok: false;
+    errors: ValidateManifestError[];
+};
+
+/**
+ * Role vocabulary for the per-board route manifest (ADR-0090 D1).
+ *
+ * Parameterized roles mirror the helpers in `../paths`; static roles mirror
+ * `BOARD_PATHS` keys; `alertsManage` / `alertsConfirm` are promoted out of
+ * raw literals in the job-alerts composer.
+ *
+ * Pure + isomorphic — imports only the sibling paths module.
+ */
+
+/** Every role the compiler can assign. */
+type RouteRole = 'jobDetail' | 'jobsCategory' | 'jobsSkill' | 'jobsLocation' | 'company' | 'companyMarket' | 'companySalary' | 'salaryTitle' | 'salarySkill' | 'salaryLocation' | 'blogPost' | 'blogTag' | 'blogAuthor' | 'home' | 'jobs' | 'companies' | 'salaries' | 'salaryCompanies' | 'salaryTitles' | 'salarySkills' | 'salaryLocations' | 'blog' | 'about' | 'privacyPolicy' | 'termsOfService' | 'cookiePolicy' | 'impressum' | 'talent' | 'employers' | 'alertsManage' | 'alertsConfirm';
+/**
+ * Exact param-name set per role, derived from each helper's signature.
+ * Empty arrays = static / zero-param roles (never inferred by signature).
+ */
+declare const ROLE_PARAM_REGISTRY: Record<RouteRole, readonly string[]>;
+/** Email-emitting roles — a missing one blocks publish (ADR-0090 D1/D6). */
+declare const REQUIRED_ROLES: readonly RouteRole[];
+/** All known roles (stable iteration order = registry key order). */
+declare const ALL_ROLES: readonly RouteRole[];
+declare function isRouteRole(value: string): value is RouteRole;
+/**
+ * Identity manifest reproducing the current canonical structure from the
+ * paths module. Built by calling helpers with `:param` placeholders so the
+ * templates stay locked to the helpers (ADR-0070 / ADR-0090).
+ */
+declare const CANONICAL_MANIFEST: ManifestV1;
+
+export { ALL_ROLES as A, type ClassifyResult as C, type ManifestV1 as M, type RouteEntry as R, type ValidateManifestError as V, type RouteRole as a, type CompileResult as b, type ValidateManifestResult as c, type Ambiguity as d, CANONICAL_MANIFEST as e, REQUIRED_ROLES as f, ROLE_PARAM_REGISTRY as g, isRouteRole as i };

package/dist/route-contract.d.mts

@@ -0,0 +1,257 @@
+import { R as RouteEntry, a as RouteRole, C as ClassifyResult, b as CompileResult, V as ValidateManifestError, c as ValidateManifestResult, M as ManifestV1 } from './roles-vY0AXhoc.mjs';
+export { A as ALL_ROLES, d as Ambiguity, e as CANONICAL_MANIFEST, f as REQUIRED_ROLES, g as ROLE_PARAM_REGISTRY, i as isRouteRole } from './roles-vY0AXhoc.mjs';
+
+/**
+ * Classify routes into role assignments. Markers (keyed by `sourcePath`)
+ * always win and remove the route from inference. Two markers claiming the
+ * same role is an ambiguity (never silent first-wins). Ambiguities never
+ * guess.
+ */
+declare function classifyRoutes(routes: RouteEntry[], markers?: ReadonlyMap<string, RouteRole>): ClassifyResult;
+
+/**
+ * Classify routes and emit a ManifestV1 plus publish-gate signals.
+ * Assigned templates are self-validated via checkRoleTemplate (F1);
+ * failing required roles land in blockingMissing; failing optionals warn.
+ */
+declare function compileManifest(routes: RouteEntry[], markers?: ReadonlyMap<string, RouteRole>): CompileResult;
+
+/**
+ * LNK-06 — compile a ManifestV1 from a workspace file tree already in
+ * memory (candidate verification). Pure: no IO.
+ */
+
+type TreeFile = {
+    path: string;
+    contents: string;
+};
+/**
+ * Enumerate routes from file paths, harvest cavunoPage markers from every
+ * file body, run compileManifest. Marker harvest is intentionally broad
+ * (all files, not just ambiguous) — cheap string scan, correct for renames.
+ */
+declare function compileManifestFromTree(files: ReadonlyArray<TreeFile>): CompileResult;
+
+/**
+ * Tolerant parse of `export const cavunoPage = '<role>'` (single or double
+ * quotes; optional `as const`). Accepts camelCase roles and their kebab-case
+ * aliases (`job-detail` → `jobDetail`). Returns null when absent or when the
+ * string is not a known RouteRole (ADR-0090 D6 escape hatch).
+ */
+declare function extractCavunoPageMarker(contents: string): RouteRole | null;
+
+/**
+ * Extract `:param` token names from a URLPattern-style template string.
+ * Order-insensitive consumers should sort / set-compare the result.
+ */
+declare function extractParamNames(template: string): string[];
+/** Order-insensitive equality of two param-name lists. */
+declare function sameParamSet(a: readonly string[], b: readonly string[]): boolean;
+
+/**
+ * Per-role template checks shared by validateManifest and compileManifest.
+ * Never throws — returns zero or more typed errors.
+ *
+ * Rules (v1):
+ * - non-empty string
+ * - must start with '/' but NOT '//'; no '//' anywhere
+ * - no '.' or '..' path segments
+ * - no '?', '#', or whitespace
+ * - charset limited to [A-Za-z0-9\-_/:.]
+ * - params referenced by a template must be in ROLE_PARAM_REGISTRY[role]
+ * - static / empty-registry roles must have zero `:` tokens
+ * - parameterized roles must retain at least one registry param
+ */
+declare function checkRoleTemplate(role: RouteRole, template: string): ValidateManifestError[];
+/**
+ * Structural + registry validation of an unknown value as ManifestV1.
+ * Never throws — returns typed errors.
+ */
+declare function validateManifest(value: unknown): ValidateManifestResult;
+
+/**
+ * Platform resolution overlay (ADR-0090 D3 / LNK-07).
+ *
+ * Pure + isomorphic: role + params + precedence layers → board path.
+ * Imports only sibling route-contract / paths modules.
+ */
+
+/** One precedence layer supplied by the caller (declared / wellKnown / inferred). */
+type ManifestLayer = {
+    source: 'declared' | 'wellKnown' | 'inferred';
+    manifest: ManifestV1;
+};
+type ResolvedBoardPath = {
+    path: string;
+    source: 'declared' | 'wellKnown' | 'inferred' | 'canonical';
+    /** Set when the winning path came from falling through a broken template. */
+    fallback?: 'missing-param';
+};
+declare function createBoardLinkResolver(layers: readonly ManifestLayer[]): {
+    pathFor(role: RouteRole, params?: Record<string, string>): ResolvedBoardPath;
+};
+
+/**
+ * LNK-10 — pure history path matching for hosted rename 301s (ADR-0090 D7).
+ *
+ * Segment-wise matcher (no RegExp construction from templates). Templates
+ * are validated at write time but stay defensive here: any segment that
+ * does not start with ':' is a literal.
+ */
+
+/**
+ * Degrade target per role when captured params no longer resolve against
+ * the current template (302-class temporary redirect, never 404-from-history).
+ */
+declare const ROLE_INDEX_PATHS: Record<RouteRole, string>;
+/**
+ * Segment-wise match of `pathname` against a URLPattern-style `:param` template.
+ * Returns captured params or null.
+ *
+ * Contract: path segments arrive ALREADY decoded (Next.js `params.rest`,
+ * URL routers). This function does NOT call decodeURIComponent — a second
+ * decode would turn a once-decoded `%2F` into a literal `/` and enable
+ * open-redirect targets when substituted into param-leading templates.
+ *
+ * Defense in depth: any capture containing `/` or `\` is rejected (null).
+ */
+declare function matchPathToTemplate(template: string, pathname: string): Record<string, string> | null;
+type HistoryMatchEntry = {
+    role: RouteRole;
+    template: string;
+};
+type HistoryMatchResult = {
+    role: RouteRole;
+    template: string;
+    params: Record<string, string>;
+};
+/**
+ * First match wins — caller orders entries newest-first.
+ */
+declare function matchPathAgainstHistory(entries: readonly HistoryMatchEntry[], pathname: string): HistoryMatchResult | null;
+
+/**
+ * LNK-02 — shared types for the route-derivation adapter registry.
+ */
+type DerivedRoute = {
+    path: string;
+    navigable: boolean;
+    /**
+     * Originating file when the parser tracked it (worker compile path).
+     * Omitted from the navigator public contract via deriveRoutes strip.
+     */
+    sourcePath?: string;
+};
+type FrameworkId = 'tanstack' | 'next' | 'astro' | 'sveltekit' | 'nuxt' | 'react-router';
+
+/**
+ * Marker-file framework detection. Specificity order (first match wins):
+ * Explicit TanStack markers → Next → Astro → SvelteKit → Nuxt →
+ * marker-less TanStack fallback → react-router candidates → null.
+ *
+ * The marker-less TanStack heuristic (any src/routes/*.tsx|jsx) runs LAST
+ * among framework checks so a Next/Astro/SvelteKit/Nuxt repo with a stray
+ * src/routes helper is never misclassified (F1).
+ */
+
+declare function detectFramework(paths: string[]): FrameworkId | null;
+
+/**
+ * react-router pure parsers over provided FILE CONTENTS.
+ *
+ * Content-fetch is intentionally NOT wired into the navigator UI —
+ * LNK-02 only exposes these functions; UI wiring is a later ticket.
+ */
+
+/**
+ * Candidate source files that typically declare react-router routes.
+ * Matches App.* / *routes*.* / router.* (basename-based).
+ */
+declare function getReactRouterCandidatePaths(paths: string[]): string[];
+/**
+ * Extract routes from react-router source contents via tolerant regex.
+ * Supports `<Route path="...">` and `{ path: "..." }` object entries
+ * (createBrowserRouter form). Skips `*`. Dynamic segments → navigable false.
+ */
+declare function parseReactRouterRoutes(contents: string[]): DerivedRoute[];
+
+/**
+ * TanStack Start / TanStack Router file-based route conventions under
+ * `src/routes/`. Behavior preserved exactly from the CHR-03 parser.
+ *
+ *   - `index` → parent path (`src/routes/index.tsx` → `/`)
+ *   - dots nest (`jobs.index.tsx` → `/jobs`)
+ *   - `$param` → dynamic segment (`jobs.$jobId.tsx` → `/jobs/:jobId`)
+ *   - `__root` is layout only (skipped)
+ *   - `-` prefix excludes the file/folder
+ *   - `_` prefix is a pathless layout segment (stripped from the URL)
+ *
+ * Dynamic patterns are listed but not navigable in v1.
+ */
+
+declare function parseTanStackRoutes(paths: string[]): DerivedRoute[];
+
+/**
+ * Next.js app router + pages router parsers over a path listing.
+ *
+ * App: app/.../page.* (+ src/app), strip (group) and @slot,
+ * [param]→:param, [...slug]→*, skip app/api/... and _private.
+ *
+ * Pages: pages/... (+ src/pages), skip api + _app/_document/_error,
+ * index collapses, [param]→:param.
+ */
+
+declare function parseNextRoutes(paths: string[]): DerivedRoute[];
+
+/**
+ * Astro file-based routing under src/pages/ (default) or pages/
+ * when the tree has astro.config.* and no src/pages/ (srcDir-customized).
+ * Page extensions: .astro / .md / .mdx / .html.
+ * Skip _-prefixed and .../api/. Index collapses.
+ * [param]→:param, [...slug]→*, [[...slug]]→* (F5).
+ */
+
+declare function parseAstroRoutes(paths: string[]): DerivedRoute[];
+
+/**
+ * SvelteKit file-based routing: src/routes/.../+page.svelte
+ * and layout-reset +page@*.svelte only.
+ * (group) stripped, [param]→:param, [[...rest]]→*, dynamic ⇒ navigable false.
+ * +page.ts / +page.server.ts are load modules and derive nothing (F4).
+ */
+
+declare function parseSvelteKitRoutes(paths: string[]): DerivedRoute[];
+
+/**
+ * Nuxt file-based routing under pages/ (and src/pages/).
+ * [param]→:param, [[...slug]]→*, [[slug]]→:slug, index collapses.
+ * Dynamic ⇒ navigable false.
+ */
+
+declare function parseNuxtRoutes(paths: string[]): DerivedRoute[];
+
+/**
+ * LNK-02 — framework adapter registry entry.
+ *
+ * Detects the framework from a path listing, dispatches to the matching
+ * pure parser, returns DerivedRoute[] (path + navigable). Unknown → [].
+ *
+ * react-router content parsers are exported for later UI wiring; the
+ * path-only deriveRoutes entry returns [] for react-router-only trees.
+ *
+ * LNK-06: enumerateRouteEntries keeps sourcePath for marker harvest +
+ * compileManifest; deriveRoutes strips it so the navigator contract is
+ * unchanged (path + navigable only).
+ */
+
+/**
+ * Navigator contract: path + navigable only (CHR-03 / LNK-02 stable).
+ * sourcePath is intentionally stripped so existing equality fixtures hold.
+ */
+declare function deriveRoutes(paths: string[]): DerivedRoute[];
+/**
+ * LNK-06 compile path: URL template + sourcePath for marker harvest.
+ */
+declare function enumerateRouteEntries(paths: string[]): RouteEntry[];
+
+export { ClassifyResult, CompileResult, type DerivedRoute, type FrameworkId, type HistoryMatchEntry, type HistoryMatchResult, type ManifestLayer, ManifestV1, ROLE_INDEX_PATHS, type ResolvedBoardPath, RouteEntry, RouteRole, type TreeFile, ValidateManifestError, ValidateManifestResult, checkRoleTemplate, classifyRoutes, compileManifest, compileManifestFromTree, createBoardLinkResolver, deriveRoutes, detectFramework, enumerateRouteEntries, extractCavunoPageMarker, extractParamNames, getReactRouterCandidatePaths, matchPathAgainstHistory, matchPathToTemplate, parseAstroRoutes, parseNextRoutes, parseNuxtRoutes, parseReactRouterRoutes, parseSvelteKitRoutes, parseTanStackRoutes, sameParamSet, validateManifest };