@tantainnovative/ndpr-toolkit 3.3.1 → 3.4.0

package/dist/styling-BMDGQDgS.d.mts

@@ -0,0 +1,64 @@
+import React__default from 'react';
+import { a as ConsentSettings, b as ConsentStorageOptions } from './consent-CmVzqZUk.mjs';
+
+interface ConsentStorageClassNames {
+    root?: string;
+}
+interface ConsentStorageProps {
+    /**
+     * Current consent settings
+     */
+    settings: ConsentSettings;
+    /**
+     * Storage options for consent settings
+     */
+    storageOptions?: ConsentStorageOptions;
+    /**
+     * Callback function called when settings are loaded from storage
+     */
+    onLoad?: (settings: ConsentSettings | null) => void;
+    /**
+     * Callback function called when settings are saved to storage
+     */
+    onSave?: (settings: ConsentSettings) => void;
+    /**
+     * Whether to automatically save settings to storage
+     * @default true
+     */
+    autoSave?: boolean;
+    /**
+     * Whether to automatically load settings from storage on mount
+     * @default true
+     */
+    autoLoad?: boolean;
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     */
+    classNames?: ConsentStorageClassNames;
+    /**
+     * When true, all default classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+    /**
+     * Children to render
+     * Can be either React nodes or a render prop function that receives storage methods
+     */
+    children?: React__default.ReactNode | ((props: {
+        loadSettings: () => ConsentSettings | null;
+        saveSettings: (settings: ConsentSettings) => void;
+        clearSettings: () => void;
+        loaded: boolean;
+    }) => React__default.ReactNode);
+}
+declare const ConsentStorage: ({ settings, storageOptions, onLoad, onSave, autoSave, autoLoad, classNames, unstyled, children }: ConsentStorageProps) => React__default.ReactElement | null;
+
+/**
+ * Resolves class names for a component section.
+ * If unstyled is true, only the override class is used (or empty string).
+ * If an override is provided, it fully REPLACES the default — no appending.
+ * Otherwise the default class string is returned as-is.
+ */
+declare function resolveClass(defaultClass: string, override?: string, unstyled?: boolean): string;
+
+export { ConsentStorage as C, type ConsentStorageClassNames as a, type ConsentStorageProps as b, resolveClass as r };

package/dist/styling-BaoQtV06.d.ts

@@ -0,0 +1,64 @@
+import React__default from 'react';
+import { a as ConsentSettings, b as ConsentStorageOptions } from './consent-CmVzqZUk.js';
+
+interface ConsentStorageClassNames {
+    root?: string;
+}
+interface ConsentStorageProps {
+    /**
+     * Current consent settings
+     */
+    settings: ConsentSettings;
+    /**
+     * Storage options for consent settings
+     */
+    storageOptions?: ConsentStorageOptions;
+    /**
+     * Callback function called when settings are loaded from storage
+     */
+    onLoad?: (settings: ConsentSettings | null) => void;
+    /**
+     * Callback function called when settings are saved to storage
+     */
+    onSave?: (settings: ConsentSettings) => void;
+    /**
+     * Whether to automatically save settings to storage
+     * @default true
+     */
+    autoSave?: boolean;
+    /**
+     * Whether to automatically load settings from storage on mount
+     * @default true
+     */
+    autoLoad?: boolean;
+    /**
+     * Object of CSS class overrides keyed by semantic section name.
+     */
+    classNames?: ConsentStorageClassNames;
+    /**
+     * When true, all default classes are removed so consumers
+     * can style from scratch using classNames.
+     */
+    unstyled?: boolean;
+    /**
+     * Children to render
+     * Can be either React nodes or a render prop function that receives storage methods
+     */
+    children?: React__default.ReactNode | ((props: {
+        loadSettings: () => ConsentSettings | null;
+        saveSettings: (settings: ConsentSettings) => void;
+        clearSettings: () => void;
+        loaded: boolean;
+    }) => React__default.ReactNode);
+}
+declare const ConsentStorage: ({ settings, storageOptions, onLoad, onSave, autoSave, autoLoad, classNames, unstyled, children }: ConsentStorageProps) => React__default.ReactElement | null;
+
+/**
+ * Resolves class names for a component section.
+ * If unstyled is true, only the override class is used (or empty string).
+ * If an override is provided, it fully REPLACES the default — no appending.
+ * Otherwise the default class string is returned as-is.
+ */
+declare function resolveClass(defaultClass: string, override?: string, unstyled?: boolean): string;
+
+export { ConsentStorage as C, type ConsentStorageClassNames as a, type ConsentStorageProps as b, resolveClass as r };

package/dist/unstyled.d.mts

@@ -1,22 +1,55 @@
-import React__default, { ReactNode } from 'react';
+import React__default from 'react';
+import { c as ConsentBannerProps } from './ConsentBanner-F5ayys5K.mjs';
+export { C as ConsentAnalyticsEvent, b as ConsentBannerClassNames } from './ConsentBanner-F5ayys5K.mjs';
+import { b as ConsentManagerProps } from './ConsentManager-C7I3PDe8.mjs';
+export { a as ConsentManagerClassNames } from './ConsentManager-C7I3PDe8.mjs';
+import { c as DSRRequestFormProps } from './DSRRequestForm-DRouEr9j.mjs';
+export { b as DSRRequestFormClassNames } from './DSRRequestForm-DRouEr9j.mjs';
+import './consent-CmVzqZUk.mjs';
+import './dsr-yKbqX531.mjs';
 
