snice 7.2.0 → 7.3.0

package/dist/index.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.1.1
+ * snice v7.2.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.
@@ -8680,6 +8680,7 @@ function Router(options) {
     const win = options.window ?? window;
     const doc = options.document ?? document;
     const routes = [];
+    let nextRegistrationOrder = 0;
     let is_sorted = false;
     let placards = []; // Store collected placards
     let _404; // the 404 page
@@ -8770,7 +8771,11 @@ function Router(options) {
                 win.customElements.define(pageOptions.tag, constructor);
             }
             // Register the routes with guards, layout, and placard
-            pageOptions.routes.forEach(route => register(route, pageOptions.tag, pageOptions.transition, pageOptions.guards, pageOptions.layout, pageOptions.placard));
+            pageOptions.routes.forEach(route => {
+                const path = typeof route === 'string' ? route : route.path;
+                const order = typeof route === 'string' ? undefined : route.order;
+                register(path, pageOptions.tag, pageOptions.transition, pageOptions.guards, pageOptions.layout, pageOptions.placard, order);
+            });
             return constructor;
         };
     }
@@ -8778,11 +8783,24 @@ function Router(options) {
      * Registers a new route with the router.
      * @param {string} route - The route path.
      * @param {string} tag - The custom element tag associated with the route.
+     * @param {number} order - Optional lower-first tie-break after specificity.
      * @example
      * register('/custom-route', 'custom-element');
      */
-    function register(route, tag, transition, guards, layout, placard) {
-        routes.push({ route: new Route(route), tag, transition, guards, layout, placard });
+    function register(route, tag, transition, guards, layout, placard, order = 0) {
+        if (!Number.isFinite(order)) {
+            throw new TypeError(`Route order for "${route}" must be a finite number.`);
+        }
+        routes.push({
+            route: new Route(route),
+            tag,
+            transition,
+            guards,
+            layout,
+            placard,
+            order,
+            registrationOrder: nextRegistrationOrder++
+        });
         is_sorted = false;
         switch (route) {
             case '/404':
@@ -8843,7 +8861,9 @@ function Router(options) {
         ensureContextProvider(target);
         const needsSorting = !is_sorted;
         if (needsSorting) {
-            routes.sort((a, b) => routeSpecificity(b.route.spec) - routeSpecificity(a.route.spec));
+            routes.sort((a, b) => routeSpecificity(b.route.spec) - routeSpecificity(a.route.spec)
+                || a.order - b.order
+                || a.registrationOrder - b.registrationOrder);
             is_sorted = true;
         }
         // Collect placards from registered routes