Class PluginRegistry

packages/abstract/src/core/plugins/registry.ts:18–162

 * @template U - The type of plugin instance
 */
export class PluginRegistry<
  T extends DragDropManager<any, any>,
  W extends PluginConstructor<T> = PluginConstructor<T>,
  U extends Plugin<T> = InstanceType<W>,
> {
  private instances: Map<W, U> = new Map();

  /**
   * Creates a new plugin registry.
   *
   * @param manager - The drag and drop manager that owns this registry
   */
  constructor(private manager: T) {}

  /**
   * Gets all registered plugin instances.
   *
   * @returns An array of all active plugin instances
   */
  public get values(): U[] {
    return Array.from(this.instances.values());
  }

  #previousValues: PluginConstructor<T>[] = [];

  /**
   * Sets the list of plugins to be used by the registry.
   *
   * @param entries - Array of plugin constructors or descriptors
   * @remarks
   * This method:
   * - Filters out duplicate plugins
   * - Unregisters plugins that are no longer in use
   * - Registers new plugins with their options
   */
  public set values(entries: Plugins<T>) {
    const descriptors = entries
      .map(descriptor)
      .reduce<PluginDescriptor<T>[]>((acc, descriptor) => {
        const existing = acc.find(({plugin}) => plugin === descriptor.plugin);

        if (existing) {
          // Keep the first occurrence's position, apply latest options
          existing.options = descriptor.options;
          return acc;
        }

        return [...acc, descriptor];
      }, []);
    const constructors = descriptors.map(({plugin}) => plugin);

    for (const plugin of this.#previousValues) {
      if (!constructors.includes(plugin)) {
        if (plugin.prototype instanceof CorePlugin) {
          continue;
        }

        this.unregister(plugin as W);