@infra-blocks/types 0.12.0 → 0.13.0-alpha.1

package/lib/cjs/guard.d.ts

@@ -1,3 +1,4 @@
+import { Primitive } from "./types.js";
 /**
  * A type guard to assess that a value is a bigint.
  *
@@ -85,6 +86,28 @@ export declare function isObject(value: unknown): value is object | null;
  * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
  */
 export declare function isObjectNotNull(value: unknown): value is object;
+/**
+ * A type guard to assess that a value is a primitive.
+ *
+ * This function checks if the value is one of the primitive types:
+ * bigint, boolean, null, number, string, symbol, or undefined.
+ *
+ * Sometimes those checks are made with the `typeof` operator, sometimes with strict equality checks.
+ *
+ * @param value - The value to test.
+ *
+ * @returns Whether or not the value is a primitive.
+ *
+ * @see isBigint
+ * @see isBoolean
+ * @see isNull
+ * @see isNumber
+ * @see isString
+ * @see isSymbol
+ * @see isUndefined
+ * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
+ */
+export declare function isPrimitive(value: unknown): value is Primitive;
 /**
  * A type guard to assess that a value is a string.
  *

package/lib/cjs/guard.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isUndefined = exports.isSymbol = exports.isString = exports.isObjectNotNull = exports.isObject = exports.isNull = exports.isNumber = exports.isFunction = exports.isBoolean = exports.isBigint = void 0;
+exports.isUndefined = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isObjectNotNull = exports.isObject = exports.isNull = exports.isNumber = exports.isFunction = exports.isBoolean = exports.isBigint = void 0;
 /**
  * A type guard to assess that a value is a bigint.
  *
@@ -110,6 +110,37 @@ function isObjectNotNull(value) {
     return !isNull(value) && typeof value === "object";
 }
 exports.isObjectNotNull = isObjectNotNull;
+/**
+ * A type guard to assess that a value is a primitive.
+ *
+ * This function checks if the value is one of the primitive types:
+ * bigint, boolean, null, number, string, symbol, or undefined.
+ *
+ * Sometimes those checks are made with the `typeof` operator, sometimes with strict equality checks.
+ *
+ * @param value - The value to test.
+ *
+ * @returns Whether or not the value is a primitive.
+ *
+ * @see isBigint
+ * @see isBoolean
+ * @see isNull
+ * @see isNumber
+ * @see isString
+ * @see isSymbol
+ * @see isUndefined
+ * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
+ */
+function isPrimitive(value) {
+    return (isBigint(value) ||
+        isBoolean(value) ||
+        isNull(value) ||
+        isNumber(value) ||
+        isString(value) ||
+        isSymbol(value) ||
+        isUndefined(value));
+}
+exports.isPrimitive = isPrimitive;
 /**
  * A type guard to assess that a value is a string.
  *

package/lib/cjs/guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/guard.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAFD,8BAEC;AAED;;;;;;;;;;GAUG;AACH,wDAAwD;AACxD,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAFD,gCAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAFD,wBAEC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAFD,0CAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,WAAW,CAAC;AACtC,CAAC;AAFD,kCAEC"}
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/guard.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAFD,8BAEC;AAED;;;;;;;;;;GAUG;AACH,wDAAwD;AACxD,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAFD,gCAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAFD,wBAEC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAFD,0CAEC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,SAAS,CAAC,KAAK,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC;QACb,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CACnB,CAAC;AACJ,CAAC;AAVD,kCAUC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,WAAW,CAAC;AACtC,CAAC;AAFD,kCAEC"}

package/lib/cjs/index.d.ts

@@ -2,51 +2,7 @@ export * from "./func.js";
 export * from "./guard.js";
 export * from "./events.js";
 export * from "./predicates.js";
-/**
- * Convenience type to represent environment variables.
- */
-export type EnvironmentVariables = Record<string, string | undefined>;
-/**
- * Just aliasing {@link EnvironmentVariables} for brevity.
- */
-export type EnvVars = EnvironmentVariables;
-/**
- * Convenient type alias to regroup a type that can be T, null or undefined.
- *
- * Semantically the opposite of {@link NonNullable}.
- */
-export type Nullable<T> = T | null | undefined;
-/**
- * Convenient mapped type to selectively make some fields of a type optional.
- *
- * This is in contrast to the built-in `Partial` type which makes all fields optional.
- */
-export type Optional<T, K extends keyof T = keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
-/**
- * A convenience type extractor to get the inner type of an array.
- *
- * It will cause compilation errors if T isn't an array.
- *
- * See here: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html
- */
-export type UnpackedArray<T> = T extends (infer U)[] ? U : never;
-/**
- * A convenience type mapping that transitively make partial fields optional.
- *
- * The built-in Partial type doesn't cover nested objects, this one does.
- */
-export type TransitivePartial<T> = {
-    [K in keyof T]?: T[K] extends object ? TransitivePartial<T[K]> : T[K];
-};
-/**
- * A convenience type mapping to extract keys of a type that are of a given type.
- *
- * For example, if you would like all the types of an object that are numbers, you could do
- * KeyOfType<TheType, number>
- */
-export type KeyOfType<T, U> = {
-    [P in keyof T]: T[P] extends U ? P : never;
-}[keyof T];
+export * from "./types.js";
 /**
  * A function for forcing exhaustiveness in switch statements or if-else chains.
  *

package/lib/cjs/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./func.js"), exports);
 __exportStar(require("./guard.js"), exports);
 __exportStar(require("./events.js"), exports);
 __exportStar(require("./predicates.js"), exports);
+__exportStar(require("./types.js"), exports);
 /**
  * A function for forcing exhaustiveness in switch statements or if-else chains.
  *

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,kDAAgC;AAsDhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAFD,kCAEC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,kDAAgC;AAChC,6CAA2B;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAFD,kCAEC"}

package/lib/cjs/predicates.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPlainObject = void 0;
+const guard_js_1 = require("./guard.js");
 /**
  * A type predicate to determine if a value is a plain object.
  *
@@ -12,7 +13,7 @@ exports.isPlainObject = void 0;
  * @returns Whether or not the value is a plain object.
  */
 function isPlainObject(value) {
-    return (typeof value === "object" && value !== null && value.constructor === Object);
+    return (0, guard_js_1.isObjectNotNull)(value) && value.constructor === Object;
 }
 exports.isPlainObject = isPlainObject;
 //# sourceMappingURL=predicates.js.map

