@cube-dev/ui-kit 0.0.0-canary-306672a → 0.0.0-canary-827ee9f

package/docs/components/overlays/Dialog.md

@@ -24,8 +24,6 @@ Dialogs are windows containing contextual information, tasks, or workflows that
 - **`onDismiss`** `function` — Callback fired when the dialog is dismissed
 - **`closeIcon`** — Custom close icon element
 - **`role`** `'dialog' | 'alertdialog'` (default: `dialog`) — ARIA role for the dialog
-- **`onBlur`** `function` — Callback fired when the dialog loses focus
-- **`onFocus`** `function` — Callback fired when the dialog receives focus
 
 ### Base Properties
 

package/docs/components/overlays/DialogForm.md

@@ -23,23 +23,27 @@ DialogForm combines [Dialog](./Dialog.md) and [Form](../form/Form.md) functional
 - **`cancelProps`** `CubeButtonProps` — Properties for cancel button (use `label` to change text)
 - **`preserve`** `boolean` (default: `false`) — Preserve form values after submission/dismissal
 - **`noActions`** `boolean` — Hide default action buttons to manually specify them
-
-### DialogForm-specific Properties
-
-- **`title`** `string` — The title of the dialog
-- **`danger`** `boolean` — Whether the submit button has a danger theme
-- **`submitProps`** `CubeButtonProps` — Properties for submit button (use `label` to change text)
-- **`cancelProps`** `CubeButtonProps` — Properties for cancel button (use `label` to change text)
-- **`preserve`** `boolean` (default: `false`) — Preserve form values after submission/dismissal
-- **`noActions`** `boolean` — Hide default action buttons to manually specify them
-
-### Inherited Properties
-
-DialogForm inherits all properties from:
-- **[Dialog](./Dialog.md)**: `size`, `isDismissable`, `closeIcon`, styling properties, etc.
-- **[Form](../form/Form.md)**: `name`, `defaultValues`, `onSubmit`, `onSubmitFailed`, `onValuesChange`, `labelPosition`, `requiredMark`, validation properties, etc.
-
-See the respective component documentation for complete property lists.
+- **`size`** `'S' | 'M' | 'L' | 'small' | 'medium' | 'large'` — The size of the dialog
+- **`isDismissable`** `boolean` — Whether the dialog is dismissable
+- **`closeIcon`** `ReactElement` — Custom close icon element
+- **`closeButtonStyles`** `Styles` — Custom styles for the close button
+- **`name`** `string` — Form name
+- **`form`** `CubeFormInstance` — Form instance created by `useForm`
+- **`defaultValues`** `object` — Default field values
+- **`onSubmit`** `(data) => void | Promise` — Callback on form submit and success
+- **`onSubmitFailed`** `(error?) => void | Promise` — Callback on form submit and failure
+- **`onValuesChange`** `function` — Callback when any field value changes
+- **`orientation`** `'vertical' | 'horizontal'` — Layout orientation of the form
+- **`labelWidth`** `string` — The size of the side area with labels (only for `labelPosition="side"`)
+- **`labelPosition`** `'top' | 'side'` — Where to place labels relative to inputs
+- **`labelStyles`** `Styles` — Styles for the label
+- **`requiredMark`** `boolean` — Whether the field presents required mark
+- **`necessityIndicator`** `NecessityIndicator` — The type of necessity indicator
+- **`necessityLabel`** `ReactNode` — Custom necessity label
+- **`isReadOnly`** `boolean` — Whether the form is read only
+- **`validationState`** `ValidationState` — The validation state of the form
+- **`validateTrigger`** `ValidateTrigger` — On which event to perform validation
+- **`showValid`** `boolean` — Whether to show valid state
 
 ### Base Properties
 

package/docs/components/overlays/DialogTrigger.md

@@ -29,6 +29,8 @@ DialogTrigger serves as a wrapper around a Dialog and its associated trigger, li
 - **`crossOffset`** `number` (default: `0`) — The additional offset applied along the cross axis
 - **`containerPadding`** `number` (default: `12`) — The padding between the edge of the overlay and the boundary
 - **`shouldFlip`** `boolean` (default: `true`) — Whether the overlay should flip positions when insufficient space
+- **`shouldUpdatePosition`** `boolean` — Whether the overlay position should update on scroll or resize
+- **`hideOnClose`** `boolean` — Whether to hide the overlay instead of unmounting on close
 - **`onOpenChange`** `function` — Callback fired when the dialog open state changes
 - **`onDismiss`** `function` — Callback fired when the dialog is dismissed
 - **`targetRef`** — The ref of the element the Dialog should visually attach itself to

package/docs/components/overlays/Tooltip.md

@@ -22,107 +22,31 @@ This module exports three components that work together:
 
 The simplest way to add tooltips to your components. It combines `TooltipTrigger` and `Tooltip` for convenience.
 
