@angular/cdk 19.2.1 → 19.2.3

package/collections/index.d.ts

@@ -1,26 +1,17 @@
+import { Observable, Subject } from 'rxjs';
 import * as i0 from '@angular/core';
-import { InjectionToken } from '@angular/core';
-import { IterableChangeRecord } from '@angular/core';
-import { IterableChanges } from '@angular/core';
-import { Observable } from 'rxjs';
-import { OnDestroy } from '@angular/core';
-import { Subject } from 'rxjs';
-import { TemplateRef } from '@angular/core';
-import { ViewContainerRef } from '@angular/core';
-
-/** DataSource wrapper for a native array. */
-export declare class ArrayDataSource<T> extends DataSource<T> {
-    private _data;
-    constructor(_data: readonly T[] | Observable<readonly T[]>);
-    connect(): Observable<readonly T[]>;
-    disconnect(): void;
-}
+import { TemplateRef, IterableChangeRecord, IterableChanges, ViewContainerRef, InjectionToken, OnDestroy } from '@angular/core';
 
+/** Represents a range of numbers with a specified start and end. */
+type ListRange = {
+    start: number;
+    end: number;
+};
 /**
  * Interface for any component that provides a view of some data collection and wants to provide
  * information regarding the view and any changes made.
  */
-export declare interface CollectionViewer {
+interface CollectionViewer {
     /**
      * A stream that emits whenever the `CollectionViewer` starts looking at a new portion of the
      * data. The `start` index is inclusive, while the `end` is exclusive.
@@ -28,7 +19,7 @@ export declare interface CollectionViewer {
     viewChange: Observable<ListRange>;
 }
 
-export declare abstract class DataSource<T> {
+declare abstract class DataSource<T> {
     /**
      * Connects a collection viewer (such as a data-table) to this data source. Note that
      * the stream provided will be accessed during change detection and should not directly change
@@ -47,36 +38,115 @@ export declare abstract class DataSource<T> {
      */
     abstract disconnect(collectionViewer: CollectionViewer): void;
 }
+/** Checks whether an object is a data source. */
+declare function isDataSource(value: any): value is DataSource<any>;
+
+/** DataSource wrapper for a native array. */
+declare class ArrayDataSource<T> extends DataSource<T> {
+    private _data;
+    constructor(_data: readonly T[] | Observable<readonly T[]>);
+    connect(): Observable<readonly T[]>;
+    disconnect(): void;
+}
 
 /**
- * A repeater that destroys views when they are removed from a
- * {@link ViewContainerRef}. When new items are inserted into the container,
- * the repeater will always construct a new embedded view for each item.
+ * The context for an embedded view in the repeater's view container.
+ *
+ * @template T The type for the embedded view's $implicit property.
+ */
+interface _ViewRepeaterItemContext<T> {
+    $implicit?: T;
+}
+/**
+ * The arguments needed to construct an embedded view for an item in a view
+ * container.
+ *
+ * @template C The type for the context passed to each embedded view.
+ */
+interface _ViewRepeaterItemInsertArgs<C> {
+    templateRef: TemplateRef<C>;
+    context?: C;
+    index?: number;
+}
+/**
+ * A factory that derives the embedded view context for an item in a view
+ * container.
  *
  * @template T The type for the embedded view's $implicit property.
  * @template R The type for the item in each IterableDiffer change record.
  * @template C The type for the context passed to each embedded view.
  */
-export declare class _DisposeViewRepeaterStrategy<T, R, C extends _ViewRepeaterItemContext<T>> implements _ViewRepeater<T, R, C> {
+type _ViewRepeaterItemContextFactory<T, R, C extends _ViewRepeaterItemContext<T>> = (record: IterableChangeRecord<R>, adjustedPreviousIndex: number | null, currentIndex: number | null) => _ViewRepeaterItemInsertArgs<C>;
+/**
+ * Extracts the value of an item from an {@link IterableChangeRecord}.
+ *
+ * @template T The type for the embedded view's $implicit property.
+ * @template R The type for the item in each IterableDiffer change record.
+ */
+type _ViewRepeaterItemValueResolver<T, R> = (record: IterableChangeRecord<R>) => T;
+/** Indicates how a view was changed by a {@link _ViewRepeater}. */
+declare enum _ViewRepeaterOperation {
+    /** The content of an existing view was replaced with another item. */
+    REPLACED = 0,
+    /** A new view was created with `createEmbeddedView`. */
+    INSERTED = 1,
+    /** The position of a view changed, but the content remains the same. */
+    MOVED = 2,
+    /** A view was detached from the view container. */
+    REMOVED = 3
+}
+/**
+ * Meta data describing the state of a view after it was updated by a
+ * {@link _ViewRepeater}.
+ *
+ * @template R The type for the item in each IterableDiffer change record.
+ * @template C The type for the context passed to each embedded view.
+ */
+interface _ViewRepeaterItemChange<R, C> {
+    /** The view's context after it was changed. */
+    context?: C;
+    /** Indicates how the view was changed. */
+    operation: _ViewRepeaterOperation;
+    /** The view's corresponding change record. */
+    record: IterableChangeRecord<R>;
+}
+/**
+ * Type for a callback to be executed after a view has changed.
+ *
+ * @template R The type for the item in each IterableDiffer change record.
+ * @template C The type for the context passed to each embedded view.
+ */
+type _ViewRepeaterItemChanged<R, C> = (change: _ViewRepeaterItemChange<R, C>) => void;
+/**
+ * Describes a strategy for rendering items in a {@link ViewContainerRef}.
+ *
+ * @template T The type for the embedded view's $implicit property.
+ * @template R The type for the item in each IterableDiffer change record.
+ * @template C The type for the context passed to each embedded view.
+ */
+interface _ViewRepeater<T, R, C extends _ViewRepeaterItemContext<T>> {
     applyChanges(changes: IterableChanges<R>, viewContainerRef: ViewContainerRef, itemContextFactory: _ViewRepeaterItemContextFactory<T, R, C>, itemValueResolver: _ViewRepeaterItemValueResolver<T, R>, itemViewChanged?: _ViewRepeaterItemChanged<R, C>): void;
     detach(): void;
 }
-
 /**
- * Returns an error that reports that multiple values are passed into a selection model
- * with a single value.
+ * Injection token for {@link _ViewRepeater}. This token is for use by Angular Material only.
  * @docs-private
  */
-export declare function getMultipleValuesInSingleSelectionError(): Error;
+declare const _VIEW_REPEATER_STRATEGY: InjectionToken<_ViewRepeater<unknown, unknown, _ViewRepeaterItemContext<unknown>>>;
 
-/** Checks whether an object is a data source. */
-export declare function isDataSource(value: any): value is DataSource<any>;
-
-/** Represents a range of numbers with a specified start and end. */
-export declare type ListRange = {
-    start: number;
-    end: number;
-};
+/**
+ * A repeater that destroys views when they are removed from a
+ * {@link ViewContainerRef}. When new items are inserted into the container,
+ * the repeater will always construct a new embedded view for each item.
+ *
+ * @template T The type for the embedded view's $implicit property.
+ * @template R The type for the item in each IterableDiffer change record.
+ * @template C The type for the context passed to each embedded view.
+ */
+declare class _DisposeViewRepeaterStrategy<T, R, C extends _ViewRepeaterItemContext<T>> implements _ViewRepeater<T, R, C> {
+    applyChanges(changes: IterableChanges<R>, viewContainerRef: ViewContainerRef, itemContextFactory: _ViewRepeaterItemContextFactory<T, R, C>, itemValueResolver: _ViewRepeaterItemValueResolver<T, R>, itemViewChanged?: _ViewRepeaterItemChanged<R, C>): void;
+    detach(): void;
+}
 
 /**
  * A repeater that caches views when they are removed from a
@@ -89,7 +159,7 @@ export declare type ListRange = {
  * @template R The type for the item in each IterableDiffer change record.
  * @template C The type for the context passed to each embedded view.
  */
-export declare class _RecycleViewRepeaterStrategy<T, R, C extends _ViewRepeaterItemContext<T>> implements _ViewRepeater<T, R, C> {
+declare class _RecycleViewRepeaterStrategy<T, R, C extends _ViewRepeaterItemContext<T>> implements _ViewRepeater<T, R, C> {
     /**
      * The size of the cache used to store unused views.
      * Setting the cache size to `0` will disable caching. Defaults to 20 views.
@@ -124,23 +194,10 @@ export declare class _RecycleViewRepeaterStrategy<T, R, C extends _ViewRepeaterI
     private _insertViewFromCache;
 }
 
-/**
- * Event emitted when the value of a MatSelectionModel has changed.
- * @docs-private
- */
-export declare interface SelectionChange<T> {
-    /** Model that dispatched the event. */
-    source: SelectionModel<T>;
-    /** Options that were added to the model. */
-    added: T[];
-    /** Options that were removed from the model. */
-    removed: T[];
-}
-
 /**
  * Class to be used to power selecting one or more options from a list.
  */
-export declare class SelectionModel<T> {
+declare class SelectionModel<T> {
     private _multiple;
     private _emitChanges;
     compareWith?: ((o1: T, o2: T) => boolean) | undefined;
@@ -231,26 +288,26 @@ export declare class SelectionModel<T> {
     /** Returns a value that is comparable to inputValue by applying compareWith function, returns the same inputValue otherwise. */
     private _getConcreteValue;
 }
-
 /**
- * Interface for a class that can flatten hierarchical structured data and re-expand the flattened
- * data back into its original structure. Should be used in conjunction with the cdk-tree.
+ * Event emitted when the value of a MatSelectionModel has changed.
+ * @docs-private
  */
-export declare interface TreeDataNodeFlattener<T> {
-    /** Transforms a set of hierarchical structured data into a flattened data array. */
-    flattenNodes(structuredData: any[]): T[];
-    /**
-     * Expands a flattened array of data into its hierarchical form using the provided expansion
-     * model.
-     */
-    expandFlattenedNodes(nodes: T[], expansionModel: SelectionModel<T>): T[];
-    /**
-     * Put node descendants of node in array.
-     * If `onlyExpandable` is true, then only process expandable descendants.
-     */
-    nodeDescendents(node: T, nodes: T[], onlyExpandable: boolean): void;
+interface SelectionChange<T> {
+    /** Model that dispatched the event. */
+    source: SelectionModel<T>;
+    /** Options that were added to the model. */
+    added: T[];
+    /** Options that were removed from the model. */
+    removed: T[];
 }
+/**
+ * Returns an error that reports that multiple values are passed into a selection model
+ * with a single value.
+ * @docs-private
+ */
+declare function getMultipleValuesInSingleSelectionError(): Error;
 
+type UniqueSelectionDispatcherListener = (id: string, name: string) => void;
 /**
  * Class to coordinate unique selection based on name.
  * Intended to be consumed as an Angular service.
@@ -260,7 +317,7 @@ export declare interface TreeDataNodeFlattener<T> {
  * This service does not *store* any IDs and names because they may change at any time, so it is
  * less error-prone if they are simply passed through when the events occur.
  */
-export declare class UniqueSelectionDispatcher implements OnDestroy {
+declare class UniqueSelectionDispatcher implements OnDestroy {
     private _listeners;
     /**
      * Notify other items that selection for the given name has been set.
@@ -278,99 +335,23 @@ export declare class UniqueSelectionDispatcher implements OnDestroy {
     static ɵprov: i0.ɵɵInjectableDeclaration<UniqueSelectionDispatcher>;
 }
 
-export declare type UniqueSelectionDispatcherListener = (id: string, name: string) => void;
-
-/**
- * Injection token for {@link _ViewRepeater}. This token is for use by Angular Material only.
- * @docs-private
- */
-export declare const _VIEW_REPEATER_STRATEGY: InjectionToken<_ViewRepeater<unknown, unknown, _ViewRepeaterItemContext<unknown>>>;
-
-/**
- * Describes a strategy for rendering items in a {@link ViewContainerRef}.
- *
- * @template T The type for the embedded view's $implicit property.
- * @template R The type for the item in each IterableDiffer change record.
- * @template C The type for the context passed to each embedded view.
- */
-export declare interface _ViewRepeater<T, R, C extends _ViewRepeaterItemContext<T>> {
-    applyChanges(changes: IterableChanges<R>, viewContainerRef: ViewContainerRef, itemContextFactory: _ViewRepeaterItemContextFactory<T, R, C>, itemValueResolver: _ViewRepeaterItemValueResolver<T, R>, itemViewChanged?: _ViewRepeaterItemChanged<R, C>): void;
-    detach(): void;
-}
-
-/**
- * Meta data describing the state of a view after it was updated by a
- * {@link _ViewRepeater}.
- *
- * @template R The type for the item in each IterableDiffer change record.
- * @template C The type for the context passed to each embedded view.
- */
-export declare interface _ViewRepeaterItemChange<R, C> {
-    /** The view's context after it was changed. */
-    context?: C;
-    /** Indicates how the view was changed. */
-    operation: _ViewRepeaterOperation;
-    /** The view's corresponding change record. */
-    record: IterableChangeRecord<R>;
-}
-
-/**
- * Type for a callback to be executed after a view has changed.
- *
- * @template R The type for the item in each IterableDiffer change record.
- * @template C The type for the context passed to each embedded view.
- */
-export declare type _ViewRepeaterItemChanged<R, C> = (change: _ViewRepeaterItemChange<R, C>) => void;
-
-/**
- * The context for an embedded view in the repeater's view container.
- *
- * @template T The type for the embedded view's $implicit property.
- */
-export declare interface _ViewRepeaterItemContext<T> {
-    $implicit?: T;
-}
-
-/**
- * A factory that derives the embedded view context for an item in a view
- * container.
- *
- * @template T The type for the embedded view's $implicit property.
- * @template R The type for the item in each IterableDiffer change record.
- * @template C The type for the context passed to each embedded view.
- */
-export declare type _ViewRepeaterItemContextFactory<T, R, C extends _ViewRepeaterItemContext<T>> = (record: IterableChangeRecord<R>, adjustedPreviousIndex: number | null, currentIndex: number | null) => _ViewRepeaterItemInsertArgs<C>;
-
-/**
- * The arguments needed to construct an embedded view for an item in a view
- * container.
- *
- * @template C The type for the context passed to each embedded view.
- */
-export declare interface _ViewRepeaterItemInsertArgs<C> {
-    templateRef: TemplateRef<C>;
-    context?: C;
-    index?: number;
-}
-
 /**
- * Extracts the value of an item from an {@link IterableChangeRecord}.
- *
- * @template T The type for the embedded view's $implicit property.
- * @template R The type for the item in each IterableDiffer change record.
+ * Interface for a class that can flatten hierarchical structured data and re-expand the flattened
+ * data back into its original structure. Should be used in conjunction with the cdk-tree.
  */
-export declare type _ViewRepeaterItemValueResolver<T, R> = (record: IterableChangeRecord<R>) => T;
-
-/** Indicates how a view was changed by a {@link _ViewRepeater}. */
-export declare enum _ViewRepeaterOperation {
-    /** The content of an existing view was replaced with another item. */
-    REPLACED = 0,
-    /** A new view was created with `createEmbeddedView`. */
-    INSERTED = 1,
-    /** The position of a view changed, but the content remains the same. */
-    MOVED = 2,
-    /** A view was detached from the view container. */
-    REMOVED = 3
+interface TreeDataNodeFlattener<T> {
+    /** Transforms a set of hierarchical structured data into a flattened data array. */
+    flattenNodes(structuredData: any[]): T[];
+    /**
+     * Expands a flattened array of data into its hierarchical form using the provided expansion
+     * model.
+     */
+    expandFlattenedNodes(nodes: T[], expansionModel: SelectionModel<T>): T[];
+    /**
+     * Put node descendants of node in array.
+     * If `onlyExpandable` is true, then only process expandable descendants.
+     */
+    nodeDescendents(node: T, nodes: T[], onlyExpandable: boolean): void;
 }
 
-export { }
+export { ArrayDataSource, type CollectionViewer, DataSource, type ListRange, type SelectionChange, SelectionModel, type TreeDataNodeFlattener, UniqueSelectionDispatcher, type UniqueSelectionDispatcherListener, _DisposeViewRepeaterStrategy, _RecycleViewRepeaterStrategy, _VIEW_REPEATER_STRATEGY, type _ViewRepeater, type _ViewRepeaterItemChange, type _ViewRepeaterItemChanged, type _ViewRepeaterItemContext, type _ViewRepeaterItemContextFactory, type _ViewRepeaterItemInsertArgs, type _ViewRepeaterItemValueResolver, _ViewRepeaterOperation, getMultipleValuesInSingleSelectionError, isDataSource };