@angular/compiler 14.0.0-next.14 → 14.0.0-next.15

package/src/render3/view/compiler.d.ts

@@ -1,86 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import { ConstantPool } from '../../constant_pool';
-import * as o from '../../output/output_ast';
-import { ParseError, ParseSourceSpan } from '../../parse_util';
-import { BindingParser } from '../../template_parser/binding_parser';
-import { R3CompiledExpression } from '../util';
-import { R3ComponentMetadata, R3DirectiveMetadata, R3TemplateDependency } from './api';
-/**
- * Compile a directive for the render3 runtime as defined by the `R3DirectiveMetadata`.
- */
-export declare function compileDirectiveFromMetadata(meta: R3DirectiveMetadata, constantPool: ConstantPool, bindingParser: BindingParser): R3CompiledExpression;
-/**
- * Compile a component for the render3 runtime as defined by the `R3ComponentMetadata`.
- */
-export declare function compileComponentFromMetadata(meta: R3ComponentMetadata<R3TemplateDependency>, constantPool: ConstantPool, bindingParser: BindingParser): R3CompiledExpression;
-/**
- * Creates the type specification from the component meta. This type is inserted into .d.ts files
- * to be consumed by upstream compilations.
- */
-export declare function createComponentType(meta: R3ComponentMetadata<R3TemplateDependency>): o.Type;
-/**
- * A set of flags to be used with Queries.
- *
- * NOTE: Ensure changes here are in sync with `packages/core/src/render3/interfaces/query.ts`
- */
-export declare const enum QueryFlags {
-    /**
-     * No flags
-     */
-    none = 0,
-    /**
-     * Whether or not the query should descend into children.
-     */
-    descendants = 1,
-    /**
-     * The query can be computed statically and hence can be assigned eagerly.
-     *
-     * NOTE: Backwards compatibility with ViewEngine.
-     */
-    isStatic = 2,
-    /**
-     * If the `QueryList` should fire change event only if actual change to query was computed (vs old
-     * behavior where the change was fired whenever the query was recomputed, even if the recomputed
-     * query resulted in the same list.)
-     */
-    emitDistinctChangesOnly = 4
-}
-export declare function createBaseDirectiveTypeParams(meta: R3DirectiveMetadata): o.Type[];
-/**
- * Creates the type specification from the directive meta. This type is inserted into .d.ts files
- * to be consumed by upstream compilations.
- */
-export declare function createDirectiveType(meta: R3DirectiveMetadata): o.Type;
-export interface ParsedHostBindings {
-    attributes: {
-        [key: string]: o.Expression;
-    };
-    listeners: {
-        [key: string]: string;
-    };
-    properties: {
-        [key: string]: string;
-    };
-    specialAttributes: {
-        styleAttr?: string;
-        classAttr?: string;
-    };
-}
-export declare function parseHostBindings(host: {
-    [key: string]: string | o.Expression;
-}): ParsedHostBindings;
-/**
- * Verifies host bindings and returns the list of errors (if any). Empty array indicates that a
- * given set of host bindings has no errors.
- *
- * @param bindings set of host bindings to verify.
- * @param sourceSpan source span where host bindings were defined.
- * @returns array of errors associated with a given set of host bindings.
- */
-export declare function verifyHostBindings(bindings: ParsedHostBindings, sourceSpan: ParseSourceSpan): ParseError[];

package/src/render3/view/i18n/context.d.ts

