@abinnovision/payloadcms-wayfinder 1.0.0-beta.3 → 1.0.0-beta.6

package/README.md

@@ -4,6 +4,11 @@
 
 Editor-authored URL routing for [Payload CMS](https://payloadcms.com/).
 
+On a shoot, the route to set is marked by a trail of small signs, one arrow per junction, put
+up by someone who walked it first. Nobody has to be told the address. Wayfinder is that trail for
+URLs: editors author which collection is served at which path pattern, and everything that needs
+a link follows the signs instead of hard-coding the route.
+
 Wayfinder owns one thing: the map from collections to the URL patterns their documents are served
 at. That map is authored in the CMS, so adding a page type is an editorial act rather than a code
 change. Everything else in the package falls out of it. `createRouter` binds the mapping, the

package/dist/admin/LinkLabelFeature.client.d.mts

@@ -1,5 +1,4 @@
 //#region src/admin/LinkLabelFeature.client.d.ts
 /** Client feature registering {@link LinkLabelPlugin} on the editor. */
-declare const LinkLabelFeatureClient: import("@payloadcms/richtext-lexical").FeatureProviderProviderClient<undefined, undefined>;
-//#endregion
-export { LinkLabelFeatureClient };
+export declare const LinkLabelFeatureClient: import("@payloadcms/richtext-lexical").FeatureProviderProviderClient<undefined, undefined>;
+//#endregion

package/dist/config/collection-string-field.d.mts

@@ -1,6 +1,6 @@
 import { Field, TextField } from "payload";
 //#region src/config/collection-string-field.d.ts
-interface CreateCollectionStringFieldArgs {
+export interface CreateCollectionStringFieldArgs {
   name: string;
   required?: boolean;
   label?: TextField["label"];
@@ -15,6 +15,5 @@ interface CreateCollectionStringFieldArgs {
  *
  * @param args Field name and presentation overrides.
  */
-declare const createCollectionStringField: (args: CreateCollectionStringFieldArgs) => Field;
-//#endregion
-export { CreateCollectionStringFieldArgs, createCollectionStringField };
+export declare const createCollectionStringField: (args: CreateCollectionStringFieldArgs) => Field;
+//#endregion

package/dist/config/has-duplicates.d.mts

@@ -10,6 +10,5 @@
  *
  * @param keys The authored keys, in row order.
  */
-declare const hasDuplicates: (keys: (string | undefined)[]) => boolean;
-//#endregion
-export { hasDuplicates };
+export declare const hasDuplicates: (keys: (string | undefined)[]) => boolean;
+//#endregion

package/dist/config/link-field.d.mts

@@ -3,7 +3,7 @@ import { LinkDeclaration, LinkVariantSource } from "../pattern/define-links.mjs"
 import { Field } from "payload";
 //#region src/config/link-field.d.ts
 /** Admin labels for the built-in link types. */
-interface LinkFieldLabels {
+export interface LinkFieldLabels {
   label?: LabelLike;
   none?: LabelLike;
   reference?: LabelLike;
@@ -14,7 +14,7 @@ interface LinkFieldLabels {
   urlField?: LabelLike;
   samePageField?: LabelLike;
 }
-interface LinkFieldArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> extends LinkVariantSource<TDeclaration> {
+export interface LinkFieldArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> extends LinkVariantSource<TDeclaration> {
   /**
    * Every collection that has a URL. A target missing here cannot be linked
    * to from the admin panel even if its mapping exists.
@@ -30,6 +30,5 @@ interface LinkFieldArgs<TDeclaration extends LinkDeclaration = LinkDeclaration>
    */
   interfaceName?: string;
 }
-declare const linkField: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: LinkFieldArgs<TDeclaration>) => Field;
-//#endregion
-export { LinkFieldArgs, LinkFieldLabels, linkField };
+export declare const linkField: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: LinkFieldArgs<TDeclaration>) => Field;
+//#endregion

package/dist/config/load-mappings.d.mts

@@ -10,11 +10,11 @@ import { Payload } from "payload";
  * `loadMappings` call in your own framework cache and invalidate it from
  * `createMappingGlobal({ onChange })`.
  */
-interface MappingCache {
+export interface MappingCache {
   get: (key: string) => PayloadCollectionMappingResolved[] | undefined;
   set: (key: string, value: PayloadCollectionMappingResolved[]) => void;
 }
-interface LoadMappingsArgs {
+export interface LoadMappingsArgs {
   payload: Payload;
   globalSlug?: string;
   /**
@@ -49,6 +49,5 @@ interface LoadMappingsArgs {
  *
  * @param args The Payload instance and mapping-global settings.
  */
-declare const loadMappings: (args: LoadMappingsArgs) => Promise<PayloadCollectionMappingResolved[]>;
-//#endregion
-export { LoadMappingsArgs, MappingCache, loadMappings };
+export declare const loadMappings: (args: LoadMappingsArgs) => Promise<PayloadCollectionMappingResolved[]>;
+//#endregion

package/dist/config/mapping-global.d.mts

@@ -1,8 +1,8 @@
 import { GlobalConfig } from "payload";
 //#region src/config/mapping-global.d.ts
 /** The global the mapping is authored in, unless overridden. */
-declare const DEFAULT_MAPPING_GLOBAL_SLUG = "collections-mapping";
-interface CreateMappingGlobalArgs {
+export declare const DEFAULT_MAPPING_GLOBAL_SLUG = "collections-mapping";
+export interface CreateMappingGlobalArgs {
   /** Defaults to {@link DEFAULT_MAPPING_GLOBAL_SLUG}. */
   globalSlug?: string;
   /**
@@ -38,6 +38,5 @@ interface CreateMappingGlobalArgs {
  *
  * @param args Slug, localization and presentation overrides.
  */
-declare const createMappingGlobal: (args?: CreateMappingGlobalArgs) => GlobalConfig;
-//#endregion
-export { CreateMappingGlobalArgs, DEFAULT_MAPPING_GLOBAL_SLUG, createMappingGlobal };
+export declare const createMappingGlobal: (args?: CreateMappingGlobalArgs) => GlobalConfig;
+//#endregion

package/dist/config/plugin.d.mts

@@ -1,7 +1,7 @@
 import { CreateMappingGlobalArgs } from "./mapping-global.mjs";
 import { Plugin } from "payload";
 //#region src/config/plugin.d.ts
-interface WayfinderPluginArgs extends CreateMappingGlobalArgs {
+export interface WayfinderPluginArgs extends CreateMappingGlobalArgs {
   /**
    * Collections to check for `defaultPopulate` at boot.
    *
@@ -29,6 +29,5 @@ interface WayfinderPluginArgs extends CreateMappingGlobalArgs {
  *
  * @param args Mapping-global settings and startup-check inputs.
  */
-declare const wayfinderPlugin: (args?: WayfinderPluginArgs) => Plugin;
-//#endregion
-export { WayfinderPluginArgs, wayfinderPlugin };
+export declare const wayfinderPlugin: (args?: WayfinderPluginArgs) => Plugin;
+//#endregion

package/dist/config/translations.d.mts

@@ -6,7 +6,7 @@
  * without the plugin still works — `req.t` returns the key's fallback — but
  * sees these in English regardless of the admin locale.
  */
-declare const wayfinderTranslations: {
+export declare const wayfinderTranslations: {
   readonly en: {
     readonly wayfinder: {
       readonly duplicateCollection: "Each collection may only be mapped once";
@@ -30,5 +30,4 @@ declare const wayfinderTranslations: {
     };
   };
 };
-//#endregion
-export { wayfinderTranslations };
+//#endregion

package/dist/lexical/index.d.mts

@@ -8,7 +8,7 @@ import { LinkFeature } from "@payloadcms/richtext-lexical";
  * destination, so the floating link editor shows a useful hover preview
  * instead of a blank one.
  */
-declare const linkLabelFeature: import("@payloadcms/richtext-lexical").FeatureProviderProviderServer<undefined, undefined, undefined>;
+export declare const linkLabelFeature: import("@payloadcms/richtext-lexical").FeatureProviderProviderServer<undefined, undefined, undefined>;
 /**
  * Replaces Lexical's link fields with the wayfinder link field, so links
  * written in rich text route through the collection mapping exactly like links
@@ -16,7 +16,7 @@ declare const linkLabelFeature: import("@payloadcms/richtext-lexical").FeaturePr
  *
  * @param args The same arguments as the standalone link field.
  */
-declare const wayfinderLinkFeature: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: LinkFieldArgs<TDeclaration>) => ReturnType<typeof LinkFeature>;
+export declare const wayfinderLinkFeature: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: LinkFieldArgs<TDeclaration>) => ReturnType<typeof LinkFeature>;
 /**
  * Resolves a rich-text link node to an href.
  *
@@ -31,8 +31,7 @@ declare const wayfinderLinkFeature: <TDeclaration extends LinkDeclaration = Link
  *
  * @param args The node's fields plus the usual link-resolution arguments.
  */
-declare const resolveLinkNode: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: Omit<ResolveLinkArgs<TDeclaration>, "link"> & {
+export declare const resolveLinkNode: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: Omit<ResolveLinkArgs<TDeclaration>, "link"> & {
   fields: unknown;
 }) => ResolvedLinkOf<TDeclaration> | null;
-//#endregion
-export { linkLabelFeature, resolveLinkNode, wayfinderLinkFeature };
+//#endregion

package/dist/montage/index.d.mts

@@ -10,7 +10,7 @@ import { MontageSlots } from "@abinnovision/payloadcms-montage";
  * Prefixed with the package name because extension names share one namespace
  * across every library using montage.
  */
-declare const wayfinderExtension: import("@abinnovision/payloadcms-montage").ContextExtension<Router<LinkDeclaration<Record<string, AnyLinkVariantDefinition>>>>;
+export declare const wayfinderExtension: import("@abinnovision/payloadcms-montage").ContextExtension<Router<LinkDeclaration<Record<string, AnyLinkVariantDefinition>>>>;
 /**
  * What `initWayfinder` needs: a router's settings, plus where the mappings
  * come from.
@@ -19,7 +19,7 @@ declare const wayfinderExtension: import("@abinnovision/payloadcms-montage").Con
  * from. A route that resolved a path has them already, and reading the global
  * a second time to render the same page is a query for nothing.
  */
-type InitWayfinderArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> = Omit<CreateRouterArgs<TDeclaration>, "mappings"> & ({
+export type InitWayfinderArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> = Omit<CreateRouterArgs<TDeclaration>, "mappings"> & ({
   mappings: PayloadCollectionMappingResolved[];
 } | {
   load: Omit<LoadMappingsArgs, "localized"> & {
@@ -37,7 +37,7 @@ type InitWayfinderArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> =
  * @param ctx The render context.
  * @param args The router's settings, and the mappings or where to read them.
  */
-declare const initWayfinder: <TDeclaration extends LinkDeclaration = LinkDeclaration>(ctx: MontageSlots, args: InitWayfinderArgs<TDeclaration>) => Promise<void>;
+export declare const initWayfinder: <TDeclaration extends LinkDeclaration = LinkDeclaration>(ctx: MontageSlots, args: InitWayfinderArgs<TDeclaration>) => Promise<void>;
 /**
  * Reads the router off the render context.
  *
@@ -49,6 +49,5 @@ declare const initWayfinder: <TDeclaration extends LinkDeclaration = LinkDeclara
  *
  * @param ctx The render context.
  */
-declare const wayfinderFrom: <TDeclaration extends LinkDeclaration = LinkDeclaration>(ctx: MontageSlots) => Router<TDeclaration>;
-//#endregion
-export { InitWayfinderArgs, initWayfinder, wayfinderExtension, wayfinderFrom };
+export declare const wayfinderFrom: <TDeclaration extends LinkDeclaration = LinkDeclaration>(ctx: MontageSlots) => Router<TDeclaration>;
+//#endregion

package/dist/pattern/define-links.d.mts

@@ -58,9 +58,9 @@ type FieldData<F1> = F1 extends {
  * signatures that reject ordinary link data, so such a variant contributes
  * nothing rather than something wrong.
  */
-type DataOfFields<TFields extends readonly unknown[]> = number extends TFields["length"] ? object : UnionToIntersection<FieldData<TFields[number]>>;
+export type DataOfFields<TFields extends readonly unknown[]> = number extends TFields["length"] ? object : UnionToIntersection<FieldData<TFields[number]>>;
 /** A variant that has had no resolver attached. */
-interface LinkVariantSpec<TFields extends readonly Field[]> {
+export interface LinkVariantSpec<TFields extends readonly Field[]> {
   label: LabelLike;
   fields?: TFields;
 }
@@ -68,7 +68,7 @@ interface LinkVariantSpec<TFields extends readonly Field[]> {
  * A declared link type: its admin presentation, the fields it contributes, and
  * how it turns into an href.
  */
-interface LinkVariantDefinition<TCtx = unknown, TFields extends readonly Field[] = readonly Field[], TExtra = object, TData = DataOfFields<TFields>> {
+export interface LinkVariantDefinition<TCtx = unknown, TFields extends readonly Field[] = readonly Field[], TExtra = object, TData = DataOfFields<TFields>> {
   label: LabelLike;
   fields?: TFields;
   resolve?: (args: {
@@ -91,13 +91,13 @@ interface LinkVariantDefinition<TCtx = unknown, TFields extends readonly Field[]
  * `resolve` takes `never` so that any resolver satisfies it: a parameter is
  * contravariant, and `never` is assignable to every argument type.
  */
-interface AnyLinkVariantDefinition {
+export interface AnyLinkVariantDefinition {
   label: LabelLike;
   fields?: readonly Field[];
   resolve?: (args: never) => unknown;
 }
 /** The link vocabulary an app declares: which types exist and how each resolves. */
-interface LinkDeclaration<TVariants1 extends Record<string, AnyLinkVariantDefinition> = Record<string, AnyLinkVariantDefinition>> {
+export interface LinkDeclaration<TVariants1 extends Record<string, AnyLinkVariantDefinition> = Record<string, AnyLinkVariantDefinition>> {
   variants: TVariants1;
 }
 /** The stored shape of a link field built from a declaration. */
@@ -116,9 +116,9 @@ type FieldsData<V> = V extends {
 type DataOfVariant<V> = V extends {
   __data?: infer D;
 } ? unknown extends D ? FieldsData<V> : D : FieldsData<V>;
-type LinkDataOf<T> = T extends LinkDeclaration<infer TVariants> ? LinkFieldData<Extract<keyof TVariants, string>, UnionToIntersection<{ [K in keyof TVariants]: DataOfVariant<TVariants[K]>; }[keyof TVariants]>> : never;
+export type LinkDataOf<T> = T extends LinkDeclaration<infer TVariants> ? LinkFieldData<Extract<keyof TVariants, string>, UnionToIntersection<{ [K in keyof TVariants]: DataOfVariant<TVariants[K]>; }[keyof TVariants]>> : never;
 /** What resolving a link built from a declaration can produce. */
-type ResolvedLinkOf<T> = T extends LinkDeclaration<infer TVariants> ? BaseResolvedLink & Contributed<UnionToIntersection<{ [K in keyof TVariants]: TVariants[K] extends {
+export type ResolvedLinkOf<T> = T extends LinkDeclaration<infer TVariants> ? BaseResolvedLink & Contributed<UnionToIntersection<{ [K in keyof TVariants]: TVariants[K] extends {
   resolve?: (args: never) => infer R;
 } ? Extract<R, BaseResolvedLink> extends (infer E) ? Omit<E, keyof BaseResolvedLink> : object : object; }[keyof TVariants]>> : never;
 /**
@@ -144,7 +144,7 @@ interface VariantStep<TCtx, TFields extends readonly Field[], TData> {
    */
   data: <TOverride>() => VariantStep<TCtx, TFields, TOverride>;
 }
-type VariantBuilder<TCtx> = <const TFields extends readonly Field[]>(spec: LinkVariantSpec<TFields>) => LinkVariantDefinition<TCtx, TFields, object, DataOfFields<TFields>> & VariantStep<TCtx, TFields, DataOfFields<TFields>>;
+export type VariantBuilder<TCtx> = <const TFields extends readonly Field[]>(spec: LinkVariantSpec<TFields>) => LinkVariantDefinition<TCtx, TFields, object, DataOfFields<TFields>> & VariantStep<TCtx, TFields, DataOfFields<TFields>>;
 /**
  * Declares the link types an app offers.
  *
@@ -161,7 +161,7 @@ type VariantBuilder<TCtx> = <const TFields extends readonly Field[]>(spec: LinkV
  * stays free of the Payload runtime and a frontend can hold the same
  * declaration the CMS config does.
  */
-declare const defineLinks: <TCtx = unknown>() => <const TVariants1 extends Record<string, AnyLinkVariantDefinition>>(build: (variant: VariantBuilder<TCtx>) => {
+export declare const defineLinks: <TCtx = unknown>() => <const TVariants1 extends Record<string, AnyLinkVariantDefinition>>(build: (variant: VariantBuilder<TCtx>) => {
   variants: TVariants1;
 }) => LinkDeclaration<TVariants1>;
 /**
@@ -173,7 +173,7 @@ type ContextOfVariant<V> = V extends {
 } ? NonNullable<R> extends ((...args: never[]) => unknown) ? Parameters<NonNullable<R>>[0] extends {
   context: infer C;
 } ? C : never : never : never;
-type LinkContextOf<T> = T extends LinkDeclaration<infer TVariants> ? UnionToIntersection<{ [K in keyof TVariants]: ContextOfVariant<TVariants[K]>; }[keyof TVariants]> : unknown;
+export type LinkContextOf<T> = T extends LinkDeclaration<infer TVariants> ? UnionToIntersection<{ [K in keyof TVariants]: ContextOfVariant<TVariants[K]>; }[keyof TVariants]> : unknown;
 /**
  * Carries a declaration to whichever function needs it.
  *
@@ -182,7 +182,7 @@ type LinkContextOf<T> = T extends LinkDeclaration<infer TVariants> ? UnionToInte
  * the context they expect, both flow to the call site. Without it a caller
  * would have to annotate the result to see its own variants' properties.
  */
-interface LinkVariantSource<TDeclaration extends LinkDeclaration = LinkDeclaration> {
+export interface LinkVariantSource<TDeclaration extends LinkDeclaration = LinkDeclaration> {
   /** The declaration built by {@link defineLinks}. */
   links?: TDeclaration;
 }
@@ -194,6 +194,5 @@ interface LinkVariantSource<TDeclaration extends LinkDeclaration = LinkDeclarati
  *
  * @param source The declaration, or nothing.
  */
-declare const variantsOf: <TCtx, TExtra>(source: LinkVariantSource) => readonly DeclaredLinkVariant<TCtx, TExtra>[];
-//#endregion
-export { AnyLinkVariantDefinition, DataOfFields, LinkContextOf, LinkDataOf, LinkDeclaration, LinkVariantDefinition, LinkVariantSource, LinkVariantSpec, ResolvedLinkOf, VariantBuilder, defineLinks, variantsOf };
+export declare const variantsOf: <TCtx, TExtra>(source: LinkVariantSource) => readonly DeclaredLinkVariant<TCtx, TExtra>[];
+//#endregion

package/dist/pattern/define-mappings.d.mts

@@ -12,8 +12,7 @@ import { PayloadCollectionMapping, PayloadCollectionMappingResolved } from "./ty
  * @param options Where a relationship parameter falls back to when the target
  *   collection's own pattern cannot name an identifier.
  */
-declare const defineMappings: (mappings: PayloadCollectionMapping[], options?: {
+export declare const defineMappings: (mappings: PayloadCollectionMapping[], options?: {
   fallbackIdentifierField?: string;
 }) => PayloadCollectionMappingResolved[];
-//#endregion
-export { defineMappings };
+//#endregion

package/dist/pattern/derive-link-label.d.mts

@@ -18,6 +18,5 @@ import { LinkVariantSource } from "./define-links.mjs";
  * @param link The nested link group of a link node.
  * @param source App-declared link types, which may describe themselves.
  */
-declare const deriveLinkLabel: <TExtra>(link: LinkFieldData<string, TExtra>, source?: LinkVariantSource) => string | undefined;
-//#endregion
-export { deriveLinkLabel };
+export declare const deriveLinkLabel: <TExtra>(link: LinkFieldData<string, TExtra>, source?: LinkVariantSource) => string | undefined;
+//#endregion

package/dist/pattern/link-node.d.mts

@@ -16,6 +16,5 @@ import { LinkFieldData } from "./types.mjs";
  *
  * @param fields The node's `fields` object, in whatever shape it arrived.
  */
-declare const normaliseLinkNodeFields: (fields: unknown) => LinkFieldData | undefined;
-//#endregion
-export { normaliseLinkNodeFields };
+export declare const normaliseLinkNodeFields: (fields: unknown) => LinkFieldData | undefined;
+//#endregion

package/dist/pattern/matcher.d.mts

@@ -5,7 +5,7 @@ interface MatchOpts {
   locale: string;
   mappings: PayloadCollectionMappingResolved[];
 }
-type PayloadCollectionMatch = {
+export type PayloadCollectionMatch = {
   mapping: PayloadCollectionMappingResolved;
 } & PayloadCollectionMappingMatch;
 /**
@@ -21,6 +21,5 @@ type PayloadCollectionMatch = {
  *
  * @param opts The path, locale and candidate mappings.
  */
-declare const matchCollectionMappings: (opts: MatchOpts) => PayloadCollectionMatch[];
-//#endregion
-export { PayloadCollectionMatch, matchCollectionMappings };
+export declare const matchCollectionMappings: (opts: MatchOpts) => PayloadCollectionMatch[];
+//#endregion

package/dist/pattern/param-query-path.d.mts

@@ -1,10 +1,10 @@
 import { PayloadCollectionMappingResolved } from "./types.mjs";
 import { SanitizedCollectionConfig } from "payload";
 //#region src/pattern/param-query-path.d.ts
-type RegisteredCollections = Record<string, {
+export type RegisteredCollections = Record<string, {
   config: SanitizedCollectionConfig;
 } | undefined>;
-interface ResolveParamQueryPathArgs {
+export interface ResolveParamQueryPathArgs {
   /** The collection the mapping belongs to. */
   config: SanitizedCollectionConfig;
   /** The parameter name taken from the path pattern. */
@@ -35,10 +35,9 @@ interface ResolveParamQueryPathArgs {
  *
  * @param args The collection, parameter and resolution context.
  */
-declare const resolveParamQueryPath: (args: ResolveParamQueryPathArgs) => {
+export declare const resolveParamQueryPath: (args: ResolveParamQueryPathArgs) => {
   queryPath: string;
 } | {
   error: string;
 };
-//#endregion
-export { RegisteredCollections, ResolveParamQueryPathArgs, resolveParamQueryPath };
+//#endregion

package/dist/pattern/resolver.d.mts

@@ -8,7 +8,7 @@ import { PayloadCollectionMapping, PayloadCollectionMappingResolved, PayloadColl
  * @param resolvers The pattern's compiled resolvers.
  * @param values The parameter values, in pattern order.
  */
-declare const isRootWildcard: (resolvers: PayloadCollectionMappingResolvers, values: string[]) => boolean;
+export declare const isRootWildcard: (resolvers: PayloadCollectionMappingResolvers, values: string[]) => boolean;
 /**
  * Picks the resolvers for a locale, falling back to the unlocalized bucket.
  *
@@ -19,7 +19,7 @@ declare const isRootWildcard: (resolvers: PayloadCollectionMappingResolvers, val
  * @param mapping The compiled mapping.
  * @param locale The locale to resolve for.
  */
-declare const resolversFor: (mapping: PayloadCollectionMappingResolved, locale: string) => PayloadCollectionMappingResolvers | undefined;
+export declare const resolversFor: (mapping: PayloadCollectionMappingResolved, locale: string) => PayloadCollectionMappingResolvers | undefined;
 /**
  * Compiles a mapping's patterns into match and build functions.
  *
@@ -27,6 +27,5 @@ declare const resolversFor: (mapping: PayloadCollectionMappingResolved, locale:
  * @param fallbackIdentifierField The field a relationship parameter falls back
  *   to when the target's own pattern cannot name one.
  */
-declare const resolveCollectionMapping: (input: PayloadCollectionMapping, fallbackIdentifierField?: string) => PayloadCollectionMappingResolved;
-//#endregion
-export { isRootWildcard, resolveCollectionMapping, resolversFor };
+export declare const resolveCollectionMapping: (input: PayloadCollectionMapping, fallbackIdentifierField?: string) => PayloadCollectionMappingResolved;
+//#endregion

package/dist/pattern/types.d.mts

@@ -9,9 +9,9 @@ import { Field } from "payload";
  * arrives as a plain string, which normalises into this single bucket so the
  * rest of the package has one shape to work with.
  */
-declare const DEFAULT_LOCALE_KEY = "__default";
+export declare const DEFAULT_LOCALE_KEY = "__default";
 /** The field a relationship parameter matches on unless something says otherwise. */
-declare const DEFAULT_IDENTIFIER_FIELD = "slug";
+export declare const DEFAULT_IDENTIFIER_FIELD = "slug";
 /**
  * Maps one collection onto the URL patterns its documents live at.
  *
@@ -19,7 +19,7 @@ declare const DEFAULT_IDENTIFIER_FIELD = "slug";
  * localization supplies a single pattern. Authored in the mapping global, so
  * adding a page type never means touching routing code.
  */
-interface PayloadCollectionMapping {
+export interface PayloadCollectionMapping {
   collection: string;
   /**
    * Either one pattern per locale (`{ de: "/:format/:slug" }`) or a single
@@ -30,7 +30,7 @@ interface PayloadCollectionMapping {
 /**
  * Result of matching a path against one mapping.
  */
-interface PayloadCollectionMappingMatch {
+export interface PayloadCollectionMappingMatch {
   /**
    * The pattern's last parameter, which identifies the document within its
    * collection.
@@ -50,14 +50,14 @@ interface PayloadCollectionMappingMatch {
  * How specific a pattern is, used to order candidates so that the most
  * precise pattern wins regardless of the order rows sit in the admin UI.
  */
-interface PayloadCollectionMappingSpecificity {
+export interface PayloadCollectionMappingSpecificity {
   /** Segments that are literal text rather than a parameter. */
   literalSegments: number;
   /** Whether the pattern ends in a catch-all. */
   hasWildcard: boolean;
   totalSegments: number;
 }
-interface PayloadCollectionMappingResolvers {
+export interface PayloadCollectionMappingResolvers {
   match: (path: string) => false | PayloadCollectionMappingMatch;
   build: (params: ParamData) => string;
   /**
@@ -68,7 +68,7 @@ interface PayloadCollectionMappingResolvers {
   paramNames: string[];
   specificity: PayloadCollectionMappingSpecificity;
 }
-interface PayloadCollectionMappingResolved {
+export interface PayloadCollectionMappingResolved {
   collection: string;
   /**
    * The field a relationship parameter matches on when it cannot be derived
@@ -106,12 +106,12 @@ interface PayloadCollectionMappingResolved {
  * Defaults to returning the path untouched, so a project serving unprefixed
  * URLs needs no configuration.
  */
-type FormatHref = (args: {
+export type FormatHref = (args: {
   path: string;
   locale: string;
 }) => string;
 /** Label accepted wherever the admin panel shows one. */
-type LabelLike = string | Record<string, string>;
+export type LabelLike = string | Record<string, string>;
 /**
  * Optional-everything, including an explicit `undefined`.
  *
@@ -120,9 +120,9 @@ type LabelLike = string | Record<string, string>;
  * reads one of its own optional fields and passes it straight back would not
  * typecheck against its own declared shape.
  */
-type Contributed<T> = { [K in keyof T]?: T[K] | undefined; };
+export type Contributed<T> = { [K in keyof T]?: T[K] | undefined; };
 /** The link types the package understands without configuration. */
-type BuiltinLinkVariant = "none" | "reference" | "custom" | "same-page";
+export type BuiltinLinkVariant = "none" | "reference" | "custom" | "same-page";
 /**
  * How Payload identifies a document.
  *
@@ -130,7 +130,7 @@ type BuiltinLinkVariant = "none" | "reference" | "custom" | "same-page";
  * reference id crosses the package boundary accepts both, so a project is not
  * forced to cast at the call site over its own choice of adapter.
  */
-type DocumentId = string | number;
+export type DocumentId = string | number;
 /**
  * Structural shape of the `link` field group.
  *
@@ -143,7 +143,7 @@ type DocumentId = string | number;
  * those variants contribute, so a variant's own resolver can read the data its
  * own fields produced without a cast.
  */
-type LinkFieldData<TVariant extends string = never, TExtra = object> = {
+export type LinkFieldData<TVariant extends string = never, TExtra = object> = {
   type?: BuiltinLinkVariant | TVariant | null;
   label?: string | null;
   reference?: {
@@ -157,7 +157,7 @@ type LinkFieldData<TVariant extends string = never, TExtra = object> = {
   newTab?: boolean | null;
 } & Contributed<TExtra>;
 /** What every link resolves to, before any variant adds to it. */
-interface BaseResolvedLink {
+export interface BaseResolvedLink {
   href: string;
   target?: string;
   rel?: string;
@@ -174,7 +174,7 @@ interface BaseResolvedLink {
  * so requiring all of it would mean each variant had to return the other
  * variants' properties alongside its own.
  */
-type ResolvedLink<E = object> = BaseResolvedLink & Contributed<E>;
+export type ResolvedLink<E = object> = BaseResolvedLink & Contributed<E>;
 /**
  * One variant, flattened out of a declaration with its key put back on it.
  *
@@ -182,7 +182,7 @@ type ResolvedLink<E = object> = BaseResolvedLink & Contributed<E>;
  * authoring form: variants are written through the builder, which is what
  * derives their field types.
  */
-interface DeclaredLinkVariant<TCtx = unknown, TExtra = object> {
+export interface DeclaredLinkVariant<TCtx = unknown, TExtra = object> {
   value: string;
   label: LabelLike;
   /** Readonly, because a `const` type parameter infers a readonly tuple. */
@@ -192,5 +192,4 @@ interface DeclaredLinkVariant<TCtx = unknown, TExtra = object> {
     context: TCtx;
   }) => ResolvedLink<TExtra> | null;
 }
-//#endregion
-export { BaseResolvedLink, BuiltinLinkVariant, Contributed, DEFAULT_IDENTIFIER_FIELD, DEFAULT_LOCALE_KEY, DeclaredLinkVariant, DocumentId, FormatHref, LabelLike, LinkFieldData, PayloadCollectionMapping, PayloadCollectionMappingMatch, PayloadCollectionMappingResolved, PayloadCollectionMappingResolvers, PayloadCollectionMappingSpecificity, ResolvedLink };
+//#endregion

package/dist/runtime/build-href.d.mts

@@ -8,10 +8,10 @@ import { BuildDiagnosticReason, OnDiagnostic } from "./diagnostics.mjs";
  * collection interfaces assign to it; the fields the path pattern names are
  * read dynamically below.
  */
-type LinkableDocument = object;
+export type LinkableDocument = object;
 /** Applied when no {@link FormatHref} is supplied: the path, untouched. */
-declare const identityFormatHref: FormatHref;
-interface BuildHrefArgs {
+export declare const identityFormatHref: FormatHref;
+export interface BuildHrefArgs {
   mappings: PayloadCollectionMappingResolved[];
   collection: string;
   document: LinkableDocument;
@@ -28,6 +28,5 @@ interface BuildHrefArgs {
  *
  * @param args The mappings, target collection, document and locale.
  */
-declare const buildHref: (args: BuildHrefArgs) => string | null;
-//#endregion
-export { BuildHrefArgs, LinkableDocument, buildHref, identityFormatHref };
+export declare const buildHref: (args: BuildHrefArgs) => string | null;
+//#endregion

package/dist/runtime/build-path.d.mts

@@ -1,7 +1,7 @@
 import { FormatHref, PayloadCollectionMappingResolved } from "../pattern/types.mjs";
 import { BuildDiagnosticReason, OnDiagnostic } from "./diagnostics.mjs";
 //#region src/runtime/build-path.d.ts
-interface BuildPathArgs {
+export interface BuildPathArgs {
   mappings: PayloadCollectionMappingResolved[];
   collection: string;
   locale: string;
@@ -27,6 +27,5 @@ interface BuildPathArgs {
  *
  * @param args The mappings, collection, locale and parameter values.
  */
-declare const buildPath: (args: BuildPathArgs) => string;
-//#endregion
-export { BuildPathArgs, buildPath };
+export declare const buildPath: (args: BuildPathArgs) => string;
+//#endregion

package/dist/runtime/create-router.d.mts

@@ -6,7 +6,7 @@ import { ResolveReference } from "./resolve-link.mjs";
 import { PayloadDocument, ResolvePathWhere, ResolvedPath } from "./resolve-path.mjs";
 import { Payload } from "payload";
 //#region src/runtime/create-router.d.ts
-interface CreateRouterArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> {
+export interface CreateRouterArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> {
   mappings: PayloadCollectionMappingResolved[];
   /** Which locale's pattern every call builds and matches against. */
   locale: string;
@@ -27,7 +27,7 @@ interface CreateRouterArgs<TDeclaration extends LinkDeclaration = LinkDeclaratio
   onDiagnostic?: OnDiagnostic<DiagnosticReason>;
 }
 /** Everything a request needs in order to turn documents and links into URLs. */
-interface Router<TDeclaration extends LinkDeclaration = LinkDeclaration> {
+export interface Router<TDeclaration extends LinkDeclaration = LinkDeclaration> {
   /** The href a document is served at, or null. */
   href: (collection: string, document: LinkableDocument) => string | null;
   /**
@@ -67,6 +67,5 @@ interface Router<TDeclaration extends LinkDeclaration = LinkDeclaration> {
  *
  * @param args The mappings, locale and per-request link settings.
  */
-declare const createRouter: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: CreateRouterArgs<TDeclaration>) => Router<TDeclaration>;
-//#endregion
-export { CreateRouterArgs, Router, createRouter };
+export declare const createRouter: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: CreateRouterArgs<TDeclaration>) => Router<TDeclaration>;
+//#endregion

package/dist/runtime/diagnostics.d.mts

@@ -8,8 +8,8 @@
  * the distinction someone staring at a missing link needs. These reasons carry
  * it out of band.
  */
-type DiagnosticReason = "no-mapping" | "no-locale-pattern" | "unpopulated-reference" | "missing-param" | "no-document" | "unknown-variant";
-interface Diagnostic<TReason extends DiagnosticReason> {
+export type DiagnosticReason = "no-mapping" | "no-locale-pattern" | "unpopulated-reference" | "missing-param" | "no-document" | "unknown-variant";
+export interface Diagnostic<TReason extends DiagnosticReason> {
   reason: TReason;
   collection?: string;
   locale?: string;
@@ -24,12 +24,11 @@ interface Diagnostic<TReason extends DiagnosticReason> {
  * misconfigured collection reports forty times. Deduplicating is the caller's
  * job — the package cannot know which of them are worth surfacing.
  */
-type OnDiagnostic<TReason extends DiagnosticReason> = (diagnostic: Diagnostic<TReason>) => void;
+export type OnDiagnostic<TReason extends DiagnosticReason> = (diagnostic: Diagnostic<TReason>) => void;
 /** Reasons {@link buildHref} and {@link buildPath} can report. */
-type BuildDiagnosticReason = "no-mapping" | "no-locale-pattern" | "missing-param";
+export type BuildDiagnosticReason = "no-mapping" | "no-locale-pattern" | "missing-param";
 /** Reasons link resolution can report. */
-type ResolveLinkDiagnosticReason = BuildDiagnosticReason | "unpopulated-reference" | "unknown-variant";
+export type ResolveLinkDiagnosticReason = BuildDiagnosticReason | "unpopulated-reference" | "unknown-variant";
 /** Reasons path resolution can report. */
-type ResolvePathDiagnosticReason = "no-mapping" | "no-document";
-//#endregion
-export { BuildDiagnosticReason, Diagnostic, DiagnosticReason, OnDiagnostic, ResolveLinkDiagnosticReason, ResolvePathDiagnosticReason };
+export type ResolvePathDiagnosticReason = "no-mapping" | "no-document";
+//#endregion

package/dist/runtime/resolve-link.d.mts

@@ -11,14 +11,14 @@ import { OnDiagnostic, ResolveLinkDiagnosticReason } from "./diagnostics.mjs";
  * strategy: the package resolves from the populated document, and this is the
  * documented way out for setups that cannot.
  */
-type ResolveReference = (args: {
+export type ResolveReference = (args: {
   relationTo: string;
   value: DocumentId | {
     id: DocumentId;
   };
   locale: string;
 }) => string | null;
-interface ResolveLinkArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> extends LinkVariantSource<TDeclaration> {
+export interface ResolveLinkArgs<TDeclaration extends LinkDeclaration = LinkDeclaration> extends LinkVariantSource<TDeclaration> {
   /**
    * The link group's value.
    *
@@ -53,7 +53,7 @@ interface ResolveLinkArgs<TDeclaration extends LinkDeclaration = LinkDeclaration
  *
  * @param args The link value, mappings, locale and any app-declared variants.
  */
-declare const resolveLink: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: ResolveLinkArgs<TDeclaration>) => ResolvedLinkOf<TDeclaration> | null;
+export declare const resolveLink: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: ResolveLinkArgs<TDeclaration>) => ResolvedLinkOf<TDeclaration> | null;
 /**
  * Whether a link would resolve to something navigable. Use it to decide
  * whether to render a link at all, rather than emitting a dead anchor.
@@ -61,8 +61,7 @@ declare const resolveLink: <TDeclaration extends LinkDeclaration = LinkDeclarati
  * @param args The same arguments as {@link resolveLink}, plus whether a label
  *   is required for the link to be worth rendering.
  */
-declare const isAvailableLink: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: ResolveLinkArgs<TDeclaration> & {
+export declare const isAvailableLink: <TDeclaration extends LinkDeclaration = LinkDeclaration>(args: ResolveLinkArgs<TDeclaration> & {
   withLabel?: boolean;
 }) => boolean;
-//#endregion
-export { ResolveLinkArgs, ResolveReference, isAvailableLink, resolveLink };
+//#endregion

package/dist/runtime/resolve-path.d.mts

@@ -8,7 +8,7 @@ import { Payload, Where } from "payload";
  * read it structurally, so it is an open record rather than the union of every
  * generated collection type.
  */
-type PayloadDocument = {
+export type PayloadDocument = {
   id: string | number;
 } & Record<string, unknown>;
 /**
@@ -27,18 +27,18 @@ type PayloadDocument = {
  * anything the compiler can see. It states what the mapping can produce, not
  * what it will.
  */
-type ResolvedPath<TDocs extends Record<string, object> = Record<string, PayloadDocument>> = { [K in keyof TDocs & string]: {
+export type ResolvedPath<TDocs extends Record<string, object> = Record<string, PayloadDocument>> = { [K in keyof TDocs & string]: {
   match: PayloadCollectionMatch;
   collection: K;
   document: TDocs[K];
 }; }[keyof TDocs & string];
 /** Extra conditions to AND into the lookup. */
-type ResolvePathWhere = Where | ((args: {
+export type ResolvePathWhere = Where | ((args: {
   collection: string;
   match: PayloadCollectionMatch;
   draft: boolean;
 }) => Where | undefined);
-interface ResolvePathToDocumentArgs {
+export interface ResolvePathToDocumentArgs {
   payload: Payload;
   mappings: PayloadCollectionMappingResolved[];
   path: string;
@@ -64,6 +64,5 @@ interface ResolvePathToDocumentArgs {
  *
  * @param args The Payload instance, mappings, path and locale.
  */
-declare const resolvePathToDocument: <TDocs extends Record<string, object> = Record<string, PayloadDocument>>(args: ResolvePathToDocumentArgs) => Promise<ResolvedPath<TDocs> | null>;
-//#endregion
-export { PayloadDocument, ResolvePathToDocumentArgs, ResolvePathWhere, ResolvedPath, resolvePathToDocument };
+export declare const resolvePathToDocument: <TDocs extends Record<string, object> = Record<string, PayloadDocument>>(args: ResolvePathToDocumentArgs) => Promise<ResolvedPath<TDocs> | null>;
+//#endregion

package/dist/runtime/resolve-relationship-slug.d.mts

@@ -1,7 +1,7 @@
 import { PayloadCollectionMappingResolved } from "../pattern/types.mjs";
 import { Payload, SanitizedCollectionConfig } from "payload";
 //#region src/runtime/resolve-relationship-slug.d.ts
-interface ResolveRelationshipSlugArgs {
+export interface ResolveRelationshipSlugArgs {
   payload: Payload;
   /** The collection the pattern parameter belongs to. */
   config: SanitizedCollectionConfig;
@@ -27,6 +27,5 @@ interface ResolveRelationshipSlugArgs {
  *
  * @param args The Payload instance, the parameter and its raw value.
  */
-declare const resolveRelationshipSlug: (args: ResolveRelationshipSlugArgs) => Promise<string | null>;
-//#endregion
-export { ResolveRelationshipSlugArgs, resolveRelationshipSlug };
+export declare const resolveRelationshipSlug: (args: ResolveRelationshipSlugArgs) => Promise<string | null>;
+//#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@abinnovision/payloadcms-wayfinder",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.6",
   "description": "Editor-authored URL routing for Payload: collection-to-path patterns, document-to-href building, path-to-document resolution and a routing-aware link field.",
   "keywords": [
     "payload",
@@ -78,27 +78,27 @@
   },
   "devDependencies": {
     "@abinnovision/eslint-config-base": "^3.4.2",
-    "@abinnovision/payloadcms-montage": "1.0.0-beta.3",
+    "@abinnovision/payloadcms-montage": "1.0.1-beta.1",
     "@abinnovision/prettier-config": "^2.2.0",
     "@arethetypeswrong/core": "^0.18.5",
     "@lexical/react": "0.41.0",
-    "@payloadcms/db-sqlite": "3.88.0",
-    "@payloadcms/richtext-lexical": "3.88.0",
-    "@payloadcms/ui": "3.88.0",
-    "@swc/core": "^1.16.1",
-    "@types/node": "^26.3.0",
-    "@types/react": "^19.2.18",
-    "@vitest/coverage-v8": "^4.1.10",
-    "eslint": "^10.9.1",
+    "@payloadcms/db-sqlite": "3.89.0",
+    "@payloadcms/richtext-lexical": "3.89.0",
+    "@payloadcms/ui": "3.89.0",
+    "@swc/core": "^1.16.2",
+    "@types/node": "^26.5.1",
+    "@types/react": "^19.3.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "eslint": "^10.10.0",
     "lexical": "0.41.0",
-    "payload": "3.88.0",
+    "payload": "3.89.0",
     "prettier": "^3.9.5",
     "publint": "^0.3.24",
-    "react": "^19.2.8",
-    "tsdown": "^0.22.14",
+    "react": "^19.3.0",
+    "tsdown": "^0.23.0",
     "typescript": "^6.0.3",
-    "unplugin-swc": "^1.5.11",
-    "vitest": "^4.1.10"
+    "unplugin-swc": "^1.6.0",
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "@abinnovision/payloadcms-montage": ">=1.0.0-beta.1",