es-toolkit 1.25.2-dev.824 → 1.25.2-dev.825

package/dist/compat/index.d.mts

@@ -79,6 +79,7 @@ export { lowerFirst } from '../string/lowerFirst.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { unescape } from '../string/unescape.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
+export { invariant } from '../util/invariant.mjs';
 export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';

package/dist/compat/index.d.ts

@@ -79,6 +79,7 @@ export { lowerFirst } from '../string/lowerFirst.js';
 export { pascalCase } from '../string/pascalCase.js';
 export { unescape } from '../string/unescape.js';
 export { upperFirst } from '../string/upperFirst.js';
+export { invariant } from '../util/invariant.js';
 export { castArray } from './array/castArray.js';
 export { chunk } from './array/chunk.js';
 export { compact } from './array/compact.js';

package/dist/compat/index.js

@@ -12,6 +12,7 @@ const toMerged = require('../_chunk/toMerged-wNz52b.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
 const isWeakSet$1 = require('../_chunk/isWeakSet-D8h8bS.js');
 const upperFirst = require('../_chunk/upperFirst-BUECmK.js');
+const util_index = require('../util/index.js');
 
 function castArray(value) {
     if (arguments.length === 0) {
@@ -2443,6 +2444,7 @@ exports.lowerFirst = upperFirst.lowerFirst;
 exports.pascalCase = upperFirst.pascalCase;
 exports.unescape = upperFirst.unescape;
 exports.upperFirst = upperFirst.upperFirst;
+exports.invariant = util_index.invariant;
 exports.ary = ary;
 exports.attempt = attempt;
 exports.before = before;

package/dist/compat/index.mjs

@@ -81,6 +81,7 @@ export { lowerFirst } from '../string/lowerFirst.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { unescape } from '../string/unescape.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
+export { invariant } from '../util/invariant.mjs';
 export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';

package/dist/index.d.mts

@@ -148,3 +148,4 @@ export { trimStart } from './string/trimStart.mjs';
 export { unescape } from './string/unescape.mjs';
 export { upperCase } from './string/upperCase.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
+export { invariant } from './util/invariant.mjs';

package/dist/index.d.ts

@@ -148,3 +148,4 @@ export { trimStart } from './string/trimStart.js';
 export { unescape } from './string/unescape.js';
 export { upperCase } from './string/upperCase.js';
 export { upperFirst } from './string/upperFirst.js';
+export { invariant } from './util/invariant.js';

package/dist/index.js

@@ -18,6 +18,7 @@ const predicate_index = require('./predicate/index.js');
 const isPlainObject = require('./_chunk/isPlainObject-octpoD.js');
 const upperFirst = require('./_chunk/upperFirst-BUECmK.js');
 const string_index = require('./string/index.js');
+const util_index = require('./util/index.js');
 
 
 
@@ -173,3 +174,4 @@ exports.unescape = upperFirst.unescape;
 exports.upperCase = upperFirst.upperCase;
 exports.upperFirst = upperFirst.upperFirst;
 exports.startCase = string_index.startCase;
+exports.invariant = util_index.invariant;

package/dist/index.mjs

@@ -148,3 +148,4 @@ export { trimStart } from './string/trimStart.mjs';
 export { unescape } from './string/unescape.mjs';
 export { upperCase } from './string/upperCase.mjs';
 export { upperFirst } from './string/upperFirst.mjs';
+export { invariant } from './util/invariant.mjs';

package/dist/util/index.d.mts

@@ -0,0 +1 @@
+export { invariant } from './invariant.mjs';

package/dist/util/index.d.ts

@@ -0,0 +1 @@
+export { invariant } from './invariant.js';

package/dist/util/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+function invariant(condition, message) {
+    if (condition) {
+        return;
+    }
+    throw new Error(message);
+}
+
+exports.invariant = invariant;

package/dist/util/index.mjs

@@ -0,0 +1 @@
+export { invariant } from './invariant.mjs';

package/dist/util/invariant.d.mts

@@ -0,0 +1,27 @@
+/**
+ * Asserts that a given condition is true. If the condition is false, an error is thrown with the provided message.
+ *
+ * @param {unknown} condition - The condition to evaluate.
+ * @param {string} [message] - The error message to throw if the condition is false.
+ * @returns {void} Returns void if the condition is true.
+ * @throws {Error} Throws an error if the condition is false.
+ *
+ * @example
+ * // This call will succeed without any errors
+ * invariant(true, 'This should not throw');
+ *
+ * // This call will fail and throw an error with the message 'This should throw'
+ * invariant(false, 'This should throw');
+ *
+ * // Example of using invariant with a condition
+ * invariant(condition, 'Expected condition is false');
+ *
+ * // Ensure that the value is neither null nor undefined
+ * invariant(value !== null && value !== undefined, 'Value should not be null or undefined');
+ *
+ * // Example of using invariant to check if a number is positive
+ * invariant(number > 0, 'Number must be positive');
+ */
+declare function invariant(condition: unknown, message: string): asserts condition;
+
+export { invariant };

package/dist/util/invariant.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Asserts that a given condition is true. If the condition is false, an error is thrown with the provided message.
+ *
+ * @param {unknown} condition - The condition to evaluate.
+ * @param {string} [message] - The error message to throw if the condition is false.
+ * @returns {void} Returns void if the condition is true.
+ * @throws {Error} Throws an error if the condition is false.
+ *
+ * @example
+ * // This call will succeed without any errors
+ * invariant(true, 'This should not throw');
+ *
+ * // This call will fail and throw an error with the message 'This should throw'
+ * invariant(false, 'This should throw');
+ *
+ * // Example of using invariant with a condition
+ * invariant(condition, 'Expected condition is false');
+ *
+ * // Ensure that the value is neither null nor undefined
+ * invariant(value !== null && value !== undefined, 'Value should not be null or undefined');
+ *
+ * // Example of using invariant to check if a number is positive
+ * invariant(number > 0, 'Number must be positive');
+ */
+declare function invariant(condition: unknown, message: string): asserts condition;
+
+export { invariant };

package/dist/util/invariant.mjs

@@ -0,0 +1,8 @@
+function invariant(condition, message) {
+    if (condition) {
+        return;
+    }
+    throw new Error(message);
+}
+
+export { invariant };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.25.2-dev.824+a000c597",
+  "version": "1.25.2-dev.825+b4e384de",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {
@@ -95,6 +95,16 @@
         "default": "./dist/string/index.js"
       }
     },
+    "./util": {
+      "import": {
+        "types": "./dist/util/index.d.mts",
+        "default": "./dist/util/index.mjs"
+      },
+      "require": {
+        "types": "./dist/util/index.d.ts",
+        "default": "./dist/util/index.js"
+      }
+    },
     "./compat": {
       "import": {
         "types": "./dist/compat/index.d.mts",
@@ -198,6 +208,16 @@
           "default": "./dist/string/index.js"
         }
       },
+      "./util": {
+        "import": {
+          "types": "./dist/util/index.d.mts",
+          "default": "./dist/util/index.mjs"
+        },
+        "require": {
+          "types": "./dist/util/index.d.ts",
+          "default": "./dist/util/index.js"
+        }
+      },
       "./compat": {
         "import": {
           "types": "./dist/compat/index.d.mts",

package/util.d.ts

@@ -0,0 +1 @@
+export * from './dist/util';