@empline/preflight 1.1.31 → 1.1.32

package/dist/checks/listing-approval/seo-metadata-consistency.js

@@ -0,0 +1,408 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requires = exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+/**
+ * SEO Metadata Consistency Preflight
+ *
+ * Validates that SEO metadata is consistently generated and stored
+ * during the listing approval process. This ensures:
+ * 1. SEO-friendly filenames are generated with product attributes
+ * 2. Alt text, titles, descriptions, and captions are created
+ * 3. SEO fields are stored in the listing database record
+ * 4. Responsive image URLs are generated for all sizes
+ * 5. Blur placeholders are generated for progressive loading
+ *
+ * Critical for:
+ * - Google Image Search ranking
+ * - Social media sharing previews
+ * - Accessibility (screen readers)
+ * - Core Web Vitals (progressive loading)
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA - Required for plugin loader discovery
+exports.id = "listing-approval/seo-metadata-consistency";
+exports.name = "SEO Metadata Consistency";
+exports.description = "Validates SEO metadata generation and storage during approval";
+exports.category = "listing-approval";
+exports.blocking = true; // Critical for SEO
+exports.tags = ["listing", "approval", "seo", "filename", "responsive", "blur"];
+exports.requires = ["trading-card-system"];
+/**
+ * Files to validate for SEO metadata
+ */
+const FILES_TO_CHECK = {
+    imageManagement: "lib/image-management.ts",
+    approvalRoute: "app/api/admin/listings/approve/route.ts",
+    bulkApprovalRoute: "app/api/admin/listings/bulk-approve/route.ts",
+};
+/**
+ * Required patterns for SEO filename generation
+ */
+const FILENAME_PATTERNS = {
+    // Must have filename generation function
+    filenameGenerator: {
+        pattern: /generateCardFilename|generate\w*Filename/,
+        description: "SEO filename generator function",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must include year in filename
+    yearInFilename: {
+        pattern: /cardData\.year|data\.year|year,?\s*$/m,
+        description: "Year included in filename generation",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must include brand in filename
+    brandInFilename: {
+        pattern: /cardData\.brand|formatBrandName/,
+        description: "Brand included in filename generation",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must include player/featured in filename
+    featuredInFilename: {
+        pattern: /cardData\.featured|data\.featured|featured/,
+        description: "Featured player/name included in filename",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must include unique suffix (listing ID)
+    uniqueSuffix: {
+        pattern: /getListingIdSuffix|listingId\.slice|listing.*suffix/i,
+        description: "Unique listing ID suffix for filename uniqueness",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must sanitize filename
+    filenameSanitization: {
+        pattern: /sanitizeForFilename|sanitize.*filename/i,
+        description: "Filename sanitization for safe URLs",
+        critical: true,
+        files: ["imageManagement"],
+    },
+};
+/**
+ * Required patterns for SEO text generation
+ */
+const SEO_TEXT_PATTERNS = {
+    // Must generate alt text
+    altTextGeneration: {
+        pattern: /altText|alt_text|generateAltText|seoMetadata\.altText/i,
+        description: "Alt text generation for accessibility",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must generate title
+    titleGeneration: {
+        pattern: /seoMetadata\.title|imageTitle|generateTitle/i,
+        description: "SEO title generation for images",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must generate description
+    descriptionGeneration: {
+        pattern: /seoMetadata\.description|imageDescription|generateDescription/i,
+        description: "SEO description generation",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must generate caption
+    captionGeneration: {
+        pattern: /seoMetadata\.caption|imageCaption|generateCaption/i,
+        description: "Image caption generation",
+        critical: false,
+        files: ["imageManagement"],
+    },
+    // Must generate keywords
+    keywordsGeneration: {
+        pattern: /seoMetadata\.keywords|imageKeywords|generateKeywords/i,
+        description: "SEO keywords generation",
+        critical: false,
+        files: ["imageManagement"],
+    },
+};
+/**
+ * Required patterns for database storage
+ */
+const DATABASE_PATTERNS = {
+    // Must store alt texts
+    storeAltTexts: {
+        pattern: /imageAltTexts[,:\s]/,
+        description: "Alt texts stored in listing record",
+        critical: true,
+        files: ["approvalRoute", "bulkApprovalRoute"],
+    },
+    // Must store titles
+    storeTitles: {
+        pattern: /imageTitles[,:\s]/,
+        description: "Image titles stored in listing record",
+        critical: true,
+        files: ["approvalRoute", "bulkApprovalRoute"],
+    },
+    // Must store descriptions
+    storeDescriptions: {
+        pattern: /imageDescriptions[,:\s]/,
+        description: "Image descriptions stored in listing record",
+        critical: true,
+        files: ["approvalRoute", "bulkApprovalRoute"],
+    },
+    // Must store captions
+    storeCaptions: {
+        pattern: /imageCaptions[,:\s]/,
+        description: "Image captions stored in listing record",
+        critical: false,
+        files: ["approvalRoute"],
+    },
+};
+/**
+ * Required patterns for responsive images
+ */
+const RESPONSIVE_PATTERNS = {
+    // Must generate multiple sizes
+    multipleSizes: {
+        pattern: /original|large|medium|thumbnail|small/i,
+        description: "Multiple image sizes generated",
+        critical: true,
+        files: ["imageManagement"],
+    },
+    // Must return responsive URLs
+    responsiveUrls: {
+        pattern: /responsiveUrls|responsive.*urls/i,
+        description: "Responsive URLs returned from processing",
+        critical: true,
+        files: ["imageManagement", "approvalRoute"],
+    },
+    // Should generate WebP format
+    webpGeneration: {
+        pattern: /webp|\.webp/i,
+        description: "WebP format for modern browsers",
+        critical: false,
+        files: ["imageManagement"],
+    },
+};
+/**
+ * Required patterns for blur placeholders
+ */
+const BLUR_PATTERNS = {
+    // Must generate blur placeholder
+    blurGeneration: {
+        pattern: /blurPlaceholder|blur.*placeholder|generateBlur/i,
+        description: "Blur placeholder for progressive loading",
+        critical: false,
+        files: ["approvalRoute"],
+    },
+    // Must store blur data
+    blurStorage: {
+        pattern: /blurPlaceholder:\s*blurPlaceholderData|blurPlaceholder\s*}/i,
+        description: "Blur placeholder stored in listing metadata",
+        critical: false,
+        files: ["approvalRoute"],
+    },
+};
+async function run() {
+    console.log(`\n${console_chars_1.emoji.ruler} SEO METADATA CONSISTENCY VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const issues = [];
+    const fileContents = {};
+    // Load all files
+    for (const [key, relativePath] of Object.entries(FILES_TO_CHECK)) {
+        const filePath = path_1.default.join(process.cwd(), relativePath);
+        if (!fs_1.default.existsSync(filePath)) {
+            issues.push({
+                file: relativePath,
+                type: "file-missing",
+                pattern: "N/A",
+                description: `Required file not found: ${relativePath}`,
+                critical: true,
+            });
+            continue;
+        }
+        fileContents[key] = fs_1.default.readFileSync(filePath, "utf-8");
+    }
+    // Check filename patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking SEO filename generation...`);
+    for (const [name, check] of Object.entries(FILENAME_PATTERNS)) {
+        let found = false;
+        for (const fileKey of check.files) {
+            if (fileContents[fileKey] && check.pattern.test(fileContents[fileKey])) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            const fileNames = check.files.map((k) => FILES_TO_CHECK[k]).join(", ");
+            issues.push({
+                file: fileNames,
+                type: "missing",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Check SEO text patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking SEO text generation...`);
+    for (const [name, check] of Object.entries(SEO_TEXT_PATTERNS)) {
+        let found = false;
+        for (const fileKey of check.files) {
+            if (fileContents[fileKey] && check.pattern.test(fileContents[fileKey])) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            const fileNames = check.files.map((k) => FILES_TO_CHECK[k]).join(", ");
+            issues.push({
+                file: fileNames,
+                type: "missing",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Check database storage patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking database storage...`);
+    for (const [name, check] of Object.entries(DATABASE_PATTERNS)) {
+        let found = false;
+        for (const fileKey of check.files) {
+            if (fileContents[fileKey] && check.pattern.test(fileContents[fileKey])) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            const fileNames = check.files.map((k) => FILES_TO_CHECK[k]).join(", ");
+            issues.push({
+                file: fileNames,
+                type: "missing",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Check responsive image patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking responsive images...`);
+    for (const [name, check] of Object.entries(RESPONSIVE_PATTERNS)) {
+        let found = false;
+        for (const fileKey of check.files) {
+            if (fileContents[fileKey] && check.pattern.test(fileContents[fileKey])) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            const fileNames = check.files.map((k) => FILES_TO_CHECK[k]).join(", ");
+            issues.push({
+                file: fileNames,
+                type: "missing",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Check blur placeholder patterns
+    console.log(`\n${console_chars_1.emoji.search} Checking blur placeholders...`);
+    for (const [name, check] of Object.entries(BLUR_PATTERNS)) {
+        let found = false;
+        for (const fileKey of check.files) {
+            if (fileContents[fileKey] && check.pattern.test(fileContents[fileKey])) {
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            const fileNames = check.files.map((k) => FILES_TO_CHECK[k]).join(", ");
+            issues.push({
+                file: fileNames,
+                type: "missing",
+                pattern: name,
+                description: check.description,
+                critical: check.critical,
+            });
+            const icon = check.critical ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`   ${icon} Missing: ${check.description}`);
+        }
+        else {
+            console.log(`   ${console_chars_1.emoji.success} Found: ${check.description}`);
+        }
+    }
+    // Summary
+    const criticalIssues = issues.filter((i) => i.critical);
+    const warningIssues = issues.filter((i) => !i.critical);
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Critical issues: ${criticalIssues.length}`);
+    console.log(`   Warning issues: ${warningIssues.length}`);
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} SEO METADATA CONSISTENCY VALIDATION PASSED`);
+        console.log(`\nAll SEO metadata is correctly generated and stored.`);
+        return { success: true, errors: 0, warnings: 0 };
+    }
+    if (criticalIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Critical issues:`);
+        for (const issue of criticalIssues) {
+            console.log(`   ${issue.file}: ${issue.description}`);
+        }
+    }
+    if (warningIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} Warning issues:`);
+        for (const issue of warningIssues) {
+            console.log(`   ${issue.file}: ${issue.description}`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.info} SEO metadata requirements:`);
+    console.log(`   Filenames: year-brand-player-cardnumber-grade-sport-side-uniqueid.jpg`);
+    console.log(`   Alt Text: Descriptive text for screen readers and Google`);
+    console.log(`   Titles: SEO-friendly image titles`);
+    console.log(`   Descriptions: Detailed product description`);
+    console.log(`   Responsive: original, large, medium, thumbnail sizes`);
+    console.log(`   Blur: Base64 placeholder for progressive loading`);
+    if (criticalIssues.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} SEO METADATA CONSISTENCY VALIDATION FAILED`);
+        return { success: false, errors: criticalIssues.length, warnings: warningIssues.length };
+    }
+    console.log(`\n${console_chars_1.emoji.warning} SEO METADATA CONSISTENCY VALIDATION PASSED WITH WARNINGS`);
+    return { success: true, errors: 0, warnings: warningIssues.length };
+}
+// Allow direct execution
+if (require.main === module) {
+    run()
+        .then((result) => {
+        process.exit(result.success ? 0 : 1);
+    })
+        .catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=seo-metadata-consistency.js.map

package/dist/checks/listing-approval/seo-metadata-consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-metadata-consistency.js","sourceRoot":"","sources":["../../../src/checks/listing-approval/seo-metadata-consistency.ts"],"names":[],"mappings":"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"}

package/dist/checks/ui/batch-progress-consistency.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export declare const id = "ui/batch-progress-consistency";
+export declare const name = "Batch Progress Consistency";
+export declare const description = "Validates integration batch operations show proper progress feedback";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const tags: string[];
+export declare function run(): Promise<{
+    success: boolean;
+    errors: number;
+    warnings: number;
+}>;
+//# sourceMappingURL=batch-progress-consistency.d.ts.map

package/dist/checks/ui/batch-progress-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-progress-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/batch-progress-consistency.ts"],"names":[],"mappings":";AAwBA,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,+BAA+B,CAAC;AACjD,eAAO,MAAM,WAAW,yEAAyE,CAAC;AAClG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAoD,CAAC;AA0EtE,wBAAsB,GAAG,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0G3F"}

package/dist/checks/ui/batch-progress-consistency.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+/**
+ * Batch Progress Consistency Preflight
+ *
+ * Validates that integration components with batch operations show
+ * proper progress feedback to users during long-running operations.
+ *
+ * Requirements for batch operations:
+ * 1. Must use a BatchLoadingState interface with progress tracking fields
+ * 2. Must update progress during batch operations (not just at start/end)
+ * 3. Must show LinearProgress for visual feedback
+ * 4. Must show StatusChip components for loaded/remaining counts
+ * 5. Must show current operation being processed
+ *
+ * This prevents the poor UX of showing a loading spinner with no progress
+ * indication while potentially thousands of items are being loaded.
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+// METADATA - Required for plugin loader discovery
+exports.id = "ui/batch-progress-consistency";
+exports.name = "Batch Progress Consistency";
+exports.description = "Validates integration batch operations show proper progress feedback";
+exports.category = "ui";
+exports.blocking = false; // Warning level - doesn't block build
+exports.tags = ["ui", "ux", "integrations", "progress", "batch"];
+/**
+ * File patterns to check for batch operations
+ */
+const INTEGRATION_PATTERNS = [
+    "components/**/steps/*.tsx",
+    "app/store/integrations/**/*.tsx",
+];
+/**
+ * Patterns that indicate a batch operation exists
+ */
+const BATCH_OPERATION_INDICATORS = [
+    /fetchAllProducts|fetchAllForBatch|selectAllIn|batchSelect|loadAll/i,
+    /loadingAllForBatch|batchLoading|isLoadingBatch/i,
+];
+/**
+ * Required patterns when batch operations are present
+ */
+const REQUIRED_BATCH_PATTERNS = {
+    // Progress state interface
+    progressState: {
+        pattern: /interface\s+\w*(?:Batch|Loading)\w*State\s*\{[\s\S]*?(?:loadedCount|processedCount|currentItem|currentCategory)[\s\S]*?\}/,
+        description: "BatchLoadingState interface with progress tracking fields",
+    },
+    // Progress updates during operation
+    progressUpdates: {
+        pattern: /setBatch(?:Loading)?State\s*\(\s*(?:\(prev\)|prev)\s*=>/,
+        description: "Progress updates during batch operation (using setState updater)",
+    },
+    // LinearProgress for visual feedback
+    linearProgress: {
+        pattern: /<LinearProgress[\s\S]*?variant="determinate"/,
+        description: "LinearProgress with determinate variant for visual progress",
+    },
+    // StatusChip for counts
+    statusChips: {
+        pattern: /<StatusChip[\s\S]*?(?:Loaded|Processed|Remaining|Failed)/,
+        description: "StatusChip components showing loaded/processed counts",
+    },
+    // Current item/category being processed
+    currentProcessing: {
+        pattern: /Processing:\s*\{|currentCategory|currentProduct|currentBatch/,
+        description: "Display of current item/category being processed",
+    },
+};
+/**
+ * Anti-patterns that suggest poor batch UX
+ */
+const BATCH_ANTI_PATTERNS = {
+    // Simple boolean loading state without progress
+    simpleBooleanLoading: {
+        pattern: /const\s*\[\s*loading(?:AllForBatch|Batch)\s*,\s*setLoading(?:AllForBatch|Batch)\s*\]\s*=\s*useState\s*<?\s*boolean\s*>?\s*\(\s*false\s*\)/,
+        description: "Simple boolean loading state (should use BatchLoadingState with progress)",
+        severity: "warning",
+    },
+    // Setting loading at start/end only
+    loadingOnlyStartEnd: {
+        pattern: /setLoading(?:AllForBatch|Batch)\s*\(\s*true\s*\)[\s\S]*?finally\s*\{[\s\S]*?setLoading(?:AllForBatch|Batch)\s*\(\s*false\s*\)/,
+        description: "Loading state only set at start/end (no progress updates during operation)",
+        severity: "warning",
+    },
+};
+async function run() {
+    console.log(`\n${console_chars_1.emoji.ruler} BATCH PROGRESS CONSISTENCY VALIDATION`);
+    console.log((0, console_chars_1.createDivider)(65, "heavy"));
+    const issues = [];
+    const filesWithBatchOps = [];
+    // Find all integration files
+    const allFiles = [];
+    for (const pattern of INTEGRATION_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, { cwd: process.cwd() });
+        allFiles.push(...matches);
+    }
+    const uniqueFiles = [...new Set(allFiles)];
+    console.log(`\n${console_chars_1.emoji.search} Scanning ${uniqueFiles.length} integration files...`);
+    // Check each file
+    for (const relativePath of uniqueFiles) {
+        const filePath = path_1.default.join(process.cwd(), relativePath);
+        if (!fs_1.default.existsSync(filePath))
+            continue;
+        const content = fs_1.default.readFileSync(filePath, "utf-8");
+        // Check if file has batch operations
+        const hasBatchOps = BATCH_OPERATION_INDICATORS.some((pattern) => pattern.test(content));
+        if (!hasBatchOps)
+            continue;
+        filesWithBatchOps.push(relativePath);
+        console.log(`   ${console_chars_1.emoji.file} ${relativePath} (has batch operations)`);
+        // Check for anti-patterns first
+        for (const [name, check] of Object.entries(BATCH_ANTI_PATTERNS)) {
+            if (check.pattern.test(content)) {
+                // Check if they also have the good patterns (upgraded from simple loading)
+                const hasProgressState = REQUIRED_BATCH_PATTERNS.progressState.pattern.test(content);
+                if (!hasProgressState) {
+                    issues.push({
+                        file: relativePath,
+                        type: "anti-pattern",
+                        description: `${name}: ${check.description}`,
+                        severity: check.severity,
+                    });
+                }
+            }
+        }
+        // Check for required patterns
+        for (const [name, check] of Object.entries(REQUIRED_BATCH_PATTERNS)) {
+            if (!check.pattern.test(content)) {
+                issues.push({
+                    file: relativePath,
+                    type: "missing",
+                    description: `Missing ${name}: ${check.description}`,
+                    severity: "warning",
+                });
+            }
+        }
+    }
+    // Summary
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Files with batch operations: ${filesWithBatchOps.length}`);
+    console.log(`   Issues found: ${issues.length}`);
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} BATCH PROGRESS CONSISTENCY VALIDATION PASSED`);
+        console.log(`\nAll integration batch operations have proper progress feedback.`);
+        return { success: true, errors: 0, warnings: 0 };
+    }
+    // Group issues by file
+    const issuesByFile = new Map();
+    for (const issue of issues) {
+        const fileIssues = issuesByFile.get(issue.file) || [];
+        fileIssues.push(issue);
+        issuesByFile.set(issue.file, fileIssues);
+    }
+    console.log(`\n${console_chars_1.emoji.warning} Issues found:`);
+    for (const [file, fileIssues] of issuesByFile) {
+        console.log(`\n   ${file}:`);
+        for (const issue of fileIssues) {
+            const icon = issue.severity === "error" ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`     ${icon} ${issue.description}`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.info} To fix batch progress issues:`);
+    console.log(`   1. Add a BatchLoadingState interface with these fields:`);
+    console.log(`      - isLoading: boolean`);
+    console.log(`      - loadedCount: number`);
+    console.log(`      - totalEstimate: number`);
+    console.log(`      - currentCategory/currentItem: string`);
+    console.log(`      - errors: string[]`);
+    console.log(`   2. Update progress DURING the batch loop, not just at start/end`);
+    console.log(`   3. Show LinearProgress with determinate variant`);
+    console.log(`   4. Show StatusChip components for loaded/remaining counts`);
+    console.log(`   5. Show which item/category is currently being processed`);
+    console.log(`\n   See components/woocommerce/steps/ProductSelectionStep.tsx for example.`);
+    // Exit with warning (non-blocking)
+    console.log(`\n${console_chars_1.emoji.warning} BATCH PROGRESS CONSISTENCY VALIDATION COMPLETED WITH WARNINGS`);
+    return { success: true, errors: 0, warnings: issues.length }; // Non-blocking - just warnings
+}
+// Allow direct execution
+if (require.main === module) {
+    run()
+        .then((result) => {
+        process.exit(result.success ? 0 : 1);
+    })
+        .catch((err) => {
+        console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=batch-progress-consistency.js.map

package/dist/checks/ui/batch-progress-consistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-progress-consistency.js","sourceRoot":"","sources":["../../../src/checks/ui/batch-progress-consistency.ts"],"names":[],"mappings":"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"}