@typedly/collection 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typedly/collection",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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

@@ -1,2 +1,63 @@
+import { DataShape } from '@typedly/data';
+import { ConstrainedConstructor } from '@typedly/constructor';
 
-export { };
+/**
+ * @description Represents a collection of elements.
+ * @export
+ * @interface Collection
+ * @template T The type of elements in the collection.
+ * @template V The type of the value in the collection, data of elements.
+ * @extends {DataShape<V>}
+ */
+interface CollectionShape<T, V = any> extends DataShape<V> {
+    /**
+     * @description Adds an item to the collection.
+     * @param {T} element Element of type `T` to add.
+     * @returns {this} The collection instance.
+     */
+    add(element: T): this;
+    /**
+     * @description Deletes an item 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;
+    /**
+     * @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.
+     * @param {any} [thisArg] Value to use as `this` when executing `callbackfn`.
+     */
+    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.
+     * @returns {boolean} `true` if the element exists, otherwise `false`.
+     */
+    has(element: T): boolean;
+    /**
+     * @description The number of items in the collection.
+     * @returns {number}
+     */
+    readonly size: number;
+    /**
+     * @description Returns a tag name for collection.
+     * @returns {string}
+     */
+    get [Symbol.toStringTag](): string;
+    /**
+     * @description Returns an iterator for the collection.
+     * @returns {Iterator<T>}
+     */
+    get [Symbol.iterator](): Iterator<T>;
+}
+
+/**
+ * @description The constructor type for CollectionShape.
+ * @export
+ * @template T The type of the elements in the collection.
+ * @template V The type of the value in the collection, data of elements.
+ * @template {CollectionShape<T, V>} C
+ */
+type CollectionConstructor<T, V, C extends CollectionShape<T, V>> = ConstrainedConstructor<CollectionShape<T, V>, C, T[]>;
+
+export type { CollectionConstructor, CollectionShape };