@jsonresume/core 0.1.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.
Files changed (279) hide show
  1. package/README.md +689 -0
  2. package/dist/resume-print.css +425 -0
  3. package/dist/tokens.css +139 -0
  4. package/package.json +66 -0
  5. package/src/badges/BadgeRowOutline.jsx +118 -0
  6. package/src/badges/BadgeRowOutline.stories.tsx +160 -0
  7. package/src/badges/index.jsx +5 -0
  8. package/src/callouts/Callout.jsx +80 -0
  9. package/src/callouts/Callout.stories.tsx +27 -0
  10. package/src/callouts/HighlightCard.jsx +114 -0
  11. package/src/callouts/HighlightCard.stories.tsx +27 -0
  12. package/src/callouts/InfoBox.jsx +82 -0
  13. package/src/callouts/InfoBox.stories.tsx +26 -0
  14. package/src/callouts/index.jsx +4 -0
  15. package/src/certifications/AwardCard.jsx +83 -0
  16. package/src/certifications/AwardCard.stories.tsx +32 -0
  17. package/src/certifications/CertificationBadge.jsx +85 -0
  18. package/src/certifications/CertificationBadge.stories.tsx +29 -0
  19. package/src/certifications/CertificationRow.jsx +150 -0
  20. package/src/certifications/CertificationRow.stories.tsx +64 -0
  21. package/src/certifications/HonorsList.jsx +87 -0
  22. package/src/certifications/HonorsList.stories.tsx +36 -0
  23. package/src/certifications/index.jsx +5 -0
  24. package/src/containers/AccentCalloutPanel.jsx +176 -0
  25. package/src/containers/AccentCalloutPanel.stories.tsx +105 -0
  26. package/src/containers/MutedPanel.jsx +125 -0
  27. package/src/containers/MutedPanel.stories.tsx +113 -0
  28. package/src/containers/RoleBlockFramed.jsx +191 -0
  29. package/src/containers/RoleBlockFramed.stories.tsx +230 -0
  30. package/src/containers/SoftCardOutline.jsx +161 -0
  31. package/src/containers/SoftCardOutline.stories.tsx +174 -0
  32. package/src/containers/index.jsx +9 -0
  33. package/src/data/KPIChipLine.jsx +158 -0
  34. package/src/data/KPIChipLine.stories.tsx +99 -0
  35. package/src/data/KeyValueInline.jsx +150 -0
  36. package/src/data/KeyValueInline.stories.tsx +136 -0
  37. package/src/data/MetricBar.jsx +93 -0
  38. package/src/data/MetricBar.stories.tsx +31 -0
  39. package/src/data/MetricBullet.jsx +129 -0
  40. package/src/data/MetricBullet.stories.tsx +99 -0
  41. package/src/data/MetricInline.jsx +60 -0
  42. package/src/data/MetricInline.stories.tsx +53 -0
  43. package/src/data/ProgressCircle.jsx +81 -0
  44. package/src/data/ProgressCircle.stories.tsx +102 -0
  45. package/src/data/StatCard.jsx +65 -0
  46. package/src/data/StatCard.stories.tsx +29 -0
  47. package/src/data/index.jsx +12 -0
  48. package/src/dates/DateBadge.jsx +73 -0
  49. package/src/dates/DateBadge.stories.tsx +30 -0
  50. package/src/dates/RelativeDate.jsx +121 -0
  51. package/src/dates/RelativeDate.stories.tsx +29 -0
  52. package/src/dates/index.jsx +3 -0
  53. package/src/experience/ExperienceCard.jsx +82 -0
  54. package/src/experience/ExperienceCard.stories.tsx +36 -0
  55. package/src/experience/ExperienceCompact.jsx +72 -0
  56. package/src/experience/ExperienceCompact.stories.tsx +53 -0
  57. package/src/experience/ExperienceGrid.jsx +65 -0
  58. package/src/experience/ExperienceGrid.stories.tsx +63 -0
  59. package/src/experience/ExperienceTimeline.jsx +24 -0
  60. package/src/experience/ExperienceTimeline.stories.tsx +63 -0
  61. package/src/experience/RoleHeaderCompact.jsx +99 -0
  62. package/src/experience/index.jsx +9 -0
  63. package/src/header/ContactRowLine.jsx +125 -0
  64. package/src/header/ContactRowLine.stories.tsx +65 -0
  65. package/src/header/CornerInitials.jsx +178 -0
  66. package/src/header/CornerInitials.stories.tsx +129 -0
  67. package/src/header/Footer.jsx +50 -0
  68. package/src/header/Footer.stories.tsx +25 -0
  69. package/src/header/HeaderCentered.jsx +51 -0
  70. package/src/header/HeaderCentered.stories.tsx +30 -0
  71. package/src/header/HeaderMinimal.jsx +50 -0
  72. package/src/header/HeaderMinimal.stories.tsx +29 -0
  73. package/src/header/HeaderSplit.jsx +65 -0
  74. package/src/header/HeaderSplit.stories.tsx +29 -0
  75. package/src/header/HeroNameBlock.jsx +71 -0
  76. package/src/header/HeroNameBlock.stories.tsx +37 -0
  77. package/src/header/NameStackElegant.jsx +104 -0
  78. package/src/header/NameStackElegant.stories.tsx +60 -0
  79. package/src/header/PageBreak.jsx +25 -0
  80. package/src/header/PageBreak.stories.tsx +22 -0
  81. package/src/header/SectionFlagTitle.jsx +87 -0
  82. package/src/header/SectionFlagTitle.stories.tsx +53 -0
  83. package/src/header/SectionRuleTitle.jsx +84 -0
  84. package/src/header/SectionRuleTitle.stories.tsx +52 -0
  85. package/src/header/index.jsx +18 -0
  86. package/src/helpers/calculations.js +428 -0
  87. package/src/index.js +253 -0
  88. package/src/languages/LanguageBar.jsx +90 -0
  89. package/src/languages/LanguageBar.stories.tsx +28 -0
  90. package/src/languages/LanguageGrid.jsx +118 -0
  91. package/src/languages/LanguageGrid.stories.tsx +33 -0
  92. package/src/languages/LanguageLevelBarLite.jsx +147 -0
  93. package/src/languages/LanguageLevelBarLite.stories.tsx +74 -0
  94. package/src/languages/ProficiencyScale.jsx +107 -0
  95. package/src/languages/ProficiencyScale.stories.tsx +30 -0
  96. package/src/languages/index.jsx +5 -0
  97. package/src/layouts/CardLayout.jsx +46 -0
  98. package/src/layouts/CardLayout.stories.tsx +272 -0
  99. package/src/layouts/FlexLayout.jsx +53 -0
  100. package/src/layouts/FlexLayout.stories.tsx +270 -0
  101. package/src/layouts/GridLayout.jsx +38 -0
  102. package/src/layouts/GridLayout.stories.tsx +183 -0
  103. package/src/layouts/SidebarLayout.jsx +63 -0
  104. package/src/layouts/SidebarLayout.stories.tsx +162 -0
  105. package/src/layouts/StackLayout.jsx +26 -0
  106. package/src/layouts/StackLayout.stories.tsx +192 -0
  107. package/src/layouts/TwoColumnMicroGrid.jsx +87 -0
  108. package/src/layouts/TwoColumnMicroGrid.stories.tsx +96 -0
  109. package/src/layouts/index.jsx +11 -0
  110. package/src/lists/AchievementListSpacious.jsx +81 -0
  111. package/src/lists/AchievementListSpacious.stories.tsx +49 -0
  112. package/src/lists/AchievementListTight.jsx +80 -0
  113. package/src/lists/AchievementListTight.stories.tsx +49 -0
  114. package/src/lists/BulletList.jsx +66 -0
  115. package/src/lists/BulletList.stories.tsx +38 -0
  116. package/src/lists/CheckList.jsx +94 -0
  117. package/src/lists/CheckList.stories.tsx +38 -0
  118. package/src/lists/CompactList.jsx +90 -0
  119. package/src/lists/CompactList.stories.tsx +34 -0
  120. package/src/lists/DefinitionKeyline.jsx +114 -0
  121. package/src/lists/DefinitionKeyline.stories.tsx +90 -0
  122. package/src/lists/HangingBulletList.jsx +82 -0
  123. package/src/lists/HangingBulletList.stories.tsx +50 -0
  124. package/src/lists/IconList.jsx +89 -0
  125. package/src/lists/IconList.stories.tsx +36 -0
  126. package/src/lists/ListDashCompact.jsx +69 -0
  127. package/src/lists/ListDashCompact.stories.tsx +60 -0
  128. package/src/lists/MiniDotLeaderList.jsx +69 -0
  129. package/src/lists/MiniDotLeaderList.stories.tsx +73 -0
  130. package/src/lists/NumberedList.jsx +74 -0
  131. package/src/lists/NumberedList.stories.tsx +39 -0
  132. package/src/lists/index.jsx +12 -0
  133. package/src/metadata/GreyLabelCaps.jsx +66 -0
  134. package/src/metadata/GreyLabelCaps.stories.tsx +40 -0
  135. package/src/metadata/InlineKicker.jsx +61 -0
  136. package/src/metadata/InlineKicker.stories.tsx +35 -0
  137. package/src/metadata/MetaRow.jsx +96 -0
  138. package/src/metadata/MetaRow.stories.tsx +38 -0
  139. package/src/metadata/SmallCapsHeading.jsx +75 -0
  140. package/src/metadata/SmallCapsHeading.stories.tsx +54 -0
  141. package/src/metadata/SubsectionLabel.jsx +92 -0
  142. package/src/metadata/SubsectionLabel.stories.tsx +40 -0
  143. package/src/metadata/index.jsx +10 -0
  144. package/src/primitives/AccentSidebarStripe.stories.tsx +65 -0
  145. package/src/primitives/AccentSidebarStripe.tsx +95 -0
  146. package/src/primitives/AccentTopRule.stories.tsx +102 -0
  147. package/src/primitives/AccentTopRule.tsx +103 -0
  148. package/src/primitives/Badge.jsx +125 -0
  149. package/src/primitives/Badge.stories.tsx +27 -0
  150. package/src/primitives/ContactInfo.jsx +133 -0
  151. package/src/primitives/ContactInfo.stories.tsx +30 -0
  152. package/src/primitives/DIVIDERS.md +333 -0
  153. package/src/primitives/DateRange.jsx +178 -0
  154. package/src/primitives/DateRange.stories.tsx +28 -0
  155. package/src/primitives/DottedDivider.stories.tsx +54 -0
  156. package/src/primitives/DottedDivider.tsx +102 -0
  157. package/src/primitives/InlineSeparatorPipe.jsx +64 -0
  158. package/src/primitives/InlineSeparatorPipe.stories.tsx +96 -0
  159. package/src/primitives/KeylineDivider.stories.tsx +48 -0
  160. package/src/primitives/KeylineDivider.tsx +80 -0
  161. package/src/primitives/Link.jsx +59 -0
  162. package/src/primitives/Link.stories.tsx +29 -0
  163. package/src/primitives/ListItem.jsx +127 -0
  164. package/src/primitives/ListItem.stories.tsx +27 -0
  165. package/src/primitives/RulesetStack.stories.tsx +85 -0
  166. package/src/primitives/RulesetStack.tsx +117 -0
  167. package/src/primitives/Section.jsx +37 -0
  168. package/src/primitives/Section.stories.tsx +28 -0
  169. package/src/primitives/SectionTitle.jsx +62 -0
  170. package/src/primitives/SectionTitle.stories.tsx +27 -0
  171. package/src/primitives/index.jsx +36 -0
  172. package/src/print/ColumnBreak.jsx +44 -0
  173. package/src/print/ColumnBreak.stories.tsx +22 -0
  174. package/src/print/KeepTogether.jsx +24 -0
  175. package/src/print/KeepTogether.stories.tsx +26 -0
  176. package/src/print/LetterheadBar.jsx +100 -0
  177. package/src/print/LetterheadBar.stories.tsx +141 -0
  178. package/src/print/PageFooterLine.jsx +93 -0
  179. package/src/print/PageFooterLine.stories.tsx +121 -0
  180. package/src/print/PageHeaderLine.jsx +59 -0
  181. package/src/print/PageHeaderLine.stories.tsx +108 -0
  182. package/src/print/PrintOnly.jsx +49 -0
  183. package/src/print/PrintOnly.stories.tsx +26 -0
  184. package/src/print/SoftShadowEmulation.jsx +88 -0
  185. package/src/print/SoftShadowEmulation.stories.tsx +214 -0
  186. package/src/print/index.jsx +8 -0
  187. package/src/profile/Avatar.jsx +66 -0
  188. package/src/profile/Avatar.stories.tsx +84 -0
  189. package/src/profile/ContactGrid.jsx +63 -0
  190. package/src/profile/ContactGrid.stories.tsx +33 -0
  191. package/src/profile/ProfileCard.jsx +73 -0
  192. package/src/profile/ProfileCard.stories.tsx +35 -0
  193. package/src/profile/SocialLinks.jsx +61 -0
  194. package/src/profile/SocialLinks.stories.tsx +33 -0
  195. package/src/profile/index.jsx +9 -0
  196. package/src/providers/ThemeProvider.jsx +56 -0
  197. package/src/providers/ThemeProvider.stories.tsx +149 -0
  198. package/src/publications/PortfolioGrid.jsx +122 -0
  199. package/src/publications/PortfolioGrid.stories.tsx +62 -0
  200. package/src/publications/ProjectCard.jsx +151 -0
  201. package/src/publications/ProjectCard.stories.tsx +36 -0
  202. package/src/publications/PublicationEntryPlain.jsx +127 -0
  203. package/src/publications/PublicationEntryPlain.stories.tsx +58 -0
  204. package/src/publications/PublicationItem.jsx +120 -0
  205. package/src/publications/PublicationItem.stories.tsx +32 -0
  206. package/src/publications/index.jsx +5 -0
  207. package/src/quotes/BlockQuote.jsx +55 -0
  208. package/src/quotes/BlockQuote.stories.tsx +33 -0
  209. package/src/quotes/PullQuote.jsx +70 -0
  210. package/src/quotes/PullQuote.stories.tsx +32 -0
  211. package/src/quotes/Testimonial.jsx +99 -0
  212. package/src/quotes/Testimonial.stories.tsx +36 -0
  213. package/src/quotes/index.jsx +4 -0
  214. package/src/skills/SkillBar.jsx +66 -0
  215. package/src/skills/SkillBar.stories.tsx +112 -0
  216. package/src/skills/SkillCategory.jsx +71 -0
  217. package/src/skills/SkillCategory.stories.tsx +197 -0
  218. package/src/skills/SkillCloud.jsx +53 -0
  219. package/src/skills/SkillCloud.stories.tsx +132 -0
  220. package/src/skills/SkillGroup.jsx +56 -0
  221. package/src/skills/SkillGroup.stories.tsx +162 -0
  222. package/src/skills/SkillPill.jsx +56 -0
  223. package/src/skills/SkillPill.stories.tsx +157 -0
  224. package/src/skills/SkillRating.jsx +60 -0
  225. package/src/skills/SkillRating.stories.tsx +115 -0
  226. package/src/skills/index.jsx +11 -0
  227. package/src/styles/tokens.css +139 -0
  228. package/src/tables/ComparisonTable.jsx +128 -0
  229. package/src/tables/ComparisonTable.stories.tsx +41 -0
  230. package/src/tables/DataTable.jsx +149 -0
  231. package/src/tables/DataTable.stories.tsx +64 -0
  232. package/src/tables/SkillMatrix.jsx +139 -0
  233. package/src/tables/SkillMatrix.stories.tsx +90 -0
  234. package/src/tables/index.jsx +4 -0
  235. package/src/tags/ToolTagRibbon.jsx +106 -0
  236. package/src/tags/ToolTagRibbon.stories.tsx +121 -0
  237. package/src/tags/index.jsx +5 -0
  238. package/src/timeline/TimelineInline.stories.tsx +83 -0
  239. package/src/timeline/TimelineInline.tsx +202 -0
  240. package/src/timeline/TimelineItem.jsx +106 -0
  241. package/src/timeline/TimelineItem.stories.tsx +64 -0
  242. package/src/timeline/TimelineRuleMinimal.stories.tsx +68 -0
  243. package/src/timeline/TimelineRuleMinimal.tsx +165 -0
  244. package/src/timeline/TimelineSection.jsx +21 -0
  245. package/src/timeline/TimelineSection.stories.tsx +44 -0
  246. package/src/timeline/index.jsx +9 -0
  247. package/src/tokens/index.js +164 -0
  248. package/src/typography/Heading.jsx +48 -0
  249. package/src/typography/Heading.stories.tsx +46 -0
  250. package/src/typography/HyphenationSafeParagraph.jsx +98 -0
  251. package/src/typography/HyphenationSafeParagraph.stories.tsx +151 -0
  252. package/src/typography/Label.jsx +38 -0
  253. package/src/typography/Label.stories.tsx +27 -0
  254. package/src/typography/QuoteStripe.jsx +78 -0
  255. package/src/typography/QuoteStripe.stories.tsx +63 -0
  256. package/src/typography/SectionIntroParagraph.jsx +62 -0
  257. package/src/typography/SectionIntroParagraph.stories.tsx +57 -0
  258. package/src/typography/Text.jsx +42 -0
  259. package/src/typography/Text.stories.tsx +35 -0
  260. package/src/typography/index.jsx +11 -0
  261. package/src/utils/Divider.jsx +32 -0
  262. package/src/utils/Divider.stories.tsx +24 -0
  263. package/src/utils/Flex.jsx +6 -0
  264. package/src/utils/Flex.stories.tsx +28 -0
  265. package/src/utils/Grid.jsx +6 -0
  266. package/src/utils/Grid.stories.tsx +28 -0
  267. package/src/utils/Spacer.jsx +18 -0
  268. package/src/utils/Spacer.stories.tsx +26 -0
  269. package/src/utils/index.jsx +9 -0
  270. package/src/utils/security.js +155 -0
  271. package/src/visuals/BackgroundPattern.jsx +65 -0
  272. package/src/visuals/BackgroundPattern.stories.tsx +27 -0
  273. package/src/visuals/BorderAccent.jsx +147 -0
  274. package/src/visuals/BorderAccent.stories.tsx +27 -0
  275. package/src/visuals/ColorBlock.jsx +60 -0
  276. package/src/visuals/ColorBlock.stories.tsx +27 -0
  277. package/src/visuals/DividerVariants.jsx +120 -0
  278. package/src/visuals/DividerVariants.stories.tsx +27 -0
  279. package/src/visuals/index.jsx +5 -0
