is-kit 1.11.5 → 1.11.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -528,6 +528,23 @@ The library is organized around a few small building blocks:
528
528
 
529
529
  For the full API list and dedicated pages, use the docs site below.
530
530
 
531
+ ### v2 migration notice
532
+
533
+ Six low-level utility adapters remain available in v1 for compatibility but are
534
+ deprecated and will no longer be exported from the package root in v2:
535
+
536
+ | Deprecated export | Migration path |
537
+ | ------------------------- | ---------------------------------------------------------------------- |
538
+ | `everyArrayValue` | Use `Array.prototype.every` or the `arrayOf` guard. |
539
+ | `everyTupleValue` | Use the `tupleOf` guard or compare tuple values directly. |
540
+ | `everySetValue` | Use the `setOf` guard or iterate the set directly. |
541
+ | `everyMapEntry` | Use the `mapOf` guard or iterate the map directly. |
542
+ | `everyOwnEnumerableEntry` | Use the `recordOf` guard or `Object.entries(value).every(...)`. |
543
+ | `toBooleanPredicates` | Use the original predicate array directly; this helper is an identity. |
544
+
545
+ The underlying internal helpers may remain in the implementation. Only their
546
+ public root exports are planned for removal.
547
+
531
548
  ## 📚 Full Documentation
532
549
 
533
550
  For detailed API pages and more examples, see:
package/dist/index.d.mts CHANGED
@@ -721,6 +721,8 @@ type BooleanPredicate<T> = (value: T) => boolean;
721
721
  /**
722
722
  * Checks whether every array element satisfies the provided predicate.
723
723
  *
724
+ * @deprecated Use `Array.prototype.every` for boolean iteration or `arrayOf`
725
+ * for a narrowing guard. This root export will be removed in is-kit v2.
724
726
  * @param values Array values to validate.
725
727
  * @param predicate Predicate applied to each element.
726
728
  * @returns Whether all elements satisfy `predicate`.
@@ -729,6 +731,8 @@ declare const everyArrayValue: (values: readonly unknown[], predicate: BooleanPr
729
731
  /**
730
732
  * Checks whether a tuple matches the provided element predicates in order.
731
733
  *
734
+ * @deprecated Use `tupleOf` for a narrowing guard or compare the tuple length
735
+ * and predicates directly. This root export will be removed in is-kit v2.
732
736
  * @param values Tuple candidate values.
733
737
  * @param predicates Predicates aligned to each tuple index.
734
738
  * @returns Whether lengths match and each index passes.
@@ -737,6 +741,8 @@ declare const everyTupleValue: (values: readonly unknown[], predicates: readonly
737
741
  /**
738
742
  * Checks whether every set value satisfies the provided predicate.
739
743
  *
744
+ * @deprecated Use `setOf` for a narrowing guard or iterate the set directly.
745
+ * This root export will be removed in is-kit v2.
740
746
  * @param values Set values to validate.
741
747
  * @param predicate Predicate applied to each value.
742
748
  * @returns Whether all set values satisfy `predicate`.
@@ -745,6 +751,8 @@ declare const everySetValue: (values: ReadonlySet<unknown>, predicate: BooleanPr
745
751
  /**
746
752
  * Checks whether every map entry satisfies the provided key and value predicates.
747
753
  *
754
+ * @deprecated Use `mapOf` for a narrowing guard or iterate the map directly.
755
+ * This root export will be removed in is-kit v2.
748
756
  * @param values Map values to validate.
749
757
  * @param keyPredicate Predicate applied to each key.
750
758
  * @param valuePredicate Predicate applied to each value.
@@ -754,6 +762,9 @@ declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicat
754
762
  /**
755
763
  * Checks whether every own enumerable string key/value pair satisfies the provided predicates.
756
764
  *
765
+ * @deprecated Use `recordOf` for a narrowing guard or
766
+ * `Object.entries(value).every(...)` for boolean iteration. This root export
767
+ * will be removed in is-kit v2.
757
768
  * @param values Plain object values to validate.
758
769
  * @param keyPredicate Predicate applied to each enumerable own string key.
759
770
  * @param valuePredicate Predicate applied to each corresponding value.
@@ -764,6 +775,8 @@ declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPred
764
775
  /**
765
776
  * Converts predicates to plain boolean predicates for iteration helpers.
766
777
  *
778
+ * @deprecated Use the original predicate array directly. This identity helper
779
+ * will no longer be exported from the package root in is-kit v2.
767
780
  * @param predicates Predicates to be treated as simple boolean functions.
768
781
  * @returns Readonly array of boolean-returning functions.
769
782
  */
