@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,92 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * SubsectionLabel Component
6
+ * Small inline label positioned above content blocks.
7
+ * Uses tracked uppercase for visual hierarchy without excessive weight.
8
+ *
9
+ * @component
10
+ * @example
11
+ * <SubsectionLabel>Key Achievements</SubsectionLabel>
12
+ * <SubsectionLabel variant="caps">Technical Skills</SubsectionLabel>
13
+ *
14
+ * @param {React.ReactNode} children - The label text
15
+ * @param {string} [variant='tracked'] - Style variant: 'tracked' (uppercase with spacing) or 'caps' (small caps)
16
+ * @param {string} [className] - Additional CSS classes
17
+ * @param {React.ElementType} [as='div'] - HTML element to render as
18
+ */
19
+
20
+ const StyledLabel = styled.div`
21
+ display: block;
22
+ font-size: ${(props) =>
23
+ props.theme?.typography?.sizes?.small || 'var(--resume-size-small, 10px)'};
24
+ font-weight: ${(props) =>
25
+ props.theme?.typography?.weights?.semibold ||
26
+ 'var(--resume-weight-semibold, 600)'};
27
+ color: ${(props) =>
28
+ props.theme?.colors?.secondary || 'var(--resume-color-secondary, #4a4a4a)'};
29
+ margin-bottom: 6px;
30
+ line-height: 1.4;
31
+
32
+ /* Tracked uppercase variant */
33
+ ${(props) =>
34
+ props.$variant === 'tracked' &&
35
+ `
36
+ text-transform: uppercase;
37
+ letter-spacing: 0.1em;
38
+ font-variant: normal;
39
+ `}
40
+
41
+ /* Small caps variant */
42
+ ${(props) =>
43
+ props.$variant === 'caps' &&
44
+ `
45
+ font-variant: small-caps;
46
+ letter-spacing: 0.05em;
47
+ text-transform: lowercase;
48
+ `}
49
+
50
+ @media print {
51
+ font-size: 9pt;
52
+ color: #4a4a4a;
53
+ margin-bottom: 4px;
54
+
55
+ ${(props) =>
56
+ props.$variant === 'tracked' &&
57
+ `
58
+ text-transform: uppercase;
59
+ letter-spacing: 0.1em;
60
+ `}
61
+
62
+ ${(props) =>
63
+ props.$variant === 'caps' &&
64
+ `
65
+ font-variant: small-caps;
66
+ letter-spacing: 0.05em;
67
+ `}
68
+ }
69
+ `;
70
+
71
+ export function SubsectionLabel({
72
+ children,
73
+ variant = 'tracked',
74
+ className,
75
+ as = 'div',
76
+ ...rest
77
+ }) {
78
+ return (
79
+ <StyledLabel
80
+ as={as}
81
+ $variant={variant}
82
+ className={`resume-subsection-label resume-subsection-label-${variant} ${
83
+ className || ''
84
+ }`.trim()}
85
+ {...rest}
86
+ >
87
+ {children}
88
+ </StyledLabel>
89
+ );
90
+ }
91
+
92
+ export default SubsectionLabel;
@@ -0,0 +1,40 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { SubsectionLabel } from './SubsectionLabel.jsx';
3
+
4
+ const meta: Meta<typeof SubsectionLabel> = {
5
+ title: 'Metadata/SubsectionLabel',
6
+ component: SubsectionLabel,
7
+ tags: ['autodocs'],
8
+ argTypes: {
9
+ variant: {
10
+ control: 'select',
11
+ options: ['tracked', 'caps'],
12
+ },
13
+ as: { control: 'text' },
14
+ },
15
+ };
16
+
17
+ export default meta;
18
+ type Story = StoryObj<typeof SubsectionLabel>;
19
+
20
+ export const Tracked: Story = {
21
+ args: {
22
+ children: 'Key Achievements',
23
+ variant: 'tracked',
24
+ },
25
+ };
26
+
27
+ export const SmallCaps: Story = {
28
+ args: {
29
+ children: 'Technical Skills',
30
+ variant: 'caps',
31
+ },
32
+ };
33
+
34
+ export const AsSpan: Story = {
35
+ args: {
36
+ children: 'Responsibilities',
37
+ variant: 'tracked',
38
+ as: 'span',
39
+ },
40
+ };
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Metadata Components
3
+ * Small labels, metadata rows, and caption components for resume sections
4
+ */
5
+
6
+ export { InlineKicker } from './InlineKicker.jsx';
7
+ export { MetaRow } from './MetaRow.jsx';
8
+ export { SubsectionLabel } from './SubsectionLabel.jsx';
9
+ export { GreyLabelCaps } from './GreyLabelCaps.jsx';
10
+ export { SmallCapsHeading } from './SmallCapsHeading.jsx';
@@ -0,0 +1,65 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { AccentSidebarStripe } from './AccentSidebarStripe';
3
+
4
+ const meta = {
5
+ title: 'Primitives/Dividers/AccentSidebarStripe',
6
+ component: AccentSidebarStripe,
7
+ parameters: {
8
+ layout: 'fullscreen',
9
+ },
10
+ tags: ['autodocs'],
11
+ } satisfies Meta<typeof AccentSidebarStripe>;
12
+
13
+ export default meta;
14
+ type Story = StoryObj<typeof meta>;
15
+
16
+ export const Default: Story = {
17
+ render: () => (
18
+ <div style={{ position: 'relative', minHeight: '300px', padding: '2rem' }}>
19
+ <AccentSidebarStripe />
20
+ <h2>Section Title</h2>
21
+ <p>Content with left accent stripe</p>
22
+ </div>
23
+ ),
24
+ };
25
+
26
+ export const RightAligned: Story = {
27
+ render: () => (
28
+ <div style={{ position: 'relative', minHeight: '300px', padding: '2rem' }}>
29
+ <AccentSidebarStripe position="right" />
30
+ <h2>Section Title</h2>
31
+ <p>Content with right accent stripe</p>
32
+ </div>
33
+ ),
34
+ };
35
+
36
+ export const CustomWidth: Story = {
37
+ render: () => (
38
+ <div style={{ position: 'relative', minHeight: '300px', padding: '2rem' }}>
39
+ <AccentSidebarStripe width="6mm" />
40
+ <h2>Section Title</h2>
41
+ <p>Content with wider accent stripe (6mm)</p>
42
+ </div>
43
+ ),
44
+ };
45
+
46
+ export const CustomColor: Story = {
47
+ render: () => (
48
+ <div style={{ position: 'relative', minHeight: '300px', padding: '2rem' }}>
49
+ <AccentSidebarStripe color="#8b5cf6" />
50
+ <h2>Section Title</h2>
51
+ <p>Content with purple accent stripe</p>
52
+ </div>
53
+ ),
54
+ };
55
+
56
+ export const PartialHeight: Story = {
57
+ render: () => (
58
+ <div style={{ position: 'relative', minHeight: '300px', padding: '2rem' }}>
59
+ <AccentSidebarStripe height="150px" top="1rem" />
60
+ <h2>Section Title</h2>
61
+ <p>Content with partial-height accent stripe</p>
62
+ <p>The stripe doesn't extend the full height</p>
63
+ </div>
64
+ ),
65
+ };
@@ -0,0 +1,95 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * AccentSidebarStripe Component
6
+ * Narrow decorative accent stripe along the far left edge
7
+ * Positioned absolutely to avoid interfering with ATS parsing
8
+ *
9
+ * Design constraints:
10
+ * - Maximum width: 6mm (≈22.68px) to stay within safe margins
11
+ * - No text content allowed (decorative only)
12
+ * - Absolute positioning to avoid layout disruption
13
+ * - ATS-safe: parsers ignore positioned elements
14
+ *
15
+ * @component
16
+ * @example
17
+ * // Minimal accent stripe
18
+ * <AccentSidebarStripe />
19
+ *
20
+ * @example
21
+ * // Custom width and color
22
+ * <AccentSidebarStripe width="4mm" color="#2563eb" />
23
+ *
24
+ * @example
25
+ * // Right-aligned stripe
26
+ * <AccentSidebarStripe position="right" />
27
+ */
28
+
29
+ interface AccentSidebarStripeProps {
30
+ /** Stripe width (max 6mm, defaults to 4mm) */
31
+ width?: string;
32
+ /** Stripe color (defaults to theme accent color) */
33
+ color?: string;
34
+ /** Position: left or right edge (defaults to left) */
35
+ position?: 'left' | 'right';
36
+ /** Height (defaults to 100%) */
37
+ height?: string;
38
+ /** Top offset (defaults to 0) */
39
+ top?: string;
40
+ /** Additional CSS class name */
41
+ className?: string;
42
+ }
43
+
44
+ const StyledStripe = styled.div<AccentSidebarStripeProps>`
45
+ position: absolute;
46
+ ${(props) => (props.position === 'right' ? 'right: 0;' : 'left: 0;')}
47
+ top: ${(props) => props.top || '0'};
48
+ width: ${(props) => props.width || '4mm'};
49
+ max-width: 6mm; /* ATS-safe maximum */
50
+ height: ${(props) => props.height || '100%'};
51
+ background-color: ${(props) =>
52
+ props.color ||
53
+ props.theme?.colors?.accent ||
54
+ 'var(--resume-color-accent, #2563eb)'};
55
+ pointer-events: none; /* Prevent interaction */
56
+
57
+ @media print {
58
+ /* Ensure color renders in print */
59
+ -webkit-print-color-adjust: exact;
60
+ print-color-adjust: exact;
61
+ /* Prevent page breaks inside stripe */
62
+ page-break-inside: avoid;
63
+ }
64
+
65
+ @media screen and (max-width: 768px) {
66
+ /* Reduce width on mobile */
67
+ width: ${(props) => (props.width ? `calc(${props.width} * 0.75)` : '3mm')};
68
+ }
69
+ `;
70
+
71
+ export function AccentSidebarStripe({
72
+ width,
73
+ color,
74
+ position = 'left',
75
+ height,
76
+ top,
77
+ className,
78
+ ...rest
79
+ }: AccentSidebarStripeProps) {
80
+ return (
81
+ <StyledStripe
82
+ role="presentation"
83
+ aria-hidden="true"
84
+ width={width}
85
+ color={color}
86
+ position={position}
87
+ height={height}
88
+ top={top}
89
+ className={`resume-accent-stripe ${className || ''}`.trim()}
90
+ {...rest}
91
+ />
92
+ );
93
+ }
94
+
95
+ export default AccentSidebarStripe;
@@ -0,0 +1,102 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { AccentTopRule } from './AccentTopRule';
3
+
4
+ const meta = {
5
+ title: 'Primitives/Dividers/AccentTopRule',
6
+ component: AccentTopRule,
7
+ parameters: {
8
+ layout: 'padded',
9
+ },
10
+ tags: ['autodocs'],
11
+ } satisfies Meta<typeof AccentTopRule>;
12
+
13
+ export default meta;
14
+ type Story = StoryObj<typeof meta>;
15
+
16
+ export const Default: Story = {
17
+ render: () => (
18
+ <div style={{ maxWidth: '600px' }}>
19
+ <AccentTopRule />
20
+ <h2>Work Experience</h2>
21
+ <p>Section content below the accent rule</p>
22
+ </div>
23
+ ),
24
+ };
25
+
26
+ export const Centered: Story = {
27
+ render: () => (
28
+ <div style={{ maxWidth: '600px' }}>
29
+ <AccentTopRule align="center" />
30
+ <h2 style={{ textAlign: 'center' }}>Work Experience</h2>
31
+ <p style={{ textAlign: 'center' }}>
32
+ Section content below the centered accent rule
33
+ </p>
34
+ </div>
35
+ ),
36
+ };
37
+
38
+ export const RightAligned: Story = {
39
+ render: () => (
40
+ <div style={{ maxWidth: '600px' }}>
41
+ <AccentTopRule align="right" />
42
+ <h2 style={{ textAlign: 'right' }}>Work Experience</h2>
43
+ <p style={{ textAlign: 'right' }}>
44
+ Section content below the right-aligned accent rule
45
+ </p>
46
+ </div>
47
+ ),
48
+ };
49
+
50
+ export const CustomWidth: Story = {
51
+ render: () => (
52
+ <div style={{ maxWidth: '600px' }}>
53
+ <AccentTopRule width="40%" />
54
+ <h2>Work Experience</h2>
55
+ <p>Section with wider accent rule (40%)</p>
56
+ </div>
57
+ ),
58
+ };
59
+
60
+ export const CustomColor: Story = {
61
+ render: () => (
62
+ <div style={{ maxWidth: '600px' }}>
63
+ <AccentTopRule color="#8b5cf6" />
64
+ <h2>Work Experience</h2>
65
+ <p>Section with purple accent rule</p>
66
+ </div>
67
+ ),
68
+ };
69
+
70
+ export const Thicker: Story = {
71
+ render: () => (
72
+ <div style={{ maxWidth: '600px' }}>
73
+ <AccentTopRule thickness="4pt" />
74
+ <h2>Work Experience</h2>
75
+ <p>Section with thicker accent rule (4pt)</p>
76
+ </div>
77
+ ),
78
+ };
79
+
80
+ export const AllVariants: Story = {
81
+ render: () => (
82
+ <div style={{ maxWidth: '600px' }}>
83
+ <AccentTopRule />
84
+ <h3>Left aligned (default)</h3>
85
+
86
+ <div style={{ marginTop: '2rem' }}>
87
+ <AccentTopRule align="center" />
88
+ <h3 style={{ textAlign: 'center' }}>Center aligned</h3>
89
+ </div>
90
+
91
+ <div style={{ marginTop: '2rem' }}>
92
+ <AccentTopRule align="right" />
93
+ <h3 style={{ textAlign: 'right' }}>Right aligned</h3>
94
+ </div>
95
+
96
+ <div style={{ marginTop: '2rem' }}>
97
+ <AccentTopRule width="40%" color="#8b5cf6" thickness="3pt" />
98
+ <h3>Custom (40% width, purple, 3pt thick)</h3>
99
+ </div>
100
+ </div>
101
+ ),
102
+ };
@@ -0,0 +1,103 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * AccentTopRule Component
6
+ * Short accent rule positioned above sections for visual hierarchy
7
+ * Creates visual separation and draws attention to important sections
8
+ *
9
+ * Design constraints:
10
+ * - Length: 25-40% of text width (optimal visual balance)
11
+ * - Thickness: 2-3pt for prominence without overwhelming
12
+ * - Positioned with margin-bottom for proper spacing
13
+ * - Can be aligned left, center, or right
14
+ *
15
+ * @component
16
+ * @example
17
+ * // Standard top rule above section
18
+ * <AccentTopRule />
19
+ * <h2>Work Experience</h2>
20
+ *
21
+ * @example
22
+ * // Centered rule with custom width
23
+ * <AccentTopRule width="35%" align="center" />
24
+ *
25
+ * @example
26
+ * // Custom color and thickness
27
+ * <AccentTopRule color="#8b5cf6" thickness="3pt" />
28
+ */
29
+
30
+ interface AccentTopRuleProps {
31
+ /** Rule width as percentage or CSS length (defaults to 30%) */
32
+ width?: string;
33
+ /** Alignment: left, center, or right (defaults to left) */
34
+ align?: 'left' | 'center' | 'right';
35
+ /** Rule thickness (defaults to 2.5pt) */
36
+ thickness?: string;
37
+ /** Rule color (defaults to theme accent color) */
38
+ color?: string;
39
+ /** Additional CSS class name */
40
+ className?: string;
41
+ }
42
+
43
+ const StyledRule = styled.div<AccentTopRuleProps>`
44
+ width: ${(props) => props.width || '30%'};
45
+ max-width: 40%; /* Design constraint: max 40% */
46
+ min-width: 25%; /* Design constraint: min 25% */
47
+ height: ${(props) => props.thickness || '2.5pt'};
48
+ background-color: ${(props) =>
49
+ props.color ||
50
+ props.theme?.colors?.accent ||
51
+ 'var(--resume-color-accent, #2563eb)'};
52
+ margin-bottom: ${(props) =>
53
+ props.theme?.spacing?.tight || 'var(--resume-space-tight, 0.5rem)'};
54
+ margin-left: ${(props) => {
55
+ if (props.align === 'center') return 'auto';
56
+ if (props.align === 'right') return 'auto';
57
+ return '0';
58
+ }};
59
+ margin-right: ${(props) => {
60
+ if (props.align === 'center') return 'auto';
61
+ if (props.align === 'right') return '0';
62
+ return 'auto';
63
+ }};
64
+
65
+ @media print {
66
+ /* Ensure color renders in print */
67
+ -webkit-print-color-adjust: exact;
68
+ print-color-adjust: exact;
69
+ /* Prevent page breaks */
70
+ page-break-inside: avoid;
71
+ /* Ensure minimum thickness for print visibility */
72
+ min-height: 2pt;
73
+ }
74
+
75
+ @media screen and (max-width: 768px) {
76
+ /* Increase width slightly on mobile for better visibility */
77
+ width: ${(props) => (props.width ? `calc(${props.width} * 1.2)` : '36%')};
78
+ }
79
+ `;
80
+
81
+ export function AccentTopRule({
82
+ width,
83
+ align = 'left',
84
+ thickness,
85
+ color,
86
+ className,
87
+ ...rest
88
+ }: AccentTopRuleProps) {
89
+ return (
90
+ <StyledRule
91
+ role="presentation"
92
+ aria-hidden="true"
93
+ width={width}
94
+ align={align}
95
+ thickness={thickness}
96
+ color={color}
97
+ className={`resume-accent-top-rule ${className || ''}`.trim()}
98
+ {...rest}
99
+ />
100
+ );
101
+ }
102
+
103
+ export default AccentTopRule;
@@ -0,0 +1,125 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * Badge Component
6
+ * Display skills, keywords, tags in a badge format
7
+ *
8
+ * @component
9
+ * @example
10
+ * <Badge variant="accent">JavaScript</Badge>
11
+ * <Badge size="sm">React</Badge>
12
+ */
13
+
14
+ const StyledBadge = styled.span`
15
+ display: inline-block;
16
+ padding: ${(props) => {
17
+ if (props.$size === 'sm') return '2px 8px';
18
+ if (props.$size === 'lg') return '6px 16px';
19
+ return '4px 12px'; // default md
20
+ }};
21
+ border-radius: ${(props) =>
22
+ props.theme?.radius?.sm || 'var(--resume-radius-sm, 4px)'};
23
+ font-size: ${(props) => {
24
+ if (props.$size === 'sm') return '9pt';
25
+ if (props.$size === 'lg') return '11pt';
26
+ return '10pt'; // default md
27
+ }};
28
+ font-weight: 500;
29
+ background: ${(props) => {
30
+ if (props.$variant === 'accent') {
31
+ return (
32
+ props.theme?.colors?.accentLight ||
33
+ 'var(--resume-color-accent-light, #e6f2ff)'
34
+ );
35
+ }
36
+ if (props.$variant === 'secondary') {
37
+ return props.theme?.colors?.muted || 'var(--resume-color-muted, #f5f5f5)';
38
+ }
39
+ return props.theme?.colors?.muted || 'var(--resume-color-muted, #f5f5f5)'; // default
40
+ }};
41
+ color: ${(props) => {
42
+ if (props.$variant === 'accent') {
43
+ return (
44
+ props.theme?.colors?.accent || 'var(--resume-color-accent, #0066cc)'
45
+ );
46
+ }
47
+ return props.theme?.colors?.primary || 'var(--resume-color-primary, #000)';
48
+ }};
49
+
50
+ @media print {
51
+ background: ${(props) =>
52
+ props.$variant === 'accent' ? '#e6f2ff' : '#f5f5f5'};
53
+ color: ${(props) => (props.$variant === 'accent' ? '#0066cc' : '#000')};
54
+ }
55
+ `;
56
+
57
+ export function Badge({
58
+ children,
59
+ variant = 'default',
60
+ size = 'md',
61
+ className,
62
+ ...rest
63
+ }) {
64
+ return (
65
+ <StyledBadge
66
+ $variant={variant}
67
+ $size={size}
68
+ className={`resume-badge resume-badge-${variant} ${
69
+ className || ''
70
+ }`.trim()}
71
+ {...rest}
72
+ >
73
+ {children}
74
+ </StyledBadge>
75
+ );
76
+ }
77
+
78
+ /**
79
+ * BadgeList Component
80
+ * Render multiple badges in a flex container
81
+ *
82
+ * @component
83
+ * @example
84
+ * <BadgeList items={['React', 'TypeScript', 'Node.js']} variant="accent" />
85
+ * <BadgeList>
86
+ * <Badge>React</Badge>
87
+ * <Badge variant="accent">TypeScript</Badge>
88
+ * </BadgeList>
89
+ */
90
+
91
+ const BadgeContainer = styled.div`
92
+ display: flex;
93
+ flex-wrap: wrap;
94
+ gap: 8px;
95
+ margin: 8px 0;
96
+ `;
97
+
98
+ export function BadgeList({
99
+ children,
100
+ items,
101
+ variant = 'default',
102
+ size = 'md',
103
+ className,
104
+ ...rest
105
+ }) {
106
+ // Support both children (for manual composition) and items array (for convenience)
107
+ const content = items
108
+ ? items.map((item, index) => (
109
+ <Badge key={index} variant={variant} size={size}>
110
+ {item}
111
+ </Badge>
112
+ ))
113
+ : children;
114
+
115
+ return (
116
+ <BadgeContainer
117
+ className={`resume-badge-list ${className || ''}`.trim()}
118
+ {...rest}
119
+ >
120
+ {content}
121
+ </BadgeContainer>
122
+ );
123
+ }
124
+
125
+ export default Badge;
@@ -0,0 +1,27 @@
1
+ import React from 'react';
2
+ /**
3
+ * Badge Stories
4
+ */
5
+ import { Badge } from './Badge';
6
+
7
+ const meta = {
8
+ title: 'Resume Core/Primitives/Badge',
9
+ component: Badge,
10
+ parameters: { layout: 'padded' },
11
+ tags: ['autodocs'],
12
+ };
13
+
14
+ export default meta;
15
+
16
+ export const Default = {
17
+ args: {
18
+ children: 'New',
19
+ },
20
+ };
21
+
22
+ export const Example = {
23
+ args: {
24
+ children: 'Featured',
25
+ variant: 'primary',
26
+ },
27
+ };