@iress-oss/ids-mcp-server 6.0.0-alpha.1-canary-20251204032753-fe18cab → 6.0.0-alpha.1-canary-20251204040305-3639454

package/generated/docs/components_components-tabset-tab-docs.md

@@ -0,0 +1,342 @@
+Tab
+===
+
+Overview
+--------
+
+A tab is an interactive element that controls the display of other content, usually a panel
+
+* * *
+
+Updated
+
+**Recently updated**
+
+This component has been recently updated with new props. The props have been marked as beta. Please tell us if there are any issues.
+
+[](./iframe.html?id=components-tabset-tab--inactive)
+
+Tab
+
+```
+
+<IressTab label\="Tab" />
+
+```
+
+Props
+-----
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| active | 
+Sets the active styling of the tab.
+
+boolean
+
+
+
+ | \- | Set boolean |
+| children | 
+
+Text to be displayed inside the tab panel.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| href | 
+
+Contains a URL or a URL fragment that the hyperlink points to. If this property is set, an anchor tag will be rendered.
+
+**Note:** This prop should be avoided when using `children`.
+
+THref
+
+
+
+ | \- | Set object |
+| label\* | 
+
+The label of this tab.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tab"
+
+ |
+| type | 
+
+ | 
+
+'button'
+
+ | Set object |
+| value | 
+
+You can provide your own value to allow you to control its active state when used in `IressTabSet`.
+
+FormControlValue
+
+
+
+ | \- | Set object |
+
+Examples
+--------
+
+### Active
+
+The tab can be set to active using the `active` prop.
+
+**Note:** If you are using `IressTabSet`, you should use the `selected` prop on the `IressTabSet` to set the active state of its `<IressTab />` children, as the `active` prop will be ignored.
+
+[](./iframe.html?id=components-tabset-tab--active)
+
+Tab
+
+```
+
+<IressTab
+  active
+  label\="Tab"
+/>
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| active | 
+Sets the active styling of the tab.
+
+boolean
+
+
+
+ | \- | FalseTrue |
+| children | 
+
+Text to be displayed inside the tab panel.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| href | 
+
+Contains a URL or a URL fragment that the hyperlink points to. If this property is set, an anchor tag will be rendered.
+
+**Note:** This prop should be avoided when using `children`.
+
+THref
+
+
+
+ | \- | Set object |
+| label\* | 
+
+The label of this tab.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tab"
+
+ |
+| type | 
+
+ | 
+
+'button'
+
+ | Set object |
+| value | 
+
+You can provide your own value to allow you to control its active state when used in `IressTabSet`.
+
+FormControlValue
+
+
+
+ | \- | Set object |
+
+### Value
+
+A tab can have a unique value set to it, used to determine its active state in a `IressTabSet` component. The value is not visible to end users.
+
+[](./iframe.html?id=components-tabset-tab--value)
+
+Tab with value
+
+```
+
+<IressTabSet\>
+  <IressTab
+    label\="Tab with value"
+    value\="some-tab-name"
+  />
+</IressTabSet\>
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| active | 
+Sets the active styling of the tab.
+
+boolean
+
+
+
+ | \- | Set boolean |
+| children | 
+
+Text to be displayed inside the tab panel.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| href | 
+
+Contains a URL or a URL fragment that the hyperlink points to. If this property is set, an anchor tag will be rendered.
+
+**Note:** This prop should be avoided when using `children`.
+
+THref
+
+
+
+ | \- | Set object |
+| label\* | 
+
+The label of this tab.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tab with value"
+
+ |
+| type | 
+
+ | 
+
+'button'
+
+ | Set object |
+| value | 
+
+You can provide your own value to allow you to control its active state when used in `IressTabSet`.
+
+FormControlValue
+
+
+
+ | \- | 
+
+"some-tab-name"
+
+ |
+
+### Panel
+
+A tab can set its `children` when used inside an `IressTabSet` component, and it will render as its panel. If the tab is not used inside an `IressTabSet` component, `children` will not render.
+
+[](./iframe.html?id=components-tabset-tab--panel)
+
+Tab
+
+Some content for this tab
+
+```
+
+<IressTabSet\>
+  <IressTab label\="Tab"\>
+    Some content for this tab  </IressTab\>
+</IressTabSet\>
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| active | 
+Sets the active styling of the tab.
+
+boolean
+
+
+
+ | \- | Set boolean |
+| children | 
+
+Text to be displayed inside the tab panel.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Some content for this tab"
+
+ |
+| href | 
+
+Contains a URL or a URL fragment that the hyperlink points to. If this property is set, an anchor tag will be rendered.
+
+**Note:** This prop should be avoided when using `children`.
+
+THref
+
+
+
+ | \- | Set object |
+| label\* | 
+
+The label of this tab.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tab"
+
+ |
+| type | 
+
+ | 
+
+'button'
+
+ | Set object |
+| value | 
+
+You can provide your own value to allow you to control its active state when used in `IressTabSet`.
+
+FormControlValue
+
+
+
+ | \- | Set object |

package/generated/docs/components_components-tag-docs.md

@@ -0,0 +1,410 @@
+Tag
+===
+
+Overview
+--------
+
+Tags represent individual units in a group of selected items.
+
+* * *
+
+Updated
+
+**Recently updated**
+
+This component has been recently updated with new props. The props have been marked as beta. Please tell us if there are any issues.
+
+[](./iframe.html?id=components-tag--tag)
+
+Tag
+
+```
+
+<IressTag\>
+  Tag
+</IressTag\>
+
+```
+
+Props
+-----
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| children | 
+Contents of the tag.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tag"
+
+ |
+| deleteButton | 
+
+You can completely replace the delete button to provide your own functionality. When this is provided, `deleteButtonText` will not be used and `onDelete` and `onDeleteButtonBlur` will not be called.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| deleteButtonText | 
+
+Screen reader text for delete button
+
+string
+
+
+
+ | 
+
+'Delete'
+
+ | Set string |
+| onDelete | 
+
+Callback triggered when the tag is deleted
+
+(children: string, e: SyntheticEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+| onDeleteButtonBlur | 
+
+Callback triggered when the close button is blurred
+
+(e: FocusEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+
+Usage
+-----
+
+### Deleting tags
+
+The delete button will not automatically remove the tag from the screen. Instead it will trigger the `onDelete` event. Use this event within your app to handle the display of tags.
+
+The text a screen reader will announce defaults to "Delete" but can be changed using the `deleteButtonText` prop.
+
+[](./iframe.html?id=components-tag--deleting-tags)
+
+Tag 1Tag 2Tag 3
+
+```
+
+export const TagDeletion \= (args: IressTagProps) \=> {
+  const \[tags, setTags\] \= useState(\['Tag 1', 'Tag 2', 'Tag 3'\]);
+  const handleAdd: IressButtonProps\['onClick'\] \= () \=> {
+    setTags(\[...tags, \`Tag ${tags.length + 1}\`\]);
+  };
+  const handleDelete: IressTagProps\['onDelete'\] \= (tag) \=> {
+    setTags((existingTags) \=>
+      existingTags.filter((existingTag) \=> existingTag !== tag),
+    );
+  };
+  return (
+    <IressInline gap\="sm" verticalAlign\="middle"\>
+      {tags.map((tag) \=> (
+        <IressTag
+          {...args}
+          key\={tag}
+          deleteButtonText\={args.deleteButtonText ?? \`Delete ${tag}\`}
+          onDelete\={handleDelete}
+        \>
+          {tag}
+        </IressTag\>
+      ))}
+      <IressButton onClick\={handleAdd}\>
+        <IressIcon name\="plus" />
+      </IressButton\>
+    </IressInline\>
+  );
+};
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| children | 
+Contents of the tag.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| deleteButton | 
+
+You can completely replace the delete button to provide your own functionality. When this is provided, `deleteButtonText` will not be used and `onDelete` and `onDeleteButtonBlur` will not be called.
+
+ReactNode
+
+
+
+ | \- | Set object |
+| deleteButtonText | 
+
+Screen reader text for delete button
+
+string
+
+
+
+ | 
+
+'Delete'
+
+ | Set string |
+| onDelete | 
+
+Callback triggered when the tag is deleted
+
+(children: string, e: SyntheticEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+| onDeleteButtonBlur | 
+
+Callback triggered when the close button is blurred
+
+(e: FocusEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+
+### Custom button
+
+You can completely override the delete button by passing a custom component to the `deleteButton` prop.
+
+[](./iframe.html?id=components-tag--custom-button)
+
+Tag
+
+Some actions go in here
+
+```
+
+<IressTag deleteButton\={<IressPopover activator\={<IressButton mode\="tertiary"\><IressIcon name\="chevron-circle-down" screenreaderText\="Actions"/></IressButton\>} align\="bottom-start"\><IressPanel\>Some actions go in here</IressPanel\></IressPopover\>}\>
+  Tag
+</IressTag\>
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| children | 
+Contents of the tag.
+
+ReactNode
+
+
+
+ | \- | 
+
+"Tag"
+
+ |
+| deleteButton | 
+
+You can completely replace the delete button to provide your own functionality. When this is provided, `deleteButtonText` will not be used and `onDelete` and `onDeleteButtonBlur` will not be called.
+
+ReactNode
+
+
+
+ | \- | 
+
+RAW
+
+deleteButton :
+
+{
+
+*   $$typeof : Symbol(react.transitional.element)
+*   type :
+    
+    {...} 3 keys
+    
+*   key : null
+*   props :
+    
+    {...} 3 keys
+    
+*   \_owner : null
+*   \_store :
+    
+    {...} 0 keys
+    
+
+}
+
+
+
+
+
+
+
+ |
+| deleteButtonText | 
+
+Screen reader text for delete button
+
+string
+
+
+
+ | 
+
+'Delete'
+
+ | Set string |
+| onDelete | 
+
+Callback triggered when the tag is deleted
+
+(children: string, e: SyntheticEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+| onDeleteButtonBlur | 
+
+Callback triggered when the close button is blurred
+
+(e: FocusEvent<HTMLButtonElement>) => void
+
+ | \- | \- |
+
+IressTagInput
+-------------
+
+`IressTagInput` allows you to manage multiple tags, and is often used for managing email addresses, domains or other simple metadata that does not have to be selected from a list.
+
+If you need to manage tags that are selected from a existing list, use `IressRichSelect` with the `multiple` prop.
+
+[](./iframe.html?id=components-tag-taginput--tag-input)
+
+Tag
+
+```
+
+<IressTagInput
+  defaultValue\={\[
+    'Tag'
+  \]}
+  placeholder\="Type and hit enter to add a tag"
+  tagLimit\={999}
+/>
+
+```
+
+#### Props
+
+| Name | Description | Default | Control |
+| --- | --- | --- | --- |
+| defaultValue | 
+Tags to display (uncontrolled)
+
+string\[\]
+
+ | \- | 
+
+RAW
+
+*   defaultValue :
+    
+    \[
+    
+    *   0 : "Tag"
+    
+    \]
+    
+
+
+
+ |
+| onChange | 
+
+Emitted when the value changes.
+
+(e?: SyntheticEvent<InputBaseElement>, value?: string\[\]) => void
+
+ | \- | \- |
+| onExistingTag | 
+
+Emitted when the user attempts to add a tag that already exists.
+
+(tag: string) => void
+
+ | \- | \- |
+| onTagDelete | 
+
+Emitted when a tag is deleted
+
+IressTagProps\['onDelete'\]
+
+ | \- | Set object |
+| onTagDeleteAll | 
+
+Emitted when the combined tag delete button is clicked
+
+IressTagProps\['onDelete'\]
+
+ | \- | Set object |
+| onTagDeleteButtonBlur | 
+
+Emitted when a tag's delete button is blurred
+
+IressTagProps\['onDeleteButtonBlur'\]
+
+ | \- | Set object |
+| placeholder | 
+
+string
+
+
+
+ | \- | Type and hit enter to add a tag |
+| selectedOptionsTagText | 
+
+Text displayed next to tag count in tag when tag limit is exceeded
+
+string
+
+
+
+ | 
+
+'selected'
+
+ | Set string |
+| tagLimit | 
+
+Limit of tags to display before shortening to `selectedOptionsTagText`
+
+number
+
+
+
+ | 
+
+5
+
+ |  |
+| value | 
+
+Tags to display (controlled)
+
+string\[\]
+
+ | \- | Set object |
+| width | 
+
+ | 
+
+'100perc'
+
+ | Set object |