@mailwoman/core 2.0.0

package/out/resources/LocaleIndex.js

@@ -0,0 +1,91 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { TextNormalizer } from "../tokenization/normalizer.js";
+/**
+ * Index mapping a specific value to originating languages.
+ *
+ * If a value is present in this index, it means that the value is a valid value in at least one
+ * language.
+ */
+export class LocaleIndex extends Map {
+    /**
+     * The normalizer to use for placenames.
+     */
+    normalizer;
+    /**
+     * The source of the index.
+     */
+    displayName;
+    constructor(entries = [], options) {
+        super();
+        this.displayName = options?.displayName ?? "unknown";
+        this.normalizer = options?.normalizer;
+        for (const [placename, languageCodes] of entries) {
+            this.add(placename, ...languageCodes);
+        }
+    }
+    /**
+     * Add a placename to the index, associating it with the given language codes.
+     *
+     * @param placename The placename to add.
+     * @param languageCodes The language codes to associate with the placename.
+     */
+    add(placename, ...languageCodes) {
+        if (languageCodes.length === 0) {
+            throw new Error(`At least one language code must be provided for "${placename}".`);
+        }
+        if (this.normalizer) {
+            placename = this.normalizer.normalize(placename);
+            if (!this.normalizer.validate(placename))
+                return;
+        }
+        if (!placename)
+            return;
+        const placenameIndex = this.open(placename);
+        placenameIndex.displayName = this.displayName;
+        for (const language of languageCodes) {
+            placenameIndex.add(language);
+        }
+    }
+    /**
+     * Remove a placename from the index.
+     *
+     * @param placename The placename to remove.
+     */
+    remove(placename) {
+        if (this.normalizer) {
+            placename = this.normalizer.normalize(placename);
+        }
+        if (!placename)
+            return;
+        super.delete(placename);
+    }
+    open(placename) {
+        if (this.normalizer) {
+            placename = this.normalizer.normalize(placename);
+        }
+        if (!placename) {
+            throw new Error(`Placename "${placename}" is empty or invalid.`);
+        }
+        let placenameIndex = this.get(placename);
+        if (!placenameIndex) {
+            placenameIndex = new Set();
+            this.set(placename, placenameIndex);
+        }
+        return placenameIndex;
+    }
+    /**
+     * Serialize the index to JSON.
+     */
+    toJSON() {
+        const entries = [];
+        for (const [placename, languages] of this) {
+            entries.push([placename, Array.from(languages)]);
+        }
+        return entries;
+    }
+}
+//# sourceMappingURL=LocaleIndex.js.map

package/out/resources/LocaleIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleIndex.js","sourceRoot":"","sources":["../../resources/LocaleIndex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAW9D;;;;;GAKG;AACH,MAAM,OAAO,WAA0C,SAAQ,GAA+B;IAC7F;;OAEG;IACa,UAAU,CAAiB;IAE3C;;OAEG;IACI,WAAW,CAAQ;IAE1B,YAAY,UAAgE,EAAE,EAAE,OAA2B;QAC1G,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,SAAS,CAAA;QACpD,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAA;QAErC,KAAK,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,aAAa,CAAC,CAAA;QACtC,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,SAAiB,EAAE,GAAG,aAA8B;QAC9D,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oDAAoD,SAAS,IAAI,CAAC,CAAA;QACnF,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;YAEhD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAM;QACjD,CAAC;QAED,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAE3C,cAAc,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QAE7C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACtC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7B,CAAC;IACF,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAiB;QAC9B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACxB,CAAC;IAEM,IAAI,CAAC,SAAiB;QAC5B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACjD,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,cAAc,SAAS,wBAAwB,CAAC,CAAA;QACjE,CAAC;QAED,IAAI,cAAc,GAAgD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAErF,IAAI,CAAC,cAAc,EAAE,CAAC;YACrB,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAA;YACzC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QACpC,CAAC;QAED,OAAO,cAAc,CAAA;IACtB,CAAC;IAOD;;OAEG;IACI,MAAM;QACZ,MAAM,OAAO,GAAqC,EAAE,CAAA;QAEpD,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;QACjD,CAAC;QAED,OAAO,OAAO,CAAA;IACf,CAAC;CACD"}

