@taiga-ui/cdk 3.51.0-canary.d032cc6 → 3.52.0

package/schematics/ng-update/v4/steps/restore-tui-mapper.js

@@ -2,83 +2,39 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.restoreTuiMapper = void 0;
 const ng_morph_1 = require("ng-morph");
-const ts_morph_1 = require("ts-morph");
-const constants_1 = require("../../../constants");
 const colored_log_1 = require("../../../utils/colored-log");
-const project_root_1 = require("../../../utils/project-root");
-const get_file_system_1 = require("../../utils/get-file-system");
-const replace_substrings_1 = require("./utils/replace-substrings");
+const get_named_import_references_1 = require("../../../utils/get-named-import-references");
+const replace_identifier_1 = require("../../steps/replace-identifier");
 function restoreTuiMapper(options) {
-    return (tree, _) => {
-        const fileSystem = get_file_system_1.getFileSystem(tree);
-        updateTuiMapper(options, fileSystem);
-        renameTuiTypedMapper(options, fileSystem);
-        !options[`skip-logs`] && colored_log_1.titleLog(`${colored_log_1.FINISH_SYMBOL} successfully migrated \n`);
-    };
+    updateTuiMapper(options);
+    renameTuiTypedMapper(options);
+    !options[`skip-logs`] && colored_log_1.titleLog(`${colored_log_1.FINISH_SYMBOL} successfully migrated \n`);
 }
 exports.restoreTuiMapper = restoreTuiMapper;
