@typedly/adaptable-collection

A TypeScript type definitions package for adaptable data collections with configuration, adapter support based on @typedly/configurable-collection.

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/configurable-collection.
• Customizable Storage: Support for various storage types (Set<T>, T[], etc.) via generics with add/remove/iterate.
• Iteration & Symbols: Built-in [Symbol.iterator] for spread/for-of, with [Symbol.toStringTag] for debugging.
• TypeScript-Only: Zero runtime, pure type definitions for type-safe collections.

Table of contents

• Related packages
• Installation
• Api
  • AdaptableCollectionConstructor
  • AdaptableCollection
  • InferCollectionAdapter
• Contributing
• Support
• Code of Conduct
• Git
  • Commit
  • Versioning
• License
• Packages

Related packages

Peer dependencies

• @typedly/adaptable-data: A TypeScript type definitions package for configurable, composable, trait-driven adaptable data models with adapter support.
• @typedly/configurable-collection: A TypeScript type definitions package for configurable collections with configuration based on @typedly/collection.

General

• @typedly/adaptable-data: A TypeScript type definitions for data adapter.
• @typedly/collection: A TypeScript type definitions package for data collections with customizable storage.
• @typedly/configurable-data: A TypeScript type definitions package for configurable, composable, trait-driven data models.
• @typedly/data-traits: A TypeScript type definitions package for configurable data traits, providing various kinds of configurable data interfaces.
• @typedly/data: A TypeScript type definitions for @typescript-package/data.
• @typescript-package/collection: A lightweight TypeScript library for data collection.
• @typescript-package/data: A lightweight TypeScript library for basic data management.

Installation

1. Install peer dependencies

npm install @typedly/adaptable-data @typedly/configurable-collection --save-peer

2. Install package

npm install @typedly/adaptable-collection --save-peer

Api

import {
  AdaptableCollectionConstructor,
  AdaptableCollectionShape,
  InferCollectionAdapter,
} from '@typedly/adaptable-collection';

AdaptableCollectionConstructor

The constructor type for AdaptableCollectionShape, which defines the structure for creating instances of adaptable collections that can adapt to different collection shapes and settings.

import { AdaptableCollectionConstructor } from '@typedly/adaptable-collection';

AdaptableCollectionShape

The AdaptableCollectionShape interface defines a collection data structure that can adapt to different configurations and behaviors based on the provided adapter and settings.

import { AdaptableCollectionShape } from '@typedly/adaptable-collection';

InferCollectionAdapter

A utility type that infers the collection adapter type from a given adaptable collection shape.

import { InferCollectionAdapter } from '@typedly/adaptable-collection';

Contributing

Your contributions are valued! If you'd like to contribute, please feel free to submit a pull request. Help is always appreciated.

Support

If you find this package useful and would like to support its and general development, you can contribute through one of the following payment methods. Your support helps maintain the packages and continue adding new.

Support via:

• 4Fund
• DonorBox
• GitHub
• Ko-fi
• OpenCollective
• Patreon
• PayPal
• Stripe
• ~~Revolut~~

or via Trust Wallet

• BNB
• BTC
• ETH
• USDT (BEP20)
• XLM

Code of Conduct

By participating in this collection, you agree to follow Code of Conduct.

GIT

Commit

• AngularJS Git Commit Message Conventions
• Karma Git Commit Msg
• Conventional Commits

Versioning

Semantic Versioning 2.0.0

Given a version number MAJOR.MINOR.PATCH, increment the:

• MAJOR version when you make incompatible API changes,
• MINOR version when you add functionality in a backwards-compatible manner, and
• PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

FAQ How should I deal with revisions in the 0.y.z initial development phase?

The simplest thing to do is start your initial development release at 0.1.0 and then increment the minor version for each subsequent release.

How do I know when to release 1.0.0?

If your software is being used in production, it should probably already be 1.0.0. If you have a stable API on which users have come to depend, you should be 1.0.0. If you’re worrying a lot about backwards compatibility, you should probably already be 1.0.0.

License

MIT © typedly (license)

Packages

• @typedly/array: A TypeScript type definitions package to handle array-related operations.
• @typedly/callback: A TypeScript type definitions package for asynchronous and synchronous callback functions of various types.
• @typedly/character: A TypeScript type definitions package for various character types.
• @typedly/context: A TypeScript type definitions package for context data structures.
• @typedly/descriptor: A TypeScript type definitions package for property descriptor.
• @typedly/digit: A TypeScript type definitions package for digit types.
• @typedly/letter: A TypeScript type definitions package for handling letter types.
• @typedly/object: A TypeScript type definitions package to handle object-related operations.
• @typedly/payload: A TypeScript type definitions package for payload data structures.
• @typedly/property: A TypeScript type definitions package to handle object property-related operations.
• @typedly/regexp: A TypeScript type definitions package for RegExp.
• @typedly/symbol: A TypeScript type definitions package for various symbols.