@ziyarago/ui 0.1.1 → 0.3.0

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 (53) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +1 -0
  3. package/dist/llms-full.txt +100 -8
  4. package/dist/llms.txt +1 -1
  5. package/dist/manifest.json +412 -20
  6. package/dist/style.css +73 -4
  7. package/docs/INTEGRATION.md +153 -0
  8. package/docs/MIGRATION.md +453 -0
  9. package/package.json +87 -7
  10. package/src/compat/index.js +468 -0
  11. package/src/compat/map.js +282 -0
  12. package/src/compat/resolver.js +22 -0
  13. package/src/compat/vite.js +29 -0
  14. package/src/core/bools.js +4 -0
  15. package/src/core/components.js +31 -23
  16. package/src/core/components2.js +20 -16
  17. package/src/core/components4.js +3 -3
  18. package/src/core/components6.js +25 -16
  19. package/src/core/index.js +2 -0
  20. package/src/i18n/components/CopyButton.js +3 -0
  21. package/src/i18n/components/index.js +5 -0
  22. package/src/i18n/index.js +48 -0
  23. package/src/meta/actions.js +10 -3
  24. package/src/meta/data.js +8 -3
  25. package/src/meta/feedback.js +2 -1
  26. package/src/meta/forms.js +44 -4
  27. package/src/meta/media.js +7 -2
  28. package/src/meta/navigation.js +3 -0
  29. package/src/meta/overlay.js +8 -2
  30. package/src/nuxt/module.mjs +2 -2
  31. package/src/nuxt/plugin.mjs +6 -5
  32. package/src/react/index.js +202 -8
  33. package/src/resolver.js +33 -0
  34. package/src/styles/components.css +7 -0
  35. package/src/styles/components6.css +2 -0
  36. package/src/styles/effects.css +6 -4
  37. package/src/styles/extras.css +55 -0
  38. package/src/styles/index.css +1 -0
  39. package/src/theme.js +16 -4
  40. package/src/vue/global.js +2 -0
  41. package/src/vue/index.js +13 -5
  42. package/types/compat-resolver.d.ts +12 -0
  43. package/types/compat-vite.d.ts +11 -0
  44. package/types/compat.d.ts +176 -0
  45. package/types/i18n.d.ts +12 -0
  46. package/types/meta.d.ts +4 -0
  47. package/types/nuxt.d.ts +1 -1
  48. package/types/react.d.ts +6282 -186
  49. package/types/resolver.d.ts +14 -0
  50. package/types/shared.d.ts +7 -7
  51. package/types/theme.d.ts +20 -1
  52. package/types/vue-global.d.ts +193 -0
  53. package/types/vue.d.ts +6178 -186
package/types/resolver.d.ts ADDED
@@ -0,0 +1,14 @@
1
+ export interface ZiyaragoUiResolverOptions {
2
+ /** Component prefix used in templates. Default 'Ui'. */
3
+ prefix?: string;
4
+ /** true: also import '@ziyarago/ui/style.css'; a string: import that module instead. Default false (import the css once in main.ts). */
5
+ css?: boolean | string;
6
+ /** Component names, without prefix, that must not be auto-imported (for example ['Button']). */
7
+ exclude?: string[];
8
+ /** Module the components come from. Default '@ziyarago/ui/vue'. */
9
+ from?: string;
10
+ }
11
+ export interface ZiyaragoUiResolverResult { name: string; from: string; sideEffects?: string }
12
+ export interface ZiyaragoUiResolver { type: 'component'; resolve(name: string): ZiyaragoUiResolverResult | undefined }
13
+ export function ZiyaragoUiResolver(options?: ZiyaragoUiResolverOptions): ZiyaragoUiResolver;
14
+ export default ZiyaragoUiResolver;
package/types/shared.d.ts CHANGED
@@ -1,17 +1,17 @@
1
1
  // Shared prop types. Hand-written; the rest of the components are typed as Record<string, any> until their props settle.
2
2
  export type Tone = 'brand' | 'sky' | 'success' | 'warning' | 'danger' | 'neutral';
3
3
  export type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
