@iress-oss/ids-mcp-server 5.14.2 → 6.0.0-alpha.0

package/generated/docs/styling-props-typography-docs.md

@@ -0,0 +1,121 @@
+[](#typography)Typography
+=========================
+
+These are all styling props related to changing the typography of a component.
+
+[](#textstyle)`textStyle`
+-------------------------
+
+The `textStyle` prop allows you to change the default text style of a component. For more control and nested element styling, it is recommended to use `IressText` instead.
+
+A panel with large text
+
+Hide code
+
+\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
+
+<IressPanel
+  bg\="alt"
+  textStyle\="typography.body.lg"
+\>
+  A panel with large text
+</IressPanel\>
+
+Copy
+
+#### [](#textStyle-props)Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| textAlign | 
+The **`text-align`** CSS property sets the horizontal alignment of the inline-level content inside a block element or table-cell box.
+
+| Chrome | Firefox | Safari | Edge | IE |
+| --- | --- | --- | --- | --- |
+| **1** | **1** | **1** | **12** | **3** |
+
+ResponsiveProp<"center" | "left" | "right" | "inherit" | "justify"> | undefined
+
+ | \- | Set object |
+| textStyle | 
+
+Select the typography to be used using the **`textStyle`** prop. These are connected to the typography tokens in the design system.'
+
+*   `typography.body.sm` - Use for small components such as badges and disclaimers, as well as compact variations of tables and lists.
+*   `typography.body.md` - The most commonly used body text size, used for most text content in the product and the default state of all components in the design system.
+*   `typography.body.lg` - Use for tag lines, subtitles, and other large text content in the product.
+*   `typography.heading.1` - Use for the main page title to establish a clear hierarchy. There is typically only one H1 per screen, emphasising the primary purpose or context of the page.
+*   `typography.heading.2` - Use for primary section headings within a page to organise content and guide the user through key areas. Also suitable for large components—such as modals—where space allows and where it pairs well with body.md or body.lg.
+*   `typography.heading.3` - Use for sub-sections under H2s to further structure content and maintain a clear visual hierarchy. Ideal for breaking down complex sections into manageable parts.
+*   `typography.heading.4` - Use for supporting headings within content blocks or small components where space is limited—such as table headers, cards, or side panels. Provides structure without overwhelming the layout.
+*   `typography.heading.5` - Use for minor labels or titles in compact UI elements, such as cards, sidebars, or inline labels. Best used to emphasise supplementary information without drawing too much attention. Works well with body.sm and is ideal for subtle content like fine print. Use sparingly to preserve typographic hierarchy.
+*   `typography.code` - Used to display code snippets in the product, such as in the API documentation.
+
+ResponsiveProp<"typography.heading.1" | "typography.heading.2" | "typography.heading.3" | "typography.heading.4" | "typography.heading.5" | "typography.body.sm" | "typography.body.sm.regular" | ... 10 more ... | "typography.code"> | undefined
+
+ | \- | 
+
+"typography.body.lg"
+
+ |
+
+[](#textalign)`textAlign`
+-------------------------
+
+The `textAlign` prop allows you to change the alignment of text inside a component. For more control, it is recommended to use `IressText` instead.
+
+A panel with centered text
+
+Hide code
+
+\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
+
+<IressPanel
+  bg\="alt"
+  textAlign\="center"
+\>
+  A panel with centered text
+</IressPanel\>
+
+Copy
+
+#### [](#textAlign-props)Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| textAlign | 
+The **`text-align`** CSS property sets the horizontal alignment of the inline-level content inside a block element or table-cell box.
+
+| Chrome | Firefox | Safari | Edge | IE |
+| --- | --- | --- | --- | --- |
+| **1** | **1** | **1** | **12** | **3** |
+
+ResponsiveProp<"center" | "left" | "right" | "inherit" | "justify"> | undefined
+
+ | \- | 
+
+"center"
+
+ |
+| textStyle | 
+
+Select the typography to be used using the **`textStyle`** prop. These are connected to the typography tokens in the design system.'
+
+*   `typography.body.sm` - Use for small components such as badges and disclaimers, as well as compact variations of tables and lists.
+*   `typography.body.md` - The most commonly used body text size, used for most text content in the product and the default state of all components in the design system.
+*   `typography.body.lg` - Use for tag lines, subtitles, and other large text content in the product.
+*   `typography.heading.1` - Use for the main page title to establish a clear hierarchy. There is typically only one H1 per screen, emphasising the primary purpose or context of the page.
+*   `typography.heading.2` - Use for primary section headings within a page to organise content and guide the user through key areas. Also suitable for large components—such as modals—where space allows and where it pairs well with body.md or body.lg.
+*   `typography.heading.3` - Use for sub-sections under H2s to further structure content and maintain a clear visual hierarchy. Ideal for breaking down complex sections into manageable parts.
+*   `typography.heading.4` - Use for supporting headings within content blocks or small components where space is limited—such as table headers, cards, or side panels. Provides structure without overwhelming the layout.
+*   `typography.heading.5` - Use for minor labels or titles in compact UI elements, such as cards, sidebars, or inline labels. Best used to emphasise supplementary information without drawing too much attention. Works well with body.sm and is ideal for subtle content like fine print. Use sparingly to preserve typographic hierarchy.
+*   `typography.code` - Used to display code snippets in the product, such as in the API documentation.
+
+ResponsiveProp<"typography.heading.1" | "typography.heading.2" | "typography.heading.3" | "typography.heading.4" | "typography.heading.5" | "typography.body.sm" | "typography.body.sm.regular" | ... 10 more ... | "typography.code"> | undefined
+
+ | \- | Set object |
+
+On this page
+
+*   [textStyle](#textstyle)
+*   [textAlign](#textalign)

package/generated/docs/themes-available-themes-docs.md

@@ -17,11 +17,11 @@ Themes are no longer connected to the version of IDS you are using. Instead they
 [](#list)List
 -------------
 
-Version: 5.5.0-29782
+Version: 5.5.0-30735
 
 * * *
 
-5.5.0-29782Latest5.4.8-262445.4.7-261205.4.6-260525.4.5-260275.4.4-260225.4.3-259955.4.2-259585.4.1-259415.4.0-294265.3.2-290865.3.1-29028
+5.5.0-30735Latest5.4.8-262445.4.7-261205.4.6-260525.4.5-260275.4.4-260225.4.3-259955.4.2-259585.4.1-259415.4.0-294265.3.2-290865.3.1-29028
 
 None selected
 
@@ -29,36 +29,36 @@ Latest build only
 
 * * *
 
-### Version: 5.5.0-29782
-
-*   [css/demo-theme-1--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-1--touch.css)
-*   [css/demo-theme-1.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-1.css)
-*   [css/demo-theme-2--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-2--touch.css)
-*   [css/demo-theme-2.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-2.css)
-*   [css/demo-theme-3--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-3--touch.css)
-*   [css/demo-theme-3.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-3.css)
-*   [css/demo-theme-4--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-4--touch.css)
-*   [css/demo-theme-4.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-4.css)
-*   [css/demo-theme-5--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-5--touch.css)
-*   [css/demo-theme-5.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-5.css)
-*   [css/demo-theme-6--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-6--touch.css)
-*   [css/demo-theme-6.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/demo-theme-6.css)
-*   [css/hostplus-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/hostplus-theme-light--touch.css)
-*   [css/hostplus-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/hostplus-theme-light.css)
-*   [css/iress-beta-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-dark--touch.css)
-*   [css/iress-beta-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-dark.css)
-*   [css/iress-beta-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-light--touch.css)
-*   [css/iress-beta-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-beta-theme-light.css)
-*   [css/iress-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-dark--touch.css)
-*   [css/iress-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-dark.css)
-*   [css/iress-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-light--touch.css)
-*   [css/iress-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-light.css)
-*   [css/iress-theme-wealth--touch.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-wealth--touch.css)
-*   [css/iress-theme-wealth.css](https://cdn-staging.iress.com/ids/5.5.0-29782/themes/css/iress-theme-wealth.css)
+### Version: 5.5.0-30735
+
+*   [css/demo-theme-1--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-1--touch.css)
+*   [css/demo-theme-1.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-1.css)
+*   [css/demo-theme-2--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-2--touch.css)
+*   [css/demo-theme-2.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-2.css)
+*   [css/demo-theme-3--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-3--touch.css)
+*   [css/demo-theme-3.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-3.css)
+*   [css/demo-theme-4--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-4--touch.css)
+*   [css/demo-theme-4.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-4.css)
+*   [css/demo-theme-5--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-5--touch.css)
+*   [css/demo-theme-5.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-5.css)
+*   [css/demo-theme-6--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-6--touch.css)
+*   [css/demo-theme-6.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/demo-theme-6.css)
+*   [css/hostplus-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/hostplus-theme-light--touch.css)
+*   [css/hostplus-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/hostplus-theme-light.css)
+*   [css/iress-beta-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-beta-theme-dark--touch.css)
+*   [css/iress-beta-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-beta-theme-dark.css)
+*   [css/iress-beta-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-beta-theme-light--touch.css)
+*   [css/iress-beta-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-beta-theme-light.css)
+*   [css/iress-theme-dark--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-dark--touch.css)
+*   [css/iress-theme-dark.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-dark.css)
+*   [css/iress-theme-light--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-light--touch.css)
+*   [css/iress-theme-light.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-light.css)
+*   [css/iress-theme-wealth--touch.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-wealth--touch.css)
+*   [css/iress-theme-wealth.css](https://cdn-staging.iress.com/ids/5.5.0-30735/themes/css/iress-theme-wealth.css)
 
 #### Theme mappings
 
-*   [ag-theme-iress-lite.css](https://cdn-staging.iress.com/ids/5.5.0-29782/ag-theme-iress-lite.css)
+*   [ag-theme-iress-lite.css](https://cdn-staging.iress.com/ids/5.5.0-30735/ag-theme-iress-lite.css)
 
 On this page
 

package/generated/docs/themes-introduction-docs.md

@@ -7,7 +7,7 @@ The Iress Design System is designed to be white-labelled, allowing you to change
 
 Beta
 
-New component
+**New component**
 
 This component is new, please provide feedback to the IDS team if you encounter any issues.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iress-oss/ids-mcp-server",
-  "version": "5.14.2",
+  "version": "6.0.0-alpha.0",
   "description": "Model Context Protocol (MCP) server for Iress Design System (IDS) component library - provides AI assistants with contextual information about IDS components, design tokens, and usage patterns",
   "type": "module",
   "publishConfig": {
@@ -32,17 +32,7 @@
   "author": "Iress",
   "license": "Apache-2.0",
   "scripts": {
-    "build": "tsc && chmod 755 ./dist/index.js",
-    "clean": "rimraf dist coverage generated .nyc_output",
-    "dev": "tsc --watch",
-    "generate": "tsx scripts/generate.ts",
-    "lint": "eslint . --ext ts,tsx,mdx --report-unused-disable-directives --max-warnings 0",
-    "lint:fix": "eslint . --fix",
-    "start": "node dist/index.js",
-    "test": "vitest run --coverage",
-    "test:dev": "chmod +x ./scripts/test-dev-server.sh && ./scripts/test-dev-server.sh",
-    "test:watch": "vitest watch",
-    "typecheck": "tsc --noEmit"
+    "generate": "tsx scripts/generate.ts"
   },
   "files": [
     "dist",
@@ -57,24 +47,15 @@
   "devDependencies": {
     "@types/node": "^22.15.21",
     "@types/turndown": "^5.0.5",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "~8.34.0",
     "@vitest/coverage-v8": "^3.2.4",
     "commander": "^12.0.0",
     "dotenv": "^16.5.0",
-    "eslint": "^8.56.0",
-    "eslint-config-prettier": "^10.0.0",
-    "eslint-plugin-file-progress": "^1.4.0",
-    "eslint-plugin-prettier": "^5.1.3",
-    "eslint-plugin-sonarjs": "^3.0.0",
     "playwright": "^1",
-    "prettier": "^3.3.3",
-    "prettier-plugin-sh": "^0.17.0",
     "rimraf": "^6.0.1",
     "tsx": "^4.20.3",
     "turndown": "^7.1.3",
     "turndown-plugin-gfm": "^1.0.2",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.1.3"
   }
 }

package/generated/docs/components-button-recipes-docs.md

@@ -1,76 +0,0 @@
-[](#recipes)Recipes
-===================
-
-[](#using-with-react-router)Using with React Router
----------------------------------------------------
-
-To use the `IressButton` component with React Router, you can use the `useHref` hook to get the `href` prop to pass to the `IressButton` component.
-
-Learn more about the `useHref` hook in the [React Router documentation](https://reactrouter.com/docs/en/v6/api#usehref).
-
-\[data-radix-scroll-area-viewport\] {
-  scrollbar-width: none;
-  -ms-overflow-style: none;
-  -webkit-overflow-scrolling: touch;
-}
-\[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
-  display: none;
-}
-:where(\[data-radix-scroll-area-viewport\]) {
-  display: flex;
-  flex-direction: column;
-  align-items: stretch;
-}
-:where(\[data-radix-scroll-area-content\]) {
-  flex-grow: 1;
-}
-
-import { IressButton } from '@iress/components';
-import { useHref } from 'react-router-dom';
-const ReactRouterButton \= () \=> {
-  const href \= useHref('/path/to/page');
-  return <IressButton href\={href}\>Go to page</IressButton\>;
-};
-
-Copy
-
-[](#using-with-nextjs)Using with Next.js
-----------------------------------------
-
-To use the `IressButton` component with Next.js, you can use the `legacyBehavior` and `passHref` props to pass the `href` prop to the `IressButton` component.
-
-Learn more about the `Link` component in the [Next.js documentation](https://nextjs.org/docs/pages/api-reference/components/link#nesting-a-functional-component).
-
-\[data-radix-scroll-area-viewport\] {
-  scrollbar-width: none;
-  -ms-overflow-style: none;
-  -webkit-overflow-scrolling: touch;
-}
-\[data-radix-scroll-area-viewport\]::-webkit-scrollbar {
-  display: none;
-}
-:where(\[data-radix-scroll-area-viewport\]) {
-  display: flex;
-  flex-direction: column;
-  align-items: stretch;
-}
-:where(\[data-radix-scroll-area-content\]) {
-  flex-grow: 1;
-}
-
-import { IressButton } from '@iress/components';
-import Link from 'next/link';
-const NextButton \= () \=> {
-  return (
-    <Link href\="/path/to/page" legacyBehavior passHref\>
-      <IressButton\>Go to page</IressButton\>
-    </Link\>
-  );
-};
-
-Copy
-
-On this page
-
-*   [Using with React Router](#using-with-react-router)
-*   [Using with Next.js](#using-with-nextjs)

package/generated/docs/components-card-recipes-docs.md

@@ -1,89 +0,0 @@
-[](#recipes)Recipes
-===================
-
-Under construction
-------------------
-
-This documentation is still under construction. If you have any questions, please reach out to the design system team.
-
-[](#compose-functions)Compose functions
----------------------------------------
-
-Beneath the surface, the `IressCard` component uses a compose helper to manage its styling. These helpers are exposed as `composeIDSCard` and `composeIDSCardSlots` and can be used to create custom cards.
-
-They accept a subset of `IressCardProps`. They also accept an optional second argument if you want to override the default styles with your own CSS module, or other `style` object (eg. CSS-in-JS).
-
-### [](#use-cases)Use cases
-
-1.  You are using a third-party routing library with its own `Link` component and want to use it as a clickable card. This is similar to `IressButtonCard` and `IressLinkCard`.
-2.  You need a different base component to meet your requirements, such as `<article />` when displaying on a news page.
-3.  You need to add some additional styling to the internals of the card, such as a custom footer or a custom image.
-
-Article mark-up, with custom classes for border
------------------------------------------------
-
-Prepend
-
-TopRight
-
-Media
-
-Heading
--------
-
-Children (default slot)
-
-Footer
-
-Hide code
-
-\[data-radix-scroll-area-viewport\] { scrollbar-width: none; -ms-overflow-style: none; -webkit-overflow-scrolling: touch; } \[data-radix-scroll-area-viewport\]::-webkit-scrollbar { display: none; } :where(\[data-radix-scroll-area-viewport\]) { display: flex; flex-direction: column; align-items: stretch; } :where(\[data-radix-scroll-area-content\]) { flex-grow: 1; }
-
-import {
-  CardSlotClass,
-  composeIDSCard,
-  composeIDSCardSlots,
-  IressCardProps,
-  IressStack,
-  IressText,
-} from '@iress-oss/ids-components';
-import styles from '@iress-storybook/styles.module.scss';
-export const CardUsingHook \= () \=> {
-  const cardProps \= composeIDSCard({
-  prepend: 'Prepend',
-  heading: 'Heading',
-  topRight: 'TopRight',
-  media: 'Media',
-  children: 'Children (default slot)',
-  footer: 'Footer',
-});
-  const cardChildren \= composeIDSCardSlots({
-  prepend: 'Prepend',
-  heading: 'Heading',
-  topRight: 'TopRight',
-  media: 'Media',
-  children: 'Children (default slot)',
-  footer: 'Footer',
-}, {
-    ...Object.fromEntries(
-      Object.entries(CardSlotClass).map((\[key, value\]) \=> \[
-        key,
-        \`${value} ${styles.addBorder}\`,
-      \]),
-    ),
-  });
-  return (
-    <IressStack gutter\="md"\>
-      <IressText element\="h2"\>
-        Article mark-up, with custom classes for border      </IressText\>
-      <article {...cardProps}\>{cardChildren}</article\>
-    </IressStack\>
-  );
-};
-
-Copy
-
-On this page
-
-*   [Compose functions](#compose-functions)
-    *   [Use cases](#use-cases)