@@ -1,68 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import { AST } from '../../../expression_parser/ast';
-import * as i18n from '../../../i18n/i18n_ast';
-import * as o from '../../../output/output_ast';
-/**
- * I18nContext is a helper class which keeps track of all i18n-related aspects
- * (accumulates placeholders, bindings, etc) between i18nStart and i18nEnd instructions.
- *
- * When we enter a nested template, the top-level context is being passed down
- * to the nested component, which uses this context to generate a child instance
- * of I18nContext class (to handle nested template) and at the end, reconciles it back
- * with the parent context.
- *
- * @param index Instruction index of i18nStart, which initiates this context
- * @param ref Reference to a translation const that represents the content if thus context
- * @param level Nestng level defined for child contexts
- * @param templateIndex Instruction index of a template which this context belongs to
- * @param meta Meta information (id, meaning, description, etc) associated with this context
- */
-export declare class I18nContext {
-    readonly index: number;
-    readonly ref: o.ReadVarExpr;
-    readonly level: number;
-    readonly templateIndex: number | null;
-    readonly meta: i18n.I18nMeta;
-    private registry?;
-    readonly id: number;
-    bindings: Set<AST>;
-    placeholders: Map<string, any[]>;
-    isEmitted: boolean;
-    private _registry;
-    private _unresolvedCtxCount;
-    constructor(index: number, ref: o.ReadVarExpr, level: number, templateIndex: number | null, meta: i18n.I18nMeta, registry?: any);
-    private appendTag;
-    get icus(): any;
-    get isRoot(): boolean;
-    get isResolved(): boolean;
-    getSerializedPlaceholders(): Map<string, any[]>;
-    appendBinding(binding: AST): void;
-    appendIcu(name: string, ref: o.Expression): void;
-    appendBoundText(node: i18n.I18nMeta): void;
-    appendTemplate(node: i18n.I18nMeta, index: number): void;
-    appendElement(node: i18n.I18nMeta, index: number, closed?: boolean): void;
-    appendProjection(node: i18n.I18nMeta, index: number): void;
-    /**
-     * Generates an instance of a child context based on the root one,
-     * when we enter a nested template within I18n section.
-     *
-     * @param index Instruction index of corresponding i18nStart, which initiates this context
-     * @param templateIndex Instruction index of a template which this context belongs to
-     * @param meta Meta information (id, meaning, description, etc) associated with this context
-     *
-     * @returns I18nContext instance
-     */
-    forkChildContext(index: number, templateIndex: number, meta: i18n.I18nMeta): I18nContext;
-    /**
-     * Reconciles child context into parent one once the end of the i18n block is reached (i18nEnd).
-     *
-     * @param context Child I18nContext instance to be reconciled with parent context.
-     */
-    reconcileChildContext(context: I18nContext): void;
-}

package/src/render3/view/i18n/get_msg_utils.d.ts

@@ -1,47 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import * as i18n from '../../../i18n/i18n_ast';
-import * as o from '../../../output/output_ast';
-/**
- * Generates a `goog.getMsg()` statement and reassignment. The template:
- *
- * ```html
- * <div i18n>Sent from {{ sender }} to <span class="receiver">{{ receiver }}</span></div>
- * ```
- *
- * Generates:
- *
- * ```typescript
- * const MSG_FOO = goog.getMsg(
- *   // Message template.
- *   'Sent from {$interpolation} to {$startTagSpan}{$interpolation_1}{$closeTagSpan}.',
- *   // Placeholder values, set to magic strings which get replaced by the Angular runtime.
- *   {
- *     'interpolation': '\uFFFD0\uFFFD',
- *     'startTagSpan': '\uFFFD1\uFFFD',
- *     'interpolation_1': '\uFFFD2\uFFFD',
- *     'closeTagSpan': '\uFFFD3\uFFFD',
- *   },
- *   // Options bag.
- *   {
- *     // Maps each placeholder to the original Angular source code which generates it's value.
- *     original_code: {
- *       'interpolation': '{{ sender }}',
- *       'startTagSpan': '<span class="receiver">',
- *       'interploation_1': '{{ receiver }}',
- *       'closeTagSpan': '</span>',
- *     },
- *   },
- * );
- * const I18N_0 = MSG_FOO;
- * ```
- */
-export declare function createGoogleGetMsgStatements(variable: o.ReadVarExpr, message: i18n.Message, closureVar: o.ReadVarExpr, placeholderValues: {
-    [name: string]: o.Expression;
-}): o.Statement[];
-export declare function serializeI18nMessageForGetMsg(message: i18n.Message): string;

package/src/render3/view/i18n/icu_serializer.d.ts

