@skyux/packages 9.0.0-alpha.7 → 9.0.0-alpha.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyux/packages",
-  "version": "9.0.0-alpha.7",
+  "version": "9.0.0-alpha.9",
   "author": "Blackbaud, Inc.",
   "description": "Handles the `ng update` command for SKY UX component libraries.",
   "keywords": [
@@ -37,54 +37,54 @@
     "migrations": "./src/schematics/migrations/migration-collection.json",
     "packageGroup": {
       "@blackbaud/angular-tree-component": "^1.0.0-alpha.0",
-      "@skyux-sdk/eslint-config": "9.0.0-alpha.7",
-      "@skyux-sdk/prettier-schematics": "9.0.0-alpha.7",
-      "@skyux-sdk/testing": "9.0.0-alpha.7",
-      "@skyux/a11y": "9.0.0-alpha.7",
-      "@skyux/action-bars": "9.0.0-alpha.7",
-      "@skyux/ag-grid": "9.0.0-alpha.7",
-      "@skyux/angular-tree-component": "9.0.0-alpha.7",
-      "@skyux/animations": "9.0.0-alpha.7",
-      "@skyux/assets": "9.0.0-alpha.7",
-      "@skyux/autonumeric": "9.0.0-alpha.7",
-      "@skyux/avatar": "9.0.0-alpha.7",
-      "@skyux/colorpicker": "9.0.0-alpha.7",
-      "@skyux/config": "9.0.0-alpha.7",
-      "@skyux/core": "9.0.0-alpha.7",
-      "@skyux/data-manager": "9.0.0-alpha.7",
-      "@skyux/datetime": "9.0.0-alpha.7",
-      "@skyux/errors": "9.0.0-alpha.7",
-      "@skyux/flyout": "9.0.0-alpha.7",
-      "@skyux/forms": "9.0.0-alpha.7",
-      "@skyux/grids": "9.0.0-alpha.7",
-      "@skyux/http": "9.0.0-alpha.7",
-      "@skyux/i18n": "9.0.0-alpha.7",
+      "@skyux-sdk/eslint-config": "9.0.0-alpha.9",
+      "@skyux-sdk/prettier-schematics": "9.0.0-alpha.9",
+      "@skyux-sdk/testing": "9.0.0-alpha.9",
+      "@skyux/a11y": "9.0.0-alpha.9",
+      "@skyux/action-bars": "9.0.0-alpha.9",
+      "@skyux/ag-grid": "9.0.0-alpha.9",
+      "@skyux/angular-tree-component": "9.0.0-alpha.9",
+      "@skyux/animations": "9.0.0-alpha.9",
+      "@skyux/assets": "9.0.0-alpha.9",
+      "@skyux/autonumeric": "9.0.0-alpha.9",
+      "@skyux/avatar": "9.0.0-alpha.9",
+      "@skyux/colorpicker": "9.0.0-alpha.9",
+      "@skyux/config": "9.0.0-alpha.9",
+      "@skyux/core": "9.0.0-alpha.9",
+      "@skyux/data-manager": "9.0.0-alpha.9",
+      "@skyux/datetime": "9.0.0-alpha.9",
+      "@skyux/errors": "9.0.0-alpha.9",
+      "@skyux/flyout": "9.0.0-alpha.9",
+      "@skyux/forms": "9.0.0-alpha.9",
+      "@skyux/grids": "9.0.0-alpha.9",
+      "@skyux/http": "9.0.0-alpha.9",
+      "@skyux/i18n": "9.0.0-alpha.9",
       "@skyux/icons": "^6.0.0",
-      "@skyux/indicators": "9.0.0-alpha.7",
-      "@skyux/inline-form": "9.0.0-alpha.7",
-      "@skyux/layout": "9.0.0-alpha.7",
-      "@skyux/list-builder": "9.0.0-alpha.7",
-      "@skyux/list-builder-common": "9.0.0-alpha.7",
-      "@skyux/list-builder-view-checklist": "9.0.0-alpha.7",
-      "@skyux/list-builder-view-grids": "9.0.0-alpha.7",
-      "@skyux/lists": "9.0.0-alpha.7",
-      "@skyux/lookup": "9.0.0-alpha.7",
-      "@skyux/modals": "9.0.0-alpha.7",
-      "@skyux/navbar": "9.0.0-alpha.7",
-      "@skyux/omnibar-interop": "9.0.0-alpha.7",
-      "@skyux/pages": "9.0.0-alpha.7",
-      "@skyux/phone-field": "9.0.0-alpha.7",
-      "@skyux/popovers": "9.0.0-alpha.7",
-      "@skyux/progress-indicator": "9.0.0-alpha.7",
-      "@skyux/router": "9.0.0-alpha.7",
-      "@skyux/select-field": "9.0.0-alpha.7",
-      "@skyux/split-view": "9.0.0-alpha.7",
-      "@skyux/tabs": "9.0.0-alpha.7",
-      "@skyux/text-editor": "9.0.0-alpha.7",
-      "@skyux/theme": "9.0.0-alpha.7",
-      "@skyux/tiles": "9.0.0-alpha.7",
-      "@skyux/toast": "9.0.0-alpha.7",
-      "@skyux/validation": "9.0.0-alpha.7",
+      "@skyux/indicators": "9.0.0-alpha.9",
+      "@skyux/inline-form": "9.0.0-alpha.9",
+      "@skyux/layout": "9.0.0-alpha.9",
+      "@skyux/list-builder": "9.0.0-alpha.9",
+      "@skyux/list-builder-common": "9.0.0-alpha.9",
+      "@skyux/list-builder-view-checklist": "9.0.0-alpha.9",
+      "@skyux/list-builder-view-grids": "9.0.0-alpha.9",
+      "@skyux/lists": "9.0.0-alpha.9",
+      "@skyux/lookup": "9.0.0-alpha.9",
+      "@skyux/modals": "9.0.0-alpha.9",
+      "@skyux/navbar": "9.0.0-alpha.9",
+      "@skyux/omnibar-interop": "9.0.0-alpha.9",
+      "@skyux/pages": "9.0.0-alpha.9",
+      "@skyux/phone-field": "9.0.0-alpha.9",
+      "@skyux/popovers": "9.0.0-alpha.9",
+      "@skyux/progress-indicator": "9.0.0-alpha.9",
+      "@skyux/router": "9.0.0-alpha.9",
+      "@skyux/select-field": "9.0.0-alpha.9",
+      "@skyux/split-view": "9.0.0-alpha.9",
+      "@skyux/tabs": "9.0.0-alpha.9",
+      "@skyux/text-editor": "9.0.0-alpha.9",
+      "@skyux/theme": "9.0.0-alpha.9",
+      "@skyux/tiles": "9.0.0-alpha.9",
+      "@skyux/toast": "9.0.0-alpha.9",
+      "@skyux/validation": "9.0.0-alpha.9",
       "ag-grid-angular": "^29.3.5",
       "ag-grid-community": "^29.3.5",
       "ag-grid-enterprise": "^29.3.5",
@@ -92,7 +92,8 @@
     }
   },
   "peerDependencies": {
-    "@angular/cli": "^16.2.0"
+    "@angular/cli": "^16.2.0",
+    "@angular/core": "^16.2.1"
   },
   "dependencies": {
     "fs-extra": "10.1.0",

package/src/schematics/migrations/migration-collection.json

@@ -1,7 +1,7 @@
 {
   "schematics": {
     "noop": {
-      "version": "9.0.0-alpha.7",
+      "version": "9.0.0-alpha.9",
       "factory": "./noop/noop.schematic",
       "description": "Update all SKY UX component packages"
     },
@@ -15,10 +15,20 @@
       "factory": "./update-9/add-forms-popovers-peer-dependency/add-forms-popovers-peer-dependency.schematic",
       "description": "Add @skyux/popovers peer dependency for @skyux/forms"
     },
+    "add-compat-stylesheets": {
+      "version": "9.0.0-0",
+      "factory": "./update-9/add-compat-stylesheets/add-compat-stylesheet.schematic",
+      "description": "Add a backwards-compatible stylesheet with styles that have been removed from components in SKY UX 9."
+    },
     "ag-grid-29": {
       "version": "9.0.0-0",
       "factory": "./update-9/ag-grid-29/ag-grid-29.schematic",
       "description": "Apply changes to support AG Grid 29"
+    },
+    "legacy-services": {
+      "version": "9.0.0-0",
+      "factory": "./update-9/legacy-services/legacy-services.schematic",
+      "description": "Modal and flyout services were previously provided in 'any' but are now provided in 'root'. Replace with a 'legacy' version for backward compatibility."
     }
   }
 }

