cindel 1.0.3 → 1.0.4

package/dist/client.js

@@ -1748,7 +1748,8 @@ var HMRClient = class {
    * @param {function(string): boolean} [options.filterCold] - Custom cold file logic. Receives `(filePath)`. Combined with `cold` via OR.
    * @param {function(string, string[]): string|null} [options.getOverrideTarget] - Given a changed file, return the path of the original it replaces, or `null`. Receives `(filePath, allFiles)`. When matched, the original is unloaded before the override loads.
    * @param {function(string): void} [options.onFileLoaded] - Called after each file loads or reloads. Receives `(filePath)`.
-   * @param {function(string[]): string[]} [options.sortFiles] - Custom sort for the initial file load order. Default sorts CSS before JS, cold files first.
+   * @param {function(string[]): string[]} [options.sortFiles] - Custom sort for the initial file load order. When provided, replaces `defaultSortFiles` entirely and `loadOrder` is ignored.
+   * @param {Array<Function>} [options.loadOrder] - Stages prepended before the built-in sort (CSS-first, cold-first, alphabetical). One argument: return true to load that file first. Two arguments: works like a normal sort callback.
    */
   constructor(options) {
     const opts = typeof options === "object" && !Array.isArray(options) ? options : {};
@@ -1769,6 +1770,7 @@ var HMRClient = class {
     this.allFiles = [];
     this.getOverrideTarget = opts.getOverrideTarget || null;
     this.onFileLoaded = opts.onFileLoaded || null;
+    this.loadOrder = opts.loadOrder || [];
     this.sortFiles = opts.sortFiles || this.defaultSortFiles.bind(this);
     this.socket = null;
     this.reconnectAttempts = 0;
@@ -1796,16 +1798,18 @@ var HMRClient = class {
   }
   defaultSortFiles(files) {
     const coldSet = new Set(files.filter((f) => this.isColdFile(f)));
+    const builtinStages = [
+      (f) => f.endsWith(".css"),
+      (f) => coldSet.has(f),
+      (a, b) => a.localeCompare(b)
+    ];
+    const stages = [...this.loadOrder, ...builtinStages];
     return [...files].sort((a, b) => {
-      const aIsCSS = a.endsWith(".css");
-      const bIsCSS = b.endsWith(".css");
-      if (aIsCSS && !bIsCSS) return -1;
-      if (!aIsCSS && bIsCSS) return 1;
-      const coldA = coldSet.has(a);
-      const coldB = coldSet.has(b);
-      if (coldA && !coldB) return -1;
-      if (!coldA && coldB) return 1;
-      return a.localeCompare(b);
+      for (const stage of stages) {
+        const result = stage.length === 2 ? stage(a, b) : stage(b) - stage(a);
+        if (result !== 0) return result;
+      }
+      return 0;
     });
   }
   makeFilter(patterns, callback) {