@ls-stack/utils 2.14.1 → 3.2.0

package/dist/typingTestUtils.d.ts

@@ -2,11 +2,37 @@ type TestTypeIsEqual<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T e
 type TestTypeNotEqual<X, Y> = true extends TestTypeIsEqual<X, Y> ? false : true;
 declare function test(title: string, func: () => any): void;
 declare function describe(title: string, func: () => any): void;
+/**
+ * Helper function for type testing that ensures a type extends `true`.
+ * Used in combination with `TestTypeIsEqual` to verify type equality at compile time.
+ *
+ * @example
+ * expectType<TestTypeIsEqual<string, string>>(); // OK
+ * expectType<TestTypeIsEqual<string, number>>(); // Type error
+ *
+ * @template T Type that must extend `true`
+ * @returns An empty object cast to type T
+ */
 declare function expectType<T extends true>(): T;
+/**
+ * Helper function for type testing that compares two types and expects a specific result.
+ * This function allows for more explicit type equality assertions with a descriptive result.
+ *
+ * @template X First type to compare
+ * @template Y Second type to compare
+ * @param result Expected comparison result: 'equal' if types are equal, 'notEqual' if they differ
+ *
+ * @example
+ * expectTypesAre<string, string>('equal'); // OK
+ * expectTypesAre<string, number>('notEqual'); // OK
+ * expectTypesAre<string, string>('notEqual'); // Type error
+ */
+declare function expectTypesAre<X, Y>(result: TestTypeIsEqual<X, Y> extends true ? 'equal' : 'notEqual'): void;
 declare const typingTest: {
     test: typeof test;
     describe: typeof describe;
     expectType: typeof expectType;
+    expectTypesAre: typeof expectTypesAre;
 };
 
 export { type TestTypeIsEqual, type TestTypeNotEqual, typingTest };

package/dist/typingTestUtils.js

