@ethlete/components 1.0.0-next.62 → 1.0.0-next.64

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,11 @@
       "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-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"
+    },
     "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-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": []
+}

package/generators/migrate-youtube-player-slot-directive/migration.js

@@ -0,0 +1,11 @@
+import { runRemovedExportsMigration, } from '../removed-exports/run-removed-exports-migration.js';
+import { YOUTUBE_PLAYER_SLOT_DIRECTIVE_REMOVALS } from './youtube-player-slot-directive.js';
+export const YOUTUBE_PLAYER_SLOT_DIRECTIVE_REPORT_PATH = 'youtube-player-slot-directive-migration-tasks.md';
+export default async function migrateYoutubePlayerSlotDirective(tree, schema) {
+    return runRemovedExportsMigration(tree, schema, {
+        title: 'Removing YoutubePlayerSlotDirective and YOUTUBE_PLAYER_SLOT_TOKEN',
+        removed: YOUTUBE_PLAYER_SLOT_DIRECTIVE_REMOVALS,
+        reportPath: YOUTUBE_PLAYER_SLOT_DIRECTIVE_REPORT_PATH,
+    });
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-youtube-player-slot-directive/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-youtube-player-slot-directive",
+  "title": "Remove YoutubePlayerSlotDirective and YOUTUBE_PLAYER_SLOT_TOKEN, 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-youtube-player-slot-directive/youtube-player-slot-directive.js

@@ -0,0 +1,12 @@
+export const YOUTUBE_PLAYER_SLOT_DIRECTIVE_REMOVALS = [
+    {
+        name: 'YoutubePlayerSlotDirective',
+        dropFromArrays: ['imports'],
+        todo: 'YoutubePlayerSlotDirective is removed. Render <et-youtube-player-slot> (YoutubePlayerSlotComponent) or build a slot with createStreamPlayerSlot.',
+    },
+    {
+        name: 'YOUTUBE_PLAYER_SLOT_TOKEN',
+        todo: 'YOUTUBE_PLAYER_SLOT_TOKEN is removed. Query YoutubePlayerSlotComponent instead, or read the slot through STREAM_SLOT_PLAYER_ID_TOKEN.',
+    },
+];
+//# sourceMappingURL=youtube-player-slot-directive.js.map

package/generators/removed-exports/removed-exports.js

@@ -0,0 +1,154 @@
+export const MIGRATION_TODO = 'TODO(ethlete-migration)';
+const COMPONENTS_IMPORT = /import\s+(type\s+)?\{([^}]*)\}\s*from\s*['"]@ethlete\/components['"][ \t]*;?/g;
+const escape = (value) => value.replace(/[$]/g, '\\$');
+const useOf = (local) => new RegExp(`(?<![\\w$.])${escape(local)}(?![\\w$])`, 'g');
+const parseSpecifiers = (list) => list
+    .split(',')
+    .map((raw) => raw.trim())
+    .filter((raw) => raw.length > 0)
+    .map((raw) => {
+    const match = /^(type\s+)?([\w$]+)(?:\s+as\s+([\w$]+))?$/.exec(raw);
+    return {
+        raw,
+        imported: match?.[2] ?? raw,
+        local: match?.[3] ?? match?.[2] ?? raw,
+        typeOnly: match?.[1] !== undefined,
+    };
+});
+const printSpecifier = (specifier) => `${specifier.typeOnly ? 'type ' : ''}${specifier.imported}${specifier.local === specifier.imported ? '' : ` as ${specifier.local}`}`;
+const closingBracket = (content, open) => {
+    let depth = 0;
+    for (let index = open; index < content.length; index++) {
+        const char = content[index];
+        if (char === '[' || char === '(' || char === '{')
+            depth++;
+        if (char === ']' || char === ')' || char === '}')
+            depth--;
+        if (depth === 0)
+            return index;
+    }
+    return -1;
+};
+const splitTopLevel = (list) => {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let index = 0; index < list.length; index++) {
+        const char = list[index];
+        if (char === '[' || char === '(' || char === '{')
+            depth++;
+        if (char === ']' || char === ')' || char === '}')
+            depth--;
+        if (char === ',' && depth === 0) {
+            parts.push(list.slice(start, index));
+            start = index + 1;
+        }
+    }
+    parts.push(list.slice(start));
+    return parts;
+};
+const dropFromArray = (content, key, local) => {
+    const opening = new RegExp(`\\b${key}\\s*:\\s*\\[`, 'g');
+    let next = content;
+    let match;
+    while ((match = opening.exec(next)) !== null) {
+        const open = match.index + match[0].length - 1;
+        const close = closingBracket(next, open);
+        if (close === -1)
+            break;
+        const parts = splitTopLevel(next.slice(open + 1, close));
+        const kept = parts.filter((part) => part.trim() !== local);
+        if (kept.length === parts.length)
+            continue;
+        const elements = kept.map((part) => part.trim()).filter((part) => part.length > 0);
+        next = `${next.slice(0, open + 1)}${elements.join(', ')}${next.slice(close)}`;
+        opening.lastIndex = open + 1;
+    }
+    return next;
+};
+const markerFor = (todo) => `// ${MIGRATION_TODO}: ${todo}`;
+const addMarkers = (content, local, todo) => {
+    const marker = markerFor(todo);
+    const output = [];
+    for (const line of content.split('\n')) {
+        const code = line.trimStart();
+        const isComment = code.startsWith('//') || code.startsWith('*') || code.startsWith('/*');
+        if (!isComment && useOf(local).test(line) && output.at(-1)?.trim() !== marker) {
+            output.push(`${line.slice(0, line.length - code.length)}${marker}`);
+        }
+        output.push(line);
+    }
+    return output.join('\n');
+};
+/**
+ * Rewrites the named imports of removed `@ethlete/components` exports: renames the ones with a successor,
+ * drops a removed one from the arrays where it is safe to, and marks every use left with a
+ * `TODO(ethlete-migration)` comment. A marked name keeps its import, so the build points at it too.
+ */
+export const migrateRemovedExportsInFile = (filePath, content, removed) => {
+    const byName = new Map(removed.map((entry) => [entry.name, entry]));
+    const statements = [...content.matchAll(COMPONENTS_IMPORT)].filter((match) => parseSpecifiers(match[2] ?? '').some((specifier) => byName.has(specifier.imported)));
+    if (statements.length === 0)
+        return { next: null, tasks: [] };
+    const renames = [];
+    const dropped = [];
+    const placeholders = [];
+    let body = '';
+    let cursor = 0;
+    statements.forEach((statement, index) => {
+        const start = statement.index ?? 0;
+        body += content.slice(cursor, start) + `\uE000${index}\uE000`;
+        cursor = start + statement[0].length;
+        placeholders.push(statement[0]);
+    });
+    body += content.slice(cursor);
+    const specifiersOf = statements.map((statement) => parseSpecifiers(statement[2] ?? '').map((specifier) => {
+        const entry = byName.get(specifier.imported);
+        if (!entry)
+            return specifier;
+        if (entry.renameTo) {
+            if (specifier.local === specifier.imported)
+                renames.push([specifier.local, entry.renameTo]);
+            return {
+                ...specifier,
+                imported: entry.renameTo,
+                local: specifier.local === specifier.imported ? entry.renameTo : specifier.local,
+            };
+        }
+        dropped.push({ specifier, entry });
+        return specifier;
+    }));
+    for (const [from, to] of renames)
+        body = body.replace(useOf(from), to);
+    const removedLocals = new Set();
+    for (const { specifier, entry } of dropped) {
+        for (const key of entry.dropFromArrays ?? [])
+            body = dropFromArray(body, key, specifier.local);
+        if (useOf(specifier.local).test(body))
+            body = addMarkers(body, specifier.local, entry.todo);
+        else
+            removedLocals.add(specifier.local);
+    }
+    const next = body.replace(/\uE000(\d+)\uE000(\n?)/g, (_, index, newline) => {
+        const statement = statements[Number(index)];
+        const specifiers = (specifiersOf[Number(index)] ?? []).filter((specifier) => !removedLocals.has(specifier.local) || !byName.has(specifier.imported));
+        const original = placeholders[Number(index)] ?? '';
+        if (specifiers.length === 0)
+            return '';
+        const list = statement?.[2] ?? '';
+        const multiline = list.includes('\n');
+        const printed = multiline
+            ? `{\n${specifiers.map((specifier) => `  ${printSpecifier(specifier)},`).join('\n')}\n}`
+            : `{ ${specifiers.map(printSpecifier).join(', ')} }`;
+        return original.replace(/\{[^}]*\}/, printed) + newline;
+    });
+    const markers = new Map(dropped.map(({ entry }) => [markerFor(entry.todo), entry]));
+    const tasks = [];
+    next.split('\n').forEach((line, index) => {
+        const entry = markers.get(line.trim());
+        if (entry)
+            tasks.push({ file: filePath, line: index + 2, name: entry.name, message: entry.todo });
+    });
+    return { next: next === content ? null : next, tasks };
+};
+//# sourceMappingURL=removed-exports.js.map

