@koobiq/components 20.4.1 → 21.0.0

package/schematics/migrations/file-upload-deprecated-outputs/index.js

@@ -0,0 +1,70 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils_messages = require('../../utils/messages.js');
+var utils_packageConfig = require('../../package-config-BhU2TfC8.js');
+var migrations_fileUploadDeprecatedOutputs_data = require('./data.js');
+require('@angular-devkit/schematics');
+require('@schematics/angular/utility');
+
+const TS_EXT = '.ts';
+const HTML_EXT = '.html';
+const LABEL = '[file-upload-deprecated-outputs]';
+// Build output that `visitProjectFiles` does not prune already.
+const SKIPPED_PATH_SEGMENTS = ['/coverage/', '/out-tsc/'];
+// `fileQueueChange` is a prefix of `fileQueueChanged`, so this one substring check
+// is enough to skip every file neither replacement can possibly match.
+const MATCH_HINT = 'fileQueueChange';
+const compiledReplacements = migrations_fileUploadDeprecatedOutputs_data.replacements.map(({ from, to }) => ({ regexp: new RegExp(from, 'g'), to }));
+function isSkippedPath(filePath) {
+    return SKIPPED_PATH_SEGMENTS.some((segment) => filePath.includes(segment));
+}
+function isMigratableFile(filePath) {
+    return filePath.endsWith(TS_EXT) || filePath.endsWith(HTML_EXT);
+}
+function applyReplacements(content) {
+    let result = content;
+    for (const { regexp, to } of compiledReplacements) {
+        result = result.replace(regexp, to);
+    }
+    return result;
+}
+function fileUploadDeprecatedOutputs(options) {
+    return async (tree, context) => {
+        const { project } = options;
+        // `ng update` invokes migrations with no options at all, and migrations.json
+        // declares no schema, so the schema default never reaches us — applying the
+        // fix is the intended behaviour there.
+        const fix = options.fix ?? true;
+        const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
+        const root = projectDefinition?.root ?? '';
+        const rootDir = root ? tree.getDir(root) : tree.root;
+        let touched = 0;
+        utils_packageConfig.visitProjectFiles(rootDir, (filePath, entry) => {
+            if (isSkippedPath(filePath))
+                return;
+            if (!isMigratableFile(filePath))
+                return;
+            const originalContent = entry?.content.toString();
+            if (!originalContent || !originalContent.includes(MATCH_HINT))
+                return;
+            const content = applyReplacements(originalContent);
+            if (content === originalContent)
+                return;
+            touched++;
+            if (fix) {
+                tree.overwrite(filePath, content);
+            }
+            else {
+                utils_messages.logMessage(context.logger, [`${LABEL} would update ${filePath} (run with --fix to apply)`]);
+            }
+        });
+        utils_messages.logMessage(context.logger, [
+            `${LABEL} processed tree under "${root || '<workspace root>'}", ` +
+                `${fix ? 'updated' : 'would update'} ${touched} file(s).`
+        ]);
+    };
+}
+
+exports.default = fileUploadDeprecatedOutputs;

package/schematics/migrations/file-upload-deprecated-outputs/schema.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "koobiq-components-file-upload-deprecated-outputs",
+    "title": "Koobiq components file-upload deprecated outputs removal",
+    "type": "object",
+    "properties": {
+        "project": {
+            "type": "string",
+            "description": "Name of the project to migrate. Defaults to the workspace's default project when run via `ng g`; `ng update` invokes the migration with no options at all, which runs it over the whole tree.",
+            "$default": {
+                "$source": "projectName"
+            }
+        },
+        "fix": {
+            "type": "boolean",
+            "default": true,
+            "description": "When true, applies all auto-fix replacements. When false, prints what would change without writing."
+        }
+    }
+}

package/schematics/migrations/filter-bar-rename-action/README.md

