decoprofile 1.1.0 → 1.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.
- package/README.md +144 -6
- package/dist/components/Namespace.d.ts +1 -1
- package/dist/components/Profile.d.ts +1 -1
- package/dist/index.js +513 -1810
- package/dist/main/DecoProfile.d.ts +23 -3
- package/dist/types/decoration-names.d.ts +15 -0
- package/dist/types/index.d.ts +49 -11
- package/package.json +3 -2
- package/types/decoration-names.ts +555 -0
- package/types/index.ts +55 -12
package/README.md
CHANGED
|
@@ -1,15 +1,153 @@
|
|
|
1
|
-
#
|
|
1
|
+
# DecoProfile
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
DecoProfile is a React component library for adding stunning animated decorations to avatars, profiles, and namespace bars. Create Discord-style profile effects with ease.
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/decoprofile)
|
|
6
|
+
[](https://opensource.org/licenses/MIT)
|
|
7
|
+
|
|
8
|
+
## ✨ Features
|
|
9
|
+
|
|
10
|
+
- **Avatar Decorations** - Animated frames around user avatars
|
|
11
|
+
- **Profile Effects** - Stunning background animations for profile cards
|
|
12
|
+
- **Namespace Bars** - Animated video bars with avatar and username
|
|
13
|
+
- **TypeScript Support** - Full type safety with autocomplete for decoration names
|
|
14
|
+
- **Scalable** - All components support proportional scaling
|
|
15
|
+
|
|
16
|
+
## 📦 Installation
|
|
4
17
|
|
|
5
18
|
```bash
|
|
6
|
-
|
|
19
|
+
npm install decoprofile
|
|
7
20
|
```
|
|
8
21
|
|
|
9
|
-
|
|
22
|
+
```bash
|
|
23
|
+
yarn add decoprofile
|
|
24
|
+
```
|
|
10
25
|
|
|
11
26
|
```bash
|
|
12
|
-
bun
|
|
27
|
+
bun add decoprofile
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 🚀 Quick Start
|
|
31
|
+
|
|
32
|
+
```tsx
|
|
33
|
+
import {
|
|
34
|
+
AvatarDecoration,
|
|
35
|
+
ProfileDecoration,
|
|
36
|
+
NamespaceDecoration,
|
|
37
|
+
} from "decoprofile";
|
|
38
|
+
|
|
39
|
+
function App() {
|
|
40
|
+
const avatarUrl = "https://example.com/avatar.jpg";
|
|
41
|
+
|
|
42
|
+
return (
|
|
43
|
+
<div>
|
|
44
|
+
{/* Avatar with animated decoration */}
|
|
45
|
+
<AvatarDecoration name="Akuma" src={avatarUrl} size={160} />
|
|
46
|
+
|
|
47
|
+
{/* Profile card with background effect */}
|
|
48
|
+
<ProfileDecoration name="OnisCurse" src={avatarUrl}>
|
|
49
|
+
<h2>Username</h2>
|
|
50
|
+
<p>Premium User</p>
|
|
51
|
+
</ProfileDecoration>
|
|
52
|
+
|
|
53
|
+
{/* Namespace bar with video background */}
|
|
54
|
+
<NamespaceDecoration name="Reddragon" src={avatarUrl} userName="Player" />
|
|
55
|
+
</div>
|
|
56
|
+
);
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## 📚 Components
|
|
61
|
+
|
|
62
|
+
### AvatarDecoration
|
|
63
|
+
|
|
64
|
+
Adds animated decoration frames around user avatars.
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
<AvatarDecoration
|
|
68
|
+
name="Akuma" // Decoration name (autocomplete available)
|
|
69
|
+
src="/avatar.jpg" // User's avatar image URL
|
|
70
|
+
size={160} // Size in pixels (default: 160)
|
|
71
|
+
className="custom" // Optional CSS class
|
|
72
|
+
/>
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
| Prop | Type | Default | Description |
|
|
76
|
+
| ----------- | ---------------------- | -------- | ----------------------- |
|
|
77
|
+
| `name` | `AvatarDecorationName` | required | Decoration effect name |
|
|
78
|
+
| `src` | `string` | required | User's avatar image URL |
|
|
79
|
+
| `size` | `number` | `160` | Size in pixels |
|
|
80
|
+
| `className` | `string` | - | Optional CSS class |
|
|
81
|
+
|
|
82
|
+
### ProfileDecoration
|
|
83
|
+
|
|
84
|
+
Creates profile cards with animated background effects.
|
|
85
|
+
|
|
86
|
+
```tsx
|
|
87
|
+
<ProfileDecoration
|
|
88
|
+
name="OnisCurse" // Effect name (autocomplete available)
|
|
89
|
+
src="/avatar.jpg" // User's avatar image URL
|
|
90
|
+
scale={1} // Scale multiplier (default: 1)
|
|
91
|
+
>
|
|
92
|
+
<h2>Username</h2>
|
|
93
|
+
<p>Status text</p>
|
|
94
|
+
</ProfileDecoration>
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
| Prop | Type | Default | Description |
|
|
98
|
+
| ----------- | ----------------------- | -------- | ---------------------------------- |
|
|
99
|
+
| `name` | `ProfileDecorationName` | required | Profile effect name |
|
|
100
|
+
| `src` | `string` | required | User's avatar image URL |
|
|
101
|
+
| `children` | `ReactNode` | - | Content below avatar |
|
|
102
|
+
| `scale` | `number` | `1` | Scale multiplier (1 = 300px width) |
|
|
103
|
+
| `className` | `string` | - | Optional CSS class |
|
|
104
|
+
|
|
105
|
+
### NamespaceDecoration
|
|
106
|
+
|
|
107
|
+
Animated namespace bars with video background effects.
|
|
108
|
+
|
|
109
|
+
```tsx
|
|
110
|
+
<NamespaceDecoration
|
|
111
|
+
name="Reddragon" // Namespace name (autocomplete available)
|
|
112
|
+
src="/avatar.jpg" // User's avatar image URL
|
|
113
|
+
userName="Player" // Display name
|
|
114
|
+
scale={1} // Scale multiplier (default: 1)
|
|
115
|
+
/>
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
| Prop | Type | Default | Description |
|
|
119
|
+
| ----------- | ------------------------- | -------- | ------------------------------- |
|
|
120
|
+
| `name` | `NamespaceDecorationName` | required | Namespace effect name |
|
|
121
|
+
| `src` | `string` | - | User's avatar image URL |
|
|
122
|
+
| `userName` | `string` | `"User"` | Display name in the bar |
|
|
123
|
+
| `scale` | `number` | `1` | Scale multiplier (1 = 260x52px) |
|
|
124
|
+
| `className` | `string` | - | Optional CSS class |
|
|
125
|
+
|
|
126
|
+
## 🎨 Available Decorations
|
|
127
|
+
|
|
128
|
+
DecoProfile includes a wide variety of decorations:
|
|
129
|
+
|
|
130
|
+
- **334** Avatar decoration effects
|
|
131
|
+
- **84** Namespace decoration effects
|
|
132
|
+
- **116** Profile background effects
|
|
133
|
+
|
|
134
|
+
All decoration names provide TypeScript autocomplete for easy discovery.
|
|
135
|
+
|
|
136
|
+
## 💡 TypeScript Support
|
|
137
|
+
|
|
138
|
+
All components are fully typed with autocomplete for decoration names:
|
|
139
|
+
|
|
140
|
+
```tsx
|
|
141
|
+
// TypeScript will suggest available decoration names
|
|
142
|
+
<AvatarDecoration name="Ak..." /> // Shows: Akuma, etc.
|
|
13
143
|
```
|
|
14
144
|
|
|
15
|
-
|
|
145
|
+
## 🔗 Links
|
|
146
|
+
|
|
147
|
+
- [NPM Package](https://www.npmjs.com/package/decoprofile)
|
|
148
|
+
- [GitHub Repository](https://github.com/vikashkhati007/decoprofile)
|
|
149
|
+
- [Demo Website](https://deco-profile.vercel.app)
|
|
150
|
+
|
|
151
|
+
## 📄 License
|
|
152
|
+
|
|
153
|
+
MIT © [Vikash Khati](https://github.com/vikashkhati007)
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
import { NameSpaceProps } from "../types";
|
|
2
|
-
export declare function NameSpace({ userName, avatar, videoId, className,
|
|
2
|
+
export declare function NameSpace({ userName, avatar, videoId, className, scale, }: NameSpaceProps): import("react/jsx-runtime").JSX.Element;
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
import { ProfileEffectProps } from "../types";
|
|
2
|
-
export declare function Profile({
|
|
2
|
+
export declare function Profile({ children, bgEffectId, avatar, className, scale, }: ProfileEffectProps): import("react/jsx-runtime").JSX.Element;
|