fs-stream-sync 2.0.21 → 2.0.22

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.22](https://github.com/bluelovers/ws-iconv/compare/fs-stream-sync@2.0.21...fs-stream-sync@2.0.22) (2026-03-02)
+
+
+
+### 📚　Documentation
+
+* 為檔案系統相關套件新增雙語 JSDoc 註解與型別標註 ([83f3845](https://github.com/bluelovers/ws-iconv/commit/83f38456ccc0f5eca4f2a6505bee4caf7e634ba6))
+
+
+
 ## [2.0.21](https://github.com/bluelovers/ws-iconv/compare/fs-stream-sync@2.0.20...fs-stream-sync@2.0.21) (2026-03-01)
 
 **Note:** Version bump only for package fs-stream-sync

package/index.d.ts

@@ -1,8 +1,62 @@
+/**
+ * fs-stream-sync - 檔案系統同步流處理模組
+ * File System Synchronous Stream Processing Module
+ *
+ * 提供同步檔案讀寫流功能，相容於 Node.js 核心 fs 模組
+ * Provides synchronous file read/write streams, compatible with Node.js core fs module
+ *
+ * @module fs-stream-sync
+ * @author bluelovers
+ */
 import { ReadStream, createReadStream } from './read';
 import { SyncReadStream, createSyncReadStream } from './read-sync';
 import { SyncWriteStream, createSyncWriteStream } from './write-sync';
 import { WriteStream, createWriteStream } from './write';
+/**
+ * 重新導出介面類型
+ * Re-export interface types
+ */
 export { IFsReadStreamOptions, IFsWriteStreamOptions, PathLike } from './lib/interface';
-export { ReadStream, WriteStream, SyncReadStream, SyncWriteStream, createReadStream, createWriteStream, createSyncReadStream, createSyncWriteStream };
+/**
+ * 導出所有流類別和建立函數
+ * Export all stream classes and factory functions
+ */
+export { 
+/**
+ * 讀取流類別 / Read stream class
+ */
+ReadStream, 
+/**
+ * 寫入流類別 / Write stream class
+ */
+WriteStream, 
+/**
+ * 同步讀取流類別 / Synchronous read stream class
+ */
+SyncReadStream, 
+/**
+ * 同步寫入流類別 / Synchronous write stream class
+ */
+SyncWriteStream, 
+/**
+ * 建立讀取流 / Create read stream
+ */
+createReadStream, 
+/**
+ * 建立寫入流 / Create write stream
+ */
+createWriteStream, 
+/**
+ * 建立同步讀取流 / Create synchronous read stream
+ */
+createSyncReadStream, 
+/**
+ * 建立同步寫入流 / Create synchronous write stream
+ */
+createSyncWriteStream };
+/**
+ * 預設導出 - 模組所有匯出內容
+ * Default export - all module exports
+ */
 declare const _default: typeof import("./index");
 export default _default;

package/index.js

@@ -1,7 +1,17 @@
 "use strict";
-/// <reference types="node" />
+/**
+ * fs-stream-sync - 檔案系統同步流處理模組
+ * File System Synchronous Stream Processing Module
+ *
+ * 提供同步檔案讀寫流功能，相容於 Node.js 核心 fs 模組
+ * Provides synchronous file read/write streams, compatible with Node.js core fs module
+ *
+ * @module fs-stream-sync
+ * @author bluelovers
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSyncWriteStream = exports.createSyncReadStream = exports.createWriteStream = exports.createReadStream = exports.SyncWriteStream = exports.SyncReadStream = exports.WriteStream = exports.ReadStream = void 0;
+/// <reference types="node" />
 const read_1 = require("./read");
 Object.defineProperty(exports, "ReadStream", { enumerable: true, get: function () { return read_1.ReadStream; } });
 Object.defineProperty(exports, "createReadStream", { enumerable: true, get: function () { return read_1.createReadStream; } });
@@ -14,5 +24,9 @@ Object.defineProperty(exports, "createSyncWriteStream", { enumerable: true, get:
 const write_1 = require("./write");
 Object.defineProperty(exports, "WriteStream", { enumerable: true, get: function () { return write_1.WriteStream; } });
 Object.defineProperty(exports, "createWriteStream", { enumerable: true, get: function () { return write_1.createWriteStream; } });
+/**
+ * 預設導出 - 模組所有匯出內容
+ * Default export - all module exports
+ */
 exports.default = exports;
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,8BAA8B;AAE9B,iCAAsD;AAmBrD,2FAnBQ,iBAAU,OAmBR;AAiBV,iGApCoB,uBAAgB,OAoCpB;AAnCjB,2CAAmE;AA0BlE,+FA1BQ,0BAAc,OA0BR;AAiBd,qGA3CwB,gCAAoB,OA2CxB;AA1CrB,6CAAsE;AA6BrE,gGA7BQ,4BAAe,OA6BR;AAiBf,sGA9CyB,kCAAqB,OA8CzB;AA7CtB,mCAAyD;AAoBxD,4FApBQ,mBAAW,OAoBR;AAiBX,kGArCqB,yBAAiB,OAqCrB;AAWlB;;;GAGG;AACH,kBAAe,OAAmC,CAAC","sourcesContent":["/**\n * fs-stream-sync - 檔案系統同步流處理模組\n * File System Synchronous Stream Processing Module\n *\n * 提供同步檔案讀寫流功能，相容於 Node.js 核心 fs 模組\n * Provides synchronous file read/write streams, compatible with Node.js core fs module\n *\n * @module fs-stream-sync\n * @author bluelovers\n */\n\n/// <reference types=\"node\" />\n\nimport { ReadStream, createReadStream } from './read';\nimport { SyncReadStream, createSyncReadStream } from './read-sync';\nimport { SyncWriteStream, createSyncWriteStream } from './write-sync';\nimport { WriteStream, createWriteStream } from './write';\n\n/**\n * 重新導出介面類型\n * Re-export interface types\n */\nexport { IFsReadStreamOptions, IFsWriteStreamOptions, PathLike } from './lib/interface';\n\n/**\n * 導出所有流類別和建立函數\n * Export all stream classes and factory functions\n */\nexport {\n\t/**\n\t * 讀取流類別 / Read stream class\n\t */\n\tReadStream,\n\t/**\n\t * 寫入流類別 / Write stream class\n\t */\n\tWriteStream,\n\t/**\n\t * 同步讀取流類別 / Synchronous read stream class\n\t */\n\tSyncReadStream,\n\t/**\n\t * 同步寫入流類別 / Synchronous write stream class\n\t */\n\tSyncWriteStream,\n\n\t/**\n\t * 建立讀取流 / Create read stream\n\t */\n\tcreateReadStream,\n\t/**\n\t * 建立寫入流 / Create write stream\n\t */\n\tcreateWriteStream,\n\t/**\n\t * 建立同步讀取流 / Create synchronous read stream\n\t */\n\tcreateSyncReadStream,\n\t/**\n\t * 建立同步寫入流 / Create synchronous write stream\n\t */\n\tcreateSyncWriteStream\n}\n\n/**\n * 預設導出 - 模組所有匯出內容\n * Default export - all module exports\n */\nexport default exports as typeof import('./index');\n"]}

package/lib/errors.d.ts

@@ -1,10 +1,56 @@
+/**
+ * 檔案系統流錯誤處理
+ * File System Stream Error Handling
+ *
+ * 定義錯誤類型和錯誤碼列舉
+ * Defines error classes and error code enums
+ */
 import ErrnoException = NodeJS.ErrnoException;
+/**
+ * Node.js 風格錯誤類別
+ * Node.js style error class
+ *
+ * 擴展 Error 類別，加入錯誤碼屬性
+ * Extends Error class with code property
+ */
 export declare class NodeLikeError extends Error {
+    /**
+     * 錯誤碼 / Error code
+     */
     code: string;
+    /**
+     * 構造函數
+     * Constructor
+     *
+     * @param {string} code - 錯誤碼 / Error code
+     * @param {string} [msg] - 錯誤訊息 / Error message
+     */
     constructor(code: string, msg?: any);
 }
+/**
+ * 建立錯誤物件
+ * Create error object
+ *
+ * 使用指定的錯誤類別和錯誤碼建立錯誤物件
+ * Creates error object with specified error class and code
+ *
+ * @param {new (msg?) => T} Err - 錯誤類別 / Error class
+ * @param {string} code - 錯誤碼 / Error code
+ * @param {string} [msg] - 錯誤訊息 / Error message
+ * @returns {T} 錯誤物件 / Error object
+ */
 export declare function createError<T extends ErrnoException>(Err: new (msg?: any) => T, code: string, msg?: any): T;
+/**
+ * 檔案流錯誤碼列舉
+ * File stream error code enum
+ */
 export declare enum EnumFsStreamErrorCode {
+    /**
+     * 寫入在結束後嘗試 / Write after end
+     */
     ERR_STREAM_WRITE_AFTER_END = "ERR_STREAM_WRITE_AFTER_END",
+    /**
+     * 流已銷毀 / Stream destroyed
+     */
     ERR_STREAM_DESTROYED = "ERR_STREAM_DESTROYED"
 }

package/lib/errors.js

@@ -1,22 +1,65 @@
 "use strict";
+/**
+ * 檔案系統流錯誤處理
+ * File System Stream Error Handling
+ *
+ * 定義錯誤類型和錯誤碼列舉
+ * Defines error classes and error code enums
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnumFsStreamErrorCode = exports.NodeLikeError = void 0;
 exports.createError = createError;
+/**
+ * Node.js 風格錯誤類別
+ * Node.js style error class
+ *
+ * 擴展 Error 類別，加入錯誤碼屬性
+ * Extends Error class with code property
+ */
 class NodeLikeError extends Error {
+    /**
+     * 構造函數
+     * Constructor
+     *
+     * @param {string} code - 錯誤碼 / Error code
+     * @param {string} [msg] - 錯誤訊息 / Error message
+     */
     constructor(code, msg) {
         super(msg);
         this.code = code;
     }
 }
 exports.NodeLikeError = NodeLikeError;
+/**
+ * 建立錯誤物件
+ * Create error object
+ *
+ * 使用指定的錯誤類別和錯誤碼建立錯誤物件
+ * Creates error object with specified error class and code
+ *
+ * @param {new (msg?) => T} Err - 錯誤類別 / Error class
+ * @param {string} code - 錯誤碼 / Error code
+ * @param {string} [msg] - 錯誤訊息 / Error message
+ * @returns {T} 錯誤物件 / Error object
+ */
 function createError(Err, code, msg) {
     let e = new Err(msg);
     e.code = code;
     return e;
 }
+/**
+ * 檔案流錯誤碼列舉
+ * File stream error code enum
+ */
 var EnumFsStreamErrorCode;
 (function (EnumFsStreamErrorCode) {
+    /**
+     * 寫入在結束後嘗試 / Write after end
+     */
     EnumFsStreamErrorCode["ERR_STREAM_WRITE_AFTER_END"] = "ERR_STREAM_WRITE_AFTER_END";
+    /**
+     * 流已銷毀 / Stream destroyed
+     */
     EnumFsStreamErrorCode["ERR_STREAM_DESTROYED"] = "ERR_STREAM_DESTROYED";
 })(EnumFsStreamErrorCode || (exports.EnumFsStreamErrorCode = EnumFsStreamErrorCode = {}));
 //# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA4CH,kCAKC;AA7CD;;;;;;GAMG;AACH,MAAa,aAAc,SAAQ,KAAK;IAOvC;;;;;;OAMG;IACH,YAAY,IAAY,EAAE,GAAI;QAE7B,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;CACD;AAnBD,sCAmBC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAA2B,GAAoB,EAAE,IAAY,EAAE,GAAI;IAE7F,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACpB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAA;IACb,OAAO,CAAC,CAAA;AACT,CAAC;AAED;;;GAGG;AACH,IAAY,qBAUX;AAVD,WAAY,qBAAqB;IAEhC;;OAEG;IACH,kFAAyD,CAAA;IACzD;;OAEG;IACH,sEAA6C,CAAA;AAC9C,CAAC,EAVW,qBAAqB,qCAArB,qBAAqB,QAUhC","sourcesContent":["/**\n * 檔案系統流錯誤處理\n * File System Stream Error Handling\n *\n * 定義錯誤類型和錯誤碼列舉\n * Defines error classes and error code enums\n */\n\nimport ErrnoException = NodeJS.ErrnoException;\n\n/**\n * Node.js 風格錯誤類別\n * Node.js style error class\n *\n * 擴展 Error 類別，加入錯誤碼屬性\n * Extends Error class with code property\n */\nexport class NodeLikeError extends Error\n{\n\t/**\n\t * 錯誤碼 / Error code\n\t */\n\tpublic code: string\n\n\t/**\n\t * 構造函數\n\t * Constructor\n\t *\n\t * @param {string} code - 錯誤碼 / Error code\n\t * @param {string} [msg] - 錯誤訊息 / Error message\n\t */\n\tconstructor(code: string, msg?)\n\t{\n\t\tsuper(msg)\n\t\tthis.code = code\n\t}\n}\n\n/**\n * 建立錯誤物件\n * Create error object\n *\n * 使用指定的錯誤類別和錯誤碼建立錯誤物件\n * Creates error object with specified error class and code\n *\n * @param {new (msg?) => T} Err - 錯誤類別 / Error class\n * @param {string} code - 錯誤碼 / Error code\n * @param {string} [msg] - 錯誤訊息 / Error message\n * @returns {T} 錯誤物件 / Error object\n */\nexport function createError<T extends ErrnoException>(Err: new (msg?) => T, code: string, msg?)\n{\n\tlet e = new Err(msg)\n\te.code = code\n\treturn e\n}\n\n/**\n * 檔案流錯誤碼列舉\n * File stream error code enum\n */\nexport enum EnumFsStreamErrorCode\n{\n\t/**\n\t * 寫入在結束後嘗試 / Write after end\n\t */\n\tERR_STREAM_WRITE_AFTER_END = 'ERR_STREAM_WRITE_AFTER_END',\n\t/**\n\t * 流已銷毀 / Stream destroyed\n\t */\n\tERR_STREAM_DESTROYED = 'ERR_STREAM_DESTROYED',\n}\n\n"]}

package/lib/interface.d.ts

@@ -1,51 +1,135 @@
+/**
+ * 檔案系統流介面定義
+ * File System Stream Interface Definitions
+ *
+ * 定義了檔案讀寫流所需的類型與介面
+ * Defines types and interfaces for file read/write streams
+ */
 export type { PathLike } from 'fs';
+/**
+ * 檔案路徑類型 - 支援字串或 Buffer
+ * File path type - supports string or Buffer
+ */
 export type IFsPath = string | Buffer;
+/**
+ * 檔案流基礎選項介面
+ * File stream base options interface
+ */
 export interface IFsStreamOptions {
+    /**
+     * 檔案開啟標誌 / File open flags
+     * @example 'r' - 讀取, 'w' - 寫入, 'a' - 追加
+     */
     flags?: string;
     /**
+     * 編碼格式 / Encoding format
      * @default null
      */
     encoding?: string;
     /**
+     * 檔案描述符 / File descriptor
      * @default null
      */
     fd?: number;
     /**
+     * 檔案權限模式 / File permission mode
      * @default 0o666
      */
     mode?: number;
     /**
+     * 是否自動關閉 / Auto close flag
      * @default true
      */
     autoClose?: boolean;
+    /**
+     * 開始位置（位元組）/ Start position in bytes
+     */
     start?: number;
 }
+/**
+ * 讀取流選項介面
+ * Read stream options interface
+ */
 export interface IFsReadStreamOptions extends IFsStreamOptions {
     /**
+     * 結束位置（位元組）/ End position in bytes
      * @default Infinity
      */
     end?: number;
     /**
+     * 高水位線（內部緩衝區大小）/ High water mark (internal buffer size)
      * @default 64 * 1024
      */
     highWaterMark?: number;
 }
+/**
+ * 寫入流選項類型
+ * Write stream options type
+ */
 export type IFsWriteStreamOptions = IFsStreamOptions;
+/**
+ * 流狀態介面
+ * Stream state interface
+ */
 export interface IFsStreamState {
+    /**
+     * 是否已銷毀 / Whether stream is destroyed
+     */
     destroyed: boolean;
+    /**
+     * 是否為同步模式 / Whether in sync mode
+     */
     sync: boolean;
 }
+/**
+ * 檔案流介面
+ * File stream interface
+ */
 export interface IFsStream {
+    /**
+     * 自動關閉標誌 / Auto close flag
+     */
     autoClose: boolean;
+    /**
+     * 檔案開啟標誌 / File open flags
+     */
     flags: string;
+    /**
+     * 檔案描述符 / File descriptor
+     */
     fd: number;
+    /**
+     * 檔案權限模式 / File permission mode
+     */
     mode: number;
+    /**
+     * 當前位置 / Current position
+     */
     pos: number;
+    /**
+     * 是否已關閉 / Whether closed
+     */
     closed: boolean;
+    /**
+     * 是否已銷毀 / Whether destroyed
+     */
     destroyed: boolean;
+    /**
+     * 可寫狀態 / Writable state
+     */
     _writableState: IFsStreamState;
+    /**
+     * 可讀狀態 / Readable state
+     */
     _readableState: IFsStreamState;
 }
+/**
+ * 流資料介面
+ * Stream data interface
+ */
 export interface IFsStreamData {
+    /**
+     * 是否已開啟 / Whether opened
+     */
     opened?: boolean;
 }

package/lib/interface.js

@@ -1,3 +1,10 @@
 "use strict";
+/**
+ * 檔案系統流介面定義
+ * File System Stream Interface Definitions
+ *
+ * 定義了檔案讀寫流所需的類型與介面
+ * Defines types and interfaces for file read/write streams
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=interface.js.map

package/lib/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["interface.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * 檔案系統流介面定義\n * File System Stream Interface Definitions\n *\n * 定義了檔案讀寫流所需的類型與介面\n * Defines types and interfaces for file read/write streams\n */\n\nimport { URL } from \"url\";\nexport type { PathLike } from 'fs';\n\n/**\n * 檔案路徑類型 - 支援字串或 Buffer\n * File path type - supports string or Buffer\n */\nexport type IFsPath = string | Buffer\n\n/**\n * 檔案流基礎選項介面\n * File stream base options interface\n */\nexport interface IFsStreamOptions\n{\n\t/**\n\t * 檔案開啟標誌 / File open flags\n\t * @example 'r' - 讀取, 'w' - 寫入, 'a' - 追加\n\t */\n\tflags?: string;\n\t/**\n\t * 編碼格式 / Encoding format\n\t * @default null\n\t */\n\tencoding?: string;\n\t/**\n\t * 檔案描述符 / File descriptor\n\t * @default null\n\t */\n\tfd?: number;\n\t/**\n\t * 檔案權限模式 / File permission mode\n\t * @default 0o666\n\t */\n\tmode?: number;\n\t/**\n\t * 是否自動關閉 / Auto close flag\n\t * @default true\n\t */\n\tautoClose?: boolean;\n\t/**\n\t * 開始位置（位元組）/ Start position in bytes\n\t */\n\tstart?: number;\n}\n\n/**\n * 讀取流選項介面\n * Read stream options interface\n */\nexport interface IFsReadStreamOptions extends IFsStreamOptions\n{\n\t/**\n\t * 結束位置（位元組）/ End position in bytes\n\t * @default Infinity\n\t */\n\tend?: number;\n\t/**\n\t * 高水位線（內部緩衝區大小）/ High water mark (internal buffer size)\n\t * @default 64 * 1024\n\t */\n\thighWaterMark?: number;\n}\n\n/**\n * 寫入流選項類型\n * Write stream options type\n */\nexport type IFsWriteStreamOptions = IFsStreamOptions\n\n/**\n * 流狀態介面\n * Stream state interface\n */\nexport interface IFsStreamState\n{\n\t/**\n\t * 是否已銷毀 / Whether stream is destroyed\n\t */\n\tdestroyed: boolean,\n\t/**\n\t * 是否為同步模式 / Whether in sync mode\n\t */\n\tsync: boolean,\n}\n\n/**\n * 檔案流介面\n * File stream interface\n */\nexport interface IFsStream\n{\n\t/**\n\t * 自動關閉標誌 / Auto close flag\n\t */\n\tautoClose: boolean\n\t/**\n\t * 檔案開啟標誌 / File open flags\n\t */\n\tflags: string\n\t/**\n\t * 檔案描述符 / File descriptor\n\t */\n\tfd: number\n\t/**\n\t * 檔案權限模式 / File permission mode\n\t */\n\tmode: number\n\t/**\n\t * 當前位置 / Current position\n\t */\n\tpos: number\n\t/**\n\t * 是否已關閉 / Whether closed\n\t */\n\tclosed: boolean\n\t/**\n\t * 是否已銷毀 / Whether destroyed\n\t */\n\tdestroyed: boolean\n\n\t/**\n\t * 可寫狀態 / Writable state\n\t */\n\t_writableState: IFsStreamState\n\t/**\n\t * 可讀狀態 / Readable state\n\t */\n\t_readableState: IFsStreamState\n}\n\n/**\n * 流資料介面\n * Stream data interface\n */\nexport interface IFsStreamData\n{\n\t/**\n\t * 是否已開啟 / Whether opened\n\t */\n\topened?: boolean\n}\n"]}

package/lib/internal.d.ts

@@ -1,17 +1,107 @@
+/**
+ * 檔案系統流內部工具函數
+ * File System Stream Internal Utility Functions
+ *
+ * 提供開啟、關閉、銷毀流等核心功能
+ * Provides core functions for opening, closing, and destroying streams
+ */
 import { ReadStream } from '../read';
 import { WriteStream } from '../write';
 import { SyncReadStream } from '../read-sync';
 import { SyncWriteStream } from '../write-sync';
 import { IFsStreamData } from './interface';
 import fs from 'fs';
+/**
+ * 流資料符號鍵 / Stream data symbol key
+ * 用於存取流的內部資料 / Used to access stream's internal data
+ */
 export declare const SYM_FS_STREAM_DATA: unique symbol;
+/**
+ * 檔案流類型聯合 / File stream type union
+ */
 export type IThisFsStream = WriteStream | ReadStream | SyncWriteStream | SyncReadStream;
+/**
+ * 開啟檔案流
+ * Open file stream
+ *
+ * 使用同步方式開啟檔案並發送相關事件
+ * Opens file synchronously and emits relevant events
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ * @param {any[]} [argv] - 額外參數 / Additional arguments
+ */
 export declare function open(thisArgv: IThisFsStream, argv?: any[]): void;
+/**
+ * 發射錯誤事件
+ * Emit error event
+ *
+ * 關閉流並發射錯誤事件
+ * Closes stream and emits error event
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ * @param {T} e - 錯誤物件 / Error object
+ */
 export declare function _error_emit<T extends Error>(thisArgv: IThisFsStream, e: T): void;
+/**
+ * 內部關閉函數
+ * Internal close function
+ *
+ * 根據 autoClose 設定決定是否銷毀流
+ * Destroys stream based on autoClose setting
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ */
 export declare function __close(thisArgv: IThisFsStream): void;
+/**
+ * 錯誤回調處理
+ * Error callback handler
+ *
+ * 關閉流並執行錯誤回調
+ * Closes stream and executes error callback
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ * @param {T} e - 錯誤物件 / Error object
+ * @param {Function} callback - 回調函數 / Callback function
+ */
 export declare function _error_callback<T extends Error>(thisArgv: IThisFsStream, e: T, callback: Function): void;
+/**
+ * 同步關閉檔案流
+ * Close file stream synchronously
+ *
+ * 同步關閉檔案描述符並發送關閉事件
+ * Closes file descriptor synchronously and emits close event
+ *
+ * @param {fs.WriteStream | fs.ReadStream | SyncWriteStream | SyncReadStream} stream - 流實例 / Stream instance
+ * @param {Function} cb - 回調函數 / Callback function
+ * @param {any} [err] - 錯誤物件 / Error object
+ */
 export declare function closeFsStreamSync(stream: fs.WriteStream | fs.ReadStream | SyncWriteStream | SyncReadStream, cb: Function, err?: any): void;
+/**
+ * 銷毀流
+ * Destroy stream
+ *
+ * 處理流的銷毀邏輯，包括關閉檔案描述符
+ * Handles stream destruction logic including closing file descriptor
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ * @param {Error | null} error - 錯誤物件或 null / Error object or null
+ * @param {(error: Error | null) => void} callback - 完成回調 / Completion callback
+ */
 export declare function _destroy(thisArgv: IThisFsStream, error: Error | null, callback: (error: Error | null) => void): void;
+/**
+ * 取得流資料
+ * Get stream data
+ *
+ * 取得或初始化流的內部資料物件
+ * Gets or initializes stream's internal data object
+ *
+ * @param {IThisFsStream} thisArgv - 流實例 / Stream instance
+ * @returns {IFsStreamData} 流資料物件 / Stream data object
+ */
 export declare function getFsStreamData(thisArgv: IThisFsStream): IFsStreamData;
+/**
+ * 預設導出 - 內部模組
+ * Default export - internal module
+ */
 declare const _default: typeof import("./internal");
 export default _default;