The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
Document remaining Twenty UI primitives (#26649)
Raphaël Bosi54077764c91e
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.jsonindex f0c3da818af..c36c91a625d 100644--- a/packages/twenty-docs/docs.json+++ b/packages/twenty-docs/docs.json@@ -515,13 +515,30 @@"group": "Primitives","pages": ["ui/primitives/overview",+ {+ "group": "Accessibility",+ "pages": [+ "ui/primitives/accessibility/visibility-hidden"+ ]+ },{"group": "Data display","pages": ["ui/primitives/data-display/avatar","ui/primitives/data-display/chip","ui/primitives/data-display/tag",- "ui/primitives/data-display/status"+ "ui/primitives/data-display/status",+ "ui/primitives/data-display/color-sample",+ "ui/primitives/data-display/pill"+ ]+ },+ {+ "group": "Feedback",+ "pages": [+ "ui/primitives/feedback/banner",+ "ui/primitives/feedback/circular-progress-bar",+ "ui/primitives/feedback/loader",+ "ui/primitives/feedback/progress-bar"]},{@@ -538,14 +555,25 @@"ui/primitives/input/radio-group","ui/primitives/input/select","ui/primitives/input/slider",- "ui/primitives/input/switch"+ "ui/primitives/input/switch",+ "ui/primitives/input/segmented-control"+ ]+ },+ {+ "group": "Layout",+ "pages": [+ "ui/primitives/layout/animated-expandable-container",+ "ui/primitives/layout/horizontal-separator",+ "ui/primitives/layout/resize-handle",+ "ui/primitives/layout/text-direction-provider"]},{"group": "Navigation","pages": ["ui/primitives/navigation/list-item",- "ui/primitives/navigation/tabs"+ "ui/primitives/navigation/tabs",+ "ui/primitives/navigation/click-to-action-link"]},{@@ -563,7 +591,8 @@"group": "Typography","pages": ["ui/primitives/typography/heading",- "ui/primitives/typography/text"+ "ui/primitives/typography/text",+ "ui/primitives/typography/overflowing-text-with-tooltip"]}]diff --git a/packages/twenty-docs/navigation/base-structure.json b/packages/twenty-docs/navigation/base-structure.jsonindex ce80647509b..5c405bcf939 100644--- a/packages/twenty-docs/navigation/base-structure.json+++ b/packages/twenty-docs/navigation/base-structure.json@@ -524,6 +524,11 @@"label": "Primitives","pages": ["ui/primitives/overview",+ {+ "key": "uiAccessibility",+ "label": "Accessibility",+ "pages": ["ui/primitives/accessibility/visibility-hidden"]+ },{"key": "uiDataDisplay","label": "Data display",@@ -531,7 +536,19 @@"ui/primitives/data-display/avatar","ui/primitives/data-display/chip","ui/primitives/data-display/tag",- "ui/primitives/data-display/status"+ "ui/primitives/data-display/status",+ "ui/primitives/data-display/color-sample",+ "ui/primitives/data-display/pill"+ ]+ },+ {+ "key": "uiFeedback",+ "label": "Feedback",+ "pages": [+ "ui/primitives/feedback/banner",+ "ui/primitives/feedback/circular-progress-bar",+ "ui/primitives/feedback/loader",+ "ui/primitives/feedback/progress-bar"]},{@@ -549,7 +566,18 @@"ui/primitives/input/radio-group","ui/primitives/input/select","ui/primitives/input/slider",- "ui/primitives/input/switch"+ "ui/primitives/input/switch",+ "ui/primitives/input/segmented-control"+ ]+ },+ {+ "key": "uiLayout",+ "label": "Layout",+ "pages": [+ "ui/primitives/layout/animated-expandable-container",+ "ui/primitives/layout/horizontal-separator",+ "ui/primitives/layout/resize-handle",+ "ui/primitives/layout/text-direction-provider"]},{@@ -557,7 +585,8 @@"label": "Navigation","pages": ["ui/primitives/navigation/list-item",- "ui/primitives/navigation/tabs"+ "ui/primitives/navigation/tabs",+ "ui/primitives/navigation/click-to-action-link"]},{@@ -577,7 +606,8 @@"label": "Typography","pages": ["ui/primitives/typography/heading",- "ui/primitives/typography/text"+ "ui/primitives/typography/text",+ "ui/primitives/typography/overflowing-text-with-tooltip"]}]diff --git a/packages/twenty-docs/navigation/navigation.template.json b/packages/twenty-docs/navigation/navigation.template.jsonindex cc64f147b0b..4c3b085b0e3 100644--- a/packages/twenty-docs/navigation/navigation.template.json+++ b/packages/twenty-docs/navigation/navigation.template.json@@ -206,12 +206,21 @@"uiPrimitives": {"label": "Primitives","groups": {+ "uiAccessibility": {+ "label": "Accessibility"+ },"uiDataDisplay": {"label": "Data display"},+ "uiFeedback": {+ "label": "Feedback"+ },"uiForms": {"label": "Forms"},+ "uiLayout": {+ "label": "Layout"+ },"uiNavigation": {"label": "Navigation"},diff --git a/packages/twenty-docs/snippets/ui/generated/accessibility/visibility-hidden.mdx b/packages/twenty-docs/snippets/ui/generated/accessibility/visibility-hidden.mdxnew file mode 100644index 00000000000..f8948970b0d--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/accessibility/visibility-hidden.mdx@@ -0,0 +1,16 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="children" type="ReactNode" required>+ Content hidden visually while remaining available to assistive technology.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/data-display/color-sample.mdx b/packages/twenty-docs/snippets/ui/generated/data-display/color-sample.mdxnew file mode 100644index 00000000000..0e82b28a33a--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/data-display/color-sample.mdx@@ -0,0 +1,28 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="className" type="string">+ CSS class applied to the swatch.+</ParamField>++<ParamField body="color" type="string">+ CSS color that overrides the background; the border still uses `colorName`.+</ParamField>++<ParamField body="colorName" type=""amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "turquoise" | "violet" | "yellow"" required>+ Theme color used for the background and border. Required even when `color` overrides the background.+</ParamField>++<ParamField body="variant" type=""circle" | "default" | "pipeline"">+ Swatch shape: `default`, `circle`, or `pipeline`. Omitting it uses the default shape.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/data-display/pill.mdx b/packages/twenty-docs/snippets/ui/generated/data-display/pill.mdxnew file mode 100644index 00000000000..df6fbfb2536--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/data-display/pill.mdx@@ -0,0 +1,24 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="className" type="string">+ CSS class applied to the pill.+</ParamField>++<ParamField body="Icon" type="IconComponent">+ Icon component rendered before the label at 12px. Import icons from `twenty-ui/icon`.+</ParamField>++<ParamField body="label" type="string">+ Short text displayed inside the pill.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/feedback/banner.mdx b/packages/twenty-docs/snippets/ui/generated/feedback/banner.mdxnew file mode 100644index 00000000000..d013cdf015b--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/feedback/banner.mdx@@ -0,0 +1,28 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="children" type="ReactNode" required>+ Message and optional actions displayed inside the banner.+</ParamField>++<ParamField body="className" type="string">+ CSS class applied to the banner.+</ParamField>++<ParamField body="color" type=""blue" | "danger"" default="blue">+ Blue information treatment or danger treatment.+</ParamField>++<ParamField body="variant" type=""primary" | "secondary"" default="primary">+ Primary solid treatment or secondary translucent treatment.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/feedback/circular-progress-bar.mdx b/packages/twenty-docs/snippets/ui/generated/feedback/circular-progress-bar.mdxnew file mode 100644index 00000000000..e8cec74a34a--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/feedback/circular-progress-bar.mdx@@ -0,0 +1,24 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="barColor" type="string" default="currentColor">+ CSS stroke color. Defaults to the inherited text color.+</ParamField>++<ParamField body="barWidth" type="number" default="5">+ Stroke width in pixels. Keep it smaller than half of `size`.+</ParamField>++<ParamField body="size" type="number" default="50">+ Width and height of the spinner in pixels.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/feedback/loader.mdx b/packages/twenty-docs/snippets/ui/generated/feedback/loader.mdxnew file mode 100644index 00000000000..e593c7f76b5--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/feedback/loader.mdx@@ -0,0 +1,16 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="color" type=""amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "turquoise" | "violet" | "yellow"">+ Theme color for the animated dot and border. When omitted, inherits the button color if available, otherwise the tertiary text color.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/feedback/progress-bar.mdx b/packages/twenty-docs/snippets/ui/generated/feedback/progress-bar.mdxnew file mode 100644index 00000000000..ea1f52a6286--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/feedback/progress-bar.mdx@@ -0,0 +1,48 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="ariaLabel" type="string">+ Accessible name describing the operation being measured.+</ParamField>++<ParamField body="backgroundColor" type="string" default="none">+ CSS background color of the track.+</ParamField>++<ParamField body="barColor" type="string">+ CSS color of the filled bar. Defaults to the primary text color.+</ParamField>++<ParamField body="className" type="string">+ CSS class applied to the progress root.+</ParamField>++<ParamField body="countdownDurationInMs" type="number">+ Starts a visual animation from full to empty over this duration in milliseconds. Does not update `value`.+</ParamField>++<ParamField body="isCountdownPaused" type="boolean" default="false">+ Pauses the countdown animation without resetting its position.+</ParamField>++<ParamField body="onCountdownComplete" type="(() => void)">+ Called when the countdown animation ends.+</ParamField>++<ParamField body="value" type="number" required>+ Current progress from 0 to 100. Also supplies the accessible value during a countdown.+</ParamField>++<ParamField body="withBorderRadius" type="boolean" default="false">+ Rounds the track and indicator corners.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/input/segmented-control.mdx b/packages/twenty-docs/snippets/ui/generated/input/segmented-control.mdxnew file mode 100644index 00000000000..8e2613a3c95--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/input/segmented-control.mdx@@ -0,0 +1,86 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="aria-label" type="string" required>+ Accessible group name. Supply this or `aria-labelledby`.+</ParamField>++<ParamField body="aria-labelledby" type="string" required>+ ID of an element that labels the group. Supply this or `aria-label`.+</ParamField>++<ParamField body="className" type="string | ((state: RadioGroupState) => string | undefined)">+ CSS class applied to the element, or a function that+ returns a class based on the component's state.+</ParamField>++<ParamField body="defaultValue" type="string">+ The uncontrolled value of the radio button that should be initially selected.++ To render a controlled radio group, use the `value` prop instead.+</ParamField>++<ParamField body="disabled" type="boolean" default="false">+ Whether the component should ignore user interaction.+</ParamField>++<ParamField body="form" type="string">+ Identifies the form that owns the radio inputs.+ Useful when the radio group is rendered outside the form.+</ParamField>++<ParamField body="inputRef" type="Ref<HTMLInputElement>">+ A ref to access the hidden input element.+</ParamField>++<ParamField body="itemWidth" type=""content" | "equal"" default="equal">+ Use equal-width options or size each option to its content.+</ParamField>++<ParamField body="name" type="string">+ Identifies the field when a form is submitted.+</ParamField>++<ParamField body="onValueChange" type="((value: TValue, eventDetails: { reason: "none"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)">+ Callback fired when the value changes.+</ParamField>++<ParamField body="options" type="readonly SegmentedControlOption<TValue>[]" required>+ Options with a unique string `value`, a `label` or `startIcon`, and optional `disabled`. Icon-only options require an `aria-label`.+</ParamField>++<ParamField body="readOnly" type="boolean" default="false">+ Whether the user should be unable to select a different radio button in the group.+</ParamField>++<ParamField body="render" type="ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, RadioGroupState>">+ Allows you to replace the component's HTML element+ with a different tag, or compose it with another component.++ Accepts a `ReactElement` or a function that returns the element to render.+</ParamField>++<ParamField body="required" type="boolean" default="false">+ Whether the user must choose a value before submitting a form.+</ParamField>++<ParamField body="style" type="CSSProperties | ((state: RadioGroupState) => CSSProperties | undefined)">+ Style applied to the element, or a function that+ returns a style object based on the component's state.+</ParamField>++<ParamField body="value" type="string">+ The controlled value of the radio item that should be currently selected.++ To render an uncontrolled radio group, use the `defaultValue` prop instead.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/layout/animated-expandable-container.mdx b/packages/twenty-docs/snippets/ui/generated/layout/animated-expandable-container.mdxnew file mode 100644index 00000000000..540a7b569c8--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/layout/animated-expandable-container.mdx@@ -0,0 +1,44 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="animationDurations" type="AnimationDurations" default="default">+ Default theme timing or separate opacity and size durations in seconds.+</ParamField>++<ParamField body="children" type="ReactNode" required>+ Content inside the expanding panel.+</ParamField>++<ParamField body="containAnimation" type="boolean" default="true">+ Clips overflowing content during expansion and uses a column layout.+</ParamField>++<ParamField body="dimension" type=""height" | "width"" default="height">+ Dimension animated when the panel opens and closes.+</ParamField>++<ParamField body="duration" type=""fast" | "instant" | "normal" | "slow"">+ Theme timing preset for both opacity and size. Explicit `animationDurations` take precedence.+</ParamField>++<ParamField body="initial" type="boolean">+ Compatibility prop accepted by the type but not used by the current implementation.+</ParamField>++<ParamField body="isExpanded" type="boolean" required>+ Controlled visibility of the panel. The application owns the trigger and state.+</ParamField>++<ParamField body="mode" type=""fit-content" | "scroll-height"">+ Compatibility prop accepted by the type but not used by the current implementation.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/layout/horizontal-separator.mdx b/packages/twenty-docs/snippets/ui/generated/layout/horizontal-separator.mdxnew file mode 100644index 00000000000..c9f4b806c1d--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/layout/horizontal-separator.mdx@@ -0,0 +1,28 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="color" type="string">+ CSS line color. Defaults to the medium border color.+</ParamField>++<ParamField body="noMargin" type="boolean" default="false">+ Removes the vertical margins.+</ParamField>++<ParamField body="text" type="string" default="">+ Optional label displayed between two lines.+</ParamField>++<ParamField body="visible" type="boolean" default="true">+ Shows the dividing line. Setting it to false preserves margins and any text.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/layout/resize-handle.mdx b/packages/twenty-docs/snippets/ui/generated/layout/resize-handle.mdxnew file mode 100644index 00000000000..9b55c26dbf2--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/layout/resize-handle.mdx@@ -0,0 +1,51 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="axis" type=""x" | "y"" default="y">+ Pointer movement axis: `y` for height or `x` for width.+</ParamField>++<ParamField body="defaultValue" type="number | (readonly string[] & number)" default="150">+ Initial size when the handle owns its state.+</ParamField>++<ParamField body="disabled" type="boolean" default="false">+ Disables resizing and removes the handle from the tab order.+</ParamField>++<ParamField body="max" type="number" default="500">+ Maximum allowed size.+</ParamField>++<ParamField body="min" type="number" default="50">+ Minimum allowed size.+</ParamField>++<ParamField body="onValueChange" type="((value: number) => void)">+ Called with the bounded size after pointer or keyboard interaction.+</ParamField>++<ParamField body="render" type="ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>">+ Allows you to replace the component's HTML element+ with a different tag, or compose it with another component.++ Accepts a `ReactElement` or a function that returns the element to render.+</ParamField>++<ParamField body="step" type="number" default="10">+ Keyboard arrow increment. Pointer movement uses the pixel delta.+</ParamField>++<ParamField body="value" type="number">+ Controlled size. Apply the value to the element being resized.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/layout/text-direction-provider.mdx b/packages/twenty-docs/snippets/ui/generated/layout/text-direction-provider.mdxnew file mode 100644index 00000000000..a684e2dd295--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/layout/text-direction-provider.mdx@@ -0,0 +1,20 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="children" type="ReactNode" required>+ Controls that receive the direction context.+</ParamField>++<ParamField body="direction" type=""ltr" | "rtl"" required>+ Reading direction used by directional interactions. Also set the matching HTML `dir` attribute on the content.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/navigation/click-to-action-link.mdx b/packages/twenty-docs/snippets/ui/generated/navigation/click-to-action-link.mdxnew file mode 100644index 00000000000..d1366d066b9--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/navigation/click-to-action-link.mdx@@ -0,0 +1,36 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="children" type="ReactNode">+ Visible link text or content. Use a descriptive destination label.+</ParamField>++<ParamField body="className" type="string">+ CSS class applied to the anchor.+</ParamField>++<ParamField body="href" type="string">+ Destination URL for native link navigation.+</ParamField>++<ParamField body="onClick" type="MouseEventHandler<HTMLAnchorElement>">+ Click handler called when the link is activated.+</ParamField>++<ParamField body="rel" type="string">+ Relationship to the destination, such as `noopener noreferrer` for a new tab.+</ParamField>++<ParamField body="target" type="HTMLAttributeAnchorTarget">+ Browsing context in which to open the destination.+</ParamField>diff --git a/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-with-tooltip.mdx b/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-with-tooltip.mdxnew file mode 100644index 00000000000..0f4497e24bd--- /dev/null+++ b/packages/twenty-docs/snippets/ui/generated/typography/overflowing-text-with-tooltip.mdx@@ -0,0 +1,48 @@+{/*+ * _____ _+ *|_ _|_ _____ _ __ | |_ _ _+ * | | \ \ /\ / / _ \ '_ \| __| | | | Auto-generated file+ * | | \ V V / __/ | | | |_| |_| | DO NOT EDIT - changes will be overwritten+ * |_| \_/\_/ \___|_| |_|\__|\__, | Generated by: npx nx generate:ui twenty-docs+ * |___/+ *+ * This file is generated from the documentation data in packages/twenty-ui/generated.+ * To update it, edit the component prop types or design tokens in twenty-ui and run:+ * npx nx generate:ui twenty-docs+ */}++<ParamField body="alwaysShowTooltip" type="boolean">+ Allows the tooltip even when the text is not truncated.+</ParamField>++<ParamField body="displayedMaxRows" type="number">+ Maximum displayed rows. Omit for single-line truncation; use a positive integer for multiline text.+</ParamField>++<ParamField body="isFocusable" type="boolean">+ Adds a tab stop and opens the tooltip on focus or click.+</ParamField>++<ParamField body="isTooltipMultiline" type="boolean">+ Preserves whitespace and line breaks in the tooltip.+</ParamField>++<ParamField body="size" type=""large" | "small"">+ Small inherited text sizing or the large fixed-height treatment.+</ParamField>++<ParamField body="text" type="string | number | bigint | boolean | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | Promise<...> | null | undefined" required>+ Text or React content to truncate. Non-string React content requires `tooltipContent`.+</ParamField>++<ParamField body="tooltipContent" type="string">+ Plain text displayed in the tooltip. Defaults to `text` when it is a nonempty string.+</ParamField>++<ParamField body="tooltipDelay" type="number">+ Hover delay in milliseconds.+</ParamField>++<ParamField body="tooltipPlace" type=""bottom" | "left" | "right" | "top"">+ Preferred side of the tooltip.+</ParamField>diff --git a/packages/twenty-docs/ui/accessibility.mdx b/packages/twenty-docs/ui/accessibility.mdxindex b2ac9d06502..b24bdf6421a 100644--- a/packages/twenty-docs/ui/accessibility.mdx+++ b/packages/twenty-docs/ui/accessibility.mdx@@ -24,6 +24,8 @@ export const EmailField = () => ();```+Use [VisibilityHidden](/ui/primitives/accessibility/visibility-hidden) when supporting text should remain available to assistive technology without being displayed.+Placeholders supplement labels; they do not replace them. For a control without visible text, supply an accessible name using `aria-label` or `aria-labelledby`.## Preserve native behaviordiff --git a/packages/twenty-docs/ui/primitives/accessibility/visibility-hidden.mdx b/packages/twenty-docs/ui/primitives/accessibility/visibility-hidden.mdxnew file mode 100644index 00000000000..6b8dac164e9--- /dev/null+++ b/packages/twenty-docs/ui/primitives/accessibility/visibility-hidden.mdx@@ -0,0 +1,37 @@+---+title: VisibilityHidden+description: Keep supporting text available to assistive technology without displaying it visually.+---++import VisibilityHiddenReference from '/snippets/ui/generated/accessibility/visibility-hidden.mdx';++`VisibilityHidden` renders a visually hidden `span`. Its content stays in the accessibility tree and can supply an accessible name. It has no state and accepts only `children`.++## Usage++```tsx+import { Button } from 'twenty-ui/primitives/input';+import { VisibilityHidden } from 'twenty-ui/primitives/accessibility';+import { IconPlus } from 'twenty-ui/icon';++type AddRecordActionProps = { onAdd: () => void };++export const AddRecordAction = ({ onAdd }: AddRecordActionProps) => (+ <Button onClick={onAdd}>+ <IconPlus aria-hidden />+ <VisibilityHidden>Add record</VisibilityHidden>+ </Button>+);+```++Use a visible label when space permits. For controls that already accept `aria-label`, that attribute is another way to supply an accessible name.++## Hidden content++Place supporting text inside the wrapper. Avoid placing focusable controls inside it: the wrapper stays visually hidden when its children receive focus. It does not add a live region, remove content from assistive technology, or hide confidential data.++The component does not forward `id`, `className`, or other native attributes. See [accessibility](/ui/accessibility) for labeling and announcement patterns.++## Props++<VisibilityHiddenReference />diff --git a/packages/twenty-docs/ui/primitives/data-display/color-sample.mdx b/packages/twenty-docs/ui/primitives/data-display/color-sample.mdxnew file mode 100644index 00000000000..e6d53f9011a--- /dev/null+++ b/packages/twenty-docs/ui/primitives/data-display/color-sample.mdx@@ -0,0 +1,51 @@+---+title: ColorSample+description: Display a theme color or a custom color alongside a text label.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import ColorSampleReference from '/snippets/ui/generated/data-display/color-sample.mdx';++`ColorSample` is a non-interactive color swatch. Use it next to a label so the meaning does not depend on color alone. Selection belongs to the surrounding control.++<StoryEmbed+ storyId="ui-data-display-colorsample--default"+ title="ColorSample example"+/>++## Usage++```tsx+import { ColorSample } from 'twenty-ui/primitives/data-display';+import { Text } from 'twenty-ui/primitives/typography';++export const PriorityColor = () => (+ <Text style={{ display: 'flex', alignItems: 'center', gap: 8 }}>+ <ColorSample colorName="red" variant="circle" />+ High priority+ </Text>+);+```++`colorName` selects a theme palette entry for the fill and border. `variant` accepts `default`, `circle`, or `pipeline`. Omitting it uses the default shape.++## Custom colors++```tsx+import { ColorSample } from 'twenty-ui/primitives/data-display';+import { Text } from 'twenty-ui/primitives/typography';++export const BrandColor = () => (+ <Text style={{ display: 'flex', alignItems: 'center', gap: 8 }}>+ <ColorSample colorName="blue" color="#2563eb" />+ Brand blue+ </Text>+);+```++A custom `color` overrides the fill; `colorName` remains required and still determines the border color. `className` styles the swatch. Other native attributes and click handlers are not forwarded. To offer selectable colors, compose the swatch inside a labeled [ListItem](/ui/primitives/navigation/list-item).++## Props++<ColorSampleReference />diff --git a/packages/twenty-docs/ui/primitives/data-display/pill.mdx b/packages/twenty-docs/ui/primitives/data-display/pill.mdxnew file mode 100644index 00000000000..f1765faeb7e--- /dev/null+++ b/packages/twenty-docs/ui/primitives/data-display/pill.mdx@@ -0,0 +1,37 @@+---+title: Pill+description: Show a compact neutral label with an optional icon.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import PillReference from '/snippets/ui/generated/data-display/pill.mdx';++`Pill` displays a short, non-interactive label. Use [Tag](/ui/primitives/data-display/tag) for colored categories or [Status](/ui/primitives/data-display/status) for a named state with an indicator.++<StoryEmbed storyId="ui-data-display-pill--default" title="Pill example" />++## Usage++```tsx+import { Pill } from 'twenty-ui/primitives/data-display';++export const PreviewLabel = () => <Pill label="Preview" />;+```++## With an icon++```tsx+import { Pill } from 'twenty-ui/primitives/data-display';+import { IconPaperclip } from 'twenty-ui/icon';++export const AttachmentLabel = () => (+ <Pill label="Attachment" Icon={IconPaperclip} />+);+```++Pass the icon component to `Icon`, rather than a rendered element. Keep a visible label to explain its meaning. The component accepts `label`, `Icon`, and `className`; it does not forward click handlers, children, or native accessibility attributes. Put actions on a separate [Button](/ui/primitives/input/button).++## Props++<PillReference />diff --git a/packages/twenty-docs/ui/primitives/feedback/banner.mdx b/packages/twenty-docs/ui/primitives/feedback/banner.mdxnew file mode 100644index 00000000000..1e3b6651262--- /dev/null+++ b/packages/twenty-docs/ui/primitives/feedback/banner.mdx@@ -0,0 +1,51 @@+---+title: Banner+description: Display a prominent information or error message with optional actions.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import BannerReference from '/snippets/ui/generated/feedback/banner.mdx';++`Banner` lays out a message and optional controls across its container. Use `color="blue"` for information and `color="danger"` for errors. The `primary` variant uses a solid background; `secondary` uses a translucent background.++<StoryEmbed storyId="ui-feedback-banner--default" title="Banner example" />++## Usage++```tsx+import { Banner } from 'twenty-ui/primitives/feedback';+import { Button } from 'twenty-ui/primitives/input';+import { Text } from 'twenty-ui/primitives/typography';++type ImportFailureProps = { onRetry: () => void };++export const ImportFailure = ({ onRetry }: ImportFailureProps) => (+ <Banner color="danger" variant="secondary">+ <Text>Some records could not be imported.</Text>+ <Button onClick={onRetry}>Retry import</Button>+ </Banner>+);+```++## Visibility and announcements++The application owns the message, action handlers, and whether the banner is rendered. `Banner` has no open state or built-in close button.++```tsx+import { Banner } from 'twenty-ui/primitives/feedback';++type ImportNoticeProps = { message: string | null };++export const ImportNotice = ({ message }: ImportNoticeProps) => (+ <div role="status">+ {message !== null && <Banner variant="secondary">{message}</Banner>}+ </div>+);+```++Keep the live-region wrapper mounted before updating its message. Use `role="alert"` only for urgent messages that need immediate attention. The banner itself does not add a live region or forward `role` and other native attributes.++## Props++<BannerReference />diff --git a/packages/twenty-docs/ui/primitives/feedback/circular-progress-bar.mdx b/packages/twenty-docs/ui/primitives/feedback/circular-progress-bar.mdxnew file mode 100644index 00000000000..a5806c73d0b--- /dev/null+++ b/packages/twenty-docs/ui/primitives/feedback/circular-progress-bar.mdx@@ -0,0 +1,41 @@+---+title: CircularProgressBar+description: Show an animated circular indicator while progress is unknown.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import CircularProgressBarReference from '/snippets/ui/generated/feedback/circular-progress-bar.mdx';++`CircularProgressBar` is an indeterminate loading spinner. It animates continuously while mounted and does not accept a progress value. Use [ProgressBar](/ui/primitives/feedback/progress-bar) when you can report a percentage.++<StoryEmbed+ storyId="ui-feedback-circularprogressbar-circularprogressbar--default"+ title="CircularProgressBar example"+/>++## Usage++```tsx+import { CircularProgressBar } from 'twenty-ui/primitives/feedback';+import { Text } from 'twenty-ui/primitives/typography';++export const ImportLoading = () => (+ <div role="status">+ <span aria-hidden="true">+ <CircularProgressBar size={24} barWidth={2} />+ </span>+ <Text>Importing records</Text>+ </div>+);+```++The application controls loading by mounting or removing the indicator. Keep an explanatory label beside it. The SVG does not supply an accessible name or live region and does not forward native attributes; apply those to a wrapper.++## Appearance++`size` sets the width and height in pixels and defaults to `50`. `barWidth` defaults to `5`; keep it smaller than half the size. `barColor` accepts a CSS color and defaults to `currentColor`, so it inherits the surrounding text color. Theme variables work as color values, for example `var(--t-font-color-secondary)`.++## Props++<CircularProgressBarReference />diff --git a/packages/twenty-docs/ui/primitives/feedback/loader.mdx b/packages/twenty-docs/ui/primitives/feedback/loader.mdxnew file mode 100644index 00000000000..be300e74d23--- /dev/null+++ b/packages/twenty-docs/ui/primitives/feedback/loader.mdx@@ -0,0 +1,42 @@+---+title: Loader+description: Display a compact animated loading indicator beside a status label.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import LoaderReference from '/snippets/ui/generated/feedback/loader.mdx';++`Loader` shows an animated dot inside a small bordered capsule. Use it while an operation is in progress and the percentage is unknown. For numeric progress, use [ProgressBar](/ui/primitives/feedback/progress-bar).++<StoryEmbed storyId="ui-feedback-loader--with-color" title="Loader example" />++## Usage++```tsx+import { Loader } from 'twenty-ui/primitives/feedback';+import { Text } from 'twenty-ui/primitives/typography';++type SaveFeedbackProps = { isSaving: boolean };++export const SaveFeedback = ({ isSaving }: SaveFeedbackProps) => (+ <div role="status">+ {isSaving && (+ <div aria-hidden="true">+ <Loader color="blue" />+ </div>+ )}+ <Text>{isSaving ? 'Saving changes' : 'Changes saved'}</Text>+ </div>+);+```++The application owns loading state. Keep the status wrapper mounted so text updates can be announced. The loader itself supplies no label or live region and accepts only `color`.++## Color++Pass a theme palette color to set both the border and dot. Without a color, the loader inherits a surrounding button color when available, otherwise it uses the tertiary text color. For a button action, prefer [Button's loading state](/ui/primitives/input/button#state-ownership), which keeps the feedback inside the control.++## Props++<LoaderReference />diff --git a/packages/twenty-docs/ui/primitives/feedback/progress-bar.mdx b/packages/twenty-docs/ui/primitives/feedback/progress-bar.mdxnew file mode 100644index 00000000000..9e8b2216bde--- /dev/null+++ b/packages/twenty-docs/ui/primitives/feedback/progress-bar.mdx@@ -0,0 +1,89 @@+---+title: ProgressBar+description: Show measured progress or a visual countdown with a horizontal bar.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import ProgressBarReference from '/snippets/ui/generated/feedback/progress-bar.mdx';++`ProgressBar` displays a value from 0 to 100 and exposes progressbar semantics. Give it an `ariaLabel` that identifies the operation, and show a text status when users need the numeric value.++<StoryEmbed+ storyId="ui-feedback-progressbar-progressbar--default"+ title="ProgressBar example"+/>++## Usage++```tsx+import { ProgressBar } from 'twenty-ui/primitives/feedback';+import { Text } from 'twenty-ui/primitives/typography';++type ImportProgressProps = { percentage: number };++export const ImportProgress = ({ percentage }: ImportProgressProps) => (+ <>+ <Text>Importing records: {percentage}%</Text>+ <ProgressBar+ value={percentage}+ ariaLabel="Importing records"+ withBorderRadius+ />+ </>+);+```++## State ownership++`value` is required and controlled by the application. There is no `defaultValue` mode. The component does not start a request or advance numeric progress by itself. Use [Loader](/ui/primitives/feedback/loader) or [CircularProgressBar](/ui/primitives/feedback/circular-progress-bar) when progress is unknown.++## Countdown++```tsx+import { useState } from 'react';+import { ProgressBar } from 'twenty-ui/primitives/feedback';+import { Button } from 'twenty-ui/primitives/input';+import { Text } from 'twenty-ui/primitives/typography';++export const PreviewCountdown = () => {+ const [isPaused, setIsPaused] = useState(false);+ const [isComplete, setIsComplete] = useState(false);++ return (+ <>+ <Text role="status">+ {isComplete ? 'Preview ended' : 'Preview available'}+ </Text>+ {!isComplete && (+ <>+ <div aria-hidden="true">+ <ProgressBar+ value={100}+ ariaLabel="Preview countdown"+ countdownDurationInMs={10000}+ isCountdownPaused={isPaused}+ onCountdownComplete={() => setIsComplete(true)}+ />+ </div>+ <Button onClick={() => setIsPaused((paused) => !paused)}>+ {isPaused ? 'Resume countdown' : 'Pause countdown'}+ </Button>+ </>+ )}+ </>+ );+};+```++`countdownDurationInMs` animates the bar from full to empty. Pausing preserves the current animation position. Completion calls `onCountdownComplete`; mount a fresh instance to restart the animation.++The animation does not change `value` or its accessible numeric value. This example hides the decorative bar from assistive technology and announces completion separately. If remaining time matters, track and display it in application state. Use application timing for deadlines, since the callback follows a visual animation.++## Appearance++`barColor` and `backgroundColor` accept CSS colors, including theme variables. `withBorderRadius` rounds the track and indicator. `className` styles the root; other native attributes are not forwarded.++## Props++<ProgressBarReference />diff --git a/packages/twenty-docs/ui/primitives/input/segmented-control.mdx b/packages/twenty-docs/ui/primitives/input/segmented-control.mdxnew file mode 100644index 00000000000..70dbfbc5b79--- /dev/null+++ b/packages/twenty-docs/ui/primitives/input/segmented-control.mdx@@ -0,0 +1,100 @@+---+title: SegmentedControl+description: Choose one value from a compact group of labeled or icon options.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import SegmentedControlReference from '/snippets/ui/generated/input/segmented-control.mdx';++`SegmentedControl` is a radio group with joined options. Use it for a short, mutually exclusive choice. For navigation between content panels, use [Tabs](/ui/primitives/navigation/tabs).++<StoryEmbed+ storyId="ui-input-segmentedcontrol--default"+ title="SegmentedControl example"+/>++## Usage++Supply an accessible group name with `aria-label` or `aria-labelledby`. Each option needs a unique string `value`. Selection belongs to the group; options do not have independent checked state.++## Uncontrolled state++```tsx+import { SegmentedControl } from 'twenty-ui/primitives/input';++export const BillingPeriod = () => (+ <SegmentedControl+ aria-label="Billing period"+ name="billingPeriod"+ defaultValue="annual"+ options={[+ { label: 'Annual', value: 'annual' },+ { label: 'Monthly', value: 'monthly' },+ ]}+ />+);+```++`defaultValue` initializes selection. The group owns later changes. Add `onValueChange` if you need to observe them without controlling the value.++## Controlled state++```tsx+import { useState } from 'react';+import { SegmentedControl } from 'twenty-ui/primitives/input';++export const BillingPeriod = () => {+ const [period, setPeriod] = useState('annual');++ return (+ <SegmentedControl+ aria-label="Billing period"+ name="billingPeriod"+ value={period}+ onValueChange={setPeriod}+ options={[+ { label: 'Annual', value: 'annual' },+ { label: 'Monthly', value: 'monthly' },+ ]}+ />+ );+};+```++Keep `value` in application state and update it in `onValueChange`. Do not combine `value` and `defaultValue` or switch ownership modes after mounting.++## Icon options++```tsx+import { SegmentedControl } from 'twenty-ui/primitives/input';+import { IconList, IconLayoutKanban } from 'twenty-ui/icon';++export const RecordLayout = () => (+ <SegmentedControl+ aria-label="Record layout"+ defaultValue="list"+ itemWidth="content"+ options={[+ { value: 'list', startIcon: <IconList />, 'aria-label': 'List' },+ {+ value: 'kanban',+ startIcon: <IconLayoutKanban />,+ 'aria-label': 'Kanban',+ },+ ]}+ />+);+```++An icon-only option requires an `aria-label`. `startIcon` is decorative and hidden from assistive technology. Options with visible text use `label` and may also provide `startIcon`. Set `disabled` on an option to prevent its selection, or on the group to disable every option.++## Keyboard, forms, and direction++Tab enters the group; arrow keys move between enabled options and update selection. `itemWidth="equal"` is the default; use `content` when labels should determine widths. Set `name` to include the selected value in native form submission.++For right-to-left content, pair [TextDirectionProvider](/ui/primitives/layout/text-direction-provider) with a matching `dir` attribute. The provider controls directional interaction; `dir` controls the document layout.++## Props++<SegmentedControlReference />diff --git a/packages/twenty-docs/ui/primitives/layout/animated-expandable-container.mdx b/packages/twenty-docs/ui/primitives/layout/animated-expandable-container.mdxnew file mode 100644index 00000000000..6b1a34039c5--- /dev/null+++ b/packages/twenty-docs/ui/primitives/layout/animated-expandable-container.mdx@@ -0,0 +1,67 @@+---+title: AnimatedExpandableContainer+description: Animate a controlled panel as it opens and closes.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import AnimatedExpandableContainerReference from '/snippets/ui/generated/layout/animated-expandable-container.mdx';++`AnimatedExpandableContainer` animates the height or width of its content. The application owns its expanded state and trigger. There is no uncontrolled mode or built-in toggle.++## Anatomy++```text+Application+├── Button (application-supplied trigger)+└── AnimatedExpandableContainer+ └── Content+```++`children` and `isExpanded` are required. The component supplies the collapsible root and animated panel internally. Supply the trigger separately and keep its `aria-expanded` value synchronized with `isExpanded`.++<StoryEmbed+ storyId="ui-layout-animatedexpandablecontainer--default"+ title="AnimatedExpandableContainer example"+/>++## Usage++```tsx+import { useState } from 'react';+import { Button } from 'twenty-ui/primitives/input';+import { AnimatedExpandableContainer } from 'twenty-ui/primitives/layout';+import { Text } from 'twenty-ui/primitives/typography';++export const ImportDetails = () => {+ const [isExpanded, setIsExpanded] = useState(false);++ return (+ <>+ <Button+ aria-expanded={isExpanded}+ onClick={() => setIsExpanded((expanded) => !expanded)}+ >+ {isExpanded ? 'Hide import details' : 'Show import details'}+ </Button>+ <AnimatedExpandableContainer isExpanded={isExpanded}>+ <Text>Match each CSV column to a record field before importing.</Text>+ </AnimatedExpandableContainer>+ </>+ );+};+```++## Animation and content lifetime++The default dimension is `height`. Use `dimension="width"` for horizontal expansion. `containAnimation` defaults to `true`, clips overflow, and lays content out in a column. Turn it off when content needs to overflow during the transition.++Use `duration` for a theme timing preset (`instant`, `fast`, `normal`, or `slow`). `animationDurations={{ opacity: 0.15, size: 0.25 }}` supplies independent durations in seconds and takes precedence over the preset.++The panel unmounts its content after closing. Keep state that must survive closing outside the panel. The component does not forward native attributes or refs to its internal panel; keep focus handling and trigger relationships in the application.++`mode` and `initial` remain in the accepted prop type but currently have no effect.++## Props++<AnimatedExpandableContainerReference />diff --git a/packages/twenty-docs/ui/primitives/layout/horizontal-separator.mdx b/packages/twenty-docs/ui/primitives/layout/horizontal-separator.mdxnew file mode 100644index 00000000000..5c32934553e--- /dev/null+++ b/packages/twenty-docs/ui/primitives/layout/horizontal-separator.mdx@@ -0,0 +1,40 @@+---+title: HorizontalSeparator+description: Separate adjacent content with a line and an optional label.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import HorizontalSeparatorReference from '/snippets/ui/generated/layout/horizontal-separator.mdx';++`HorizontalSeparator` is a visual divider with optional text. It has no interaction or state and does not render native `hr` semantics.++<StoryEmbed+ storyId="ui-layout-horizontalseparator--default"+ title="HorizontalSeparator example"+/>++## Usage++```tsx+import { HorizontalSeparator } from 'twenty-ui/primitives/layout';+import { Text } from 'twenty-ui/primitives/typography';++export const ImportSources = () => (+ <>+ <Text>Import records from a CSV file.</Text>+ <HorizontalSeparator text="or" />+ <Text>Connect an external data source.</Text>+ </>+);+```++## Spacing and visibility++Omit `text` for one continuous line. `noMargin` removes the vertical margins. `visible={false}` hides the line while preserving the margins and any text. A custom `color` changes the line color; the default uses the medium border color.++Use headings to communicate document structure. If a separator must have semantic meaning, place the unlabeled component in a wrapper with `role="separator"`. Native attributes, event handlers, and children are not forwarded.++## Props++<HorizontalSeparatorReference />diff --git a/packages/twenty-docs/ui/primitives/layout/resize-handle.mdx b/packages/twenty-docs/ui/primitives/layout/resize-handle.mdxnew file mode 100644index 00000000000..3296b58839c--- /dev/null+++ b/packages/twenty-docs/ui/primitives/layout/resize-handle.mdx@@ -0,0 +1,99 @@+---+title: ResizeHandle+description: Resize a panel with pointer dragging or keyboard controls.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import ResizeHandleReference from '/snippets/ui/generated/layout/resize-handle.mdx';++`ResizeHandle` manages a numeric size and exposes a focusable separator. The application applies that size to the panel; the handle does not resize another element automatically.++<StoryEmbed+ storyId="ui-layout-resizehandle--resizable"+ title="ResizeHandle example"+/>++## Usage++Use `axis="y"` for height or `axis="x"` for width. Give the handle a specific accessible name and use `aria-controls` to identify the panel.++## Uncontrolled state++```tsx+import { useId, useState } from 'react';+import { ResizeHandle } from 'twenty-ui/primitives/layout';+import { Text } from 'twenty-ui/primitives/typography';++export const ResizableNotes = () => {+ const panelId = useId();+ const [height, setHeight] = useState(150);++ return (+ <>+ <Text id={panelId} style={{ height, overflow: 'auto' }}>+ Record notes+ </Text>+ <ResizeHandle+ axis="y"+ defaultValue={150}+ onValueChange={setHeight}+ min={50}+ max={500}+ aria-label="Resize notes height"+ aria-controls={panelId}+ />+ </>+ );+};+```++The handle owns its value. `onValueChange` copies the latest size to the panel layout without controlling the handle. `defaultValue` only sets the initial size.++## Controlled state++```tsx+import { useId, useState } from 'react';+import { ResizeHandle } from 'twenty-ui/primitives/layout';+import { Text } from 'twenty-ui/primitives/typography';++export const ResizableNotes = () => {+ const panelId = useId();+ const [height, setHeight] = useState(150);++ return (+ <>+ <Text id={panelId} style={{ height, overflow: 'auto' }}>+ Record notes+ </Text>+ <ResizeHandle+ axis="y"+ value={height}+ onValueChange={setHeight}+ min={50}+ max={500}+ aria-label="Resize notes height"+ aria-controls={panelId}+ />+ </>+ );+};+```++The application owns the value and can update it from other controls. Keep `value` and `defaultValue` separate and retain the same ownership mode throughout the component's lifetime.++## Keyboard and bounds++For `axis="y"`, Down increases the size and Up decreases it. For `axis="x"`, Right increases and Left decreases in left-to-right content; the directions reverse under [TextDirectionProvider](/ui/primitives/layout/text-direction-provider) with `direction="rtl"`.++Arrow keys use `step`, which defaults to `10`. Home moves to `min`, and End moves to `max`. Pointer dragging uses the pixel movement and is not snapped to `step`. Both interactions stay within the bounds. `disabled` prevents resizing and removes the handle from the tab order.++The separator orientation describes the dividing edge: horizontal for height resizing and vertical for width resizing.++## Custom handle++`children` replaces the visible grip; it does not replace the separator behavior. `render` can replace the root element. Custom wrappers must [forward the supplied props and ref](/ui/primitives/overview#custom-components) so focus, pointer capture, keyboard handlers, and accessibility attributes reach the same element.++## Props++<ResizeHandleReference />diff --git a/packages/twenty-docs/ui/primitives/layout/text-direction-provider.mdx b/packages/twenty-docs/ui/primitives/layout/text-direction-provider.mdxnew file mode 100644index 00000000000..2a543d11045--- /dev/null+++ b/packages/twenty-docs/ui/primitives/layout/text-direction-provider.mdx@@ -0,0 +1,49 @@+---+title: TextDirectionProvider+description: Coordinate directional keyboard and pointer interactions with the document direction.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import TextDirectionProviderReference from '/snippets/ui/generated/layout/text-direction-provider.mdx';++`TextDirectionProvider` supplies `ltr` or `rtl` direction to Twenty UI controls. It does not render a DOM element or set an HTML `dir` attribute. Set both the provider direction and the matching document direction.++<StoryEmbed+ storyId="ui-input-segmentedcontrol--right-to-left"+ title="TextDirectionProvider example"+/>++## Usage++```tsx+import { SegmentedControl } from 'twenty-ui/primitives/input';+import { TextDirectionProvider } from 'twenty-ui/primitives/layout';++type DirectionalChoicesProps = { direction: 'ltr' | 'rtl' };++export const DirectionalChoices = ({ direction }: DirectionalChoicesProps) => (+ <TextDirectionProvider direction={direction}>+ <div dir={direction}>+ <SegmentedControl+ aria-label="Billing period"+ defaultValue="annual"+ options={[+ { label: 'Annual', value: 'annual' },+ { label: 'Monthly', value: 'monthly' },+ ]}+ />+ </div>+ </TextDirectionProvider>+);+```++The host application supplies translated labels and chooses the direction. Direction context affects directional interactions; the HTML attribute handles text and layout. For example, [SegmentedControl](/ui/primitives/input/segmented-control) reverses horizontal arrow navigation, and [ResizeHandle](/ui/primitives/layout/resize-handle) reverses horizontal resizing.++## Scope and state++Place one provider around the controls that share a direction. Nested providers can override the direction for a subtree; pair each override with a matching `dir` attribute. `direction` is a required application-owned prop, with no uncontrolled mode. The provider does not translate content or choose direction from the locale automatically.++## Props++<TextDirectionProviderReference />diff --git a/packages/twenty-docs/ui/primitives/navigation/click-to-action-link.mdx b/packages/twenty-docs/ui/primitives/navigation/click-to-action-link.mdxnew file mode 100644index 00000000000..819a85efbed--- /dev/null+++ b/packages/twenty-docs/ui/primitives/navigation/click-to-action-link.mdx@@ -0,0 +1,51 @@+---+title: ClickToActionLink+description: Render a text link for navigation to a destination.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import ClickToActionLinkReference from '/snippets/ui/generated/navigation/click-to-action-link.mdx';++`ClickToActionLink` renders a styled native anchor. Use a meaningful `href` and descriptive visible text. For an action that changes application state without navigation, use [Button](/ui/primitives/input/button).++<StoryEmbed+ storyId="ui-navigation-clicktoactionlink--default"+ title="ClickToActionLink example"+/>++## Usage++```tsx+import { ClickToActionLink } from 'twenty-ui/primitives/navigation';++export const ImportHelpLink = () => (+ <ClickToActionLink href="https://docs.twenty.com/">+ Read the Twenty documentation+ </ClickToActionLink>+);+```++## Open a new tab++```tsx+import { ClickToActionLink } from 'twenty-ui/primitives/navigation';++export const ExternalHelpLink = () => (+ <ClickToActionLink+ href="https://docs.twenty.com/"+ target="_blank"+ rel="noopener noreferrer"+ >+ Read the documentation (opens in a new tab)+ </ClickToActionLink>+);+```++With an `href`, the native anchor provides keyboard focus and Enter activation. `onClick` can observe or intercept activation; routing and state belong to the host application.++Although its TypeScript type accepts anchor attributes, the current implementation forwards only `children`, `className`, `href`, `onClick`, `target`, and `rel`. Other attributes and refs are not forwarded. Use visible link text as the accessible name.++## Props++<ClickToActionLinkReference />diff --git a/packages/twenty-docs/ui/primitives/navigation/list-item.mdx b/packages/twenty-docs/ui/primitives/navigation/list-item.mdxindex bd8a7e71d1b..f6b0bbc89cf 100644--- a/packages/twenty-docs/ui/primitives/navigation/list-item.mdx+++ b/packages/twenty-docs/ui/primitives/navigation/list-item.mdx@@ -134,7 +134,7 @@ export const AssigneeButtons = () => {### Multiple selection-Compose [Tag](/ui/primitives/data-display/tag) as the row content for tagged values, or put `ColorSample` in `startIcon` for a color choice. A row can also contain plain text or an avatar.+Compose [Tag](/ui/primitives/data-display/tag) as the row content for tagged values, or put [ColorSample](/ui/primitives/data-display/color-sample) in `startIcon` for a color choice. A row can also contain plain text or an avatar.<StoryEmbedstoryId="ui-navigation-listitem-picker--multiple-selection"diff --git a/packages/twenty-docs/ui/primitives/overview.mdx b/packages/twenty-docs/ui/primitives/overview.mdxindex 46d8171e4ed..5002f2eb53c 100644--- a/packages/twenty-docs/ui/primitives/overview.mdx+++ b/packages/twenty-docs/ui/primitives/overview.mdx@@ -86,10 +86,13 @@ Use a native button for button-like parts. On parts that expose `nativeButton`,Each page includes usage examples, interaction guidance, and a generated API reference.-| Family | Primitives |-| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |-| Data display | [Avatar](/ui/primitives/data-display/avatar), [Chip](/ui/primitives/data-display/chip), [Tag](/ui/primitives/data-display/tag), [Status](/ui/primitives/data-display/status) |-| Forms | [Button](/ui/primitives/input/button), [ButtonGroup](/ui/primitives/input/button-group), [Field](/ui/primitives/input/field), [Input](/ui/primitives/input/input), [InputGroup](/ui/primitives/input/input-group), [Textarea](/ui/primitives/input/textarea), [Checkbox](/ui/primitives/input/checkbox), [Radio](/ui/primitives/input/radio), [RadioGroup](/ui/primitives/input/radio-group), [Select](/ui/primitives/input/select), [Slider](/ui/primitives/input/slider), [Switch](/ui/primitives/input/switch) |-| Navigation | [ListItem](/ui/primitives/navigation/list-item), [Tabs](/ui/primitives/navigation/tabs) |-| Surfaces | [AlertDialog](/ui/primitives/surfaces/alert-dialog), [Card](/ui/primitives/surfaces/card), [Dialog](/ui/primitives/surfaces/dialog), [Menu](/ui/primitives/surfaces/menu), [Popover](/ui/primitives/surfaces/popover), [Tooltip](/ui/primitives/surfaces/tooltip) |-| Typography | [Heading](/ui/primitives/typography/heading), [Text](/ui/primitives/typography/text) |+| Family | Primitives |+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |+| Accessibility | [VisibilityHidden](/ui/primitives/accessibility/visibility-hidden) |+| Data display | [Avatar](/ui/primitives/data-display/avatar), [Chip](/ui/primitives/data-display/chip), [ColorSample](/ui/primitives/data-display/color-sample), [Pill](/ui/primitives/data-display/pill), [Status](/ui/primitives/data-display/status), [Tag](/ui/primitives/data-display/tag) |+| Feedback | [Banner](/ui/primitives/feedback/banner), [CircularProgressBar](/ui/primitives/feedback/circular-progress-bar), [Loader](/ui/primitives/feedback/loader), [ProgressBar](/ui/primitives/feedback/progress-bar) |+| Forms | [Button](/ui/primitives/input/button), [ButtonGroup](/ui/primitives/input/button-group), [Checkbox](/ui/primitives/input/checkbox), [Field](/ui/primitives/input/field), [Input](/ui/primitives/input/input), [InputGroup](/ui/primitives/input/input-group), [Radio](/ui/primitives/input/radio), [RadioGroup](/ui/primitives/input/radio-group), [SegmentedControl](/ui/primitives/input/segmented-control), [Select](/ui/primitives/input/select), [Slider](/ui/primitives/input/slider), [Switch](/ui/primitives/input/switch), [Textarea](/ui/primitives/input/textarea) |+| Layout | [AnimatedExpandableContainer](/ui/primitives/layout/animated-expandable-container), [HorizontalSeparator](/ui/primitives/layout/horizontal-separator), [ResizeHandle](/ui/primitives/layout/resize-handle), [TextDirectionProvider](/ui/primitives/layout/text-direction-provider) |+| Navigation | [ClickToActionLink](/ui/primitives/navigation/click-to-action-link), [ListItem](/ui/primitives/navigation/list-item), [Tabs](/ui/primitives/navigation/tabs) |+| Surfaces | [AlertDialog](/ui/primitives/surfaces/alert-dialog), [Card](/ui/primitives/surfaces/card), [Dialog](/ui/primitives/surfaces/dialog), [Menu](/ui/primitives/surfaces/menu), [Popover](/ui/primitives/surfaces/popover), [Tooltip](/ui/primitives/surfaces/tooltip) |+| Typography | [Heading](/ui/primitives/typography/heading), [OverflowingTextWithTooltip](/ui/primitives/typography/overflowing-text-with-tooltip), [Text](/ui/primitives/typography/text) |diff --git a/packages/twenty-docs/ui/primitives/surfaces/tooltip.mdx b/packages/twenty-docs/ui/primitives/surfaces/tooltip.mdxindex 49a5d2597db..7c500cd58f0 100644--- a/packages/twenty-docs/ui/primitives/surfaces/tooltip.mdx+++ b/packages/twenty-docs/ui/primitives/surfaces/tooltip.mdx@@ -119,7 +119,7 @@ Setting `disabled` on `Tooltip` suppresses the tooltip itself. It does not disabThe popup defaults to `side="top"`, `align="center"`, `sideOffset={10}`, and a maximum width of `300` pixels. Placement adjusts to available space. Use `arrow` for an arrow and `container` to override the theme's portal destination; see [theming](/ui/theming).-Use `OverflowingTextWithTooltip` when a text label should show its full value only when truncated. Its existing `text`, `tooltipContent`, and `tooltipPlace` props remain available.+Use [OverflowingTextWithTooltip](/ui/primitives/typography/overflowing-text-with-tooltip) when a text label should show its full value only when truncated. Its existing `text`, `tooltipContent`, and `tooltipPlace` props remain available.## Propsdiff --git a/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx b/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdxnew file mode 100644index 00000000000..8014be46ad2--- /dev/null+++ b/packages/twenty-docs/ui/primitives/typography/overflowing-text-with-tooltip.mdx@@ -0,0 +1,88 @@+---+title: OverflowingTextWithTooltip+description: Truncate long text and reveal its full value in a tooltip.+---++import { StoryEmbed } from '/snippets/ui/StoryEmbed.mdx';++import OverflowingTextWithTooltipReference from '/snippets/ui/generated/typography/overflowing-text-with-tooltip.mdx';++`OverflowingTextWithTooltip` truncates content within the available width. It checks for overflow on pointer entry and focus, then shows a tooltip only when needed. It manages tooltip visibility internally and exposes no controlled or uncontrolled open-state props.++<StoryEmbed+ storyId="ui-surfaces-overflowingtextwithtooltip--single-line-overflowing"+ title="OverflowingTextWithTooltip example"+/>++## Usage++```tsx+import {+ OverflowingTextWithTooltip,+ Text,+} from 'twenty-ui/primitives/typography';++export const RecordTitle = () => (+ <Text style={{ maxWidth: 220 }}>+ <OverflowingTextWithTooltip+ text="Quarterly account review and renewal preparation"+ isFocusable+ />+ </Text>+);+```++Constrain the width of the surrounding layout so truncation can occur. `isFocusable` gives the text a tab stop and opens the tooltip on focus or click. Keep essential information available to users who cannot hover.++## Multiline content++```tsx+import {+ OverflowingTextWithTooltip,+ Text,+} from 'twenty-ui/primitives/typography';++export const RecordDescription = () => (+ <Text style={{ maxWidth: 220 }}>+ <OverflowingTextWithTooltip+ text="Review the account history, confirm the renewal date, and prepare the next conversation with the customer."+ displayedMaxRows={2}+ isTooltipMultiline+ isFocusable+ />+ </Text>+);+```++`displayedMaxRows` limits the displayed lines; use a positive integer. `isTooltipMultiline` preserves whitespace and line breaks inside the tooltip. Without a row limit, text truncates on one line.++## Custom content and timing++```tsx+import {+ OverflowingTextWithTooltip,+ Text,+} from 'twenty-ui/primitives/typography';++export const ImportResult = () => (+ <Text style={{ maxWidth: 220 }}>+ <OverflowingTextWithTooltip+ text={<strong>24 records imported successfully</strong>}+ tooltipContent="24 records imported successfully"+ tooltipPlace="top"+ tooltipDelay={300}+ isFocusable+ />+ </Text>+);+```++React content requires a plain-string `tooltipContent`. With string text, that prop can override the tooltip label; otherwise the text itself is used. An empty or missing label does not open a tooltip. String text also recognizes links.++`alwaysShowTooltip` allows the tooltip even without truncation. `tooltipDelay` controls the hover delay and defaults to 500 milliseconds. `tooltipPlace` defaults to `bottom`.++The component supplies its text and tooltip parts internally; it does not accept children, native attributes, or a ref for its text element. Use [Text](/ui/primitives/typography/text) and [Tooltip](/ui/primitives/surfaces/tooltip) directly when you need custom composition. Interactive popup content belongs in [Popover](/ui/primitives/surfaces/popover).++## Props++<OverflowingTextWithTooltipReference />diff --git a/packages/twenty-shared/src/constants/DocumentationPaths.ts b/packages/twenty-shared/src/constants/DocumentationPaths.tsindex 9ab3c7c55ac..bf14b848079 100644--- a/packages/twenty-shared/src/constants/DocumentationPaths.ts+++ b/packages/twenty-shared/src/constants/DocumentationPaths.ts@@ -142,10 +142,20 @@ export const DOCUMENTATION_PATHS = {UI_COMPONENTS_TOAST: '/ui/components/toast',UI_DARK_MODE: '/ui/dark-mode',UI_GETTING_STARTED: '/ui/getting-started',+ UI_PRIMITIVES_ACCESSIBILITY_VISIBILITY_HIDDEN:+ '/ui/primitives/accessibility/visibility-hidden',UI_PRIMITIVES_DATA_DISPLAY_AVATAR: '/ui/primitives/data-display/avatar',UI_PRIMITIVES_DATA_DISPLAY_CHIP: '/ui/primitives/data-display/chip',+ UI_PRIMITIVES_DATA_DISPLAY_COLOR_SAMPLE:+ '/ui/primitives/data-display/color-sample',+ UI_PRIMITIVES_DATA_DISPLAY_PILL: '/ui/primitives/data-display/pill',UI_PRIMITIVES_DATA_DISPLAY_STATUS: '/ui/primitives/data-display/status',UI_PRIMITIVES_DATA_DISPLAY_TAG: '/ui/primitives/data-display/tag',+ UI_PRIMITIVES_FEEDBACK_BANNER: '/ui/primitives/feedback/banner',+ UI_PRIMITIVES_FEEDBACK_CIRCULAR_PROGRESS_BAR:+ '/ui/primitives/feedback/circular-progress-bar',+ UI_PRIMITIVES_FEEDBACK_LOADER: '/ui/primitives/feedback/loader',+ UI_PRIMITIVES_FEEDBACK_PROGRESS_BAR: '/ui/primitives/feedback/progress-bar',UI_PRIMITIVES_INPUT_BUTTON: '/ui/primitives/input/button',UI_PRIMITIVES_INPUT_BUTTON_GROUP: '/ui/primitives/input/button-group',UI_PRIMITIVES_INPUT_CHECKBOX: '/ui/primitives/input/checkbox',@@ -154,10 +164,21 @@ export const DOCUMENTATION_PATHS = {UI_PRIMITIVES_INPUT_INPUT_GROUP: '/ui/primitives/input/input-group',UI_PRIMITIVES_INPUT_RADIO: '/ui/primitives/input/radio',UI_PRIMITIVES_INPUT_RADIO_GROUP: '/ui/primitives/input/radio-group',+ UI_PRIMITIVES_INPUT_SEGMENTED_CONTROL:+ '/ui/primitives/input/segmented-control',UI_PRIMITIVES_INPUT_SELECT: '/ui/primitives/input/select',UI_PRIMITIVES_INPUT_SLIDER: '/ui/primitives/input/slider',UI_PRIMITIVES_INPUT_SWITCH: '/ui/primitives/input/switch',UI_PRIMITIVES_INPUT_TEXTAREA: '/ui/primitives/input/textarea',+ UI_PRIMITIVES_LAYOUT_ANIMATED_EXPANDABLE_CONTAINER:+ '/ui/primitives/layout/animated-expandable-container',+ UI_PRIMITIVES_LAYOUT_HORIZONTAL_SEPARATOR:+ '/ui/primitives/layout/horizontal-separator',+ UI_PRIMITIVES_LAYOUT_RESIZE_HANDLE: '/ui/primitives/layout/resize-handle',+ UI_PRIMITIVES_LAYOUT_TEXT_DIRECTION_PROVIDER:+ '/ui/primitives/layout/text-direction-provider',+ UI_PRIMITIVES_NAVIGATION_CLICK_TO_ACTION_LINK:+ '/ui/primitives/navigation/click-to-action-link',UI_PRIMITIVES_NAVIGATION_LIST_ITEM: '/ui/primitives/navigation/list-item',UI_PRIMITIVES_NAVIGATION_TABS: '/ui/primitives/navigation/tabs',UI_PRIMITIVES_OVERVIEW: '/ui/primitives/overview',@@ -168,6 +189,8 @@ export const DOCUMENTATION_PATHS = {UI_PRIMITIVES_SURFACES_POPOVER: '/ui/primitives/surfaces/popover',UI_PRIMITIVES_SURFACES_TOOLTIP: '/ui/primitives/surfaces/tooltip',UI_PRIMITIVES_TYPOGRAPHY_HEADING: '/ui/primitives/typography/heading',+ UI_PRIMITIVES_TYPOGRAPHY_OVERFLOWING_TEXT_WITH_TOOLTIP:+ '/ui/primitives/typography/overflowing-text-with-tooltip',UI_PRIMITIVES_TYPOGRAPHY_TEXT: '/ui/primitives/typography/text',UI_SSR: '/ui/ssr',UI_THEMING: '/ui/theming',diff --git a/packages/twenty-ui/docs/animatedExpandableContainerPropDescriptions.ts b/packages/twenty-ui/docs/animatedExpandableContainerPropDescriptions.tsnew file mode 100644index 00000000000..0629eb12ef8--- /dev/null+++ b/packages/twenty-ui/docs/animatedExpandableContainerPropDescriptions.ts@@ -0,0 +1,21 @@+import { type ComponentProps } from 'react';++import { type AnimatedExpandableContainer } from '../src/primitives/layout/AnimatedExpandableContainer/AnimatedExpandableContainer';++export const ANIMATED_EXPANDABLE_CONTAINER_PROP_DESCRIPTIONS = {+ children: 'Content inside the expanding panel.',+ isExpanded:+ 'Controlled visibility of the panel. The application owns the trigger and state.',+ dimension: 'Dimension animated when the panel opens and closes.',+ animationDurations:+ 'Default theme timing or separate opacity and size durations in seconds.',+ containAnimation:+ 'Clips overflowing content during expansion and uses a column layout.',+ duration:+ 'Theme timing preset for both opacity and size. Explicit `animationDurations` take precedence.',+ mode: 'Compatibility prop accepted by the type but not used by the current implementation.',+ initial:+ 'Compatibility prop accepted by the type but not used by the current implementation.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof AnimatedExpandableContainer>, string>+>;diff --git a/packages/twenty-ui/docs/bannerPropDescriptions.ts b/packages/twenty-ui/docs/bannerPropDescriptions.tsnew file mode 100644index 00000000000..da744044f19--- /dev/null+++ b/packages/twenty-ui/docs/bannerPropDescriptions.ts@@ -0,0 +1,10 @@+import { type ComponentProps } from 'react';++import { type Banner } from '../src/primitives/feedback/Banner/Banner';++export const BANNER_PROP_DESCRIPTIONS = {+ children: 'Message and optional actions displayed inside the banner.',+ color: 'Blue information treatment or danger treatment.',+ variant: 'Primary solid treatment or secondary translucent treatment.',+ className: 'CSS class applied to the banner.',+} satisfies Partial<Record<keyof ComponentProps<typeof Banner>, string>>;diff --git a/packages/twenty-ui/docs/circularProgressBarPropDescriptions.ts b/packages/twenty-ui/docs/circularProgressBarPropDescriptions.tsnew file mode 100644index 00000000000..3f35a54aa01--- /dev/null+++ b/packages/twenty-ui/docs/circularProgressBarPropDescriptions.ts@@ -0,0 +1,11 @@+import { type ComponentProps } from 'react';++import { type CircularProgressBar } from '../src/primitives/feedback/CircularProgressBar/CircularProgressBar';++export const CIRCULAR_PROGRESS_BAR_PROP_DESCRIPTIONS = {+ size: 'Width and height of the spinner in pixels.',+ barWidth: 'Stroke width in pixels. Keep it smaller than half of `size`.',+ barColor: 'CSS stroke color. Defaults to the inherited text color.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof CircularProgressBar>, string>+>;diff --git a/packages/twenty-ui/docs/clickToActionLinkPropDescriptions.ts b/packages/twenty-ui/docs/clickToActionLinkPropDescriptions.tsnew file mode 100644index 00000000000..d8811429e5c--- /dev/null+++ b/packages/twenty-ui/docs/clickToActionLinkPropDescriptions.ts@@ -0,0 +1,15 @@+import { type ComponentProps } from 'react';++import { type ClickToActionLink } from '../src/primitives/navigation/ClickToActionLink/ClickToActionLink';++export const CLICK_TO_ACTION_LINK_PROP_DESCRIPTIONS = {+ children:+ 'Visible link text or content. Use a descriptive destination label.',+ className: 'CSS class applied to the anchor.',+ href: 'Destination URL for native link navigation.',+ onClick: 'Click handler called when the link is activated.',+ target: 'Browsing context in which to open the destination.',+ rel: 'Relationship to the destination, such as `noopener noreferrer` for a new tab.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof ClickToActionLink>, string>+>;diff --git a/packages/twenty-ui/docs/colorSamplePropDescriptions.ts b/packages/twenty-ui/docs/colorSamplePropDescriptions.tsnew file mode 100644index 00000000000..0a2a6ea7f97--- /dev/null+++ b/packages/twenty-ui/docs/colorSamplePropDescriptions.ts@@ -0,0 +1,13 @@+import { type ComponentProps } from 'react';++import { type ColorSample } from '../src/primitives/data-display/ColorSample/ColorSample';++export const COLOR_SAMPLE_PROP_DESCRIPTIONS = {+ colorName:+ 'Theme color used for the background and border. Required even when `color` overrides the background.',+ color:+ 'CSS color that overrides the background; the border still uses `colorName`.',+ variant:+ 'Swatch shape: `default`, `circle`, or `pipeline`. Omitting it uses the default shape.',+ className: 'CSS class applied to the swatch.',+} satisfies Partial<Record<keyof ComponentProps<typeof ColorSample>, string>>;diff --git a/packages/twenty-ui/docs/components.ts b/packages/twenty-ui/docs/components.tsindex 06c803d30b8..47faf499569 100644--- a/packages/twenty-ui/docs/components.ts+++ b/packages/twenty-ui/docs/components.ts@@ -1,4 +1,6 @@+import { ANIMATED_EXPANDABLE_CONTAINER_PROP_DESCRIPTIONS } from './animatedExpandableContainerPropDescriptions';import { AVATAR_PROP_DESCRIPTIONS } from './avatarPropDescriptions';+import { BANNER_PROP_DESCRIPTIONS } from './bannerPropDescriptions';import { BUTTON_GROUP_PROP_DESCRIPTIONS } from './buttonGroupPropDescriptions';import { BUTTON_PROP_DESCRIPTIONS } from './buttonPropDescriptions';import { CARD_CONTENT_PROP_DESCRIPTIONS } from './cardContentPropDescriptions';@@ -6,23 +8,136 @@ import { CARD_FOOTER_PROP_DESCRIPTIONS } from './cardFooterPropDescriptions';import { CARD_HEADER_PROP_DESCRIPTIONS } from './cardHeaderPropDescriptions';import { CARD_PROP_DESCRIPTIONS } from './cardPropDescriptions';import { CHIP_PROP_DESCRIPTIONS } from './chipPropDescriptions';+import { CIRCULAR_PROGRESS_BAR_PROP_DESCRIPTIONS } from './circularProgressBarPropDescriptions';+import { CLICK_TO_ACTION_LINK_PROP_DESCRIPTIONS } from './clickToActionLinkPropDescriptions';import { CODE_EDITOR_HEADER_PROP_DESCRIPTIONS } from './codeEditorHeaderPropDescriptions';import { CODE_EDITOR_PROP_DESCRIPTIONS } from './codeEditorPropDescriptions';+import { COLOR_SAMPLE_PROP_DESCRIPTIONS } from './colorSamplePropDescriptions';import { DIALOG_PROP_DESCRIPTIONS } from './dialogPropDescriptions';import { DIALOG_TITLE_PROP_DESCRIPTIONS } from './dialogTitlePropDescriptions';import { HEADING_PROP_DESCRIPTIONS } from './headingPropDescriptions';+import { HORIZONTAL_SEPARATOR_PROP_DESCRIPTIONS } from './horizontalSeparatorPropDescriptions';import { ICON_BUTTON_PROP_DESCRIPTIONS } from './iconButtonPropDescriptions';import { LIGHT_BUTTON_PROP_DESCRIPTIONS } from './lightButtonPropDescriptions';import { LIGHT_ICON_BUTTON_PROP_DESCRIPTIONS } from './lightIconButtonPropDescriptions';+import { LOADER_PROP_DESCRIPTIONS } from './loaderPropDescriptions';+import { OVERFLOWING_TEXT_WITH_TOOLTIP_PROP_DESCRIPTIONS } from './overflowingTextWithTooltipPropDescriptions';+import { PILL_PROP_DESCRIPTIONS } from './pillPropDescriptions';+import { PROGRESS_BAR_PROP_DESCRIPTIONS } from './progressBarPropDescriptions';+import { RESIZE_HANDLE_PROP_DESCRIPTIONS } from './resizeHandlePropDescriptions';import { SECTION_HEADER_PROP_DESCRIPTIONS } from './sectionHeaderPropDescriptions';import { SECTION_ROOT_PROP_DESCRIPTIONS } from './sectionRootPropDescriptions';+import { SEGMENTED_CONTROL_PROP_DESCRIPTIONS } from './segmentedControlPropDescriptions';import { SETTINGS_ROW_PROP_DESCRIPTIONS } from './settingsRowPropDescriptions';import { STATUS_PROP_DESCRIPTIONS } from './statusPropDescriptions';import { TAG_PROP_DESCRIPTIONS } from './tagPropDescriptions';+import { TEXT_DIRECTION_PROVIDER_PROP_DESCRIPTIONS } from './textDirectionProviderPropDescriptions';import { TOOLTIP_PART_PROP_DESCRIPTIONS } from './tooltipPartPropDescriptions';import { TOOLTIP_PROP_DESCRIPTIONS } from './tooltipPropDescriptions';+import { VISIBILITY_HIDDEN_PROP_DESCRIPTIONS } from './visibilityHiddenPropDescriptions';export const DOCUMENTED_COMPONENTS = [+ {+ name: 'VisibilityHidden',+ source: 'primitives/accessibility/components/VisibilityHidden.tsx',+ entryPoint: 'twenty-ui/primitives/accessibility',+ slug: 'accessibility/visibility-hidden',+ propDescriptions: VISIBILITY_HIDDEN_PROP_DESCRIPTIONS,+ },+ {+ name: 'ColorSample',+ source: 'primitives/data-display/ColorSample/ColorSample.tsx',+ entryPoint: 'twenty-ui/primitives/data-display',+ slug: 'data-display/color-sample',+ propDescriptions: COLOR_SAMPLE_PROP_DESCRIPTIONS,+ },+ {+ name: 'Pill',+ source: 'primitives/data-display/Pill/Pill.tsx',+ entryPoint: 'twenty-ui/primitives/data-display',+ slug: 'data-display/pill',+ propDescriptions: PILL_PROP_DESCRIPTIONS,+ },+ {+ name: 'Banner',+ source: 'primitives/feedback/Banner/Banner.tsx',+ entryPoint: 'twenty-ui/primitives/feedback',+ slug: 'feedback/banner',+ propDescriptions: BANNER_PROP_DESCRIPTIONS,+ },+ {+ name: 'CircularProgressBar',+ source: 'primitives/feedback/CircularProgressBar/CircularProgressBar.tsx',+ entryPoint: 'twenty-ui/primitives/feedback',+ slug: 'feedback/circular-progress-bar',+ propDescriptions: CIRCULAR_PROGRESS_BAR_PROP_DESCRIPTIONS,+ },+ {+ name: 'Loader',+ source: 'primitives/feedback/Loader/Loader.tsx',+ entryPoint: 'twenty-ui/primitives/feedback',+ slug: 'feedback/loader',+ propDescriptions: LOADER_PROP_DESCRIPTIONS,+ },+ {+ name: 'ProgressBar',+ source: 'primitives/feedback/ProgressBar/ProgressBar.tsx',+ entryPoint: 'twenty-ui/primitives/feedback',+ slug: 'feedback/progress-bar',+ propDescriptions: PROGRESS_BAR_PROP_DESCRIPTIONS,+ },+ {+ name: 'SegmentedControl',+ source: 'primitives/input/SegmentedControl/SegmentedControl.tsx',+ entryPoint: 'twenty-ui/primitives/input',+ slug: 'input/segmented-control',+ propDescriptions: SEGMENTED_CONTROL_PROP_DESCRIPTIONS,+ },+ {+ name: 'AnimatedExpandableContainer',+ source:+ 'primitives/layout/AnimatedExpandableContainer/AnimatedExpandableContainer.tsx',+ entryPoint: 'twenty-ui/primitives/layout',+ slug: 'layout/animated-expandable-container',+ propDescriptions: ANIMATED_EXPANDABLE_CONTAINER_PROP_DESCRIPTIONS,+ },+ {+ name: 'HorizontalSeparator',+ source: 'primitives/layout/HorizontalSeparator/HorizontalSeparator.tsx',+ entryPoint: 'twenty-ui/primitives/layout',+ slug: 'layout/horizontal-separator',+ propDescriptions: HORIZONTAL_SEPARATOR_PROP_DESCRIPTIONS,+ },+ {+ name: 'ResizeHandle',+ source: 'primitives/layout/ResizeHandle/ResizeHandle.tsx',+ entryPoint: 'twenty-ui/primitives/layout',+ slug: 'layout/resize-handle',+ propDescriptions: RESIZE_HANDLE_PROP_DESCRIPTIONS,+ propDefaults: { defaultValue: '150', min: '50', max: '500', step: '10' },+ },+ {+ name: 'TextDirectionProvider',+ source: 'primitives/layout/TextDirectionProvider/TextDirectionProvider.tsx',+ entryPoint: 'twenty-ui/primitives/layout',+ slug: 'layout/text-direction-provider',+ propDescriptions: TEXT_DIRECTION_PROVIDER_PROP_DESCRIPTIONS,+ },+ {+ name: 'ClickToActionLink',+ source: 'primitives/navigation/ClickToActionLink/ClickToActionLink.tsx',+ entryPoint: 'twenty-ui/primitives/navigation',+ slug: 'navigation/click-to-action-link',+ propDescriptions: CLICK_TO_ACTION_LINK_PROP_DESCRIPTIONS,+ },+ {+ name: 'OverflowingTextWithTooltip',+ source:+ 'primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip.tsx',+ entryPoint: 'twenty-ui/primitives/typography',+ slug: 'typography/overflowing-text-with-tooltip',+ propDescriptions: OVERFLOWING_TEXT_WITH_TOOLTIP_PROP_DESCRIPTIONS,+ },{name: 'LightIconButton',source: 'components/input/LightIconButton/LightIconButton.tsx',diff --git a/packages/twenty-ui/docs/horizontalSeparatorPropDescriptions.ts b/packages/twenty-ui/docs/horizontalSeparatorPropDescriptions.tsnew file mode 100644index 00000000000..6bd27c164cb--- /dev/null+++ b/packages/twenty-ui/docs/horizontalSeparatorPropDescriptions.ts@@ -0,0 +1,13 @@+import { type ComponentProps } from 'react';++import { type HorizontalSeparator } from '../src/primitives/layout/HorizontalSeparator/HorizontalSeparator';++export const HORIZONTAL_SEPARATOR_PROP_DESCRIPTIONS = {+ visible:+ 'Shows the dividing line. Setting it to false preserves margins and any text.',+ text: 'Optional label displayed between two lines.',+ noMargin: 'Removes the vertical margins.',+ color: 'CSS line color. Defaults to the medium border color.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof HorizontalSeparator>, string>+>;diff --git a/packages/twenty-ui/docs/loaderPropDescriptions.ts b/packages/twenty-ui/docs/loaderPropDescriptions.tsnew file mode 100644index 00000000000..626e6c20faf--- /dev/null+++ b/packages/twenty-ui/docs/loaderPropDescriptions.ts@@ -0,0 +1,8 @@+import { type ComponentProps } from 'react';++import { type Loader } from '../src/primitives/feedback/Loader/Loader';++export const LOADER_PROP_DESCRIPTIONS = {+ color:+ 'Theme color for the animated dot and border. When omitted, inherits the button color if available, otherwise the tertiary text color.',+} satisfies Partial<Record<keyof ComponentProps<typeof Loader>, string>>;diff --git a/packages/twenty-ui/docs/overflowingTextWithTooltipPropDescriptions.ts b/packages/twenty-ui/docs/overflowingTextWithTooltipPropDescriptions.tsnew file mode 100644index 00000000000..6df820d6185--- /dev/null+++ b/packages/twenty-ui/docs/overflowingTextWithTooltipPropDescriptions.ts@@ -0,0 +1,19 @@+import { type ComponentProps } from 'react';++import { type OverflowingTextWithTooltip } from '../src/primitives/typography/OverflowingTextWithTooltip/OverflowingTextWithTooltip';++export const OVERFLOWING_TEXT_WITH_TOOLTIP_PROP_DESCRIPTIONS = {+ text: 'Text or React content to truncate. Non-string React content requires `tooltipContent`.',+ tooltipContent:+ 'Plain text displayed in the tooltip. Defaults to `text` when it is a nonempty string.',+ size: 'Small inherited text sizing or the large fixed-height treatment.',+ isTooltipMultiline: 'Preserves whitespace and line breaks in the tooltip.',+ displayedMaxRows:+ 'Maximum displayed rows. Omit for single-line truncation; use a positive integer for multiline text.',+ tooltipDelay: 'Hover delay in milliseconds.',+ tooltipPlace: 'Preferred side of the tooltip.',+ alwaysShowTooltip: 'Allows the tooltip even when the text is not truncated.',+ isFocusable: 'Adds a tab stop and opens the tooltip on focus or click.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof OverflowingTextWithTooltip>, string>+>;diff --git a/packages/twenty-ui/docs/pillPropDescriptions.ts b/packages/twenty-ui/docs/pillPropDescriptions.tsnew file mode 100644index 00000000000..39b0d8a0cb8--- /dev/null+++ b/packages/twenty-ui/docs/pillPropDescriptions.ts@@ -0,0 +1,9 @@+import { type ComponentProps } from 'react';++import { type Pill } from '../src/primitives/data-display/Pill/Pill';++export const PILL_PROP_DESCRIPTIONS = {+ label: 'Short text displayed inside the pill.',+ Icon: 'Icon component rendered before the label at 12px. Import icons from `twenty-ui/icon`.',+ className: 'CSS class applied to the pill.',+} satisfies Partial<Record<keyof ComponentProps<typeof Pill>, string>>;diff --git a/packages/twenty-ui/docs/progressBarPropDescriptions.ts b/packages/twenty-ui/docs/progressBarPropDescriptions.tsnew file mode 100644index 00000000000..5d8615bcd36--- /dev/null+++ b/packages/twenty-ui/docs/progressBarPropDescriptions.ts@@ -0,0 +1,18 @@+import { type ComponentProps } from 'react';++import { type ProgressBar } from '../src/primitives/feedback/ProgressBar/ProgressBar';++export const PROGRESS_BAR_PROP_DESCRIPTIONS = {+ value:+ 'Current progress from 0 to 100. Also supplies the accessible value during a countdown.',+ className: 'CSS class applied to the progress root.',+ barColor: 'CSS color of the filled bar. Defaults to the primary text color.',+ backgroundColor: 'CSS background color of the track.',+ withBorderRadius: 'Rounds the track and indicator corners.',+ ariaLabel: 'Accessible name describing the operation being measured.',+ countdownDurationInMs:+ 'Starts a visual animation from full to empty over this duration in milliseconds. Does not update `value`.',+ isCountdownPaused:+ 'Pauses the countdown animation without resetting its position.',+ onCountdownComplete: 'Called when the countdown animation ends.',+} satisfies Partial<Record<keyof ComponentProps<typeof ProgressBar>, string>>;diff --git a/packages/twenty-ui/docs/resizeHandlePropDescriptions.ts b/packages/twenty-ui/docs/resizeHandlePropDescriptions.tsnew file mode 100644index 00000000000..2cf8aab48e6--- /dev/null+++ b/packages/twenty-ui/docs/resizeHandlePropDescriptions.ts@@ -0,0 +1,15 @@+import { type ComponentProps } from 'react';++import { type ResizeHandle } from '../src/primitives/layout/ResizeHandle/ResizeHandle';++export const RESIZE_HANDLE_PROP_DESCRIPTIONS = {+ axis: 'Pointer movement axis: `y` for height or `x` for width.',+ value: 'Controlled size. Apply the value to the element being resized.',+ defaultValue: 'Initial size when the handle owns its state.',+ onValueChange:+ 'Called with the bounded size after pointer or keyboard interaction.',+ min: 'Minimum allowed size.',+ max: 'Maximum allowed size.',+ step: 'Keyboard arrow increment. Pointer movement uses the pixel delta.',+ disabled: 'Disables resizing and removes the handle from the tab order.',+} satisfies Partial<Record<keyof ComponentProps<typeof ResizeHandle>, string>>;diff --git a/packages/twenty-ui/docs/segmentedControlPropDescriptions.ts b/packages/twenty-ui/docs/segmentedControlPropDescriptions.tsnew file mode 100644index 00000000000..c39a89a7d64--- /dev/null+++ b/packages/twenty-ui/docs/segmentedControlPropDescriptions.ts@@ -0,0 +1,15 @@+import { type ComponentProps } from 'react';+import { type KeysOfUnion } from 'type-fest';++import { type SegmentedControl } from '../src/primitives/input/SegmentedControl/SegmentedControl';++export const SEGMENTED_CONTROL_PROP_DESCRIPTIONS = {+ itemWidth: 'Use equal-width options or size each option to its content.',+ options:+ 'Options with a unique string `value`, a `label` or `startIcon`, and optional `disabled`. Icon-only options require an `aria-label`.',+ 'aria-label': 'Accessible group name. Supply this or `aria-labelledby`.',+ 'aria-labelledby':+ 'ID of an element that labels the group. Supply this or `aria-label`.',+} satisfies Partial<+ Record<KeysOfUnion<ComponentProps<typeof SegmentedControl>>, string>+>;diff --git a/packages/twenty-ui/docs/textDirectionProviderPropDescriptions.ts b/packages/twenty-ui/docs/textDirectionProviderPropDescriptions.tsnew file mode 100644index 00000000000..b1be6869236--- /dev/null+++ b/packages/twenty-ui/docs/textDirectionProviderPropDescriptions.ts@@ -0,0 +1,11 @@+import { type ComponentProps } from 'react';++import { type TextDirectionProvider } from '../src/primitives/layout/TextDirectionProvider/TextDirectionProvider';++export const TEXT_DIRECTION_PROVIDER_PROP_DESCRIPTIONS = {+ children: 'Controls that receive the direction context.',+ direction:+ 'Reading direction used by directional interactions. Also set the matching HTML `dir` attribute on the content.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof TextDirectionProvider>, string>+>;diff --git a/packages/twenty-ui/docs/visibilityHiddenPropDescriptions.ts b/packages/twenty-ui/docs/visibilityHiddenPropDescriptions.tsnew file mode 100644index 00000000000..66c4906a214--- /dev/null+++ b/packages/twenty-ui/docs/visibilityHiddenPropDescriptions.ts@@ -0,0 +1,10 @@+import { type ComponentProps } from 'react';++import { type VisibilityHidden } from '../src/primitives/accessibility/components/VisibilityHidden';++export const VISIBILITY_HIDDEN_PROP_DESCRIPTIONS = {+ children:+ 'Content hidden visually while remaining available to assistive technology.',+} satisfies Partial<+ Record<keyof ComponentProps<typeof VisibilityHidden>, string>+>;diff --git a/packages/twenty-ui/generated/components.docs.json b/packages/twenty-ui/generated/components.docs.jsonindex df618e68cb3..4f562598260 100644--- a/packages/twenty-ui/generated/components.docs.json+++ b/packages/twenty-ui/generated/components.docs.json@@ -1,4 +1,655 @@[+ {+ "name": "VisibilityHidden",+ "entryPoint": "twenty-ui/primitives/accessibility",+ "slug": "accessibility/visibility-hidden",+ "props": [+ {+ "name": "children",+ "type": "ReactNode",+ "required": true,+ "defaultValue": null,+ "description": "Content hidden visually while remaining available to assistive technology."+ }+ ]+ },+ {+ "name": "ColorSample",+ "entryPoint": "twenty-ui/primitives/data-display",+ "slug": "data-display/color-sample",+ "props": [+ {+ "name": "className",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the swatch."+ },+ {+ "name": "color",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS color that overrides the background; the border still uses `colorName`."+ },+ {+ "name": "colorName",+ "type": "\"amber\" | \"blue\" | \"bronze\" | \"brown\" | \"crimson\" | \"cyan\" | \"gold\" | \"grass\" | \"gray\" | \"green\" | \"iris\" | \"jade\" | \"lime\" | \"mint\" | \"orange\" | \"pink\" | \"plum\" | \"purple\" | \"red\" | \"ruby\" | \"sky\" | \"tomato\" | \"turquoise\" | \"violet\" | \"yellow\"",+ "required": true,+ "defaultValue": null,+ "description": "Theme color used for the background and border. Required even when `color` overrides the background."+ },+ {+ "name": "variant",+ "type": "\"circle\" | \"default\" | \"pipeline\"",+ "required": false,+ "defaultValue": null,+ "description": "Swatch shape: `default`, `circle`, or `pipeline`. Omitting it uses the default shape."+ }+ ]+ },+ {+ "name": "Pill",+ "entryPoint": "twenty-ui/primitives/data-display",+ "slug": "data-display/pill",+ "props": [+ {+ "name": "className",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the pill."+ },+ {+ "name": "Icon",+ "type": "IconComponent",+ "required": false,+ "defaultValue": null,+ "description": "Icon component rendered before the label at 12px. Import icons from `twenty-ui/icon`."+ },+ {+ "name": "label",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Short text displayed inside the pill."+ }+ ]+ },+ {+ "name": "Banner",+ "entryPoint": "twenty-ui/primitives/feedback",+ "slug": "feedback/banner",+ "props": [+ {+ "name": "children",+ "type": "ReactNode",+ "required": true,+ "defaultValue": null,+ "description": "Message and optional actions displayed inside the banner."+ },+ {+ "name": "className",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the banner."+ },+ {+ "name": "color",+ "type": "\"blue\" | \"danger\"",+ "required": false,+ "defaultValue": "blue",+ "description": "Blue information treatment or danger treatment."+ },+ {+ "name": "variant",+ "type": "\"primary\" | \"secondary\"",+ "required": false,+ "defaultValue": "primary",+ "description": "Primary solid treatment or secondary translucent treatment."+ }+ ]+ },+ {+ "name": "CircularProgressBar",+ "entryPoint": "twenty-ui/primitives/feedback",+ "slug": "feedback/circular-progress-bar",+ "props": [+ {+ "name": "barColor",+ "type": "string",+ "required": false,+ "defaultValue": "currentColor",+ "description": "CSS stroke color. Defaults to the inherited text color."+ },+ {+ "name": "barWidth",+ "type": "number",+ "required": false,+ "defaultValue": "5",+ "description": "Stroke width in pixels. Keep it smaller than half of `size`."+ },+ {+ "name": "size",+ "type": "number",+ "required": false,+ "defaultValue": "50",+ "description": "Width and height of the spinner in pixels."+ }+ ]+ },+ {+ "name": "Loader",+ "entryPoint": "twenty-ui/primitives/feedback",+ "slug": "feedback/loader",+ "props": [+ {+ "name": "color",+ "type": "\"amber\" | \"blue\" | \"bronze\" | \"brown\" | \"crimson\" | \"cyan\" | \"gold\" | \"grass\" | \"gray\" | \"green\" | \"iris\" | \"jade\" | \"lime\" | \"mint\" | \"orange\" | \"pink\" | \"plum\" | \"purple\" | \"red\" | \"ruby\" | \"sky\" | \"tomato\" | \"turquoise\" | \"violet\" | \"yellow\"",+ "required": false,+ "defaultValue": null,+ "description": "Theme color for the animated dot and border. When omitted, inherits the button color if available, otherwise the tertiary text color."+ }+ ]+ },+ {+ "name": "ProgressBar",+ "entryPoint": "twenty-ui/primitives/feedback",+ "slug": "feedback/progress-bar",+ "props": [+ {+ "name": "ariaLabel",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Accessible name describing the operation being measured."+ },+ {+ "name": "backgroundColor",+ "type": "string",+ "required": false,+ "defaultValue": "none",+ "description": "CSS background color of the track."+ },+ {+ "name": "barColor",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS color of the filled bar. Defaults to the primary text color."+ },+ {+ "name": "className",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the progress root."+ },+ {+ "name": "countdownDurationInMs",+ "type": "number",+ "required": false,+ "defaultValue": null,+ "description": "Starts a visual animation from full to empty over this duration in milliseconds. Does not update `value`."+ },+ {+ "name": "isCountdownPaused",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Pauses the countdown animation without resetting its position."+ },+ {+ "name": "onCountdownComplete",+ "type": "(() => void)",+ "required": false,+ "defaultValue": null,+ "description": "Called when the countdown animation ends."+ },+ {+ "name": "value",+ "type": "number",+ "required": true,+ "defaultValue": null,+ "description": "Current progress from 0 to 100. Also supplies the accessible value during a countdown."+ },+ {+ "name": "withBorderRadius",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Rounds the track and indicator corners."+ }+ ]+ },+ {+ "name": "SegmentedControl",+ "entryPoint": "twenty-ui/primitives/input",+ "slug": "input/segmented-control",+ "props": [+ {+ "name": "aria-label",+ "type": "string",+ "required": true,+ "defaultValue": null,+ "description": "Accessible group name. Supply this or `aria-labelledby`."+ },+ {+ "name": "aria-labelledby",+ "type": "string",+ "required": true,+ "defaultValue": null,+ "description": "ID of an element that labels the group. Supply this or `aria-label`."+ },+ {+ "name": "className",+ "type": "string | ((state: RadioGroupState) => string | undefined)",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the element, or a function that\nreturns a class based on the component's state."+ },+ {+ "name": "defaultValue",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "The uncontrolled value of the radio button that should be initially selected.\n\nTo render a controlled radio group, use the `value` prop instead."+ },+ {+ "name": "disabled",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Whether the component should ignore user interaction."+ },+ {+ "name": "form",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Identifies the form that owns the radio inputs.\nUseful when the radio group is rendered outside the form."+ },+ {+ "name": "inputRef",+ "type": "Ref<HTMLInputElement>",+ "required": false,+ "defaultValue": null,+ "description": "A ref to access the hidden input element."+ },+ {+ "name": "itemWidth",+ "type": "\"content\" | \"equal\"",+ "required": false,+ "defaultValue": "equal",+ "description": "Use equal-width options or size each option to its content."+ },+ {+ "name": "name",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Identifies the field when a form is submitted."+ },+ {+ "name": "onValueChange",+ "type": "((value: TValue, eventDetails: { reason: \"none\"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)",+ "required": false,+ "defaultValue": null,+ "description": "Callback fired when the value changes."+ },+ {+ "name": "options",+ "type": "readonly SegmentedControlOption<TValue>[]",+ "required": true,+ "defaultValue": null,+ "description": "Options with a unique string `value`, a `label` or `startIcon`, and optional `disabled`. Icon-only options require an `aria-label`."+ },+ {+ "name": "readOnly",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Whether the user should be unable to select a different radio button in the group."+ },+ {+ "name": "render",+ "type": "ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, RadioGroupState>",+ "required": false,+ "defaultValue": null,+ "description": "Allows you to replace the component's HTML element\nwith a different tag, or compose it with another component.\n\nAccepts a `ReactElement` or a function that returns the element to render."+ },+ {+ "name": "required",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Whether the user must choose a value before submitting a form."+ },+ {+ "name": "style",+ "type": "CSSProperties | ((state: RadioGroupState) => CSSProperties | undefined)",+ "required": false,+ "defaultValue": null,+ "description": "Style applied to the element, or a function that\nreturns a style object based on the component's state."+ },+ {+ "name": "value",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "The controlled value of the radio item that should be currently selected.\n\nTo render an uncontrolled radio group, use the `defaultValue` prop instead."+ }+ ]+ },+ {+ "name": "AnimatedExpandableContainer",+ "entryPoint": "twenty-ui/primitives/layout",+ "slug": "layout/animated-expandable-container",+ "props": [+ {+ "name": "animationDurations",+ "type": "AnimationDurations",+ "required": false,+ "defaultValue": "default",+ "description": "Default theme timing or separate opacity and size durations in seconds."+ },+ {+ "name": "children",+ "type": "ReactNode",+ "required": true,+ "defaultValue": null,+ "description": "Content inside the expanding panel."+ },+ {+ "name": "containAnimation",+ "type": "boolean",+ "required": false,+ "defaultValue": "true",+ "description": "Clips overflowing content during expansion and uses a column layout."+ },+ {+ "name": "dimension",+ "type": "\"height\" | \"width\"",+ "required": false,+ "defaultValue": "height",+ "description": "Dimension animated when the panel opens and closes."+ },+ {+ "name": "duration",+ "type": "\"fast\" | \"instant\" | \"normal\" | \"slow\"",+ "required": false,+ "defaultValue": null,+ "description": "Theme timing preset for both opacity and size. Explicit `animationDurations` take precedence."+ },+ {+ "name": "initial",+ "type": "boolean",+ "required": false,+ "defaultValue": null,+ "description": "Compatibility prop accepted by the type but not used by the current implementation."+ },+ {+ "name": "isExpanded",+ "type": "boolean",+ "required": true,+ "defaultValue": null,+ "description": "Controlled visibility of the panel. The application owns the trigger and state."+ },+ {+ "name": "mode",+ "type": "\"fit-content\" | \"scroll-height\"",+ "required": false,+ "defaultValue": null,+ "description": "Compatibility prop accepted by the type but not used by the current implementation."+ }+ ]+ },+ {+ "name": "HorizontalSeparator",+ "entryPoint": "twenty-ui/primitives/layout",+ "slug": "layout/horizontal-separator",+ "props": [+ {+ "name": "color",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS line color. Defaults to the medium border color."+ },+ {+ "name": "noMargin",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Removes the vertical margins."+ },+ {+ "name": "text",+ "type": "string",+ "required": false,+ "defaultValue": "",+ "description": "Optional label displayed between two lines."+ },+ {+ "name": "visible",+ "type": "boolean",+ "required": false,+ "defaultValue": "true",+ "description": "Shows the dividing line. Setting it to false preserves margins and any text."+ }+ ]+ },+ {+ "name": "ResizeHandle",+ "entryPoint": "twenty-ui/primitives/layout",+ "slug": "layout/resize-handle",+ "props": [+ {+ "name": "axis",+ "type": "\"x\" | \"y\"",+ "required": false,+ "defaultValue": "y",+ "description": "Pointer movement axis: `y` for height or `x` for width."+ },+ {+ "name": "defaultValue",+ "type": "number | (readonly string[] & number)",+ "required": false,+ "defaultValue": "150",+ "description": "Initial size when the handle owns its state."+ },+ {+ "name": "disabled",+ "type": "boolean",+ "required": false,+ "defaultValue": "false",+ "description": "Disables resizing and removes the handle from the tab order."+ },+ {+ "name": "max",+ "type": "number",+ "required": false,+ "defaultValue": "500",+ "description": "Maximum allowed size."+ },+ {+ "name": "min",+ "type": "number",+ "required": false,+ "defaultValue": "50",+ "description": "Minimum allowed size."+ },+ {+ "name": "onValueChange",+ "type": "((value: number) => void)",+ "required": false,+ "defaultValue": null,+ "description": "Called with the bounded size after pointer or keyboard interaction."+ },+ {+ "name": "render",+ "type": "ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>",+ "required": false,+ "defaultValue": null,+ "description": "Allows you to replace the component's HTML element\nwith a different tag, or compose it with another component.\n\nAccepts a `ReactElement` or a function that returns the element to render."+ },+ {+ "name": "step",+ "type": "number",+ "required": false,+ "defaultValue": "10",+ "description": "Keyboard arrow increment. Pointer movement uses the pixel delta."+ },+ {+ "name": "value",+ "type": "number",+ "required": false,+ "defaultValue": null,+ "description": "Controlled size. Apply the value to the element being resized."+ }+ ]+ },+ {+ "name": "TextDirectionProvider",+ "entryPoint": "twenty-ui/primitives/layout",+ "slug": "layout/text-direction-provider",+ "props": [+ {+ "name": "children",+ "type": "ReactNode",+ "required": true,+ "defaultValue": null,+ "description": "Controls that receive the direction context."+ },+ {+ "name": "direction",+ "type": "\"ltr\" | \"rtl\"",+ "required": true,+ "defaultValue": null,+ "description": "Reading direction used by directional interactions. Also set the matching HTML `dir` attribute on the content."+ }+ ]+ },+ {+ "name": "ClickToActionLink",+ "entryPoint": "twenty-ui/primitives/navigation",+ "slug": "navigation/click-to-action-link",+ "props": [+ {+ "name": "children",+ "type": "ReactNode",+ "required": false,+ "defaultValue": null,+ "description": "Visible link text or content. Use a descriptive destination label."+ },+ {+ "name": "className",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "CSS class applied to the anchor."+ },+ {+ "name": "href",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Destination URL for native link navigation."+ },+ {+ "name": "onClick",+ "type": "MouseEventHandler<HTMLAnchorElement>",+ "required": false,+ "defaultValue": null,+ "description": "Click handler called when the link is activated."+ },+ {+ "name": "rel",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Relationship to the destination, such as `noopener noreferrer` for a new tab."+ },+ {+ "name": "target",+ "type": "HTMLAttributeAnchorTarget",+ "required": false,+ "defaultValue": null,+ "description": "Browsing context in which to open the destination."+ }+ ]+ },+ {+ "name": "OverflowingTextWithTooltip",+ "entryPoint": "twenty-ui/primitives/typography",+ "slug": "typography/overflowing-text-with-tooltip",+ "props": [+ {+ "name": "alwaysShowTooltip",+ "type": "boolean",+ "required": false,+ "defaultValue": null,+ "description": "Allows the tooltip even when the text is not truncated."+ },+ {+ "name": "displayedMaxRows",+ "type": "number",+ "required": false,+ "defaultValue": null,+ "description": "Maximum displayed rows. Omit for single-line truncation; use a positive integer for multiline text."+ },+ {+ "name": "isFocusable",+ "type": "boolean",+ "required": false,+ "defaultValue": null,+ "description": "Adds a tab stop and opens the tooltip on focus or click."+ },+ {+ "name": "isTooltipMultiline",+ "type": "boolean",+ "required": false,+ "defaultValue": null,+ "description": "Preserves whitespace and line breaks in the tooltip."+ },+ {+ "name": "size",+ "type": "\"large\" | \"small\"",+ "required": false,+ "defaultValue": null,+ "description": "Small inherited text sizing or the large fixed-height treatment."+ },+ {+ "name": "text",+ "type": "string | number | bigint | boolean | ReactElement<unknown, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | Promise<...> | null | undefined",+ "required": true,+ "defaultValue": null,+ "description": "Text or React content to truncate. Non-string React content requires `tooltipContent`."+ },+ {+ "name": "tooltipContent",+ "type": "string",+ "required": false,+ "defaultValue": null,+ "description": "Plain text displayed in the tooltip. Defaults to `text` when it is a nonempty string."+ },+ {+ "name": "tooltipDelay",+ "type": "number",+ "required": false,+ "defaultValue": null,+ "description": "Hover delay in milliseconds."+ },+ {+ "name": "tooltipPlace",+ "type": "\"bottom\" | \"left\" | \"right\" | \"top\"",+ "required": false,+ "defaultValue": null,+ "description": "Preferred side of the tooltip."+ }+ ]+ },{"name": "LightIconButton","entryPoint": "twenty-ui/components",