@typedly/collection 1.0.1 → 2.0.0

package/README.md

@@ -16,6 +16,7 @@ A **TypeScript** type definitions package for data collections with customizable
 
 ## Features
 
+- **Adapter**: The default interface for adapters in collections.
 - **Constructor**: The constructor type for initialization with custom storage (e.g. `Set`, `Array`).
 - **Shape**: The shape of element-based collection built on @typedly/data.
 - **Customizable Storage**: Support for various storage types (`Set<T>`, `T[]`, etc.) via generics with add/remove/iterate.
@@ -27,6 +28,7 @@ A **TypeScript** type definitions package for data collections with customizable
 - [Installation](#installation)
 - [Api](#api)
   - Interface
+    - [`CollectionAdapter`](#collectionadapter)
     - [`CollectionShape`](#collectionshape)
   - Type
     - [`CollectionConstructor`](#collectionconstructor)
@@ -49,6 +51,7 @@ npm install @typedly/collection --save-peer
 ```typescript
 import {
   // Interface.
+  CollectionAdapter,
   CollectionShape,
   // Type.
   CollectionConstructor
@@ -57,6 +60,14 @@ import {
 
 ### Interface
 
+### `CollectionAdapter`
+
+The adapter interface for collections.
+
+```typescript
+import { CollectionAdapter } from '@typedly/collection';
+```
+
 ### `CollectionShape`
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typedly/collection",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "author": "wwwdev.io <dev@wwwdev.io>",
   "description": "A TypeScript type definitions package for data collections with customizable storage.",
   "license": "MIT",

package/types/typedly-collection.d.ts

@@ -11,17 +11,17 @@ import { ConstrainedConstructor } from '@typedly/constructor';
  */
 interface CollectionShape<T, V = any> extends DataShape<V> {
     /**
-     * @description Adds an item to the collection.
-     * @param {T} element Element of type `T` to add.
+     * @description Adds elements to the collection.
+     * @param {...T[]} element Element of type `T` to add.
      * @returns {this} The collection instance.
      */
-    add(element: T): this;
+    add(...element: T[]): this;
     /**
-     * @description Deletes an item from the collection.
-     * @param {T} element Element of type `T` to delete.
+     * @description Deletes elements from the collection.
+     * @param {...T[]} element Element of type `T` to delete.
      * @returns {boolean} `true` if the element was successfully deleted, otherwise `false`.
      */
-    delete(element: T): boolean;
+    delete(...element: T[]): boolean;
     /**
      * @description Executes a provided function once for each collection element.
      * @param {(value: T, value2: T, collection: CollectionShape<T, V>) => void} callbackfn Function to execute for each element.
@@ -29,11 +29,11 @@ interface CollectionShape<T, V = any> extends DataShape<V> {
      */
     forEach(callbackfn: (element: T, element2: T, collection: CollectionShape<T, V>) => void, thisArg?: any): void;
     /**
-     * @description Checks if an item exists in the collection.
-     * @param {T} element Element of type `T` to check for existence.
+     * @description Checks if every item exists in the collection.
+     * @param {...T[]} element Element of type `T` to check for existence.
      * @returns {boolean} `true` if the element exists, otherwise `false`.
      */
-    has(element: T): boolean;
+    has(...element: T[]): boolean;
     /**
      * @description The number of items in the collection.
      * @returns {number}
@@ -48,7 +48,19 @@ interface CollectionShape<T, V = any> extends DataShape<V> {
      * @description Returns an iterator for the collection.
      * @returns {Iterator<T>}
      */
-    get [Symbol.iterator](): Iterator<T>;
+    [Symbol.iterator](): Iterator<T>;
+}
+
+/**
+ * @description The adapter interface for collections.
+ * @export
+ * @interface CollectionAdapter
+ * @template Element  The type of elements in the collection.
+ * @template Type The type of the value in the collection, data of elements.
+ * @extends {CollectionShape<Element, Type>}
+ */
+interface CollectionAdapter<Element, Type> extends CollectionShape<Element, Type> {
+    version: string;
 }
 
 /**
@@ -60,4 +72,4 @@ interface CollectionShape<T, V = any> extends DataShape<V> {
  */
 type CollectionConstructor<T, V, C extends CollectionShape<T, V>> = ConstrainedConstructor<CollectionShape<T, V>, C, T[]>;
 
-export type { CollectionConstructor, CollectionShape };
+export type { CollectionAdapter, CollectionConstructor, CollectionShape };