@sourceaxis/shared 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# @sourceaxis/shared
+
+Shared implementation utilities for SourceAxis packages.
+
+## Responsibilities
+
+- Provide small assertion, async, constant, guard, object, path, string, and type helpers.
+- Avoid provider-specific behavior.
+- Keep common implementation utilities out of public runtime package internals.
+
+## Install
+
+```sh
+pnpm add @sourceaxis/shared
+```
+
+Applications usually do not need this package directly. Prefer the public APIs exposed by
+`@sourceaxis/core`, provider packages, and `@sourceaxis/contracts`.
+
+## Usage
+
+```ts
+import { deepFreeze } from "@sourceaxis/shared";
+
+const value = deepFreeze({ stable: true });
+```

package/dist/cjs/assertions/index.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = assert;
+exports.assertDefined = assertDefined;
+exports.assertNever = assertNever;
+exports.unreachable = unreachable;
+/**
+ * Asserts that a condition is truthy.
+ *
+ * @throws Error when the condition is false.
+ */
+function assert(condition, message = "Assertion failed") {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+/**
+ * Asserts that a value is neither null nor undefined.
+ *
+ * @throws Error when the value is null or undefined.
+ */
+function assertDefined(value, message = "Expected value to be defined") {
+    if (value === null || value === undefined) {
+        throw new Error(message);
+    }
+}
+/**
+ * Exhaustiveness helper for discriminated unions.
+ *
+ * @throws Error when reached at runtime.
+ */
+function assertNever(value, message = "Unexpected value") {
+    throw new Error(`${message}: ${String(value)}`);
+}
+/**
+ * Marks code paths that should be unreachable.
+ *
+ * @throws Error whenever called.
+ */
+function unreachable(message = "Unreachable code reached") {
+    throw new Error(message);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/assertions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAKA,wBAIC;AAOD,sCAOC;AAOD,kCAEC;AAOD,kCAEC;AAzCD;;;;GAIG;AACH,SAAgB,MAAM,CAAC,SAAkB,EAAE,OAAO,GAAG,kBAAkB;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAC3B,KAAQ,EACR,OAAO,GAAG,8BAA8B;IAExC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,KAAY,EAAE,OAAO,GAAG,kBAAkB;IACpE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,OAAO,GAAG,0BAA0B;IAC9D,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cjs/async/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deferred = deferred;
+exports.raceAbort = raceAbort;
+exports.sleep = sleep;
+/**
+ * Creates a Promise with externally exposed resolve and reject callbacks.
+ */
+function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((promiseResolve, promiseReject) => {
+        resolve = promiseResolve;
+        reject = promiseReject;
+    });
+    return { promise, resolve, reject };
+}
+/**
+ * Races a Promise-like operation against an AbortSignal.
+ */
+function raceAbort(operation, signal) {
+    if (signal === undefined) {
+        return Promise.resolve(operation);
+    }
+    if (signal.aborted) {
+        return Promise.reject(createAbortError(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(createAbortError(signal));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        Promise.resolve(operation).then((value) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(error);
+        });
+    });
+}
+/**
+ * Resolves after the requested delay unless aborted.
+ */
+function sleep(milliseconds, signal) {
+    if (signal === undefined) {
+        return new Promise((resolve) => {
+            setTimeout(resolve, milliseconds);
+        });
+    }
+    if (signal.aborted) {
+        return Promise.reject(createAbortError(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, milliseconds);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            reject(createAbortError(signal));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function createAbortError(signal) {
+    return signal.reason instanceof Error ? signal.reason : new Error("Operation aborted");
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/async/index.js.map

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

package/dist/cjs/constants/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_OBJECT = exports.EMPTY_ARRAY = void 0;
+/**
+ * Shared immutable empty array sentinel.
+ */
+exports.EMPTY_ARRAY = Object.freeze([]);
+/**
+ * Shared immutable empty object sentinel.
+ */
+exports.EMPTY_OBJECT = Object.freeze({});
+//# sourceMappingURL=index.js.map

package/dist/cjs/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACU,QAAA,WAAW,GAAqB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/D;;GAEG;AACU,QAAA,YAAY,GAAyC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/cjs/guards/index.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDefined = isDefined;
+exports.isString = isString;
+exports.isNumber = isNumber;
+exports.isBoolean = isBoolean;
+exports.isObject = isObject;
+exports.isPlainObject = isPlainObject;
+exports.isRecord = isRecord;
+exports.isError = isError;
+/**
+ * Returns true when a value is neither null nor undefined.
+ */
+function isDefined(value) {
+    return value !== null && value !== undefined;
+}
+/**
+ * Returns true when a value is a string.
+ */
+function isString(value) {
+    return typeof value === "string";
+}
+/**
+ * Returns true when a value is a finite number.
+ */
+function isNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+/**
+ * Returns true when a value is a boolean.
+ */
+function isBoolean(value) {
+    return typeof value === "boolean";
+}
+/**
+ * Returns true when a value is a non-null object.
+ */
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+/**
+ * Returns true when a value is an object literal or a null-prototype object.
+ */
+function isPlainObject(value) {
+    if (!isObject(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Returns true when a value can be treated as an object record.
+ */
+function isRecord(value) {
+    return isObject(value) && !Array.isArray(value);
+}
+/**
+ * Returns true when a value is an Error instance.
+ */
+function isError(value) {
+    return value instanceof Error;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAGA,8BAEC;AAKD,4BAEC;AAKD,4BAEC;AAKD,8BAEC;AAKD,4BAEC;AAKD,sCAOC;AAKD,4BAEC;AAKD,0BAEC;AA3DD;;GAEG;AACH,SAAgB,SAAS,CAAI,KAAQ;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./assertions/index.js"), exports);
+__exportStar(require("./async/index.js"), exports);
+__exportStar(require("./constants/index.js"), exports);
+__exportStar(require("./guards/index.js"), exports);
+__exportStar(require("./objects/index.js"), exports);
+__exportStar(require("./paths/index.js"), exports);
+__exportStar(require("./strings/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,mDAAiC;AACjC,uDAAqC;AACrC,oDAAkC;AAClC,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,mDAAiC"}

package/dist/cjs/objects/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepFreeze = deepFreeze;
+exports.hasOwn = hasOwn;
+exports.isEmptyObject = isEmptyObject;
+exports.mergeDefined = mergeDefined;
+/**
+ * Recursively freezes an object and its object-valued own properties.
+ */
+function deepFreeze(value) {
+    if (value === null || (typeof value !== "object" && typeof value !== "function")) {
+        return value;
+    }
+    for (const key of Reflect.ownKeys(value)) {
+        const child = value[key];
+        if (child !== null && (typeof child === "object" || typeof child === "function")) {
+            deepFreeze(child);
+        }
+    }
+    return Object.freeze(value);
+}
+/**
+ * Returns true when an object owns a property directly.
+ */
+function hasOwn(object, key) {
+    return Object.prototype.hasOwnProperty.call(object, key);
+}
+/**
+ * Returns true when an object has no own string or symbol keys.
+ */
+function isEmptyObject(object) {
+    return Reflect.ownKeys(object).length === 0;
+}
+/**
+ * Returns a shallow merge where undefined source values are ignored.
+ */
+function mergeDefined(target, ...sources) {
+    const result = { ...target };
+    for (const source of sources) {
+        for (const key of Reflect.ownKeys(source)) {
+            const value = source[key];
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/objects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAKA,gCAcC;AAKD,wBAKC;AAKD,sCAEC;AAKD,oCAiBC;AAxDD;;GAEG;AACH,SAAgB,UAAU,CAAI,KAAQ;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;QACjF,OAAO,KAAwB,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAI,KAAsC,CAAC,GAAG,CAAC,CAAC;QAE3D,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,EAAE,CAAC;YACjF,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAoB,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CACpB,MAAS,EACT,GAAM;IAEN,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAC1B,MAAS,EACT,GAAG,OAAiE;IAEpE,MAAM,MAAM,GAAe,EAAE,GAAG,MAAM,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAmB,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/paths/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.basename = basename;
+exports.dirname = dirname;
+exports.joinPath = joinPath;
+exports.normalizePath = normalizePath;
+exports.splitPath = splitPath;
+/**
+ * Returns the final segment of a slash-delimited path.
+ */
+function basename(path) {
+    const parts = splitPath(path);
+    return parts.at(-1) ?? "";
+}
+/**
+ * Returns every segment before the final segment of a slash-delimited path.
+ */
+function dirname(path) {
+    const normalized = normalizePath(path);
+    const absolute = normalized.startsWith("/");
+    const parts = splitPath(normalized);
+    if (parts.length <= 1) {
+        return absolute ? "/" : "";
+    }
+    const directory = parts.slice(0, -1).join("/");
+    return absolute ? `/${directory}` : directory;
+}
+/**
+ * Joins path segments using forward slashes and normalizes the result.
+ */
+function joinPath(...segments) {
+    return normalizePath(segments.filter((segment) => segment.length > 0).join("/"));
+}
+/**
+ * Normalizes a path to forward slashes, removes duplicate separators, and resolves dot segments.
+ */
+function normalizePath(path) {
+    const slashPath = path.replace(/\\/g, "/");
+    const absolute = slashPath.startsWith("/");
+    const output = [];
+    for (const segment of slashPath.split("/")) {
+        if (segment === "" || segment === ".") {
+            continue;
+        }
+        if (segment === "..") {
+            if (output.length > 0 && output.at(-1) !== "..") {
+                output.pop();
+            }
+            else if (!absolute) {
+                output.push(segment);
+            }
+            continue;
+        }
+        output.push(segment);
+    }
+    const normalized = output.join("/");
+    if (absolute) {
+        return normalized.length > 0 ? `/${normalized}` : "/";
+    }
+    return normalized;
+}
+/**
+ * Splits a normalized path into non-empty segments.
+ */
+function splitPath(path) {
+    const normalized = normalizePath(path);
+    return normalized.split("/").filter((segment) => segment.length > 0);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/paths/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAGA,4BAGC;AAKD,0BAWC;AAKD,4BAEC;AAKD,sCA8BC;AAKD,8BAGC;AAxED;;GAEG;AACH,SAAgB,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,IAAY;IAClC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CAAC,GAAG,QAA2B;IACrD,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YAED,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAY;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/cjs/strings/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capitalize = capitalize;
+exports.isBlank = isBlank;
+exports.trimStartSlash = trimStartSlash;
+exports.trimEndSlash = trimEndSlash;
+exports.normalizeLineEndings = normalizeLineEndings;
+/**
+ * Uppercases the first character of a string.
+ */
+function capitalize(value) {
+    if (value.length === 0) {
+        return value;
+    }
+    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+}
+/**
+ * Returns true when a string contains only whitespace.
+ */
+function isBlank(value) {
+    return value.trim().length === 0;
+}
+/**
+ * Removes leading forward slashes.
+ */
+function trimStartSlash(value) {
+    return value.replace(/^\/+/, "");
+}
+/**
+ * Removes trailing forward slashes.
+ */
+function trimEndSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+/**
+ * Converts CRLF and CR line endings to LF.
+ */
+function normalizeLineEndings(value) {
+    return value.replace(/\r\n?/g, "\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/strings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAGA,gCAMC;AAKD,0BAEC;AAKD,wCAEC;AAKD,oCAEC;AAKD,oDAEC;AArCD;;GAEG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":""}

package/dist/esm/assertions/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Asserts that a condition is truthy.
+ *
+ * @throws Error when the condition is false.
+ */
+export declare function assert(condition: unknown, message?: string): asserts condition;
+/**
+ * Asserts that a value is neither null nor undefined.
+ *
+ * @throws Error when the value is null or undefined.
+ */
+export declare function assertDefined<T>(value: T, message?: string): asserts value is NonNullable<T>;
+/**
+ * Exhaustiveness helper for discriminated unions.
+ *
+ * @throws Error when reached at runtime.
+ */
+export declare function assertNever(value: never, message?: string): never;
+/**
+ * Marks code paths that should be unreachable.
+ *
+ * @throws Error whenever called.
+ */
+export declare function unreachable(message?: string): never;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/assertions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/assertions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,SAAqB,GAAG,OAAO,CAAC,SAAS,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,SAAiC,GACvC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAIjC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,SAAqB,GAAG,KAAK,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAA6B,GAAG,KAAK,CAEvE"}

package/dist/esm/assertions/index.js

@@ -0,0 +1,36 @@
+/**
+ * Asserts that a condition is truthy.
+ *
+ * @throws Error when the condition is false.
+ */
+export function assert(condition, message = "Assertion failed") {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+/**
+ * Asserts that a value is neither null nor undefined.
+ *
+ * @throws Error when the value is null or undefined.
+ */
+export function assertDefined(value, message = "Expected value to be defined") {
+    if (value === null || value === undefined) {
+        throw new Error(message);
+    }
+}
+/**
+ * Exhaustiveness helper for discriminated unions.
+ *
+ * @throws Error when reached at runtime.
+ */
+export function assertNever(value, message = "Unexpected value") {
+    throw new Error(`${message}: ${String(value)}`);
+}
+/**
+ * Marks code paths that should be unreachable.
+ *
+ * @throws Error whenever called.
+ */
+export function unreachable(message = "Unreachable code reached") {
+    throw new Error(message);
+}

package/dist/esm/async/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A Promise with externally controlled resolution functions.
+ */
+export interface Deferred<T> {
+    /**
+     * The Promise controlled by this deferred value.
+     */
+    readonly promise: Promise<T>;
+    /**
+     * Resolves the Promise.
+     */
+    readonly resolve: (value: T | PromiseLike<T>) => void;
+    /**
+     * Rejects the Promise.
+     */
+    readonly reject: (reason?: unknown) => void;
+}
+/**
+ * Creates a Promise with externally exposed resolve and reject callbacks.
+ */
+export declare function deferred<T>(): Deferred<T>;
+/**
+ * Races a Promise-like operation against an AbortSignal.
+ */
+export declare function raceAbort<T>(operation: PromiseLike<T>, signal?: AbortSignal): Promise<T>;
+/**
+ * Resolves after the requested delay unless aborted.
+ */
+export declare function sleep(milliseconds: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/async/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/async/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAUzC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CA2BxF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/E"}

package/dist/esm/async/index.js

@@ -0,0 +1,63 @@
+/**
+ * Creates a Promise with externally exposed resolve and reject callbacks.
+ */
+export function deferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((promiseResolve, promiseReject) => {
+        resolve = promiseResolve;
+        reject = promiseReject;
+    });
+    return { promise, resolve, reject };
+}
+/**
+ * Races a Promise-like operation against an AbortSignal.
+ */
+export function raceAbort(operation, signal) {
+    if (signal === undefined) {
+        return Promise.resolve(operation);
+    }
+    if (signal.aborted) {
+        return Promise.reject(createAbortError(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            reject(createAbortError(signal));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        Promise.resolve(operation).then((value) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(error);
+        });
+    });
+}
+/**
+ * Resolves after the requested delay unless aborted.
+ */
+export function sleep(milliseconds, signal) {
+    if (signal === undefined) {
+        return new Promise((resolve) => {
+            setTimeout(resolve, milliseconds);
+        });
+    }
+    if (signal.aborted) {
+        return Promise.reject(createAbortError(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, milliseconds);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            reject(createAbortError(signal));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+function createAbortError(signal) {
+    return signal.reason instanceof Error ? signal.reason : new Error("Operation aborted");
+}

package/dist/esm/constants/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared immutable empty array sentinel.
+ */
+export declare const EMPTY_ARRAY: readonly never[];
+/**
+ * Shared immutable empty object sentinel.
+ */
+export declare const EMPTY_OBJECT: Readonly<Record<PropertyKey, never>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,KAAK,EAAsB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAqB,CAAC"}

package/dist/esm/constants/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared immutable empty array sentinel.
+ */
+export const EMPTY_ARRAY = Object.freeze([]);
+/**
+ * Shared immutable empty object sentinel.
+ */
+export const EMPTY_OBJECT = Object.freeze({});

package/dist/esm/guards/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Returns true when a value is neither null nor undefined.
+ */
+export declare function isDefined<T>(value: T): value is NonNullable<T>;
+/**
+ * Returns true when a value is a string.
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Returns true when a value is a finite number.
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Returns true when a value is a boolean.
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Returns true when a value is a non-null object.
+ */
+export declare function isObject(value: unknown): value is object;
+/**
+ * Returns true when a value is an object literal or a null-prototype object.
+ */
+export declare function isPlainObject(value: unknown): value is Record<PropertyKey, unknown>;
+/**
+ * Returns true when a value can be treated as an object record.
+ */
+export declare function isRecord(value: unknown): value is Record<PropertyKey, unknown>;
+/**
+ * Returns true when a value is an Error instance.
+ */
+export declare function isError(value: unknown): value is Error;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAOnF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD"}

package/dist/esm/guards/index.js

@@ -0,0 +1,52 @@
+/**
+ * Returns true when a value is neither null nor undefined.
+ */
+export function isDefined(value) {
+    return value !== null && value !== undefined;
+}
+/**
+ * Returns true when a value is a string.
+ */
+export function isString(value) {
+    return typeof value === "string";
+}
+/**
+ * Returns true when a value is a finite number.
+ */
+export function isNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+/**
+ * Returns true when a value is a boolean.
+ */
+export function isBoolean(value) {
+    return typeof value === "boolean";
+}
+/**
+ * Returns true when a value is a non-null object.
+ */
+export function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+/**
+ * Returns true when a value is an object literal or a null-prototype object.
+ */
+export function isPlainObject(value) {
+    if (!isObject(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Returns true when a value can be treated as an object record.
+ */
+export function isRecord(value) {
+    return isObject(value) && !Array.isArray(value);
+}
+/**
+ * Returns true when a value is an Error instance.
+ */
+export function isError(value) {
+    return value instanceof Error;
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./assertions/index.js";
+export * from "./async/index.js";
+export * from "./constants/index.js";
+export * from "./guards/index.js";
+export * from "./objects/index.js";
+export * from "./paths/index.js";
+export * from "./strings/index.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+export * from "./assertions/index.js";
+export * from "./async/index.js";
+export * from "./constants/index.js";
+export * from "./guards/index.js";
+export * from "./objects/index.js";
+export * from "./paths/index.js";
+export * from "./strings/index.js";
+export * from "./types/index.js";

package/dist/esm/objects/index.d.ts

@@ -0,0 +1,20 @@
+import type { DeepReadonly } from "../types/index.js";
+/**
+ * Recursively freezes an object and its object-valued own properties.
+ */
+export declare function deepFreeze<T>(value: T): DeepReadonly<T>;
+/**
+ * Returns true when an object owns a property directly.
+ */
+export declare function hasOwn<T extends object, K extends PropertyKey>(object: T, key: K): object is T & Record<K, unknown>;
+/**
+ * Returns true when an object has no own string or symbol keys.
+ */
+export declare function isEmptyObject(object: object): boolean;
+/**
+ * Returns a shallow merge where undefined source values are ignored.
+ */
+export declare function mergeDefined<T extends object>(target: T, ...sources: ReadonlyArray<{
+    [Key in keyof T]?: T[Key] | undefined;
+}>): T;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/objects/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAcvD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,WAAW,EAC5D,MAAM,EAAE,CAAC,EACT,GAAG,EAAE,CAAC,GACL,MAAM,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAElC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,MAAM,EAAE,CAAC,EACT,GAAG,OAAO,EAAE,aAAa,CAAC;KAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;CAAE,CAAC,GACnE,CAAC,CAcH"}

package/dist/esm/objects/index.js

@@ -0,0 +1,42 @@
+/**
+ * Recursively freezes an object and its object-valued own properties.
+ */
+export function deepFreeze(value) {
+    if (value === null || (typeof value !== "object" && typeof value !== "function")) {
+        return value;
+    }
+    for (const key of Reflect.ownKeys(value)) {
+        const child = value[key];
+        if (child !== null && (typeof child === "object" || typeof child === "function")) {
+            deepFreeze(child);
+        }
+    }
+    return Object.freeze(value);
+}
+/**
+ * Returns true when an object owns a property directly.
+ */
+export function hasOwn(object, key) {
+    return Object.prototype.hasOwnProperty.call(object, key);
+}
+/**
+ * Returns true when an object has no own string or symbol keys.
+ */
+export function isEmptyObject(object) {
+    return Reflect.ownKeys(object).length === 0;
+}
+/**
+ * Returns a shallow merge where undefined source values are ignored.
+ */
+export function mergeDefined(target, ...sources) {
+    const result = { ...target };
+    for (const source of sources) {
+        for (const key of Reflect.ownKeys(source)) {
+            const value = source[key];
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}

package/dist/esm/paths/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Returns the final segment of a slash-delimited path.
+ */
+export declare function basename(path: string): string;
+/**
+ * Returns every segment before the final segment of a slash-delimited path.
+ */
+export declare function dirname(path: string): string;
+/**
+ * Joins path segments using forward slashes and normalizes the result.
+ */
+export declare function joinPath(...segments: readonly string[]): string;
+/**
+ * Normalizes a path to forward slashes, removes duplicate separators, and resolves dot segments.
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Splits a normalized path into non-empty segments.
+ */
+export declare function splitPath(path: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/paths/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/paths/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BlD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD"}

package/dist/esm/paths/index.js

@@ -0,0 +1,61 @@
+/**
+ * Returns the final segment of a slash-delimited path.
+ */
+export function basename(path) {
+    const parts = splitPath(path);
+    return parts.at(-1) ?? "";
+}
+/**
+ * Returns every segment before the final segment of a slash-delimited path.
+ */
+export function dirname(path) {
+    const normalized = normalizePath(path);
+    const absolute = normalized.startsWith("/");
+    const parts = splitPath(normalized);
+    if (parts.length <= 1) {
+        return absolute ? "/" : "";
+    }
+    const directory = parts.slice(0, -1).join("/");
+    return absolute ? `/${directory}` : directory;
+}
+/**
+ * Joins path segments using forward slashes and normalizes the result.
+ */
+export function joinPath(...segments) {
+    return normalizePath(segments.filter((segment) => segment.length > 0).join("/"));
+}
+/**
+ * Normalizes a path to forward slashes, removes duplicate separators, and resolves dot segments.
+ */
+export function normalizePath(path) {
+    const slashPath = path.replace(/\\/g, "/");
+    const absolute = slashPath.startsWith("/");
+    const output = [];
+    for (const segment of slashPath.split("/")) {
+        if (segment === "" || segment === ".") {
+            continue;
+        }
+        if (segment === "..") {
+            if (output.length > 0 && output.at(-1) !== "..") {
+                output.pop();
+            }
+            else if (!absolute) {
+                output.push(segment);
+            }
+            continue;
+        }
+        output.push(segment);
+    }
+    const normalized = output.join("/");
+    if (absolute) {
+        return normalized.length > 0 ? `/${normalized}` : "/";
+    }
+    return normalized;
+}
+/**
+ * Splits a normalized path into non-empty segments.
+ */
+export function splitPath(path) {
+    const normalized = normalizePath(path);
+    return normalized.split("/").filter((segment) => segment.length > 0);
+}

package/dist/esm/strings/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Uppercases the first character of a string.
+ */
+export declare function capitalize(value: string): string;
+/**
+ * Returns true when a string contains only whitespace.
+ */
+export declare function isBlank(value: string): boolean;
+/**
+ * Removes leading forward slashes.
+ */
+export declare function trimStartSlash(value: string): string;
+/**
+ * Removes trailing forward slashes.
+ */
+export declare function trimEndSlash(value: string): string;
+/**
+ * Converts CRLF and CR line endings to LF.
+ */
+export declare function normalizeLineEndings(value: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/strings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/strings/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/esm/strings/index.js

@@ -0,0 +1,33 @@
+/**
+ * Uppercases the first character of a string.
+ */
+export function capitalize(value) {
+    if (value.length === 0) {
+        return value;
+    }
+    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+}
+/**
+ * Returns true when a string contains only whitespace.
+ */
+export function isBlank(value) {
+    return value.trim().length === 0;
+}
+/**
+ * Removes leading forward slashes.
+ */
+export function trimStartSlash(value) {
+    return value.replace(/^\/+/, "");
+}
+/**
+ * Removes trailing forward slashes.
+ */
+export function trimEndSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+/**
+ * Converts CRLF and CR line endings to LF.
+ */
+export function normalizeLineEndings(value) {
+    return value.replace(/\r\n?/g, "\n");
+}

package/dist/esm/types/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A value that may be returned directly or through a Promise.
+ */
+export type Awaitable<T> = T | Promise<T>;
+/**
+ * Recursively makes every property optional.
+ */
+export type DeepPartial<T> = T extends Primitive | ((...args: never[]) => unknown) ? T : T extends readonly (infer Item)[] ? readonly DeepPartial<Item>[] : {
+    readonly [Key in keyof T]?: DeepPartial<T[Key]>;
+};
+/**
+ * Recursively makes every property readonly.
+ */
+export type DeepReadonly<T> = T extends Primitive | ((...args: never[]) => unknown) ? T : T extends readonly (infer Item)[] ? readonly DeepReadonly<Item>[] : {
+    readonly [Key in keyof T]: DeepReadonly<T[Key]>;
+};
+/**
+ * A value that may be undefined.
+ */
+export type Maybe<T> = T | undefined;
+/**
+ * A value that may be returned directly or through a Promise-like value.
+ */
+export type MaybePromise<T> = T | PromiseLike<T>;
+/**
+ * A readonly array with at least one item.
+ */
+export type NonEmptyArray<T> = readonly [T, ...T[]];
+/**
+ * A value that may be null.
+ */
+export type Nullable<T> = T | null;
+/**
+ * Primitive JavaScript values.
+ */
+export type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+/**
+ * Flattens an object type for easier editor display.
+ */
+export type Prettify<T> = {
+    [Key in keyof T]: T[Key];
+} & {};
+/**
+ * The union of an object's value types.
+ */
+export type ValueOf<T> = T[keyof T];
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAC9E,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAC/B,SAAS,WAAW,CAAC,IAAI,CAAC,EAAE,GAC5B;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,GAC/E,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,GAC/B,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GAC7B;IAAE,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACvB,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;CACzB,GAAG,EAAE,CAAC;AAEP;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/esm/types/index.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@sourceaxis/shared",
+  "version": "0.1.0",
+  "description": "Provider-neutral shared utilities for SourceAxis packages.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./assertions": {
+      "types": "./dist/esm/assertions/index.d.ts",
+      "import": "./dist/esm/assertions/index.js",
+      "require": "./dist/cjs/assertions/index.js",
+      "default": "./dist/esm/assertions/index.js"
+    },
+    "./async": {
+      "types": "./dist/esm/async/index.d.ts",
+      "import": "./dist/esm/async/index.js",
+      "require": "./dist/cjs/async/index.js",
+      "default": "./dist/esm/async/index.js"
+    },
+    "./constants": {
+      "types": "./dist/esm/constants/index.d.ts",
+      "import": "./dist/esm/constants/index.js",
+      "require": "./dist/cjs/constants/index.js",
+      "default": "./dist/esm/constants/index.js"
+    },
+    "./guards": {
+      "types": "./dist/esm/guards/index.d.ts",
+      "import": "./dist/esm/guards/index.js",
+      "require": "./dist/cjs/guards/index.js",
+      "default": "./dist/esm/guards/index.js"
+    },
+    "./objects": {
+      "types": "./dist/esm/objects/index.d.ts",
+      "import": "./dist/esm/objects/index.js",
+      "require": "./dist/cjs/objects/index.js",
+      "default": "./dist/esm/objects/index.js"
+    },
+    "./paths": {
+      "types": "./dist/esm/paths/index.d.ts",
+      "import": "./dist/esm/paths/index.js",
+      "require": "./dist/cjs/paths/index.js",
+      "default": "./dist/esm/paths/index.js"
+    },
+    "./strings": {
+      "types": "./dist/esm/strings/index.d.ts",
+      "import": "./dist/esm/strings/index.js",
+      "require": "./dist/cjs/strings/index.js",
+      "default": "./dist/esm/strings/index.js"
+    },
+    "./types": {
+      "types": "./dist/esm/types/index.d.ts",
+      "import": "./dist/esm/types/index.js",
+      "require": "./dist/cjs/types/index.js",
+      "default": "./dist/esm/types/index.js"
+    }
+  },
+  "types": "./dist/esm/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.esm.json && node ../../scripts/build/build-cjs.mjs .",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mriduldey/source-axis.git",
+    "directory": "packages/shared"
+  },
+  "bugs": {
+    "url": "https://github.com/mriduldey/source-axis/issues"
+  },
+  "homepage": "https://github.com/mriduldey/source-axis#readme",
+  "keywords": [
+    "git",
+    "github",
+    "sdk",
+    "typescript",
+    "provider-neutral"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}