Skip to content

Commit

Permalink
docs: generate sandbox
Browse files Browse the repository at this point in the history
  • Loading branch information
marcelovicentegc committed Nov 23, 2023
1 parent 6674dda commit b097948
Show file tree
Hide file tree
Showing 194 changed files with 1,636 additions and 2,657 deletions.
3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
"build:storybook": "pnpm build && pnpm storybook build",
"chromatic": "chromatic --exit-zero-on-changes --build-script-name=build:storybook",
"docs": "npm --prefix packages/admin-ui-docs run start",
"generate-docs": "typedoc --plugin typedoc-plugin-markdown --hideBreadcrumbs && node scripts/typedoc-to-nextra.js",
"generate-docs": "typedoc --plugin typedoc-plugin-markdown --hideBreadcrumbs --hideInPageTOC --plugin typedoc-plugin-mdn-links && node scripts/typedoc-to-nextra.js",
"next-docs": "npm --prefix packages/next-docs run dev",
"build:docs": "npm --prefix packages/admin-ui-docs run build-docs",
"build:next-docs": "npm --prefix packages/next-docs run build-docs",
Expand Down Expand Up @@ -132,6 +132,7 @@
"turbo": "1.4.3",
"typedoc": "^0.25.3",
"typedoc-plugin-markdown": "^3.17.1",
"typedoc-plugin-mdn-links": "^3.1.4",
"typescript": "4.9.5",
"url-loader": "^4.1.0",
"vite": "4.3.9",
Expand Down
2 changes: 1 addition & 1 deletion packages/components/src/button/button.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ export interface ButtonProps extends ComponentPropsWithoutRef<'button'> {
children: ReactNode
/**
* Increase or decrease padding.
* @default normal
* @default 'normal'
*/
size?: 'normal' | 'large'
/**
Expand Down
1 change: 1 addition & 0 deletions packages/next-docs/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
"@vtex/shoreline-preset-admin": "workspace:*",
"@vtex/shoreline-icons": "workspace:*",
"@vtex/shoreline-utils": "workspace:*",
"@vtex/shoreline-components": "workspace:*",
"next": "13.4.7",
"nextra": "2.10.0",
"nextra-theme-docs": "2.10.0",
Expand Down
1 change: 0 additions & 1 deletion packages/next-docs/pages/components/_meta.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
{
"interfaces": "Interfaces",
"action": "Action",
"alert": "Alert",
"bleed": "Bleed",
Expand Down
31 changes: 27 additions & 4 deletions packages/next-docs/pages/components/action/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,43 @@ Specific button used for contextual actions

#### Parameters

| Name | Type |
| :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `props` | `Omit`\<[`ButtonProps`](interfaces/ButtonProps.md), `"variant"`\> & \{ `iconOnly?`: `boolean` ; `label?`: `ReactNode` ; `vertical?`: `boolean` } & `RefAttributes`\<`HTMLButtonElement`\> |
| Name | Type |
| :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `props` | [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)\<[`ButtonProps`](interfaces/ButtonProps.md), `"variant"`\> & \{ `iconOnly?`: `boolean` ; `label?`: `ReactNode` ; `vertical?`: `boolean` } & `RefAttributes`\<[`HTMLButtonElement`](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement)\> |

#### Returns

`null` \| `ReactElement`\<`any`, `string` \| `JSXElementConstructor`\<`any`\>\>

**`Example`**

```ts
```tsx copy showLineNumbers filename="example.tsx
<Action>Label</Action>
```

import {
SandpackProvider,
SandpackLayout,
SandpackCodeEditor,
SandpackPreview,
} from '@codesandbox/sandpack-react'

<SandpackProvider
template="react"
customSetup={{ dependencies: { '@vtex/shoreline-components': '^0.21.0' } }}
files={{'/App.js': `import React from 'react'
import { Action } from '@vtex/shoreline-components'
export default function App() { return (<><Action>Label</Action></>)}`,
}}

> <SandpackLayout>

<SandpackCodeEditor />
<SandpackPreview />

</SandpackLayout>
</SandpackProvider>

#### Defined in

node_modules/.pnpm/@types[email protected]/node_modules/@types/react/ts5.0/index.d.ts:355
82 changes: 82 additions & 0 deletions packages/next-docs/pages/components/action/props.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# shoreline

## Interfaces

- [AccessibleIconProps](interfaces/AccessibleIconProps.md)
- [AlertProps](interfaces/AlertProps.md)
- [BleedProps](interfaces/BleedProps.md)
- [ButtonProps](interfaces/ButtonProps.md)
- [CheckboxFieldProps](interfaces/CheckboxFieldProps.md)
- [CheckboxGroupProps](interfaces/CheckboxGroupProps.md)
- [CheckboxProps](interfaces/CheckboxProps.md)
- [ClickableBubbleProps](interfaces/ClickableBubbleProps.md)
- [ClickableProps](interfaces/ClickableProps.md)
- [ComboboxItemProps](interfaces/ComboboxItemProps.md)
- [ComboboxListProps](interfaces/ComboboxListProps.md)
- [ComboboxPopoverProps](interfaces/ComboboxPopoverProps.md)
- [ComboboxProps](interfaces/ComboboxProps.md)
- [ComposableProps](interfaces/ComposableProps.md)
- [ComposeProps](interfaces/ComposeProps.md)
- [ContainerProps](interfaces/ContainerProps.md)
- [ContentProps](interfaces/ContentProps.md)
- [FieldLabelProps](interfaces/FieldLabelProps.md)
- [FieldMessageProps](interfaces/FieldMessageProps.md)
- [FieldProps](interfaces/FieldProps.md)
- [FilterPopoverProps](interfaces/FilterPopoverProps.md)
- [FilterProps](interfaces/FilterProps.md)
- [FilterProviderProps](interfaces/FilterProviderProps.md)
- [GridCellShorthandProps](interfaces/GridCellShorthandProps.md)
- [GridShorthandProps](interfaces/GridShorthandProps.md)
- [IconButtonProps](interfaces/IconButtonProps.md)
- [LinkBoxProps](interfaces/LinkBoxProps.md)
- [LinkProps](interfaces/LinkProps.md)
- [LocaleProviderProps](interfaces/LocaleProviderProps.md)
- [MenuItemProps](interfaces/MenuItemProps.md)
- [MenuProps](interfaces/MenuProps.md)
- [ModalProps](interfaces/ModalProps.md)
- [PaginationProps](interfaces/PaginationProps.md)
- [PopoverDismissProps](interfaces/PopoverDismissProps.md)
- [PopoverProps](interfaces/PopoverProps.md)
- [PopoverTriggerProps](interfaces/PopoverTriggerProps.md)
- [RadioGroupProps](interfaces/RadioGroupProps.md)
- [RadioGroupState](interfaces/RadioGroupState.md)
- [RadioProps](interfaces/RadioProps.md)
- [ScrollAreaProps](interfaces/ScrollAreaProps.md)
- [SearchProps](interfaces/SearchProps.md)
- [SelectFieldProps](interfaces/SelectFieldProps.md)
- [SelectListProps](interfaces/SelectListProps.md)
- [SelectOptionCheckProps](interfaces/SelectOptionCheckProps.md)
- [SelectOptionProps](interfaces/SelectOptionProps.md)
- [SelectPopoverProps](interfaces/SelectPopoverProps.md)
- [SelectProps](interfaces/SelectProps.md)
- [SimpleTableProps](interfaces/SimpleTableProps.md)
- [SkeletonProps](interfaces/SkeletonProps.md)
- [SpinnerProps](interfaces/SpinnerProps.md)
- [StackProps](interfaces/StackProps.md)
- [TabListProps](interfaces/TabListProps.md)
- [TabPanelProps](interfaces/TabPanelProps.md)
- [TabProps](interfaces/TabProps.md)
- [TableBodyProps](interfaces/TableBodyProps.md)
- [TableCellProps](interfaces/TableCellProps.md)
- [TableHeaderCellProps](interfaces/TableHeaderCellProps.md)
- [TableHeaderProps](interfaces/TableHeaderProps.md)
- [TableProps](interfaces/TableProps.md)
- [TableRowProps](interfaces/TableRowProps.md)
- [TagProps](interfaces/TagProps.md)
- [TextInputProps](interfaces/TextInputProps.md)
- [TextareaProps](interfaces/TextareaProps.md)
- [TooltipAnchorProps](interfaces/TooltipAnchorProps.md)
- [TooltipArrowProps](interfaces/TooltipArrowProps.md)
- [TooltipPopoverProps](interfaces/TooltipPopoverProps.md)
- [TooltipProps](interfaces/TooltipProps.md)
- [VisuallyHiddenProps](interfaces/VisuallyHiddenProps.md)

## Type Aliases

### ActionProps

Ƭ **ActionProps**: [`Omit`](https://www.typescriptlang.org/docs/handbook/utility-types.html#omittype-keys)\<[`ButtonProps`](interfaces/ButtonProps.md), `"variant"`\> & \{ `iconOnly?`: `boolean` ; `label?`: `ReactNode` ; `vertical?`: `boolean` }

#### Defined in

[packages/components/src/action/action.tsx:34](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/action/action.tsx#L34)
33 changes: 29 additions & 4 deletions packages/next-docs/pages/components/alert/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,48 @@ Alert indicators allow users to view semantic messages that are prominent and ca

#### Parameters

| Name | Type |
| :------ | :----------------------------------------------------------------------------- |
| `props` | [`AlertProps`](interfaces/AlertProps.md) & `RefAttributes`\<`HTMLDivElement`\> |
| Name | Type |
| :------ | :-------------------------------------------------------------------------------------------------------------------------- |
| `props` | [`AlertProps`](props.md) & `RefAttributes`\<[`HTMLDivElement`](https://developer.mozilla.org/docs/Web/API/HTMLDivElement)\> |

#### Returns

`null` \| `ReactElement`\<`any`, `string` \| `JSXElementConstructor`\<`any`\>\>

**`Example`**

```ts
```tsx copy showLineNumbers filename="example.tsx
<Alert onDismiss={() => {}}>
<Text>Message</Text>
<Action>Action</Action>
</Alert>
```

import {
SandpackProvider,
SandpackLayout,
SandpackCodeEditor,
SandpackPreview,
} from '@codesandbox/sandpack-react'

<SandpackProvider
template="react"
customSetup={{ dependencies: { '@vtex/shoreline-components': '^0.21.0' } }}
files={{'/App.js': `import React from 'react'
import { Alert } from '@vtex/shoreline-components'
import { Text } from '@vtex/shoreline-components'
import { Action } from '@vtex/shoreline-components'
export default function App() { return (<><Alert onDismiss={() => {}}> <Text>Message</Text> <Action>Action</Action></Alert></>)}`,
}}

> <SandpackLayout>

<SandpackCodeEditor />
<SandpackPreview />

</SandpackLayout>
</SandpackProvider>

#### Defined in

node_modules/.pnpm/@types[email protected]/node_modules/@types/react/ts5.0/index.d.ts:355
13 changes: 3 additions & 10 deletions packages/next-docs/pages/components/alert/props.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,15 @@

**`AlertProps`**

## Table of contents

### Properties

- [onDismiss](props.md#ondismiss)
- [variant](props.md#variant)

## Properties

### onDismiss

`Optional` **onDismiss**: `MouseEventHandler`\<`HTMLButtonElement`\>
`Optional` **onDismiss**: `MouseEventHandler`\<[`HTMLButtonElement`](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement)\>

#### Defined in

[packages/components/src/alert/alert.tsx:74](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/alert/alert.tsx#L74)
[packages/components/src/alert/alert.tsx:74](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/alert/alert.tsx#L74)

---

Expand All @@ -31,4 +24,4 @@

#### Defined in

[packages/components/src/alert/alert.tsx:73](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/alert/alert.tsx#L73)
[packages/components/src/alert/alert.tsx:73](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/alert/alert.tsx#L73)
6 changes: 3 additions & 3 deletions packages/next-docs/pages/components/bleed/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@

#### Parameters

| Name | Type |
| :------ | :----------------------------------------------------------------------------- |
| `props` | [`BleedProps`](interfaces/BleedProps.md) & `RefAttributes`\<`HTMLDivElement`\> |
| Name | Type |
| :------ | :-------------------------------------------------------------------------------------------------------------------------- |
| `props` | [`BleedProps`](props.md) & `RefAttributes`\<[`HTMLDivElement`](https://developer.mozilla.org/docs/Web/API/HTMLDivElement)\> |

#### Returns

Expand Down
23 changes: 6 additions & 17 deletions packages/next-docs/pages/components/bleed/props.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,6 @@

**`BleedProps`**

## Table of contents

### Properties

- [bottom](props.md#bottom)
- [horizontal](props.md#horizontal)
- [left](props.md#left)
- [right](props.md#right)
- [top](props.md#top)
- [vertical](props.md#vertical)

## Properties

### bottom
Expand All @@ -33,7 +22,7 @@ Bottom bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:68](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L68)
[packages/components/src/bleed/bleed.tsx:68](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L68)

---

Expand All @@ -51,7 +40,7 @@ Horizontal bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:83](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L83)
[packages/components/src/bleed/bleed.tsx:83](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L83)

---

Expand All @@ -69,7 +58,7 @@ Left bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:73](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L73)
[packages/components/src/bleed/bleed.tsx:73](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L73)

---

Expand All @@ -87,7 +76,7 @@ Right bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:78](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L78)
[packages/components/src/bleed/bleed.tsx:78](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L78)

---

Expand All @@ -105,7 +94,7 @@ Top bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:63](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L63)
[packages/components/src/bleed/bleed.tsx:63](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L63)

---

Expand All @@ -123,4 +112,4 @@ Vertical bleed

#### Defined in

[packages/components/src/bleed/bleed.tsx:88](https://github.com/vtex/shoreline/blob/9cdfd7505/packages/components/src/bleed/bleed.tsx#L88)
[packages/components/src/bleed/bleed.tsx:88](https://github.com/vtex/shoreline/blob/6674ddada/packages/components/src/bleed/bleed.tsx#L88)
31 changes: 27 additions & 4 deletions packages/next-docs/pages/components/button/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,43 @@ Buttons triggers allow users to identify and start the most important actions in

#### Parameters

| Name | Type |
| :------ | :---------------------------------------------------------------------------------- |
| `props` | [`ButtonProps`](interfaces/ButtonProps.md) & `RefAttributes`\<`HTMLButtonElement`\> |
| Name | Type |
| :------ | :--------------------------------------------------------------------------------------------------------------------------------- |
| `props` | [`ButtonProps`](props.md) & `RefAttributes`\<[`HTMLButtonElement`](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement)\> |

#### Returns

`null` \| `ReactElement`\<`any`, `string` \| `JSXElementConstructor`\<`any`\>\>

**`Example`**

```ts
```tsx copy showLineNumbers filename="example.tsx
<Button>Action label</Button>
```

import {
SandpackProvider,
SandpackLayout,
SandpackCodeEditor,
SandpackPreview,
} from '@codesandbox/sandpack-react'

<SandpackProvider
template="react"
customSetup={{ dependencies: { '@vtex/shoreline-components': '^0.21.0' } }}
files={{'/App.js': `import React from 'react'
import { Button } from '@vtex/shoreline-components'
export default function App() { return (<><Button>Action label</Button></>)}`,
}}

> <SandpackLayout>

<SandpackCodeEditor />
<SandpackPreview />

</SandpackLayout>
</SandpackProvider>

#### Defined in

node_modules/.pnpm/@types[email protected]/node_modules/@types/react/ts5.0/index.d.ts:355
Loading

0 comments on commit b097948

Please sign in to comment.