package/src/schematics/migrations/update-9/add-compat-stylesheets/add-compat-stylesheet.schematic.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from '@angular-devkit/schematics';
+export default function (): Rule;

package/src/schematics/migrations/update-9/add-compat-stylesheets/add-compat-stylesheet.schematic.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schematics_1 = require("@angular-devkit/schematics");
+const tree_1 = require("../../../utility/tree");
+const workspace_1 = require("../../../utility/workspace");
+const COMPAT_CSS_FILE_NAME = 'skyux9-compat.css';
+const compatStyles = {
+    libraries: [
+        {
+            name: '@skyux/forms',
+            components: [
+                {
+                    name: 'input box',
+                    styles: [
+                        {
+                            css: `
+:root {
+  --sky-compat-sky-form-group-margin-bottom: 10px
+}
+`,
+                            instructions: `
+The bottom margin has been removed from the  \`sky-input-box\`. To address this, remove this block of CSS and use \`stacked="true"\` to automatically have the latest vertical spacing added.`,
+                        },
+                    ],
+                },
+            ],
+        },
+        {
+            name: '@skyux/theme',
+            components: [
+                {
+                    name: 'styles',
+                    styles: [
+                        {
+                            css: `
+:root {
+  --sky-compat-sky-form-group-margin-bottom: 10px
+}
+`,
+                            instructions: `
+The bottom margin has been removed from \`sky-form-group\` style class. To address this, remove this block of css and change \`sky-form-group\` to \`sky-margin-stacked-sm\` or other appropriate spacing classes. See https://developer.blackbaud.com/skyux/design/styles/spacing for a list of supported spacing classes.`,
+                        },
+                    ],
+                },
+            ],
+        },
+    ],
+};
+function getProjectSourcePath(projectDefinition) {
+    /*istanbul ignore else*/
+    if (projectDefinition.sourceRoot) {
+        return `${projectDefinition.sourceRoot}/app`;
+    }
+    else {
+        return `${projectDefinition.root}/src/app`;
+    }
+}
+function buildCommentBlock(message) {
+    return `/${'*'.repeat(79)}
+ * ${message.replace(/(?![^\n]{1,75}$)([^\n]{1,75})\s/g, '$1\n * ')}
+ ${'*'.repeat(79)}/`;
+}
+function buildComponentCss(component) {
+    let contents = buildCommentBlock(`COMPONENT: ${component.name.toUpperCase()}`);
+    for (const style of component.styles) {
+        contents += `
+
+${buildCommentBlock(style.instructions.trim())}
+
+${style.css.trim()}
+`;
+    }
+    return contents;
+}
+function writeStylesheet(sourceRoot, contents) {
+    const filePath = `${sourceRoot}/${COMPAT_CSS_FILE_NAME}`;
+    return (tree) => {
+        if (tree.exists(filePath)) {
+            tree.overwrite(filePath, contents);
+        }
+        else {
+            tree.create(filePath, contents);
+        }
+    };
+}
+function addStylesheetToWorkspace() {
+    return () => (0, workspace_1.updateWorkspace)((workspace) => {
+        for (const project of workspace.projects.values()) {
+            for (const targetName of ['build', 'test']) {
+                if (project.extensions['projectType'] === 'application') {
+                    const target = project.targets.get(targetName);
+                    const sourceRoot = getProjectSourcePath(project);
+                    const filePath = `${sourceRoot}/${COMPAT_CSS_FILE_NAME}`;
+                    /* istanbul ignore else */
+                    if (target && target.options) {
+                        const styles = (target.options['styles'] = (target.options['styles'] || []));
+                        if (!styles.includes(filePath)) {
+                            styles.push(filePath);
+                        }
+                    }
+                }
+            }
+        }
+    });
+}
+function getCompatStyles(tree) {
+    let contents = '';
+    const packageJson = JSON.parse((0, tree_1.readRequiredFile)(tree, '/package.json'));
+    for (const library of compatStyles.libraries) {
+        if (packageJson.dependencies?.[library.name] ||
+            packageJson.devDependencies?.[library.name]) {
+            for (const component of library.components) {
+                contents += `
+${buildComponentCss(component)}`;
+            }
+        }
+    }
+    return contents
+        ? `${buildCommentBlock(`TODO: The following component libraries introduced visual breaking changes in SKY UX 9. Each block of CSS reintroduces the styles that were changed or removed for backwards compatibility. You will need to do the following before migrating to the next major version of SKY UX:
+- Address each of the changes by following the instructions
+  in each block of CSS, then remove the block.
+- Delete this file after all blocks have been addressed.
+- Remove each occurrence of this file in your project's
+  angular.json file.`)}
+${contents}`
+        : undefined;
+}
+function default_1() {
+    return async (tree) => {
+        const { workspace } = await (0, workspace_1.getWorkspace)(tree);
+        const styles = getCompatStyles(tree);
+        const rules = [];
+        for (const [, projectDefinition] of workspace.projects.entries()) {
+            if (projectDefinition.extensions['projectType'] === 'application') {
+                if (styles) {
+                    const sourcePath = getProjectSourcePath(projectDefinition);
+                    rules.push(writeStylesheet(sourcePath, styles));
+                }
+            }
+        }
+        if (styles) {
+            rules.push(addStylesheetToWorkspace());
+        }
+        return (0, schematics_1.chain)(rules);
+    };
+}
+exports.default = default_1;
+//# sourceMappingURL=add-compat-stylesheet.schematic.js.map

