@fpkit/acss 0.5.9 → 0.5.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +425 -18
- package/libs/chunk-23ANBDCR.js +8 -0
- package/libs/chunk-23ANBDCR.js.map +1 -0
- package/libs/chunk-5M57K4SW.js +8 -0
- package/libs/chunk-5M57K4SW.js.map +1 -0
- package/libs/chunk-5ZM4XL44.js +8 -0
- package/libs/chunk-5ZM4XL44.js.map +1 -0
- package/libs/chunk-6BVXFW7U.cjs +15 -0
- package/libs/chunk-6BVXFW7U.cjs.map +1 -0
- package/libs/chunk-6TE5QEVE.cjs +13 -0
- package/libs/chunk-6TE5QEVE.cjs.map +1 -0
- package/libs/chunk-7K76RW2A.cjs +18 -0
- package/libs/chunk-7K76RW2A.cjs.map +1 -0
- package/libs/chunk-BHRQBJRY.js +8 -0
- package/libs/chunk-BHRQBJRY.js.map +1 -0
- package/libs/chunk-BIP2NY53.js +8 -0
- package/libs/chunk-BIP2NY53.js.map +1 -0
- package/libs/chunk-BSPKFLO4.js +8 -0
- package/libs/chunk-BSPKFLO4.js.map +1 -0
- package/libs/chunk-BV5CLH44.cjs +18 -0
- package/libs/chunk-BV5CLH44.cjs.map +1 -0
- package/libs/chunk-DKGJHKGW.js +9 -0
- package/libs/chunk-DKGJHKGW.js.map +1 -0
- package/libs/chunk-DV56L5YX.cjs +18 -0
- package/libs/chunk-DV56L5YX.cjs.map +1 -0
- package/libs/chunk-E3XP6BEX.cjs +16 -0
- package/libs/chunk-E3XP6BEX.cjs.map +1 -0
- package/libs/chunk-ECLD37WN.cjs +16 -0
- package/libs/chunk-ECLD37WN.cjs.map +1 -0
- package/libs/chunk-EQ67LF46.js +9 -0
- package/libs/chunk-EQ67LF46.js.map +1 -0
- package/libs/chunk-G55UJ53G.cjs +16 -0
- package/libs/chunk-G55UJ53G.cjs.map +1 -0
- package/libs/chunk-HYBZBN4G.js +8 -0
- package/libs/chunk-HYBZBN4G.js.map +1 -0
- package/libs/chunk-ICCKQ2GC.cjs +15 -0
- package/libs/chunk-ICCKQ2GC.cjs.map +1 -0
- package/libs/chunk-IYUN2EW3.cjs +15 -0
- package/libs/chunk-IYUN2EW3.cjs.map +1 -0
- package/libs/chunk-KKLTUJFB.cjs +31 -0
- package/libs/chunk-KKLTUJFB.cjs.map +1 -0
- package/libs/chunk-LHVJKDMA.cjs +15 -0
- package/libs/chunk-LHVJKDMA.cjs.map +1 -0
- package/libs/chunk-LIQJ7ZZR.js +8 -0
- package/libs/chunk-LIQJ7ZZR.js.map +1 -0
- package/libs/chunk-LL7HTLMS.cjs +15 -0
- package/libs/chunk-LL7HTLMS.cjs.map +1 -0
- package/libs/chunk-LT5KZ2QW.cjs +22 -0
- package/libs/chunk-LT5KZ2QW.cjs.map +1 -0
- package/libs/chunk-M5QL5TAE.cjs +14 -0
- package/libs/chunk-M5QL5TAE.cjs.map +1 -0
- package/libs/chunk-NE6YXTMC.js +7 -0
- package/libs/chunk-NE6YXTMC.js.map +1 -0
- package/libs/chunk-NHYXGV3L.js +8 -0
- package/libs/chunk-NHYXGV3L.js.map +1 -0
- package/libs/chunk-O6QZBB6G.js +9 -0
- package/libs/chunk-O6QZBB6G.js.map +1 -0
- package/libs/chunk-P7TTEYCD.js +7 -0
- package/libs/chunk-P7TTEYCD.js.map +1 -0
- package/libs/chunk-PPOOBUOS.js +8 -0
- package/libs/chunk-PPOOBUOS.js.map +1 -0
- package/libs/chunk-QCMV4VQZ.js +8 -0
- package/libs/chunk-QCMV4VQZ.js.map +1 -0
- package/libs/chunk-QVV34QEH.cjs +32 -0
- package/libs/chunk-QVV34QEH.cjs.map +1 -0
- package/libs/chunk-S7BABR7Z.cjs +13 -0
- package/libs/chunk-S7BABR7Z.cjs.map +1 -0
- package/libs/chunk-SXVZSWX6.js +11 -0
- package/libs/chunk-SXVZSWX6.js.map +1 -0
- package/libs/chunk-X3EVB7VS.cjs +15 -0
- package/libs/chunk-X3EVB7VS.cjs.map +1 -0
- package/libs/chunk-YWOYVRFT.js +9 -0
- package/libs/chunk-YWOYVRFT.js.map +1 -0
- package/libs/component-props-a8a2f97e.d.ts +38 -0
- package/libs/components/breadcrumbs/breadcrumb.cjs +20 -0
- package/libs/components/breadcrumbs/breadcrumb.cjs.map +1 -0
- package/libs/components/breadcrumbs/breadcrumb.d.cts +51 -0
- package/libs/components/breadcrumbs/breadcrumb.d.ts +51 -0
- package/libs/components/breadcrumbs/breadcrumb.js +5 -0
- package/libs/components/breadcrumbs/breadcrumb.js.map +1 -0
- package/libs/components/button.cjs +19 -0
- package/libs/components/button.cjs.map +1 -0
- package/libs/components/button.d.cts +16 -0
- package/libs/components/button.d.ts +16 -0
- package/libs/components/button.js +4 -0
- package/libs/components/button.js.map +1 -0
- package/libs/components/card.cjs +31 -0
- package/libs/components/card.cjs.map +1 -0
- package/libs/components/card.d.cts +58 -0
- package/libs/components/card.d.ts +58 -0
- package/libs/components/card.js +4 -0
- package/libs/components/card.js.map +1 -0
- package/libs/components/details/details.css +1 -1
- package/libs/components/details/details.css.map +1 -1
- package/libs/components/details/details.min.css +2 -2
- package/libs/components/dialog/dialog.cjs +22 -0
- package/libs/components/dialog/dialog.cjs.map +1 -0
- package/libs/components/dialog/dialog.d.cts +51 -0
- package/libs/components/dialog/dialog.d.ts +51 -0
- package/libs/components/dialog/dialog.js +7 -0
- package/libs/components/dialog/dialog.js.map +1 -0
- package/libs/components/form/fields.cjs +19 -0
- package/libs/components/form/fields.cjs.map +1 -0
- package/libs/components/form/fields.d.cts +24 -0
- package/libs/components/form/fields.d.ts +24 -0
- package/libs/components/form/fields.js +4 -0
- package/libs/components/form/fields.js.map +1 -0
- package/libs/components/form/inputs.cjs +19 -0
- package/libs/components/form/inputs.cjs.map +1 -0
- package/libs/components/form/inputs.d.cts +2 -0
- package/libs/components/form/inputs.d.ts +2 -0
- package/libs/components/form/inputs.js +4 -0
- package/libs/components/form/inputs.js.map +1 -0
- package/libs/components/form/textarea.cjs +19 -0
- package/libs/components/form/textarea.cjs.map +1 -0
- package/libs/components/form/textarea.d.cts +29 -0
- package/libs/components/form/textarea.d.ts +29 -0
- package/libs/components/form/textarea.js +4 -0
- package/libs/components/form/textarea.js.map +1 -0
- package/libs/components/heading/heading.cjs +10 -0
- package/libs/components/heading/heading.cjs.map +1 -0
- package/libs/components/heading/heading.d.cts +14 -0
- package/libs/components/heading/heading.d.ts +14 -0
- package/libs/components/heading/heading.js +4 -0
- package/libs/components/heading/heading.js.map +1 -0
- package/libs/components/icons/icon.cjs +19 -0
- package/libs/components/icons/icon.cjs.map +1 -0
- package/libs/{icons-31ace3de.d.ts → components/icons/icon.d.cts} +4 -58
- package/libs/components/icons/icon.d.ts +301 -0
- package/libs/components/icons/icon.js +4 -0
- package/libs/components/icons/icon.js.map +1 -0
- package/libs/components/link/link.cjs +19 -0
- package/libs/components/link/link.cjs.map +1 -0
- package/libs/components/link/link.d.cts +19 -0
- package/libs/components/link/link.d.ts +19 -0
- package/libs/components/link/link.js +4 -0
- package/libs/components/link/link.js.map +1 -0
- package/libs/components/list/list.cjs +23 -0
- package/libs/components/list/list.cjs.map +1 -0
- package/libs/components/list/list.d.cts +39 -0
- package/libs/components/list/list.d.ts +39 -0
- package/libs/components/list/list.js +4 -0
- package/libs/components/list/list.js.map +1 -0
- package/libs/components/modal.cjs +14 -0
- package/libs/components/modal.cjs.map +1 -0
- package/libs/components/modal.d.cts +35 -0
- package/libs/components/modal.d.ts +35 -0
- package/libs/components/modal.js +5 -0
- package/libs/components/modal.js.map +1 -0
- package/libs/components/nav/nav.cjs +28 -0
- package/libs/components/nav/nav.cjs.map +1 -0
- package/libs/components/nav/nav.d.cts +44 -0
- package/libs/components/nav/nav.d.ts +44 -0
- package/libs/components/nav/nav.js +5 -0
- package/libs/components/nav/nav.js.map +1 -0
- package/libs/components/popover/popover.cjs +23 -0
- package/libs/components/popover/popover.cjs.map +1 -0
- package/libs/components/popover/popover.d.cts +40 -0
- package/libs/components/popover/popover.d.ts +40 -0
- package/libs/components/popover/popover.js +4 -0
- package/libs/components/popover/popover.js.map +1 -0
- package/libs/components/tables/table.cjs +21 -0
- package/libs/components/tables/table.cjs.map +1 -0
- package/libs/components/tables/table.d.cts +36 -0
- package/libs/components/tables/table.d.ts +36 -0
- package/libs/components/tables/table.js +4 -0
- package/libs/components/tables/table.js.map +1 -0
- package/libs/components/text/text.cjs +23 -0
- package/libs/components/text/text.cjs.map +1 -0
- package/libs/components/text/text.d.cts +30 -0
- package/libs/components/text/text.d.ts +30 -0
- package/libs/components/text/text.js +4 -0
- package/libs/components/text/text.js.map +1 -0
- package/libs/icons.cjs +3 -2
- package/libs/icons.d.cts +3 -1
- package/libs/icons.d.ts +3 -1
- package/libs/icons.js +2 -1
- package/libs/index.cjs +152 -61
- package/libs/index.cjs.map +1 -1
- package/libs/index.css +1 -1
- package/libs/index.css.map +1 -1
- package/libs/index.d.cts +65 -472
- package/libs/index.d.ts +65 -472
- package/libs/index.js +24 -7
- package/libs/index.js.map +1 -1
- package/libs/inputs-f3a216db.d.ts +45 -0
- package/libs/ui-9a6f9f8d.d.ts +24 -0
- package/package.json +87 -2
- package/src/components/README.mdx +1 -1
- package/src/components/alert/README.mdx +1 -1
- package/src/components/alert/alert.stories.tsx +2 -2
- package/src/components/alert/elements/README.mdx +1 -1
- package/src/components/alert/elements/dismiss-button.stories.tsx +2 -2
- package/src/components/badge/badge.mdx +1 -1
- package/src/components/badge/badge.stories.tsx +2 -2
- package/src/components/badge/badge.tsx +11 -19
- package/src/components/breadcrumbs/README.mdx +1 -1
- package/src/components/breadcrumbs/breadcrumb.stories.tsx +2 -2
- package/src/components/button.ts +2 -0
- package/src/components/buttons/README.mdx +1 -1
- package/src/components/buttons/button.stories.tsx +2 -2
- package/src/components/buttons/button.test.tsx +1 -1
- package/src/components/card.ts +2 -0
- package/src/components/cards/README.md +80 -0
- package/src/components/cards/card.stories.tsx +2 -2
- package/src/components/details/README.mdx +1 -1
- package/src/components/details/details.scss +7 -0
- package/src/components/details/details.stories.tsx +2 -2
- package/src/components/details/details.tsx +11 -18
- package/src/components/dialog/README.mdx +1 -1
- package/src/components/dialog/dialog-modal.stories.tsx +2 -2
- package/src/components/dialog/dialog-modal.tsx +1 -1
- package/src/components/dialog/dialog.stories.tsx +2 -2
- package/src/components/dialog/views/README.mdx +1 -1
- package/src/components/dialog/views/dialog-header.stories.tsx +2 -2
- package/src/components/form/form.stories.tsx +2 -2
- package/src/components/form/input.stories.tsx +2 -2
- package/src/components/form/select.stories.tsx +2 -2
- package/src/components/fp.test.tsx +52 -50
- package/src/components/heading/heading.stories.tsx +2 -2
- package/src/components/heading/heading.tsx +12 -24
- package/src/components/icons/icon.stories.tsx +1 -1
- package/src/components/images/figure.stories.tsx +2 -2
- package/src/components/images/img.stories.tsx +2 -2
- package/src/components/layout/footer.stories.tsx +10 -19
- package/src/components/layout/landmarks.stories.tsx +22 -24
- package/src/components/layout/main.stories.tsx +21 -25
- package/src/components/link/link.stories.tsx +2 -2
- package/src/components/list/list.stories.tsx +2 -2
- package/src/components/modal.ts +1 -0
- package/src/components/nav/nav.stories.tsx +2 -2
- package/src/components/popover/popover.stories.tsx +2 -2
- package/src/components/progress/progress.stories.tsx +1 -1
- package/src/components/tag/tag.stories.tsx +2 -2
- package/src/components/text/text.stories.tsx +2 -2
- package/src/components/text/text.tsx +50 -49
- package/src/components/text-to-speech/TextToSpeech.stories.tsx +1 -1
- package/src/decorators/instructions.tsx +2 -1
- package/src/index.ts +43 -19
- package/src/patterns/page/page-header.stories.tsx +2 -2
- package/src/styles/details/details.css +8 -0
- package/src/styles/details/details.css.map +1 -1
- package/src/styles/index.css +8 -0
- package/src/styles/index.css.map +1 -1
- package/libs/chunk-PWVRDQ3R.js +0 -8
- package/libs/chunk-PWVRDQ3R.js.map +0 -1
- package/libs/chunk-SVS4MX3U.cjs +0 -31
- package/libs/chunk-SVS4MX3U.cjs.map +0 -1
- package/src/components/cards/README.mdx +0 -133
- package/src/components/text/README.mdx +0 -98
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
import { Meta } from "@storybook/blocks";
|
|
2
|
-
|
|
3
|
-
<Meta title="FP.REACT Components/Text/Readme" />
|
|
4
|
-
|
|
5
|
-
# Text Component
|
|
6
|
-
|
|
7
|
-
## Summary
|
|
8
|
-
|
|
9
|
-
The `Text` component is a flexible wrapper for rendering various text elements
|
|
10
|
-
such as paragraphs, spans, and other inline or block-level elements. It supports
|
|
11
|
-
customization through props like `elm`, `text`, and additional styles or
|
|
12
|
-
classes.
|
|
13
|
-
|
|
14
|
-
The `Title` component is a specialized version of `Text` for rendering HTML
|
|
15
|
-
headings (`h1` to `h6`).
|
|
16
|
-
|
|
17
|
-
## Features
|
|
18
|
-
|
|
19
|
-
- Render any valid HTML text element.
|
|
20
|
-
- Pass text content directly or use children for nested elements.
|
|
21
|
-
- Fully customizable with styles and classes.
|
|
22
|
-
- Supports accessibility with `id` and other attributes.
|
|
23
|
-
|
|
24
|
-
## Props
|
|
25
|
-
|
|
26
|
-
### Text Props
|
|
27
|
-
|
|
28
|
-
| Name | Type | Default | Description |
|
|
29
|
-
| ---------- | --------------------- | ------- | ----------------------------------- |
|
|
30
|
-
| `elm` | `TextElements` | `'p'` | The HTML element to render. |
|
|
31
|
-
| `text` | `string` | `''` | Text content to display. |
|
|
32
|
-
| `id` | `string` | `''` | Unique identifier for the element. |
|
|
33
|
-
| `styles` | `React.CSSProperties` | `null` | Inline styles for the element. |
|
|
34
|
-
| `classes` | `string` | `''` | Additional CSS classes for styling. |
|
|
35
|
-
| `children` | `React.ReactNode` | `null` | Nested content inside the element. |
|
|
36
|
-
|
|
37
|
-
### Title Props
|
|
38
|
-
|
|
39
|
-
| Name | Type | Default | Description |
|
|
40
|
-
| ---------- | ---------------------------------------------- | ------- | ----------------------------------- |
|
|
41
|
-
| `elm` | `'h1' \| 'h2' \| 'h3' \| 'h4' \| 'h5' \| 'h6'` | `'h3'` | The HTML heading element to render. |
|
|
42
|
-
| `id` | `string` | `''` | Unique identifier for the element. |
|
|
43
|
-
| `styles` | `React.CSSProperties` | `null` | Inline styles for the element. |
|
|
44
|
-
| `classes` | `string` | `''` | Additional CSS classes for styling. |
|
|
45
|
-
| `children` | `React.ReactNode` | `null` | Nested content inside the element. |
|
|
46
|
-
|
|
47
|
-
## Technical Details
|
|
48
|
-
|
|
49
|
-
- The `Text` component uses the `UI` component internally to render the
|
|
50
|
-
specified element.
|
|
51
|
-
- The `Title` component is a wrapper around `Text` with default settings for
|
|
52
|
-
headings.
|
|
53
|
-
- Both components support additional props inherited from the `UI` component.
|
|
54
|
-
|
|
55
|
-
## Usage Examples
|
|
56
|
-
|
|
57
|
-
### Basic Usage
|
|
58
|
-
|
|
59
|
-
```tsx
|
|
60
|
-
import { Text, Title } from "./text";
|
|
61
|
-
|
|
62
|
-
const App = () => (
|
|
63
|
-
<>
|
|
64
|
-
<Text elm="p" text="This is a paragraph." />
|
|
65
|
-
<Text elm="span" text="This is a span." />
|
|
66
|
-
<Title elm="h1">This is a heading</Title>
|
|
67
|
-
</>
|
|
68
|
-
);
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### Advanced Usage
|
|
72
|
-
|
|
73
|
-
```tsx
|
|
74
|
-
import { Text, Title } from "./text";
|
|
75
|
-
|
|
76
|
-
const App = () => (
|
|
77
|
-
<>
|
|
78
|
-
<Text
|
|
79
|
-
elm="blockquote"
|
|
80
|
-
styles={{ fontStyle: "italic", color: "gray" }}
|
|
81
|
-
text="This is a blockquote."
|
|
82
|
-
/>
|
|
83
|
-
<Title
|
|
84
|
-
elm="h2"
|
|
85
|
-
classes="custom-heading"
|
|
86
|
-
styles={{ fontWeight: "bold", fontSize: "2rem" }}
|
|
87
|
-
>
|
|
88
|
-
Custom Heading
|
|
89
|
-
</Title>
|
|
90
|
-
</>
|
|
91
|
-
);
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
### Additional Notes
|
|
95
|
-
|
|
96
|
-
- Use the `elm` prop to specify the desired HTML element.
|
|
97
|
-
- Combine `styles` and `classes` for advanced styling.
|
|
98
|
-
- Use `children` for nested content when `text` is not sufficient.
|