@sanity-labs/ui-poc 0.0.1-alpha.14 → 0.0.1-alpha.15

package/README.md

@@ -0,0 +1,151 @@
+# Sanity UI 4
+
+The next version of Sanity's component library. Faster, simpler, and built on CSS instead of styled-components.
+
+## What's different from v3
+
+- **CSS classes instead of styled-components.** No runtime style generation. Smaller bundles, faster renders.
+- **Direct props for layout.** Width, height, position, border, and overflow are first-class props — no more `style={{ ... }}` escape hatches.
+- **Works alongside v3.** Install both packages in the same app. No forced migration.
+
+## Install
+
+```sh
+pnpm add @sanity-labs/ui-poc
+```
+
+Requires React 19.2+ and Node >=20.19 <22 || >=22.12.
+
+## Setup
+
+Import the stylesheet at your app entry point. Without it, components render as unstyled HTML with no error.
+
+```tsx
+import '@sanity-labs/ui-poc/styles.css'
+```
+
+If your app uses Sanity UI v3, keep the existing `ThemeProvider` setup.
+
+```tsx
+import {ThemeProvider, studioTheme, ToastProvider} from '@sanity/ui'
+import '@sanity-labs/ui-poc/styles.css'
+import App from './App'
+
+createRoot(document.getElementById('root')!).render(
+  <ThemeProvider theme={studioTheme}>
+    <ToastProvider>
+      <App />
+    </ToastProvider>
+  </ThemeProvider>,
+)
+```
+
+## Usage
+
+Import from `@sanity-labs/ui-poc`. Components not yet in v4 — Menu, Dialog, TextInput, Badge — remain in `@sanity/ui`.
+
+```tsx
+import {Box, Flex, Card, Heading, Text, Button} from '@sanity-labs/ui-poc'
+import {AddIcon} from '@sanity/icons'
+
+export default function App() {
+  return (
+    <Flex minHeight="100vh">
+      <Box as="nav" aria-label="Main" padding={3} borderRight width="240px">
+        <Heading as="h2" size={1}>
+          My App
+        </Heading>
+      </Box>
+      <Box as="main" padding={4} flexGrow={1}>
+        <Flex alignItems="center" justifyContent="space-between" flexWrap="wrap" gap={2}>
+          <Heading as="h1" size={2}>
+            Documents
+          </Heading>
+          <Button iconStart={AddIcon} text="New" />
+        </Flex>
+        <Box marginTop={3}>
+          <Card density="loose">
+            <Text size={1}>First document</Text>
+            <Text size={1} muted>
+              Edited 2 hours ago
+            </Text>
+          </Card>
+        </Box>
+      </Box>
+    </Flex>
+  )
+}
+```
+
+## Components
+
+All components below are from `@sanity-labs/ui-poc`.
+
+### Layout
+
+| Component   | What it does                                                                        |
+| ----------- | ----------------------------------------------------------------------------------- |
+| `Box`       | General container. Padding, margin, border, overflow, and position as direct props. |
+| `Flex`      | Flexbox layout. `alignItems`, `justifyContent`, `flexDirection`, `gap`.             |
+| `Grid`      | CSS grid. Use `gridTemplateColumns` with a CSS string (e.g. `"repeat(3, 1fr)"`).    |
+| `Container` | Max-width content wrapper.                                                          |
+| `HStack`    | Horizontal stack. Accepts `gap` and `as` only — use `Flex` for alignment control.   |
+| `VStack`    | Vertical stack. Accepts `gap` and `as` only — use `Flex` for alignment control.     |
+| `Inline`    | Inline flow layout with wrapping and gap.                                           |
+
+### Typography
+
+| Component | What it does                                                            |
+| --------- | ----------------------------------------------------------------------- |
+| `Heading` | Semantic headings (`h1`–`h6`). Always set `as` to match the level.      |
+| `Text`    | Body copy, captions, labels. Props: `size`, `weight`, `muted`, `align`. |
+| `Label`   | Form input label. Use only with form elements.                          |
+| `Code`    | Inline or block code. Uses the system monospace font.                   |
+
+### Interactive
+
+| Component  | What it does                                                                                                             |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `Button`   | `level` (primary/secondary/tertiary), `tone` (neutral/critical), `iconStart`, `iconEnd`, `text`, `fullWidth`, `loading`. |
+| `Checkbox` | Controlled checkbox. Requires `label` (string).                                                                          |
+| `Radio`    | Controlled radio button.                                                                                                 |
+| `Switch`   | Toggle control. Requires `label` (string).                                                                               |
+| `Link`     | Anchor element styled as a link.                                                                                         |
+
+### Display
+
+| Component        | What it does                                                                                                         |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `Card`           | Raised surface with background and `tone`. Does not accept padding, margin, or layout props — wrap content in `Box`. |
+| `Divider`        | Horizontal rule between content sections.                                                                            |
+| `Icon`           | Renders a `@sanity/icons` icon component. Always set `aria-label` or `aria-hidden`.                                  |
+| `Indicator`      | Status dot with `tone`.                                                                                              |
+| `IndicatorGroup` | Grouped `Indicator` elements.                                                                                        |
+| `Spinner`        | Loading indicator.                                                                                                   |
+
+### Lists
+
+| Component | What it does                                        |
+| --------- | --------------------------------------------------- |
+| `List`    | Semantic list. Use `List.Item` and `List.ItemText`. |
+
+### Accessibility
+
+| Component        | What it does                                                                                     |
+| ---------------- | ------------------------------------------------------------------------------------------------ |
+| `SkipToContent`  | Visually hidden skip-nav link. Must be the first focusable element. Requires `hash` and `label`. |
+| `VisuallyHidden` | Hides content visually while keeping it in the accessibility tree.                               |
+
+### Still from `@sanity/ui`
+
+Menu, Dialog, TextInput, Select, Stack, Badge, ThemeProvider, ToastProvider, and other components not yet migrated to v4.
+
+## Contributing
+
+We welcome feedback and contributions. Start here:
+
+1. **Try the components** and report what breaks, what confuses, or what's missing.
+2. **Read the contribution model** — build a recipe with existing building block components, then propose graduating it.
+3. **Open a PR** following the branch naming and checklist in the developer contribution docs.
+
+During preview, the most useful contribution is using the components and telling us what happens.

