pejay-ui 1.0.0 → 1.0.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 (2) hide show
  1. package/README.md +131 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -0,0 +1,131 @@
1
+ # pejay-ui CLI Commands
2
+
3
+ A lightweight CLI tool to initialize, add, and remove React UI components in your projects.
4
+
5
+ ## Commands
6
+
7
+ ### 1. Initialize Configuration
8
+ Initialize the configuration file `pejay-ui.json` in the root of your project.
9
+ ```bash
10
+ npx pejay-ui init
11
+ ```
12
+
13
+ ### 2. Add Component
14
+ Download and install a component, automatically setting up its utilities (like `cn`) and resolving component-to-component dependencies.
15
+ ```bash
16
+ npx pejay-ui add <component-name>
17
+ ```
18
+ *Example:* `npx pejay-ui add button` or `npx pejay-ui add form/date-picker`
19
+
20
+ ### 3. Remove Component
21
+ Safely delete a component's files, and clean up any unused utilities or package dependencies that were installed with it.
22
+ ```bash
23
+ npx pejay-ui remove <component-name>
24
+ ```
25
+ *Example:* `npx pejay-ui remove button`
26
+
27
+ ---
28
+
29
+ ## Available Components
30
+
31
+ Below is the list of components you can add. Markdown renderers (like GitHub and NPM) automatically place a **Copy icon** at the top right of each code block for one-click copying:
32
+
33
+ ### Buttons
34
+
35
+ * **`button`**: Premium interactive button supporting multiple variants (solid, soft, ghost), loaders, and custom hover tooltips.
36
+ ```bash
37
+ npx pejay-ui add button
38
+ ```
39
+
40
+ ### Form Inputs
41
+
42
+ * **`form/input`**: Standard text input field with validation, labels, and error messaging.
43
+ ```bash
44
+ npx pejay-ui add form/input
45
+ ```
46
+ * **`form/amount-input`**: Numeric input configured for currency entry with symbol prefixes and formatting.
47
+ ```bash
48
+ npx pejay-ui add form/amount-input
49
+ ```
50
+ * **`form/checkbox`**: Styled single checkbox input.
51
+ ```bash
52
+ npx pejay-ui add form/checkbox
53
+ ```
54
+ * **`form/checkbox-group`**: Group of checkboxes managing single or multiple selection states with item indices.
55
+ ```bash
56
+ npx pejay-ui add form/checkbox-group
57
+ ```
58
+ * **`form/email-input`**: Dedicated input for email addresses with prefix icon.
59
+ ```bash
60
+ npx pejay-ui add form/email-input
61
+ ```
62
+ * **`form/file-input`**: Premium dropzone-style file upload component supporting drag-and-drop and progress/preview states.
63
+ ```bash
64
+ npx pejay-ui add form/file-input
65
+ ```
66
+ * **`form/number-input`**: Input field for numerical values with increment/decrement steppers.
67
+ ```bash
68
+ npx pejay-ui add form/number-input
69
+ ```
70
+ * **`form/password-input`**: Secure text input with eye icon toggle to show/hide the password.
71
+ ```bash
72
+ npx pejay-ui add form/password-input
73
+ ```
74
+ * **`form/phone-input`**: Formatted input field for telephone numbers.
75
+ ```bash
76
+ npx pejay-ui add form/phone-input
77
+ ```
78
+ * **`form/radio`**: Styled radio selection dot.
79
+ ```bash
80
+ npx pejay-ui add form/radio
81
+ ```
82
+ * **`form/radio-group`**: Group of mutually exclusive radio options.
83
+ ```bash
84
+ npx pejay-ui add form/radio-group
85
+ ```
86
+ * **`form/range-slider`**: Slider controls for choosing values from a numeric range.
87
+ ```bash
88
+ npx pejay-ui add form/range-slider
89
+ ```
90
+ * **`form/switch`**: Styled toggle switch representing boolean options.
91
+ ```bash
92
+ npx pejay-ui add form/switch
93
+ ```
94
+ * **`form/textarea`**: Multiline text area input with character counter/limit indicators.
95
+ ```bash
96
+ npx pejay-ui add form/textarea
97
+ ```
98
+ * **`form/url-input`**: Styled input field specifically formatted for web addresses/links.
99
+ ```bash
100
+ npx pejay-ui add form/url-input
101
+ ```
102
+
103
+ ### Date & Time Pickers
104
+
105
+ * **`form/date-picker`**: Calendar-based date selector popover with inline month/year dropdowns.
106
+ ```bash
107
+ npx pejay-ui add form/date-picker
108
+ ```
109
+ * **`form/date-range-picker`**: Date range selector to pick start and end dates with highlight ranges.
110
+ ```bash
111
+ npx pejay-ui add form/date-range-picker
112
+ ```
113
+ * **`form/time-picker`**: Dropdown component for picking specific hours, minutes, and AM/PM.
114
+ ```bash
115
+ npx pejay-ui add form/time-picker
116
+ ```
117
+ * **`form/time-range-picker`**: Popover time selector for configuring custom duration intervals.
118
+ ```bash
119
+ npx pejay-ui add form/time-range-picker
120
+ ```
121
+
122
+ ### Dropdowns & Selects
123
+
124
+ * **`dropdown/select-input`**: Elegant single-select searchable dropdown input.
125
+ ```bash
126
+ npx pejay-ui add dropdown/select-input
127
+ ```
128
+ * **`dropdown/multiselect-input`**: Searchable multiselect dropdown which renders selected options as dismissible tag pills.
129
+ ```bash
130
+ npx pejay-ui add dropdown/multiselect-input
131
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pejay-ui",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "type": "module",
5
5
  "description": "react ui components",
6
6
  "bin": {