@@ -0,0 +1,183 @@
+# filter-bar-rename-action
+
+Migration schematic invoked automatically by `ng update @koobiq/components@21`
+(registered for `21.0.0-0`). Cleans up after the filter-bar "rename" rework.
+
+## Background
+
+The save/rename popover used to render a caption above its name field, sourced
+from `filters.name` of the filter-bar locale configuration, while its header
+said either "Сохранить как новый" or "Сохранить изменения". The header now
+carries the caption itself ("Новый фильтр" when saving a new filter, "Новое
+название" when renaming), so the separate field caption — and its locale key —
+were removed.
+
+A taken name used to be reported twice: by `filters.error` under the name field
+and by `filters.errorHint` in the alert above it. The message under the field —
+and its locale key — were removed; the field is still marked invalid.
+
+`filters.saveChanges` and `filters.saveAsNew` each did two jobs: the label of a
+dropdown item and the header of the popover it opens. A field caption reads
+wrong on a dropdown item, so each key was split into a `…Header` and a
+`…Button` key.
+
+The dropdown item that opens the rename popover was reworded from "Изменить" to
+"Переименовать", and its action was narrowed to match the new name.
+
+## Breaking change
+
+**`filters.name` and `filters.error` were removed from the filter-bar locale
+configuration.**
+
+**`filters.saveChanges` and `filters.saveAsNew` were replaced** by
+`saveChangesHeader` / `saveChangesButton` and `saveAsNewHeader` /
+`saveAsNewButton`.
+
+A literal typed against the configuration — a
+`kbqFilterBarLocaleConfigurationProvider()` argument, for one — fails to
+compile on a removed key with an excess-property error; an untyped one (a
+`useValue`) silently loses the override.
+
+## Behaviour change
+
+**Renaming a filter no longer saves it.** `saveAsNew()` used to stamp
+`saved: true` / `changed: false` onto the emitted payload in both modes, so
+renaming a filter with unsaved pipe edits handed the host a payload that
+declared those edits saved — and a host persisting `event.filter` wholesale
+wrote them to storage. In rename mode both flags are now inherited from the
+current filter, so a dirty filter stays dirty under its new name and its "save
+changes" action (with its warning marker) survives the rename.
+
+Hosts handling `KbqSaveFilterStatuses.NewName` should persist **the name only**.
+The payload still carries the pipes currently shown in the bar — the component
+cannot know which pipes were last persisted — so writing the whole payload back
+reintroduces the old behaviour.
+
+The default wording changed with it: the dropdown items read "Сохранить" and
+"Сохранить как новый", and the alert reporting a taken name reads "Такой фильтр
+уже есть".
+
+## What it does
+
+The schematic walks every `.ts` and `.html` file in the project (skipping
+`node_modules` and `dist`).
+
+| Auto-fix                                                                                       | Where |
+| ---------------------------------------------------------------------------------------------- | ----- |
+| Removes the `name` and `error` properties from a filter-bar `filters` locale literal           | `.ts` |
+| Splits `saveChanges` / `saveAsNew` in such a literal into `…Header` and `…Button` (same value) | `.ts` |
+
+Literals are found through the TypeScript AST and matched by **fingerprint**: an
+object literal is treated as a `filters` section only when it carries at least
+three of the section's other keys (`saveAsNewFilter`, `saveChanges`,
+`saveAsNewHeader`, `actionsTooltip`, …; old and split keys both count). No type
+resolution is involved — the schematic's virtual tree has no `@koobiq` types to
+resolve against — so an unrelated object that merely has a `name`, `error`,
+`saveChanges` or `saveAsNew` property is never touched. A deleted property goes
+together with exactly one adjacent separator, so the literal keeps its shape and
+nothing else in the file is reformatted.
+
+A split key becomes both of its halves, each carrying the old value, so the
+string keeps showing where it did. A half the literal already has is not
+repeated, and a shorthand expands into two references to its variable.
+
+A shorthand `name` or `error` (`{ name, saveChanges: … }`) is deliberately left
+alone: deleting it would drop a reference to a variable the file still declares,
+which is a different edit from removing a dead string. The literal is reported
+instead, so the key does not go unnoticed.
+
+The AST parse is gated on a cheap pre-check for a `name`, `error`,
+`saveChanges` or `saveAsNew` member (`name:`, `'name':`, or the shorthand
+between two separators) rather than on the bare word, which would match
+`className`, `errorState` and most of a project.
+
+## What it does _not_ do (warn-only)
+
+| Pattern                                                                        | Manual migration                                                                             |
+| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
+| `filters.name` in `.ts`                                                        | A read (or a literal the fingerprint did not match) — drop it                                |
+| A shorthand `name` / `error` in a matched literal                              | Remove it by hand, together with the variable if nothing else reads it                       |
+| `filters.name` / `localeData.name` in a template                               | Drop the binding, or bind your own string if the field still needs a visible caption         |
+| A read or binding of `filters.error` / `localeData.error`                      | Drop it — the alert above the field reports a taken name alone                               |
+| An `error` key left in a partial override or binding (`filters: { error: … }`) | Delete it                                                                                    |
+| `KbqSaveFilterStatuses.NewName`                                                | Review the handler: persist the name only, or the rename keeps saving the pending pipe edits |
+| A read of `filters.saveChanges` / `filters.saveAsNew`                          | Read `…Header` for the popover header or `…Button` for the dropdown item                     |
+| A `saveChanges` / `saveAsNew` string left in a partial override or binding     | Replace it with `…Header` and/or `…Button`                                                   |
+
+Warnings are checked against the **post-fix** content, so an auto-fixed literal
+does not also report as needing manual work. In dry-run mode (`--fix false`)
+they are reported against the original content instead.
+
+`fix` defaults to `true`. `ng update` invokes migrations with no options at all,
+so the rule applies that default itself rather than relying on the schema.
+
+[Params](schema.ts)
+
+Usage for Angular Cli:
+
+```shell
+ng g @koobiq/components:filter-bar-rename-action --project "<your project>"
+```
+
+Usage for Nx:
+
+```shell
+nx g @koobiq/components:filter-bar-rename-action --project "<your project>"
+```
+
+### Run locally
+
+Build package
+
+```shell
+yarn run build:schematics
+```
+
+Run command (for example, for `koobiq-docs` project)
+
+```shell
+ng g ./dist/components/schematics/collection.json:filter-bar-rename-action --project koobiq-docs
+```
+
+### Result
+
+#### Before
+
+```ts
+import { KBQ_FILTER_BAR_LOCALE_CONFIGURATION } from '@koobiq/components/filter-bar';
+
+export const filterBarConfiguration = {
+    provide: KBQ_FILTER_BAR_LOCALE_CONFIGURATION,
+    useValue: {
+        ...ruRULocaleData.filterBar,
+        filters: {
+            ...ruRULocaleData.filterBar.filters,
+            saveChanges: 'Сохранить изменения',
+            change: 'Изменить',
+            name: 'Название',
+            error: 'Поиск с таким названием уже существует',
+            saveButton: 'Сохранить'
+        }
+    }
+};
+```
+
+#### After
+
+```ts
+import { KBQ_FILTER_BAR_LOCALE_CONFIGURATION } from '@koobiq/components/filter-bar';
+
+export const filterBarConfiguration = {
+    provide: KBQ_FILTER_BAR_LOCALE_CONFIGURATION,
+    useValue: {
+        ...ruRULocaleData.filterBar,
+        filters: {
+            ...ruRULocaleData.filterBar.filters,
+            saveChangesHeader: 'Сохранить изменения',
+            saveChangesButton: 'Сохранить изменения',
+            change: 'Изменить',
+            saveButton: 'Сохранить'
+        }
+    }
+};
+```