package/src/schematics/migrations/update-9/add-compat-stylesheets/add-compat-stylesheet.schematic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-compat-stylesheet.schematic.js","sourceRoot":"","sources":["../../../../../../../../../libs/components/packages/src/schematics/migrations/update-9/add-compat-stylesheets/add-compat-stylesheet.schematic.ts"],"names":[],"mappings":"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"}

package/src/schematics/migrations/update-9/legacy-services/legacy-services.schematic.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The contents of this file are heavily inspired by Angular's "untyped forms" migration.
+ * @see https://github.com/angular/angular/blob/14.3.x/packages/core/schematics/migrations/typed-forms/index.ts
+ */
+import { Rule } from '@angular-devkit/schematics';
+/**
+ * Replaces certain SKY UX services with their "legacy" equivalents.
+ * For example, `SkyModalService` becomes `SkyModalLegacyService`.
+ */
+export default function (): Rule;

package/src/schematics/migrations/update-9/legacy-services/legacy-services.schematic.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tree_1 = require("../../../utility/tree");
+const imports_1 = require("../../../utility/typescript/imports");
+const source_file_1 = require("../../../utility/typescript/source-file");
+const workspace_1 = require("../../../utility/workspace");
+// A collection of services (and their packages) that should be replaced with "legacy" versions.
+const packages = new Map([
+    ['@skyux/core', ['SkyDynamicComponentService', 'SkyOverlayService']],
+    ['@skyux/flyout', ['SkyFlyoutService']],
+    ['@skyux/modals', ['SkyModalService']],
+    ['@skyux/toast', ['SkyToastService']],
+]);
+function runLegacyServicesMigration(tree, filePath) {
+    const sourceFile = (0, source_file_1.createSourceFile)(filePath, (0, tree_1.readRequiredFile)(tree, filePath));
+    let update = null;
+    const rewriter = (startPos, origLength, text) => {
+        if (update === null) {
+            // Lazily initialize update, because most files will not require migration.
+            update = tree.beginUpdate(sourceFile.fileName);
+        }
+        update.remove(startPos, origLength);
+        update.insertLeft(startPos, text);
+    };
+    const imports = (0, imports_1.getImports)(sourceFile, packages);
+    // If no relevant classes are imported, we can exit early.
+    if (imports.length === 0) {
+        return;
+    }
+    // For each control class, migrate all of its uses.
+    for (const imp of imports) {
+        const usages = (0, imports_1.getUsages)(sourceFile, imp);
+        for (const usage of usages) {
+            const newName = getLegacyVersionOfName(imp.getText(sourceFile));
+            if (newName) {
+                rewriter(usage.node.getStart(sourceFile), usage.node.getWidth(sourceFile), newName);
+            }
+        }
+    }
+    // For each imported control class, migrate to the corresponding legacy import.
+    for (const imp of imports) {
+        // If the import specifier has a property name, use that instead (for example, `import {PropertyName as Foo}`).
+        const item = imp.propertyName ?? imp;
+        rewriter(item.getStart(sourceFile), item.getWidth(sourceFile), getLegacyVersionOfName(item.getText(sourceFile)));
+    }
+    if (update) {
+        tree.commitUpdate(update);
+    }
+}
+function getLegacyVersionOfName(name) {
+    return name.replace(/(?:Service)$/, 'LegacyService');
+}
+/**
+ * Replaces certain SKY UX services with their "legacy" equivalents.
+ * For example, `SkyModalService` becomes `SkyModalLegacyService`.
+ */
+function default_1() {
+    return async (tree) => {
+        const { workspace } = await (0, workspace_1.getWorkspace)(tree);
+        workspace.projects.forEach((project) => {
+            tree.getDir(project.root).visit((filePath) => {
+                if (filePath.endsWith('.ts') && !filePath.includes('node_modules')) {
+                    runLegacyServicesMigration(tree, filePath);
+                }
+            });
+        });
+    };
+}
+exports.default = default_1;
+//# sourceMappingURL=legacy-services.schematic.js.map

