skyloom-ui 0.1.0 → 0.1.2

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.
Files changed (101) hide show
  1. package/README.md +352 -11
  2. package/dist/advanced.css +89 -0
  3. package/dist/components/accordion.js +3 -2
  4. package/dist/components/advanced-forms.d.ts +40 -0
  5. package/dist/components/advanced-forms.js +66 -0
  6. package/dist/components/advanced-layout.d.ts +29 -0
  7. package/dist/components/advanced-layout.js +49 -0
  8. package/dist/components/ai-status.d.ts +29 -0
  9. package/dist/components/ai-status.js +19 -0
  10. package/dist/components/alert.d.ts +1 -1
  11. package/dist/components/alert.js +1 -0
  12. package/dist/components/animated-tooltip.d.ts +10 -0
  13. package/dist/components/animated-tooltip.js +17 -0
  14. package/dist/components/badge.d.ts +4 -2
  15. package/dist/components/badge.js +7 -4
  16. package/dist/components/breadcrumb.d.ts +1 -1
  17. package/dist/components/breadcrumb.js +2 -1
  18. package/dist/components/button-group.d.ts +5 -0
  19. package/dist/components/button-group.js +8 -0
  20. package/dist/components/button.d.ts +4 -4
  21. package/dist/components/button.js +8 -3
  22. package/dist/components/card.d.ts +6 -1
  23. package/dist/components/card.js +13 -2
  24. package/dist/components/code-block.d.ts +31 -0
  25. package/dist/components/code-block.js +49 -0
  26. package/dist/components/compare.d.ts +17 -0
  27. package/dist/components/compare.js +39 -0
  28. package/dist/components/data-table-columns.d.ts +24 -0
  29. package/dist/components/data-table-columns.js +60 -0
  30. package/dist/components/data-table.d.ts +9 -1
  31. package/dist/components/data-table.js +16 -6
  32. package/dist/components/dialog.d.ts +11 -2
  33. package/dist/components/dialog.js +13 -2
  34. package/dist/components/dropdown-menu.js +2 -2
  35. package/dist/components/feature-card.d.ts +9 -0
  36. package/dist/components/feature-card.js +6 -0
  37. package/dist/components/fields.d.ts +9 -2
  38. package/dist/components/fields.js +10 -5
  39. package/dist/components/globe-renderer.d.ts +7 -0
  40. package/dist/components/globe-renderer.js +32 -0
  41. package/dist/components/globe.d.ts +9 -0
  42. package/dist/components/globe.js +25 -0
  43. package/dist/components/icon.d.ts +26 -0
  44. package/dist/components/icon.js +26 -0
  45. package/dist/components/image-generation-loader.d.ts +15 -0
  46. package/dist/components/image-generation-loader.js +93 -0
  47. package/dist/components/interactive-card.d.ts +6 -0
  48. package/dist/components/interactive-card.js +18 -0
  49. package/dist/components/link-preview.d.ts +25 -0
  50. package/dist/components/link-preview.js +84 -0
  51. package/dist/components/loader.d.ts +18 -0
  52. package/dist/components/loader.js +17 -0
  53. package/dist/components/loading.js +1 -1
  54. package/dist/components/message.d.ts +8 -0
  55. package/dist/components/message.js +11 -0
  56. package/dist/components/motion.d.ts +32 -0
  57. package/dist/components/motion.js +63 -0
  58. package/dist/components/multi-step-loader.d.ts +16 -0
  59. package/dist/components/multi-step-loader.js +29 -0
  60. package/dist/components/navigation.d.ts +76 -0
  61. package/dist/components/navigation.js +99 -0
  62. package/dist/components/popover.js +1 -1
  63. package/dist/components/progress.js +1 -1
  64. package/dist/components/prompt-input.d.ts +17 -0
  65. package/dist/components/prompt-input.js +27 -0
  66. package/dist/components/select.js +4 -3
  67. package/dist/components/sheet.js +2 -1
  68. package/dist/components/stat-card.d.ts +10 -0
  69. package/dist/components/stat-card.js +6 -0
  70. package/dist/components/tabs.d.ts +3 -1
  71. package/dist/components/tabs.js +4 -4
  72. package/dist/components/text-effects.d.ts +48 -0
  73. package/dist/components/text-effects.js +105 -0
  74. package/dist/components/theme-controls.d.ts +2 -0
  75. package/dist/components/theme-controls.js +17 -0
  76. package/dist/components/theme-provider.d.ts +20 -0
  77. package/dist/components/theme-provider.js +50 -0
  78. package/dist/components/theme-script.d.ts +9 -0
  79. package/dist/components/theme-script.js +8 -0
  80. package/dist/components/timeline.d.ts +12 -0
  81. package/dist/components/timeline.js +11 -0
  82. package/dist/components/tooltip.js +1 -1
  83. package/dist/components/use-column-layout.d.ts +6 -0
  84. package/dist/components/use-column-layout.js +38 -0
  85. package/dist/components/use-column-pinning.d.ts +10 -0
  86. package/dist/components/use-column-pinning.js +50 -0
  87. package/dist/components/world-map.d.ts +17 -0
  88. package/dist/components/world-map.js +13 -0
  89. package/dist/data/land.d.ts +1 -0
  90. package/dist/data/land.js +2 -0
  91. package/dist/index.d.ts +33 -5
  92. package/dist/index.js +30 -3
  93. package/dist/lib/canvas-tokens.d.ts +5 -0
  94. package/dist/lib/canvas-tokens.js +34 -0
  95. package/dist/lib/column-layout.d.ts +36 -0
  96. package/dist/lib/column-layout.js +69 -0
  97. package/dist/lib/theme-settings.d.ts +22 -0
  98. package/dist/lib/theme-settings.js +36 -0
  99. package/dist/styles.css +56 -3
  100. package/dist/tokens.css +273 -153
  101. package/package.json +20 -3
package/README.md CHANGED
@@ -1,6 +1,223 @@
1
1
  # skyloom-ui
2
2
 
