@ethlete/components 1.0.0-next.32 → 1.0.0-next.33

package/generators/generators.json

@@ -1,5 +1,15 @@
 {
   "generators": {
+    "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-rich-text-editor-link-editor": {
+      "factory": "./migrate-rich-text-editor-link-editor/migration",
+      "schema": "./migrate-rich-text-editor-link-editor/schema.json",
+      "description": "Find rich text editor usage that loses the link editor popover and report where to re-opt-in"
+    },
     "icons": {
       "factory": "./icons/generator",
       "schema": "./icons/schema.json",

package/generators/migrate-query-error-labels/migration-scope.js

@@ -0,0 +1,30 @@
+import { getProjects, visitNotIgnoredFiles } from '@nx/devkit';
+const stripTrailingSlash = (value) => (value.endsWith('/') ? value.slice(0, -1) : value);
+export const createMigrationScope = (tree, options) => {
+    const roots = [];
+    for (const projectName of options.projects ?? []) {
+        const project = getProjects(tree).get(projectName);
+        if (!project) {
+            throw new Error(`Unknown project "${projectName}". Pass names as they appear in \`nx show projects\`, or use --include with a path prefix.`);
+        }
+        roots.push(stripTrailingSlash(project.root));
+    }
+    for (const includePath of options.include ?? []) {
+        roots.push(stripTrailingSlash(includePath));
+    }
+    if (roots.length === 0) {
+        return {
+            visit: (targetTree, callback) => visitNotIgnoredFiles(targetTree, '', callback),
+            describe: () => 'the whole workspace',
+        };
+    }
+    return {
+        visit: (targetTree, callback) => {
+            for (const root of roots) {
+                visitNotIgnoredFiles(targetTree, root, callback);
+            }
+        },
+        describe: () => roots.join(', '),
+    };
+};
+//# sourceMappingURL=migration-scope.js.map

package/generators/migrate-query-error-labels/migration.js

@@ -0,0 +1,58 @@
+import { formatFiles } from '@nx/devkit';
+import { createMigrationScope } from './migration-scope.js';
+import { scanQueryErrorLabelsInFile } from './query-error-labels.js';
+export const QUERY_ERROR_LABELS_REPORT_PATH = 'query-error-labels-migration-tasks.md';
+const renderReport = (tasks) => [
+    '# Query-error labels migration tasks',
+    '',
+    'Query-error titles and fallback messages no longer switch to German automatically when the locale is a',
+    'German one — the default is English-only, so an English-only app stops bundling the German status table.',
+    'Whether to bring German back is a product decision no codemod can make, so the sites below were found but',
+    'not changed.',
+    '',
+    'If the app should keep the old locale-driven wording, add once, app-wide:',
+    '',
+    '```ts',
+    "import { provideQueryErrorLabels, queryErrorLabelsForLocale } from '@ethlete/components';",
+    '',
+    'provideQueryErrorLabels(queryErrorLabelsForLocale);',
+    '```',
+    '',
+    'For German unconditionally, pass `GERMAN_QUERY_ERROR_LABELS` instead. If the app is English-only (or already',
+    'overrides the labels), there is nothing to do — delete this file.',
+    '',
+    ...tasks.map((task) => [`## \`${task.id}\``, '', `- ${task.file}:${task.line}`, `- ${task.message}`, ''].join('\n')),
+].join('\n');
+export default async function migrateQueryErrorLabels(tree, schema) {
+    console.log('\n🔎 Scanning for query-error usage affected by the English-only label default...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const tasks = [];
+    let hasLabelProvider = 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 = scanQueryErrorLabelsInFile(filePath, content);
+        tasks.push(...result.usages);
+        hasLabelProvider ||= result.hasLabelProvider;
+    });
+    if (hasLabelProvider) {
+        console.log('   ✓ Found a provideQueryErrorLabels call — the app already controls its wording.');
+    }
+    else if (tasks.length > 0) {
+        tree.write(QUERY_ERROR_LABELS_REPORT_PATH, renderReport(tasks));
+    }
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (!hasLabelProvider && tasks.length > 0) {
+        console.log(`\n⚠️  ${tasks.length} site(s) use query-error without a label provider — see ${QUERY_ERROR_LABELS_REPORT_PATH}.`);
+    }
+    else {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-query-error-labels/query-error-labels.js

@@ -0,0 +1,30 @@
+/**
+ * The query-error labels no longer resolve German automatically from the locale — the default is the
+ * English status tables only, and German is an explicit `provideQueryErrorLabels(queryErrorLabelsForLocale)`
+ * (or `GERMAN_QUERY_ERROR_LABELS`) opt-in. Whether an app wants German back is a product decision, so this
+ * migration only finds the affected sites and reports them; it rewrites nothing.
+ */
+const USAGE_MARKERS = [
+    'et-query-error',
+    'etQueryError',
+    'QueryErrorComponent',
+    'QueryErrorDirective',
+    'QUERY_ERROR_IMPORTS',
+    'injectQueryErrorLabels',
+];
+const OPT_IN_MARKER = 'provideQueryErrorLabels';
+export const scanQueryErrorLabelsInFile = (filePath, content) => {
+    const usages = [];
+    const marker = USAGE_MARKERS.find((m) => content.includes(m));
+    if (marker) {
+        const line = content.slice(0, content.indexOf(marker)).split('\n').length;
+        usages.push({
+            id: `query-error-labels--${filePath.replace(/[^a-zA-Z0-9]+/g, '-')}`,
+            file: filePath,
+            line,
+            message: `Uses the query-error UI (\`${marker}\`). Its titles and fallback messages are English-only by default now.`,
+        });
+    }
+    return { usages, hasLabelProvider: content.includes(OPT_IN_MARKER) };
+};
+//# sourceMappingURL=query-error-labels.js.map

package/generators/migrate-query-error-labels/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-query-error-labels",
+  "title": "Find apps affected by the query-error label default change (English-only)",
+  "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-rich-text-editor-link-editor/migration.js

@@ -0,0 +1,57 @@
+import { formatFiles } from '@nx/devkit';
+import { createMigrationScope } from '../migrate-query-error-labels/migration-scope.js';
+import { scanRichTextEditorLinkEditorInFile } from './rich-text-editor-link-editor.js';
+export const RICH_TEXT_EDITOR_LINK_EDITOR_REPORT_PATH = 'rich-text-editor-link-editor-migration-tasks.md';
+const renderReport = (tasks) => [
+    '# Rich text editor link editor migration tasks',
+    '',
+    'The rich text editor no longer mounts the link editor popover. Its `link` tool now falls back to the',
+    "browser's `prompt()`, so an editor that never opts in stops bundling the popover (and the form",
+    'controls and overlay strategies it pulls in).',
+    '',
+    'To keep the popover, add once — app-wide, or on the component/route that renders the editor:',
+    '',
+    '```ts',
+    "import { provideRichTextEditorLinkEditor } from '@ethlete/components';",
+    '',
+    'provideRichTextEditorLinkEditor();',
+    '```',
+    '',
+    'If the prompt fallback is fine (or the app never uses the `link` tool), there is nothing to do — delete',
+    'this file.',
+    '',
+    ...tasks.map((task) => [`## \`${task.id}\``, '', `- ${task.file}:${task.line}`, `- ${task.message}`, ''].join('\n')),
+].join('\n');
+export default async function migrateRichTextEditorLinkEditor(tree, schema) {
+    console.log('\n🔎 Scanning for rich text editor usage affected by the opt-in link editor...');
+    const scope = createMigrationScope(tree, schema);
+    console.log(`   Scope: ${scope.describe()}`);
+    const tasks = [];
+    let hasLinkEditorProvider = 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 = scanRichTextEditorLinkEditorInFile(filePath, content);
+        tasks.push(...result.usages);
+        hasLinkEditorProvider ||= result.hasLinkEditorProvider;
+    });
+    if (hasLinkEditorProvider) {
+        console.log('   ✓ Found a provideRichTextEditorLinkEditor call — the popover is already opted back in.');
+    }
+    else if (tasks.length > 0) {
+        tree.write(RICH_TEXT_EDITOR_LINK_EDITOR_REPORT_PATH, renderReport(tasks));
+    }
+    if (!schema.skipFormat) {
+        await formatFiles(tree);
+    }
+    if (!hasLinkEditorProvider && tasks.length > 0) {
+        console.log(`\n⚠️  ${tasks.length} site(s) use the rich text editor without the link editor — see ${RICH_TEXT_EDITOR_LINK_EDITOR_REPORT_PATH}.`);
+    }
+    else {
+        console.log('\n✅ Nothing to do.');
+    }
+}
+//# sourceMappingURL=migration.js.map

package/generators/migrate-rich-text-editor-link-editor/rich-text-editor-link-editor.js

@@ -0,0 +1,28 @@
+/**
+ * The rich text editor no longer mounts the link editor popover itself — it is an opt-in
+ * `provideRichTextEditorLinkEditor()`, and without it the `'link'` tool falls back to
+ * `window.prompt`. Whether an app wants the popover back is its own call, so this migration only
+ * finds the affected sites and reports them; it rewrites nothing.
+ */
+const USAGE_MARKERS = [
+    'et-rich-text-editor',
+    'RICH_TEXT_EDITOR_IMPORTS',
+    'RichTextEditorComponent',
+    'etRichTextEditor',
+];
+const OPT_IN_MARKER = 'provideRichTextEditorLinkEditor';
+export const scanRichTextEditorLinkEditorInFile = (filePath, content) => {
+    const usages = [];
+    const marker = USAGE_MARKERS.find((m) => content.includes(m));
+    if (marker) {
+        const line = content.slice(0, content.indexOf(marker)).split('\n').length;
+        usages.push({
+            id: `rich-text-editor-link-editor--${filePath.replace(/[^a-zA-Z0-9]+/g, '-')}`,
+            file: filePath,
+            line,
+            message: `Uses the rich text editor (\`${marker}\`). Its link tool opens \`window.prompt\` now unless the link editor popover is provided.`,
+        });
+    }
+    return { usages, hasLinkEditorProvider: content.includes(OPT_IN_MARKER) };
+};
+//# sourceMappingURL=rich-text-editor-link-editor.js.map

package/generators/migrate-rich-text-editor-link-editor/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "migrate-rich-text-editor-link-editor",
+  "title": "Find rich text editor usage affected by the opt-in link editor popover",
+  "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethlete/components",
-  "version": "1.0.0-next.32",
+  "version": "1.0.0-next.33",
   "license": "MIT",
   "sideEffects": false,
   "peerDependencies": {
@@ -20,8 +20,14 @@
     "rxjs": "7.8.2"
   },
   "peerDependenciesMeta": {
+    "@analogjs/vitest-angular": {
+      "optional": true
+    },
     "@nx/devkit": {
       "optional": true
+    },
+    "date-fns": {
+      "optional": true
     }
   },
   "generators": "./generators/generators.json",