@salesforce/pwa-kit-mcp 0.1.1 → 0.2.1-dev

package/dist/tools/create-new-page-tool.js

@@ -1,313 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _promises = _interopRequireDefault(require("fs/promises"));
-var _path = _interopRequireDefault(require("path"));
-var _utils = require("../utils");
-var _zod = require("zod");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-const systemPromptForCreatePage = `You are a smart assistant that can use tools when needed. \
-        Please ask the user to provide following information **one at a time**, in a natural and conversational way. \
-        Do **not** ask all the questions at once. \
-        Do **not** assume the answers to the questions, especially the URL route. **Always** ask the user for the URL route. \
-        - What is the name of the new page to create? \
-        - List the components to include on the page, separated by commas. Component names should be in PascalCase (e.g., Image, ProductView) \
-        - What is the URL route for this page? (e.g., /new-home, /my-products) \
-        - What is the absolute path to your node_modules directory? \
-        - What is the absolute path to your components directory? \
-        - What is the absolute path to your pages directory? \
-        - What is the absolute path to your routes.jsx file? \
-        - Is ccExtensibility.overridesDir set in your package.json? (true/false) \
-        Collect answers to these questions, then call the tool with the collected information as input parameters.`;
-const systemPromptForProductHook = `User have added the ProductView component to the new page. Please ask user: \
-        "To make it work, would you like to add the hook useProduct to your page?" \
-        If user answers yes, please make sure do do following: \
-        1. add the useProduct with ALL parameters following product-detail's useProduct as example, \
-        2. update ProductView tag to pass product and isProductLoading as props, \
-        3. in routes.jsx, update the path for the new page with '/:productId'. \
-        4. open the new page in the browser with URL: http://localhost:3000/{static-route-path}/25592300M \
-        If user answers no, skip above steps.`;
-const systemPromptForImageComponent = `User has added the Image component to the new page. Please ask the user, after they have provided the URL route:
-        "To make it work, would you like to provide the full path of the image source to your page? Note that CORS (Cross-Origin Resource Sharing) restrictions may apply."
-        
-        If the user answers yes, please do the following:
-        1. Ask the user to provide the full path of the image source.
-        2. If the image is from a URL from the internet, always check in the codebase if the domain of the image source is present in the CSP img-src allow list in ssr.js or related server files.
-        3. When checking the allow list, also check for wildcard entries (e.g., '*.domain.com') that would cover the provided domain. If either the exact domain or a matching wildcard is present, inform the user that the image source is already allowed by the CSP and proceed.
-        4. If neither the domain nor a matching wildcard is present in the allow list, inform the user and **do not** update the src of the Image component. Tell the user that the CSP img-src allow list needs to be updated manually, and do not proceed further until the domain is confirmed present in the codebase.
-        5. **Do not** update the CSP img-src allow list in ssr.js yourself; always ask the user to update the CSP img-src allow list manually, even if the user requests it.
-        6. Once the user confirms they have updated the CSP img-src allow list, check again in the codebase if the domain of the image source or a matching wildcard is part of the CSP img-src allow list. If yes, then proceed. If no, tell the user that the CSP img-src allow list needs to be updated manually, or ask the user to provide another image source.
-        7. Only if the image from the internet is part of the CSP img-src allow list (either by exact domain or wildcard), then proceed.
-        8. If the image source is an https URL, then use the image source directly in the Image component. If it's a local image, update the path inside getAssetUrl and use it in the Image component.
-        9. Ask the user to provide the alt text for the image.
-        10. Ask the user to provide the width and height of the image.
-        11. Update the src, alt text, width, and height of the Image component in the newly created page once the user has provided them.
-        12. Request the user to restart the front end server.
-        13. Open the new page in the browser with URL: http://localhost:3000/{static-route-path}
-        
-        If the user answers no, tell the user that the default image located at /static/img/hero.png is being displayed.
-        
-        Note:
-        If the automation cannot detect the Image component but you know it exists and works as intended, proceed with the above steps as if the component is available. Do not block or alter the workflow due to the detection issue. Clearly communicate to the user that the Image component will be used, even if it was not detected by the automation.
-        `;
-const systemPromptForUnfoundComponents = unfoundComponents => `The following components were not found: ${unfoundComponents.join(', ')}. \
-        If the component is not found, **Please** suggest changes to the newly generated page file based on the components not found.`;
-class CreateNewPageTool {
-  constructor() {
-    var _this = this;
-    this.name = 'create_sample_storefront_page';
-    this.description = 'Create a sample PWA storefront page. Gather information from user for the MCP tool parameters **one at a time**, in a natural and conversational way. Do **not** ask all the questions at once.';
-    this.inputSchema = {
-      pageName: _zod.z.string().describe('The name of the new page to create?'),
-      componentList: _zod.z.array(_zod.z.string()).describe('The existing components to include on the page, separated by commas. Component names should be in PascalCase (e.g., AddressDisplay, ProductView, Footer)'),
-      route: _zod.z.string().describe('The URL route for this page? (e.g., /new-home, /my-product-view)'),
-      nodeModulesPath: _zod.z.string().describe('The absolute path to the node_modules directory'),
-      componentsPath: _zod.z.string().describe('The absolute path to the components directory'),
-      pagesPath: _zod.z.string().describe('The absolute path to the pages directory'),
-      routesPath: _zod.z.string().describe('The absolute path to the routes.jsx file'),
-      hasOverridesDir: _zod.z.boolean().describe('Whether ccExtensibility.overridesDir is set in package.json')
-    };
-    this.unfoundComponents = [];
-    this.handler = /*#__PURE__*/function () {
-      var _ref = _asyncToGenerator(function* (args) {
-        (0, _utils.logMCPMessage)(`------- Calling CreateNewPageTool handler`);
-        if (!args || !args.pageName || !args.componentList || !args.route || !args.nodeModulesPath || !args.componentsPath || !args.pagesPath || !args.routesPath || args.hasOverridesDir === undefined) {
-          return {
-            role: 'system',
-            content: [{
-              type: 'text',
-              text: systemPromptForCreatePage
-            }]
-          };
-        }
-        return _this.createPage(args.pageName, args.componentList, args.route, {
-          nodeModulesPath: args.nodeModulesPath,
-          componentsPath: args.componentsPath,
-          pagesPath: args.pagesPath,
-          routesPath: args.routesPath,
-          hasOverridesDir: args.hasOverridesDir
-        });
-      });
-      return function (_x) {
-        return _ref.apply(this, arguments);
-      };
-    }();
-  }
-  createPage(pageName, componentList, route, absolutePaths) {
-    var _this2 = this;
-    return _asyncToGenerator(function* () {
-      (0, _utils.logMCPMessage)(`========== Creating page ${pageName} with components ${componentList} and route ${route}`);
-      _this2.unfoundComponents = [];
-      yield (0, _utils.logMCPMessage)(`Creating page ${pageName} with components ${componentList} and route ${route}`);
-      try {
-        const messages = [];
-        // Use the provided absolute path for pages directory
-        const pagesDir = absolutePaths.pagesPath;
-        pageName = (0, _utils.toPascalCase)(pageName);
-        const pageDir = _path.default.join(pagesDir, (0, _utils.toKebabCase)(pageName));
-        try {
-          yield _promises.default.access(pageDir);
-          throw new Error(`Page directory already exists: ${pageDir}`);
-        } catch (err) {
-          if (err.code !== 'ENOENT') throw err;
-        }
-        yield _promises.default.mkdir(pageDir, {
-          recursive: true
-        });
-        if (componentList.length == 0) {
-          componentList.push(pageName);
-        }
-        const pageContent = yield _this2.generatePageContent(pageName, componentList, absolutePaths);
-        (0, _utils.logMCPMessage)(`!!!!!! \n pageContent: ${pageContent} \n !!!!!`);
-        const indexPath = _path.default.join(pageDir, 'index.jsx');
-        yield _promises.default.writeFile(indexPath, pageContent, 'utf8');
-        yield _this2.updateRoutes(pageName, route, absolutePaths);
-        messages.push(`Created page ${pageName} at ${pageDir}`);
-        messages.push(`Added route ${route}`);
-        (0, _utils.logMCPMessage)(`componentList: ${componentList}`);
-        if (componentList.includes('ProductView')) {
-          messages.push(systemPromptForProductHook);
-        }
-        if (componentList.includes('Image')) {
-          messages.push(systemPromptForImageComponent);
-        }
-        (0, _utils.logMCPMessage)(`Unfound components: ${_this2.unfoundComponents}`);
-        if (_this2.unfoundComponents.length != 0) {
-          messages.push(systemPromptForUnfoundComponents(_this2.unfoundComponents));
-        }
-        (0, _utils.logMCPMessage)(messages.join('\n'));
-        return {
-          role: 'system',
-          content: [{
-            type: 'text',
-            text: messages.join('\n')
-          }]
-        };
-      } catch (error) {
-        (0, _utils.logMCPMessage)(`Error creating page: ${error.message}`);
-        return {
-          role: 'developer',
-          content: [{
-            type: 'text',
-            text: `Error creating page: ${error.message}`
-          }]
-        };
-      }
-    })();
-  }
-  generatePageContent(pageName, componentList, absolutePaths) {
-    var _this3 = this;
-    const imports = [`import React from 'react'`, `import Seo from '@salesforce/retail-react-app/app/components/seo'`];
-    const sharedUIComponents = ['Box'];
-    // Add component imports
-    const accessPromises = componentList.map(/*#__PURE__*/function () {
-      var _ref2 = _asyncToGenerator(function* (component) {
-        component = (0, _utils.toPascalCase)(component);
-        const componentName = component.charAt(0).toUpperCase() + component.slice(1);
-        const componentDir = (0, _utils.toKebabCase)(componentName);
-        // Use the provided absolute paths for component detection
-        const isLocal = (0, _utils.isLocalComponent)(componentDir, absolutePaths.componentsPath);
-        const isLocalSharedUI = (0, _utils.isLocalSharedUIComponent)(componentDir, absolutePaths.componentsPath);
-        const isBase = (0, _utils.isBaseComponent)(componentDir, absolutePaths.nodeModulesPath);
-        const isSharedUI = (0, _utils.isSharedUIBaseComponent)(componentDir, absolutePaths.nodeModulesPath);
-        if (!isLocal && !isLocalSharedUI && !isBase && !isSharedUI) {
-          _this3.unfoundComponents.push(component);
-        }
-        // Import getAssetUrl for displaying image source if Image component is used
-        if (componentName === 'Image') {
-          imports.push(`import {getAssetUrl} from '@salesforce/pwa-kit-react-sdk/ssr/universal/utils'`);
-        }
-        if (isLocalSharedUI || isSharedUI) {
-          sharedUIComponents.push(componentName);
-          return;
-        }
-        // If the component name is the same as the page name, add 'Component' to the component name to avoid conflict with the page name
-        const importComponentName = componentName === pageName ? componentName + 'Component' : componentName;
-        const importComponentPath = (0, _utils.generateComponentImportStatement)(importComponentName, componentDir, isLocal, isBase, absolutePaths, absolutePaths.hasOverridesDir);
-        imports.push(importComponentPath);
-      });
-      return function (_x2) {
-        return _ref2.apply(this, arguments);
-      };
-    }());
-
-    // Import all shared UI components in a single import statement
-    if (sharedUIComponents.length > 0) {
-      const importSharedUIComponents = sharedUIComponents.join(', ');
-      imports.push(`import {${importSharedUIComponents}} from '@salesforce/retail-react-app/app/components/shared/ui'`);
-    }
-    return Promise.all(accessPromises).then(() => {
-      (0, _utils.logMCPMessage)(`?????? imports ${imports.join('\n')}`);
-      const componentJsx = componentList.map(component => {
-        component = (0, _utils.toPascalCase)(component);
-        const componentName = component.charAt(0).toUpperCase() + component.slice(1);
-        // If the component name is the same as the page name, add 'Component' to the component name
-        const importComponentName = componentName === pageName ? componentName + 'Component' : componentName;
-        if (componentName === 'Image') {
-          return ` <Image src={getAssetUrl('static/img/hero.png')} alt="pwa-kit banner" style={{ width: '700px', height: 'auto' }} />`;
-        }
-        return `                <${importComponentName} />`;
-      }).join('\n');
-      return `/*
- * Copyright (c) ${new Date().getFullYear()}, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-
-${imports.join('\n')}
-
-/**
- * ${pageName} component
- * @returns {React.JSX.Element}
- */
-const ${pageName} = () => {
-
-    return (
-        <Box data-testid="${pageName.toLowerCase()}-page" layerStyle="page">
-            <Seo
-                title="${pageName}"
-                description="${pageName} Page"
-                keywords="Commerce Cloud, Retail React App, React Storefront"
-            />
-
-${componentJsx}
-        </Box>
-    );
-}
-
-export default ${pageName};
-        `;
-    });
-  }
-  updateRoutes(pageName, route, absolutePaths) {
-    return _asyncToGenerator(function* () {
-      // Use the provided absolute path to the routes.jsx file
-      const routesPath = absolutePaths.routesPath;
-      try {
-        const routesContent = yield _promises.default.readFile(routesPath, 'utf8');
-        const importStatement = `const ${pageName} = loadable(() => import('./pages/${(0, _utils.toKebabCase)(pageName)}'), {fallback})`;
-        (0, _utils.logMCPMessage)(`!!!!!!!!!! importStatement: ${importStatement}`);
-
-        // Match all loadable import statements
-        const loadableRegex = /const\s+\w+\s*=\s*loadable\(\(\)\s*=>\s*import\(['"`].*?['"`]\)(?:,\s*\{fallback\})?\);?/g;
-        const matches = [...routesContent.matchAll(loadableRegex)];
-        if (matches.length === 0) {
-          throw new Error('No loadable import statements found.');
-        }
-        const lastMatch = matches[matches.length - 1];
-        const insertPosition = lastMatch.index + lastMatch[0].length;
-
-        // Insert the new import after the last one
-        let updatedContent = routesContent.slice(0, insertPosition) + `\n${importStatement}` + routesContent.slice(insertPosition);
-        const routeObject = `    {\n        path: '${route}',\n        component: ${pageName},\n        exact: true\n    },`;
-
-        // Find the routes array, works for both export and non-export cases
-        const routesArrayRegex = /(export\s+)?const\s+routes\s*=\s*\[([\s\S]*?)\]/m;
-        const match = updatedContent.match(routesArrayRegex);
-        if (!match) {
-          throw new Error('No routes array declaration found.');
-        }
-
-        // Find the start and end of the routes array
-        const arrayStart = match.index + match[0].indexOf('[') + 1;
-        const arrayEnd = match.index + match[0].lastIndexOf(']');
-        let arrayBody = updatedContent.slice(arrayStart, arrayEnd).trim();
-
-        // Remove leading/trailing commas and whitespace
-        arrayBody = arrayBody.replace(/^,|,$/g, '').trim();
-
-        // Remove trailing '}' if present after a spread operator (e.g., ..._routes} in case of generated app)
-        arrayBody = arrayBody.replace(/(\.\.\.[^,}\]]+)}\s*$/, '$1');
-        if (arrayBody) {
-          if (!arrayBody.match(/\.\.\.[^,}\]]+\s*$/)) {
-            if (!arrayBody.endsWith(',')) {
-              arrayBody += ',';
-            }
-          } else {
-            arrayBody = arrayBody.replace(/,\s*$/, '');
-          }
-        }
-        const newArrayBody = `\n${routeObject}\n${arrayBody ? '    ' + arrayBody : ''}\n`;
-
-        // Reassemble the file
-        updatedContent = updatedContent.slice(0, arrayStart) + newArrayBody + updatedContent.slice(arrayEnd);
-        yield _promises.default.writeFile(routesPath, updatedContent, 'utf8');
-      } catch (error) {
-        throw new Error(`Failed to update routes: ${error.message}`);
-      }
-    })();
-  }
-}
-const createNewPageTool = new CreateNewPageTool();
-var _default = exports.default = createNewPageTool;

