@nice2dev/icons 1.3.14 → 1.3.16

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 (142) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/dist/cjs/NiceDesktopIconExporter.js +688 -599
  3. package/dist/cjs/NiceFaviconGenerator.js +603 -417
  4. package/dist/cjs/NiceIconPicker.js +788 -508
  5. package/dist/cjs/NiceIconPreview.js +246 -188
  6. package/dist/cjs/NiceIconSetCreator.js +683 -552
  7. package/dist/cjs/NiceIconStacker.js +547 -171
  8. package/dist/cjs/NiceIconValue.js +27 -35
  9. package/dist/cjs/NtdIconBadge.js +384 -360
  10. package/dist/cjs/NtdIconMorph.js +419 -354
  11. package/dist/cjs/NtdStateMorph.js +150 -147
  12. package/dist/cjs/advancedIconSearch.js +373 -510
  13. package/dist/cjs/animationControls.js +518 -642
  14. package/dist/cjs/client.js +12 -15
  15. package/dist/cjs/createIcon.js +349 -251
  16. package/dist/cjs/design-tokens.js +324 -390
  17. package/dist/cjs/figmaExport.js +162 -257
  18. package/dist/cjs/figmaSync.js +234 -316
  19. package/dist/cjs/headless-ui.js +240 -368
  20. package/dist/cjs/iconAnalytics.js +337 -393
  21. package/dist/cjs/iconHtml.js +64 -86
  22. package/dist/cjs/iconMetadata.js +392 -472
  23. package/dist/cjs/iconParts.js +120 -90
  24. package/dist/cjs/iconStack.js +136 -155
  25. package/dist/cjs/iconStyles.js +1609 -504
  26. package/dist/cjs/iconValue.js +359 -430
  27. package/dist/cjs/icons/accessibility.js +1119 -134
  28. package/dist/cjs/icons/actions.js +1290 -330
  29. package/dist/cjs/icons/ai.js +1424 -144
  30. package/dist/cjs/icons/brand.js +1344 -172
  31. package/dist/cjs/icons/business.js +903 -193
  32. package/dist/cjs/icons/devtech.js +1656 -227
  33. package/dist/cjs/icons/ecommerce.js +802 -111
  34. package/dist/cjs/icons/education.js +1345 -199
  35. package/dist/cjs/icons/files.js +1597 -328
  36. package/dist/cjs/icons/fintech.js +793 -104
  37. package/dist/cjs/icons/food.js +1507 -153
  38. package/dist/cjs/icons/fun.js +786 -109
  39. package/dist/cjs/icons/gaming.js +916 -170
  40. package/dist/cjs/icons/health.js +623 -112
  41. package/dist/cjs/icons/index.js +34 -35
  42. package/dist/cjs/icons/input.js +282 -83
  43. package/dist/cjs/icons/legal.js +1065 -122
  44. package/dist/cjs/icons/media.js +1061 -267
  45. package/dist/cjs/icons/navigation.js +387 -122
  46. package/dist/cjs/icons/omniverk.js +747 -90
  47. package/dist/cjs/icons/realestate.js +1520 -193
  48. package/dist/cjs/icons/saas.js +867 -98
  49. package/dist/cjs/icons/science.js +1465 -165
  50. package/dist/cjs/icons/shapes.js +1316 -308
  51. package/dist/cjs/icons/smarthome.js +786 -90
  52. package/dist/cjs/icons/social.js +591 -59
  53. package/dist/cjs/icons/sports.js +1225 -133
  54. package/dist/cjs/icons/sustainability.js +1211 -139
  55. package/dist/cjs/icons/travel.js +1470 -148
  56. package/dist/cjs/icons/ui.js +1508 -315
  57. package/dist/cjs/icons/weather.js +1160 -173
  58. package/dist/cjs/index.js +566 -566
  59. package/dist/cjs/lottieIntegration.js +261 -266
  60. package/dist/cjs/nicetodev-icons.css +1 -1
  61. package/dist/cjs/particleEffects.js +270 -251
  62. package/dist/cjs/resolver.js +229 -284
  63. package/dist/cjs/rsc.js +175 -193
  64. package/dist/cjs/sharpen.js +73 -130
  65. package/dist/cjs/smilAnimations.js +371 -165
  66. package/dist/cjs/stacking.js +87 -122
  67. package/dist/cjs/tailwind-plugin.js +280 -320
  68. package/dist/cjs/types.js +46 -72
  69. package/dist/cjs/utilities.js +163 -324
  70. package/dist/cjs/variantProps.js +12 -52
  71. package/dist/esm/NiceDesktopIconExporter.js +671 -598
  72. package/dist/esm/NiceFaviconGenerator.js +583 -416
  73. package/dist/esm/NiceIconPicker.js +789 -507
  74. package/dist/esm/NiceIconPreview.js +247 -187
  75. package/dist/esm/NiceIconSetCreator.js +685 -551
  76. package/dist/esm/NiceIconStacker.js +549 -170
  77. package/dist/esm/NiceIconValue.js +29 -34
  78. package/dist/esm/NtdIconBadge.js +388 -359
  79. package/dist/esm/NtdIconMorph.js +423 -353
  80. package/dist/esm/NtdStateMorph.js +152 -146
  81. package/dist/esm/advancedIconSearch.js +391 -509
  82. package/dist/esm/animationControls.js +527 -641
  83. package/dist/esm/client.js +48 -10
  84. package/dist/esm/createIcon.js +350 -250
  85. package/dist/esm/design-tokens.js +334 -387
  86. package/dist/esm/figmaExport.js +170 -256
  87. package/dist/esm/figmaSync.js +237 -315
  88. package/dist/esm/headless-ui.js +254 -365
  89. package/dist/esm/iconAnalytics.js +342 -392
  90. package/dist/esm/iconHtml.js +67 -85
  91. package/dist/esm/iconMetadata.js +404 -471
  92. package/dist/esm/iconParts.js +125 -89
  93. package/dist/esm/iconStack.js +145 -154
  94. package/dist/esm/iconStyles.js +1620 -503
  95. package/dist/esm/iconValue.js +361 -429
  96. package/dist/esm/icons/accessibility.js +1133 -133
  97. package/dist/esm/icons/actions.js +1320 -329
  98. package/dist/esm/icons/ai.js +1441 -143
  99. package/dist/esm/icons/brand.js +1351 -171
  100. package/dist/esm/icons/business.js +931 -201
  101. package/dist/esm/icons/devtech.js +1687 -226
  102. package/dist/esm/icons/ecommerce.js +816 -110
  103. package/dist/esm/icons/education.js +1364 -198
  104. package/dist/esm/icons/files.js +1628 -327
  105. package/dist/esm/icons/fintech.js +807 -103
  106. package/dist/esm/icons/food.js +1524 -152
  107. package/dist/esm/icons/fun.js +801 -108
  108. package/dist/esm/icons/gaming.js +933 -169
  109. package/dist/esm/icons/health.js +636 -111
  110. package/dist/esm/icons/index.js +596 -32
  111. package/dist/esm/icons/input.js +326 -82
  112. package/dist/esm/icons/legal.js +1079 -121
  113. package/dist/esm/icons/media.js +1086 -266
  114. package/dist/esm/icons/navigation.js +401 -121
  115. package/dist/esm/icons/omniverk.js +759 -89
  116. package/dist/esm/icons/realestate.js +1544 -198
  117. package/dist/esm/icons/saas.js +880 -97
  118. package/dist/esm/icons/science.js +1482 -164
  119. package/dist/esm/icons/shapes.js +1343 -307
  120. package/dist/esm/icons/smarthome.js +799 -89
  121. package/dist/esm/icons/social.js +599 -58
  122. package/dist/esm/icons/sports.js +1240 -132
  123. package/dist/esm/icons/sustainability.js +1226 -138
  124. package/dist/esm/icons/travel.js +1486 -147
  125. package/dist/esm/icons/ui.js +1540 -314
  126. package/dist/esm/icons/weather.js +1181 -172
  127. package/dist/esm/index.js +756 -58
  128. package/dist/esm/lottieIntegration.js +264 -265
  129. package/dist/esm/nicetodev-icons.css +1 -1
  130. package/dist/esm/particleEffects.js +271 -250
  131. package/dist/esm/resolver.js +231 -283
  132. package/dist/esm/rsc.js +182 -192
  133. package/dist/esm/sharpen.js +78 -129
  134. package/dist/esm/smilAnimations.js +376 -164
  135. package/dist/esm/stacking.js +99 -121
  136. package/dist/esm/tailwind-plugin.js +282 -319
  137. package/dist/esm/types.js +50 -71
  138. package/dist/esm/utilities.js +177 -321
  139. package/dist/esm/variantProps.js +23 -52
  140. package/dist/types/icons/index.d.ts +1 -1
  141. package/dist/types/icons/science.d.ts +9 -0
  142. package/package.json +15 -22
@@ -1,559 +1,441 @@
1
- import { useState, useMemo, useEffect, useCallback } from 'react';
2
-
3
- /**
4
- * @file advancedIconSearch.ts
5
- * @module @nice2dev/icons
6
- * @description PRO-28.3 — Advanced Icon Search with fuzzy matching,
7
- * filters, semantic search support, and analytics.
8
- */
9
- /* ══════════════════════════════════════════════════════════════════════════════
10
- Fuzzy Match Utilities
11
- ══════════════════════════════════════════════════════════════════════════════ */
12
- /**
13
- * Calculate Levenshtein distance between two strings.
14
- */
1
+ import { useState, useMemo, useEffect, useCallback } from "react";
15
2
  function levenshteinDistance(a, b) {
16
- const matrix = [];
17
- // Handle empty strings
18
- if (a.length === 0) {
19
- return b.length;
20
- }
21
- if (b.length === 0) {
22
- return a.length;
23
- }
24
- // Initialize matrix
25
- for (let i = 0; i <= b.length; i++) {
26
- matrix[i] = [i];
27
- }
28
- for (let j = 0; j <= a.length; j++) {
29
- matrix[0][j] = j;
30
- }
31
- // Fill matrix
32
- for (let i = 1; i <= b.length; i++) {
33
- for (let j = 1; j <= a.length; j++) {
34
- if (b.charAt(i - 1) === a.charAt(j - 1)) {
35
- matrix[i][j] = matrix[i - 1][j - 1];
36
- }
37
- else {
38
- matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
39
- matrix[i][j - 1] + 1, // insertion
40
- matrix[i - 1][j] + 1);
41
- }
42
- }
43
- }
44
- return matrix[b.length][a.length];
3
+ const matrix = [];
4
+ if (a.length === 0) {
5
+ return b.length;
6
+ }
7
+ if (b.length === 0) {
8
+ return a.length;
9
+ }
10
+ for (let i = 0; i <= b.length; i++) {
11
+ matrix[i] = [i];
12
+ }
13
+ for (let j = 0; j <= a.length; j++) {
14
+ matrix[0][j] = j;
15
+ }
16
+ for (let i = 1; i <= b.length; i++) {
17
+ for (let j = 1; j <= a.length; j++) {
18
+ if (b.charAt(i - 1) === a.charAt(j - 1)) {
19
+ matrix[i][j] = matrix[i - 1][j - 1];
20
+ } else {
21
+ matrix[i][j] = Math.min(
22
+ matrix[i - 1][j - 1] + 1,
23
+ // substitution
24
+ matrix[i][j - 1] + 1,
25
+ // insertion
26
+ matrix[i - 1][j] + 1
27
+ // deletion
28
+ );
29
+ }
30
+ }
31
+ }
32
+ return matrix[b.length][a.length];
45
33
  }
46
- /**
47
- * Calculate fuzzy match score (0-100).
48
- */
49
34
  function fuzzyMatchScore(query, target) {
50
- const q = query.toLowerCase();
51
- const t = target.toLowerCase();
52
- // Exact match
53
- if (q === t) {
54
- return 100;
55
- }
56
- // Contains exact
57
- if (t.includes(q)) {
58
- return 90 - (t.length - q.length) / 2;
59
- }
60
- // Starts with
61
- if (t.startsWith(q)) {
62
- return 85;
63
- }
64
- // Calculate Levenshtein-based similarity
65
- const distance = levenshteinDistance(q, t);
66
- const maxLen = Math.max(q.length, t.length);
67
- const similarity = ((maxLen - distance) / maxLen) * 100;
68
- return Math.max(0, Math.round(similarity));
35
+ const q = query.toLowerCase();
36
+ const t = target.toLowerCase();
37
+ if (q === t) {
38
+ return 100;
39
+ }
40
+ if (t.includes(q)) {
41
+ return 90 - (t.length - q.length) / 2;
42
+ }
43
+ if (t.startsWith(q)) {
44
+ return 85;
45
+ }
46
+ const distance = levenshteinDistance(q, t);
47
+ const maxLen = Math.max(q.length, t.length);
48
+ const similarity = (maxLen - distance) / maxLen * 100;
49
+ return Math.max(0, Math.round(similarity));
69
50
  }
70
- /**
71
- * Tokenize a search query.
72
- */
73
51
  function tokenizeQuery(query) {
74
- return query
75
- .toLowerCase()
76
- .replace(/[^\w\s-]/g, ' ')
77
- .split(/\s+/)
78
- .filter((token) => token.length > 1);
52
+ return query.toLowerCase().replace(/[^\w\s-]/g, " ").split(/\s+/).filter((token) => token.length > 1);
79
53
  }
80
- /* ══════════════════════════════════════════════════════════════════════════════
81
- Extended Icon Registry
82
- ══════════════════════════════════════════════════════════════════════════════ */
83
- const extendedRegistry = new Map();
84
- const favoriteIcons = new Set();
54
+ const extendedRegistry = /* @__PURE__ */ new Map();
55
+ const favoriteIcons = /* @__PURE__ */ new Set();
85
56
  const recentlyUsedIcons = [];
86
57
  const searchHistory = [];
87
- /**
88
- * Register an icon with extended metadata.
89
- */
90
58
  function registerExtendedIcon(name, metadata) {
91
- // Merge with defaults
92
- const extended = {
93
- name,
94
- category: metadata.category || 'ui',
95
- primaryCategory: metadata.primaryCategory || metadata.category || 'ui',
96
- secondaryCategories: metadata.secondaryCategories || [],
97
- domains: metadata.domains || ['general'],
98
- useCases: metadata.useCases || ['action'],
99
- styles: metadata.styles || ['solid', 'outline'],
100
- tags: metadata.tags || [],
101
- aliases: metadata.aliases || [],
102
- description: metadata.description || '',
103
- related: metadata.related || [],
104
- relatedIcons: metadata.relatedIcons || metadata.related || [],
105
- recommendedSizes: metadata.recommendedSizes || [16, 48],
106
- localizedNames: metadata.localizedNames || { en: name },
107
- searchKeywords: metadata.searchKeywords || [],
108
- dateAdded: metadata.dateAdded,
109
- versionAdded: metadata.versionAdded,
110
- deprecated: metadata.deprecated,
111
- deprecatedMessage: metadata.deprecatedMessage,
112
- };
113
- extendedRegistry.set(name, extended);
59
+ const extended = {
60
+ name,
61
+ category: metadata.category || "ui",
62
+ primaryCategory: metadata.primaryCategory || metadata.category || "ui",
63
+ secondaryCategories: metadata.secondaryCategories || [],
64
+ domains: metadata.domains || ["general"],
65
+ useCases: metadata.useCases || ["action"],
66
+ styles: metadata.styles || ["solid", "outline"],
67
+ tags: metadata.tags || [],
68
+ aliases: metadata.aliases || [],
69
+ description: metadata.description || "",
70
+ related: metadata.related || [],
71
+ relatedIcons: metadata.relatedIcons || metadata.related || [],
72
+ recommendedSizes: metadata.recommendedSizes || [16, 48],
73
+ localizedNames: metadata.localizedNames || { en: name },
74
+ searchKeywords: metadata.searchKeywords || [],
75
+ dateAdded: metadata.dateAdded,
76
+ versionAdded: metadata.versionAdded,
77
+ deprecated: metadata.deprecated,
78
+ deprecatedMessage: metadata.deprecatedMessage
79
+ };
80
+ extendedRegistry.set(name, extended);
114
81
  }
115
- /**
116
- * Get extended metadata for an icon.
117
- */
118
82
  function getExtendedMetadata(name) {
119
- return extendedRegistry.get(name);
83
+ return extendedRegistry.get(name);
120
84
  }
121
- /**
122
- * Mark an icon as favorite.
123
- */
124
85
  function toggleFavorite(name) {
125
- if (favoriteIcons.has(name)) {
126
- favoriteIcons.delete(name);
127
- return false;
128
- }
129
- favoriteIcons.add(name);
130
- return true;
86
+ if (favoriteIcons.has(name)) {
87
+ favoriteIcons.delete(name);
88
+ return false;
89
+ }
90
+ favoriteIcons.add(name);
91
+ return true;
131
92
  }
132
- /**
133
- * Check if icon is favorite.
134
- */
135
93
  function isFavorite(name) {
136
- return favoriteIcons.has(name);
94
+ return favoriteIcons.has(name);
137
95
  }
138
- /**
139
- * Get all favorite icons.
140
- */
141
96
  function getFavorites() {
142
- return Array.from(favoriteIcons);
97
+ return Array.from(favoriteIcons);
143
98
  }
144
- /**
145
- * Record icon usage (for analytics).
146
- */
147
99
  function recordIconUsage(name) {
148
- const existing = recentlyUsedIcons.findIndex((item) => item.name === name);
149
- if (existing >= 0) {
150
- recentlyUsedIcons.splice(existing, 1);
151
- }
152
- recentlyUsedIcons.unshift({ name, timestamp: Date.now() });
153
- // Keep only last 100
154
- if (recentlyUsedIcons.length > 100) {
155
- recentlyUsedIcons.pop();
156
- }
100
+ const existing = recentlyUsedIcons.findIndex((item) => item.name === name);
101
+ if (existing >= 0) {
102
+ recentlyUsedIcons.splice(existing, 1);
103
+ }
104
+ recentlyUsedIcons.unshift({ name, timestamp: Date.now() });
105
+ if (recentlyUsedIcons.length > 100) {
106
+ recentlyUsedIcons.pop();
107
+ }
157
108
  }
158
- /**
159
- * Get recently used icons.
160
- */
161
109
  function getRecentlyUsed(limit = 20) {
162
- return recentlyUsedIcons.slice(0, limit).map((item) => item.name);
110
+ return recentlyUsedIcons.slice(0, limit).map((item) => item.name);
163
111
  }
164
- /* ══════════════════════════════════════════════════════════════════════════════
165
- Advanced Search Engine
166
- ══════════════════════════════════════════════════════════════════════════════ */
167
- /**
168
- * Perform advanced search with fuzzy matching and filters.
169
- */
170
112
  function advancedSearch(query, filters = {}, options = {}) {
171
- const startTime = performance.now();
172
- const { maxResults = 50, minScore = 30, locale = 'en' } = options;
173
- const tokens = tokenizeQuery(query);
174
- const results = [];
175
- for (const [name, metadata] of extendedRegistry) {
176
- // Apply filters first
177
- if (!passesFilters(metadata, filters)) {
178
- continue;
179
- }
180
- // Calculate match score
181
- const { score, matchedIn, highlights } = calculateMatchScore(tokens, query, name, metadata, locale);
182
- if (score >= minScore) {
183
- results.push({ name, metadata, score, matchedIn, highlights });
184
- }
185
- }
186
- // Sort by score descending
187
- results.sort((a, b) => b.score - a.score);
188
- // Track analytics
189
- const duration = performance.now() - startTime;
190
- searchHistory.push({
191
- query,
192
- duration,
193
- totalResults: results.length,
194
- filters,
195
- timestamp: Date.now(),
196
- });
197
- return results.slice(0, maxResults);
113
+ const startTime = performance.now();
114
+ const { maxResults = 50, minScore = 30, locale = "en" } = options;
115
+ const tokens = tokenizeQuery(query);
116
+ const results = [];
117
+ for (const [name, metadata] of extendedRegistry) {
118
+ if (!passesFilters(metadata, filters)) {
119
+ continue;
120
+ }
121
+ const { score, matchedIn, highlights } = calculateMatchScore(
122
+ tokens,
123
+ query,
124
+ name,
125
+ metadata,
126
+ locale
127
+ );
128
+ if (score >= minScore) {
129
+ results.push({ name, metadata, score, matchedIn, highlights });
130
+ }
131
+ }
132
+ results.sort((a, b) => b.score - a.score);
133
+ const duration = performance.now() - startTime;
134
+ searchHistory.push({
135
+ query,
136
+ duration,
137
+ totalResults: results.length,
138
+ filters,
139
+ timestamp: Date.now()
140
+ });
141
+ return results.slice(0, maxResults);
198
142
  }
199
- /**
200
- * Check if metadata passes all filters.
201
- */
202
143
  function passesFilters(metadata, filters) {
203
- var _a, _b, _c, _d;
204
- // Category filter
205
- if ((_a = filters.categories) === null || _a === void 0 ? void 0 : _a.length) {
206
- const allCats = [metadata.primaryCategory, ...metadata.secondaryCategories];
207
- if (!filters.categories.some((c) => allCats.includes(c))) {
208
- return false;
209
- }
210
- }
211
- // Domain filter
212
- if ((_b = filters.domains) === null || _b === void 0 ? void 0 : _b.length) {
213
- if (!filters.domains.some((d) => metadata.domains.includes(d))) {
214
- return false;
215
- }
216
- }
217
- // Use-case filter
218
- if ((_c = filters.useCases) === null || _c === void 0 ? void 0 : _c.length) {
219
- if (!filters.useCases.some((u) => metadata.useCases.includes(u))) {
220
- return false;
221
- }
222
- }
223
- // Style filter
224
- if ((_d = filters.styles) === null || _d === void 0 ? void 0 : _d.length) {
225
- if (!filters.styles.some((s) => metadata.styles.includes(s))) {
226
- return false;
227
- }
228
- }
229
- // Size filter
230
- if (filters.minSize !== undefined) {
231
- if (metadata.recommendedSizes[1] < filters.minSize) {
232
- return false;
233
- }
234
- }
235
- if (filters.maxSize !== undefined) {
236
- if (metadata.recommendedSizes[0] > filters.maxSize) {
237
- return false;
144
+ if (filters.categories?.length) {
145
+ const allCats = [metadata.primaryCategory, ...metadata.secondaryCategories];
146
+ if (!filters.categories.some((c) => allCats.includes(c))) {
147
+ return false;
148
+ }
149
+ }
150
+ if (filters.domains?.length) {
151
+ if (!filters.domains.some((d) => metadata.domains.includes(d))) {
152
+ return false;
153
+ }
154
+ }
155
+ if (filters.useCases?.length) {
156
+ if (!filters.useCases.some((u) => metadata.useCases.includes(u))) {
157
+ return false;
158
+ }
159
+ }
160
+ if (filters.styles?.length) {
161
+ if (!filters.styles.some((s) => metadata.styles.includes(s))) {
162
+ return false;
163
+ }
164
+ }
165
+ if (filters.minSize !== void 0) {
166
+ if (metadata.recommendedSizes[1] < filters.minSize) {
167
+ return false;
168
+ }
169
+ }
170
+ if (filters.maxSize !== void 0) {
171
+ if (metadata.recommendedSizes[0] > filters.maxSize) {
172
+ return false;
173
+ }
174
+ }
175
+ if (filters.excludeDeprecated && metadata.deprecated) {
176
+ return false;
177
+ }
178
+ if (filters.favoritesOnly && !favoriteIcons.has(metadata.name)) {
179
+ return false;
180
+ }
181
+ if (filters.recentlyUsedOnly) {
182
+ const isRecent = recentlyUsedIcons.some((r) => r.name === metadata.name);
183
+ if (!isRecent) {
184
+ return false;
185
+ }
186
+ }
187
+ if (filters.recentDays !== void 0 && metadata.dateAdded) {
188
+ const addedDate = new Date(metadata.dateAdded).getTime();
189
+ const cutoff = Date.now() - filters.recentDays * 24 * 60 * 60 * 1e3;
190
+ if (addedDate < cutoff) {
191
+ return false;
192
+ }
193
+ }
194
+ return true;
195
+ }
196
+ function calculateMatchScore(tokens, fullQuery, name, metadata, locale) {
197
+ let totalScore = 0;
198
+ const matchedIn = [];
199
+ const highlights = [];
200
+ const nameScore = fuzzyMatchScore(fullQuery, name);
201
+ if (nameScore > 30) {
202
+ totalScore += nameScore * 2;
203
+ matchedIn.push("name");
204
+ highlights.push({ field: "name", text: name });
205
+ }
206
+ for (const alias of metadata.aliases) {
207
+ const aliasScore = fuzzyMatchScore(fullQuery, alias);
208
+ if (aliasScore > 30) {
209
+ totalScore += aliasScore * 1.5;
210
+ if (!matchedIn.includes("alias")) {
211
+ matchedIn.push("alias");
212
+ }
213
+ highlights.push({ field: "alias", text: alias });
214
+ }
215
+ }
216
+ const localizedName = metadata.localizedNames[locale] || metadata.localizedNames.en;
217
+ if (localizedName && localizedName !== name) {
218
+ const localScore = fuzzyMatchScore(fullQuery, localizedName);
219
+ if (localScore > 30) {
220
+ totalScore += localScore * 1.3;
221
+ if (!matchedIn.includes("localized")) {
222
+ matchedIn.push("localized");
223
+ }
224
+ highlights.push({ field: "localized", text: localizedName });
225
+ }
226
+ }
227
+ for (const tag of metadata.tags) {
228
+ for (const token of tokens) {
229
+ const tagScore = fuzzyMatchScore(token, tag);
230
+ if (tagScore > 50) {
231
+ totalScore += tagScore * 0.7;
232
+ if (!matchedIn.includes("tag")) {
233
+ matchedIn.push("tag");
238
234
  }
239
- }
240
- // Deprecated filter
241
- if (filters.excludeDeprecated && metadata.deprecated) {
242
- return false;
243
- }
244
- // Favorites filter
245
- if (filters.favoritesOnly && !favoriteIcons.has(metadata.name)) {
246
- return false;
247
- }
248
- // Recently used filter
249
- if (filters.recentlyUsedOnly) {
250
- const isRecent = recentlyUsedIcons.some((r) => r.name === metadata.name);
251
- if (!isRecent) {
252
- return false;
235
+ highlights.push({ field: "tag", text: tag });
236
+ }
237
+ }
238
+ }
239
+ for (const keyword of metadata.searchKeywords) {
240
+ for (const token of tokens) {
241
+ const keywordScore = fuzzyMatchScore(token, keyword);
242
+ if (keywordScore > 50) {
243
+ totalScore += keywordScore * 0.8;
244
+ if (!matchedIn.includes("keyword")) {
245
+ matchedIn.push("keyword");
253
246
  }
254
- }
255
- // Recent days filter
256
- if (filters.recentDays !== undefined && metadata.dateAdded) {
257
- const addedDate = new Date(metadata.dateAdded).getTime();
258
- const cutoff = Date.now() - filters.recentDays * 24 * 60 * 60 * 1000;
259
- if (addedDate < cutoff) {
260
- return false;
247
+ highlights.push({ field: "keyword", text: keyword });
248
+ }
249
+ }
250
+ }
251
+ if (metadata.description) {
252
+ for (const token of tokens) {
253
+ if (metadata.description.toLowerCase().includes(token)) {
254
+ totalScore += 15;
255
+ if (!matchedIn.includes("description")) {
256
+ matchedIn.push("description");
261
257
  }
258
+ highlights.push({ field: "description", text: metadata.description });
259
+ break;
260
+ }
262
261
  }
263
- return true;
262
+ }
263
+ const normalizedScore = Math.min(100, Math.round(totalScore / (tokens.length || 1)));
264
+ return { score: normalizedScore, matchedIn, highlights };
264
265
  }
265
- /**
266
- * Calculate match score for an icon.
267
- */
268
- function calculateMatchScore(tokens, fullQuery, name, metadata, locale) {
269
- let totalScore = 0;
270
- const matchedIn = [];
271
- const highlights = [];
272
- // Match against name (highest weight)
273
- const nameScore = fuzzyMatchScore(fullQuery, name);
274
- if (nameScore > 30) {
275
- totalScore += nameScore * 2; // 2x weight for name
276
- matchedIn.push('name');
277
- highlights.push({ field: 'name', text: name });
278
- }
279
- // Match against aliases
280
- for (const alias of metadata.aliases) {
281
- const aliasScore = fuzzyMatchScore(fullQuery, alias);
282
- if (aliasScore > 30) {
283
- totalScore += aliasScore * 1.5;
284
- if (!matchedIn.includes('alias')) {
285
- matchedIn.push('alias');
286
- }
287
- highlights.push({ field: 'alias', text: alias });
288
- }
289
- }
290
- // Match against localized name
291
- const localizedName = metadata.localizedNames[locale] || metadata.localizedNames.en;
292
- if (localizedName && localizedName !== name) {
293
- const localScore = fuzzyMatchScore(fullQuery, localizedName);
294
- if (localScore > 30) {
295
- totalScore += localScore * 1.3;
296
- if (!matchedIn.includes('localized')) {
297
- matchedIn.push('localized');
298
- }
299
- highlights.push({ field: 'localized', text: localizedName });
300
- }
266
+ function findSimilarIcons(iconName, limit = 10) {
267
+ const source = extendedRegistry.get(iconName);
268
+ if (!source) {
269
+ return [];
270
+ }
271
+ const similarities = [];
272
+ for (const [name, metadata] of extendedRegistry) {
273
+ if (name === iconName) {
274
+ continue;
275
+ }
276
+ let similarity = 0;
277
+ if (metadata.primaryCategory === source.primaryCategory) {
278
+ similarity += 30;
279
+ }
280
+ for (const cat of metadata.secondaryCategories) {
281
+ if (source.secondaryCategories.includes(cat)) {
282
+ similarity += 5;
283
+ }
284
+ }
285
+ for (const domain of metadata.domains) {
286
+ if (source.domains.includes(domain)) {
287
+ similarity += 10;
288
+ }
289
+ }
290
+ for (const useCase of metadata.useCases) {
291
+ if (source.useCases.includes(useCase)) {
292
+ similarity += 5;
293
+ }
301
294
  }
302
- // Match against tags
303
295
  for (const tag of metadata.tags) {
304
- for (const token of tokens) {
305
- const tagScore = fuzzyMatchScore(token, tag);
306
- if (tagScore > 50) {
307
- totalScore += tagScore * 0.7;
308
- if (!matchedIn.includes('tag')) {
309
- matchedIn.push('tag');
310
- }
311
- highlights.push({ field: 'tag', text: tag });
312
- }
313
- }
296
+ if (source.tags.includes(tag)) {
297
+ similarity += 3;
298
+ }
314
299
  }
315
- // Match against keywords
316
- for (const keyword of metadata.searchKeywords) {
317
- for (const token of tokens) {
318
- const keywordScore = fuzzyMatchScore(token, keyword);
319
- if (keywordScore > 50) {
320
- totalScore += keywordScore * 0.8;
321
- if (!matchedIn.includes('keyword')) {
322
- matchedIn.push('keyword');
323
- }
324
- highlights.push({ field: 'keyword', text: keyword });
325
- }
326
- }
300
+ if (source.relatedIcons.includes(name)) {
301
+ similarity += 20;
327
302
  }
328
- // Match against description
329
- if (metadata.description) {
330
- for (const token of tokens) {
331
- if (metadata.description.toLowerCase().includes(token)) {
332
- totalScore += 15;
333
- if (!matchedIn.includes('description')) {
334
- matchedIn.push('description');
335
- }
336
- highlights.push({ field: 'description', text: metadata.description });
337
- break; // Only count once for description
338
- }
339
- }
303
+ similarity += fuzzyMatchScore(iconName, name) / 5;
304
+ if (similarity > 20) {
305
+ similarities.push({ name, similarity: Math.min(100, similarity) });
340
306
  }
341
- // Normalize score to 0-100
342
- const normalizedScore = Math.min(100, Math.round(totalScore / (tokens.length || 1)));
343
- return { score: normalizedScore, matchedIn, highlights };
307
+ }
308
+ similarities.sort((a, b) => b.similarity - a.similarity);
309
+ return similarities.slice(0, limit);
344
310
  }
345
- /* ══════════════════════════════════════════════════════════════════════════════
346
- Similar Icons Finder
347
- ══════════════════════════════════════════════════════════════════════════════ */
348
- /**
349
- * Find similar icons based on metadata overlap.
350
- */
351
- function findSimilarIcons(iconName, limit = 10) {
352
- const source = extendedRegistry.get(iconName);
353
- if (!source) {
354
- return [];
311
+ function getSearchSuggestions(partial, limit = 10) {
312
+ if (partial.length < 2) {
313
+ return [];
314
+ }
315
+ const p = partial.toLowerCase();
316
+ const suggestions = /* @__PURE__ */ new Set();
317
+ for (const [name, metadata] of extendedRegistry) {
318
+ if (name.toLowerCase().startsWith(p)) {
319
+ suggestions.add(name);
355
320
  }
356
- const similarities = [];
357
- for (const [name, metadata] of extendedRegistry) {
358
- if (name === iconName) {
359
- continue;
360
- }
361
- let similarity = 0;
362
- // Same primary category (+30)
363
- if (metadata.primaryCategory === source.primaryCategory) {
364
- similarity += 30;
365
- }
366
- // Shared secondary categories (+5 each)
367
- for (const cat of metadata.secondaryCategories) {
368
- if (source.secondaryCategories.includes(cat)) {
369
- similarity += 5;
370
- }
371
- }
372
- // Shared domains (+10 each)
373
- for (const domain of metadata.domains) {
374
- if (source.domains.includes(domain)) {
375
- similarity += 10;
376
- }
377
- }
378
- // Shared use-cases (+5 each)
379
- for (const useCase of metadata.useCases) {
380
- if (source.useCases.includes(useCase)) {
381
- similarity += 5;
382
- }
383
- }
384
- // Shared tags (+3 each)
385
- for (const tag of metadata.tags) {
386
- if (source.tags.includes(tag)) {
387
- similarity += 3;
388
- }
389
- }
390
- // In related icons list (+20)
391
- if (source.relatedIcons.includes(name)) {
392
- similarity += 20;
393
- }
394
- // Similar name (+fuzzy score / 5)
395
- similarity += fuzzyMatchScore(iconName, name) / 5;
396
- if (similarity > 20) {
397
- similarities.push({ name, similarity: Math.min(100, similarity) });
398
- }
321
+ for (const alias of metadata.aliases) {
322
+ if (alias.toLowerCase().startsWith(p)) {
323
+ suggestions.add(alias);
324
+ }
399
325
  }
400
- // Sort by similarity descending
401
- similarities.sort((a, b) => b.similarity - a.similarity);
402
- return similarities.slice(0, limit);
403
- }
404
- /* ══════════════════════════════════════════════════════════════════════════════
405
- Search Suggestions / Autocomplete
406
- ══════════════════════════════════════════════════════════════════════════════ */
407
- /**
408
- * Get search suggestions based on partial input.
409
- */
410
- function getSearchSuggestions(partial, limit = 10) {
411
- if (partial.length < 2) {
412
- return [];
326
+ for (const tag of metadata.tags) {
327
+ if (tag.toLowerCase().startsWith(p)) {
328
+ suggestions.add(tag);
329
+ }
413
330
  }
414
- const p = partial.toLowerCase();
415
- const suggestions = new Set();
416
- for (const [name, metadata] of extendedRegistry) {
417
- // Name starts with partial
418
- if (name.toLowerCase().startsWith(p)) {
419
- suggestions.add(name);
420
- }
421
- // Alias starts with partial
422
- for (const alias of metadata.aliases) {
423
- if (alias.toLowerCase().startsWith(p)) {
424
- suggestions.add(alias);
425
- }
426
- }
427
- // Tag starts with partial
428
- for (const tag of metadata.tags) {
429
- if (tag.toLowerCase().startsWith(p)) {
430
- suggestions.add(tag);
431
- }
432
- }
433
- if (suggestions.size >= limit * 2) {
434
- break;
435
- }
331
+ if (suggestions.size >= limit * 2) {
332
+ break;
436
333
  }
437
- return Array.from(suggestions).slice(0, limit);
334
+ }
335
+ return Array.from(suggestions).slice(0, limit);
438
336
  }
439
- /* ══════════════════════════════════════════════════════════════════════════════
440
- Analytics & Insights
441
- ══════════════════════════════════════════════════════════════════════════════ */
442
- /**
443
- * Get search analytics summary.
444
- */
445
337
  function getSearchAnalytics() {
446
- const queryCounts = new Map();
447
- const zeroResults = [];
448
- let totalDuration = 0;
449
- for (const search of searchHistory) {
450
- totalDuration += search.duration;
451
- const count = queryCounts.get(search.query) || 0;
452
- queryCounts.set(search.query, count + 1);
453
- if (search.totalResults === 0) {
454
- zeroResults.push(search.query);
455
- }
456
- }
457
- // Top queries
458
- const topQueries = Array.from(queryCounts.entries())
459
- .map(([query, count]) => ({ query, count }))
460
- .sort((a, b) => b.count - a.count)
461
- .slice(0, 10);
462
- return {
463
- totalSearches: searchHistory.length,
464
- averageDuration: searchHistory.length > 0 ? totalDuration / searchHistory.length : 0,
465
- topQueries,
466
- zeroResultQueries: [...new Set(zeroResults)].slice(0, 20),
467
- };
338
+ const queryCounts = /* @__PURE__ */ new Map();
339
+ const zeroResults = [];
340
+ let totalDuration = 0;
341
+ for (const search of searchHistory) {
342
+ totalDuration += search.duration;
343
+ const count = queryCounts.get(search.query) || 0;
344
+ queryCounts.set(search.query, count + 1);
345
+ if (search.totalResults === 0) {
346
+ zeroResults.push(search.query);
347
+ }
348
+ }
349
+ const topQueries = Array.from(queryCounts.entries()).map(([query, count]) => ({ query, count })).sort((a, b) => b.count - a.count).slice(0, 10);
350
+ return {
351
+ totalSearches: searchHistory.length,
352
+ averageDuration: searchHistory.length > 0 ? totalDuration / searchHistory.length : 0,
353
+ topQueries,
354
+ zeroResultQueries: [...new Set(zeroResults)].slice(0, 20)
355
+ };
468
356
  }
469
- /**
470
- * Get icon usage statistics.
471
- */
472
357
  function getIconUsageStats() {
473
- // Count usage from history
474
- const usageCounts = new Map();
475
- for (const item of recentlyUsedIcons) {
476
- const count = usageCounts.get(item.name) || 0;
477
- usageCounts.set(item.name, count + 1);
478
- }
479
- // Most used
480
- const mostUsed = Array.from(usageCounts.entries())
481
- .map(([name, count]) => ({ name, count }))
482
- .sort((a, b) => b.count - a.count)
483
- .slice(0, 20);
484
- // Find never used
485
- const usedNames = new Set(recentlyUsedIcons.map((i) => i.name));
486
- const neverUsed = [];
487
- for (const name of extendedRegistry.keys()) {
488
- if (!usedNames.has(name)) {
489
- neverUsed.push(name);
490
- }
491
- }
492
- // Least used (used once)
493
- const leastUsed = Array.from(usageCounts.entries())
494
- .filter(([_, count]) => count === 1)
495
- .map(([name]) => name)
496
- .slice(0, 20);
497
- return { mostUsed, leastUsed, neverUsed };
358
+ const usageCounts = /* @__PURE__ */ new Map();
359
+ for (const item of recentlyUsedIcons) {
360
+ const count = usageCounts.get(item.name) || 0;
361
+ usageCounts.set(item.name, count + 1);
362
+ }
363
+ const mostUsed = Array.from(usageCounts.entries()).map(([name, count]) => ({ name, count })).sort((a, b) => b.count - a.count).slice(0, 20);
364
+ const usedNames = new Set(recentlyUsedIcons.map((i) => i.name));
365
+ const neverUsed = [];
366
+ for (const name of extendedRegistry.keys()) {
367
+ if (!usedNames.has(name)) {
368
+ neverUsed.push(name);
369
+ }
370
+ }
371
+ const leastUsed = Array.from(usageCounts.entries()).filter(([_, count]) => count === 1).map(([name]) => name).slice(0, 20);
372
+ return { mostUsed, leastUsed, neverUsed };
498
373
  }
499
- /**
500
- * Clear search history.
501
- */
502
374
  function clearSearchHistory() {
503
- searchHistory.length = 0;
375
+ searchHistory.length = 0;
504
376
  }
505
- /**
506
- * Clear recently used.
507
- */
508
377
  function clearRecentlyUsed() {
509
- recentlyUsedIcons.length = 0;
378
+ recentlyUsedIcons.length = 0;
510
379
  }
511
- /**
512
- * React hook for advanced icon search.
513
- */
514
- function useAdvancedIconSearch(debounceMs = 200, locale = 'en') {
515
- const [query, setQuery] = useState('');
516
- const [filters, setFilters] = useState({});
517
- const [results, setResults] = useState([]);
518
- const [isSearching, setIsSearching] = useState(false);
519
- // Suggestions
520
- const suggestions = useMemo(() => {
521
- return query.length >= 2 ? getSearchSuggestions(query) : [];
522
- }, [query]);
523
- // Debounced search
524
- useEffect(() => {
525
- if (!query && !Object.keys(filters).length) {
526
- setResults([]);
527
- return;
528
- }
529
- setIsSearching(true);
530
- const timer = setTimeout(() => {
531
- const searchResults = advancedSearch(query, filters, { locale });
532
- setResults(searchResults);
533
- setIsSearching(false);
534
- }, debounceMs);
535
- return () => clearTimeout(timer);
536
- }, [query, filters, debounceMs, locale]);
537
- const search = useCallback(() => {
538
- setIsSearching(true);
539
- const searchResults = advancedSearch(query, filters, { locale });
540
- setResults(searchResults);
541
- setIsSearching(false);
542
- }, [query, filters, locale]);
543
- const clearFilters = useCallback(() => {
544
- setFilters({});
545
- }, []);
546
- return {
547
- query,
548
- setQuery,
549
- filters,
550
- setFilters,
551
- results,
552
- isSearching,
553
- suggestions,
554
- search,
555
- clearFilters,
556
- };
380
+ function useAdvancedIconSearch(debounceMs = 200, locale = "en") {
381
+ const [query, setQuery] = useState("");
382
+ const [filters, setFilters] = useState({});
383
+ const [results, setResults] = useState([]);
384
+ const [isSearching, setIsSearching] = useState(false);
385
+ const suggestions = useMemo(() => {
386
+ return query.length >= 2 ? getSearchSuggestions(query) : [];
387
+ }, [query]);
388
+ useEffect(() => {
389
+ if (!query && !Object.keys(filters).length) {
390
+ setResults([]);
391
+ return;
392
+ }
393
+ setIsSearching(true);
394
+ const timer = setTimeout(() => {
395
+ const searchResults = advancedSearch(query, filters, { locale });
396
+ setResults(searchResults);
397
+ setIsSearching(false);
398
+ }, debounceMs);
399
+ return () => clearTimeout(timer);
400
+ }, [query, filters, debounceMs, locale]);
401
+ const search = useCallback(() => {
402
+ setIsSearching(true);
403
+ const searchResults = advancedSearch(query, filters, { locale });
404
+ setResults(searchResults);
405
+ setIsSearching(false);
406
+ }, [query, filters, locale]);
407
+ const clearFilters = useCallback(() => {
408
+ setFilters({});
409
+ }, []);
410
+ return {
411
+ query,
412
+ setQuery,
413
+ filters,
414
+ setFilters,
415
+ results,
416
+ isSearching,
417
+ suggestions,
418
+ search,
419
+ clearFilters
420
+ };
557
421
  }
558
-
559
- export { advancedSearch, clearRecentlyUsed, clearSearchHistory, findSimilarIcons, fuzzyMatchScore, getExtendedMetadata, getFavorites, getIconUsageStats, getRecentlyUsed, getSearchAnalytics, getSearchSuggestions, isFavorite, levenshteinDistance, recordIconUsage, registerExtendedIcon, toggleFavorite, tokenizeQuery, useAdvancedIconSearch };
422
+ export {
423
+ advancedSearch,
424
+ clearRecentlyUsed,
425
+ clearSearchHistory,
426
+ findSimilarIcons,
427
+ fuzzyMatchScore,
428
+ getExtendedMetadata,
429
+ getFavorites,
430
+ getIconUsageStats,
431
+ getRecentlyUsed,
432
+ getSearchAnalytics,
433
+ getSearchSuggestions,
434
+ isFavorite,
435
+ levenshteinDistance,
436
+ recordIconUsage,
437
+ registerExtendedIcon,
438
+ toggleFavorite,
439
+ tokenizeQuery,
440
+ useAdvancedIconSearch
441
+ };