@ng-doc/app 22.0.0-beta.1 → 22.0.0

package/styles/themes/dark.css

@@ -1,33 +1,44 @@
 @media (prefers-color-scheme: dark) {
   :root[data-theme=auto] {
-    --ng-doc-base-rgb: 43 43 43;
-    --ng-doc-base-0: rgb(40.85, 40.85, 40.85);
-    --ng-doc-base-1: rgb(48.45, 48.45, 48.45);
-    --ng-doc-base-2: rgb(55.1, 55.1, 55.1);
-    --ng-doc-base-3: rgb(62.7, 62.7, 62.7);
-    --ng-doc-base-4: rgb(71.25, 71.25, 71.25);
-    --ng-doc-base-5: rgb(80.75, 80.75, 80.75);
-    --ng-doc-base-6: rgb(89.3, 89.3, 89.3);
-    --ng-doc-base-7: rgb(98.8, 98.8, 98.8);
-    --ng-doc-base-8: rgb(108.3, 108.3, 108.3);
-    --ng-doc-base-9: rgb(118.75, 118.75, 118.75);
-    --ng-doc-base-10: rgb(129.2, 129.2, 129.2);
-    --ng-doc-heading-color: #e3e3e3;
-    --ng-doc-text: #a9a9a9;
-    --ng-doc-text-muted: var(--ng-doc-base-10);
-    --ng-doc-text-selection: rgba(110, 110, 110, 0.81);
-    --ng-doc-shadow-color: rgba(0, 0, 0, 0.4);
-    --ng-doc-link-color: #30a5ff;
-    --ng-doc-inline-code-background: #b9b9b9;
-    --ng-doc-primary: #faab00;
-    --ng-doc-info: #7095ff;
-    --ng-doc-mark-background: rgba(48, 165, 255, 0.3);
-    --ng-doc-search-result-color: #c6c6c6;
-    --ng-doc-api-tag-background: #ff5959;
-    --ng-doc-api-tag-color: var(--ng-doc-base-0);
-    --ng-doc-guide-tag-background: #faab00;
-    --ng-doc-guide-tag-color: var(--ng-doc-base-0);
-    --ng-doc-navbar-border: 1px solid var(--ng-doc-base-4);
+    --ng-doc-base-rgb: 24 25 29;
+    --ng-doc-base-0: var(--ng-doc-palette-neutral-950);
+    --ng-doc-base-1: var(--ng-doc-palette-neutral-900);
+    --ng-doc-base-2: var(--ng-doc-palette-neutral-875);
+    --ng-doc-base-3: var(--ng-doc-palette-neutral-850);
+    --ng-doc-base-4: var(--ng-doc-palette-neutral-800);
+    --ng-doc-base-5: var(--ng-doc-palette-neutral-750);
+    --ng-doc-base-6: var(--ng-doc-palette-neutral-700);
+    --ng-doc-base-7: var(--ng-doc-palette-neutral-600);
+    --ng-doc-base-8: var(--ng-doc-palette-neutral-500);
+    --ng-doc-base-9: var(--ng-doc-palette-neutral-450);
+    --ng-doc-base-10: var(--ng-doc-palette-neutral-400);
+    --ng-doc-heading-color: var(--ng-doc-palette-neutral-50);
+    --ng-doc-text: var(--ng-doc-palette-neutral-300);
+    --ng-doc-text-muted: var(--ng-doc-base-9);
+    --ng-doc-text-selection: color-mix(in srgb, var(--ng-doc-primary) 30%, transparent);
+    --ng-doc-shadow-color: rgb(0 0 0 / 0.45);
+    --ng-doc-inline-code-background: var(--ng-doc-base-10);
+    --ng-doc-primary: var(--ng-doc-palette-brand-400);
+    --ng-doc-primary-text: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-link-color: var(--ng-doc-primary);
+    --ng-doc-info: var(--ng-doc-palette-brand-400);
+    --ng-doc-info-text: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-success: var(--ng-doc-palette-green-400);
+    --ng-doc-success-text: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-warning: var(--ng-doc-palette-amber-400);
+    --ng-doc-warning-text: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-alert: var(--ng-doc-palette-red-400);
+    --ng-doc-alert-text: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-mark-background: color-mix(in srgb, #f5c542 28%, transparent);
+    --ng-doc-search-result-color: var(--ng-doc-text);
+    --ng-doc-navbar-border: 1px solid var(--ng-doc-border-color);
+    --ng-doc-hue-violet: var(--ng-doc-palette-violet-400);
+    --ng-doc-on-hue: var(--ng-doc-palette-neutral-1000);
+    --ng-doc-mix-soft: 12%;
+    --ng-doc-mix-chip: 16%;
+    --ng-doc-mix-border: 30%;
+    --ng-doc-focus-ring-color: var(--ng-doc-palette-brand-400);
+    --ng-doc-playground-input-border: var(--ng-doc-border-size) solid var(--ng-doc-base-8);
   }
   :root[data-theme=auto] .shiki,
   :root[data-theme=auto] .shiki span {
@@ -36,34 +47,45 @@
 }
 
 :root[data-theme=dark] {
-  --ng-doc-base-rgb: 43 43 43;
-  --ng-doc-base-0: rgb(40.85, 40.85, 40.85);
-  --ng-doc-base-1: rgb(48.45, 48.45, 48.45);
-  --ng-doc-base-2: rgb(55.1, 55.1, 55.1);
-  --ng-doc-base-3: rgb(62.7, 62.7, 62.7);
-  --ng-doc-base-4: rgb(71.25, 71.25, 71.25);
-  --ng-doc-base-5: rgb(80.75, 80.75, 80.75);
-  --ng-doc-base-6: rgb(89.3, 89.3, 89.3);
-  --ng-doc-base-7: rgb(98.8, 98.8, 98.8);
-  --ng-doc-base-8: rgb(108.3, 108.3, 108.3);
-  --ng-doc-base-9: rgb(118.75, 118.75, 118.75);
-  --ng-doc-base-10: rgb(129.2, 129.2, 129.2);
-  --ng-doc-heading-color: #e3e3e3;
-  --ng-doc-text: #a9a9a9;
-  --ng-doc-text-muted: var(--ng-doc-base-10);
-  --ng-doc-text-selection: rgba(110, 110, 110, 0.81);
-  --ng-doc-shadow-color: rgba(0, 0, 0, 0.4);
-  --ng-doc-link-color: #30a5ff;
-  --ng-doc-inline-code-background: #b9b9b9;
-  --ng-doc-primary: #faab00;
-  --ng-doc-info: #7095ff;
-  --ng-doc-mark-background: rgba(48, 165, 255, 0.3);
-  --ng-doc-search-result-color: #c6c6c6;
-  --ng-doc-api-tag-background: #ff5959;
-  --ng-doc-api-tag-color: var(--ng-doc-base-0);
-  --ng-doc-guide-tag-background: #faab00;
-  --ng-doc-guide-tag-color: var(--ng-doc-base-0);
-  --ng-doc-navbar-border: 1px solid var(--ng-doc-base-4);
+  --ng-doc-base-rgb: 24 25 29;
+  --ng-doc-base-0: var(--ng-doc-palette-neutral-950);
+  --ng-doc-base-1: var(--ng-doc-palette-neutral-900);
+  --ng-doc-base-2: var(--ng-doc-palette-neutral-875);
+  --ng-doc-base-3: var(--ng-doc-palette-neutral-850);
+  --ng-doc-base-4: var(--ng-doc-palette-neutral-800);
+  --ng-doc-base-5: var(--ng-doc-palette-neutral-750);
+  --ng-doc-base-6: var(--ng-doc-palette-neutral-700);
+  --ng-doc-base-7: var(--ng-doc-palette-neutral-600);
+  --ng-doc-base-8: var(--ng-doc-palette-neutral-500);
+  --ng-doc-base-9: var(--ng-doc-palette-neutral-450);
+  --ng-doc-base-10: var(--ng-doc-palette-neutral-400);
+  --ng-doc-heading-color: var(--ng-doc-palette-neutral-50);
+  --ng-doc-text: var(--ng-doc-palette-neutral-300);
+  --ng-doc-text-muted: var(--ng-doc-base-9);
+  --ng-doc-text-selection: color-mix(in srgb, var(--ng-doc-primary) 30%, transparent);
+  --ng-doc-shadow-color: rgb(0 0 0 / 0.45);
+  --ng-doc-inline-code-background: var(--ng-doc-base-10);
+  --ng-doc-primary: var(--ng-doc-palette-brand-400);
+  --ng-doc-primary-text: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-link-color: var(--ng-doc-primary);
+  --ng-doc-info: var(--ng-doc-palette-brand-400);
+  --ng-doc-info-text: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-success: var(--ng-doc-palette-green-400);
+  --ng-doc-success-text: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-warning: var(--ng-doc-palette-amber-400);
+  --ng-doc-warning-text: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-alert: var(--ng-doc-palette-red-400);
+  --ng-doc-alert-text: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-mark-background: color-mix(in srgb, #f5c542 28%, transparent);
+  --ng-doc-search-result-color: var(--ng-doc-text);
+  --ng-doc-navbar-border: 1px solid var(--ng-doc-border-color);
+  --ng-doc-hue-violet: var(--ng-doc-palette-violet-400);
+  --ng-doc-on-hue: var(--ng-doc-palette-neutral-1000);
+  --ng-doc-mix-soft: 12%;
+  --ng-doc-mix-chip: 16%;
+  --ng-doc-mix-border: 30%;
+  --ng-doc-focus-ring-color: var(--ng-doc-palette-brand-400);
+  --ng-doc-playground-input-border: var(--ng-doc-border-size) solid var(--ng-doc-base-8);
 }
 :root[data-theme=dark] .shiki,
 :root[data-theme=dark] .shiki span {

package/types/ng-doc-app-classes-content-anchor-controller.d.ts

@@ -0,0 +1,54 @@
+import * as i0 from '@angular/core';
+
+/** Coordinates one missed router anchor with the accepted asynchronous content pass. */
+declare class NgDocContentAnchorController {
+    private readonly applicationRef;
+    private readonly document;
+    private readonly contentState;
+    private readonly initialScrollIntent;
+    private readonly anchorScrolling;
+    private readonly positionRestoration;
+    private readonly host;
+    private readonly zone;
+    private readonly router;
+    private readonly viewport;
+    private readonly browser;
+    private active;
+    private bodyProcessed;
+    private destroyed;
+    private latestNavigationId;
+    private pending?;
+    private sequence;
+    private readonly subscription;
+    private viewportListening;
+    private frameWait?;
+    private overflowAnchorLease?;
+    private suppressedNavigationId?;
+    private unsubscribeIntent?;
+    private readonly userInput;
+    private readonly keyInput;
+    private readonly viewportScroll;
+    constructor();
+    /** Limits delayed replay to pages backed by an asynchronous content source. */
+    activate(): void;
+    /** Marks the current asynchronous body and its processors as accepted. */
+    contentProcessed(): void;
+    /** Cancels a missed anchor when the current body fails. */
+    contentFailed(): void;
+    private observeScroll;
+    private replayAfterStable;
+    private observeInitialIntent;
+    private afterScrollOpportunity;
+    private eventUrl;
+    private target;
+    private clear;
+    private acquireOverflowAnchor;
+    private releaseOverflowAnchor;
+    private pageWrapper;
+    private cancelFrameWait;
+    private destroy;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgDocContentAnchorController, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+
+export { NgDocContentAnchorController };

package/types/ng-doc-app-classes-content-controller.d.ts

@@ -0,0 +1,94 @@
+import * as i0 from '@angular/core';
+import { WritableSignal } from '@angular/core';
+import { NgDocContentSource, NgDocContentModule } from '@ng-doc/core/interfaces';
+
+/** A failed processing pass of one content version. */
+interface NgDocContentRenderFailure {
+    /** The content version the pass rendered. */
+    readonly version: number;
+    /** The error the pass failed with. */
+    readonly error: unknown;
+}
+/**
+ * Owns one body or header content source for one component instance. Provide it in the
+ * component's `providers`; it holds a pending task from each load until the processors accept
+ * the loaded HTML.
+ */
+declare class NgDocContentController {
+    /** The loaded HTML. */
+    readonly html: WritableSignal<string>;
+    /** Increments whenever the HTML must be processed again. */
+    readonly version: WritableSignal<number>;
+    /** The load or processing error of the current source. */
+    readonly error: WritableSignal<Error | undefined>;
+    /**
+     * Whether the latest load of the current source has been rendered: its version was processed,
+     * or the load or its processing failed. False while a load or its processing is pending.
+     */
+    readonly settled: WritableSignal<boolean>;
+    /**
+     * The version of the latest loaded content of the current source, or undefined before the
+     * first load. A processing pass of this version renders loaded content.
+     * @internal
+     */
+    readonly loadedVersion: WritableSignal<number | undefined>;
+    private readonly pendingTasks;
+    private readonly contentState;
+    private readonly owner;
+    private source?;
+    private unsubscribe?;
+    private abort?;
+    private pending?;
+    private request;
+    private sourceEpoch;
+    private renderState;
+    private destroyed;
+    constructor();
+    /**
+     * Loads the source and reloads it whenever the source reports a change. Connecting the
+     * connected source again does nothing.
+     * @param source - The content source.
+     */
+    connect(source: NgDocContentSource): void;
+    /** Drops the current source and clears the HTML. */
+    disconnect(): void;
+    /**
+     * Accepts a processing pass. Only the pass of the current version counts.
+     * @param version - The content version the pass rendered.
+     */
+    processed(version: number): void;
+    /**
+     * Reports a failed processing pass. Only a failure of the current version counts.
+     * @param failure - The version and the error.
+     */
+    processingFailed(failure: NgDocContentRenderFailure): void;
+    /** Cancels the current load and releases its pending task. Called on destroy. */
+    destroy(): void;
+    /**
+     * Loads the current source.
+     * @param preloaded - Whether a payload that was preloaded for the source (by the route resolver
+     * or by link preloading) may be used. It is applied at once, so the first render of the
+     * component already shows the content instead of an empty page.
+     */
+    private reload;
+    private load;
+    private apply;
+    private isCurrent;
+    private fail;
+    private settle;
+    private cancelCurrent;
+    private finishPending;
+    private unsubscribeCurrent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgDocContentController, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * Checks that a loaded content module has the expected shape and id.
+ * @param payload - The loaded value.
+ * @param expectedId - The id of the source that loaded it.
+ * @returns The payload, typed.
+ */
+declare function validatePayload(payload: unknown, expectedId: string): NgDocContentModule;
+
+export { NgDocContentController, validatePayload };
+export type { NgDocContentRenderFailure };

package/types/ng-doc-app-classes-default-search-engine.d.ts

@@ -21,12 +21,18 @@ interface NgDocDefaultSearchEngineOptions {
      */
     exact?: boolean;
     /**
-     * Number of results to return (default: 10).
+     * Number of results to return (default: 10). Guides get up to half of them, and more when
+     * fewer API references match; API references fill the rest.
      */
     limit?: number;
 }
 /**
  * Search engine for the documentation, it loads the index and provides a search method.
+ *
+ * Guides rank above API references: the results list the matching guides first, then the
+ * matching API references, each in order of relevance. Guides take up to half of the `limit`
+ * (rounded up), or more when fewer API references match; API references fill the rest, and take
+ * more than half when fewer guides match.
  */
 declare class NgDocDefaultSearchEngine extends NgDocSearchEngine {
     private options?;
@@ -37,7 +43,9 @@ declare class NgDocDefaultSearchEngine extends NgDocSearchEngine {
      * @param query The query to search for.
      */
     search(query: string): Observable<NgDocSearchResult[]>;
+    private searchPages;
     private request;
+    private createDatabase;
 }
 
 export { NgDocDefaultSearchEngine };

package/types/ng-doc-app-classes-root-page.d.ts

@@ -1,5 +1,5 @@
 import { NgDocDemoAssets } from '@ng-doc/app/interfaces';
-import { NgDocPage } from '@ng-doc/core/interfaces';
+import { NgDocContentSource, NgDocPage } from '@ng-doc/core/interfaces';
 import { NgDocPageType } from '@ng-doc/core/types';
 
 /**
@@ -14,6 +14,11 @@ declare abstract class NgDocRootPage {
      * Html content of the page
      */
     abstract readonly pageContent: string;
+    /**
+     * Deferred content for generated pages. Legacy pages can continue to provide
+     * {@link pageContent} only.
+     */
+    readonly pageContentSource?: NgDocContentSource;
     /**
      * Edit URL that can be used to edit the page source file in the repository
      */

package/types/ng-doc-app-classes-search-engine.d.ts

@@ -5,6 +5,11 @@ import { Observable } from 'rxjs';
  * Abstract search engine class, that can be used to implement a custom search engine.
  */
 declare abstract class NgDocSearchEngine {
+    /**
+     * Searches the documentation.
+     * @param query - The text the user typed.
+     * @returns The results for the query.
+     */
     abstract search(query: string): Observable<NgDocSearchResult[]>;
 }
 

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

@@ -1,3 +1,5 @@
+export * from '@ng-doc/app/classes/content-anchor-controller';
+export * from '@ng-doc/app/classes/content-controller';
 export * from '@ng-doc/app/classes/default-search-engine';
 export * from '@ng-doc/app/classes/root-page';
 export * from '@ng-doc/app/classes/search-engine';

package/types/ng-doc-app-components-api-list.d.ts

@@ -1,29 +1,78 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
 import * as _angular_core from '@angular/core';
-import { OnInit, WritableSignal, Signal } from '@angular/core';
-import { FormGroup, FormControl } from '@angular/forms';
-import { NgDocApiList } from '@ng-doc/core/interfaces';
+import { Signal } from '@angular/core';
+import { NgDocShortcutsService } from '@ng-doc/app/services/shortcuts';
+import { NgDocApiListItem } from '@ng-doc/core/interfaces';
 
-interface ApiFilterForm {
-    filter: FormControl<string | null>;
-    scope: FormControl<string | null>;
-    type: FormControl<string | null>;
+/** How the API index groups declarations. */
+type GroupBy = 'kind' | 'scope';
+/**
+ * A declaration of the API list. The generated list may carry a one-line description; the index
+ * filters by it and shows it when it is present.
+ */
+interface Declaration extends NgDocApiListItem {
+    description?: string;
+    scope: string;
 }
-declare class NgDocApiListComponent implements OnInit {
-    private readonly baseUrl;
-    title: _angular_core.InputSignal<string>;
-    segment: _angular_core.InputSignal<string | undefined>;
-    apiList: WritableSignal<NgDocApiList[]>;
-    filteredApiList: Signal<NgDocApiList[]>;
-    filter: Signal<any>;
-    scopes: Signal<string[]>;
-    types: Signal<string[]>;
-    protected formGroup: FormGroup<ApiFilterForm>;
-    private readonly formBuilder;
+interface Group {
+    id: string;
+    kind?: string;
+    label: string;
+    items: Declaration[];
+}
+interface KindFilter {
+    kind: string;
+    label: string;
+    count: number;
+}
+/**
+ * The index of API declarations: a filter that matches names and descriptions, grouping by kind
+ * or by scope, and a kind filter with counts. The filter, kind, scope and grouping are kept in
+ * the query parameters (filter, type, scope and group), so a filtered index can be linked.
+ */
+declare class NgDocApiListComponent {
+    /** The title of the page. */
+    readonly title: _angular_core.InputSignal<string>;
+    /** The segment of the API list data, when the site has more than one API list. */
+    readonly segment: _angular_core.InputSignal<string | undefined>;
+    protected readonly shortcuts: NgDocShortcutsService;
+    protected readonly model: _angular_core.WritableSignal<{
+        filter: string;
+    }>;
+    protected readonly filterForm: _angular_forms_signals.FieldTree<{
+        filter: string;
+    }, string | number, "writable">;
+    protected readonly kind: _angular_core.WritableSignal<string>;
+    protected readonly scope: _angular_core.WritableSignal<string>;
+    protected readonly groupBy: _angular_core.WritableSignal<GroupBy>;
     private readonly route;
     private readonly router;
-    private readonly httpClient;
+    private readonly basePath;
+    private readonly filterInput;
+    private readonly apiList;
+    protected readonly declarations: Signal<Declaration[]>;
+    protected readonly scopes: Signal<string[]>;
+    protected readonly hasDescriptions: Signal<boolean>;
+    /** Declarations in the selected scope, before the text and kind filters. */
+    protected readonly inScope: Signal<Declaration[]>;
+    protected readonly kinds: Signal<KindFilter[]>;
+    protected readonly visible: Signal<Declaration[]>;
+    protected readonly groups: Signal<Group[]>;
+    protected readonly loaded: Signal<boolean>;
+    protected readonly failed: Signal<boolean>;
     constructor();
-    ngOnInit(): void;
+    /**
+     * Shows only the declarations of a kind, or of every kind.
+     * @param kind - The kind, or an empty string for every kind.
+     */
+    protected selectKind(kind: string): void;
+    /**
+     * Groups the declarations by kind or by scope.
+     * @param groupBy - The grouping.
+     */
+    protected selectGroupBy(groupBy: GroupBy): void;
+    /** Shows the declarations of every scope. */
+    protected clearScope(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocApiListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocApiListComponent, "ng-doc-api-list", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "segment": { "alias": "segment"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/types/ng-doc-app-components-breadcrumb.d.ts

@@ -1,10 +1,15 @@
-import { NgDocPageBreadcrumbs } from '@ng-doc/app/interfaces';
 import * as i0 from '@angular/core';
+import { NgDocPageBreadcrumbs } from '@ng-doc/app/interfaces';
 
+/**
+ * The breadcrumbs of a page: a navigation landmark that lists the categories above the page and
+ * marks the page itself as the current one.
+ */
 declare class NgDocBreadcrumbComponent implements NgDocPageBreadcrumbs {
-    breadcrumbs: string[];
+    /** Titles from the top category down to the page. */
+    readonly breadcrumbs: i0.InputSignal<string[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgDocBreadcrumbComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NgDocBreadcrumbComponent, "ng-doc-breadcrumb", never, { "breadcrumbs": { "alias": "breadcrumbs"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgDocBreadcrumbComponent, "ng-doc-breadcrumb", never, { "breadcrumbs": { "alias": "breadcrumbs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { NgDocBreadcrumbComponent };

package/types/ng-doc-app-components-code.d.ts

@@ -1,16 +1,50 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
+import { AfterViewInit, Signal } from '@angular/core';
 
-declare class NgDocCodeComponent {
-    private elementRef;
-    html: string;
-    copyButton: boolean;
-    name?: string;
-    icon?: string;
-    constructor();
-    get hasHeader(): boolean;
-    get codeElement(): HTMLElement | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NgDocCodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NgDocCodeComponent, "ng-doc-code", never, { "html": { "alias": "html"; "required": false; }; "copyButton": { "alias": "copyButton"; "required": false; }; "name": { "alias": "name"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; }, {}, never, ["*"], true, never>;
+/**
+ * Renders a code block: a header with the file name, the language and the highlighted lines
+ * (shown when the block has a name or an icon), line numbers and a copy button.
+ *
+ * Line numbers are CSS counters, so they are neither copied nor announced. Setting the
+ * `code-line-numbers` theme variable to `none` hides them.
+ */
+declare class NgDocCodeComponent implements AfterViewInit {
+    private readonly elementRef;
+    /** Highlighted HTML of the code. When empty, the projected content is shown instead. */
+    readonly html: _angular_core.InputSignal<string>;
+    /** Whether the copy button is shown. */
+    readonly copyButton: _angular_core.InputSignal<boolean>;
+    /** File name shown in the header. */
+    readonly name: _angular_core.InputSignal<string | undefined>;
+    /** Name of a custom icon shown before the file name. */
+    readonly icon: _angular_core.InputSignal<string | undefined>;
+    /** Whether the header bar is shown: a block with a file name or an icon has one. */
+    readonly hasHeader: Signal<boolean>;
+    /** Language and highlighted lines of projected code, read from the DOM. */
+    private readonly projected;
+    /**
+     * Language and highlighted lines of the code. Highlighted HTML is parsed as a string, so the
+     * header is complete in server-rendered and prerendered pages; projected code is read from its
+     * DOM, which the server renderer provides too.
+     */
+    private readonly rendered;
+    /** Display name of the language; empty for plain text. */
+    protected readonly language: Signal<string>;
+    /** The highlighted lines as text, for example "Lines 6–7" or "Lines 2, 5–6". */
+    protected readonly range: Signal<string>;
+    /** Reads the text of the rendered code when the copy button is pressed. */
+    protected readonly text: () => string;
+    /**
+     * Reads projected code once the view has rendered it. The page's code is projected inside a
+     * control-flow block, so it is in place only after the first render; this hook also runs on the
+     * server, so prerendered pages get the language and the highlighted lines. The page processor
+     * relies on that late projection: it replaces the page's `pre` with this component after
+     * creating it.
+     */
+    ngAfterViewInit(): void;
+    private codeElement;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgDocCodeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgDocCodeComponent, "ng-doc-code", never, { "html": { "alias": "html"; "required": false; "isSignal": true; }; "copyButton": { "alias": "copyButton"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
 export { NgDocCodeComponent };