package/dist/tools/developer-guideline.js

@@ -1,131 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _utils = require("../utils/utils");
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-const guidelinesText = `# Salesforce Commerce Composable Storefront Development Guidelines
-
-## Overview
-This document offers guidelines in the development of Salesforce Commerce Composable Storefront applications using PWA Kit. The AI should possess a comprehensive understanding of the PWA Kit architecture, sample Retail React App, Chakra UI, and standard React application practices.
-
-## Core Principles
-
-### Project Understanding
-- Thoroughly analyze requests and the existing project for successful implementation.
-- Promptly clarify ambiguous requirements.
-
-### Development Workflow
-- **Analyze Requirements** - Clearly define the objectives and functionalities required.
-- **Review Existing Code** - Examine the current codebase to identify similar solutions and potentially reusable components.
-- **Understand Existing Hooks and Utilities** - Familiarize with hooks and utility functions available within the project, including those from commerce-sdk-react and template-retail-react-app modules.
-- **Plan Implementation** - Design component structure before coding.
-- **Implement Incrementally** - Develop and test the service in small, manageable steps.
-- **Test Thoroughly** - Ensure comprehensive testing, including the use of Jest.
-
-## Technical Stack
-
-### Core Technologies
-- **React** - UI components and SPA architecture
-- **Express** - Server-side rendering and backend
-- **@salesforce/commerce-sdk-react** - Commerce Cloud API integration (hooks)
-- **PWA Kit** - SSR, routing, config, Salesforce integration
-- **Chakra UI V2** - UI components and theming
-- **Emotion** - CSS-in-JS styling
-- **React Router** - Routing
-- **React Intl** - Localization
-- **React Query** - Data fetching/caching
-- **Webpack** - Bundling
-- **React Testing Library, Jest** - Testing libraries
-- **react-helmet, framer-motion, etc.** - Utilities, animation, head management
-- **ESLint/Prettier** - Code formatting and linting
-
-## PWK Kit Architecture
-
-### Configuration Files
-- PWA Kit apps are customized using configuration files for API access, URL formatting, and server-side rendering.
-- These files support JavaScript, YAML, and JSON formats, with default.js being the standard.
-- Configuration values are serialized for isomorphic rendering, so secrets must not be included.
-- Environment-specific configuration files can replace or complement default.js.
-- File precedence is .js > .yml > .yaml > .json if base names are the same.
-
-### Proxy Requests
-- Managed Runtime's proxy feature routes API requests through the storefront domain to avoid CORS issues and improve performance.
-- Local proxy configurations are set in config/default.js, while Managed Runtime deployments use Runtime Admin or the Managed Runtime API.
-- Requests use the /mobify/proxy/<PROXY_PATH> pattern.
-- Proxied requests and responses are modified for transparent operation.
-- Proxied requests are uncached by default but can be cached using a caching path prefix.
-
-### Rendering
-- PWA Kit uses server-side rendering (SSR) for fast initial page loads, leveraging CDN caching.
-- After the first load, client-side rendering (CSR) takes over for fluid user interactions.
-- Application code must be isomorphic, functioning in both server and client environments, often with conditional logic.
-- Props from API requests are serialized into the page source during SSR for client-side hydration.
-- A correlation ID is provided on each page for tracking requests across PWA Kit and other systems.
-
-### Routing
-- PWA Kit uses Express.js and React Router for handling requests and rendering components.
-- Routes are defined in app/routes.jsx as an array of objects with 'path' and 'component' properties.
-- You can use both withReactQuery and withLegacyGetProps at the same time.
-- getProps and shouldGetProps were removed from the default template of pages of the Retail React App, but aren't deprecated. Long-term support for these methods remains.
-
-### PWA Kit Special Components
-- Customize your storefront by overriding default special components that start with an underscore (_), such as app/components/_app-config/index.jsx.
-- app/components/_app-config: The top-level component for app-wide configurations like theme providers and state management.
-- app/components/_app: The child of _app-config. Use it for layout and UI that persist throughout your React app, such as the header, footer, and sidebar.
-- app/components/_error: Renders when a page or its data isn't found, or when an error occurs, returning a 404 status.
-
-### State Management
-- PWA Kit applications support various state management approaches, including simple prop-passing or React's Context API.
-- The React Context API can be used with useReducer and useContext for shared global state.
-- The AppConfig special component is the primary place to initialize a state management system.
-- When integrating libraries like Redux, AppConfig methods such as restore, freeze, extraGetPropsArgs, and render are utilized.
-
-### PWA Kit Extensibility
-- In PWA Kit v3, you can extend a base template (@salesforce/retail-react-app) by replacing specific files using a local "overrides directory."
-- Extensibility is configured in package.json with the base template (ccExtensibility.extends) and your overrides directory (ccExtensibility.overridesDir).
-- To override a file, recreate its exact path and filename in your overrides directory.
-
-### PWA Kit Storefront Development
-- Start development with Retail React App sample codebase and tooling.
-- Use included npm scripts for automating development tasks like build, test, and lint.
-- Access Shopper data through the commerce-sdk-react hooks to fetch, cache, and mutate utilizing Salesforce Commerce API (SLAS) and OCAPI.
-- Use Chakra UI and existing components when available.
-- Create simple, functional, modular, reusable components.
-- Use the React Helmet library to modify the HTML tags in Document, such as <head>.
-- Use kebab-case for file names. Only start with an underscore (_) if they are special components.
-- Use React Hooks (e.g., useState, useEffect, useContext, useMemo, useCallback) for state management and side effects. 
-
-## Quality Standards
-- Maintain consistent code formatting using project standards.
-- Write comprehensive test coverage.
-- Ensure components are accessible and mobile-friendly.
-- Follow security best practices for all code.
-`;
-var _default = exports.default = {
-  name: 'development_guidelines',
-  description: `You must follow this development guidelines before attempting to analyze/ generate / refactor / modify / fix code.
-    - e.g. "Create a customer service Chat component", "Find bugs in my_script.jsx", "Refactor my_script.jsx to use React Hooks"`,
-  inputSchema: _utils.EmptyJsonSchema,
-  fn: function () {
-    var _ref = _asyncToGenerator(function* () {
-      return {
-        content: [{
-          type: 'text',
-          text: guidelinesText
-        }]
-      };
-    });
-    return function fn() {
-      return _ref.apply(this, arguments);
-    };
-  }()
-};