4
- export interface ButtonProps { variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'inverse' | 'tonal' | 'outlined' | 'text' | 'elevated'; tone?: Tone; size?: Size; icon?: string; iconRight?: string; block?: boolean; loading?: boolean; disabled?: boolean; onClick?: (e: MouseEvent) => void }
4
+ export interface ButtonProps { variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'inverse' | 'tonal' | 'outlined' | 'text' | 'elevated'; tone?: Tone; size?: Size; icon?: string; iconRight?: string; block?: boolean; loading?: boolean; disabled?: boolean; type?: 'button' | 'submit' | 'reset'; iconOnly?: boolean; title?: string; onClick?: (e: MouseEvent) => void }
5
5
  export interface ChipProps { tone?: Tone; variant?: 'tonal' | 'outlined' | 'solid'; size?: Size; pill?: boolean; icon?: string; onClose?: () => void }
6
- export interface BadgeProps { tone?: 'brand' | 'success' | 'warning' | 'danger' | 'info'; dot?: boolean; size?: Size }
6
+ export interface BadgeProps { tone?: 'brand' | 'success' | 'warning' | 'danger' | 'info' | 'inverse'; dot?: boolean; shape?: 'pill' | 'square'; size?: Size }
7
7
  export interface IconTileProps { icon: string; tone?: Tone; size?: number; shape?: 'square' | 'circle' }
8
- export interface CardProps { size?: Size; title?: string; subtitle?: string; variant?: 'default' | 'inverse'; actions?: unknown }
8
+ export interface CardProps { size?: Size; title?: string; subtitle?: string; variant?: 'default' | 'inverse' | 'gradient' | 'outline'; tone?: Tone | 'rose' | 'violet'; intensity?: 'vivid'; padding?: 'none'; interactive?: boolean; header?: unknown; footer?: unknown; actions?: unknown; onClick?: (e: MouseEvent) => void }
9
9
  export interface NavItem { value?: string; label?: string; icon?: string; count?: number | string; badge?: number | string; group?: string }
10
10
  export interface AppShellProps { nav?: 'top' | 'side'; items: NavItem[]; modelValue?: string; collapsible?: boolean; collapsed?: boolean; frame?: boolean; brand?: unknown; actions?: unknown; footer?: unknown; onCollapse?: (v: boolean) => void }
11
- export interface Column<R = any> { key: string; label: string; sortable?: boolean; num?: boolean; render?: (value: any, row: R) => unknown }
12
- export interface DataTableProps<R = any> { columns: Column<R>[]; rows: (R & { id: string | number })[]; selected?: (string | number)[]; sortKey?: string; sortDir?: 'asc' | 'desc'; onSelect?: (ids: (string | number)[]) => void; onSort?: (key: string, dir: 'asc' | 'desc') => void }
13
- export interface TextFieldProps { label?: string; icon?: string; modelValue?: string; placeholder?: string; hint?: string; error?: string; type?: string; variant?: 'filled' | 'underlined' | 'solo'; density?: 'compact'; disabled?: boolean; readonly?: boolean; onChange?: (v: string) => void }
14
- export interface SelectProps { label?: string; options: { value: string | number; label: string }[]; modelValue?: string | number; placeholder?: string; onChange?: (v: any) => void }
11
+ export interface Column<R = any> { key: string; label: string; sortable?: boolean; num?: boolean; align?: 'left' | 'center' | 'right'; width?: string; render?: (value: any, row: R) => unknown }
12
+ export interface DataTableProps<R = any> { columns: Column<R>[]; rows: (R & { id: string | number })[]; selected?: (string | number)[]; sortKey?: string; sortDir?: 'asc' | 'desc'; onSelect?: (ids: (string | number)[]) => void; onSort?: (key: string, dir: 'asc' | 'desc') => void; onRowClick?: (row: R, index: number) => void; empty?: unknown }
13
+ export interface TextFieldProps { label?: string; icon?: string; modelValue?: string; placeholder?: string; hint?: string; error?: string; type?: string; variant?: 'filled' | 'underlined' | 'solo'; density?: 'compact'; disabled?: boolean; readonly?: boolean; required?: boolean; name?: string; autocomplete?: string; min?: number | string; max?: number | string; step?: number | string; maxlength?: number; minlength?: number; inputmode?: string; pattern?: string; spellcheck?: boolean; autofocus?: boolean; prefix?: unknown; onChange?: (v: string) => void; onInput?: (e: Event) => void; onBlur?: (e: FocusEvent) => void; onFocus?: (e: FocusEvent) => void; onKeydown?: (e: KeyboardEvent) => void }
14
+ export interface SelectProps { label?: string; options: { value: string | number; label: string }[]; modelValue?: string | number; placeholder?: string; hint?: string; error?: string; required?: boolean; name?: string; onChange?: (v: any) => void }
15
15
  export type Rule = (value: any) => true | string;
