@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,54 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { DottedDivider } from './DottedDivider';
3
+
4
+ const meta = {
5
+ title: 'Primitives/Dividers/DottedDivider',
6
+ component: DottedDivider,
7
+ parameters: {
8
+ layout: 'padded',
9
+ },
10
+ tags: ['autodocs'],
11
+ } satisfies Meta<typeof DottedDivider>;
12
+
13
+ export default meta;
14
+ type Story = StoryObj<typeof meta>;
15
+
16
+ export const Default: Story = {
17
+ args: {},
18
+ };
19
+
20
+ export const CustomColor: Story = {
21
+ args: {
22
+ color: '#94a3b8',
23
+ },
24
+ };
25
+
26
+ export const SparseSpacing: Story = {
27
+ args: {
28
+ spacing: '8px',
29
+ },
30
+ };
31
+
32
+ export const LargerDots: Story = {
33
+ args: {
34
+ dotSize: '3px',
35
+ },
36
+ };
37
+
38
+ export const AllVariants: Story = {
39
+ render: () => (
40
+ <div style={{ maxWidth: '600px' }}>
41
+ <p>Default dotted divider</p>
42
+ <DottedDivider />
43
+
44
+ <p>Custom color (slate)</p>
45
+ <DottedDivider color="#94a3b8" />
46
+
47
+ <p>Sparse spacing (8px)</p>
48
+ <DottedDivider spacing="8px" />
49
+
50
+ <p>Larger dots (3px)</p>
51
+ <DottedDivider dotSize="3px" />
52
+ </div>
53
+ ),
54
+ };
@@ -0,0 +1,102 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * DottedDivider Component
6
+ * Dotted horizontal rule for visual rhythm and section separation
7
+ * Optimized to prevent moiré patterns in PDF generation
8
+ *
9
+ * Design constraints:
10
+ * - Fixed dot size (2px) to avoid rendering artifacts
11
+ * - Fixed spacing (4px) to prevent moiré in PDFs
12
+ * - Uses semantic <hr> for accessibility
13
+ *
14
+ * @component
15
+ * @example
16
+ * // Standard dotted divider
17
+ * <DottedDivider />
18
+ *
19
+ * @example
20
+ * // Custom color
21
+ * <DottedDivider color="#94a3b8" />
22
+ *
23
+ * @example
24
+ * // Sparse dotted divider
25
+ * <DottedDivider spacing="8px" />
26
+ */
27
+
28
+ interface DottedDividerProps {
29
+ /** Dot color (defaults to theme border color) */
30
+ color?: string;
31
+ /** Spacing between dots (defaults to 4px) */
32
+ spacing?: string;
33
+ /** Dot size (defaults to 2px) */
34
+ dotSize?: string;
35
+ /** Additional CSS class name */
36
+ className?: string;
37
+ }
38
+
39
+ const StyledHr = styled.hr<DottedDividerProps>`
40
+ border: none;
41
+ border-top: ${(props) => props.dotSize || '2px'} dotted
42
+ ${(props) =>
43
+ props.color ||
44
+ props.theme?.colors?.border ||
45
+ 'var(--resume-color-border, #e5e7eb)'};
46
+ margin-top: ${(props) =>
47
+ props.theme?.spacing?.tight || 'var(--resume-space-tight, 0.5rem)'};
48
+ margin-bottom: ${(props) =>
49
+ props.theme?.spacing?.tight || 'var(--resume-space-tight, 0.5rem)'};
50
+
51
+ /* Override default border-top-width to use fixed spacing */
52
+ ${(props) =>
53
+ props.spacing &&
54
+ `
55
+ background-image: radial-gradient(
56
+ circle,
57
+ ${
58
+ props.color ||
59
+ props.theme?.colors?.border ||
60
+ 'var(--resume-color-border, #e5e7eb)'
61
+ } ${props.dotSize || '2px'},
62
+ transparent ${props.dotSize || '2px'}
63
+ );
64
+ background-size: ${props.spacing} 1px;
65
+ background-repeat: repeat-x;
66
+ background-position: center;
67
+ border: none;
68
+ height: 1px;
69
+ `}
70
+
71
+ @media print {
72
+ /* Ensure dots render in all print modes */
73
+ -webkit-print-color-adjust: exact;
74
+ print-color-adjust: exact;
75
+ /* Prevent page breaks */
76
+ page-break-inside: avoid;
77
+ /* Fixed dot rendering for PDF generation */
78
+ border-top-width: ${(props) => props.dotSize || '2px'};
79
+ }
80
+ `;
81
+
82
+ export function DottedDivider({
83
+ color,
84
+ spacing,
85
+ dotSize,
86
+ className,
87
+ ...rest
88
+ }: DottedDividerProps) {
89
+ return (
90
+ <StyledHr
91
+ role="separator"
92
+ aria-orientation="horizontal"
93
+ color={color}
94
+ spacing={spacing}
95
+ dotSize={dotSize}
96
+ className={`resume-dotted-divider ${className || ''}`.trim()}
97
+ {...rest}
98
+ />
99
+ );
100
+ }
101
+
102
+ export default DottedDivider;
@@ -0,0 +1,64 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * InlineSeparatorPipe Component
6
+ * Vertical pipe separator for inline metadata with thin space padding.
7
+ * Prevents crowding and improves readability in compact layouts.
8
+ * Uses Unicode thin space (U+2009) for optimal spacing.
9
+ *
10
+ * @component
11
+ * @example
12
+ * <span>
13
+ * Remote
14
+ * <InlineSeparatorPipe />
15
+ * Full-time
16
+ * <InlineSeparatorPipe />
17
+ * $100k-$150k
18
+ * </span>
19
+ *
20
+ * @param {string} [color] - Custom color for the pipe
21
+ * @param {string} [className] - Additional CSS classes
22
+ * @param {React.ElementType} [as='span'] - HTML element to render as
23
+ */
24
+
25
+ const StyledPipe = styled.span`
26
+ /* Thin space (U+2009) + pipe + thin space for balanced spacing */
27
+ &::before {
28
+ content: '\u2009|\u2009';
29
+ opacity: 0.5;
30
+ color: ${(props) => props.$color || 'currentColor'};
31
+ font-weight: normal;
32
+ }
33
+
34
+ /* Ensure consistent spacing across browsers */
35
+ display: inline;
36
+ white-space: pre;
37
+
38
+ @media print {
39
+ &::before {
40
+ content: '\u2009|\u2009';
41
+ opacity: 0.6;
42
+ }
43
+ }
44
+ `;
45
+
46
+ export function InlineSeparatorPipe({
47
+ color,
48
+ className,
49
+ as = 'span',
50
+ ...rest
51
+ }) {
52
+ return (
53
+ <StyledPipe
54
+ as={as}
55
+ $color={color}
56
+ className={`resume-inline-separator-pipe ${className || ''}`.trim()}
57
+ aria-hidden="true"
58
+ role="presentation"
59
+ {...rest}
60
+ />
61
+ );
62
+ }
63
+
64
+ export default InlineSeparatorPipe;
@@ -0,0 +1,96 @@
1
+ import React from 'react';
2
+ import type { Meta, StoryObj } from '@storybook/react';
3
+ import { InlineSeparatorPipe } from './InlineSeparatorPipe';
4
+
5
+ const meta: Meta<typeof InlineSeparatorPipe> = {
6
+ title: 'Primitives/InlineSeparatorPipe',
7
+ component: InlineSeparatorPipe,
8
+ tags: ['autodocs'],
9
+ parameters: {
10
+ docs: {
11
+ description: {
12
+ component:
13
+ 'Vertical pipe separator for inline metadata with thin space padding. Uses Unicode thin space (U+2009) for optimal spacing without crowding.',
14
+ },
15
+ },
16
+ },
17
+ };
18
+
19
+ export default meta;
20
+ type Story = StoryObj<typeof InlineSeparatorPipe>;
21
+
22
+ export const Default: Story = {
23
+ render: () => (
24
+ <div>
25
+ <span>Remote</span>
26
+ <InlineSeparatorPipe />
27
+ <span>Full-time</span>
28
+ <InlineSeparatorPipe />
29
+ <span>$100k-$150k</span>
30
+ </div>
31
+ ),
32
+ };
33
+
34
+ export const LocationAndDate: Story = {
35
+ render: () => (
36
+ <div>
37
+ <span>San Francisco, CA</span>
38
+ <InlineSeparatorPipe />
39
+ <span>Jan 2020 - Present</span>
40
+ <InlineSeparatorPipe />
41
+ <span>3 years</span>
42
+ </div>
43
+ ),
44
+ };
45
+
46
+ export const JobMetadata: Story = {
47
+ render: () => (
48
+ <div style={{ fontSize: '14px', color: '#666' }}>
49
+ <span>Senior Engineer</span>
50
+ <InlineSeparatorPipe />
51
+ <span>Tech Corp</span>
52
+ <InlineSeparatorPipe />
53
+ <span>Remote</span>
54
+ </div>
55
+ ),
56
+ };
57
+
58
+ export const CustomColor: Story = {
59
+ render: () => (
60
+ <div>
61
+ <span>Item A</span>
62
+ <InlineSeparatorPipe color="#0066cc" />
63
+ <span>Item B</span>
64
+ <InlineSeparatorPipe color="#0066cc" />
65
+ <span>Item C</span>
66
+ </div>
67
+ ),
68
+ };
69
+
70
+ export const InParagraph: Story = {
71
+ render: () => (
72
+ <p style={{ maxWidth: '600px' }}>
73
+ Led a cross-functional team of 8 engineers
74
+ <InlineSeparatorPipe />
75
+ Delivered 5 major features on time
76
+ <InlineSeparatorPipe />
77
+ Increased system performance by 40%
78
+ <InlineSeparatorPipe />
79
+ Mentored 3 junior developers to senior level.
80
+ </p>
81
+ ),
82
+ };
83
+
84
+ export const CompactMetadata: Story = {
85
+ render: () => (
86
+ <div style={{ fontSize: '12px', color: '#888' }}>
87
+ <span>Published</span>
88
+ <InlineSeparatorPipe />
89
+ <span>Mar 2023</span>
90
+ <InlineSeparatorPipe />
91
+ <span>IEEE</span>
92
+ <InlineSeparatorPipe />
93
+ <span>DOI: 10.1109/example</span>
94
+ </div>
95
+ ),
96
+ };
@@ -0,0 +1,48 @@
1
+ import type { Meta, StoryObj } from '@storybook/react';
2
+ import { KeylineDivider } from './KeylineDivider';
3
+
4
+ const meta = {
5
+ title: 'Primitives/Dividers/KeylineDivider',
6
+ component: KeylineDivider,
7
+ parameters: {
8
+ layout: 'padded',
9
+ },
10
+ tags: ['autodocs'],
11
+ } satisfies Meta<typeof KeylineDivider>;
12
+
13
+ export default meta;
14
+ type Story = StoryObj<typeof meta>;
15
+
16
+ export const Default: Story = {
17
+ args: {},
18
+ };
19
+
20
+ export const WithInset: Story = {
21
+ args: {
22
+ inset: '2rem',
23
+ },
24
+ };
25
+
26
+ export const CustomColor: Story = {
27
+ args: {
28
+ color: '#94a3b8',
29
+ },
30
+ };
31
+
32
+ export const AllVariants: Story = {
33
+ render: () => (
34
+ <div style={{ maxWidth: '600px' }}>
35
+ <p>Full width keyline</p>
36
+ <KeylineDivider />
37
+
38
+ <p>With 1rem inset</p>
39
+ <KeylineDivider inset="1rem" />
40
+
41
+ <p>With 2rem inset</p>
42
+ <KeylineDivider inset="2rem" />
43
+
44
+ <p>Custom color (slate)</p>
45
+ <KeylineDivider color="#94a3b8" />
46
+ </div>
47
+ ),
48
+ };
@@ -0,0 +1,80 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * KeylineDivider Component
6
+ * Low-contrast horizontal rule with adjustable inset
7
+ * Optimized for ATS parsing and print quality
8
+ *
9
+ * Design constraints:
10
+ * - ≥0.3pt stroke weight to prevent disappearing in print
11
+ * - Supports horizontal inset for visual hierarchy
12
+ * - Uses semantic <hr> for accessibility
13
+ *
14
+ * @component
15
+ * @example
16
+ * // Full-width keyline
17
+ * <KeylineDivider />
18
+ *
19
+ * @example
20
+ * // Inset keyline for nested sections
21
+ * <KeylineDivider inset="1rem" />
22
+ *
23
+ * @example
24
+ * // Custom color
25
+ * <KeylineDivider color="#e5e7eb" />
26
+ */
27
+
28
+ interface KeylineDividerProps {
29
+ /** Horizontal inset from edges (CSS length value) */
30
+ inset?: string;
31
+ /** Border color (defaults to theme border color) */
32
+ color?: string;
33
+ /** Additional CSS class name */
34
+ className?: string;
35
+ }
36
+
37
+ const StyledHr = styled.hr<KeylineDividerProps>`
38
+ border: none;
39
+ border-top: 0.5pt solid
40
+ ${(props) =>
41
+ props.color ||
42
+ props.theme?.colors?.border ||
43
+ 'var(--resume-color-border, #e5e7eb)'};
44
+ margin-left: ${(props) => props.inset || '0'};
45
+ margin-right: ${(props) => props.inset || '0'};
46
+ margin-top: ${(props) =>
47
+ props.theme?.spacing?.tight || 'var(--resume-space-tight, 0.5rem)'};
48
+ margin-bottom: ${(props) =>
49
+ props.theme?.spacing?.tight || 'var(--resume-space-tight, 0.5rem)'};
50
+
51
+ @media print {
52
+ /* Ensure minimum stroke weight for print visibility */
53
+ border-top-width: 0.3pt;
54
+ /* Prevent page breaks */
55
+ page-break-inside: avoid;
56
+ /* Ensure border renders in all print modes */
57
+ -webkit-print-color-adjust: exact;
58
+ print-color-adjust: exact;
59
+ }
60
+ `;
61
+
62
+ export function KeylineDivider({
63
+ inset,
64
+ color,
65
+ className,
66
+ ...rest
67
+ }: KeylineDividerProps) {
68
+ return (
69
+ <StyledHr
70
+ role="separator"
71
+ aria-orientation="horizontal"
72
+ inset={inset}
73
+ color={color}
74
+ className={`resume-keyline-divider ${className || ''}`.trim()}
75
+ {...rest}
76
+ />
77
+ );
78
+ }
79
+
80
+ export default KeylineDivider;
@@ -0,0 +1,59 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+ import { safeUrl, isExternalUrl } from '../utils/security.js';
4
+
5
+ /**
6
+ * Link Component
7
+ * Safe link component with security checks
8
+ *
9
+ * @component
10
+ * @example
11
+ * <Link href="https://example.com">Visit Site</Link>
12
+ */
13
+
14
+ const StyledLink = styled.a`
15
+ color: ${(props) =>
16
+ props.theme?.colors?.link || 'var(--resume-color-link, #0066cc)'};
17
+ text-decoration: none;
18
+
19
+ &:hover {
20
+ text-decoration: underline;
21
+ }
22
+
23
+ &:visited {
24
+ color: ${(props) =>
25
+ props.theme?.colors?.linkVisited ||
26
+ 'var(--resume-color-link-visited, #551a8b)'};
27
+ }
28
+
29
+ @media print {
30
+ color: inherit;
31
+ text-decoration: underline;
32
+ }
33
+ `;
34
+
35
+ export function Link({ href, children, className, ...rest }) {
36
+ const safeHref = safeUrl(href);
37
+
38
+ if (!safeHref) {
39
+ return <span className={className}>{children}</span>;
40
+ }
41
+
42
+ const isExternal = isExternalUrl(safeHref);
43
+ const externalProps = isExternal
44
+ ? { target: '_blank', rel: 'noopener noreferrer' }
45
+ : {};
46
+
47
+ return (
48
+ <StyledLink
49
+ href={safeHref}
50
+ className={`resume-link ${className || ''}`.trim()}
51
+ {...externalProps}
52
+ {...rest}
53
+ >
54
+ {children}
55
+ </StyledLink>
56
+ );
57
+ }
58
+
59
+ export default Link;
@@ -0,0 +1,29 @@
1
+ import React from 'react';
2
+ /**
3
+ * Link Stories
4
+ */
5
+ import { Link } from './Link';
6
+
7
+ const meta = {
8
+ title: 'Resume Core/Primitives/Link',
9
+ component: Link,
10
+ parameters: { layout: 'padded' },
11
+ tags: ['autodocs'],
12
+ };
13
+
14
+ export default meta;
15
+
16
+ export const Default = {
17
+ args: {
18
+ href: 'https://example.com',
19
+ children: 'Visit website',
20
+ },
21
+ };
22
+
23
+ export const Example = {
24
+ args: {
25
+ href: 'https://github.com/username',
26
+ children: 'GitHub Profile',
27
+ external: true,
28
+ },
29
+ };
@@ -0,0 +1,127 @@
1
+ import React from 'react';
2
+ import styled from 'styled-components';
3
+
4
+ /**
5
+ * ListItem Component
6
+ * Experience/Education item with consistent structure
7
+ * Perfect for work experience, education, projects, etc.
8
+ *
9
+ * @component
10
+ * @example
11
+ * <ListItem
12
+ * title="Senior Software Engineer"
13
+ * subtitle="Acme Corp"
14
+ * dateRange="Jan 2020 - Present"
15
+ * location="San Francisco, CA"
16
+ * description="Led development of microservices architecture"
17
+ * highlights={['Led team of 5', 'Increased performance by 40%']}
18
+ * />
19
+ */
20
+
21
+ const ItemContainer = styled.div`
22
+ margin-bottom: ${(props) =>
23
+ props.theme?.spacing?.item || 'var(--resume-space-item, 1rem)'};
24
+
25
+ @media print {
26
+ page-break-inside: avoid;
27
+ }
28
+ `;
29
+
30
+ const ItemHeader = styled.div`
31
+ display: flex;
32
+ justify-content: space-between;
33
+ align-items: baseline;
34
+ margin-bottom: 4px;
35
+ `;
36
+
37
+ const ItemTitle = styled.div`
38
+ font-weight: 600;
39
+ color: ${(props) =>
40
+ props.theme?.colors?.primary || 'var(--resume-color-primary, #000)'};
41
+ font-size: ${(props) =>
42
+ props.theme?.typography?.body || 'var(--resume-size-body, 11pt)'};
43
+ `;
44
+
45
+ const ItemSubtitle = styled.div`
46
+ color: ${(props) =>
47
+ props.theme?.colors?.secondary || 'var(--resume-color-secondary, #333)'};
48
+ margin-bottom: 4px;
49
+ `;
50
+
51
+ const ItemMeta = styled.div`
52
+ display: flex;
53
+ gap: 12px;
54
+ font-size: ${(props) =>
55
+ props.theme?.typography?.small || 'var(--resume-size-small, 10pt)'};
56
+ color: ${(props) =>
57
+ props.theme?.colors?.tertiary || 'var(--resume-color-tertiary, #666)'};
58
+ margin-bottom: 8px;
59
+ `;
60
+
61
+ const Description = styled.p`
62
+ margin: 8px 0;
63
+ line-height: 1.6;
64
+ `;
65
+
66
+ const Highlights = styled.ul`
67
+ margin: 8px 0;
68
+ padding-left: 20px;
69
+ list-style-type: disc;
70
+
71
+ li {
72
+ margin: 4px 0;
73
+ line-height: 1.5;
74
+ }
75
+ `;
76
+
77
+ export function ListItem({
78
+ title,
79
+ subtitle,
80
+ dateRange,
81
+ location,
82
+ description,
83
+ highlights = [],
84
+ className,
85
+ ...rest
86
+ }) {
87
+ if (!title) return null;
88
+
89
+ const metaItems = [dateRange, location].filter(Boolean);
90
+
91
+ return (
92
+ <ItemContainer
93
+ className={`resume-item ${className || ''}`.trim()}
94
+ {...rest}
95
+ >
96
+ <ItemHeader className="resume-item-header">
97
+ <ItemTitle className="resume-item-title">{title}</ItemTitle>
98
+ </ItemHeader>
99
+
100
+ {subtitle && (
101
+ <ItemSubtitle className="resume-item-subtitle">{subtitle}</ItemSubtitle>
102
+ )}
103
+
104
+ {metaItems.length > 0 && (
105
+ <ItemMeta className="resume-item-meta">
106
+ {dateRange && <span className="resume-date">{dateRange}</span>}
107
+ {dateRange && location && <span>•</span>}
108
+ {location && <span className="resume-location">{location}</span>}
109
+ </ItemMeta>
110
+ )}
111
+
112
+ {description && (
113
+ <Description className="resume-description">{description}</Description>
114
+ )}
115
+
116
+ {highlights.length > 0 && (
117
+ <Highlights className="resume-highlights">
118
+ {highlights.map((highlight, index) => (
119
+ <li key={index}>{highlight}</li>
120
+ ))}
121
+ </Highlights>
122
+ )}
123
+ </ItemContainer>
124
+ );
125
+ }
126
+
127
+ export default ListItem;
@@ -0,0 +1,27 @@
1
+ import React from 'react';
2
+ /**
3
+ * ListItem Stories
4
+ */
5
+ import { ListItem } from './ListItem';
6
+
7
+ const meta = {
8
+ title: 'Resume Core/Primitives/ListItem',
9
+ component: ListItem,
10
+ parameters: { layout: 'padded' },
11
+ tags: ['autodocs'],
12
+ };
13
+
14
+ export default meta;
15
+
16
+ export const Default = {
17
+ args: {
18
+ children: 'First list item',
19
+ },
20
+ };
21
+
22
+ export const Example = {
23
+ args: {
24
+ children: 'List item with icon',
25
+ icon: '✓',
26
+ },
27
+ };