package/dist/index.d.ts CHANGED
@@ -721,6 +721,8 @@ type BooleanPredicate<T> = (value: T) => boolean;
721
721
  /**
722
722
  * Checks whether every array element satisfies the provided predicate.
723
723
  *
724
+ * @deprecated Use `Array.prototype.every` for boolean iteration or `arrayOf`
725
+ * for a narrowing guard. This root export will be removed in is-kit v2.
724
726
  * @param values Array values to validate.
725
727
  * @param predicate Predicate applied to each element.
726
728
  * @returns Whether all elements satisfy `predicate`.
@@ -729,6 +731,8 @@ declare const everyArrayValue: (values: readonly unknown[], predicate: BooleanPr
729
731
  /**
730
732
  * Checks whether a tuple matches the provided element predicates in order.
731
733
  *
734
+ * @deprecated Use `tupleOf` for a narrowing guard or compare the tuple length
735
+ * and predicates directly. This root export will be removed in is-kit v2.
732
736
  * @param values Tuple candidate values.
733
737
  * @param predicates Predicates aligned to each tuple index.
734
738
  * @returns Whether lengths match and each index passes.
@@ -737,6 +741,8 @@ declare const everyTupleValue: (values: readonly unknown[], predicates: readonly
737
741
  /**
738
742
  * Checks whether every set value satisfies the provided predicate.
739
743
  *
744
+ * @deprecated Use `setOf` for a narrowing guard or iterate the set directly.
745
+ * This root export will be removed in is-kit v2.
740
746
  * @param values Set values to validate.
741
747
  * @param predicate Predicate applied to each value.
742
748
  * @returns Whether all set values satisfy `predicate`.
@@ -745,6 +751,8 @@ declare const everySetValue: (values: ReadonlySet<unknown>, predicate: BooleanPr
745
751
  /**
746
752
  * Checks whether every map entry satisfies the provided key and value predicates.
747
753
  *
754
+ * @deprecated Use `mapOf` for a narrowing guard or iterate the map directly.
755
+ * This root export will be removed in is-kit v2.
748
756
  * @param values Map values to validate.
749
757
  * @param keyPredicate Predicate applied to each key.
750
758
  * @param valuePredicate Predicate applied to each value.
@@ -754,6 +762,9 @@ declare const everyMapEntry: (values: ReadonlyMap<unknown, unknown>, keyPredicat
754
762
  /**
755
763
  * Checks whether every own enumerable string key/value pair satisfies the provided predicates.
756
764
  *
765
+ * @deprecated Use `recordOf` for a narrowing guard or
766
+ * `Object.entries(value).every(...)` for boolean iteration. This root export
767
+ * will be removed in is-kit v2.
757
768
  * @param values Plain object values to validate.
758
769
  * @param keyPredicate Predicate applied to each enumerable own string key.
759
770
  * @param valuePredicate Predicate applied to each corresponding value.
@@ -764,6 +775,8 @@ declare const everyOwnEnumerableEntry: (values: Record<string, unknown>, keyPred
764
775
  /**
765
776
  * Converts predicates to plain boolean predicates for iteration helpers.
766
777
  *
778
+ * @deprecated Use the original predicate array directly. This identity helper
779
+ * will no longer be exported from the package root in is-kit v2.
767
780
  * @param predicates Predicates to be treated as simple boolean functions.
768
781
  * @returns Readonly array of boolean-returning functions.
769
782
  */
