@reuters-graphics/graphics-components 1.0.30 → 1.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 (563) hide show
  1. package/dist/actions/cssVariables/cssVariables.mdx +42 -0
  2. package/dist/actions/resizeObserver/resizeObserver.mdx +22 -0
  3. package/dist/{@types/components → components}/@types/global.d.ts +2 -2
  4. package/dist/components/@types/global.js +0 -1
  5. package/dist/components/AdSlot/@types/ads.js +0 -1
  6. package/dist/components/AdSlot/AdScripts.svelte +12 -15
  7. package/dist/components/AdSlot/AdScripts.svelte.d.ts +16 -0
  8. package/dist/components/AdSlot/AdSlot.svelte +27 -35
  9. package/dist/{@types/components → components}/AdSlot/AdSlot.svelte.d.ts +4 -2
  10. package/dist/components/AdSlot/InlineAd.stories.svelte +21 -0
  11. package/dist/components/AdSlot/InlineAd.stories.svelte.d.ts +16 -0
  12. package/dist/components/AdSlot/InlineAd.svelte +6 -9
  13. package/dist/{@types/components → components}/AdSlot/InlineAd.svelte.d.ts +5 -3
  14. package/dist/components/AdSlot/LeaderboardAd.stories.svelte +35 -0
  15. package/dist/components/AdSlot/LeaderboardAd.stories.svelte.d.ts +25 -0
  16. package/dist/components/AdSlot/LeaderboardAd.svelte +26 -29
  17. package/dist/{@types/components → components}/AdSlot/LeaderboardAd.svelte.d.ts +4 -2
  18. package/dist/components/AdSlot/OneTrust.svelte +34 -34
  19. package/dist/components/AdSlot/OneTrust.svelte.d.ts +16 -0
  20. package/dist/components/AdSlot/ResponsiveAd.svelte +40 -43
  21. package/dist/{@types/components → components}/AdSlot/ResponsiveAd.svelte.d.ts +4 -2
  22. package/dist/components/AdSlot/SponsorshipAd.stories.svelte +26 -0
  23. package/dist/components/AdSlot/SponsorshipAd.stories.svelte.d.ts +25 -0
  24. package/dist/components/AdSlot/SponsorshipAd.svelte +8 -13
  25. package/dist/{@types/components → components}/AdSlot/SponsorshipAd.svelte.d.ts +4 -2
  26. package/dist/components/AdSlot/adScripts/bootstrap.js +12 -7
  27. package/dist/components/AdSlot/adScripts/getParameterByName.d.ts +2 -0
  28. package/dist/components/AdSlot/adScripts/getParameterByName.js +0 -1
  29. package/dist/components/AdSlot/adScripts/ias.js +1 -1
  30. package/dist/components/AdSlot/adScripts/loadScript.js +2 -2
  31. package/dist/components/AdSlot/stories/docs/inline.md +46 -0
  32. package/dist/components/AdSlot/stories/docs/leaderboard.md +21 -0
  33. package/dist/components/AdSlot/stories/docs/sponsorship.md +27 -0
  34. package/dist/components/AdSlot/utils.js +0 -1
  35. package/dist/components/Analytics/Analytics.stories.svelte +42 -0
  36. package/dist/components/Analytics/Analytics.stories.svelte.d.ts +25 -0
  37. package/dist/components/Analytics/Analytics.svelte +5 -8
  38. package/dist/{@types/components → components}/Analytics/Analytics.svelte.d.ts +4 -2
  39. package/dist/components/Analytics/providers/chartbeat.js +0 -1
  40. package/dist/components/Analytics/providers/ga.js +1 -1
  41. package/dist/components/Analytics/providers/index.js +0 -1
  42. package/dist/components/Analytics/stories/docs/component.md +11 -0
  43. package/dist/components/Analytics/stories/docs/environments.md +17 -0
  44. package/dist/components/Analytics/stories/docs/multipage.md +31 -0
  45. package/dist/components/Article/Article.stories.svelte +122 -0
  46. package/dist/components/Article/Article.stories.svelte.d.ts +16 -0
  47. package/dist/components/Article/Article.svelte +13 -22
  48. package/dist/{@types/components → components}/Article/Article.svelte.d.ts +4 -2
  49. package/dist/components/Article/stories/docs/component.md +13 -0
  50. package/dist/components/Article/stories/docs/customWellWidths.md +87 -0
  51. package/dist/components/BeforeAfter/BeforeAfter.stories.svelte +116 -0
  52. package/dist/components/BeforeAfter/BeforeAfter.stories.svelte.d.ts +25 -0
  53. package/dist/components/BeforeAfter/BeforeAfter.svelte +52 -108
  54. package/dist/{@types/components → components}/BeforeAfter/BeforeAfter.svelte.d.ts +4 -2
  55. package/dist/components/BeforeAfter/stories/docs/ariaDescriptions.md +35 -0
  56. package/dist/components/BeforeAfter/stories/docs/component.md +15 -0
  57. package/dist/components/BeforeAfter/stories/docs/withOverlays.md +33 -0
  58. package/dist/components/BeforeAfter/stories/myrne-after.jpg +0 -0
  59. package/dist/components/BeforeAfter/stories/myrne-before.jpg +0 -0
  60. package/dist/components/Block/Block.stories.svelte +173 -0
  61. package/dist/components/Block/Block.stories.svelte.d.ts +25 -0
  62. package/dist/components/Block/Block.svelte +5 -11
  63. package/dist/{@types/components → components}/Block/Block.svelte.d.ts +4 -2
  64. package/dist/components/Block/stories/docs/component.md +15 -0
  65. package/dist/components/Block/stories/docs/customLayouts.md +13 -0
  66. package/dist/components/Block/stories/docs/snapWidths.md +50 -0
  67. package/dist/components/BodyText/BodyText.stories.svelte +269 -0
  68. package/dist/components/BodyText/BodyText.stories.svelte.d.ts +25 -0
  69. package/dist/components/BodyText/BodyText.svelte +5 -12
  70. package/dist/{@types/components → components}/BodyText/BodyText.svelte.d.ts +4 -2
  71. package/dist/components/BodyText/stories/docs/component.md +33 -0
  72. package/dist/components/Byline/Byline.stories.svelte +43 -0
  73. package/dist/components/Byline/Byline.stories.svelte.d.ts +25 -0
  74. package/dist/components/Byline/Byline.svelte +19 -50
  75. package/dist/{@types/components → components}/Byline/Byline.svelte.d.ts +5 -3
  76. package/dist/components/Byline/stories/docs/component.md +19 -0
  77. package/dist/components/DatawrapperChart/DatawrapperChart.stories.svelte +57 -0
  78. package/dist/components/DatawrapperChart/DatawrapperChart.stories.svelte.d.ts +25 -0
  79. package/dist/components/DatawrapperChart/DatawrapperChart.svelte +28 -68
  80. package/dist/{@types/components → components}/DatawrapperChart/DatawrapperChart.svelte.d.ts +4 -2
  81. package/dist/components/DatawrapperChart/stories/docs/component.md +25 -0
  82. package/dist/components/DatawrapperChart/stories/docs/withChatter.md +5 -0
  83. package/dist/components/DocumentCloud/DocumentCloud.stories.svelte +39 -0
  84. package/dist/components/DocumentCloud/DocumentCloud.stories.svelte.d.ts +25 -0
  85. package/dist/components/DocumentCloud/DocumentCloud.svelte +5 -19
  86. package/dist/{@types/components → components}/DocumentCloud/DocumentCloud.svelte.d.ts +4 -2
  87. package/dist/components/DocumentCloud/stories/docs/component.md +17 -0
  88. package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.stories.svelte +27 -0
  89. package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.stories.svelte.d.ts +25 -0
  90. package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.svelte +2 -2
  91. package/dist/{@types/components → components}/EmbedPreviewerLink/EmbedPreviewerLink.svelte.d.ts +4 -2
  92. package/dist/components/EmbedPreviewerLink/stories/docs/component.md +11 -0
  93. package/dist/components/EndNotes/EndNotes.stories.svelte +37 -0
  94. package/dist/components/EndNotes/EndNotes.stories.svelte.d.ts +25 -0
  95. package/dist/components/EndNotes/EndNotes.svelte +3 -8
  96. package/dist/{@types/components → components}/EndNotes/EndNotes.svelte.d.ts +4 -2
  97. package/dist/{@types/components → components}/EndNotes/docProps.d.ts +4 -4
  98. package/dist/components/EndNotes/docProps.js +0 -1
  99. package/dist/components/EndNotes/stories/docs/component.md +24 -0
  100. package/dist/components/FeaturePhoto/FeaturePhoto.stories.svelte +75 -0
  101. package/dist/components/FeaturePhoto/FeaturePhoto.stories.svelte.d.ts +25 -0
  102. package/dist/components/FeaturePhoto/FeaturePhoto.svelte +27 -66
  103. package/dist/{@types/components → components}/FeaturePhoto/FeaturePhoto.svelte.d.ts +4 -2
  104. package/dist/components/FeaturePhoto/stories/docs/component.md +16 -0
  105. package/dist/components/FeaturePhoto/stories/docs/missingAltText.md +1 -0
  106. package/dist/components/FeaturePhoto/stories/docs/quickit.md +38 -0
  107. package/dist/components/FeaturePhoto/stories/shark.jpg +0 -0
  108. package/dist/components/Framer/Framer.stories.svelte +29 -0
  109. package/dist/{@types/components/Framer/Framer.svelte.d.ts → components/Framer/Framer.stories.svelte.d.ts} +6 -10
  110. package/dist/components/Framer/Framer.svelte +8 -15
  111. package/dist/components/Framer/Framer.svelte.d.ts +31 -0
  112. package/dist/components/Framer/Resizer/index.svelte +1 -3
  113. package/dist/{@types/components/SiteHeader/MobileMenu → components/Framer/Resizer}/index.svelte.d.ts +10 -8
  114. package/dist/{@types/components → components}/Framer/Typeahead/fuzzy.d.ts +1 -1
  115. package/dist/components/Framer/Typeahead/fuzzy.js +1 -1
  116. package/dist/components/Framer/Typeahead/index.svelte +21 -34
  117. package/dist/{@types/components → components}/Framer/Typeahead/index.svelte.d.ts +34 -32
  118. package/dist/{@types/components → components}/Framer/stores.d.ts +0 -1
  119. package/dist/components/Framer/stories/docs/component.md +11 -0
  120. package/dist/components/GraphicBlock/AriaHidden.svelte +1 -4
  121. package/dist/{@types/components → components}/GraphicBlock/AriaHidden.svelte.d.ts +4 -2
  122. package/dist/components/GraphicBlock/GraphicBlock.stories.svelte +122 -0
  123. package/dist/components/GraphicBlock/GraphicBlock.stories.svelte.d.ts +25 -0
  124. package/dist/components/GraphicBlock/GraphicBlock.svelte +13 -63
  125. package/dist/{@types/components → components}/GraphicBlock/GraphicBlock.svelte.d.ts +4 -2
  126. package/dist/components/GraphicBlock/TextBlock.svelte +3 -4
  127. package/dist/{@types/components → components}/GraphicBlock/TextBlock.svelte.d.ts +4 -2
  128. package/dist/components/GraphicBlock/stories/ai2svelte/ai-chart.svelte +632 -0
  129. package/dist/components/GraphicBlock/stories/ai2svelte/ai-chart.svelte.d.ts +25 -0
  130. package/dist/components/GraphicBlock/stories/docs/ai2svelte.md +19 -0
  131. package/dist/components/GraphicBlock/stories/docs/aria.md +56 -0
  132. package/dist/components/GraphicBlock/stories/docs/component.md +20 -0
  133. package/dist/components/GraphicBlock/stories/docs/customText.md +14 -0
  134. package/dist/components/GraphicBlock/stories/docs/quickit.md +35 -0
  135. package/dist/components/GraphicBlock/stories/imgs/ai-chart-md.png +0 -0
  136. package/dist/components/GraphicBlock/stories/imgs/ai-chart-sm.png +0 -0
  137. package/dist/components/GraphicBlock/stories/imgs/ai-chart-xs.png +0 -0
  138. package/dist/components/GraphicBlock/stories/placeholder.png +0 -0
  139. package/dist/components/Headline/Headline.stories.svelte +131 -0
  140. package/dist/components/Headline/Headline.stories.svelte.d.ts +25 -0
  141. package/dist/components/Headline/Headline.svelte +29 -60
  142. package/dist/{@types/components → components}/Headline/Headline.svelte.d.ts +6 -4
  143. package/dist/components/Headline/stories/crown.png +0 -0
  144. package/dist/components/Headline/stories/docs/component.md +13 -0
  145. package/dist/components/Headline/stories/docs/customHed.md +31 -0
  146. package/dist/components/Headline/stories/docs/withByline.md +13 -0
  147. package/dist/components/Headline/stories/docs/withCrownGraphic.md +24 -0
  148. package/dist/components/Headline/stories/docs/withCrownImage.md +21 -0
  149. package/dist/components/Headline/stories/docs/withDek.md +11 -0
  150. package/dist/components/Headline/stories/graphic-lg.png +0 -0
  151. package/dist/components/Headline/stories/graphic-md.png +0 -0
  152. package/dist/components/Headline/stories/graphic-sm.png +0 -0
  153. package/dist/components/Headline/stories/graphic-xl.png +0 -0
  154. package/dist/components/Headline/stories/graphic-xs.png +0 -0
  155. package/dist/components/Headline/stories/graphic.svelte +958 -0
  156. package/dist/components/Headline/stories/graphic.svelte.d.ts +25 -0
  157. package/dist/components/HeroHeadline/Hero.stories.svelte +335 -0
  158. package/dist/components/HeroHeadline/Hero.stories.svelte.d.ts +25 -0
  159. package/dist/components/HeroHeadline/Hero.svelte +37 -98
  160. package/dist/{@types/components → components}/HeroHeadline/Hero.svelte.d.ts +8 -6
  161. package/dist/components/HeroHeadline/stories/docs/backgroundGraphic.md +84 -0
  162. package/dist/components/HeroHeadline/stories/docs/backgroundVideo.md +51 -0
  163. package/dist/components/HeroHeadline/stories/docs/component.md +20 -0
  164. package/dist/components/HeroHeadline/stories/docs/customHed.md +43 -0
  165. package/dist/components/HeroHeadline/stories/docs/inlineGraphic.md +38 -0
  166. package/dist/components/HeroHeadline/stories/docs/inlinePhoto.md +34 -0
  167. package/dist/components/HeroHeadline/stories/docs/inlineVideo.md +34 -0
  168. package/dist/components/HeroHeadline/stories/docs/transparentHeader.md +17 -0
  169. package/dist/components/HeroHeadline/stories/eurovis.jpeg +0 -0
  170. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-lg.jpeg +0 -0
  171. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-md.jpeg +0 -0
  172. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-sm.jpeg +0 -0
  173. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xl.jpeg +0 -0
  174. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xl_copy.jpeg +0 -0
  175. package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xs.jpeg +0 -0
  176. package/dist/components/HeroHeadline/stories/graphics/crash.svelte +637 -0
  177. package/dist/components/HeroHeadline/stories/graphics/crash.svelte.d.ts +25 -0
  178. package/dist/components/HeroHeadline/stories/graphics/quake-map-top-lg.jpeg +0 -0
  179. package/dist/components/HeroHeadline/stories/graphics/quake-map-top-md.jpeg +0 -0
  180. package/dist/components/HeroHeadline/stories/graphics/quake-map-top-sm.jpeg +0 -0
  181. package/dist/components/HeroHeadline/stories/graphics/quake-map-top-xl.jpeg +0 -0
  182. package/dist/components/HeroHeadline/stories/graphics/quake-map-top-xs.jpeg +0 -0
  183. package/dist/components/HeroHeadline/stories/graphics/quakemap.svelte +865 -0
  184. package/dist/components/HeroHeadline/stories/graphics/quakemap.svelte.d.ts +25 -0
  185. package/dist/components/HeroHeadline/stories/polar.jpg +0 -0
  186. package/dist/components/InfoBox/InfoBox.stories.svelte +51 -0
  187. package/dist/components/InfoBox/InfoBox.stories.svelte.d.ts +25 -0
  188. package/dist/components/InfoBox/InfoBox.svelte +11 -34
  189. package/dist/{@types/components → components}/InfoBox/InfoBox.svelte.d.ts +4 -2
  190. package/dist/components/InfoBox/stories/docs/component.md +17 -0
  191. package/dist/components/Markdown/Markdown.stories.svelte +31 -0
  192. package/dist/components/Markdown/Markdown.stories.svelte.d.ts +25 -0
  193. package/dist/components/Markdown/Markdown.svelte +14 -15
  194. package/dist/{@types/components → components}/Markdown/Markdown.svelte.d.ts +4 -2
  195. package/dist/{@types/components → components}/Markdown/stores.d.ts +0 -1
  196. package/dist/components/Markdown/stores.js +0 -1
  197. package/dist/components/Markdown/stories/docs/component.md +39 -0
  198. package/dist/components/PaddingReset/PaddingReset.stories.svelte +45 -0
  199. package/dist/components/PaddingReset/PaddingReset.stories.svelte.d.ts +25 -0
  200. package/dist/components/PaddingReset/PaddingReset.svelte +2 -1
  201. package/dist/{@types/components → components}/PaddingReset/PaddingReset.svelte.d.ts +6 -4
  202. package/dist/components/PaddingReset/stories/docs/component.md +35 -0
  203. package/dist/components/PhotoCarousel/PhotoCarousel.stories.svelte +80 -0
  204. package/dist/components/PhotoCarousel/PhotoCarousel.stories.svelte.d.ts +25 -0
  205. package/dist/components/PhotoCarousel/PhotoCarousel.svelte +31 -62
  206. package/dist/{@types/components → components}/PhotoCarousel/PhotoCarousel.svelte.d.ts +6 -4
  207. package/dist/components/PhotoCarousel/stories/docs/component.md +21 -0
  208. package/dist/components/PhotoCarousel/stories/docs/withCustom.md +27 -0
  209. package/dist/components/PhotoCarousel/stories/photos.json +72 -0
  210. package/dist/components/PhotoPack/PhotoPack.stories.svelte +153 -0
  211. package/dist/components/PhotoPack/PhotoPack.stories.svelte.d.ts +25 -0
  212. package/dist/components/PhotoPack/PhotoPack.svelte +30 -62
  213. package/dist/{@types/components → components}/PhotoPack/PhotoPack.svelte.d.ts +4 -2
  214. package/dist/{@types/components → components}/PhotoPack/docProps.d.ts +7 -7
  215. package/dist/components/PhotoPack/docProps.js +7 -10
  216. package/dist/components/PhotoPack/stories/docs/component.md +45 -0
  217. package/dist/components/PhotoPack/stories/docs/missingAltText.md +1 -0
  218. package/dist/components/PhotoPack/stories/docs/quickit.md +67 -0
  219. package/dist/components/PymChild/PymChild.stories.svelte +23 -0
  220. package/dist/components/PymChild/PymChild.stories.svelte.d.ts +25 -0
  221. package/dist/components/PymChild/PymChild.svelte +6 -7
  222. package/dist/{@types/components → components}/PymChild/PymChild.svelte.d.ts +4 -2
  223. package/dist/components/PymChild/stores.d.ts +1 -0
  224. package/dist/components/PymChild/stories/docs/component.md +28 -0
  225. package/dist/components/ReferralBlock/ReferralBlock.stories.svelte +69 -0
  226. package/dist/components/ReferralBlock/ReferralBlock.stories.svelte.d.ts +25 -0
  227. package/dist/components/ReferralBlock/ReferralBlock.svelte +33 -64
  228. package/dist/{@types/components → components}/ReferralBlock/ReferralBlock.svelte.d.ts +4 -2
  229. package/dist/components/ReferralBlock/stories/docs/collection.md +7 -0
  230. package/dist/components/ReferralBlock/stories/docs/component.md +15 -0
  231. package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.stories.svelte +22 -0
  232. package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.stories.svelte.d.ts +25 -0
  233. package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.svelte +22 -17
  234. package/dist/{@types/components → components}/ReutersGraphicsLogo/ReutersGraphicsLogo.svelte.d.ts +4 -2
  235. package/dist/components/ReutersGraphicsLogo/stories/docs/component.md +11 -0
  236. package/dist/components/ReutersLogo/ReutersLogo.stories.svelte +26 -0
  237. package/dist/components/ReutersLogo/ReutersLogo.stories.svelte.d.ts +25 -0
  238. package/dist/components/ReutersLogo/ReutersLogo.svelte +5 -7
  239. package/dist/{@types/components → components}/ReutersLogo/ReutersLogo.svelte.d.ts +4 -2
  240. package/dist/components/ReutersLogo/stories/docs/component.md +9 -0
  241. package/dist/components/SEO/SEO.stories.svelte +45 -0
  242. package/dist/components/SEO/SEO.stories.svelte.d.ts +25 -0
  243. package/dist/components/SEO/SEO.svelte +55 -110
  244. package/dist/{@types/components → components}/SEO/SEO.svelte.d.ts +4 -2
  245. package/dist/components/SEO/stories/docs/component.md +26 -0
  246. package/dist/components/SEO/stories/docs/quickit.md +29 -0
  247. package/dist/{@types/components → components}/Scroller/Background.svelte.d.ts +4 -2
  248. package/dist/components/Scroller/Embedded/Background.svelte +1 -1
  249. package/dist/{@types/components → components}/Scroller/Embedded/Background.svelte.d.ts +4 -2
  250. package/dist/components/Scroller/Embedded/Foreground.svelte +2 -2
  251. package/dist/{@types/components → components}/Scroller/Embedded/Foreground.svelte.d.ts +4 -2
  252. package/dist/components/Scroller/Embedded/index.svelte +8 -16
  253. package/dist/{@types/components → components}/Scroller/Embedded/index.svelte.d.ts +4 -2
  254. package/dist/components/Scroller/Foreground.svelte +1 -1
  255. package/dist/{@types/components → components}/Scroller/Foreground.svelte.d.ts +4 -2
  256. package/dist/components/Scroller/Scroller.stories.svelte +182 -0
  257. package/dist/components/Scroller/Scroller.stories.svelte.d.ts +25 -0
  258. package/dist/components/Scroller/Scroller.svelte +22 -97
  259. package/dist/{@types/components → components}/Scroller/Scroller.svelte.d.ts +4 -2
  260. package/dist/{@types/components → components}/Scroller/docProps.d.ts +3 -3
  261. package/dist/components/Scroller/docProps.js +0 -1
  262. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-1.svelte +138 -0
  263. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-1.svelte.d.ts +25 -0
  264. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-2.svelte +282 -0
  265. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-2.svelte.d.ts +25 -0
  266. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-3.svelte +282 -0
  267. package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-3.svelte.d.ts +25 -0
  268. package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-lg.png +0 -0
  269. package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-md.png +0 -0
  270. package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-sm.png +0 -0
  271. package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-xl.png +0 -0
  272. package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-xs.png +0 -0
  273. package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-lg.png +0 -0
  274. package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-md.png +0 -0
  275. package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-sm.png +0 -0
  276. package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-xl.png +0 -0
  277. package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-xs.png +0 -0
  278. package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-lg.png +0 -0
  279. package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-md.png +0 -0
  280. package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-sm.png +0 -0
  281. package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-xl.png +0 -0
  282. package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-xs.png +0 -0
  283. package/dist/components/Scroller/stories/components/basic/InteractiveForeground.svelte +13 -0
  284. package/dist/components/Scroller/stories/components/basic/InteractiveForeground.svelte.d.ts +25 -0
  285. package/dist/components/Scroller/stories/components/basic/Step.svelte +12 -0
  286. package/dist/components/Scroller/stories/components/basic/Step.svelte.d.ts +25 -0
  287. package/dist/components/Scroller/stories/docs/ai2svelte.md +124 -0
  288. package/dist/components/Scroller/stories/docs/component.md +39 -0
  289. package/dist/components/Scroller/stories/docs/interactive.md +36 -0
  290. package/dist/components/Scroller/stories/docs/quickit.md +60 -0
  291. package/dist/{@types/components → components}/SearchInput/MagnifyingGlass.svelte.d.ts +4 -2
  292. package/dist/components/SearchInput/SearchInput.stories.svelte +22 -0
  293. package/dist/components/SearchInput/SearchInput.stories.svelte.d.ts +25 -0
  294. package/dist/components/SearchInput/SearchInput.svelte +12 -16
  295. package/dist/{@types/components → components}/SearchInput/SearchInput.svelte.d.ts +4 -2
  296. package/dist/{@types/components → components}/SearchInput/X.svelte.d.ts +4 -2
  297. package/dist/components/SearchInput/stories/docs/component.md +17 -0
  298. package/dist/components/SimpleTimeline/SimpleTimeline.stories.svelte +110 -0
  299. package/dist/components/SimpleTimeline/SimpleTimeline.stories.svelte.d.ts +25 -0
  300. package/dist/components/SimpleTimeline/SimpleTimeline.svelte +12 -31
  301. package/dist/{@types/components → components}/SimpleTimeline/SimpleTimeline.svelte.d.ts +4 -2
  302. package/dist/components/SimpleTimeline/stories/docs/component.md +24 -0
  303. package/dist/components/SiteFooter/CompanyLinks.svelte +0 -6
  304. package/dist/{@types/components → components}/SiteFooter/CompanyLinks.svelte.d.ts +6 -4
  305. package/dist/components/SiteFooter/LegalLinks.svelte +0 -6
  306. package/dist/{@types/components → components}/SiteFooter/LegalLinks.svelte.d.ts +6 -4
  307. package/dist/components/SiteFooter/QuickLinks.svelte +0 -5
  308. package/dist/{@types/components → components}/SiteFooter/QuickLinks.svelte.d.ts +6 -4
  309. package/dist/components/SiteFooter/Referrals/IntersectionObserver.svelte +1 -1
  310. package/dist/{@types/components → components}/SiteFooter/Referrals/IntersectionObserver.svelte.d.ts +14 -12
  311. package/dist/components/SiteFooter/Referrals/Link.svelte +0 -2
  312. package/dist/{@types/components → components}/SiteFooter/Referrals/Link.svelte.d.ts +4 -2
  313. package/dist/{@types/components → components}/SiteFooter/Referrals/Referrals.svelte.d.ts +6 -4
  314. package/dist/components/SiteFooter/Referrals/index.svelte +1 -1
  315. package/dist/{@types/components/SiteHeader/NavBar → components/SiteFooter/Referrals}/index.svelte.d.ts +6 -4
  316. package/dist/components/SiteFooter/SiteFooter.stories.svelte +80 -0
  317. package/dist/components/SiteFooter/SiteFooter.stories.svelte.d.ts +25 -0
  318. package/dist/components/SiteFooter/SiteFooter.svelte +23 -31
  319. package/dist/{@types/components → components}/SiteFooter/SiteFooter.svelte.d.ts +4 -2
  320. package/dist/components/SiteFooter/data.json +209 -209
  321. package/dist/components/SiteFooter/stories/docs/component.md +11 -0
  322. package/dist/components/SiteFooter/stories/docs/customReferrals.md +26 -0
  323. package/dist/components/SiteFooter/stories/docs/darkTheme.md +11 -0
  324. package/dist/components/SiteFooter/stories/docs/removeReferrals.md +9 -0
  325. package/dist/{@types/components → components}/SiteFooter/svgs/Facebook.svelte.d.ts +6 -4
  326. package/dist/{@types/components → components}/SiteFooter/svgs/Graphics.svelte.d.ts +4 -2
  327. package/dist/{@types/components → components}/SiteFooter/svgs/Instagram.svelte.d.ts +6 -4
  328. package/dist/{@types/components → components}/SiteFooter/svgs/LinkedIn.svelte.d.ts +6 -4
  329. package/dist/{@types/components → components}/SiteFooter/svgs/Pictures.svelte.d.ts +4 -2
  330. package/dist/{@types/components → components}/SiteFooter/svgs/Twitter.svelte.d.ts +6 -4
  331. package/dist/{@types/components → components}/SiteFooter/svgs/Videos.svelte.d.ts +4 -2
  332. package/dist/{@types/components → components}/SiteFooter/svgs/YouTube.svelte.d.ts +6 -4
  333. package/dist/components/SiteHeader/MobileMenu/index.svelte +0 -5
  334. package/dist/{@types/components/Framer/Resizer → components/SiteHeader/MobileMenu}/index.svelte.d.ts +10 -8
  335. package/dist/{@types/components → components}/SiteHeader/NavBar/DownArrow.svelte.d.ts +6 -4
  336. package/dist/components/SiteHeader/NavBar/NavDropdown/MoreDropdown.svelte +1 -4
  337. package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/MoreDropdown.svelte.d.ts +6 -4
  338. package/dist/components/SiteHeader/NavBar/NavDropdown/SectionDropdown.svelte +4 -8
  339. package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/SectionDropdown.svelte.d.ts +6 -4
  340. package/dist/components/SiteHeader/NavBar/NavDropdown/Spinner/index.svelte +0 -1
  341. package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/Spinner/index.svelte.d.ts +4 -2
  342. package/dist/components/SiteHeader/NavBar/NavDropdown/StoryCard/index.svelte +1 -2
  343. package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/StoryCard/index.svelte.d.ts +6 -4
  344. package/dist/components/SiteHeader/NavBar/NavDropdown/index.svelte +1 -9
  345. package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/index.svelte.d.ts +6 -4
  346. package/dist/components/SiteHeader/NavBar/index.svelte +2 -8
  347. package/dist/{@types/components/SiteFooter/Referrals → components/SiteHeader/NavBar}/index.svelte.d.ts +6 -4
  348. package/dist/components/SiteHeader/SiteHeader.stories.svelte +47 -0
  349. package/dist/components/SiteHeader/SiteHeader.stories.svelte.d.ts +25 -0
  350. package/dist/components/SiteHeader/SiteHeader.svelte +26 -35
  351. package/dist/{@types/components → components}/SiteHeader/SiteHeader.svelte.d.ts +4 -2
  352. package/dist/components/SiteHeader/data.json +347 -1
  353. package/dist/components/SiteHeader/scss/_breakpoints.scss +31 -11
  354. package/dist/components/SiteHeader/scss/_colors.scss +3 -3
  355. package/dist/components/SiteHeader/scss/_grids.scss +12 -12
  356. package/dist/components/SiteHeader/scss/_z-indexes.scss +9 -9
  357. package/dist/components/SiteHeader/stories/docs/component.md +11 -0
  358. package/dist/components/SiteHeader/stories/docs/darkTheme.md +11 -0
  359. package/dist/components/SiteHeader/svgs/Close.svelte +2 -1
  360. package/dist/{@types/components → components}/SiteHeader/svgs/Close.svelte.d.ts +4 -2
  361. package/dist/{@types/components → components}/SiteHeader/svgs/Menu.svelte.d.ts +6 -4
  362. package/dist/components/SiteHeadline/SiteHeadline.stories.svelte +67 -0
  363. package/dist/components/SiteHeadline/SiteHeadline.stories.svelte.d.ts +38 -0
  364. package/dist/components/SiteHeadline/SiteHeadline.svelte +22 -63
  365. package/dist/{@types/components → components}/SiteHeadline/SiteHeadline.svelte.d.ts +4 -2
  366. package/dist/components/SiteHeadline/stories/docs/component.md +21 -0
  367. package/dist/components/SiteHeadline/stories/docs/quickit.md +30 -0
  368. package/dist/components/Spinner/Spinner.stories.svelte +31 -0
  369. package/dist/components/Spinner/Spinner.stories.svelte.d.ts +25 -0
  370. package/dist/components/Spinner/Spinner.svelte +1 -14
  371. package/dist/{@types/components → components}/Spinner/Spinner.svelte.d.ts +4 -2
  372. package/dist/components/Spinner/stories/docs/component.md +15 -0
  373. package/dist/components/Table/LeftArrow.svelte +2 -1
  374. package/dist/{@types/components → components}/Table/LeftArrow.svelte.d.ts +4 -2
  375. package/dist/components/Table/Pagination.svelte +10 -28
  376. package/dist/{@types/components → components}/Table/Pagination.svelte.d.ts +4 -2
  377. package/dist/components/Table/RightArrow.svelte +2 -1
  378. package/dist/{@types/components → components}/Table/RightArrow.svelte.d.ts +4 -2
  379. package/dist/components/Table/Select.svelte +4 -12
  380. package/dist/{@types/components → components}/Table/Select.svelte.d.ts +4 -2
  381. package/dist/components/Table/SortArrow.svelte +1 -5
  382. package/dist/{@types/components → components}/Table/SortArrow.svelte.d.ts +4 -2
  383. package/dist/components/Table/Table.stories.svelte +169 -0
  384. package/dist/components/Table/Table.stories.svelte.d.ts +25 -0
  385. package/dist/components/Table/Table.svelte +58 -152
  386. package/dist/{@types/components → components}/Table/Table.svelte.d.ts +4 -2
  387. package/dist/components/Table/stories/docs/both.md +13 -0
  388. package/dist/components/Table/stories/docs/component.md +14 -0
  389. package/dist/components/Table/stories/docs/filter.md +11 -0
  390. package/dist/components/Table/stories/docs/format.md +21 -0
  391. package/dist/components/Table/stories/docs/metadata.md +14 -0
  392. package/dist/components/Table/stories/docs/paginate.md +14 -0
  393. package/dist/components/Table/stories/docs/search.md +11 -0
  394. package/dist/components/Table/stories/docs/sort.md +14 -0
  395. package/dist/components/Table/stories/docs/style.md +23 -0
  396. package/dist/components/Table/stories/docs/truncate.md +11 -0
  397. package/dist/components/Table/stories/homeRuns.json +42 -0
  398. package/dist/components/Table/stories/pressFreedom.json +887 -0
  399. package/dist/components/Table/stories/richestWomen.json +42 -0
  400. package/dist/{@types/components → components}/Table/utils.d.ts +0 -2
  401. package/dist/components/Table/utils.js +2 -2
  402. package/dist/{@types/components → components}/Theme/@types/component.d.ts +8 -8
  403. package/dist/components/Theme/@types/component.js +0 -3
  404. package/dist/components/Theme/Theme.stories.svelte +145 -0
  405. package/dist/components/Theme/Theme.stories.svelte.d.ts +16 -0
  406. package/dist/components/Theme/Theme.svelte +7 -22
  407. package/dist/{@types/components → components}/Theme/Theme.svelte.d.ts +4 -2
  408. package/dist/components/Theme/stories/ThemedPage.svelte +43 -0
  409. package/dist/components/Theme/stories/ThemedPage.svelte.d.ts +25 -0
  410. package/dist/components/Theme/stories/docs/component.md +15 -0
  411. package/dist/components/Theme/stories/docs/customise-font.md +52 -0
  412. package/dist/components/Theme/stories/docs/customise.md +28 -0
  413. package/dist/components/Theme/stories/docs/gfonts.png +0 -0
  414. package/dist/components/Theme/stories/docs/inheritance.md +17 -0
  415. package/dist/components/Theme/stories/docs/pattern.md +40 -0
  416. package/dist/components/Theme/themes/common.d.ts +2 -0
  417. package/dist/components/Theme/themes/dark.d.ts +2 -0
  418. package/dist/components/Theme/themes/light.d.ts +2 -0
  419. package/dist/components/Theme/utils/flatten.js +2 -3
  420. package/dist/components/ToolsHeader/ToolsHeader.stories.svelte +31 -0
  421. package/dist/components/ToolsHeader/ToolsHeader.stories.svelte.d.ts +25 -0
  422. package/dist/components/ToolsHeader/ToolsHeader.svelte +10 -27
  423. package/dist/{@types/components → components}/ToolsHeader/ToolsHeader.svelte.d.ts +4 -2
  424. package/dist/components/ToolsHeader/stories/docs/component.md +13 -0
  425. package/dist/components/Video/Controls.svelte +12 -10
  426. package/dist/{@types/components → components}/Video/Controls.svelte.d.ts +4 -2
  427. package/dist/components/Video/Video.stories.svelte +95 -0
  428. package/dist/components/Video/Video.stories.svelte.d.ts +25 -0
  429. package/dist/components/Video/Video.svelte +81 -143
  430. package/dist/{@types/components → components}/Video/Video.svelte.d.ts +4 -2
  431. package/dist/components/Video/docs.svx +275 -0
  432. package/dist/components/Video/stories/docs/component.md +15 -0
  433. package/dist/components/Video/stories/docs/controls.md +38 -0
  434. package/dist/components/Video/stories/docs/playAndLoop.md +28 -0
  435. package/dist/components/Video/stories/docs/withSound.md +36 -0
  436. package/dist/components/Video/stories/videos/silent-video.mp4 +0 -0
  437. package/dist/components/Video/stories/videos/sound-video.mp4 +0 -0
  438. package/dist/components/Visible/Visible.stories.svelte +30 -0
  439. package/dist/components/Visible/Visible.stories.svelte.d.ts +25 -0
  440. package/dist/components/Visible/Visible.svelte +25 -36
  441. package/dist/{@types/components → components}/Visible/Visible.svelte.d.ts +4 -2
  442. package/dist/components/Visible/stories/docs/component.md +19 -0
  443. package/dist/components/Visible/stories/snippets/default.svelte +11 -0
  444. package/dist/components/Visible/stories/snippets/default.svelte.d.ts +25 -0
  445. package/dist/docs/actions/intro.mdx +16 -0
  446. package/dist/docs/contributing/component-guidelines.mdx +170 -0
  447. package/dist/docs/contributing/quickstart.mdx +48 -0
  448. package/dist/docs/contributing/story-recipes/basic-story.mdx +79 -0
  449. package/dist/docs/contributing/story-recipes/source-code.png +0 -0
  450. package/dist/docs/contributing/story-recipes/story-with-custom-controls.mdx +48 -0
  451. package/dist/docs/contributing/story-recipes/story-with-custom-docs.mdx +132 -0
  452. package/dist/docs/contributing/story-recipes/story-with-media.mdx +52 -0
  453. package/dist/docs/contributing/writing-component-stories.mdx +34 -0
  454. package/dist/docs/contributing/writing-docs-stories.mdx +39 -0
  455. package/dist/docs/docStyles.scss +11 -0
  456. package/dist/docs/docs-components/CopyColourTable/ImportSnippet.d.ts +6 -0
  457. package/dist/docs/docs-components/CopyColourTable/ImportSnippet.jsx +54 -0
  458. package/dist/docs/docs-components/CopyColourTable/Table.d.ts +10 -0
  459. package/dist/docs/docs-components/CopyColourTable/Table.jsx +106 -0
  460. package/dist/docs/docs-components/CopyColourTable/styles.module.scss +180 -0
  461. package/dist/docs/docs-components/CopyTable/Table.d.ts +10 -0
  462. package/dist/docs/docs-components/CopyTable/Table.jsx +99 -0
  463. package/dist/docs/docs-components/CopyTable/styles.module.scss +129 -0
  464. package/dist/docs/docs-components/MdxTheme/Theme.d.ts +3 -0
  465. package/dist/docs/docs-components/MdxTheme/Theme.jsx +29 -0
  466. package/dist/docs/docs-components/Mermaid/Mermaid.d.ts +2 -0
  467. package/dist/docs/docs-components/Mermaid/Mermaid.jsx +32 -0
  468. package/dist/docs/docs-components/ThemeBuilder/CSSVariables/VariableTable.d.ts +3 -0
  469. package/dist/docs/docs-components/ThemeBuilder/CSSVariables/VariableTable.jsx +21 -0
  470. package/dist/docs/docs-components/ThemeBuilder/Customiser/ColourPicker.d.ts +6 -0
  471. package/dist/docs/docs-components/ThemeBuilder/Customiser/ColourPicker.jsx +25 -0
  472. package/dist/docs/docs-components/ThemeBuilder/Customiser/Customiser.d.ts +7 -0
  473. package/dist/docs/docs-components/ThemeBuilder/Customiser/Customiser.jsx +27 -0
  474. package/dist/docs/docs-components/ThemeBuilder/Customiser/Key.d.ts +10 -0
  475. package/dist/docs/docs-components/ThemeBuilder/Customiser/Key.jsx +40 -0
  476. package/dist/docs/docs-components/ThemeBuilder/Customiser/Value.d.ts +10 -0
  477. package/dist/docs/docs-components/ThemeBuilder/Customiser/Value.jsx +60 -0
  478. package/dist/docs/docs-components/ThemeBuilder/Customiser/styles.module.scss +93 -0
  479. package/dist/docs/docs-components/ThemeBuilder/NewTheme/NewTheme.d.ts +6 -0
  480. package/dist/docs/docs-components/ThemeBuilder/NewTheme/NewTheme.jsx +55 -0
  481. package/dist/docs/docs-components/ThemeBuilder/NewTheme/styles.module.scss +9 -0
  482. package/dist/docs/docs-components/ThemeBuilder/ThemeBuilder.d.ts +3 -0
  483. package/dist/docs/docs-components/ThemeBuilder/ThemeBuilder.jsx +42 -0
  484. package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/Switch.d.ts +6 -0
  485. package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/Switch.jsx +28 -0
  486. package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/styles.module.scss +40 -0
  487. package/dist/docs/docs-components/ThemeBuilder/styles.module.scss +20 -0
  488. package/dist/docs/guides/customising-with-scss.mdx +94 -0
  489. package/dist/docs/guides/getting-help.mdx +30 -0
  490. package/dist/docs/guides/google-docs.mdx +74 -0
  491. package/dist/docs/guides/graphics-kit.mdx +56 -0
  492. package/dist/docs/guides/imgs/argstable.png +0 -0
  493. package/dist/docs/guides/imgs/copy-code.png +0 -0
  494. package/dist/docs/guides/imgs/frame.png +0 -0
  495. package/dist/docs/guides/imgs/intro.png +0 -0
  496. package/dist/docs/guides/imgs/more-stories.png +0 -0
  497. package/dist/docs/guides/imgs/prop.png +0 -0
  498. package/dist/docs/guides/imgs/quickit.png +0 -0
  499. package/dist/docs/guides/imgs/scss-change.png +0 -0
  500. package/dist/docs/guides/imgs/scss-highlight.png +0 -0
  501. package/dist/docs/guides/imgs/scss-inspector.png +0 -0
  502. package/dist/docs/guides/imgs/scss-start.png +0 -0
  503. package/dist/docs/guides/imgs/scss-test.png +0 -0
  504. package/dist/docs/guides/imgs/scss-winning.png +0 -0
  505. package/dist/docs/guides/imgs/slots.png +0 -0
  506. package/dist/docs/guides/imgs/stories.png +0 -0
  507. package/dist/docs/guides/using-docs.mdx +58 -0
  508. package/dist/docs/intro.mdx +38 -0
  509. package/dist/docs/layout/article-well.jpg +0 -0
  510. package/dist/docs/layout/intro.mdx +29 -0
  511. package/dist/docs/styles/colours/intro.mdx +24 -0
  512. package/dist/docs/styles/colours/primary.mdx +165 -0
  513. package/dist/docs/styles/colours/thematic.mdx +26 -0
  514. package/dist/docs/styles/intro.mdx +23 -0
  515. package/dist/docs/styles/tokens/accessibility/main.mdx +19 -0
  516. package/dist/docs/styles/tokens/backgrounds/main.mdx +20 -0
  517. package/dist/docs/styles/tokens/borders/main.mdx +46 -0
  518. package/dist/docs/styles/tokens/flexbox/main.mdx +113 -0
  519. package/dist/docs/styles/tokens/interactivity/_main.mdx +29 -0
  520. package/dist/docs/styles/tokens/intro.mdx +128 -0
  521. package/dist/docs/styles/tokens/layout/main.mdx +73 -0
  522. package/dist/docs/styles/tokens/sizing/main.mdx +64 -0
  523. package/dist/docs/styles/tokens/spacers/main.mdx +58 -0
  524. package/dist/docs/styles/tokens/styles.scss +9 -0
  525. package/dist/docs/styles/tokens/typography/main.mdx +147 -0
  526. package/dist/docs/styles/tokens/typography/styles.scss +9 -0
  527. package/dist/docs/styles/tokens/variables/main.mdx +29 -0
  528. package/dist/docs/theme-builder/theme-builder.mdx +14 -0
  529. package/dist/docs/theming/css-variables.mdx +107 -0
  530. package/dist/docs/utils/docsPage.d.ts +25 -0
  531. package/dist/docs/utils/docsPage.js +13 -0
  532. package/dist/docs/utils/parseCss.d.ts +3 -0
  533. package/dist/docs/utils/parseCss.js +48 -0
  534. package/dist/docs/utils/withParams.d.ts +15 -0
  535. package/dist/docs/utils/withParams.js +46 -0
  536. package/dist/globals.d.ts +6 -6
  537. package/dist/index.js +2 -6
  538. package/dist/scss/fonts/_font-faces.scss +46 -23
  539. package/dist/scss/reset/_normalize.scss +1 -0
  540. package/package.json +66 -310
  541. package/dist/@types/components/AdSlot/AdScripts.svelte.d.ts +0 -23
  542. package/dist/@types/components/AdSlot/OneTrust.svelte.d.ts +0 -23
  543. package/dist/@types/components/AdSlot/adScripts/getParameterByName.d.ts +0 -2
  544. package/dist/@types/components/PymChild/stores.d.ts +0 -2
  545. package/dist/@types/components/Theme/themes/common.d.ts +0 -2
  546. package/dist/@types/components/Theme/themes/dark.d.ts +0 -2
  547. package/dist/@types/components/Theme/themes/light.d.ts +0 -2
  548. /package/dist/{@types/actions → actions}/cssVariables/index.d.ts +0 -0
  549. /package/dist/{@types/actions → actions}/resizeObserver/index.d.ts +0 -0
  550. /package/dist/{@types/components → components}/AdSlot/@types/ads.d.ts +0 -0
  551. /package/dist/{@types/components → components}/AdSlot/adScripts/bootstrap.d.ts +0 -0
  552. /package/dist/{@types/components → components}/AdSlot/adScripts/ias.d.ts +0 -0
  553. /package/dist/{@types/components → components}/AdSlot/adScripts/loadScript.d.ts +0 -0
  554. /package/dist/{@types/components → components}/AdSlot/utils.d.ts +0 -0
  555. /package/dist/{@types/components → components}/Analytics/providers/chartbeat.d.ts +0 -0
  556. /package/dist/{@types/components → components}/Analytics/providers/ga.d.ts +0 -0
  557. /package/dist/{@types/components → components}/Analytics/providers/index.d.ts +0 -0
  558. /package/dist/{@types/components → components}/Framer/uniqNames.d.ts +0 -0
  559. /package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/StoryCard/time.d.ts +0 -0
  560. /package/dist/{@types/components → components}/SiteHeader/NavBar/utils/index.d.ts +0 -0
  561. /package/dist/{@types/components → components}/Theme/utils/flatten.d.ts +0 -0
  562. /package/dist/{@types/components → components}/Theme/utils/merge.d.ts +0 -0
  563. /package/dist/{@types/index.d.ts → index.d.ts} +0 -0