@@ -1,9 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import * as i18n from '../../../i18n/i18n_ast';
-export declare function serializeIcuNode(icu: i18n.Icu): string;

package/src/render3/view/i18n/localize_utils.d.ts

@@ -1,24 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import * as i18n from '../../../i18n/i18n_ast';
-import * as o from '../../../output/output_ast';
-export declare function createLocalizeStatements(variable: o.ReadVarExpr, message: i18n.Message, params: {
-    [name: string]: o.Expression;
-}): o.Statement[];
-/**
- * Serialize an i18n message into two arrays: messageParts and placeholders.
- *
- * These arrays will be used to generate `$localize` tagged template literals.
- *
- * @param message The message to be serialized.
- * @returns an object containing the messageParts and placeholders.
- */
-export declare function serializeI18nMessageForLocalize(message: i18n.Message): {
-    messageParts: o.LiteralPiece[];
-    placeHolders: o.PlaceholderPiece[];
-};

package/src/render3/view/i18n/meta.d.ts

@@ -1,78 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import * as i18n from '../../../i18n/i18n_ast';
-import * as html from '../../../ml_parser/ast';
-import { InterpolationConfig } from '../../../ml_parser/interpolation_config';
-import { ParseTreeResult } from '../../../ml_parser/parser';
-import * as o from '../../../output/output_ast';
-export declare type I18nMeta = {
-    id?: string;
-    customId?: string;
-    legacyIds?: string[];
-    description?: string;
-    meaning?: string;
-};
-/**
- * This visitor walks over HTML parse tree and converts information stored in
- * i18n-related attributes ("i18n" and "i18n-*") into i18n meta object that is
- * stored with other element's and attribute's information.
- */
-export declare class I18nMetaVisitor implements html.Visitor {
-    private interpolationConfig;
-    private keepI18nAttrs;
-    private enableI18nLegacyMessageIdFormat;
-    hasI18nMeta: boolean;
-    private _errors;
-    private _createI18nMessage;
-    constructor(interpolationConfig?: InterpolationConfig, keepI18nAttrs?: boolean, enableI18nLegacyMessageIdFormat?: boolean);
-    private _generateI18nMessage;
-    visitAllWithErrors(nodes: html.Node[]): ParseTreeResult;
-    visitElement(element: html.Element): any;
-    visitExpansion(expansion: html.Expansion, currentMessage: i18n.Message | null): any;
-    visitText(text: html.Text): any;
-    visitAttribute(attribute: html.Attribute): any;
-    visitComment(comment: html.Comment): any;
-    visitExpansionCase(expansionCase: html.ExpansionCase): any;
-    /**
-     * Parse the general form `meta` passed into extract the explicit metadata needed to create a
-     * `Message`.
-     *
-     * There are three possibilities for the `meta` variable
-     * 1) a string from an `i18n` template attribute: parse it to extract the metadata values.
-     * 2) a `Message` from a previous processing pass: reuse the metadata values in the message.
-     * 4) other: ignore this and just process the message metadata as normal
-     *
-     * @param meta the bucket that holds information about the message
-     * @returns the parsed metadata.
-     */
-    private _parseMetadata;
-    /**
-     * Generate (or restore) message id if not specified already.
-     */
-    private _setMessageId;
-    /**
-     * Update the `message` with a `legacyId` if necessary.
-     *
-     * @param message the message whose legacy id should be set
-     * @param meta information about the message being processed
-     */
-    private _setLegacyIds;
-    private _reportError;
-}
-/**
- * Parses i18n metas like:
- *  - "@@id",
- *  - "description[@@id]",
- *  - "meaning|description[@@id]"
- * and returns an object with parsed output.
- *
- * @param meta String that represents i18n meta
- * @returns Object with id, meaning and description fields
- */
-export declare function parseI18nMeta(meta?: string): I18nMeta;
-export declare function i18nMetaToJSDoc(meta: I18nMeta): o.JSDocComment;

package/src/render3/view/i18n/util.d.ts

@@ -1,78 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-import * as i18n from '../../../i18n/i18n_ast';
-import * as html from '../../../ml_parser/ast';
-import * as o from '../../../output/output_ast';
-import * as t from '../../r3_ast';
-/**
- * Prefix for non-`goog.getMsg` i18n-related vars.
- * Note: the prefix uses lowercase characters intentionally due to a Closure behavior that
- * considers variables like `I18N_0` as constants and throws an error when their value changes.
- */
-export declare const TRANSLATION_VAR_PREFIX = "i18n_";
-/** Name of the i18n attributes **/
-export declare const I18N_ATTR = "i18n";
-export declare const I18N_ATTR_PREFIX = "i18n-";
-/** Prefix of var expressions used in ICUs */
-export declare const I18N_ICU_VAR_PREFIX = "VAR_";
-/** Prefix of ICU expressions for post processing */
-export declare const I18N_ICU_MAPPING_PREFIX = "I18N_EXP_";
-/** Placeholder wrapper for i18n expressions **/
-export declare const I18N_PLACEHOLDER_SYMBOL = "\uFFFD";
-export declare function isI18nAttribute(name: string): boolean;
-export declare function isI18nRootNode(meta?: i18n.I18nMeta): meta is i18n.Message;
-export declare function isSingleI18nIcu(meta?: i18n.I18nMeta): boolean;
-export declare function hasI18nMeta(node: t.Node & {
-    i18n?: i18n.I18nMeta;
-}): boolean;
-export declare function hasI18nAttrs(element: html.Element): boolean;
-export declare function icuFromI18nMessage(message: i18n.Message): i18n.IcuPlaceholder;
-export declare function wrapI18nPlaceholder(content: string | number, contextId?: number): string;
-export declare function assembleI18nBoundString(strings: string[], bindingStartIndex?: number, contextId?: number): string;
-export declare function getSeqNumberGenerator(startsAt?: number): () => number;
-export declare function placeholdersToParams(placeholders: Map<string, string[]>): {
-    [name: string]: o.LiteralExpr;
-};
-export declare function updatePlaceholderMap(map: Map<string, any[]>, name: string, ...values: any[]): void;
-export declare function assembleBoundTextPlaceholders(meta: i18n.I18nMeta, bindingStartIndex?: number, contextId?: number): Map<string, any[]>;
-/**
- * Format the placeholder names in a map of placeholders to expressions.
- *
- * The placeholder names are converted from "internal" format (e.g. `START_TAG_DIV_1`) to "external"
- * format (e.g. `startTagDiv_1`).
- *
- * @param params A map of placeholder names to expressions.
- * @param useCamelCase whether to camelCase the placeholder name when formatting.
- * @returns A new map of formatted placeholder names to expressions.
- */
-export declare function formatI18nPlaceholderNamesInMap(params: {
-    [name: string]: o.Expression;
-} | undefined, useCamelCase: boolean): {
-    [key: string]: o.Expression;
-};
-/**
- * Converts internal placeholder names to public-facing format
- * (for example to use in goog.getMsg call).
- * Example: `START_TAG_DIV_1` is converted to `startTagDiv_1`.
- *
- * @param name The placeholder name that should be formatted
- * @returns Formatted placeholder name
- */
-export declare function formatI18nPlaceholderName(name: string, useCamelCase?: boolean): string;
-/**
- * Generates a prefix for translation const name.
- *
- * @param extra Additional local prefix that should be injected into translation var name
- * @returns Complete translation const prefix
- */
-export declare function getTranslationConstPrefix(extra: string): string;
-/**
- * Generate AST to declare a variable. E.g. `var I18N_1;`.
- * @param variable the name of the variable to declare.
- */
-export declare function declareI18nVariable(variable: o.ReadVarExpr): o.Statement;

package/src/render3/view/style_parser.d.ts

