@ls-stack/utils 3.2.9 → 3.2.10

package/lib/saferTyping.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/saferTyping.ts
+var saferTyping_exports = {};
+__export(saferTyping_exports, {
+  __FIX_THIS_CASTING__: () => __FIX_THIS_CASTING__,
+  __FIX_THIS_TYPING__: () => __FIX_THIS_TYPING__,
+  __LEGIT_ANY_CAST__: () => __LEGIT_ANY_CAST__,
+  __LEGIT_CAST__: () => __LEGIT_CAST__,
+  __REFINE_CAST__: () => __REFINE_CAST__
+});
+module.exports = __toCommonJS(saferTyping_exports);
+function __LEGIT_ANY_CAST__(value) {
+  return value;
+}
+function __LEGIT_CAST__(value) {
+  return value;
+}
+function __REFINE_CAST__(value) {
+  return () => value;
+}
+function __FIX_THIS_CASTING__(value) {
+  return value;
+}
+function __FIX_THIS_TYPING__(value) {
+  return value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  __FIX_THIS_CASTING__,
+  __FIX_THIS_TYPING__,
+  __LEGIT_ANY_CAST__,
+  __LEGIT_CAST__,
+  __REFINE_CAST__
+});

package/lib/saferTyping.d.cts

@@ -0,0 +1,27 @@
+/** Use this only when you have 100% of certainty that this will not break the types */
+type __LEGIT_ANY__ = any;
+/**
+ * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
+ *
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __LEGIT_ANY_CAST__<V = unknown>(value: V): __LEGIT_ANY__;
+/**
+ * Cast a value to a specific type T. Use this when you have legit usage of type assertion.
+ *
+ * @template T - The type to cast to
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __LEGIT_CAST__<T, V = unknown>(value: V): T;
+/**
+ * Refine a value to a specific type T. Use this when you have legit usage of type assertion.
+ *
+ * @template T - The type to cast to
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
+declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
+type __FIX_THIS_TYPING__ = any;
+declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
+
+export { __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };

package/lib/saferTyping.d.ts

@@ -0,0 +1,27 @@
+/** Use this only when you have 100% of certainty that this will not break the types */
+type __LEGIT_ANY__ = any;
+/**
+ * Cast a value to `any` type. Use this when you have legit usage of `any` casting.
+ *
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __LEGIT_ANY_CAST__<V = unknown>(value: V): __LEGIT_ANY__;
+/**
+ * Cast a value to a specific type T. Use this when you have legit usage of type assertion.
+ *
+ * @template T - The type to cast to
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __LEGIT_CAST__<T, V = unknown>(value: V): T;
+/**
+ * Refine a value to a specific type T. Use this when you have legit usage of type assertion.
+ *
+ * @template T - The type to cast to
+ * @template V (optional) - When used enforces that the casted value is assignable to the type V, use it for safer casts
+ */
+declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
+declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
+type __FIX_THIS_TYPING__ = any;
+declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
+
+export { __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };

package/lib/saferTyping.js

@@ -0,0 +1,23 @@
+// src/saferTyping.ts
+function __LEGIT_ANY_CAST__(value) {
+  return value;
+}
+function __LEGIT_CAST__(value) {
+  return value;
+}
+function __REFINE_CAST__(value) {
+  return () => value;
+}
+function __FIX_THIS_CASTING__(value) {
+  return value;
+}
+function __FIX_THIS_TYPING__(value) {
+  return value;
+}
+export {
+  __FIX_THIS_CASTING__,
+  __FIX_THIS_TYPING__,
+  __LEGIT_ANY_CAST__,
+  __LEGIT_CAST__,
+  __REFINE_CAST__
+};

package/lib/typingUtils.d.cts

@@ -10,5 +10,11 @@ type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType
 type IsAny<T> = unknown extends T ? [
     keyof T
 ] extends [never] ? false : true : false;
+type Prettify<T extends Record<string, unknown>> = {
+    [P in keyof T]: T[P];
+} & {};
+type DeepPrettify<T> = {
+    [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
+} & {};
 
-export type { IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord };
+export type { DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/lib/typingUtils.d.ts

@@ -10,5 +10,11 @@ type ObjKeysWithValuesOfType<Obj extends Record<PropertyKey, unknown>, ValueType
 type IsAny<T> = unknown extends T ? [
     keyof T
 ] extends [never] ? false : true : false;
+type Prettify<T extends Record<string, unknown>> = {
+    [P in keyof T]: T[P];
+} & {};
+type DeepPrettify<T> = {
+    [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
+} & {};
 
-export type { IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord };
+export type { DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "3.2.9",
+  "version": "3.2.10",
   "license": "MIT",
   "files": [
     "lib"
@@ -106,6 +106,10 @@
       "import": "./lib/safeJson.js",
       "require": "./lib/safeJson.cjs"
     },
+    "./saferTyping": {
+      "import": "./lib/saferTyping.js",
+      "require": "./lib/saferTyping.cjs"
+    },
     "./shallowEqual": {
       "import": "./lib/shallowEqual.js",
       "require": "./lib/shallowEqual.cjs"