@@ -0,0 +1,68 @@
1
+ import React from 'react';
2
+ import { TimelineRuleMinimal } from './TimelineRuleMinimal';
3
+
4
+ export default {
5
+ title: 'Timeline/TimelineRuleMinimal',
6
+ component: TimelineRuleMinimal,
7
+ tags: ['autodocs'],
8
+ };
9
+
10
+ const sampleItems = [
11
+ {
12
+ date: 'Jan 2020',
13
+ label: 'Software Engineer',
14
+ meta: 'Tech Corp',
15
+ },
16
+ {
17
+ date: 'Mar 2022',
18
+ label: 'Senior Software Engineer',
19
+ meta: 'Innovation Labs',
20
+ },
21
+ {
22
+ date: 'Jun 2024',
23
+ label: 'Lead Engineer',
24
+ meta: 'Startup Inc',
25
+ },
26
+ ];
27
+
28
+ export const Default = {
29
+ args: {
30
+ items: sampleItems,
31
+ },
32
+ };
33
+
34
+ export const CustomTickHeight = {
35
+ args: {
36
+ items: sampleItems,
37
+ tickHeight: '3pt',
38
+ },
39
+ };
40
+
41
+ export const CustomColors = {
42
+ args: {
43
+ items: sampleItems,
44
+ lineColor: '#4a90e2',
45
+ tickHeight: '2.5pt',
46
+ },
47
+ };
48
+
49
+ export const MinimalLabels = {
50
+ args: {
51
+ items: [
52
+ { date: '2020', label: 'Bachelor of Science' },
53
+ { date: '2022', label: 'Master of Science' },
54
+ { date: '2024', label: 'PhD Candidate' },
55
+ ],
56
+ },
57
+ };
58
+
59
+ export const DatesOnly = {
60
+ args: {
61
+ items: [
62
+ { date: 'Q1 2020' },
63
+ { date: 'Q3 2021' },
64
+ { date: 'Q2 2023' },
65
+ { date: 'Present' },
66
+ ],
67
+ },
68
+ };
@@ -0,0 +1,165 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * TimelineRuleMinimal Component
6
+ * Simple vertical rule with tick marks for minimal timeline display
7
+ * Designed for ATS-friendly resumes with clear visual hierarchy
8
+ *
9
+ * @component
10
+ * @example
11
+ * <TimelineRuleMinimal
12
+ * items={[
13
+ * { date: '2020-01', label: 'Software Engineer' },
14
+ * { date: '2022-03', label: 'Senior Engineer' }
15
+ * ]}
16
+ * />
17
+ *
18
+ * @example
19
+ * // With custom styling
20
+ * <TimelineRuleMinimal
21
+ * items={items}
22
+ * lineColor="var(--resume-color-accent)"
23
+ * tickHeight="3pt"
24
+ * />
25
+ */
26
+
27
+ interface TimelineItem {
28
+ /** Date label displayed next to tick mark */
29
+ date: string;
30
+ /** Optional content/title for this timeline entry */
31
+ label?: string;
32
+ /** Optional additional metadata */
33
+ meta?: string;
34
+ }
35
+
36
+ interface TimelineRuleMinimalProps {
37
+ /** Array of timeline items to display */
38
+ items: TimelineItem[];
39
+ /** Color of the vertical rule (default: --resume-color-border) */
40
+ lineColor?: string;
41
+ /** Height of tick marks (minimum 2pt, default: 2pt) */
42
+ tickHeight?: string;
43
+ /** Width of tick marks (default: 8px) */
44
+ tickWidth?: string;
45
+ /** Additional CSS class name */
46
+ className?: string;
47
+ }
48
+
49
+ const Container = styled.div`
50
+ position: relative;
51
+ display: flex;
52
+ flex-direction: column;
53
+ gap: var(--resume-space-item, 12pt);
54
+
55
+ @media print {
56
+ break-inside: avoid;
57
+ }
58
+ `;
59
+
60
+ const Rule = styled.div<{ $lineColor?: string }>`
61
+ position: absolute;
62
+ left: 0;
63
+ top: 0;
64
+ bottom: 0;
65
+ width: 1px;
66
+ background-color: ${(props) =>
67
+ props.$lineColor || 'var(--resume-color-border, #ddd)'};
68
+
69
+ @media print {
70
+ -webkit-print-color-adjust: exact;
71
+ print-color-adjust: exact;
72
+ }
73
+ `;
74
+
75
+ const Item = styled.div`
76
+ position: relative;
77
+ display: flex;
78
+ align-items: baseline;
79
+ gap: 12px;
80
+ padding-left: 20px;
81
+ `;
82
+
83
+ const Tick = styled.div<{ $height?: string; $width?: string; $color?: string }>`
84
+ position: absolute;
85
+ left: 0;
86
+ top: 50%;
87
+ transform: translateY(-50%);
88
+ width: ${(props) => props.$width || '8px'};
89
+ height: ${(props) => {
90
+ const height = props.$height || '2pt';
91
+ // Ensure minimum 2pt height
92
+ const value = parseFloat(height);
93
+ const unit = height.replace(/[\d.]/g, '');
94
+ return value < 2 && unit === 'pt' ? '2pt' : height;
95
+ }};
96
+ background-color: ${(props) =>
97
+ props.$color || 'var(--resume-color-border, #ddd)'};
98
+
99
+ @media print {
100
+ -webkit-print-color-adjust: exact;
101
+ print-color-adjust: exact;
102
+ min-height: 2pt; /* Ensure visibility in print */
103
+ }
104
+ `;
105
+
106
+ const Date = styled.span`
107
+ font-size: var(--resume-size-small, 10pt);
108
+ color: var(--resume-color-secondary, #666);
109
+ font-weight: var(--resume-weight-normal, 400);
110
+ white-space: nowrap;
111
+ flex-shrink: 0;
112
+ `;
113
+
114
+ const Content = styled.div`
115
+ display: flex;
116
+ flex-direction: column;
117
+ gap: 2px;
118
+ flex: 1;
119
+ `;
120
+
121
+ const Label = styled.span`
122
+ font-size: var(--resume-size-body, 11pt);
123
+ color: var(--resume-color-primary, #000);
124
+ font-weight: var(--resume-weight-medium, 500);
125
+ `;
126
+
127
+ const Meta = styled.span`
128
+ font-size: var(--resume-size-small, 10pt);
129
+ color: var(--resume-color-tertiary, #999);
130
+ `;
131
+
132
+ /**
133
+ * TimelineRuleMinimal
134
+ * Displays a vertical timeline with tick marks and minimal styling
135
+ * Perfect for chronological work history or education sections
136
+ */
137
+ export function TimelineRuleMinimal({
138
+ items,
139
+ lineColor,
140
+ tickHeight = '2pt',
141
+ tickWidth = '8px',
142
+ className,
143
+ }: TimelineRuleMinimalProps) {
144
+ if (!items || items.length === 0) return null;
145
+
146
+ return (
147
+ <Container
148
+ className={`resume-timeline-rule-minimal ${className || ''}`.trim()}
149
+ >
150
+ <Rule $lineColor={lineColor} />
151
+ {items.map((item, index) => (
152
+ <Item key={index}>
153
+ <Tick $height={tickHeight} $width={tickWidth} $color={lineColor} />
154
+ <Date>{item.date}</Date>
155
+ <Content>
156
+ {item.label && <Label>{item.label}</Label>}
157
+ {item.meta && <Meta>{item.meta}</Meta>}
158
+ </Content>
159
+ </Item>
160
+ ))}
161
+ </Container>
162
+ );
163
+ }
164
+
165
+ export default TimelineRuleMinimal;
@@ -0,0 +1,21 @@
1
+ import React from 'react';
2
+ /**
3
+ * TimelineSection
4
+ * Container for timeline items
5
+ */
6
+ import styled from 'styled-components';
7
+
8
+ const Container = styled.div`
9
+ position: relative;
10
+ margin-bottom: var(--resume-space-section);
11
+
12
+ @media print {
13
+ page-break-inside: avoid;
14
+ }
15
+ `;
16
+
17
+ export function TimelineSection({ children, className }) {
18
+ return <Container className={className}>{children}</Container>;
19
+ }
20
+
21
+ export default TimelineSection;
@@ -0,0 +1,44 @@
1
+ import React from 'react';
2
+ /**
3
+ * TimelineSection Stories
4
+ */
5
+ import { TimelineSection } from './TimelineSection';
6
+ import { TimelineItem } from './TimelineItem';
7
+
8
+ const meta = {
9
+ title: 'Resume Core/Timeline/TimelineSection',
10
+ component: TimelineSection,
11
+ parameters: { layout: 'padded' },
12
+ tags: ['autodocs'],
13
+ };
14
+
15
+ export default meta;
16
+
17
+ export const WorkHistory = {
18
+ render: () => (
19
+ <TimelineSection>
20
+ <TimelineItem title="Senior Software Engineer" meta="2020-Present">
21
+ Leading development of cloud-native applications at Tech Corp
22
+ </TimelineItem>
23
+ <TimelineItem title="Software Engineer" meta="2018-2020">
24
+ Full-stack development at StartupCo
25
+ </TimelineItem>
26
+ <TimelineItem title="Junior Developer" meta="2016-2018">
27
+ Front-end development at WebAgency
28
+ </TimelineItem>
29
+ </TimelineSection>
30
+ ),
31
+ };
32
+
33
+ export const Education = {
34
+ render: () => (
35
+ <TimelineSection>
36
+ <TimelineItem title="MS Computer Science" meta="2018">
37
+ Stanford University - Focus: AI/ML
38
+ </TimelineItem>
39
+ <TimelineItem title="BS Computer Engineering" meta="2016">
40
+ MIT - Summa Cum Laude
41
+ </TimelineItem>
42
+ </TimelineSection>
43
+ ),
44
+ };
@@ -0,0 +1,9 @@
1
+ import React from 'react';
2
+ /**
3
+ * Timeline Components
4
+ * Export all timeline components
5
+ */
6
+ export { TimelineSection } from './TimelineSection.jsx';
7
+ export { TimelineItem } from './TimelineItem.jsx';
8
+ export { TimelineRuleMinimal } from './TimelineRuleMinimal.tsx';
9
+ export { TimelineInline } from './TimelineInline.tsx';
@@ -0,0 +1,164 @@
1
+ /**
2
+ * Design Tokens
3
+ * Framework-agnostic design tokens exported as both CSS variables and JS objects
4
+ */
5
+
6
+ /**
7
+ * Typography tokens
8
+ */
9
+ export const typography = {
10
+ fonts: {
11
+ sans: 'var(--resume-font-sans)',
12
+ serif: 'var(--resume-font-serif)',
13
+ mono: 'var(--resume-font-mono)',
14
+ },
15
+ sizes: {
16
+ name: 'var(--resume-size-name)',
17
+ heading: 'var(--resume-size-heading)',
18
+ subheading: 'var(--resume-size-subheading)',
19
+ body: 'var(--resume-size-body)',
20
+ small: 'var(--resume-size-small)',
21
+ },
22
+ weights: {
23
+ normal: 'var(--resume-weight-normal)',
24
+ medium: 'var(--resume-weight-medium)',
25
+ semibold: 'var(--resume-weight-semibold)',
26
+ bold: 'var(--resume-weight-bold)',
27
+ },
28
+ lineHeights: {
29
+ tight: 'var(--resume-line-height-tight)',
30
+ normal: 'var(--resume-line-height-normal)',
31
+ relaxed: 'var(--resume-line-height-relaxed)',
32
+ },
33
+ };
34
+
35
+ /**
36
+ * Color tokens
37
+ */
38
+ export const colors = {
39
+ primary: 'var(--resume-color-primary)',
40
+ secondary: 'var(--resume-color-secondary)',
41
+ accent: 'var(--resume-color-accent)',
42
+ background: 'var(--resume-color-background)',
43
+ border: 'var(--resume-color-border)',
44
+ };
45
+
46
+ /**
47
+ * Spacing tokens
48
+ */
49
+ export const spacing = {
50
+ section: 'var(--resume-space-section)',
51
+ item: 'var(--resume-space-item)',
52
+ tight: 'var(--resume-space-tight)',
53
+ margin: 'var(--resume-space-margin)',
54
+ };
55
+
56
+ /**
57
+ * Layout tokens
58
+ */
59
+ export const layout = {
60
+ maxWidth: 'var(--resume-max-width)',
61
+ columnGap: 'var(--resume-column-gap)',
62
+ };
63
+
64
+ /**
65
+ * Border radius tokens
66
+ */
67
+ export const radius = {
68
+ sm: 'var(--resume-radius-sm)',
69
+ md: 'var(--resume-radius-md)',
70
+ lg: 'var(--resume-radius-lg)',
71
+ };
72
+
73
+ /**
74
+ * Shadow tokens
75
+ */
76
+ export const shadows = {
77
+ sm: 'var(--resume-shadow-sm)',
78
+ md: 'var(--resume-shadow-md)',
79
+ };
80
+
81
+ /**
82
+ * Combined tokens object
83
+ */
84
+ export const tokens = {
85
+ typography,
86
+ colors,
87
+ spacing,
88
+ layout,
89
+ radius,
90
+ shadows,
91
+ };
92
+
93
+ /**
94
+ * Raw token values (for non-CSS use cases like PDF generation)
95
+ */
96
+ export const rawTokens = {
97
+ typography: {
98
+ fonts: {
99
+ sans: '"Helvetica Neue", Helvetica, Arial, sans-serif',
100
+ serif: 'Cambria, Georgia, "Times New Roman", serif',
101
+ mono: '"Courier New", Courier, monospace',
102
+ },
103
+ sizes: {
104
+ name: '36px',
105
+ heading: '16px',
106
+ subheading: '14px',
107
+ body: '11px',
108
+ small: '10px',
109
+ },
110
+ weights: {
111
+ normal: 400,
112
+ medium: 500,
113
+ semibold: 600,
114
+ bold: 700,
115
+ },
116
+ lineHeights: {
117
+ tight: 1.2,
118
+ normal: 1.5,
119
+ relaxed: 1.75,
120
+ },
121
+ },
122
+ colors: {
123
+ professional: {
124
+ primary: '#1a1a1a',
125
+ secondary: '#4a4a4a',
126
+ accent: '#2563eb',
127
+ background: '#ffffff',
128
+ border: '#e5e7eb',
129
+ },
130
+ modern: {
131
+ primary: '#0f172a',
132
+ secondary: '#475569',
133
+ accent: '#8b5cf6',
134
+ background: '#ffffff',
135
+ border: '#e5e7eb',
136
+ },
137
+ classic: {
138
+ primary: '#000000',
139
+ secondary: '#333333',
140
+ accent: '#0066cc',
141
+ background: '#ffffff',
142
+ border: '#cccccc',
143
+ },
144
+ minimal: {
145
+ primary: '#18181b',
146
+ secondary: '#71717a',
147
+ accent: '#000000',
148
+ background: '#ffffff',
149
+ border: '#e4e4e7',
150
+ },
151
+ },
152
+ spacing: {
153
+ section: '24px',
154
+ item: '16px',
155
+ tight: '8px',
156
+ margin: '48px',
157
+ },
158
+ layout: {
159
+ maxWidth: '660px',
160
+ columnGap: '24px',
161
+ },
162
+ };
163
+
164
+ export default tokens;
@@ -0,0 +1,48 @@
1
+ import React from 'react';
2
+ /**
3
+ * Heading
4
+ * Semantic heading component
5
+ */
6
+ import styled from 'styled-components';
7
+
8
+ const StyledHeading = styled.h1`
9
+ font-size: ${(props) => {
10
+ const sizes = {
11
+ 1: 'var(--resume-size-name)',
12
+ 2: 'var(--resume-size-heading)',
13
+ 3: 'var(--resume-size-subheading)',
14
+ 4: 'var(--resume-size-body)',
15
+ };
16
+ return sizes[props.$level] || sizes[2];
17
+ }};
18
+ font-weight: ${(props) => props.$weight || 'var(--resume-weight-semibold)'};
19
+ color: ${(props) => props.$color || 'var(--resume-color-primary)'};
20
+ margin: 0 0 ${(props) => props.$spacing || 'var(--resume-space-tight)'} 0;
21
+ line-height: var(--resume-line-height-tight);
22
+ `;
23
+
24
+ export function Heading({
25
+ level = 2,
26
+ weight,
27
+ color,
28
+ spacing,
29
+ children,
30
+ className,
31
+ as,
32
+ }) {
33
+ const Component = as || `h${level}`;
34
+ return (
35
+ <StyledHeading
36
+ as={Component}
37
+ $level={level}
38
+ $weight={weight}
39
+ $color={color}
40
+ $spacing={spacing}
41
+ className={className}
42
+ >
43
+ {children}
44
+ </StyledHeading>
45
+ );
46
+ }
47
+
48
+ export default Heading;
@@ -0,0 +1,46 @@
1
+ import React from 'react';
2
+ /**
3
+ * Heading Stories
4
+ */
5
+ import { Heading } from './Heading';
6
+
7
+ const meta = {
8
+ title: 'Resume Core/Typography/Heading',
9
+ component: Heading,
10
+ parameters: { layout: 'padded' },
11
+ tags: ['autodocs'],
12
+ argTypes: {
13
+ level: { control: { type: 'range', min: 1, max: 4, step: 1 } },
14
+ weight: { control: 'text' },
15
+ color: { control: 'color' },
16
+ },
17
+ };
18
+
19
+ export default meta;
20
+
21
+ export const Level1: Story = {
22
+ args: { level: 1, children: 'John Doe - Level 1 Heading' },
23
+ };
24
+ export const Level2: Story = {
25
+ args: { level: 2, children: 'Work Experience - Level 2 Heading' },
26
+ };
27
+ export const Level3: Story = {
28
+ args: { level: 3, children: 'Senior Software Engineer - Level 3' },
29
+ };
30
+ export const Level4: Story = {
31
+ args: { level: 4, children: 'Additional Details - Level 4' },
32
+ };
33
+ export const CustomColor: Story = {
34
+ args: { level: 2, color: '#007bff', children: 'Colored Heading' },
35
+ };
36
+
37
+ export const AllLevels = {
38
+ render: () => (
39
+ <div>
40
+ <Heading level={1}>Level 1: John Doe</Heading>
41
+ <Heading level={2}>Level 2: Work Experience</Heading>
42
+ <Heading level={3}>Level 3: Senior Software Engineer</Heading>
43
+ <Heading level={4}>Level 4: Project Details</Heading>
44
+ </div>
45
+ ),
46
+ };
@@ -0,0 +1,98 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * HyphenationSafeParagraph
6
+ * Paragraph component with balanced hyphenation for improved text flow.
7
+ * Sets appropriate language attributes for quality hyphenation algorithms.
8
+ *
9
+ * @param {Object} props - Component props
10
+ * @param {React.ReactNode} props.children - Content to render
11
+ * @param {string} [props.className] - Additional CSS classes
12
+ * @param {string} [props.as='p'] - HTML element to render as
13
+ * @param {string} [props.lang='en'] - Language code for hyphenation (en, es, fr, de, etc.)
14
+ * @param {string} [props.color] - Text color override
15
+ * @param {string} [props.textAlign='left'] - Text alignment
16
+ * @param {number} [props.maxLines] - Maximum number of lines before truncation
17
+ *
18
+ * @example
19
+ * ```jsx
20
+ * <HyphenationSafeParagraph>
21
+ * Implemented comprehensive internationalization framework...
22
+ * </HyphenationSafeParagraph>
23
+ *
24
+ * <HyphenationSafeParagraph lang="fr">
25
+ * Développement d'applications web modernes avec React...
26
+ * </HyphenationSafeParagraph>
27
+ *
28
+ * <HyphenationSafeParagraph maxLines={3}>
29
+ * Long description text that will be truncated after 3 lines...
30
+ * </HyphenationSafeParagraph>
31
+ * ```
32
+ */
33
+
34
+ const StyledHyphenatedParagraph = styled.p`
35
+ font-size: var(--resume-size-body);
36
+ font-weight: var(--resume-weight-normal);
37
+ color: ${(props) => props.$color || 'var(--resume-color-secondary)'};
38
+ line-height: var(--resume-line-height-normal);
39
+ text-align: ${(props) => props.$textAlign || 'left'};
40
+ margin: 0 0 var(--resume-space-tight) 0;
41
+
42
+ /* Enable hyphenation for better text flow */
43
+ hyphens: auto;
44
+ -webkit-hyphens: auto;
45
+ -moz-hyphens: auto;
46
+ -ms-hyphens: auto;
47
+
48
+ /* Prevent orphans and widows */
49
+ orphans: 2;
50
+ widows: 2;
51
+
52
+ /* Balanced text wrapping */
53
+ text-wrap: balance;
54
+
55
+ /* Optional line clamping */
56
+ ${(props) =>
57
+ props.$maxLines &&
58
+ `
59
+ display: -webkit-box;
60
+ -webkit-line-clamp: ${props.$maxLines};
61
+ -webkit-box-orient: vertical;
62
+ overflow: hidden;
63
+ text-overflow: ellipsis;
64
+ `}
65
+
66
+ /* Print optimization - disable hyphenation for cleaner output */
67
+ @media print {
68
+ hyphens: none;
69
+ -webkit-hyphens: none;
70
+ page-break-inside: avoid;
71
+ text-wrap: pretty;
72
+ }
73
+ `;
74
+
75
+ export function HyphenationSafeParagraph({
76
+ children,
77
+ className,
78
+ as = 'p',
79
+ lang = 'en',
80
+ color,
81
+ textAlign,
82
+ maxLines,
83
+ }) {
84
+ return (
85
+ <StyledHyphenatedParagraph
86
+ as={as}
87
+ lang={lang}
88
+ $color={color}
89
+ $textAlign={textAlign}
90
+ $maxLines={maxLines}
91
+ className={className}
92
+ >
93
+ {children}
94
+ </StyledHyphenatedParagraph>
95
+ );
96
+ }
97
+
98
+ export default HyphenationSafeParagraph;