16
16
  export const rules: { required(): Rule; email(): Rule; url(): Rule; digits(n: number): Rule; alpha(): Rule; alphaDash(): Rule; minLength(n: number): Rule; maxLength(n: number): Rule; range(a: number, b: number): Rule; regex(re: RegExp, msg?: string): Rule; confirmed(get: () => unknown): Rule; password(): Rule };
17
17
  export function setIconBase(base: string): void;
package/types/theme.d.ts CHANGED
@@ -1,6 +1,25 @@
1
1
  export type Theme = 'dark' | 'light';
2
2
  export type Palette = 'gold' | 'tamam';
3
3
  export type Dir = 'ltr' | 'rtl';
4
- export interface UiTheme { readonly theme: Theme; readonly palette: Palette; readonly dir: Dir; readonly palettes: Palette[]; setTheme(t: Theme): void; toggleTheme(): void; setPalette(p: Palette): void; setDir(d: Dir): void; setLocale(code: string): void }
4
+ export type Motion = 'auto' | 'on' | 'off';
5
+ export type Effects = 'auto' | 'full' | 'lite';
6
+ export type Background = 'none' | 'aurora' | 'sunset' | 'ocean' | 'emerald' | 'rose' | 'mesh';
7
+ export interface UiThemeState { theme: Theme; palette: Palette; dir: Dir; motion: Motion; effects: Effects; bg: Background }
8
+ export interface UiTheme {
9
+ readonly theme: Theme; readonly palette: Palette; readonly dir: Dir;
10
+ readonly motion: Motion; readonly effects: Effects; readonly bg: Background;
11
+ readonly resolved: { motion: 'on' | 'off'; effects: 'full' | 'lite' };
12
+ readonly palettes: Palette[]; readonly backgrounds: Background[];
13
+ setTheme(t: Theme): void; toggleTheme(): void; setPalette(p: Palette): void; setDir(d: Dir): void; setLocale(code: string): void;
14
+ setMotion(m: Motion): void; setEffects(e: Effects): void; setBackground(b: Background): void;
15
+ subscribe(fn: (state: UiThemeState) => void): () => void;
16
+ snapshot(): UiThemeState;
17
+ }
5
18
  export const PALETTES: Palette[];
19
+ export const BACKGROUNDS: Background[];
20
+ /** Inline script for <head>: applies the saved theme/palette/dir before first paint. Inject it in SSR layouts (Next: <script dangerouslySetInnerHTML>). */
21
+ export const themeInitScript: string;
6
22
  export function useUiTheme(): UiTheme;