-interface UnstyledConsentBannerProps {
-    className?: string;
-    children?: ReactNode;
-}
-declare const UnstyledConsentBanner: React__default.FC<UnstyledConsentBannerProps>;
+/**
+ * Unstyled entry — design-system-friendly component variants.
+ *
+ * Components imported from this subpath default `unstyled` to `true`,
+ * which strips every default class name from the rendered markup.
+ * Consumers using their own design system (Tailwind, Mantine, Chakra,
+ * shadcn, raw CSS) get logic + accessibility + semantic structure
+ * without any pre-applied visual styling.
+ *
+ * Markup, ARIA attributes, focus management, keyboard handling, and the
+ * `data-ndpr-component` data attributes are all preserved — those are
+ * part of the contract, not styling.
+ *
+ * @example
+ * ```tsx
+ * // app/cookie-banner.tsx
+ * import { ConsentBanner } from '@tantainnovative/ndpr-toolkit/unstyled';
+ *
+ * export function CookieBanner() {
+ *   return (
+ *     <ConsentBanner
+ *       options={[]}
+ *       onSave={() => {}}
+ *       classNames={{
+ *         root: 'fixed bottom-0 inset-x-0 bg-white p-6 shadow-2xl',
+ *         title: 'text-xl font-bold mb-2',
+ *         buttonGroup: 'flex gap-2 mt-4',
+ *         acceptButton: 'btn-primary',
+ *         rejectButton: 'btn-secondary',
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * For components not yet migrated to the BEM stylesheet (DPIA, Breach,
+ * ROPA, etc.), import them from their normal subpath and pass
+ * `unstyled` manually if available — the migration completes in 3.5.x.
+ */
 
-interface UnstyledConsentSettingsProps {
-    className?: string;
-    children?: ReactNode;
-}
-declare const UnstyledConsentSettings: React__default.FC<UnstyledConsentSettingsProps>;
+declare const ConsentBanner: React__default.FC<ConsentBannerProps>;
+declare const ConsentManager: React__default.FC<ConsentManagerProps>;
+declare const DSRRequestForm: React__default.FC<DSRRequestFormProps>;
 
-interface UnstyledConsentToggleProps {
-    category: 'analytics' | 'marketing' | 'functional';
-    className?: string;
-    label?: string;
-}
-declare const UnstyledConsentToggle: React__default.FC<UnstyledConsentToggleProps>;
-
-export { UnstyledConsentBanner as ConsentBanner, UnstyledConsentSettings as ConsentSettings, UnstyledConsentToggle as ConsentToggle };
+export { ConsentBanner, ConsentBannerProps, ConsentManager, ConsentManagerProps, DSRRequestForm, DSRRequestFormProps };

package/dist/unstyled.d.ts

@@ -1,22 +1,55 @@
-import React__default, { ReactNode } from 'react';
+import React__default from 'react';
+import { c as ConsentBannerProps } from './ConsentBanner-VqIPophc.js';
+export { C as ConsentAnalyticsEvent, b as ConsentBannerClassNames } from './ConsentBanner-VqIPophc.js';
+import { b as ConsentManagerProps } from './ConsentManager-CQ2IZtUU.js';
+export { a as ConsentManagerClassNames } from './ConsentManager-CQ2IZtUU.js';
+import { c as DSRRequestFormProps } from './DSRRequestForm-D8rPTNmU.js';
+export { b as DSRRequestFormClassNames } from './DSRRequestForm-D8rPTNmU.js';
+import './consent-CmVzqZUk.js';
+import './dsr-yKbqX531.js';
 
-interface UnstyledConsentBannerProps {
-    className?: string;
-    children?: ReactNode;
-}
-declare const UnstyledConsentBanner: React__default.FC<UnstyledConsentBannerProps>;
+/**
+ * Unstyled entry — design-system-friendly component variants.
+ *
+ * Components imported from this subpath default `unstyled` to `true`,
+ * which strips every default class name from the rendered markup.
+ * Consumers using their own design system (Tailwind, Mantine, Chakra,
+ * shadcn, raw CSS) get logic + accessibility + semantic structure
+ * without any pre-applied visual styling.
+ *
+ * Markup, ARIA attributes, focus management, keyboard handling, and the
+ * `data-ndpr-component` data attributes are all preserved — those are
+ * part of the contract, not styling.
+ *
+ * @example
+ * ```tsx
+ * // app/cookie-banner.tsx
+ * import { ConsentBanner } from '@tantainnovative/ndpr-toolkit/unstyled';
+ *
+ * export function CookieBanner() {
+ *   return (
+ *     <ConsentBanner
+ *       options={[]}
+ *       onSave={() => {}}
+ *       classNames={{
+ *         root: 'fixed bottom-0 inset-x-0 bg-white p-6 shadow-2xl',
+ *         title: 'text-xl font-bold mb-2',
+ *         buttonGroup: 'flex gap-2 mt-4',
+ *         acceptButton: 'btn-primary',
+ *         rejectButton: 'btn-secondary',
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * For components not yet migrated to the BEM stylesheet (DPIA, Breach,
+ * ROPA, etc.), import them from their normal subpath and pass
+ * `unstyled` manually if available — the migration completes in 3.5.x.
+ */
 
-interface UnstyledConsentSettingsProps {
-    className?: string;
-    children?: ReactNode;
-}
-declare const UnstyledConsentSettings: React__default.FC<UnstyledConsentSettingsProps>;
+declare const ConsentBanner: React__default.FC<ConsentBannerProps>;
+declare const ConsentManager: React__default.FC<ConsentManagerProps>;
+declare const DSRRequestForm: React__default.FC<DSRRequestFormProps>;
 
-interface UnstyledConsentToggleProps {
-    category: 'analytics' | 'marketing' | 'functional';
-    className?: string;
-    label?: string;
-}
-declare const UnstyledConsentToggle: React__default.FC<UnstyledConsentToggleProps>;
-
-export { UnstyledConsentBanner as ConsentBanner, UnstyledConsentSettings as ConsentSettings, UnstyledConsentToggle as ConsentToggle };
+export { ConsentBanner, ConsentBannerProps, ConsentManager, ConsentManagerProps, DSRRequestForm, DSRRequestFormProps };

package/dist/unstyled.js