package/dist/tools/index.js

@@ -1,62 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "CreateAppGuidelinesTool", {
-  enumerable: true,
-  get: function () {
-    return _createAppGuideline.default;
-  }
-});
-Object.defineProperty(exports, "CreateNewComponentTool", {
-  enumerable: true,
-  get: function () {
-    return _createNewComponent.default;
-  }
-});
-Object.defineProperty(exports, "CreateNewPageTool", {
-  enumerable: true,
-  get: function () {
-    return _createNewPageTool.default;
-  }
-});
-Object.defineProperty(exports, "DeveloperGuidelinesTool", {
-  enumerable: true,
-  get: function () {
-    return _developerGuideline.default;
-  }
-});
-Object.defineProperty(exports, "TestWithPlaywrightTool", {
-  enumerable: true,
-  get: function () {
-    return _siteTest.TestWithPlaywrightTool;
-  }
-});
-Object.defineProperty(exports, "VersionControlGitTool", {
-  enumerable: true,
-  get: function () {
-    return _versionControlGit.default;
-  }
-});
-Object.defineProperty(exports, "runAccessibilityTest", {
-  enumerable: true,
-  get: function () {
-    return _siteTestAccessibility.runAccessibilityTest;
-  }
-});
-Object.defineProperty(exports, "runPerformanceTest", {
-  enumerable: true,
-  get: function () {
-    return _siteTestPerformance.runPerformanceTest;
-  }
-});
-var _createAppGuideline = _interopRequireDefault(require("./create-app-guideline.js"));
-var _createNewComponent = _interopRequireDefault(require("./create-new-component.js"));
-var _developerGuideline = _interopRequireDefault(require("./developer-guideline.js"));
-var _siteTest = require("./site-test.js");
-var _createNewPageTool = _interopRequireDefault(require("./create-new-page-tool.js"));
-var _versionControlGit = _interopRequireDefault(require("./version-control-git.js"));
-var _siteTestAccessibility = require("./site-test-accessibility.js");
-var _siteTestPerformance = require("./site-test-performance.js");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/dist/tools/site-test-accessibility.js