@@ -1,18 +0,0 @@
-/**
- * @license
- * Copyright Google LLC All Rights Reserved.
- *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.io/license
- */
-/**
- * Parses string representation of a style and converts it into object literal.
- *
- * @param value string representation of style as used in the `style` attribute in HTML.
- *   Example: `color: red; height: auto`.
- * @returns An array of style property name and value pairs, e.g. `['color', 'red', 'height',
- * 'auto']`
- */
-export declare function parse(value: string): string[];
-export declare function stripUnnecessaryQuotes(value: string): string;
-export declare function hyphenate(value: string): string;

package/src/render3/view/styling_builder.d.ts

@@ -1,211 +0,0 @@
-import { AST } from '../../expression_parser/ast';
-import * as o from '../../output/output_ast';
-import { ParseSourceSpan } from '../../parse_util';
-import * as t from '../r3_ast';
-import { ValueConverter } from './template';
-import { DefinitionMap } from './util';
-/**
- * Minimum amount of binding slots required in the runtime for style/class bindings.
- *
- * Styling in Angular uses up two slots in the runtime LView/TData data structures to
- * record binding data, property information and metadata.
- *
- * When a binding is registered it will place the following information in the `LView`:
- *
- * slot 1) binding value
- * slot 2) cached value (all other values collected before it in string form)
- *
- * When a binding is registered it will place the following information in the `TData`:
- *
- * slot 1) prop name
- * slot 2) binding index that points to the previous style/class binding (and some extra config
- * values)
- *
- * Let's imagine we have a binding that looks like so:
- *
- * ```
- * <div [style.width]="x" [style.height]="y">
- * ```
- *
- * Our `LView` and `TData` data-structures look like so:
- *
- * ```typescript
- * LView = [
- *   // ...
- *   x, // value of x
- *   "width: x",
- *
- *   y, // value of y
- *   "width: x; height: y",
- *   // ...
- * ];
- *
- * TData = [
- *   // ...
- *   "width", // binding slot 20
- *   0,
- *
- *   "height",
- *   20,
- *   // ...
- * ];
- * ```
- *
- * */
-export declare const MIN_STYLING_BINDING_SLOTS_REQUIRED = 2;
-/**
- * A styling expression summary that is to be processed by the compiler
- */
-export interface StylingInstruction {
-    reference: o.ExternalReference;
-    /** Calls to individual styling instructions. Used when chaining calls to the same instruction. */
-    calls: StylingInstructionCall[];
-}
-export interface StylingInstructionCall {
-    sourceSpan: ParseSourceSpan | null;
-    supportsInterpolation: boolean;
-    allocateBindingSlots: number;
-    params: ((convertFn: (value: any) => o.Expression | o.Expression[]) => o.Expression[]);
-}
-/**
- * An internal record of the input data for a styling binding
- */
-interface BoundStylingEntry {
-    hasOverrideFlag: boolean;
-    name: string | null;
-    suffix: string | null;
-    sourceSpan: ParseSourceSpan;
-    value: AST;
-}
-/**
- * Produces creation/update instructions for all styling bindings (class and style)
- *
- * It also produces the creation instruction to register all initial styling values
- * (which are all the static class="..." and style="..." attribute values that exist
- * on an element within a template).
- *
- * The builder class below handles producing instructions for the following cases:
- *
- * - Static style/class attributes (style="..." and class="...")
- * - Dynamic style/class map bindings ([style]="map" and [class]="map|string")
- * - Dynamic style/class property bindings ([style.prop]="exp" and [class.name]="exp")
- *
- * Due to the complex relationship of all of these cases, the instructions generated
- * for these attributes/properties/bindings must be done so in the correct order. The
- * order which these must be generated is as follows:
- *
- * if (createMode) {
- *   styling(...)
- * }
- * if (updateMode) {
- *   styleMap(...)
- *   classMap(...)
- *   styleProp(...)
- *   classProp(...)
- * }
- *
- * The creation/update methods within the builder class produce these instructions.
- */
-export declare class StylingBuilder {
-    private _directiveExpr;
-    /** Whether or not there are any static styling values present */
-    private _hasInitialValues;
-    /**
-     *  Whether or not there are any styling bindings present
-     *  (i.e. `[style]`, `[class]`, `[style.prop]` or `[class.name]`)
-     */
-    hasBindings: boolean;
-    hasBindingsWithPipes: boolean;
-    /** the input for [class] (if it exists) */
-    private _classMapInput;
-    /** the input for [style] (if it exists) */
-    private _styleMapInput;
-    /** an array of each [style.prop] input */
-    private _singleStyleInputs;
-    /** an array of each [class.name] input */
-    private _singleClassInputs;
-    private _lastStylingInput;
-    private _firstStylingInput;
-    /**
-     * Represents the location of each style binding in the template
-     * (e.g. `<div [style.width]="w" [style.height]="h">` implies
-     * that `width=0` and `height=1`)
-     */
-    private _stylesIndex;
-    /**
-     * Represents the location of each class binding in the template
-     * (e.g. `<div [class.big]="b" [class.hidden]="h">` implies
-     * that `big=0` and `hidden=1`)
-     */
-    private _classesIndex;
-    private _initialStyleValues;
-    private _initialClassValues;
-    constructor(_directiveExpr: o.Expression | null);
-    /**
-     * Registers a given input to the styling builder to be later used when producing AOT code.
-     *
-     * The code below will only accept the input if it is somehow tied to styling (whether it be
-     * style/class bindings or static style/class attributes).
-     */
-    registerBoundInput(input: t.BoundAttribute): boolean;
-    registerInputBasedOnName(name: string, expression: AST, sourceSpan: ParseSourceSpan): BoundStylingEntry | null;
-    registerStyleInput(name: string, isMapBased: boolean, value: AST, sourceSpan: ParseSourceSpan, suffix?: string | null): BoundStylingEntry | null;
-    registerClassInput(name: string, isMapBased: boolean, value: AST, sourceSpan: ParseSourceSpan): BoundStylingEntry | null;
-    private _checkForPipes;
-    /**
-     * Registers the element's static style string value to the builder.
-     *
-     * @param value the style string (e.g. `width:100px; height:200px;`)
-     */
-    registerStyleAttr(value: string): void;
-    /**
-     * Registers the element's static class string value to the builder.
-     *
-     * @param value the className string (e.g. `disabled gold zoom`)
-     */
-    registerClassAttr(value: string): void;
-    /**
-     * Appends all styling-related expressions to the provided attrs array.
-     *
-     * @param attrs an existing array where each of the styling expressions
-     * will be inserted into.
-     */
-    populateInitialStylingAttrs(attrs: o.Expression[]): void;
-    /**
-     * Builds an instruction with all the expressions and parameters for `elementHostAttrs`.
-     *
-     * The instruction generation code below is used for producing the AOT statement code which is
-     * responsible for registering initial styles (within a directive hostBindings' creation block),
-     * as well as any of the provided attribute values, to the directive host element.
-     */
-    assignHostAttrs(attrs: o.Expression[], definitionMap: DefinitionMap): void;
-    /**
-     * Builds an instruction with all the expressions and parameters for `classMap`.
-     *
-     * The instruction data will contain all expressions for `classMap` to function
-     * which includes the `[class]` expression params.
-     */
-    buildClassMapInstruction(valueConverter: ValueConverter): StylingInstruction | null;
-    /**
-     * Builds an instruction with all the expressions and parameters for `styleMap`.
-     *
-     * The instruction data will contain all expressions for `styleMap` to function
-     * which includes the `[style]` expression params.
-     */
-    buildStyleMapInstruction(valueConverter: ValueConverter): StylingInstruction | null;
-    private _buildMapBasedInstruction;
-    private _buildSingleInputs;
-    private _buildClassInputs;
-    private _buildStyleInputs;
-    /**
-     * Constructs all instructions which contain the expressions that will be placed
-     * into the update block of a template function or a directive hostBindings function.
-     */
-    buildUpdateLevelInstructions(valueConverter: ValueConverter): StylingInstruction[];
-}
-export declare function parseProperty(name: string): {
-    property: string;
-    suffix: string | null;
-    hasOverrideFlag: boolean;
-};
-export {};