-function updateTuiMapper(options, fileSystem) {
+function updateTuiMapper(options) {
     !options[`skip-logs`] &&
         colored_log_1.infoLog(`${colored_log_1.SMALL_TAB_SYMBOL}${colored_log_1.REPLACE_SYMBOL} updating TuiMapper typing to the typed version`);
-    ng_morph_1.getSourceFiles(constants_1.ALL_TS_FILES).forEach(sourceFile => {
-        const replacements = findTuiMapperFirstTypeArgReplacements(sourceFile);
-        const sourceText = sourceFile.getFullText();
-        const transformed = replace_substrings_1.replaceSubstrings(sourceText, replacements);
-        sourceFile.replaceWithText(transformed);
-    });
-    fileSystem.commitEdits();
-    ng_morph_1.saveActiveProject();
-    ng_morph_1.setActiveProject(ng_morph_1.createProject(fileSystem.tree, project_root_1.projectRoot(), constants_1.ALL_FILES));
-}
-function findTuiMapperFirstTypeArgReplacements(sourceFile) {
-    const replacements = [];
-    sourceFile.transform(traversal => {
-        const node = traversal.visitChildren();
-        if (!ts_morph_1.ts.isTypeReferenceNode(node) || node.typeName.getText() !== `TuiMapper`) {
-            return node;
+    const refs = get_named_import_references_1.getNamedImportReferences(`TuiMapper`, `@taiga-ui/cdk`);
+    for (const ref of refs) {
+        if (ref.wasForgotten()) {
+            return;
         }
-        const typeArguments = node.typeArguments;
-        if (!typeArguments || typeArguments.length !== 2) {
-            return node;
+        const parent = ref.getParent();
+        if (ng_morph_1.Node.isTypeReference(parent)) {
+            const typeArguments = parent.getTypeArguments();
+            if (!typeArguments || typeArguments.length !== 2) {
+                return;
+            }
+            const [inputType] = typeArguments;
+            inputType.replaceWithText(`[${inputType.getText()}, ...any]`);
         }
-        const [inputType] = typeArguments;
-        replacements.push({
-            start: inputType.getStart(),
-            from: inputType.getText(),
-            to: `[${inputType.getText()}, ...any]`,
-        });
-        return node;
-    });
-    return replacements;
+    }
 }
-function renameTuiTypedMapper(options, fileSystem) {
+function renameTuiTypedMapper(options) {
     !options[`skip-logs`] &&
         colored_log_1.infoLog(`${colored_log_1.SMALL_TAB_SYMBOL}${colored_log_1.REPLACE_SYMBOL} renaming TuiTypedMapper to TuiMapper`);
-    ng_morph_1.getSourceFiles(constants_1.ALL_TS_FILES).forEach(sourceFile => {
-        const replacements = findTuiTypedMapperReplacements(sourceFile);
-        const sourceText = sourceFile.getFullText();
-        const transformed = replace_substrings_1.replaceSubstrings(sourceText, replacements);
-        sourceFile.replaceWithText(transformed);
-        sourceFile.organizeImports();
-    });
-    fileSystem.commitEdits();
-    ng_morph_1.saveActiveProject();
-    ng_morph_1.setActiveProject(ng_morph_1.createProject(fileSystem.tree, project_root_1.projectRoot(), constants_1.ALL_FILES));
-}
-function findTuiTypedMapperReplacements(sourceFile) {
-    const replacements = [];
-    sourceFile.transform(traversal => {
-        const node = traversal.visitChildren();
-        if (!ts_morph_1.ts.isTypeReferenceNode(node) ||
-            node.typeName.getText() !== `TuiTypedMapper`) {
-            return node;
-        }
-        replacements.push({
-            start: node.getStart(),
-            from: `TuiTypedMapper`,
-            to: `TuiMapper`,
-        });
-        return node;
+    replace_identifier_1.replaceIdentifier({
+        from: { name: `TuiTypedMapper`, moduleSpecifier: `@taiga-ui/cdk` },
+        to: { name: `TuiMapper`, moduleSpecifier: `@taiga-ui/cdk` },
     });
-    return replacements;
 }

package/schematics/ng-update/v4/steps/restore-tui-matcher.d.ts

@@ -1,3 +1,2 @@
-import { Rule } from '@angular-devkit/schematics';
 import { TuiSchema } from '../../../ng-add/schema';
-export declare function restoreTuiMatcher(options: TuiSchema): Rule;
+export declare function restoreTuiMatcher(options: TuiSchema): void;

package/schematics/ng-update/v4/steps/restore-tui-matcher.js

@@ -2,83 +2,39 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.restoreTuiMatcher = void 0;
 const ng_morph_1 = require("ng-morph");
-const ts_morph_1 = require("ts-morph");
-const constants_1 = require("../../../constants");
 const colored_log_1 = require("../../../utils/colored-log");
-const project_root_1 = require("../../../utils/project-root");
-const get_file_system_1 = require("../../utils/get-file-system");
-const replace_substrings_1 = require("./utils/replace-substrings");
+const get_named_import_references_1 = require("../../../utils/get-named-import-references");
+const replace_identifier_1 = require("../../steps/replace-identifier");
 function restoreTuiMatcher(options) {
-    return (tree, _) => {
-        const fileSystem = get_file_system_1.getFileSystem(tree);
-        updateTuiMatcher(options, fileSystem);
-        renameTuiTypedMatcher(options, fileSystem);
-        !options[`skip-logs`] && colored_log_1.titleLog(`${colored_log_1.FINISH_SYMBOL} successfully migrated \n`);
-    };
+    updateTuiMatcher(options);
+    renameTuiTypedMatcher(options);
+    !options[`skip-logs`] && colored_log_1.titleLog(`${colored_log_1.FINISH_SYMBOL} successfully migrated \n`);
 }
 exports.restoreTuiMatcher = restoreTuiMatcher;
-function updateTuiMatcher(options, fileSystem) {
+function updateTuiMatcher(options) {
     !options[`skip-logs`] &&
         colored_log_1.infoLog(`${colored_log_1.SMALL_TAB_SYMBOL}${colored_log_1.REPLACE_SYMBOL} updating TuiMatcher typing to the typed version`);
-    ng_morph_1.getSourceFiles(constants_1.ALL_TS_FILES).forEach(sourceFile => {
-        const replacements = findTuiMatcherFirstTypeArgReplacements(sourceFile);
-        const sourceText = sourceFile.getFullText();
-        const transformed = replace_substrings_1.replaceSubstrings(sourceText, replacements);
-        sourceFile.replaceWithText(transformed);
-    });
-    fileSystem.commitEdits();
-    ng_morph_1.saveActiveProject();
-    ng_morph_1.setActiveProject(ng_morph_1.createProject(fileSystem.tree, project_root_1.projectRoot(), constants_1.ALL_FILES));
-}
-function findTuiMatcherFirstTypeArgReplacements(sourceFile) {
-    const replacements = [];
-    sourceFile.transform(traversal => {
-        const node = traversal.visitChildren();
-        if (!ts_morph_1.ts.isTypeReferenceNode(node) || node.typeName.getText() !== `TuiMatcher`) {
-            return node;
+    const refs = get_named_import_references_1.getNamedImportReferences(`TuiMatcher`, `@taiga-ui/cdk`);
+    for (const ref of refs) {
+        if (ref.wasForgotten()) {
+            return;
         }
-        const typeArguments = node.typeArguments;
-        if (!typeArguments || typeArguments.length !== 1) {
-            return node;
+        const parent = ref.getParent();
+        if (ng_morph_1.Node.isTypeReference(parent)) {
+            const typeArguments = parent.getTypeArguments();
+            if (!typeArguments || typeArguments.length !== 1) {
+                return;
+            }
+            const [inputType] = typeArguments;
+            inputType.replaceWithText(`[${inputType.getText()}, ...any]`);
         }
-        const [inputType] = typeArguments;
-        replacements.push({
-            start: inputType.getStart(),
-            from: inputType.getText(),
-            to: `[${inputType.getText()}, ...any]`,
-        });
-        return node;
-    });
-    return replacements;
+    }
 }
-function renameTuiTypedMatcher(options, fileSystem) {
+function renameTuiTypedMatcher(options) {
     !options[`skip-logs`] &&
         colored_log_1.infoLog(`${colored_log_1.SMALL_TAB_SYMBOL}${colored_log_1.REPLACE_SYMBOL} renaming TuiTypedMatcher to TuiMatcher`);
-    ng_morph_1.getSourceFiles(constants_1.ALL_TS_FILES).forEach(sourceFile => {
-        const replacements = findTuiTypedMatcherReplacements(sourceFile);
-        const sourceText = sourceFile.getFullText();
-        const transformed = replace_substrings_1.replaceSubstrings(sourceText, replacements);
-        sourceFile.replaceWithText(transformed);
-        sourceFile.organizeImports();
-    });
-    fileSystem.commitEdits();
-    ng_morph_1.saveActiveProject();
-    ng_morph_1.setActiveProject(ng_morph_1.createProject(fileSystem.tree, project_root_1.projectRoot(), constants_1.ALL_FILES));
-}
-function findTuiTypedMatcherReplacements(sourceFile) {
-    const replacements = [];
-    sourceFile.transform(traversal => {
-        const node = traversal.visitChildren();
-        if (!ts_morph_1.ts.isTypeReferenceNode(node) ||
-            node.typeName.getText() !== `TuiTypedMatcher`) {
-            return node;
-        }
-        replacements.push({
-            start: node.getStart(),
-            from: `TuiTypedMatcher`,
-            to: `TuiMatcher`,
-        });
-        return node;
+    replace_identifier_1.replaceIdentifier({
+        from: { name: `TuiTypedMatcher`, moduleSpecifier: `@taiga-ui/cdk` },
+        to: { name: `TuiMatcher`, moduleSpecifier: `@taiga-ui/cdk` },
     });
-    return replacements;
 }

package/schematics/utils/add-import-to-component.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addImportToComponent = void 0;
-const push_to_array_property_1 = require("ng-morph/ng/helpers/push-to-array-property");
+const ng_morph_1 = require("ng-morph");
+// TODO: delete after adding to ng-morph
 function addImportToComponent(classDeclaration, moduleName, { unique = true } = {}) {
-    push_to_array_property_1.pushToArrayProperty(classDeclaration, `Component`, `imports`, moduleName, {
+    ng_morph_1.pushToDecoratorArrayProperty(classDeclaration, `Component`, `imports`, moduleName, {
         unique,
         forceToArray: true,
     });

package/schematics/utils/angular/ng-module.d.ts

@@ -1,3 +1,6 @@
 import { ClassDeclaration, Pattern, Query, StructureType } from 'ng-morph';
 export declare function getNgModules(pattern: Pattern, query?: Query<Omit<StructureType<ClassDeclaration>, 'kind'>>): ClassDeclaration[];
+/**
+ * Find NgModule where the component was declared.
+ */
 export declare function findNgModule(ngComponent: ClassDeclaration): ClassDeclaration | null;

package/schematics/utils/angular/ng-module.js

@@ -7,6 +7,9 @@ function getNgModules(pattern, query) {
     return ng_morph_1.getClasses(pattern, query).filter(declaration => !!declaration.getDecorator(`NgModule`));
 }
 exports.getNgModules = getNgModules;
+/**
+ * Find NgModule where the component was declared.
+ */
 function findNgModule(ngComponent) {
     const allNgModules = getNgModules(constants_1.ALL_TS_FILES);
     return (allNgModules.find(module => {

package/schematics/utils/angular-json-manipulations.js

@@ -12,7 +12,13 @@ const get_projects_1 = require("./get-projects");
 function isInvalidAngularJson(tree) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
         return (workspace_1.getWorkspace(tree)
+            // eslint-disable-next-line no-restricted-syntax
             .then(() => false)
+            /**
+             * Possible error – "Invalid format version detected - Expected:[ 1 ] Found: [ 2 ]"
+             * @see https://github.com/angular/angular-cli/blob/main/packages/angular_devkit/core/src/workspace/json/reader.ts#L67-L69
+             */
+            // eslint-disable-next-line no-restricted-syntax
             .catch(() => true));
     });
 }
@@ -26,6 +32,7 @@ function hasTaigaIcons(assets) {
     }));
 }
 function addStylesToAngularJson(options, context, taigaStyles, filter, stylesToReplace, tree) {
+    // eslint-disable-next-line @typescript-eslint/naming-convention
     const MANUAL_MIGRATION_TIPS = `Add styles ${taigaStyles.join(`,`)} to angular.json manually.`;
     return workspace_1.updateWorkspace(workspace => {
         const projects = get_projects_1.getProjects(options, workspace);

package/schematics/utils/colored-log.js

@@ -21,7 +21,7 @@ function titleLog(message) {
     console.info(`\x1B[35m`, message);
 }
 exports.titleLog = titleLog;
-exports.SMALL_TAB_SYMBOL = `  `;
+exports.SMALL_TAB_SYMBOL = `  `; // @note: if you use \t then we have big gaps
 exports.START_SYMBOL = `🚀`;
 exports.FINISH_SYMBOL = `🏆`;
 exports.REPLACE_SYMBOL = `⚡️`;

package/schematics/utils/get-projects.d.ts

@@ -1,3 +1,3 @@
-import { ProjectDefinition, WorkspaceDefinition } from '@angular-devkit/core/src/workspace';
+import { workspaces } from '@angular-devkit/core';
 import { TuiSchema } from '../ng-add/schema';
-export declare function getProjects(options: TuiSchema, workspace: WorkspaceDefinition): ProjectDefinition[];
+export declare function getProjects(options: TuiSchema, workspace: workspaces.WorkspaceDefinition): workspaces.ProjectDefinition[];

package/schematics/utils/get-projects.js

@@ -6,7 +6,9 @@ function getProjects(options, workspace) {
     const projects = Array.from(workspace.projects.entries())
         .filter(([_, project]) => project.targets.get(`build`))
         .map(([_, project]) => project);
-    const nameFromContext = options.project || ((_a = workspace.extensions.defaultProject) === null || _a === void 0 ? void 0 : _a.toString()) || ``;
+    const nameFromContext = 
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string
+    options.project || ((_a = workspace.extensions.defaultProject) === null || _a === void 0 ? void 0 : _a.toString()) || ``;
     const projectFromContext = workspace.projects.get(nameFromContext);
     return projectFromContext ? [projectFromContext] : projects;
 }

package/schematics/utils/is-ci.js

@@ -1,18 +1,20 @@
 "use strict";
+/// <reference types="node" />
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tuiIsCI = void 0;
 function tuiIsCI() {
     return (process.env.TUI_CI === `true` ||
-        !!process.env.CI ||
-        !!process.env.GITHUB_ACTION ||
-        !!process.env.GITLAB_CI ||
-        !!process.env.CIRCLECI ||
-        !!process.env.TF_BUILD ||
-        !!process.env.CIRRUS_CI ||
-        !!process.env.BUILDKITE ||
-        !!process.env.HEROKU_TEST_RUN_ID ||
-        !!process.env.CODEBUILD_BUILD_ID ||
-        !!process.env.TEAMCITY_VERSION ||
-        !!process.env.BUILD_ID);
+        !!process.env.CI || // Another CI
+        !!process.env.GITHUB_ACTION || // Github CI
+        !!process.env.GITLAB_CI || // Gitlab CI
+        !!process.env.CIRCLECI || // Circle CI
+        !!process.env.TF_BUILD || // Azure CI
+        !!process.env.CIRRUS_CI || // Cirrus CI
+        !!process.env.BUILDKITE || // Build Kite CI
+        !!process.env.HEROKU_TEST_RUN_ID || // Heroku CI
+        !!process.env.CODEBUILD_BUILD_ID || // CodeBuild CI
+        !!process.env.TEAMCITY_VERSION || // TeamCity CI
+        !!process.env.BUILD_ID // Jenkins/Hudson
+    );
 }
 exports.tuiIsCI = tuiIsCI;

package/schematics/utils/progress.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupProgressLogger = void 0;
+/// <reference types="node" />
 const readline_1 = require("readline");
 const colored_log_1 = require("./colored-log");
 const is_ci_1 = require("./is-ci");

package/schematics/utils/push-to-array-property.js

@@ -21,6 +21,7 @@ function pushToObjectArrayProperty(objectExpression, propertyName, initializer,
             .some(element => element.getText() === initializer)) {
         return;
     }
+    // eslint-disable-next-line @taiga-ui/experience/no-typeof
     if (typeof index === `number`) {
         importsInitializer.insertElement(index, initializer);
     }

package/schematics/utils/templates/elements.d.ts

@@ -3,9 +3,28 @@ export declare function findElementsByFn(nodes: ChildNode[], predicateFn: (el: E
 export declare function findElementsInTemplateByFn(html: string, predicateFn: (el: Element) => boolean): Element[];
 export declare function findElementsByTagName(html: string, tagName: string): Element[];
 export declare function findElementsByTagNames(html: string, tagNames: string[]): Element[];
+/**
+ * Parses a HTML fragment and traverses all AST nodes in order find elements that
+ * include the specified attribute.
+ */
 export declare function findElementsWithAttribute(html: string, attributeName: string): Element[];
+/**
+ * Parses a HTML fragment and traverses all AST nodes in order find elements that include the specified attribute and tag name.
+ * @param html
+ * @param attributeName
+ */
 export declare function findElementsWithAttributeOnTag(html: string, attributeNames: string[], tagNames?: string[]): Element[];
+/**
+ * Finds elements with explicit tag names that also contain the specified attribute. Returns the
+ * attribute start offset based on the specified HTML.
+ */
 export declare function findAttributeOnElementWithTag(html: string, name: string, tagNames: string[], filterFn?: (element: Element) => boolean): number[];
+/**
+ * Finds elements that contain the given attribute and contain at least one of the other
+ * specified attributes. Returns the primary attribute's start offset based on the specified HTML.
+ */
 export declare function findAttributeOnElementWithAttrs(html: string, name: string, attrs: string[], filterFn?: (element: Element) => boolean): number[];
+/** Shorthand function that checks if the specified element contains the given attribute. */
 export declare function hasElementAttribute(element: Element, attributeName: string): boolean;
+/** Gets the start offset of the given attribute from a Parse5 element. */
 export declare function getStartOffsetOfAttribute(element: Element, attributeName: string): number;

package/schematics/utils/templates/elements.js

@@ -20,6 +20,7 @@ function findElementsByFn(nodes, predicateFn) {
 }
 exports.findElementsByFn = findElementsByFn;
 function findElementsInTemplateByFn(html, predicateFn) {
+    // utf8 with BOM adds an extra character to the beginning of the string
     if (html.charCodeAt(0) === 0xfeff) {
         html = html.slice(1);
     }
@@ -35,10 +36,19 @@ function findElementsByTagNames(html, tagNames) {
     return findElementsInTemplateByFn(html, el => tagNames.includes(el.tagName));
 }
 exports.findElementsByTagNames = findElementsByTagNames;
+/**
+ * Parses a HTML fragment and traverses all AST nodes in order find elements that
+ * include the specified attribute.
+ */
 function findElementsWithAttribute(html, attributeName) {
     return findElementsInTemplateByFn(html, el => { var _a; return (_a = el.attrs) === null || _a === void 0 ? void 0 : _a.some(attr => attr.name === attributeName.toLowerCase()); });
 }
 exports.findElementsWithAttribute = findElementsWithAttribute;
+/**
+ * Parses a HTML fragment and traverses all AST nodes in order find elements that include the specified attribute and tag name.
+ * @param html
+ * @param attributeName
+ */
 function findElementsWithAttributeOnTag(html, attributeNames, tagNames = []) {
     return findElementsInTemplateByFn(html, el => {
         var _a;
@@ -47,25 +57,39 @@ function findElementsWithAttributeOnTag(html, attributeNames, tagNames = []) {
     });
 }
 exports.findElementsWithAttributeOnTag = findElementsWithAttributeOnTag;
-function findAttributeOnElementWithTag(html, name, tagNames, filterFn = () => true) {
+/**
+ * Finds elements with explicit tag names that also contain the specified attribute. Returns the
+ * attribute start offset based on the specified HTML.
+ */
+function findAttributeOnElementWithTag(html, name, tagNames, 
+// eslint-disable-next-line no-restricted-syntax
+filterFn = () => true) {
     return findElementsWithAttribute(html, name)
         .filter(element => (tagNames.includes(element.tagName) || tagNames.includes(`*`)) &&
         filterFn(element))
         .map(element => getStartOffsetOfAttribute(element, name));
 }
 exports.findAttributeOnElementWithTag = findAttributeOnElementWithTag;
-function findAttributeOnElementWithAttrs(html, name, attrs, filterFn = () => true) {
+/**
+ * Finds elements that contain the given attribute and contain at least one of the other
+ * specified attributes. Returns the primary attribute's start offset based on the specified HTML.
+ */
+function findAttributeOnElementWithAttrs(html, name, attrs, 
+// eslint-disable-next-line no-restricted-syntax
+filterFn = () => true) {
     return findElementsWithAttribute(html, name)
         .filter(element => attrs.some(attr => hasElementAttribute(element, attr)) &&
         filterFn(element))
         .map(element => getStartOffsetOfAttribute(element, name));
 }
 exports.findAttributeOnElementWithAttrs = findAttributeOnElementWithAttrs;
+/** Shorthand function that checks if the specified element contains the given attribute. */
 function hasElementAttribute(element, attributeName) {
     var _a;
     return (_a = element.attrs) === null || _a === void 0 ? void 0 : _a.some(attr => attr.name === attributeName.toLowerCase());
 }
 exports.hasElementAttribute = hasElementAttribute;
+/** Gets the start offset of the given attribute from a Parse5 element. */
 function getStartOffsetOfAttribute(element, attributeName) {
     var _a, _b, _c;
     return (((_c = (_b = (_a = element.sourceCodeLocation) === null || _a === void 0 ? void 0 : _a.attrs) === null || _b === void 0 ? void 0 : _b[attributeName.toLowerCase()]) === null || _c === void 0 ? void 0 : _c.startOffset) || 0);

package/schematics/utils/templates/ng-component-input-manipulations.d.ts

@@ -1,6 +1,31 @@
 import { DevkitFileSystem } from 'ng-morph/project/classes/devkit-file-system';
 import { Element } from 'parse5';
 import { TemplateResource } from '../../ng-update/interfaces/template-resource';
+/**
+ * Replace component input property by new value
+ * ___
+ * Example:
+ * 1. Before
+ * ```html
+ * <tui-input-slider secondary="123"></tui-input-slider>
+ * ```
+ * 2. Execute
+ * ```ts
+ * const wasModified = replaceInputProperty({
+ *      templateResource,
+ *      fileSystem,
+ *      componentSelector: 'tui-input-slider',
+ *      from: 'secondary',
+ *      to: 'tuiTextfieldCustomContent',
+ * });
+ * ```
+ * 3. After
+ * ```html
+ * <tui-input-slider tuiTextfieldCustomContent="123"></tui-input-slider>
+ * ```
+ * ___
+ * @return true if something was changed
+ */
 export declare function replaceInputProperty({ templateResource, fileSystem, componentSelector, from, to, newValue, filterFn, }: {
     componentSelector: string[] | string;
     fileSystem: DevkitFileSystem;
@@ -10,7 +35,21 @@ export declare function replaceInputProperty({ templateResource, fileSystem, com
     templateResource: TemplateResource;
     to: string;
 }): boolean;
+/**
+ * @example
+ * // 10 symbols before property `size` and string `size="s"` has 8-symbols length
+ * const template = '<tui-card size="s"></tui-card>';
+ *
+ * getInputPropertyOffsets(template, 'size', ['tui-card']) // [[10, 18]]
+ */
 export declare function getInputPropertyOffsets(html: string, attrName: string, tags: string[], filterFn?: (element: Element) => boolean): Array<[number, number]>;
+/**
+ * @example
+ * // `<tui-card size="` has 16-symbols length
+ * const template = '<tui-card size="xl"></tui-card>';
+ *
+ * getInputPropertyValueOffsets(template, 'size', ['tui-card']) // [ [16, 18] ]
+ */
 export declare function getInputPropertyValueOffsets(template: string, attrName: string, tags: string[]): Array<[number, number]>;
 export declare function replaceInputPropertyByDirective({ templateResource, fileSystem, componentSelector, inputProperty, directive, directiveModule, filterFn, }: {
     componentSelector: string[] | string;
@@ -24,6 +63,11 @@ export declare function replaceInputPropertyByDirective({ templateResource, file
     inputProperty: string;
     templateResource: TemplateResource;
 }): void;
+/**
+ * After removing property from the tag (which uses multi lines inside template) it can leave redundant space.
+ * It is not critical because html is valid even with this extra space.
+ * TODO: Find a way to fix it
+ */
 export declare function removeInputProperty({ templateResource, fileSystem, componentSelector, inputProperty, filterFn, }: {
     componentSelector: string;
     fileSystem: DevkitFileSystem;

package/schematics/utils/templates/ng-component-input-manipulations.js

@@ -4,6 +4,31 @@ exports.removeInputProperty = exports.replaceInputPropertyByDirective = exports.
 const add_import_to_closest_module_1 = require("../add-import-to-closest-module");
 const elements_1 = require("./elements");
 const template_resource_1 = require("./template-resource");
+/**
+ * Replace component input property by new value
+ * ___
+ * Example:
+ * 1. Before
+ * ```html
+ * <tui-input-slider secondary="123"></tui-input-slider>
+ * ```
+ * 2. Execute
+ * ```ts
+ * const wasModified = replaceInputProperty({
+ *      templateResource,
+ *      fileSystem,
+ *      componentSelector: 'tui-input-slider',
+ *      from: 'secondary',
+ *      to: 'tuiTextfieldCustomContent',
+ * });
+ * ```
+ * 3. After
+ * ```html
+ * <tui-input-slider tuiTextfieldCustomContent="123"></tui-input-slider>
+ * ```
+ * ___
+ * @return true if something was changed
+ */
 function replaceInputProperty({ templateResource, fileSystem, componentSelector, from, to, newValue = ``, filterFn, }) {
     const template = template_resource_1.getTemplateFromTemplateResource(templateResource, fileSystem);
     const path = fileSystem.resolve(template_resource_1.getPathFromTemplateResource(templateResource));
@@ -44,7 +69,16 @@ function replaceInputProperty({ templateResource, fileSystem, componentSelector,
     return true;
 }
 exports.replaceInputProperty = replaceInputProperty;
-function getInputPropertyOffsets(html, attrName, tags, filterFn = () => true) {
+/**
+ * @example
+ * // 10 symbols before property `size` and string `size="s"` has 8-symbols length
+ * const template = '<tui-card size="s"></tui-card>';
+ *
+ * getInputPropertyOffsets(template, 'size', ['tui-card']) // [[10, 18]]
+ */
+function getInputPropertyOffsets(html, attrName, tags, 
+// eslint-disable-next-line no-restricted-syntax
+filterFn = () => true) {
     return elements_1.findElementsWithAttribute(html, attrName)
         .filter(element => (tags.includes(element.tagName) || tags.includes(`*`)) &&
         filterFn(element))
@@ -55,6 +89,13 @@ function getInputPropertyOffsets(html, attrName, tags, filterFn = () => true) {
     });
 }
 exports.getInputPropertyOffsets = getInputPropertyOffsets;
+/**
+ * @example
+ * // `<tui-card size="` has 16-symbols length
+ * const template = '<tui-card size="xl"></tui-card>';
+ *
+ * getInputPropertyValueOffsets(template, 'size', ['tui-card']) // [ [16, 18] ]
+ */
 function getInputPropertyValueOffsets(template, attrName, tags) {
     const stringProperties = getInputPropertyOffsets(template, attrName, tags).map(([start, end]) => [start + attrName.length + `="`.length, end - 1]);
     const propertyBindings = getInputPropertyOffsets(template, `[${attrName}]`, tags).map(([start, end]) => [start + `[${attrName}]`.length + `="`.length, end - 1]);
@@ -75,6 +116,11 @@ function replaceInputPropertyByDirective({ templateResource, fileSystem, compone
     }
 }
 exports.replaceInputPropertyByDirective = replaceInputPropertyByDirective;
+/**
+ * After removing property from the tag (which uses multi lines inside template) it can leave redundant space.
+ * It is not critical because html is valid even with this extra space.
+ * TODO: Find a way to fix it
+ */
 function removeInputProperty({ templateResource, fileSystem, componentSelector, inputProperty, filterFn, }) {
     const template = template_resource_1.getTemplateFromTemplateResource(templateResource, fileSystem);
     const templateOffset = template_resource_1.getTemplateOffset(templateResource);

package/services/destroy.service.d.ts

@@ -1,6 +1,14 @@
 import { OnDestroy } from '@angular/core';
 import { ReplaySubject } from 'rxjs';
 import * as i0 from "@angular/core";
+/**
+ * @note:
+ * Observable abstraction over ngOnDestroy to use with takeUntil
+ *
+ * Why we use `ReplaySubject` instead of `Subject`?
+ * Well, we’ll use ReplaySubject to emit the last message in case
+ * the subscription is ended after the component is destroyed.
+ */
 export declare class TuiDestroyService extends ReplaySubject<void> implements OnDestroy {
     constructor();
     ngOnDestroy(): void;

package/services/directive-styles.service.d.ts

@@ -1,5 +1,8 @@
 import { ComponentFactoryResolver, Injector, Type } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * Service to use styles with directives
+ */
 export declare class TuiDirectiveStylesService {
     private readonly resolver;
     private readonly injector;

package/services/focus-visible.service.d.ts

@@ -1,6 +1,11 @@
 import { ChangeDetectorRef, ElementRef } from '@angular/core';
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
+/**
+ * Service to imitate :focus-visible
+ * (https://developer.mozilla.org/en-US/docs/Web/CSS/:focus-visible)
+ * in browsers that do not support it
+ */
 export declare class TuiFocusVisibleService extends Observable<boolean> {
     private readonly focusVisible$;
     constructor({ nativeElement }: ElementRef<Element>, cdr: ChangeDetectorRef, destroy$: Observable<void>);

package/services/id.service.d.ts

@@ -1,4 +1,7 @@
 import * as i0 from "@angular/core";
+/**
+ * Generates unique ids
+ */
 export declare class TuiIdService {
     private static autoId;
     generate(): string;