package/src/schematics/migrations/update-9/legacy-services/legacy-services.schematic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-services.schematic.js","sourceRoot":"","sources":["../../../../../../../../../libs/components/packages/src/schematics/migrations/update-9/legacy-services/legacy-services.schematic.ts"],"names":[],"mappings":"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"}

package/src/schematics/utility/typescript/imports.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The contents of this file are heavily inspired by Angular's source code.
+ * @see https://github.com/angular/angular/blob/14.3.x/packages/core/schematics/utils/typescript/imports.ts
+ */
+import * as ts from '@schematics/angular/third_party/github.com/Microsoft/TypeScript/lib/typescript';
+export interface ImportUsage {
+    node: ts.Node;
+    importName: string;
+}
+export declare function getImports(sourceFile: ts.SourceFile, packages: Map<string, string[]>): ts.ImportSpecifier[];
+export declare function getUsages(sourceFile: ts.SourceFile, importSpecifier: ts.ImportSpecifier): ImportUsage[];

package/src/schematics/utility/typescript/imports.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUsages = exports.getImports = void 0;
+const tslib_1 = require("tslib");
+/**
+ * The contents of this file are heavily inspired by Angular's source code.
+ * @see https://github.com/angular/angular/blob/14.3.x/packages/core/schematics/utils/typescript/imports.ts
+ */
+const ts = tslib_1.__importStar(require("@schematics/angular/third_party/github.com/Microsoft/TypeScript/lib/typescript"));
+function getImports(sourceFile, packages) {
+    const importSpecifiers = [];
+    for (const [packageName, classes] of packages.entries()) {
+        for (const cc of classes) {
+            const specifiers = getImportSpecifiers(sourceFile, packageName, cc);
+            if (specifiers) {
+                importSpecifiers.push(...specifiers);
+            }
+        }
+    }
+    return importSpecifiers;
+}
+exports.getImports = getImports;
+function getUsages(sourceFile, importSpecifier) {
+    const usages = [];
+    const visitNode = (node) => {
+        // Skip this node and all of its children; imports are a special case.
+        if (ts.isImportSpecifier(node)) {
+            return;
+        }
+        const importName = importSpecifier.getText(sourceFile);
+        if (ts.isIdentifier(node) && node.escapedText === importName) {
+            usages.push({ node, importName });
+        }
+        ts.forEachChild(node, visitNode);
+    };
+    ts.forEachChild(sourceFile, visitNode);
+    return usages;
+}
+exports.getUsages = getUsages;
+/**
+ * Gets top-level import specifiers with a specific name that is imported from a particular module.
+ * E.g. given a file that looks like:
+ *
+ * ```
+ * import { Component, Directive } from '@angular/core';
+ * import { Foo } from './foo';
+ * ```
+ *
+ * Calling `getImportSpecifiers(sourceFile, '@angular/core', 'Directive')` will yield the nodes
+ * referring to `Directive` in the top import.
+ *
+ * @param sourceFile File in which to look for imports.
+ * @param moduleName Name of the import's module.
+ * @param specifierName Original name of the specifier to look for. Aliases will be resolved to
+ *    their original name.
+ */
+function getImportSpecifiers(sourceFile, moduleName, specifierName) {
+    const importSpecifiers = [];
+    for (const node of sourceFile.statements) {
+        if (ts.isImportDeclaration(node) &&
+            ts.isStringLiteral(node.moduleSpecifier) &&
+            node.moduleSpecifier.text === moduleName) {
+            const namedBindings = node.importClause && node.importClause.namedBindings;
+            if (namedBindings && ts.isNamedImports(namedBindings)) {
+                const match = findImportSpecifier(namedBindings.elements, specifierName);
+                if (match) {
+                    importSpecifiers.push(match);
+                }
+            }
+        }
+    }
+    return importSpecifiers;
+}
+/**
+ * Finds an import specifier with a particular name.
+ */
+function findImportSpecifier(nodes, specifierName) {
+    return nodes.find((element) => {
+        const { name, propertyName } = element;
+        return propertyName?.text === specifierName || name.text === specifierName;
+    });
+}
+//# sourceMappingURL=imports.js.map

