@guanghechen/disposable 1.0.3 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-present guanghechen (https://github.com/guanghechen)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+<header>
+  <h1 align="center">
+    <a href="https://github.com/guanghechen/sora/tree/@guanghechen/disposable@2.0.0/packages/disposable#readme">@guanghechen/disposable</a>
+  </h1>
+  <div align="center">
+    <a href="https://www.npmjs.com/package/@guanghechen/disposable">
+      <img
+        alt="Npm Version"
+        src="https://img.shields.io/npm/v/@guanghechen/disposable.svg"
+      />
+    </a>
+    <a href="https://www.npmjs.com/package/@guanghechen/disposable">
+      <img
+        alt="Npm Download"
+        src="https://img.shields.io/npm/dm/@guanghechen/disposable.svg"
+      />
+    </a>
+    <a href="https://www.npmjs.com/package/@guanghechen/disposable">
+      <img
+        alt="Npm License"
+        src="https://img.shields.io/npm/l/@guanghechen/disposable.svg"
+      />
+    </a>
+    <a href="#install">
+      <img
+        alt="Module Formats: cjs, esm"
+        src="https://img.shields.io/badge/module_formats-cjs%2C%20esm-green.svg"
+      />
+    </a>
+    <a href="https://github.com/nodejs/node">
+      <img
+        alt="Node.js Version"
+        src="https://img.shields.io/node/v/@guanghechen/disposable"
+      />
+    </a>
+    <a href="https://github.com/facebook/jest">
+      <img
+        alt="Tested with Jest"
+        src="https://img.shields.io/badge/tested_with-jest-9c465e.svg"
+      />
+    </a>
+    <a href="https://github.com/prettier/prettier">
+      <img
+        alt="Code Style: prettier"
+        src="https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square"
+      />
+    </a>
+  </div>
+</header>
+<br/>
+
+Disposable pattern implementation for resource cleanup and memory management.
+
+## Install
+
+- npm
+
+  ```bash
+  npm install --save @guanghechen/disposable
+  ```
+
+- yarn
+
+  ```bash
+  yarn add @guanghechen/disposable
+  ```
+
+## Usage
+
+|        Name        |                        Description                        |
+| :----------------: | :-------------------------------------------------------: |
+|   `Disposable`     |     Single disposable resource with cleanup callback     |
+| `BatchDisposable`  |     Batch disposable for managing multiple resources     |
+|   `disposeAll`     |        Utility to dispose all disposable items           |
+|  `isDisposable`    |      Type guard to check if object is disposable         |
+
+## Example
+
+- Basic disposable:
+
+  ```typescript
+  import { Disposable } from '@guanghechen/disposable'
+
+  const resource = new Disposable(() => {
+    console.log('Resource cleaned up!')
+  })
+
+  console.log(resource.disposed) // false
+  resource.dispose()
+  console.log(resource.disposed) // true
+  // Output: "Resource cleaned up!"
+  ```
+
+- Batch disposable:
+
+  ```typescript
+  import { BatchDisposable, Disposable } from '@guanghechen/disposable'
+
+  const batch = new BatchDisposable()
+
+  const resource1 = new Disposable(() => console.log('Resource 1 disposed'))
+  const resource2 = new Disposable(() => console.log('Resource 2 disposed'))
+
+  batch.registerDisposable(resource1)
+  batch.registerDisposable(resource2)
+
+  batch.dispose()
+  // Output: "Resource 1 disposed"
+  // Output: "Resource 2 disposed"
+  ```
+
+- Utility functions:
+
+  ```typescript
+  import { Disposable, disposeAll, isDisposable } from '@guanghechen/disposable'
+
+  const items: unknown[] = [
+    new Disposable(() => console.log('Disposed 1')),
+    new Disposable(() => console.log('Disposed 2')),
+    'not disposable'
+  ]
+
+  // Check if an item is disposable
+  items.forEach(item => {
+    if (isDisposable(item)) {
+      console.log('Item is disposable')
+    }
+  })
+
+  // Filter and dispose only disposable items
+  const disposables = items.filter(isDisposable)
+  disposeAll(disposables) // Disposes all disposable items
+  ```
+
+## Reference
+
+- [homepage][homepage]
+
+[homepage]:
+  https://github.com/guanghechen/sora/tree/@guanghechen/disposable@2.0.0/packages/disposable#readme

package/lib/cjs/index.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-var disposable_types = require('@guanghechen/disposable.types');
-
 class SafeBatchHandler {
     _errors;
     _summary;
@@ -103,9 +101,3 @@ exports.Disposable = Disposable;
 exports.SafeBatchHandler = SafeBatchHandler;
 exports.disposeAll = disposeAll;
 exports.isDisposable = isDisposable;
-Object.keys(disposable_types).forEach(function (k) {
-    if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-        enumerable: true,
-        get: function () { return disposable_types[k]; }
-    });
-});

package/lib/esm/index.mjs

@@ -1,5 +1,3 @@
-export * from '@guanghechen/disposable.types';
-
 class SafeBatchHandler {
     _errors;
     _summary;

package/lib/types/index.d.ts

@@ -1,5 +1,4 @@
-import { IBatchDisposable, IDisposable } from '@guanghechen/disposable.types';
-export * from '@guanghechen/disposable.types';
+import { IBatchDisposable, IDisposable } from '@guanghechen/types';
 
 declare class BatchDisposable implements IBatchDisposable {
     protected _disposed: boolean;

package/package.json

@@ -1,24 +1,27 @@
 {
   "name": "@guanghechen/disposable",
-  "version": "1.0.3",
+  "version": "2.0.1",
   "author": {
     "name": "guanghechen",
     "url": "https://github.com/guanghechen/"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/disposable@1.0.2",
+    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/disposable@2.0.0",
     "directory": "packages/disposable"
   },
-  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/disposable@1.0.2/packages/disposable#readme",
+  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/disposable@2.0.0/packages/disposable#readme",
   "keywords": [
     "disposable"
   ],
   "type": "module",
   "exports": {
-    "types": "./lib/types/index.d.ts",
-    "require": "./lib/cjs/index.cjs",
-    "import": "./lib/esm/index.mjs"
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "source": "./src/index.ts",
+      "import": "./lib/esm/index.mjs",
+      "require": "./lib/cjs/index.cjs"
+    }
   },
   "types": "./lib/types/index.d.ts",
   "main": "./lib/cjs/index.cjs",
@@ -34,7 +37,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@guanghechen/disposable.types": "^1.0.3"
+    "@guanghechen/types": "^2.0.1"
   },
-  "gitHead": "c46c7cc64c02c61047fbc7dff2ce8f6b21d4da2c"
-}
+  "scripts": {
+    "build": "rollup -c ../../rollup.config.mjs",
+    "clean": "rimraf lib",
+    "test": "vitest run --config ../../vitest.config.ts",
+    "test:coverage": "vitest run --config ../../vitest.config.ts --coverage",
+    "test:update": "vitest run --config ../../vitest.config.ts -u"
+  }
+}