package/generators/removed-exports/run-removed-exports-migration.js

@@ -0,0 +1,49 @@
+import { formatFiles } from '@nx/devkit';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { MIGRATION_TODO, migrateRemovedExportsInFile } from './removed-exports.js';
+const renderReport = (title, tasks) => [
+    `# ${title}`,
+    '',
+    `Each site below carries a \`// ${MIGRATION_TODO}\` comment the migration could not resolve. Fix it by hand, delete the comment, then delete this file.`,
+    '',
+    ...tasks.map((task) => `- ${task.file}:${task.line} - \`${task.name}\`: ${task.message}`),
+    '',
+].join('\n');
+export const runRemovedExportsMigration = async (tree, schema, migration) => {
+    console.log(`\n🔎 ${migration.title}...`);
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const changed = [];
+    const tasks = [];
+    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 scan = filePath.endsWith('.ts')
+            ? migrateRemovedExportsInFile(filePath, content, migration.removed)
+            : { next: null, tasks: [] };
+        const next = migration.rewrite?.(tree, filePath, scan.next ?? content) ?? scan.next;
+        tasks.push(...scan.tasks);
+        if (next !== null && next !== content) {
+            tree.write(filePath, next);
+            changed.push(filePath);
+        }
+    });
+    if (tasks.length > 0)
+        tree.write(migration.reportPath, renderReport(migration.title, tasks));
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (changed.length > 0)
+        console.log(`\n✅ Rewrote ${changed.length} file(s).`);
+    if (tasks.length > 0) {
+        console.warn(`\n⚠️  ${tasks.length} site(s) need a hand fix - search for ${MIGRATION_TODO}, or see ${migration.reportPath}.`);
+    }
+    else if (changed.length === 0) {
+        console.log('\n✅ Nothing to do.');
+    }
+    return { changed, tasks };
+};
+//# sourceMappingURL=run-removed-exports-migration.js.map