23
+
24
+ export function configureTheme(defaults?: Partial<{ theme: 'dark' | 'light'; palette: string; dir: 'ltr' | 'rtl'; motion: 'auto' | 'on' | 'off'; effects: 'auto' | 'full' | 'lite'; bg: string }>): void;
25
+ export function applySavedLocale(): void;
package/types/vue-global.d.ts ADDED
@@ -0,0 +1,193 @@
1
+ // generated by scripts/types.mjs from src/meta — do not edit
2
+ // Opt in to template typing for globally registered components (app.use(ui)): add
3
+ // import '@ziyarago/ui/vue/global' (in env.d.ts) or /// <reference types="@ziyarago/ui/vue/global" />
4
+ // Not needed with unplugin-vue-components (it writes its own components.d.ts) or Nuxt (generated).
5
+ import type * as Ui from './vue';
6
+
7
+ declare module 'vue' {
8
+ export interface GlobalComponents {
9
+ UiAccordion: typeof Ui.UiAccordion;
10
+ UiActionCard: typeof Ui.UiActionCard;
11
+ UiActionRail: typeof Ui.UiActionRail;
12
+ UiActionsheet: typeof Ui.UiActionsheet;
13
+ UiAlert: typeof Ui.UiAlert;
14
+ UiAppShell: typeof Ui.UiAppShell;
15
+ UiAuthLayout: typeof Ui.UiAuthLayout;
16
+ UiAuthSplit: typeof Ui.UiAuthSplit;
17
+ UiAvatar: typeof Ui.UiAvatar;
18
+ UiBadge: typeof Ui.UiBadge;
19
+ UiBanner: typeof Ui.UiBanner;
20
+ UiBookingCard: typeof Ui.UiBookingCard;
21
+ UiBottomSheet: typeof Ui.UiBottomSheet;
22
+ UiBox: typeof Ui.UiBox;
23
+ UiBreadcrumbs: typeof Ui.UiBreadcrumbs;
24
+ UiButton: typeof Ui.UiButton;
25
+ UiCalendar: typeof Ui.UiCalendar;
26
+ UiCalendarView: typeof Ui.UiCalendarView;
27
+ UiCallCard: typeof Ui.UiCallCard;
28
+ UiCallRow: typeof Ui.UiCallRow;
29
+ UiCard: typeof Ui.UiCard;
30
+ UiCarousel: typeof Ui.UiCarousel;
31
+ UiCenter: typeof Ui.UiCenter;
32
+ UiChartCard: typeof Ui.UiChartCard;
33
+ UiChatAi: typeof Ui.UiChatAi;
34
+ UiCheckbox: typeof Ui.UiCheckbox;
35
+ UiChip: typeof Ui.UiChip;
36
+ UiChipInput: typeof Ui.UiChipInput;
37
+ UiCode: typeof Ui.UiCode;
38
+ UiCodeInput: typeof Ui.UiCodeInput;
39
+ UiColorPicker: typeof Ui.UiColorPicker;
40
+ UiCombobox: typeof Ui.UiCombobox;
41
+ UiCommandBar: typeof Ui.UiCommandBar;
42
+ UiCommandPalette: typeof Ui.UiCommandPalette;
43
+ UiConfirmDialog: typeof Ui.UiConfirmDialog;
44
+ UiContactPanel: typeof Ui.UiContactPanel;
45
+ UiContextMenu: typeof Ui.UiContextMenu;
46
+ UiCopyButton: typeof Ui.UiCopyButton;
47
+ UiCountryRow: typeof Ui.UiCountryRow;
48
+ UiDataGroup: typeof Ui.UiDataGroup;
49
+ UiDataState: typeof Ui.UiDataState;
50
+ UiDataTable: typeof Ui.UiDataTable;
51
+ UiDatePicker: typeof Ui.UiDatePicker;
52
+ UiDealCard: typeof Ui.UiDealCard;
53
+ UiDescriptions: typeof Ui.UiDescriptions;
54
+ UiDivider: typeof Ui.UiDivider;
55
+ UiDrawer: typeof Ui.UiDrawer;
56
+ UiDropdown: typeof Ui.UiDropdown;
57
+ UiEmptyState: typeof Ui.UiEmptyState;
58
+ UiErrorPage: typeof Ui.UiErrorPage;
59
+ UiFab: typeof Ui.UiFab;
60
+ UiFileUpload: typeof Ui.UiFileUpload;
61
+ UiFilterChips: typeof Ui.UiFilterChips;
62
+ UiFooter: typeof Ui.UiFooter;
63
+ UiFormField: typeof Ui.UiFormField;
64
+ UiFullscreenDialog: typeof Ui.UiFullscreenDialog;
65
+ UiGallery: typeof Ui.UiGallery;
66
+ UiGrid: typeof Ui.UiGrid;
67
+ UiGroupedSelect: typeof Ui.UiGroupedSelect;
68
+ UiGuestCard: typeof Ui.UiGuestCard;
69
+ UiHStack: typeof Ui.UiHStack;
70
+ UiHeading: typeof Ui.UiHeading;
71
+ UiHeroBanner: typeof Ui.UiHeroBanner;
72
+ UiHotelCard: typeof Ui.UiHotelCard;
73
+ UiHoverCard: typeof Ui.UiHoverCard;
74
+ UiIcon: typeof Ui.UiIcon;
75
+ UiIconButton: typeof Ui.UiIconButton;
76
+ UiIconTile: typeof Ui.UiIconTile;
77
+ UiImageUpload: typeof Ui.UiImageUpload;
78
+ UiImageViewer: typeof Ui.UiImageViewer;
79
+ UiIncomingCall: typeof Ui.UiIncomingCall;
80
+ UiInlineEdit: typeof Ui.UiInlineEdit;
81
+ UiIntegrationCard: typeof Ui.UiIntegrationCard;
82
+ UiKanbanCard: typeof Ui.UiKanbanCard;
83
+ UiKanbanColumn: typeof Ui.UiKanbanColumn;
84
+ UiKbd: typeof Ui.UiKbd;
85
+ UiKpiInline: typeof Ui.UiKpiInline;
86
+ UiKpiTile: typeof Ui.UiKpiTile;
87
+ UiLazyImage: typeof Ui.UiLazyImage;
88
+ UiLeadCard: typeof Ui.UiLeadCard;
89
+ UiLink: typeof Ui.UiLink;
90
+ UiLiquidGlass: typeof Ui.UiLiquidGlass;
91
+ UiLoadingOverlay: typeof Ui.UiLoadingOverlay;
92
+ UiLoginForm: typeof Ui.UiLoginForm;
93
+ UiMap: typeof Ui.UiMap;
94
+ UiMenu: typeof Ui.UiMenu;
95
+ UiMiniChart: typeof Ui.UiMiniChart;
96
+ UiModal: typeof Ui.UiModal;
97
+ UiMultiSelect: typeof Ui.UiMultiSelect;
98
+ UiNotificationBell: typeof Ui.UiNotificationBell;
99
+ UiNumberInput: typeof Ui.UiNumberInput;
100
+ UiOccupancyChart: typeof Ui.UiOccupancyChart;
101
+ UiOptionCard: typeof Ui.UiOptionCard;
102
+ UiOptionCards: typeof Ui.UiOptionCards;
103
+ UiPageAccount: typeof Ui.UiPageAccount;
104
+ UiPageAuth: typeof Ui.UiPageAuth;
105
+ UiPageBookings: typeof Ui.UiPageBookings;
106
+ UiPageCatalog: typeof Ui.UiPageCatalog;
107
+ UiPageCrm: typeof Ui.UiPageCrm;
108
+ UiPageDashboard: typeof Ui.UiPageDashboard;
109
+ UiPageDetail: typeof Ui.UiPageDetail;
110
+ UiPageFaq: typeof Ui.UiPageFaq;
111
+ UiPageForm: typeof Ui.UiPageForm;
112
+ UiPageHeader: typeof Ui.UiPageHeader;
113
+ UiPageOrder: typeof Ui.UiPageOrder;
114
+ UiPagePatterns: typeof Ui.UiPagePatterns;
115
+ UiPagePricing: typeof Ui.UiPagePricing;
116
+ UiPageProfile: typeof Ui.UiPageProfile;
117
+ UiPageSettings: typeof Ui.UiPageSettings;
118
+ UiPageStatus: typeof Ui.UiPageStatus;
119
+ UiPageUserList: typeof Ui.UiPageUserList;
120
+ UiPagination: typeof Ui.UiPagination;
121
+ UiPasswordInput: typeof Ui.UiPasswordInput;
122
+ UiPhoneInput: typeof Ui.UiPhoneInput;
123
+ UiPillSelect: typeof Ui.UiPillSelect;
124
+ UiPillTabs: typeof Ui.UiPillTabs;
125
+ UiPipelineBoard: typeof Ui.UiPipelineBoard;
126
+ UiPopconfirm: typeof Ui.UiPopconfirm;
127
+ UiPopover: typeof Ui.UiPopover;
128
+ UiPortal: typeof Ui.UiPortal;
129
+ UiPrayerTimes: typeof Ui.UiPrayerTimes;
130
+ UiPressable: typeof Ui.UiPressable;
131
+ UiPricingCard: typeof Ui.UiPricingCard;
132
+ UiProfileHeader: typeof Ui.UiProfileHeader;
133
+ UiProgress: typeof Ui.UiProgress;
134
+ UiRadioGroup: typeof Ui.UiRadioGroup;
135
+ UiRamadanTracker: typeof Ui.UiRamadanTracker;
136
+ UiRangeCalendar: typeof Ui.UiRangeCalendar;
137
+ UiRangeSlider: typeof Ui.UiRangeSlider;
138
+ UiRating: typeof Ui.UiRating;
139
+ UiRichEditor: typeof Ui.UiRichEditor;
140
+ UiRing: typeof Ui.UiRing;
141
+ UiRoomCalendar: typeof Ui.UiRoomCalendar;
142
+ UiRoomGrid: typeof Ui.UiRoomGrid;
143
+ UiSalesFunnel: typeof Ui.UiSalesFunnel;
144
+ UiScreensaver: typeof Ui.UiScreensaver;
145
+ UiScrollArea: typeof Ui.UiScrollArea;
146
+ UiSearchInput: typeof Ui.UiSearchInput;
147
+ UiSegBar: typeof Ui.UiSegBar;
148
+ UiSegmentedControl: typeof Ui.UiSegmentedControl;
149
+ UiSelect: typeof Ui.UiSelect;
150
+ UiSettingsSection: typeof Ui.UiSettingsSection;
151
+ UiSideNav: typeof Ui.UiSideNav;
152
+ UiSkeleton: typeof Ui.UiSkeleton;
153
+ UiSlider: typeof Ui.UiSlider;
154
+ UiSnackbar: typeof Ui.UiSnackbar;
155
+ UiSortable: typeof Ui.UiSortable;
156
+ UiSpinner: typeof Ui.UiSpinner;
157
+ UiSplitLayout: typeof Ui.UiSplitLayout;
158
+ UiStatLine: typeof Ui.UiStatLine;
159
+ UiStatRow: typeof Ui.UiStatRow;
160
+ UiStatStrip: typeof Ui.UiStatStrip;
161
+ UiStatsCard: typeof Ui.UiStatsCard;
162
+ UiStatusIcon: typeof Ui.UiStatusIcon;
163
+ UiStatusPage: typeof Ui.UiStatusPage;
164
+ UiStepDialog: typeof Ui.UiStepDialog;
165
+ UiStepForm: typeof Ui.UiStepForm;
166
+ UiStepper: typeof Ui.UiStepper;
167
+ UiSubNav: typeof Ui.UiSubNav;
168
+ UiSwitch: typeof Ui.UiSwitch;
169
+ UiSystemStatus: typeof Ui.UiSystemStatus;
170
+ UiTabTiles: typeof Ui.UiTabTiles;
171
+ UiTabs: typeof Ui.UiTabs;
172
+ UiTag: typeof Ui.UiTag;
173
+ UiText: typeof Ui.UiText;
174
+ UiTextField: typeof Ui.UiTextField;
175
+ UiTextarea: typeof Ui.UiTextarea;
176
+ UiTimePicker: typeof Ui.UiTimePicker;
177
+ UiTimeline: typeof Ui.UiTimeline;
178
+ UiToast: typeof Ui.UiToast;
179
+ UiToggleGroup: typeof Ui.UiToggleGroup;
180
+ UiTooltip: typeof Ui.UiTooltip;
181
+ UiTopNav: typeof Ui.UiTopNav;
182
+ UiTour: typeof Ui.UiTour;
183
+ UiTourCard: typeof Ui.UiTourCard;
184
+ UiTourPopover: typeof Ui.UiTourPopover;
185
+ UiTreeSelect: typeof Ui.UiTreeSelect;
186
+ UiTreeView: typeof Ui.UiTreeView;
187
+ UiUserCell: typeof Ui.UiUserCell;
188
+ UiVStack: typeof Ui.UiVStack;
189
+ UiValidatedField: typeof Ui.UiValidatedField;
190
+ UiVersusBar: typeof Ui.UiVersusBar;
191
+ }
192
+ }
193
+ export {};