@infra-blocks/types 0.25.0 → 0.26.0

package/lib/cjs/index.d.ts

@@ -24,3 +24,24 @@ export * from "./types.js";
  * @param value - The value to validate against never.
  */
 export declare function unreachable(value: never): never;
+/**
+ * A function to mark a value as trusted for a type cast that can leverage inference.
+ *
+ * It is 100% the same as doing a type cast. Sometimes it's going to look nicer and
+ * look more compact, sometimes you're better off with writing the cast.
+ *
+ * @example
+ * type BullshitType = {
+ *  contentz?: string;
+ * };
+ * const value: BullshitType = {
+ *  contentz: "toto",
+ * };
+ * const content: string = trusted(value.contentz);
+ * content.toUpperCase();
+ *
+ * @param value - The value to type cast.
+ *
+ * @returns The value, casted as the parametric type.
+ */
+export declare function trusted<T>(value: unknown): T;

package/lib/cjs/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.unreachable = unreachable;
+exports.trusted = trusted;
 __exportStar(require("./func.js"), exports);
 __exportStar(require("./guard.js"), exports);
 __exportStar(require("./predicates.js"), exports);
@@ -43,4 +44,27 @@ __exportStar(require("./types.js"), exports);
 function unreachable(value) {
     return value;
 }
+/**
+ * A function to mark a value as trusted for a type cast that can leverage inference.
+ *
+ * It is 100% the same as doing a type cast. Sometimes it's going to look nicer and
+ * look more compact, sometimes you're better off with writing the cast.
+ *
+ * @example
+ * type BullshitType = {
+ *  contentz?: string;
+ * };
+ * const value: BullshitType = {
+ *  contentz: "toto",
+ * };
+ * const content: string = trusted(value.contentz);
+ * content.toUpperCase();
+ *
+ * @param value - The value to type cast.
+ *
+ * @returns The value, casted as the parametric type.
+ */
+function trusted(value) {
+    return value;
+}
 //# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA0BA,kCAEC;AA5BD,4CAA0B;AAC1B,6CAA2B;AAC3B,kDAAgC;AAChC,6CAA2B;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AA0BA,kCAEC;AAsBD,0BAEC;AApDD,4CAA0B;AAC1B,6CAA2B;AAC3B,kDAAgC;AAChC,6CAA2B;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,OAAO,CAAI,KAAc;IACvC,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/lib/esm/index.d.ts

@@ -24,3 +24,24 @@ export * from "./types.js";
  * @param value - The value to validate against never.
  */
 export declare function unreachable(value: never): never;
+/**
+ * A function to mark a value as trusted for a type cast that can leverage inference.
+ *
+ * It is 100% the same as doing a type cast. Sometimes it's going to look nicer and
+ * look more compact, sometimes you're better off with writing the cast.
+ *
+ * @example
+ * type BullshitType = {
+ *  contentz?: string;
+ * };
+ * const value: BullshitType = {
+ *  contentz: "toto",
+ * };
+ * const content: string = trusted(value.contentz);
+ * content.toUpperCase();
+ *
+ * @param value - The value to type cast.
+ *
+ * @returns The value, casted as the parametric type.
+ */
+export declare function trusted<T>(value: unknown): T;

package/lib/esm/index.js

@@ -26,4 +26,27 @@ export * from "./types.js";
 export function unreachable(value) {
     return value;
 }
+/**
+ * A function to mark a value as trusted for a type cast that can leverage inference.
+ *
+ * It is 100% the same as doing a type cast. Sometimes it's going to look nicer and
+ * look more compact, sometimes you're better off with writing the cast.
+ *
+ * @example
+ * type BullshitType = {
+ *  contentz?: string;
+ * };
+ * const value: BullshitType = {
+ *  contentz: "toto",
+ * };
+ * const content: string = trusted(value.contentz);
+ * content.toUpperCase();
+ *
+ * @param value - The value to type cast.
+ *
+ * @returns The value, casted as the parametric type.
+ */
+export function trusted(value) {
+    return value;
+}
 //# sourceMappingURL=index.js.map

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,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;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,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,OAAO,CAAI,KAAc;IACvC,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/package.json

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