From 0b38172628158e22cb7eb5da4f17d4f9918f8fab Mon Sep 17 00:00:00 2001
From: Paul Gschwendtner <paulgschwendtner@gmail.com>
Date: Mon, 18 Mar 2024 14:22:29 +0000
Subject: [PATCH] refactor(core): improve API documentation for query
 initializer APIs (#54925)

Similar to `input`, `model`, `output`, the query initializer APIs are
also explicitly denoted as such. This allows angular.dev to display them
more readable and compactly.

PR Close #54925
---
 packages/core/src/authoring/queries.ts | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/core/src/authoring/queries.ts b/packages/core/src/authoring/queries.ts
index 6e0b3d3c412ed..66e050ddf38fd 100644
--- a/packages/core/src/authoring/queries.ts
+++ b/packages/core/src/authoring/queries.ts
@@ -76,6 +76,7 @@ export interface ViewChildFunction {
  * ```
  *
  * @developerPreview
+ * @initializerApiFunction
  */
 export const viewChild: ViewChildFunction = (() => {
   // Note: This may be considered a side-effect, but nothing will depend on
@@ -107,6 +108,9 @@ export function viewChildren<LocatorT, ReadT>(
  *   divEls = viewChildren<ElementRef>('el');   // Signal<ReadonlyArray<ElementRef>>
  * }
  * ```
+ *
+ * @initializerApiFunction
+ * @developerPreview
  */
 export function viewChildren<LocatorT, ReadT>(
     locator: ProviderToken<LocatorT>|string,
@@ -155,8 +159,6 @@ export interface ContentChildFunction {
 
   /**
    * Initializes a content child query that is always expected to match.
-   *
-   * @developerPreview
    */
   required: {
     <LocatorT>(locator: ProviderToken<LocatorT>|string, opts?: {
@@ -187,6 +189,9 @@ export interface ContentChildFunction {
  *   headerRequired = contentChild.required(MyHeader);            // Signal<MyHeader>
  * }
  * ```
+ *
+ * @initializerApiFunction
+ * @developerPreview
  */
 export const contentChild: ContentChildFunction = (() => {
   // Note: This may be considered a side-effect, but nothing will depend on
@@ -220,6 +225,9 @@ export function contentChildren<LocatorT, ReadT>(
  *   headerEl = contentChildren<ElementRef>('h');   // Signal<ReadonlyArray<ElementRef>>
  * }
  * ```
+ *
+ * @initializerApiFunction
+ * @developerPreview
  */
 export function contentChildren<LocatorT, ReadT>(
     locator: ProviderToken<LocatorT>|string,