@koobiq/components 21.0.1 → 21.1.0

package/schematics/migrations/deprecated-icons/index.cjs

@@ -7,13 +7,13 @@ var utils_angularParsing = require('../../utils/angular-parsing.cjs');
 var utils_iconMigration = require('../../utils/icon-migration.cjs');
 var utils_messages = require('../../utils/messages.cjs');
 var utils_packageConfig = require('../../utils/package-config.cjs');
+var utils_projectFiles = require('../../utils/project-files.cjs');
 var migrations_deprecatedIcons_data = require('./data.cjs');
 require('typescript');
 require('../../utils/ast.cjs');
 require('../../utils/typescript.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
-require('../../utils/project-files.cjs');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -38,30 +38,20 @@ const iconsFontImportRule = "@use '@koobiq/icons/fonts/kbq-icons';";
 const migrationData = {
     valueAttrs: ['kbq-icon', 'kbq-icon-item', 'kbq-icon-button'],
     scope: migrations_deprecatedIcons_data.scope,
-    scopeClassInList: 'remove',
+    scopeClassInList: 'rename',
+    scopeClassOnIconHost: 'remove',
     icons: migrations_deprecatedIcons_data.iconsMapping.map(({ replace, replaceWith }) => ({ from: replace, to: replaceWith })),
     rescopeUnknownValues: true
 };
 function deprecatedIcons(options) {
-    let targetDir;
     return async (tree, context) => {
         const { project, fix, stylesExt } = options;
-        try {
-            const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
-            targetDir = projectDefinition ? tree.getDir(projectDefinition.root) : tree;
-        }
-        catch {
-            targetDir = tree;
-        }
+        const targetDir = await utils_packageConfig.resolveTargetDir(project, tree);
         const { logger } = context;
         const tokenMap = utils_iconMigration.buildIconTokenMap(migrationData);
-        // Unlike a `class` list (where the bare scope token is simply dropped, e.g.
-        // `class="pt-icons"` -> `class=""`), a stylesheet selector renames the scope class itself
-        // (e.g. `.pt-icons` -> `.kbq`) rather than removing it.
-        const styleTokenMap = new Map(tokenMap).set(migrationData.scope.from, migrationData.scope.to);
         // Precompiled once and reused across every .ts/style file below, instead of rebuilding
         // every regex per file.
-        const stylePatterns = utils_iconMigration.buildIconTokenPatterns(styleTokenMap, migrationData.scope.from);
+        const stylePatterns = utils_iconMigration.buildIconTokenPatterns(tokenMap, migrationData.scope.from);
         const onFound = (filePath, found) => {
             const parsedFilePath = path__namespace.relative(__dirname, `.${filePath}`).replace(/\\/g, '/');
             utils_messages.logMessage(logger, [
@@ -74,11 +64,7 @@ function deprecatedIcons(options) {
         const templatePaths = [];
         const tsPaths = [];
         const stylePaths = [];
-        // if project property not provided, skip files in node_modules & dist
-        targetDir.visit((filePath) => {
-            if (filePath.includes('node_modules') || filePath.includes('/dist/')) {
-                return;
-            }
+        utils_projectFiles.visitProjectFiles(targetDir, (filePath) => {
             if (filePath.endsWith('.html')) {
                 templatePaths.push(filePath);
             }
@@ -110,8 +96,8 @@ function deprecatedIcons(options) {
             }
         }
         // check if icon styles from new scope should be included in styles file
-        targetDir.visit((filePath, entry) => {
-            if (filePath.endsWith(stylesExt) && !entry?.content.toString()?.includes(iconsFontImportRule)) {
+        utils_projectFiles.visitProjectFiles(targetDir, (filePath, entry) => {
+            if (filePath.endsWith(stylesExt) && !entry.content.toString()?.includes(iconsFontImportRule)) {
                 const parsedFilePath = path__namespace.relative(__dirname, `.${filePath}`).replace(/\\/g, '/');
                 utils_messages.logMessage(logger, [
                     parsedFilePath,

package/schematics/migrations/deprecated-icons/schema.json

@@ -6,7 +6,7 @@
     "properties": {
         "project": {
             "type": "string",
-            "description": "Name of the project",
+            "description": "Name of the project, or a folder to migrate (e.g. ./libs). Without it the whole workspace is migrated",
             "$default": {
                 "$source": "projectName"
             }

package/schematics/migrations/icons-replacement/README.md

@@ -6,6 +6,20 @@ This schematic provides migration for new icons naming attribute. It includes:
 
 [Params](schema.ts)
 
+`--project` takes a project name or a folder such as `./libs`; without it the whole workspace is migrated.
+`node_modules` and `dist` are always skipped.
+
+The built-in mapping applies unless `--custom-data-path` points at a JSON file of your own, resolved from the
+workspace root (then as an absolute path); a missing file stops the run. The shape is the one `new-icons-pack`
+reads; a name matches anywhere it occurs, so it can be written with or without the `kbq-` prefix:
+
+```json
+[{ "replace": "bolt-circle_16", "replaceWith": "circle-bolt_16" }]
+```
+
+`--replacement-data-path` is the deprecated name of the option: it still works, resolved from the project root
+or the folder first, and so do files of `{ "from", "to" }` pairs; both print a warning.
+
 #### Usage for Angular Cli:
 
 Apply for project and log file path and icon name should be replaced
@@ -17,7 +31,7 @@ ng g @koobiq/components:icons-replacement --project "<your project>"
 - with custom icon replacement mapping:
 
 ```shell
-ng g @koobiq/components:icons-replacement --project "<your project>" --replacement-data-path "<path-as-json>"
+ng g @koobiq/components:icons-replacement --project "<your project>" --custom-data-path "<path-as-json>"
 ```
 
 Apply for project and replace icon name.
@@ -35,7 +49,7 @@ nx g @koobiq/components:icons-replacement --project "<your project>"
 - with custom icon replacement mapping:
 
 ```shell
-nx g @koobiq/components:icons-replacement --project "<your project>" --replacement-data-path "<path-as-json>"
+nx g @koobiq/components:icons-replacement --project "<your project>" --custom-data-path "<path-as-json>"
 ```
 
 ### Run locally

package/schematics/migrations/icons-replacement/index.cjs

@@ -3,12 +3,14 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var path = require('path');
+var utils_customData = require('../../utils/custom-data.cjs');
 var utils_messages = require('../../utils/messages.cjs');
 var utils_packageConfig = require('../../utils/package-config.cjs');
+var utils_projectFiles = require('../../utils/project-files.cjs');
 var migrations_iconsReplacement_data = require('./data.cjs');
 require('@angular-devkit/schematics');
+require('fs');
 require('@schematics/angular/utility');
-require('../../utils/project-files.cjs');
 
 const replaceIcons = (contentToBeUpdated, replacementData) => {
     let res = contentToBeUpdated;
@@ -43,24 +45,25 @@ const processIconReplacement = ({ fileContent, filePath, fix, logger, replacemen
         return { fileContent, changed: false, errors: [] };
     }
 };
-const resolveReplacementData = (projectRootPath, tree, customReplacementDataPath) => {
-    if (customReplacementDataPath) {
-        const replacementData = tree.get(`${projectRootPath}/${customReplacementDataPath}`);
-        if (!replacementData)
-            return migrations_iconsReplacement_data.iconReplacementData;
-        return JSON.parse(replacementData.content.toString());
-    }
-    return migrations_iconsReplacement_data.iconReplacementData;
-};
 function migrate(options) {
     return async (tree, context) => {
         const { logger } = context;
-        const { project, allowed, fix, replacementDataPath } = options;
-        const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
-        const replacementData = resolveReplacementData(projectDefinition.root, tree, replacementDataPath);
-        tree.getDir(projectDefinition.root).visit((filePath, entry) => {
+        const { project, allowed, fix, customDataPath, replacementDataPath } = options;
+        const targetDir = await utils_packageConfig.resolveTargetDir(project, tree);
+        if (replacementDataPath && customDataPath) {
+            logger.warn('--replacement-data-path is deprecated and ignored next to --custom-data-path.');
+        }
+        const dataPath = customDataPath ?? replacementDataPath;
+        const bases = customDataPath ? undefined : [targetDir.path, '/'];
+        const replacementData = dataPath
+            ? utils_customData.readCustomIconMapping(tree, dataPath, logger, bases)
+            : migrations_iconsReplacement_data.iconReplacementData;
+        logger.info(dataPath
+            ? `Icon mapping: ${replacementData.length} entries from '${dataPath}'.`
+            : `Icon mapping: the built-in one, ${replacementData.length} entries (--custom-data-path overrides it).`);
+        utils_projectFiles.visitProjectFiles(targetDir, (filePath, entry) => {
             if (allowed.length === 0 || allowed.some((ext) => filePath.endsWith(ext))) {
-                const initialContent = entry?.content.toString();
+                const initialContent = entry.content.toString();
                 if (!initialContent)
                     return;
                 const { fileContent, changed } = processIconReplacement({
@@ -82,4 +85,3 @@ exports.default = migrate;
 exports.logReplacement = logReplacement;
 exports.processIconReplacement = processIconReplacement;
 exports.replaceIcons = replaceIcons;
-exports.resolveReplacementData = resolveReplacementData;

package/schematics/migrations/icons-replacement/schema.json

@@ -6,7 +6,7 @@
     "properties": {
         "project": {
             "type": "string",
-            "description": "Name of the project",
+            "description": "Name of the project, or a folder to migrate (e.g. ./libs). Without it the whole workspace is migrated",
             "$default": {
                 "$source": "projectName"
             }
@@ -18,15 +18,24 @@
         },
         "allowed": {
             "type": "array",
-            "default": [".html", ".ts", ".scss"],
+            "default": [
+                ".html",
+                ".ts",
+                ".scss"
+            ],
             "items": {
                 "type": "string"
             },
             "description": "Allowed file extensions to check"
         },
+        "customDataPath": {
+            "type": "string",
+            "description": "JSON file with an icon mapping that replaces the built-in one, an array of { \"replace\": \"<old>\", \"replaceWith\": \"<new>\" }, resolved from the workspace root"
+        },
         "replacementDataPath": {
             "type": "string",
-            "description": "Custom replacement data path. Will be used as relative to `project.root`"
+            "description": "Deprecated, use customDataPath. Resolved from the project root or the folder first",
+            "x-deprecated": "Use --custom-data-path, resolved from the workspace root."
         }
     }
 }

package/schematics/migrations/new-icons-pack/README.md

@@ -3,7 +3,9 @@
 This schematic provides migration for update icons pack. It includes:
 
 - Change prefixes from `mc` to `kbq` for TS, HTML, and styles
-- Update icon names for updated/removed icons according to [mapping](data.ts)
+- Update icon names for updated/removed icons according to [mapping](data.ts), in the values of `kbq-icon`,
+  `kbq-icon-item`, `kbq-icon-button` and of their `mc-*` counterparts (`mc-icon="mc-search_16"` →
+  `mc-icon="kbq-magnifying-glass_16"`; the attribute names themselves are left alone)
 - Fix icons package prefix in styles
 - Optionally use custom migration and replacement data
 
@@ -27,16 +29,32 @@ and can still be rewritten.
 regardless of `updatePrefix`; the option only gates the _bare_ scope-word rename (`mc` → `kbq`) there. In
 templates/TS, icon-attribute values are always matched regardless of `updatePrefix`.
 
-#### `--custom-icon-replacement-path`
+#### Data
 
-The expected file shape changed. It's still a JSON array of `{ "replace": ..., "replaceWith": ... }` objects,
-but each entry is now interpreted as a bare scope-word pair (e.g. `{ "replace": "mc", "replaceWith": "kbq" }`,
-with no leading/trailing hyphen) rather than a whole-file regex fragment like `kbq-icon="mc-` — the AST-based
-matcher no longer needs per-context fragments. A file still written in the old fragment style, or a malformed
-one, is detected and ignored with a warning (falling back to the default `mc` → `kbq` scope) rather than being
-silently misapplied or crashing. [`replacement.json`](replacement.json) is kept in its old fragment shape for
-backward compatibility with anyone already pointing at it — **don't** pass it via `--custom-icon-replacement-path`
-as-is (see the fallback warning above); copy it into your own file and rewrite it in the new shape instead.
+Everything the migration needs is built in: the icon-name mapping ([`data.ts`](data.ts)) and the `mc` → `kbq`
+scope. Run it without the custom-data options — the log says which data it runs on. The options are for a
+mapping or a scope of your own, not for passing the shipped files back in.
+
+`--custom-data-path` takes the icon-name mapping, an array of `replace`/`replaceWith` pairs written with the
+`kbq-` prefix (the `mc-` form of each name is matched as well):
+
+```json
+[{ "replace": "kbq-add-to-list_16", "replaceWith": "kbq-file-plus-o_16" }]
+```
+
+The same option and shape are read by `icons-replacement`. A file of `{ "from", "to" }` pairs, the shape
+`icons-replacement` used to read, is still accepted with a warning.
+
+`--custom-icon-replacement-path` takes the scope pair, bare words with no hyphen:
+
+```json
+[{ "replace": "mc", "replaceWith": "kbq" }]
+```
+
+[`migration.json`](migration.json) and [`replacement.json`](replacement.json) hold the built-in data in these
+shapes, so they can be copied as a starting point. A path is resolved from the workspace root first, then as an
+absolute path or one relative to the current directory; a missing file stops the run. A scope file still
+written in the old fragment shape (`kbq-icon="mc-`) is ignored with a warning, and the built-in scope applies.
 
 ---
 
@@ -48,20 +66,17 @@ The schematic supports the following options:
   Applies fixes automatically without prompting.
 
 - **`--project`** (`string`)
-  Target Angular/Nx project name.
+  Target Angular/Nx project name, or a folder such as `./libs`. Without it the whole workspace is migrated;
+  `node_modules` and `dist` are always skipped.
 
 - **`--update-prefix`** (`boolean`)
   Whether to change icon prefixes during migration.
 
 - **`--custom-data-path`** (`string`)
-  Path to a custom migration data file.
-  When provided, use `migration.json` file as a default.
-  Use this option if you want to override the default icon mapping data.
+  JSON file with an icon-name mapping that replaces the built-in one (see [Data](#data)).
 
 - **`--custom-icon-replacement-path`** (`string`)
-  Path to a custom icon attributes replacement file.
-  When provided, use `replacement.json` file as a default.
-  Use this option to customize how icon attributes are replaced during migration.
+  JSON file with a scope pair that replaces the built-in `mc` → `kbq` (see [Data](#data)).
 
 The schema definition can be found in [`schema.ts`](schema.ts).
 
@@ -71,22 +86,19 @@ The schema definition can be found in [`schema.ts`](schema.ts).
 
 ```shell
 ng g @koobiq/components:new-icons-pack --fix=true --project "<your project>"
+ng g @koobiq/components:new-icons-pack --fix=true --project ./libs
 ```
 
 #### Angular CLI with custom data
 
 ```shell
 ng g @koobiq/components:new-icons-pack \
-    --custom-data-path migration.json \
-    --custom-icon-replacement-path my-replacement.json \
+    --custom-data-path my-icons.json \
+    --custom-icon-replacement-path my-scope.json \
     --fix=true \
     --project "<your-project>"
 ```
 
-`migration.json` is the shipped icon-name mapping and can be used as-is. `my-replacement.json` is a file you
-write yourself, in the new bare scope-word-pair shape described above — **not** the shipped
-[`replacement.json`](replacement.json), which is still in the legacy shape.
-
 #### Nx
 
 ```shell
@@ -97,8 +109,8 @@ nx g @koobiq/components:new-icons-pack --fix=true --project "<your project>"
 
 ```shell
 nx g @koobiq/components:new-icons-pack \
-    --custom-data-path migration.json \
-    --custom-icon-replacement-path my-replacement.json \
+    --custom-data-path my-icons.json \
+    --custom-icon-replacement-path my-scope.json \
     --fix=true \
     --project "<your-project>"
 ```

package/schematics/migrations/new-icons-pack/index.cjs

@@ -2,19 +2,20 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var fs = require('fs');
 var path = require('path');
 var utils_angularParsing = require('../../utils/angular-parsing.cjs');
+var utils_customData = require('../../utils/custom-data.cjs');
 var utils_iconMigration = require('../../utils/icon-migration.cjs');
 var utils_messages = require('../../utils/messages.cjs');
 var utils_packageConfig = require('../../utils/package-config.cjs');
+var utils_projectFiles = require('../../utils/project-files.cjs');
 var migrations_newIconsPack_data = require('./data.cjs');
 require('typescript');
 require('../../utils/ast.cjs');
 require('../../utils/typescript.cjs');
 require('@angular-devkit/schematics');
+require('fs');
 require('@schematics/angular/utility');
-require('../../utils/project-files.cjs');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -35,11 +36,6 @@ function _interopNamespaceDefault(e) {
 
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 
-function readJsonFile(filePath) {
-    const absolutePath = path__namespace.resolve(filePath);
-    const fileContents = fs.readFileSync(absolutePath, 'utf-8');
-    return JSON.parse(fileContents);
-}
 // A bare word: no leading/trailing hyphen, no empty hyphen-separated segment (rejects e.g. `mc-`,
 // which is otherwise the most natural — and wrong, per the new engine's key-building — way to
 // write a "prefix" pair).
@@ -85,32 +81,35 @@ function resolveScope(entries, fallback, logger) {
     return { from: valid.replace, to: valid.replaceWith };
 }
 function newIconsPack(options) {
-    let targetDir;
     return async (tree, context) => {
         const { project, fix, stylesExt, updatePrefix = true, customDataPath, customIconReplacementPath } = options;
         const { logger } = context;
-        const resolvedData = customDataPath ? readJsonFile(customDataPath) : migrations_newIconsPack_data.newIconsPackData;
+        const resolvedData = customDataPath
+            ? utils_customData.readCustomIconMapping(tree, customDataPath, logger)
+            : migrations_newIconsPack_data.newIconsPackData.map(({ replace, replaceWith }) => ({ from: replace, to: replaceWith }));
         const resolvedScope = customIconReplacementPath
-            ? resolveScope(readJsonFile(customIconReplacementPath), migrations_newIconsPack_data.scope, logger)
+            ? resolveScope(utils_customData.readCustomJson(tree, customIconReplacementPath), migrations_newIconsPack_data.scope, logger)
             : migrations_newIconsPack_data.scope;
-        try {
-            const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
-            targetDir = projectDefinition ? tree.getDir(projectDefinition.root) : tree;
-        }
-        catch {
-            targetDir = tree;
-        }
+        logger.info([
+            customDataPath
+                ? `Icon mapping: ${resolvedData.length} entries from '${customDataPath}'.`
+                : `Icon mapping: the built-in one, ${resolvedData.length} entries (--custom-data-path overrides it).`,
+            customIconReplacementPath
+                ? `Scope: ${resolvedScope.from} -> ${resolvedScope.to}, from '${customIconReplacementPath}'.`
+                : `Scope: ${resolvedScope.from} -> ${resolvedScope.to}, the built-in one (--custom-icon-replacement-path overrides it).`
+        ].join('\n'));
+        const targetDir = await utils_packageConfig.resolveTargetDir(project, tree);
         const migrationData = {
-            valueAttrs: ['kbq-icon', 'kbq-icon-item', 'kbq-icon-button'],
+            valueAttrs: ['kbq-icon', 'kbq-icon-item', 'kbq-icon-button', 'mc-icon', 'mc-icon-item', 'mc-icon-button'],
             scope: resolvedScope,
             scopeClassInList: 'rename',
             // `replace`/`replaceWith` are always authored under `CANONICAL_ICON_DATA_SCOPE`
             // ('kbq-'), regardless of the scope this run is migrating *to* — falls back to
             // stripping the target scope for a custom data file that doesn't follow that
             // convention.
-            icons: resolvedData.map(({ replace, replaceWith }) => ({
-                from: stripScopePrefix(replace, [CANONICAL_ICON_DATA_SCOPE, resolvedScope.to, resolvedScope.from]),
-                to: stripScopePrefix(replaceWith, [CANONICAL_ICON_DATA_SCOPE, resolvedScope.to])
+            icons: resolvedData.map(({ from, to }) => ({
+                from: stripScopePrefix(from, [CANONICAL_ICON_DATA_SCOPE, resolvedScope.to, resolvedScope.from]),
+                to: stripScopePrefix(to, [CANONICAL_ICON_DATA_SCOPE, resolvedScope.to])
             })),
             // Only the attribute-value path (`kbq-icon="mc-<anything>"`) rescopes suffixes that
             // aren't a known icon name; class lists/bindings/strings/styles stay exact-token-only.
@@ -145,11 +144,7 @@ function newIconsPack(options) {
         const tsPaths = [];
         const markdownPaths = [];
         // Update templates & components
-        targetDir.visit((filePath) => {
-            // if project property not provided, skip files in node_modules & dist
-            if (filePath.includes('node_modules') || filePath.includes('/dist/')) {
-                return;
-            }
+        utils_projectFiles.visitProjectFiles(targetDir, (filePath) => {
             if (filePath.endsWith('.html')) {
                 templatePaths.push(filePath);
             }
@@ -181,12 +176,7 @@ function newIconsPack(options) {
         }
         // update styles — icon-name renames always apply; `updatePrefix` only adds the bare
         // scope-word rename (see `styleAndMarkdownTokenMap` above).
-        targetDir.visit((filePath) => {
-            // if project property not provided, styles in node_modules are still skipped, same as
-            // every other file type above
-            if (filePath.includes('node_modules')) {
-                return;
-            }
+        utils_projectFiles.visitProjectFiles(targetDir, (filePath) => {
             if (!filePath.endsWith(stylesExt)) {
                 return;
             }

package/schematics/migrations/new-icons-pack/replacement.json

@@ -1,18 +1,6 @@
 [
     {
-        "replace": "class=\"mc mc-icon",
-        "replaceWith": "class=\"kbq mc-icon"
-    },
-    {
-        "replace": "class=\"mc ",
-        "replaceWith": "class=\"kbq "
-    },
-    {
-        "replace": "class: 'mc mc-icon",
-        "replaceWith": "class: 'kbq mc-icon"
-    },
-    {
-        "replace": " mc ",
-        "replaceWith": " kbq "
+        "replace": "mc",
+        "replaceWith": "kbq"
     }
 ]

package/schematics/migrations/new-icons-pack/schema.json

@@ -6,7 +6,7 @@
     "properties": {
         "project": {
             "type": "string",
-            "description": "Name of the project",
+            "description": "Name of the project, or a folder to migrate (e.g. ./libs). Without it the whole workspace is migrated",
             "$default": {
                 "$source": "projectName"
             }
@@ -28,11 +28,11 @@
         },
         "customDataPath": {
             "type": "string",
-            "description": "Use this option to specify styles extension preferred in your project"
+            "description": "JSON file with the icon mapping, an array of { \"replace\": \"kbq-<old>\", \"replaceWith\": \"kbq-<new>\" }, relative to the workspace root. Without it the built-in mapping is used"
         },
         "customIconReplacementPath": {
             "type": "string",
-            "description": "Use this option to specify styles extension preferred in your project"
+            "description": "JSON file with the scope pair, [{ \"replace\": \"mc\", \"replaceWith\": \"kbq\" }], relative to the workspace root. Without it the scope is mc -> kbq"
         }
     }
 }

package/schematics/ng-add/index.cjs

@@ -62,7 +62,7 @@ function ssrSuggestion() {
 function fontsSuggestion() {
     return [
         'Koobiq recommends the Inter and JetBrains Mono fonts.',
-        'See https://koobiq.io/en/main/typography for installation options (Fontsource or Google Fonts CDN).'
+        'See https://koobiq.io/en/main/typography for installation options (npm packages or self-hosted files).'
     ];
 }
 
@@ -184,15 +184,15 @@ function ngAdd(options) {
         }
         // Installing dependencies
         utils_packageConfig.addPackageToPackageJson(tree, '@angular/cdk', "^21.2.14");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/angular-luxon-adapter', "^21.0.1");
+        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/angular-luxon-adapter', "^21.1.0");
         // `@koobiq/angular-luxon-adapter` is a wrapper: it extends `LuxonDateAdapter` from the base
         // package and re-exports its formats, both as value imports. That makes the base a mandatory
         // peer of the wrapper, and installing a package without its mandatory peers only works on
         // npm — Yarn leaves them out, so the application ends up unable to resolve the adapter.
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/luxon-date-adapter', "^3.5.1");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/date-formatter', "^3.5.1");
+        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/date-formatter', "^3.7.0");
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/date-adapter', "^3.5.1");
-        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/icons', "^12.4.0");
+        utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/icons', "^12.5.0");
         utils_packageConfig.addPackageToPackageJson(tree, '@koobiq/design-tokens', "^4.1.0");
         utils_packageConfig.addPackageToPackageJson(tree, 'luxon', "^3.7.2");
         // `overlayscrollbars` is a mandatory peer too: `@koobiq/components/scrollbar` imports it

package/schematics/utils/custom-data.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var schematics = require('@angular-devkit/schematics');
+var fs = require('fs');
+var path = require('path');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+const MAPPING_EXAMPLE = '[{ "replace": "kbq-add-to-list_16", "replaceWith": "kbq-file-plus-o_16" }]';
+function readCustomJson(tree, filePath, bases = ['/']) {
+    for (const base of bases) {
+        const candidate = path__namespace.posix.join(base, filePath);
+        if (tree.exists(candidate)) {
+            return JSON.parse(tree.readText(candidate));
+        }
+    }
+    const absolutePath = path__namespace.resolve(filePath);
+    if (!fs.existsSync(absolutePath)) {
+        throw new schematics.SchematicsException(`Unable to find '${filePath}' in the workspace or at '${absolutePath}'`);
+    }
+    return JSON.parse(fs.readFileSync(absolutePath, 'utf-8'));
+}
+function readCustomIconMapping(tree, filePath, logger, bases) {
+    const entries = readCustomJson(tree, filePath, bases);
+    const invalid = () => new schematics.SchematicsException(`'${filePath}' must hold a JSON array of icon pairs, for example ${MAPPING_EXAMPLE}`);
+    if (!Array.isArray(entries)) {
+        throw invalid();
+    }
+    let legacyShape = false;
+    const pairs = entries.map((entry) => {
+        if (typeof entry?.replace === 'string' && typeof entry?.replaceWith === 'string') {
+            return { from: entry.replace, to: entry.replaceWith };
+        }
+        if (typeof entry?.from === 'string' && typeof entry?.to === 'string') {
+            legacyShape = true;
+            return { from: entry.from, to: entry.to };
+        }
+        throw invalid();
+    });
+    if (legacyShape) {
+        logger.warn(`'${filePath}' uses the deprecated { "from", "to" } pairs; write them as { "replace", "replaceWith" }, for example ${MAPPING_EXAMPLE}`);
+    }
+    return pairs;
+}
+
+exports.readCustomIconMapping = readCustomIconMapping;
+exports.readCustomJson = readCustomJson;

package/schematics/utils/icon-migration.cjs

@@ -178,6 +178,9 @@ function createIconTemplateTransform(data, tokenMap, opts) {
         utils_ast.visitAll(visitor, parsed.tree.rootNodes);
         const edits = [];
         const allFound = [];
+        const iconHostTokenMap = data.scopeClassOnIconHost === undefined || data.scopeClassOnIconHost === data.scopeClassInList
+            ? tokenMap
+            : new Map(tokenMap).set(data.scope.from, data.scopeClassOnIconHost === 'remove' ? null : data.scope.to);
         const resolveValueToken = (token) => {
             if (tokenMap.has(token)) {
                 return tokenMap.get(token);
@@ -191,6 +194,9 @@ function createIconTemplateTransform(data, tokenMap, opts) {
             opts.warn(`${message}${(fileName && ' File: ' + fileName) || ''}`);
         };
         for (const el of visitor.elementsToMigrate) {
+            const classTokenMap = el.attrs.some((attr) => data.valueAttrs.includes(utils_ast.getSimpleAttributeName(attr.name)))
+                ? iconHostTokenMap
+                : tokenMap;
             for (const attr of el.attrs) {
                 if (!attr.valueSpan) {
                     continue;
@@ -223,7 +229,7 @@ function createIconTemplateTransform(data, tokenMap, opts) {
                 }
                 if (simpleName === 'class' && !attr.name.startsWith('[')) {
                     const found = [];
-                    const newValue = utils_ast.replaceTokenList(attr.value, exactTokenLookup(tokenMap, found));
+                    const newValue = utils_ast.replaceTokenList(attr.value, exactTokenLookup(classTokenMap, found));
                     if (newValue !== undefined) {
                         edits.push({
                             start: attr.valueSpan.start.offset,
@@ -235,8 +241,8 @@ function createIconTemplateTransform(data, tokenMap, opts) {
                     continue;
                 }
                 const bindingToken = utils_ast.getClassBindingToken(simpleName);
-                if (bindingToken !== undefined && tokenMap.has(bindingToken)) {
-                    const replacement = tokenMap.get(bindingToken);
+                if (bindingToken !== undefined && classTokenMap.has(bindingToken)) {
+                    const replacement = classTokenMap.get(bindingToken);
                     if (replacement) {
                         const newSimpleName = simpleName.replace(new RegExp(`\\.${escapeRegExp(bindingToken)}$`), `.${replacement}`);
                         const newName = attr.name.startsWith('[') ? `[${newSimpleName}]` : newSimpleName;

package/schematics/utils/messages.cjs

@@ -3,6 +3,9 @@
 function noProject(project) {
     return `Unable to find project '${project}' in the workspace`;
 }
+function noProjectOrDirectory(project) {
+    return `'${project}' is neither a project of the workspace nor a folder of it`;
+}
 const logMessage = (logger, content) => {
     logger.warn('-------------------------');
     logger.warn(content.join('\n'));
@@ -11,3 +14,4 @@ const logMessage = (logger, content) => {
 
 exports.logMessage = logMessage;
 exports.noProject = noProject;
+exports.noProjectOrDirectory = noProjectOrDirectory;