@@ -1,2 +1,2 @@
-'use strict';require('./chunk-MQFZHA2D.js');var react=require('react'),jsxRuntime=require('react/jsx-runtime');var m=react.createContext(void 0);function a(){let e=react.useContext(m);if(!e)throw new Error("useConsent must be used within a ConsentProvider");return e}var f=({className:e,children:i})=>{let{showBanner:t,acceptAll:s,rejectAll:l,openSettings:c}=a();return t?jsxRuntime.jsx("div",{className:e,role:"region","aria-label":"Cookie consent",children:i||jsxRuntime.jsxs(jsxRuntime.Fragment,{children:[jsxRuntime.jsxs("div",{children:[jsxRuntime.jsx("h3",{children:"Cookie Consent"}),jsxRuntime.jsx("p",{children:"We use cookies to enhance your experience. By continuing to visit this site you agree to our use of cookies."})]}),jsxRuntime.jsxs("div",{children:[jsxRuntime.jsx("button",{onClick:s,"aria-label":"Accept all cookies",children:"Accept All"}),jsxRuntime.jsx("button",{onClick:l,"aria-label":"Reject non-essential cookies",children:"Reject All"}),jsxRuntime.jsx("button",{onClick:c,"aria-label":"Manage cookie preferences",children:"Manage Preferences"})]})]})}):null};var w=[{id:"necessary",name:"Necessary Cookies",description:"These cookies are essential for the website to function properly.",disabled:true},{id:"analytics",name:"Analytics Cookies",description:"These cookies help us understand how visitors interact with our website.",disabled:false},{id:"marketing",name:"Marketing Cookies",description:"These cookies are used to track visitors across websites for marketing purposes.",disabled:false},{id:"functional",name:"Functional Cookies",description:"These cookies enable personalized features and functionality.",disabled:false}],u=({className:e,children:i})=>{let{showSettings:t,consentState:s,updateConsent:l,savePreferences:c,closeSettings:k}=a();if(!t)return null;let b=()=>{c(s);};return jsxRuntime.jsx("div",{className:e,role:"dialog","aria-label":"Cookie preferences",children:i||jsxRuntime.jsxs(jsxRuntime.Fragment,{children:[jsxRuntime.jsxs("div",{children:[jsxRuntime.jsx("h2",{children:"Cookie Preferences"}),jsxRuntime.jsx("p",{children:"Manage your cookie preferences. You can enable or disable different categories of cookies below."})]}),jsxRuntime.jsx("div",{children:w.map(o=>jsxRuntime.jsxs("div",{children:[jsxRuntime.jsxs("div",{children:[jsxRuntime.jsx("h4",{children:o.name}),jsxRuntime.jsx("p",{children:o.description})]}),jsxRuntime.jsx("input",{type:"checkbox",checked:s[o.id],onChange:v=>l(o.id,v.target.checked),disabled:o.disabled,"aria-label":`Toggle ${o.name}`})]},o.id))}),jsxRuntime.jsxs("div",{children:[jsxRuntime.jsx("button",{onClick:k,"aria-label":"Cancel changes",children:"Cancel"}),jsxRuntime.jsx("button",{onClick:b,"aria-label":"Save cookie preferences",children:"Save Preferences"})]})]})})};var g=({category:e,className:i,label:t})=>{let{consentState:s,updateConsent:l}=a();return jsxRuntime.jsxs("label",{className:i,children:[jsxRuntime.jsx("input",{type:"checkbox",checked:s[e],onChange:c=>l(e,c.target.checked),"aria-label":t||`Toggle ${e} cookies`}),t&&jsxRuntime.jsx("span",{children:t})]})};exports.ConsentBanner=f;exports.ConsentSettings=u;exports.ConsentToggle=g;//# sourceMappingURL=unstyled.js.map
+'use strict';var chunkRLYTX3MM_js=require('./chunk-RLYTX3MM.js'),chunkSUEGUY35_js=require('./chunk-SUEGUY35.js'),chunkZPKVLTSX_js=require('./chunk-ZPKVLTSX.js');require('./chunk-I54CDQGN.js'),require('./chunk-E64TU6IU.js');var chunkMQFZHA2D_js=require('./chunk-MQFZHA2D.js'),P=require('react');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var P__default=/*#__PURE__*/_interopDefault(P);function e(C,R){let n=d=>{var s=d,{unstyled:l=true}=s,c=chunkMQFZHA2D_js.c(s,["unstyled"]);return P__default.default.createElement(C,chunkMQFZHA2D_js.b(chunkMQFZHA2D_js.a({},c),{unstyled:l}))};return n.displayName=R,n}var u=e(chunkSUEGUY35_js.a,"UnstyledConsentBanner"),y=e(chunkRLYTX3MM_js.a,"UnstyledConsentManager"),S=e(chunkZPKVLTSX_js.a,"UnstyledDSRRequestForm");exports.ConsentBanner=u;exports.ConsentManager=y;exports.DSRRequestForm=S;//# sourceMappingURL=unstyled.js.map
 //# sourceMappingURL=unstyled.js.map

package/dist/unstyled.mjs