package/dist/index.js CHANGED
@@ -118,53 +118,11 @@ function define(fn) {
118
118
  var hasOwnPropertyKey = (value, key) => Object.hasOwn(value, key);
119
119
  var hasOwnPropertyKeys = (value, keys) => keys.every((key) => hasOwnPropertyKey(value, key));
120
120
 
121
- // src/utils/guard-collections.ts
122
- var mapEntries = Map.prototype.entries;
123
- var setValues = Set.prototype.values;
124
- var everyIterableValue = (values, predicate) => {
125
- for (const value of values) {
126
- if (!predicate(value)) return false;
127
- }
128
- return true;
129
- };
130
- var everyKeyValueEntry = (entries, predicate) => {
131
- for (const [key, value] of entries) {
132
- if (!predicate(key, value)) return false;
133
- }
134
- return true;
135
- };
136
- var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
137
- var everyTupleValue = (values, predicates) => {
138
- if (values.length !== predicates.length) return false;
139
- for (let index = 0; index < predicates.length; index += 1) {
140
- const predicate = predicates[index];
141
- if (!predicate(values[index])) return false;
142
- }
143
- return true;
144
- };
145
- var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
146
- var everyBrandedSetValue = (values, predicate) => everyIterableValue(setValues.call(values), predicate);
147
- var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
148
- values,
149
- (key, value) => keyPredicate(key) && valuePredicate(value)
150
- );
151
- var everyBrandedMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
152
- mapEntries.call(values),
153
- (key, value) => keyPredicate(key) && valuePredicate(value)
154
- );
155
- var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
156
- Object.keys(values),
157
- (key) => keyPredicate(key) && valuePredicate(values[key])
158
- );
159
-
160
121
  // src/utils/object-tags.ts
161
122
  var objectToString = Object.prototype.toString;
162
123
  var OBJECT_TAG_ERROR = "[object Error]";
163
124
  var getTag = (value) => objectToString.call(value);
164
125
 
165
- // src/utils/to-boolean-predicates.ts
166
- var toBooleanPredicates = (predicates) => predicates;
167
-
168
126
  // src/core/object.ts
169
127
  var BUILTIN_BRAND_SENTINEL = Object.freeze({});
170
128
  var getIntrinsicGetter = (prototype, key) => {
@@ -316,6 +274,9 @@ function lazy(factory) {
316
274
  };
317
275
  }
318
276
 
277
+ // src/utils/to-boolean-predicates.ts
278
+ var toBooleanPredicates = (predicates) => predicates;
279
+
319
280
  // src/core/logic.ts
320
281
  function and(precondition, condition) {
321
282
  return define((input) => {
@@ -433,6 +394,45 @@ var isPrimitive = or(
433
394
  isNull
434
395
  );
435
396
 
397
+ // src/utils/guard-collections.ts
398
+ var mapEntries = Map.prototype.entries;
399
+ var setValues = Set.prototype.values;
400
+ var everyIterableValue = (values, predicate) => {
401
+ for (const value of values) {
402
+ if (!predicate(value)) return false;
403
+ }
404
+ return true;
405
+ };
406
+ var everyKeyValueEntry = (entries, predicate) => {
407
+ for (const [key, value] of entries) {
408
+ if (!predicate(key, value)) return false;
409
+ }
410
+ return true;
411
+ };
412
+ var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
413
+ var everyTupleValue = (values, predicates) => {
414
+ if (values.length !== predicates.length) return false;
415
+ for (let index = 0; index < predicates.length; index += 1) {
416
+ const predicate = predicates[index];
417
+ if (!predicate(values[index])) return false;
418
+ }
419
+ return true;
420
+ };
421
+ var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
422
+ var everyBrandedSetValue = (values, predicate) => everyIterableValue(setValues.call(values), predicate);
423
+ var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
424
+ values,
425
+ (key, value) => keyPredicate(key) && valuePredicate(value)
426
+ );
427
+ var everyBrandedMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
428
+ mapEntries.call(values),
429
+ (key, value) => keyPredicate(key) && valuePredicate(value)
430
+ );
431
+ var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
432
+ Object.keys(values),
433
+ (key) => keyPredicate(key) && valuePredicate(values[key])
434
+ );
435
+
436
436
  // src/core/combinators/array.ts