package/src/schematics/utility/typescript/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../../../../../../../libs/components/packages/src/schematics/utility/typescript/imports.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,2HAAqG;AAOrG,SAAgB,UAAU,CACxB,UAAyB,EACzB,QAA+B;IAE/B,MAAM,gBAAgB,GAAyB,EAAE,CAAC;IAElD,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE;QACvD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE;YACxB,MAAM,UAAU,GAAG,mBAAmB,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YAEpE,IAAI,UAAU,EAAE;gBACd,gBAAgB,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;aACtC;SACF;KACF;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAjBD,gCAiBC;AAED,SAAgB,SAAS,CACvB,UAAyB,EACzB,eAAmC;IAEnC,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,MAAM,SAAS,GAAG,CAAC,IAAa,EAAE,EAAE;QAClC,sEAAsE;QACtE,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE;YAC9B,OAAO;SACR;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEvD,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE;YAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;SACnC;QAED,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAxBD,8BAwBC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,mBAAmB,CAC1B,UAAyB,EACzB,UAAkB,EAClB,aAAqB;IAErB,MAAM,gBAAgB,GAAyB,EAAE,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,UAAU,EAAE;QACxC,IACE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;YAC5B,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC;YACxC,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,UAAU,EACxC;YACA,MAAM,aAAa,GACjB,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;YAEvD,IAAI,aAAa,IAAI,EAAE,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE;gBACrD,MAAM,KAAK,GAAG,mBAAmB,CAC/B,aAAa,CAAC,QAAQ,EACtB,aAAa,CACd,CAAC;gBAEF,IAAI,KAAK,EAAE;oBACT,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;iBAC9B;aACF;SACF;KACF;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,KAAuC,EACvC,aAAqB;IAErB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAEvC,OAAO,YAAY,EAAE,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/src/schematics/utility/typescript/source-file.d.ts