3
- The frontend's single shared UI package. All controls and compositions live in `src/components`, exported from `skyloom-ui`. There is no separate commoncomponents package or folder. These are locally authored shadcn-style wrappers, with Radix primitives providing interactive accessibility behavior.
3
+ Theme-token-based React components, layouts, data tables, and charts for React 19 and Tailwind CSS v4. Interactive components use Radix primitives for accessible behavior.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install skyloom-ui
9
+ ```
10
+
11
+ React and React DOM are peer dependencies and must be available in your application.
12
+
13
+ Import the package stylesheet after Tailwind in your global CSS:
14
+
15
+ ```css
16
+ @import "tailwindcss";
17
+ @import "skyloom-ui/styles.css";
18
+ ```
19
+
20
+ For Next.js, add the package to `transpilePackages` in `next.config.ts`:
21
+
22
+ ```ts
23
+ import type { NextConfig } from "next";
24
+
25
+ const nextConfig: NextConfig = {
26
+ transpilePackages: ["skyloom-ui"],
27
+ };
28
+
29
+ export default nextConfig;
30
+ ```
31
+
32
+ ## Quick start
33
+
34
+ ```tsx
35
+ import { Button, Card, CardContent, CardHeader, CardTitle } from "skyloom-ui";
36
+
37
+ export function WelcomeCard() {
38
+ return (
39
+ <Card>
40
+ <CardHeader>
41
+ <CardTitle>Welcome</CardTitle>
42
+ </CardHeader>
43
+ <CardContent>
44
+ <Button>Get started</Button>
45
+ </CardContent>
46
+ </Card>
47
+ );
48
+ }
49
+ ```
50
+
51
+ Set the theme and density on the document root:
52
+
53
+ ```html
54
+ <html lang="en" data-theme="light" data-density="comfortable">
55
+ ```
56
+
57
+ Available themes are `light`, `dark`, and `sepia`; the optional provider also supports the `system` preference. Densities are `comfortable` (default) and `compact`.
58
+
59
+ Choose a palette and appearance independently of light/dark mode. All settings belong on `html`, including when using dialogs and other portals:
60
+
61
+ ```html
62
+ <html lang="en" data-theme="dark" data-palette="ocean"
63
+ data-appearance="modern" data-density="comfortable">
64
+ ```
65
+
66
+ | Setting | Values | Default |
67
+ | --- | --- | --- |
68
+ | `data-theme` | `light`, `dark`, `sepia` (resolved theme) | `light` |
69
+ | `data-palette` | `sage`, `ocean`, `violet`, `neutral` | `sage` |
70
+ | `data-appearance` | `default`, `classic`, `modern` | `default` |
71
+ | `data-density` | `comfortable`, `compact` | `comfortable` |
72
+ | `data-font` | `system`, `inter`, `editorial`, registered custom profiles | `system` |
73
+ | `data-motion` | `system`, `reduced`, `none` | `system` |
74
+
75
+ Classic uses smaller surface corners. Modern uses softer corners and removes raised shadows. Omitting the new attributes preserves the original design. Component-level variants can override appearance for individual surfaces. The catalog at `/design-system` previews and persists these settings using the optional ThemeProvider.
76
+
77
+ ### Theme preferences and typography
78
+
79
+ ThemeProvider, ThemeScript, ThemeControls, and useTheme share one settings resolver. System follows live OS color-scheme changes. Explicit themes remain selected when the OS changes. Settings persist under `sky-ui-*` keys, synchronize across tabs, and fall back safely when storage is unavailable or invalid. Existing palette/appearance/density keys remain compatible.
80
+
81
+ For Next.js, place the bootstrap script in the head and the provider around your application. Pass the same `themes`, `fontProfiles`, `defaultSettings`, and `storagePrefix` to both when customizing them. ThemeScript accepts a CSP `nonce`.
82
+
83
+ ```tsx
84
+ import { ThemeScript } from "skyloom-ui/components/theme-script";
85
+ import { ThemeProvider } from "skyloom-ui/components/theme-provider";
86
+
87
+ export default function Layout({ children }: { children: React.ReactNode }) {
88
+ return <html lang="en" suppressHydrationWarning>
89
+ <head><ThemeScript defaultSettings={{ theme: "system" }} /></head>
90
+ <body><ThemeProvider defaultSettings={{ theme: "system" }}>{children}</ThemeProvider></body>
91
+ </html>;
92
+ }
93
+ ```
94
+
95
+ Render `<ThemeControls />` inside the provider, or use `useTheme()` in your own client controls. It exposes `settings`, `resolvedTheme`, `themes`, `fontProfiles`, `updateSettings(partial)`, and `resetSettings()`. The preference is recorded as `data-theme-preference`; `data-theme` always holds the resolved CSS theme. Without a provider, setting root attributes manually remains supported.
96
+
97
+ Extend the exported `themes` registry with `{ id, label, colorScheme }` entries, retaining the built-in light/dark entries for system resolution. Define the matching `:root[data-theme="your-theme"]` semantic roles in CSS after the package stylesheet. Registration supplies a label and native color scheme; it does not generate a color palette. Keep background/foreground and status pairs accessible.
98
+
99
+ Typography is independent of color and appearance. Components consume `--sky-font-body`, `--sky-font-heading`, and `--sky-font-mono` (Tailwind `font-body`, `font-heading`, `font-mono`). The legacy `--sky-font-family` remains the body fallback. System uses platform fonts; Inter uses `--sky-loaded-inter`; Editorial uses Inter for body and `--sky-loaded-serif` for headings. All profiles retain a monospace code font. Set these loader variables or override the semantic font roles to integrate other families. The package does not download fonts or depend on Next.js font loading.
100
+
101
+ The catalog self-hosts Latin variable Inter and Source Serif 4 through `next/font/local`; font assets and their OFL licenses live in `src/app/fonts`. Unsupported glyphs use platform fallbacks. Add appropriate language subsets in the consuming app when needed.
102
+
103
+ Register additional typography profiles without modifying the package. Pass the same registry to ThemeProvider and ThemeScript; ThemeControls automatically lists it and saved preferences are validated against it. IDs must be unique and nonempty. An empty registry falls back to built-in profiles.
104
+
105
+ ```tsx
106
+ import { fontProfiles, type FontProfileDefinition } from "skyloom-ui";
107
+
108
+ export const appFonts: readonly FontProfileDefinition[] = [
109
+ ...fontProfiles,
110
+ { id: "studio", label: "Studio" },
111
+ ];
112
+ // <ThemeScript fontProfiles={appFonts} />
113
+ // <ThemeProvider fontProfiles={appFonts}>...</ThemeProvider>
114
+ ```
115
+
116
+ Load the desired fonts in your app and map their variables to the semantic roles:
117
+
118
+ ```css
119
+ :root[data-font="studio"] {
120
+ --sky-font-body: var(--app-body-font, var(--sky-family-system));
121
+ --sky-font-heading: var(--app-heading-font, var(--sky-family-serif));
122
+ --sky-font-mono: var(--app-code-font, var(--sky-family-mono));
123
+ }
124
+ ```
125
+
126
+ Registry labels do not load font files. Existing System, Inter, and Editorial behavior is unchanged. In-memory settings survive parent rerenders even when browser storage is blocked; changing `storagePrefix` loads the new namespace.
127
+
128
+ ### Variants and reusable compositions
129
+
130
+ The catalog now includes a Playground for every entry. Choose actual component props, compare options, narrow the preview container, reset, and copy a standalone example matching the current selection. Charts use focused synthetic fixtures in their playgrounds. Existing metric-specific demos remain in Preview.
131
+
132
+ ### Shared SVG icons
133
+
134
+ `Icon` provides `chevron-down`, `chevron-up`, `chevron-right`, `arrow-up`, `arrow-down`, `arrow-left`, `check`, `close`, `grip`, and `more-horizontal`. Icons use a shared viewBox, currentColor, and the `--sky-icon` size token. SVG coordinates describe artwork; rendered dimensions come from theme tokens. Buttons, badges, tabs, menu items, and feature-card slots also normalize direct SVG children, including third-party icons. Icons stay centered and do not shrink beside wrapping text.
135
+
136
+ ```tsx
137
+ import { Button, Icon } from "skyloom-ui";
138
+
139
+ <Button variant="outline"><Icon name="check" />Save changes</Button>;
140
+ <Button size="icon" aria-label="More options"><Icon name="more-horizontal" /></Button>;
141
+ <Icon name="check" aria-label="Complete" />;
142
+ ```
143
+
144
+ Icons are decorative by default; label icon-only controls on the button. Use `aria-label` or `aria-labelledby` for a standalone meaningful icon. Native SVG props, refs, and `className` are forwarded. Directional navigation icons can use `rtl:rotate-180`. Disclosure arrows rotate with expanded state and honor the shared reduced-motion settings. Preview every icon and context in the catalog's Icon playground.
145
+
146
+ ### Motion preferences
147
+
148
+ ThemeProvider/ThemeScript persist `motion: "system" | "reduced" | "none"` as `data-motion`. ThemeControls exposes this setting. OS reduced motion always disables package animation; Reduced and None also disable transitions and animations. System enables subtle component feedback, Radix overlay entrance, and preview transitions. Durations and distances use `--sky-duration-enter`, `--sky-duration-fast`, and `--sky-motion-distance` tokens. Dragging remains directly user-controlled. Static labels, tables, and separators do not move autonomously.
149
+
150
+ ```tsx
151
+ import { InteractiveCard, CardHeader, CardTitle, Button, Suggestions, ToolStatus, TaskPlan, ShimmerText } from "skyloom-ui";
152
+
153
+ <InteractiveCard effect="spotlight" variant="modern">
154
+ <CardHeader><CardTitle>Your workspace</CardTitle><Button>Explore</Button></CardHeader>
155
+ </InteractiveCard>;
156
+ <Suggestions items={["Summarize", "Explain"]} onSelect={setPrompt} />;
157
+ <ToolStatus title="Search documents" status="complete" defaultOpen>3 documents found.</ToolStatus>;
158
+ <TaskPlan title="Release" steps={[{ id: "review", title: "Review changes", status: "complete", description: "Changes reviewed." }]} />;
159
+ <ShimmerText active>Preparing response…</ShimmerText>;
160
+ ```
161
+
162
+ InteractiveCard supports `lift`, `spotlight`, and `none`; it preserves Card props and refs, and uses explicit child links/buttons for actions. Suggestions supports disabled state. ToolStatus supports `pending`, `running`, `complete`, and `error`, with controlled `open`/`onOpenChange` or `defaultOpen`. TaskPlan takes uniquely identified steps with optional details. ShimmerText uses a finite pulse and retains readable text. These AI-oriented components display caller-provided state and content; they do not execute tools or connect an AI provider. See the repository's `docs/advanced-ui-research.md` for references and the implementation plan.
163
+
164
+ | Component | Variants / options |
165
+ | --- | --- |
166
+ | Button | Existing variants plus `soft`, `success`, `classic`; `shape="default\|pill\|square"` |
167
+ | Card | `default`, `outline`, `soft`, `classic`, `modern`, `elevated` |
168
+ | Input, Textarea | `default`, `filled`, `classic` |
169
+ | Badge | Existing variants plus `info`, `warning`, `soft`; `shape="default\|pill"` |
170
+ | Alert | Existing variants plus `info`, `warning` |
171
+ | DialogContent | `default`, `classic`, `modern`; `size="default\|sm\|lg"`; composable DialogHeader |
172
+ | TabsList | `default`, `line`, `outline` |
173
+
174
+ `buttonVariants` and `cardVariants` are exported for composing matching surfaces. Native props, refs, and `className` overrides remain available.
175
+
176
+ ```tsx
177
+ import { Button, FeatureCard, ResponsiveGrid, StatCard } from "skyloom-ui";
178
+
179
+ <ResponsiveGrid>
180
+ <FeatureCard title="Your workspace" description="Everything in one place."
181
+ variant="modern" action={<Button variant="soft">Explore</Button>} />
182
+ <StatCard label="Completed requests" value="12,840" variant="classic"
183
+ trend="Up 12% this week" tone="success" />
184
+ </ResponsiveGrid>;
185
+ ```
186
+
187
+ FeatureCard composes existing Card parts; supply `icon`, `action`, or children as needed. StatCard uses a description list, with optional description and trend. Trends use explicit `default`, `success`, or `destructive` tones. ButtonGroup wraps actions with a labeled group (`aria-label`), supports horizontal or vertical layout, and wraps on small screens. Kbd renders a keyboard hint; it does not register shortcuts.
188
+
189
+ ### Lightweight chat primitives
190
+
191
+ Message, MessageContent, and MessageActions compose user, assistant, or system messages. Message supports `bubble` (default) and `plain` variants. Content is ordinary React content, with whitespace preserved; Markdown parsing and streaming transport stay in the application. Add an appropriately labeled conversation region in the application, and choose live announcements to suit your streaming behavior.
192
+
193
+ ```tsx
194
+ "use client";
195
+ import { useState } from "react";
196
+ import { Message, MessageContent, PromptInput } from "skyloom-ui";
197
+
198
+ export function Composer() {
199
+ const [value, setValue] = useState("");
200
+ const [message, setMessage] = useState("Hello");
201
+ return <>
202
+ <Message from="user"><MessageContent>{message}</MessageContent></Message>
203
+ <PromptInput value={value} onValueChange={setValue} variant="modern"
204
+ onSubmit={text => { setMessage(text); setValue(""); }} />
205
+ </>;
206
+ }
207
+ ```
208
+
209
+ PromptInput is controlled: `onSubmit(text, event)` receives trimmed, nonempty text and the caller decides when to clear the draft. Enter submits, Shift+Enter inserts a newline, and IME composition does not submit. `status="submitted"` or `"streaming"` blocks sending and displays a stop button connected to `onStop`; without `onStop`, that button is disabled. `ready` and `error` allow sending. Render error details in the application. `disabled` disables the fieldset and guards submission. Use `label`, `submitLabel`, `stopLabel`, `tools`, and `textareaProps` to customize labels, controls, refs, validation, and keyboard handling. Calling `preventDefault()` in `textareaProps.onKeyDown` overrides the built-in shortcut. Tool buttons should use `type="button"` (the Button default).
210
+
211
+ These additions have no new runtime dependencies, animation engine, or AI SDK dependency. Import individual modules when you want an explicit lightweight entry point:
212
+
213
+ ```tsx
214
+ import { Button } from "skyloom-ui/components/button";
215
+ import { PromptInput } from "skyloom-ui/components/prompt-input";
216
+ ```
217
+
218
+ The normal stylesheet import is still required. The root export remains available for tree-shaking bundlers. No bundle-size benchmark is implied.
219
+
220
+ Design references: [shadcn theming](https://ui.shadcn.com/docs/theming) for paired semantic roles, [Aceternity Bento Grid](https://ui.aceternity.com/components/bento-grid) for composable feature tiles, and Vercel AI Elements [Message](https://elements.ai-sdk.dev/components/message) / [Prompt Input](https://elements.ai-sdk.dev/components/prompt-input) for chat composition. These are native sky-ui implementations using the existing architecture, not full API-compatible ports.
4
221
 
5
222
  ```tsx