@@ -1,38 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.runAccessibilityTest = runAccessibilityTest;
-var _playwright = require("playwright");
-var _playwright2 = _interopRequireDefault(require("@axe-core/playwright"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-function runAccessibilityTest(_x) {
-  return _runAccessibilityTest.apply(this, arguments);
-}
-function _runAccessibilityTest() {
-  _runAccessibilityTest = _asyncToGenerator(function* (siteUrl) {
-    const browser = yield _playwright.chromium.launch();
-    const context = yield browser.newContext();
-    const page = yield context.newPage();
-    yield page.goto(siteUrl);
-    const results = yield new _playwright2.default({
-      page
-    }).analyze();
-    yield browser.close();
-    return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(results)
-      }]
-    };
-  });
-  return _runAccessibilityTest.apply(this, arguments);
-}

package/dist/tools/site-test-performance.js

@@ -1,87 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.runPerformanceTest = runPerformanceTest;
-var _playwright = require("playwright");
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
-function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
- * Copyright (c) 2025, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
- */
-function runPerformanceTest(_x) {
-  return _runPerformanceTest.apply(this, arguments);
-}
-function _runPerformanceTest() {
-  _runPerformanceTest = _asyncToGenerator(function* (siteUrl) {
-    const browser = yield _playwright.chromium.launch();
-    const page = yield browser.newPage();
-    yield page.goto(siteUrl);
-
-    // Wait for page to fully load
-    yield page.waitForLoadState('load');
-
-    // Extract detailed navigation timing data from the browser
-    const navigationEntries = yield page.evaluate(() => {
-      const nav = performance.getEntriesByType('navigation')[0];
-      if (!nav) return null;
-      return {
-        type: nav.type,
-        startTime: nav.startTime,
-        unloadEventStart: nav.unloadEventStart,
-        unloadEventEnd: nav.unloadEventEnd,
-        redirectStart: nav.redirectStart,
-        redirectEnd: nav.redirectEnd,
-        fetchStart: nav.fetchStart,
-        domainLookupStart: nav.domainLookupStart,
-        domainLookupEnd: nav.domainLookupEnd,
-        connectStart: nav.connectStart,
-        connectEnd: nav.connectEnd,
-        secureConnectionStart: nav.secureConnectionStart,
-        requestStart: nav.requestStart,
-        responseStart: nav.responseStart,
-        responseEnd: nav.responseEnd,
-        domLoading: nav.domLoading,
-        domInteractive: nav.domInteractive,
-        domContentLoadedEventStart: nav.domContentLoadedEventStart,
-        domContentLoadedEventEnd: nav.domContentLoadedEventEnd,
-        domComplete: nav.domComplete,
-        loadEventStart: nav.loadEventStart,
-        loadEventEnd: nav.loadEventEnd,
-        duration: nav.duration
-      };
-    });
-
-    // Fallback for browsers that don't support Navigation Timing Level 2
-    const perfTiming = navigationEntries || (yield page.evaluate(() => JSON.parse(JSON.stringify(window.performance.timing))));
-
-    // Calculate key metrics
-    const metrics = _objectSpread({
-      totalLoadTime: perfTiming.loadEventEnd - perfTiming.startTime,
-      domContentLoadedTime: perfTiming.domContentLoadedEventEnd - perfTiming.startTime,
-      timeToFirstByte: perfTiming.responseStart - perfTiming.startTime,
-      domInteractive: perfTiming.domInteractive - perfTiming.startTime,
-      firstPaint: perfTiming.responseEnd - perfTiming.startTime
-    }, perfTiming);
-    yield browser.close();
-    return {
-      content: [{
-        type: 'text',
-        text: `Total Load Time: ${metrics.totalLoadTime}ms, \
-        DOM Content Loaded: ${metrics.domContentLoadedTime}ms, \
-        Time to First Byte: ${metrics.timeToFirstByte}ms, 
-        DOM Interactive: ${metrics.domInteractive}ms, \
-        First Paint: ${metrics.firstPaint}ms`
-      }]
-    };
-  });
-  return _runPerformanceTest.apply(this, arguments);
-}