@ethlete/components 1.0.0-next.63 → 1.0.0-next.65

package/generators/generators.json

@@ -5,11 +5,26 @@
       "schema": "./component/schema.json",
       "description": "Scaffold a component domain following the three-tier architecture (folder layout, headless + default split, styles, spec, stories, docs page, barrel wiring)"
     },
+    "migrate-bracket-default-cards": {
+      "factory": "./migrate-bracket-default-cards/migration",
+      "schema": "./migrate-bracket-default-cards/schema.json",
+      "description": "Spread BRACKET_DEFAULT_CARDS into provideBracketConfig and report brackets without one"
+    },
+    "migrate-bracket-ethlete-renames": {
+      "factory": "./migrate-bracket-ethlete-renames/migration",
+      "schema": "./migrate-bracket-ethlete-renames/schema.json",
+      "description": "Rename generateTournamentModeFormEthleteRounds to generateTournamentModeFromEthleteRounds"
+    },
     "migrate-query-error-labels": {
       "factory": "./migrate-query-error-labels/migration",
       "schema": "./migrate-query-error-labels/schema.json",
       "description": "Find query-error usage affected by the English-only label default and report where German must be re-opted-in"
     },
+    "migrate-overlay-nav-tab-imports": {
+      "factory": "./migrate-overlay-nav-tab-imports/migration",
+      "schema": "./migrate-overlay-nav-tab-imports/schema.json",
+      "description": "Add OVERLAY_NAV_TAB_IMPORTS where a NAV_TAB_IMPORTS component renders et-overlay-nav-tab-link"
+    },
     "migrate-rich-text-editor-floating-toolbar": {
       "factory": "./migrate-rich-text-editor-floating-toolbar/migration",
       "schema": "./migrate-rich-text-editor-floating-toolbar/schema.json",
@@ -25,6 +40,31 @@
       "schema": "./migrate-rich-text-editor-tools/schema.json",
       "description": "Find rich text editor usage that loses the heading, quote, code-block and link tools and report where to re-opt-in"
     },
