@salesforce/b2c-dx-mcp 2.0.0 → 2.1.1

package/dist/tools/storefrontnext/sfnext-development-guidelines.js

@@ -1,141 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Developer Guidelines tool for Storefront Next.
- *
- * Provides critical development guidelines and best practices for building
- * Storefront Next applications with React Server Components.
- *
- * @module tools/storefrontnext/sfnext-development-guidelines
- */
-import { readFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { z } from 'zod';
-import { createToolAdapter, textResult } from '../adapter.js';
-// Resolve the content directory from the package root
-// Uses createRequire to find the package.json location, which is robust
-// regardless of where this module is located in the build output
-const require = createRequire(import.meta.url);
-const packageRoot = path.dirname(require.resolve('@salesforce/b2c-dx-mcp/package.json'));
-const CONTENT_DIR = path.join(packageRoot, 'content', 'sfnext');
-/**
- * Section metadata with key and optional description.
- * Single source of truth for all available sections.
- */
-const SECTIONS_METADATA = [
-    { key: 'quick-reference', description: null }, // Meta-section, excluded from topics list
-    {
-        key: 'data-fetching',
-        description: 'server-only data loading (no client loaders), synchronous loaders for streaming, data fetching patterns',
-    },
-    { key: 'state-management', description: 'state management patterns' },
-    { key: 'auth', description: 'authentication and session management' },
-    { key: 'config', description: 'configuration' },
-    { key: 'i18n', description: 'i18n patterns and internationalization' },
-    { key: 'components', description: 'component best practices' },
-    { key: 'styling', description: 'Tailwind CSS 4, Shadcn/ui, styling guidelines' },
-    { key: 'page-designer', description: 'Page Designer integration' },
-    { key: 'performance', description: 'performance optimization' },
-    { key: 'testing', description: 'testing strategies' },
-    { key: 'extensions', description: 'framework extensions' },
-    { key: 'pitfalls', description: 'common pitfalls' },
-];
-/**
- * Derived: array of section keys for validation.
- */
-const _SECTIONS = SECTIONS_METADATA.map((s) => s.key);
-/**
- * Generates the topics list for the tool description.
- * Excludes meta-sections (like quick-reference) that don't have descriptions.
- * @returns Comma-separated list of topics
- */
-function generateTopicsList() {
-    return SECTIONS_METADATA.filter((s) => s.description !== null)
-        .map((s) => s.description)
-        .join(', ');
-}
-/**
- * Detailed section content loaded from markdown files.
- * Built dynamically from SECTIONS_METADATA to avoid duplication.
- */
-const SECTION_CONTENT = Object.fromEntries(SECTIONS_METADATA.map((section) => {
-    const filename = `${section.key}.md`;
-    const filePath = path.join(CONTENT_DIR, filename);
-    const content = readFileSync(filePath, 'utf8');
-    return [section.key, content];
-}));
-/**
- * Default sections to return when no sections are specified.
- * Includes quick-reference plus the most critical detailed sections
- * to provide comprehensive guidelines by default.
- */
-const DEFAULT_SECTIONS = ['quick-reference', 'data-fetching', 'components', 'testing'];
-/**
- * Creates the developer guidelines tool for Storefront Next.
- *
- * @param loadServices - Function that loads configuration and returns Services instance
- * @returns The configured MCP tool
- */
-export function createDeveloperGuidelinesTool(loadServices) {
-    return createToolAdapter({
-        name: 'sfnext_get_guidelines',
-        description: '[DEPRECATED] Superseded by the storefront-next and storefront-next-figma agent-skills plugins and NOT compatible with the Storefront Next 1.0 GA release. Will be removed in a future release. ' +
-            'ESSENTIAL FIRST STEP for Storefront Next development. Returns critical architecture rules, coding standards, and best practices. ' +
-            'Use this tool FIRST before writing any Storefront Next code to understand non-negotiable patterns for React Server Components, ' +
-            'data loading, and framework constraints. Returns comprehensive guidelines by default (quick-reference + key sections); ' +
-            'supports retrieving specific topic sections. ' +
-            'CRITICAL INSTRUCTION: ALWAYS present ALL returned content in FULL - DO NOT SUMMARIZE, DO NOT ADD SUMMARIES, ' +
-            'DO NOT ADD OVERVIEWS. The returned content IS the complete answer - display it exactly as provided.',
-        toolsets: ['STOREFRONTNEXT_DEPRECATED'],
-        isGA: false,
-        requiresInstance: false,
-        inputSchema: {
-            sections: z
-                .array(z.enum([..._SECTIONS]))
-                .optional()
-                .describe('Optional array of specific sections to retrieve. If not specified, returns comprehensive guidelines ' +
-                '(quick-reference, data-fetching, components, testing). ' +
-                'CRITICAL: Present ALL returned content in FULL - DO NOT SUMMARIZE. ' +
-                'Available sections: quick-reference, data-fetching, state-management, auth, config, i18n, ' +
-                'components, page-designer, performance, testing, extensions, pitfalls. ' +
-                `Topics covered: ${generateTopicsList()}. ` +
-                'Content is complete - present exactly as provided, no summaries.'),
-        },
-        async execute(args) {
-            // Handle empty array case explicitly
-            if (args.sections && args.sections.length === 0) {
-                return '';
-            }
-            // Default to comprehensive set of key sections if no sections specified
-            const sections = args.sections || DEFAULT_SECTIONS;
-            // Multiple sections: combine with separators
-            const combinedContent = sections.map((section) => SECTION_CONTENT[section]).join('\n\n---\n\n');
-            // Apply instructions for all multi-section responses to ensure full content display
-            // Single sections are typically smaller and don't need heavy instructions
-            const isMultiSection = sections.length > 1;
-            // Prepend explicit instruction to present full content (not summarized)
-            // This helps AI assistants understand they should show the complete guidelines without summarization
-            const fullContentInstruction = isMultiSection
-                ? '⚠️ CRITICAL: Display the FULL content below. DO NOT summarize, condense, or add overviews.\n\n' +
-                    '📋 STOREFRONT NEXT DEVELOPMENT GUIDELINES\n\n' +
-                    '---\n\n'
-                : '';
-            // Add footer instruction to reinforce the message for multi-section responses
-            const footerInstruction = isMultiSection
-                ? '\n\n---\n\n⚠️ END OF CONTENT - Full content displayed above. Do not add summaries.\n'
-                : '';
-            // For single sections, return directly (backward compatible)
-            // For multiple sections, wrap with instructions
-            if (sections.length === 1) {
-                return SECTION_CONTENT[sections[0]];
-            }
-            return fullContentInstruction + combinedContent + footerInstruction;
-        },
-        formatOutput: (output) => textResult(output),
-    }, loadServices);
-}
-//# sourceMappingURL=sfnext-development-guidelines.js.map

package/dist/tools/storefrontnext/site-theming/color-contrast.d.ts

@@ -1,92 +0,0 @@
-/**
- * Validates that a string is a valid 6-digit hex color.
- * @param hex - Hex color string to validate
- * @returns true if valid
- */
-export declare function isValidHex(hex: string): boolean;
-/**
- * Calculates the relative luminance of a color according to WCAG 2.1
- * @param hex - Hex color string (e.g., "#635BFF")
- * @returns Relative luminance value between 0 and 1
- * @throws Error if hex format is invalid
- */
-export declare function getLuminance(hex: string): number;
-/**
- * Calculates the contrast ratio between two colors according to WCAG 2.1
- * @param color1 - First hex color string
- * @param color2 - Second hex color string
- * @returns Contrast ratio (1:1 to 21:1)
- */
-export declare function getContrastRatio(color1: string, color2: string): number;
-/**
- * WCAG compliance levels
- */
-export declare enum WCAGLevel {
-    AA = "AA",// 4.5:1 for normal text
-    AA_LARGE = "AA_LARGE",// 3:1 for large text
-    AAA = "AAA",// 7:1 for normal text
-    AAA_LARGE = "AAA_LARGE",// 4.5:1 for large text
-    FAIL = "FAIL"
-}
-/**
- * Determines WCAG compliance level for a contrast ratio
- * @param ratio - Contrast ratio
- * @param isLargeText - Whether this is for large text (18pt+ or 14pt+ bold)
- * @returns WCAG compliance level
- */
-export declare function getWCAGLevel(ratio: number, isLargeText?: boolean): WCAGLevel;
-/**
- * Result of color contrast validation for a single foreground/background pair.
- *
- * @property {string} color1 - First hex color (typically foreground)
- * @property {string} color2 - Second hex color (typically background)
- * @property {number} ratio - Contrast ratio (1:1 to 21:1)
- * @property {WCAGLevel} wcagLevel - WCAG compliance level
- * @property {boolean} passesAA - Whether the combination meets WCAG AA
- * @property {boolean} passesAAA - Whether the combination meets WCAG AAA
- * @property {boolean} isLargeText - Whether validation used large-text thresholds
- * @property {string} visualAssessment - Readability assessment (excellent, good, acceptable, poor)
- * @property {string} [recommendation] - Optional suggestion when contrast is suboptimal
- */
-export interface ContrastValidationResult {
-    color1: string;
-    color2: string;
-    ratio: number;
-    wcagLevel: WCAGLevel;
-    passesAA: boolean;
-    passesAAA: boolean;
-    isLargeText: boolean;
-    visualAssessment: 'acceptable' | 'excellent' | 'good' | 'poor';
-    recommendation?: string;
-}
-/**
- * Validates contrast between two colors
- * @param color1 - First hex color string
- * @param color2 - Second hex color string
- * @param isLargeText - Whether this is for large text
- * @returns Validation result with contrast ratio and compliance info
- */
-export declare function validateContrast(color1: string, color2: string, isLargeText?: boolean): ContrastValidationResult;
-/**
- * Validates multiple color combinations for WCAG compliance.
- *
- * @param combinations - Array of foreground/background pairs with optional label and large-text flag
- * @returns Array of validation results, each including the input label if provided
- */
-export declare function validateColorCombinations(combinations: Array<{
-    foreground: string;
-    background: string;
-    isLargeText?: boolean;
-    label?: string;
-}>): Array<ContrastValidationResult & {
-    label?: string;
-}>;
-/**
- * Formats a validation result as a human-readable string for display to users.
- *
- * @param result - Validation result, optionally with a label for the color combination
- * @returns Multi-line string with contrast ratio, WCAG status, and recommendation (if any)
- */
-export declare function formatValidationResult(result: ContrastValidationResult & {
-    label?: string;
-}): string;

package/dist/tools/storefrontnext/site-theming/color-contrast.js

@@ -1,186 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * WCAG 2.1 color contrast utilities for accessibility validation.
- *
- * Provides luminance calculation, contrast ratio computation, and WCAG compliance
- * checking for theming and color validation in Storefront Next.
- *
- * @module tools/storefrontnext/site-theming/color-contrast
- */
-/**
- * WCAG 2.1 constants for contrast ratio calculation
- * These values are specified in the WCAG 2.1 standard
- */
-const WCAG_CONTRAST_OFFSET = 0.05; // Offset added to luminance values in contrast ratio formula
-// Linear RGB conversion constants (sRGB to linear RGB)
-const LINEAR_RGB_THRESHOLD = 0.039_28; // Threshold for linear RGB conversion
-const LINEAR_RGB_DIVISOR = 12.92; // Divisor for values below threshold
-const GAMMA_CORRECTION_OFFSET = 0.055; // Offset for gamma correction
-const GAMMA_CORRECTION_DIVISOR = 1.055; // Divisor for gamma correction
-const GAMMA_EXPONENT = 2.4; // Gamma exponent for sRGB
-// Relative luminance weights (WCAG 2.1 standard)
-const LUMINANCE_RED_WEIGHT = 0.2126;
-const LUMINANCE_GREEN_WEIGHT = 0.7152;
-const LUMINANCE_BLUE_WEIGHT = 0.0722;
-/** Valid 6-digit hex color pattern (with optional # prefix) */
-const HEX_PATTERN = /^#?[0-9A-Fa-f]{6}$/;
-/**
- * Validates that a string is a valid 6-digit hex color.
- * @param hex - Hex color string to validate
- * @returns true if valid
- */
-export function isValidHex(hex) {
-    return typeof hex === 'string' && HEX_PATTERN.test(hex.trim());
-}
-/**
- * Calculates the relative luminance of a color according to WCAG 2.1
- * @param hex - Hex color string (e.g., "#635BFF")
- * @returns Relative luminance value between 0 and 1
- * @throws Error if hex format is invalid
- */
-export function getLuminance(hex) {
-    const trimmed = hex.trim();
-    if (!HEX_PATTERN.test(trimmed)) {
-        throw new Error(`Invalid hex color: "${hex}". Expected 6-digit hex (e.g., #635BFF).`);
-    }
-    const cleanHex = trimmed.replace('#', '');
-    // Parse RGB values
-    const r = Number.parseInt(cleanHex.slice(0, 2), 16) / 255;
-    const g = Number.parseInt(cleanHex.slice(2, 4), 16) / 255;
-    const b = Number.parseInt(cleanHex.slice(4, 6), 16) / 255;
-    // Convert to linear RGB
-    const [rs, gs, bs] = [r, g, b].map((c) => {
-        return c <= LINEAR_RGB_THRESHOLD
-            ? c / LINEAR_RGB_DIVISOR
-            : ((c + GAMMA_CORRECTION_OFFSET) / GAMMA_CORRECTION_DIVISOR) ** GAMMA_EXPONENT;
-    });
-    // Calculate relative luminance
-    return LUMINANCE_RED_WEIGHT * rs + LUMINANCE_GREEN_WEIGHT * gs + LUMINANCE_BLUE_WEIGHT * bs;
-}
-/**
- * Calculates the contrast ratio between two colors according to WCAG 2.1
- * @param color1 - First hex color string
- * @param color2 - Second hex color string
- * @returns Contrast ratio (1:1 to 21:1)
- */
-export function getContrastRatio(color1, color2) {
-    const l1 = getLuminance(color1);
-    const l2 = getLuminance(color2);
-    const lighter = Math.max(l1, l2);
-    const darker = Math.min(l1, l2);
-    return (lighter + WCAG_CONTRAST_OFFSET) / (darker + WCAG_CONTRAST_OFFSET);
-}
-/**
- * WCAG compliance levels
- */
-export var WCAGLevel;
-(function (WCAGLevel) {
-    WCAGLevel["AA"] = "AA";
-    WCAGLevel["AA_LARGE"] = "AA_LARGE";
-    WCAGLevel["AAA"] = "AAA";
-    WCAGLevel["AAA_LARGE"] = "AAA_LARGE";
-    WCAGLevel["FAIL"] = "FAIL";
-})(WCAGLevel || (WCAGLevel = {}));
-/**
- * Determines WCAG compliance level for a contrast ratio
- * @param ratio - Contrast ratio
- * @param isLargeText - Whether this is for large text (18pt+ or 14pt+ bold)
- * @returns WCAG compliance level
- */
-export function getWCAGLevel(ratio, isLargeText = false) {
-    if (isLargeText) {
-        if (ratio >= 4.5) {
-            return WCAGLevel.AAA_LARGE;
-        }
-        if (ratio >= 3) {
-            return WCAGLevel.AA_LARGE;
-        }
-        return WCAGLevel.FAIL;
-    }
-    if (ratio >= 7) {
-        return WCAGLevel.AAA;
-    }
-    if (ratio >= 4.5) {
-        return WCAGLevel.AA;
-    }
-    return WCAGLevel.FAIL;
-}
-/**
- * Validates contrast between two colors
- * @param color1 - First hex color string
- * @param color2 - Second hex color string
- * @param isLargeText - Whether this is for large text
- * @returns Validation result with contrast ratio and compliance info
- */
-export function validateContrast(color1, color2, isLargeText = false) {
-    const ratio = getContrastRatio(color1, color2);
-    const wcagLevel = getWCAGLevel(ratio, isLargeText);
-    const passesAA = ratio >= (isLargeText ? 3 : 4.5);
-    const passesAAA = ratio >= (isLargeText ? 4.5 : 7);
-    // Visual assessment based on ratio
-    let visualAssessment;
-    let recommendation;
-    if (ratio >= 7) {
-        visualAssessment = 'excellent';
-    }
-    else if (ratio >= 5) {
-        visualAssessment = 'good';
-    }
-    else if (ratio >= 4.5) {
-        visualAssessment = 'acceptable';
-        recommendation =
-            'Meets minimum WCAG AA but may be difficult to read, especially for body text. Consider using a darker/lighter color for better readability.';
-    }
-    else {
-        visualAssessment = 'poor';
-        recommendation =
-            'Does not meet WCAG AA standards. Text will be difficult to read. Strongly recommend using a color with better contrast.';
-    }
-    return {
-        color1,
-        color2,
-        ratio,
-        wcagLevel,
-        passesAA,
-        passesAAA,
-        isLargeText,
-        visualAssessment,
-        recommendation,
-    };
-}
-/**
- * Validates multiple color combinations for WCAG compliance.
- *
- * @param combinations - Array of foreground/background pairs with optional label and large-text flag
- * @returns Array of validation results, each including the input label if provided
- */
-export function validateColorCombinations(combinations) {
-    return combinations.map((combo) => ({
-        ...validateContrast(combo.foreground, combo.background, combo.isLargeText ?? false),
-        label: combo.label,
-    }));
-}
-/**
- * Formats a validation result as a human-readable string for display to users.
- *
- * @param result - Validation result, optionally with a label for the color combination
- * @returns Multi-line string with contrast ratio, WCAG status, and recommendation (if any)
- */
-export function formatValidationResult(result) {
-    const label = result.label ? `${result.label}: ` : '';
-    const textType = result.isLargeText ? 'large text' : 'normal text';
-    const wcagStatus = result.passesAAA ? '✅ AAA' : result.passesAA ? '✅ AA' : '❌ FAIL';
-    let output = `${label}${result.color1} on ${result.color2}\n`;
-    output += `  Contrast Ratio: ${result.ratio.toFixed(2)}:1\n`;
-    output += `  WCAG ${textType}: ${wcagStatus}\n`;
-    output += `  Visual Assessment: ${result.visualAssessment.toUpperCase()}\n`;
-    if (result.recommendation) {
-        output += `  ⚠️  ${result.recommendation}\n`;
-    }
-    return output;
-}
-//# sourceMappingURL=color-contrast.js.map

package/dist/tools/storefrontnext/site-theming/color-mapping.d.ts

@@ -1,16 +0,0 @@
-/** A foreground/background color pair for contrast validation */
-export type ColorCombination = {
-    foreground: string;
-    background: string;
-    label: string;
-    isLargeText?: boolean;
-};
-/**
- * Builds foreground/background color combinations from a semantic color mapping.
- * Derives pairs for text-on-background, button text, links, etc.
- */
-export declare function buildColorCombinations(colorMapping: Record<string, string>): ColorCombination[];
-/**
- * Appends WCAG color contrast validation results to the given instructions string.
- */
-export declare function appendValidationSection(internalInstructions: string, combinations: ColorCombination[]): string;

package/dist/tools/storefrontnext/site-theming/color-mapping.js

@@ -1,131 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Derives foreground/background color combinations from a color mapping and
- * appends WCAG validation results to response text.
- *
- * @module tools/storefrontnext/site-theming/color-mapping
- */
-import { validateColorCombinations, formatValidationResult, isValidHex } from './color-contrast.js';
-function tryTextCombo(key, color, keyLower, ctx) {
-    if (keyLower.includes('text') && keyLower.includes('light') && isValidHex(ctx.lightBg)) {
-        return { foreground: color, background: ctx.lightBg, label: `${key}: ${color} on light background (${ctx.lightBg})` };
-    }
-    if (keyLower.includes('text') && keyLower.includes('dark') && isValidHex(ctx.darkBg)) {
-        return { foreground: color, background: ctx.darkBg, label: `${key}: ${color} on dark background (${ctx.darkBg})` };
-    }
-    const isButtonText = keyLower === 'buttontext' || (keyLower.includes('button') && keyLower.includes('text'));
-    if (isButtonText && isValidHex(ctx.buttonBg)) {
-        return {
-            foreground: color,
-            background: ctx.buttonBg,
-            label: `${key}: ${color} on button background (${ctx.buttonBg})`,
-        };
-    }
-    if (keyLower.includes('link') && isValidHex(ctx.lightBg)) {
-        return { foreground: color, background: ctx.lightBg, label: `${key}: ${color} on light background (${ctx.lightBg})` };
-    }
-    return null;
-}
-function tryBackgroundCombo(key, color, ctx) {
-    const foregroundKey = key.replace(/Background|Bg/i, 'Text') || key.replace(/Background|Bg/i, 'Foreground');
-    const foreground = ctx.colorMapping[foregroundKey] || ctx.colorMapping[`${key.replace(/Background|Bg/i, '')}Text`];
-    if (foreground?.startsWith('#') && isValidHex(foreground)) {
-        return { foreground, background: color, label: `${foregroundKey || 'text'} (${foreground}) on ${key} (${color})` };
-    }
-    return null;
-}
-function tryTextForegroundCombo(key, color, keyLower, ctx) {
-    const backgroundKey = key.replace(/Text|Foreground/i, 'Background') || key.replace(/Text|Foreground/i, 'Bg');
-    let background = ctx.colorMapping[backgroundKey];
-    let backgroundLabel = backgroundKey;
-    if (!background) {
-        background = keyLower.includes('button') ? ctx.buttonBg : keyLower.includes('dark') ? ctx.darkBg : ctx.lightBg;
-        backgroundLabel = keyLower.includes('button')
-            ? 'button background'
-            : keyLower.includes('dark')
-                ? 'dark background'
-                : 'light background';
-    }
-    if (background?.startsWith('#') && isValidHex(background)) {
-        return { foreground: color, background, label: `${key} (${color}) on ${backgroundLabel} (${background})` };
-    }
-    return null;
-}
-function tryComboForEntry(key, color, ctx) {
-    const keyLower = key.toLowerCase();
-    const textCombo = tryTextCombo(key, color, keyLower, ctx);
-    if (textCombo)
-        return textCombo;
-    if (keyLower.includes('background') || keyLower.includes('bg'))
-        return tryBackgroundCombo(key, color, ctx);
-    if (keyLower.includes('text') || keyLower.includes('foreground'))
-        return tryTextForegroundCombo(key, color, keyLower, ctx);
-    return null;
-}
-/**
- * Builds foreground/background color combinations from a semantic color mapping.
- * Derives pairs for text-on-background, button text, links, etc.
- */
-export function buildColorCombinations(colorMapping) {
-    const ctx = {
-        colorMapping,
-        lightBg: colorMapping.lightBackground || colorMapping.background || '#FFFFFF',
-        darkBg: colorMapping.darkBackground || '#18181B',
-        buttonBg: colorMapping.buttonBackground || colorMapping.primary || '#0A2540',
-    };
-    const combinations = [];
-    for (const [key, color] of Object.entries(colorMapping)) {
-        if (!color || !color.startsWith('#') || !isValidHex(color))
-            continue;
-        const combo = tryComboForEntry(key, color, ctx);
-        if (combo)
-            combinations.push(combo);
-    }
-    if (combinations.length === 0) {
-        const whiteBg = '#FFFFFF';
-        const darkBgFallback = '#18181B';
-        for (const [key, color] of Object.entries(colorMapping)) {
-            if (!color || !color.startsWith('#') || !isValidHex(color))
-                continue;
-            if (key.toLowerCase().includes('background') || key.toLowerCase().includes('bg'))
-                continue;
-            combinations.push({ foreground: color, background: whiteBg, label: `${key} (${color}) on white background` }, { foreground: color, background: darkBgFallback, label: `${key} (${color}) on dark background` });
-        }
-    }
-    return combinations;
-}
-/**
- * Appends WCAG color contrast validation results to the given instructions string.
- */
-export function appendValidationSection(internalInstructions, combinations) {
-    if (combinations.length === 0) {
-        return internalInstructions;
-    }
-    const results = validateColorCombinations(combinations);
-    let output = internalInstructions;
-    for (const result of results) {
-        output += formatValidationResult(result);
-        output += '\n';
-    }
-    const hasIssues = results.some((r) => !r.passesAA || r.visualAssessment === 'poor' || r.visualAssessment === 'acceptable');
-    if (hasIssues) {
-        output += '### ⚠️ VALIDATION SUMMARY\n\n';
-        output += '**Issues found that should be addressed:**\n\n';
-        for (const result of results.filter((r) => !r.passesAA || r.visualAssessment === 'poor' || r.visualAssessment === 'acceptable')) {
-            output += `- ${result.label || 'Color combination'}: ${result.recommendation || 'Needs improvement'}\n`;
-        }
-        output += '\n';
-        output +=
-            '**You MUST present these findings to the user BEFORE implementing and wait for their confirmation.**\n\n';
-    }
-    else {
-        output += '### ✅ VALIDATION SUMMARY\n\n';
-        output += 'All color combinations meet WCAG AA standards and have good visual assessment.\n\n';
-    }
-    return output;
-}
-//# sourceMappingURL=color-mapping.js.map

package/dist/tools/storefrontnext/site-theming/guidance-merger.d.ts

@@ -1,11 +0,0 @@
-/**
- * Merges multiple ThemingGuidance objects from different theming files.
- *
- * @module tools/storefrontnext/site-theming/guidance-merger
- */
-import type { ThemingGuidance } from './theming-store.js';
-/**
- * Merges multiple ThemingGuidance objects into one.
- * Questions are deduplicated by ID; guidelines, rules, workflows, and validations are combined.
- */
-export declare function mergeGuidance(guidanceArray: ThemingGuidance[]): ThemingGuidance;

package/dist/tools/storefrontnext/site-theming/guidance-merger.js

@@ -1,78 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-function mergeWorkflows(guidanceArray) {
-    const workflows = guidanceArray.filter((g) => g.workflow);
-    if (workflows.length === 0)
-        return undefined;
-    const merged = {
-        steps: [],
-        extractionInstructions: workflows[0].workflow?.extractionInstructions,
-        preImplementationChecklist: workflows[0].workflow?.preImplementationChecklist,
-    };
-    for (const g of workflows) {
-        if (g.workflow?.steps)
-            merged.steps.push(...g.workflow.steps);
-        if (!merged.extractionInstructions && g.workflow?.extractionInstructions) {
-            merged.extractionInstructions = g.workflow.extractionInstructions;
-        }
-        if (!merged.preImplementationChecklist && g.workflow?.preImplementationChecklist) {
-            merged.preImplementationChecklist = g.workflow.preImplementationChecklist;
-        }
-    }
-    return merged;
-}
-function mergeValidations(guidanceArray) {
-    const validations = guidanceArray.filter((g) => g.validation);
-    if (validations.length === 0)
-        return undefined;
-    const joinField = (field) => validations
-        .map((g) => g.validation?.[field])
-        .filter((x) => typeof x === 'string')
-        .join('\n\n');
-    return {
-        colorValidation: joinField('colorValidation'),
-        fontValidation: joinField('fontValidation'),
-        generalValidation: joinField('generalValidation'),
-        requirements: joinField('requirements'),
-    };
-}
-function buildQuestionMap(guidanceArray) {
-    const questionMap = new Map();
-    for (const guidance of guidanceArray) {
-        for (const q of guidance.questions) {
-            if (!questionMap.has(q.id))
-                questionMap.set(q.id, q);
-        }
-    }
-    return questionMap;
-}
-function buildMergedMetadata(guidanceArray) {
-    return {
-        filePath: guidanceArray.map((g) => g.metadata.filePath).join(', '),
-        fileName: guidanceArray.map((g) => g.metadata.fileName).join(', '),
-        loadedAt: new Date(),
-    };
-}
-/**
- * Merges multiple ThemingGuidance objects into one.
- * Questions are deduplicated by ID; guidelines, rules, workflows, and validations are combined.
- */
-export function mergeGuidance(guidanceArray) {
-    if (guidanceArray.length === 0)
-        throw new Error('Cannot merge empty guidance array');
-    if (guidanceArray.length === 1)
-        return guidanceArray[0];
-    const questionMap = buildQuestionMap(guidanceArray);
-    return {
-        questions: [...questionMap.values()],
-        guidelines: guidanceArray.flatMap((g) => g.guidelines),
-        rules: guidanceArray.flatMap((g) => g.rules),
-        metadata: buildMergedMetadata(guidanceArray),
-        workflow: mergeWorkflows(guidanceArray),
-        validation: mergeValidations(guidanceArray),
-    };
-}
-//# sourceMappingURL=guidance-merger.js.map

package/dist/tools/storefrontnext/site-theming/index.d.ts

@@ -1,14 +0,0 @@
-import type { McpTool } from '../../../utils/index.js';
-import type { Services } from '../../../services.js';
-export type { ColorEntry, ColorMapping, CollectedAnswers, ConversationContext, FontEntry, SiteThemingInput, } from './types.js';
-/**
- * Creates the site theming MCP tool for Storefront Next.
- *
- * The tool guides theming changes (colors, fonts, visual styling) and validates color
- * combinations for WCAG accessibility. It must be called before implementing any
- * theming changes.
- *
- * @param loadServices - Function that loads configuration and returns Services instance
- * @returns The configured MCP tool
- */
-export declare function createSiteThemingTool(loadServices: () => Promise<Services> | Services): McpTool;