----
-
-### Properties
-
-- **`title`** `ReactNode` — Content to display inside the tooltip
-- **`tooltipStyles`** `Styles` — Custom styles for the tooltip content container
-- **`width`** `string` — Width of the tooltip
-- **`placement`** `Placement` (default: `'top'`) — Position of the tooltip relative to its trigger. Options: `top`, `bottom`, `left`, `right`, `start`, `end`
-- **`delay`** `number` (default: `250`) — The delay time in ms for the tooltip to show up
-- **`closeDelay`** `number` (default: `500`) — The delay time in ms for the tooltip to close
-- **`offset`** `number` (default: `8`) — Distance between the tooltip and the trigger element
-- **`crossOffset`** `number` (default: `0`) — Cross-axis offset of the tooltip
-- **`isMaterial`** `boolean` — Enables material-style tooltip with auto pointer events
-- **`isLight`** `boolean` — Uses light color scheme for the tooltip
-- **`isDisabled`** `boolean` — Whether the tooltip is disabled
-- **`isOpen`** `boolean` — Controlled open state of the tooltip
-- **`defaultOpen`** `boolean` — Whether the tooltip is open by default (uncontrolled)
-- **`onOpenChange`** `(isOpen: boolean) => void` — Callback when the tooltip open state changes
-- **`trigger`** `'focus'` — When set, opens the tooltip only on focus instead of both focus and hover
-
-### Base Properties
-
-Supports [Base properties](../../BaseProperties.md)
-
-### Styling Properties
-
-#### tooltipStyles
+See TooltipProvider for full documentation.
 
-Customizes the tooltip content container.
-
-**Sub-elements:**
-- None (tooltip tip is styled via `tipStyles` prop on `Tooltip` component)
-
-### Style Properties
-
-These properties allow direct style application without using the `styles` prop: `width`.
-
-### Modifiers
+## TooltipTrigger
 
-The `mods` property on the tooltip accepts the following modifiers you can override:
+Lower-level component that wraps a trigger element and a `Tooltip`. Use this when you need more control over the tooltip content or behavior.
 
-- **`material`** `boolean` — Enables material-style tooltip with pointer events
-- **`light`** `boolean` — Uses light color scheme instead of dark
-- **`open`** `boolean` — Indicates whether the tooltip is currently visible
+See TooltipTrigger for full documentation.
 
-## TooltipTrigger
+## Tooltip
 
-Lower-level component that wraps a trigger element and a `Tooltip`. Use this when you need more control over the tooltip content or behavior.
+Display container for tooltip content. Has a directional arrow dependent on its placement. This component is typically used as a child of `TooltipTrigger` or automatically rendered by `TooltipProvider`.
 
 ---
 
 ### Properties
 
-- **`placement`** `Placement` (default: `'top'`) — Position of the tooltip relative to its trigger. Options: `top`, `bottom`, `left`, `right`, `start`, `end`
-- **`delay`** `number` (default: `250`) — The delay time in ms for the tooltip to show up
-- **`closeDelay`** `number` (default: `500`) — The delay time in ms for the tooltip to close
-- **`offset`** `number` (default: `8`) — Distance between the tooltip and the trigger element
-- **`crossOffset`** `number` (default: `0`) — Cross-axis offset of the tooltip
+- **`tipStyles`** `Styles` — Custom styles for the tooltip arrow (tip) element
+- **`showIcon`** `boolean` — Controls whether an icon should be displayed in the tooltip
+- **`placement`** `PlacementAxis` (default: `'top'`) — Position of the tooltip relative to its trigger. Options: `top`, `bottom`, `left`, `right`
 - **`isMaterial`** `boolean` — Enables material-style tooltip with auto pointer events
 - **`isLight`** `boolean` — Uses light color scheme for the tooltip
-- **`isDisabled`** `boolean` — Whether the tooltip is disabled
 - **`isOpen`** `boolean` — Controlled open state of the tooltip
 - **`defaultOpen`** `boolean` — Whether the tooltip is open by default (uncontrolled)
 - **`onOpenChange`** `(isOpen: boolean) => void` — Callback when the tooltip open state changes
-- **`trigger`** `'focus'` — When set, opens the tooltip only on focus instead of both focus and hover
-- **`activeWrap`** `boolean` — *(deprecated)* Whether the trigger should have an ActiveZone wrap. Use function-as-first-child pattern instead.
-- **`targetRef`** `RefObject<HTMLElement>` — External ref to use for the trigger element
-
-### Base Properties
-
-Supports [Base properties](../../BaseProperties.md)
-
-## Tooltip
-
-Display container for tooltip content. Has a directional arrow dependent on its placement. This component is typically used as a child of `TooltipTrigger` or automatically rendered by `TooltipProvider`.
-
-### Properties
-
-#### tipStyles
-
-Customizes the tooltip arrow (tip) element.
-
-#### showIcon
-
-`boolean` - Controls whether an icon should be displayed in the tooltip.
-
-#### placement
-
-`PlacementAxis` - Controls the position of the tooltip relative to its trigger. Options: `top`, `bottom`, `left`, `right`.
-
-#### isMaterial
-
-`boolean` - Enables material-style tooltip with auto pointer events.
-
-#### isLight
-
-`boolean` - Uses light color scheme for the tooltip.
-
-#### width
-
-Specifies the width of the tooltip.
+- **`shouldFlip`** `boolean` — Whether the tooltip should flip position when there is insufficient space
 
 ### Base Properties
 