package/schematics/migrations/filter-bar-rename-action/data.js

@@ -0,0 +1,151 @@
+'use strict';
+
+/**
+ * Replacement data for the filter-bar "rename" rework.
+ *
+ * The `filters.name` key was removed from the filter-bar locale configuration: the save/rename
+ * popover no longer renders a separate caption above its name field, because its header now
+ * carries that caption itself. `filters.error` went too: a taken name is reported by the alert above
+ * the field (`filters.errorHint`) alone. `filters.saveChanges` and `filters.saveAsNew` each served as
+ * both a popover header and a dropdown item label, so each was split into a `…Header` and a `…Button`
+ * key. Renaming a filter also stopped writing `saved: true` / `changed: false` onto the emitted
+ * payload, so it no longer persists the filter's pending pipe edits as a side effect.
+ */
+/** The locale keys removed from the `filters` section of the filter-bar configuration. */
+const REMOVED_KEYS = ['name', 'error'];
+/**
+ * Cheap pre-check gating the AST parse.
+ *
+ * Searching for `name` or `error` alone would match `className`, `errorState` and most of a project,
+ * so the parse is gated on the shapes a key can take inside an object literal: `name:`, a quoted
+ * `'name':`, and the shorthand `name` standing between a brace or comma and the next one. A preceding
+ * word character or dot rules out both longer identifiers and property reads, which are warn-only.
+ */
+const REMOVED_MEMBER_PATTERN = /(?:^|[^.\w])(['"]?)(?:name|error)\1\s*[:,}]/;
+/** Keys split in two: the popover header (`…Header`) and the dropdown item label (`…Button`). */
+const SPLIT_KEYS = new Map([
+    ['saveChanges', ['saveChangesHeader', 'saveChangesButton']],
+    ['saveAsNew', ['saveAsNewHeader', 'saveAsNewButton']]
+]);
+/** The same pre-check for the split keys; `saveAsNewFilter` does not match. */
+const SPLIT_MEMBER_PATTERN = /(?:^|[^.\w])(['"]?)(?:saveChanges|saveAsNew)\1\s*[:,}]/;
+/** Reported for a shorthand removed key the fix deliberately leaves in place. */
+const shorthandMessage = (key) => `This filter-bar locale literal carries \`${key}\` as a shorthand property. It was left in place — ` +
+    'deleting it would drop a reference to a variable the file still declares — so remove it by hand, ' +
+    'together with the variable if nothing else reads it.';
+/**
+ * Sibling keys that identify a `filters` locale literal.
+ *
+ * A full locale literal carries the whole key set — matching on a handful of them keeps an unrelated
+ * object that merely has a `name`, `error`, `saveChanges` or `saveAsNew` property from being
+ * touched. Both the old and the split keys count, so a literal is recognised before and after the
+ * split. No type resolution is involved: the schematic's virtual tree has no `@koobiq` types to
+ * resolve against.
+ */
+const FINGERPRINT_KEYS = [
+    'defaultName',
+    'saveNewFilterTooltip',
+    'searchPlaceholder',
+    'searchEmptyResult',
+    'saveAsNewFilter',
+    'saveChanges',
+    'saveAsNew',
+    'saveChangesHeader',
+    'saveChangesButton',
+    'saveAsNewHeader',
+    'saveAsNewButton',
+    'change',
+    'resetChanges',
+    'errorHint',
+    'saveButton',
+    'cancelButton',
+    'actionsTooltip'
+];
+/**
+ * How many fingerprint keys an object literal needs before it is rewritten.
+ *
+ * Three distinct filter-bar strings never co-occur by accident, while a full section carries well
+ * over a dozen, so the threshold rejects look-alikes. A partial override with fewer keys is left to
+ * the warnings below.
+ */
+const MIN_FINGERPRINT_MATCHES = 3;
+/** Warnings for `.ts` files. Checked against post-fix content, so they only fire on what was left. */
+const tsWarnPatterns = [
+    {
+        pattern: '\\bfilters\\.name\\b',
+        message: 'The `name` key was removed from the filters section of the filter-bar locale configuration. ' +
+            'Drop this read — the popover header now captions the name field. Manual migration required: ' +
+            'this usage was not an object literal the schematic could rewrite.'
+    },
+    {
+        pattern: 'KbqSaveFilterStatuses\\.NewName',
+        message: "Renaming changed meaning: the payload of a NewName save now keeps the filter's own `saved` / " +
+            '`changed` flags instead of forcing saved: true / changed: false, and it still carries the pipes ' +
+            'currently shown in the bar. Persist the name only — writing the whole payload back would ' +
+            'silently save the pending pipe edits along with it.'
+    }
+];
+/**
+ * Warnings for `.html` files and inline templates. A `.ts` file is checked against them too, so the
+ * split-key warnings live here and cover both.
+ */
+const templateWarnPatterns = [
+    {
+        pattern: '\\bfilters\\.name\\b|\\blocaleData\\.name\\b',
+        message: 'The `name` key was removed from the filters section of the filter-bar locale configuration. ' +
+            'Drop this binding, or bind your own string if the field still needs a visible caption.'
+    },
+    {
+        pattern: '\\b(?:filters|localeData)\\.error\\b',
+        message: 'The `error` key was removed from the filters section of the filter-bar locale configuration: ' +
+            'a taken name is reported by the alert above the name field (`errorHint`) alone. Drop this ' +
+            'read or binding. Manual migration required.'
+    },
+    {
+        pattern: '\\bfilters\\s*:\\s*\\{[^{}]*\\berror\\s*:',
+        message: 'An `error` key the fix did not rewrite: a filter-bar locale override with too few keys to be ' +
+            'recognised, or one bound in a template. The key was removed — delete it, or ignore this if ' +
+            'the object is not a filter-bar locale override.'
+    },
+    {
+        // The lookahead skips calls of the KbqFilters methods that share these names.
+        pattern: '\\b(?:filters|localeData)\\.(?:saveChanges|saveAsNew)\\b(?!\\s*\\()',
+        message: '`filters.saveChanges` and `filters.saveAsNew` were split: read `saveChangesHeader` / ' +
+            '`saveAsNewHeader` for the popover header, or `saveChangesButton` / `saveAsNewButton` for the ' +
+            'dropdown item. Manual migration required.'
+    },
+    {
+        pattern: '([\'"]?)\\b(?:saveChanges|saveAsNew)\\1\\s*:\\s*[\'"`]',
+        message: 'A `saveChanges` / `saveAsNew` string the fix did not rewrite: a filter-bar locale override with too ' +
+            'few keys to be recognised, or one bound in a template. Each key was split in two — replace it ' +
+            'with `…Header` (popover header) and `…Button` (dropdown item), or ignore this if the object is ' +
+            'not a filter-bar locale override.'
+    }
+];
+/** Behaviour note printed once per run — the parts no call site can point at. */
+const BEHAVIOUR_NOTE = [
+    'Filter-bar rename behaviour changed:',
+    '  - The "Изменить" / "Edit" dropdown item now reads "Переименовать" / "Rename" and only renames.',
+    '    A filter with unsaved pipe changes stays changed under its new name, so the "save changes"',
+    '    action (and its warning marker) survives a rename instead of being cleared by it.',
+    '  - `filters.saveChanges` and `filters.saveAsNew` were each split into a `…Header` key (the popover',
+    '    header, which now also captions the name field: "Новое название" / "Новый фильтр") and a',
+    '    `…Button` key (the dropdown item: "Сохранить" / "Сохранить как новый"). The fix copies an',
+    '    overridden value into both; re-check the headers — an action-shaped string reads wrong there.',
+    '  - The popover no longer renders a caption above the name field; its header carries it.',
+    '  - A taken name is reported by the alert above the name field alone ("Такой фильтр уже есть",',
+    '    `filters.errorHint`): the field is still marked invalid, but `filters.error` no longer repeats',
+    '    the message underneath.',
+    'Override these strings through kbqFilterBarLocaleConfigurationProvider if the new wording does not fit.'
+];
+
+exports.BEHAVIOUR_NOTE = BEHAVIOUR_NOTE;
+exports.FINGERPRINT_KEYS = FINGERPRINT_KEYS;
+exports.MIN_FINGERPRINT_MATCHES = MIN_FINGERPRINT_MATCHES;
+exports.REMOVED_KEYS = REMOVED_KEYS;
+exports.REMOVED_MEMBER_PATTERN = REMOVED_MEMBER_PATTERN;
+exports.SPLIT_KEYS = SPLIT_KEYS;
+exports.SPLIT_MEMBER_PATTERN = SPLIT_MEMBER_PATTERN;
+exports.shorthandMessage = shorthandMessage;
+exports.templateWarnPatterns = templateWarnPatterns;
+exports.tsWarnPatterns = tsWarnPatterns;

package/schematics/migrations/filter-bar-rename-action/index.js

@@ -0,0 +1,177 @@
+'use strict';
+
+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 migrations_filterBarRenameAction_data = require('./data.js');
+require('@angular-devkit/schematics');
+require('@schematics/angular/utility');
+
+const TS_EXT = '.ts';
+const HTML_EXT = '.html';
+const LABEL = '[filter-bar-rename-action]';
+const createSourceFile = (fileName, content) => ts.createSourceFile(fileName, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+/** Property name of an object-literal member, for the forms a locale literal can use. */
+function propertyName(property) {
+    if (!ts.isPropertyAssignment(property) && !ts.isShorthandPropertyAssignment(property))
+        return null;
+    if (!ts.isIdentifier(property.name) && !ts.isStringLiteralLike(property.name))
+        return null;
+    return property.name.text;
+}
+/**
+ * Whether an object literal is recognisably a filter-bar `filters` locale section — one carrying
+ * enough of the sibling keys listed in {@link FINGERPRINT_KEYS}.
+ */
+function isFiltersSection(node) {
+    const fingerprint = node.properties.filter((property) => {
+        const name = propertyName(property);
+        return name !== null && migrations_filterBarRenameAction_data.FINGERPRINT_KEYS.includes(name);
+    });
+    return fingerprint.length >= migrations_filterBarRenameAction_data.MIN_FINGERPRINT_MATCHES;
+}
+/**
+ * Rewrites a split key into its `…Header` / `…Button` pair, both carrying the old value, so every
+ * string keeps showing where it did. A half the literal already has is not repeated; with both
+ * present the old property is just deleted. A shorthand expands into two references to its variable.
+ */
+function splitProperty(property, name, targets, existing, sourceFile) {
+    const start = property.getStart(sourceFile);
+    const end = property.getEnd();
+    const missing = targets.filter((target) => !existing.has(target));
+    if (!missing.length)
+        return { start, end, text: null };
+    const text = sourceFile.text;
+    const key = text.slice(property.name.getStart(sourceFile), property.name.getEnd());
+    const value = ts.isPropertyAssignment(property)
+        ? text.slice(property.initializer.getStart(sourceFile), property.initializer.getEnd())
+        : name;
+    const indent = text.slice(text.lastIndexOf('\n', start - 1) + 1, start);
+    const separator = /^[ \t]*$/.test(indent) ? `,${text.includes('\r\n') ? '\r\n' : '\n'}${indent}` : ', ';
+    return { start, end, text: missing.map((target) => `${key.replace(name, target)}: ${value}`).join(separator) };
+}
+/** Every edit across the file, plus the shorthand removed keys left behind. */
+function collectFindings(sourceFile) {
+    const findings = { edits: [], shorthand: new Set() };
+    const visit = (node) => {
+        if (ts.isObjectLiteralExpression(node) && isFiltersSection(node)) {
+            const existing = new Set(node.properties.map(propertyName));
+            for (const property of node.properties) {
+                if (!ts.isPropertyAssignment(property) && !ts.isShorthandPropertyAssignment(property))
+                    continue;
+                const name = propertyName(property);
+                if (name === null)
+                    continue;
+                const targets = migrations_filterBarRenameAction_data.SPLIT_KEYS.get(name);
+                if (targets) {
+                    findings.edits.push(splitProperty(property, name, targets, existing, sourceFile));
+                }
+                else if (migrations_filterBarRenameAction_data.REMOVED_KEYS.includes(name) && ts.isPropertyAssignment(property)) {
+                    findings.edits.push({ start: property.getStart(sourceFile), end: property.getEnd(), text: null });
+                }
+                else if (migrations_filterBarRenameAction_data.REMOVED_KEYS.includes(name)) {
+                    // A shorthand: deleting it would also drop a reference to a variable the file
+                    // still declares, which is a different edit from removing a dead string.
+                    findings.shorthand.add(name);
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    ts.forEachChild(sourceFile, visit);
+    return findings;
+}
+/** A comma and the whitespace — at most one line break — that separates two members. */
+const SEPARATOR_BEFORE = /,[ \t]*\r?\n?[ \t]*$/;
+const SEPARATOR_AFTER = /^,[ \t]*\r?\n?[ \t]*/;
+/**
+ * Applies the edits right-to-left, so earlier offsets stay valid. A deleted property takes exactly
+ * one adjacent separator with it — the preceding one when it has one — so the literal keeps its shape
+ * and nothing around it is reformatted. A sole property leaves an empty literal rather than a stray
+ * comma.
+ */
+function applyEdits(content, edits) {
+    let result = content;
+    for (const { start, end, text } of [...edits].sort((a, b) => b.start - a.start)) {
+        if (text !== null) {
+            result = result.slice(0, start) + text + result.slice(end);
+            continue;
+        }
+        const before = SEPARATOR_BEFORE.exec(result.slice(0, start));
+        const after = before ? null : SEPARATOR_AFTER.exec(result.slice(end));
+        result = result.slice(0, before ? before.index : start) + result.slice(end + (after ? after[0].length : 0));
+    }
+    return result;
+}
+function logWarnings(context, filePath, content, patterns) {
+    for (const { pattern, message } of patterns) {
+        if (new RegExp(pattern).test(content)) {
+            utils_messages.logMessage(context.logger, [`${LABEL} ${filePath}`, `  ${message}`]);
+        }
+    }
+}
+function pickWarnPatterns(filePath) {
+    // A .ts file can hold an inline template, so it is checked against both sets.
+    return filePath.endsWith(TS_EXT) ? [...migrations_filterBarRenameAction_data.tsWarnPatterns, ...migrations_filterBarRenameAction_data.templateWarnPatterns] : migrations_filterBarRenameAction_data.templateWarnPatterns;
+}
+function isMigratableFile(filePath) {
+    return filePath.endsWith(TS_EXT) || filePath.endsWith(HTML_EXT);
+}
+function filterBarRenameAction(options) {
+    return async (tree, context) => {
+        const { project } = options;
+        // ng update invokes migrations with no options at all, and migrations.json declares no
+        // schema, so the schema default never reaches us — applying the fix is the intended
+        // behaviour there.
+        const fix = options.fix ?? true;
+        const projectDefinition = await utils_packageConfig.setupOptions(project, tree);
+        const root = projectDefinition?.root ?? '';
+        const rootDir = root ? tree.getDir(root) : tree.root;
+        const filePaths = [];
+        utils_packageConfig.visitProjectFiles(rootDir, (filePath) => {
+            if (!isMigratableFile(filePath))
+                return;
+            filePaths.push(filePath);
+        });
+        let touched = 0;
+        for (const filePath of filePaths) {
+            const originalContent = tree.read(filePath)?.toString();
+            if (!originalContent)
+                continue;
+            let content = originalContent;
+            // Parsing every .ts of the project is not free, and a file that carries no `name`, `error`,
+            // `saveChanges` or `saveAsNew` member at all cannot hold a literal to fix.
+            if (filePath.endsWith(TS_EXT) &&
+                (migrations_filterBarRenameAction_data.REMOVED_MEMBER_PATTERN.test(content) || migrations_filterBarRenameAction_data.SPLIT_MEMBER_PATTERN.test(content))) {
+                const { edits, shorthand } = collectFindings(createSourceFile(filePath, content));
+                content = applyEdits(content, edits);
+                for (const key of shorthand) {
+                    utils_messages.logMessage(context.logger, [`${LABEL} ${filePath}`, `  ${migrations_filterBarRenameAction_data.shorthandMessage(key)}`]);
+                }
+            }
+            // Warn on what is left over, so an auto-fixed literal does not also produce a
+            // "manual migration required" note. In dry-run mode the fix is not written, so report
+            // against the original content.
+            logWarnings(context, filePath, fix ? content : originalContent, pickWarnPatterns(filePath));
+            if (content === originalContent)
+                continue;
+            touched++;
+            if (fix) {
+                tree.overwrite(filePath, content);
+            }
+            else {
+                utils_messages.logMessage(context.logger, [`${LABEL} would update ${filePath} (run with --fix to apply)`]);
+            }
+        }
+        utils_messages.logMessage(context.logger, [
+            `${LABEL} processed tree under "${root || '<workspace root>'}", ` +
+                `${fix ? 'updated' : 'would update'} ${touched} file(s).`,
+            '',
+            ...migrations_filterBarRenameAction_data.BEHAVIOUR_NOTE
+        ]);
+    };
+}
+
+exports.default = filterBarRenameAction;

package/schematics/migrations/filter-bar-rename-action/schema.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "koobiq-components-filter-bar-rename-action",
+    "title": "Koobiq components filter-bar rename action rework",
+    "type": "object",
+    "properties": {
+        "project": {
+            "type": "string",
+            "description": "Name of the project to migrate. If omitted, the migration runs over the whole tree.",
+            "$default": {
+                "$source": "projectName"
+            }
+        },
+        "fix": {
+            "type": "boolean",
+            "default": true,
+            "description": "When true, applies all auto-fix replacements. When false, prints what would change without writing."
+        }
+    }
+}