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 CHANGED
@@ -1,15 +1,153 @@
1
- # decoprofilenpm
1
+ # DecoProfile
2
2
 
3
- To install dependencies:
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
+ [![npm version](https://img.shields.io/npm/v/decoprofile.svg)](https://www.npmjs.com/package/decoprofile)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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
- bun install
19
+ npm install decoprofile
7
20
  ```
8
21
 
9
- To run:
22
+ ```bash
23
+ yarn add decoprofile
24
+ ```
10
25
 
11
26
  ```bash
12
- bun run index.ts
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
- This project was created using `bun init` in bun v1.3.0. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
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, width, height, }: NameSpaceProps): import("react/jsx-runtime").JSX.Element;
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({ headerComponent, bottomComponent, bgEffectId, avatar, className, width, height, }: ProfileEffectProps): import("react/jsx-runtime").JSX.Element;
2
+ export declare function Profile({ children, bgEffectId, avatar, className, scale, }: ProfileEffectProps): import("react/jsx-runtime").JSX.Element;