wizzard-stepper-react 1.0.2 → 1.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +163 -163
- package/dist/index.cjs.map +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +4 -3
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 Aziz
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Aziz
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,163 +1,163 @@
|
|
|
1
|
-
# wizzard-stepper-react 🧙♂️
|
|
2
|
-
|
|
3
|
-
A flexible, headless, and strictly typed multi-step wizard library for React. Built with adapter patterns in mind to support any form library (React Hook Form, Formik, etc.) and any validation schema (Zod, Yup).
|
|
4
|
-
|
|
5
|
-
## Features
|
|
6
|
-
|
|
7
|
-
- 🧠 **Headless Architecture**: Full control over UI. You bring the components, we provide the logic.
|
|
8
|
-
- 🔌 **Adapter Pattern**: Built-in adapters for **Zod**, **Yup** validation, and **LocalStorage/URL/Memory** persistence.
|
|
9
|
-
- 🛡️ **Strictly Typed**: Built with TypeScript generics for type safety across steps.
|
|
10
|
-
- 🔀 **Conditional Steps**: Dynamic pipelines where steps can be skipped based on data.
|
|
11
|
-
- 💾 **Persistence**: Auto-save progress to LocalStorage or custom stores.
|
|
12
|
-
- ⚡ **Auto Validation**: Block navigation until the step is valid.
|
|
13
|
-
|
|
14
|
-
## Installation
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
npm install wizzard-stepper-react
|
|
18
|
-
# or
|
|
19
|
-
yarn add wizzard-stepper-react
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
## Quick Start (Native Forms)
|
|
23
|
-
|
|
24
|
-
```tsx
|
|
25
|
-
import { WizardProvider, useWizard, IWizardConfig } from 'wizzard-stepper-react';
|
|
26
|
-
|
|
27
|
-
// 1. Define Config
|
|
28
|
-
const config: IWizardConfig = {
|
|
29
|
-
steps: [
|
|
30
|
-
{ id: 'personal', label: 'Personal Info' },
|
|
31
|
-
{ id: 'contact', label: 'Contact Details' },
|
|
32
|
-
],
|
|
33
|
-
};
|
|
34
|
-
|
|
35
|
-
// 2. Create Steps
|
|
36
|
-
const Step1 = () => {
|
|
37
|
-
const { handleStepChange, wizardData } = useWizard<{ name: string }>();
|
|
38
|
-
return (
|
|
39
|
-
<input
|
|
40
|
-
value={wizardData.name || ''}
|
|
41
|
-
onChange={e => handleStepChange('name', e.target.value)}
|
|
42
|
-
/>
|
|
43
|
-
);
|
|
44
|
-
};
|
|
45
|
-
|
|
46
|
-
// 3. Wrap in Provider
|
|
47
|
-
export default function App() {
|
|
48
|
-
return (
|
|
49
|
-
<WizardProvider config={config}>
|
|
50
|
-
<WizardContent />
|
|
51
|
-
</WizardProvider>
|
|
52
|
-
);
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
const WizardContent = () => {
|
|
56
|
-
const { currentStep, goToNextStep } = useWizard();
|
|
57
|
-
if(!currentStep) return null;
|
|
58
|
-
return (
|
|
59
|
-
<div>
|
|
60
|
-
{currentStep.id === 'personal' && <Step1 />}
|
|
61
|
-
<button onClick={goToNextStep}>Next</button>
|
|
62
|
-
</div>
|
|
63
|
-
)
|
|
64
|
-
}
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## Integration with React Hook Form + Zod
|
|
68
|
-
|
|
69
|
-
```tsx
|
|
70
|
-
import { useForm } from 'react-hook-form';
|
|
71
|
-
import { zodResolver } from '@hookform/resolvers/zod';
|
|
72
|
-
import { z } from 'zod';
|
|
73
|
-
import { ZodAdapter, useWizard } from 'wizzard-stepper-react';
|
|
74
|
-
|
|
75
|
-
const schema = z.object({ email: z.string().email() });
|
|
76
|
-
|
|
77
|
-
const MyStep = () => {
|
|
78
|
-
const { handleStepChange, wizardData } = useWizard();
|
|
79
|
-
const { register } = useForm({
|
|
80
|
-
defaultValues: wizardData,
|
|
81
|
-
resolver: zodResolver(schema),
|
|
82
|
-
mode: 'onChange' // Important: validate real-time or bind changes
|
|
83
|
-
});
|
|
84
|
-
|
|
85
|
-
return (
|
|
86
|
-
<input {...register('email', {
|
|
87
|
-
onChange: (e) => handleStepChange('email', e.target.value)
|
|
88
|
-
})} />
|
|
89
|
-
);
|
|
90
|
-
}
|
|
91
|
-
|
|
92
|
-
// In Config:
|
|
93
|
-
const config = {
|
|
94
|
-
steps: [
|
|
95
|
-
{
|
|
96
|
-
id: 'step1',
|
|
97
|
-
label: 'Email',
|
|
98
|
-
validationAdapter: new ZodAdapter(schema) // Blocks 'Next' if invalid
|
|
99
|
-
}
|
|
100
|
-
]
|
|
101
|
-
}
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
## Conditional Steps
|
|
105
|
-
|
|
106
|
-
Steps can be dynamically included based on the wizard's state.
|
|
107
|
-
|
|
108
|
-
```tsx
|
|
109
|
-
const config: IWizardConfig = {
|
|
110
|
-
steps: [
|
|
111
|
-
{ id: 'start', label: 'Start' },
|
|
112
|
-
{
|
|
113
|
-
id: 'bonus',
|
|
114
|
-
label: 'Bonus Step',
|
|
115
|
-
// Only show if 'wantBonus' is true
|
|
116
|
-
condition: (data) => !!data.wantBonus
|
|
117
|
-
}
|
|
118
|
-
]
|
|
119
|
-
}
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
## Persistence
|
|
123
|
-
|
|
124
|
-
Save progress automatically to LocalStorage to survive page reloads.
|
|
125
|
-
|
|
126
|
-
```tsx
|
|
127
|
-
import { LocalStorageAdapter } from 'wizzard-stepper-react';
|
|
128
|
-
|
|
129
|
-
const config: IWizardConfig = {
|
|
130
|
-
persistence: {
|
|
131
|
-
mode: 'onChange', // Save on every keystroke
|
|
132
|
-
adapter: new LocalStorageAdapter('my_wizard_prefix_')
|
|
133
|
-
},
|
|
134
|
-
steps: [...]
|
|
135
|
-
}
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
## API Reference
|
|
139
|
-
|
|
140
|
-
### `IWizardConfig<T>`
|
|
141
|
-
- `steps`: Array of step configurations.
|
|
142
|
-
- `persistence`: Configuration for state persistence.
|
|
143
|
-
- `autoValidate`: (obj) Global validation setting.
|
|
144
|
-
|
|
145
|
-
### `useWizard<T>()`
|
|
146
|
-
- `activeSteps`: Steps that match conditions.
|
|
147
|
-
- `currentStep`: The currently active step object.
|
|
148
|
-
- `wizardData`: The global state object.
|
|
149
|
-
- `handleStepChange(key, value)`: Helper to update state.
|
|
150
|
-
- `goToNextStep()`: Validates and moves next.
|
|
151
|
-
- `goToStep(id)`: Jumps to specific step.
|
|
152
|
-
- `allErrors`: Map of validation errors.
|
|
153
|
-
|
|
154
|
-
## Demos
|
|
155
|
-
|
|
156
|
-
Check out the [Live Demo](https://ZizzX.github.io/wizzard-stepper-react-demo/) or the [source code](https://github.com/ZizzX/wizzard-stepper-react-demo) for a complete implementation featuring:
|
|
157
|
-
- **Tailwind CSS v4** UI overhaul.
|
|
158
|
-
- **React Hook Form + Zod** integration.
|
|
159
|
-
- **Formik + Yup** integration.
|
|
160
|
-
- **Conditional Routing** logic.
|
|
161
|
-
|
|
162
|
-
## License
|
|
163
|
-
MIT
|
|
1
|
+
# wizzard-stepper-react 🧙♂️
|
|
2
|
+
|
|
3
|
+
A flexible, headless, and strictly typed multi-step wizard library for React. Built with adapter patterns in mind to support any form library (React Hook Form, Formik, etc.) and any validation schema (Zod, Yup).
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- 🧠 **Headless Architecture**: Full control over UI. You bring the components, we provide the logic.
|
|
8
|
+
- 🔌 **Adapter Pattern**: Built-in adapters for **Zod**, **Yup** validation, and **LocalStorage/URL/Memory** persistence.
|
|
9
|
+
- 🛡️ **Strictly Typed**: Built with TypeScript generics for type safety across steps.
|
|
10
|
+
- 🔀 **Conditional Steps**: Dynamic pipelines where steps can be skipped based on data.
|
|
11
|
+
- 💾 **Persistence**: Auto-save progress to LocalStorage or custom stores.
|
|
12
|
+
- ⚡ **Auto Validation**: Block navigation until the step is valid.
|
|
13
|
+
|
|
14
|
+
## Installation
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npm install wizzard-stepper-react
|
|
18
|
+
# or
|
|
19
|
+
yarn add wizzard-stepper-react
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Quick Start (Native Forms)
|
|
23
|
+
|
|
24
|
+
```tsx
|
|
25
|
+
import { WizardProvider, useWizard, IWizardConfig } from 'wizzard-stepper-react';
|
|
26
|
+
|
|
27
|
+
// 1. Define Config
|
|
28
|
+
const config: IWizardConfig = {
|
|
29
|
+
steps: [
|
|
30
|
+
{ id: 'personal', label: 'Personal Info' },
|
|
31
|
+
{ id: 'contact', label: 'Contact Details' },
|
|
32
|
+
],
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
// 2. Create Steps
|
|
36
|
+
const Step1 = () => {
|
|
37
|
+
const { handleStepChange, wizardData } = useWizard<{ name: string }>();
|
|
38
|
+
return (
|
|
39
|
+
<input
|
|
40
|
+
value={wizardData.name || ''}
|
|
41
|
+
onChange={e => handleStepChange('name', e.target.value)}
|
|
42
|
+
/>
|
|
43
|
+
);
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
// 3. Wrap in Provider
|
|
47
|
+
export default function App() {
|
|
48
|
+
return (
|
|
49
|
+
<WizardProvider config={config}>
|
|
50
|
+
<WizardContent />
|
|
51
|
+
</WizardProvider>
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
const WizardContent = () => {
|
|
56
|
+
const { currentStep, goToNextStep } = useWizard();
|
|
57
|
+
if(!currentStep) return null;
|
|
58
|
+
return (
|
|
59
|
+
<div>
|
|
60
|
+
{currentStep.id === 'personal' && <Step1 />}
|
|
61
|
+
<button onClick={goToNextStep}>Next</button>
|
|
62
|
+
</div>
|
|
63
|
+
)
|
|
64
|
+
}
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## Integration with React Hook Form + Zod
|
|
68
|
+
|
|
69
|
+
```tsx
|
|
70
|
+
import { useForm } from 'react-hook-form';
|
|
71
|
+
import { zodResolver } from '@hookform/resolvers/zod';
|
|
72
|
+
import { z } from 'zod';
|
|
73
|
+
import { ZodAdapter, useWizard } from 'wizzard-stepper-react';
|
|
74
|
+
|
|
75
|
+
const schema = z.object({ email: z.string().email() });
|
|
76
|
+
|
|
77
|
+
const MyStep = () => {
|
|
78
|
+
const { handleStepChange, wizardData } = useWizard();
|
|
79
|
+
const { register } = useForm({
|
|
80
|
+
defaultValues: wizardData,
|
|
81
|
+
resolver: zodResolver(schema),
|
|
82
|
+
mode: 'onChange' // Important: validate real-time or bind changes
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
return (
|
|
86
|
+
<input {...register('email', {
|
|
87
|
+
onChange: (e) => handleStepChange('email', e.target.value)
|
|
88
|
+
})} />
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
// In Config:
|
|
93
|
+
const config = {
|
|
94
|
+
steps: [
|
|
95
|
+
{
|
|
96
|
+
id: 'step1',
|
|
97
|
+
label: 'Email',
|
|
98
|
+
validationAdapter: new ZodAdapter(schema) // Blocks 'Next' if invalid
|
|
99
|
+
}
|
|
100
|
+
]
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Conditional Steps
|
|
105
|
+
|
|
106
|
+
Steps can be dynamically included based on the wizard's state.
|
|
107
|
+
|
|
108
|
+
```tsx
|
|
109
|
+
const config: IWizardConfig = {
|
|
110
|
+
steps: [
|
|
111
|
+
{ id: 'start', label: 'Start' },
|
|
112
|
+
{
|
|
113
|
+
id: 'bonus',
|
|
114
|
+
label: 'Bonus Step',
|
|
115
|
+
// Only show if 'wantBonus' is true
|
|
116
|
+
condition: (data) => !!data.wantBonus
|
|
117
|
+
}
|
|
118
|
+
]
|
|
119
|
+
}
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Persistence
|
|
123
|
+
|
|
124
|
+
Save progress automatically to LocalStorage to survive page reloads.
|
|
125
|
+
|
|
126
|
+
```tsx
|
|
127
|
+
import { LocalStorageAdapter } from 'wizzard-stepper-react';
|
|
128
|
+
|
|
129
|
+
const config: IWizardConfig = {
|
|
130
|
+
persistence: {
|
|
131
|
+
mode: 'onChange', // Save on every keystroke
|
|
132
|
+
adapter: new LocalStorageAdapter('my_wizard_prefix_')
|
|
133
|
+
},
|
|
134
|
+
steps: [...]
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## API Reference
|
|
139
|
+
|
|
140
|
+
### `IWizardConfig<T>`
|
|
141
|
+
- `steps`: Array of step configurations.
|
|
142
|
+
- `persistence`: Configuration for state persistence.
|
|
143
|
+
- `autoValidate`: (obj) Global validation setting.
|
|
144
|
+
|
|
145
|
+
### `useWizard<T>()`
|
|
146
|
+
- `activeSteps`: Steps that match conditions.
|
|
147
|
+
- `currentStep`: The currently active step object.
|
|
148
|
+
- `wizardData`: The global state object.
|
|
149
|
+
- `handleStepChange(key, value)`: Helper to update state.
|
|
150
|
+
- `goToNextStep()`: Validates and moves next.
|
|
151
|
+
- `goToStep(id)`: Jumps to specific step.
|
|
152
|
+
- `allErrors`: Map of validation errors.
|
|
153
|
+
|
|
154
|
+
## Demos
|
|
155
|
+
|
|
156
|
+
Check out the [Live Demo](https://ZizzX.github.io/wizzard-stepper-react-demo/), [NPM](https://www.npmjs.com/package/wizzard-stepper-react) or the [source code](https://github.com/ZizzX/wizzard-stepper-react-demo) for a complete implementation featuring:
|
|
157
|
+
- **Tailwind CSS v4** UI overhaul.
|
|
158
|
+
- **React Hook Form + Zod** integration.
|
|
159
|
+
- **Formik + Yup** integration.
|
|
160
|
+
- **Conditional Routing** logic.
|
|
161
|
+
|
|
162
|
+
## License
|
|
163
|
+
MIT
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/context/WizardContext.tsx","../src/adapters/persistence/MemoryAdapter.ts","../src/hooks/useWizard.ts","../src/adapters/persistence/LocalStorageAdapter.ts","../src/adapters/validation/ZodAdapter.ts","../src/adapters/validation/YupAdapter.ts"],"sourcesContent":["export * from './types';\r\nexport * from './context/WizardContext';\r\nexport * from './hooks/useWizard';\r\n\r\nexport * from './adapters/persistence/MemoryAdapter';\r\nexport * from './adapters/persistence/LocalStorageAdapter';\r\n\r\nexport * from './adapters/validation/ZodAdapter';\r\nexport * from './adapters/validation/YupAdapter';\r\n","import React, { createContext, useContext, useEffect, useMemo, useState, useCallback } from 'react';\r\nimport type {\r\n IWizardConfig,\r\n IWizardContext,\r\n PersistenceMode,\r\n IPersistenceAdapter,\r\n} from '../types';\r\nimport { MemoryAdapter } from '../adapters/persistence/MemoryAdapter';\r\n\r\nconst WizardContext = createContext<IWizardContext<any> | undefined>(undefined);\r\n\r\ninterface WizardProviderProps<T> {\r\n config: IWizardConfig<T>;\r\n initialData?: T;\r\n children: React.ReactNode;\r\n}\r\n\r\nexport function WizardProvider<T extends Record<string, any>>({\r\n config,\r\n initialData,\r\n children,\r\n}: WizardProviderProps<T>) {\r\n const [currentStepId, setCurrentStepId] = useState<string>('');\r\n const [wizardData, setWizardData] = useState<T>((initialData || {}) as T);\r\n const [visitedSteps, setVisitedSteps] = useState<Set<string>>(new Set());\r\n const [completedSteps, setCompletedSteps] = useState<Set<string>>(new Set());\r\n const [errorSteps, setErrorSteps] = useState<Set<string>>(new Set());\r\n const [allErrors, setAllErrors] = useState<Record<string, Record<string, string>>>({});\r\n const [isLoading, setIsLoading] = useState<boolean>(true);\r\n\r\n // Persistence Setup\r\n const persistenceAdapter = useMemo<IPersistenceAdapter>(() => {\r\n return config.persistence?.adapter || new MemoryAdapter();\r\n }, [config.persistence?.adapter]);\r\n\r\n const persistenceMode = config.persistence?.mode || 'onStepChange';\r\n\r\n // Calculate Active Steps (Conditional Logic)\r\n const activeSteps = useMemo(() => {\r\n return config.steps.filter((step) => {\r\n if (step.condition) {\r\n return step.condition(wizardData);\r\n }\r\n return true;\r\n });\r\n }, [config.steps, wizardData]);\r\n\r\n // Set initial step if not set\r\n useEffect(() => {\r\n if (!currentStepId && activeSteps.length > 0) {\r\n setCurrentStepId(activeSteps[0].id);\r\n setIsLoading(false);\r\n }\r\n }, [activeSteps, currentStepId]);\r\n\r\n // Derived state\r\n const currentStep = useMemo(() => activeSteps.find((s) => s.id === currentStepId) || null, [activeSteps, currentStepId]);\r\n const currentStepIndex = useMemo(() => activeSteps.findIndex((s) => s.id === currentStepId), [activeSteps, currentStepId]);\r\n const isFirstStep = currentStepIndex === 0;\r\n const isLastStep = currentStepIndex === activeSteps.length - 1;\r\n\r\n // Constants\r\n const META_KEY = '__wizzard_meta__';\r\n\r\n // Hydration Helper\r\n const hydrate = useCallback(() => {\r\n setIsLoading(true);\r\n \r\n // 1. Load Metadata (Current Step, Visited, etc.)\r\n const metaFn = persistenceAdapter.getStep<{\r\n currentStepId: string;\r\n visited: string[];\r\n completed: string[];\r\n }>(META_KEY);\r\n\r\n if (metaFn) {\r\n if (metaFn.currentStepId) setCurrentStepId(metaFn.currentStepId);\r\n if (metaFn.visited) setVisitedSteps(new Set(metaFn.visited));\r\n if (metaFn.completed) setCompletedSteps(new Set(metaFn.completed));\r\n }\r\n\r\n // 2. Load Data\r\n // We assume data is distributed across steps OR stored centrally.\r\n // Given the current implementation saves 'wizardData' to each stepId, \r\n // we can iterate steps.\r\n const loadedData: Partial<T> = {};\r\n config.steps.forEach(step => {\r\n const stepData = persistenceAdapter.getStep(step.id);\r\n if (stepData) {\r\n Object.assign(loadedData, stepData);\r\n }\r\n });\r\n\r\n if (Object.keys(loadedData).length > 0) {\r\n setWizardData(prev => ({ ...prev, ...loadedData }));\r\n }\r\n setIsLoading(false);\r\n }, [config.steps, persistenceAdapter]);\r\n\r\n useEffect(() => {\r\n hydrate();\r\n }, [hydrate]);\r\n\r\n // Save logic\r\n const saveData = useCallback((mode: PersistenceMode, stepId: string, data: any) => {\r\n if (mode === persistenceMode || mode === 'manual') {\r\n persistenceAdapter.saveStep(stepId, data);\r\n \r\n // Also save metadata whenever we save data (if appropriate)\r\n // Or we can save metadata explicitly on navigation.\r\n }\r\n }, [persistenceAdapter, persistenceMode]);\r\n\r\n // Explicit Metadata Save\r\n\r\n // Action: Set Step Data\r\n const setStepData = useCallback((stepId: string, data: any) => {\r\n setWizardData((prev) => {\r\n const newData = { ...prev, ...data };\r\n // Save if mode is 'onChange'\r\n if (persistenceMode === 'onChange') {\r\n // We must save the FULL new data, not just the partial 'data' update, \r\n // otherwise we overwrite the storage with just the single field.\r\n saveData('onChange', stepId, newData); \r\n }\r\n return newData;\r\n });\r\n }, [persistenceMode, saveData]);\r\n\r\n // Action: Handle specific field change (helper)\r\n const handleStepChange = useCallback((field: string, value: any) => {\r\n if (!currentStepId) return;\r\n setStepData(currentStepId, { [field]: value });\r\n }, [currentStepId, setStepData]);\r\n \r\n // Validation Logic\r\n const validateStep = useCallback(async (stepId: string): Promise<boolean> => {\r\n const step = config.steps.find(s => s.id === stepId);\r\n if (!step) return true;\r\n \r\n // Check if adapter exists\r\n if (!step.validationAdapter) return true;\r\n\r\n const result = await step.validationAdapter.validate(wizardData);\r\n \r\n if (!result.isValid) {\r\n setAllErrors(prev => ({\r\n ...prev,\r\n [stepId]: result.errors || {}\r\n }));\r\n setErrorSteps(prev => new Set(prev).add(stepId));\r\n return false;\r\n } else {\r\n setAllErrors(prev => {\r\n const next = { ...prev };\r\n delete next[stepId];\r\n return next;\r\n });\r\n setErrorSteps(prev => {\r\n const next = new Set(prev);\r\n next.delete(stepId);\r\n return next;\r\n });\r\n return true;\r\n }\r\n }, [config.steps, wizardData]);\r\n\r\n const validateAll = useCallback(async (): Promise<boolean> => {\r\n let isValid = true;\r\n for (const step of activeSteps) {\r\n const stepValid = await validateStep(step.id);\r\n if (!stepValid) isValid = false;\r\n }\r\n return isValid;\r\n }, [activeSteps, validateStep]);\r\n\r\n // Navigation\r\n const goToStep = useCallback(async (stepId: string): Promise<boolean> => {\r\n const targetIndex = activeSteps.findIndex(s => s.id === stepId);\r\n if (targetIndex === -1) return false;\r\n\r\n // If moving forward, validate current\r\n if (targetIndex > currentStepIndex) {\r\n const shouldValidate = currentStep?.autoValidate ?? config.autoValidate ?? true;\r\n if (shouldValidate) {\r\n const isValid = await validateStep(currentStepId);\r\n if (!isValid) return false; // Block\r\n }\r\n }\r\n \r\n // Save current step data logic\r\n if (persistenceMode === 'onStepChange' && currentStep) {\r\n saveData('onStepChange', currentStepId, wizardData); \r\n }\r\n\r\n // Update State\r\n const nextVisited = new Set(visitedSteps).add(currentStepId);\r\n setVisitedSteps(nextVisited);\r\n setCurrentStepId(stepId);\r\n \r\n // Persist Metadata (New Step Position)\r\n // We need to pass the *new* values because state updates are async\r\n if (persistenceMode !== 'manual') {\r\n persistenceAdapter.saveStep(META_KEY, {\r\n currentStepId: stepId,\r\n visited: Array.from(nextVisited),\r\n completed: Array.from(completedSteps)\r\n });\r\n }\r\n\r\n window.scrollTo(0, 0);\r\n return true;\r\n }, [activeSteps, currentStepId, currentStep, currentStepIndex, config.autoValidate, persistenceMode, saveData, wizardData, validateStep, visitedSteps, completedSteps, persistenceAdapter]);\r\n\r\n const goToNextStep = useCallback(async () => {\r\n if (isLastStep) return;\r\n const nextStep = activeSteps[currentStepIndex + 1];\r\n if (nextStep) {\r\n // Validation happens inside goToStep. If it fails, we shouldn't mark as completed.\r\n const success = await goToStep(nextStep.id);\r\n \r\n if (success) {\r\n // Mark completed logic ONLY on success\r\n const nextCompleted = new Set(completedSteps).add(currentStepId);\r\n setCompletedSteps(nextCompleted);\r\n \r\n // We need to update metadata again to include the new 'completed' status.\r\n // The previous save in goToStep didn't know about this new completion.\r\n if (persistenceMode !== 'manual') {\r\n persistenceAdapter.saveStep(META_KEY, {\r\n currentStepId: nextStep.id,\r\n visited: Array.from(new Set(visitedSteps).add(currentStepId)),\r\n completed: Array.from(nextCompleted) // Updated completed steps\r\n });\r\n }\r\n }\r\n }\r\n }, [activeSteps, currentStepIndex, isLastStep, currentStepId, goToStep, visitedSteps, completedSteps, persistenceMode, persistenceAdapter]);\r\n\r\n const goToPrevStep = useCallback(() => {\r\n if (isFirstStep) return;\r\n const prevStep = activeSteps[currentStepIndex - 1];\r\n if (prevStep) {\r\n goToStep(prevStep.id);\r\n }\r\n }, [activeSteps, currentStepIndex, isFirstStep, goToStep]);\r\n\r\n // Context Value\r\n const value = {\r\n currentStep,\r\n currentStepIndex,\r\n isFirstStep,\r\n isLastStep,\r\n isLoading,\r\n activeSteps,\r\n wizardData,\r\n allErrors,\r\n visitedSteps,\r\n completedSteps,\r\n errorSteps,\r\n goToNextStep,\r\n goToPrevStep,\r\n goToStep,\r\n setStepData,\r\n handleStepChange,\r\n validateStep,\r\n validateAll,\r\n save: () => saveData('manual', currentStepId, wizardData),\r\n clearStorage: () => persistenceAdapter.clear(),\r\n };\r\n\r\n return <WizardContext.Provider value={value}>{children}</WizardContext.Provider>;\r\n}\r\n\r\nexport function useWizardContext<T = any>() {\r\n const context = useContext(WizardContext);\r\n if (!context) {\r\n throw new Error('useWizardContext must be used within a WizardProvider');\r\n }\r\n return context as IWizardContext<T>;\r\n}\r\n","import type { IPersistenceAdapter } from '../../types';\r\n\r\nexport class MemoryAdapter implements IPersistenceAdapter {\r\n private storage: Record<string, any> = {};\r\n\r\n saveStep<T>(stepId: string, data: T): void {\r\n this.storage[stepId] = data;\r\n }\r\n\r\n getStep<T>(stepId: string): T | undefined {\r\n return this.storage[stepId] as T;\r\n }\r\n\r\n clear(): void {\r\n this.storage = {};\r\n }\r\n}\r\n","import { useWizardContext } from '../context/WizardContext';\r\n\r\nexport const useWizard = <T = any>() => {\r\n return useWizardContext<T>();\r\n};\r\n","import type { IPersistenceAdapter } from '../../types';\r\n\r\nexport class LocalStorageAdapter implements IPersistenceAdapter {\r\n private prefix: string;\r\n\r\n constructor(prefix: string = 'wizard_') {\r\n this.prefix = prefix;\r\n }\r\n\r\n private getKey(stepId: string): string {\r\n return `${this.prefix}${stepId}`;\r\n }\r\n\r\n saveStep<T>(stepId: string, data: T): void {\r\n if (typeof window === 'undefined') return;\r\n try {\r\n localStorage.setItem(this.getKey(stepId), JSON.stringify(data));\r\n } catch (error) {\r\n console.warn('LocalStorageAdapter: Failed to save step', error);\r\n }\r\n }\r\n\r\n getStep<T>(stepId: string): T | undefined {\r\n if (typeof window === 'undefined') return undefined;\r\n try {\r\n const item = localStorage.getItem(this.getKey(stepId));\r\n return item ? JSON.parse(item) : undefined;\r\n } catch (error) {\r\n console.warn('LocalStorageAdapter: Failed to get step', error);\r\n return undefined;\r\n }\r\n }\r\n\r\n clear(): void {\r\n if (typeof window === 'undefined') return;\r\n Object.keys(localStorage).forEach((key) => {\r\n if (key.startsWith(this.prefix)) {\r\n localStorage.removeItem(key);\r\n }\r\n });\r\n }\r\n}\r\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\r\nimport { ZodType } from 'zod';\r\n\r\nexport class ZodAdapter<T> implements IValidatorAdapter<T> {\r\n private schema: ZodType<T>;\r\n\r\n constructor(schema: ZodType<T>) {\r\n this.schema = schema;\r\n }\r\n\r\n async validate(data: T): Promise<ValidationResult> {\r\n const result = await this.schema.safeParseAsync(data);\r\n if (result.success) {\r\n return { isValid: true };\r\n }\r\n\r\n // Explicitly handle error case\r\n const errors: Record<string, string> = {};\r\n result.error.issues.forEach((err) => {\r\n const path = err.path.join('.'); // nested.field\r\n errors[path] = err.message;\r\n });\r\n return { isValid: false, errors };\r\n }\r\n}\r\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\r\nimport { Schema, ValidationError } from 'yup';\r\n\r\nexport class YupAdapter<T> implements IValidatorAdapter<T> {\r\n private schema: Schema<T>;\r\n\r\n constructor(schema: Schema<T>) {\r\n this.schema = schema;\r\n }\r\n\r\n async validate(data: T): Promise<ValidationResult> {\r\n try {\r\n await this.schema.validate(data, { abortEarly: false });\r\n return { isValid: true };\r\n } catch (err) {\r\n if (err instanceof ValidationError) {\r\n const errors: Record<string, string> = {};\r\n err.inner.forEach((error) => {\r\n if (error.path) {\r\n errors[error.path] = error.message;\r\n }\r\n });\r\n return { isValid: false, errors };\r\n }\r\n throw err;\r\n }\r\n }\r\n}\r\n"],"mappings":"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","names":["value"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/context/WizardContext.tsx","../src/adapters/persistence/MemoryAdapter.ts","../src/hooks/useWizard.ts","../src/adapters/persistence/LocalStorageAdapter.ts","../src/adapters/validation/ZodAdapter.ts","../src/adapters/validation/YupAdapter.ts"],"sourcesContent":["export * from './types';\nexport * from './context/WizardContext';\nexport * from './hooks/useWizard';\n\nexport * from './adapters/persistence/MemoryAdapter';\nexport * from './adapters/persistence/LocalStorageAdapter';\n\nexport * from './adapters/validation/ZodAdapter';\nexport * from './adapters/validation/YupAdapter';\n","import React, { createContext, useContext, useEffect, useMemo, useState, useCallback } from 'react';\nimport type {\n IWizardConfig,\n IWizardContext,\n PersistenceMode,\n IPersistenceAdapter,\n} from '../types';\nimport { MemoryAdapter } from '../adapters/persistence/MemoryAdapter';\n\nconst WizardContext = createContext<IWizardContext<any> | undefined>(undefined);\n\ninterface WizardProviderProps<T> {\n config: IWizardConfig<T>;\n initialData?: T;\n children: React.ReactNode;\n}\n\nexport function WizardProvider<T extends Record<string, any>>({\n config,\n initialData,\n children,\n}: WizardProviderProps<T>) {\n const [currentStepId, setCurrentStepId] = useState<string>('');\n const [wizardData, setWizardData] = useState<T>((initialData || {}) as T);\n const [visitedSteps, setVisitedSteps] = useState<Set<string>>(new Set());\n const [completedSteps, setCompletedSteps] = useState<Set<string>>(new Set());\n const [errorSteps, setErrorSteps] = useState<Set<string>>(new Set());\n const [allErrors, setAllErrors] = useState<Record<string, Record<string, string>>>({});\n const [isLoading, setIsLoading] = useState<boolean>(true);\n\n // Persistence Setup\n const persistenceAdapter = useMemo<IPersistenceAdapter>(() => {\n return config.persistence?.adapter || new MemoryAdapter();\n }, [config.persistence?.adapter]);\n\n const persistenceMode = config.persistence?.mode || 'onStepChange';\n\n // Calculate Active Steps (Conditional Logic)\n const activeSteps = useMemo(() => {\n return config.steps.filter((step) => {\n if (step.condition) {\n return step.condition(wizardData);\n }\n return true;\n });\n }, [config.steps, wizardData]);\n\n // Set initial step if not set\n useEffect(() => {\n if (!currentStepId && activeSteps.length > 0) {\n setCurrentStepId(activeSteps[0].id);\n setIsLoading(false);\n }\n }, [activeSteps, currentStepId]);\n\n // Derived state\n const currentStep = useMemo(() => activeSteps.find((s) => s.id === currentStepId) || null, [activeSteps, currentStepId]);\n const currentStepIndex = useMemo(() => activeSteps.findIndex((s) => s.id === currentStepId), [activeSteps, currentStepId]);\n const isFirstStep = currentStepIndex === 0;\n const isLastStep = currentStepIndex === activeSteps.length - 1;\n\n // Constants\n const META_KEY = '__wizzard_meta__';\n\n // Hydration Helper\n const hydrate = useCallback(() => {\n setIsLoading(true);\n \n // 1. Load Metadata (Current Step, Visited, etc.)\n const metaFn = persistenceAdapter.getStep<{\n currentStepId: string;\n visited: string[];\n completed: string[];\n }>(META_KEY);\n\n if (metaFn) {\n if (metaFn.currentStepId) setCurrentStepId(metaFn.currentStepId);\n if (metaFn.visited) setVisitedSteps(new Set(metaFn.visited));\n if (metaFn.completed) setCompletedSteps(new Set(metaFn.completed));\n }\n\n // 2. Load Data\n // We assume data is distributed across steps OR stored centrally.\n // Given the current implementation saves 'wizardData' to each stepId, \n // we can iterate steps.\n const loadedData: Partial<T> = {};\n config.steps.forEach(step => {\n const stepData = persistenceAdapter.getStep(step.id);\n if (stepData) {\n Object.assign(loadedData, stepData);\n }\n });\n\n if (Object.keys(loadedData).length > 0) {\n setWizardData(prev => ({ ...prev, ...loadedData }));\n }\n setIsLoading(false);\n }, [config.steps, persistenceAdapter]);\n\n useEffect(() => {\n hydrate();\n }, [hydrate]);\n\n // Save logic\n const saveData = useCallback((mode: PersistenceMode, stepId: string, data: any) => {\n if (mode === persistenceMode || mode === 'manual') {\n persistenceAdapter.saveStep(stepId, data);\n \n // Also save metadata whenever we save data (if appropriate)\n // Or we can save metadata explicitly on navigation.\n }\n }, [persistenceAdapter, persistenceMode]);\n\n // Explicit Metadata Save\n\n // Action: Set Step Data\n const setStepData = useCallback((stepId: string, data: any) => {\n setWizardData((prev) => {\n const newData = { ...prev, ...data };\n // Save if mode is 'onChange'\n if (persistenceMode === 'onChange') {\n // We must save the FULL new data, not just the partial 'data' update, \n // otherwise we overwrite the storage with just the single field.\n saveData('onChange', stepId, newData); \n }\n return newData;\n });\n }, [persistenceMode, saveData]);\n\n // Action: Handle specific field change (helper)\n const handleStepChange = useCallback((field: string, value: any) => {\n if (!currentStepId) return;\n setStepData(currentStepId, { [field]: value });\n }, [currentStepId, setStepData]);\n \n // Validation Logic\n const validateStep = useCallback(async (stepId: string): Promise<boolean> => {\n const step = config.steps.find(s => s.id === stepId);\n if (!step) return true;\n \n // Check if adapter exists\n if (!step.validationAdapter) return true;\n\n const result = await step.validationAdapter.validate(wizardData);\n \n if (!result.isValid) {\n setAllErrors(prev => ({\n ...prev,\n [stepId]: result.errors || {}\n }));\n setErrorSteps(prev => new Set(prev).add(stepId));\n return false;\n } else {\n setAllErrors(prev => {\n const next = { ...prev };\n delete next[stepId];\n return next;\n });\n setErrorSteps(prev => {\n const next = new Set(prev);\n next.delete(stepId);\n return next;\n });\n return true;\n }\n }, [config.steps, wizardData]);\n\n const validateAll = useCallback(async (): Promise<boolean> => {\n let isValid = true;\n for (const step of activeSteps) {\n const stepValid = await validateStep(step.id);\n if (!stepValid) isValid = false;\n }\n return isValid;\n }, [activeSteps, validateStep]);\n\n // Navigation\n const goToStep = useCallback(async (stepId: string): Promise<boolean> => {\n const targetIndex = activeSteps.findIndex(s => s.id === stepId);\n if (targetIndex === -1) return false;\n\n // If moving forward, validate current\n if (targetIndex > currentStepIndex) {\n const shouldValidate = currentStep?.autoValidate ?? config.autoValidate ?? true;\n if (shouldValidate) {\n const isValid = await validateStep(currentStepId);\n if (!isValid) return false; // Block\n }\n }\n \n // Save current step data logic\n if (persistenceMode === 'onStepChange' && currentStep) {\n saveData('onStepChange', currentStepId, wizardData); \n }\n\n // Update State\n const nextVisited = new Set(visitedSteps).add(currentStepId);\n setVisitedSteps(nextVisited);\n setCurrentStepId(stepId);\n \n // Persist Metadata (New Step Position)\n // We need to pass the *new* values because state updates are async\n if (persistenceMode !== 'manual') {\n persistenceAdapter.saveStep(META_KEY, {\n currentStepId: stepId,\n visited: Array.from(nextVisited),\n completed: Array.from(completedSteps)\n });\n }\n\n window.scrollTo(0, 0);\n return true;\n }, [activeSteps, currentStepId, currentStep, currentStepIndex, config.autoValidate, persistenceMode, saveData, wizardData, validateStep, visitedSteps, completedSteps, persistenceAdapter]);\n\n const goToNextStep = useCallback(async () => {\n if (isLastStep) return;\n const nextStep = activeSteps[currentStepIndex + 1];\n if (nextStep) {\n // Validation happens inside goToStep. If it fails, we shouldn't mark as completed.\n const success = await goToStep(nextStep.id);\n \n if (success) {\n // Mark completed logic ONLY on success\n const nextCompleted = new Set(completedSteps).add(currentStepId);\n setCompletedSteps(nextCompleted);\n \n // We need to update metadata again to include the new 'completed' status.\n // The previous save in goToStep didn't know about this new completion.\n if (persistenceMode !== 'manual') {\n persistenceAdapter.saveStep(META_KEY, {\n currentStepId: nextStep.id,\n visited: Array.from(new Set(visitedSteps).add(currentStepId)),\n completed: Array.from(nextCompleted) // Updated completed steps\n });\n }\n }\n }\n }, [activeSteps, currentStepIndex, isLastStep, currentStepId, goToStep, visitedSteps, completedSteps, persistenceMode, persistenceAdapter]);\n\n const goToPrevStep = useCallback(() => {\n if (isFirstStep) return;\n const prevStep = activeSteps[currentStepIndex - 1];\n if (prevStep) {\n goToStep(prevStep.id);\n }\n }, [activeSteps, currentStepIndex, isFirstStep, goToStep]);\n\n // Context Value\n const value = {\n currentStep,\n currentStepIndex,\n isFirstStep,\n isLastStep,\n isLoading,\n activeSteps,\n wizardData,\n allErrors,\n visitedSteps,\n completedSteps,\n errorSteps,\n goToNextStep,\n goToPrevStep,\n goToStep,\n setStepData,\n handleStepChange,\n validateStep,\n validateAll,\n save: () => saveData('manual', currentStepId, wizardData),\n clearStorage: () => persistenceAdapter.clear(),\n };\n\n return <WizardContext.Provider value={value}>{children}</WizardContext.Provider>;\n}\n\nexport function useWizardContext<T = any>() {\n const context = useContext(WizardContext);\n if (!context) {\n throw new Error('useWizardContext must be used within a WizardProvider');\n }\n return context as IWizardContext<T>;\n}\n","import type { IPersistenceAdapter } from '../../types';\n\nexport class MemoryAdapter implements IPersistenceAdapter {\n private storage: Record<string, any> = {};\n\n saveStep<T>(stepId: string, data: T): void {\n this.storage[stepId] = data;\n }\n\n getStep<T>(stepId: string): T | undefined {\n return this.storage[stepId] as T;\n }\n\n clear(): void {\n this.storage = {};\n }\n}\n","import { useWizardContext } from '../context/WizardContext';\n\nexport const useWizard = <T = any>() => {\n return useWizardContext<T>();\n};\n","import type { IPersistenceAdapter } from '../../types';\n\nexport class LocalStorageAdapter implements IPersistenceAdapter {\n private prefix: string;\n\n constructor(prefix: string = 'wizard_') {\n this.prefix = prefix;\n }\n\n private getKey(stepId: string): string {\n return `${this.prefix}${stepId}`;\n }\n\n saveStep<T>(stepId: string, data: T): void {\n if (typeof window === 'undefined') return;\n try {\n localStorage.setItem(this.getKey(stepId), JSON.stringify(data));\n } catch (error) {\n console.warn('LocalStorageAdapter: Failed to save step', error);\n }\n }\n\n getStep<T>(stepId: string): T | undefined {\n if (typeof window === 'undefined') return undefined;\n try {\n const item = localStorage.getItem(this.getKey(stepId));\n return item ? JSON.parse(item) : undefined;\n } catch (error) {\n console.warn('LocalStorageAdapter: Failed to get step', error);\n return undefined;\n }\n }\n\n clear(): void {\n if (typeof window === 'undefined') return;\n Object.keys(localStorage).forEach((key) => {\n if (key.startsWith(this.prefix)) {\n localStorage.removeItem(key);\n }\n });\n }\n}\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\nimport { ZodType } from 'zod';\n\nexport class ZodAdapter<T> implements IValidatorAdapter<T> {\n private schema: ZodType<T>;\n\n constructor(schema: ZodType<T>) {\n this.schema = schema;\n }\n\n async validate(data: T): Promise<ValidationResult> {\n const result = await this.schema.safeParseAsync(data);\n if (result.success) {\n return { isValid: true };\n }\n\n // Explicitly handle error case\n const errors: Record<string, string> = {};\n result.error.issues.forEach((err) => {\n const path = err.path.join('.'); // nested.field\n errors[path] = err.message;\n });\n return { isValid: false, errors };\n }\n}\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\nimport { Schema, ValidationError } from 'yup';\n\nexport class YupAdapter<T> implements IValidatorAdapter<T> {\n private schema: Schema<T>;\n\n constructor(schema: Schema<T>) {\n this.schema = schema;\n }\n\n async validate(data: T): Promise<ValidationResult> {\n try {\n await this.schema.validate(data, { abortEarly: false });\n return { isValid: true };\n } catch (err) {\n if (err instanceof ValidationError) {\n const errors: Record<string, string> = {};\n err.inner.forEach((error) => {\n if (error.path) {\n errors[error.path] = error.message;\n }\n });\n return { isValid: false, errors };\n }\n throw err;\n }\n }\n}\n"],"mappings":"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","names":["value"]}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/context/WizardContext.tsx","../src/adapters/persistence/MemoryAdapter.ts","../src/hooks/useWizard.ts","../src/adapters/persistence/LocalStorageAdapter.ts","../src/adapters/validation/ZodAdapter.ts","../src/adapters/validation/YupAdapter.ts"],"sourcesContent":["import React, { createContext, useContext, useEffect, useMemo, useState, useCallback } from 'react';\r\nimport type {\r\n IWizardConfig,\r\n IWizardContext,\r\n PersistenceMode,\r\n IPersistenceAdapter,\r\n} from '../types';\r\nimport { MemoryAdapter } from '../adapters/persistence/MemoryAdapter';\r\n\r\nconst WizardContext = createContext<IWizardContext<any> | undefined>(undefined);\r\n\r\ninterface WizardProviderProps<T> {\r\n config: IWizardConfig<T>;\r\n initialData?: T;\r\n children: React.ReactNode;\r\n}\r\n\r\nexport function WizardProvider<T extends Record<string, any>>({\r\n config,\r\n initialData,\r\n children,\r\n}: WizardProviderProps<T>) {\r\n const [currentStepId, setCurrentStepId] = useState<string>('');\r\n const [wizardData, setWizardData] = useState<T>((initialData || {}) as T);\r\n const [visitedSteps, setVisitedSteps] = useState<Set<string>>(new Set());\r\n const [completedSteps, setCompletedSteps] = useState<Set<string>>(new Set());\r\n const [errorSteps, setErrorSteps] = useState<Set<string>>(new Set());\r\n const [allErrors, setAllErrors] = useState<Record<string, Record<string, string>>>({});\r\n const [isLoading, setIsLoading] = useState<boolean>(true);\r\n\r\n // Persistence Setup\r\n const persistenceAdapter = useMemo<IPersistenceAdapter>(() => {\r\n return config.persistence?.adapter || new MemoryAdapter();\r\n }, [config.persistence?.adapter]);\r\n\r\n const persistenceMode = config.persistence?.mode || 'onStepChange';\r\n\r\n // Calculate Active Steps (Conditional Logic)\r\n const activeSteps = useMemo(() => {\r\n return config.steps.filter((step) => {\r\n if (step.condition) {\r\n return step.condition(wizardData);\r\n }\r\n return true;\r\n });\r\n }, [config.steps, wizardData]);\r\n\r\n // Set initial step if not set\r\n useEffect(() => {\r\n if (!currentStepId && activeSteps.length > 0) {\r\n setCurrentStepId(activeSteps[0].id);\r\n setIsLoading(false);\r\n }\r\n }, [activeSteps, currentStepId]);\r\n\r\n // Derived state\r\n const currentStep = useMemo(() => activeSteps.find((s) => s.id === currentStepId) || null, [activeSteps, currentStepId]);\r\n const currentStepIndex = useMemo(() => activeSteps.findIndex((s) => s.id === currentStepId), [activeSteps, currentStepId]);\r\n const isFirstStep = currentStepIndex === 0;\r\n const isLastStep = currentStepIndex === activeSteps.length - 1;\r\n\r\n // Constants\r\n const META_KEY = '__wizzard_meta__';\r\n\r\n // Hydration Helper\r\n const hydrate = useCallback(() => {\r\n setIsLoading(true);\r\n \r\n // 1. Load Metadata (Current Step, Visited, etc.)\r\n const metaFn = persistenceAdapter.getStep<{\r\n currentStepId: string;\r\n visited: string[];\r\n completed: string[];\r\n }>(META_KEY);\r\n\r\n if (metaFn) {\r\n if (metaFn.currentStepId) setCurrentStepId(metaFn.currentStepId);\r\n if (metaFn.visited) setVisitedSteps(new Set(metaFn.visited));\r\n if (metaFn.completed) setCompletedSteps(new Set(metaFn.completed));\r\n }\r\n\r\n // 2. Load Data\r\n // We assume data is distributed across steps OR stored centrally.\r\n // Given the current implementation saves 'wizardData' to each stepId, \r\n // we can iterate steps.\r\n const loadedData: Partial<T> = {};\r\n config.steps.forEach(step => {\r\n const stepData = persistenceAdapter.getStep(step.id);\r\n if (stepData) {\r\n Object.assign(loadedData, stepData);\r\n }\r\n });\r\n\r\n if (Object.keys(loadedData).length > 0) {\r\n setWizardData(prev => ({ ...prev, ...loadedData }));\r\n }\r\n setIsLoading(false);\r\n }, [config.steps, persistenceAdapter]);\r\n\r\n useEffect(() => {\r\n hydrate();\r\n }, [hydrate]);\r\n\r\n // Save logic\r\n const saveData = useCallback((mode: PersistenceMode, stepId: string, data: any) => {\r\n if (mode === persistenceMode || mode === 'manual') {\r\n persistenceAdapter.saveStep(stepId, data);\r\n \r\n // Also save metadata whenever we save data (if appropriate)\r\n // Or we can save metadata explicitly on navigation.\r\n }\r\n }, [persistenceAdapter, persistenceMode]);\r\n\r\n // Explicit Metadata Save\r\n\r\n // Action: Set Step Data\r\n const setStepData = useCallback((stepId: string, data: any) => {\r\n setWizardData((prev) => {\r\n const newData = { ...prev, ...data };\r\n // Save if mode is 'onChange'\r\n if (persistenceMode === 'onChange') {\r\n // We must save the FULL new data, not just the partial 'data' update, \r\n // otherwise we overwrite the storage with just the single field.\r\n saveData('onChange', stepId, newData); \r\n }\r\n return newData;\r\n });\r\n }, [persistenceMode, saveData]);\r\n\r\n // Action: Handle specific field change (helper)\r\n const handleStepChange = useCallback((field: string, value: any) => {\r\n if (!currentStepId) return;\r\n setStepData(currentStepId, { [field]: value });\r\n }, [currentStepId, setStepData]);\r\n \r\n // Validation Logic\r\n const validateStep = useCallback(async (stepId: string): Promise<boolean> => {\r\n const step = config.steps.find(s => s.id === stepId);\r\n if (!step) return true;\r\n \r\n // Check if adapter exists\r\n if (!step.validationAdapter) return true;\r\n\r\n const result = await step.validationAdapter.validate(wizardData);\r\n \r\n if (!result.isValid) {\r\n setAllErrors(prev => ({\r\n ...prev,\r\n [stepId]: result.errors || {}\r\n }));\r\n setErrorSteps(prev => new Set(prev).add(stepId));\r\n return false;\r\n } else {\r\n setAllErrors(prev => {\r\n const next = { ...prev };\r\n delete next[stepId];\r\n return next;\r\n });\r\n setErrorSteps(prev => {\r\n const next = new Set(prev);\r\n next.delete(stepId);\r\n return next;\r\n });\r\n return true;\r\n }\r\n }, [config.steps, wizardData]);\r\n\r\n const validateAll = useCallback(async (): Promise<boolean> => {\r\n let isValid = true;\r\n for (const step of activeSteps) {\r\n const stepValid = await validateStep(step.id);\r\n if (!stepValid) isValid = false;\r\n }\r\n return isValid;\r\n }, [activeSteps, validateStep]);\r\n\r\n // Navigation\r\n const goToStep = useCallback(async (stepId: string): Promise<boolean> => {\r\n const targetIndex = activeSteps.findIndex(s => s.id === stepId);\r\n if (targetIndex === -1) return false;\r\n\r\n // If moving forward, validate current\r\n if (targetIndex > currentStepIndex) {\r\n const shouldValidate = currentStep?.autoValidate ?? config.autoValidate ?? true;\r\n if (shouldValidate) {\r\n const isValid = await validateStep(currentStepId);\r\n if (!isValid) return false; // Block\r\n }\r\n }\r\n \r\n // Save current step data logic\r\n if (persistenceMode === 'onStepChange' && currentStep) {\r\n saveData('onStepChange', currentStepId, wizardData); \r\n }\r\n\r\n // Update State\r\n const nextVisited = new Set(visitedSteps).add(currentStepId);\r\n setVisitedSteps(nextVisited);\r\n setCurrentStepId(stepId);\r\n \r\n // Persist Metadata (New Step Position)\r\n // We need to pass the *new* values because state updates are async\r\n if (persistenceMode !== 'manual') {\r\n persistenceAdapter.saveStep(META_KEY, {\r\n currentStepId: stepId,\r\n visited: Array.from(nextVisited),\r\n completed: Array.from(completedSteps)\r\n });\r\n }\r\n\r\n window.scrollTo(0, 0);\r\n return true;\r\n }, [activeSteps, currentStepId, currentStep, currentStepIndex, config.autoValidate, persistenceMode, saveData, wizardData, validateStep, visitedSteps, completedSteps, persistenceAdapter]);\r\n\r\n const goToNextStep = useCallback(async () => {\r\n if (isLastStep) return;\r\n const nextStep = activeSteps[currentStepIndex + 1];\r\n if (nextStep) {\r\n // Validation happens inside goToStep. If it fails, we shouldn't mark as completed.\r\n const success = await goToStep(nextStep.id);\r\n \r\n if (success) {\r\n // Mark completed logic ONLY on success\r\n const nextCompleted = new Set(completedSteps).add(currentStepId);\r\n setCompletedSteps(nextCompleted);\r\n \r\n // We need to update metadata again to include the new 'completed' status.\r\n // The previous save in goToStep didn't know about this new completion.\r\n if (persistenceMode !== 'manual') {\r\n persistenceAdapter.saveStep(META_KEY, {\r\n currentStepId: nextStep.id,\r\n visited: Array.from(new Set(visitedSteps).add(currentStepId)),\r\n completed: Array.from(nextCompleted) // Updated completed steps\r\n });\r\n }\r\n }\r\n }\r\n }, [activeSteps, currentStepIndex, isLastStep, currentStepId, goToStep, visitedSteps, completedSteps, persistenceMode, persistenceAdapter]);\r\n\r\n const goToPrevStep = useCallback(() => {\r\n if (isFirstStep) return;\r\n const prevStep = activeSteps[currentStepIndex - 1];\r\n if (prevStep) {\r\n goToStep(prevStep.id);\r\n }\r\n }, [activeSteps, currentStepIndex, isFirstStep, goToStep]);\r\n\r\n // Context Value\r\n const value = {\r\n currentStep,\r\n currentStepIndex,\r\n isFirstStep,\r\n isLastStep,\r\n isLoading,\r\n activeSteps,\r\n wizardData,\r\n allErrors,\r\n visitedSteps,\r\n completedSteps,\r\n errorSteps,\r\n goToNextStep,\r\n goToPrevStep,\r\n goToStep,\r\n setStepData,\r\n handleStepChange,\r\n validateStep,\r\n validateAll,\r\n save: () => saveData('manual', currentStepId, wizardData),\r\n clearStorage: () => persistenceAdapter.clear(),\r\n };\r\n\r\n return <WizardContext.Provider value={value}>{children}</WizardContext.Provider>;\r\n}\r\n\r\nexport function useWizardContext<T = any>() {\r\n const context = useContext(WizardContext);\r\n if (!context) {\r\n throw new Error('useWizardContext must be used within a WizardProvider');\r\n }\r\n return context as IWizardContext<T>;\r\n}\r\n","import type { IPersistenceAdapter } from '../../types';\r\n\r\nexport class MemoryAdapter implements IPersistenceAdapter {\r\n private storage: Record<string, any> = {};\r\n\r\n saveStep<T>(stepId: string, data: T): void {\r\n this.storage[stepId] = data;\r\n }\r\n\r\n getStep<T>(stepId: string): T | undefined {\r\n return this.storage[stepId] as T;\r\n }\r\n\r\n clear(): void {\r\n this.storage = {};\r\n }\r\n}\r\n","import { useWizardContext } from '../context/WizardContext';\r\n\r\nexport const useWizard = <T = any>() => {\r\n return useWizardContext<T>();\r\n};\r\n","import type { IPersistenceAdapter } from '../../types';\r\n\r\nexport class LocalStorageAdapter implements IPersistenceAdapter {\r\n private prefix: string;\r\n\r\n constructor(prefix: string = 'wizard_') {\r\n this.prefix = prefix;\r\n }\r\n\r\n private getKey(stepId: string): string {\r\n return `${this.prefix}${stepId}`;\r\n }\r\n\r\n saveStep<T>(stepId: string, data: T): void {\r\n if (typeof window === 'undefined') return;\r\n try {\r\n localStorage.setItem(this.getKey(stepId), JSON.stringify(data));\r\n } catch (error) {\r\n console.warn('LocalStorageAdapter: Failed to save step', error);\r\n }\r\n }\r\n\r\n getStep<T>(stepId: string): T | undefined {\r\n if (typeof window === 'undefined') return undefined;\r\n try {\r\n const item = localStorage.getItem(this.getKey(stepId));\r\n return item ? JSON.parse(item) : undefined;\r\n } catch (error) {\r\n console.warn('LocalStorageAdapter: Failed to get step', error);\r\n return undefined;\r\n }\r\n }\r\n\r\n clear(): void {\r\n if (typeof window === 'undefined') return;\r\n Object.keys(localStorage).forEach((key) => {\r\n if (key.startsWith(this.prefix)) {\r\n localStorage.removeItem(key);\r\n }\r\n });\r\n }\r\n}\r\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\r\nimport { ZodType } from 'zod';\r\n\r\nexport class ZodAdapter<T> implements IValidatorAdapter<T> {\r\n private schema: ZodType<T>;\r\n\r\n constructor(schema: ZodType<T>) {\r\n this.schema = schema;\r\n }\r\n\r\n async validate(data: T): Promise<ValidationResult> {\r\n const result = await this.schema.safeParseAsync(data);\r\n if (result.success) {\r\n return { isValid: true };\r\n }\r\n\r\n // Explicitly handle error case\r\n const errors: Record<string, string> = {};\r\n result.error.issues.forEach((err) => {\r\n const path = err.path.join('.'); // nested.field\r\n errors[path] = err.message;\r\n });\r\n return { isValid: false, errors };\r\n }\r\n}\r\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\r\nimport { Schema, ValidationError } from 'yup';\r\n\r\nexport class YupAdapter<T> implements IValidatorAdapter<T> {\r\n private schema: Schema<T>;\r\n\r\n constructor(schema: Schema<T>) {\r\n this.schema = schema;\r\n }\r\n\r\n async validate(data: T): Promise<ValidationResult> {\r\n try {\r\n await this.schema.validate(data, { abortEarly: false });\r\n return { isValid: true };\r\n } catch (err) {\r\n if (err instanceof ValidationError) {\r\n const errors: Record<string, string> = {};\r\n err.inner.forEach((error) => {\r\n if (error.path) {\r\n errors[error.path] = error.message;\r\n }\r\n });\r\n return { isValid: false, errors };\r\n }\r\n throw err;\r\n }\r\n }\r\n}\r\n"],"mappings":"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","names":["value"]}
|
|
1
|
+
{"version":3,"sources":["../src/context/WizardContext.tsx","../src/adapters/persistence/MemoryAdapter.ts","../src/hooks/useWizard.ts","../src/adapters/persistence/LocalStorageAdapter.ts","../src/adapters/validation/ZodAdapter.ts","../src/adapters/validation/YupAdapter.ts"],"sourcesContent":["import React, { createContext, useContext, useEffect, useMemo, useState, useCallback } from 'react';\nimport type {\n IWizardConfig,\n IWizardContext,\n PersistenceMode,\n IPersistenceAdapter,\n} from '../types';\nimport { MemoryAdapter } from '../adapters/persistence/MemoryAdapter';\n\nconst WizardContext = createContext<IWizardContext<any> | undefined>(undefined);\n\ninterface WizardProviderProps<T> {\n config: IWizardConfig<T>;\n initialData?: T;\n children: React.ReactNode;\n}\n\nexport function WizardProvider<T extends Record<string, any>>({\n config,\n initialData,\n children,\n}: WizardProviderProps<T>) {\n const [currentStepId, setCurrentStepId] = useState<string>('');\n const [wizardData, setWizardData] = useState<T>((initialData || {}) as T);\n const [visitedSteps, setVisitedSteps] = useState<Set<string>>(new Set());\n const [completedSteps, setCompletedSteps] = useState<Set<string>>(new Set());\n const [errorSteps, setErrorSteps] = useState<Set<string>>(new Set());\n const [allErrors, setAllErrors] = useState<Record<string, Record<string, string>>>({});\n const [isLoading, setIsLoading] = useState<boolean>(true);\n\n // Persistence Setup\n const persistenceAdapter = useMemo<IPersistenceAdapter>(() => {\n return config.persistence?.adapter || new MemoryAdapter();\n }, [config.persistence?.adapter]);\n\n const persistenceMode = config.persistence?.mode || 'onStepChange';\n\n // Calculate Active Steps (Conditional Logic)\n const activeSteps = useMemo(() => {\n return config.steps.filter((step) => {\n if (step.condition) {\n return step.condition(wizardData);\n }\n return true;\n });\n }, [config.steps, wizardData]);\n\n // Set initial step if not set\n useEffect(() => {\n if (!currentStepId && activeSteps.length > 0) {\n setCurrentStepId(activeSteps[0].id);\n setIsLoading(false);\n }\n }, [activeSteps, currentStepId]);\n\n // Derived state\n const currentStep = useMemo(() => activeSteps.find((s) => s.id === currentStepId) || null, [activeSteps, currentStepId]);\n const currentStepIndex = useMemo(() => activeSteps.findIndex((s) => s.id === currentStepId), [activeSteps, currentStepId]);\n const isFirstStep = currentStepIndex === 0;\n const isLastStep = currentStepIndex === activeSteps.length - 1;\n\n // Constants\n const META_KEY = '__wizzard_meta__';\n\n // Hydration Helper\n const hydrate = useCallback(() => {\n setIsLoading(true);\n \n // 1. Load Metadata (Current Step, Visited, etc.)\n const metaFn = persistenceAdapter.getStep<{\n currentStepId: string;\n visited: string[];\n completed: string[];\n }>(META_KEY);\n\n if (metaFn) {\n if (metaFn.currentStepId) setCurrentStepId(metaFn.currentStepId);\n if (metaFn.visited) setVisitedSteps(new Set(metaFn.visited));\n if (metaFn.completed) setCompletedSteps(new Set(metaFn.completed));\n }\n\n // 2. Load Data\n // We assume data is distributed across steps OR stored centrally.\n // Given the current implementation saves 'wizardData' to each stepId, \n // we can iterate steps.\n const loadedData: Partial<T> = {};\n config.steps.forEach(step => {\n const stepData = persistenceAdapter.getStep(step.id);\n if (stepData) {\n Object.assign(loadedData, stepData);\n }\n });\n\n if (Object.keys(loadedData).length > 0) {\n setWizardData(prev => ({ ...prev, ...loadedData }));\n }\n setIsLoading(false);\n }, [config.steps, persistenceAdapter]);\n\n useEffect(() => {\n hydrate();\n }, [hydrate]);\n\n // Save logic\n const saveData = useCallback((mode: PersistenceMode, stepId: string, data: any) => {\n if (mode === persistenceMode || mode === 'manual') {\n persistenceAdapter.saveStep(stepId, data);\n \n // Also save metadata whenever we save data (if appropriate)\n // Or we can save metadata explicitly on navigation.\n }\n }, [persistenceAdapter, persistenceMode]);\n\n // Explicit Metadata Save\n\n // Action: Set Step Data\n const setStepData = useCallback((stepId: string, data: any) => {\n setWizardData((prev) => {\n const newData = { ...prev, ...data };\n // Save if mode is 'onChange'\n if (persistenceMode === 'onChange') {\n // We must save the FULL new data, not just the partial 'data' update, \n // otherwise we overwrite the storage with just the single field.\n saveData('onChange', stepId, newData); \n }\n return newData;\n });\n }, [persistenceMode, saveData]);\n\n // Action: Handle specific field change (helper)\n const handleStepChange = useCallback((field: string, value: any) => {\n if (!currentStepId) return;\n setStepData(currentStepId, { [field]: value });\n }, [currentStepId, setStepData]);\n \n // Validation Logic\n const validateStep = useCallback(async (stepId: string): Promise<boolean> => {\n const step = config.steps.find(s => s.id === stepId);\n if (!step) return true;\n \n // Check if adapter exists\n if (!step.validationAdapter) return true;\n\n const result = await step.validationAdapter.validate(wizardData);\n \n if (!result.isValid) {\n setAllErrors(prev => ({\n ...prev,\n [stepId]: result.errors || {}\n }));\n setErrorSteps(prev => new Set(prev).add(stepId));\n return false;\n } else {\n setAllErrors(prev => {\n const next = { ...prev };\n delete next[stepId];\n return next;\n });\n setErrorSteps(prev => {\n const next = new Set(prev);\n next.delete(stepId);\n return next;\n });\n return true;\n }\n }, [config.steps, wizardData]);\n\n const validateAll = useCallback(async (): Promise<boolean> => {\n let isValid = true;\n for (const step of activeSteps) {\n const stepValid = await validateStep(step.id);\n if (!stepValid) isValid = false;\n }\n return isValid;\n }, [activeSteps, validateStep]);\n\n // Navigation\n const goToStep = useCallback(async (stepId: string): Promise<boolean> => {\n const targetIndex = activeSteps.findIndex(s => s.id === stepId);\n if (targetIndex === -1) return false;\n\n // If moving forward, validate current\n if (targetIndex > currentStepIndex) {\n const shouldValidate = currentStep?.autoValidate ?? config.autoValidate ?? true;\n if (shouldValidate) {\n const isValid = await validateStep(currentStepId);\n if (!isValid) return false; // Block\n }\n }\n \n // Save current step data logic\n if (persistenceMode === 'onStepChange' && currentStep) {\n saveData('onStepChange', currentStepId, wizardData); \n }\n\n // Update State\n const nextVisited = new Set(visitedSteps).add(currentStepId);\n setVisitedSteps(nextVisited);\n setCurrentStepId(stepId);\n \n // Persist Metadata (New Step Position)\n // We need to pass the *new* values because state updates are async\n if (persistenceMode !== 'manual') {\n persistenceAdapter.saveStep(META_KEY, {\n currentStepId: stepId,\n visited: Array.from(nextVisited),\n completed: Array.from(completedSteps)\n });\n }\n\n window.scrollTo(0, 0);\n return true;\n }, [activeSteps, currentStepId, currentStep, currentStepIndex, config.autoValidate, persistenceMode, saveData, wizardData, validateStep, visitedSteps, completedSteps, persistenceAdapter]);\n\n const goToNextStep = useCallback(async () => {\n if (isLastStep) return;\n const nextStep = activeSteps[currentStepIndex + 1];\n if (nextStep) {\n // Validation happens inside goToStep. If it fails, we shouldn't mark as completed.\n const success = await goToStep(nextStep.id);\n \n if (success) {\n // Mark completed logic ONLY on success\n const nextCompleted = new Set(completedSteps).add(currentStepId);\n setCompletedSteps(nextCompleted);\n \n // We need to update metadata again to include the new 'completed' status.\n // The previous save in goToStep didn't know about this new completion.\n if (persistenceMode !== 'manual') {\n persistenceAdapter.saveStep(META_KEY, {\n currentStepId: nextStep.id,\n visited: Array.from(new Set(visitedSteps).add(currentStepId)),\n completed: Array.from(nextCompleted) // Updated completed steps\n });\n }\n }\n }\n }, [activeSteps, currentStepIndex, isLastStep, currentStepId, goToStep, visitedSteps, completedSteps, persistenceMode, persistenceAdapter]);\n\n const goToPrevStep = useCallback(() => {\n if (isFirstStep) return;\n const prevStep = activeSteps[currentStepIndex - 1];\n if (prevStep) {\n goToStep(prevStep.id);\n }\n }, [activeSteps, currentStepIndex, isFirstStep, goToStep]);\n\n // Context Value\n const value = {\n currentStep,\n currentStepIndex,\n isFirstStep,\n isLastStep,\n isLoading,\n activeSteps,\n wizardData,\n allErrors,\n visitedSteps,\n completedSteps,\n errorSteps,\n goToNextStep,\n goToPrevStep,\n goToStep,\n setStepData,\n handleStepChange,\n validateStep,\n validateAll,\n save: () => saveData('manual', currentStepId, wizardData),\n clearStorage: () => persistenceAdapter.clear(),\n };\n\n return <WizardContext.Provider value={value}>{children}</WizardContext.Provider>;\n}\n\nexport function useWizardContext<T = any>() {\n const context = useContext(WizardContext);\n if (!context) {\n throw new Error('useWizardContext must be used within a WizardProvider');\n }\n return context as IWizardContext<T>;\n}\n","import type { IPersistenceAdapter } from '../../types';\n\nexport class MemoryAdapter implements IPersistenceAdapter {\n private storage: Record<string, any> = {};\n\n saveStep<T>(stepId: string, data: T): void {\n this.storage[stepId] = data;\n }\n\n getStep<T>(stepId: string): T | undefined {\n return this.storage[stepId] as T;\n }\n\n clear(): void {\n this.storage = {};\n }\n}\n","import { useWizardContext } from '../context/WizardContext';\n\nexport const useWizard = <T = any>() => {\n return useWizardContext<T>();\n};\n","import type { IPersistenceAdapter } from '../../types';\n\nexport class LocalStorageAdapter implements IPersistenceAdapter {\n private prefix: string;\n\n constructor(prefix: string = 'wizard_') {\n this.prefix = prefix;\n }\n\n private getKey(stepId: string): string {\n return `${this.prefix}${stepId}`;\n }\n\n saveStep<T>(stepId: string, data: T): void {\n if (typeof window === 'undefined') return;\n try {\n localStorage.setItem(this.getKey(stepId), JSON.stringify(data));\n } catch (error) {\n console.warn('LocalStorageAdapter: Failed to save step', error);\n }\n }\n\n getStep<T>(stepId: string): T | undefined {\n if (typeof window === 'undefined') return undefined;\n try {\n const item = localStorage.getItem(this.getKey(stepId));\n return item ? JSON.parse(item) : undefined;\n } catch (error) {\n console.warn('LocalStorageAdapter: Failed to get step', error);\n return undefined;\n }\n }\n\n clear(): void {\n if (typeof window === 'undefined') return;\n Object.keys(localStorage).forEach((key) => {\n if (key.startsWith(this.prefix)) {\n localStorage.removeItem(key);\n }\n });\n }\n}\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\nimport { ZodType } from 'zod';\n\nexport class ZodAdapter<T> implements IValidatorAdapter<T> {\n private schema: ZodType<T>;\n\n constructor(schema: ZodType<T>) {\n this.schema = schema;\n }\n\n async validate(data: T): Promise<ValidationResult> {\n const result = await this.schema.safeParseAsync(data);\n if (result.success) {\n return { isValid: true };\n }\n\n // Explicitly handle error case\n const errors: Record<string, string> = {};\n result.error.issues.forEach((err) => {\n const path = err.path.join('.'); // nested.field\n errors[path] = err.message;\n });\n return { isValid: false, errors };\n }\n}\n","import type { IValidatorAdapter, ValidationResult } from '../../types';\nimport { Schema, ValidationError } from 'yup';\n\nexport class YupAdapter<T> implements IValidatorAdapter<T> {\n private schema: Schema<T>;\n\n constructor(schema: Schema<T>) {\n this.schema = schema;\n }\n\n async validate(data: T): Promise<ValidationResult> {\n try {\n await this.schema.validate(data, { abortEarly: false });\n return { isValid: true };\n } catch (err) {\n if (err instanceof ValidationError) {\n const errors: Record<string, string> = {};\n err.inner.forEach((error) => {\n if (error.path) {\n errors[error.path] = error.message;\n }\n });\n return { isValid: false, errors };\n }\n throw err;\n }\n }\n}\n"],"mappings":"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","names":["value"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wizzard-stepper-react",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
4
4
|
"description": "A flexible, headless, and strictly typed multi-step wizard library for React.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -29,9 +29,10 @@
|
|
|
29
29
|
"url": "git+https://github.com/ZizzX/wizzard-stepper-react.git"
|
|
30
30
|
},
|
|
31
31
|
"bugs": {
|
|
32
|
-
"url": "https://github.com/ZizzX/wizzard-stepper-react/issues"
|
|
32
|
+
"url": "https://github.com/ZizzX/wizzard-stepper-react/issues",
|
|
33
|
+
"email": "zizzxiii@gmail.com"
|
|
33
34
|
},
|
|
34
|
-
"homepage": "https://github.
|
|
35
|
+
"homepage": "https://zizzx.github.io/wizzard-stepper-react-demo/",
|
|
35
36
|
"peerDependencies": {
|
|
36
37
|
"react": ">=16.8.0",
|
|
37
38
|
"react-dom": ">=16.8.0",
|