437
437
  function arrayOf(elementGuard) {
438
438
  return define(
package/dist/index.mjs CHANGED
@@ -14,53 +14,11 @@ function define(fn) {
14
14
  var hasOwnPropertyKey = (value, key) => Object.hasOwn(value, key);
15
15
  var hasOwnPropertyKeys = (value, keys) => keys.every((key) => hasOwnPropertyKey(value, key));
16
16
 
17
- // src/utils/guard-collections.ts
18
- var mapEntries = Map.prototype.entries;
19
- var setValues = Set.prototype.values;
20
- var everyIterableValue = (values, predicate) => {
21
- for (const value of values) {
22
- if (!predicate(value)) return false;
23
- }
24
- return true;
25
- };
26
- var everyKeyValueEntry = (entries, predicate) => {
27
- for (const [key, value] of entries) {
28
- if (!predicate(key, value)) return false;
29
- }
30
- return true;
31
- };
32
- var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
33
- var everyTupleValue = (values, predicates) => {
34
- if (values.length !== predicates.length) return false;
35
- for (let index = 0; index < predicates.length; index += 1) {
36
- const predicate = predicates[index];
37
- if (!predicate(values[index])) return false;
38
- }
39
- return true;
40
- };
41
- var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
42
- var everyBrandedSetValue = (values, predicate) => everyIterableValue(setValues.call(values), predicate);
43
- var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
44
- values,
45
- (key, value) => keyPredicate(key) && valuePredicate(value)
46
- );
47
- var everyBrandedMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
48
- mapEntries.call(values),
49
- (key, value) => keyPredicate(key) && valuePredicate(value)
50
- );
51
- var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
52
- Object.keys(values),
53
- (key) => keyPredicate(key) && valuePredicate(values[key])
54
- );
55
-
56
17
  // src/utils/object-tags.ts
57
18
  var objectToString = Object.prototype.toString;
58
19
  var OBJECT_TAG_ERROR = "[object Error]";
59
20
  var getTag = (value) => objectToString.call(value);
60
21
 
61
- // src/utils/to-boolean-predicates.ts
62
- var toBooleanPredicates = (predicates) => predicates;
63
-
64
22
  // src/core/object.ts
65
23
  var BUILTIN_BRAND_SENTINEL = Object.freeze({});
66
24
  var getIntrinsicGetter = (prototype, key) => {
@@ -212,6 +170,9 @@ function lazy(factory) {
212
170
  };
213
171
  }
214
172
 
173
+ // src/utils/to-boolean-predicates.ts
174
+ var toBooleanPredicates = (predicates) => predicates;
175
+
215
176
  // src/core/logic.ts
216
177
  function and(precondition, condition) {
217
178
  return define((input) => {
@@ -329,6 +290,45 @@ var isPrimitive = or(
329
290
  isNull
330
291
  );
331
292
 
293
+ // src/utils/guard-collections.ts
294
+ var mapEntries = Map.prototype.entries;
295
+ var setValues = Set.prototype.values;
296
+ var everyIterableValue = (values, predicate) => {
297
+ for (const value of values) {
298
+ if (!predicate(value)) return false;
299
+ }
300
+ return true;
301
+ };
302
+ var everyKeyValueEntry = (entries, predicate) => {
303
+ for (const [key, value] of entries) {
304
+ if (!predicate(key, value)) return false;
305
+ }
306
+ return true;
307
+ };
308
+ var everyArrayValue = (values, predicate) => everyIterableValue(values, predicate);
309
+ var everyTupleValue = (values, predicates) => {
310
+ if (values.length !== predicates.length) return false;
311
+ for (let index = 0; index < predicates.length; index += 1) {
312
+ const predicate = predicates[index];
313
+ if (!predicate(values[index])) return false;
314
+ }
315
+ return true;
316
+ };
317
+ var everySetValue = (values, predicate) => everyIterableValue(values, predicate);
318
+ var everyBrandedSetValue = (values, predicate) => everyIterableValue(setValues.call(values), predicate);
319
+ var everyMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
320
+ values,
321
+ (key, value) => keyPredicate(key) && valuePredicate(value)
322
+ );
323
+ var everyBrandedMapEntry = (values, keyPredicate, valuePredicate) => everyKeyValueEntry(
324
+ mapEntries.call(values),
325
+ (key, value) => keyPredicate(key) && valuePredicate(value)
326
+ );
327
+ var everyOwnEnumerableEntry = (values, keyPredicate, valuePredicate) => everyIterableValue(
328
+ Object.keys(values),
329
+ (key) => keyPredicate(key) && valuePredicate(values[key])
330
+ );
331
+
332
332
  // src/core/combinators/array.ts
333
333
  function arrayOf(elementGuard) {
334
334
  return define(
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "is-kit",
3
- "version": "1.11.5",
3
+ "version": "1.11.7",
4
4
  "description": "Zero-dependency TypeScript runtime validation toolkit for composable type guards and natural type narrowing.",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.mjs",