snice 7.2.0 → 7.3.0

package/dist/index.iife.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.
@@ -8683,6 +8683,7 @@ var Snice = (function (exports) {
         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
@@ -8773,7 +8774,11 @@ var Snice = (function (exports) {
                     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;
             };
         }
@@ -8781,11 +8786,24 @@ var Snice = (function (exports) {
          * 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':
@@ -8846,7 +8864,9 @@ var Snice = (function (exports) {
             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