@@ -1,2 +1,2 @@
-import'./chunk-WWT2ZSNU.mjs';import {createContext,useContext}from'react';import {jsx,jsxs,Fragment}from'react/jsx-runtime';var m=createContext(void 0);function a(){let e=useContext(m);if(!e)throw new Error("useConsent must be used within a ConsentProvider");return e}var f=({className:e,children:i})=>{let{showBanner:t,acceptAll:s,rejectAll:l,openSettings:c}=a();return t?jsx("div",{className:e,role:"region","aria-label":"Cookie consent",children:i||jsxs(Fragment,{children:[jsxs("div",{children:[jsx("h3",{children:"Cookie Consent"}),jsx("p",{children:"We use cookies to enhance your experience. By continuing to visit this site you agree to our use of cookies."})]}),jsxs("div",{children:[jsx("button",{onClick:s,"aria-label":"Accept all cookies",children:"Accept All"}),jsx("button",{onClick:l,"aria-label":"Reject non-essential cookies",children:"Reject All"}),jsx("button",{onClick:c,"aria-label":"Manage cookie preferences",children:"Manage Preferences"})]})]})}):null};var w=[{id:"necessary",name:"Necessary Cookies",description:"These cookies are essential for the website to function properly.",disabled:true},{id:"analytics",name:"Analytics Cookies",description:"These cookies help us understand how visitors interact with our website.",disabled:false},{id:"marketing",name:"Marketing Cookies",description:"These cookies are used to track visitors across websites for marketing purposes.",disabled:false},{id:"functional",name:"Functional Cookies",description:"These cookies enable personalized features and functionality.",disabled:false}],u=({className:e,children:i})=>{let{showSettings:t,consentState:s,updateConsent:l,savePreferences:c,closeSettings:k}=a();if(!t)return null;let b=()=>{c(s);};return jsx("div",{className:e,role:"dialog","aria-label":"Cookie preferences",children:i||jsxs(Fragment,{children:[jsxs("div",{children:[jsx("h2",{children:"Cookie Preferences"}),jsx("p",{children:"Manage your cookie preferences. You can enable or disable different categories of cookies below."})]}),jsx("div",{children:w.map(o=>jsxs("div",{children:[jsxs("div",{children:[jsx("h4",{children:o.name}),jsx("p",{children:o.description})]}),jsx("input",{type:"checkbox",checked:s[o.id],onChange:v=>l(o.id,v.target.checked),disabled:o.disabled,"aria-label":`Toggle ${o.name}`})]},o.id))}),jsxs("div",{children:[jsx("button",{onClick:k,"aria-label":"Cancel changes",children:"Cancel"}),jsx("button",{onClick:b,"aria-label":"Save cookie preferences",children:"Save Preferences"})]})]})})};var g=({category:e,className:i,label:t})=>{let{consentState:s,updateConsent:l}=a();return jsxs("label",{className:i,children:[jsx("input",{type:"checkbox",checked:s[e],onChange:c=>l(e,c.target.checked),"aria-label":t||`Toggle ${e} cookies`}),t&&jsx("span",{children:t})]})};export{f as ConsentBanner,u as ConsentSettings,g as ConsentToggle};//# sourceMappingURL=unstyled.mjs.map
+import {a as a$2}from'./chunk-EPT2K355.mjs';import {a as a$1}from'./chunk-BN77GP4W.mjs';import {a as a$3}from'./chunk-6HZL2WDU.mjs';import'./chunk-GKKAK6ES.mjs';import'./chunk-AYKLAEOU.mjs';import {c,b,a}from'./chunk-WWT2ZSNU.mjs';import P from'react';function e(C,R){let n=d=>{var s=d,{unstyled:l=true}=s,c$1=c(s,["unstyled"]);return P.createElement(C,b(a({},c$1),{unstyled:l}))};return n.displayName=R,n}var u=e(a$1,"UnstyledConsentBanner"),y=e(a$2,"UnstyledConsentManager"),S=e(a$3,"UnstyledDSRRequestForm");export{u as ConsentBanner,y as ConsentManager,S as DSRRequestForm};//# sourceMappingURL=unstyled.mjs.map
 //# sourceMappingURL=unstyled.mjs.map

package/dist/{useAdaptivePolicyWizard-A1PyOy6P.d.mts → useAdaptivePolicyWizard-BnjW4OR4.d.mts}

@@ -1,5 +1,5 @@
 import { c as PrivacyPolicy, P as PolicySection } from './privacy-Ca6te9Ir.mjs';
-import { P as PolicyDraft, C as ComplianceGap, T as TemplateContext, a as CustomSection, b as ComplianceResult, c as PDFExportOptions, D as DOCXExportOptions, H as HTMLExportOptions } from './policy-engine-DefZcX3R.mjs';
+import { P as PolicyDraft, C as ComplianceGap, T as TemplateContext, b as CustomSection, a as ComplianceResult, g as PDFExportOptions, f as DOCXExportOptions, H as HTMLExportOptions } from './policy-engine-fYSqEqSW.mjs';
 import { S as StorageAdapter } from './types-DK2CoKOC.mjs';
 
 interface UseAdaptivePolicyWizardOptions {

package/dist/{useAdaptivePolicyWizard-LVIKhAxw.d.ts → useAdaptivePolicyWizard-sb3m4-Zk.d.ts}

@@ -1,5 +1,5 @@
 import { c as PrivacyPolicy, P as PolicySection } from './privacy-Ca6te9Ir.js';
-import { P as PolicyDraft, C as ComplianceGap, T as TemplateContext, a as CustomSection, b as ComplianceResult, c as PDFExportOptions, D as DOCXExportOptions, H as HTMLExportOptions } from './policy-engine-C6nC2t3a.js';
+import { P as PolicyDraft, C as ComplianceGap, T as TemplateContext, b as CustomSection, a as ComplianceResult, g as PDFExportOptions, f as DOCXExportOptions, H as HTMLExportOptions } from './policy-engine-CCUCud2T.js';
 import { S as StorageAdapter } from './types-DK2CoKOC.js';
 
 interface UseAdaptivePolicyWizardOptions {

package/dist/{useDefaultPrivacyPolicy-ySWU7nc-.d.mts → useDefaultPrivacyPolicy-Cs2WQSYQ.d.mts}

@@ -99,16 +99,34 @@ declare function usePrivacyPolicy({ templates, initialPolicy, adapter, storageKe
 
 interface UseDefaultPrivacyPolicyOptions {
     /**
-     * Organisation information to pre-fill into the policy variables.
+     * Organisation information to pre-fill into the policy. When provided and
+     * `autoGenerate` is true (the default), the hook will auto-select the
+     * default template and generate a renderable policy on first commit, so
+     * `policy` is non-null on the first useful render.
      */
     orgInfo?: {
-        /** Organisation name */
+        /** Organisation name (maps to `organizationInfo.name` and `orgName` variable) */
         name?: string;
-        /** Privacy contact email */
+        /** Privacy contact email (maps to `privacyEmail`) */
         email?: string;
+        /** Organisation website URL */
+        website?: string;
+        /** Physical address */
+        address?: string;
+        /** Industry / sector descriptor */
+        industry?: string;
         /** Data Protection Officer name */
         dpoName?: string;
+        /** DPO email address */
+        dpoEmail?: string;
     };
+    /**
+     * Whether the hook should auto-select the default template and generate
+     * the policy as soon as it's mounted with `orgInfo`. Set to false to
+     * retain manual control via `selectTemplate` / `generatePolicy`.
+     * @default true
+     */
+    autoGenerate?: boolean;
     /**
      * Storage key for policy data.
      * @default "ndpr_privacy_policy"
@@ -120,20 +138,23 @@ interface UseDefaultPrivacyPolicyOptions {
      */
     useLocalStorage?: boolean;
     /**
-     * Pluggable storage adapter. When provided, takes precedence over storageKey/useLocalStorage.
+     * Pluggable storage adapter. When provided, takes precedence over
+     * storageKey/useLocalStorage.
      */
     adapter?: StorageAdapter<PrivacyPolicy>;
 }
 /**
- * Convenience wrapper around `usePrivacyPolicy` that automatically
- * loads the default NDPA-compliant business policy template and
- * pre-fills common organisation variables.
+ * Convenience wrapper around `usePrivacyPolicy`. With `orgInfo` provided
+ * and `autoGenerate` enabled (default), `policy` is non-null on the first
+ * post-load render — no manual `selectTemplate` / `generatePolicy` chaining
+ * required.
  *
  * @example
  * ```tsx
- * const policy = useDefaultPrivacyPolicy({
- *   orgInfo: { name: 'Acme Ltd', email: 'privacy@acme.ng', dpoName: 'Jane Doe' }
+ * const { policy } = useDefaultPrivacyPolicy({
+ *   orgInfo: { name: 'Acme Ltd', email: 'privacy@acme.ng' }
  * });
+ * return policy ? <PolicyPage policy={policy} /> : <Spinner />;
  * ```
  */
 declare function useDefaultPrivacyPolicy(options?: UseDefaultPrivacyPolicyOptions): UsePrivacyPolicyReturn;

package/dist/{useDefaultPrivacyPolicy-DvCbeEl1.d.ts → useDefaultPrivacyPolicy-DkOqMg2e.d.ts}

@@ -99,16 +99,34 @@ declare function usePrivacyPolicy({ templates, initialPolicy, adapter, storageKe
 
 interface UseDefaultPrivacyPolicyOptions {
     /**
-     * Organisation information to pre-fill into the policy variables.
+     * Organisation information to pre-fill into the policy. When provided and
+     * `autoGenerate` is true (the default), the hook will auto-select the
+     * default template and generate a renderable policy on first commit, so
+     * `policy` is non-null on the first useful render.
      */
     orgInfo?: {
-        /** Organisation name */
+        /** Organisation name (maps to `organizationInfo.name` and `orgName` variable) */
         name?: string;
-        /** Privacy contact email */
+        /** Privacy contact email (maps to `privacyEmail`) */
         email?: string;
+        /** Organisation website URL */
+        website?: string;
+        /** Physical address */
+        address?: string;
+        /** Industry / sector descriptor */
+        industry?: string;
         /** Data Protection Officer name */
         dpoName?: string;
+        /** DPO email address */
+        dpoEmail?: string;
     };
+    /**
+     * Whether the hook should auto-select the default template and generate
+     * the policy as soon as it's mounted with `orgInfo`. Set to false to
+     * retain manual control via `selectTemplate` / `generatePolicy`.
+     * @default true
+     */
+    autoGenerate?: boolean;
     /**
      * Storage key for policy data.
      * @default "ndpr_privacy_policy"
@@ -120,20 +138,23 @@ interface UseDefaultPrivacyPolicyOptions {
      */
     useLocalStorage?: boolean;
     /**
-     * Pluggable storage adapter. When provided, takes precedence over storageKey/useLocalStorage.
+     * Pluggable storage adapter. When provided, takes precedence over
+     * storageKey/useLocalStorage.
      */
     adapter?: StorageAdapter<PrivacyPolicy>;
 }
 /**
- * Convenience wrapper around `usePrivacyPolicy` that automatically
- * loads the default NDPA-compliant business policy template and
- * pre-fills common organisation variables.
+ * Convenience wrapper around `usePrivacyPolicy`. With `orgInfo` provided
+ * and `autoGenerate` enabled (default), `policy` is non-null on the first
+ * post-load render — no manual `selectTemplate` / `generatePolicy` chaining
+ * required.
  *
  * @example
  * ```tsx
- * const policy = useDefaultPrivacyPolicy({
- *   orgInfo: { name: 'Acme Ltd', email: 'privacy@acme.ng', dpoName: 'Jane Doe' }
+ * const { policy } = useDefaultPrivacyPolicy({
+ *   orgInfo: { name: 'Acme Ltd', email: 'privacy@acme.ng' }
  * });
+ * return policy ? <PolicyPage policy={policy} /> : <Spinner />;
  * ```
  */
 declare function useDefaultPrivacyPolicy(options?: UseDefaultPrivacyPolicyOptions): UsePrivacyPolicyReturn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tantainnovative/ndpr-toolkit",
-  "version": "3.3.1",
+  "version": "3.4.0",
   "private": false,
   "description": "Nigeria Data Protection Toolkit — enterprise-grade compliance components for the Nigeria Data Protection Act (NDPA) 2023",
   "keywords": [
@@ -46,6 +46,11 @@
       "import": "./dist/core.mjs",
       "require": "./dist/core.js"
     },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js"
+    },
     "./hooks": {
       "types": "./dist/hooks.d.ts",
       "import": "./dist/hooks.mjs",
@@ -108,8 +113,11 @@
     },
     "./styles": {
       "types": "./dist/styles.d.ts",
+      "style": "./dist/styles.css",
+      "sass": "./dist/styles.css",
       "import": "./dist/styles.css",
-      "require": "./dist/styles.css"
+      "require": "./dist/styles.css",
+      "default": "./dist/styles.css"
     }
   },
   "typesVersions": {
@@ -117,6 +125,9 @@
       "core": [
         "./dist/core.d.ts"
       ],
+      "server": [
+        "./dist/server.d.ts"
+      ],
       "hooks": [
         "./dist/hooks.d.ts"
       ],
@@ -162,6 +173,7 @@
     "dist/**/*.d.mts",
     "dist/**/*.css",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "publishConfig": {

package/dist/chunk-25OOUES4.js

@@ -1,2 +0,0 @@
-'use strict';var chunkE64TU6IU_js=require('./chunk-E64TU6IU.js'),jsxRuntime=require('react/jsx-runtime');var x={consent:"Consent",dsr:"Data Subject Rights",dpia:"DPIA",breach:"Breach Notification",policy:"Privacy Policy",lawfulBasis:"Lawful Basis",crossBorder:"Cross-Border",ropa:"ROPA"},p={critical:"rgb(var(--ndpr-destructive))","needs-work":"rgb(var(--ndpr-warning))",good:"rgb(var(--ndpr-primary))",excellent:"rgb(var(--ndpr-success))"},m={critical:"Critical","needs-work":"Needs Work",good:"Good",excellent:"Excellent"},f={critical:"Critical",high:"High",medium:"Medium",low:"Low"},C=({score:t,rating:o,classNames:e,unstyled:a})=>{let r=p[o],i=2*Math.PI*40,c=i*(1-t/100);return jsxRuntime.jsxs("div",{className:chunkE64TU6IU_js.a("relative inline-flex items-center justify-center",e==null?void 0:e.scoreCircle,a),role:"img","aria-label":`Compliance score: ${t} out of 100, rated ${m[o]}`,children:[jsxRuntime.jsxs("svg",{width:"120",height:"120",viewBox:"0 0 100 100","aria-hidden":"true",children:[jsxRuntime.jsx("circle",{cx:"50",cy:"50",r:"40",fill:"none",stroke:"rgba(0,0,0,0.08)",strokeWidth:"8"}),jsxRuntime.jsx("circle",{cx:"50",cy:"50",r:"40",fill:"none",stroke:r,strokeWidth:"8",strokeLinecap:"round",strokeDasharray:i,strokeDashoffset:c,transform:"rotate(-90 50 50)",style:{transition:"stroke-dashoffset 0.4s ease"}})]}),jsxRuntime.jsx("span",{className:chunkE64TU6IU_js.a("absolute text-2xl font-bold tabular-nums",e==null?void 0:e.scoreValue,a),style:{color:r},children:t})]})},y=({rating:t,className:o,unstyled:e})=>{let a=p[t];return jsxRuntime.jsx("span",{className:chunkE64TU6IU_js.a("inline-block px-3 py-1 rounded-full text-sm font-semibold",o,e),style:{backgroundColor:`${a.replace("rgb(","rgba(").replace(")",", 0.12)")}`,color:a,border:`1px solid ${a.replace("rgb(","rgba(").replace(")",", 0.3)")}`},role:"status","aria-live":"polite",children:m[t]})},h=({moduleKey:t,module:o,classNames:e,unstyled:a})=>{var b;let r=o.score>=90?"excellent":o.score>=70?"good":o.score>=40?"needs-work":"critical",i=p[r];Math.round(o.score/100*(o.gaps.length+Math.round(o.score/100*5)));let u=o.gaps.length,g=(b=x[t])!=null?b:t;return jsxRuntime.jsxs("div",{className:chunkE64TU6IU_js.a("rounded-lg border p-4 flex flex-col gap-2",e==null?void 0:e.moduleCard,a),style:{borderColor:`${i.replace("rgb(","rgba(").replace(")",", 0.25)")}`,backgroundColor:`${i.replace("rgb(","rgba(").replace(")",", 0.04)")}`},children:[jsxRuntime.jsxs("div",{className:"flex items-center justify-between",children:[jsxRuntime.jsx("span",{className:chunkE64TU6IU_js.a("text-sm font-semibold truncate",e==null?void 0:e.moduleTitle,a),children:g}),jsxRuntime.jsx("span",{className:chunkE64TU6IU_js.a("text-lg font-bold tabular-nums",e==null?void 0:e.moduleScore,a),style:{color:i},role:"status","aria-label":`${g} score: ${o.score}`,children:o.score})]}),jsxRuntime.jsx("div",{className:"h-1.5 rounded-full overflow-hidden",style:{backgroundColor:"rgba(0,0,0,0.08)"},role:"progressbar","aria-valuenow":o.score,"aria-valuemin":0,"aria-valuemax":100,"aria-label":`${g} compliance score: ${o.score}%`,children:jsxRuntime.jsx("div",{className:"h-full rounded-full transition-all",style:{width:`${o.score}%`,backgroundColor:i}})}),u>0&&jsxRuntime.jsxs("p",{className:chunkE64TU6IU_js.a("text-xs text-gray-500 dark:text-gray-400",e==null?void 0:e.moduleGaps,a),children:[u," gap",u!==1?"s":""," to address"]})]})},R=({rec:t,classNames:o,unstyled:e})=>{var i,c;let r=(i={critical:p.critical,high:p["needs-work"],medium:p.good,low:p.excellent}[t.priority])!=null?i:p.good;return jsxRuntime.jsxs("div",{"data-testid":"recommendation-item",className:chunkE64TU6IU_js.a("flex gap-3 p-3 rounded-lg border border-gray-100 dark:border-gray-700 bg-white dark:bg-gray-800",o==null?void 0:o.recommendationItem,e),children:[jsxRuntime.jsx("span",{className:chunkE64TU6IU_js.a("mt-0.5 shrink-0 inline-block px-2 py-0.5 rounded text-xs font-bold uppercase tracking-wide",o==null?void 0:o.recommendationPriority,e),style:{backgroundColor:`${r.replace("rgb(","rgba(").replace(")",", 0.12)")}`,color:r},children:(c=f[t.priority])!=null?c:t.priority}),jsxRuntime.jsxs("div",{className:"min-w-0 flex-1",children:[jsxRuntime.jsx("p",{className:chunkE64TU6IU_js.a("text-sm font-medium text-gray-900 dark:text-gray-100",o==null?void 0:o.recommendationTitle,e),children:t.label}),jsxRuntime.jsx("p",{className:"mt-0.5 text-xs text-gray-500 dark:text-gray-400 leading-relaxed",children:t.recommendation}),jsxRuntime.jsxs("p",{className:"mt-1 text-xs text-gray-400 dark:text-gray-500",children:[t.ndpaSection," \u2022 Effort: ",t.effort]})]})]})},k=({report:t,title:o="NDPA Compliance Dashboard",showRecommendations:e=true,maxRecommendations:a=5,classNames:r,unstyled:i=false})=>{let c=t.recommendations.slice(0,a),u=Object.entries(t.modules);return jsxRuntime.jsxs("div",{"data-ndpr-component":"compliance-dashboard",className:chunkE64TU6IU_js.a("w-full rounded-xl border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-900 shadow-sm p-6 flex flex-col gap-8",r==null?void 0:r.root,i),children:[jsxRuntime.jsxs("div",{className:chunkE64TU6IU_js.a("flex flex-col sm:flex-row items-start sm:items-center gap-6",r==null?void 0:r.header,i),children:[jsxRuntime.jsx(C,{score:t.score,rating:t.rating,classNames:{scoreCircle:r==null?void 0:r.scoreCircle,scoreValue:r==null?void 0:r.scoreValue},unstyled:i}),jsxRuntime.jsxs("div",{className:"flex flex-col gap-2",children:[jsxRuntime.jsx("h2",{className:"text-xl font-bold text-gray-900 dark:text-gray-100 leading-tight",children:o}),jsxRuntime.jsx(y,{rating:t.rating,className:r==null?void 0:r.ratingBadge,unstyled:i}),jsxRuntime.jsxs("p",{className:"text-sm text-gray-500 dark:text-gray-400",children:["Generated on"," ",new Date(t.generatedAt).toLocaleDateString(void 0,{year:"numeric",month:"long",day:"numeric"})]})]})]}),jsxRuntime.jsx("div",{className:chunkE64TU6IU_js.a("grid grid-cols-2 sm:grid-cols-2 md:grid-cols-4 gap-3",r==null?void 0:r.modulesGrid,i),children:u.map(([g,b])=>jsxRuntime.jsx(h,{moduleKey:g,module:b,classNames:{moduleCard:r==null?void 0:r.moduleCard,moduleTitle:r==null?void 0:r.moduleTitle,moduleScore:r==null?void 0:r.moduleScore,moduleGaps:r==null?void 0:r.moduleGaps},unstyled:i},g))}),e&&c.length>0&&jsxRuntime.jsxs("div",{className:chunkE64TU6IU_js.a("flex flex-col gap-3",r==null?void 0:r.recommendationsSection,i),children:[jsxRuntime.jsx("h3",{className:"text-base font-semibold text-gray-900 dark:text-gray-100",children:"Recommendations"}),c.map(g=>jsxRuntime.jsx(R,{rec:g,classNames:{recommendationItem:r==null?void 0:r.recommendationItem,recommendationPriority:r==null?void 0:r.recommendationPriority,recommendationTitle:r==null?void 0:r.recommendationTitle},unstyled:i},`${g.module}-${g.key}`))]})]})};exports.a=k;//# sourceMappingURL=chunk-25OOUES4.js.map
-//# sourceMappingURL=chunk-25OOUES4.js.map

package/dist/chunk-4JKTIR33.mjs

@@ -1,2 +0,0 @@
-import {a as a$1}from'./chunk-AYKLAEOU.mjs';import {a,b}from'./chunk-WWT2ZSNU.mjs';import {useState,useRef,useEffect,useCallback}from'react';import {createPortal}from'react-dom';import {jsx,jsxs}from'react/jsx-runtime';var yt=({options:d,onSave:U,title:Q="We Value Your Privacy",description:X="We use cookies and similar technologies to provide our services and enhance your experience. Your consent is collected in accordance with NDPA Sections 25-26.",acceptAllButtonText:Z="Accept All",rejectAllButtonText:s="Reject All",customizeButtonText:N="Customize",saveButtonText:tt="Save Preferences",position:L="bottom",zIndex:q=9999,version:a$2="1.0",show:x,manageStorage:z=true,storageKey:D="ndpr_consent",className:et="",buttonClassName:B="",primaryButtonClassName:H="",secondaryButtonClassName:nt="",classNames:t,unstyled:o,onAnalytics:k})=>{let[u,c]=useState(false),[g,m]=useState(false),[w,E]=useState({}),[F,rt]=useState(false),f=useRef(null),T=useRef(null),$=useRef(false);useEffect(()=>{rt(true);},[]);let b$1=useCallback((e,n)=>{k==null||k(a({action:e,timestamp:Date.now(),version:a$2},n!==void 0?{categories:n}:{}));},[k,a$2]);useEffect(()=>{let e={};if(d.forEach(n=>{e[n.id]=n.defaultValue||false;}),E(e),x===void 0)if(!z)c(true);else {let n=localStorage.getItem(D);if(n)try{JSON.parse(n).version!==a$2?c(!0):c(!1);}catch(C){c(true);}else c(true);}else c(x);},[d,D,a$2,z]),useEffect(()=>{x!==void 0&&c(x);},[x]);let ot=()=>{let e={};d.forEach(n=>{e[n.id]=true;}),b$1("accepted_all",e),j(e);},M=()=>{let e={};d.forEach(n=>{e[n.id]=n.required||false;}),b$1("rejected_all",e),j(e);},it=(e,n)=>{E(C=>b(a({},C),{[e]:n}));},dt=()=>{let e={};d.forEach(n=>{e[n.id]=true;}),E(e);},ut=()=>{let e={};d.forEach(n=>{e[n.id]=n.required||false;}),E(e);},_=d.length>0&&d.every(e=>w[e.id]),ct=()=>{b$1("customized",w),j(w);},j=e=>{let n={consents:e,timestamp:Date.now(),version:a$2,method:g?"customize":"banner",hasInteracted:true};z&&localStorage.setItem(D,JSON.stringify(n)),U(n),c(false),m(false);};if(useEffect(()=>{if(!u)return;let e=n=>{n.key==="Escape"&&(b$1("dismissed"),M());};return document.addEventListener("keydown",e),()=>document.removeEventListener("keydown",e)},[u,b$1,d,g]),useEffect(()=>{u&&!$.current&&($.current=true,b$1("shown")),u||($.current=false);},[u,b$1]),useEffect(()=>{if(!u||!f.current)return;let e='a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])',C=setTimeout(()=>{if(!f.current)return;let p=f.current.querySelectorAll(e);p.length>0?p[0].focus():f.current.focus();},0),G=p=>{if(p.key!=="Tab"||!f.current)return;let A=f.current.querySelectorAll(e);if(A.length===0)return;let V=A[0],J=A[A.length-1];p.shiftKey?document.activeElement===V&&(p.preventDefault(),J.focus()):document.activeElement===J&&(p.preventDefault(),V.focus());};return document.addEventListener("keydown",G),()=>{clearTimeout(C),document.removeEventListener("keydown",G);}},[u,g]),useEffect(()=>{if(g&&T.current){let e=T.current;e.style.maxHeight="0px",e.style.opacity="0",e.offsetHeight,e.style.maxHeight=`${e.scrollHeight}px`,e.style.opacity="1";}},[g]),!u)return null;let lt=(t==null?void 0:t.primaryButton)||(t==null?void 0:t.acceptButton)||`px-4 py-2 bg-[rgb(var(--ndpr-primary))] text-[rgb(var(--ndpr-primary-foreground))] rounded hover:bg-[rgb(var(--ndpr-primary-hover))] ${B} ${H}`,K=(t==null?void 0:t.secondaryButton)||(t==null?void 0:t.rejectButton)||`px-4 py-2 bg-gray-200 text-gray-800 dark:bg-gray-700 dark:text-white rounded hover:bg-gray-300 dark:hover:bg-gray-600 ${B} ${nt}`,gt=(t==null?void 0:t.customizeButton)||`px-4 py-2 bg-transparent text-gray-800 dark:text-white hover:underline ${B}`,ft=(t==null?void 0:t.saveButton)||`px-4 py-2 bg-[rgb(var(--ndpr-primary))] text-[rgb(var(--ndpr-primary-foreground))] rounded hover:bg-[rgb(var(--ndpr-primary-hover))] ${B} ${H}`,S=L==="inline",y=L==="center",h;S||y?h="":L==="top"?h="fixed inset-x-0 top-0":h="fixed inset-x-0 bottom-0";let P=jsx("div",{ref:f,tabIndex:-1,"data-ndpr-component":"consent-banner",className:a$1(`${S?"":h} bg-white dark:bg-gray-800 shadow-lg p-3 sm:p-4 border border-gray-200 dark:border-gray-700 ${y?"max-w-lg w-full":""} ${et}`,t==null?void 0:t.root,o),style:!S&&!y?{zIndex:q}:void 0,role:"dialog","aria-modal":y||void 0,"aria-labelledby":"consent-banner-title","aria-describedby":"consent-banner-description",children:jsxs("div",{className:a$1("max-w-6xl mx-auto",t==null?void 0:t.container,o),children:[jsx("h2",{id:"consent-banner-title",className:a$1("text-lg font-bold mb-2",t==null?void 0:t.title,o),children:Q}),jsx("p",{id:"consent-banner-description",className:a$1("text-sm sm:text-base mb-4",t==null?void 0:t.description,o),children:X}),g&&jsxs("div",{ref:T,className:a$1("mb-4 p-3 sm:p-4 rounded-md border border-gray-200 dark:border-gray-600 bg-gray-50 dark:bg-gray-700/50",t==null?void 0:t.customizePanel,o),style:{overflow:"hidden",transition:"max-height 0.3s ease-out, opacity 0.3s ease-out"},children:[jsx("div",{className:"mb-3 flex items-center justify-end",children:jsx("button",{type:"button",onClick:_?ut:dt,className:a$1("text-sm font-medium text-[rgb(var(--ndpr-primary))] hover:underline",t==null?void 0:t.selectAllButton,o),children:_?"Deselect All":"Select All"})}),jsx("div",{className:a$1("space-y-3",t==null?void 0:t.optionsList,o),children:d.map(e=>jsxs("div",{className:a$1("flex items-start",t==null?void 0:t.optionItem,o),children:[jsx("div",{className:"flex items-center h-5",children:jsx("input",{id:`consent-${e.id}`,type:"checkbox",checked:w[e.id]||false,onChange:n=>it(e.id,n.target.checked),disabled:e.required,className:a$1("h-4 w-4 rounded border-gray-300 text-[rgb(var(--ndpr-primary))] focus:ring-[rgb(var(--ndpr-ring))]",t==null?void 0:t.optionCheckbox,o)})}),jsxs("div",{className:"ml-3 text-sm",children:[jsxs("label",{htmlFor:`consent-${e.id}`,className:a$1("font-medium",t==null?void 0:t.optionLabel,o),children:[e.label," ",e.required&&jsx("span",{className:"text-red-500",children:"*"})]}),jsx("p",{className:a$1("text-gray-600 dark:text-gray-400",t==null?void 0:t.optionDescription,o),children:e.description})]})]},e.id))}),jsxs("div",{className:a$1("mt-4 flex flex-col sm:flex-row flex-wrap gap-2",t==null?void 0:t.buttonGroup,o),children:[jsx("button",{onClick:ct,className:a$1(ft,t==null?void 0:t.saveButton,o),children:tt}),jsx("button",{onClick:()=>m(false),className:a$1(K,t==null?void 0:t.rejectButton,o),children:"Back"})]})]}),!g&&jsxs("div",{className:a$1("flex flex-col sm:flex-row flex-wrap gap-2",t==null?void 0:t.buttonGroup,o),children:[jsx("button",{onClick:ot,className:a$1(lt,t==null?void 0:t.acceptButton,o),children:Z}),jsx("button",{onClick:M,className:a$1(K,t==null?void 0:t.rejectButton,o),children:s}),jsx("button",{onClick:()=>m(true),className:a$1(gt,t==null?void 0:t.customizeButton,o),children:N})]}),jsx("div",{className:a$1("mt-2 text-xs text-gray-600 dark:text-gray-400",void 0,o),children:'By clicking "Accept All", you agree to the use of ALL cookies. Visit our Cookie Policy to learn more.'})]})});if(S)return P;if(y){let e=jsxs("div",{className:"fixed inset-0 flex items-center justify-center",style:{zIndex:q},children:[jsx("div",{className:"absolute inset-0 bg-black/50","aria-hidden":"true"}),jsx("div",{className:"relative",children:P})]});return F?createPortal(e,document.body):null}return F?createPortal(P,document.body):null};export{yt as a};//# sourceMappingURL=chunk-4JKTIR33.mjs.map
-//# sourceMappingURL=chunk-4JKTIR33.mjs.map