@jsonresume/core 0.1.0 → 0.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/LICENSE +21 -0
- package/package.json +22 -18
- package/src/__tests__/components/contactInfo.test.jsx +96 -0
- package/src/__tests__/components/dateRange.test.jsx +119 -0
- package/src/__tests__/components/link.test.jsx +115 -0
- package/src/__tests__/components/primitives.test.jsx +199 -0
- package/src/__tests__/components/profile.test.jsx +113 -0
- package/src/__tests__/components/renderHtml.jsx +24 -0
- package/src/__tests__/ssr/renderResumeDocument.test.jsx +122 -0
- package/src/dates/RelativeDate.jsx +4 -72
- package/src/helpers/calculations.js +40 -422
- package/src/helpers/counts.js +16 -0
- package/src/helpers/education.js +12 -0
- package/src/helpers/experience.js +16 -0
- package/src/helpers/index.js +11 -0
- package/src/helpers/keyMetrics.js +8 -0
- package/src/helpers/workHistory.js +13 -0
- package/src/index.js +8 -3
- package/src/primitives/DateRange.jsx +5 -107
- package/src/ssr/index.js +152 -0
- package/src/styled.d.ts +46 -0
- package/src/utils/security.js +13 -154
|
@@ -4,425 +4,43 @@
|
|
|
4
4
|
* Pure functions for computing metrics and insights from JSON Resume data.
|
|
5
5
|
* Use these helpers in themes to display calculated metrics, statistics, and insights.
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
export
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
// Assume first item is most recent (no endDate or latest endDate)
|
|
48
|
-
const currentRole = work.find((job) => !job.endDate) || work[0];
|
|
49
|
-
if (!currentRole || !currentRole.startDate) return 0;
|
|
50
|
-
|
|
51
|
-
const start = new Date(currentRole.startDate);
|
|
52
|
-
const end = currentRole.endDate ? new Date(currentRole.endDate) : new Date();
|
|
53
|
-
const years = (end - start) / (1000 * 60 * 60 * 24 * 365.25);
|
|
54
|
-
|
|
55
|
-
return Math.round(years * 10) / 10; // Round to 1 decimal
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
/**
|
|
59
|
-
* Count total number of companies worked at
|
|
60
|
-
* @param {Array} work - Array of work experience objects
|
|
61
|
-
* @returns {number} Number of unique companies
|
|
62
|
-
*
|
|
63
|
-
* @example
|
|
64
|
-
* const companies = countCompanies(resume.work);
|
|
65
|
-
* // => 5
|
|
66
|
-
*/
|
|
67
|
-
export function countCompanies(work = []) {
|
|
68
|
-
if (!Array.isArray(work) || work.length === 0) return 0;
|
|
69
|
-
|
|
70
|
-
const uniqueCompanies = new Set(work.map((job) => job.name).filter(Boolean));
|
|
71
|
-
|
|
72
|
-
return uniqueCompanies.size;
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
/**
|
|
76
|
-
* Count total number of projects
|
|
77
|
-
* @param {Array} projects - Array of project objects
|
|
78
|
-
* @returns {number} Number of projects
|
|
79
|
-
*
|
|
80
|
-
* @example
|
|
81
|
-
* const projectCount = countProjects(resume.projects);
|
|
82
|
-
* // => 12
|
|
83
|
-
*/
|
|
84
|
-
export function countProjects(projects = []) {
|
|
85
|
-
return Array.isArray(projects) ? projects.length : 0;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Count total number of publications
|
|
90
|
-
* @param {Array} publications - Array of publication objects
|
|
91
|
-
* @returns {number} Number of publications
|
|
92
|
-
*
|
|
93
|
-
* @example
|
|
94
|
-
* const pubCount = countPublications(resume.publications);
|
|
95
|
-
* // => 8
|
|
96
|
-
*/
|
|
97
|
-
export function countPublications(publications = []) {
|
|
98
|
-
return Array.isArray(publications) ? publications.length : 0;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* Count total number of awards received
|
|
103
|
-
* @param {Array} awards - Array of award objects
|
|
104
|
-
* @returns {number} Number of awards
|
|
105
|
-
*
|
|
106
|
-
* @example
|
|
107
|
-
* const awardCount = countAwards(resume.awards);
|
|
108
|
-
* // => 3
|
|
109
|
-
*/
|
|
110
|
-
export function countAwards(awards = []) {
|
|
111
|
-
return Array.isArray(awards) ? awards.length : 0;
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
/**
|
|
115
|
-
* Count total skills across all skill categories
|
|
116
|
-
* @param {Array} skills - Array of skill objects with keywords
|
|
117
|
-
* @returns {number} Total number of skill keywords
|
|
118
|
-
*
|
|
119
|
-
* @example
|
|
120
|
-
* const skillCount = countTotalSkills(resume.skills);
|
|
121
|
-
* // => 42
|
|
122
|
-
*/
|
|
123
|
-
export function countTotalSkills(skills = []) {
|
|
124
|
-
if (!Array.isArray(skills) || skills.length === 0) return 0;
|
|
125
|
-
|
|
126
|
-
return skills.reduce((total, skill) => {
|
|
127
|
-
const keywords = skill.keywords || [];
|
|
128
|
-
return total + keywords.length;
|
|
129
|
-
}, 0);
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
/**
|
|
133
|
-
* Count skill categories
|
|
134
|
-
* @param {Array} skills - Array of skill objects
|
|
135
|
-
* @returns {number} Number of skill categories
|
|
136
|
-
*
|
|
137
|
-
* @example
|
|
138
|
-
* const categories = countSkillCategories(resume.skills);
|
|
139
|
-
* // => 6
|
|
140
|
-
*/
|
|
141
|
-
export function countSkillCategories(skills = []) {
|
|
142
|
-
return Array.isArray(skills) ? skills.length : 0;
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
/**
|
|
146
|
-
* Count languages spoken
|
|
147
|
-
* @param {Array} languages - Array of language objects
|
|
148
|
-
* @returns {number} Number of languages
|
|
149
|
-
*
|
|
150
|
-
* @example
|
|
151
|
-
* const langCount = countLanguages(resume.languages);
|
|
152
|
-
* // => 3
|
|
153
|
-
*/
|
|
154
|
-
export function countLanguages(languages = []) {
|
|
155
|
-
return Array.isArray(languages) ? languages.length : 0;
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
/**
|
|
159
|
-
* Calculate total volunteer hours (if duration data is available)
|
|
160
|
-
* @param {Array} volunteer - Array of volunteer objects with startDate and endDate
|
|
161
|
-
* @returns {number} Total volunteer years
|
|
162
|
-
*
|
|
163
|
-
* @example
|
|
164
|
-
* const volunteerYears = calculateVolunteerYears(resume.volunteer);
|
|
165
|
-
* // => 4
|
|
166
|
-
*/
|
|
167
|
-
export function calculateVolunteerYears(volunteer = []) {
|
|
168
|
-
if (!Array.isArray(volunteer) || volunteer.length === 0) return 0;
|
|
169
|
-
|
|
170
|
-
const totalYears = volunteer.reduce((acc, vol) => {
|
|
171
|
-
if (!vol.startDate) return acc;
|
|
172
|
-
|
|
173
|
-
const start = new Date(vol.startDate);
|
|
174
|
-
const end = vol.endDate ? new Date(vol.endDate) : new Date();
|
|
175
|
-
const years = (end - start) / (1000 * 60 * 60 * 24 * 365.25);
|
|
176
|
-
|
|
177
|
-
return acc + years;
|
|
178
|
-
}, 0);
|
|
179
|
-
|
|
180
|
-
return Math.round(totalYears);
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
/**
|
|
184
|
-
* Calculate total education years
|
|
185
|
-
* @param {Array} education - Array of education objects with startDate and endDate
|
|
186
|
-
* @returns {number} Total years of education
|
|
187
|
-
*
|
|
188
|
-
* @example
|
|
189
|
-
* const eduYears = calculateEducationYears(resume.education);
|
|
190
|
-
* // => 6
|
|
191
|
-
*/
|
|
192
|
-
export function calculateEducationYears(education = []) {
|
|
193
|
-
if (!Array.isArray(education) || education.length === 0) return 0;
|
|
194
|
-
|
|
195
|
-
const totalYears = education.reduce((acc, edu) => {
|
|
196
|
-
if (!edu.startDate) return acc;
|
|
197
|
-
|
|
198
|
-
const start = new Date(edu.startDate);
|
|
199
|
-
const end = edu.endDate ? new Date(edu.endDate) : new Date();
|
|
200
|
-
const years = (end - start) / ((1000 * 60 * 60 * 24) / 365.25);
|
|
201
|
-
|
|
202
|
-
return acc + years;
|
|
203
|
-
}, 0);
|
|
204
|
-
|
|
205
|
-
return Math.round(totalYears);
|
|
206
|
-
}
|
|
207
|
-
|
|
208
|
-
/**
|
|
209
|
-
* Get highest education level
|
|
210
|
-
* @param {Array} education - Array of education objects with studyType
|
|
211
|
-
* @returns {string} Highest degree (PhD, Master's, Bachelor's, etc.)
|
|
212
|
-
*
|
|
213
|
-
* @example
|
|
214
|
-
* const degree = getHighestDegree(resume.education);
|
|
215
|
-
* // => "PhD"
|
|
216
|
-
*/
|
|
217
|
-
export function getHighestDegree(education = []) {
|
|
218
|
-
if (!Array.isArray(education) || education.length === 0) return '';
|
|
219
|
-
|
|
220
|
-
const degreeRanking = {
|
|
221
|
-
phd: 5,
|
|
222
|
-
doctorate: 5,
|
|
223
|
-
doctoral: 5,
|
|
224
|
-
master: 4,
|
|
225
|
-
mba: 4,
|
|
226
|
-
bachelor: 3,
|
|
227
|
-
associate: 2,
|
|
228
|
-
diploma: 1,
|
|
229
|
-
certificate: 1,
|
|
230
|
-
};
|
|
231
|
-
|
|
232
|
-
let highest = { level: 0, studyType: '' };
|
|
233
|
-
|
|
234
|
-
education.forEach((edu) => {
|
|
235
|
-
if (!edu.studyType) return;
|
|
236
|
-
|
|
237
|
-
const studyTypeLower = edu.studyType.toLowerCase();
|
|
238
|
-
for (const [key, level] of Object.entries(degreeRanking)) {
|
|
239
|
-
if (studyTypeLower.includes(key) && level > highest.level) {
|
|
240
|
-
highest = { level, studyType: edu.studyType };
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
});
|
|
244
|
-
|
|
245
|
-
return highest.studyType;
|
|
246
|
-
}
|
|
247
|
-
|
|
248
|
-
/**
|
|
249
|
-
* Calculate career trajectory (promotions/role changes)
|
|
250
|
-
* @param {Array} work - Array of work experience objects with position
|
|
251
|
-
* @returns {number} Number of distinct positions held
|
|
252
|
-
*
|
|
253
|
-
* @example
|
|
254
|
-
* const positions = countCareerPositions(resume.work);
|
|
255
|
-
* // => 7
|
|
256
|
-
*/
|
|
257
|
-
export function countCareerPositions(work = []) {
|
|
258
|
-
if (!Array.isArray(work) || work.length === 0) return 0;
|
|
259
|
-
|
|
260
|
-
const uniquePositions = new Set(
|
|
261
|
-
work.map((job) => job.position).filter(Boolean)
|
|
262
|
-
);
|
|
263
|
-
|
|
264
|
-
return uniquePositions.size;
|
|
265
|
-
}
|
|
266
|
-
|
|
267
|
-
/**
|
|
268
|
-
* Get career progression rate (positions per year)
|
|
269
|
-
* @param {Array} work - Array of work experience objects
|
|
270
|
-
* @returns {number} Average years per position
|
|
271
|
-
*
|
|
272
|
-
* @example
|
|
273
|
-
* const rate = getCareerProgressionRate(resume.work);
|
|
274
|
-
* // => 2.3 (years per position)
|
|
275
|
-
*/
|
|
276
|
-
export function getCareerProgressionRate(work = []) {
|
|
277
|
-
const totalYears = calculateTotalExperience(work);
|
|
278
|
-
const positions = countCareerPositions(work);
|
|
279
|
-
|
|
280
|
-
if (totalYears === 0 || positions === 0) return 0;
|
|
281
|
-
|
|
282
|
-
return Math.round((totalYears / positions) * 10) / 10;
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
/**
|
|
286
|
-
* Calculate total highlights/achievements across work experience
|
|
287
|
-
* @param {Array} work - Array of work experience objects with highlights
|
|
288
|
-
* @returns {number} Total number of highlights
|
|
289
|
-
*
|
|
290
|
-
* @example
|
|
291
|
-
* const achievements = countTotalHighlights(resume.work);
|
|
292
|
-
* // => 28
|
|
293
|
-
*/
|
|
294
|
-
export function countTotalHighlights(work = []) {
|
|
295
|
-
if (!Array.isArray(work) || work.length === 0) return 0;
|
|
296
|
-
|
|
297
|
-
return work.reduce((total, job) => {
|
|
298
|
-
const highlights = job.highlights || [];
|
|
299
|
-
return total + highlights.length;
|
|
300
|
-
}, 0);
|
|
301
|
-
}
|
|
302
|
-
|
|
303
|
-
/**
|
|
304
|
-
* Get all unique industries from work experience
|
|
305
|
-
* @param {Array} work - Array of work experience objects with industry field
|
|
306
|
-
* @returns {Array<string>} Array of unique industries
|
|
307
|
-
*
|
|
308
|
-
* @example
|
|
309
|
-
* const industries = getUniqueIndustries(resume.work);
|
|
310
|
-
* // => ["Technology", "Finance", "Healthcare"]
|
|
311
|
-
*/
|
|
312
|
-
export function getUniqueIndustries(work = []) {
|
|
313
|
-
if (!Array.isArray(work) || work.length === 0) return [];
|
|
314
|
-
|
|
315
|
-
const industries = new Set(work.map((job) => job.industry).filter(Boolean));
|
|
316
|
-
|
|
317
|
-
return Array.from(industries);
|
|
318
|
-
}
|
|
319
|
-
|
|
320
|
-
/**
|
|
321
|
-
* Get most recent/current employer
|
|
322
|
-
* @param {Array} work - Array of work experience objects
|
|
323
|
-
* @returns {Object|null} Most recent work object
|
|
324
|
-
*
|
|
325
|
-
* @example
|
|
326
|
-
* const current = getCurrentEmployer(resume.work);
|
|
327
|
-
* // => { name: "Google", position: "Senior Engineer", ... }
|
|
328
|
-
*/
|
|
329
|
-
export function getCurrentEmployer(work = []) {
|
|
330
|
-
if (!Array.isArray(work) || work.length === 0) return null;
|
|
331
|
-
|
|
332
|
-
// Find first job without endDate (current), or first in array
|
|
333
|
-
return work.find((job) => !job.endDate) || work[0];
|
|
334
|
-
}
|
|
335
|
-
|
|
336
|
-
/**
|
|
337
|
-
* Check if currently employed
|
|
338
|
-
* @param {Array} work - Array of work experience objects
|
|
339
|
-
* @returns {boolean} True if currently employed
|
|
340
|
-
*
|
|
341
|
-
* @example
|
|
342
|
-
* const employed = isCurrentlyEmployed(resume.work);
|
|
343
|
-
* // => true
|
|
344
|
-
*/
|
|
345
|
-
export function isCurrentlyEmployed(work = []) {
|
|
346
|
-
if (!Array.isArray(work) || work.length === 0) return false;
|
|
347
|
-
return work.some((job) => !job.endDate);
|
|
348
|
-
}
|
|
349
|
-
|
|
350
|
-
/**
|
|
351
|
-
* Calculate comprehensive Key Metrics object for dashboard displays
|
|
352
|
-
* @param {Object} resume - Complete JSON Resume object
|
|
353
|
-
* @returns {Array<Object>} Array of metric objects with label and value
|
|
354
|
-
*
|
|
355
|
-
* @example
|
|
356
|
-
* const metrics = calculateKeyMetrics(resume);
|
|
357
|
-
* // => [
|
|
358
|
-
* // { label: 'Years Experience', value: 8 },
|
|
359
|
-
* // { label: 'Companies', value: 5 },
|
|
360
|
-
* // { label: 'Projects', value: 12 },
|
|
361
|
-
* // { label: 'Core Skills', value: 42 }
|
|
362
|
-
* // ]
|
|
363
|
-
*/
|
|
364
|
-
export function calculateKeyMetrics(resume) {
|
|
365
|
-
const metrics = [];
|
|
366
|
-
|
|
367
|
-
const {
|
|
368
|
-
work = [],
|
|
369
|
-
projects = [],
|
|
370
|
-
skills = [],
|
|
371
|
-
publications = [],
|
|
372
|
-
awards = [],
|
|
373
|
-
education = [],
|
|
374
|
-
volunteer = [],
|
|
375
|
-
languages = [],
|
|
376
|
-
} = resume;
|
|
377
|
-
|
|
378
|
-
// Experience
|
|
379
|
-
const experience = calculateTotalExperience(work);
|
|
380
|
-
if (experience > 0) {
|
|
381
|
-
metrics.push({ label: 'Years Experience', value: experience });
|
|
382
|
-
}
|
|
383
|
-
|
|
384
|
-
// Companies
|
|
385
|
-
const companies = countCompanies(work);
|
|
386
|
-
if (companies > 0) {
|
|
387
|
-
metrics.push({ label: 'Companies', value: companies });
|
|
388
|
-
}
|
|
389
|
-
|
|
390
|
-
// Projects
|
|
391
|
-
const projectCount = countProjects(projects);
|
|
392
|
-
if (projectCount > 0) {
|
|
393
|
-
metrics.push({ label: 'Projects', value: projectCount });
|
|
394
|
-
}
|
|
395
|
-
|
|
396
|
-
// Skills
|
|
397
|
-
const skillCount = countTotalSkills(skills);
|
|
398
|
-
if (skillCount > 0) {
|
|
399
|
-
metrics.push({ label: 'Core Skills', value: skillCount });
|
|
400
|
-
}
|
|
401
|
-
|
|
402
|
-
// Publications
|
|
403
|
-
const pubCount = countPublications(publications);
|
|
404
|
-
if (pubCount > 0) {
|
|
405
|
-
metrics.push({ label: 'Publications', value: pubCount });
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
// Awards
|
|
409
|
-
const awardCount = countAwards(awards);
|
|
410
|
-
if (awardCount > 0) {
|
|
411
|
-
metrics.push({ label: 'Awards', value: awardCount });
|
|
412
|
-
}
|
|
413
|
-
|
|
414
|
-
// Education
|
|
415
|
-
const degree = getHighestDegree(education);
|
|
416
|
-
if (degree) {
|
|
417
|
-
metrics.push({ label: 'Education', value: degree });
|
|
418
|
-
}
|
|
419
|
-
|
|
420
|
-
// Languages
|
|
421
|
-
const langCount = countLanguages(languages);
|
|
422
|
-
if (langCount > 1) {
|
|
423
|
-
// Only show if multilingual
|
|
424
|
-
metrics.push({ label: 'Languages', value: langCount });
|
|
425
|
-
}
|
|
426
|
-
|
|
427
|
-
return metrics;
|
|
428
|
-
}
|
|
7
|
+
* This module is a thin re-export barrel. The implementations now live in
|
|
8
|
+
* @jsonresume/utils (framework-free); the sibling modules below re-export them
|
|
9
|
+
* so @jsonresume/core's public surface stays byte-for-byte stable:
|
|
10
|
+
* - ./experience.js work tenure & career progression
|
|
11
|
+
* - ./counts.js simple section tallies
|
|
12
|
+
* - ./education.js education years & highest degree
|
|
13
|
+
* - ./workHistory.js employment status, industries, volunteer tenure
|
|
14
|
+
* - ./keyMetrics.js dashboard metrics aggregation
|
|
15
|
+
*
|
|
16
|
+
* @module @jsonresume/core/helpers/calculations
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
export {
|
|
20
|
+
calculateTotalExperience,
|
|
21
|
+
calculateCurrentRoleExperience,
|
|
22
|
+
countCareerPositions,
|
|
23
|
+
getCareerProgressionRate,
|
|
24
|
+
countTotalHighlights,
|
|
25
|
+
} from './experience.js';
|
|
26
|
+
|
|
27
|
+
export {
|
|
28
|
+
countCompanies,
|
|
29
|
+
countProjects,
|
|
30
|
+
countPublications,
|
|
31
|
+
countAwards,
|
|
32
|
+
countTotalSkills,
|
|
33
|
+
countSkillCategories,
|
|
34
|
+
countLanguages,
|
|
35
|
+
} from './counts.js';
|
|
36
|
+
|
|
37
|
+
export { calculateEducationYears, getHighestDegree } from './education.js';
|
|
38
|
+
|
|
39
|
+
export {
|
|
40
|
+
calculateVolunteerYears,
|
|
41
|
+
getUniqueIndustries,
|
|
42
|
+
getCurrentEmployer,
|
|
43
|
+
isCurrentlyEmployed,
|
|
44
|
+
} from './workHistory.js';
|
|
45
|
+
|
|
46
|
+
export { calculateKeyMetrics } from './keyMetrics.js';
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resume Count Calculation Helpers
|
|
3
|
+
*
|
|
4
|
+
* Re-exported from @jsonresume/utils (framework-free).
|
|
5
|
+
*
|
|
6
|
+
* @module @jsonresume/core/helpers/counts
|
|
7
|
+
*/
|
|
8
|
+
export {
|
|
9
|
+
countCompanies,
|
|
10
|
+
countProjects,
|
|
11
|
+
countPublications,
|
|
12
|
+
countAwards,
|
|
13
|
+
countTotalSkills,
|
|
14
|
+
countSkillCategories,
|
|
15
|
+
countLanguages,
|
|
16
|
+
} from '@jsonresume/utils/metrics';
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resume Education Calculation Helpers
|
|
3
|
+
*
|
|
4
|
+
* Re-exported from @jsonresume/utils (framework-free). Note: calculateEducationYears
|
|
5
|
+
* now uses the corrected ms-per-year formula (Wave 1 bugfix).
|
|
6
|
+
*
|
|
7
|
+
* @module @jsonresume/core/helpers/education
|
|
8
|
+
*/
|
|
9
|
+
export {
|
|
10
|
+
calculateEducationYears,
|
|
11
|
+
getHighestDegree,
|
|
12
|
+
} from '@jsonresume/utils/metrics';
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resume Experience Calculation Helpers
|
|
3
|
+
*
|
|
4
|
+
* Re-exported from @jsonresume/utils (framework-free). The implementations
|
|
5
|
+
* moved there in Wave 1; this shim keeps @jsonresume/core's public surface
|
|
6
|
+
* byte-for-byte stable.
|
|
7
|
+
*
|
|
8
|
+
* @module @jsonresume/core/helpers/experience
|
|
9
|
+
*/
|
|
10
|
+
export {
|
|
11
|
+
calculateTotalExperience,
|
|
12
|
+
calculateCurrentRoleExperience,
|
|
13
|
+
countCareerPositions,
|
|
14
|
+
getCareerProgressionRate,
|
|
15
|
+
countTotalHighlights,
|
|
16
|
+
} from '@jsonresume/utils/metrics';
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @jsonresume/core/helpers
|
|
3
|
+
*
|
|
4
|
+
* Discoverability re-export of the framework-free @jsonresume/utils surface
|
|
5
|
+
* (date, metrics, and URL helpers). Prefer importing from @jsonresume/utils
|
|
6
|
+
* directly in new code; this subpath exists so the helpers are easy to find
|
|
7
|
+
* from @jsonresume/core.
|
|
8
|
+
*
|
|
9
|
+
* @module @jsonresume/core/helpers
|
|
10
|
+
*/
|
|
11
|
+
export * from '@jsonresume/utils';
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resume Work History Insight Helpers
|
|
3
|
+
*
|
|
4
|
+
* Re-exported from @jsonresume/utils (framework-free).
|
|
5
|
+
*
|
|
6
|
+
* @module @jsonresume/core/helpers/workHistory
|
|
7
|
+
*/
|
|
8
|
+
export {
|
|
9
|
+
calculateVolunteerYears,
|
|
10
|
+
getUniqueIndustries,
|
|
11
|
+
getCurrentEmployer,
|
|
12
|
+
isCurrentlyEmployed,
|
|
13
|
+
} from '@jsonresume/utils/metrics';
|
package/src/index.js
CHANGED
|
@@ -1,7 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @
|
|
2
|
+
* @jsonresume/core
|
|
3
3
|
* React component library for building ATS-friendly resume themes
|
|
4
4
|
* Design tokens, primitives, and utilities with JSX
|
|
5
|
+
*
|
|
6
|
+
* The pure (framework-free) calculation, date, and URL helpers re-exported
|
|
7
|
+
* below now live in @jsonresume/utils; they are re-exported here so existing
|
|
8
|
+
* `import { ... } from '@jsonresume/core'` consumers keep working unchanged.
|
|
5
9
|
*/
|
|
6
10
|
|
|
7
11
|
// Export theme provider
|
|
@@ -249,5 +253,6 @@ export { ToolTagRibbon } from './tags/index.jsx';
|
|
|
249
253
|
// Export badge components
|
|
250
254
|
export { BadgeRowOutline } from './badges/index.jsx';
|
|
251
255
|
|
|
252
|
-
// Package metadata
|
|
253
|
-
|
|
256
|
+
// Package metadata. Kept in sync with package.json's "version" (the canonical,
|
|
257
|
+
// changeset-managed source of truth).
|
|
258
|
+
export const version = '0.1.0';
|
|
@@ -1,115 +1,13 @@
|
|
|
1
1
|
import React from 'react';
|
|
2
2
|
import styled from 'styled-components';
|
|
3
|
+
import { formatDateRange } from '@jsonresume/utils/dates';
|
|
3
4
|
|
|
4
5
|
/**
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* @param {Object} options - DateRange options
|
|
9
|
-
* @param {string|Date} options.startDate - Start date (ISO string or Date object)
|
|
10
|
-
* @param {string|Date} [options.endDate] - End date (ISO string, Date object, or null for "Present")
|
|
11
|
-
* @param {string} [options.format='short'] - Format style: 'short' (default), 'long', 'numeric'
|
|
12
|
-
* @param {string} [options.locale='en-US'] - BCP 47 locale (e.g., 'en-US', 'fr-FR', 'ar-SA')
|
|
13
|
-
* @param {string} [options.numberingSystem] - Numbering system (e.g., 'arab', 'latn', 'hanidec')
|
|
14
|
-
* @param {string} [options.presentLabel] - Custom label for present/ongoing (defaults to localized)
|
|
15
|
-
* @returns {string} Formatted date range
|
|
16
|
-
*
|
|
17
|
-
* @example
|
|
18
|
-
* formatDateRange({ startDate: '2020-01-15', endDate: null })
|
|
19
|
-
* // 'Jan 2020 - Present'
|
|
20
|
-
*
|
|
21
|
-
* @example
|
|
22
|
-
* formatDateRange({
|
|
23
|
-
* startDate: '2020-01-15',
|
|
24
|
-
* locale: 'fr-FR',
|
|
25
|
-
* format: 'long'
|
|
26
|
-
* })
|
|
27
|
-
* // 'janvier 2020 - Présent'
|
|
28
|
-
*
|
|
29
|
-
* @example
|
|
30
|
-
* formatDateRange({
|
|
31
|
-
* startDate: '2020-01-15',
|
|
32
|
-
* locale: 'ar-SA',
|
|
33
|
-
* numberingSystem: 'arab'
|
|
34
|
-
* })
|
|
35
|
-
* // With Arabic numerals
|
|
6
|
+
* The pure date-formatting function now lives in @jsonresume/utils (no React /
|
|
7
|
+
* styled-components). It is re-exported here so existing imports
|
|
8
|
+
* (`import { formatDateRange } from '@jsonresume/core'`) keep working.
|
|
36
9
|
*/
|
|
37
|
-
export
|
|
38
|
-
startDate,
|
|
39
|
-
endDate,
|
|
40
|
-
format = 'short',
|
|
41
|
-
locale = 'en-US',
|
|
42
|
-
numberingSystem,
|
|
43
|
-
presentLabel,
|
|
44
|
-
}) {
|
|
45
|
-
if (!startDate) return '';
|
|
46
|
-
|
|
47
|
-
// Determine "Present" label based on locale
|
|
48
|
-
const getPresentLabel = () => {
|
|
49
|
-
if (presentLabel) return presentLabel;
|
|
50
|
-
|
|
51
|
-
const labels = {
|
|
52
|
-
en: 'Present',
|
|
53
|
-
'en-US': 'Present',
|
|
54
|
-
'en-GB': 'Present',
|
|
55
|
-
fr: 'Présent',
|
|
56
|
-
'fr-FR': 'Présent',
|
|
57
|
-
es: 'Presente',
|
|
58
|
-
'es-ES': 'Presente',
|
|
59
|
-
de: 'Heute',
|
|
60
|
-
'de-DE': 'Heute',
|
|
61
|
-
it: 'Presente',
|
|
62
|
-
'it-IT': 'Presente',
|
|
63
|
-
pt: 'Presente',
|
|
64
|
-
'pt-BR': 'Presente',
|
|
65
|
-
ja: '現在',
|
|
66
|
-
'ja-JP': '現在',
|
|
67
|
-
zh: '至今',
|
|
68
|
-
'zh-CN': '至今',
|
|
69
|
-
'zh-TW': '至今',
|
|
70
|
-
ko: '현재',
|
|
71
|
-
'ko-KR': '현재',
|
|
72
|
-
ar: 'حاضر',
|
|
73
|
-
'ar-SA': 'حاضر',
|
|
74
|
-
};
|
|
75
|
-
|
|
76
|
-
return labels[locale] || labels[locale.split('-')[0]] || 'Present';
|
|
77
|
-
};
|
|
78
|
-
|
|
79
|
-
const formatDate = (dateStr) => {
|
|
80
|
-
if (!dateStr) return getPresentLabel();
|
|
81
|
-
|
|
82
|
-
const date = typeof dateStr === 'string' ? new Date(dateStr) : dateStr;
|
|
83
|
-
|
|
84
|
-
if (isNaN(date.getTime())) return dateStr; // Invalid date, return as-is
|
|
85
|
-
|
|
86
|
-
// Configure Intl.DateTimeFormat based on format style
|
|
87
|
-
const monthFormats = {
|
|
88
|
-
short: { month: 'short' },
|
|
89
|
-
long: { month: 'long' },
|
|
90
|
-
numeric: { month: '2-digit' },
|
|
91
|
-
};
|
|
92
|
-
|
|
93
|
-
const options = {
|
|
94
|
-
...monthFormats[format],
|
|
95
|
-
year: 'numeric',
|
|
96
|
-
};
|
|
97
|
-
|
|
98
|
-
// Add numbering system if provided
|
|
99
|
-
if (numberingSystem) {
|
|
100
|
-
options.numberingSystem = numberingSystem;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
// Use Intl.DateTimeFormat for proper locale support
|
|
104
|
-
const formatter = new Intl.DateTimeFormat(locale, options);
|
|
105
|
-
return formatter.format(date);
|
|
106
|
-
};
|
|
107
|
-
|
|
108
|
-
const start = formatDate(startDate);
|
|
109
|
-
const end = formatDate(endDate);
|
|
110
|
-
|
|
111
|
-
return `${start} - ${end}`;
|
|
112
|
-
}
|
|
10
|
+
export { formatDateRange };
|
|
113
11
|
|
|
114
12
|
/**
|
|
115
13
|
* DateRange Component
|