+    "migrate-stream-default-components": {
+      "factory": "./migrate-stream-default-components/migration",
+      "schema": "./migrate-stream-default-components/schema.json",
+      "description": "Spread STREAM_DEFAULT_COMPONENTS into provideStreamConfig and report stream slots without one"
+    },
+    "migrate-youtube-player-slot-directive": {
+      "factory": "./migrate-youtube-player-slot-directive/migration",
+      "schema": "./migrate-youtube-player-slot-directive/schema.json",
+      "description": "Remove YoutubePlayerSlotDirective and YOUTUBE_PLAYER_SLOT_TOKEN, and mark the uses it cannot remove"
+    },
+    "migrate-chart-baseline-y": {
+      "factory": "./migrate-chart-baseline-y/migration",
+      "schema": "./migrate-chart-baseline-y/schema.json",
+      "description": "Rename the removed chart-grid baselineY alias to baseline"
+    },
+    "migrate-grid-engine-internals": {
+      "factory": "./migrate-grid-engine-internals/migration",
+      "schema": "./migrate-grid-engine-internals/schema.json",
+      "description": "Remove the grid engine internals from @ethlete/components imports and mark their uses"
+    },
+    "migrate-overlay-fullscreen-animation": {
+      "factory": "./migrate-overlay-fullscreen-animation/migration",
+      "schema": "./migrate-overlay-fullscreen-animation/schema.json",
+      "description": "Remove the overlay fullscreen animation internals from @ethlete/components imports and mark their uses"
+    },
     "icons": {
       "factory": "./icons/generator",
       "schema": "./icons/schema.json",

package/generators/migrate-bracket-default-cards/bracket-default-cards.js

@@ -0,0 +1,67 @@
+const USAGE_MARKERS = [
+    /<et-bracket[\s/>]/,
+    /<et-bracket-rounds-list[\s/>]/,
+    /\bBRACKET_IMPORTS\b/,
+    /\bBRACKET_ROUNDS_LIST_IMPORTS\b/,
+    /\bBracketComponent\b/,
+    /\bBracketRoundsListComponent\b/,
+];
+const COMPONENTS_IMPORT = /import\s*\{([^}]*)\}\s*from\s*['"]@ethlete\/components['"]/g;
+const lineOf = (content, index) => content.slice(0, index).split('\n').length;
+const taskId = (filePath, line) => `bracket-default-cards--${filePath.replace(/[^a-zA-Z0-9]+/g, '-')}-${line}`;
+/**
+ * Spreads `BRACKET_DEFAULT_CARDS` first into every literal `provideBracketConfig` call, so a card the
+ * config names itself still wins, and reports each call whose config is not a literal.
+ */
+export const scanBracketDefaultCardsInFile = (filePath, content) => {
+    const usesBracket = USAGE_MARKERS.some((marker) => marker.test(content));
+    const hasConfig = content.includes('provideBracketConfig(');
+    const tasks = [];
+    const importStatement = [...content.matchAll(COMPONENTS_IMPORT)].find((match) => /\bprovideBracketConfig\b/.test(match[1] ?? ''));
+    if (!importStatement || content.includes('BRACKET_DEFAULT_CARDS')) {
+        return { next: null, usesBracket, hasConfig, tasks };
+    }
+    let rewrote = false;
+    const next = content.replace(/provideBracketConfig\(\s*(\{\s*\}|\{\s*|\)|[^\s{)])/g, (call, opening, index) => {
+        if (opening === ')') {
+            rewrote = true;
+            return 'provideBracketConfig({ ...BRACKET_DEFAULT_CARDS })';
+        }
+        if (opening.startsWith('{')) {
+            rewrote = true;
+            return opening.endsWith('}')
+                ? 'provideBracketConfig({ ...BRACKET_DEFAULT_CARDS }'
+                : 'provideBracketConfig({ ...BRACKET_DEFAULT_CARDS, ';
+        }
+        const line = lineOf(content, index);
+        const argument = content.slice(index + call.length - 1).match(/^[^)\n]*/)?.[0] ?? '';
+        tasks.push({
+            id: taskId(filePath, line),
+            file: filePath,
+            line,
+            message: `\`provideBracketConfig(${argument})\` is not a literal the migration can edit. Spread \`BRACKET_DEFAULT_CARDS\` into it unless it names every card itself.`,
+        });
+        return call;
+    });
+    if (!rewrote)
+        return { next: null, usesBracket, hasConfig, tasks };
+    const rewrittenImport = importStatement[0].replace('{', '{ BRACKET_DEFAULT_CARDS,');
+    const importIndex = next.indexOf(importStatement[0]);
+    return {
+        next: next.slice(0, importIndex) + rewrittenImport + next.slice(importIndex + importStatement[0].length),
+        usesBracket,
+        hasConfig,
+        tasks,
+    };
+};
+export const bracketUsageTask = (filePath, content) => {
+    const index = Math.min(...USAGE_MARKERS.map((marker) => content.search(marker)).filter((position) => position >= 0));
+    const line = lineOf(content, index);
+    return {
+        id: taskId(filePath, line),
+        file: filePath,
+        line,
+        message: 'Renders a bracket, but the app has no `provideBracketConfig`, so no card is registered.',
+    };
+};
+//# sourceMappingURL=bracket-default-cards.js.map

package/generators/migrate-bracket-default-cards/migration.js

@@ -0,0 +1,63 @@
+import { formatFiles } from '@nx/devkit';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { bracketUsageTask, scanBracketDefaultCardsInFile } from './bracket-default-cards.js';
+export const BRACKET_DEFAULT_CARDS_REPORT_PATH = 'bracket-default-cards-migration-tasks.md';
+const renderReport = (tasks) => [
+    '# Bracket default cards migration tasks',
+    '',
+    'The shipped bracket cards are opt-in. A bracket whose match or round header card nothing names throws',
+    '`ET3414`. The migration spread `BRACKET_DEFAULT_CARDS` into every literal `provideBracketConfig` call; the',
+    'sites below need it by hand. Add once, app-wide or on the component that renders the bracket:',
+    '',
+    '```ts',
+    "import { BRACKET_DEFAULT_CARDS, provideBracketConfig } from '@ethlete/components';",
+    '',
+    'provideBracketConfig({ ...BRACKET_DEFAULT_CARDS });',
+    '```',
+    '',
+    'A bracket that binds cards of its own needs nothing. Delete this file when done.',
+    '',
+    ...tasks.map((task) => [`## \`${task.id}\``, '', `- ${task.file}:${task.line}`, `- ${task.message}`, ''].join('\n')),
+].join('\n');
+export default async function migrateBracketDefaultCards(tree, schema) {
+    console.log('\n🔎 Spreading BRACKET_DEFAULT_CARDS into provideBracketConfig...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const changed = [];
+    const tasks = [];
+    const usages = [];
+    let hasConfig = false;
+    scope.visit(tree, (filePath) => {
+        if (!/\.(ts|html)$/.test(filePath) || filePath.endsWith('.d.ts'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        const result = scanBracketDefaultCardsInFile(filePath, content);
+        hasConfig ||= result.hasConfig;
+        tasks.push(...result.tasks);
+        if (result.usesBracket)
+            usages.push(bracketUsageTask(filePath, content));
+        if (result.next !== null) {
+            tree.write(filePath, result.next);
+            changed.push(filePath);
+        }
+    });
+    const report = hasConfig ? tasks : [...tasks, ...usages];
+    if (report.length > 0) {
+        tree.write(BRACKET_DEFAULT_CARDS_REPORT_PATH, renderReport(report));
+    }
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (changed.length > 0) {
+        console.log(`\n✅ Spread BRACKET_DEFAULT_CARDS in ${changed.length} file(s).`);
+    }
+    if (report.length > 0) {
+        console.log(`\n⚠️  ${report.length} site(s) need the default cards by hand — see ${BRACKET_DEFAULT_CARDS_REPORT_PATH}.`);
+    }
+    else if (changed.length === 0) {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-bracket-default-cards/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-bracket-default-cards",
+  "title": "Spread BRACKET_DEFAULT_CARDS into provideBracketConfig and report brackets without one",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-bracket-ethlete-renames/bracket-ethlete-renames.js

@@ -0,0 +1,15 @@
+export const BRACKET_ETHLETE_RENAMES = {
+    generateTournamentModeFormEthleteRounds: 'generateTournamentModeFromEthleteRounds',
+};
+const IMPORTS_COMPONENTS = /from\s+['"]@ethlete\/components['"]/;
+/** Returns the file with every renamed bracket export replaced, or `null` when nothing changed. */
+export const renameBracketEthleteExportsInFile = (content) => {
+    if (!IMPORTS_COMPONENTS.test(content))
+        return null;
+    let next = content;
+    for (const [oldName, newName] of Object.entries(BRACKET_ETHLETE_RENAMES)) {
+        next = next.replace(new RegExp(`\\b${oldName}\\b`, 'g'), newName);
+    }
+    return next === content ? null : next;
+};
+//# sourceMappingURL=bracket-ethlete-renames.js.map

package/generators/migrate-bracket-ethlete-renames/migration.js

@@ -0,0 +1,31 @@
+import { formatFiles } from '@nx/devkit';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { renameBracketEthleteExportsInFile } from './bracket-ethlete-renames.js';
+export default async function migrateBracketEthleteRenames(tree, schema) {
+    console.log('\n🔎 Renaming generateTournamentModeFormEthleteRounds to generateTournamentModeFromEthleteRounds...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const changed = [];
+    scope.visit(tree, (filePath) => {
+        if (!filePath.endsWith('.ts') || filePath.endsWith('.d.ts'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        const next = renameBracketEthleteExportsInFile(content);
+        if (next === null)
+            return;
+        tree.write(filePath, next);
+        changed.push(filePath);
+    });
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (changed.length > 0) {
+        console.log(`\n✅ Renamed the export in ${changed.length} file(s).`);
+    }
+    else {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-bracket-ethlete-renames/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-bracket-ethlete-renames",
+  "title": "Rename generateTournamentModeFormEthleteRounds to generateTournamentModeFromEthleteRounds",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-chart-baseline-y/chart-baseline-y.js

@@ -0,0 +1,10 @@
+const COMPONENTS_IMPORT = /from\s*['"]@ethlete\/components(?:\/[^'"]*)?['"]/;
+const BASELINE_Y = /(\.\s*)baselineY\b/g;
+export const TEMPLATE_URL = /templateUrl\s*:\s*['"]([^'"]+)['"]/g;
+export const importsEthleteComponents = (content) => COMPONENTS_IMPORT.test(content);
+/** Returns the source or template with every `.baselineY` renamed to `.baseline`, or `null` when there is none. */
+export const renameBaselineY = (content) => {
+    const next = content.replace(BASELINE_Y, '$1baseline');
+    return next === content ? null : next;
+};
+//# sourceMappingURL=chart-baseline-y.js.map

package/generators/migrate-chart-baseline-y/migration.js

@@ -0,0 +1,41 @@
+import { formatFiles, joinPathFragments } from '@nx/devkit';
+import { dirname } from 'node:path/posix';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { importsEthleteComponents, renameBaselineY, TEMPLATE_URL } from './chart-baseline-y.js';
+export default async function migrateChartBaselineY(tree, schema) {
+    console.log('\n🔎 Renaming the removed chart-grid baselineY alias to baseline...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const changed = [];
+    const write = (filePath, content) => {
+        const next = renameBaselineY(content);
+        if (next === null)
+            return;
+        tree.write(filePath, next);
+        changed.push(filePath);
+    };
+    scope.visit(tree, (filePath) => {
+        if (!filePath.endsWith('.ts') || filePath.endsWith('.d.ts'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content || !importsEthleteComponents(content))
+            return;
+        for (const match of content.matchAll(TEMPLATE_URL)) {
+            const templatePath = joinPathFragments(dirname(filePath), match[1] ?? '');
+            const template = tree.read(templatePath, 'utf-8');
+            if (template !== null)
+                write(templatePath, template);
+        }
+        write(filePath, content);
+    });
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (changed.length > 0) {
+        console.log(`\n✅ Renamed baselineY in ${changed.length} file(s).`);
+    }
+    else {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-chart-baseline-y/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-chart-baseline-y",
+  "title": "Rename the removed chart-grid baselineY alias to baseline",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-grid-engine-internals/grid-engine-internals.js

@@ -0,0 +1,43 @@
+const NAMES = [
+    'PixelRect',
+    'GridGeometry',
+    'ResizeSpanBounds',
+    'computeGeometry',
+    'spanWidth',
+    'spanHeight',
+    'positionToPixelRect',
+    'rowsToPixelHeight',
+    'pixelRectsEqual',
+    'positionsEqual',
+    'SNAP_HYSTERESIS',
+    'hysteresisRound',
+    'resizeSpanBounds',
+    'clampResizeRect',
+    'snapResizeSpan',
+    'projectDragCell',
+    'FindCollisionOptions',
+    'AutoPlaceOptions',
+    'ClampPositionOptions',
+    'ResolveCollisionsOptions',
+    'RowFloors',
+    'CompactLayoutOptions',
+    'itemsCollide',
+    'findCollision',
+    'compactLayout',
+    'autoPlace',
+    'clampPosition',
+    'resolveCollisions',
+    'computeGridHeight',
+    'MapLayoutOptions',
+    'resolveBreakpoint',
+    'mapLayoutToBreakpoint',
+    'AutoScrollPointer',
+    'AutoScroller',
+    'findScrollableAncestor',
+    'createAutoScroller',
+];
+export const GRID_ENGINE_INTERNALS_REMOVALS = NAMES.map((name) => ({
+    name,
+    todo: `${name} is no longer exported; the grid layout engine is internal. Use the GridComponent inputs and outputs, createGridAdapter, or serializeGridLayout / deserializeGridLayout instead.`,
+}));
+//# sourceMappingURL=grid-engine-internals.js.map

package/generators/migrate-grid-engine-internals/migration.js

@@ -0,0 +1,11 @@
+import { runRemovedExportsMigration, } from '../removed-exports/run-removed-exports-migration.js';
+import { GRID_ENGINE_INTERNALS_REMOVALS } from './grid-engine-internals.js';
+export const GRID_ENGINE_INTERNALS_REPORT_PATH = 'grid-engine-internals-migration-tasks.md';
+export default async function migrateGridEngineInternals(tree, schema) {
+    await runRemovedExportsMigration(tree, schema, {
+        title: 'Removing the grid engine internals from @ethlete/components',
+        removed: GRID_ENGINE_INTERNALS_REMOVALS,
+        reportPath: GRID_ENGINE_INTERNALS_REPORT_PATH,
+    });
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-grid-engine-internals/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-grid-engine-internals",
+  "title": "Remove the grid engine internals from @ethlete/components and mark the uses it cannot remove",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-overlay-fullscreen-animation/migration.js

@@ -0,0 +1,11 @@
+import { runRemovedExportsMigration, } from '../removed-exports/run-removed-exports-migration.js';
+import { OVERLAY_FULLSCREEN_ANIMATION_REMOVALS } from './overlay-fullscreen-animation.js';
+export const OVERLAY_FULLSCREEN_ANIMATION_REPORT_PATH = 'overlay-fullscreen-animation-migration-tasks.md';
+export default async function migrateOverlayFullscreenAnimation(tree, schema) {
+    await runRemovedExportsMigration(tree, schema, {
+        title: 'Removing the overlay fullscreen animation internals from @ethlete/components',
+        removed: OVERLAY_FULLSCREEN_ANIMATION_REMOVALS,
+        reportPath: OVERLAY_FULLSCREEN_ANIMATION_REPORT_PATH,
+    });
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-overlay-fullscreen-animation/overlay-fullscreen-animation.js

@@ -0,0 +1,16 @@
+const NAMES = [
+    'ViewportTransformData',
+    'FullscreenAnimationCancellable',
+    'FullscreenAnimationState',
+    'FullscreenAnimationDeps',
+    'cleanupFullscreenAnimationStyles',
+    'startFullscreenEnterAnimation',
+    'startFullscreenLeaveAnimation',
+    'cleanupFullscreenAnimation',
+    'abortFullscreenAnimation',
+];
+export const OVERLAY_FULLSCREEN_ANIMATION_REMOVALS = NAMES.map((name) => ({
+    name,
+    todo: `${name} is no longer exported; the full-screen morph animation is internal to fullScreenDialogOverlayStrategy. Configure the strategy instead of driving the animation yourself.`,
+}));
+//# sourceMappingURL=overlay-fullscreen-animation.js.map

package/generators/migrate-overlay-fullscreen-animation/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-overlay-fullscreen-animation",
+  "title": "Remove the overlay fullscreen animation internals from @ethlete/components and mark the uses it cannot remove",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}

package/generators/migrate-overlay-nav-tab-imports/migration.js

@@ -0,0 +1,35 @@
+import { formatFiles, joinPathFragments } from '@nx/devkit';
+import { dirname } from 'node:path/posix';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { addOverlayNavTabImportsToFile, TEMPLATE_URL } from './overlay-nav-tab-imports.js';
+export default async function migrateOverlayNavTabImports(tree, schema) {
+    console.log('\n🔎 Adding OVERLAY_NAV_TAB_IMPORTS where a NAV_TAB_IMPORTS component renders et-overlay-nav-tab-link...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const changed = [];
+    scope.visit(tree, (filePath) => {
+        if (!filePath.endsWith('.ts') || filePath.endsWith('.d.ts'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content?.includes('NAV_TAB_IMPORTS'))
+            return;
+        const templates = [...content.matchAll(TEMPLATE_URL)]
+            .map((match) => tree.read(joinPathFragments(dirname(filePath), match[1] ?? ''), 'utf-8'))
+            .filter((template) => template !== null);
+        const next = addOverlayNavTabImportsToFile(content, templates);
+        if (next === null)
+            return;
+        tree.write(filePath, next);
+        changed.push(filePath);
+    });
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (changed.length > 0) {
+        console.log(`\n✅ Added OVERLAY_NAV_TAB_IMPORTS in ${changed.length} file(s).`);
+    }
+    else {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-overlay-nav-tab-imports/overlay-nav-tab-imports.js

@@ -0,0 +1,25 @@
+const COMPONENTS_IMPORT = /import\s*\{([^}]*)\}\s*from\s*['"]@ethlete\/components['"]/g;
+const NAV_TAB_IMPORTS = /\bNAV_TAB_IMPORTS\b/;
+const OVERLAY_LINK = 'et-overlay-nav-tab-link';
+export const TEMPLATE_URL = /templateUrl\s*:\s*['"]([^'"]+)['"]/g;
+/**
+ * Returns the file with `OVERLAY_NAV_TAB_IMPORTS` added next to every `NAV_TAB_IMPORTS`, or `null` when the
+ * file does not import `NAV_TAB_IMPORTS` from `@ethlete/components` or none of its templates renders an
+ * `et-overlay-nav-tab-link`.
+ */
+export const addOverlayNavTabImportsToFile = (content, externalTemplates) => {
+    if (content.includes('OVERLAY_NAV_TAB_IMPORTS'))
+        return null;
+    const importStatement = [...content.matchAll(COMPONENTS_IMPORT)].find((match) => NAV_TAB_IMPORTS.test(match[1] ?? '') && !/\bNAV_TAB_IMPORTS\s+as\b/.test(match[1] ?? ''));
+    if (!importStatement || importStatement.index === undefined)
+        return null;
+    if (!content.includes(OVERLAY_LINK) && !externalTemplates.some((template) => template.includes(OVERLAY_LINK))) {
+        return null;
+    }
+    const start = importStatement.index;
+    const end = start + importStatement[0].length;
+    const rewrittenImport = importStatement[0].replace(NAV_TAB_IMPORTS, 'NAV_TAB_IMPORTS, OVERLAY_NAV_TAB_IMPORTS');
+    const addNextToUsage = (code) => code.replace(/(\.\.\.)?\bNAV_TAB_IMPORTS\b/g, (_, spread) => `${spread ?? ''}NAV_TAB_IMPORTS, ${spread ?? ''}OVERLAY_NAV_TAB_IMPORTS`);
+    return addNextToUsage(content.slice(0, start)) + rewrittenImport + addNextToUsage(content.slice(end));
+};
+//# sourceMappingURL=overlay-nav-tab-imports.js.map

package/generators/migrate-overlay-nav-tab-imports/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-overlay-nav-tab-imports",
+  "title": "Add OVERLAY_NAV_TAB_IMPORTS where a NAV_TAB_IMPORTS component renders et-overlay-nav-tab-link",
+  "type": "object",
+  "properties": {
+    "projects": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Nx projects to scan. Defaults to every project in the workspace.",
+      "alias": "project"
+    },
+    "include": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Path prefixes to scan, relative to the workspace root (e.g. 'apps/shop'). Unioned with `projects`.",
+      "alias": "includePath"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files after migration",
+      "default": false
+    }
+  },
+  "required": []
+}