@ng-doc/app 22.1.0 → 22.2.0

package/types/ng-doc-app-providers-texts.d.ts

@@ -0,0 +1,28 @@
+import { Provider } from '@angular/core';
+import { NgDocTextsOverrides } from '@ng-doc/app/interfaces';
+
+/**
+ * Changes the texts NgDoc shows to readers, for example to translate them. Pass the groups and
+ * texts to change; every other text keeps its English default (`NG_DOC_DEFAULT_TEXTS`). NgDoc
+ * ships complete translations in entry points of their own, such as `NG_DOC_TEXTS_DE` from
+ * `@ng-doc/app/texts/de`; pass one first and your changes after it.
+ *
+ * Calls and arguments add up: in one injector they apply in order, so a later one wins for a
+ * text both set, and the providers of a child injector (a lazy route, for example) apply on top of the
+ * texts of its parent. The texts are read when a component is created, so they are fixed per
+ * injector: switch the language by reloading the application, not at run time.
+ * @example
+ * ```typescript
+ * provideNgDocTexts(NG_DOC_TEXTS_DE, { search: { placeholder: 'Handbuch durchsuchen…' } });
+ *
+ * provideNgDocTexts({
+ *   search: { placeholder: 'Dokumentation durchsuchen…' },
+ *   searchPalette: { noResults: ({ query }) => `Keine Ergebnisse für „${query}“` },
+ * });
+ * ```
+ * @param texts - The texts to change, by group, in the order they apply.
+ * @returns The providers to add to the application, a route or a page.
+ */
+declare function provideNgDocTexts(...texts: NgDocTextsOverrides[]): Provider[];
+
+export { provideNgDocTexts };

package/types/ng-doc-app-providers.d.ts

@@ -3,5 +3,6 @@ export * from '@ng-doc/app/providers/ng-doc-app';
 export * from '@ng-doc/app/providers/page-skeleton';
 export * from '@ng-doc/app/providers/playground-demo';
 export * from '@ng-doc/app/providers/search-engine';
+export * from '@ng-doc/app/providers/texts';
 export * from '@ng-doc/app/providers/title';
 export * from '@ng-doc/app/providers/type-control';

package/types/ng-doc-app-services-content-scroll-intent.d.ts

