Update package configuration for NHSDigital npm public registry

Package changes:
- Renamed package to @nhsdigital/nhs-fdp-design-system
- Updated version to 1.0.0 for fresh public release
- Changed author to "FDP Product Design Team"
- Changed license to MIT
- Added repository, bugs, homepage URLs pointing to NHSDigital/fdp-react-design-system
- Updated publishConfig to use npm public registry
- Added keywords for discoverability
- Updated publish scripts to use --access public

Updated all references across codebase:
- 50+ files updated from @fergusbisset/nhs-fdp-design-system to @nhsdigital/nhs-fdp-design-system
- Documentation, imports, comments all updated

Author: fergusbisset

CLAUDE.md

@@ -70,7 +70,7 @@ Components with interactivity use a split pattern:
 - `.tsx` - Client variant with state and data attributes for behaviours
 - `.server.tsx` - Server variant invoking pure renderer only
 
-Server variants can be imported via `@fergusbisset/nhs-fdp-design-system/components/ComponentName/server`
+Server variants can be imported via `@nhsdigital/nhs-fdp-design-system/components/ComponentName/server`
 
 ### Design Token System
 Built with Style Dictionary, tokens are in `packages/nhs-fdp/tokens/`:
@@ -112,6 +112,7 @@ The build system auto-generates exports:
 
 1. **Documentation Location**: All docs go in `docs/` subdirectories, never at repo root
 2. **React Version**: Uses React 19.2.0
-3. **Package Registry**: Published to GitHub Packages (`@fergusbisset` scope)
+3. **Package Registry**: Published to npm public registry (`@nhsdigital/nhs-fdp-design-system`)
 4. **Next.js Compatibility**: Supports Next.js 13.4+ through 16
 5. **Pre-version Checks**: `npm run preversion` runs lint, tests, and build before version bumps
+6. **Repository**: https://github.com/NHSDigital/fdp-react-design-system

MIGRATION-PLAN.md

@@ -7,7 +7,7 @@ This document outlines the step-by-step process to migrate from `fergusbisset/nh
 | Item | From | To |
 |------|------|-----|
 | **Repository** | `github.com/fergusbisset/nhs-fdp-design-system` | `github.com/NHSDigital/fdp-react-design-system` |
-| **Package Name** | `@fergusbisset/nhs-fdp-design-system` | `@nhsdigital/nhs-fdp-design-system` |
+| **Package Name** | `@nhsdigital/nhs-fdp-design-system` | `@nhsdigital/nhs-fdp-design-system` |
 | **Registry** | GitHub Packages | npm public registry |
 | **Author** | Fergus Bisset | FDP Product Design Team |
 
@@ -191,7 +191,7 @@ Update `package.json` to remove corresponding npm scripts.
 
 ### Step 5.2: Update all internal package references
 Search and replace throughout codebase:
-- `@fergusbisset/nhs-fdp-design-system` → `@nhsdigital/nhs-fdp-design-system`
+- `@nhsdigital/nhs-fdp-design-system` → `@nhsdigital/nhs-fdp-design-system`
 
 Files to update:
 - `README.md` (all import examples)

docs/BEHAVIOURS_ARCHITECTURE.md

@@ -63,12 +63,12 @@ This architecture ensures:
 
 ### 1. SSR Components (Server-Side)
 
-**Import from:** `@fergusbisset/nhs-fdp-design-system/ssr` or main export
+**Import from:** `@nhsdigital/nhs-fdp-design-system/ssr` or main export
 
 **Usage:**
 ```tsx
 // app/page.tsx (Next.js App Router - Server Component)
