@cube-dev/ui-kit 0.0.0-canary-d688797 → 0.0.0-canary-bdfccbd

package/docs/components/overlays/UseDialogContainer.md

@@ -27,26 +27,20 @@ function useDialogContainer<P, E = ComponentProps<typeof DialogContainer>>(
 
 ## Parameters
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `Component` | `ComponentType<P>` | **Required.** A React component that represents the dialog content. Must accept props of type P. |
-| `defaultContainerProps` | `ComponentProps<typeof DialogContainer>` | **Optional.** Default props to pass to the DialogContainer wrapper. |
+- **`Component`** `ComponentType<P>` — **Required.** A React component that represents the dialog content. Must accept props of type P.
+- **`defaultContainerProps`** `ComponentProps<typeof DialogContainer>` — **Optional.** Default props to pass to the DialogContainer wrapper.
 
 ## Return Value
 
-| Property | Type | Description |
-|----------|------|-------------|
-| `open` | `(props: P, containerProps?: E) => void` | Function to open the dialog with provided component props and optional container props. |
-| `update` | `(props: P, containerProps?: E) => void` | Function to update dialog content while it's open. |
-| `close` | `() => void` | Function to close the dialog. |
-| `rendered` | `ReactElement \| null` | **Required.** JSX element that must be included in your component tree for the dialog to work. |
+- **`open`** `(props: P, containerProps?: E) => void` — Function to open the dialog with provided component props and optional container props.
+- **`update`** `(props: P, containerProps?: E) => void` — Function to update dialog content while it's open.
+- **`close`** `() => void` — Function to close the dialog.
+- **`rendered`** `ReactElement \| null` — **Required.** JSX element that must be included in your component tree for the dialog to work.
 
 ## Generic Type Parameters
 
-| Parameter | Description |
-|-----------|-------------|
-| `P` | The props type for your dialog component |
-| `E` | The container props type (defaults to `ComponentProps<typeof DialogContainer>`) |
+- **`P`** — The props type for your dialog component
+- **`E`** — The container props type (defaults to `ComponentProps<typeof DialogContainer>`)
 
 ## Examples
 

package/docs/components/portal/Portal.md

@@ -0,0 +1,29 @@
+# Portal
+
+Renders children outside the current DOM hierarchy using React portals. By default, portals mount under the `Root` component's portal container.
+
+## When to Use
+
+- Modals and overlays
+- Tooltips and popovers
+- Content that should escape parent overflow/stacking context
+
+## Properties
+
+- **`root`** `RefObject<HTMLElement>` — Custom mount target ref (default: Root's portal container)
+- **`isDisabled`** `boolean` (default: `false`) — Disable portaling and render inline
+- **`onMount`** `() => void` — Callback when portal mounts
+
+## Examples
+
+```jsx
+<Portal>
+  <div>Rendered outside parent DOM</div>
+</Portal>
+```
+
+```jsx
+<Portal isDisabled={typeof window === 'undefined'}>
+  <Modal>Content</Modal>
+</Portal>
+```

package/docs/components/status/LoadingAnimation.md

@@ -0,0 +1,27 @@
+# LoadingAnimation
+
+An animated loading indicator with a rotating cube graphic. Used for full-page or section loading states.
+
+## When to Use
+
+- Full-page loading
+- Section loading overlays
+- Branded loading experience
+
+## Properties
+
+- **`size`** `'small' | 'medium' | 'large' | number` (default: `'medium'`) — Animation size (small=32px, medium=64px, large=96px, or custom pixel value)
+
+### Base Properties
+
+Supports [Base properties](../../BaseProperties.md).
+
+## Examples
+
+```jsx
+<LoadingAnimation />
+
+<LoadingAnimation size="small" />
+
+<LoadingAnimation size="large" />
+```

package/docs/components/status/Spin.md

@@ -0,0 +1,35 @@
+# Spin
+
+A loading spinner wrapper. Shows a spinner overlay when `spinning` is true, otherwise renders children normally.
+
+## When to Use
+
+- Loading states for buttons or sections
+- Blocking content while data loads
+- Inline loading indicators
+
+## Properties
+
+- **`spinning`** `boolean` (default: `true`) — Whether to show the spinner
+- **`size`** `'small' | 'default' | 'large'` (default: `'default'`) — Spinner size (small=24px, default=32px, large=48px)
+- **`styles`** `Styles` — Custom styles for the spinner container
+
+### Base Properties
+
+Supports [Base properties](../../BaseProperties.md).
+
+## Examples
+
+```jsx
+<Spin>
+  <Button>Loading...</Button>
+</Spin>
+
+<Spin spinning={isLoading} size="large">
+  <Card>Content</Card>
+</Spin>
+
+<Spin spinning={false}>
+  <Text>Content is loaded</Text>
+</Spin>
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-d688797",
+  "version": "0.0.0-canary-bdfccbd",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {