@sankyu/react-circle-flags 1.3.3 → 1.3.4
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 +27 -37
- package/dist/index.cjs +2 -2
- package/dist/index.mjs +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,11 +10,7 @@
|
|
|
10
10
|
|
|
11
11
|
[](https://www.typescriptlang.org/) [](https://reactjs.org/) [](./LICENSE)
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
:star: **Star us on [GitHub](https://github.com/Sankyu-Lab/react-circle-flags)** | :bug: **Report Issues [here](https://github.com/Sankyu-Lab/react-circle-flags/issues)**
|
|
16
|
-
|
|
17
|
-
:rocket: **Explore the [Demo Gallery](https://sankyu-lab.github.io/react-circle-flags/browse)** | :book: **Read the [Documentation](https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/)**
|
|
13
|
+
:star: **Star us on <a href="https://github.com/Sankyu-Lab/react-circle-flags" target="_blank">GitHub</a>** | :bug: **Report Issues <a href="https://github.com/Sankyu-Lab/react-circle-flags/issues" target="_blank">here</a>**
|
|
18
14
|
|
|
19
15
|
</div>
|
|
20
16
|
|
|
@@ -28,8 +24,15 @@ This library provides **400+ circular SVG flag components** with **Full-TypeScri
|
|
|
28
24
|
|
|
29
25
|
Perfect for applications that need fast, crisp country flags without external image requests.
|
|
30
26
|
|
|
27
|
+
:rocket: **Explore the <a href="https://sankyu-lab.github.io/react-circle-flags/browse" target="_blank">Demo Gallery</a>** | :book: **Read the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/" target="_blank">Documentation</a>**
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
31
|
## ✨ Key Features
|
|
32
32
|
|
|
33
|
+
> [!TIP]
|
|
34
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/#-key-features" target="_blank">Documentation</a>.
|
|
35
|
+
|
|
33
36
|
- 🎯 **Tree-shakable** - Only bundle the flags you use
|
|
34
37
|
- 📦 **TypeScript** - Full type definitions included
|
|
35
38
|
- ⚡ **Zero dependencies** - Only requires React as peer dependency
|
|
@@ -40,6 +43,9 @@ Perfect for applications that need fast, crisp country flags without external im
|
|
|
40
43
|
|
|
41
44
|
## 📦 Installation
|
|
42
45
|
|
|
46
|
+
> [!TIP]
|
|
47
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/installation/" target="_blank">Installation Guide</a>.
|
|
48
|
+
|
|
43
49
|
```bash
|
|
44
50
|
npm install @sankyu/react-circle-flags
|
|
45
51
|
# or
|
|
@@ -52,6 +58,9 @@ bun add @sankyu/react-circle-flags
|
|
|
52
58
|
|
|
53
59
|
## 🚀 Usage
|
|
54
60
|
|
|
61
|
+
> [!TIP]
|
|
62
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/usage/" target="_blank">Usage Guide</a>.
|
|
63
|
+
|
|
55
64
|
### Import individual flags (Recommended)
|
|
56
65
|
|
|
57
66
|
```tsx
|
|
@@ -90,6 +99,9 @@ export default function StyledFlag() {
|
|
|
90
99
|
> [!WARNING]
|
|
91
100
|
> ⚠️ Using `DynamicFlag` or `import * as Flags` will pull all flag components into the bundle, which can reduce tree-shaking efficiency and increase bundle size.
|
|
92
101
|
|
|
102
|
+
> [!TIP]
|
|
103
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/dynamic-flags/" target="_blank">Dynamic Flag Selection</a> section in the documentation.
|
|
104
|
+
|
|
93
105
|
```tsx
|
|
94
106
|
import { DynamicFlag } from '@sankyu/react-circle-flags'
|
|
95
107
|
|
|
@@ -124,7 +136,7 @@ interface FlagProps extends SVGProps<SVGSVGElement> {
|
|
|
124
136
|
|
|
125
137
|
### Available Flags
|
|
126
138
|
|
|
127
|
-
|
|
139
|
+
Each flag is exported with the pattern `Flag{PascalCase ISO_CODE}` (for example, `FlagUs`, `FlagCn`). Convenience aliases are provided for common two-letter codes: `FlagUs`, `FlagCn`, `FlagGb`, `FlagJp`.
|
|
128
140
|
|
|
129
141
|
- `FlagUs` - United States
|
|
130
142
|
- `FlagCn` - China
|
|
@@ -132,40 +144,18 @@ Over 428 country and territory flags are available. Each flag is exported with t
|
|
|
132
144
|
- `FlagJp` - Japan
|
|
133
145
|
- ... and many more
|
|
134
146
|
|
|
135
|
-
See the
|
|
147
|
+
See the <a href="https://sankyu-lab.github.io/react-circle-flags/browse" target="_blank">Full list of flags</a> in the circle-flags gallery.
|
|
136
148
|
|
|
137
149
|
## 🎨 Styling
|
|
138
150
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
```tsx
|
|
142
|
-
// With Tailwind CSS
|
|
143
|
-
<FlagUs className="w-12 h-12 rounded-full shadow-lg" />
|
|
144
|
-
|
|
145
|
-
// With inline styles
|
|
146
|
-
<FlagUs style={{ width: 48, height: 48, borderRadius: '50%' }} />
|
|
147
|
-
|
|
148
|
-
// With CSS modules
|
|
149
|
-
<FlagUs className={styles.flag} />
|
|
150
|
-
```
|
|
151
|
+
> [!TIP]
|
|
152
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/styling/" target="_blank">Styling Guide</a>.
|
|
151
153
|
|
|
152
154
|
## 🔧 TypeScript
|
|
153
155
|
|
|
154
|
-
Full TypeScript support is included out of the box
|
|
155
|
-
|
|
156
|
-
```tsx
|
|
157
|
-
import type { SVGProps } from 'react'
|
|
158
|
-
import { FlagUs } from '@sankyu/react-circle-flags'
|
|
156
|
+
Full TypeScript support is included out of the box.
|
|
159
157
|
|
|
160
|
-
|
|
161
|
-
countryCode: string
|
|
162
|
-
flagProps?: SVGProps<SVGSVGElement>
|
|
163
|
-
}
|
|
164
|
-
|
|
165
|
-
export const MyComponent = ({ flagProps }: Props) => {
|
|
166
|
-
return <FlagUs {...flagProps} />
|
|
167
|
-
}
|
|
168
|
-
```
|
|
158
|
+
> For more information, you may refer to the <a href="https://sankyu-lab.github.io/react-circle-flags/docs/guides/getting-started/typescript/" target="_blank">TypeScript Guide</a>.
|
|
169
159
|
|
|
170
160
|
## 📖 Examples
|
|
171
161
|
|
|
@@ -214,11 +204,11 @@ Please see [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
|
|
|
214
204
|
|
|
215
205
|
## 📄 License
|
|
216
206
|
|
|
217
|
-
`@sankyu/react-circle-flags` is licensed under the MIT License, ©
|
|
207
|
+
`@sankyu/react-circle-flags` is licensed under the MIT License, © <a href="https://github.com/Sankyu-Lab" target="_blank">Sankyu Lab</a>
|
|
218
208
|
|
|
219
|
-
[website](./website/) is licensed under the GPL-3.0 License, ©
|
|
209
|
+
[website](./website/) is licensed under the GPL-3.0 License, © <a href="https://github.com/Sankyu-Lab" target="_blank">Sankyu Lab</a>
|
|
220
210
|
|
|
221
211
|
## 🙏 Credits
|
|
222
212
|
|
|
223
|
-
- Flag designs from
|
|
224
|
-
- Built with
|
|
213
|
+
- Flag designs from <a href="https://github.com/HatScripts/circle-flags" target="_blank">HatScripts/circle-flags</a>
|
|
214
|
+
- Built with <a href="https://github.com/egoist/tsup" target="_blank">tsup</a>
|
package/dist/index.cjs
CHANGED
|
@@ -14329,7 +14329,7 @@ var FLAG_REGISTRY = {
|
|
|
14329
14329
|
|
|
14330
14330
|
// package.json
|
|
14331
14331
|
var package_default = {
|
|
14332
|
-
version: "1.3.
|
|
14332
|
+
version: "1.3.4"};
|
|
14333
14333
|
|
|
14334
14334
|
// src/meta.ts
|
|
14335
14335
|
var parseBuiltAt = (source) => {
|
|
@@ -14338,7 +14338,7 @@ var parseBuiltAt = (source) => {
|
|
|
14338
14338
|
};
|
|
14339
14339
|
var commit = "dev" ;
|
|
14340
14340
|
var builtAt = parseBuiltAt(
|
|
14341
|
-
"
|
|
14341
|
+
"1767373364124"
|
|
14342
14342
|
);
|
|
14343
14343
|
var buildMeta = {
|
|
14344
14344
|
version: package_default.version,
|
package/dist/index.mjs
CHANGED
|
@@ -14327,7 +14327,7 @@ var FLAG_REGISTRY = {
|
|
|
14327
14327
|
|
|
14328
14328
|
// package.json
|
|
14329
14329
|
var package_default = {
|
|
14330
|
-
version: "1.3.
|
|
14330
|
+
version: "1.3.4"};
|
|
14331
14331
|
|
|
14332
14332
|
// src/meta.ts
|
|
14333
14333
|
var parseBuiltAt = (source) => {
|
|
@@ -14336,7 +14336,7 @@ var parseBuiltAt = (source) => {
|
|
|
14336
14336
|
};
|
|
14337
14337
|
var commit = "dev" ;
|
|
14338
14338
|
var builtAt = parseBuiltAt(
|
|
14339
|
-
"
|
|
14339
|
+
"1767373364124"
|
|
14340
14340
|
);
|
|
14341
14341
|
var buildMeta = {
|
|
14342
14342
|
version: package_default.version,
|
package/package.json
CHANGED