@@ -14,6 +14,7 @@ interface NgDocInitialContentScrollIntent {
 declare class NgDocContentScrollIntent {
     private readonly browser;
     private readonly router;
+    private readonly location;
     private candidate?;
     private intent?;
     private readonly listeners;
@@ -26,7 +27,10 @@ declare class NgDocContentScrollIntent {
      */
     readonly currentIntent: Signal<NgDocInitialContentScrollIntent | undefined>;
     constructor();
-    /** Starts following router events. Does nothing on the server or when already started. */
+    /**
+     * Starts following router events. Does nothing on the server or when already started. Started
+     * during a navigation, it follows that navigation too.
+     */
     start(): void;
     /**
      * Calls the listener with every change of the intent, and at once with the pending one.
@@ -40,6 +44,12 @@ declare class NgDocContentScrollIntent {
      */
     settle(navigationId: number): void;
     private navigationStarted;
+    /**
+     * Takes the navigation in progress as the candidate. The providers of a lazy route start the
+     * intent while the router loads that route, after the first navigation has started, and its
+     * fragment must still be replayed.
+     */
+    private followCurrentNavigation;
     private navigationEnded;
     private scrolled;
     private publish;

package/types/ng-doc-app-services-highlighter.d.ts

@@ -31,7 +31,9 @@ interface NgDocHighlighterConfig {
     };
 }
 /**
- * Highlights code with Shiki. `provideNgDocApp` initializes it before the application renders.
+ * Highlights code with Shiki. `provideNgDocApp` starts its initialization where it is provided (the
+ * application, or the route that holds the documentation), and the server render waits for it.
+ * Shiki is loaded on demand: `initialize()` imports it.
  */
 declare class NgDocHighlighterService implements OnDestroy {
     private static defaultInitialization?;

package/types/ng-doc-app-services-shortcuts.d.ts

@@ -43,6 +43,10 @@ declare const NG_DOC_STORE_SHORTCUTS_KEY: string;
  * the choice is saved in the browser. A site turns them off by default with the shortcuts option
  * of provideNgDocApp. They never run while the reader types in a field or holds Command, Control
  * or Alt. Chords such as Command+K (Control+K) always work.
+ *
+ * Shortcuts run only while the documentation layout is shown: `NgDocRootComponent` turns them on
+ * with `listen()`, so the other pages of an application that shows its documentation under a
+ * route keep their own keys.
  */
 declare class NgDocShortcutsService {
     private readonly document;
@@ -52,6 +56,10 @@ declare class NgDocShortcutsService {
     private readonly appDefault;
     private readonly userChoice;
     private readonly shortcuts;
+    private readonly listener;
+    /** The layouts that listen for the shortcuts; the document listener is on while there are any. */
+    private listeners;
+    private destroyed;
     private themeToggle?;
     /**
      * Whether single-key shortcuts are on: the reader's saved choice, or the site's default.
@@ -59,6 +67,14 @@ declare class NgDocShortcutsService {
      */
     readonly enabled: Signal<boolean>;
     constructor();
+    /**
+     * Runs the shortcuts on key presses until the returned function is called. `NgDocRootComponent`
+     * calls it while the documentation layout is shown; a site with a layout of its own calls it
+     * the same way. Several callers may listen at once: the shortcuts run until each has stopped.
+     * Does nothing on the server.
+     * @returns A function that stops listening; later calls do nothing.
+     */
+    listen(): () => void;
     /**
      * Turns single-key shortcuts on or off for this reader and saves the choice in the browser.
      * @param enabled - Whether single-key shortcuts should run.

package/types/ng-doc-app-texts-ar.d.ts

@@ -0,0 +1,13 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Arabic texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_AR)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_AR, { search: { placeholder: '…' } })`. NgDoc's layout is
+ * left-to-right, so these texts translate the interface but don't mirror it.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_AR: NgDocTexts;
+
+export { NG_DOC_TEXTS_AR };

package/types/ng-doc-app-texts-de.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The German texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_DE)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_DE, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_DE: NgDocTexts;
+
+export { NG_DOC_TEXTS_DE };

package/types/ng-doc-app-texts-es.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Spanish texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_ES)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_ES, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_ES: NgDocTexts;
+
+export { NG_DOC_TEXTS_ES };

package/types/ng-doc-app-texts-fr.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The French texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_FR)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_FR, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_FR: NgDocTexts;
+
+export { NG_DOC_TEXTS_FR };

package/types/ng-doc-app-texts-hi.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Hindi texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_HI)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_HI, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_HI: NgDocTexts;
+
+export { NG_DOC_TEXTS_HI };

package/types/ng-doc-app-texts-ja.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Japanese texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_JA)`. Pass your own changes
+ * after them: `provideNgDocTexts(NG_DOC_TEXTS_JA, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_JA: NgDocTexts;
+
+export { NG_DOC_TEXTS_JA };

package/types/ng-doc-app-texts-ko.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Korean texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_KO)`. Pass your own changes
+ * after them: `provideNgDocTexts(NG_DOC_TEXTS_KO, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_KO: NgDocTexts;
+
+export { NG_DOC_TEXTS_KO };

package/types/ng-doc-app-texts-pt-br.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Brazilian Portuguese texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_PT_BR)`. Pass your
+ * own changes after them: `provideNgDocTexts(NG_DOC_TEXTS_PT_BR, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_PT_BR: NgDocTexts;
+
+export { NG_DOC_TEXTS_PT_BR };

package/types/ng-doc-app-texts-ru.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Russian texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_RU)`. Pass your own changes after
+ * them: `provideNgDocTexts(NG_DOC_TEXTS_RU, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_RU: NgDocTexts;
+
+export { NG_DOC_TEXTS_RU };

package/types/ng-doc-app-texts-uk.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Ukrainian texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_UK)`. Pass your own changes
+ * after them: `provideNgDocTexts(NG_DOC_TEXTS_UK, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_UK: NgDocTexts;
+
+export { NG_DOC_TEXTS_UK };

package/types/ng-doc-app-texts-zh.d.ts

@@ -0,0 +1,12 @@
+import { NgDocTexts } from '@ng-doc/app/interfaces';
+
+/**
+ * The Simplified Chinese texts of NgDoc, for `provideNgDocTexts(NG_DOC_TEXTS_ZH)`. Pass your own
+ * changes after them: `provideNgDocTexts(NG_DOC_TEXTS_ZH, { search: { placeholder: '…' } })`.
+ *
+ * These translations welcome corrections: open an issue or a pull request at
+ * https://github.com/ng-doc/ng-doc that names the text (its group and key) and your wording.
+ */
+declare const NG_DOC_TEXTS_ZH: NgDocTexts;
+
+export { NG_DOC_TEXTS_ZH };

package/types/ng-doc-app-tokens.d.ts

@@ -1,5 +1,5 @@
 import { InjectionToken, Provider } from '@angular/core';
-import { NgDocContext, NgDocPageProcessor, NgDocPageSkeleton, NgDocTypeControl } from '@ng-doc/app/interfaces';
+import { NgDocContext, NgDocPageProcessor, NgDocPageSkeleton, NgDocTexts, NgDocTextsOverrides, NgDocTypeControl } from '@ng-doc/app/interfaces';
 import { Mermaid } from 'mermaid';
 
 /** Enables one delayed anchor replay after asynchronous NgDoc content is processed. */
@@ -37,7 +37,26 @@ interface NgDocShikiTheme {
 }
 declare const NG_DOC_SHIKI_THEME: InjectionToken<NgDocShikiTheme>;
 
+/**
+ * The English texts of the NgDoc application. They are the texts NgDoc showed before the texts
+ * could be changed, so an application that changes none renders as before.
+ */
+declare const NG_DOC_DEFAULT_TEXTS: NgDocTexts;
+/**
+ * The texts the NgDoc application shows. It resolves to `NG_DOC_DEFAULT_TEXTS` unless
+ * `provideNgDocTexts` changes them. Inject it to show the same texts in your own components.
+ */
+declare const NG_DOC_TEXTS: InjectionToken<NgDocTexts>;
+/**
+ * Applies changes to texts: each group of each change replaces the texts it sets, in order, so a
+ * later change wins. A text set to `undefined` keeps its value. The result is frozen.
+ * @param texts - The texts to change.
+ * @param overrides - The changes, the last one winning.
+ * @returns New texts; `texts` and the changes are left as they are.
+ */
+declare function mergeNgDocTexts(texts: NgDocTexts, ...overrides: readonly NgDocTextsOverrides[]): NgDocTexts;
+
 declare const NG_DOC_TYPE_CONTROL: InjectionToken<NgDocTypeControl>;
 
-export { NG_DOC_CONTENT_ANCHOR_SCROLLING, NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION, NG_DOC_CONTEXT, NG_DOC_MERMAID, NG_DOC_PAGE_CUSTOM_PROCESSOR, NG_DOC_PAGE_PROCESSOR, NG_DOC_PAGE_SKELETON, NG_DOC_ROUTE_PREFIX, NG_DOC_SHIKI_THEME, NG_DOC_TYPE_CONTROL, provideMainPageProcessor, providePageProcessor };
+export { NG_DOC_CONTENT_ANCHOR_SCROLLING, NG_DOC_CONTENT_SCROLL_POSITION_RESTORATION, NG_DOC_CONTEXT, NG_DOC_DEFAULT_TEXTS, NG_DOC_MERMAID, NG_DOC_PAGE_CUSTOM_PROCESSOR, NG_DOC_PAGE_PROCESSOR, NG_DOC_PAGE_SKELETON, NG_DOC_ROUTE_PREFIX, NG_DOC_SHIKI_THEME, NG_DOC_TEXTS, NG_DOC_TYPE_CONTROL, mergeNgDocTexts, provideMainPageProcessor, providePageProcessor };
 export type { NgDocContentScrollPositionRestoration, NgDocShikiTheme };

package/types/ng-doc-app-type-controls-json-control.d.ts

@@ -0,0 +1,38 @@
+import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
+import { NgDocTypeControl, NgDocPlaygroundTexts } from '@ng-doc/app/interfaces';
+import { DIControl } from 'di-controls';
+
+/**
+ * The playground control of array inputs that have no list control, such as `Item[]` or
+ * `[string, number]`: a text area that holds the value as JSON.
+ *
+ * Text that parses sets the value; while the text is not JSON, the field is marked as invalid and
+ * the input keeps its last valid value. An empty field is `undefined`, and the value that the
+ * playground writes is shown as JSON again, so the text and the value always match. It edits any
+ * value that JSON can hold, so it can also be registered for an object type.
+ */
+declare class NgDocJsonControlComponent<T = unknown> extends DIControl<T | undefined> implements NgDocTypeControl<T | undefined> {
+    /** The text of the field. */
+    protected readonly text: _angular_core.WritableSignal<string>;
+    /** Whether the text is not JSON. */
+    protected readonly invalid: _angular_core.WritableSignal<boolean>;
+    /** The rows of the field: its lines, from 2 to 10. */
+    protected readonly rows: Signal<number>;
+    protected readonly texts: NgDocPlaygroundTexts;
+    /** ID of the message that describes invalid text. */
+    protected readonly errorId: string;
+    /** The value that the text stands for. */
+    private textValue;
+    constructor();
+    writeValue(value: T | null | undefined): void;
+    /**
+     * Sets the value from the text of the field, when it is JSON.
+     * @param text - The text of the field.
+     */
+    protected edit(text: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocJsonControlComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocJsonControlComponent<any>, "ng-doc-json-control", never, {}, {}, never, never, true, never>;
+}
+
+export { NgDocJsonControlComponent };

package/types/ng-doc-app-type-controls-list-control.d.ts

@@ -0,0 +1,313 @@
+import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
+import { NgDocResolvedPlaygroundOption } from '@ng-doc/app/helpers';
+import { NgDocTypeControl, NgDocPlaygroundTexts } from '@ng-doc/app/interfaces';
+import { NgDocPlaygroundOption } from '@ng-doc/core/interfaces';
+import { DIControl } from 'di-controls';
+
+/** A value that an item of an array control can be. */
+type NgDocListControlItem = string | number | boolean;
+/** A row of the dropdown of an array control. */
+interface NgDocListControlRow<T> {
+    /** `add` for the row that adds the typed text, `item` for a suggestion or a value of a union. */
+    kind: 'add' | 'item';
+    /** The value that the row adds. */
+    value: T;
+    /** The text of the value. */
+    label: string;
+    /** Whether the array holds the value: a picked value of a union. */
+    selected: boolean;
+}
+/**
+ * The base of the playground controls of array inputs: a chip combobox. The items are chips, in
+ * one field with a text field after them. Enter adds the typed value, Backspace in the empty field
+ * removes the last chip, and the × of a chip removes it. A chip is dragged to another place, or
+ * moved with Alt+Left and Alt+Right while it is focused, and the arrow keys move between chips.
+ * While the reader types, a dropdown lists the matching suggestions; the arrow keys move its
+ * highlight, and Enter or a click picks a row. Escape closes it.
+ *
+ * Subclasses decide what an item is: typed text (`parseItem`) for the arrays of strings and
+ * numbers, which suggest the input's default items and the items removed while the control is
+ * shown, or the values of a union, which the dropdown lists (`NgDocTypeAliasListControlComponent`).
+ *
+ * The control never changes an array it received: every edit reports a new array of plain values,
+ * so the value can be compared with the default and sent to an isolated demo as it is. An
+ * `undefined` or `null` value has no items and shows as such; the first added item makes it an
+ * array, and removing the last item leaves an empty array. Reset returns to the input's default,
+ * which is how an optional input gets back to `undefined`.
+ */
+declare abstract class NgDocListControl<T extends NgDocListControlItem> extends DIControl<T[] | undefined> implements NgDocTypeControl<T[] | undefined> {
+    /** Default value of the input; Reset returns to it. */
+    readonly default: _angular_core.InputSignal<T[] | undefined>;
+    /**
+     * Whether typed text becomes an item (`parseItem`). Without it, the dropdown lists the values the
+     * items can have, and a value is in the array at most once.
+     */
+    protected abstract readonly freeText: boolean;
+    protected readonly texts: NgDocPlaygroundTexts;
+    /** The prefix of the IDs of the parts of the control. */
+    protected readonly id: string;
+    /** The items of the value; none when the value is not an array. */
+    protected readonly items: Signal<readonly T[]>;
+    /** The items as the chips show them: in the order of a drag in progress. */
+    protected readonly shownItems: Signal<readonly T[]>;
+    /**
+     * The text shown instead of the items when the value is not an array (`undefined` or `null`), or
+     * is an empty array (`[]`), so that the two can be told apart. These are code, not words.
+     */
+    protected readonly literal: Signal<string>;
+    /** Whether Reset is shown: the value differs from the default. */
+    protected readonly canReset: Signal<boolean>;
+    /** The text of the text field. */
+    protected readonly text: _angular_core.WritableSignal<string>;
+    /** Whether the reader asked for the dropdown, by typing, clicking or an arrow key. */
+    protected readonly expanded: _angular_core.WritableSignal<boolean>;
+    /** The position of the highlighted row of the dropdown, or `-1`. */
+    protected readonly highlighted: _angular_core.WritableSignal<number>;
+    /** The position of the item edited in place, or `null`. */
+    protected readonly editing: _angular_core.WritableSignal<number | null>;
+    /** The text of the field that edits an item in place. */
+    protected readonly editText: _angular_core.WritableSignal<string>;
+    /** The position of the chip in the tab order; the others are reached with the arrow keys. */
+    protected readonly tabStop: _angular_core.WritableSignal<number>;
+    /** The position of the chip being dragged, or `null`. */
+    protected readonly dragIndex: _angular_core.WritableSignal<number | null>;
+    /** What the live region announces: the new position of a moved item. */
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    /** The width of the dropdown: the width of the field. */
+    protected readonly panelWidth: _angular_core.WritableSignal<number>;
+    /** Whether the text field holds text that is not an item, such as a word in a `number[]`. */
+    protected readonly invalid: Signal<boolean>;
+    /** Whether the field that edits an item holds text that is not an item. */
+    protected readonly editInvalid: Signal<boolean>;
+    /**
+     * The rows of the dropdown: the values of `candidates()` whose text contains the typed text (the
+     * one equal to it first), and, when the typed text is an item that no row adds, a row that adds
+     * it, first.
+     */
+    protected readonly rows: Signal<Array<NgDocListControlRow<T>>>;
+    /**
+     * Whether the dropdown is open: the reader asked for it and it has rows, or, for a union, says
+     * that no value matches the typed text.
+     */
+    protected readonly panelOpen: Signal<boolean>;
+    /** The items removed while the control is shown, which the arrays of strings and numbers suggest. */
+    private readonly removed;
+    private readonly injector;
+    private readonly dropdown;
+    private readonly fieldBox;
+    /** The items in the order of a drag in progress, or `null`. */
+    private readonly dragOrder;
+    private drag;
+    /** The last array the control reported, which the form writes back. */
+    private reported;
+    protected constructor();
+    /**
+     * Reads typed text as an item.
+     * @param text - The text.
+     * @returns The item, or `undefined` when the text is not one.
+     */
+    protected abstract parseItem(text: string): T | undefined;
+    /**
+     * The values that the dropdown can list, before the typed text filters them: for an array of
+     * strings or numbers, the items of the default and the removed items that the array doesn't
+     * hold. Plain arrays may hold an item twice, so typed text that is an item is added again, but
+     * the suggestions never repeat an item.
+     */
+    protected candidates(): readonly T[];
+    /**
+     * The text of an item.
+     * @param item - The item.
+     */
+    protected labelOf(item: T): string;
+    /**
+     * The text of a chip: the item's text, or `""` for an empty string.
+     * @param item - The item.
+     */
+    protected chipText(item: T): string;
+    /**
+     * Reads the text field as the reader types.
+     * @param text - The text of the field.
+     */
+    protected type(text: string): void;
+    /**
+     * Handles the keys of the text field.
+     * @param event - The key event.
+     * @param field - The text field.
+     */
+    protected fieldKeydown(event: KeyboardEvent, field: HTMLInputElement): void;
+    /**
+     * Opens the dropdown when the reader clicks the field, and focuses the text field when the click
+     * is not on a chip or a button.
+     * @param event - The click.
+     * @param field - The text field.
+     */
+    protected fieldClick(event: MouseEvent, field: HTMLInputElement): void;
+    /**
+     * Picks a row of the dropdown: adds its value, or removes a picked value of a union.
+     * @param row - The row.
+     */
+    protected pick(row: NgDocListControlRow<T>): void;
+    /**
+     * Handles the keys of a focused chip.
+     * @param event - The key event.
+     * @param index - The position of the chip.
+     */
+    protected chipKeydown(event: KeyboardEvent, index: number): void;
+    /**
+     * Removes an item. The focus goes to the chip that takes its place, the previous chip, or the
+     * text field when the field had it, or no chip is left.
+     * @param index - The position of the item.
+     * @param focus - Whether the focus moves; a pick in the dropdown keeps it in the text field.
+     */
+    protected remove(index: number, focus?: boolean): void;
+    /**
+     * Edits an item in place: its chip becomes a text field.
+     * @param index - The position of the item.
+     */
+    protected startEdit(index: number): void;
+    /**
+     * Handles the keys of the field that edits an item: Enter keeps the text, Escape the item.
+     * @param event - The key event.
+     */
+    protected editKeydown(event: KeyboardEvent): void;
+    /** Ends an edit when its field loses the focus: with the text when it is an item. */
+    protected editBlur(): void;
+    /**
+     * Starts to follow a pointer that went down on a chip.
+     * @param event - The pointer event.
+     * @param index - The position of the chip.
+     */
+    protected chipPointerDown(event: PointerEvent, index: number): void;
+    /**
+     * Drags the chip once the pointer has moved far enough, and moves it in front of or behind the
+     * chip under the pointer once the pointer passes that chip's middle.
+     * @param event - The pointer event.
+     */
+    protected chipPointerMove(event: PointerEvent): void;
+    /**
+     * Drops a dragged chip: the items take the order of the drag.
+     * @param event - The pointer event.
+     */
+    protected chipPointerUp(event: PointerEvent): void;
+    /** Stops following the pointer; a drag in progress leaves the items as they were. */
+    protected cancelDrag(): void;
+    /**
+     * Closes the dropdown and marks the control as touched when the focus leaves the control.
+     * @param event - The focus event.
+     */
+    protected leave(event: FocusEvent): void;
+    /** Sets the value back to the default of the input. */
+    protected reset(): void;
+    /**
+     * The ID of a row of the dropdown, which the text field names as its active descendant.
+     * @param index - The position of the row.
+     */
+    protected rowId(index: number): string;
+    /**
+     * Adds an item at the end.
+     * @param value - The item.
+     */
+    private add;
+    /** Adds the highlighted row, or the typed text when it is an item. */
+    private enter;
+    /**
+     * Moves the highlight of the dropdown, and opens it.
+     * @param step - `1` for the next row, `-1` for the previous one.
+     */
+    private moveHighlight;
+    /**
+     * Moves an item one place, with the focus.
+     * @param index - The position of the item.
+     * @param offset - `-1` toward the start, `1` toward the end.
+     */
+    private move;
+    /**
+     * Sets the edited item from the text of its field.
+     * @returns Whether the text is an item.
+     */
+    private commitEdit;
+    /**
+     * The position a dragged chip moves to: the position of the chip under the pointer, once the
+     * pointer has passed its middle in the direction of the move.
+     * @param event - The pointer event.
+     * @param from - The position of the dragged chip.
+     */
+    private dropTarget;
+    /**
+     * Reports a new value.
+     * @param value - The value.
+     */
+    private report;
+    /**
+     * Announces the new position of a moved item.
+     * @param order - The items after the move.
+     * @param index - The new position of the item.
+     */
+    private announceMove;
+    /**
+     * Focuses a chip once the chips have rendered: they are tracked by position, so the focused
+     * element may show another item, or be gone.
+     * @param index - The position of the chip.
+     */
+    private focusChip;
+    /** Focuses the text field once the chips have rendered. */
+    private focusField;
+    private fieldElement;
+    private isFocused;
+    /** Whether the chips flow from right to left, which turns the arrow keys round. */
+    private isRtl;
+    private host;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocListControl<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgDocListControl<any>, never, never, { "default": { "alias": "default"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * The playground control of `string[]` inputs: a chip combobox (`NgDocListControl`). Typed text is
+ * an item as it is, and a double click, Enter or F2 edits a chip in place.
+ */
+declare class NgDocStringListControlComponent extends NgDocListControl<string> {
+    protected readonly freeText = true;
+    constructor();
+    protected parseItem(text: string): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocStringListControlComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocStringListControlComponent, "ng-doc-string-list-control", never, {}, {}, never, never, true, never>;
+}
+/**
+ * The playground control of `number[]` inputs: a chip combobox (`NgDocListControl`) whose items are
+ * numbers. Text that is not a number marks the field as invalid and adds nothing; a chip edited to
+ * such text keeps its number.
+ */
+declare class NgDocNumberListControlComponent extends NgDocListControl<number> {
+    protected readonly freeText = true;
+    constructor();
+    protected parseItem(text: string): number | undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocNumberListControlComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocNumberListControlComponent, "ng-doc-number-list-control", never, {}, {}, never, never, true, never>;
+}
+/**
+ * The playground control of arrays of a union of literals, such as `NgDocSize[]` or
+ * `('a' | 'b')[]`: a chip combobox (`NgDocListControl`) whose dropdown lists every value of the
+ * union, with the same texts as the control of the union (`NgDocTypeAliasControlComponent`).
+ * Picking a value adds it, and picking a value that the array holds, which is marked, removes it.
+ * The typed text filters the values; it is never an item itself.
+ */
+declare class NgDocTypeAliasListControlComponent extends NgDocListControl<NgDocListControlItem> {
+    /**
+     * The values of the items: the members of the union as written in code, plain values when
+     * `isManual` is set, or the names and values of enum members.
+     */
+    readonly options: _angular_core.InputSignal<(string | NgDocPlaygroundOption)[] | undefined>;
+    /** Whether `options` are values the user listed in the playground config. */
+    readonly isManual: _angular_core.InputSignal<boolean | undefined>;
+    protected readonly freeText = false;
+    /** The values of the union that an item can be; `undefined`, `null` and repeats are left out. */
+    protected readonly values: Signal<NgDocResolvedPlaygroundOption[]>;
+    constructor();
+    protected candidates(): readonly NgDocListControlItem[];
+    protected labelOf(item: NgDocListControlItem): string;
+    protected parseItem(): undefined;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocTypeAliasListControlComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocTypeAliasListControlComponent, "ng-doc-type-alias-list-control", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "isManual": { "alias": "isManual"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NgDocListControl, NgDocNumberListControlComponent, NgDocStringListControlComponent, NgDocTypeAliasListControlComponent };