@opencxh/domain 1.142.0 → 1.145.0

package/dist/platform/routing.d.ts

@@ -8,6 +8,18 @@ export interface RouteDefinition {
     resource: string;
     /** If true, the path must match exactly. */
     exact?: boolean;
+    /**
+     * Fixed props handed to the resource on top of the path parameters.
+     *
+     * Lets one component serve several routes without the viewport having to
+     * remount a different resource per URL — which is what makes navigating
+     * between them flash. Two paths that produce the same parameters (a list and
+     * its `/search` sibling, say) stay distinguishable because the route says
+     * which one it is.
+     *
+     * Path parameters win on a name collision: those come from the URL.
+     */
+    props?: Record<string, string>;
     /**
      * Readable without a session. The shell skips its bounce to the login screen
      * for these paths and renders them without any chrome.
@@ -66,6 +78,8 @@ export interface PublicRoutePattern {
     resource: string;
     /** Absolute pattern, e.g. `/help/:hcSlug/:locale`. */
     pattern: string;
+    /** See {@link RouteDefinition.props}. */
+    props?: Record<string, string>;
 }
 export interface PublicRouteMatch extends PublicRoutePattern {
     params: Record<string, string>;
@@ -74,6 +88,19 @@ export interface PublicRouteMatch extends PublicRoutePattern {
 export declare function publicBasePathFor(app: PublicRouteSource): string;
 /** Every public route across the installed apps, as absolute patterns. */
 export declare function publicRoutePatterns(apps: Iterable<PublicRouteSource>): PublicRoutePattern[];
+/**
+ * Is `a` a more specific pattern than `b`?
+ *
+ * Segment by segment, a literal beats a parameter: `/help/:hc/:locale/search`
+ * has to win over `/help/:hc/:locale/:collection`, or a help centre can never
+ * have a search page. Comparing string lengths would get exactly that case
+ * backwards, since `:collection` is the longer text.
+ *
+ * Exported because the shell asks the same question about `/apps/{name}` routes.
+ * It used to answer it with "whichever matched last", so a declared `/create`
+ * lost to the `/:id` below it — the opposite of what the author wrote down.
+ */
+export declare function isMoreSpecificPattern(a: string, b: string): boolean;
 /**
  * The public route this path lands on, or null.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.142.0",
+  "version": "1.145.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",