package/dist/index.d.ts

@@ -322,10 +322,26 @@ declare interface HStackProps<T extends React.ElementType> extends Pick<GapProps
 }
 
 /** @public */
-export declare function Icon({icon: Component, size, ...props}: IconProps): JSX.Element
+export declare function Icon({size, ...props}: IconProps): JSX.Element
 
 declare const ICON_SIZE: readonly [0, 1, 2, 3, 4]
 
+/** @public */
+export declare function IconButton<T extends ElementType = 'button'>(
+  props: IconButtonProps<T> & Omit<ComponentPropsWithRef<T>, keyof IconButtonProps<T>>,
+): JSX.Element
+
+/** @public */
+declare interface IconButtonProps<T extends React_2.ElementType> extends Pick<
+  ButtonProps<T>,
+  'as' | 'density' | 'level' | 'loading' | 'tone'
+> {
+  /** Button label */
+  'aria-label': string
+  /** Icon */
+  'icon': React_2.ComponentType<SVGProps<SVGSVGElement>>
+}
+
 /** @public */
 declare interface IconProps
   extends ComponentProps<'svg'>, Pick<TypographyProps, 'muted'>, MarginProps, ToneProps {
@@ -343,17 +359,6 @@ export declare function Indicator<T extends ElementType = 'span'>({
   ...props
 }: IndicatorProps<T> & Omit<ComponentPropsWithRef<T>, keyof IndicatorProps<T>>): JSX.Element
 
-/** @public */
-export declare function IndicatorGroup<T extends ElementType = 'div'>(
-  props: IndicatorGroupProps<T> & Omit<ComponentPropsWithRef<T>, keyof IndicatorGroupProps<T>>,
-): JSX.Element
-
-/** @public */
-declare interface IndicatorGroupProps<T extends React.ElementType> {
-  /** Element to render */
-  as?: T
-}
-
 /** @beta */
 declare interface IndicatorProps<T extends React.ElementType> extends ToneProps {
   /** Element to render */
@@ -362,6 +367,17 @@ declare interface IndicatorProps<T extends React.ElementType> extends ToneProps
   label?: string
 }
 
+/** @public */
+export declare function IndicatorStack<T extends ElementType = 'div'>(
+  props: IndicatorStackProps<T> & Omit<ComponentPropsWithRef<T>, keyof IndicatorStackProps<T>>,
+): JSX.Element
+
+/** @public */
+declare interface IndicatorStackProps<T extends React.ElementType> {
+  /** Element to render */
+  as?: T
+}
+
 /** @deprecated Use HStack component instead */
 /** @public */
 export declare function Inline<T extends ElementType = 'div'>(
@@ -535,6 +551,28 @@ declare interface PaddingProps {
   paddingLeft?: Responsive<Space>
 }
 
+declare const PLACEMENT: readonly [
+  'top',
+  'top-start',
+  'top-end',
+  'right',
+  'right-start',
+  'right-end',
+  'bottom',
+  'bottom-start',
+  'bottom-end',
+  'left',
+  'left-start',
+  'left-end',
+]
+
+declare type Placement = (typeof PLACEMENT)[number]
+
+declare type PlacementProps = {
+  /** Placement relative to anchor */
+  placement?: Placement
+}
+
 declare const POSITION: readonly ['absolute', 'fixed', 'relative', 'static', 'sticky']
 
 declare type Position = (typeof POSITION)[number]
@@ -591,9 +629,13 @@ declare type Responsive<T> =
       length: 6
     })
 
+declare const SHADOW: readonly [0, 1, 2, 3, 4, 5]
+
+declare type Shadow = (typeof SHADOW)[number]
+
 declare type ShadowProps = {
   /** CSS **box-shadow** property */
-  shadow?: string
+  shadow?: Shadow
 }
 
 /** @beta */
@@ -701,6 +743,28 @@ declare type ToneProps = {
   tone?: Tone
 }
 
+/** @public */
+export declare function Tooltip({placement, ...props}: TooltipProps): any
+
+/** @public */
+export declare function TooltipGroup<T extends ElementType = 'div'>(
+  props: TooltipGroupProps<T> & Omit<ComponentPropsWithRef<T>, keyof TooltipGroupProps<T>>,
+): JSX.Element
+
+/** @public */
+declare interface TooltipGroupProps<T extends React.ElementType> {
+  /** Element to render */
+  as?: T
+}
+
+/** @public */
+declare interface TooltipProps extends React.ComponentProps<'div'>, PlacementProps {
+  /** Tooltip text */
+  text?: React.ReactNode
+  /** Disabled state */
+  disabled?: boolean
+}
+
 declare interface TypographyProps extends MarginProps, ToneProps {
   /** CSS **text-align** property */
   align?: TextAlign