@tantainnovative/ndpr-toolkit 3.5.0 → 3.5.5

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { ErrorInfo } from 'react';
 import React__default from 'react';
 import { ReactNode } from 'react';
+import { RefObject } from 'react';
 
 /**
  * Adequacy status of a destination country
@@ -101,6 +102,44 @@ export declare interface BreachFormSubmission {
     dataTypes: string[];
     /** Estimated number of affected data subjects */
     estimatedAffectedSubjects?: number;
+    /**
+     * Approximate number of personal data RECORDS concerned. Distinct from
+     * subject count (one subject may have many records). NDPA Section 40(2).
+     */
+    approximateRecordCount?: number;
+    /**
+     * Categories of data subjects affected (e.g. customers, employees, minors).
+     * NDPA Section 40(2).
+     */
+    dataSubjectCategories?: string[];
+    /** Whether sensitive personal data (NDPA Section 30) is involved */
+    involvesSensitiveData?: boolean;
+    /**
+     * Likely consequences of the breach for affected data subjects.
+     * Required content for the NDPC report and Section 40(3) communications.
+     */
+    likelyConsequences?: string;
+    /**
+     * Measures taken or proposed to mitigate adverse effects.
+     * NDPA Section 40(3).
+     */
+    mitigationMeasures?: string;
+    /**
+     * Data Protection Officer contact details (Section 32(3)(c) — DPO is the
+     * named NDPC contact). Falls back to organisation-level DPO if omitted.
+     */
+    dpoContact?: {
+        name: string;
+        email: string;
+        phone?: string;
+    };
+    /**
+     * Whether this is a phased / interim report submitted under Section 40(2)
+     * before complete information is available.
+     */
+    isPhasedReport?: boolean;
+    /** ID of the prior phased report this report supplements, if any. */
+    supplementsReportId?: string;
     /** Current status of the breach */
     status: 'ongoing' | 'contained' | 'resolved';
     /** Initial actions taken to address the breach */
