fix(ProductCard): remove useRef for SSR compatibility

- Remove unused useRef from ProductCard component
- Change image seed default from Date.now() to 0 for SSR consistency
- Export ProductCard from /ssr barrel for Next.js usage
- Add SSR validation test to prevent client hooks in SSR exports
- Add test:ssr-components to preversion scripts for quality gate
- Add comprehensive ProductCard documentation for SSR usage

Breaking change: ProductCard image seed now defaults to 0 instead of Date.now()
Users must provide explicit seed values for unique patterns in SSR contexts

Author: Fergus Bisset

config/vitest.ssr.config.ts

@@ -6,7 +6,11 @@ import tsconfigPaths from 'vite-tsconfig-paths'
 export default defineConfig({
   plugins: [tsconfigPaths(), react()],
   test: {
-    include: ['src/**/*.ssr.test.{ts,tsx}', 'src/**/*.env-safe.test.{ts,tsx}'],
+    include: [
+      'src/**/*.ssr.test.{ts,tsx}',
+      'src/**/*.env-safe.test.{ts,tsx}',
+      'tests/ssr-validation/**/*.test.{ts,tsx}'
+    ],
     environment: 'jsdom',
     setupFiles: ['src/test-setup.ts', 'src/ssr-test-setup.ts'],
     globals: true,

dist/components/_internal/Mermaid.css

@@ -1,3 +1,93 @@
+.nhsuk-u-visually-hidden {
+  position: absolute !important;
+  width: 1px !important;
+  height: 1px !important;
+  padding: 0 !important;
+  margin: -1px !important;
+  overflow: hidden !important;
+  clip: rect(0, 0, 0, 0) !important;
+  white-space: nowrap !important;
+  border: 0 !important;
+}
+.nhsuk-u-hidden {
+  display: none !important;
+}
+.nhsuk-u-show {
+  display: block !important;
+}
+.nhsuk-u-text-left {
+  text-align: left !important;
+}
+.nhsuk-u-text-center {
+  text-align: center !important;
+}
+.nhsuk-u-text-right {
+  text-align: right !important;
+}
+.nhsuk-u-margin-0 {
+  margin: 0 !important;
+}
+.nhsuk-u-margin-bottom-0 {
+  margin-bottom: 0 !important;
+}
+.nhsuk-u-margin-top-0 {
+  margin-top: 0 !important;
+}
+.nhsuk-u-padding-0 {
+  padding: 0 !important;
+}
+.nhsuk-u-padding-bottom-0 {
+  padding-bottom: 0 !important;
+}
+.nhsuk-u-padding-top-0 {
+  padding-top: 0 !important;
+}
+.nhsuk-u-clearfix::after {
+  content: "";
+  display: table;
+  clear: both;
+}
+
+.nhsuk-header .nhsuk-u-visually-hidden,
+.nhsuk-header__search .nhsuk-u-visually-hidden,
+label .nhsuk-u-visually-hidden,
+span .nhsuk-u-visually-hidden {
+  position: absolute !important;
+  width: 1px !important;
+  height: 1px !important;
+  padding: 0 !important;
+  margin: -1px !important;
+  overflow: hidden !important;
+  clip: rect(0, 0, 0, 0) !important;
+  -webkit-clip-path: inset(50%) !important;
+  clip-path: inset(50%) !important;
+  white-space: nowrap !important;
+  border: 0 !important;
+}
+
+.nhsuk-width-container {
+  margin: 0 auto;
+  padding: 0 24px;
+  max-width: 1200px;
+}
+@media (min-width: 768px) {
+  .nhsuk-width-container {
+    padding: 0 32px;
+  }
+}
+@media (min-width: 1020px) {
+  .nhsuk-width-container {
+    padding: 0 40px;
+  }
+}
+
+.nhsuk-icon {
+  width: auto !important;
+  height: 2em;
+  vertical-align: text-bottom;
+  flex-shrink: 0;
+}
+
 .mermaid-diagram {
   --_mm-bg: var(--nhs-fdp-color-grey-6, nhs.$nhs-fdp-color-grey-6);
   --_mm-border: var(--nhs-fdp-color-grey-4, nhs.$nhs-fdp-color-grey-4);

dist/index.esm.js

@@ -1781,9 +1781,22 @@ function Bd(e) {
   ].filter(Boolean).join(" "), o = e.marginBottom ? { marginBottom: e.marginBottom } : void 0;
   return { tag: `h${t}`, classes: r, style: o };
 }
-const Bt = ({ level: e, className: t, text: r, html: o, children: s, size: a, marginBottom: i, ...l }) => {
+const Bt = ({
+  level: e,
+  className: t,
+  text: r,
+  html: o,
+  children: s,
+  size: a,
+  marginBottom: i,
+  ...l
+}) => {
   const c = Bd({ level: e, size: a, className: t, marginBottom: i }), d = s || (o ? /* @__PURE__ */ n.jsx("span", { dangerouslySetInnerHTML: { __html: o } }) : r);
-  return Pi(c.tag, { className: c.classes, style: c.style, ...l }, d);
+  return Pi(
+    c.tag,
+    { className: c.classes, style: c.style, ...l },
+    d
+  );
 };
 function Hd(e) {
   return {