6
223
  import { Button, SelectField, MultiSelect, Card, Dialog, Sheet, ResponsiveGrid } from "skyloom-ui";
@@ -10,7 +227,7 @@ import { Button, SelectField, MultiSelect, Card, Dialog, Sheet, ResponsiveGrid }
10
227
 
11
228
  The design follows [shadcn semantic CSS variables](https://ui.shadcn.com/docs/theming) and [Tailwind v4 theme aliases](https://tailwindcss.com/docs/theme). Foundation values, semantic roles, and component decisions are separated using CSS references. This uses the aliasing principle described by [DTCG](https://www.designtokens.org/tr/2025.10/format/), without maintaining a duplicate JSON token source.
12
229
 
13
- - `src/tokens.css`: OKLCH palette, rem dimensions, typography, spacing, focus/border widths, radii, shadows, layers, opacity, motion, and runtime light/dark and density roles.
230
+ - `src/tokens.css`: OKLCH palette, rem dimensions, typography, spacing, focus/border widths, radii, shadows, layers, opacity, motion, and runtime theme, font, and density roles.
14
231
  - `src/styles.css`: Tailwind inline mappings, static breakpoint tokens, shared state styles, and reduced-motion rules.
15
232
  - Components: semantic utilities such as `bg-card`, `text-muted-foreground`, `p-panel`, `gap-control`, `h-field`, and `rounded-control`.
16
233
 
@@ -22,7 +239,7 @@ Apply theme and density to the document root so body portals receive the same va
22
239
  <html lang="en" data-theme="dark" data-density="comfortable">
23
240
  ```
24
241
 
25
- Use `light` or `dark`; use `comfortable` (default) or `compact`. Existing `.dark` works too, but explicit `data-theme="light"` takes precedence. Brand overrides belong after the package stylesheet; override the appropriate `--sky-brand-light` and `--sky-brand-dark` foundation values and verify contrast. This package supplies themes, not preference persistence or a system-theme provider.
242
+ Use `light`, `dark`, or `sepia`; use `comfortable` (default) or `compact`. Existing `.dark` works when `data-theme` is absent; explicit theme attributes take precedence. Brand overrides belong after the package stylesheet; override the appropriate `--sky-brand-light` and `--sky-brand-dark` foundation values and verify contrast. Sepia uses warm surfaces with the selected light brand palette.
26
243
 
27
244
  ## Responsive behavior
28
245
 
@@ -48,7 +265,7 @@ Breakpoints are defined once in `@theme`; CSS media queries cannot resolve runti
48
265
  - Surfaces: Card and parts, Badge, Alert and parts, EmptyState, Separator.
49
266
  - Overlays/navigation: Dialog and parts, Sheet and parts, Tabs and parts, Accordion and parts, Tooltip and provider.
50
267
  - Loading/layout: Skeleton, Spinner, Container, Stack, ResponsiveGrid.
51
- - Data: Avatar, Table, DataTable with pagination/search/page sizes, Progress, Breadcrumb, Pagination.
268
+ - Data: Avatar, Table, DataTable with pagination/search/page sizes and column management, Progress, Breadcrumb, Pagination.
52
269
  - Additional overlays: DropdownMenu and Popover.
53
270
  - Analytics: ChartContainer, ChartTooltipContent, CartesianChart (line/area/bar), DonutChart, ScatterPlot, Heatmap. Chart height, palettes, and emphasis use theme tokens; exact values are available in HTML data tables.
54
271
 
@@ -68,6 +285,30 @@ const columns: DataTableColumn<Item>[] = [
68
285
 
69
286
  Pagination follows filtering, and page indices are clamped after data shrinks. `loading` and `error` display distinct states. This version does not claim server pagination, sorting, selection, or virtualization.
70
287
 
288
+ ### Column layouts
289
+
290
+ DataTable includes draggable header handles and a **Manage columns** button opening a left drawer. The drawer includes every column, including hidden ones, with visibility switches, pin controls, drag handles, and move-up/down buttons. Set `columnManagement={false}` to hide these controls. Column IDs must be unique and stable. Set `enableHiding: false` or `enablePinning: false` on individual column definitions to restrict those actions; the last visible column cannot be hidden.
291
+
292
+ ```tsx
293
+ import { DataTable, type DataTableColumnLayout } from "skyloom-ui";
294
+
295
+ const initialLayout: DataTableColumnLayout = {
296
+ order: ["id", "name", "status"],
297
+ visibility: { id: true, name: true, status: true },
298
+ pinning: { start: ["id"], end: [] },
299
+ };
300
+
301
+ <DataTable data={items} columns={columns} getRowId={row => row.id}
302
+ caption="Items" defaultColumnLayout={initialLayout}
303
+ columnLayoutStorageKey="items-columns" />;
304
+ ```
305
+
306
+ Use `columnLayout` with `onColumnLayoutChange` for controlled state. Otherwise `defaultColumnLayout` initializes state and **Reset columns** restores it. Persistence is opt-in via a table-specific `columnLayoutStorageKey`; controlled callers own persistence. Malformed or unsupported saved payloads fall back to `defaultColumnLayout`. Valid stored layouts are reconciled against current definitions: removed/duplicate IDs are discarded, new columns are appended, and column capabilities take precedence.
307
+
308
+ Dragging reorders within the start, unpinned, or end group. Use pin controls to move between groups. Header dragging moves visible columns while retaining hidden slots; the drawer can reorder hidden columns too. Mouse, touch, and keyboard dragging use dnd-kit; focus a grip and press Space, use arrows, then Enter to drop or Escape to cancel. Drawer arrow buttons provide an alternative. Canceling a drag keeps the drawer open; Escape outside a drag closes it and restores trigger focus. Layout changes retain filtering and pagination.
309
+
310
+ Pinned offsets use measured cell widths and logical CSS insets, supporting RTL and remeasurement after font, density, or viewport changes. When pinned widths would leave less than `--sky-table-center-min` for the center, sticky positioning pauses and horizontal scrolling remains available. Pin choices are retained and resume at wider sizes. DataTable adds dnd-kit to its module dependency graph; basic Table and individual component imports remain available for simpler views.
311
+
71
312
  ### Charts
72
313
 
73
314
  ```tsx
@@ -87,15 +328,115 @@ MultiSelect supports Select all, mixed state, disabled options, and empty option
87
328
 
88
329
  Supply DialogTitle/SheetTitle and descriptions in overlays. Label switches and icon-only buttons. Tooltips require TooltipProvider and must not hold essential information available only on hover. Button defaults to type="button"; pass type="submit" explicitly. Button asChild expects one appropriate interactive child, such as a link; native button disabled semantics do not automatically apply to links. Accordion accepts Radix single/multiple modes. Keep business logic out of these wrappers.
89
330
 
90
- ## Integration and checks
331
+ ## Styles and exports
91
332
 
92
- Install workspace dependencies from frontend with `npm install`. Add `skyloom-ui` to the Next.js `transpilePackages` array. In the consuming app's global stylesheet:
333
+ The package exports its components from `skyloom-ui` and provides two stylesheet entry points:
93
334
 
94
- ```css
95
- @import "tailwindcss";
96
- @import "skyloom-ui/styles.css";
335
+ - `skyloom-ui/styles.css` includes the theme, Tailwind utility mappings, responsive tokens, and shared state styles. Import this stylesheet for normal use.
336
+ - `skyloom-ui/tokens.css` contains the design-token CSS variables when you need tokens without the full stylesheet.
337
+
338
+ The stylesheet registers package component sources for Tailwind CSS v4 class scanning. Load it in your app's global stylesheet so the component styles and utilities are included.
339
+
340
+ ## Development
341
+
342
+ From the repository's `frontend` directory, install dependencies with `npm install`. Run `npm run check` to type-check the frontend, verify compiled token and responsive styles, and run component interaction tests.
343
+
344
+
345
+ ## Advanced components
346
+
347
+ The package exports the following theme-aware families. The `/design-system` catalog provides previews, variant comparison, editable configuration, copyable React examples, and animation pause/replay controls.
348
+
349
+ | Family | Exports |
350
+ | --- | --- |
351
+ | Loading | `Loader`, `LoaderOne` through `LoaderFive`, `MultiStepLoader`, `ImageGenerationLoader` |
352
+ | Navigation | `FloatingNavbar`, `ResizableNavbar`, `NavbarMenu`, `Sidebar`, `FloatingDock`, `Notch`, `AnimatedTabs`, `StickyBanner` |
353
+ | Forms | `FormPanel`, `PlaceholdersAndVanishInput`, `GooeyInput`, `FileUpload` |
354
+ | Content and visualization | `Compare` / `CompareSlider`, `Timeline`, `CodeBlock`, `WorldMap`, `Globe` |
355
+ | Layout | `LayoutGrid`, `BentoGrid`, `BentoGridItem`, `ContainerCover`, `InfiniteCardGrid` |
356
+ | Previews | `AnimatedTooltip`, `LinkPreview` |
357
+ | Text | `CanvasText`, `EncryptedText`, `LayoutTextFlip`, `ColourfulText`, `SquigglyText`, `TextGenerateEffect`, `TypewriterEffect`, `FlipWords`, `TextHoverEffect`, `ContainerTextFlip`, `HeroHighlight`, `Highlight`, `TextRevealCard`, `TextFlippingBoard` |
358
+
359
+ `Button` additionally supports `variant="hover-border-gradient"`, and `Input` supports `variant="gradient"`. Appearance variants use existing semantic tokens, so theme, palette, font, and density settings remain shared with the rest of the package.
360
+
361
+ ### Motion and lifecycle
362
+
363
+ `AnimationBoundary` accepts `playing` to pause its effects. `useMotionPolicy` and `useAnimationActivity` share root settings, OS reduced-motion preferences, and document visibility; activity-aware renderers also observe intersection visibility. Canvas renderers limit pixel density and work per frame. `InfiniteCardGrid` renders at most 120 recycled tiles and provides directional controls and an accessible list. `Globe` loads its Three.js renderer dynamically after browser capability and visibility checks; an SVG map is the fallback. Three.js, Motion, and Prism remain normal installed dependencies.
364
+
365
+ ### Integration contracts
366
+
367
+ - `MultiStepLoader` defaults to a looping 2,000 ms sequence. Pass `activeStep` for real externally controlled progress; timed messages are illustrative rather than backend completion events. Pass `onLoadingChange` to allow modal dismissal.
368
+ - `FileUpload` selects and validates files locally. It accepts controlled `files`, `onFilesChange`, `accept`, `maxFiles`, `maxSize`, and caller-supplied progress. Upload transport belongs to the consuming application.
369
+ - `LinkPreview` defaults to caller-supplied `preview` data and makes no metadata request. `provider="custom"` uses an abortable resolver. `provider="microlink"` explicitly opts into a third-party request that receives the target URL. Responses are cached for five minutes, with at most 100 entries.
370
+ - `Compare` supports controlled `value`/`onValueChange`, drag/hover interaction, vertical/horizontal orientation, and a native keyboard slider. `CompareSlider` is the same implementation.
371
+ - `CodeBlock` accepts either `code` or `tabs`, supports line numbers and highlights, and renders tokenized text without injecting HTML.
372
+ - Gallery images and map connections are application data. Catalog SVG illustrations are local demo assets, not package assets. Replace example image paths in other applications.
373
+
374
+ The local map geometry is derived from [Natural Earth 1:110m land](https://www.naturalearthdata.com/downloads/110m-physical-vectors/110m-land/), rounded for display. Natural Earth data is [public domain](https://www.naturalearthdata.com/about/terms-of-use/). It is illustrative geography, not a navigation or boundary authority.
375
+
376
+ These are native Sky UI implementations inspired by the referenced interaction patterns; they do not include licensed Aceternity paid source code.
377
+
378
+ ## Advanced interaction updates
379
+
380
+ The modern Compare presentation adds a curved divider, local backdrop blur, split-color edging, and bounded particles during dragging. Both orientations support this treatment; reduced motion disables it while preserving slider interaction.
381
+
382
+ Navigation transitions use `--sky-duration-enter`. Animated tooltip springs use `--sky-spring-stiffness` and `--sky-spring-damping`. Override these tokens on the document root alongside your theme settings.
383
+
384
+ ### Controlled progress
385
+
386
+ ```tsx
387
+ import { MultiStepLoader } from "skyloom-ui";
388
+
389
+ <MultiStepLoader
390
+ loading={isLoading}
391
+ onLoadingChange={setIsLoading}
392
+ loadingStates={[{ text: "Preparing" }, { text: "Rendering" }]}
393
+ activeStep={currentStep}
394
+ presentation="modal"
395
+ />;
396
+ ```
397
+
398
+ Supply application state for the variables above. Omit `activeStep` for timed progress; `duration` defaults to 2000 ms and `loop` defaults to true. Setting `loop={false}` ends the message sequence with a waiting status, not a claim that the request completed.
399
+
400
+ ### Image loading overlay
401
+
402
+ ```tsx
403
+ import { ImageGenerationLoader } from "skyloom-ui";
404
+
405
+ <div className="relative h-chart overflow-hidden rounded-surface">
406
+ <ImageGenerationLoader
407
+ effect="scale-wave"
408
+ easing="ease-in-out"
409
+ text="Analysing"
410
+ cellSize={3}
411
+ gap={1}
412
+ bandHeight={48}
413
+ />
414
+ </div>;
415
+ ```
416
+
417
+ The numeric geometry overrides are CSS-pixel measurements. Effects include `shimmer`, `wave`, `scale-wave`, and `none`; easing supports `linear` and `ease-in-out`. A readable status remains available when animation or canvas rendering is unavailable.
418
+
419
+ ### Application-owned link previews
420
+
421
+ ```tsx
422
+ import { LinkPreview } from "skyloom-ui";
423
+
424
+ <LinkPreview
425
+ href="https://example.com"
426
+ provider="custom"
427
+ resolve={async (url, signal) => {
428
+ const response = await fetch(
429
+ "/api/preview?url=" + encodeURIComponent(url),
430
+ { signal },
431
+ );
432
+ if (!response.ok) throw new Error("Preview unavailable");
433
+ return response.json();
434
+ }}
435
+ >
436
+ Visit website
437
+ </LinkPreview>;
97
438
  ```
98
439
 
99
- The stylesheet registers package sources for Tailwind class scanning. Run `npm run check` from frontend for TypeScript, compiled token/responsive checks, and component interaction tests. The optional Windows Rolldown binding is pinned to the runner's version to work around npm omitting it during install.
440
+ Implement the example endpoint in your application and return `{ title?, description?, image? }`. Requests start on preview intent. The resolver receives an abort signal; the component caches successful results and ignores stale responses. Use supplied `preview` metadata for local previews, or explicitly choose `provider="microlink"` for the external service.
100
441
 
101
- The skill source is `frontend/skills/sky-ui-tokens/SKILL.md`. Browse `/design-system` or `/design-system/analytics` in the Next.js app. The ecommerce app is still planned. Use the frontend Playwright tests for real viewport verification; jsdom tests do not replace it.
442
+ The catalog exposes controlled/timed loading, looping, image-loader geometry/easing, and custom preview examples. Regression coverage includes IME submission, mocked Microlink requests, simultaneous comparison hydration, and responsive dragging with live reduced-motion changes.
@@ -0,0 +1,89 @@
1
+ @property --sky-border-angle { syntax: "<angle>"; inherits: false; initial-value: 0deg; }
2
+ @layer components {
3
+ .sky-vanish { animation: sky-vanish var(--sky-duration-vanish) var(--sky-ease) both; }
4
+ @keyframes sky-vanish { to { opacity: 0; filter: blur(var(--sky-space-sm)); translate: var(--sky-space-panel) calc(-1 * var(--sky-space-panel)); } }
5
+ .sky-gooey-decoration { z-index: -1; background: var(--secondary); border-radius: var(--sky-radius-capsule); }
6
+ .sky-gooey { isolation: isolate; }
7
+ .sky-compare { touch-action: pan-y; }
8
+ .sky-compare[data-orientation="vertical"] { touch-action: pan-x; }
9
+ .sky-compare-divider { background: var(--primary); }
10
+ .sky-compare[data-orientation="horizontal"] .sky-compare-divider { width: var(--sky-stroke); }
11
+ .sky-compare[data-orientation="vertical"] .sky-compare-divider { height: var(--sky-stroke); }
12
+ .sky-compare-handle { left: 50%; top: 50%; translate: -50% -50%; }
13
+ .sky-compare[data-variant="modern"][data-dragging="true"] .sky-compare-divider { box-shadow: 0 0 var(--sky-space-inline) var(--info); border-radius: 50%; }
14
+ .sky-compare-particle { position: absolute; top: calc(var(--sky-index) * 16%); width: var(--sky-space-xs); height: var(--sky-space-xs); border-radius: 50%; background: var(--primary); animation: sky-particle var(--sky-duration-particle) ease-out infinite; animation-delay: calc(var(--sky-index) * var(--sky-duration-particle-delay)); }
15
+ @keyframes sky-particle { to { translate: var(--sky-space-panel) var(--sky-space-panel); opacity: 0; } }
16
+ .sky-infinite-grid { height: var(--sky-gallery-height); }
17
+ .sky-gallery-tile { border-width: var(--sky-space-xs); border-color: var(--muted); cursor: grab; }
18
+ .sky-cover-beams { background: repeating-linear-gradient(0deg, transparent 0, transparent var(--sky-space-sm), var(--primary) var(--sky-space-sm), transparent calc(var(--sky-space-sm) + var(--sky-stroke))); opacity: .2; }
19
+ .sky-cover[data-running="true"]:is(:hover,:focus-within) .sky-cover-beams { animation: sky-cover-flow var(--sky-duration-cover) linear infinite; }
20
+ @keyframes sky-cover-flow { to { translate: 25% 0; } }
21
+ .sky-flap { display: inline-block; min-width: 1ch; border: var(--sky-stroke) solid var(--border); border-radius: var(--sky-radius-control); padding: var(--sky-space-xs); background: var(--secondary); font-family: var(--sky-font-mono); transition: transform var(--sky-duration-enter); }
22
+ .sky-word-reveal { transition: opacity var(--sky-duration-enter); }
23
+ .sky-colourful[data-running="true"] > span { display: inline-block; animation: sky-color-float var(--sky-duration-orbit) ease-in-out infinite; animation-delay: calc(var(--sky-index) * var(--sky-duration-fast)); }
24
+ @keyframes sky-color-float { 50% { translate: 0 calc(-1 * var(--sky-space-xs)); } }
25
+ .sky-squiggly[data-running="true"] { animation: sky-squiggle var(--sky-duration-loading) steps(4) infinite; }
26
+ @keyframes sky-squiggle { 50% { transform: skewX(2deg); } }
27
+ .sky-text-hover { background: radial-gradient(circle at var(--sky-text-position, 50%) 50%, var(--primary), var(--info), var(--foreground)); color: transparent; background-clip: text; -webkit-text-stroke: var(--sky-stroke) var(--primary); }
28
+ .sky-hero-highlight { background-color: var(--card); background-image: radial-gradient(var(--border) var(--sky-stroke), transparent var(--sky-stroke)); background-size: var(--sky-space-lg) var(--sky-space-lg); }
29
+ .sky-code .token.comment, .sky-code .token.prolog { color: var(--muted-foreground); }
30
+ .sky-code .token.keyword, .sky-code .token.tag { color: var(--primary); }
31
+ .sky-code .token.string, .sky-code .token.attr-value { color: var(--success); }
32
+ .sky-code .token.number, .sky-code .token.boolean { color: var(--info); }
33
+ .sky-code .token.function { color: var(--warning); }
34
+ .sky-map-arc { stroke-dasharray: 1; animation: sky-path-draw var(--sky-duration-orbit) ease-in-out infinite alternate; }
35
+ .sky-navbar { width: 100%; top: var(--sky-nav-offset); z-index: var(--sky-layer-pinned); }
36
+ .sky-navbar[data-position="sticky"] { position: sticky; }
37
+ .sky-navbar[data-position="fixed"] { position: fixed; inset-inline: var(--sky-nav-offset); width: auto; }
38
+ .sky-navbar[data-compact="true"] { max-width: var(--sky-dialog-lg); }
39
+ .sky-sidebar-panel { width: var(--sky-header-height); }
40
+ .sky-sidebar-panel[data-expanded="true"] { width: var(--sky-sidebar); }
41
+ .sky-notch[data-align="center"] { margin-inline: auto; }
42
+ .sky-notch[data-align="end"] { margin-inline-start: auto; }
43
+ .sky-notch[data-fixed="true"] { position: fixed; z-index: var(--sky-layer-popover); max-width: calc(100% - var(--sky-space-page) * 2); }
44
+ .sky-notch[data-fixed="true"][data-position="top"] { top: var(--sky-nav-offset); }
45
+ .sky-notch[data-fixed="true"][data-position="bottom"] { bottom: var(--sky-nav-offset); }
46
+ .sky-notch[data-fixed="true"][data-align="center"] { left: 50%; translate: -50% 0; }
47
+ .sky-notch[data-fixed="true"][data-align="start"] { inset-inline-start: var(--sky-nav-offset); }
48
+ .sky-notch[data-fixed="true"][data-align="end"] { inset-inline-end: var(--sky-nav-offset); }
49
+ .sky-banner { position: sticky; top: 0; z-index: var(--sky-layer-pinned); }
50
+ .sky-tab-stack { box-shadow: 0 var(--sky-space-xs) 0 var(--border), 0 var(--sky-space-sm) 0 var(--muted); }
51
+ .sky-gradient-border { position: relative; isolation: isolate; border: var(--sky-stroke) solid transparent; background: linear-gradient(var(--card), var(--card)) padding-box, conic-gradient(from var(--sky-border-angle), var(--border), var(--primary), var(--info), var(--border)) border-box; }
52
+ .sky-gradient-border::before { content: ""; pointer-events: none; position: absolute; inset: 0; border-radius: inherit; box-shadow: 0 0 var(--sky-glow-radius) color-mix(in oklch, var(--primary) 25%, transparent); opacity: 0; transition: opacity var(--sky-duration-enter) var(--sky-ease); }
53
+ .sky-gradient-border:not(:disabled):not([aria-disabled="true"]):is(:hover,:focus-visible)::before { opacity: 1; }
54
+ .sky-gradient-border:not(:disabled):not([aria-disabled="true"]) { animation: sky-border-turn var(--sky-duration-orbit) linear infinite; }
55
+ @keyframes sky-border-turn { to { --sky-border-angle: 360deg; } }
56
+ .sky-loader { --sky-loader-dot-size: var(--sky-icon); }
57
+ .sky-loader[data-size="sm"] { --sky-loader-dot-size: var(--sky-space-sm); }
58
+ .sky-loader[data-size="lg"] { --sky-loader-dot-size: var(--sky-space-xl); }
59
+ .sky-loader-dot { display: block; width: var(--sky-loader-dot-size); height: var(--sky-loader-dot-size); border-radius: var(--sky-radius-pill); background: linear-gradient(var(--primary), var(--info)); }
60
+ .sky-loader-symbol { width: calc(var(--sky-loader-dot-size) * 2); height: calc(var(--sky-loader-dot-size) * 2); }
61
+ .sky-loader[data-running="true"][data-variant="dots"] .sky-loader-dot { animation: sky-dot-bounce var(--sky-duration-loading) var(--sky-ease) infinite; animation-delay: calc(var(--sky-index) * var(--sky-duration-fast)); }
62
+ .sky-loader[data-running="true"][data-variant="sliding-dots"] .sky-loader-dot { animation: sky-dot-slide var(--sky-duration-loading) var(--sky-ease) infinite; animation-delay: calc(var(--sky-index) * var(--sky-duration-fast)); }
63
+ .sky-loader[data-running="true"] .sky-loader-path { stroke-dasharray: 1; animation: sky-path-draw var(--sky-duration-loading) ease-in-out infinite alternate; }
64
+ .sky-loader[data-running="true"] .sky-loader-glitch { animation: sky-glitch var(--sky-duration-orbit) steps(1) infinite; }
65
+ .sky-loader[data-running="true"] .sky-loader-shimmer { animation: sky-pulse var(--sky-duration-loading) ease-in-out infinite alternate; }
66
+ @keyframes sky-dot-bounce { 50% { translate: 0 var(--sky-space-sm); opacity: var(--sky-opacity-disabled); } }
67
+ @keyframes sky-dot-slide { 50% { translate: var(--sky-space-sm) 0; } }
68
+ @keyframes sky-path-draw { from { stroke-dashoffset: 1; } to { stroke-dashoffset: 0; fill: var(--secondary); } }
69
+ @keyframes sky-glitch { 90% { transform: skewX(0); text-shadow: none; } 92% { transform: skewX(-8deg); text-shadow: var(--sky-stroke) 0 var(--info); } 94% { transform: skewX(5deg); text-shadow: calc(-1 * var(--sky-stroke)) 0 var(--primary); } 96% { transform: none; text-shadow: none; } }
70
+ [data-sky-paused="true"] *, [data-sky-paused="true"] *::before, [data-sky-paused="true"] *::after { animation-play-state: paused !important; }
71
+ .sky-advanced-surface { border: var(--sky-stroke) solid var(--border); border-radius: var(--sky-radius-surface); background: var(--card); color: var(--card-foreground); }
72
+ .sky-advanced-surface[data-variant="classic"] { border-radius: var(--sky-radius-control); }
73
+ .sky-advanced-surface[data-variant="modern"] { border-radius: var(--sky-radius-lg); box-shadow: var(--sky-shadow-raised); }
74
+ }
75
+
76
+ @layer components {
77
+ .sky-compare[data-variant="modern"][data-dragging="true"] .sky-compare-divider::before {
78
+ content: ""; position: absolute; inset: 0; border-radius: 50%;
79
+ border: var(--sky-stroke) solid var(--primary);
80
+ box-shadow: var(--sky-stroke) 0 var(--info), calc(-1 * var(--sky-stroke)) 0 var(--warning);
81
+ backdrop-filter: blur(var(--sky-space-xs));
82
+ }
83
+ .sky-compare[data-orientation="horizontal"][data-dragging="true"] .sky-compare-divider::before {
84
+ width: var(--sky-compare-bend); translate: -50% 0;
85
+ }
86
+ .sky-compare[data-orientation="vertical"][data-dragging="true"] .sky-compare-divider::before {
87
+ height: var(--sky-compare-bend); translate: 0 -50%;
88
+ }
89
+ }
@@ -2,13 +2,14 @@
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import * as Primitive from "@radix-ui/react-accordion";
4
4
  import { cn } from "../lib/utils.js";
5
+ import { Icon } from "./icon.js";
5
6
  export const Accordion = Primitive.Root;
6
7
  export function AccordionItem({ className, ...props }) {
7
8
  return _jsx(Primitive.Item, { className: cn("sky-border rounded-control border-border", className), ...props });
8
9
  }
9
10
  export function AccordionTrigger({ className, children, ...props }) {
10
- return _jsx(Primitive.Header, { children: _jsxs(Primitive.Trigger, { className: cn("sky-focus sky-disabled flex min-h-touch w-full items-center justify-between gap-control rounded-control px-panel py-control text-start text-label font-medium", className), ...props, children: [children, _jsx("span", { "aria-hidden": "true", children: "\u2304" })] }) });
11
+ return _jsx(Primitive.Header, { children: _jsxs(Primitive.Trigger, { className: cn("sky-disclosure sky-focus sky-disabled flex min-h-touch w-full items-center justify-between gap-control rounded-control px-panel py-control text-start text-label font-medium", className), ...props, children: [children, _jsx(Icon, { name: "chevron-down", className: "sky-disclosure-icon text-muted-foreground" })] }) });
11
12
  }
12
13
  export function AccordionContent({ className, ...props }) {
13
- return _jsx(Primitive.Content, { className: cn("px-panel pb-panel text-label leading-body text-muted-foreground", className), ...props });
14
+ return _jsx(Primitive.Content, { className: cn("sky-enter px-panel pb-panel text-label leading-body text-muted-foreground", className), ...props });
14
15
  }
@@ -0,0 +1,40 @@
1
+ import { type ComponentPropsWithRef, type FormEvent } from "react";
2
+ import { type InputProps } from "./fields.js";
3
+ import type { SurfaceVariant } from "./navigation.js";
4
+ export declare function FormPanel({ variant, className, ...props }: ComponentPropsWithRef<"form"> & {
5
+ variant?: SurfaceVariant;
6
+ }): import("react").JSX.Element;
7
+ export type VanishInputProps = Omit<InputProps, "onSubmit" | "value" | "defaultValue"> & {
8
+ label: string;
9
+ value: string;
10
+ onValueChange: (value: string) => void;
11
+ onSubmit: (value: string, event: FormEvent<HTMLFormElement>) => void;
12
+ placeholders?: readonly string[];
13
+ };
14
+ export declare function PlaceholdersAndVanishInput({ label, value, onValueChange, onSubmit, placeholders, disabled, readOnly, id: suppliedId, className, ...props }: VanishInputProps): import("react").JSX.Element;
15
+ export type GooeyInputProps = InputProps & {
16
+ label: string;
17
+ onValueChange?: (value: string) => void;
18
+ onOpenChange?: (open: boolean) => void;
19
+ };
20
+ export declare function GooeyInput({ label, onValueChange, onOpenChange, className, id: suppliedId, ...props }: GooeyInputProps): import("react").JSX.Element;
21
+ export type FileRejection = {
22
+ file: File;
23
+ reason: string;
24
+ };
25
+ export type FileUploadProps = {
26
+ files?: readonly File[];
27
+ defaultFiles?: readonly File[];
28
+ onFilesChange?: (files: File[]) => void;
29
+ onReject?: (files: FileRejection[]) => void;
30
+ accept?: string;
31
+ multiple?: boolean;
32
+ maxFiles?: number;
33
+ maxSize?: number;
34
+ disabled?: boolean;
35
+ label?: string;
36
+ progress?: readonly number[];
37
+ variant?: SurfaceVariant;
38
+ className?: string;
39
+ };
40
+ export declare function FileUpload({ files: controlled, defaultFiles, onFilesChange, onReject, accept, multiple, maxFiles, maxSize, disabled, label, progress, variant, className }: FileUploadProps): import("react").JSX.Element;