@iress-oss/ids-mcp-server 5.15.0 → 5.20.1

package/generated/docs/{foundations-user-experience-docs.md → components_foundations-user-experience-docs.md}

@@ -1,63 +1,53 @@
-[](#user-experience)User experience
-===================================
+User experience
+===============
 
 We use heuristic guidelines to assess the usability and user-centred design quality of all Iress products.
 
-[](#system-feedback)System Feedback
------------------------------------
+System Feedback
+---------------
 
 *   Always show users where they are, what just happened, and what’s possible next.
 *   Provide immediate visual and textual feedback for all actions and states.
 *   Ensure feedback is clear, contextual, and proportionate to the importance of the action.
 
-[](#language-and-mental-models)Language and Mental Models
----------------------------------------------------------
+Language and Mental Models
+--------------------------
 
 *   Use user-centred language and avoid technical jargon.
 *   Follow cultural and industry conventions for colour, iconography, terminology, and layout.
 *   Align interaction patterns with real-world analogues wherever feasible.
 
-[](#control-and-forgiveness)Control and Forgiveness
----------------------------------------------------
+Control and Forgiveness
+-----------------------
 
 *   Make actions reversible and provide undo where errors may occur.
 *   Let users easily backtrack, edit inputs, or abandon flows.
 *   Provide escape hatches from any process without penalty.
 
-[](#standards-and-consistency)Standards and Consistency
--------------------------------------------------------
+Standards and Consistency
+-------------------------
 
 *   Use consistent layout, labelling, iconography, and grammar.
 *   Reinforce expectations by placing similar elements in predictable positions.
 *   Apply colour, spacing, and visual patterns consistently across all screens.
 
-[](#error-prevention-and-recovery)Error Prevention and Recovery
----------------------------------------------------------------
+Error Prevention and Recovery
+-----------------------------
 
 *   Prevent errors by anticipating misuse and validating early.
 *   Phrase error messages with clarity, empathy, and constructive suggestions.
 *   Where errors occur, explain why and how they can be resolved.
 
-[](#recognition-over-recall)Recognition Over Recall
----------------------------------------------------
+Recognition Over Recall
+-----------------------
 
 *   Display necessary information at the point of decision.
 *   Use visual grouping, spacing, and affordance to reveal hierarchy.
 *   Prioritise visual clarity over novelty.
 
-[](#simplicity-and-minimalism)Simplicity and Minimalism
--------------------------------------------------------
+Simplicity and Minimalism
+-------------------------
 
 *   Remove unnecessary detail—every word, element, or feature should earn its place.
 *   Design for clarity of purpose with visually distinct, semantically meaningful UI components.
 *   Use whitespace, clean alignment, and simplified flows to reduce cognitive load.
-
-On this page
-
-*   [System Feedback](#system-feedback)
-*   [Language and Mental Models](#language-and-mental-models)
-*   [Control and Forgiveness](#control-and-forgiveness)
-*   [Standards and Consistency](#standards-and-consistency)
-*   [Error Prevention and Recovery](#error-prevention-and-recovery)
-*   [Recognition Over Recall](#recognition-over-recall)
-*   [Simplicity and Minimalism](#simplicity-and-minimalism)

package/generated/docs/{foundations-visual-design-docs.md → components_foundations-visual-design-docs.md}

@@ -1,16 +1,16 @@
-[](#visual-design-standards)Visual Design Standards
-===================================================
+Visual Design Standards
+=======================
 
-[](#typography)Typography
--------------------------
+Typography
+----------
 
 *   Use systematic font sizing with heading scales (H1-H6)
 *   Implement consistent line heights and font weights
 *   Provide text colour hierarchies (primary, muted, success, warning, danger)
 *   Support responsive typography scaling
 
-[](#colour-system)Colour System
--------------------------------
+Colour System
+-------------
 
 *   Maintain semantic colour meanings:
     *   **Primary**: Main call-to-action colour with high contrast
@@ -22,25 +22,18 @@
 *   Ensure all colour combinations meet accessibility contrast requirements
 *   Provide consistent hover and active state colours
 
-[](#spacing-and-layout)Spacing and Layout
------------------------------------------
+Spacing and Layout
+------------------
 
 *   Use systematic spacing scale (xs, sm, md, lg, xl)
 *   Apply consistent gutter systems for layout components
 *   Implement responsive breakpoints for adaptive layouts
 *   Maintain proper margin and padding relationships
 
-[](#interactive-states)Interactive States
------------------------------------------
+Interactive States
+------------------
 
 *   Provide clear hover, focus, active, and disabled states
 *   Use consistent transition timing and easing
 *   Implement proper focus indicators for keyboard navigation
 *   Show loading states for asynchronous operations
-
-On this page
-
-*   [Typography](#typography)
-*   [Colour System](#colour-system)
-*   [Spacing and Layout](#spacing-and-layout)
-*   [Interactive States](#interactive-states)

package/generated/docs/{frequently-asked-questions-docs.md → components_frequently-asked-questions-docs.md}

@@ -1,29 +1,29 @@
-[](#frequently-asked-questions)Frequently asked questions
-=========================================================
+Frequently asked questions
+==========================
 
 Some of the most frequently asked questions related to IDS are answered here.
 
 * * *
 
-[](#how-long-will-version-4-be-supported)How long will version 4 be supported?
-------------------------------------------------------------------------------
+How long will version 4 be supported?
+-------------------------------------
 
 We will continue to support version 4.x until the end of 2024. This means there will be security patches and critical bug fixes, but no new enhancements will be added to version 4.
 
-[](#does-this-mean-we-need-to-upgrade-now)Does this mean we need to upgrade now?
---------------------------------------------------------------------------------
+Does this mean we need to upgrade now?
+--------------------------------------
 
 No, you do not need to upgrade now. However, we recommend that you start planning your migration to version 5 and use it for new projects. Support for version 4 will continue until the end of 2024.
 
-[](#what-support-will-there-be-to-help-us-upgrade)What support will there be to help us upgrade?
-------------------------------------------------------------------------------------------------
+What support will there be to help us upgrade?
+----------------------------------------------
 
 If you are moving from version 4 to version 5, a [migration guide](?path=/docs/resources-migration-guides-from-v4-to-v5--docs) is available. This guide will help you understand the changes between the two versions, how to migrate your code, and how to use them side by side while you are migrating.
 
 If you plan to migrate soon, we would like to partner with you. Please reach out to the design system team via Iress channels.
 
-[](#what-will-happen-if-we-do-not-upgrade-by-the-end-of-2024)What will happen if we do not upgrade by the end of 2024?
-----------------------------------------------------------------------------------------------------------------------
+What will happen if we do not upgrade by the end of 2024?
+---------------------------------------------------------
 
 After the end of 2024, we will no longer provide support for version 4. This means that we will not provide any security patches or critical bug fixes, which may leave the rest of your application vulnerable to security threats. There are several ways to handle this:
 
@@ -31,23 +31,14 @@ After the end of 2024, we will no longer provide support for version 4. This mea
 *   Create a PR to fix the issue in version 4 and submit it to IDS for review.
 *   Update nested dependencies to the secure version using `yarn audit` and `resolutions` in your `package.json`.
 
-[](#will-the-documentation-for-version-4-still-be-available)Will the documentation for version 4 still be available?
---------------------------------------------------------------------------------------------------------------------
+Will the documentation for version 4 still be available?
+--------------------------------------------------------
 
 Yes, we will host the documentation for version 4 indefinitely. The documentation will be available on the [Versions page](?path=/docs/versions--docs).
 
-[](#can-i-contribute-to-version-4)Can I contribute to version 4?
-----------------------------------------------------------------
+Can I contribute to version 4?
+------------------------------
 
 Yes! We will continue to accept pull requests for version 4, but only until the end of 2024. To do so, please use `4.x` as the base branch for your pull request.
 
 After this time, we will only accept pull requests regarding critical security patches or critical bug fixes.
-
-On this page
-
-*   [How long will version 4 be supported?](#how-long-will-version-4-be-supported)
-*   [Does this mean we need to upgrade now?](#does-this-mean-we-need-to-upgrade-now)
-*   [What support will there be to help us upgrade?](#what-support-will-there-be-to-help-us-upgrade)
-*   [What will happen if we do not upgrade by the end of 2024?](#what-will-happen-if-we-do-not-upgrade-by-the-end-of-2024)
-*   [Will the documentation for version 4 still be available?](#will-the-documentation-for-version-4-still-be-available)
-*   [Can I contribute to version 4?](#can-i-contribute-to-version-4)

package/generated/docs/components_get-started-develop-docs.md

@@ -0,0 +1,84 @@
+Develop
+=======
+
+Set up your environment to use the latest version of the Iress Design System (IDS). You can use this library to build React applications that align to IDS, and ensure a consistent and modern look and feel across all Iress products.
+
+Requirements
+------------
+
+*   [React 17 or later](https://reactjs.org/)
+*   Access to Iress Artifactory
+
+Set up the component library
+----------------------------
+
+1.  Install using the command line:
+    
+    yarn add @iress-oss/ids-components
+    
+    ```
+    
+2.  Import the styles:
+    
+    import '@iress-oss/ids-components/dist/style.css';
+    
+    ```
+    
+3.  Import the components. The provider is optional, but recommended for most applications. It sets up the design system and provides a consistent container for components like modals, slideouts, and toasts.
+    
+    import { IressProvider, IressButton } from '@iress-oss/ids-components';
+    
+    ```
+    
+4.  Use the components:
+    
+    const App \= () \=> (
+      <IressButton onClick\={() \=> success({ children: 'Toast triggered' })}\>
+        Trigger toast  </IressButton\>
+    );
+    ReactDOM.createRoot(document.getElementById('root')!).render(
+      <IressProvider\>
+        <App />
+      </IressProvider\>,
+    );
+    
+    ```
+    
+
+* * *
+
+Set up the theme
+----------------
+
+The component library comes with the white label theme by default. You can add a theme by importing the theme file and including it in your application.
+
+Microfrontends
+--------------
+
+If you are building a React App that is intended to be used as a microfrontend, please skip this step. Microfrontends should inherit the parent application's theme, and not define a theme itself, as it may conflict with other microfrontends in the same parent application.
+
+1.  Install using the command line:
+    
+    yarn add @iress/ids-themes
+    
+    ```
+    
+2.  Import the component:
+    
+    import { IressTheme } from '@iress-oss/ids-components';
+    
+    ```
+    
+3.  Add the component to your application:
+    
+    ReactDOM.createRoot(document.getElementById('root')!).render(
+      <IressProvider\>
+        <IressTheme />
+        <App />
+      </IressProvider\>,
+    );
+    
+    ```
+    
+
+For alternative ways to import the theme, see the [Themes documentation](/docs/themes-introduction--docs).

package/generated/docs/components_get-started-using-storybook-docs.md

@@ -0,0 +1,55 @@
+Using Storybook
+===============
+
+The Frontend Enablement team uses Storybook to develop and document our components. Storybook is a development environment for UI components. It allows you to browse a component library, view the different states of each component, and interactively develop and test components. It is most likely what you are looking at right now.
+
+Here we have just highlighted a few of our top tips on how you can use Storybook more efficiently. We have separated it by different stages of the product delivery cycle, but you can use these tips at any stage.
+
+* * *
+
+First-time users
+----------------
+
+When you first come to the IDS Storybook, you may notice the pages look un-styled. This is the default theme of IDS. You can change the theme to the theme you normally use in your product by clicking the \`brush\` icon in the top left, right above this page.
+
+You can also change to use the dark theme of Storybook itself by clicking the \`moon\` icon in the top left, right above this page.
+
+These settings are saved so the next time you come back to Storybook, it will remember your preferences.
+
+Scoping work
+------------
+
+If you are scoping work, you can use Storybook to see what components are available to you. You can also see how they are used and what states they can be in. This can help you to understand what is possible and what is not.
+
+Every IDS component has a `Docs` page and a`Guidelines` (coming soon) page. The `Docs` page will show you how to use the component and what props it accepts, helping you understand what is available, and how each property behaves to allow you to understand the final user experience of your feature.
+
+The `Guidelines` page will show you how to use the component in a way that is consistent with other Iress applications. It covers things like accessibility, usability, and design principles, as well as which scenario to use which component and common pitfalls.
+
+Design
+------
+
+When designing a new feature, you can use Storybook to see how your designs will look and behave in a real application.
+
+`Docs` and `Guidelines` (coming soon) pages will help you understand how to use the components and what is possible, and help you align to any design decisions made previously.
+
+`Stories` are a good way to see how variations of a component look and behave. You can see how a component looks in different states, and how it behaves with different props. If there is a variation that is not shown in the `Stories`, you can use the `Controls` tab to change the props of the component to see how it behaves with different values. You can also toggle how each component looks at different breakpoints (screen sizes/devices), how they look to users with certain eyesight conditions, and how they look in different states.
+
+Development
+-----------
+
+During development, you can refer to Storybook for code examples and understand the API available to you.
+
+If you are using Typescript, majority of the API is available in your IDE. However, Storybook provides more than just the API. It provides examples of how to use and combine the properties, as well as which components were designed to work with each other.
+
+`Docs` covers the API of the component, and also discusses `Examples (stories)`in detail alongside code examples.
+
+If you want to see how a component looks and behaves with different props, you can use the `Controls` tab to change the props of the component to see how it behaves with different values. You can also toggle how each component looks at different breakpoints (screen sizes/devices), how they look to users with certain eyesight conditions, and how they look in different states.
+
+IDS is a starting point for your application development. It provides the foundations to make your application look and behave in a consistent way to other Iress products. However, not everything is covered here. It is good to discuss with designers and other developers to understand any constraints or guidelines that are not covered by IDS.
+
+Common issues
+-------------
+
+### I can't find the `Controls`, `Actions` or `Accessibility` tab
+
+These tabs are only shown in the component `Stories`, which can be toggled to display using the bookmark icon on the top right of the screen. If you click on an stories and still cannot see it, you may need to toggle the orientation of the addon. You can do this by tapping the `d` key twice, or using the settings as shown in the video.

package/generated/docs/components_introduction-docs.md

@@ -0,0 +1,15 @@
+Iress Design System
+===================
+
+5.20.2
+
+* * *
+
+The Iress Design System (IDS) serves as a shared visual language, working code, design tools and resources, human interface guidelines, and a community of contributors. It supports designers and developers building digital products for both B2B (Financial Advisors, Paraplanners) and B2B2C (client customers) segments.
+
+Ready to dive in?
+-----------------
+
+Start shipping faster with IDS.
+
+[Get started](/?path=/docs/get-started-develop--docs)