@ts-type/unpacked 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.0.2](https://github.com/bluelovers/ws-ts-type/compare/@ts-type/unpacked@1.0.1...@ts-type/unpacked@1.0.2) (2026-03-07)
+
+
+
+### 📚　Documentation
+
+* enhance documentation and JSDoc comments across multiple packages ([88ee99b](https://github.com/bluelovers/ws-ts-type/commit/88ee99b3a489645ca53093357cc3523dbe7996e0))
+
+
+### 🛠　Build System
+
+* 更新多個套件的 test 指令為 jest ([61ea53b](https://github.com/bluelovers/ws-ts-type/commit/61ea53bf15fc3ed0e216793200604ae5a52079c9))
+
+
+### ♻️　Chores
+
+* migrate from yarn to pnpm and enhance test infrastructure ([8a5daa2](https://github.com/bluelovers/ws-ts-type/commit/8a5daa2f2022eaf025c3349d4fe5dc8971f8c077))
+
+
+
 ## 1.0.1 (2022-10-10)
 
 

package/README.md

@@ -1,8 +1,19 @@
-# README.md
+# @ts-type/unpacked
 
-    
+類型解包裝工具，從複雜類型中提取內部類型
 
-## install
+Type unpacking utilities to extract inner types from complex types
+
+## 功能特點 / Features
+
+- 從 Promise、Map、Set 等包裝類型中提取內部類型
+- Extract inner types from Promise, Map, Set and other wrapper types
+- 支援函式回傳類型、Iterator、ArrayLike 等
+- Support function return types, Iterator, ArrayLike, etc.
+- 完整的 TypeScript 類型推論
+- Complete TypeScript type inference
+
+## 安裝 / Install
 
 ```bash
 yarn add @ts-type/unpacked
@@ -10,3 +21,21 @@ yarn-tool add @ts-type/unpacked
 yt add @ts-type/unpacked
 ```
 
+## 使用範例 / Usage Example
+
+```typescript
+import type { ITSUnpacked, ITSUnpackedPromiseLike, ITSUnpackedArrayLike } from '@ts-type/unpacked';
+
+// 解包裝 Promise 類型
+type PromiseValue = ITSUnpacked<Promise<string>>;
+// type: string
+
+// 解包裝陣列類型
+type ArrayElement = ITSUnpackedArrayLike<string[]>;
+// type: string
+
+// 解包裝 Iterator
+type IteratorValue = ITSUnpacked<Iterator<number>>;
+// type: number
+```
+

package/index.d.ts

@@ -1,10 +1,52 @@
 import { ITSMapLike, ITSResolvable, ITSTypeFunction } from 'ts-type/lib/generic';
+/**
+ * 取得函式回傳類型的未包裝類型
+ * Get unpacked type of function return type
+ *
+ * @typeParam T - 函式類型 / Function type
+ */
 export type ITSUnpackedReturnType<T extends (...args: any[]) => any> = ITSUnpacked<ReturnType<T>>;
 /**
+ * 解包裝類型 - 從各種包裝類型中提取內部類型
+ * Unpack type - Extract inner type from various wrapper types
+ *
+ * 支援解包裝：
+ * - Map, WeakMap, Set, WeakSet 等 MapLike 類型
+ * - 陣列 / Array
+ * - ArrayLike
+ * - Iterator / IteratorResult
+ * - 函式
+ * - 可解析類型（Promise, Thenable）
+ *
  * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html
+ * @typeParam T - 要解包裝的類型 / Type to unpack
  */
 export type ITSUnpacked<T> = T extends ITSMapLike<any, infer U> ? U : T extends (infer U)[] ? U : T extends ArrayLike<infer U> ? U : T extends Iterator<infer U> ? U : T extends IteratorResult<infer U> ? U : T extends ITSTypeFunction<infer U> ? U : T extends ITSResolvable<infer U> ? U : T;
+/**
+ * 解包裝可 Promise 或 Thenable 類型
+ * Unpack Promise or Thenable type
+ *
+ * @typeParam T - 要解包裝的類型 / Type to unpack
+ */
 export type ITSUnpackedPromiseLike<T> = T extends ITSResolvable<infer U> ? U : T;
+/**
+ * 解包裝 Iterator 或 IteratorResult 類型
+ * Unpack Iterator or IteratorResult type
+ *
+ * @typeParam T - Iterator 相關類型 / Iterator-related type
+ */
 export type ITSUnpackedIteratorLike<T extends Iterator<any> | IteratorResult<any>> = T extends Iterator<infer U> ? U : T extends IteratorYieldResult<infer U> ? U : never;
+/**
+ * 解包裝類陣列或陣列類型
+ * Unpack array-like or array type
+ *
+ * @typeParam T - 陣列類型 / Array type
+ */
 export type ITSUnpackedArrayLike<T extends ArrayLike<any> | any[]> = T extends (infer U)[] ? ITSUnpacked<U> : T extends readonly (infer U)[] ? ITSUnpacked<U> : T extends ArrayLike<infer U> ? ITSUnpacked<U> : T;
+/**
+ * 取得函式的 this 參數類型
+ * Get the this parameter type of a function
+ *
+ * @typeParam T - 函式類型 / Function type
+ */
 export type ITSUnpackedThisFunction<T extends (...args: any[]) => any> = T extends (this: infer R, ...args: any[]) => any ? R : unknown;

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"","sourcesContent":["import { ITSMapLike, ITSResolvable, ITSTypeFunction } from 'ts-type/lib/generic';\n\nexport type ITSUnpackedReturnType<T extends (...args: any[]) => any> =\n\tITSUnpacked<ReturnType<T>>\n//\tT extends ITSTypeFunction<infer R>\n//\t\t? ITSUnpacked<R>\n//\t\t: T\n\t;\n\n/**\n * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html\n */\nexport type ITSUnpacked<T> =\n\tT extends ITSMapLike<any, infer U> ? U :\n\t\tT extends (infer U)[] ? U :\n\t\t\tT extends ArrayLike<infer U> ? U :\n\t\t\t\tT extends Iterator<infer U> ? U :\n\t\t\t\t\tT extends IteratorResult<infer U> ? U :\n\t\t\t\t\t\tT extends ITSTypeFunction<infer U> ? U :\n\t\t\t\t\t\t\tT extends ITSResolvable<infer U> ? U :\n\t\t\t\t\t\t\t\t//T extends Promise<infer U> ? U :\n\t\t\t\t\t\t\t\tT\n\t;\n\nexport type ITSUnpackedPromiseLike<T> =\n\tT extends ITSResolvable<infer U> ? U :\n\t\tT\n\t;\n\nexport type ITSUnpackedIteratorLike<T extends Iterator<any> | IteratorResult<any>> =\n\tT extends Iterator<infer U> ? U :\n\t\tT extends IteratorYieldResult<infer U> ? U :\n\t\t\t\tnever\n\t;\n\nexport type ITSUnpackedArrayLike<T extends ArrayLike<any> | any[]> =\n\tT extends (infer U)[] ? ITSUnpacked<U> :\n\t\tT extends readonly (infer U)[] ? ITSUnpacked<U> :\n\t\t\tT extends ArrayLike<infer U> ? ITSUnpacked<U> :\n\t\t\t\tT\n\t;\n\nexport type ITSUnpackedThisFunction<T extends (...args: any[]) => any> =\n\tT extends (this: infer R, ...args: any[]) => any\n\t\t? R\n\t\t: unknown;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"","sourcesContent":["import { ITSMapLike, ITSResolvable, ITSTypeFunction } from 'ts-type/lib/generic';\n\n/**\n * 取得函式回傳類型的未包裝類型\n * Get unpacked type of function return type\n *\n * @typeParam T - 函式類型 / Function type\n */\nexport type ITSUnpackedReturnType<T extends (...args: any[]) => any> =\n\tITSUnpacked<ReturnType<T>>\n//\tT extends ITSTypeFunction<infer R>\n//\t\t? ITSUnpacked<R>\n//\t\t: T\n\t;\n\n/**\n * 解包裝類型 - 從各種包裝類型中提取內部類型\n * Unpack type - Extract inner type from various wrapper types\n *\n * 支援解包裝：\n * - Map, WeakMap, Set, WeakSet 等 MapLike 類型\n * - 陣列 / Array\n * - ArrayLike\n * - Iterator / IteratorResult\n * - 函式\n * - 可解析類型（Promise, Thenable）\n *\n * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html\n * @typeParam T - 要解包裝的類型 / Type to unpack\n */\nexport type ITSUnpacked<T> =\n\tT extends ITSMapLike<any, infer U> ? U :\n\t\tT extends (infer U)[] ? U :\n\t\t\tT extends ArrayLike<infer U> ? U :\n\t\t\t\tT extends Iterator<infer U> ? U :\n\t\t\t\t\tT extends IteratorResult<infer U> ? U :\n\t\t\t\t\t\tT extends ITSTypeFunction<infer U> ? U :\n\t\t\t\t\t\t\tT extends ITSResolvable<infer U> ? U :\n\t\t\t\t\t\t\t\t//T extends Promise<infer U> ? U :\n\t\t\t\t\t\t\t\tT\n\t;\n\n/**\n * 解包裝可 Promise 或 Thenable 類型\n * Unpack Promise or Thenable type\n *\n * @typeParam T - 要解包裝的類型 / Type to unpack\n */\nexport type ITSUnpackedPromiseLike<T> =\n\tT extends ITSResolvable<infer U> ? U :\n\t\tT\n\t;\n\n/**\n * 解包裝 Iterator 或 IteratorResult 類型\n * Unpack Iterator or IteratorResult type\n *\n * @typeParam T - Iterator 相關類型 / Iterator-related type\n */\nexport type ITSUnpackedIteratorLike<T extends Iterator<any> | IteratorResult<any>> =\n\tT extends Iterator<infer U> ? U :\n\t\tT extends IteratorYieldResult<infer U> ? U :\n\t\t\t\tnever\n\t;\n\n/**\n * 解包裝類陣列或陣列類型\n * Unpack array-like or array type\n *\n * @typeParam T - 陣列類型 / Array type\n */\nexport type ITSUnpackedArrayLike<T extends ArrayLike<any> | any[]> =\n\tT extends (infer U)[] ? ITSUnpacked<U> :\n\t\tT extends readonly (infer U)[] ? ITSUnpacked<U> :\n\t\t\tT extends ArrayLike<infer U> ? ITSUnpacked<U> :\n\t\t\t\tT\n\t;\n\n/**\n * 取得函式的 this 參數類型\n * Get the this parameter type of a function\n *\n * @typeParam T - 函式類型 / Function type\n */\nexport type ITSUnpackedThisFunction<T extends (...args: any[]) => any> =\n\tT extends (this: infer R, ...args: any[]) => any\n\t\t? R\n\t\t: unknown;\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ts-type/unpacked",
-  "version": "1.0.1",
-  "description": "",
+  "version": "1.0.2",
+  "description": "類型解包裝工具，從複雜類型中提取內部類型 | Type unpacking utilities to extract inner types from complex types",
   "keywords": [
     ".d.ts",
     "@types",
@@ -51,17 +51,18 @@
     "pretest": "echo pretest",
     "test": "yarn run test:tsd",
     "test:jest": "jest --passWithNoTests",
+    "test:jest:coverage": "node --run test:jest -- --coverage",
     "test:jest:snapshot": "yarn run test:jest -- -u",
     "test:mocha": "ynpx --quiet -p ts-node -p mocha mocha -- --require ts-node/register \"!(node_modules)/**/*.{test,spec}.{ts,tsx}\"",
     "test:snapshot": "yarn run test -- -u",
     "test:tsd": "ynpx tsd -f ./test/unpacked.test-d.ts",
-    "test:tsdx": "ynpx @bluelovers/tsdx test --passWithNoTests",
+    "test:tsdx": "tsdx test --passWithNoTests",
     "build:dts:bundle": "ynpx dts-bundle-generator -o ./dist/index.d.ts ./src/index.ts --no-banner --inline-declare-global & echo build:dts:bundle",
     "build:dts:copy": "copy .\\src\\index.d.ts .\\dist\\index.d.ts & echo build:dts",
     "build:dts:tsc": "yarn run build:dts:tsc:emit && yarn run build:dts:copy",
     "build:dts:tsc:emit": "tsc --emitDeclarationOnly --declaration --noEmit false",
     "build:microbundle": "ynpx microbundle --target node",
-    "build:tsdx": "ynpx @bluelovers/tsdx build --target node --name index",
+    "build:tsdx": "tsdx build --target node --name index",
     "ci:install": "echo ci:install",
     "ci:build": "echo ci:build",
     "preversion": "echo preversion && yarn run test",
@@ -82,11 +83,10 @@
     "tsc:showConfig": "ynpx get-current-tsconfig -p"
   },
   "dependencies": {
-    "ts-type": "^3.0.1"
+    "ts-type": "^3.0.2"
   },
-  "packageManager": "yarn@1.22.19",
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "fa34eea119b9bcbb363061ddffcfe9d78c2d0ddd"
+  "gitHead": "57f82cba146cfef0d0f3f138e5ec736cd17f040d"
 }