@@ -230,10 +269,51 @@ export declare interface BreachReport {
     affectedSystems: string[];
     /** Types of data involved in the breach */
     dataTypes: string[];
-    /** Whether sensitive personal data is involved (NDPA Section 27) */
+    /** Whether sensitive personal data is involved (NDPA Section 30) */
     involvesSensitiveData?: boolean;
     /** Estimated number of data subjects affected */
     estimatedAffectedSubjects?: number;
+    /**
+     * Approximate number of personal data RECORDS concerned (distinct from subject count).
+     * Required content under NDPA Section 40(1)(a) and Section 40(2).
+     */
+    approximateRecordCount?: number;
+    /**
+     * Categories of data subjects affected (e.g. customers, employees, minors, patients).
+     * Required content under NDPA Section 40(1)(a) and Section 40(2).
+     */
+    dataSubjectCategories?: string[];
+    /**
+     * Likely consequences of the breach for affected data subjects (e.g. identity theft,
+     * financial loss, reputational damage). Reported to the NDPC and, where applicable,
+     * communicated to data subjects under Section 40(3).
+     */
+    likelyConsequences?: string;
+    /**
+     * Measures taken or proposed to mitigate adverse effects of the breach.
+     * Required content for Section 40(3) communications to data subjects.
+     */
+    mitigationMeasures?: string;
+    /**
+     * Whether this is a phased / interim report submitted before full investigation
+     * is complete. The NDPC permits phased reporting where complete information is
+     * not available within 72 hours.
+     */
+    isPhasedReport?: boolean;
+    /**
+     * ID of the prior phased report this report supplements, if any.
+     */
+    supplementsReportId?: string;
+    /**
+     * Data Protection Officer contact details. The DPO is the named contact point
+     * for the NDPC per NDPA Section 32(3)(c). Required content in the regulatory
+     * report (Section 40(2)).
+     */
+    dpoContact?: {
+        name: string;
+        email: string;
+        phone?: string;
+    };
     /** Whether the breach is ongoing or contained */
     status: 'ongoing' | 'contained' | 'resolved';
     /** Initial actions taken to address the breach */
@@ -452,6 +532,26 @@ export declare function calculateBreachSeverity(report: BreachReport, assessment
     justification: string;
 };
 
+/** A single gap found during NDPA compliance evaluation. */
+declare interface ComplianceGap {
+    /** Machine-readable requirement identifier. */
+    requirementId: string;
+    /** Human-readable name of the requirement. */
+    requirement: string;
+    /** Reference to the relevant NDPA section. */
+    ndpaSection: string;
+    /** How severe the gap is. */
+    severity: 'critical' | 'important' | 'recommended';
+    /** Explanation of what is missing. */
+    message: string;
+    /** Suggested fix type for the UI. */
+    fixType: 'add_section' | 'add_content' | 'fill_field';
+    /** Label for the fix action button. */
+    fixLabel: string;
+    /** Pre-written content the user can insert to close the gap. */
+    suggestedContent?: string;
+}
+
 export declare interface ComplianceInput {
     consent: {
         hasConsentMechanism: boolean;
@@ -531,6 +631,22 @@ export declare interface ComplianceReport {
     generatedAt: string;
 }
 
+/** Result of evaluating a policy against NDPA requirements. */
+declare interface ComplianceResult {
+    /** Points earned. */
+    score: number;
+    /** Maximum achievable points (115). */
+    maxScore: number;
+    /** Percentage score (0-100). */
+    percentage: number;
+    /** Overall compliance rating. */
+    rating: 'compliant' | 'nearly_compliant' | 'not_compliant';
+    /** List of identified compliance gaps. */
+    gaps: ComplianceGap[];
+    /** List of requirement ids that passed. */
+    passed: string[];
+}
+
 export declare interface ConsentAnalyticsEvent {
     action: 'shown' | 'accepted_all' | 'rejected_all' | 'customized' | 'dismissed';
     timestamp: number;
@@ -1153,6 +1269,29 @@ declare interface CrossBorderTransferManagerProps {
     unstyled?: boolean;
 }
 
+/** A user-defined section added to the policy outside the generated ones. */
+declare interface CustomSection {
+    id: string;
+    title: string;
+    content: string;
+    order: number;
+    required: false;
+}
+
+/** A logical category of personal data the organisation may collect. */
+declare interface DataCategory {
+    /** Machine-readable identifier. */
+    id: string;
+    /** Human-readable label shown in the wizard. */
+    label: string;
+    /** Grouping for display and compliance checks. */
+    group: 'identity' | 'financial' | 'behavioral' | 'sensitive' | 'children';
+    /** Specific data points within this category. */
+    dataPoints: string[];
+    /** Whether this category is currently selected by the user. */
+    selected: boolean;
+}
+
 /**
  * Default NDPA-compliant privacy policy sections.
  * Each section uses {{variable}} placeholders that are resolved at generation time.
@@ -1165,11 +1304,17 @@ export declare const DEFAULT_POLICY_SECTIONS: PolicySection[];
  */
 export declare const DEFAULT_POLICY_VARIABLES: PolicyVariable[];
 
+/** Options for DOCX export of the finalised policy. */
+declare interface DOCXExportOptions {
+    includeTOC?: boolean;
+    filename?: string;
+}
+
 /** A map of question IDs to their answer values */
-declare type DPIAAnswerMap = Record<string, DPIAAnswerValue>;
+export declare type DPIAAnswerMap = Record<string, DPIAAnswerValue>;
 
 /** Possible value types for a DPIA answer */
-declare type DPIAAnswerValue = string | number | boolean | string[];
+export declare type DPIAAnswerValue = string | number | boolean | string[];
 
 /**
  * Data Protection Impact Assessment types aligned with NDPA 2023 Sections 38-39
@@ -1214,8 +1359,8 @@ export declare interface DPIAQuestion {
 }
 
 /**
- * DPIA questionnaire component. Implements NDPA Section 38 requirements
- * for conducting Data Protection Impact Assessments on high-risk processing activities.
+ * DPIA questionnaire component. Implements NDPA Section 28 requirements
+ * for conducting Data Privacy Impact Assessments on high-risk processing activities.
  */
 export declare const DPIAQuestionnaire: React__default.FC<DPIAQuestionnaireProps>;
 
@@ -1685,7 +1830,7 @@ export declare interface DSRRequest {
 }
 
 /**
- * Data Subject Request form component. Implements NDPA Part IV, Sections 29-36
+ * Data Subject Request form component. Implements NDPA Part VI (Sections 34-38)
  * covering data subject rights including access, rectification, erasure, and portability.
  */
 export declare const DSRRequestForm: React__default.FC<DSRRequestFormProps>;
@@ -1896,20 +2041,25 @@ declare interface DSRTrackerProps {
 }
 
 /**
- * Data Subject Rights types aligned with NDPA 2023 Part IV (Sections 29-36)
+ * Data Subject Rights types aligned with NDPA 2023 Part VI (Sections 34-38)
+ * and the related provisions in Part V (Section 27 — information to the data subject)
+ * and Part X (Section 46 — complaint to the Commission).
+ *
+ * Note: These are guidance labels — not legal advice. Verify with your DPO or counsel.
  */
 /**
- * Types of data subject requests per NDPA Part IV
- * - 'information': Right to be informed (Section 29)
- * - 'access': Right of access (Section 30)
- * - 'rectification': Right to rectification (Section 31)
- * - 'erasure': Right to erasure (Section 32)
- * - 'restriction': Right to restrict processing (Section 33)
- * - 'portability': Right to data portability (Section 34)
- * - 'objection': Right to object (Section 35)
- * - 'automated_decision_making': Rights related to automated decision-making (Section 36)
+ * Types of data subject requests per NDPA Part VI
+ * - 'information': Right to be informed (Section 27 — provision of information; Section 34(1)(a))
+ * - 'access': Right of access / confirmation + data copy (Section 34(1)(a)–(b))
+ * - 'rectification': Right to rectification (Section 34(1)(c))
+ * - 'erasure': Right to erasure (Section 34(1)(d), Section 34(2))
+ * - 'restriction': Right to restrict processing (Section 34(1)(e))
+ * - 'portability': Right to data portability (Section 38)
+ * - 'objection': Right to object (Section 36)
+ * - 'automated_decision_making': Rights re. automated decisions / profiling (Section 37)
+ * - 'withdraw_consent': Right to withdraw consent (Section 35)
  */
-export declare type DSRType = 'information' | 'access' | 'rectification' | 'erasure' | 'restriction' | 'portability' | 'objection' | 'automated_decision_making';
+export declare type DSRType = 'information' | 'access' | 'rectification' | 'erasure' | 'restriction' | 'portability' | 'objection' | 'automated_decision_making' | 'withdraw_consent';
 
 export declare type EffortLevel = 'low' | 'medium' | 'high';
 
@@ -1995,6 +2145,33 @@ export declare function getLawfulBasisDescription(basis: LawfulBasis): string;
  */
 export declare function getTransferMechanismDescription(mechanism: TransferMechanism): string;
 
+/** Options for HTML export of the finalised policy. */
+declare interface HTMLExportOptions {
+    includeStyles?: boolean;
+    includePrintCSS?: boolean;
+    customCSS?: string;
+    /**
+     * Theme controlling the embedded design tokens.
+     *
+     * - `'light'` (default): emits the light token palette only. No
+     *   `prefers-color-scheme: dark` block is included, so a visitor's OS
+     *   dark-mode setting will NOT recolour the policy. This is the right
+     *   default for an embedded compliance widget — most consumer host sites
+     *   are single-theme and Shadow DOM does not isolate `prefers-color-scheme`.
+     * - `'dark'`: emits the dark token palette as the primary style.
+     * - `'auto'`: emits light tokens plus a `@media (prefers-color-scheme: dark)`
+     *   block that swaps to dark on the user's OS preference. Use this when
+     *   your host site genuinely follows OS dark mode and you want the policy
+     *   to match.
+     *
+     * Pre-3.4.1 the export effectively behaved like `'auto'` unconditionally,
+     * which leaked dark colours into light-only host sites via Shadow DOM.
+     *
+     * @default 'light'
+     */
+    theme?: 'light' | 'dark' | 'auto';
+}
+
 /**
  * Identifies compliance gaps in the Record of Processing Activities.
  * Finds records that are missing required information per NDPA 2023.
@@ -2004,13 +2181,24 @@ export declare function getTransferMechanismDescription(mechanism: TransferMecha
  */
 export declare function identifyComplianceGaps(ropa: RecordOfProcessingActivities): ROPAComplianceGap[];
 
+/**
+ * Policy engine types for the adaptive privacy policy generator.
+ * These types power the wizard-driven policy builder, compliance checker,
+ * and export functionality — all aligned with the NDPA 2023.
+ */
+
+/** Industry verticals with sector-specific compliance requirements. */
+declare type Industry = 'fintech' | 'healthcare' | 'ecommerce' | 'saas' | 'education' | 'government' | 'other';
+
 /**
  * Returns whether NDPC approval is required for a given transfer mechanism.
- * Approval is required for standard contractual clauses (Section 42),
- * binding corporate rules (Section 43), and specific NDPC authorization (Section 44).
+ * Under NDPA Section 42(5), the Commission may approve binding corporate rules,
+ * codes of conduct, certification mechanisms, or similar instruments. Standard
+ * contractual clauses are one of the appropriate safeguards under Section 41(1)(a)
+ * and the Commission may approve them per Section 42(4).
  *
  * @param mechanism The transfer mechanism
- * @returns Whether NDPC approval is required
+ * @returns Whether NDPC approval is typically required
  */
 export declare function isNDPCApprovalRequired(mechanism: TransferMechanism): boolean;
 
@@ -2151,6 +2339,43 @@ export declare interface LawfulBasisValidationResult {
     warnings: string[];
 }
 
+/**
+ * Full disclaimer suitable for PDF/DOCX footers and exported artifacts.
+ */
+export declare const LEGAL_DISCLAIMER_LONG: string;
+
+/**
+ * Short disclaimer suitable for component captions and dashboard footers.
+ * One line, no markdown.
+ */
+export declare const LEGAL_DISCLAIMER_SHORT = "Generated for guidance only. Not legal advice \u2014 verify with your DPO or counsel.";
+
+/**
+ * Returns the long disclaimer wrapped with a leading heading suitable for
+ * embedding at the foot of an exported document.
+ */
+export declare function legalDisclaimerBlock(heading?: string): string;
+
+/**
+ * Renders the standard "not legal advice" notice produced by this toolkit.
+ * Use under any component that surfaces an NDPA section citation or generates
+ * an artifact (privacy policy, breach report, DPIA result, etc.).
+ */
+export declare const LegalNotice: React__default.FC<LegalNoticeProps>;
+
+export declare interface LegalNoticeProps {
+    /**
+     * Disclaimer length. `short` is a one-liner appropriate for captions and
+     * footers; `long` is the full notice for export documents and dialogs.
+     * @default 'short'
+     */
+    variant?: 'short' | 'long';
+    /** Custom className for the wrapping element */
+    className?: string;
+    /** When true, renders nothing (escape hatch for unstyled mode) */
+    hidden?: boolean;
+}
+
 /**
  * Represents a Legitimate Interest Assessment (LIA)
  * Required when the lawful basis is 'legitimate_interests'
@@ -2463,6 +2688,38 @@ declare interface OrganizationInfo_2 {
     dpoPhone?: string;
 }
 
+/** Organisation size tiers — affects complexity of generated language. */
+declare type OrgSize = 'startup' | 'midsize' | 'enterprise';
+
+/** Options for PDF export of the finalised policy. */
+declare interface PDFExportOptions {
+    includeCoverPage?: boolean;
+    includeTOC?: boolean;
+    includeComplianceBadge?: boolean;
+    logoUrl?: string;
+    filename?: string;
+}
+
+/** Represents an in-progress policy being built in the wizard. */
+declare interface PolicyDraft {
+    /** Unique identifier for the draft. */
+    id: string;
+    /** The template context driving section generation. */
+    templateContext: TemplateContext;
+    /** Custom sections added by the user. */
+    customSections: CustomSection[];
+    /** Per-section content overrides keyed by section id. */
+    sectionOverrides: Record<string, string>;
+    /** Ordered list of section ids defining the final order. */
+    sectionOrder: string[];
+    /** Current wizard step (0-indexed). */
+    currentStep: number;
+    /** Timestamp of the last save. */
+    lastSavedAt: number;
+    /** The draft is always in "draft" status until finalised. */
+    status: 'draft';
+}
+
 export declare const PolicyExporter: React__default.FC<PolicyExporterProps>;
 
 export declare interface PolicyExporterClassNames {
@@ -2922,6 +3179,9 @@ export declare interface ProcessingActivity {
     };
 }
 
+/** Lawful processing purposes recognised under the NDPA. */
+declare type ProcessingPurpose = 'service_delivery' | 'marketing' | 'analytics' | 'research' | 'legal_compliance' | 'fraud_prevention';
+
 /**
  * Record of Processing Activities (ROPA) types aligned with NDPA 2023
  * Data controllers must maintain comprehensive records of all processing activities
@@ -3222,7 +3482,9 @@ export declare interface RequestType {
     /** Description of what this request type entails */
     description: string;
     /**
-     * NDPA section reference (e.g., "Section 30" for access requests)
+     * NDPA 2023 section reference for this right
+     * (e.g., "Section 34(1)(a)" for access, "Section 38" for portability).
+     * Used for display purposes only — verify the exact subsection with counsel.
      */
     ndpaSection?: string;
     /**
@@ -3527,6 +3789,42 @@ declare interface StorageAdapter<T = unknown> {
     remove(): void | Promise<void>;
 }
 
+/** Full context used to generate an adaptive privacy policy. */
+declare interface TemplateContext {
+    /** Organisation details, extended with industry and size. */
+    org: OrganizationInfo & {
+        industry: Industry;
+        orgSize: OrgSize;
+        country: string;
+    };
+    /** Data categories the organisation collects. */
+    dataCategories: DataCategory[];
+    /** Processing purposes relevant to the organisation. */
+    purposes: ProcessingPurpose[];
+    /** Whether the organisation processes children's data. */
+    hasChildrenData: boolean;
+    /** Whether the organisation processes sensitive/special-category data. */
+    hasSensitiveData: boolean;
+    /** Whether the organisation processes financial data. */
+    hasFinancialData: boolean;
+    /** Whether data is transferred outside Nigeria. */
+    hasCrossBorderTransfer: boolean;
+    /** Whether automated decision-making or profiling is used. */
+    hasAutomatedDecisions: boolean;
+    /** Third-party processors that receive personal data. */
+    thirdPartyProcessors: ThirdPartyProcessor[];
+}
+
+/** A third-party entity that processes data on behalf of the organisation. */
+declare interface ThirdPartyProcessor {
+    /** Name of the third party. */
+    name: string;
+    /** Purpose of sharing data with this processor. */
+    purpose: string;
+    /** Country where the processor is located. */
+    country: string;
+}
+
 /**
  * Transfer Impact Assessment (TIA) for cross-border transfers
  */
@@ -3570,8 +3868,11 @@ export declare interface TransferImpactAssessment {
 }
 
 /**
- * Cross-Border Data Transfer types aligned with NDPA 2023 Part VI (Sections 41-45)
- * Personal data may only be transferred outside Nigeria under specific conditions
+ * Cross-Border Data Transfer types aligned with NDPA 2023 Part VIII (Sections 41-43).
+ * Personal data may only be transferred outside Nigeria under the bases listed in
+ * Section 41(1), where Section 42 defines adequacy and Section 43 lists derogations.
+ *
+ * Note: These are guidance labels — not legal advice. Verify with your DPO or counsel.
  */
 /**
  * Transfer mechanisms recognized under the NDPA
@@ -3597,6 +3898,55 @@ export declare interface TransferValidationResult {
     warnings: string[];
 }
 
+export declare function useAdaptivePolicyWizard(options?: UseAdaptivePolicyWizardOptions): UseAdaptivePolicyWizardReturn;
+
+export declare interface UseAdaptivePolicyWizardOptions {
+    adapter?: StorageAdapter<PolicyDraft>;
+    onComplete?: (policy: PrivacyPolicy) => void;
+    onComplianceChange?: (score: number, gaps: ComplianceGap[]) => void;
+}
+
+export declare interface UseAdaptivePolicyWizardReturn {
+    currentStep: number;
+    goToStep: (step: number) => void;
+    nextStep: () => void;
+    prevStep: () => void;
+    canProceed: boolean;
+    context: TemplateContext;
+    updateContext: (updates: Partial<TemplateContext>) => void;
+    updateOrg: (updates: Partial<TemplateContext['org']>) => void;
+    toggleDataCategory: (categoryId: string) => void;
+    togglePurpose: (purpose: string) => void;
+    addProcessor: (processor: {
+        name: string;
+        purpose: string;
+        country: string;
+    }) => void;
+    removeProcessor: (index: number) => void;
+    policy: PrivacyPolicy | null;
+    sections: PolicySection[];
+    customSections: CustomSection[];
+    addCustomSection: (section: Omit<CustomSection, 'id' | 'required'>) => void;
+    updateCustomSection: (id: string, updates: Partial<CustomSection>) => void;
+    removeCustomSection: (id: string) => void;
+    reorderSections: (sectionId: string, direction: 'up' | 'down') => void;
+    editSectionContent: (sectionId: string, content: string) => void;
+    sectionOverrides: Record<string, string>;
+    complianceScore: number;
+    complianceResult: ComplianceResult;
+    complianceGaps: ComplianceGap[];
+    applyFix: (gapId: string) => void;
+    handleExportPDF: (options?: PDFExportOptions) => Promise<Blob>;
+    handleExportDOCX: (options?: DOCXExportOptions) => Promise<Blob>;
+    handleExportHTML: (options?: HTMLExportOptions) => string;
+    handleExportMarkdown: () => string;
+    isDraftSaved: boolean;
+    lastSavedAt: number | null;
+    saveDraft: () => Promise<void>;
+    discardDraft: () => void;
+    isLoading: boolean;
+}
+
 /**
  * Hook for managing data breach notifications in compliance with the NDPA (Section 40)
  */
@@ -3705,6 +4055,12 @@ declare interface UseBreachReturn {
     isLoading: boolean;
 }
 
+export declare function useComplianceScore({ input }: UseComplianceScoreOptions): ComplianceReport;
+
+declare interface UseComplianceScoreOptions {
+    input: ComplianceInput;
+}
+
 /**
  * Hook for managing user consent in compliance with NDPA
  */
@@ -4073,9 +4429,10 @@ declare interface UseDSRReturn {
      */
     requests: DSRRequest[];
     /**
-     * Submit a new request
+     * Submit a new request. The hook assigns `id`, `status`, `createdAt`,
+     * `updatedAt`, and `dueDate` — pass everything else.
      */
-    submitRequest: (requestData: Omit<DSRRequest, 'id' | 'status' | 'submittedAt' | 'updatedAt' | 'estimatedCompletionDate'>) => DSRRequest;
+    submitRequest: (requestData: Omit<DSRRequest, 'id' | 'status' | 'createdAt' | 'updatedAt' | 'dueDate'>) => DSRRequest;
     /**
      * Update an existing request
      */
@@ -4087,7 +4444,12 @@ declare interface UseDSRReturn {
     /**
      * Get requests by status
      */
-    getRequestsByStatus: (status: RequestStatus) => DSRRequest[];
+    /**
+     * Filter requests by status. Accepts both the modern `DSRStatus` union and
+     * the deprecated `RequestStatus` for backward compatibility — pass the
+     * modern values (`'pending' | 'awaitingVerification' | 'inProgress' | ...`).
+     */
+    getRequestsByStatus: (status: DSRStatus | RequestStatus) => DSRRequest[];
     /**
      * Get requests by type
      */
@@ -4110,6 +4472,40 @@ declare interface UseDSRReturn {
     isLoading: boolean;
 }
 
+/**
+ * Trap keyboard focus inside a container while it is active, and restore
+ * focus to the element that was active before activation when the container
+ * deactivates. Centralises the trap/restore logic that was previously
+ * duplicated (and broken — no restore) inside ConsentBanner.
+ *
+ * @example
+ * ```tsx
+ * const ref = useFocusTrap<HTMLDivElement>({ active: isOpen, onEscape: close });
+ * return <div ref={ref}>...</div>;
+ * ```
+ */
+export declare function useFocusTrap<T extends HTMLElement = HTMLElement>(options: UseFocusTrapOptions): RefObject<T | null>;
+
+export declare interface UseFocusTrapOptions {
+    /**
+     * Whether the focus trap is active. When transitioning from false → true,
+     * the hook captures `document.activeElement` and moves focus into the
+     * container; when transitioning back to false, the captured element is
+     * re-focused (WCAG 2.4.3 — focus order).
+     */
+    active: boolean;
+    /**
+     * Optional callback fired on Escape keydown while the trap is active.
+     * Typical use is to close the surrounding dialog.
+     */
+    onEscape?: () => void;
+    /**
+     * If false, do not auto-focus the first interactive element inside the
+     * container on activation. Defaults to true.
+     */
+    autoFocus?: boolean;
+}
+
 /**
  * Hook for managing lawful basis documentation for processing activities
  * in compliance with NDPA 2023 Section 25.

package/dist/index.js

@@ -1,3 +1,2 @@
 "use client";
-'use strict';var chunkLWXZMKC2_js=require('./chunk-LWXZMKC2.js'),chunkHGGLW5TE_js=require('./chunk-HGGLW5TE.js'),chunkLSNL4XR5_js=require('./chunk-LSNL4XR5.js'),chunkNQNFS3QI_js=require('./chunk-NQNFS3QI.js'),chunkXNSZ7KUH_js=require('./chunk-XNSZ7KUH.js'),chunkRXL6CZAI_js=require('./chunk-RXL6CZAI.js');require('./chunk-C5QO3SX4.js');var chunkTV4U6AIS_js=require('./chunk-TV4U6AIS.js'),chunk7AVN424U_js=require('./chunk-7AVN424U.js'),chunkMCWV7S2G_js=require('./chunk-MCWV7S2G.js'),chunkM2TPT5GB_js=require('./chunk-M2TPT5GB.js'),chunkLIM64IV2_js=require('./chunk-LIM64IV2.js'),chunkS4GRSNB4_js=require('./chunk-S4GRSNB4.js');require('./chunk-CPK5D5FY.js');var chunkTDDAYVKK_js=require('./chunk-TDDAYVKK.js'),chunkC4YM4UMI_js=require('./chunk-C4YM4UMI.js'),chunkGOU6FU6Y_js=require('./chunk-GOU6FU6Y.js'),chunk3NQQSU4P_js=require('./chunk-3NQQSU4P.js'),chunkRLYTX3MM_js=require('./chunk-RLYTX3MM.js'),chunkXIM7KMD6_js=require('./chunk-XIM7KMD6.js'),chunkMJGOLP5M_js=require('./chunk-MJGOLP5M.js'),chunk7SMLHZ4B_js=require('./chunk-7SMLHZ4B.js');require('./chunk-A4PK7JB2.js');var chunkHO5M7M4M_js=require('./chunk-HO5M7M4M.js'),chunkVIQUXWJC_js=require('./chunk-VIQUXWJC.js'),chunkZPKVLTSX_js=require('./chunk-ZPKVLTSX.js'),chunkCKJAECGV_js=require('./chunk-CKJAECGV.js'),chunkJ5WCPZLW_js=require('./chunk-J5WCPZLW.js'),chunk3VQAYQR7_js=require('./chunk-3VQAYQR7.js'),chunk5HL4UBFV_js=require('./chunk-5HL4UBFV.js'),chunkOPYQIJKY_js=require('./chunk-OPYQIJKY.js'),chunkP42Z5CFE_js=require('./chunk-P42Z5CFE.js'),chunkSKKOMFXH_js=require('./chunk-SKKOMFXH.js'),chunkWTJGLNTB_js=require('./chunk-WTJGLNTB.js'),chunkI4M2AA3N_js=require('./chunk-I4M2AA3N.js'),chunkBKRETVJ6_js=require('./chunk-BKRETVJ6.js'),chunkI54CDQGN_js=require('./chunk-I54CDQGN.js'),chunkE64TU6IU_js=require('./chunk-E64TU6IU.js');require('./chunk-ELKB2AFZ.js'),require('./chunk-MQFZHA2D.js');Object.defineProperty(exports,"PolicyExporter",{enumerable:true,get:function(){return chunkLWXZMKC2_js.c}});Object.defineProperty(exports,"PolicyGenerator",{enumerable:true,get:function(){return chunkLWXZMKC2_js.a}});Object.defineProperty(exports,"PolicyPreview",{enumerable:true,get:function(){return chunkLWXZMKC2_js.b}});Object.defineProperty(exports,"NDPRDashboard",{enumerable:true,get:function(){return chunkHGGLW5TE_js.a}});Object.defineProperty(exports,"LawfulBasisTracker",{enumerable:true,get:function(){return chunkLSNL4XR5_js.a}});Object.defineProperty(exports,"CrossBorderTransferManager",{enumerable:true,get:function(){return chunkNQNFS3QI_js.a}});Object.defineProperty(exports,"ROPAManager",{enumerable:true,get:function(){return chunkXNSZ7KUH_js.a}});Object.defineProperty(exports,"NDPRProvider",{enumerable:true,get:function(){return chunkRXL6CZAI_js.a}});Object.defineProperty(exports,"useNDPRConfig",{enumerable:true,get:function(){return chunkRXL6CZAI_js.b}});Object.defineProperty(exports,"useDefaultPrivacyPolicy",{enumerable:true,get:function(){return chunkTV4U6AIS_js.b}});Object.defineProperty(exports,"usePrivacyPolicy",{enumerable:true,get:function(){return chunkTV4U6AIS_js.a}});Object.defineProperty(exports,"useLawfulBasis",{enumerable:true,get:function(){return chunk7AVN424U_js.a}});Object.defineProperty(exports,"useCrossBorderTransfer",{enumerable:true,get:function(){return chunkMCWV7S2G_js.a}});Object.defineProperty(exports,"useROPA",{enumerable:true,get:function(){return chunkM2TPT5GB_js.a}});Object.defineProperty(exports,"DEFAULT_POLICY_SECTIONS",{enumerable:true,get:function(){return chunkLIM64IV2_js.c}});Object.defineProperty(exports,"DEFAULT_POLICY_VARIABLES",{enumerable:true,get:function(){return chunkLIM64IV2_js.d}});Object.defineProperty(exports,"createBusinessPolicyTemplate",{enumerable:true,get:function(){return chunkLIM64IV2_js.e}});Object.defineProperty(exports,"generatePolicyText",{enumerable:true,get:function(){return chunkLIM64IV2_js.b}});Object.defineProperty(exports,"getComplianceScore",{enumerable:true,get:function(){return chunkS4GRSNB4_js.a}});Object.defineProperty(exports,"assessComplianceGaps",{enumerable:true,get:function(){return chunkTDDAYVKK_js.c}});Object.defineProperty(exports,"generateLawfulBasisSummary",{enumerable:true,get:function(){return chunkTDDAYVKK_js.d}});Object.defineProperty(exports,"getLawfulBasisDescription",{enumerable:true,get:function(){return chunkTDDAYVKK_js.b}});Object.defineProperty(exports,"validateProcessingActivity",{enumerable:true,get:function(){return chunkTDDAYVKK_js.a}});Object.defineProperty(exports,"assessTransferRisk",{enumerable:true,get:function(){return chunkC4YM4UMI_js.h}});Object.defineProperty(exports,"getTransferMechanismDescription",{enumerable:true,get:function(){return chunkC4YM4UMI_js.f}});Object.defineProperty(exports,"isNDPCApprovalRequired",{enumerable:true,get:function(){return chunkC4YM4UMI_js.e}});Object.defineProperty(exports,"validateTransfer",{enumerable:true,get:function(){return chunkC4YM4UMI_js.g}});Object.defineProperty(exports,"exportROPAToCSV",{enumerable:true,get:function(){return chunkGOU6FU6Y_js.c}});Object.defineProperty(exports,"generateROPASummary",{enumerable:true,get:function(){return chunkGOU6FU6Y_js.b}});Object.defineProperty(exports,"identifyComplianceGaps",{enumerable:true,get:function(){return chunkGOU6FU6Y_js.d}});Object.defineProperty(exports,"validateProcessingRecord",{enumerable:true,get:function(){return chunkGOU6FU6Y_js.a}});Object.defineProperty(exports,"ConsentStorage",{enumerable:true,get:function(){return chunk3NQQSU4P_js.a}});Object.defineProperty(exports,"ConsentManager",{enumerable:true,get:function(){return chunkRLYTX3MM_js.a}});Object.defineProperty(exports,"ConsentBanner",{enumerable:true,get:function(){return chunkXIM7KMD6_js.a}});Object.defineProperty(exports,"appendAuditEntry",{enumerable:true,get:function(){return chunkMJGOLP5M_js.c}});Object.defineProperty(exports,"createAuditEntry",{enumerable:true,get:function(){return chunkMJGOLP5M_js.a}});Object.defineProperty(exports,"getAuditLog",{enumerable:true,get:function(){return chunkMJGOLP5M_js.b}});Object.defineProperty(exports,"useConsent",{enumerable:true,get:function(){return chunk7SMLHZ4B_js.a}});Object.defineProperty(exports,"validateConsent",{enumerable:true,get:function(){return chunkHO5M7M4M_js.a}});Object.defineProperty(exports,"validateConsentOptions",{enumerable:true,get:function(){return chunkHO5M7M4M_js.b}});Object.defineProperty(exports,"DSRDashboard",{enumerable:true,get:function(){return chunkVIQUXWJC_js.a}});Object.defineProperty(exports,"DSRTracker",{enumerable:true,get:function(){return chunkVIQUXWJC_js.b}});Object.defineProperty(exports,"DSRRequestForm",{enumerable:true,get:function(){return chunkZPKVLTSX_js.a}});Object.defineProperty(exports,"useDSR",{enumerable:true,get:function(){return chunkCKJAECGV_js.a}});Object.defineProperty(exports,"formatDSRRequest",{enumerable:true,get:function(){return chunkJ5WCPZLW_js.b}});Object.defineProperty(exports,"DPIAReport",{enumerable:true,get:function(){return chunk3VQAYQR7_js.a}});Object.defineProperty(exports,"StepIndicator",{enumerable:true,get:function(){return chunk3VQAYQR7_js.b}});Object.defineProperty(exports,"DPIAQuestionnaire",{enumerable:true,get:function(){return chunk5HL4UBFV_js.a}});Object.defineProperty(exports,"useDPIA",{enumerable:true,get:function(){return chunkOPYQIJKY_js.a}});Object.defineProperty(exports,"assessDPIARisk",{enumerable:true,get:function(){return chunkP42Z5CFE_js.a}});Object.defineProperty(exports,"BreachNotificationManager",{enumerable:true,get:function(){return chunkSKKOMFXH_js.b}});Object.defineProperty(exports,"BreachRiskAssessment",{enumerable:true,get:function(){return chunkSKKOMFXH_js.a}});Object.defineProperty(exports,"RegulatoryReportGenerator",{enumerable:true,get:function(){return chunkSKKOMFXH_js.c}});Object.defineProperty(exports,"BreachReportForm",{enumerable:true,get:function(){return chunkWTJGLNTB_js.a}});Object.defineProperty(exports,"useBreach",{enumerable:true,get:function(){return chunkI4M2AA3N_js.a}});Object.defineProperty(exports,"calculateBreachSeverity",{enumerable:true,get:function(){return chunkBKRETVJ6_js.a}});Object.defineProperty(exports,"sanitizeInput",{enumerable:true,get:function(){return chunkI54CDQGN_js.a}});Object.defineProperty(exports,"resolveClass",{enumerable:true,get:function(){return chunkE64TU6IU_js.a}});//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+'use strict';var chunkXO3VQYTL_js=require('./chunk-XO3VQYTL.js'),chunkNUWVPRNI_js=require('./chunk-NUWVPRNI.js'),chunkPZRQWPWD_js=require('./chunk-PZRQWPWD.js'),chunkI3Y4LOSL_js=require('./chunk-I3Y4LOSL.js'),chunk5GVMKUMP_js=require('./chunk-5GVMKUMP.js'),chunkUAV7V4EM_js=require('./chunk-UAV7V4EM.js');require('./chunk-7IFSWCQP.js');var chunkRYREGZVQ_js=require('./chunk-RYREGZVQ.js'),chunkZ763UI5U_js=require('./chunk-Z763UI5U.js'),chunkUTFBKL73_js=require('./chunk-UTFBKL73.js'),chunkHHK5LHEG_js=require('./chunk-HHK5LHEG.js'),chunk3JPDTXGC_js=require('./chunk-3JPDTXGC.js'),chunkUI536RU2_js=require('./chunk-UI536RU2.js');require('./chunk-N3MQQUQP.js');var chunkLVGT3DLT_js=require('./chunk-LVGT3DLT.js'),chunkQPRYXVH2_js=require('./chunk-QPRYXVH2.js');require('./chunk-Q64735OC.js');var chunkWZYCBW2R_js=require('./chunk-WZYCBW2R.js'),chunkYFBDJ4FH_js=require('./chunk-YFBDJ4FH.js'),chunk4CVBQC66_js=require('./chunk-4CVBQC66.js'),chunkSJDDNB6M_js=require('./chunk-SJDDNB6M.js'),chunkBRS52EDT_js=require('./chunk-BRS52EDT.js'),chunk732C2EVN_js=require('./chunk-732C2EVN.js'),chunk3IA3KDII_js=require('./chunk-3IA3KDII.js'),chunkP4LNLCSF_js=require('./chunk-P4LNLCSF.js'),chunkL2VO3MEJ_js=require('./chunk-L2VO3MEJ.js');require('./chunk-7ZZO7GVB.js');var chunkB46SJB5V_js=require('./chunk-B46SJB5V.js'),chunkCR2QZTGW_js=require('./chunk-CR2QZTGW.js'),chunkW47OSMT6_js=require('./chunk-W47OSMT6.js'),chunkHBLGN4SD_js=require('./chunk-HBLGN4SD.js'),chunkL2BRFMVS_js=require('./chunk-L2BRFMVS.js'),chunkEZCGTHQV_js=require('./chunk-EZCGTHQV.js'),chunkWDDCKYWA_js=require('./chunk-WDDCKYWA.js'),chunkC7IDR2IV_js=require('./chunk-C7IDR2IV.js'),chunkTQZWJGJ2_js=require('./chunk-TQZWJGJ2.js'),chunkPGI2LM6P_js=require('./chunk-PGI2LM6P.js'),chunkS6COXIZA_js=require('./chunk-S6COXIZA.js'),chunkVJTQXVAF_js=require('./chunk-VJTQXVAF.js'),chunk3YTAOT5O_js=require('./chunk-3YTAOT5O.js'),chunkUXUMYP4L_js=require('./chunk-UXUMYP4L.js'),chunkZVOIR4QH_js=require('./chunk-ZVOIR4QH.js'),chunkAME4HJR4_js=require('./chunk-AME4HJR4.js');require('./chunk-VWED6UTN.js'),require('./chunk-RFPLZDIO.js');var jsxRuntime=require('react/jsx-runtime');var xe=({variant:t="short",className:e,hidden:s})=>{if(s)return null;let a=t==="long"?chunkZVOIR4QH_js.b:chunkZVOIR4QH_js.a;return jsxRuntime.jsx("p",{role:"note",className:e!=null?e:"ndpr-legal-notice","data-ndpr-legal-notice":t,children:a})};Object.defineProperty(exports,"PolicyExporter",{enumerable:true,get:function(){return chunkXO3VQYTL_js.c}});Object.defineProperty(exports,"PolicyGenerator",{enumerable:true,get:function(){return chunkXO3VQYTL_js.a}});Object.defineProperty(exports,"PolicyPreview",{enumerable:true,get:function(){return chunkXO3VQYTL_js.b}});Object.defineProperty(exports,"NDPRDashboard",{enumerable:true,get:function(){return chunkNUWVPRNI_js.a}});Object.defineProperty(exports,"LawfulBasisTracker",{enumerable:true,get:function(){return chunkPZRQWPWD_js.a}});Object.defineProperty(exports,"CrossBorderTransferManager",{enumerable:true,get:function(){return chunkI3Y4LOSL_js.a}});Object.defineProperty(exports,"ROPAManager",{enumerable:true,get:function(){return chunk5GVMKUMP_js.a}});Object.defineProperty(exports,"NDPRProvider",{enumerable:true,get:function(){return chunkUAV7V4EM_js.a}});Object.defineProperty(exports,"useNDPRConfig",{enumerable:true,get:function(){return chunkUAV7V4EM_js.b}});Object.defineProperty(exports,"useComplianceScore",{enumerable:true,get:function(){return chunkRYREGZVQ_js.a}});Object.defineProperty(exports,"useDefaultPrivacyPolicy",{enumerable:true,get:function(){return chunkZ763UI5U_js.b}});Object.defineProperty(exports,"usePrivacyPolicy",{enumerable:true,get:function(){return chunkZ763UI5U_js.a}});Object.defineProperty(exports,"useLawfulBasis",{enumerable:true,get:function(){return chunkUTFBKL73_js.a}});Object.defineProperty(exports,"useCrossBorderTransfer",{enumerable:true,get:function(){return chunkHHK5LHEG_js.a}});Object.defineProperty(exports,"useROPA",{enumerable:true,get:function(){return chunk3JPDTXGC_js.a}});Object.defineProperty(exports,"useAdaptivePolicyWizard",{enumerable:true,get:function(){return chunkUI536RU2_js.a}});Object.defineProperty(exports,"DEFAULT_POLICY_SECTIONS",{enumerable:true,get:function(){return chunkLVGT3DLT_js.c}});Object.defineProperty(exports,"DEFAULT_POLICY_VARIABLES",{enumerable:true,get:function(){return chunkLVGT3DLT_js.d}});Object.defineProperty(exports,"createBusinessPolicyTemplate",{enumerable:true,get:function(){return chunkLVGT3DLT_js.e}});Object.defineProperty(exports,"generatePolicyText",{enumerable:true,get:function(){return chunkLVGT3DLT_js.b}});Object.defineProperty(exports,"getComplianceScore",{enumerable:true,get:function(){return chunkQPRYXVH2_js.a}});Object.defineProperty(exports,"assessComplianceGaps",{enumerable:true,get:function(){return chunkWZYCBW2R_js.c}});Object.defineProperty(exports,"generateLawfulBasisSummary",{enumerable:true,get:function(){return chunkWZYCBW2R_js.d}});Object.defineProperty(exports,"getLawfulBasisDescription",{enumerable:true,get:function(){return chunkWZYCBW2R_js.b}});Object.defineProperty(exports,"validateProcessingActivity",{enumerable:true,get:function(){return chunkWZYCBW2R_js.a}});Object.defineProperty(exports,"assessTransferRisk",{enumerable:true,get:function(){return chunkYFBDJ4FH_js.h}});Object.defineProperty(exports,"getTransferMechanismDescription",{enumerable:true,get:function(){return chunkYFBDJ4FH_js.f}});Object.defineProperty(exports,"isNDPCApprovalRequired",{enumerable:true,get:function(){return chunkYFBDJ4FH_js.e}});Object.defineProperty(exports,"validateTransfer",{enumerable:true,get:function(){return chunkYFBDJ4FH_js.g}});Object.defineProperty(exports,"exportROPAToCSV",{enumerable:true,get:function(){return chunk4CVBQC66_js.c}});Object.defineProperty(exports,"generateROPASummary",{enumerable:true,get:function(){return chunk4CVBQC66_js.b}});Object.defineProperty(exports,"identifyComplianceGaps",{enumerable:true,get:function(){return chunk4CVBQC66_js.d}});Object.defineProperty(exports,"validateProcessingRecord",{enumerable:true,get:function(){return chunk4CVBQC66_js.a}});Object.defineProperty(exports,"ConsentStorage",{enumerable:true,get:function(){return chunkSJDDNB6M_js.a}});Object.defineProperty(exports,"ConsentManager",{enumerable:true,get:function(){return chunkBRS52EDT_js.a}});Object.defineProperty(exports,"ConsentBanner",{enumerable:true,get:function(){return chunk732C2EVN_js.a}});Object.defineProperty(exports,"appendAuditEntry",{enumerable:true,get:function(){return chunk3IA3KDII_js.c}});Object.defineProperty(exports,"createAuditEntry",{enumerable:true,get:function(){return chunk3IA3KDII_js.a}});Object.defineProperty(exports,"getAuditLog",{enumerable:true,get:function(){return chunk3IA3KDII_js.b}});Object.defineProperty(exports,"useConsent",{enumerable:true,get:function(){return chunkP4LNLCSF_js.a}});Object.defineProperty(exports,"useFocusTrap",{enumerable:true,get:function(){return chunkL2VO3MEJ_js.a}});Object.defineProperty(exports,"validateConsent",{enumerable:true,get:function(){return chunkB46SJB5V_js.a}});Object.defineProperty(exports,"validateConsentOptions",{enumerable:true,get:function(){return chunkB46SJB5V_js.b}});Object.defineProperty(exports,"DSRDashboard",{enumerable:true,get:function(){return chunkCR2QZTGW_js.a}});Object.defineProperty(exports,"DSRTracker",{enumerable:true,get:function(){return chunkCR2QZTGW_js.b}});Object.defineProperty(exports,"DSRRequestForm",{enumerable:true,get:function(){return chunkW47OSMT6_js.a}});Object.defineProperty(exports,"useDSR",{enumerable:true,get:function(){return chunkHBLGN4SD_js.a}});Object.defineProperty(exports,"formatDSRRequest",{enumerable:true,get:function(){return chunkL2BRFMVS_js.b}});Object.defineProperty(exports,"DPIAReport",{enumerable:true,get:function(){return chunkEZCGTHQV_js.a}});Object.defineProperty(exports,"StepIndicator",{enumerable:true,get:function(){return chunkEZCGTHQV_js.b}});Object.defineProperty(exports,"DPIAQuestionnaire",{enumerable:true,get:function(){return chunkWDDCKYWA_js.a}});Object.defineProperty(exports,"useDPIA",{enumerable:true,get:function(){return chunkC7IDR2IV_js.a}});Object.defineProperty(exports,"assessDPIARisk",{enumerable:true,get:function(){return chunkTQZWJGJ2_js.a}});Object.defineProperty(exports,"BreachNotificationManager",{enumerable:true,get:function(){return chunkPGI2LM6P_js.b}});Object.defineProperty(exports,"BreachRiskAssessment",{enumerable:true,get:function(){return chunkPGI2LM6P_js.a}});Object.defineProperty(exports,"RegulatoryReportGenerator",{enumerable:true,get:function(){return chunkPGI2LM6P_js.c}});Object.defineProperty(exports,"BreachReportForm",{enumerable:true,get:function(){return chunkS6COXIZA_js.a}});Object.defineProperty(exports,"useBreach",{enumerable:true,get:function(){return chunkVJTQXVAF_js.a}});Object.defineProperty(exports,"calculateBreachSeverity",{enumerable:true,get:function(){return chunk3YTAOT5O_js.a}});Object.defineProperty(exports,"sanitizeInput",{enumerable:true,get:function(){return chunkUXUMYP4L_js.a}});Object.defineProperty(exports,"LEGAL_DISCLAIMER_LONG",{enumerable:true,get:function(){return chunkZVOIR4QH_js.b}});Object.defineProperty(exports,"LEGAL_DISCLAIMER_SHORT",{enumerable:true,get:function(){return chunkZVOIR4QH_js.a}});Object.defineProperty(exports,"legalDisclaimerBlock",{enumerable:true,get:function(){return chunkZVOIR4QH_js.c}});Object.defineProperty(exports,"resolveClass",{enumerable:true,get:function(){return chunkAME4HJR4_js.a}});exports.LegalNotice=xe;