package/out/resources/ResourceMapCache.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * A resource that can be disposed of either synchronously or asynchronously.
+ */
+export type DisposableLike = Disposable | AsyncDisposable;
+export type ResourceConstructor<K extends PropertyKey, R extends DisposableLike> = new (key: K) => R;
+export type ResourceFactory<K extends PropertyKey, R extends DisposableLike> = (key: K) => R | Promise<R>;
+export type ResourceFactoryLike<K extends PropertyKey = PropertyKey, R extends DisposableLike = DisposableLike> = ResourceConstructor<K, R> | ResourceFactory<K, R>;
+export type InferResource<F> = F extends ResourceConstructor<infer _K, infer R> ? R : F extends ResourceFactory<infer _K, infer R> ? R : never;
+export type OpenResourceResult<F> = F extends ResourceConstructor<infer _K, infer R> ? R : F extends ResourceFactory<infer _K, infer _R> ? ReturnType<F> : never;
+/**
+ * Type-guard to determine if a value is a promise-like object.
+ */
+export declare function isPromiseLike<T>(value: unknown): value is PromiseLike<T>;
+/**
+ * A map-like object that caches disposable resources, creating them on demand.
+ */
+export declare class ResourceMapCache<K extends PropertyKey = PropertyKey, R extends DisposableLike = DisposableLike, F extends ResourceFactoryLike<K, R> = ResourceConstructor<K, R>> extends Map<K, R> implements AsyncDisposable {
+    protected readonly factoryLike: F;
+    /**
+     * The human-readable name of the resource.
+     */
+    displayName: string;
+    constructor(ResourceConstructor: ResourceConstructor<K, R>);
+    constructor(factory: ResourceFactory<K, R>);
+    /**
+     * Gets a resource from the cache, creating if it doesn't exist.
+     */
+    open(key: K): OpenResourceResult<F>;
+    /**
+     * Closes a resource and removes it from the cache.
+     */
+    close(key: K): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=ResourceMapCache.d.ts.map

package/out/resources/ResourceMapCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceMapCache.d.ts","sourceRoot":"","sources":["../../resources/ResourceMapCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,CAAA;AAEzD,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,cAAc,IAAI,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;AACpG,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEzG,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,IAC3G,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GACzB,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAExB,MAAM,MAAM,aAAa,CAAC,CAAC,IAC1B,CAAC,SAAS,mBAAmB,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAEhH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC/B,CAAC,SAAS,mBAAmB,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,GAC7C,CAAC,GACD,CAAC,SAAS,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAC5C,UAAU,CAAC,CAAC,CAAC,GACb,KAAK,CAAA;AAUV;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAGxE;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAC5B,CAAC,SAAS,WAAW,GAAG,WAAW,EACnC,CAAC,SAAS,cAAc,GAAG,cAAc,EACzC,CAAC,SAAS,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAE/D,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAChB,YAAW,eAAe;IASd,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAP7C;;OAEG;IACI,WAAW,EAAE,MAAM,CAAqB;gBAEnC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9C,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAK1C;;OAEG;IACI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;IA4B1C;;OAEG;IACI,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAUb,CAAC,MAAM,CAAC,YAAY,CAAC;CASlC"}

package/out/resources/ResourceMapCache.js

@@ -0,0 +1,75 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Type-guard to determine if a function is a constructor.
+ */
+function isConstructor(value) {
+    if (typeof value !== "function")
+        return false;
+    return Boolean(value.prototype && value.prototype.constructor === value);
+}
+/**
+ * Type-guard to determine if a value is a promise-like object.
+ */
+export function isPromiseLike(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    return typeof value.then === "function";
+}
+/**
+ * A map-like object that caches disposable resources, creating them on demand.
+ */
+export class ResourceMapCache extends Map {
+    factoryLike;
+    /**
+     * The human-readable name of the resource.
+     */
+    displayName = "ResourceMapCache";
+    constructor(factoryLike) {
+        super();
+        this.factoryLike = factoryLike;
+    }
+    /**
+     * Gets a resource from the cache, creating if it doesn't exist.
+     */
+    open(key) {
+        const existingResource = super.get(key);
+        if (existingResource)
+            return existingResource;
+        if (isConstructor(this.factoryLike)) {
+            const resource = new this.factoryLike(key);
+            super.set(key, resource);
+            return resource;
+        }
+        const factoryResult = this.factoryLike(key);
+        if (isPromiseLike(factoryResult)) {
+            return factoryResult.then((resolvedResource) => {
+                super.set(key, resolvedResource);
+                return resolvedResource;
+            });
+        }
+        super.set(key, factoryResult);
+        return factoryResult;
+    }
+    /**
+     * Closes a resource and removes it from the cache.
+     */
+    close(key) {
+        const resource = super.get(key);
+        if (resource && Symbol.dispose in resource) {
+            resource[Symbol.dispose]();
+        }
+        super.delete(key);
+    }
+    async [Symbol.asyncDispose]() {
+        const resourceKeys = Array.from(super.keys()).reverse();
+        for (const resourceKey of resourceKeys) {
+            this.close(resourceKey);
+        }
+        super.clear();
+    }
+}
+//# sourceMappingURL=ResourceMapCache.js.map

package/out/resources/ResourceMapCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceMapCache.js","sourceRoot":"","sources":["../../resources/ResourceMapCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH;;GAEG;AACH,SAAS,aAAa,CAAI,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,KAAK,KAAK,CAAC,CAAA;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,OAAO,OAAQ,KAAwB,CAAC,IAAI,KAAK,UAAU,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,gBAKZ,SAAQ,GAAS;IAUc;IAP/B;;OAEG;IACI,WAAW,GAAW,kBAAkB,CAAA;IAI/C,YAA+B,WAAc;QAC5C,KAAK,EAAE,CAAA;QADuB,gBAAW,GAAX,WAAW,CAAG;IAE7C,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,GAAM;QACjB,MAAM,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEvC,IAAI,gBAAgB;YAAE,OAAO,gBAAyC,CAAA;QAEtE,IAAI,aAAa,CAA4B,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAChE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YAE1C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAExB,OAAO,QAAiC,CAAA;QACzC,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QAE3C,IAAI,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,EAAE;gBAC9C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;gBAEhC,OAAO,gBAAgB,CAAA;YACxB,CAAC,CAA0B,CAAA;QAC5B,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;QAE7B,OAAO,aAAsC,CAAA;IAC9C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,GAAM;QAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAE/B,IAAI,QAAQ,IAAI,MAAM,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC5C,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QAC3B,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IAEM,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACjC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;QAEvD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACxB,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;CACD"}

package/out/resources/collections.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { PathBuilderLike } from "path-ts";
+/**
+ * Given an iterable collection, returns an async iterable, executing the callback on each batch.
+ *
+ * This is useful for batching asynchronous operations.
+ *
+ * @param collection The collection to batch.
+ * @param batchSize The size of each batch.
+ * @param callback The async callback to execute on each batch.
+ */
+export declare function takeInParallel<T, C extends (entry: T) => Promise<unknown>>(collection: Iterable<T> | AsyncIterable<T>, batchSize: number, callback: C, abortSignal?: AbortSignal): AsyncIterable<Awaited<ReturnType<C>>>;
+/**
+ * Given an async iterable collection, returns an async iterable, yielding batches of items.
+ *
+ * This is useful for emitting asynchronous items in batches, such as when processing a stream of
+ * data.
+ */
+export declare function takeAsync<T>(collection: AsyncIterable<T>, batchSize: number): AsyncIterable<T[]>;
+/**
+ * Given a list of file patterns, returns the count of files that match the patterns.
+ */
+export declare function tallyPatternCount(patterns: string[], directory: PathBuilderLike): Promise<number>;
+//# sourceMappingURL=collections.d.ts.map

package/out/resources/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../resources/collections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C;;;;;;;;GAQG;AACH,wBAAuB,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAChF,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,EACX,WAAW,CAAC,EAAE,WAAW,GACvB,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAiDvC;AAED;;;;;GAKG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAgBvG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvG"}

package/out/resources/collections.js

@@ -0,0 +1,76 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { $ } from "zx";
+/**
+ * Given an iterable collection, returns an async iterable, executing the callback on each batch.
+ *
+ * This is useful for batching asynchronous operations.
+ *
+ * @param collection The collection to batch.
+ * @param batchSize The size of each batch.
+ * @param callback The async callback to execute on each batch.
+ */
+export async function* takeInParallel(collection, batchSize, callback, abortSignal) {
+    const iterator = Symbol.asyncIterator in collection ? collection[Symbol.asyncIterator]() : collection[Symbol.iterator]();
+    const runningTasks = new Map();
+    const results = new Map();
+    let iterationResult = await iterator.next();
+    while ((!iterationResult.done || results.size) && !abortSignal?.aborted) {
+        for (const [key, result] of results) {
+            yield result;
+            results.delete(key);
+        }
+        if (runningTasks.size >= batchSize) {
+            await Promise.race(runningTasks.values());
+            continue;
+        }
+        if (iterationResult.done) {
+            await Promise.all(runningTasks.values());
+            break;
+        }
+        const entry = iterationResult.value;
+        const futureResult = callback(entry).then((result) => {
+            runningTasks.delete(entry);
+            results.set(entry, result);
+        });
+        runningTasks.set(entry, futureResult);
+        iterationResult = await iterator.next();
+    }
+    if (!abortSignal || !abortSignal.aborted) {
+        await Promise.all(runningTasks.values());
+        for (const [key, result] of results) {
+            yield result;
+            results.delete(key);
+        }
+    }
+}
+/**
+ * Given an async iterable collection, returns an async iterable, yielding batches of items.
+ *
+ * This is useful for emitting asynchronous items in batches, such as when processing a stream of
+ * data.
+ */
+export async function* takeAsync(collection, batchSize) {
+    let buffer = [];
+    for await (const item of collection) {
+        buffer.push(item);
+        if (buffer.length === batchSize) {
+            yield buffer;
+            buffer = [];
+        }
+    }
+    if (buffer.length !== 0) {
+        yield buffer;
+    }
+}
+/**
+ * Given a list of file patterns, returns the count of files that match the patterns.
+ */
+export async function tallyPatternCount(patterns, directory) {
+    const result = await $ `find ${directory} -name ${patterns.join(" -o -name ")} | wc -l`;
+    return parseInt(result.stdout);
+}
+//# sourceMappingURL=collections.js.map

package/out/resources/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../resources/collections.ts"],"names":[],"mappings":"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"}

package/out/resources/db/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export {};
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+//# sourceMappingURL=index.d.ts.map

package/out/resources/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../resources/db/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG"}

package/out/resources/db/index.js

@@ -0,0 +1,57 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export {};
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+//# sourceMappingURL=index.js.map

package/out/resources/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../resources/db/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG"}

package/out/resources/debugging.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * A resource with a display name.
+ */
+export type Displayable<T> = T & {
+    displayName?: string;
+};
+/**
+ * Type predicate to determine if a value is displayable.
+ */
+export declare function isDisplayable<T>(value: T): value is Displayable<T>;
+//# sourceMappingURL=debugging.d.ts.map

package/out/resources/debugging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugging.d.ts","sourceRoot":"","sources":["../../resources/debugging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAElE"}

package/out/resources/debugging.js

@@ -0,0 +1,12 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Type predicate to determine if a value is displayable.
+ */
+export function isDisplayable(value) {
+    return typeof value === "object" && value !== null && "displayName" in value;
+}
+//# sourceMappingURL=debugging.js.map

package/out/resources/debugging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugging.js","sourceRoot":"","sources":["../../resources/debugging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,aAAa,IAAI,KAAK,CAAA;AAC7E,CAAC"}

package/out/resources/fs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { Stats } from "node:fs";
+import type { PathBuilderLike } from "path-ts";
+/**
+ * Attempts to stat a file or directory.
+ */
+export declare function tryStat(pathBuilderLike: PathBuilderLike): Promise<Stats | null>;
+//# sourceMappingURL=fs.d.ts.map

package/out/resources/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../resources/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;GAEG;AACH,wBAAgB,OAAO,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAE/E"}

package/out/resources/fs.js

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { stat } from "node:fs/promises";
+/**
+ * Attempts to stat a file or directory.
+ */
+export function tryStat(pathBuilderLike) {
+    return stat(pathBuilderLike).catch(() => null);
+}
+//# sourceMappingURL=fs.js.map

package/out/resources/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../resources/fs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAGvC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,eAAgC;IACvD,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;AAC/C,CAAC"}

package/out/resources/git.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { PathBuilder, type PathBuilderLike } from "path-ts";
+/**
+ * Metadata for a repository source.
+ */
+export interface RepositorySource {
+    name: string;
+    owner: string;
+    url: string;
+}
+export declare function prepareRepositoryDirectories({ name, owner }: RepositorySource, localRepoDirectory: PathBuilderLike): Promise<{
+    ownerDirectory: PathBuilder<`${string}/${string}`>;
+    repoDirectory: PathBuilder<`${string}/${string}/${string}`>;
+    exists: import("fs").Stats | null;
+}>;
+/**
+ * Synchronize a repository source, i.e. clone or pull the repository.
+ */
+export declare function synchronizeRepo(source: RepositorySource, localRepoDirectory: PathBuilderLike): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/out/resources/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../resources/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAI3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACX;AAED,wBAAsB,4BAA4B,CACjD,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,gBAAgB,EACjC,kBAAkB,EAAE,eAAe;;;;GAUnC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBlH"}

package/out/resources/git.js

@@ -0,0 +1,36 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import * as fs from "node:fs/promises";
+import { PathBuilder } from "path-ts";
+import { $ } from "zx";
+import { tryStat } from "./fs.js";
+export async function prepareRepositoryDirectories({ name, owner }, localRepoDirectory) {
+    const ownerDirectory = PathBuilder.from(localRepoDirectory, owner);
+    const repoDirectory = ownerDirectory(name);
+    await fs.mkdir(ownerDirectory, { recursive: true });
+    const exists = await tryStat(repoDirectory);
+    return { ownerDirectory, repoDirectory, exists };
+}
+/**
+ * Synchronize a repository source, i.e. clone or pull the repository.
+ */
+export async function synchronizeRepo(source, localRepoDirectory) {
+    if (source.name.includes("deprecated"))
+        return;
+    const { ownerDirectory, repoDirectory, exists } = await prepareRepositoryDirectories(source, localRepoDirectory);
+    if (exists) {
+        const shell = $({
+            cwd: repoDirectory.toString(),
+        });
+        await shell `git pull`;
+        return;
+    }
+    const shell = $({
+        cwd: ownerDirectory.toString(),
+    });
+    await shell `git clone --depth=1 ${source.url}`;
+}
+//# sourceMappingURL=git.js.map

package/out/resources/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../resources/git.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAAE,WAAW,EAAwB,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,IAAI,CAAA;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAWjC,MAAM,CAAC,KAAK,UAAU,4BAA4B,CACjD,EAAE,IAAI,EAAE,KAAK,EAAoB,EACjC,kBAAmC;IAEnC,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;IAClE,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;IAE1C,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAEnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAA;IAE3C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAwB,EAAE,kBAAmC;IAClG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAM;IAE9C,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,4BAA4B,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAEhH,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,CAAC,CAAC;YACf,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE;SAC7B,CAAC,CAAA;QAEF,MAAM,KAAK,CAAA,UAAU,CAAA;QAErB,OAAM;IACP,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,CAAC;QACf,GAAG,EAAE,cAAc,CAAC,QAAQ,EAAE;KAC9B,CAAC,CAAA;IAEF,MAAM,KAAK,CAAA,uBAAuB,MAAM,CAAC,GAAG,EAAE,CAAA;AAC/C,CAAC"}

package/out/resources/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./collections.js";
+export * from "./db/index.js";
+export * from "./debugging.js";
+export * from "./fs.js";
+export * from "./git.js";
+export * from "./languages/index.js";
+export * from "./libaddressinput.js";
+export * from "./libpostal.js";
+export * from "./locale.js";
+export * from "./LocaleIndex.js";
+export * from "./ResourceMapCache.js";
+export * from "./set.js";
+export * from "./whosonfirst/index.js";
+//# sourceMappingURL=index.d.ts.map

package/out/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,wBAAwB,CAAA"}

package/out/resources/index.js

@@ -0,0 +1,19 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./collections.js";
+export * from "./db/index.js";
+export * from "./debugging.js";
+export * from "./fs.js";
+export * from "./git.js";
+export * from "./languages/index.js";
+export * from "./libaddressinput.js";
+export * from "./libpostal.js";
+export * from "./locale.js";
+export * from "./LocaleIndex.js";
+export * from "./ResourceMapCache.js";
+export * from "./set.js";
+export * from "./whosonfirst/index.js";
+//# sourceMappingURL=index.js.map

package/out/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../resources/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,wBAAwB,CAAA"}