@@ -0,0 +1,2 @@
+import * as ts from '@schematics/angular/third_party/github.com/Microsoft/TypeScript/lib/typescript';
+export declare function createSourceFile(filePath: string, fileContents: string): ts.SourceFile;

package/src/schematics/utility/typescript/source-file.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSourceFile = void 0;
+const tslib_1 = require("tslib");
+const ts = tslib_1.__importStar(require("@schematics/angular/third_party/github.com/Microsoft/TypeScript/lib/typescript"));
+function createSourceFile(filePath, fileContents) {
+    return ts.createSourceFile(filePath, fileContents, ts.ScriptTarget.Latest, false, ts.ScriptKind.TS);
+}
+exports.createSourceFile = createSourceFile;
+//# sourceMappingURL=source-file.js.map

package/src/schematics/utility/typescript/source-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.js","sourceRoot":"","sources":["../../../../../../../../libs/components/packages/src/schematics/utility/typescript/source-file.ts"],"names":[],"mappings":";;;;AAAA,2HAAqG;AAErG,SAAgB,gBAAgB,CAC9B,QAAgB,EAChB,YAAoB;IAEpB,OAAO,EAAE,CAAC,gBAAgB,CACxB,QAAQ,EACR,YAAY,EACZ,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,KAAK,EACL,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;AACJ,CAAC;AAXD,4CAWC"}