@hz-9/a5-core 0.2.0-alpha.18 → 0.2.0-alpha.20

package/dist/all.d.ts

@@ -435,6 +435,13 @@ export declare class A5Util {
     static tryWithAbsolutePath(sourcePath: string, basePath: string): string;
 }
 
+/**
+ * 类型断言工具 - 判断两个类型结构相似
+ *
+ * @public
+ */
+export declare type Alike<X, Y> = Equal<MergeInsertions<X>, MergeInsertions<Y>>;
+
 /**
  * @public
  */
@@ -462,16 +469,67 @@ export declare class ColorUtil {
     static clear(text: string): string;
 }
 
+/**
+ * 类型调试工具 - 展开类型定义
+ *
+ * @public
+ */
+export declare type Debug<T> = {
+    [K in keyof T]: T[K];
+};
+
 /**
  * @public
  */
 export declare const DEFAULT_LOG_LEVELS: LogLevel[];
 
+/**
+ * 类型断言工具 - 判断两个类型相等
+ *
+ * @public
+ */
+export declare type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;
+
 /**
  * @public
  */
 export declare const ERROR_WELCOME_MSG: string;
 
+/**
+ * 类型断言工具 - 期望类型为 true
+ *
+ * @public
+ */
+export declare type Expect<T extends true> = T;
+
+/**
+ * 类型断言工具 - 期望类型扩展自目标类型
+ *
+ * @public
+ */
+export declare type ExpectExtends<VALUE, EXPECTED> = EXPECTED extends VALUE ? true : false;
+
+/**
+ * 类型断言工具 - 期望值为 false
+ *
+ * @public
+ */
+export declare type ExpectFalse<T extends false> = T;
+
+/**
+ * 类型断言工具 - 期望值为 true
+ *
+ * @public
+ */
+export declare type ExpectTrue<T extends true> = T;
+
+/**
+ * 类型断言工具 - 验证函数参数类型
+ *
+ * @public
+ */
+export declare type ExpectValidArgs<FUNC extends (...args: any[]) => any, ARGS extends any[]> = ARGS extends Parameters<FUNC> ? true : false;
+
 /**
  * @public
  */
@@ -535,6 +593,27 @@ export declare abstract class IA5ConfigModule {
 export declare abstract class IA5LogModule {
 }
 
+/**
+ * 类型断言工具 - 判断是否为 any 类型
+ *
+ * @public
+ */
+export declare type IsAny<T> = 0 extends (1 & T) ? true : false;
+
+/**
+ * 类型断言工具 - 判断是否为 false
+ *
+ * @public
+ */
+export declare type IsFalse<T extends false> = T;
+
+/**
+ * 类型断言工具 - 判断是否为 true
+ *
+ * @public
+ */
+export declare type IsTrue<T extends true> = T;
+
 /**
  * 包加载工具类
  * 用于统一处理可选依赖的动态导入
@@ -602,6 +681,15 @@ export declare class LogoUtil {
  */
 export declare const MAIN_STATIC_PATH: string;
 
+/**
+ * 类型合并工具 - 合并嵌套类型
+ *
+ * @public
+ */
+export declare type MergeInsertions<T> = T extends object ? {
+    [K in keyof T]: MergeInsertions<T[K]>;
+} : T;
+
 /**
  *
  * @public
@@ -622,6 +710,20 @@ export declare const MODULE_CONFIG_PATH_A5_LOG: <T extends string>(str: T) => `A
 
 export { nanoid }
 
+/**
+ * 类型断言工具 - 判断不是 any 类型
+ *
+ * @public
+ */
+export declare type NotAny<T> = true extends IsAny<T> ? false : true;
+
+/**
+ * 类型断言工具 - 判断两个类型不相等
+ *
+ * @public
+ */
+export declare type NotEqual<X, Y> = true extends Equal<X, Y> ? false : true;
+
 /**
  * @public
  */
@@ -661,6 +763,13 @@ export declare class RunEnvUtil {
     static get inJest(): boolean;
 }
 
+/**
+ * 类型转换工具 - 联合类型转交叉类型
+ *
+ * @public
+ */
+export declare type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+
 /**
  * @public
  */

package/dist/interface/index.d.ts

@@ -1,3 +1,4 @@
 export * from './base';
 export * from './http';
 export * from './provide-token';
+export * from './type-challenges.utils';

package/dist/interface/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./base"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./provide-token"), exports);
+__exportStar(require("./type-challenges.utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/interface/type-challenges.utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 类型断言工具 - 期望类型为 true
+ *
+ * @public
+ */
+export type Expect<T extends true> = T;
+/**
+ * 类型断言工具 - 期望值为 true
+ *
+ * @public
+ */
+export type ExpectTrue<T extends true> = T;
+/**
+ * 类型断言工具 - 期望值为 false
+ *
+ * @public
+ */
+export type ExpectFalse<T extends false> = T;
+/**
+ * 类型断言工具 - 判断是否为 true
+ *
+ * @public
+ */
+export type IsTrue<T extends true> = T;
+/**
+ * 类型断言工具 - 判断是否为 false
+ *
+ * @public
+ */
+export type IsFalse<T extends false> = T;
+/**
+ * 类型断言工具 - 判断两个类型不相等
+ *
+ * @public
+ */
+export type NotEqual<X, Y> = true extends Equal<X, Y> ? false : true;
+/**
+ * 类型断言工具 - 判断两个类型相等
+ *
+ * @public
+ */
+export type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;
+/**
+ * 类型断言工具 - 判断是否为 any 类型
+ *
+ * @public
+ */
+export type IsAny<T> = 0 extends (1 & T) ? true : false;
+/**
+ * 类型断言工具 - 判断不是 any 类型
+ *
+ * @public
+ */
+export type NotAny<T> = true extends IsAny<T> ? false : true;
+/**
+ * 类型调试工具 - 展开类型定义
+ *
+ * @public
+ */
+export type Debug<T> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * 类型合并工具 - 合并嵌套类型
+ *
+ * @public
+ */
+export type MergeInsertions<T> = T extends object ? {
+    [K in keyof T]: MergeInsertions<T[K]>;
+} : T;
+/**
+ * 类型断言工具 - 判断两个类型结构相似
+ *
+ * @public
+ */
+export type Alike<X, Y> = Equal<MergeInsertions<X>, MergeInsertions<Y>>;
+/**
+ * 类型断言工具 - 期望类型扩展自目标类型
+ *
+ * @public
+ */
+export type ExpectExtends<VALUE, EXPECTED> = EXPECTED extends VALUE ? true : false;
+/**
+ * 类型断言工具 - 验证函数参数类型
+ *
+ * @public
+ */
+export type ExpectValidArgs<FUNC extends (...args: any[]) => any, ARGS extends any[]> = ARGS extends Parameters<FUNC> ? true : false;
+/**
+ * 类型转换工具 - 联合类型转交叉类型
+ *
+ * @public
+ */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;

package/dist/interface/type-challenges.utils.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type-challenges.utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hz-9/a5-core",
-  "version": "0.2.0-alpha.18",
+  "version": "0.2.0-alpha.20",
   "description": "The core library for the `@hz-9/a5-*` series of repositories.",
   "keywords": [
     "nest",
@@ -45,7 +45,6 @@
     "@types/node": "~20.3.1",
     "@types/pug": "~2.0.10",
     "@types/uuid": "~9.0.8",
-    "@type-challenges/utils": "~0.1.1",
     "axios": "~1.7.2",
     "body-parser": "~1.20.2",
     "dayjs": "~1.11.10",