@@ -8,10 +8,13 @@ function describe(title, func) {
 function expectType() {
   return {};
 }
+function expectTypesAre(result) {
+}
 var typingTest = {
   test,
   describe,
-  expectType
+  expectType,
+  expectTypesAre
 };
 export {
   typingTest

package/dist/typingUtils.d.cts

@@ -7,5 +7,8 @@ type NonPartial<T> = {
 type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
     [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
 }[keyof Obj];
+type IsAny<T> = unknown extends T ? [
+    keyof T
+] extends [never] ? false : true : false;
 
-export type { NonPartial, ObjKeysWithValuesOfType, PartialRecord };
+export type { IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord };

package/dist/typingUtils.d.ts

@@ -7,5 +7,8 @@ type NonPartial<T> = {
 type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType> = {
     [K in keyof Obj]: Obj[K] extends ValueType ? K : never;
 }[keyof Obj];
+type IsAny<T> = unknown extends T ? [
+    keyof T
+] extends [never] ? false : true : false;
 
-export type { NonPartial, ObjKeysWithValuesOfType, PartialRecord };
+export type { IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord };

package/dist/yamlStringify.js

@@ -7,7 +7,7 @@ import {
 import {
   isObject,
   isPlainObject
-} from "./chunk-4UGSP3L3.js";
+} from "./chunk-3XCS7FVO.js";
 
 // src/yamlStringify.ts
 function yamlStringify(obj, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "2.14.1",
+  "version": "3.2.0",
   "license": "MIT",
   "files": [
     "dist"
@@ -79,15 +79,10 @@
       "types": "./dist/exhaustiveMatch.d.ts",
       "require": "./dist/exhaustiveMatch.cjs"
     },
-    "./getObjStableKey": {
-      "import": "./dist/getObjStableKey.js",
-      "types": "./dist/getObjStableKey.d.ts",
-      "require": "./dist/getObjStableKey.cjs"
-    },
-    "./internalUtils": {
-      "import": "./dist/internalUtils.js",
-      "types": "./dist/internalUtils.d.ts",
-      "require": "./dist/internalUtils.cjs"
+    "./getValueStableKey": {
+      "import": "./dist/getValueStableKey.js",
+      "types": "./dist/getValueStableKey.d.ts",
+      "require": "./dist/getValueStableKey.cjs"
     },
     "./interpolate": {
       "import": "./dist/interpolate.js",
@@ -99,11 +94,6 @@
       "types": "./dist/levenshtein.d.ts",
       "require": "./dist/levenshtein.cjs"
     },
-    "./main": {
-      "import": "./dist/main.js",
-      "types": "./dist/main.d.ts",
-      "require": "./dist/main.cjs"
-    },
     "./mathUtils": {
       "import": "./dist/mathUtils.js",
       "types": "./dist/mathUtils.d.ts",
@@ -129,11 +119,6 @@
       "types": "./dist/retryOnError.d.ts",
       "require": "./dist/retryOnError.cjs"
     },
-    "./rsResult": {
-      "import": "./dist/rsResult.js",
-      "types": "./dist/rsResult.d.ts",
-      "require": "./dist/rsResult.cjs"
-    },
     "./runShellCmd": {
       "import": "./dist/runShellCmd.js",
       "types": "./dist/runShellCmd.d.ts",
@@ -169,6 +154,11 @@
       "types": "./dist/time.d.ts",
       "require": "./dist/time.cjs"
     },
+    "./tsResult": {
+      "import": "./dist/tsResult.js",
+      "types": "./dist/tsResult.d.ts",
+      "require": "./dist/tsResult.cjs"
+    },
     "./typingFnUtils": {
       "import": "./dist/typingFnUtils.js",
       "types": "./dist/typingFnUtils.d.ts",
@@ -253,11 +243,8 @@
       "exhaustiveMatch": [
         "./dist/exhaustiveMatch.d.ts"
       ],
-      "getObjStableKey": [
-        "./dist/getObjStableKey.d.ts"
-      ],
-      "internalUtils": [
-        "./dist/internalUtils.d.ts"
+      "getValueStableKey": [
+        "./dist/getValueStableKey.d.ts"
       ],
       "interpolate": [
         "./dist/interpolate.d.ts"
@@ -265,9 +252,6 @@
       "levenshtein": [
         "./dist/levenshtein.d.ts"
       ],
-      "main": [
-        "./dist/main.d.ts"
-      ],
       "mathUtils": [
         "./dist/mathUtils.d.ts"
       ],
@@ -283,9 +267,6 @@
       "retryOnError": [
         "./dist/retryOnError.d.ts"
       ],
-      "rsResult": [
-        "./dist/rsResult.d.ts"
-      ],
       "runShellCmd": [
         "./dist/runShellCmd.d.ts"
       ],
@@ -307,6 +288,9 @@
       "time": [
         "./dist/time.d.ts"
       ],
+      "tsResult": [
+        "./dist/tsResult.d.ts"
+      ],
       "typingFnUtils": [
         "./dist/typingFnUtils.d.ts"
       ],

package/dist/chunk-GBFS2I67.js

@@ -1,17 +0,0 @@
-// src/castValues.ts
-function castToString(value) {
-  const valueType = typeof value;
-  return valueType === "string" || valueType === "number" || valueType === "boolean" || valueType === "bigint" ? String(value) : null;
-}
-function castToNumber(value) {
-  return isNumeric(value) ? Number(value) : null;
-}
-function isNumeric(num) {
-  const str = String(num);
-  return !isNaN(str) && !isNaN(parseFloat(str));
-}
-
-export {
-  castToString,
-  castToNumber
-};

package/dist/getObjStableKey.cjs

@@ -1,83 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/getObjStableKey.ts
-var getObjStableKey_exports = {};
-__export(getObjStableKey_exports, {
-  getObjStableKey: () => getObjStableKey
-});
-module.exports = __toCommonJS(getObjStableKey_exports);
-
-// src/arrayUtils.ts
-function filterAndMap(array, mapFilter) {
-  const result = [];
-  let i = -1;
-  for (const item of array) {
-    i += 1;
-    const filterResult = mapFilter(item, i);
-    if (filterResult !== false) {
-      result.push(filterResult);
-    }
-  }
-  return result;
-}
-
-// src/assertions.ts
-function isObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-// src/getObjStableKey.ts
-function getObjStableKey(input, maxDepth = 3) {
-  if (typeof input === "string") return String(input);
-  if (!input || typeof input !== "object") return `#$${input}$#`;
-  return JSON.stringify(sortValues(input, maxDepth, 0));
-}
-function sortValues(input, maxDepth, depth) {
-  if (depth >= maxDepth) return input;
-  if (Array.isArray(input)) {
-    return input.map((v) => sortValues(v, maxDepth, depth + 1));
-  }
-  if (isObject(input)) {
-    return orderedProps(input, (v) => sortValues(v, maxDepth, depth + 1));
-  }
-  return input;
-}
-var emptyObject = {};
-function orderedProps(obj, mapValue) {
-  const keys = Object.keys(obj);
-  if (keys.length === 0) return emptyObject;
-  if (keys.length === 1) {
-    const value = obj[keys[0]];
-    if (value === void 0) return emptyObject;
-    return { [keys[0]]: mapValue(value) };
-  }
-  const mappedValues = filterAndMap(keys.sort(), (k) => {
-    const value = obj[k];
-    if (value === void 0) return false;
-    return { [k]: mapValue(value) };
-  });
-  if (mappedValues.length === 0) return emptyObject;
-  if (mappedValues.length === 1) return mappedValues[0];
-  return mappedValues;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getObjStableKey
-});

package/dist/getObjStableKey.d.cts

@@ -1,3 +0,0 @@
-declare function getObjStableKey(input: unknown, maxDepth?: number): string;
-
-export { getObjStableKey };

package/dist/getObjStableKey.d.ts

@@ -1,3 +0,0 @@
-declare function getObjStableKey(input: unknown, maxDepth?: number): string;
-
-export { getObjStableKey };

package/dist/getObjStableKey.js

@@ -1,44 +0,0 @@
-import {
-  filterAndMap
-} from "./chunk-QMFZE2VO.js";
-import {
-  isObject
-} from "./chunk-4UGSP3L3.js";
-
-// src/getObjStableKey.ts
-function getObjStableKey(input, maxDepth = 3) {
-  if (typeof input === "string") return String(input);
-  if (!input || typeof input !== "object") return `#$${input}$#`;
-  return JSON.stringify(sortValues(input, maxDepth, 0));
-}
-function sortValues(input, maxDepth, depth) {
-  if (depth >= maxDepth) return input;
-  if (Array.isArray(input)) {
-    return input.map((v) => sortValues(v, maxDepth, depth + 1));
-  }
-  if (isObject(input)) {
-    return orderedProps(input, (v) => sortValues(v, maxDepth, depth + 1));
-  }
-  return input;
-}
-var emptyObject = {};
-function orderedProps(obj, mapValue) {
-  const keys = Object.keys(obj);
-  if (keys.length === 0) return emptyObject;
-  if (keys.length === 1) {
-    const value = obj[keys[0]];
-    if (value === void 0) return emptyObject;
-    return { [keys[0]]: mapValue(value) };
-  }
-  const mappedValues = filterAndMap(keys.sort(), (k) => {
-    const value = obj[k];
-    if (value === void 0) return false;
-    return { [k]: mapValue(value) };
-  });
-  if (mappedValues.length === 0) return emptyObject;
-  if (mappedValues.length === 1) return mappedValues[0];
-  return mappedValues;
-}
-export {
-  getObjStableKey
-};

package/dist/rsResult.js

@@ -1,20 +0,0 @@
-import {
-  Result,
-  asyncResultify,
-  createTypedResult,
-  normalizeError,
-  resultify,
-  safeJsonStringify,
-  unknownToError
-} from "./chunk-KBFP7INB.js";
-import "./chunk-VAAMRG4K.js";
-import "./chunk-4UGSP3L3.js";
-export {
-  Result,
-  asyncResultify,
-  createTypedResult,
-  normalizeError,
-  resultify,
-  safeJsonStringify,
-  unknownToError
-};