refactor(ivy): Update @publicapi to @codeGenApi on ivy instructions (angular#29820)

- Removes `@publicApi` annotation from ivy instructions
- Adds new `@codeGenApi` annotation to ivy instructions
- Updates ts_api_guardian to support the new annotation properly

PR Close angular#29820

Author: benlesh

packages/core/src/render3/definition.ts

@@ -39,7 +39,7 @@ let _renderCompCount = 0;
  *   });
  * }
  * ```
- * @publicApi
+ * @codeGenApi
  */
 export function ΔdefineComponent<T>(componentDefinition: {
   /**
@@ -305,7 +305,7 @@ export function ΔdefineComponent<T>(componentDefinition: {
 }
 
 /**
- * @publicApi
+ * @codeGenApi
  */
 export function ΔsetComponentScope(
     type: ComponentType<any>, directives: Type<any>[], pipes: Type<any>[]): void {
@@ -332,7 +332,7 @@ export function extractPipeDef(type: PipeType<any>): PipeDef<any> {
 }
 
 /**
- * @publicApi
+ * @codeGenApi
  */
 export function ΔdefineNgModule<T>(def: {
   /** Token representing the module. Used by DI. */
@@ -376,7 +376,7 @@ export function ΔdefineNgModule<T>(def: {
  * marked pure to tree-shake it from the bundle, allowing for all referenced declarations
  * to become eligible for tree-shaking as well.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔsetNgModuleScope(type: any, scope: {
   /** List of components, directives, and pipes declared by this module. */
@@ -488,7 +488,7 @@ function invertObject<T>(
  *
  * @param baseDefinition The base definition parameters
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔdefineBase<T>(baseDefinition: {
   /**
@@ -570,7 +570,7 @@ export function ΔdefineBase<T>(baseDefinition: {
  * }
  * ```
  *