@@ -137,6 +61,14 @@ Customizes the root element of the tooltip.
 **Sub-elements:**
 - None
 
+### Modifiers
+
+The `mods` property on the tooltip accepts the following modifiers you can override:
+
+- **`material`** `boolean` — Enables material-style tooltip with pointer events
+- **`light`** `boolean` — Uses light color scheme instead of dark
+- **`open`** `boolean` — Indicates whether the tooltip is currently visible
+
 ## Usage Patterns
 
 ### Standard Pattern (Active Elements)

package/docs/components/overlays/TooltipProvider.md

@@ -11,11 +11,20 @@ A convenience wrapper that combines `TooltipTrigger` and `Tooltip` into a single
 ## Properties
 
 - **`title`** `ReactNode` — Tooltip content
-- **`tooltipStyles`** `Styles` — Custom styles for the tooltip
+- **`tooltipStyles`** `Styles` — Custom styles for the tooltip container
 - **`width`** `string` — Tooltip width
-- **`isDisabled`** `boolean` — Disable the tooltip
-
-Inherits all TooltipTrigger properties: `placement`, `offset`, `crossOffset`, `delay`, etc.
+- **`placement`** `Placement` (default: `'top'`) — Position of the tooltip relative to its trigger
+- **`offset`** `number` (default: `8`) — Distance between the tooltip and the trigger element
+- **`crossOffset`** `number` (default: `0`) — Cross-axis offset of the tooltip
+- **`delay`** `number` (default: `250`) — The delay time in ms for the tooltip to show up
+- **`closeDelay`** `number` (default: `500`) — The delay time in ms for the tooltip to close
+- **`isMaterial`** `boolean` — Enables material-style tooltip with auto pointer events
+- **`isLight`** `boolean` — Uses light color scheme for the tooltip
+- **`isOpen`** `boolean` — Controlled open state of the tooltip
+- **`defaultOpen`** `boolean` — Whether the tooltip is open by default (uncontrolled)
+- **`onOpenChange`** `(isOpen: boolean) => void` — Callback when the tooltip open state changes
+- **`trigger`** `'focus'` — When set, opens the tooltip only on focus instead of both focus and hover
+- **`shouldCloseOnPress`** `boolean` (default: `true`) — Whether the tooltip closes when the trigger is pressed
 
 ### Base Properties
 

package/docs/components/overlays/TooltipTrigger.md

@@ -14,12 +14,15 @@ Lower-level component that wraps a trigger element and a `Tooltip`. Use when you
 - **`offset`** `number` (default: `8`) — Distance from trigger in pixels
 - **`crossOffset`** `number` (default: `0`) — Cross-axis offset in pixels
 - **`delay`** `number` (default: `250`) — Show delay in milliseconds
+- **`closeDelay`** `number` (default: `500`) — Close delay in milliseconds
 - **`isMaterial`** `boolean` — Material design style tooltip
 - **`isLight`** `boolean` — Light theme tooltip
 - **`isDisabled`** `boolean` — Disable the tooltip
 - **`isOpen`** `boolean` — Controlled open state
 - **`defaultOpen`** `boolean` — Initially open (uncontrolled)
 - **`onOpenChange`** `(isOpen: boolean) => void` — Callback when open state changes
+- **`trigger`** `'focus'` — When set, opens the tooltip only on focus instead of both focus and hover
+- **`shouldCloseOnPress`** `boolean` (default: `true`) — Whether the tooltip closes when the trigger is pressed
 
 ### Base Properties
 

package/docs/components/portal/Portal.md

@@ -14,6 +14,10 @@ Renders children outside the current DOM hierarchy using React portals. By defau
 - **`isDisabled`** `boolean` (default: `false`) — Disable portaling and render inline
 - **`onMount`** `() => void` — Callback when portal mounts
 
+### Base Properties
+
+Supports [Base properties](../../BaseProperties.md).
+
 ## Examples
 
 ```jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-306672a",
+  "version": "0.0.0-canary-827ee9f",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -50,7 +50,8 @@
     "prepack": "node scripts/prepare-docs.mjs",
     "postpack": "node scripts/cleanup-docs.mjs",
     "release": "pnpm build && changeset publish --provenance",
-    "add-icons": "cd src/icons && node add-new-icon.js && pnpm fix"
+    "add-icons": "cd src/icons && node add-new-icon.js && pnpm fix",
+    "audit-docs": "node scripts/audit-docs.mjs"
   },
   "keywords": [
     "uikit"