@esmx/router 3.0.0-rc.112 → 3.0.0-rc.116

package/dist/matcher.mjs

@@ -13,6 +13,7 @@ export function createMatcher(routes, compiledRoutes = createRouteMatches(routes
           matches.unshift(item);
           return true;
         }
+        if (item.requireIndex && item.children.length) continue;
         const result = item.match(matchPath);
         if (result) {
           matches.unshift(item);
@@ -30,6 +31,7 @@ export function createMatcher(routes, compiledRoutes = createRouteMatches(routes
 }
 export function createRouteMatches(routes, base = "") {
   return routes.map((route) => {
+    var _a;
     const compilePath = joinPathname(route.path, base);
     return {
       ...route,
@@ -37,6 +39,7 @@ export function createRouteMatches(routes, base = "") {
       match: match(compilePath),
       compile: compile(compilePath),
       meta: route.meta || {},
+      requireIndex: (_a = route.requireIndex) != null ? _a : false,
       children: Array.isArray(route.children) ? createRouteMatches(route.children, compilePath) : []
     };
   });

package/dist/types.d.ts

@@ -64,6 +64,42 @@ export interface RouteConfig {
     beforeLeave?: RouteConfirmHook;
     /** Mark this route as only effective in layer mode */
     layer?: boolean;
+    /**
+     * Require an index child route to match the parent path
+     *
+     * When set to `true`, the parent route will not match its own path
+     * if no child route matches. The parent route requires a `path: ''`
+     * index child route to match the parent path itself.
+     *
+     * - `requireIndex: false` (default): If no child route matches,
+     *   the matcher falls back to matching the parent route itself
+     * - `requireIndex: true`: If no child route matches, the parent
+     *   route is skipped entirely (no fallback to self-match)
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * // requireIndex: true - /A won't match without index child
+     * {
+     *   path: '/A',
+     *   requireIndex: true,
+     *   children: [
+     *     { path: '', component: IndexComponent },  // /A matches this
+     *     { path: 'a', component: AComponent }       // /A/a matches this
+     *   ]
+     * }
+     *
+     * // Default behavior - /A matches even without index child
+     * {
+     *   path: '/A',
+     *   children: [
+     *     { path: 'a', component: AComponent }  // /A/a matches, /A also matches (parent self)
+     *   ]
+     * }
+     * ```
+     */
+    requireIndex?: boolean;
     /**
      * Route override function for hybrid app development
      *
@@ -85,6 +121,8 @@ export interface RouteConfig {
     override?: RouteConfirmHook;
 }
 export interface RouteParsedConfig extends RouteConfig {
+    /** Require an index child route to match the parent path (always has a value after parsing) */
+    requireIndex: boolean;
     compilePath: string;
     children: RouteParsedConfig[];
     match: MatchFunction;

package/package.json

@@ -39,7 +39,7 @@
         "unbuild": "3.6.1",
         "vitest": "3.2.4"
     },
-    "version": "3.0.0-rc.112",
+    "version": "3.0.0-rc.116",
     "type": "module",
     "private": false,
     "exports": {
@@ -58,5 +58,5 @@
         "template",
         "public"
     ],
-    "gitHead": "f59838cc739a87380605820bc8b0b46640a83faa"
+    "gitHead": "3e692857ccb65e7d1fdf689e30eb5d935e8bda77"
 }

package/src/matcher.ts

@@ -28,6 +28,8 @@ export function createMatcher(
                     matches.unshift(item);
                     return true;
                 }
+                // At this point, children exist but none matched — if requireIndex is true, skip self-match
+                if (item.requireIndex && item.children.length) continue;
                 const result = item.match(matchPath);
                 if (result) {
                     matches.unshift(item);
@@ -56,6 +58,7 @@ export function createRouteMatches(
             match: match(compilePath),
             compile: compile(compilePath),
             meta: route.meta || {},
+            requireIndex: route.requireIndex ?? false,
             children: Array.isArray(route.children)
                 ? createRouteMatches(route.children, compilePath)
                 : []

package/src/types.ts

@@ -114,6 +114,43 @@ export interface RouteConfig {
     /** Mark this route as only effective in layer mode */
     layer?: boolean;
 
+    /**
+     * Require an index child route to match the parent path
+     *
+     * When set to `true`, the parent route will not match its own path
+     * if no child route matches. The parent route requires a `path: ''`
+     * index child route to match the parent path itself.
+     *
+     * - `requireIndex: false` (default): If no child route matches,
+     *   the matcher falls back to matching the parent route itself
+     * - `requireIndex: true`: If no child route matches, the parent
+     *   route is skipped entirely (no fallback to self-match)
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * // requireIndex: true - /A won't match without index child
+     * {
+     *   path: '/A',
+     *   requireIndex: true,
+     *   children: [
+     *     { path: '', component: IndexComponent },  // /A matches this
+     *     { path: 'a', component: AComponent }       // /A/a matches this
+     *   ]
+     * }
+     *
+     * // Default behavior - /A matches even without index child
+     * {
+     *   path: '/A',
+     *   children: [
+     *     { path: 'a', component: AComponent }  // /A/a matches, /A also matches (parent self)
+     *   ]
+     * }
+     * ```
+     */
+    requireIndex?: boolean;
+
     /**
      * Route override function for hybrid app development
      *
@@ -136,6 +173,8 @@ export interface RouteConfig {
 }
 
 export interface RouteParsedConfig extends RouteConfig {
+    /** Require an index child route to match the parent path (always has a value after parsing) */
+    requireIndex: boolean;
     compilePath: string;
     children: RouteParsedConfig[];
     match: MatchFunction;

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2020 Esmx Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.