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 +17 -0
- package/dist/index.d.mts +13 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +42 -42
- package/dist/index.mjs +42 -42
- package/package.json +1 -1
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