package/lib/cjs/predicates.js.map

@@ -1 +1 @@
-{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/predicates.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,CAC5E,CAAC;AACJ,CAAC;AAJD,sCAIC"}
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/predicates.ts"],"names":[],"mappings":";;;AAAA,yCAA6C;AAE7C;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAA,0BAAe,EAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC;AAChE,CAAC;AAFD,sCAEC"}

package/lib/cjs/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Convenience type to represent environment variables.
+ */
+export type EnvironmentVariables = Record<string, string | undefined>;
+/**
+ * Just aliasing {@link EnvironmentVariables} for brevity.
+ */
+export type EnvVars = EnvironmentVariables;
+/**
+ * A convenience type mapping to extract keys of a type that are of a given type.
+ *
+ * For example, if you would like all the types of an object that are numbers, you could do
+ * KeyOfType<TheType, number>
+ */
+export type KeyOfType<T, U> = {
+    [P in keyof T]: T[P] extends U ? P : never;
+}[keyof T];
+/**
+ * Convenient type alias to regroup a type that can be T, null or undefined.
+ *
+ * Semantically the opposite of {@link NonNullable}.
+ */
+export type Nullable<T> = T | null | undefined;
+/**
+ * Convenient mapped type to selectively make some fields of a type optional.
+ *
+ * This is in contrast to the built-in `Partial` type which makes all fields optional.
+ */
+export type Optional<T, K extends keyof T = keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+/**
+ * A union type that includes all primitive types.
+ */
+export type Primitive = bigint | boolean | null | number | string | symbol | undefined;
+/**
+ * A convenience type mapping that transitively make partial fields optional.
+ *
+ * The built-in Partial type doesn't cover nested objects, this one does.
+ */
+export type TransitivePartial<T> = {
+    [K in keyof T]?: T[K] extends object ? TransitivePartial<T[K]> : T[K];
+};
+/**
+ * A convenience type extractor to get the inner type of an array.
+ *
+ * It will cause compilation errors if T isn't an array.
+ *
+ * See here: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html
+ */
+export type UnpackedArray<T> = T extends (infer U)[] ? U : never;

package/lib/cjs/types.js

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

package/lib/cjs/types.js.map

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

package/lib/esm/guard.d.ts

@@ -1,3 +1,4 @@
+import { Primitive } from "./types.js";
 /**
  * A type guard to assess that a value is a bigint.
  *
@@ -85,6 +86,28 @@ export declare function isObject(value: unknown): value is object | null;
  * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
  */
 export declare function isObjectNotNull(value: unknown): value is object;
+/**
+ * A type guard to assess that a value is a primitive.
+ *
+ * This function checks if the value is one of the primitive types:
+ * bigint, boolean, null, number, string, symbol, or undefined.
+ *
+ * Sometimes those checks are made with the `typeof` operator, sometimes with strict equality checks.
+ *
+ * @param value - The value to test.
+ *
+ * @returns Whether or not the value is a primitive.
+ *
+ * @see isBigint
+ * @see isBoolean
+ * @see isNull
+ * @see isNumber
+ * @see isString
+ * @see isSymbol
+ * @see isUndefined
+ * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
+ */
+export declare function isPrimitive(value: unknown): value is Primitive;
 /**
  * A type guard to assess that a value is a string.
  *

package/lib/esm/guard.js

@@ -100,6 +100,36 @@ export function isObject(value) {
 export function isObjectNotNull(value) {
     return !isNull(value) && typeof value === "object";
 }
+/**
+ * A type guard to assess that a value is a primitive.
+ *
+ * This function checks if the value is one of the primitive types:
+ * bigint, boolean, null, number, string, symbol, or undefined.
+ *
+ * Sometimes those checks are made with the `typeof` operator, sometimes with strict equality checks.
+ *
+ * @param value - The value to test.
+ *
+ * @returns Whether or not the value is a primitive.
+ *
+ * @see isBigint
+ * @see isBoolean
+ * @see isNull
+ * @see isNumber
+ * @see isString
+ * @see isSymbol
+ * @see isUndefined
+ * @see https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards
+ */
+export function isPrimitive(value) {
+    return (isBigint(value) ||
+        isBoolean(value) ||
+        isNull(value) ||
+        isNumber(value) ||
+        isString(value) ||
+        isSymbol(value) ||
+        isUndefined(value));
+}
 /**
  * A type guard to assess that a value is a string.
  *

package/lib/esm/guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,WAAW,CAAC;AACtC,CAAC"}
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/guard.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,SAAS,CAAC,KAAK,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC;QACb,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC;QACf,QAAQ,CAAC,KAAK,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,CACnB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,WAAW,CAAC;AACtC,CAAC"}

package/lib/esm/index.d.ts

@@ -2,51 +2,7 @@ export * from "./func.js";
 export * from "./guard.js";
 export * from "./events.js";
 export * from "./predicates.js";
-/**
- * Convenience type to represent environment variables.
- */
-export type EnvironmentVariables = Record<string, string | undefined>;
-/**
- * Just aliasing {@link EnvironmentVariables} for brevity.
- */
-export type EnvVars = EnvironmentVariables;
-/**
- * Convenient type alias to regroup a type that can be T, null or undefined.
- *
- * Semantically the opposite of {@link NonNullable}.
- */
-export type Nullable<T> = T | null | undefined;
-/**
- * Convenient mapped type to selectively make some fields of a type optional.
- *
- * This is in contrast to the built-in `Partial` type which makes all fields optional.
- */
-export type Optional<T, K extends keyof T = keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
-/**
- * A convenience type extractor to get the inner type of an array.
- *
- * It will cause compilation errors if T isn't an array.
- *
- * See here: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html
- */
-export type UnpackedArray<T> = T extends (infer U)[] ? U : never;
-/**
- * A convenience type mapping that transitively make partial fields optional.
- *
- * The built-in Partial type doesn't cover nested objects, this one does.
- */
-export type TransitivePartial<T> = {
-    [K in keyof T]?: T[K] extends object ? TransitivePartial<T[K]> : T[K];
-};
-/**
- * A convenience type mapping to extract keys of a type that are of a given type.
- *
- * For example, if you would like all the types of an object that are numbers, you could do
- * KeyOfType<TheType, number>
- */
-export type KeyOfType<T, U> = {
-    [P in keyof T]: T[P] extends U ? P : never;
-}[keyof T];
+export * from "./types.js";
 /**
  * A function for forcing exhaustiveness in switch statements or if-else chains.
  *

package/lib/esm/index.js

@@ -2,6 +2,7 @@ export * from "./func.js";
 export * from "./guard.js";
 export * from "./events.js";
 export * from "./predicates.js";
+export * from "./types.js";
 /**
  * A function for forcing exhaustiveness in switch statements or if-else chains.
  *

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAsDhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/esm/predicates.js

@@ -1,3 +1,4 @@
+import { isObjectNotNull } from "./guard.js";
 /**
  * A type predicate to determine if a value is a plain object.
  *
@@ -9,6 +10,6 @@
  * @returns Whether or not the value is a plain object.
  */
 export function isPlainObject(value) {
-    return (typeof value === "object" && value !== null && value.constructor === Object);
+    return isObjectNotNull(value) && value.constructor === Object;
 }
 //# sourceMappingURL=predicates.js.map

package/lib/esm/predicates.js.map

@@ -1 +1 @@
-{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/predicates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,CAC5E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../src/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC;AAChE,CAAC"}

package/lib/esm/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Convenience type to represent environment variables.
+ */
+export type EnvironmentVariables = Record<string, string | undefined>;
+/**
+ * Just aliasing {@link EnvironmentVariables} for brevity.
+ */
+export type EnvVars = EnvironmentVariables;
+/**
+ * A convenience type mapping to extract keys of a type that are of a given type.
+ *
+ * For example, if you would like all the types of an object that are numbers, you could do
+ * KeyOfType<TheType, number>
+ */
+export type KeyOfType<T, U> = {
+    [P in keyof T]: T[P] extends U ? P : never;
+}[keyof T];
+/**
+ * Convenient type alias to regroup a type that can be T, null or undefined.
+ *
+ * Semantically the opposite of {@link NonNullable}.
+ */
+export type Nullable<T> = T | null | undefined;
+/**
+ * Convenient mapped type to selectively make some fields of a type optional.
+ *
+ * This is in contrast to the built-in `Partial` type which makes all fields optional.
+ */
+export type Optional<T, K extends keyof T = keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+/**
+ * A union type that includes all primitive types.
+ */
+export type Primitive = bigint | boolean | null | number | string | symbol | undefined;
+/**
+ * A convenience type mapping that transitively make partial fields optional.
+ *
+ * The built-in Partial type doesn't cover nested objects, this one does.
+ */
+export type TransitivePartial<T> = {
+    [K in keyof T]?: T[K] extends object ? TransitivePartial<T[K]> : T[K];
+};
+/**
+ * A convenience type extractor to get the inner type of an array.
+ *
+ * It will cause compilation errors if T isn't an array.
+ *
+ * See here: https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html
+ */
+export type UnpackedArray<T> = T extends (infer U)[] ? U : never;

package/lib/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/esm/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/types",
-  "version": "0.12.0",
+  "version": "0.13.0-alpha.1",
   "description": "Typescript types utility package.",
   "keywords": [
     "type",