recker 1.0.43 → 1.0.44

package/dist/browser/seo/rules/cwv.js

@@ -0,0 +1,248 @@
+import { createResult } from './types.js';
+export const cwvRules = [
+    {
+        id: 'cwv-lcp-hero-image',
+        name: 'LCP Hero Image',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Hero images should be optimized for fast LCP',
+        check: (ctx) => {
+            if (!ctx.lcpCandidate) {
+                return createResult({ id: 'cwv-lcp-hero-image', name: 'LCP Hero Image', category: 'performance', severity: 'warning' }, 'info', 'No LCP candidate detected', { recommendation: 'Ensure the page has a hero image or prominent content element' });
+            }
+            const issues = [];
+            if (ctx.lcpCandidate.loading === 'lazy') {
+                issues.push('LCP image has loading="lazy" (should be eager or omitted)');
+            }
+            if (!ctx.lcpCandidate.fetchpriority) {
+                issues.push('Missing fetchpriority="high" on LCP image');
+            }
+            if (!ctx.hasLcpPreload) {
+                issues.push('LCP image not preloaded');
+            }
+            if (issues.length > 0) {
+                return createResult({ id: 'cwv-lcp-hero-image', name: 'LCP Hero Image', category: 'performance', severity: 'warning' }, 'warn', `LCP optimization issues: ${issues.length} found`, {
+                    recommendation: 'Optimize LCP image loading',
+                    evidence: {
+                        found: issues,
+                        expected: 'LCP image with fetchpriority="high", no lazy loading, and preload link',
+                        example: `<link rel="preload" as="image" href="hero.webp" fetchpriority="high">
+<img src="hero.webp" fetchpriority="high" alt="Hero">`,
+                        impact: 'LCP is a Core Web Vital - aim for < 2.5s',
+                        learnMore: 'https://web.dev/lcp/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-lcp-hero-image', name: 'LCP Hero Image', category: 'performance', severity: 'warning' }, 'pass', 'LCP image appears optimized');
+        },
+    },
+    {
+        id: 'cwv-lcp-text-visible',
+        name: 'LCP Text Visibility',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Text LCP elements should render immediately without font blocking',
+        check: (ctx) => {
+            if (!ctx.webFonts || ctx.webFonts.length === 0) {
+                return createResult({ id: 'cwv-lcp-text-visible', name: 'LCP Text Visibility', category: 'performance', severity: 'warning' }, 'info', 'No web fonts detected', { recommendation: 'No custom web fonts to analyze' });
+            }
+            const blockingFonts = ctx.webFonts.filter(f => !f.hasSwap && !f.hasOptional);
+            if (blockingFonts.length > 0) {
+                return createResult({ id: 'cwv-lcp-text-visible', name: 'LCP Text Visibility', category: 'performance', severity: 'warning' }, 'warn', `${blockingFonts.length} web font(s) may block text rendering`, {
+                    recommendation: 'Use font-display: swap or optional for web fonts',
+                    evidence: {
+                        found: blockingFonts.map(f => f.family).filter(Boolean).slice(0, 3),
+                        expected: 'font-display: swap or font-display: optional',
+                        example: '@font-face { font-display: swap; }',
+                        impact: 'Blocking fonts delay LCP for text elements',
+                        learnMore: 'https://web.dev/font-display/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-lcp-text-visible', name: 'LCP Text Visibility', category: 'performance', severity: 'warning' }, 'pass', 'Web fonts use non-blocking display');
+        },
+    },
+    {
+        id: 'cwv-render-blocking-css',
+        name: 'Render-Blocking CSS',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Minimize render-blocking CSS for faster LCP',
+        check: (ctx) => {
+            if (ctx.renderBlockingStylesheets === undefined) {
+                return createResult({ id: 'cwv-render-blocking-css', name: 'Render-Blocking CSS', category: 'performance', severity: 'warning' }, 'info', 'Unable to check render-blocking CSS (data unavailable)', { recommendation: 'Ensure CSS resource analysis completed' });
+            }
+            if (ctx.renderBlockingStylesheets > 3) {
+                return createResult({ id: 'cwv-render-blocking-css', name: 'Render-Blocking CSS', category: 'performance', severity: 'warning' }, 'warn', `${ctx.renderBlockingStylesheets} render-blocking stylesheets`, {
+                    recommendation: 'Reduce render-blocking CSS or use critical CSS inline',
+                    evidence: {
+                        found: ctx.renderBlockingStylesheets,
+                        expected: '1-3 stylesheets or inline critical CSS',
+                        example: '<style>/* critical CSS */</style>\n<link rel="stylesheet" href="main.css" media="print" onload="this.media=\'all\'">',
+                        impact: 'Each blocking stylesheet delays first paint',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-render-blocking-css', name: 'Render-Blocking CSS', category: 'performance', severity: 'warning' }, 'pass', `${ctx.renderBlockingStylesheets} render-blocking stylesheet(s)`);
+        },
+    },
+    {
+        id: 'cwv-render-blocking-js',
+        name: 'Render-Blocking JavaScript',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Scripts in head should use async or defer',
+        check: (ctx) => {
+            if (ctx.renderBlockingScripts === undefined) {
+                return createResult({ id: 'cwv-render-blocking-js', name: 'Render-Blocking JavaScript', category: 'performance', severity: 'warning' }, 'info', 'Unable to check render-blocking scripts (data unavailable)', { recommendation: 'Ensure script analysis completed' });
+            }
+            if (ctx.renderBlockingScripts > 0) {
+                return createResult({ id: 'cwv-render-blocking-js', name: 'Render-Blocking JavaScript', category: 'performance', severity: 'warning' }, 'warn', `${ctx.renderBlockingScripts} render-blocking script(s) in <head>`, {
+                    recommendation: 'Add async or defer to scripts, or move to end of body',
+                    evidence: {
+                        found: ctx.renderBlockingScripts,
+                        expected: 'Scripts with async, defer, or type="module"',
+                        example: '<script src="app.js" defer></script>',
+                        impact: 'Blocking scripts delay HTML parsing and LCP',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-render-blocking-js', name: 'Render-Blocking JavaScript', category: 'performance', severity: 'warning' }, 'pass', 'No render-blocking scripts in head');
+        },
+    },
+    {
+        id: 'cwv-cls-image-dimensions',
+        name: 'Image Dimensions',
+        category: 'performance',
+        severity: 'warning',
+        description: 'Images should have explicit width and height to prevent layout shift',
+        check: (ctx) => {
+            if (ctx.imagesMissingDimensions === undefined) {
+                return createResult({ id: 'cwv-cls-image-dimensions', name: 'Image Dimensions', category: 'performance', severity: 'warning' }, 'info', 'Unable to check image dimensions (data unavailable)', { recommendation: 'Ensure image analysis completed' });
+            }
+            if (ctx.imagesMissingDimensions > 0) {
+                const total = ctx.totalImages || 0;
+                const percent = total > 0 ? Math.round((ctx.imagesMissingDimensions / total) * 100) : 0;
+                return createResult({ id: 'cwv-cls-image-dimensions', name: 'Image Dimensions', category: 'performance', severity: 'warning' }, 'warn', `${ctx.imagesMissingDimensions} image(s) missing width/height (${percent}%)`, {
+                    recommendation: 'Add explicit width and height attributes to all images',
+                    evidence: {
+                        found: `${ctx.imagesMissingDimensions} of ${total} images`,
+                        expected: 'width and height on all <img> elements',
+                        example: '<img src="photo.jpg" width="800" height="600" alt="...">',
+                        impact: 'Missing dimensions cause layout shift when images load',
+                        learnMore: 'https://web.dev/cls/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-cls-image-dimensions', name: 'Image Dimensions', category: 'performance', severity: 'warning' }, 'pass', 'All images have dimensions');
+        },
+    },
+    {
+        id: 'cwv-cls-aspect-ratio',
+        name: 'Aspect Ratio CSS',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use CSS aspect-ratio for responsive media containers',
+        check: (ctx) => {
+            if (!ctx.hasAspectRatioCss && ctx.hasResponsiveImages) {
+                return createResult({ id: 'cwv-cls-aspect-ratio', name: 'Aspect Ratio CSS', category: 'performance', severity: 'info' }, 'info', 'Consider using CSS aspect-ratio for media containers', {
+                    recommendation: 'Use aspect-ratio CSS property for responsive containers',
+                    evidence: {
+                        example: '.video-container { aspect-ratio: 16 / 9; }',
+                        impact: 'Reserves space before media loads, preventing CLS',
+                        learnMore: 'https://web.dev/aspect-ratio/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-cls-aspect-ratio', name: 'Aspect Ratio CSS', category: 'performance', severity: 'info' }, 'pass', 'Aspect ratio handling is appropriate');
+        },
+    },
+    {
+        id: 'cwv-cls-font-fallback',
+        name: 'Font Fallback Metrics',
+        category: 'performance',
+        severity: 'info',
+        description: 'Web fonts should have size-matched fallbacks',
+        check: (ctx) => {
+            if (!ctx.webFonts || ctx.webFonts.length === 0) {
+                return createResult({ id: 'cwv-cls-font-fallback', name: 'Font Fallback Metrics', category: 'performance', severity: 'info' }, 'info', 'No web fonts to check', { recommendation: 'No custom web fonts detected' });
+            }
+            const fontsWithoutMetrics = ctx.webFonts.filter(f => !f.hasSizeAdjust && !f.hasAscentOverride);
+            if (fontsWithoutMetrics.length > 0 && ctx.webFonts.length > 0) {
+                return createResult({ id: 'cwv-cls-font-fallback', name: 'Font Fallback Metrics', category: 'performance', severity: 'info' }, 'info', 'Web fonts may cause layout shift during swap', {
+                    recommendation: 'Use size-adjust or metric overrides for fallback fonts',
+                    evidence: {
+                        example: `@font-face {
+  font-family: 'Custom Font';
+  src: url('custom.woff2') format('woff2');
+  font-display: swap;
+  size-adjust: 92%;  /* Match fallback metrics */
+}`,
+                        impact: 'Font swapping can cause visible layout shift',
+                        learnMore: 'https://web.dev/css-size-adjust/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-cls-font-fallback', name: 'Font Fallback Metrics', category: 'performance', severity: 'info' }, 'pass', 'Font fallback metrics configured');
+        },
+    },
+    {
+        id: 'cwv-resource-hints',
+        name: 'Resource Hints',
+        category: 'performance',
+        severity: 'info',
+        description: 'Use resource hints to speed up critical resources',
+        check: (ctx) => {
+            const hints = [];
+            if (!ctx.hasPreconnect && ctx.externalOrigins && ctx.externalOrigins > 2) {
+                hints.push('preconnect for critical third-party origins');
+            }
+            if (!ctx.hasDnsPrefetch && ctx.externalOrigins && ctx.externalOrigins > 3) {
+                hints.push('dns-prefetch for secondary origins');
+            }
+            if (!ctx.hasPreload && ctx.hasCriticalResources) {
+                hints.push('preload for critical CSS/fonts/images');
+            }
+            if (hints.length > 0) {
+                return createResult({ id: 'cwv-resource-hints', name: 'Resource Hints', category: 'performance', severity: 'info' }, 'info', `Consider adding: ${hints.join(', ')}`, {
+                    recommendation: 'Add resource hints in <head> for faster loading',
+                    evidence: {
+                        expected: hints,
+                        example: `<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="dns-prefetch" href="https://analytics.example.com">
+<link rel="preload" as="font" href="/fonts/main.woff2" crossorigin>`,
+                        learnMore: 'https://web.dev/preconnect-and-dns-prefetch/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-resource-hints', name: 'Resource Hints', category: 'performance', severity: 'info' }, 'pass', 'Resource hints configured');
+        },
+    },
+    {
+        id: 'cwv-critical-css',
+        name: 'Critical CSS',
+        category: 'performance',
+        severity: 'info',
+        description: 'Inline critical CSS for above-the-fold content',
+        check: (ctx) => {
+            if (ctx.hasInlineCriticalCss) {
+                return createResult({ id: 'cwv-critical-css', name: 'Critical CSS', category: 'performance', severity: 'info' }, 'pass', 'Inline critical CSS detected');
+            }
+            if (ctx.renderBlockingStylesheets && ctx.renderBlockingStylesheets > 0) {
+                return createResult({ id: 'cwv-critical-css', name: 'Critical CSS', category: 'performance', severity: 'info' }, 'info', 'Consider inlining critical CSS', {
+                    recommendation: 'Inline critical CSS in <head> and defer non-critical styles',
+                    evidence: {
+                        example: `<style>
+  /* Critical above-the-fold styles */
+  body { margin: 0; font-family: system-ui; }
+</style>
+<link rel="stylesheet" href="main.css" media="print" onload="this.media='all'">`,
+                        impact: 'Critical CSS eliminates render-blocking stylesheets',
+                        learnMore: 'https://web.dev/extract-critical-css/',
+                    },
+                });
+            }
+            return createResult({ id: 'cwv-critical-css', name: 'Critical CSS', category: 'performance', severity: 'info' }, 'info', 'No render-blocking stylesheets to optimize', { recommendation: 'Page has no render-blocking CSS' });
+        },
+    },
+];

package/dist/browser/seo/rules/ecommerce.d.ts

@@ -0,0 +1,2 @@
+import { SeoRule } from './types.js';
+export declare const ecommerceRules: SeoRule[];

package/dist/browser/seo/rules/ecommerce.js

@@ -0,0 +1,312 @@
+import { createResult } from './types.js';
+export const ecommerceRules = [
+    {
+        id: 'ecommerce-product-schema',
+        name: 'Product Schema',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'Product pages should have Product schema for rich snippets',
+        check: (ctx) => {
+            if (!ctx.isProductPage) {
+                return createResult({ id: 'ecommerce-product-schema', name: 'Product Schema', category: 'structured-data', severity: 'warning' }, 'info', 'Not a product page', {
+                    recommendation: 'Add Product schema if this is a product page',
+                });
+            }
+            if (!ctx.jsonLdTypes) {
+                return createResult({ id: 'ecommerce-product-schema', name: 'Product Schema', category: 'structured-data', severity: 'warning' }, 'warn', 'Product page has no JSON-LD structured data', {
+                    recommendation: 'Add Product structured data for rich snippets',
+                    evidence: {
+                        found: 'No JSON-LD structured data',
+                        expected: 'Product schema with name, image, price, availability',
+                        impact: 'Missing product schema prevents rich snippets in search results',
+                        example: `<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "Product",
+  "name": "Product Name",
+  "image": "https://example.com/image.jpg",
+  "offers": {
+    "@type": "Offer",
+    "price": "99.99",
+    "priceCurrency": "USD"
+  }
+}
+</script>`,
+                    },
+                });
+            }
+            const hasProduct = ctx.jsonLdTypes.includes('Product');
+            if (!hasProduct) {
+                return createResult({ id: 'ecommerce-product-schema', name: 'Product Schema', category: 'structured-data', severity: 'warning' }, 'warn', 'Product page missing Product schema', {
+                    recommendation: 'Add Product structured data for rich snippets in search results',
+                    evidence: {
+                        expected: 'Product schema with name, image, price, availability',
+                        example: `{
+  "@type": "Product",
+  "name": "Product Name",
+  "image": "https://example.com/image.jpg",
+  "offers": {
+    "@type": "Offer",
+    "price": "99.99",
+    "priceCurrency": "USD",
+    "availability": "https://schema.org/InStock"
+  }
+}`,
+                        learnMore: 'https://developers.google.com/search/docs/appearance/structured-data/product',
+                    },
+                });
+            }
+            return createResult({ id: 'ecommerce-product-schema', name: 'Product Schema', category: 'structured-data', severity: 'warning' }, 'pass', 'Product schema found');
+        },
+    },
+    {
+        id: 'ecommerce-product-price',
+        name: 'Product Price',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'Product schema should include price information',
+        check: (ctx) => {
+            if (!ctx.productSchema) {
+                return createResult({ id: 'ecommerce-product-price', name: 'Product Price', category: 'structured-data', severity: 'warning' }, 'info', 'Not applicable (no Product schema)', {
+                    recommendation: 'Add Product schema first, then include price information',
+                });
+            }
+            const hasPrice = ctx.productSchema.offers?.price !== undefined ||
+                ctx.productSchema.offers?.lowPrice !== undefined;
+            const hasCurrency = ctx.productSchema.offers?.priceCurrency !== undefined;
+            if (!hasPrice) {
+                return createResult({ id: 'ecommerce-product-price', name: 'Product Price', category: 'structured-data', severity: 'warning' }, 'warn', 'Product schema missing price', {
+                    recommendation: 'Add price to Product offers for price display in search results',
+                    evidence: {
+                        found: 'Product offers without price',
+                        expected: 'offers.price or offers.lowPrice with priceCurrency',
+                        impact: 'Products without price may not show in Google Shopping results',
+                        example: '"offers": {\n  "@type": "Offer",\n  "price": "99.99",\n  "priceCurrency": "USD"\n}',
+                    },
+                });
+            }
+            if (!hasCurrency) {
+                return createResult({ id: 'ecommerce-product-price', name: 'Product Price', category: 'structured-data', severity: 'warning' }, 'warn', 'Product schema missing currency', {
+                    recommendation: 'Add priceCurrency (e.g., USD, EUR, BRL) to offers',
+                    evidence: {
+                        found: `price: ${ctx.productSchema.offers?.price}`,
+                        expected: 'priceCurrency: "USD" or similar ISO 4217 code',
+                        impact: 'Currency is required for Google Shopping and price display in search results',
+                        example: '"priceCurrency": "USD"',
+                    },
+                });
+            }
+            return createResult({ id: 'ecommerce-product-price', name: 'Product Price', category: 'structured-data', severity: 'warning' }, 'pass', `Price: ${ctx.productSchema.offers?.priceCurrency} ${ctx.productSchema.offers?.price || ctx.productSchema.offers?.lowPrice}`);
+        },
+    },
+    {
+        id: 'ecommerce-product-availability',
+        name: 'Product Availability',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Product schema should include availability status',
+        check: (ctx) => {
+            if (!ctx.productSchema?.offers) {
+                return createResult({ id: 'ecommerce-product-availability', name: 'Product Availability', category: 'structured-data', severity: 'info' }, 'info', 'Not applicable (no Product offers schema)', {
+                    recommendation: 'Add Product schema with offers to include availability',
+                });
+            }
+            const availability = ctx.productSchema.offers.availability;
+            if (!availability) {
+                return createResult({ id: 'ecommerce-product-availability', name: 'Product Availability', category: 'structured-data', severity: 'info' }, 'info', 'Product schema missing availability', {
+                    recommendation: 'Add availability to help users know if product is in stock',
+                    evidence: {
+                        expected: 'availability: "https://schema.org/InStock" or similar',
+                        example: 'InStock, OutOfStock, PreOrder, BackOrder, Discontinued',
+                        learnMore: 'https://schema.org/ItemAvailability',
+                    },
+                });
+            }
+            const availType = availability.replace('https://schema.org/', '').replace('http://schema.org/', '');
+            return createResult({ id: 'ecommerce-product-availability', name: 'Product Availability', category: 'structured-data', severity: 'info' }, 'pass', `Availability: ${availType}`);
+        },
+    },
+    {
+        id: 'ecommerce-product-image',
+        name: 'Product Image',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'Product schema should include high-quality images',
+        check: (ctx) => {
+            if (!ctx.productSchema) {
+                return createResult({ id: 'ecommerce-product-image', name: 'Product Image', category: 'structured-data', severity: 'warning' }, 'info', 'Not applicable (no Product schema)', {
+                    recommendation: 'Add Product schema first, then include images',
+                });
+            }
+            const hasImage = ctx.productSchema.image !== undefined;
+            if (!hasImage) {
+                return createResult({ id: 'ecommerce-product-image', name: 'Product Image', category: 'structured-data', severity: 'warning' }, 'warn', 'Product schema missing image', {
+                    recommendation: 'Add product images for visual search results',
+                    evidence: {
+                        found: 'Product schema without image',
+                        expected: 'At least one high-quality product image',
+                        impact: 'Products without images are less likely to appear in image search and shopping results',
+                        example: '"image": "https://example.com/product-image.jpg"',
+                    },
+                });
+            }
+            const imageCount = Array.isArray(ctx.productSchema.image)
+                ? ctx.productSchema.image.length
+                : 1;
+            return createResult({ id: 'ecommerce-product-image', name: 'Product Image', category: 'structured-data', severity: 'warning' }, 'pass', `${imageCount} product image(s) in schema`);
+        },
+    },
+    {
+        id: 'ecommerce-product-reviews',
+        name: 'Product Reviews',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Product schema can include aggregate ratings for star snippets',
+        check: (ctx) => {
+            if (!ctx.productSchema) {
+                return createResult({ id: 'ecommerce-product-reviews', name: 'Product Reviews', category: 'structured-data', severity: 'info' }, 'info', 'Not applicable (no Product schema)', {
+                    recommendation: 'Add Product schema first, then include reviews/ratings',
+                });
+            }
+            const hasRating = ctx.productSchema.aggregateRating !== undefined;
+            const hasReviews = ctx.productSchema.review !== undefined;
+            if (!hasRating && !hasReviews) {
+                return createResult({ id: 'ecommerce-product-reviews', name: 'Product Reviews', category: 'structured-data', severity: 'info' }, 'info', 'Product schema has no reviews or ratings', {
+                    recommendation: 'Add aggregateRating for star ratings in search results',
+                    evidence: {
+                        example: `"aggregateRating": {
+  "@type": "AggregateRating",
+  "ratingValue": "4.5",
+  "reviewCount": "42"
+}`,
+                        impact: 'Star ratings in search results can improve click-through rate by 20-30%',
+                    },
+                });
+            }
+            if (hasRating && ctx.productSchema.aggregateRating) {
+                const rating = ctx.productSchema.aggregateRating;
+                return createResult({ id: 'ecommerce-product-reviews', name: 'Product Reviews', category: 'structured-data', severity: 'info' }, 'pass', `Rating: ${rating.ratingValue ?? '?'}/5 (${rating.reviewCount ?? rating.ratingCount ?? '?'} reviews)`);
+            }
+            return createResult({ id: 'ecommerce-product-reviews', name: 'Product Reviews', category: 'structured-data', severity: 'info' }, 'pass', 'Product has review data');
+        },
+    },
+    {
+        id: 'ecommerce-product-brand',
+        name: 'Product Brand',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Product schema should include brand information',
+        check: (ctx) => {
+            if (!ctx.productSchema) {
+                return createResult({ id: 'ecommerce-product-brand', name: 'Product Brand', category: 'structured-data', severity: 'info' }, 'info', 'Not applicable (no Product schema)', {
+                    recommendation: 'Add Product schema first, then include brand',
+                });
+            }
+            const hasBrand = ctx.productSchema.brand !== undefined;
+            if (!hasBrand) {
+                return createResult({ id: 'ecommerce-product-brand', name: 'Product Brand', category: 'structured-data', severity: 'info' }, 'info', 'Product schema missing brand', {
+                    recommendation: 'Add brand for better product identification',
+                    evidence: {
+                        example: `"brand": { "@type": "Brand", "name": "Brand Name" }`,
+                        impact: 'Brand helps Google understand product context for shopping queries',
+                    },
+                });
+            }
+            const brandName = typeof ctx.productSchema.brand === 'string'
+                ? ctx.productSchema.brand
+                : ctx.productSchema.brand?.name;
+            return createResult({ id: 'ecommerce-product-brand', name: 'Product Brand', category: 'structured-data', severity: 'info' }, 'pass', `Brand: ${brandName || 'specified'}`);
+        },
+    },
+    {
+        id: 'ecommerce-product-sku',
+        name: 'Product Identifiers',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Product schema should include unique identifiers (SKU, GTIN, MPN)',
+        check: (ctx) => {
+            if (!ctx.productSchema) {
+                return createResult({ id: 'ecommerce-product-sku', name: 'Product Identifiers', category: 'structured-data', severity: 'info' }, 'info', 'Not applicable (no Product schema)', {
+                    recommendation: 'Add Product schema first, then include identifiers',
+                });
+            }
+            const hasSku = ctx.productSchema.sku !== undefined;
+            const hasGtin = ctx.productSchema.gtin !== undefined ||
+                ctx.productSchema.gtin13 !== undefined ||
+                ctx.productSchema.gtin14 !== undefined ||
+                ctx.productSchema.gtin8 !== undefined;
+            const hasMpn = ctx.productSchema.mpn !== undefined;
+            const identifiers = [];
+            if (hasSku)
+                identifiers.push('SKU');
+            if (hasGtin)
+                identifiers.push('GTIN');
+            if (hasMpn)
+                identifiers.push('MPN');
+            if (identifiers.length === 0) {
+                return createResult({ id: 'ecommerce-product-sku', name: 'Product Identifiers', category: 'structured-data', severity: 'info' }, 'info', 'Product schema missing identifiers', {
+                    recommendation: 'Add SKU, GTIN, or MPN for better product matching',
+                    evidence: {
+                        expected: 'At least one of: sku, gtin, gtin13, gtin14, gtin8, mpn',
+                        impact: 'Product identifiers help Google match products across retailers',
+                        learnMore: 'https://support.google.com/merchants/answer/6324461',
+                    },
+                });
+            }
+            return createResult({ id: 'ecommerce-product-sku', name: 'Product Identifiers', category: 'structured-data', severity: 'info' }, 'pass', `Identifiers: ${identifiers.join(', ')}`);
+        },
+    },
+    {
+        id: 'ecommerce-offer-valid-dates',
+        name: 'Offer Valid Dates',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'Time-sensitive offers should have valid date ranges',
+        check: (ctx) => {
+            if (!ctx.productSchema?.offers) {
+                return createResult({ id: 'ecommerce-offer-valid-dates', name: 'Offer Valid Dates', category: 'structured-data', severity: 'info' }, 'info', 'Not applicable (no Product offers schema)', {
+                    recommendation: 'Add Product schema with offers to enable date validation',
+                });
+            }
+            const offers = ctx.productSchema.offers;
+            const priceValidUntil = offers.priceValidUntil;
+            const validThrough = offers.validThrough;
+            if (priceValidUntil) {
+                const endDate = new Date(priceValidUntil);
+                const now = new Date();
+                if (endDate < now) {
+                    return createResult({ id: 'ecommerce-offer-valid-dates', name: 'Offer Valid Dates', category: 'structured-data', severity: 'info' }, 'warn', 'Offer priceValidUntil date has passed', {
+                        recommendation: 'Update or remove expired priceValidUntil date',
+                        evidence: {
+                            found: priceValidUntil,
+                            expected: 'Future date or no priceValidUntil',
+                            impact: 'Expired dates may cause Google to distrust your pricing data',
+                            example: `"priceValidUntil": "${new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString().split('T')[0]}"`,
+                        },
+                    });
+                }
+            }
+            if (validThrough) {
+                const endDate = new Date(validThrough);
+                const now = new Date();
+                if (endDate < now) {
+                    return createResult({ id: 'ecommerce-offer-valid-dates', name: 'Offer Valid Dates', category: 'structured-data', severity: 'info' }, 'warn', 'Offer validThrough date has passed', {
+                        recommendation: 'Update or remove expired validThrough date',
+                        evidence: {
+                            found: validThrough,
+                            expected: 'Future date or no validThrough',
+                            impact: 'Expired validity dates may prevent offer from showing in search results',
+                            example: `"validThrough": "${new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString().split('T')[0]}"`,
+                        },
+                    });
+                }
+            }
+            if (priceValidUntil || validThrough) {
+                return createResult({ id: 'ecommerce-offer-valid-dates', name: 'Offer Valid Dates', category: 'structured-data', severity: 'info' }, 'pass', 'Offer dates are valid');
+            }
+            return createResult({ id: 'ecommerce-offer-valid-dates', name: 'Offer Valid Dates', category: 'structured-data', severity: 'info' }, 'info', 'No offer date constraints specified', {
+                recommendation: 'Consider adding priceValidUntil for time-limited offers',
+            });
+        },
+    },
+];

package/dist/browser/seo/rules/i18n.d.ts

@@ -0,0 +1,2 @@
+import { SeoRule } from './types.js';
+export declare const i18nRules: SeoRule[];