@@ -0,0 +1,29 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { cssStringToTableArray } from '../../../utils/parseCss';
5
+
6
+ import cursor from '../../../../scss/tokens/interactivity/_cursor.scss?raw';
7
+ import pointerEvents from '../../../../scss/tokens/interactivity/_pointer-events.scss?raw';
8
+
9
+ <Meta title="Styles/Tokens/Interactivity" parameters={{ ...parameters }} />
10
+
11
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
12
+
13
+ # Interactivity tokens
14
+
15
+ <CopyTable
16
+ title="Cursor"
17
+ mdnLink="cursor"
18
+ header={['Class', 'Properties']}
19
+ body={cssStringToTableArray(cursor)}
20
+ copyable={[true, false]}
21
+ />
22
+
23
+ <CopyTable
24
+ title="Pointer events"
25
+ mdnLink="pointer-events"
26
+ header={['Class', 'Properties']}
27
+ body={cssStringToTableArray(pointerEvents)}
28
+ copyable={[true, false]}
29
+ />
@@ -0,0 +1,128 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../utils/docsPage.js';
3
+ import Mermaid from '../../docs-components/Mermaid/Mermaid.jsx';
4
+ import CopyTable from '../../docs-components/CopyTable/Table.jsx';
5
+ import { cssStringToTableArray } from '../../utils/parseCss';
6
+ import './styles.scss';
7
+
8
+ import color from '../../../scss/tokens/text/_color.scss?inline';
9
+
10
+ <Meta title="Styles/Tokens/Intro" parameters={{ ...parameters }} />
11
+
12
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
13
+
14
+ # Style tokens
15
+
16
+ All of the components in this library have been styled using a system of tokens. The style tokens give us a lot of flexibility and ultimately make for the most concise CSS possible.
17
+
18
+ You can use the style tokens to help shortcut the time you spend writing CSS and reinventing solid design conventions.
19
+
20
+ ## What's a "token"?
21
+
22
+ A token represents the value for an individual style rule, like `font-size` or `color`. Each token sets just one style rule, and multiple tokens are combined together to style an element, like a `<div/>`.
23
+
24
+ <Mermaid
25
+ name="token-graph"
26
+ code={`
27
+ graph LR;
28
+ A(Token)-->|1rem|B;
29
+ B(Style rule)-->|font-size|Y;
30
+ C(Token)-->|bold|D;
31
+ D(Style rule)-->|font-weight|Y;
32
+ E(Token)-->|serif|F;
33
+ F(Style rule)-->|font-family|Y;
34
+ Y(HTML Element)-->|"&lt;div/&gt;"|Z("&lt;Component/&gt;");
35
+ `}
36
+ />
37
+
38
+ Each set of tokens has several levels that represent the different values a style rule can take in our design system and are grouped in how they're named to make them easier to remember.
39
+
40
+ <Mermaid
41
+ name="individual-graph"
42
+ code={`
43
+ graph LR;
44
+ TD("\`**Text align tokens**\`")---TA;
45
+ TD---TB;
46
+ TD---TC;
47
+ TA(text-left)-->TX("text-align: left;");
48
+ TB(text-center)-->TY("text-align: center;");
49
+ TC(text-right)-->TZ("text-align: right;");
50
+ `}
51
+ />
52
+
53
+ ## Using style tokens
54
+
55
+ > Whether you use style tokens or write your own custom CSS in your project is **entirely up to you**.
56
+ >
57
+ > There are hundreds of tokens, so they can be a little daunting at first. But learning the tokens for the styles you have to write most often **will absolutely save you time**, so we recommend giving them a try.
58
+ >
59
+ > **That said**, we _do recommend_ using tokens for styling typography, especially `font-size`. (Our typography size tokens use a fluid scale so your text will look great whether a reader is on a mobile phone or giant desktop.)
60
+
61
+ All of our style tokens can be used through either a class name, an SCSS mixin or both. Use the tables throughout this section of the docs to see what's available for each token.
62
+
63
+ ### For example...
64
+
65
+ Here's our table of text colour tokens, which set the `text-color` style.
66
+
67
+ <CopyTable
68
+ title="Colour"
69
+ mdnLink="color"
70
+ header={['Class', 'Include', 'Properties']}
71
+ body={cssStringToTableArray(color, true)}
72
+ copyable={[true, (t) => `@include ${t};`, false]}
73
+ />
74
+
75
+ This table's tokens can be used through either a class or an SCSS mixin. (The table lets you click-to-copy for either.)
76
+
77
+ To use the token that sets the `color` style to our "primary" text colour (i.e., black), you'd use the `Class` token like this:
78
+
79
+ ```svelte
80
+ <p class="text-primary">Lorem ipsum...</p>
81
+ ```
82
+
83
+ If you'd like to set the style in SCSS, you'd use the `Include` token like this:
84
+
85
+ ```svelte
86
+ <p>Lorem ipsum...</p>
87
+
88
+ <style lang="scss">
89
+ @import '@reuters-graphics/graphics-components/scss/mixins';
90
+
91
+ p {
92
+ @include text-primary;
93
+ }
94
+ </style>
95
+ ```
96
+
97
+ > **Note:** If you're writing SCSS _inside a component_, the `@import` above is required. If you're writing in `global.scss`, this is already included for you.
98
+
99
+ To use multiple tokens, you'd simply add another class or include:
100
+
101
+ ```svelte
102
+ <p class="text-primary font-bold">Lorem ipsum...</p>
103
+ ```
104
+
105
+ ```scss
106
+ p {
107
+ @include text-primary;
108
+ @include font-bold;
109
+ }
110
+ ```
111
+
112
+ It's normal that not every style is accounted for by our tokens, so even if you use them expect you'll still have to write your own SCSS at times. But using the pre-made tokens will shortcut a lot of time spent tweaking styles to make designs consistent across your page. The styles set by our tokens have been pre-harmonised for you!
113
+
114
+ ### `!important` modifier
115
+
116
+ Most of our tokens can be used with an `!important` modifier simply by adding an `!`. So for the class token that controls `font-weight`, you'd make it important like:
117
+
118
+ ```svelte
119
+ <p class="!font-bold">Lorem ipsum...</p>
120
+ ```
121
+
122
+ For SCSS includes, the concept is the same, but you need to escape the `!` by adding an extra `\` to make it valid syntax:
123
+
124
+ ```scss
125
+ p {
126
+ @include \!font-bold;
127
+ }
128
+ ```
@@ -0,0 +1,73 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { cssStringToTableArray } from '../../../utils/parseCss';
5
+ import boxSizing from '../../../../scss/tokens/layout/_box-sizing.scss?raw';
6
+ import display from '../../../../scss/tokens/layout/_display.scss?raw';
7
+ import floats from '../../../../scss/tokens/layout/_floats.scss?raw';
8
+ import objectFit from '../../../../scss/tokens/layout/_object-fit.scss?raw';
9
+ import objectPosition from '../../../../scss/tokens/layout/_object-position.scss?raw';
10
+ import overflow from '../../../../scss/tokens/layout/_overflow.scss?raw';
11
+ import position from '../../../../scss/tokens/layout/_position.scss?raw';
12
+
13
+ <Meta title="Styles/Tokens/Layout" parameters={{ ...parameters }} />
14
+
15
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
16
+
17
+ # Layout tokens
18
+
19
+ <CopyTable
20
+ title="Display"
21
+ mdnLink="display"
22
+ header={['Class', 'Properties']}
23
+ body={cssStringToTableArray(display)}
24
+ copyable={[true, false]}
25
+ />
26
+
27
+ <CopyTable
28
+ title="Position"
29
+ mdnLink="position"
30
+ header={['Class', 'Properties']}
31
+ body={cssStringToTableArray(position)}
32
+ copyable={[true, false]}
33
+ />
34
+
35
+ <CopyTable
36
+ title="Overflow"
37
+ mdnLink="overflow"
38
+ header={['Class', 'Properties']}
39
+ body={cssStringToTableArray(overflow)}
40
+ copyable={[true, false]}
41
+ />
42
+
43
+ <CopyTable
44
+ title="Float"
45
+ mdnLink="float"
46
+ header={['Class', 'Properties']}
47
+ body={cssStringToTableArray(floats)}
48
+ copyable={[true, false]}
49
+ />
50
+
51
+ <CopyTable
52
+ title="Box sizing"
53
+ mdnLink="box-sizing"
54
+ header={['Class', 'Properties']}
55
+ body={cssStringToTableArray(boxSizing)}
56
+ copyable={[true, false]}
57
+ />
58
+
59
+ <CopyTable
60
+ title="Object fit"
61
+ mdnLink="object-fit"
62
+ header={['Class', 'Properties']}
63
+ body={cssStringToTableArray(objectFit)}
64
+ copyable={[true, false]}
65
+ />
66
+
67
+ <CopyTable
68
+ title="Object position"
69
+ mdnLink="object-position"
70
+ header={['Class', 'Properties']}
71
+ body={cssStringToTableArray(objectPosition)}
72
+ copyable={[true, false]}
73
+ />
@@ -0,0 +1,64 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { cssStringToTableArray } from '../../../utils/parseCss';
5
+ import height from '../../../../scss/tokens/sizing/_height.scss?inline';
6
+ import maxHeight from '../../../../scss/tokens/sizing/_max-height.scss?inline';
7
+ import maxWidth from '../../../../scss/tokens/sizing/_max-width.scss?inline';
8
+ import minHeight from '../../../../scss/tokens/sizing/_min-height.scss?inline';
9
+ import minWidth from '../../../../scss/tokens/sizing/_min-width.scss?inline';
10
+ import width from '../../../../scss/tokens/sizing/_width.scss?inline';
11
+
12
+ <Meta title="Styles/Tokens/Sizing" parameters={{ ...parameters }} />
13
+
14
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
15
+
16
+ # Sizing tokens
17
+
18
+ <CopyTable
19
+ title="Width"
20
+ mdnLink="width"
21
+ header={['Class', 'Properties']}
22
+ body={cssStringToTableArray(width)}
23
+ copyable={[true, false]}
24
+ />
25
+
26
+ <CopyTable
27
+ title="Max-width"
28
+ mdnLink="max-width"
29
+ header={['Class', 'Properties']}
30
+ body={cssStringToTableArray(maxWidth)}
31
+ copyable={[true, false]}
32
+ />
33
+
34
+ <CopyTable
35
+ title="Min-width"
36
+ mdnLink="min-width"
37
+ header={['Class', 'Properties']}
38
+ body={cssStringToTableArray(minWidth)}
39
+ copyable={[true, false]}
40
+ />
41
+
42
+ <CopyTable
43
+ title="Height"
44
+ mdnLink="height"
45
+ header={['Class', 'Properties']}
46
+ body={cssStringToTableArray(height)}
47
+ copyable={[true, false]}
48
+ />
49
+
50
+ <CopyTable
51
+ title="Max-height"
52
+ mdnLink="max-height"
53
+ header={['Class', 'Properties']}
54
+ body={cssStringToTableArray(maxHeight)}
55
+ copyable={[true, false]}
56
+ />
57
+
58
+ <CopyTable
59
+ title="Min-height"
60
+ mdnLink="min-height"
61
+ header={['Class', 'Properties']}
62
+ body={cssStringToTableArray(minHeight)}
63
+ copyable={[true, false]}
64
+ />
@@ -0,0 +1,58 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { cssStringToTableArray } from '../../../utils/parseCss';
5
+ import margin from '../../../../scss/tokens/spacers/_margin.scss?inline';
6
+ import padding from '../../../../scss/tokens/spacers/_padding.scss?inline';
7
+ import fluidMargin from '../../../../scss/tokens/spacers/_fluid-margin.scss?inline';
8
+ import fluidPadding from '../../../../scss/tokens/spacers/_fluid-padding.scss?inline';
9
+
10
+ <Meta title="Styles/Tokens/Spacers" parameters={{ ...parameters }} />
11
+
12
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
13
+
14
+ # Spacer tokens
15
+
16
+ Spacers include tokens that control static and fluid margins and paddings.
17
+
18
+ ### What's the difference between "static" and "fluid"?
19
+
20
+ **Static** margin/padding tokens set values that don't change with the size of the viewport. These tokens are best for creating space between block-like elements — divs, pictures, videos, graphics, etc. The tables below contain dozens of levels so you can finely tune spacing, but their values also are at intervals that help you maintain consistent balance on your page.
21
+
22
+ **Fluid** token values _do change_ depending on the size of the device and are specifically designed to pair with our fluid font sizes. These tokens have fewer available levels to help make sure our typography is consistent.
23
+
24
+ As a rule of thumb, if you're setting space between or adjacent to _text elements_, you'll likely want to use **fluid tokens** (`Fluid margin`/`Fluid padding` tables). If you're setting space between _block-like elements_, you probably want **static tokens** (`Margin`/`Padding`).
25
+
26
+ ---
27
+
28
+ <CopyTable
29
+ title="Margin"
30
+ mdnLink="margin"
31
+ header={['Class', 'Properties']}
32
+ body={cssStringToTableArray(margin)}
33
+ copyable={[true, false]}
34
+ />
35
+
36
+ <CopyTable
37
+ title="Padding"
38
+ mdnLink="padding"
39
+ header={['Class', 'Properties']}
40
+ body={cssStringToTableArray(padding)}
41
+ copyable={[true, false]}
42
+ />
43
+
44
+ <CopyTable
45
+ title="Fluid margin"
46
+ mdnLink="margin"
47
+ header={['Class', 'Include', 'Properties']}
48
+ body={cssStringToTableArray(fluidMargin, true)}
49
+ copyable={[true, (t) => `@include ${t};`, false]}
50
+ />
51
+
52
+ <CopyTable
53
+ title="Fluid padding"
54
+ mdnLink="margin"
55
+ header={['Class', 'Include', 'Properties']}
56
+ body={cssStringToTableArray(fluidPadding, true)}
57
+ copyable={[true, (t) => `@include ${t};`, false]}
58
+ />
@@ -0,0 +1,9 @@
1
+ div.storybook-mermaid-graph {
2
+ text,
3
+ span {
4
+ font-size: 14px;
5
+ }
6
+ p {
7
+ margin: 0;
8
+ }
9
+ }
@@ -0,0 +1,147 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { cssStringToTableArray } from '../../../utils/parseCss';
5
+ import role from '../../../../scss/tokens/text/_text-role.scss?inline';
6
+ import color from '../../../../scss/tokens/text/_color.scss?inline';
7
+ import fontFamily from '../../../../scss/tokens/text/_font-family.scss?inline';
8
+ import fontSize from '../../../../scss/tokens/text/_font-size.scss?inline';
9
+ import fontStyle from '../../../../scss/tokens/text/_font-style.scss?inline';
10
+ import fontWeight from '../../../../scss/tokens/text/_font-weight.scss?inline';
11
+ import letterSpacing from '../../../../scss/tokens/text/_letter-spacing.scss?inline';
12
+ import lineHeight from '../../../../scss/tokens/text/_line-height.scss?inline';
13
+ import textAlign from '../../../../scss/tokens/text/_text-align.scss?inline';
14
+ import textDecoration from '../../../../scss/tokens/text/_text-decoration.scss?inline';
15
+ import textStroke from '../../../../scss/tokens/text/_text-stroke.scss?inline';
16
+ import textTransform from '../../../../scss/tokens/text/_text-transform.scss?inline';
17
+ import verticalAlign from '../../../../scss/tokens/text/_vertical-align.scss?inline';
18
+ import whiteSpace from '../../../../scss/tokens/text/_white-space.scss?inline';
19
+ import wordBreak from '../../../../scss/tokens/text/_word-break.scss?inline';
20
+
21
+ import './styles.scss';
22
+
23
+ <Meta title="Styles/Tokens/Typography" parameters={{ ...parameters }} />
24
+
25
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
26
+
27
+ # Typography tokens
28
+
29
+ <CopyTable
30
+ title="Role"
31
+ note="Role tokens group several individual style tokens for common text elements like headers, body text, notes and links. You can use them as a shorthand for our default typography styles."
32
+ header={['Class', 'Include', 'Properties']}
33
+ body={cssStringToTableArray(role, true)}
34
+ copyable={[true, (t) => `@include ${t};`, false]}
35
+ />
36
+
37
+ <CopyTable
38
+ title="Colour"
39
+ mdnLink="color"
40
+ header={['Class', 'Include', 'Properties']}
41
+ body={cssStringToTableArray(color, true)}
42
+ copyable={[true, (t) => `@include ${t};`, false]}
43
+ />
44
+
45
+ <CopyTable
46
+ title="Font family"
47
+ mdnLink="font-family"
48
+ header={['Class', 'Include', 'Properties']}
49
+ body={cssStringToTableArray(fontFamily, true)}
50
+ copyable={[true, (t) => `@include ${t};`, false]}
51
+ />
52
+
53
+ <CopyTable
54
+ title="Font size"
55
+ mdnLink="font-size"
56
+ header={['Class', 'Include', 'Properties']}
57
+ body={cssStringToTableArray(fontSize, true)}
58
+ copyable={[true, (t) => `@include ${t};`, false]}
59
+ />
60
+
61
+ <CopyTable
62
+ title="Font style"
63
+ mdnLink="font-style"
64
+ header={['Class', 'Properties']}
65
+ body={cssStringToTableArray(fontStyle)}
66
+ copyable={[true, false]}
67
+ />
68
+
69
+ <CopyTable
70
+ title="Font weight"
71
+ mdnLink="font-weight"
72
+ header={['Class', 'Include', 'Properties']}
73
+ body={cssStringToTableArray(fontWeight, true)}
74
+ copyable={[true, (t) => `@include ${t};`, false]}
75
+ />
76
+
77
+ <CopyTable
78
+ title="Letter spacing"
79
+ mdnLink="letter-spacing"
80
+ header={['Class', 'Include', 'Properties']}
81
+ body={cssStringToTableArray(letterSpacing, true)}
82
+ copyable={[true, (t) => `@include ${t};`, false]}
83
+ />
84
+
85
+ <CopyTable
86
+ title="Line height"
87
+ mdnLink="line-height"
88
+ header={['Class', 'Include', 'Properties']}
89
+ body={cssStringToTableArray(lineHeight, true)}
90
+ copyable={[true, (t) => `@include ${t};`, false]}
91
+ />
92
+
93
+ <CopyTable
94
+ title="Text align"
95
+ mdnLink="text-align"
96
+ header={['Class', 'Properties']}
97
+ body={cssStringToTableArray(textAlign)}
98
+ copyable={[true, false]}
99
+ />
100
+
101
+ <CopyTable
102
+ title="Text decoration"
103
+ mdnLink="text-decoration"
104
+ header={['Class', 'Properties']}
105
+ body={cssStringToTableArray(textDecoration)}
106
+ copyable={[true, false]}
107
+ />
108
+
109
+ <CopyTable
110
+ title="Text stroke"
111
+ mdnLink="text-stroke"
112
+ header={['Class', 'Properties']}
113
+ body={cssStringToTableArray(textStroke)}
114
+ copyable={[true, false]}
115
+ />
116
+
117
+ <CopyTable
118
+ title="Text transform"
119
+ mdnLink="text-transform"
120
+ header={['Class', 'Properties']}
121
+ body={cssStringToTableArray(textTransform)}
122
+ copyable={[true, false]}
123
+ />
124
+
125
+ <CopyTable
126
+ title="Vertical align"
127
+ mdnLink="vertical-align"
128
+ header={['Class', 'Properties']}
129
+ body={cssStringToTableArray(verticalAlign)}
130
+ copyable={[true, false]}
131
+ />
132
+
133
+ <CopyTable
134
+ title="White space"
135
+ mdnLink="white-space"
136
+ header={['Class', 'Properties']}
137
+ body={cssStringToTableArray(whiteSpace)}
138
+ copyable={[true, false]}
139
+ />
140
+
141
+ <CopyTable
142
+ title="Word break"
143
+ mdnLink="word-break"
144
+ header={['Class', 'Properties']}
145
+ body={cssStringToTableArray(wordBreak)}
146
+ copyable={[true, false]}
147
+ />
@@ -0,0 +1,9 @@
1
+ div.type-system-demo {
2
+ *:first-child {
3
+ margin-top: 0;
4
+ }
5
+
6
+ *:last-child {
7
+ margin-bottom: 0;
8
+ }
9
+ }
@@ -0,0 +1,29 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../../../utils/docsPage.js';
3
+ import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
4
+ import { scssVariablesToTableArray } from '../../../utils/parseCss';
5
+
6
+ import theme from '../../../../scss/tokens/variables/_theme.scss?raw';
7
+ import block from '../../../../scss/tokens/variables/_block.scss?raw';
8
+
9
+ <Meta title="Styles/Tokens/SCSS Variables" parameters={{ ...parameters }} />
10
+
11
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
12
+
13
+ # Token variables
14
+
15
+ These are SCSS mirrors of some of the default CSS variables used in the `Theme`. Use them in places where CSS variables cannot be used. e.g. You can write `media-queries` to target the block widths using the `block` vars, which is not possible using CSS variables.
16
+
17
+ <CopyTable
18
+ title="Theme"
19
+ header={['Variable', 'Properties']}
20
+ body={scssVariablesToTableArray(theme)}
21
+ copyable={[true, false]}
22
+ />
23
+
24
+ <CopyTable
25
+ title="Block"
26
+ header={['Variable', 'Properties']}
27
+ body={scssVariablesToTableArray(block)}
28
+ copyable={[true, false]}
29
+ />
@@ -0,0 +1,14 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../utils/docsPage.js';
3
+
4
+ import ThemeBuilder from './../docs-components/ThemeBuilder/ThemeBuilder.jsx';
5
+
6
+ <Meta title="Theming/Theme builder" parameters={{ ...parameters }} />
7
+
8
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
9
+
10
+ # Theme builder
11
+
12
+ Use this tool to create a custom theme for your page then update the `Theme` component in your project.
13
+
14
+ <ThemeBuilder />
@@ -0,0 +1,107 @@
1
+ import { Meta } from '@storybook/blocks';
2
+ import { parameters } from '../utils/docsPage.js';
3
+
4
+ <Meta title="Theming/CSS variables" parameters={{ ...parameters }} />
5
+
6
+ ![](https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg)
7
+
8
+ # CSS variables
9
+
10
+ The [`Theme`](?path=/docs/components-theme--default) component uses **[CSS variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties)** to control major parts of your page's theme.
11
+
12
+ All other components in this library use those variables for styling basic colours and typography, helping keep our pages uniform and making it easier to customise the theme. CSS variables also allow our clients to easily change elements of our theme to match their brand.
13
+
14
+ This doc explains which variables are set and how you can use them in custom components you create.
15
+
16
+ > **Note:** CSS variables do not currently affect [ai2svelte](https://github.com/reuters-graphics/ai2svelte/) graphics, so you should continue to make sure your colours match the theme of your page directly in Adobe Illustrator for those graphics.
17
+
18
+ ## Using CSS variables directly
19
+
20
+ If you're new to how CSS variables work, [here's a video](https://www.youtube.com/watch?v=PHO6TBq_auI) that does a decent job explaining what they are, how they work and why they're useful.
21
+
22
+ You can use any of the CSS variables the `Theme` component sets in your own code with the [`var()`](https://www.w3schools.com/css/css3_variables.asp) function.
23
+
24
+ ```svelte
25
+ <p>My custom text</p>
26
+
27
+ <style lang="scss">
28
+ p {
29
+ color: var(--theme-colour-text-primary);
30
+ font-family: var(--theme-font-family-sans-serif);
31
+ }
32
+ </style>
33
+ ```
34
+
35
+ ## Customising variables
36
+
37
+ You can redefine any of the above CSS variables in the `<Theme>` component. Read more in [the docs](/docs/theming-theme--custom-theme) and **use the [Theme builder](/docs/theming-theme-builder--docs)**.
38
+
39
+ ```svelte
40
+ <Theme
41
+ base="light"
42
+ theme="{{
43
+ colour: {
44
+ // This replaces the default text-secondary colour '#666666' for light theme
45
+ 'text-secondary': '#213310',
46
+ },
47
+ }}"
48
+ >
49
+ <!-- page stuff -->
50
+ </Theme>
51
+ ```
52
+
53
+ ## Adding extra variables
54
+
55
+ You can even add custom variables through the `Theme` component.
56
+
57
+ For example, let's say you want to define a border radius for some card elements on your page. You can add a custom property to the `theme` prop like this:
58
+
59
+ ```svelte
60
+ <Theme
61
+ base="light"
62
+ theme="{{
63
+ style: {
64
+ 'border-radius': '22px',
65
+ },
66
+ }}"
67
+ >
68
+ <!-- page stuff -->
69
+ </Theme>
70
+ ```
71
+
72
+ ... and then access the CSS variable in your code like this:
73
+
74
+ ```svelte
75
+ <div class="card"></div>
76
+
77
+ <style lang="scss">
78
+ .card {
79
+ border-radius: var(--theme-style-border-radius);
80
+ }
81
+ </style>
82
+ ```
83
+
84
+ Using the `Theme` component for your own CSS variables helps unify important style values across a project. It also lets clients more easily customise those values for whatever matches their brand.
85
+
86
+ You can also change a variable's value based on some condition. For example, to set a smaller border radius on mobile screens, you might:
87
+
88
+ ```svelte
89
+ <script>
90
+ // other code
91
+
92
+ let windowWidth;
93
+ </script>
94
+
95
+ <svelte:window bind:innerWidth="{windowWidth}" />
96
+
97
+ <Theme
98
+ base="light"
99
+ theme="{{
100
+ style: {
101
+ 'border-radius': windowWidth > 475 ? '22px' : '11px',
102
+ },
103
+ }}"
104
+ >
105
+ <!-- page stuff -->
106
+ </Theme>
107
+ ```