@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 CHANGED
@@ -10,11 +10,7 @@
10
10
 
11
11
  [![TypeScript Supported](https://img.shields.io/badge/TypeScript-Supported-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/) [![React Ready](https://img.shields.io/badge/React-%3E%3D16.0.0-61dafb?style=flat-square&logo=react)](https://reactjs.org/) [![MIT License](https://img.shields.io/badge/License-MIT-green?style=flat-square&logo=opensourceinitiative)](./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
- Over 428 country and territory flags are available. 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`.
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 [full list of flags](https://sankyu-lab.github.io/react-circle-flags/browse) in the circle-flags gallery.
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
- Flags are just SVG components, so you can style them however you want:
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
- interface Props {
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, © [Sankyu Lab](https://github.com/Sankyu-Lab)
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, © [Sankyu Lab](https://github.com/Sankyu-Lab)
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 [HatScripts/circle-flags](https://github.com/HatScripts/circle-flags)
224
- - Built with [tsup](https://github.com/egoist/tsup)
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.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
- "1767372018500"
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.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
- "1767372018500"
14339
+ "1767373364124"
14340
14340
  );
14341
14341
  var buildMeta = {
14342
14342
  version: package_default.version,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sankyu/react-circle-flags",
3
- "version": "1.3.3",
3
+ "version": "1.3.4",
4
4
  "description": "Modern React library for circular flag components with SVGs, TypeScript support, and tree-shaking optimization.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",