@bradleyhodges/addresskit 2.2.3 → 2.4.4

package/dist/cli.js

@@ -39,7 +39,7 @@ var version;
 var init_version = __esm({
   "packages/core/version.ts"() {
     "use strict";
-    version = "2.2.3";
+    version = "2.4.4";
   }
 });
 
@@ -3329,8 +3329,8 @@ var require_main = __commonJS({
         const shortPaths = [];
         for (const filePath of optionPaths) {
           try {
-            const relative = path5.relative(process.cwd(), filePath);
-            shortPaths.push(relative);
+            const relative2 = path5.relative(process.cwd(), filePath);
+            shortPaths.push(relative2);
           } catch (e) {
             if (debug8) {
               _debug(`Failed to load ${filePath} ${e.message}`);
@@ -7469,7 +7469,7 @@ var require_buffer_list = __commonJS({
         }
       }, {
         key: "join",
-        value: function join2(s) {
+        value: function join3(s) {
           if (this.length === 0) return "";
           var p = this.head;
           var ret = "" + p.data;
@@ -24729,6 +24729,8 @@ var require_elasticsearch = __commonJS({
     exports2.VERBOSE = exports2.ELASTIC_PORT = void 0;
     exports2.dropIndex = dropIndex;
     exports2.initIndex = initIndex3;
+    exports2.dropLocalityIndex = dropLocalityIndex;
+    exports2.initLocalityIndex = initLocalityIndex2;
     exports2.esConnect = esConnect3;
     var opensearch_1 = require_opensearch();
     var debug_1 = __importDefault3(require_src());
@@ -24736,6 +24738,7 @@ var require_elasticsearch = __commonJS({
     var logger8 = (0, debug_1.default)("api");
     var error8 = (0, debug_1.default)("error");
     var ES_INDEX_NAME2 = process.env.ES_INDEX_NAME ?? "addresskit";
+    var ES_LOCALITY_INDEX_NAME2 = process.env.ES_LOCALITY_INDEX_NAME ?? "addresskit-localities";
     exports2.ELASTIC_PORT = Number.parseInt(process.env.ELASTIC_PORT ?? "9200", 10);
     var ELASTIC_HOST = process.env.ELASTIC_HOST ?? "127.0.0.1";
     var ELASTIC_USERNAME = process.env.ELASTIC_USERNAME ?? void 0;
@@ -24872,6 +24875,163 @@ var require_elasticsearch = __commonJS({
       });
       if (exports2.VERBOSE)
         logger8(`indexGetResult:
+${JSON.stringify(indexGetResult, void 0, 2)}`);
+    }
+    async function dropLocalityIndex(esClient) {
+      const exists = await esClient.indices.exists({
+        index: ES_LOCALITY_INDEX_NAME2
+      });
+      if (exists.body === true) {
+        const deleteIndexResult = await esClient.indices.delete({
+          index: ES_LOCALITY_INDEX_NAME2
+        });
+        if (exports2.VERBOSE)
+          logger8({ deleteIndexResult });
+      }
+      const postExists = await esClient.indices.exists({
+        index: ES_LOCALITY_INDEX_NAME2
+      });
+      if (exports2.VERBOSE)
+        logger8("locality index exists:", postExists);
+    }
+    async function initLocalityIndex2(esClient, clear) {
+      if (clear)
+        await dropLocalityIndex(esClient);
+      const exists = await esClient.indices.exists({
+        index: ES_LOCALITY_INDEX_NAME2
+      });
+      if (exports2.VERBOSE)
+        logger8("locality index exists:", exists.body);
+      const indexBody = {
+        settings: {
+          index: {
+            analysis: {
+              filter: {
+                comma_stripper: {
+                  type: "pattern_replace",
+                  pattern: ",",
+                  replacement: ""
+                }
+              },
+              analyzer: {
+                locality_analyzer: {
+                  tokenizer: "whitecomma",
+                  filter: [
+                    "uppercase",
+                    "asciifolding",
+                    "comma_stripper",
+                    "trim"
+                  ]
+                }
+              },
+              tokenizer: {
+                whitecomma: {
+                  type: "pattern",
+                  pattern: "[\\W,]+",
+                  lowercase: false
+                }
+              }
+            }
+          }
+        },
+        aliases: {},
+        mappings: {
+          properties: {
+            // Display string for autocomplete (e.g., "SYDNEY NSW 2000")
+            display: {
+              type: "text",
+              analyzer: "locality_analyzer",
+              fields: {
+                raw: {
+                  type: "keyword"
+                }
+              }
+            },
+            // Locality name for searching
+            name: {
+              type: "text",
+              analyzer: "locality_analyzer",
+              fields: {
+                raw: {
+                  type: "keyword"
+                }
+              }
+            },
+            // State abbreviation for filtering
+            stateAbbreviation: {
+              type: "keyword"
+            },
+            // State full name
+            stateName: {
+              type: "keyword"
+            },
+            // Primary postcode
+            postcode: {
+              type: "keyword"
+            },
+            // All postcodes associated with this locality
+            postcodes: {
+              type: "keyword"
+            },
+            // Locality class code
+            classCode: {
+              type: "keyword"
+            },
+            // Locality class name
+            className: {
+              type: "keyword"
+            },
+            // Original G-NAF locality PID
+            localityPid: {
+              type: "keyword"
+            }
+          }
+        }
+      };
+      if (exists.body !== true) {
+        if (exports2.VERBOSE)
+          logger8(`creating locality index: ${ES_LOCALITY_INDEX_NAME2}`);
+        const indexCreateResult = await esClient.indices.create({
+          index: ES_LOCALITY_INDEX_NAME2,
+          body: indexBody
+        });
+        if (exports2.VERBOSE)
+          logger8({ indexCreateResult });
+      } else {
+        const indexCloseResult = await esClient.indices.close({
+          index: ES_LOCALITY_INDEX_NAME2
+        });
+        if (exports2.VERBOSE)
+          logger8({ indexCloseResult });
+        const indexPutSettingsResult = await esClient.indices.putSettings({
+          index: ES_LOCALITY_INDEX_NAME2,
+          body: indexBody
+        });
+        if (exports2.VERBOSE)
+          logger8({ indexPutSettingsResult });
+        const indexPutMappingResult = await esClient.indices.putMapping({
+          index: ES_LOCALITY_INDEX_NAME2,
+          body: indexBody.mappings
+        });
+        if (exports2.VERBOSE)
+          logger8({ indexPutMappingResult });
+        const indexOpenResult = await esClient.indices.open({
+          index: ES_LOCALITY_INDEX_NAME2
+        });
+        if (exports2.VERBOSE)
+          logger8({ indexOpenResult });
+        const refreshResult = await esClient.indices.refresh({
+          index: ES_LOCALITY_INDEX_NAME2
+        });
+        if (exports2.VERBOSE)
+          logger8({ refreshResult });
+      }
+      const indexGetResult = await esClient.indices.get({
+        index: ES_LOCALITY_INDEX_NAME2,
+        include_defaults: true
+      });
+      if (exports2.VERBOSE)
+        logger8(`localityIndexGetResult:
 ${JSON.stringify(indexGetResult, void 0, 2)}`);
     }
     async function esConnect3(esport = exports2.ELASTIC_PORT, eshost = ELASTIC_HOST, interval = 1e3, timeout = 0) {
@@ -31999,10 +32159,10 @@ var require_symlink = __commonJS({
       pathExists(dstpath, (err, destinationExists) => {
         if (err) return callback(err);
         if (destinationExists) return callback(null);
-        symlinkPaths(srcpath, dstpath, (err2, relative) => {
+        symlinkPaths(srcpath, dstpath, (err2, relative2) => {
           if (err2) return callback(err2);
-          srcpath = relative.toDst;
-          symlinkType(relative.toCwd, type, (err3, type2) => {
+          srcpath = relative2.toDst;
+          symlinkType(relative2.toCwd, type, (err3, type2) => {
             if (err3) return callback(err3);
             const dir = path5.dirname(dstpath);
             pathExists(dir, (err4, dirExists) => {
@@ -32022,9 +32182,9 @@ var require_symlink = __commonJS({
       type = typeof type === "function" ? false : type;
       const destinationExists = fs5.existsSync(dstpath);
       if (destinationExists) return void 0;
-      const relative = symlinkPathsSync(srcpath, dstpath);
-      srcpath = relative.toDst;
-      type = symlinkTypeSync(relative.toCwd, type);
+      const relative2 = symlinkPathsSync(srcpath, dstpath);
+      srcpath = relative2.toDst;
+      type = symlinkTypeSync(relative2.toCwd, type);
       const dir = path5.dirname(dstpath);
       const exists = fs5.existsSync(dir);
       if (exists) return fs5.symlinkSync(srcpath, dstpath, type);
@@ -32469,2247 +32629,6 @@ var require_directory_exists = __commonJS({
   }
 });
 
-// node_modules/.pnpm/fs.realpath@1.0.0/node_modules/fs.realpath/old.js
-var require_old = __commonJS({
-  "node_modules/.pnpm/fs.realpath@1.0.0/node_modules/fs.realpath/old.js"(exports2) {
-    var pathModule = require("path");
-    var isWindows = process.platform === "win32";
-    var fs5 = require("fs");
-    var DEBUG = process.env.NODE_DEBUG && /fs/.test(process.env.NODE_DEBUG);
-    function rethrow() {
-      var callback;
-      if (DEBUG) {
-        var backtrace = new Error();
-        callback = debugCallback;
-      } else
-        callback = missingCallback;
-      return callback;
-      function debugCallback(err) {
-        if (err) {
-          backtrace.message = err.message;
-          err = backtrace;
-          missingCallback(err);
-        }
-      }
-      function missingCallback(err) {
-        if (err) {
-          if (process.throwDeprecation)
-            throw err;
-          else if (!process.noDeprecation) {
-            var msg = "fs: missing callback " + (err.stack || err.message);
-            if (process.traceDeprecation)
-              console.trace(msg);
-            else
-              console.error(msg);
-          }
-        }
-      }
-    }
-    function maybeCallback(cb) {
-      return typeof cb === "function" ? cb : rethrow();
-    }
-    var normalize = pathModule.normalize;
-    if (isWindows) {
-      nextPartRe = /(.*?)(?:[\/\\]+|$)/g;
-    } else {
-      nextPartRe = /(.*?)(?:[\/]+|$)/g;
-    }
-    var nextPartRe;
-    if (isWindows) {
-      splitRootRe = /^(?:[a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/][^\\\/]+)?[\\\/]*/;
-    } else {
-      splitRootRe = /^[\/]*/;
-    }
-    var splitRootRe;
-    exports2.realpathSync = function realpathSync(p, cache2) {
-      p = pathModule.resolve(p);
-      if (cache2 && Object.prototype.hasOwnProperty.call(cache2, p)) {
-        return cache2[p];
-      }
-      var original = p, seenLinks = {}, knownHard = {};
-      var pos;
-      var current;
-      var base;
-      var previous;
-      start();
-      function start() {
-        var m = splitRootRe.exec(p);
-        pos = m[0].length;
-        current = m[0];
-        base = m[0];
-        previous = "";
-        if (isWindows && !knownHard[base]) {
-          fs5.lstatSync(base);
-          knownHard[base] = true;
-        }
-      }
-      while (pos < p.length) {
-        nextPartRe.lastIndex = pos;
-        var result = nextPartRe.exec(p);
-        previous = current;
-        current += result[0];
-        base = previous + result[1];
-        pos = nextPartRe.lastIndex;
-        if (knownHard[base] || cache2 && cache2[base] === base) {
-          continue;
-        }
-        var resolvedLink;
-        if (cache2 && Object.prototype.hasOwnProperty.call(cache2, base)) {
-          resolvedLink = cache2[base];
-        } else {
-          var stat2 = fs5.lstatSync(base);
-          if (!stat2.isSymbolicLink()) {
-            knownHard[base] = true;
-            if (cache2) cache2[base] = base;
-            continue;
-          }
-          var linkTarget = null;
-          if (!isWindows) {
-            var id = stat2.dev.toString(32) + ":" + stat2.ino.toString(32);
-            if (seenLinks.hasOwnProperty(id)) {
-              linkTarget = seenLinks[id];
-            }
-          }
-          if (linkTarget === null) {
-            fs5.statSync(base);
-            linkTarget = fs5.readlinkSync(base);
-          }
-          resolvedLink = pathModule.resolve(previous, linkTarget);
-          if (cache2) cache2[base] = resolvedLink;
-          if (!isWindows) seenLinks[id] = linkTarget;
-        }
-        p = pathModule.resolve(resolvedLink, p.slice(pos));
-        start();
-      }
-      if (cache2) cache2[original] = p;
-      return p;
-    };
-    exports2.realpath = function realpath(p, cache2, cb) {
-      if (typeof cb !== "function") {
-        cb = maybeCallback(cache2);
-        cache2 = null;
-      }
-      p = pathModule.resolve(p);
-      if (cache2 && Object.prototype.hasOwnProperty.call(cache2, p)) {
-        return process.nextTick(cb.bind(null, null, cache2[p]));
-      }
-      var original = p, seenLinks = {}, knownHard = {};
-      var pos;
-      var current;
-      var base;
-      var previous;
-      start();
-      function start() {
-        var m = splitRootRe.exec(p);
-        pos = m[0].length;
-        current = m[0];
-        base = m[0];
-        previous = "";
-        if (isWindows && !knownHard[base]) {
-          fs5.lstat(base, function(err) {
-            if (err) return cb(err);
-            knownHard[base] = true;
-            LOOP();
-          });
-        } else {
-          process.nextTick(LOOP);
-        }
-      }
-      function LOOP() {
-        if (pos >= p.length) {
-          if (cache2) cache2[original] = p;
-          return cb(null, p);
-        }
-        nextPartRe.lastIndex = pos;
-        var result = nextPartRe.exec(p);
-        previous = current;
-        current += result[0];
-        base = previous + result[1];
-        pos = nextPartRe.lastIndex;
-        if (knownHard[base] || cache2 && cache2[base] === base) {
-          return process.nextTick(LOOP);
-        }
-        if (cache2 && Object.prototype.hasOwnProperty.call(cache2, base)) {
-          return gotResolvedLink(cache2[base]);
-        }
-        return fs5.lstat(base, gotStat);
-      }
-      function gotStat(err, stat2) {
-        if (err) return cb(err);
-        if (!stat2.isSymbolicLink()) {
-          knownHard[base] = true;
-          if (cache2) cache2[base] = base;
-          return process.nextTick(LOOP);
-        }
-        if (!isWindows) {
-          var id = stat2.dev.toString(32) + ":" + stat2.ino.toString(32);
-          if (seenLinks.hasOwnProperty(id)) {
-            return gotTarget(null, seenLinks[id], base);
-          }
-        }
-        fs5.stat(base, function(err2) {
-          if (err2) return cb(err2);
-          fs5.readlink(base, function(err3, target) {
-            if (!isWindows) seenLinks[id] = target;
-            gotTarget(err3, target);
-          });
-        });
-      }
-      function gotTarget(err, target, base2) {
-        if (err) return cb(err);
-        var resolvedLink = pathModule.resolve(previous, target);
-        if (cache2) cache2[base2] = resolvedLink;
-        gotResolvedLink(resolvedLink);
-      }
-      function gotResolvedLink(resolvedLink) {
-        p = pathModule.resolve(resolvedLink, p.slice(pos));
-        start();
-      }
-    };
-  }
-});
-
-// node_modules/.pnpm/fs.realpath@1.0.0/node_modules/fs.realpath/index.js
-var require_fs2 = __commonJS({
-  "node_modules/.pnpm/fs.realpath@1.0.0/node_modules/fs.realpath/index.js"(exports2, module2) {
-    module2.exports = realpath;
-    realpath.realpath = realpath;
-    realpath.sync = realpathSync;
-    realpath.realpathSync = realpathSync;
-    realpath.monkeypatch = monkeypatch;
-    realpath.unmonkeypatch = unmonkeypatch;
-    var fs5 = require("fs");
-    var origRealpath = fs5.realpath;
-    var origRealpathSync = fs5.realpathSync;
-    var version2 = process.version;
-    var ok = /^v[0-5]\./.test(version2);
-    var old = require_old();
-    function newError(er) {
-      return er && er.syscall === "realpath" && (er.code === "ELOOP" || er.code === "ENOMEM" || er.code === "ENAMETOOLONG");
-    }
-    function realpath(p, cache2, cb) {
-      if (ok) {
-        return origRealpath(p, cache2, cb);
-      }
-      if (typeof cache2 === "function") {
-        cb = cache2;
-        cache2 = null;
-      }
-      origRealpath(p, cache2, function(er, result) {
-        if (newError(er)) {
-          old.realpath(p, cache2, cb);
-        } else {
-          cb(er, result);
-        }
-      });
-    }
-    function realpathSync(p, cache2) {
-      if (ok) {
-        return origRealpathSync(p, cache2);
-      }
-      try {
-        return origRealpathSync(p, cache2);
-      } catch (er) {
-        if (newError(er)) {
-          return old.realpathSync(p, cache2);
-        } else {
-          throw er;
-        }
-      }
-    }
-    function monkeypatch() {
-      fs5.realpath = realpath;
-      fs5.realpathSync = realpathSync;
-    }
-    function unmonkeypatch() {
-      fs5.realpath = origRealpath;
-      fs5.realpathSync = origRealpathSync;
-    }
-  }
-});
-
-// node_modules/.pnpm/concat-map@0.0.1/node_modules/concat-map/index.js
-var require_concat_map = __commonJS({
-  "node_modules/.pnpm/concat-map@0.0.1/node_modules/concat-map/index.js"(exports2, module2) {
-    module2.exports = function(xs, fn) {
-      var res = [];
-      for (var i = 0; i < xs.length; i++) {
-        var x = fn(xs[i], i);
-        if (isArray(x)) res.push.apply(res, x);
-        else res.push(x);
-      }
-      return res;
-    };
-    var isArray = Array.isArray || function(xs) {
-      return Object.prototype.toString.call(xs) === "[object Array]";
-    };
-  }
-});
-
-// node_modules/.pnpm/balanced-match@1.0.2/node_modules/balanced-match/index.js
-var require_balanced_match = __commonJS({
-  "node_modules/.pnpm/balanced-match@1.0.2/node_modules/balanced-match/index.js"(exports2, module2) {
-    "use strict";
-    module2.exports = balanced;
-    function balanced(a, b, str) {
-      if (a instanceof RegExp) a = maybeMatch(a, str);
-      if (b instanceof RegExp) b = maybeMatch(b, str);
-      var r = range(a, b, str);
-      return r && {
-        start: r[0],
-        end: r[1],
-        pre: str.slice(0, r[0]),
-        body: str.slice(r[0] + a.length, r[1]),
-        post: str.slice(r[1] + b.length)
-      };
-    }
-    function maybeMatch(reg, str) {
-      var m = str.match(reg);
-      return m ? m[0] : null;
-    }
-    balanced.range = range;
-    function range(a, b, str) {
-      var begs, beg, left, right, result;
-      var ai = str.indexOf(a);
-      var bi = str.indexOf(b, ai + 1);
-      var i = ai;
-      if (ai >= 0 && bi > 0) {
-        if (a === b) {
-          return [ai, bi];
-        }
-        begs = [];
-        left = str.length;
-        while (i >= 0 && !result) {
-          if (i == ai) {
-            begs.push(i);
-            ai = str.indexOf(a, i + 1);
-          } else if (begs.length == 1) {
-            result = [begs.pop(), bi];
-          } else {
-            beg = begs.pop();
-            if (beg < left) {
-              left = beg;
-              right = bi;
-            }
-            bi = str.indexOf(b, i + 1);
-          }
-          i = ai < bi && ai >= 0 ? ai : bi;
-        }
-        if (begs.length) {
-          result = [left, right];
-        }
-      }
-      return result;
-    }
-  }
-});
-
-// node_modules/.pnpm/brace-expansion@1.1.12/node_modules/brace-expansion/index.js
-var require_brace_expansion = __commonJS({
-  "node_modules/.pnpm/brace-expansion@1.1.12/node_modules/brace-expansion/index.js"(exports2, module2) {
-    var concatMap = require_concat_map();
-    var balanced = require_balanced_match();
-    module2.exports = expandTop;
-    var escSlash = "\0SLASH" + Math.random() + "\0";
-    var escOpen = "\0OPEN" + Math.random() + "\0";
-    var escClose = "\0CLOSE" + Math.random() + "\0";
-    var escComma = "\0COMMA" + Math.random() + "\0";
-    var escPeriod = "\0PERIOD" + Math.random() + "\0";
-    function numeric(str) {
-      return parseInt(str, 10) == str ? parseInt(str, 10) : str.charCodeAt(0);
-    }
-    function escapeBraces(str) {
-      return str.split("\\\\").join(escSlash).split("\\{").join(escOpen).split("\\}").join(escClose).split("\\,").join(escComma).split("\\.").join(escPeriod);
-    }
-    function unescapeBraces(str) {
-      return str.split(escSlash).join("\\").split(escOpen).join("{").split(escClose).join("}").split(escComma).join(",").split(escPeriod).join(".");
-    }
-    function parseCommaParts(str) {
-      if (!str)
-        return [""];
-      var parts = [];
-      var m = balanced("{", "}", str);
-      if (!m)
-        return str.split(",");
-      var pre = m.pre;
-      var body = m.body;
-      var post = m.post;
-      var p = pre.split(",");
-      p[p.length - 1] += "{" + body + "}";
-      var postParts = parseCommaParts(post);
-      if (post.length) {
-        p[p.length - 1] += postParts.shift();
-        p.push.apply(p, postParts);
-      }
-      parts.push.apply(parts, p);
-      return parts;
-    }
-    function expandTop(str) {
-      if (!str)
-        return [];
-      if (str.substr(0, 2) === "{}") {
-        str = "\\{\\}" + str.substr(2);
-      }
-      return expand(escapeBraces(str), true).map(unescapeBraces);
-    }
-    function embrace(str) {
-      return "{" + str + "}";
-    }
-    function isPadded(el) {
-      return /^-?0\d/.test(el);
-    }
-    function lte(i, y) {
-      return i <= y;
-    }
-    function gte(i, y) {
-      return i >= y;
-    }
-    function expand(str, isTop) {
-      var expansions = [];
-      var m = balanced("{", "}", str);
-      if (!m || /\$$/.test(m.pre)) return [str];
-      var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body);
-      var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body);
-      var isSequence = isNumericSequence || isAlphaSequence;
-      var isOptions = m.body.indexOf(",") >= 0;
-      if (!isSequence && !isOptions) {
-        if (m.post.match(/,(?!,).*\}/)) {
-          str = m.pre + "{" + m.body + escClose + m.post;
-          return expand(str);
-        }
-        return [str];
-      }
-      var n;
-      if (isSequence) {
-        n = m.body.split(/\.\./);
-      } else {
-        n = parseCommaParts(m.body);
-        if (n.length === 1) {
-          n = expand(n[0], false).map(embrace);
-          if (n.length === 1) {
-            var post = m.post.length ? expand(m.post, false) : [""];
-            return post.map(function(p) {
-              return m.pre + n[0] + p;
-            });
-          }
-        }
-      }
-      var pre = m.pre;
-      var post = m.post.length ? expand(m.post, false) : [""];
-      var N;
-      if (isSequence) {
-        var x = numeric(n[0]);
-        var y = numeric(n[1]);
-        var width = Math.max(n[0].length, n[1].length);
-        var incr = n.length == 3 ? Math.abs(numeric(n[2])) : 1;
-        var test = lte;
-        var reverse = y < x;
-        if (reverse) {
-          incr *= -1;
-          test = gte;
-        }
-        var pad = n.some(isPadded);
-        N = [];
-        for (var i = x; test(i, y); i += incr) {
-          var c;
-          if (isAlphaSequence) {
-            c = String.fromCharCode(i);
-            if (c === "\\")
-              c = "";
-          } else {
-            c = String(i);
-            if (pad) {
-              var need = width - c.length;
-              if (need > 0) {
-                var z = new Array(need + 1).join("0");
-                if (i < 0)
-                  c = "-" + z + c.slice(1);
-                else
-                  c = z + c;
-              }
-            }
-          }
-          N.push(c);
-        }
-      } else {
-        N = concatMap(n, function(el) {
-          return expand(el, false);
-        });
-      }
-      for (var j = 0; j < N.length; j++) {
-        for (var k = 0; k < post.length; k++) {
-          var expansion = pre + N[j] + post[k];
-          if (!isTop || isSequence || expansion)
-            expansions.push(expansion);
-        }
-      }
-      return expansions;
-    }
-  }
-});
-
-// node_modules/.pnpm/minimatch@3.1.2/node_modules/minimatch/minimatch.js
-var require_minimatch = __commonJS({
-  "node_modules/.pnpm/minimatch@3.1.2/node_modules/minimatch/minimatch.js"(exports2, module2) {
-    module2.exports = minimatch;
-    minimatch.Minimatch = Minimatch;
-    var path5 = (function() {
-      try {
-        return require("path");
-      } catch (e) {
-      }
-    })() || {
-      sep: "/"
-    };
-    minimatch.sep = path5.sep;
-    var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {};
-    var expand = require_brace_expansion();
-    var plTypes = {
-      "!": { open: "(?:(?!(?:", close: "))[^/]*?)" },
-      "?": { open: "(?:", close: ")?" },
-      "+": { open: "(?:", close: ")+" },
-      "*": { open: "(?:", close: ")*" },
-      "@": { open: "(?:", close: ")" }
-    };
-    var qmark = "[^/]";
-    var star = qmark + "*?";
-    var twoStarDot = "(?:(?!(?:\\/|^)(?:\\.{1,2})($|\\/)).)*?";
-    var twoStarNoDot = "(?:(?!(?:\\/|^)\\.).)*?";
-    var reSpecials = charSet("().*{}+?[]^$\\!");
-    function charSet(s) {
-      return s.split("").reduce(function(set, c) {
-        set[c] = true;
-        return set;
-      }, {});
-    }
-    var slashSplit = /\/+/;
-    minimatch.filter = filter;
-    function filter(pattern, options) {
-      options = options || {};
-      return function(p, i, list) {
-        return minimatch(p, pattern, options);
-      };
-    }
-    function ext(a, b) {
-      b = b || {};
-      var t = {};
-      Object.keys(a).forEach(function(k) {
-        t[k] = a[k];
-      });
-      Object.keys(b).forEach(function(k) {
-        t[k] = b[k];
-      });
-      return t;
-    }
-    minimatch.defaults = function(def) {
-      if (!def || typeof def !== "object" || !Object.keys(def).length) {
-        return minimatch;
-      }
-      var orig = minimatch;
-      var m = function minimatch2(p, pattern, options) {
-        return orig(p, pattern, ext(def, options));
-      };
-      m.Minimatch = function Minimatch2(pattern, options) {
-        return new orig.Minimatch(pattern, ext(def, options));
-      };
-      m.Minimatch.defaults = function defaults(options) {
-        return orig.defaults(ext(def, options)).Minimatch;
-      };
-      m.filter = function filter2(pattern, options) {
-        return orig.filter(pattern, ext(def, options));
-      };
-      m.defaults = function defaults(options) {
-        return orig.defaults(ext(def, options));
-      };
-      m.makeRe = function makeRe2(pattern, options) {
-        return orig.makeRe(pattern, ext(def, options));
-      };
-      m.braceExpand = function braceExpand2(pattern, options) {
-        return orig.braceExpand(pattern, ext(def, options));
-      };
-      m.match = function(list, pattern, options) {
-        return orig.match(list, pattern, ext(def, options));
-      };
-      return m;
-    };
-    Minimatch.defaults = function(def) {
-      return minimatch.defaults(def).Minimatch;
-    };
-    function minimatch(p, pattern, options) {
-      assertValidPattern(pattern);
-      if (!options) options = {};
-      if (!options.nocomment && pattern.charAt(0) === "#") {
-        return false;
-      }
-      return new Minimatch(pattern, options).match(p);
-    }
-    function Minimatch(pattern, options) {
-      if (!(this instanceof Minimatch)) {
-        return new Minimatch(pattern, options);
-      }
-      assertValidPattern(pattern);
-      if (!options) options = {};
-      pattern = pattern.trim();
-      if (!options.allowWindowsEscape && path5.sep !== "/") {
-        pattern = pattern.split(path5.sep).join("/");
-      }
-      this.options = options;
-      this.set = [];
-      this.pattern = pattern;
-      this.regexp = null;
-      this.negate = false;
-      this.comment = false;
-      this.empty = false;
-      this.partial = !!options.partial;
-      this.make();
-    }
-    Minimatch.prototype.debug = function() {
-    };
-    Minimatch.prototype.make = make;
-    function make() {
-      var pattern = this.pattern;
-      var options = this.options;
-      if (!options.nocomment && pattern.charAt(0) === "#") {
-        this.comment = true;
-        return;
-      }
-      if (!pattern) {
-        this.empty = true;
-        return;
-      }
-      this.parseNegate();
-      var set = this.globSet = this.braceExpand();
-      if (options.debug) this.debug = function debug8() {
-        console.error.apply(console, arguments);
-      };
-      this.debug(this.pattern, set);
-      set = this.globParts = set.map(function(s) {
-        return s.split(slashSplit);
-      });
-      this.debug(this.pattern, set);
-      set = set.map(function(s, si, set2) {
-        return s.map(this.parse, this);
-      }, this);
-      this.debug(this.pattern, set);
-      set = set.filter(function(s) {
-        return s.indexOf(false) === -1;
-      });
-      this.debug(this.pattern, set);
-      this.set = set;
-    }
-    Minimatch.prototype.parseNegate = parseNegate;
-    function parseNegate() {
-      var pattern = this.pattern;
-      var negate = false;
-      var options = this.options;
-      var negateOffset = 0;
-      if (options.nonegate) return;
-      for (var i = 0, l = pattern.length; i < l && pattern.charAt(i) === "!"; i++) {
-        negate = !negate;
-        negateOffset++;
-      }
-      if (negateOffset) this.pattern = pattern.substr(negateOffset);
-      this.negate = negate;
-    }
-    minimatch.braceExpand = function(pattern, options) {
-      return braceExpand(pattern, options);
-    };
-    Minimatch.prototype.braceExpand = braceExpand;
-    function braceExpand(pattern, options) {
-      if (!options) {
-        if (this instanceof Minimatch) {
-          options = this.options;
-        } else {
-          options = {};
-        }
-      }
-      pattern = typeof pattern === "undefined" ? this.pattern : pattern;
-      assertValidPattern(pattern);
-      if (options.nobrace || !/\{(?:(?!\{).)*\}/.test(pattern)) {
-        return [pattern];
-      }
-      return expand(pattern);
-    }
-    var MAX_PATTERN_LENGTH = 1024 * 64;
-    var assertValidPattern = function(pattern) {
-      if (typeof pattern !== "string") {
-        throw new TypeError("invalid pattern");
-      }
-      if (pattern.length > MAX_PATTERN_LENGTH) {
-        throw new TypeError("pattern is too long");
-      }
-    };
-    Minimatch.prototype.parse = parse3;
-    var SUBPARSE = {};
-    function parse3(pattern, isSub) {
-      assertValidPattern(pattern);
-      var options = this.options;
-      if (pattern === "**") {
-        if (!options.noglobstar)
-          return GLOBSTAR;
-        else
-          pattern = "*";
-      }
-      if (pattern === "") return "";
-      var re = "";
-      var hasMagic = !!options.nocase;
-      var escaping = false;
-      var patternListStack = [];
-      var negativeLists = [];
-      var stateChar;
-      var inClass = false;
-      var reClassStart = -1;
-      var classStart = -1;
-      var patternStart = pattern.charAt(0) === "." ? "" : options.dot ? "(?!(?:^|\\/)\\.{1,2}(?:$|\\/))" : "(?!\\.)";
-      var self2 = this;
-      function clearStateChar() {
-        if (stateChar) {
-          switch (stateChar) {
-            case "*":
-              re += star;
-              hasMagic = true;
-              break;
-            case "?":
-              re += qmark;
-              hasMagic = true;
-              break;
-            default:
-              re += "\\" + stateChar;
-              break;
-          }
-          self2.debug("clearStateChar %j %j", stateChar, re);
-          stateChar = false;
-        }
-      }
-      for (var i = 0, len = pattern.length, c; i < len && (c = pattern.charAt(i)); i++) {
-        this.debug("%s	%s %s %j", pattern, i, re, c);
-        if (escaping && reSpecials[c]) {
-          re += "\\" + c;
-          escaping = false;
-          continue;
-        }
-        switch (c) {
-          /* istanbul ignore next */
-          case "/": {
-            return false;
-          }
-          case "\\":
-            clearStateChar();
-            escaping = true;
-            continue;
-          // the various stateChar values
-          // for the "extglob" stuff.
-          case "?":
-          case "*":
-          case "+":
-          case "@":
-          case "!":
-            this.debug("%s	%s %s %j <-- stateChar", pattern, i, re, c);
-            if (inClass) {
-              this.debug("  in class");
-              if (c === "!" && i === classStart + 1) c = "^";
-              re += c;
-              continue;
-            }
-            self2.debug("call clearStateChar %j", stateChar);
-            clearStateChar();
-            stateChar = c;
-            if (options.noext) clearStateChar();
-            continue;
-          case "(":
-            if (inClass) {
-              re += "(";
-              continue;
-            }
-            if (!stateChar) {
-              re += "\\(";
-              continue;
-            }
-            patternListStack.push({
-              type: stateChar,
-              start: i - 1,
-              reStart: re.length,
-              open: plTypes[stateChar].open,
-              close: plTypes[stateChar].close
-            });
-            re += stateChar === "!" ? "(?:(?!(?:" : "(?:";
-            this.debug("plType %j %j", stateChar, re);
-            stateChar = false;
-            continue;
-          case ")":
-            if (inClass || !patternListStack.length) {
-              re += "\\)";
-              continue;
-            }
-            clearStateChar();
-            hasMagic = true;
-            var pl = patternListStack.pop();
-            re += pl.close;
-            if (pl.type === "!") {
-              negativeLists.push(pl);
-            }
-            pl.reEnd = re.length;
-            continue;
-          case "|":
-            if (inClass || !patternListStack.length || escaping) {
-              re += "\\|";
-              escaping = false;
-              continue;
-            }
-            clearStateChar();
-            re += "|";
-            continue;
-          // these are mostly the same in regexp and glob
-          case "[":
-            clearStateChar();
-            if (inClass) {
-              re += "\\" + c;
-              continue;
-            }
-            inClass = true;
-            classStart = i;
-            reClassStart = re.length;
-            re += c;
-            continue;
-          case "]":
-            if (i === classStart + 1 || !inClass) {
-              re += "\\" + c;
-              escaping = false;
-              continue;
-            }
-            var cs = pattern.substring(classStart + 1, i);
-            try {
-              RegExp("[" + cs + "]");
-            } catch (er) {
-              var sp = this.parse(cs, SUBPARSE);
-              re = re.substr(0, reClassStart) + "\\[" + sp[0] + "\\]";
-              hasMagic = hasMagic || sp[1];
-              inClass = false;
-              continue;
-            }
-            hasMagic = true;
-            inClass = false;
-            re += c;
-            continue;
-          default:
-            clearStateChar();
-            if (escaping) {
-              escaping = false;
-            } else if (reSpecials[c] && !(c === "^" && inClass)) {
-              re += "\\";
-            }
-            re += c;
-        }
-      }
-      if (inClass) {
-        cs = pattern.substr(classStart + 1);
-        sp = this.parse(cs, SUBPARSE);
-        re = re.substr(0, reClassStart) + "\\[" + sp[0];
-        hasMagic = hasMagic || sp[1];
-      }
-      for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) {
-        var tail = re.slice(pl.reStart + pl.open.length);
-        this.debug("setting tail", re, pl);
-        tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function(_, $1, $2) {
-          if (!$2) {
-            $2 = "\\";
-          }
-          return $1 + $1 + $2 + "|";
-        });
-        this.debug("tail=%j\n   %s", tail, tail, pl, re);
-        var t = pl.type === "*" ? star : pl.type === "?" ? qmark : "\\" + pl.type;
-        hasMagic = true;
-        re = re.slice(0, pl.reStart) + t + "\\(" + tail;
-      }
-      clearStateChar();
-      if (escaping) {
-        re += "\\\\";
-      }
-      var addPatternStart = false;
-      switch (re.charAt(0)) {
-        case "[":
-        case ".":
-        case "(":
-          addPatternStart = true;
-      }
-      for (var n = negativeLists.length - 1; n > -1; n--) {
-        var nl = negativeLists[n];
-        var nlBefore = re.slice(0, nl.reStart);
-        var nlFirst = re.slice(nl.reStart, nl.reEnd - 8);
-        var nlLast = re.slice(nl.reEnd - 8, nl.reEnd);
-        var nlAfter = re.slice(nl.reEnd);
-        nlLast += nlAfter;
-        var openParensBefore = nlBefore.split("(").length - 1;
-        var cleanAfter = nlAfter;
-        for (i = 0; i < openParensBefore; i++) {
-          cleanAfter = cleanAfter.replace(/\)[+*?]?/, "");
-        }
-        nlAfter = cleanAfter;
-        var dollar = "";
-        if (nlAfter === "" && isSub !== SUBPARSE) {
-          dollar = "$";
-        }
-        var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast;
-        re = newRe;
-      }
-      if (re !== "" && hasMagic) {
-        re = "(?=.)" + re;
-      }
-      if (addPatternStart) {
-        re = patternStart + re;
-      }
-      if (isSub === SUBPARSE) {
-        return [re, hasMagic];
-      }
-      if (!hasMagic) {
-        return globUnescape(pattern);
-      }
-      var flags = options.nocase ? "i" : "";
-      try {
-        var regExp = new RegExp("^" + re + "$", flags);
-      } catch (er) {
-        return new RegExp("$.");
-      }
-      regExp._glob = pattern;
-      regExp._src = re;
-      return regExp;
-    }
-    minimatch.makeRe = function(pattern, options) {
-      return new Minimatch(pattern, options || {}).makeRe();
-    };
-    Minimatch.prototype.makeRe = makeRe;
-    function makeRe() {
-      if (this.regexp || this.regexp === false) return this.regexp;
-      var set = this.set;
-      if (!set.length) {
-        this.regexp = false;
-        return this.regexp;
-      }
-      var options = this.options;
-      var twoStar = options.noglobstar ? star : options.dot ? twoStarDot : twoStarNoDot;
-      var flags = options.nocase ? "i" : "";
-      var re = set.map(function(pattern) {
-        return pattern.map(function(p) {
-          return p === GLOBSTAR ? twoStar : typeof p === "string" ? regExpEscape(p) : p._src;
-        }).join("\\/");
-      }).join("|");
-      re = "^(?:" + re + ")$";
-      if (this.negate) re = "^(?!" + re + ").*$";
-      try {
-        this.regexp = new RegExp(re, flags);
-      } catch (ex) {
-        this.regexp = false;
-      }
-      return this.regexp;
-    }
-    minimatch.match = function(list, pattern, options) {
-      options = options || {};
-      var mm = new Minimatch(pattern, options);
-      list = list.filter(function(f) {
-        return mm.match(f);
-      });
-      if (mm.options.nonull && !list.length) {
-        list.push(pattern);
-      }
-      return list;
-    };
-    Minimatch.prototype.match = function match(f, partial) {
-      if (typeof partial === "undefined") partial = this.partial;
-      this.debug("match", f, this.pattern);
-      if (this.comment) return false;
-      if (this.empty) return f === "";
-      if (f === "/" && partial) return true;
-      var options = this.options;
-      if (path5.sep !== "/") {
-        f = f.split(path5.sep).join("/");
-      }
-      f = f.split(slashSplit);
-      this.debug(this.pattern, "split", f);
-      var set = this.set;
-      this.debug(this.pattern, "set", set);
-      var filename;
-      var i;
-      for (i = f.length - 1; i >= 0; i--) {
-        filename = f[i];
-        if (filename) break;
-      }
-      for (i = 0; i < set.length; i++) {
-        var pattern = set[i];
-        var file = f;
-        if (options.matchBase && pattern.length === 1) {
-          file = [filename];
-        }
-        var hit = this.matchOne(file, pattern, partial);
-        if (hit) {
-          if (options.flipNegate) return true;
-          return !this.negate;
-        }
-      }
-      if (options.flipNegate) return false;
-      return this.negate;
-    };
-    Minimatch.prototype.matchOne = function(file, pattern, partial) {
-      var options = this.options;
-      this.debug(
-        "matchOne",
-        { "this": this, file, pattern }
-      );
-      this.debug("matchOne", file.length, pattern.length);
-      for (var fi = 0, pi = 0, fl = file.length, pl = pattern.length; fi < fl && pi < pl; fi++, pi++) {
-        this.debug("matchOne loop");
-        var p = pattern[pi];
-        var f = file[fi];
-        this.debug(pattern, p, f);
-        if (p === false) return false;
-        if (p === GLOBSTAR) {
-          this.debug("GLOBSTAR", [pattern, p, f]);
-          var fr = fi;
-          var pr = pi + 1;
-          if (pr === pl) {
-            this.debug("** at the end");
-            for (; fi < fl; fi++) {
-              if (file[fi] === "." || file[fi] === ".." || !options.dot && file[fi].charAt(0) === ".") return false;
-            }
-            return true;
-          }
-          while (fr < fl) {
-            var swallowee = file[fr];
-            this.debug("\nglobstar while", file, fr, pattern, pr, swallowee);
-            if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) {
-              this.debug("globstar found match!", fr, fl, swallowee);
-              return true;
-            } else {
-              if (swallowee === "." || swallowee === ".." || !options.dot && swallowee.charAt(0) === ".") {
-                this.debug("dot detected!", file, fr, pattern, pr);
-                break;
-              }
-              this.debug("globstar swallow a segment, and continue");
-              fr++;
-            }
-          }
-          if (partial) {
-            this.debug("\n>>> no match, partial?", file, fr, pattern, pr);
-            if (fr === fl) return true;
-          }
-          return false;
-        }
-        var hit;
-        if (typeof p === "string") {
-          hit = f === p;
-          this.debug("string match", p, f, hit);
-        } else {
-          hit = f.match(p);
-          this.debug("pattern match", p, f, hit);
-        }
-        if (!hit) return false;
-      }
-      if (fi === fl && pi === pl) {
-        return true;
-      } else if (fi === fl) {
-        return partial;
-      } else if (pi === pl) {
-        return fi === fl - 1 && file[fi] === "";
-      }
-      throw new Error("wtf?");
-    };
-    function globUnescape(s) {
-      return s.replace(/\\(.)/g, "$1");
-    }
-    function regExpEscape(s) {
-      return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
-    }
-  }
-});
-
-// node_modules/.pnpm/path-is-absolute@1.0.1/node_modules/path-is-absolute/index.js
-var require_path_is_absolute = __commonJS({
-  "node_modules/.pnpm/path-is-absolute@1.0.1/node_modules/path-is-absolute/index.js"(exports2, module2) {
-    "use strict";
-    function posix(path5) {
-      return path5.charAt(0) === "/";
-    }
-    function win32(path5) {
-      var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/;
-      var result = splitDeviceRe.exec(path5);
-      var device = result[1] || "";
-      var isUnc = Boolean(device && device.charAt(1) !== ":");
-      return Boolean(result[2] || isUnc);
-    }
-    module2.exports = process.platform === "win32" ? win32 : posix;
-    module2.exports.posix = posix;
-    module2.exports.win32 = win32;
-  }
-});
-
-// node_modules/.pnpm/glob@7.2.3/node_modules/glob/common.js
-var require_common2 = __commonJS({
-  "node_modules/.pnpm/glob@7.2.3/node_modules/glob/common.js"(exports2) {
-    exports2.setopts = setopts;
-    exports2.ownProp = ownProp;
-    exports2.makeAbs = makeAbs;
-    exports2.finish = finish;
-    exports2.mark = mark;
-    exports2.isIgnored = isIgnored;
-    exports2.childrenIgnored = childrenIgnored;
-    function ownProp(obj, field) {
-      return Object.prototype.hasOwnProperty.call(obj, field);
-    }
-    var fs5 = require("fs");
-    var path5 = require("path");
-    var minimatch = require_minimatch();
-    var isAbsolute = require_path_is_absolute();
-    var Minimatch = minimatch.Minimatch;
-    function alphasort(a, b) {
-      return a.localeCompare(b, "en");
-    }
-    function setupIgnores(self2, options) {
-      self2.ignore = options.ignore || [];
-      if (!Array.isArray(self2.ignore))
-        self2.ignore = [self2.ignore];
-      if (self2.ignore.length) {
-        self2.ignore = self2.ignore.map(ignoreMap);
-      }
-    }
-    function ignoreMap(pattern) {
-      var gmatcher = null;
-      if (pattern.slice(-3) === "/**") {
-        var gpattern = pattern.replace(/(\/\*\*)+$/, "");
-        gmatcher = new Minimatch(gpattern, { dot: true });
-      }
-      return {
-        matcher: new Minimatch(pattern, { dot: true }),
-        gmatcher
-      };
-    }
-    function setopts(self2, pattern, options) {
-      if (!options)
-        options = {};
-      if (options.matchBase && -1 === pattern.indexOf("/")) {
-        if (options.noglobstar) {
-          throw new Error("base matching requires globstar");
-        }
-        pattern = "**/" + pattern;
-      }
-      self2.silent = !!options.silent;
-      self2.pattern = pattern;
-      self2.strict = options.strict !== false;
-      self2.realpath = !!options.realpath;
-      self2.realpathCache = options.realpathCache || /* @__PURE__ */ Object.create(null);
-      self2.follow = !!options.follow;
-      self2.dot = !!options.dot;
-      self2.mark = !!options.mark;
-      self2.nodir = !!options.nodir;
-      if (self2.nodir)
-        self2.mark = true;
-      self2.sync = !!options.sync;
-      self2.nounique = !!options.nounique;
-      self2.nonull = !!options.nonull;
-      self2.nosort = !!options.nosort;
-      self2.nocase = !!options.nocase;
-      self2.stat = !!options.stat;
-      self2.noprocess = !!options.noprocess;
-      self2.absolute = !!options.absolute;
-      self2.fs = options.fs || fs5;
-      self2.maxLength = options.maxLength || Infinity;
-      self2.cache = options.cache || /* @__PURE__ */ Object.create(null);
-      self2.statCache = options.statCache || /* @__PURE__ */ Object.create(null);
-      self2.symlinks = options.symlinks || /* @__PURE__ */ Object.create(null);
-      setupIgnores(self2, options);
-      self2.changedCwd = false;
-      var cwd = process.cwd();
-      if (!ownProp(options, "cwd"))
-        self2.cwd = cwd;
-      else {
-        self2.cwd = path5.resolve(options.cwd);
-        self2.changedCwd = self2.cwd !== cwd;
-      }
-      self2.root = options.root || path5.resolve(self2.cwd, "/");
-      self2.root = path5.resolve(self2.root);
-      if (process.platform === "win32")
-        self2.root = self2.root.replace(/\\/g, "/");
-      self2.cwdAbs = isAbsolute(self2.cwd) ? self2.cwd : makeAbs(self2, self2.cwd);
-      if (process.platform === "win32")
-        self2.cwdAbs = self2.cwdAbs.replace(/\\/g, "/");
-      self2.nomount = !!options.nomount;
-      options.nonegate = true;
-      options.nocomment = true;
-      options.allowWindowsEscape = false;
-      self2.minimatch = new Minimatch(pattern, options);
-      self2.options = self2.minimatch.options;
-    }
-    function finish(self2) {
-      var nou = self2.nounique;
-      var all = nou ? [] : /* @__PURE__ */ Object.create(null);
-      for (var i = 0, l = self2.matches.length; i < l; i++) {
-        var matches = self2.matches[i];
-        if (!matches || Object.keys(matches).length === 0) {
-          if (self2.nonull) {
-            var literal = self2.minimatch.globSet[i];
-            if (nou)
-              all.push(literal);
-            else
-              all[literal] = true;
-          }
-        } else {
-          var m = Object.keys(matches);
-          if (nou)
-            all.push.apply(all, m);
-          else
-            m.forEach(function(m2) {
-              all[m2] = true;
-            });
-        }
-      }
-      if (!nou)
-        all = Object.keys(all);
-      if (!self2.nosort)
-        all = all.sort(alphasort);
-      if (self2.mark) {
-        for (var i = 0; i < all.length; i++) {
-          all[i] = self2._mark(all[i]);
-        }
-        if (self2.nodir) {
-          all = all.filter(function(e) {
-            var notDir = !/\/$/.test(e);
-            var c = self2.cache[e] || self2.cache[makeAbs(self2, e)];
-            if (notDir && c)
-              notDir = c !== "DIR" && !Array.isArray(c);
-            return notDir;
-          });
-        }
-      }
-      if (self2.ignore.length)
-        all = all.filter(function(m2) {
-          return !isIgnored(self2, m2);
-        });
-      self2.found = all;
-    }
-    function mark(self2, p) {
-      var abs = makeAbs(self2, p);
-      var c = self2.cache[abs];
-      var m = p;
-      if (c) {
-        var isDir = c === "DIR" || Array.isArray(c);
-        var slash = p.slice(-1) === "/";
-        if (isDir && !slash)
-          m += "/";
-        else if (!isDir && slash)
-          m = m.slice(0, -1);
-        if (m !== p) {
-          var mabs = makeAbs(self2, m);
-          self2.statCache[mabs] = self2.statCache[abs];
-          self2.cache[mabs] = self2.cache[abs];
-        }
-      }
-      return m;
-    }
-    function makeAbs(self2, f) {
-      var abs = f;
-      if (f.charAt(0) === "/") {
-        abs = path5.join(self2.root, f);
-      } else if (isAbsolute(f) || f === "") {
-        abs = f;
-      } else if (self2.changedCwd) {
-        abs = path5.resolve(self2.cwd, f);
-      } else {
-        abs = path5.resolve(f);
-      }
-      if (process.platform === "win32")
-        abs = abs.replace(/\\/g, "/");
-      return abs;
-    }
-    function isIgnored(self2, path6) {
-      if (!self2.ignore.length)
-        return false;
-      return self2.ignore.some(function(item) {
-        return item.matcher.match(path6) || !!(item.gmatcher && item.gmatcher.match(path6));
-      });
-    }
-    function childrenIgnored(self2, path6) {
-      if (!self2.ignore.length)
-        return false;
-      return self2.ignore.some(function(item) {
-        return !!(item.gmatcher && item.gmatcher.match(path6));
-      });
-    }
-  }
-});
-
-// node_modules/.pnpm/glob@7.2.3/node_modules/glob/sync.js
-var require_sync = __commonJS({
-  "node_modules/.pnpm/glob@7.2.3/node_modules/glob/sync.js"(exports2, module2) {
-    module2.exports = globSync;
-    globSync.GlobSync = GlobSync;
-    var rp = require_fs2();
-    var minimatch = require_minimatch();
-    var Minimatch = minimatch.Minimatch;
-    var Glob = require_glob().Glob;
-    var util = require("util");
-    var path5 = require("path");
-    var assert = require("assert");
-    var isAbsolute = require_path_is_absolute();
-    var common = require_common2();
-    var setopts = common.setopts;
-    var ownProp = common.ownProp;
-    var childrenIgnored = common.childrenIgnored;
-    var isIgnored = common.isIgnored;
-    function globSync(pattern, options) {
-      if (typeof options === "function" || arguments.length === 3)
-        throw new TypeError("callback provided to sync glob\nSee: https://github.com/isaacs/node-glob/issues/167");
-      return new GlobSync(pattern, options).found;
-    }
-    function GlobSync(pattern, options) {
-      if (!pattern)
-        throw new Error("must provide pattern");
-      if (typeof options === "function" || arguments.length === 3)
-        throw new TypeError("callback provided to sync glob\nSee: https://github.com/isaacs/node-glob/issues/167");
-      if (!(this instanceof GlobSync))
-        return new GlobSync(pattern, options);
-      setopts(this, pattern, options);
-      if (this.noprocess)
-        return this;
-      var n = this.minimatch.set.length;
-      this.matches = new Array(n);
-      for (var i = 0; i < n; i++) {
-        this._process(this.minimatch.set[i], i, false);
-      }
-      this._finish();
-    }
-    GlobSync.prototype._finish = function() {
-      assert.ok(this instanceof GlobSync);
-      if (this.realpath) {
-        var self2 = this;
-        this.matches.forEach(function(matchset, index) {
-          var set = self2.matches[index] = /* @__PURE__ */ Object.create(null);
-          for (var p in matchset) {
-            try {
-              p = self2._makeAbs(p);
-              var real = rp.realpathSync(p, self2.realpathCache);
-              set[real] = true;
-            } catch (er) {
-              if (er.syscall === "stat")
-                set[self2._makeAbs(p)] = true;
-              else
-                throw er;
-            }
-          }
-        });
-      }
-      common.finish(this);
-    };
-    GlobSync.prototype._process = function(pattern, index, inGlobStar) {
-      assert.ok(this instanceof GlobSync);
-      var n = 0;
-      while (typeof pattern[n] === "string") {
-        n++;
-      }
-      var prefix;
-      switch (n) {
-        // if not, then this is rather simple
-        case pattern.length:
-          this._processSimple(pattern.join("/"), index);
-          return;
-        case 0:
-          prefix = null;
-          break;
-        default:
-          prefix = pattern.slice(0, n).join("/");
-          break;
-      }
-      var remain = pattern.slice(n);
-      var read;
-      if (prefix === null)
-        read = ".";
-      else if (isAbsolute(prefix) || isAbsolute(pattern.map(function(p) {
-        return typeof p === "string" ? p : "[*]";
-      }).join("/"))) {
-        if (!prefix || !isAbsolute(prefix))
-          prefix = "/" + prefix;
-        read = prefix;
-      } else
-        read = prefix;
-      var abs = this._makeAbs(read);
-      if (childrenIgnored(this, read))
-        return;
-      var isGlobStar = remain[0] === minimatch.GLOBSTAR;
-      if (isGlobStar)
-        this._processGlobStar(prefix, read, abs, remain, index, inGlobStar);
-      else
-        this._processReaddir(prefix, read, abs, remain, index, inGlobStar);
-    };
-    GlobSync.prototype._processReaddir = function(prefix, read, abs, remain, index, inGlobStar) {
-      var entries = this._readdir(abs, inGlobStar);
-      if (!entries)
-        return;
-      var pn = remain[0];
-      var negate = !!this.minimatch.negate;
-      var rawGlob = pn._glob;
-      var dotOk = this.dot || rawGlob.charAt(0) === ".";
-      var matchedEntries = [];
-      for (var i = 0; i < entries.length; i++) {
-        var e = entries[i];
-        if (e.charAt(0) !== "." || dotOk) {
-          var m;
-          if (negate && !prefix) {
-            m = !e.match(pn);
-          } else {
-            m = e.match(pn);
-          }
-          if (m)
-            matchedEntries.push(e);
-        }
-      }
-      var len = matchedEntries.length;
-      if (len === 0)
-        return;
-      if (remain.length === 1 && !this.mark && !this.stat) {
-        if (!this.matches[index])
-          this.matches[index] = /* @__PURE__ */ Object.create(null);
-        for (var i = 0; i < len; i++) {
-          var e = matchedEntries[i];
-          if (prefix) {
-            if (prefix.slice(-1) !== "/")
-              e = prefix + "/" + e;
-            else
-              e = prefix + e;
-          }
-          if (e.charAt(0) === "/" && !this.nomount) {
-            e = path5.join(this.root, e);
-          }
-          this._emitMatch(index, e);
-        }
-        return;
-      }
-      remain.shift();
-      for (var i = 0; i < len; i++) {
-        var e = matchedEntries[i];
-        var newPattern;
-        if (prefix)
-          newPattern = [prefix, e];
-        else
-          newPattern = [e];
-        this._process(newPattern.concat(remain), index, inGlobStar);
-      }
-    };
-    GlobSync.prototype._emitMatch = function(index, e) {
-      if (isIgnored(this, e))
-        return;
-      var abs = this._makeAbs(e);
-      if (this.mark)
-        e = this._mark(e);
-      if (this.absolute) {
-        e = abs;
-      }
-      if (this.matches[index][e])
-        return;
-      if (this.nodir) {
-        var c = this.cache[abs];
-        if (c === "DIR" || Array.isArray(c))
-          return;
-      }
-      this.matches[index][e] = true;
-      if (this.stat)
-        this._stat(e);
-    };
-    GlobSync.prototype._readdirInGlobStar = function(abs) {
-      if (this.follow)
-        return this._readdir(abs, false);
-      var entries;
-      var lstat;
-      var stat2;
-      try {
-        lstat = this.fs.lstatSync(abs);
-      } catch (er) {
-        if (er.code === "ENOENT") {
-          return null;
-        }
-      }
-      var isSym = lstat && lstat.isSymbolicLink();
-      this.symlinks[abs] = isSym;
-      if (!isSym && lstat && !lstat.isDirectory())
-        this.cache[abs] = "FILE";
-      else
-        entries = this._readdir(abs, false);
-      return entries;
-    };
-    GlobSync.prototype._readdir = function(abs, inGlobStar) {
-      var entries;
-      if (inGlobStar && !ownProp(this.symlinks, abs))
-        return this._readdirInGlobStar(abs);
-      if (ownProp(this.cache, abs)) {
-        var c = this.cache[abs];
-        if (!c || c === "FILE")
-          return null;
-        if (Array.isArray(c))
-          return c;
-      }
-      try {
-        return this._readdirEntries(abs, this.fs.readdirSync(abs));
-      } catch (er) {
-        this._readdirError(abs, er);
-        return null;
-      }
-    };
-    GlobSync.prototype._readdirEntries = function(abs, entries) {
-      if (!this.mark && !this.stat) {
-        for (var i = 0; i < entries.length; i++) {
-          var e = entries[i];
-          if (abs === "/")
-            e = abs + e;
-          else
-            e = abs + "/" + e;
-          this.cache[e] = true;
-        }
-      }
-      this.cache[abs] = entries;
-      return entries;
-    };
-    GlobSync.prototype._readdirError = function(f, er) {
-      switch (er.code) {
-        case "ENOTSUP":
-        // https://github.com/isaacs/node-glob/issues/205
-        case "ENOTDIR":
-          var abs = this._makeAbs(f);
-          this.cache[abs] = "FILE";
-          if (abs === this.cwdAbs) {
-            var error8 = new Error(er.code + " invalid cwd " + this.cwd);
-            error8.path = this.cwd;
-            error8.code = er.code;
-            throw error8;
-          }
-          break;
-        case "ENOENT":
-        // not terribly unusual
-        case "ELOOP":
-        case "ENAMETOOLONG":
-        case "UNKNOWN":
-          this.cache[this._makeAbs(f)] = false;
-          break;
-        default:
-          this.cache[this._makeAbs(f)] = false;
-          if (this.strict)
-            throw er;
-          if (!this.silent)
-            console.error("glob error", er);
-          break;
-      }
-    };
-    GlobSync.prototype._processGlobStar = function(prefix, read, abs, remain, index, inGlobStar) {
-      var entries = this._readdir(abs, inGlobStar);
-      if (!entries)
-        return;
-      var remainWithoutGlobStar = remain.slice(1);
-      var gspref = prefix ? [prefix] : [];
-      var noGlobStar = gspref.concat(remainWithoutGlobStar);
-      this._process(noGlobStar, index, false);
-      var len = entries.length;
-      var isSym = this.symlinks[abs];
-      if (isSym && inGlobStar)
-        return;
-      for (var i = 0; i < len; i++) {
-        var e = entries[i];
-        if (e.charAt(0) === "." && !this.dot)
-          continue;
-        var instead = gspref.concat(entries[i], remainWithoutGlobStar);
-        this._process(instead, index, true);
-        var below = gspref.concat(entries[i], remain);
-        this._process(below, index, true);
-      }
-    };
-    GlobSync.prototype._processSimple = function(prefix, index) {
-      var exists = this._stat(prefix);
-      if (!this.matches[index])
-        this.matches[index] = /* @__PURE__ */ Object.create(null);
-      if (!exists)
-        return;
-      if (prefix && isAbsolute(prefix) && !this.nomount) {
-        var trail = /[\/\\]$/.test(prefix);
-        if (prefix.charAt(0) === "/") {
-          prefix = path5.join(this.root, prefix);
-        } else {
-          prefix = path5.resolve(this.root, prefix);
-          if (trail)
-            prefix += "/";
-        }
-      }
-      if (process.platform === "win32")
-        prefix = prefix.replace(/\\/g, "/");
-      this._emitMatch(index, prefix);
-    };
-    GlobSync.prototype._stat = function(f) {
-      var abs = this._makeAbs(f);
-      var needDir = f.slice(-1) === "/";
-      if (f.length > this.maxLength)
-        return false;
-      if (!this.stat && ownProp(this.cache, abs)) {
-        var c = this.cache[abs];
-        if (Array.isArray(c))
-          c = "DIR";
-        if (!needDir || c === "DIR")
-          return c;
-        if (needDir && c === "FILE")
-          return false;
-      }
-      var exists;
-      var stat2 = this.statCache[abs];
-      if (!stat2) {
-        var lstat;
-        try {
-          lstat = this.fs.lstatSync(abs);
-        } catch (er) {
-          if (er && (er.code === "ENOENT" || er.code === "ENOTDIR")) {
-            this.statCache[abs] = false;
-            return false;
-          }
-        }
-        if (lstat && lstat.isSymbolicLink()) {
-          try {
-            stat2 = this.fs.statSync(abs);
-          } catch (er) {
-            stat2 = lstat;
-          }
-        } else {
-          stat2 = lstat;
-        }
-      }
-      this.statCache[abs] = stat2;
-      var c = true;
-      if (stat2)
-        c = stat2.isDirectory() ? "DIR" : "FILE";
-      this.cache[abs] = this.cache[abs] || c;
-      if (needDir && c === "FILE")
-        return false;
-      return c;
-    };
-    GlobSync.prototype._mark = function(p) {
-      return common.mark(this, p);
-    };
-    GlobSync.prototype._makeAbs = function(f) {
-      return common.makeAbs(this, f);
-    };
-  }
-});
-
-// node_modules/.pnpm/inflight@1.0.6/node_modules/inflight/inflight.js
-var require_inflight = __commonJS({
-  "node_modules/.pnpm/inflight@1.0.6/node_modules/inflight/inflight.js"(exports2, module2) {
-    var wrappy = require_wrappy();
-    var reqs = /* @__PURE__ */ Object.create(null);
-    var once = require_once();
-    module2.exports = wrappy(inflight);
-    function inflight(key, cb) {
-      if (reqs[key]) {
-        reqs[key].push(cb);
-        return null;
-      } else {
-        reqs[key] = [cb];
-        return makeres(key);
-      }
-    }
-    function makeres(key) {
-      return once(function RES() {
-        var cbs = reqs[key];
-        var len = cbs.length;
-        var args = slice(arguments);
-        try {
-          for (var i = 0; i < len; i++) {
-            cbs[i].apply(null, args);
-          }
-        } finally {
-          if (cbs.length > len) {
-            cbs.splice(0, len);
-            process.nextTick(function() {
-              RES.apply(null, args);
-            });
-          } else {
-            delete reqs[key];
-          }
-        }
-      });
-    }
-    function slice(args) {
-      var length = args.length;
-      var array = [];
-      for (var i = 0; i < length; i++) array[i] = args[i];
-      return array;
-    }
-  }
-});
-
-// node_modules/.pnpm/glob@7.2.3/node_modules/glob/glob.js
-var require_glob = __commonJS({
-  "node_modules/.pnpm/glob@7.2.3/node_modules/glob/glob.js"(exports2, module2) {
-    module2.exports = glob2;
-    var rp = require_fs2();
-    var minimatch = require_minimatch();
-    var Minimatch = minimatch.Minimatch;
-    var inherits = require_inherits();
-    var EE = require("events").EventEmitter;
-    var path5 = require("path");
-    var assert = require("assert");
-    var isAbsolute = require_path_is_absolute();
-    var globSync = require_sync();
-    var common = require_common2();
-    var setopts = common.setopts;
-    var ownProp = common.ownProp;
-    var inflight = require_inflight();
-    var util = require("util");
-    var childrenIgnored = common.childrenIgnored;
-    var isIgnored = common.isIgnored;
-    var once = require_once();
-    function glob2(pattern, options, cb) {
-      if (typeof options === "function") cb = options, options = {};
-      if (!options) options = {};
-      if (options.sync) {
-        if (cb)
-          throw new TypeError("callback provided to sync glob");
-        return globSync(pattern, options);
-      }
-      return new Glob(pattern, options, cb);
-    }
-    glob2.sync = globSync;
-    var GlobSync = glob2.GlobSync = globSync.GlobSync;
-    glob2.glob = glob2;
-    function extend2(origin, add) {
-      if (add === null || typeof add !== "object") {
-        return origin;
-      }
-      var keys = Object.keys(add);
-      var i = keys.length;
-      while (i--) {
-        origin[keys[i]] = add[keys[i]];
-      }
-      return origin;
-    }
-    glob2.hasMagic = function(pattern, options_) {
-      var options = extend2({}, options_);
-      options.noprocess = true;
-      var g = new Glob(pattern, options);
-      var set = g.minimatch.set;
-      if (!pattern)
-        return false;
-      if (set.length > 1)
-        return true;
-      for (var j = 0; j < set[0].length; j++) {
-        if (typeof set[0][j] !== "string")
-          return true;
-      }
-      return false;
-    };
-    glob2.Glob = Glob;
-    inherits(Glob, EE);
-    function Glob(pattern, options, cb) {
-      if (typeof options === "function") {
-        cb = options;
-        options = null;
-      }
-      if (options && options.sync) {
-        if (cb)
-          throw new TypeError("callback provided to sync glob");
-        return new GlobSync(pattern, options);
-      }
-      if (!(this instanceof Glob))
-        return new Glob(pattern, options, cb);
-      setopts(this, pattern, options);
-      this._didRealPath = false;
-      var n = this.minimatch.set.length;
-      this.matches = new Array(n);
-      if (typeof cb === "function") {
-        cb = once(cb);
-        this.on("error", cb);
-        this.on("end", function(matches) {
-          cb(null, matches);
-        });
-      }
-      var self2 = this;
-      this._processing = 0;
-      this._emitQueue = [];
-      this._processQueue = [];
-      this.paused = false;
-      if (this.noprocess)
-        return this;
-      if (n === 0)
-        return done();
-      var sync = true;
-      for (var i = 0; i < n; i++) {
-        this._process(this.minimatch.set[i], i, false, done);
-      }
-      sync = false;
-      function done() {
-        --self2._processing;
-        if (self2._processing <= 0) {
-          if (sync) {
-            process.nextTick(function() {
-              self2._finish();
-            });
-          } else {
-            self2._finish();
-          }
-        }
-      }
-    }
-    Glob.prototype._finish = function() {
-      assert(this instanceof Glob);
-      if (this.aborted)
-        return;
-      if (this.realpath && !this._didRealpath)
-        return this._realpath();
-      common.finish(this);
-      this.emit("end", this.found);
-    };
-    Glob.prototype._realpath = function() {
-      if (this._didRealpath)
-        return;
-      this._didRealpath = true;
-      var n = this.matches.length;
-      if (n === 0)
-        return this._finish();
-      var self2 = this;
-      for (var i = 0; i < this.matches.length; i++)
-        this._realpathSet(i, next);
-      function next() {
-        if (--n === 0)
-          self2._finish();
-      }
-    };
-    Glob.prototype._realpathSet = function(index, cb) {
-      var matchset = this.matches[index];
-      if (!matchset)
-        return cb();
-      var found = Object.keys(matchset);
-      var self2 = this;
-      var n = found.length;
-      if (n === 0)
-        return cb();
-      var set = this.matches[index] = /* @__PURE__ */ Object.create(null);
-      found.forEach(function(p, i) {
-        p = self2._makeAbs(p);
-        rp.realpath(p, self2.realpathCache, function(er, real) {
-          if (!er)
-            set[real] = true;
-          else if (er.syscall === "stat")
-            set[p] = true;
-          else
-            self2.emit("error", er);
-          if (--n === 0) {
-            self2.matches[index] = set;
-            cb();
-          }
-        });
-      });
-    };
-    Glob.prototype._mark = function(p) {
-      return common.mark(this, p);
-    };
-    Glob.prototype._makeAbs = function(f) {
-      return common.makeAbs(this, f);
-    };
-    Glob.prototype.abort = function() {
-      this.aborted = true;
-      this.emit("abort");
-    };
-    Glob.prototype.pause = function() {
-      if (!this.paused) {
-        this.paused = true;
-        this.emit("pause");
-      }
-    };
-    Glob.prototype.resume = function() {
-      if (this.paused) {
-        this.emit("resume");
-        this.paused = false;
-        if (this._emitQueue.length) {
-          var eq = this._emitQueue.slice(0);
-          this._emitQueue.length = 0;
-          for (var i = 0; i < eq.length; i++) {
-            var e = eq[i];
-            this._emitMatch(e[0], e[1]);
-          }
-        }
-        if (this._processQueue.length) {
-          var pq = this._processQueue.slice(0);
-          this._processQueue.length = 0;
-          for (var i = 0; i < pq.length; i++) {
-            var p = pq[i];
-            this._processing--;
-            this._process(p[0], p[1], p[2], p[3]);
-          }
-        }
-      }
-    };
-    Glob.prototype._process = function(pattern, index, inGlobStar, cb) {
-      assert(this instanceof Glob);
-      assert(typeof cb === "function");
-      if (this.aborted)
-        return;
-      this._processing++;
-      if (this.paused) {
-        this._processQueue.push([pattern, index, inGlobStar, cb]);
-        return;
-      }
-      var n = 0;
-      while (typeof pattern[n] === "string") {
-        n++;
-      }
-      var prefix;
-      switch (n) {
-        // if not, then this is rather simple
-        case pattern.length:
-          this._processSimple(pattern.join("/"), index, cb);
-          return;
-        case 0:
-          prefix = null;
-          break;
-        default:
-          prefix = pattern.slice(0, n).join("/");
-          break;
-      }
-      var remain = pattern.slice(n);
-      var read;
-      if (prefix === null)
-        read = ".";
-      else if (isAbsolute(prefix) || isAbsolute(pattern.map(function(p) {
-        return typeof p === "string" ? p : "[*]";
-      }).join("/"))) {
-        if (!prefix || !isAbsolute(prefix))
-          prefix = "/" + prefix;
-        read = prefix;
-      } else
-        read = prefix;
-      var abs = this._makeAbs(read);
-      if (childrenIgnored(this, read))
-        return cb();
-      var isGlobStar = remain[0] === minimatch.GLOBSTAR;
-      if (isGlobStar)
-        this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb);
-      else
-        this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb);
-    };
-    Glob.prototype._processReaddir = function(prefix, read, abs, remain, index, inGlobStar, cb) {
-      var self2 = this;
-      this._readdir(abs, inGlobStar, function(er, entries) {
-        return self2._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb);
-      });
-    };
-    Glob.prototype._processReaddir2 = function(prefix, read, abs, remain, index, inGlobStar, entries, cb) {
-      if (!entries)
-        return cb();
-      var pn = remain[0];
-      var negate = !!this.minimatch.negate;
-      var rawGlob = pn._glob;
-      var dotOk = this.dot || rawGlob.charAt(0) === ".";
-      var matchedEntries = [];
-      for (var i = 0; i < entries.length; i++) {
-        var e = entries[i];
-        if (e.charAt(0) !== "." || dotOk) {
-          var m;
-          if (negate && !prefix) {
-            m = !e.match(pn);
-          } else {
-            m = e.match(pn);
-          }
-          if (m)
-            matchedEntries.push(e);
-        }
-      }
-      var len = matchedEntries.length;
-      if (len === 0)
-        return cb();
-      if (remain.length === 1 && !this.mark && !this.stat) {
-        if (!this.matches[index])
-          this.matches[index] = /* @__PURE__ */ Object.create(null);
-        for (var i = 0; i < len; i++) {
-          var e = matchedEntries[i];
-          if (prefix) {
-            if (prefix !== "/")
-              e = prefix + "/" + e;
-            else
-              e = prefix + e;
-          }
-          if (e.charAt(0) === "/" && !this.nomount) {
-            e = path5.join(this.root, e);
-          }
-          this._emitMatch(index, e);
-        }
-        return cb();
-      }
-      remain.shift();
-      for (var i = 0; i < len; i++) {
-        var e = matchedEntries[i];
-        var newPattern;
-        if (prefix) {
-          if (prefix !== "/")
-            e = prefix + "/" + e;
-          else
-            e = prefix + e;
-        }
-        this._process([e].concat(remain), index, inGlobStar, cb);
-      }
-      cb();
-    };
-    Glob.prototype._emitMatch = function(index, e) {
-      if (this.aborted)
-        return;
-      if (isIgnored(this, e))
-        return;
-      if (this.paused) {
-        this._emitQueue.push([index, e]);
-        return;
-      }
-      var abs = isAbsolute(e) ? e : this._makeAbs(e);
-      if (this.mark)
-        e = this._mark(e);
-      if (this.absolute)
-        e = abs;
-      if (this.matches[index][e])
-        return;
-      if (this.nodir) {
-        var c = this.cache[abs];
-        if (c === "DIR" || Array.isArray(c))
-          return;
-      }
-      this.matches[index][e] = true;
-      var st = this.statCache[abs];
-      if (st)
-        this.emit("stat", e, st);
-      this.emit("match", e);
-    };
-    Glob.prototype._readdirInGlobStar = function(abs, cb) {
-      if (this.aborted)
-        return;
-      if (this.follow)
-        return this._readdir(abs, false, cb);
-      var lstatkey = "lstat\0" + abs;
-      var self2 = this;
-      var lstatcb = inflight(lstatkey, lstatcb_);
-      if (lstatcb)
-        self2.fs.lstat(abs, lstatcb);
-      function lstatcb_(er, lstat) {
-        if (er && er.code === "ENOENT")
-          return cb();
-        var isSym = lstat && lstat.isSymbolicLink();
-        self2.symlinks[abs] = isSym;
-        if (!isSym && lstat && !lstat.isDirectory()) {
-          self2.cache[abs] = "FILE";
-          cb();
-        } else
-          self2._readdir(abs, false, cb);
-      }
-    };
-    Glob.prototype._readdir = function(abs, inGlobStar, cb) {
-      if (this.aborted)
-        return;
-      cb = inflight("readdir\0" + abs + "\0" + inGlobStar, cb);
-      if (!cb)
-        return;
-      if (inGlobStar && !ownProp(this.symlinks, abs))
-        return this._readdirInGlobStar(abs, cb);
-      if (ownProp(this.cache, abs)) {
-        var c = this.cache[abs];
-        if (!c || c === "FILE")
-          return cb();
-        if (Array.isArray(c))
-          return cb(null, c);
-      }
-      var self2 = this;
-      self2.fs.readdir(abs, readdirCb(this, abs, cb));
-    };
-    function readdirCb(self2, abs, cb) {
-      return function(er, entries) {
-        if (er)
-          self2._readdirError(abs, er, cb);
-        else
-          self2._readdirEntries(abs, entries, cb);
-      };
-    }
-    Glob.prototype._readdirEntries = function(abs, entries, cb) {
-      if (this.aborted)
-        return;
-      if (!this.mark && !this.stat) {
-        for (var i = 0; i < entries.length; i++) {
-          var e = entries[i];
-          if (abs === "/")
-            e = abs + e;
-          else
-            e = abs + "/" + e;
-          this.cache[e] = true;
-        }
-      }
-      this.cache[abs] = entries;
-      return cb(null, entries);
-    };
-    Glob.prototype._readdirError = function(f, er, cb) {
-      if (this.aborted)
-        return;
-      switch (er.code) {
-        case "ENOTSUP":
-        // https://github.com/isaacs/node-glob/issues/205
-        case "ENOTDIR":
-          var abs = this._makeAbs(f);
-          this.cache[abs] = "FILE";
-          if (abs === this.cwdAbs) {
-            var error8 = new Error(er.code + " invalid cwd " + this.cwd);
-            error8.path = this.cwd;
-            error8.code = er.code;
-            this.emit("error", error8);
-            this.abort();
-          }
-          break;
-        case "ENOENT":
-        // not terribly unusual
-        case "ELOOP":
-        case "ENAMETOOLONG":
-        case "UNKNOWN":
-          this.cache[this._makeAbs(f)] = false;
-          break;
-        default:
-          this.cache[this._makeAbs(f)] = false;
-          if (this.strict) {
-            this.emit("error", er);
-            this.abort();
-          }
-          if (!this.silent)
-            console.error("glob error", er);
-          break;
-      }
-      return cb();
-    };
-    Glob.prototype._processGlobStar = function(prefix, read, abs, remain, index, inGlobStar, cb) {
-      var self2 = this;
-      this._readdir(abs, inGlobStar, function(er, entries) {
-        self2._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb);
-      });
-    };
-    Glob.prototype._processGlobStar2 = function(prefix, read, abs, remain, index, inGlobStar, entries, cb) {
-      if (!entries)
-        return cb();
-      var remainWithoutGlobStar = remain.slice(1);
-      var gspref = prefix ? [prefix] : [];
-      var noGlobStar = gspref.concat(remainWithoutGlobStar);
-      this._process(noGlobStar, index, false, cb);
-      var isSym = this.symlinks[abs];
-      var len = entries.length;
-      if (isSym && inGlobStar)
-        return cb();
-      for (var i = 0; i < len; i++) {
-        var e = entries[i];
-        if (e.charAt(0) === "." && !this.dot)
-          continue;
-        var instead = gspref.concat(entries[i], remainWithoutGlobStar);
-        this._process(instead, index, true, cb);
-        var below = gspref.concat(entries[i], remain);
-        this._process(below, index, true, cb);
-      }
-      cb();
-    };
-    Glob.prototype._processSimple = function(prefix, index, cb) {
-      var self2 = this;
-      this._stat(prefix, function(er, exists) {
-        self2._processSimple2(prefix, index, er, exists, cb);
-      });
-    };
-    Glob.prototype._processSimple2 = function(prefix, index, er, exists, cb) {
-      if (!this.matches[index])
-        this.matches[index] = /* @__PURE__ */ Object.create(null);
-      if (!exists)
-        return cb();
-      if (prefix && isAbsolute(prefix) && !this.nomount) {
-        var trail = /[\/\\]$/.test(prefix);
-        if (prefix.charAt(0) === "/") {
-          prefix = path5.join(this.root, prefix);
-        } else {
-          prefix = path5.resolve(this.root, prefix);
-          if (trail)
-            prefix += "/";
-        }
-      }
-      if (process.platform === "win32")
-        prefix = prefix.replace(/\\/g, "/");
-      this._emitMatch(index, prefix);
-      cb();
-    };
-    Glob.prototype._stat = function(f, cb) {
-      var abs = this._makeAbs(f);
-      var needDir = f.slice(-1) === "/";
-      if (f.length > this.maxLength)
-        return cb();
-      if (!this.stat && ownProp(this.cache, abs)) {
-        var c = this.cache[abs];
-        if (Array.isArray(c))
-          c = "DIR";
-        if (!needDir || c === "DIR")
-          return cb(null, c);
-        if (needDir && c === "FILE")
-          return cb();
-      }
-      var exists;
-      var stat2 = this.statCache[abs];
-      if (stat2 !== void 0) {
-        if (stat2 === false)
-          return cb(null, stat2);
-        else {
-          var type = stat2.isDirectory() ? "DIR" : "FILE";
-          if (needDir && type === "FILE")
-            return cb();
-          else
-            return cb(null, type, stat2);
-        }
-      }
-      var self2 = this;
-      var statcb = inflight("stat\0" + abs, lstatcb_);
-      if (statcb)
-        self2.fs.lstat(abs, statcb);
-      function lstatcb_(er, lstat) {
-        if (lstat && lstat.isSymbolicLink()) {
-          return self2.fs.stat(abs, function(er2, stat3) {
-            if (er2)
-              self2._stat2(f, abs, null, lstat, cb);
-            else
-              self2._stat2(f, abs, er2, stat3, cb);
-          });
-        } else {
-          self2._stat2(f, abs, er, lstat, cb);
-        }
-      }
-    };
-    Glob.prototype._stat2 = function(f, abs, er, stat2, cb) {
-      if (er && (er.code === "ENOENT" || er.code === "ENOTDIR")) {
-        this.statCache[abs] = false;
-        return cb();
-      }
-      var needDir = f.slice(-1) === "/";
-      this.statCache[abs] = stat2;
-      if (abs.slice(-1) === "/" && stat2 && !stat2.isDirectory())
-        return cb(null, false, stat2);
-      var c = true;
-      if (stat2)
-        c = stat2.isDirectory() ? "DIR" : "FILE";
-      this.cache[abs] = this.cache[abs] || c;
-      if (needDir && c === "FILE")
-        return cb();
-      return cb(null, c, stat2);
-    };
-  }
-});
-
-// node_modules/.pnpm/glob-promise@6.0.7_glob@7.2.3/node_modules/glob-promise/lib/index.js
-var require_lib3 = __commonJS({
-  "node_modules/.pnpm/glob-promise@6.0.7_glob@7.2.3/node_modules/glob-promise/lib/index.js"(exports2, module2) {
-    var glob2 = require_glob();
-    var promise = function(pattern, options) {
-      return new Promise((resolve2, reject) => {
-        glob2(pattern, options, (err, files) => err === null ? resolve2(files) : reject(err));
-      });
-    };
-    module2.exports = promise;
-    module2.exports.glob = glob2;
-    module2.exports.Glob = glob2.Glob;
-    module2.exports.hasMagic = glob2.hasMagic;
-    module2.exports.promise = promise;
-    module2.exports.sync = glob2.sync;
-  }
-});
-
 // node_modules/.pnpm/papaparse@5.5.3/node_modules/papaparse/papaparse.js
 var require_papaparse = __commonJS({
   "node_modules/.pnpm/papaparse@5.5.3/node_modules/papaparse/papaparse.js"(exports2, module2) {
@@ -37923,7 +35842,7 @@ var init_getCoveredStates = __esm({
 });
 
 // apps/server/service/config.ts
-var PAGE_SIZE, MAX_PAGE_SIZE, MAX_PAGE_NUMBER, ES_INDEX_NAME, ES_CLEAR_INDEX, INDEX_BACKOFF_INITIAL, INDEX_BACKOFF_INCREMENT, INDEX_BACKOFF_MAX, INDEX_MAX_RETRIES, INDEX_TIMEOUT, LOADING_CHUNK_SIZE, ENABLE_GEO, GNAF_PACKAGE_URL, GNAF_DIR, ONE_DAY_S, ONE_DAY_MS, THIRTY_DAYS_MS, SERVER_PORT, CORS_ALLOW_ORIGIN, CORS_EXPOSE_HEADERS, CORS_ALLOW_HEADERS, CACHE_MAX_ENTRIES, CACHE_TTL_MS, CACHE_ENABLED, CIRCUIT_FAILURE_THRESHOLD, CIRCUIT_RESET_TIMEOUT_MS, CIRCUIT_SUCCESS_THRESHOLD, DYNAMIC_RESOURCES_ENABLED, TARGET_MEMORY_UTILIZATION, VERBOSE;
+var PAGE_SIZE, MAX_PAGE_SIZE, MAX_PAGE_NUMBER, ES_INDEX_NAME, ES_LOCALITY_INDEX_NAME, ES_CLEAR_INDEX, INDEX_BACKOFF_INITIAL, INDEX_BACKOFF_INCREMENT, INDEX_BACKOFF_MAX, INDEX_MAX_RETRIES, INDEX_TIMEOUT, LOADING_CHUNK_SIZE, ENABLE_GEO, GNAF_PACKAGE_URL, GNAF_DIR, ONE_DAY_S, ONE_DAY_MS, THIRTY_DAYS_MS, SERVER_PORT, CORS_ALLOW_ORIGIN, CORS_EXPOSE_HEADERS, CORS_ALLOW_HEADERS, CACHE_MAX_ENTRIES, CACHE_TTL_MS, CACHE_ENABLED, CIRCUIT_FAILURE_THRESHOLD, CIRCUIT_RESET_TIMEOUT_MS, CIRCUIT_SUCCESS_THRESHOLD, DYNAMIC_RESOURCES_ENABLED, TARGET_MEMORY_UTILIZATION, VERBOSE;
 var init_config = __esm({
   "apps/server/service/config.ts"() {
     "use strict";
@@ -37931,6 +35850,7 @@ var init_config = __esm({
     MAX_PAGE_SIZE = Number.parseInt(process.env.MAX_PAGE_SIZE ?? "100", 10) || 100;
     MAX_PAGE_NUMBER = Number.parseInt(process.env.MAX_PAGE_NUMBER ?? "1000", 10) || 1e3;
     ES_INDEX_NAME = process.env.ES_INDEX_NAME ?? "addresskit";
+    ES_LOCALITY_INDEX_NAME = process.env.ES_LOCALITY_INDEX_NAME ?? "addresskit-localities";
     ES_CLEAR_INDEX = process.env.ES_CLEAR_INDEX === "true";
     INDEX_BACKOFF_INITIAL = Number.parseInt(
       process.env.ADDRESSKIT_INDEX_BACKOFF ?? "30000",
@@ -39535,7 +37455,7 @@ var init_circuitBreaker = __esm({
 });
 
 // apps/server/service/helpers/jsonapi.ts
-var JSONAPI_IMPLEMENTATION, RESOURCE_TYPES, extractAddressId, buildAutocompleteResource, buildAddressResource, buildPaginationLinks, buildPaginationMeta, buildAutocompleteDocument, buildAddressDetailDocument, buildError, buildErrorDocument, ErrorDocuments;
+var JSONAPI_IMPLEMENTATION, RESOURCE_TYPES, extractAddressId, extractLocalityId, buildAutocompleteResource, buildAddressResource, buildLocalityAutocompleteResource, buildLocalityResource, buildPaginationLinks, API_WARNINGS, buildPaginationMeta, buildAutocompleteDocument, buildAddressDetailDocument, buildLocalityAutocompleteDocument, buildLocalityDetailDocument, buildError, buildErrorDocument, ErrorDocuments;
 var init_jsonapi = __esm({
   "apps/server/service/helpers/jsonapi.ts"() {
     "use strict";
@@ -39546,11 +37466,18 @@ var init_jsonapi = __esm({
       /** Resource type for address entities */
       ADDRESS: "address",
       /** Resource type for autocomplete suggestions */
-      ADDRESS_SUGGESTION: "address-suggestion"
+      ADDRESS_SUGGESTION: "address-suggestion",
+      /** Resource type for locality entities */
+      LOCALITY: "locality",
+      /** Resource type for locality autocomplete suggestions */
+      LOCALITY_SUGGESTION: "locality-suggestion"
     };
     extractAddressId = (path5) => {
       return path5.replace(/^\/addresses\//, "");
     };
+    extractLocalityId = (path5) => {
+      return path5.replace(/^\/localities\//, "");
+    };
     buildAutocompleteResource = (id, sla, rank, ssla) => {
       const attributes = {
         sla,
@@ -39576,6 +37503,30 @@ var init_jsonapi = __esm({
         }
       };
     };
+    buildLocalityAutocompleteResource = (id, display, rank) => {
+      const attributes = {
+        display,
+        rank
+      };
+      return {
+        type: RESOURCE_TYPES.LOCALITY_SUGGESTION,
+        id,
+        attributes,
+        links: {
+          self: `/localities/${id}`
+        }
+      };
+    };
+    buildLocalityResource = (id, attributes) => {
+      return {
+        type: RESOURCE_TYPES.LOCALITY,
+        id,
+        attributes,
+        links: {
+          self: `/localities/${id}`
+        }
+      };
+    };
     buildPaginationLinks = (baseUrl, query, currentPage, totalPages, pageSize2) => {
       const buildQueryString = (page) => {
         const params = new URLSearchParams();
@@ -39610,14 +37561,25 @@ var init_jsonapi = __esm({
       }
       return links;
     };
-    buildPaginationMeta = (total, page, pageSize2, responseTime) => {
+    API_WARNINGS = {
+      /** Warning when the address dataset is empty (no addresses loaded) */
+      EMPTY_DATASET: "No addresses are currently loaded in the dataset. Please run the data loader to populate the address index.",
+      /** Warning when a search query returns no matching results */
+      NO_RESULTS: "No addresses matched your search query.",
+      /** Warning when the locality dataset is empty (no localities loaded) */
+      EMPTY_LOCALITY_DATASET: "No localities are currently loaded in the dataset. Please run the data loader to populate the locality index.",
+      /** Warning when a locality search query returns no matching results */
+      NO_LOCALITY_RESULTS: "No localities matched your search query."
+    };
+    buildPaginationMeta = (total, page, pageSize2, responseTime, warning) => {
       const totalPages = Math.ceil(total / pageSize2);
       return {
         total,
         page,
         pageSize: pageSize2,
         totalPages,
-        ...responseTime !== void 0 && { responseTime }
+        ...responseTime !== void 0 && { responseTime },
+        ...warning !== void 0 && { warning }
       };
     };
     buildAutocompleteDocument = (resources, links, meta) => {
@@ -39637,6 +37599,23 @@ var init_jsonapi = __esm({
         }
       };
     };
+    buildLocalityAutocompleteDocument = (resources, links, meta) => {
+      return {
+        jsonapi: JSONAPI_IMPLEMENTATION,
+        data: resources,
+        links,
+        meta
+      };
+    };
+    buildLocalityDetailDocument = (resource) => {
+      return {
+        jsonapi: JSONAPI_IMPLEMENTATION,
+        data: resource,
+        links: {
+          self: resource.links?.self
+        }
+      };
+    };
     buildError = (status, title, detail, code, source) => {
       return {
         status,
@@ -39672,6 +37651,23 @@ var init_jsonapi = __esm({
           )
         ]);
       },
+      /**
+       * Builds a 400 Bad Request error document for missing required parameter.
+       *
+       * @param paramName - The name of the missing required parameter.
+       * @returns JSON:API error document for missing parameter.
+       */
+      missingRequiredParameter: (paramName) => {
+        return buildErrorDocument([
+          buildError(
+            "400",
+            "Bad Request",
+            `The '${paramName}' query parameter is required and must not be empty.`,
+            "MISSING_REQUIRED_PARAMETER",
+            { parameter: paramName }
+          )
+        ]);
+      },
       /**
        * Builds a 404 Not Found error document.
        *
@@ -39764,7 +37760,7 @@ var init_helpers = __esm({
 });
 
 // apps/server/service/commands/load.ts
-var crypto, fs3, path3, stream, import_elasticsearch2, import_directory_exists, import_glob_promise, Papa2, unzip, fetchGNAFPackageData, fetchGNAFArchive, unzipGNAFArchive, computeDocumentHash, loadGNAFAddress, processAddressChunk, IndexingError, extractBulkErrors, isRetryableError, sendIndexRequest, getStateName, initGNAFDataLoader, loadStateData, loadStreetLocality, loadLocality, loadSiteGeo, loadDefaultGeo, loadAuthFiles, loadCommandEntry;
+var crypto, fs3, path3, stream, import_elasticsearch2, import_directory_exists, Papa2, unzip, fetchGNAFPackageData, fetchGNAFArchive, unzipGNAFArchive, computeDocumentHash, loadGNAFAddress, processAddressChunk, IndexingError, extractBulkErrors, isRetryableError, sendIndexRequest, getStateName, indexLocalitiesForState, initGNAFDataLoader, loadStateData, loadStreetLocality, loadLocality, loadSiteGeo, loadDefaultGeo, loadAuthFiles, loadCommandEntry;
 var init_load = __esm({
   "apps/server/service/commands/load.ts"() {
     "use strict";
@@ -39775,7 +37771,6 @@ var init_load = __esm({
     import_elasticsearch2 = __toESM(require_elasticsearch());
     init_stream_down();
     import_directory_exists = __toESM(require_directory_exists());
-    import_glob_promise = __toESM(require_lib3());
     Papa2 = __toESM(require_papaparse());
     unzip = __toESM(require_unzip());
     init_conf();
@@ -39911,9 +37906,12 @@ var init_load = __esm({
             }
           });
           const downloadedStats = fs3.statSync(incompleteFile);
-          if (dataResource.size && downloadedStats.size !== dataResource.size) {
+          const expectedSize = dataResource.size;
+          const actualSize = downloadedStats.size;
+          const percentageDifference = Math.abs((actualSize - expectedSize) / expectedSize) * 100;
+          if (percentageDifference > 5) {
             throw new Error(
-              `Downloaded file size (${downloadedStats.size}) doesn't match expected (${dataResource.size})`
+              `Downloaded file size (${actualSize}) doesn't match expected (${expectedSize})`
             );
           }
           const downloadDuration = Date.now() - downloadStartTime;
@@ -40328,6 +38326,60 @@ var init_load = __esm({
         });
       });
     };
+    indexLocalitiesForState = async (context, addressDetailFile, refresh) => {
+      const localityPostcodes = {};
+      await new Promise((resolve2, reject) => {
+        Papa2.parse(fs3.createReadStream(addressDetailFile), {
+          header: true,
+          delimiter: "|",
+          chunk: (chunk, parser) => {
+            for (const row of chunk.data) {
+              const localityPid = row.LOCALITY_PID;
+              const postcode = row.POSTCODE;
+              if (!localityPid || !postcode) continue;
+              if (localityPostcodes[localityPid] === void 0) {
+                localityPostcodes[localityPid] = /* @__PURE__ */ new Set();
+              }
+              localityPostcodes[localityPid].add(postcode);
+            }
+          },
+          complete: () => resolve2(),
+          error: (parseError) => reject(parseError)
+        });
+      });
+      const localityIndexed = context.localityIndexed ?? {};
+      const state = context.state ?? "";
+      const stateName = context.stateName ?? "";
+      const localityClassCode = context.LOCALITY_CLASS_AUT ?? {};
+      const indexingBody = [];
+      for (const [localityPid, localityData] of Object.entries(localityIndexed)) {
+        const postcodes = localityPostcodes[localityPid] ? Array.from(localityPostcodes[localityPid]).sort() : [];
+        const primaryPostcode = postcodes[0] ?? "";
+        const classCode = localityData.LOCALITY_CLASS_CODE ?? "";
+        const className = localityClassCode[classCode]?.NAME ?? classCode ?? "";
+        const display = primaryPostcode ? `${localityData.LOCALITY_NAME} ${state} ${primaryPostcode}` : `${localityData.LOCALITY_NAME} ${state}`;
+        indexingBody.push({
+          index: {
+            _index: ES_LOCALITY_INDEX_NAME,
+            _id: `/localities/${localityPid}`
+          }
+        });
+        indexingBody.push({
+          display,
+          name: localityData.LOCALITY_NAME,
+          localityPid,
+          stateAbbreviation: state,
+          stateName,
+          postcode: primaryPostcode,
+          postcodes,
+          classCode,
+          className
+        });
+      }
+      if (indexingBody.length > 0) {
+        await sendIndexRequest(indexingBody, void 0, { refresh });
+      }
+    };
     initGNAFDataLoader = async (directory, { refresh = false } = {}) => {
       const countsFile = `${directory}/Counts.csv`;
       const countsFileExists = await fileExists(countsFile);
@@ -40350,6 +38402,7 @@ var init_load = __esm({
         loadContext
       );
       await (0, import_elasticsearch2.initIndex)(global.esClient, ES_CLEAR_INDEX, synonyms);
+      await (0, import_elasticsearch2.initLocalityIndex)(global.esClient, ES_CLEAR_INDEX);
       const addressDetailFiles = files.filter(
         (f) => f.match(/ADDRESS_DETAIL/) && f.match(/\/Standard\//)
       );
@@ -40461,6 +38514,17 @@ var init_load = __esm({
           succeedSpinner(
             `${stateProgress} ${formatState(state)}: ${formatNumber(expectedCount)} addresses indexed in ${formatDuration(indexingDuration)}`
           );
+          const localitySpinner = startSpinner(
+            `${stateProgress} ${formatState(state)}: Indexing localities...`
+          );
+          await indexLocalitiesForState(
+            loadContext,
+            `${directory}/${detailFile}`,
+            refresh
+          );
+          succeedSpinner(
+            `${stateProgress} ${formatState(state)}: Localities indexed`
+          );
         }
       }
     };
@@ -40756,18 +38820,41 @@ var init_load = __esm({
           throw new Error(`Data dir '${unzipped}' is empty`);
         }
         const locateSpinner = startSpinner("Locating G-NAF data directory...");
-        const gnafDir = await (0, import_glob_promise.glob)("**/G-NAF/", { cwd: unzipped });
-        if (VERBOSE) logger("gnafDir", gnafDir);
-        if (gnafDir.length === 0) {
+        const findDirectory = async (baseDir, targetName, maxDepth = 3) => {
+          const searchDir = async (currentDir, depth) => {
+            if (depth > maxDepth) return void 0;
+            const entries = await fsp.readdir(currentDir, {
+              withFileTypes: true
+            });
+            for (const entry of entries) {
+              if (entry.isDirectory()) {
+                if (entry.name === targetName) {
+                  return path3.relative(
+                    baseDir,
+                    path3.join(currentDir, entry.name)
+                  );
+                }
+                const found = await searchDir(
+                  path3.join(currentDir, entry.name),
+                  depth + 1
+                );
+                if (found) return found;
+              }
+            }
+            return void 0;
+          };
+          return searchDir(baseDir, 0);
+        };
+        const gnafDirPath = await findDirectory(unzipped, "G-NAF");
+        if (VERBOSE) logger("gnafDir found", gnafDirPath);
+        if (!gnafDirPath) {
           failSpinner("G-NAF directory not found");
           throw new Error(
             `Cannot find 'G-NAF' directory in Data dir '${unzipped}'`
           );
         }
         succeedSpinner("G-NAF data directory located");
-        const mainDirectory = path3.dirname(
-          `${unzipped}/${gnafDir[0].slice(0, -1)}`
-        );
+        const mainDirectory = path3.dirname(`${unzipped}/${gnafDirPath}`);
         if (VERBOSE) logger("Main Data dir", mainDirectory);
         if (resourceMonitor) {
           if (VERBOSE) logger("Starting data loading phase");
@@ -41841,7 +39928,7 @@ var init_setLinkOptions = __esm({
 });
 
 // apps/server/service/index.ts
-var crypto2, fs4, import_node_https2, import_debug4, got, import_http_link_header, import_keyv, import_keyv_file, fsp, readdir, logger, error, cache, gnafHttpCache, keepAliveAgent, gotClient, validatePaginationParams, normalizeSearchString, searchForAddress, getAddress, getAddresses, mapToJsonApiAutocompleteResponse, service_default;
+var crypto2, fs4, import_node_https2, import_debug4, got, import_http_link_header, import_keyv, import_keyv_file, fsp, readdir, logger, error, cache, gnafHttpCache, keepAliveAgent, gotClient, validatePaginationParams, normalizeSearchString, isIndexEmpty, searchForAddress, getAddress, getAddresses, mapToJsonApiAutocompleteResponse, isLocalityIndexEmpty, searchForLocality, getLocality, getLocalities, service_default;
 var init_service = __esm({
   "apps/server/service/index.ts"() {
     "use strict";
@@ -41885,6 +39972,19 @@ var init_service = __esm({
       return { validPage, validSize };
     };
     normalizeSearchString = (searchString) => (searchString ?? "").trim().replace(/\s+/g, " ");
+    isIndexEmpty = async () => {
+      try {
+        const circuit = getOpenSearchCircuit();
+        const countResponse = await circuit.execute(async () => {
+          return await global.esClient.count({
+            index: ES_INDEX_NAME
+          });
+        });
+        return countResponse.body.count === 0;
+      } catch {
+        return true;
+      }
+    };
     searchForAddress = async (searchString, p, pageSize2 = PAGE_SIZE) => {
       const normalizedSearch = normalizeSearchString(searchString);
       if (normalizedSearch === "") {
@@ -42142,7 +40242,18 @@ var init_service = __esm({
           title: `${swagger.path.get.operationId} API Docs`,
           type: "text/html"
         };
-        const meta = buildPaginationMeta(totalHits, page, size);
+        let warning;
+        if (totalHits === 0) {
+          const datasetEmpty = await isIndexEmpty();
+          warning = datasetEmpty ? API_WARNINGS.EMPTY_DATASET : API_WARNINGS.NO_RESULTS;
+        }
+        const meta = buildPaginationMeta(
+          totalHits,
+          page,
+          size,
+          void 0,
+          warning
+        );
         const jsonApiDocument = buildAutocompleteDocument(
           resources,
           jsonApiLinks,
@@ -42263,10 +40374,361 @@ var init_service = __esm({
         );
       });
     };
+    isLocalityIndexEmpty = async () => {
+      try {
+        const circuit = getOpenSearchCircuit();
+        const countResponse = await circuit.execute(async () => {
+          return await global.esClient.count({
+            index: ES_LOCALITY_INDEX_NAME
+          });
+        });
+        return countResponse.body.count === 0;
+      } catch {
+        return true;
+      }
+    };
+    searchForLocality = async (searchString, p, pageSize2 = PAGE_SIZE) => {
+      const normalizedSearch = (searchString ?? "").trim().replace(/\s+/g, " ");
+      if (normalizedSearch === "") {
+        throw new Error("Search query must not be empty after normalization");
+      }
+      const safePage = Number.isFinite(p) ? p : 1;
+      const safeSize = Number.isFinite(pageSize2) ? pageSize2 : PAGE_SIZE;
+      const validPage = Math.max(1, Math.min(safePage, MAX_PAGE_NUMBER));
+      const validSize = Math.max(1, Math.min(safeSize, MAX_PAGE_SIZE));
+      const from = (validPage - 1) * validSize;
+      const circuit = getOpenSearchCircuit();
+      const searchResp = await circuit.execute(async () => {
+        return await global.esClient.search({
+          index: ES_LOCALITY_INDEX_NAME,
+          body: {
+            from,
+            size: validSize,
+            _source: [
+              "display",
+              "name",
+              "localityPid",
+              "stateAbbreviation",
+              "stateName",
+              "postcode",
+              "postcodes",
+              "classCode",
+              "className"
+            ],
+            query: {
+              bool: {
+                should: [
+                  // Highest boost: Display starts with the search query (exact prefix match)
+                  {
+                    prefix: {
+                      "display.raw": {
+                        value: normalizedSearch.toUpperCase(),
+                        boost: 100
+                      }
+                    }
+                  },
+                  // High boost: Locality name starts with search query
+                  {
+                    prefix: {
+                      "name.raw": {
+                        value: normalizedSearch.toUpperCase(),
+                        boost: 80
+                      }
+                    }
+                  },
+                  // Medium boost: Postcode match
+                  {
+                    term: {
+                      postcode: {
+                        value: normalizedSearch,
+                        boost: 60
+                      }
+                    }
+                  },
+                  // Medium boost: Match on any of the postcodes
+                  {
+                    term: {
+                      postcodes: {
+                        value: normalizedSearch,
+                        boost: 50
+                      }
+                    }
+                  },
+                  // Phrase prefix match on display
+                  {
+                    match_phrase_prefix: {
+                      display: {
+                        query: normalizedSearch,
+                        boost: 40
+                      }
+                    }
+                  },
+                  // Phrase prefix match on name
+                  {
+                    match_phrase_prefix: {
+                      name: {
+                        query: normalizedSearch,
+                        boost: 30
+                      }
+                    }
+                  },
+                  // Fuzzy match for typo tolerance
+                  {
+                    multi_match: {
+                      fields: ["display", "name"],
+                      query: normalizedSearch,
+                      fuzziness: "AUTO",
+                      type: "bool_prefix",
+                      lenient: true,
+                      operator: "AND"
+                    }
+                  }
+                ]
+              }
+            },
+            sort: ["_score", { "name.raw": { order: "asc" } }]
+          }
+        });
+      });
+      const rawTotal = searchResp.body.hits.total;
+      const totalHits = typeof rawTotal === "number" ? rawTotal : rawTotal.value;
+      return {
+        searchResponse: searchResp,
+        page: validPage,
+        size: validSize,
+        totalHits: totalHits ?? 0
+      };
+    };
+    getLocality = async (localityId) => {
+      try {
+        const circuit = getOpenSearchCircuit();
+        const jsonX = await circuit.execute(async () => {
+          return await global.esClient.get({
+            index: ES_LOCALITY_INDEX_NAME,
+            id: `/localities/${localityId}`
+          });
+        });
+        if (VERBOSE) logger("locality jsonX", jsonX);
+        const source = jsonX.body._source;
+        const attributes = {
+          localityPid: source.localityPid,
+          name: source.name,
+          display: source.display,
+          ...source.classCode !== void 0 && {
+            class: {
+              code: source.classCode,
+              name: source.className
+            }
+          },
+          ...source.stateAbbreviation !== void 0 && {
+            state: {
+              name: source.stateName,
+              abbreviation: source.stateAbbreviation
+            }
+          },
+          ...source.postcode !== void 0 && { postcode: source.postcode },
+          ...source.postcodes !== void 0 && {
+            postcodes: source.postcodes
+          }
+        };
+        const resource = buildLocalityResource(localityId, attributes);
+        const jsonApiDocument = buildLocalityDetailDocument(resource);
+        const link = new import_http_link_header.default();
+        link.set({
+          rel: "self",
+          uri: `/localities/${localityId}`
+        });
+        const hash = crypto2.createHash("md5").update(JSON.stringify(jsonApiDocument)).digest("hex");
+        return { link, json: jsonApiDocument, hash };
+      } catch (error_) {
+        if (error_ instanceof CircuitOpenError) {
+          error("Circuit breaker open for OpenSearch", error_);
+          const retryAfterSeconds = Math.ceil(error_.retryAfterMs / 1e3);
+          return {
+            statusCode: 503,
+            json: ErrorDocuments.serviceUnavailable(
+              retryAfterSeconds
+            )
+          };
+        }
+        const osError = error_;
+        error("error getting locality from elastic search", osError);
+        if (osError.body?.found === false) {
+          return {
+            statusCode: 404,
+            json: ErrorDocuments.notFound("locality", localityId)
+          };
+        }
+        if (osError.body?.error?.type === "index_not_found_exception") {
+          return {
+            statusCode: 503,
+            json: ErrorDocuments.serviceUnavailable()
+          };
+        }
+        return {
+          statusCode: 500,
+          json: ErrorDocuments.internalError()
+        };
+      }
+    };
+    getLocalities = async (url, swagger, q, p = 1) => {
+      try {
+        const normalizedQuery = (q ?? "").trim().replace(/\s+/g, " ");
+        if (normalizedQuery === "") {
+          return {
+            statusCode: 400,
+            json: ErrorDocuments.badRequest(
+              "The 'q' query parameter is required and must not be empty.",
+              "q"
+            )
+          };
+        }
+        const {
+          searchResponse: foundLocalities,
+          page,
+          size,
+          totalHits
+        } = await searchForLocality(normalizedQuery, p);
+        if (VERBOSE) logger("foundLocalities", foundLocalities);
+        const totalPages = Math.ceil(totalHits / size);
+        const maxScore = foundLocalities.body.hits.hits[0] ? foundLocalities.body.hits.hits[0]._score : 1;
+        const resources = foundLocalities.body.hits.hits.map((h) => {
+          const hit = h;
+          const localityId = extractLocalityId(hit._id);
+          const normalizedRank = maxScore > 0 ? hit._score / maxScore : 0;
+          return buildLocalityAutocompleteResource(
+            localityId,
+            hit._source.display,
+            normalizedRank
+          );
+        });
+        const jsonApiLinks = buildPaginationLinks(
+          url,
+          normalizedQuery,
+          page,
+          totalPages
+        );
+        jsonApiLinks.describedby = {
+          href: `/docs/#operations-${swagger.path.get["x-swagger-router-controller"].toLowerCase()}-${swagger.path.get.operationId}`,
+          title: `${swagger.path.get.operationId} API Docs`,
+          type: "text/html"
+        };
+        let warning;
+        if (totalHits === 0) {
+          const datasetEmpty = await isLocalityIndexEmpty();
+          warning = datasetEmpty ? API_WARNINGS.EMPTY_LOCALITY_DATASET : API_WARNINGS.NO_LOCALITY_RESULTS;
+        }
+        const meta = buildPaginationMeta(
+          totalHits,
+          page,
+          size,
+          void 0,
+          warning
+        );
+        const jsonApiDocument = buildLocalityAutocompleteDocument(
+          resources,
+          jsonApiLinks,
+          meta
+        );
+        const link = new import_http_link_header.default();
+        link.set({
+          rel: "describedby",
+          uri: `/docs/#operations-${swagger.path.get["x-swagger-router-controller"].toLowerCase()}-${swagger.path.get.operationId}`,
+          title: `${swagger.path.get.operationId} API Docs`,
+          type: "text/html"
+        });
+        const sp = new URLSearchParams({
+          ...normalizedQuery !== "" && { q: normalizedQuery },
+          ...page !== 1 && { "page[number]": String(page) }
+        });
+        const spString = sp.toString();
+        link.set({
+          rel: "self",
+          uri: `${url}${spString === "" ? "" : "?"}${spString}`
+        });
+        link.set({
+          rel: "first",
+          uri: `${url}${normalizedQuery === "" ? "" : "?"}${new URLSearchParams(
+            {
+              ...normalizedQuery !== "" && { q: normalizedQuery }
+            }
+          ).toString()}`
+        });
+        if (page > 1) {
+          link.set({
+            rel: "prev",
+            uri: `${url}${normalizedQuery === "" && page === 2 ? "" : "?"}${new URLSearchParams({
+              ...normalizedQuery !== "" && { q: normalizedQuery },
+              ...page > 2 && { "page[number]": String(page - 1) }
+            }).toString()}`
+          });
+        }
+        const hasNextPage = totalHits > size * page;
+        if (hasNextPage) {
+          link.set({
+            rel: "next",
+            uri: `${url}?${new URLSearchParams({
+              ...normalizedQuery !== "" && { q: normalizedQuery },
+              "page[number]": String(page + 1)
+            }).toString()}`
+          });
+        }
+        if (totalPages > 0) {
+          link.set({
+            rel: "last",
+            uri: `${url}?${new URLSearchParams({
+              ...normalizedQuery !== "" && { q: normalizedQuery },
+              ...totalPages > 1 && {
+                "page[number]": String(totalPages)
+              }
+            }).toString()}`
+          });
+        }
+        const linkTemplate = new import_http_link_header.default();
+        const op = swagger.path.get;
+        setLinkOptions(op, url, linkTemplate);
+        return {
+          link,
+          json: jsonApiDocument,
+          linkTemplate
+        };
+      } catch (error_) {
+        if (error_ instanceof CircuitOpenError) {
+          error("Circuit breaker open for OpenSearch", error_);
+          const retryAfterSeconds = Math.ceil(error_.retryAfterMs / 1e3);
+          return {
+            statusCode: 503,
+            json: ErrorDocuments.serviceUnavailable(
+              retryAfterSeconds
+            )
+          };
+        }
+        const osError = error_;
+        error("error querying localities in elastic search", osError);
+        if (osError.body?.error?.type === "index_not_found_exception") {
+          return {
+            statusCode: 503,
+            json: ErrorDocuments.serviceUnavailable()
+          };
+        }
+        if (osError.displayName === "RequestTimeout") {
+          return {
+            statusCode: 504,
+            json: ErrorDocuments.gatewayTimeout()
+          };
+        }
+        return {
+          statusCode: 500,
+          json: ErrorDocuments.internalError()
+        };
+      }
+    };
     service_default = {
       load: loadCommandEntry,
       autocomplete: getAddresses,
-      lookup: getAddress
+      lookup: getAddress,
+      localityAutocomplete: getLocalities,
+      localityLookup: getLocality
     };
   }
 });
@@ -42287,9 +40749,9 @@ async function runLoadCommand(options) {
     displayKeyValue({
       "OpenSearch URL": process.env.ES_HOST || "http://localhost:9200",
       "Index Name": process.env.ES_INDEX_NAME || "addresskit",
-      "Clear Index": options.clear ? "Yes" : "No",
-      Geocoding: options.geo ? "Enabled" : "Disabled",
-      States: options.states || "All"
+      "Clear Index": process.env.ES_CLEAR_INDEX === "true" || options.clear ? "Yes" : "No",
+      Geocoding: process.env.ADDRESSKIT_ENABLE_GEO === "1" || options.geo ? "Enabled" : "Disabled",
+      States: process.env.COVERED_STATES || options.states || "All"
     });
   }
   const connectSpinner = startSpinner("Connecting to OpenSearch...");
@@ -42383,7 +40845,7 @@ var init_load2 = __esm({
 // node_modules/.pnpm/depd@2.0.0/node_modules/depd/index.js
 var require_depd = __commonJS({
   "node_modules/.pnpm/depd@2.0.0/node_modules/depd/index.js"(exports2, module2) {
-    var relative = require("path").relative;
+    var relative2 = require("path").relative;
     module2.exports = depd;
     var basePath = process.cwd();
     function containsNamespace(str, namespace) {
@@ -42575,7 +41037,7 @@ var require_depd = __commonJS({
       return formatted;
     }
     function formatLocation(callSite) {
-      return relative(basePath, callSite[0]) + ":" + callSite[1] + ":" + callSite[2];
+      return relative2(basePath, callSite[0]) + ":" + callSite[1] + ":" + callSite[2];
     }
     function getStack() {
       var limit = Error.stackTraceLimit;
@@ -47055,7 +45517,7 @@ var require_extend_node = __commonJS({
 });
 
 // node_modules/.pnpm/iconv-lite@0.4.24/node_modules/iconv-lite/lib/index.js
-var require_lib4 = __commonJS({
+var require_lib3 = __commonJS({
   "node_modules/.pnpm/iconv-lite@0.4.24/node_modules/iconv-lite/lib/index.js"(exports2, module2) {
     "use strict";
     var Buffer2 = require_safer().Buffer;
@@ -47202,7 +45664,7 @@ var require_raw_body = __commonJS({
     var asyncHooks = tryRequireAsyncHooks();
     var bytes = require_bytes();
     var createError = require_http_errors();
-    var iconv = require_lib4();
+    var iconv = require_lib3();
     var unpipe = require_unpipe();
     module2.exports = getRawBody;
     var ICONV_ENCODING_MESSAGE_REGEXP = /^Encoding not recognized: /;
@@ -47551,7 +46013,7 @@ var require_read = __commonJS({
     var createError = require_http_errors();
     var destroy = require_destroy2();
     var getBody = require_raw_body();
-    var iconv = require_lib4();
+    var iconv = require_lib3();
     var onFinished = require_on_finished();
     var unpipe = require_unpipe();
     var zlib = require("zlib");
@@ -59243,7 +57705,7 @@ var require_parse = __commonJS({
 });
 
 // node_modules/.pnpm/qs@6.14.1/node_modules/qs/lib/index.js
-var require_lib5 = __commonJS({
+var require_lib4 = __commonJS({
   "node_modules/.pnpm/qs@6.14.1/node_modules/qs/lib/index.js"(exports2, module2) {
     "use strict";
     var stringify = require_stringify();
@@ -59392,7 +57854,7 @@ var require_urlencoded = __commonJS({
       }
       switch (name) {
         case "qs":
-          mod = require_lib5();
+          mod = require_lib4();
           break;
         case "querystring":
           mod = require("querystring");
@@ -60647,7 +59109,7 @@ var require_query = __commonJS({
     "use strict";
     var merge = require_utils_merge();
     var parseUrl = require_parseurl();
-    var qs = require_lib5();
+    var qs = require_lib4();
     module2.exports = function query(options) {
       var opts = merge({}, options);
       var queryparse = qs.parse;
@@ -60679,7 +59141,7 @@ var require_view = __commonJS({
     var dirname2 = path5.dirname;
     var basename3 = path5.basename;
     var extname2 = path5.extname;
-    var join2 = path5.join;
+    var join3 = path5.join;
     var resolve2 = path5.resolve;
     module2.exports = View;
     function View(name, options) {
@@ -60727,12 +59189,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve3(dir, file) {
       var ext = this.ext;
-      var path6 = join2(dir, file);
+      var path6 = join3(dir, file);
       var stat2 = tryStat(path6);
       if (stat2 && stat2.isFile()) {
         return path6;
       }
-      path6 = join2(dir, basename3(file, ext), "index" + ext);
+      path6 = join3(dir, basename3(file, ext), "index" + ext);
       stat2 = tryStat(path6);
       if (stat2 && stat2.isFile()) {
         return path6;
@@ -61191,7 +59653,7 @@ var require_send = __commonJS({
     var Stream = require("stream");
     var util = require("util");
     var extname2 = path5.extname;
-    var join2 = path5.join;
+    var join3 = path5.join;
     var normalize = path5.normalize;
     var resolve2 = path5.resolve;
     var sep = path5.sep;
@@ -61410,7 +59872,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path6.split(sep);
-        path6 = normalize(join2(root, path6));
+        path6 = normalize(join3(root, path6));
       } else {
         if (UP_PATH_REGEXP.test(path6)) {
           debug8('malicious path "%s"', path6);
@@ -61545,7 +60007,7 @@ var require_send = __commonJS({
           if (err) return self2.onStatError(err);
           return self2.error(404);
         }
-        var p = join2(path6, self2._index[i]);
+        var p = join3(path6, self2._index[i]);
         debug8('stat "%s"', p);
         fs5.stat(p, function(err2, stat2) {
           if (err2) return next(err2);
@@ -62554,7 +61016,7 @@ var require_utils3 = __commonJS({
     var mime = require_send().mime;
     var etag = require_etag();
     var proxyaddr = require_proxy_addr();
-    var qs = require_lib5();
+    var qs = require_lib4();
     var querystring = require("querystring");
     exports2.etag = createETagGenerator({ weak: false });
     exports2.wetag = createETagGenerator({ weak: true });
@@ -65393,7 +63855,7 @@ var require_waycharter = __commonJS({
 });
 
 // node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/common.js
-var require_common3 = __commonJS({
+var require_common2 = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/common.js"(exports2, module2) {
     "use strict";
     function isNothing(subject) {
@@ -65471,7 +63933,7 @@ var require_exception = __commonJS({
 var require_mark = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/mark.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     function Mark(name, buffer, position, line, column) {
       this.name = name;
       this.buffer = buffer;
@@ -65588,7 +64050,7 @@ var require_type2 = __commonJS({
 var require_schema = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/schema.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     var YAMLException = require_exception();
     var Type = require_type2();
     function compileList(schema, name, result) {
@@ -65810,7 +64272,7 @@ var require_bool = __commonJS({
 var require_int = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/type/int.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     var Type = require_type2();
     function isHexCode(c) {
       return 48 <= c && c <= 57 || 65 <= c && c <= 70 || 97 <= c && c <= 102;
@@ -65943,7 +64405,7 @@ var require_int = __commonJS({
 var require_float = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/type/float.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     var Type = require_type2();
     var YAML_FLOAT_PATTERN = new RegExp(
       // 2.5e4, 2.5 and integers
@@ -66508,7 +64970,7 @@ var require_default_full = __commonJS({
 var require_loader = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/loader.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     var YAMLException = require_exception();
     var Mark = require_mark();
     var DEFAULT_SAFE_SCHEMA = require_default_safe();
@@ -67627,7 +66089,7 @@ var require_loader = __commonJS({
 var require_dumper = __commonJS({
   "node_modules/.pnpm/js-yaml@3.14.2/node_modules/js-yaml/lib/js-yaml/dumper.js"(exports2, module2) {
     "use strict";
-    var common = require_common3();
+    var common = require_common2();
     var YAMLException = require_exception();
     var DEFAULT_FULL_SCHEMA = require_default_full();
     var DEFAULT_SAFE_SCHEMA = require_default_safe();
@@ -68652,6 +67114,116 @@ async function loadAddressCollection(params) {
     }
   };
 }
+function mapLocalitySearchHitToResource(hit, maxScore) {
+  const localityId = hit._id.replace("/localities/", "");
+  const normalizedRank = maxScore > 0 ? hit._score / maxScore : 0;
+  return {
+    type: "locality-suggestion",
+    id: localityId,
+    attributes: {
+      display: hit._source.display,
+      rank: Math.round(normalizedRank * 100) / 100
+    },
+    links: {
+      self: `/localities/${localityId}`
+    }
+  };
+}
+async function loadLocalityItem({
+  localityPid
+}) {
+  if (typeof localityPid !== "string" || localityPid.length === 0) {
+    throw new Error("Locality PID is required to load a record.");
+  }
+  const { json, hash, statusCode } = await getLocality(
+    localityPid
+  );
+  return {
+    body: json,
+    headers: {
+      etag: `"${version}-${hash}"`,
+      "cache-control": `public, max-age=${ONE_WEEK}`
+    },
+    status: statusCode ?? 200
+  };
+}
+async function loadLocalityCollection(params) {
+  const { page, q } = params;
+  const resolvedPage = Number(page ?? 0);
+  if (!Number.isFinite(resolvedPage)) {
+    throw new Error("Search page value must be numeric.");
+  }
+  const baseUrl = `/localities${q ? `?q=${encodeURIComponent(q)}` : ""}`;
+  if (q && q.length > 1) {
+    logger6("Searching for localities with query:", q);
+    const searchResult = await searchForLocality(
+      q,
+      resolvedPage + 1,
+      pageSize
+    );
+    const hits = searchResult.searchResponse.body.hits.hits;
+    const totalHits = searchResult.totalHits;
+    const totalPages = Math.ceil(totalHits / pageSize);
+    const currentPage = resolvedPage + 1;
+    const maxScore = hits.length > 0 ? hits[0]._score : 1;
+    const data = hits.map(
+      (hit) => mapLocalitySearchHitToResource(hit, maxScore)
+    );
+    const jsonApiDocument = {
+      jsonapi: { version: "1.1" },
+      data,
+      links: {
+        self: `${baseUrl}${currentPage > 1 ? `&page[number]=${currentPage}` : ""}`,
+        first: baseUrl,
+        ...currentPage > 1 && {
+          prev: currentPage === 2 ? baseUrl : `${baseUrl}&page[number]=${currentPage - 1}`
+        },
+        ...currentPage < totalPages && {
+          next: `${baseUrl}&page[number]=${currentPage + 1}`
+        },
+        ...totalPages > 0 && {
+          last: totalPages === 1 ? baseUrl : `${baseUrl}&page[number]=${totalPages}`
+        }
+      },
+      meta: {
+        total: totalHits,
+        page: currentPage,
+        pageSize,
+        totalPages
+      }
+    };
+    const responseHash = (0, import_node_crypto.createHash)("md5").update(JSON.stringify(jsonApiDocument)).digest("hex");
+    return {
+      body: jsonApiDocument,
+      hasMore: currentPage < totalPages,
+      headers: {
+        etag: `"${version}-${responseHash}"`,
+        "cache-control": `public, max-age=${ONE_WEEK}`
+      }
+    };
+  }
+  const emptyDocument = {
+    jsonapi: { version: "1.1" },
+    data: [],
+    links: {
+      self: baseUrl
+    },
+    meta: {
+      total: 0,
+      page: 1,
+      pageSize,
+      totalPages: 0
+    }
+  };
+  return {
+    body: emptyDocument,
+    hasMore: false,
+    headers: {
+      etag: `"${version}"`,
+      "cache-control": `public, max-age=${ONE_WEEK}`
+    }
+  };
+}
 function transformPaginationParams(req, _res, next) {
   const pageParam = req.query.page;
   if (pageParam && typeof pageParam === "object" && pageParam.number) {
@@ -68696,10 +67268,24 @@ async function startRest2Server() {
       }
     ]
   });
+  const localitiesType = waycharter.registerCollection({
+    itemPath: "/:localityPid",
+    itemLoader: loadLocalityItem,
+    collectionPath: "/localities",
+    collectionLoader: loadLocalityCollection,
+    filters: [
+      {
+        rel: "https://addressr.io/rels/locality-search",
+        parameters: ["q"]
+      }
+    ]
+  });
   const loadIndexResource = async () => {
+    const addressLinks = addressesType.additionalPaths;
+    const localityLinks = localitiesType.additionalPaths;
     return {
       body: {},
-      links: addressesType.additionalPaths,
+      links: [...addressLinks, ...localityLinks],
       headers: {
         etag: `"${version}"`,
         "cache-control": `public, max-age=${ONE_WEEK}`
@@ -68823,6 +67409,20 @@ async function runStartCommand(options) {
       `       ${theme.dim("Get detailed information for a specific address")}`
     );
     console.log();
+    console.log(
+      `  ${theme.secondary("GET")}  ${theme.muted("/localities?q=<query>")}`
+    );
+    console.log(
+      `       ${theme.dim("Search for suburbs/postcodes matching the query")}`
+    );
+    console.log();
+    console.log(
+      `  ${theme.secondary("GET")}  ${theme.muted("/localities/:id")}`
+    );
+    console.log(
+      `       ${theme.dim("Get detailed information for a specific locality")}`
+    );
+    console.log();
     console.log(`  ${theme.secondary("GET")}  ${theme.muted("/docs")}`);
     console.log(`       ${theme.dim("OpenAPI/Swagger documentation")}`);
     console.log();
@@ -68883,7 +67483,7 @@ program2.command("load").description("Load G-NAF address data into the search in
     process.env.COVERED_STATES = options.states;
   }
   if (options.clear) {
-    process.env.ES_CLEAR_INDEX = "1";
+    process.env.ES_CLEAR_INDEX = "true";
   }
   if (options.geo) {
     process.env.ADDRESSKIT_ENABLE_GEO = "1";