@koobiq/components 21.0.0 → 21.1.0

package/schematics/migrations/accordion-state-saving-default/{index.js → index.cjs}

@@ -2,9 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var migrations_accordionStateSavingDefault_data = require('./data.js');
+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_accordionStateSavingDefault_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -30,7 +31,7 @@ function accordionStateSavingDefault(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         let consumers = 0;
         let reported = 0;
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath, entry) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath, entry) => {
             if (!EXTENSIONS.some((extension) => filePath.endsWith(extension)))
                 return;
             const content = entry?.content.toString();

package/schematics/migrations/actions-panel-overlay-container/{index.js → index.cjs}

@@ -2,9 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var migrations_actionsPanelOverlayContainer_data = require('./data.js');
+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_actionsPanelOverlayContainer_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -26,7 +27,7 @@ function actionsPanelOverlayContainer(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         let consumers = 0;
         let reported = 0;
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath, entry) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath, entry) => {
             if (!EXTENSIONS.some((extension) => filePath.endsWith(extension)))
                 return;
             const content = entry?.content.toString();

package/schematics/migrations/alert-signals/{index.js → index.cjs}

@@ -3,15 +3,16 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var signalMembersMigration = require('../../signal-members-migration-BoAJKutT.js');
-var templateRefAccess = require('../../template-ref-access-DLNoxmmG.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_alertSignals_data = require('./data.js');
+var utils_messages = require('../../utils/messages.cjs');
+var utils_packageConfig = require('../../utils/package-config.cjs');
+var utils_projectFiles = require('../../utils/project-files.cjs');
+var utils_signalMembersMigration = require('../../utils/signal-members-migration.cjs');
+var utils_templateRefAccess = require('../../utils/template-ref-access.cjs');
+var utils_typescript = require('../../utils/typescript.cjs');
+var migrations_alertSignals_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
-require('../../utils/ast.js');
+require('../../utils/ast.cjs');
 
 const TS_EXT = '.ts';
 const HTML_EXT = '.html';
@@ -26,7 +27,7 @@ function applyEdits(content, edits) {
 }
 /** The `KbqAlert` receivers of a file, typed by annotation or `inject()`. */
 function collectFileReceivers(sourceFile) {
-    return { receivers: signalMembersMigration.collectAllReceivers(sourceFile, [migrations_alertSignals_data.ALERT_TYPE]), bindings: signalMembersMigration.collectBindings(sourceFile) };
+    return { receivers: utils_signalMembersMigration.collectAllReceivers(sourceFile, [migrations_alertSignals_data.ALERT_TYPE]), bindings: utils_signalMembersMigration.collectBindings(sourceFile) };
 }
 /**
  * Whether a property access reads from an alert receiver. The shared engine resolves the receiver at this
@@ -34,7 +35,7 @@ function collectFileReceivers(sourceFile) {
  * followed. A signal query holds the instance behind a call of its own, which this pass does not reach.
  */
 function onReceiver(node, sourceFile, scope) {
-    const receiver = signalMembersMigration.resolveReceiver(node.expression, node, sourceFile, scope.receivers, scope.bindings);
+    const receiver = utils_signalMembersMigration.resolveReceiver(node.expression, node, sourceFile, scope.receivers, scope.bindings);
     return !!receiver && !receiver.signalQuery;
 }
 /** Collects edits for every read/write of a value-safe signal member on a known alert receiver. */
@@ -46,7 +47,7 @@ function collectAccessEdits(sourceFile, scope) {
             migrations_alertSignals_data.SIGNAL_MEMBERS.includes(node.name.text) &&
             onReceiver(node, sourceFile, scope)) {
             // `KbqAlert` signal members are `input()`, so every write is left for the consumer and reported.
-            signalMembersMigration.classifyAccess(node, sourceFile, migrations_alertSignals_data.WRITABLE_MEMBERS, edits);
+            utils_signalMembersMigration.classifyAccess(node, sourceFile, migrations_alertSignals_data.WRITABLE_MEMBERS, edits);
         }
         node.forEachChild(visit);
     };
@@ -55,7 +56,7 @@ function collectAccessEdits(sourceFile, scope) {
 }
 /** Whether a signal member is written rather than read, in any form: the migration leaves it for the consumer. */
 function isReadOnlyWrite(node) {
-    return migrations_alertSignals_data.SIGNAL_MEMBERS.includes(node.name.text) && !migrations_alertSignals_data.WRITABLE_MEMBERS.has(node.name.text) && signalMembersMigration.isWriteTarget(node);
+    return migrations_alertSignals_data.SIGNAL_MEMBERS.includes(node.name.text) && !migrations_alertSignals_data.WRITABLE_MEMBERS.has(node.name.text) && utils_signalMembersMigration.isWriteTarget(node);
 }
 /**
  * Collects the manual-migration members (`alertColor`, now-`protected` queries, writes to read-only signal
@@ -134,7 +135,7 @@ async function migrateTemplate(template) {
         return untouched;
     const { rootNodes } = parsed.tree;
     // A bare `#ref` or one naming the alert; `#ref="ngModel"` names another directive.
-    const { content, readOnlyWrites } = templateRefAccess.rewriteRefAccesses(template, rootNodes, (element, value) => element.name === migrations_alertSignals_data.ALERT_ELEMENT && (!value || value === migrations_alertSignals_data.ALERT_EXPORT_AS) ? REF_POLICY : undefined);
+    const { content, readOnlyWrites } = utils_templateRefAccess.rewriteRefAccesses(template, rootNodes, (element, value) => element.name === migrations_alertSignals_data.ALERT_ELEMENT && (!value || value === migrations_alertSignals_data.ALERT_EXPORT_AS) ? REF_POLICY : undefined);
     return { content, changed: content !== template, readOnlyWrites };
 }
 /** Pass B (inline) — rewrite alert ref reads inside inline component templates. */
@@ -174,7 +175,7 @@ function alertSignals(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         const tsPaths = [];
         const htmlPaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/angular-animations-removal/index.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils_warnOnlyMigration = require('../../utils/warn-only-migration.cjs');
+var migrations_angularAnimationsRemoval_data = require('./data.cjs');
+require('../../utils/messages.cjs');
+require('../../utils/package-config.cjs');
+require('@angular-devkit/schematics');
+require('@schematics/angular/utility');
+require('../../utils/project-files.cjs');
+
+/**
+ * Reports the uses of the removed animation triggers and of the members that carried an `AnimationEvent`.
+ * Never writes: what replaces a member depends on what the code did with the event.
+ */
+function angularAnimationsRemoval(options) {
+    return utils_warnOnlyMigration.warnOnlyRule({ label: '[angular-animations-removal]', warnPatterns: migrations_angularAnimationsRemoval_data.warnPatterns, summary: migrations_angularAnimationsRemoval_data.SUMMARY }, options);
+}
+
+exports.default = angularAnimationsRemoval;

package/schematics/migrations/app-switcher-signals/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_appSwitcherSignals_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_appSwitcherSignals_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -305,7 +306,7 @@ function appSwitcherSignals(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         const tsPaths = [];
         const htmlPaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/autocomplete-panel-width-auto/{index.js → index.cjs}

@@ -2,14 +2,15 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var utils_angularParsing = require('../../utils/angular-parsing.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
+var utils_angularParsing = require('../../utils/angular-parsing.cjs');
+var utils_packageConfig = require('../../utils/package-config.cjs');
+var utils_typescript = require('../../utils/typescript.cjs');
 require('typescript');
-require('../../utils/ast.js');
+require('../../utils/ast.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
-require('../../utils/messages.js');
+require('../../utils/messages.cjs');
+require('../../utils/project-files.cjs');
 
 const migrationData = {
     elementName: 'kbq-autocomplete',

package/schematics/migrations/autocomplete-signals/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_autocompleteSignals_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_autocompleteSignals_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -644,7 +645,7 @@ function autocompleteSignals(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         const tsPaths = [];
         const htmlPaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/badge-signals/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_badgeSignals_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_badgeSignals_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -633,7 +634,7 @@ function badgeSignals(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         const tsPaths = [];
         const htmlPaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/button-state-and-styles/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_buttonStateAndStyles_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_buttonStateAndStyles_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -163,7 +164,7 @@ function buttonStateAndStyles(options) {
         const root = projectDefinition?.root ?? '';
         const rootDir = root ? tree.getDir(root) : tree.root;
         const filePaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (!isMigratableFile(filePath))
                 return;
             filePaths.push(filePath);

package/schematics/migrations/button-supported-colors/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_buttonSupportedColors_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_buttonSupportedColors_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -197,7 +198,7 @@ function buttonSupportedColors(options) {
         const root = projectDefinition?.root ?? '';
         const rootDir = root ? tree.getDir(root) : tree.root;
         const filePaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (!isMigratableFile(filePath))
                 return;
             filePaths.push(filePath);

package/schematics/migrations/button-toggle-signals-and-aria/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_buttonToggleSignalsAndAria_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_buttonToggleSignalsAndAria_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -425,7 +426,7 @@ function buttonToggleSignalsAndAria(options) {
         const tsPaths = [];
         const htmlPaths = [];
         const stylePaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/button-truncation/{index.js → index.cjs}

@@ -3,11 +3,12 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_buttonTruncation_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_typescript = require('../../utils/typescript.cjs');
+var migrations_buttonTruncation_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -204,7 +205,7 @@ function buttonTruncation(options) {
         const tsPaths = [];
         const htmlPaths = [];
         const stylePaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/checkbox-signals/{index.js → index.cjs}

@@ -3,12 +3,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var ts = require('typescript');
-var utils_ast = require('../../utils/ast.js');
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var signalMembersMigration = require('../../signal-members-migration-BoAJKutT.js');
-var utils_typescript = require('../../utils/typescript.js');
-var migrations_checkboxSignals_data = require('./data.js');
+var utils_ast = require('../../utils/ast.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 utils_signalMembersMigration = require('../../utils/signal-members-migration.cjs');
+var utils_typescript = require('../../utils/typescript.cjs');
+var migrations_checkboxSignals_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -234,7 +235,7 @@ function classifyAccess(node, edits) {
     // a destructuring target. Every migrated member is an `input()`, so there is no writable half: the write is
     // left untouched and reported, and appending `()` would produce unparseable TypeScript instead of the
     // read-only error the consumer should see.
-    if (signalMembersMigration.isWriteTarget(node))
+    if (utils_signalMembersMigration.isWriteTarget(node))
         return 'write';
     // Read (incl. optional chain `x?.id`): append `()`.
     edits.push({ start: node.getEnd(), end: node.getEnd(), text: '()' });
@@ -563,7 +564,7 @@ function checkboxSignals(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         const tsPaths = [];
         const htmlPaths = [];
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath) => {
             if (filePath.endsWith(TS_EXT))
                 tsPaths.push(filePath);
             else if (filePath.endsWith(HTML_EXT))

package/schematics/migrations/clamped-text-disclosure/{index.js → index.cjs}

@@ -2,9 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var utils_messages = require('../../utils/messages.js');
-var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
-var migrations_clampedTextDisclosure_data = require('./data.js');
+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_clampedTextDisclosure_data = require('./data.cjs');
 require('@angular-devkit/schematics');
 require('@schematics/angular/utility');
 
@@ -31,7 +32,7 @@ function clampedTextDisclosure(options) {
         const rootDir = root ? tree.getDir(root) : tree.root;
         let consumers = 0;
         let reported = 0;
-        utils_packageConfig.visitProjectFiles(rootDir, (filePath, entry) => {
+        utils_projectFiles.visitProjectFiles(rootDir, (filePath, entry) => {
             if (!EXTENSIONS.some((extension) => filePath.endsWith(extension)))
                 return;
             const content = entry?.content.toString();

package/schematics/migrations/code-block-highlight-js-core/README.md

@@ -0,0 +1,53 @@
+# code-block-highlight-js-core
+
+Migration schematic invoked automatically by `ng update @koobiq/components` (registered for `21.1.0-0`).
+Keeps the full highlight.js bundle where the code block loaded it by default.
+
+## Background
+
+A highlight.js configuration without `core`, or no configuration at all, used to load the full bundle:
+every language highlight.js has, about 1 MB. Since the library held `import('highlight.js')`, every
+application bundled that chunk, even one whose configuration loaded the core and a few languages: a bundler
+emits a chunk for each `import()` it finds, whether it is called or not.
+
+The code block loads the core now, `highlight.js/lib/core`, which has no languages but plain text. The full
+bundle is loaded only where the application asks for it:
+
+```ts
+kbqCodeBlockHighlightJsConfigProvider({ core: () => import('highlight.js') });
+```
+
+## What it rewrites
+
+- An application that imports `@koobiq/components/code-block` and has no highlight.js configuration in its
+  root providers gets the provider above there, through `addRootProvider`, standalone or NgModule.
+- A configuration written as an object literal without `core` - the argument of
+  `kbqCodeBlockHighlightJsConfigProvider` and the `useValue` of a `KBQ_CODE_BLOCK_HIGHLIGHT_JS_CONFIG`
+  provider, imported under another name or passed to `TestBed.overrideProvider` too - gets
+  `core: () => import('highlight.js')`, in specs too.
+
+## What it does _not_ do
+
+| Case                                                             | Manual migration                                                                     |
+| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| A configuration in a variable, with a spread or from a factory   | Add `core: () => import('highlight.js')` if it has no `core`                         |
+| A configuration the root providers get through a function        | Remove the added root provider, which overrides it                                   |
+| A library that renders code blocks                               | Provide a configuration in the applications that use it                              |
+| A bootstrap it cannot analyze, or root providers not in an array | Add the provider to the root providers by hand                                       |
+| A spec that checks the highlighted markup of a code block        | Add the configuration to its `TestBed`: specs do not get the application's providers |
+
+To drop the full bundle, about 1 MB, list the languages the files use instead; plain text needs no entry:
+
+```ts
+kbqCodeBlockHighlightJsConfigProvider({
+    languages: {
+        typescript: () => import('highlight.js/lib/languages/typescript')
+    }
+});
+```
+
+## Running it manually
+
+```
+ng generate @koobiq/components:code-block-highlight-js-core --project my-app
+```

package/schematics/migrations/code-block-highlight-js-core/data.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+/**
+ * Data for the `code-block-highlight-js-core` migration.
+ *
+ * A configuration without `core` used to load the full highlight.js bundle, every language of it, about 1 MB. It
+ * loads the core now, which has no languages but plain text: the `import('highlight.js')` the library held made
+ * every application bundle the full one, configured or not, since a bundler emits a chunk for each `import()` it
+ * finds. The migration keeps the full bundle where the code block loaded it, by asking for it explicitly.
+ */
+const CODE_BLOCK_PACKAGE = '@koobiq/components/code-block';
+const CONFIG_PROVIDER = 'kbqCodeBlockHighlightJsConfigProvider';
+const CONFIG_TOKEN = 'KBQ_CODE_BLOCK_HIGHLIGHT_JS_CONFIG';
+/** The property that asks for the full bundle, which a configuration without `core` loaded. */
+const FULL_BUNDLE_CORE = "core: () => import('highlight.js')";
+const FULL_BUNDLE_PROVIDER = `${CONFIG_PROVIDER}({ ${FULL_BUNDLE_CORE} })`;
+const unreadConfigMessage = (line) => `Line ${line}: a highlight.js configuration the migration cannot read. If it has no \`core\`, the code block ` +
+    `now loads the core, which has no languages but plain text: add \`${FULL_BUNDLE_CORE}\` to keep every ` +
+    'language, or list the languages of the files in `languages`.';
+const addedRootProviderMessage = (project, fix) => [
+    `Project "${project}" renders code blocks without a highlight.js configuration in its root providers. ` +
+        `${fix ? 'Added' : 'Would add'} \`${FULL_BUNDLE_PROVIDER}\` to them to keep every language. To bundle the ` +
+        'core and the languages of the files only, about 1 MB less, list them instead:',
+    `  ${CONFIG_PROVIDER}({ languages: { typescript: () => import('highlight.js/lib/languages/typescript') } })`
+];
+const rootProviderFallback = (project) => [
+    `Could not tell whether project "${project}" provides a highlight.js configuration in its root providers: its ` +
+        'bootstrap cannot be analyzed statically, or its root providers are not an array literal. If it does not, ' +
+        'add one by hand, or its code blocks highlight plain text only:',
+    `  ${FULL_BUNDLE_PROVIDER}`
+];
+const noWorkspaceMessage = () => [
+    'Could not read the workspace, so the root providers of its applications were not checked. Add ' +
+        `\`${FULL_BUNDLE_PROVIDER}\` to those of an application that renders code blocks without a highlight.js ` +
+        'configuration there, or its code blocks highlight plain text only.'
+];
+const otherConfigsMessage = (project) => [
+    `Project "${project}" also provides a highlight.js configuration outside its root providers. If one of them ` +
+        'reaches every code block, through a function the root providers call, remove the added provider, which ' +
+        'overrides it.'
+];
+const libraryMessage = (project) => [
+    `Library "${project}" renders code blocks without a highlight.js configuration. Without one, the code block ` +
+        'now loads the core, which has no languages but plain text: the applications that use the library have ' +
+        `to provide \`${FULL_BUNDLE_PROVIDER}\` or the languages of its files.`
+];
+const SUMMARY = [
+    'The code block loads the highlight.js core when its configuration has no `core`, rather than the full bundle:',
+    'register the languages of the files in `languages`, plain text needs no entry. Specs render code blocks without',
+    "the application's providers: add the configuration to the TestBed of a spec that checks highlighted markup."
+];
+
+exports.CODE_BLOCK_PACKAGE = CODE_BLOCK_PACKAGE;
+exports.CONFIG_PROVIDER = CONFIG_PROVIDER;
+exports.CONFIG_TOKEN = CONFIG_TOKEN;
+exports.FULL_BUNDLE_CORE = FULL_BUNDLE_CORE;
+exports.FULL_BUNDLE_PROVIDER = FULL_BUNDLE_PROVIDER;
+exports.SUMMARY = SUMMARY;
+exports.addedRootProviderMessage = addedRootProviderMessage;
+exports.libraryMessage = libraryMessage;
+exports.noWorkspaceMessage = noWorkspaceMessage;
+exports.otherConfigsMessage = otherConfigsMessage;
+exports.rootProviderFallback = rootProviderFallback;
+exports.unreadConfigMessage = unreadConfigMessage;