- * @publicApi
+ * @codeGenApi
  */
 export const ΔdefineDirective = ΔdefineComponent as any as<T>(directiveDefinition: {
   /**
@@ -688,7 +688,7 @@ export const ΔdefineDirective = ΔdefineComponent as any as<T>(directiveDefinit
  * ```
  * @param pipeDef Pipe definition generated by the compiler
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔdefinePipe<T>(pipeDef: {
   /** Name of the pipe. Used for matching pipes in template to pipe defs. */

packages/core/src/render3/di.ts

@@ -635,7 +635,7 @@ export class NodeInjector implements Injector {
 }
 
 /**
- * @publicApi
+ * @codeGenApi
  */
 export function ΔgetFactoryOf<T>(type: Type<any>): ((type: Type<T>| null) => T)|null {
   const typeAny = type as any;
@@ -648,7 +648,7 @@ export function ΔgetFactoryOf<T>(type: Type<any>): ((type: Type<T>| null) => T)
 }
 
 /**
- * @publicApi
+ * @codeGenApi
  */
 export function ΔgetInheritedFactory<T>(type: Type<any>): (type: Type<T>) => T {
   const proto = Object.getPrototypeOf(type.prototype).constructor as Type<any>;

packages/core/src/render3/features/inherit_definition_feature.ts

@@ -24,7 +24,7 @@ function getSuperType(type: Type<any>): Type<any>&
  * Merges the definition from a super class to a sub class.
  * @param definition The definition that is a SubClass of another directive of component
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔInheritDefinitionFeature(definition: DirectiveDef<any>| ComponentDef<any>): void {
   let superType = getSuperType(definition.type);

packages/core/src/render3/features/ng_onchanges_feature.ts

@@ -39,7 +39,7 @@ type OnChangesExpando = OnChanges & {
  * });
  * ```
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔNgOnChangesFeature<T>(): DirectiveDefFeature {
   // This option ensures that the ngOnChanges lifecycle hook will be inherited

packages/core/src/render3/features/providers_feature.ts

@@ -37,7 +37,7 @@ import {DirectiveDef} from '../interfaces/definition';
  *
  * @param definition
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔProvidersFeature<T>(providers: Provider[], viewProviders: Provider[] = []) {
   return (definition: DirectiveDef<T>) => {

packages/core/src/render3/i18n.ts

@@ -347,7 +347,7 @@ const parentIndexStack: number[] = [];
  * @param message The translation message.
  * @param subTemplateIndex Optional sub-template index in the `message`.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nStart(index: number, message: string, subTemplateIndex?: number): void {
   const tView = getLView()[TVIEW];
@@ -534,7 +534,7 @@ function appendI18nNode(tNode: TNode, parentTNode: TNode, previousTNode: TNode |
  *
  * @returns Transformed string that can be consumed by i18nStart instruction
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nPostprocess(
     message: string, replacements: {[key: string]: (string | string[])} = {}): string {
@@ -630,7 +630,7 @@ export function Δi18nPostprocess(
  * Translates a translation block marked by `i18nStart` and `i18nEnd`. It inserts the text/ICU nodes
  * into the render tree, moves the placeholder nodes and removes the deleted nodes.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nEnd(): void {
   const tView = getLView()[TVIEW];
@@ -919,7 +919,7 @@ function removeNode(index: number, viewData: LView) {
  * @param message The translation message.
  * @param subTemplateIndex Optional sub-template index in the `message`.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18n(index: number, message: string, subTemplateIndex?: number): void {
   Δi18nStart(index, message, subTemplateIndex);
@@ -932,7 +932,7 @@ export function Δi18n(index: number, message: string, subTemplateIndex?: number
  * @param index A unique index in the static block
  * @param values
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nAttributes(index: number, values: string[]): void {
   const tView = getLView()[TVIEW];
@@ -984,7 +984,7 @@ let shiftsCounter = 0;
  *
  * @param expression The binding's new value or NO_CHANGE
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nExp<T>(expression: T | NO_CHANGE): void {
   if (expression !== NO_CHANGE) {
@@ -999,7 +999,7 @@ export function Δi18nExp<T>(expression: T | NO_CHANGE): void {
  * @param index Index of either {@link i18nStart} (translation block) or {@link i18nAttributes}
  * (i18n attribute) on which it should update the content.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δi18nApply(index: number) {
   if (shiftsCounter) {

packages/core/src/render3/instructions/alloc_host_vars.ts

@@ -17,7 +17,7 @@ import {NO_CHANGE} from '../tokens';
  *
  * @param count Amount of vars to be allocated
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔallocHostVars(count: number): void {
   const lView = getLView();

packages/core/src/render3/instructions/container.ts

@@ -28,7 +28,7 @@ import {addToViewTree, createDirectivesAndLocals, createLContainer, createNodeAt
  *
  * @param index The index of the container in the data array
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δcontainer(index: number): void {
   const tNode = containerInternal(index, null, null);
@@ -57,7 +57,7 @@ export function Δcontainer(index: number): void {
  * @param localRefExtractor A function which extracts local-refs values from the template.
  *        Defaults to the current element associated with the local-ref.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δtemplate(
     index: number, templateFn: ComponentTemplate<any>| null, consts: number, vars: number,
@@ -85,7 +85,7 @@ export function Δtemplate(
  *
  * @param index The index of the container in the data array
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔcontainerRefreshStart(index: number): void {
   const lView = getLView();
@@ -108,7 +108,7 @@ export function ΔcontainerRefreshStart(index: number): void {
  *
  * Marking the end of LContainer is the time when to child views get inserted or removed.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔcontainerRefreshEnd(): void {
   let previousOrParentTNode = getPreviousOrParentTNode();

packages/core/src/render3/instructions/di.ts

@@ -33,7 +33,7 @@ import {getLView, getPreviousOrParentTNode} from '../state';
  * @param flags Injection flags
  * @returns the value from the injector or `null` when not found
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔdirectiveInject<T>(token: Type<T>| InjectionToken<T>): T;
 export function ΔdirectiveInject<T>(token: Type<T>| InjectionToken<T>, flags: InjectFlags): T;
@@ -48,7 +48,7 @@ export function ΔdirectiveInject<T>(
 /**
  * Facade for the attribute injection from DI.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔinjectAttribute(attrNameToInject: string): string|null {
   return injectAttributeImpl(getPreviousOrParentTNode(), attrNameToInject);

packages/core/src/render3/instructions/element.ts

@@ -42,7 +42,7 @@ import {getActiveDirectiveStylingIndex} from './styling';
  * hold an attribute name and elements with an odd index hold an attribute value, ex.:
  * ['id', 'warning5', 'class', 'alert']
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementStart(
     index: number, name: string, attrs?: TAttributes | null, localRefs?: string[] | null): void {
@@ -127,7 +127,7 @@ export function ΔelementStart(
 /**
  * Mark the end of the element.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementEnd(): void {
   let previousOrParentTNode = getPreviousOrParentTNode();
@@ -179,7 +179,7 @@ export function ΔelementEnd(): void {
  *              element on creation. Use [AttributeMarker] to denote the meaning of this array.
  * @param localRefs A set of local reference bindings on the element.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δelement(
     index: number, name: string, attrs?: TAttributes | null, localRefs?: string[] | null): void {
@@ -198,7 +198,7 @@ export function Δelement(
  * @param sanitizer An optional function used to sanitize the value.
  * @param namespace Optional namespace to use when setting the attribute.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementAttribute(
     index: number, name: string, value: any, sanitizer?: SanitizerFn | null,
@@ -266,7 +266,7 @@ export function ΔelementAttribute(
  * @param attrs An array of static values (attributes, classes and styles) with the correct marker
  * values.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementHostAttrs(attrs: TAttributes) {
   const hostElementIndex = getSelectedIndex();

packages/core/src/render3/instructions/element_container.ts

@@ -29,7 +29,7 @@ import {createDirectivesAndLocals, createNodeAtIndex, executeContentQueries, set
  * the DOM (as a comment node can't have attributes). Attributes are here only for directive
  * matching purposes and setting initial inputs of directives.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementContainerStart(
     index: number, attrs?: TAttributes | null, localRefs?: string[] | null): void {
@@ -70,7 +70,7 @@ export function ΔelementContainerStart(
 /**
  * Mark the end of the <ng-container>.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔelementContainerEnd(): void {
   let previousOrParentTNode = getPreviousOrParentTNode();

packages/core/src/render3/instructions/embedded_view.ts

@@ -23,8 +23,8 @@ import {assignTViewNodeToLView, createLView, createTView, refreshDescendantViews
  *
  * @param viewBlockId The ID of this view
  * @return boolean Whether or not this view is in creation mode
- * 
- * @publicApi
+ *
+ * @codeGenApi
  */
 export function ΔembeddedViewStart(viewBlockId: number, consts: number, vars: number): RenderFlags {
   const lView = getLView();
@@ -127,7 +127,7 @@ function scanForView(lContainer: LContainer, startIdx: number, viewBlockId: numb
 /**
  * Marks the end of an embedded view.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔembeddedViewEnd(): void {
   const lView = getLView();

packages/core/src/render3/instructions/get_current_view.ts

@@ -15,7 +15,7 @@ import {getLView} from '../state';
  * of the current view and restore it when listeners are invoked. This allows
  * walking the declaration view tree in listeners to get vars from parent views.
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔgetCurrentView(): OpaqueViewState {
   return getLView() as any as OpaqueViewState;

packages/core/src/render3/instructions/listener.ts

@@ -29,7 +29,7 @@ import {BindingDirection, generatePropertyAliases, getCleanup, handleError, load
  * @param eventTargetResolver Function that returns global target information in case this listener
  * should be attached to a global object like window, document or body
  *
- * @publicApi
+ * @codeGenApi
  */
 export function Δlistener(
     eventName: string, listenerFn: (e?: any) => any, useCapture = false,
@@ -56,7 +56,7 @@ export function Δlistener(
 * @param eventTargetResolver Function that returns global target information in case this listener
 * should be attached to a global object like window, document or body
  *
- * @publicApi
+ * @codeGenApi
 */
 export function ΔcomponentHostSyntheticListener<T>(
     eventName: string, listenerFn: (e?: any) => any, useCapture = false,

packages/core/src/render3/instructions/next_context.ts

@@ -17,7 +17,7 @@ import {nextContextImpl} from '../state';
  * @param level The relative level of the view from which to grab context compared to contextVewData
  * @returns context
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔnextContext<T = any>(level: number = 1): T {
   return nextContextImpl(level);

packages/core/src/render3/instructions/projection.ts

@@ -37,7 +37,7 @@ import {createNodeAtIndex} from './shared';
  * @param selectors A collection of parsed CSS selectors
  * @param rawSelectors A collection of CSS selectors in the raw, un-parsed form
  *
- * @publicApi
+ * @codeGenApi
  */
 export function ΔprojectionDef(selectors?: CssSelectorList[]): void {
   const componentNode = findComponentView(getLView())[T_HOST] as TElementNode;
@@ -76,7 +76,7 @@ export function ΔprojectionDef(selectors?: CssSelectorList[]): void {
  *        - 0 when the selector is `*` (or unspecified as this is the default value),
  *        - 1 based index of the selector from the {@link projectionDef}
   *
- * @publicApi
+ * @codeGenApi
 */
 export function Δprojection(
     nodeIndex: number, selectorIndex: number = 0, attrs?: TAttributes): void {