@iress-oss/ids-mcp-server 0.0.1 → 5.14.2

package/generated/docs/components-popover-docs.md

@@ -0,0 +1,464 @@
+[](#popover)Popover
+===================
+
+Overview
+--------
+
+A popover is panel that is toggled on/off by an activator button or text input. The panel is positioned relative to its activator element.
+
+Toggle popover
+
+A little more information about this area.
+
+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; }
+
+<IressPopover activator\={<IressButton\>Toggle popover</IressButton\>}\>
+  <IressPanel className\="iress-u-text"\>
+    A little more information about this area.  </IressPanel\>
+</IressPopover\>
+
+Copy
+
+[](#usage)Usage
+---------------
+
+### [](#activator)Activator
+
+For the popover to render, the `activator` property is required. It is the element used to trigger the popover, and works best with an `IressButton`.
+
+Anything added as the children of the `IressPopover` component will be displayed in the popover panel.
+
+Toggle popover
+
+A little more information about this area.
+
+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; }
+
+<IressPopover activator\={<IressButton\>Toggle popover</IressButton\>}\>
+  <IressPanel className\="iress-u-text"\>
+    A little more information about this area.  </IressPanel\>
+</IressPopover\>
+
+Copy
+
+### [](#the-show-property)The `show` property
+
+You can use state to control the popover by setting the `show` property to `true` or `false`. To sync your state with the popover, you can use the `onActivated` and `onDeactivated` prop.
+
+Show popover using state
+
+A little more information about this area.
+
+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 {
+  IressButton,
+  IressPanel,
+  IressPopover,
+  IressPopoverProps,
+} from '@iress-oss/ids-components';
+import { useState } from 'react';
+export const PopoverUsingState \= () \=> {
+  const \[show, setShow\] \= useState(false);
+  return (
+    <IressPopover
+      
+      activator\={
+        <IressButton onClick\={() \=> setShow(!show)}\>
+          Show popover using state        </IressButton\>
+      }
+      show\={show}
+      onActivated\={() \=> setShow(true)}
+      onDeactivated\={() \=> setShow(false)}
+    \>
+      <IressPanel\>A little more information about this area.</IressPanel\>
+    </IressPopover\>
+  );
+};
+
+Copy
+
+[](#behaviour)Behaviour
+-----------------------
+
+*   The popover is opened when the activator is pressed
+*   Once activated, the popover will set focus to popover content
+*   When the activator is pressed whilst the popover is open, it will close
+*   When the escape key is pressed while it is open, it will close
+*   When the popover panel loses focus, it will close
+
+[](#examples)Examples
+---------------------
+
+### [](#align)Align
+
+The popover panel can be aligned in one of 12 positions relative to the activator element. The default value is `auto`.
+
+The popover panel's position will change dynamically based on the amount of space available in it's container window, so that it doesn't overflow.
+
+top-start
+
+Hello!
+
+top
+
+Hello!
+
+top-end
+
+Hello!
+
+left-start
+
+Hello!
+
+left
+
+Hello!
+
+left-end
+
+Hello!
+
+right-start
+
+Hello!
+
+right
+
+Hello!
+
+right-end
+
+Hello!
+
+bottom-start
+
+Hello!
+
+bottom
+
+Hello!
+
+bottom-end
+
+Hello!
+
+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; }
+
+<div
+  style\={{
+    padding: '80px 150px'
+  }}
+\>
+  <IressStack gutter\="md"\>
+    <IressInline
+      gutter\="sm"
+      horizontalAlign\="center"
+    \>
+      <IressPopover
+        activator\={<IressTooltip align\="bottom-start" tooltipText\="Tooltips and popovers can go together if needed!"\><IressButton\>top-start</IressButton\></IressTooltip\>}
+        align\="top-start"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+      <IressPopover
+        activator\={<IressButton\>top</IressButton\>}
+        align\="top"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+      <IressPopover
+        activator\={<IressButton\>top-end</IressButton\>}
+        align\="top-end"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+    </IressInline\>
+    <IressInline horizontalAlign\="between"\>
+      <IressStack gutter\="sm"\>
+        <IressInline horizontalAlign\="left"\>
+          <IressPopover
+            activator\={<IressButton\>left-start</IressButton\>}
+            align\="left-start"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+        <IressInline horizontalAlign\="left"\>
+          <IressPopover
+            activator\={<IressButton\>left</IressButton\>}
+            align\="left"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+        <IressInline horizontalAlign\="left"\>
+          <IressPopover
+            activator\={<IressButton\>left-end</IressButton\>}
+            align\="left-end"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+      </IressStack\>
+      <IressStack gutter\="sm"\>
+        <IressInline horizontalAlign\="right"\>
+          <IressPopover
+            activator\={<IressButton\>right-start</IressButton\>}
+            align\="right-start"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+        <IressInline horizontalAlign\="right"\>
+          <IressPopover
+            activator\={<IressButton\>right</IressButton\>}
+            align\="right"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+        <IressInline horizontalAlign\="right"\>
+          <IressPopover
+            activator\={<IressButton\>right-end</IressButton\>}
+            align\="right-end"
+          \>
+            <IressPanel className\="iress-u-text"\>
+              Hello!            </IressPanel\>
+          </IressPopover\>
+        </IressInline\>
+      </IressStack\>
+    </IressInline\>
+    <IressInline
+      gutter\="sm"
+      horizontalAlign\="center"
+    \>
+      <IressPopover
+        activator\={<IressButton\>bottom-start</IressButton\>}
+        align\="bottom-start"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+      <IressPopover
+        activator\={<IressButton\>bottom</IressButton\>}
+        align\="bottom"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+      <IressPopover
+        activator\={<IressButton\>bottom-end</IressButton\>}
+        align\="bottom-end"
+      \>
+        <IressPanel className\="iress-u-text"\>
+          Hello!        </IressPanel\>
+      </IressPopover\>
+    </IressInline\>
+  </IressStack\>
+</div\>
+
+Copy
+
+### [](#width)Width
+
+Occasionally, you may have more information to display than the width set by the theme can comfortably show.
+
+This is where the `--iress-width` CSS token come in, it will allow you to set the width for the popover panel. For better results, its recommended to use it with the `--iress-max-width` CSS token, to allow your popovers to be responsive.
+
+**Note:** The `width` prop has been deprecated in favour of the CSS tokens.
+
+Toggle popover
+
+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; }
+
+<IressPopover
+  activator\={<IressButton\>Toggle popover</IressButton\>}
+  container\={document.body}
+  style\={{
+    '--iress-max-width': '30rem',
+    '--iress-width': '100%'
+  }}
+\>
+  <IressPanel\>
+    <IressRow\>
+      <IressCol span\={6}\>
+        <IressText\>
+          Client        </IressText\>
+        <IressText noGutter\>
+          <ul\>
+            <li\>
+              Entity id 582323            </li\>
+            <li\>
+              Fruit Apple            </li\>
+            <li\>
+              Preferred email mamaduke@gmail.com            </li\>
+          </ul\>
+        </IressText\>
+      </IressCol\>
+      <IressCol span\={6}\>
+        <IressText\>
+          Client        </IressText\>
+        <IressText noGutter\>
+          <ul\>
+            <li\>
+              Entity id 8766            </li\>
+            <li\>
+              Fruit Orange            </li\>
+            <li\>
+              Preferred email felicity@yahoo.com            </li\>
+          </ul\>
+        </IressText\>
+      </IressCol\>
+    </IressRow\>
+  </IressPanel\>
+</IressPopover\>
+
+Copy
+
+### [](#overflow)Overflow
+
+Popovers can contain a wide variety of different content, including components that use popovers themselves (like Combobox). This can cause issues with overflowing content, so by default we allow popovers to grow in height based on their content.
+
+If you need to fix the height of a popover, you can set a maximum height using the `--iress-max-height` theme token on your popover. You'll also need to change the overflow behaviour by setting the `--iress-overflow-y` theme token:
+
+Normal popover
+
+Fixed height popover
+
+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; }
+
+<IressInline gutter\="md"\>
+  <IressPopover
+    activator\={<IressButton\>Normal popover</IressButton\>}
+    align\="bottom-start"
+    container\={document.body}
+  \>
+    <IressPanel\>
+      <IressText noGutter\>
+        <p\>
+          His head is gone, it is like it is been erased... Erased from existence. That was the day I invented time travel. I remember it vividly. I was standing on the edge of my toilet hanging a clock, the porces was wet, I slipped, hit my head on the edge of the sink. And when I came to I had a revelation, a picture, a picture in my head, a picture of this. This is what makes time travel possible. The flux capacitor.        </p\>
+      </IressText\>
+    </IressPanel\>
+  </IressPopover\>
+  <IressPopover
+    activator\={<IressButton\>Fixed height popover</IressButton\>}
+    align\="bottom-start"
+    container\={document.body}
+    style\={{
+      '--iress-max-height': '200px',
+      '--iress-overflow-y': 'auto'
+    }}
+  \>
+    <IressPanel\>
+      <IressText noGutter\>
+        <p\>
+          His head is gone, it is like it is been erased... Erased from existence. That was the day I invented time travel. I remember it vividly. I was standing on the edge of my toilet hanging a clock, the porces was wet, I slipped, hit my head on the edge of the sink. And when I came to I had a revelation, a picture, a picture in my head, a picture of this. This is what makes time travel possible. The flux capacitor.        </p\>
+      </IressText\>
+    </IressPanel\>
+  </IressPopover\>
+</IressInline\>
+
+Copy
+
+### [](#container)Container
+
+By default, the popover will be rendered where its parent is rendered. If you need to render the popover in a different container, you can use the `container` prop.
+
+**Note:** If the `container` doesn’t exist when the portal is mounted, ensure you pass an element directly (not a ref) and specify null as the default value before it is set. This lets it wait for the root to be available.
+
+This will be the case when you are rendering into its parent container, which is not yet rendered when the popover is mounted. The example below shows how to use state instead of a reference to change where the popover is rendered.
+
+Toggle
+
+This content will be rendered in the parent container
+
+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; }
+
+export const PopoverParentContainer \= () \=> {
+  const \[parentContainer, setParentContainer\] \= useState<HTMLDivElement | null\>(
+    null,
+  );
+  return (
+    <div id\="parent" ref\={setParentContainer}\>
+      <IressPopover
+        activator\={<IressButton\>Toggle</IressButton\>}
+        container\={parentContainer}
+      \>
+        <IressPanel\>
+          This content will be rendered in the parent container        </IressPanel\>
+      </IressPopover\>
+    </div\>
+  );
+};
+
+Copy
+
+[](#iressinputpopover)`IressInputPopover`
+-----------------------------------------
+
+If you need a popover that is triggered by input changes, you can use the `IressInputPopover` component. This component has an additional `minLength` prop that allows you to specify the minimum number of characters required before the popover is shown.
+
+### [](#behaviour-1)Behaviour
+
+Input popovers work slightly different to normal popovers, where the focus inside the popover is **virtual**. This means that the popover content will act as if it is in focus, but the input will still be the actual focus.
+
+*   The popover is opened when the input has content that meets the `minLength` requirement
+*   The popover is closed when the input no longer meets the `minLength` requirement
+*   Once activated, virtual focus will be set to the popover content if it contains a menu (e.g. items will highlight as if in focus, but the user can still type in the input)
+*   When the `minLength` is 0, it will open on focus
+*   When the escape key is pressed while it is open, it will close
+*   When the input loses focus, it will close
+
+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; }
+
+<IressInputPopover
+  activator\={<IressInput />}
+  container\={document.body}
+\>
+  <IressPanel className\="iress-u-text"\>
+    A little more information about this area.  </IressPanel\>
+</IressInputPopover\>
+
+Copy
+
+On this page
+
+*   [Overview](#overview)
+*   [Props](#props)
+*   [Usage](#usage)
+    *   [Activator](#activator)
+    *   [The show property](#the-show-property)
+*   [Behaviour](#behaviour)
+*   [Examples](#examples)
+    *   [Align](#align)
+    *   [Width](#width)
+    *   [Overflow](#overflow)
+    *   [Container](#container)
+*   [IressInputPopover](#iressinputpopover)
+    *   [Behaviour](#behaviour-1)

package/{docs/ids → generated/docs}/components-radiogroup-docs.md

@@ -171,22 +171,22 @@ Hide code
       stack    </h3\>
     <IressRadioGroup layout\="stack"\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="google"
       \>
         Google      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="friend"
       \>
         Friend      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="other"
       \>
         Other      </IressRadio\>
@@ -197,22 +197,22 @@ Hide code
       block    </h3\>
     <IressRadioGroup layout\="block"\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="google"
       \>
         Google      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="friend"
       \>
         Friend      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="other"
       \>
         Other      </IressRadio\>
@@ -223,22 +223,22 @@ Hide code
       inline    </h3\>
     <IressRadioGroup layout\="inline"\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="google"
       \>
         Google      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="friend"
       \>
         Friend      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="other"
       \>
         Other      </IressRadio\>
@@ -249,22 +249,22 @@ Hide code
       inlineFlex    </h3\>
     <IressRadioGroup layout\="inlineFlex"\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="google"
       \>
         Google      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="friend"
       \>
         Friend      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="other"
       \>
         Other      </IressRadio\>
@@ -275,22 +275,22 @@ Hide code
       inlineEqualWidth    </h3\>
     <IressRadioGroup layout\="inlineEqualWidth"\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="google"
       \>
         Google      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="newspaper"
       \>
         Newspaper      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="friend"
       \>
         Friend      </IressRadio\>
       <IressRadio
-        className\="ids-styles--add-border-v5130"
+        className\="ids-styles--add-border-v5142"
         value\="other"
       \>
         Other      </IressRadio\>
@@ -441,7 +441,7 @@ Hide code
     }}
   \>
     <div
-      className\="ids-styles--resizable-v5130"
+      className\="ids-styles--resizable-v5142"
       style\={{
         display: 'grid',
         gridAutoRows: '1fr',