package/migrations.json

@@ -31,6 +31,38 @@
       "description": "Find the rich text editors that lose the selection toolbar, and report where to opt back in.",
       "generator": "@ethlete/components:migrate-rich-text-editor-floating-toolbar",
       "docs": "/components/rich-text-editor"
+    },
+    {
+      "name": "bracket-ethlete-renames",
+      "version": "1.0.0-next.64",
+      "kind": "auto",
+      "description": "Rename generateTournamentModeFormEthleteRounds to generateTournamentModeFromEthleteRounds.",
+      "generator": "@ethlete/components:migrate-bracket-ethlete-renames",
+      "docs": "/components/bracket"
+    },
+    {
+      "name": "bracket-default-cards",
+      "version": "1.0.0-next.64",
+      "kind": "auto",
+      "description": "Spread BRACKET_DEFAULT_CARDS into provideBracketConfig, and report the brackets that need it by hand.",
+      "generator": "@ethlete/components:migrate-bracket-default-cards",
+      "docs": "/components/bracket"
+    },
+    {
+      "name": "overlay-nav-tab-imports",
+      "version": "1.0.0-next.64",
+      "kind": "auto",
+      "description": "Add OVERLAY_NAV_TAB_IMPORTS where a NAV_TAB_IMPORTS component renders et-overlay-nav-tab-link.",
+      "generator": "@ethlete/components:migrate-overlay-nav-tab-imports",
+      "docs": "/components/tabs"
+    },
+    {
+      "name": "youtube-player-slot-directive",
+      "version": "1.0.0-next.64",
+      "kind": "auto",
+      "description": "Remove YoutubePlayerSlotDirective and YOUTUBE_PLAYER_SLOT_TOKEN, and mark the uses that need a YoutubePlayerSlotComponent.",
+      "generator": "@ethlete/components:migrate-youtube-player-slot-directive",
+      "docs": "/components/stream"
     }
   ]
 }