-import { Button, Radios, Input } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { Button, Radios, Input } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 export default function Page() {
   return (
@@ -97,12 +97,12 @@ export default function Page() {
 
 ### 2. BehavioursLoader (Client Component)
 
-**Import from:** `@fergusbisset/nhs-fdp-design-system/behaviours/react`
+**Import from:** `@nhsdigital/nhs-fdp-design-system/behaviours/react`
 
 **Usage:**
 ```tsx
 // app/layout.tsx (Next.js App Router - Server Component)
-import { BehavioursLoader } from '@fergusbisset/nhs-fdp-design-system/behaviours/react';
+import { BehavioursLoader } from '@nhsdigital/nhs-fdp-design-system/behaviours/react';
 
 export default function RootLayout({ children }) {
   return (
@@ -137,12 +137,12 @@ export default function RootLayout({ children }) {
 
 ### 3. Vanilla JS Behaviours (Browser-Only)
 
-**Import from:** `@fergusbisset/nhs-fdp-design-system/behaviours`
+**Import from:** `@nhsdigital/nhs-fdp-design-system/behaviours`
 
 **Usage:**
 ```typescript
 // Traditional approach (if not using React)
-import { initAll } from '@fergusbisset/nhs-fdp-design-system/behaviours';
+import { initAll } from '@nhsdigital/nhs-fdp-design-system/behaviours';
 
 // After DOM is ready
 document.addEventListener('DOMContentLoaded', () => {
@@ -163,8 +163,8 @@ document.addEventListener('DOMContentLoaded', () => {
 
 ```tsx
 // app/layout.tsx (Server Component)
-import { BehavioursLoader } from '@fergusbisset/nhs-fdp-design-system/behaviours/react';
-import '@fergusbisset/nhs-fdp-design-system/css';
+import { BehavioursLoader } from '@nhsdigital/nhs-fdp-design-system/behaviours/react';
+import '@nhsdigital/nhs-fdp-design-system/css';
 
 export default function RootLayout({ children }) {
   return (
@@ -180,7 +180,7 @@ export default function RootLayout({ children }) {
 
 ```tsx
 // app/page.tsx (Server Component)
-import { Button, Radios } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { Button, Radios } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 export default function Page() {
   return (
@@ -196,8 +196,8 @@ export default function Page() {
 
 ```tsx
 // pages/_app.tsx
-import { BehavioursLoader } from '@fergusbisset/nhs-fdp-design-system/behaviours/react';
-import '@fergusbisset/nhs-fdp-design-system/css';
+import { BehavioursLoader } from '@nhsdigital/nhs-fdp-design-system/behaviours/react';
+import '@nhsdigital/nhs-fdp-design-system/css';
 
 export default function App({ Component, pageProps }) {
   return (
@@ -219,7 +219,7 @@ import nunjucks from 'nunjucks';
 const app = express();
 
 // Serve behaviours bundle
-app.use('/static', express.static('node_modules/@fergusbisset/nhs-fdp-design-system/dist/behaviours'));
+app.use('/static', express.static('node_modules/@nhsdigital/nhs-fdp-design-system/dist/behaviours'));
 
 // In your template:
 // <script src="/static/index.js"></script>
@@ -282,7 +282,7 @@ export function initRadios(scope = document) {
 ```tsx
 // ✅ CORRECT - Import in layout, use after children
 // app/layout.tsx (Server Component is OK)
-import { BehavioursLoader } from '@fergusbisset/nhs-fdp-design-system/behaviours/react';
+import { BehavioursLoader } from '@nhsdigital/nhs-fdp-design-system/behaviours/react';
 
 export default function Layout({ children }) {
   return (

docs/BEHAVIOURS_INITIALIZATION.md

@@ -38,7 +38,7 @@ Use Next.js `Script` component or plain `<script>` tags to initialize behaviours
 
 ```tsx
 // app/layout.tsx (Server Component - no "use client" needed!)
-import { InitBehaviours } from '@fergusbisset/nhs-fdp-design-system/nextjs'
+import { InitBehaviours } from '@nhsdigital/nhs-fdp-design-system/nextjs'
 
 export default function RootLayout({ children }: { children: React.ReactNode }) {
   return (
@@ -77,7 +77,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 
 ```tsx
 // app/layout.tsx
-import { InitBehavioursInline } from '@fergusbisset/nhs-fdp-design-system/nextjs'
+import { InitBehavioursInline } from '@nhsdigital/nhs-fdp-design-system/nextjs'
 
 export default function RootLayout({ children }: { children: React.ReactNode }) {
   return (
@@ -112,7 +112,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 
   <!-- Load behaviours after content -->
   <script 
-    src="/node_modules/@fergusbisset/nhs-fdp-design-system/dist/behaviours/init.js" 
+    src="/node_modules/@nhsdigital/nhs-fdp-design-system/dist/behaviours/init.js" 
     type="module"
     defer
   ></script>
@@ -124,7 +124,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 
 ```html
 <script 
-  src="https://unpkg.com/@fergusbisset/nhs-fdp-design-system/dist/behaviours/init.js"
+  src="https://unpkg.com/@nhsdigital/nhs-fdp-design-system/dist/behaviours/init.js"
   type="module"
   defer
 ></script>
@@ -149,7 +149,7 @@ export function ClientInitializer() {
     if (typeof window === 'undefined') return
 
     // Import and initialize
-    import('@fergusbisset/nhs-fdp-design-system/behaviours')
+    import('@nhsdigital/nhs-fdp-design-system/behaviours')
       .then(({ initAll }) => {
         initAll(document)
       })
@@ -197,7 +197,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 
 ```tsx
 // app/layout.tsx
-import { BehavioursLoader } from '@fergusbisset/nhs-fdp-design-system/behaviours/react'
+import { BehavioursLoader } from '@nhsdigital/nhs-fdp-design-system/behaviours/react'
 
 export default function RootLayout({ children }) {
   return (
@@ -215,7 +215,7 @@ export default function RootLayout({ children }) {
 
 ```tsx
 // app/layout.tsx
-import { InitBehaviours } from '@fergusbisset/nhs-fdp-design-system/nextjs'
+import { InitBehaviours } from '@nhsdigital/nhs-fdp-design-system/nextjs'
 
 export default function RootLayout({ children }) {
   return (
@@ -247,7 +247,7 @@ export function ScopedSection() {
   useEffect(() => {
     if (!containerRef.current) return
 
-    import('@fergusbisset/nhs-fdp-design-system/behaviours')
+    import('@nhsdigital/nhs-fdp-design-system/behaviours')
       .then(({ initAll }) => {
         initAll(containerRef.current!) // Init only in this container
       })
@@ -275,7 +275,7 @@ export function ManagedSection() {
 
     let cleanup: (() => void) | undefined
 
-    import('@fergusbisset/nhs-fdp-design-system/behaviours')
+    import('@nhsdigital/nhs-fdp-design-system/behaviours')
       .then(({ initAll, teardownAll }) => {
         initAll(containerRef.current!)
         cleanup = () => teardownAll(containerRef.current!)
@@ -306,8 +306,8 @@ export function ManagedSection() {
 ### "Module not found" errors
 
 **Check**:
-1. Package is installed: `npm list @fergusbisset/nhs-fdp-design-system`
-2. Import path is correct: `@fergusbisset/nhs-fdp-design-system/nextjs`
+1. Package is installed: `npm list @nhsdigital/nhs-fdp-design-system`
+2. Import path is correct: `@nhsdigital/nhs-fdp-design-system/nextjs`
 3. Build succeeded: `npm run build`
 
 ### Behaviours run too early (before hydration)
@@ -342,7 +342,7 @@ Use `<InitBehavioursInline />` if:
 **The recommended approach is `<InitBehaviours />`** from the `/nextjs` export:
 
 ```tsx
-import { InitBehaviours } from '@fergusbisset/nhs-fdp-design-system/nextjs'
+import { InitBehaviours } from '@nhsdigital/nhs-fdp-design-system/nextjs'
 ```
 
 This gives you:

docs/MIGRATIONS.md

@@ -5,7 +5,7 @@ We’ve simplified SPC imports to a few stable surfaces and reduced accidental c
 Recommended pattern (barrel-first):
 
 - Component and basic types → `src/components/DataVisualisation/charts/SPC` (SPC barrel)
-  - Example: `import { SPCChart } from '@fergusbisset/nhs-fdp-design-system/src/components/DataVisualisation/charts/SPC'`
+  - Example: `import { SPCChart } from '@nhsdigital/nhs-fdp-design-system/src/components/DataVisualisation/charts/SPC'`
   - Example: `import type { SPCChartProps, SPCDatum } from '.../charts/SPC'`
 - Engine helpers and enums → `src/components/DataVisualisation/charts/SPC/engine`
   - Example: `import { buildSpcV26a, SpcVisualCategory } from '.../charts/SPC/engine'`

docs/NEXTJS-QUICK-START.md

@@ -14,9 +14,9 @@ Load the behaviours via a tiny client-only component provided by the library. Th
 
 ```tsx
 // app/layout.tsx (Server Component)
-import '@fergusbisset/nhs-fdp-design-system/dist/nhs-fdp-design-system.css';
-import { HeaderServer } from '@fergusbisset/nhs-fdp-design-system/ssr';
-import { NHSBehavioursInit } from '@fergusbisset/nhs-fdp-design-system/nextjs';
+import '@nhsdigital/nhs-fdp-design-system/dist/nhs-fdp-design-system.css';
+import { HeaderServer } from '@nhsdigital/nhs-fdp-design-system/ssr';
+import { NHSBehavioursInit } from '@nhsdigital/nhs-fdp-design-system/nextjs';
 
 export default function RootLayout({ children }: { children: React.ReactNode }) {
   return (
@@ -34,7 +34,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
 }
 ```
 
-Alternative (legacy): If you can’t use the component, create your own client-only wrapper that imports '@fergusbisset/nhs-fdp-design-system/behaviours'. Note: avoid manual script tags (e.g. adding a src directly) – this is brittle in Next.js and won’t help SSR inline dynamic imports.
+Alternative (legacy): If you can’t use the component, create your own client-only wrapper that imports '@nhsdigital/nhs-fdp-design-system/behaviours'. Note: avoid manual script tags (e.g. adding a src directly) – this is brittle in Next.js and won’t help SSR inline dynamic imports.
 
 ## How to Verify It's Working
 
@@ -64,7 +64,7 @@ So behaviours **automatically initialize** there. But in your Next.js app, nothi
 
 ## What the Behaviours Do
 
-When you import `@fergusbisset/nhs-fdp-design-system/behaviours`, it:
+When you import `@nhsdigital/nhs-fdp-design-system/behaviours`, it:
 
 1. **Auto-initializes** on DOM ready (code at bottom of `behaviours/index.ts`)
 2. **Finds all headers** on the page (`.nhsuk-header`)
@@ -80,9 +80,9 @@ Without this, you just get the static SSR markup with no interactivity.
 
 ```tsx
 // app/layout.tsx
-import '@fergusbisset/nhs-fdp-design-system/behaviours'  // ← The magic line
-import { Header } from '@fergusbisset/nhs-fdp-design-system/ssr'
-import '@fergusbisset/nhs-fdp-design-system/dist/nhs-fdp-design-system.css'
+import '@nhsdigital/nhs-fdp-design-system/behaviours'  // ← The magic line
+import { Header } from '@nhsdigital/nhs-fdp-design-system/ssr'
+import '@nhsdigital/nhs-fdp-design-system/dist/nhs-fdp-design-system.css'
 
 export default function RootLayout({ 
   children 

docs/PUBLISHING.md

@@ -70,18 +70,18 @@ Users can install specific versions:
 
 ```bash
 # Latest alpha
-npm install @fergusbisset/nhs-fdp-design-system@alpha
+npm install @nhsdigital/nhs-fdp-design-system@alpha
 
 # Latest beta
-npm install @fergusbisset/nhs-fdp-design-system@beta
+npm install @nhsdigital/nhs-fdp-design-system@beta
 
 # Latest stable
-npm install @fergusbisset/nhs-fdp-design-system
+npm install @nhsdigital/nhs-fdp-design-system
 # or explicitly:
-npm install @fergusbisset/nhs-fdp-design-system@latest
+npm install @nhsdigital/nhs-fdp-design-system@latest
 
 # Specific version
-npm install @fergusbisset/[email protected]
+npm install @nhsdigital/[email protected]
 ```
 
 ## Benefits

docs/RELEASE_v0.0.43.md

@@ -52,7 +52,7 @@ If you import ProductCard from `/ssr`:
 
 **Before (v0.0.42):**
 ```tsx
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 <ProductCard
   title="Product"
@@ -65,7 +65,7 @@ import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
 
 **After (v0.0.43):**
 ```tsx
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 <ProductCard
   title="Product"
@@ -81,7 +81,7 @@ import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
 Client-side usage (main barrel) is **100% backward compatible**:
 
 ```tsx
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system';
 
 // All existing code continues to work unchanged
 <ProductCard
@@ -99,7 +99,7 @@ import { ProductCard } from '@fergusbisset/nhs-fdp-design-system';
 
 ```tsx
 // app/products/page.tsx (Server Component - default)
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 export default function ProductsPage() {
   return (
@@ -133,7 +133,7 @@ export default function ProductsPage() {
 // app/products/interactive.tsx
 'use client';  // Required in Next.js App Router
 
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system';
 import { useRouter } from 'next/navigation';
 
 export default function InteractiveProduct() {
@@ -232,7 +232,7 @@ You can now use ProductCard in **Server Components** (the default):
 
 ```tsx
 // app/page.tsx - No 'use client' needed!
-import { ProductCard } from '@fergusbisset/nhs-fdp-design-system/ssr';
+import { ProductCard } from '@nhsdigital/nhs-fdp-design-system/ssr';
 
 export default function HomePage() {
   return <ProductCard title="My Product" href="/product" />;
@@ -265,7 +265,7 @@ Questions? Check the documentation:
 ## Installation
 
 ```bash
-npm install @fergusbisset/[email protected]
+npm install @nhsdigital/[email protected]
 ```
 
 or with `.npmrc`:
@@ -278,5 +278,5 @@ or with `.npmrc`:
 then:
 
 ```bash
-npm install @fergusbisset/nhs-fdp-design-system@latest
+npm install @nhsdigital/nhs-fdp-design-system@latest
 ```

docs/SSR_HEADER_BEHAVIOUR.md

@@ -48,8 +48,8 @@ The `InitBehaviours` component (from `/nextjs` export) initializes all behaviour
 
 ```tsx
 // app/layout.tsx (Server Component - no "use client" needed!)
-import { InitBehaviours } from '@fergusbisset/nhs-fdp-design-system/nextjs'
-import { HeaderServer } from '@fergusbisset/nhs-fdp-design-system/ssr'
+import { InitBehaviours } from '@nhsdigital/nhs-fdp-design-system/nextjs'
+import { HeaderServer } from '@nhsdigital/nhs-fdp-design-system/ssr'
 
 export default function RootLayout({ children }) {
   return (
@@ -210,7 +210,7 @@ export function CustomHeaderInit() {
   useEffect(() => {
     if (!headerRef.current) return
 
-    import('@fergusbisset/nhs-fdp-design-system/behaviours')
+    import('@nhsdigital/nhs-fdp-design-system/behaviours')
       .then(({ initHeaders }) => {
         const instances = initHeaders(headerRef.current!)
         return () => instances.forEach(i => i.destroy())