@clikvn/showroom-visualizer 0.3.0-dev-07 → 0.3.0-dev-08
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/CLAUDE.md +19 -14
- package/README.md +190 -33
- package/dist/commons/SkinLayer/components/CardItemGroup/Item.d.ts.map +1 -1
- package/dist/components/SkinLayer/ActionsChangeScene/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/Floorplan/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/Guide/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/PlayBar/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/PoiDetailSlideIn/Detail.d.ts.map +1 -1
- package/dist/components/SkinLayer/PoiDetailSlideIn/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/ScenarioList/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/SearchAndDiscoverySlideIn/ContentItem/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/SearchAndDiscoverySlideIn/PromotionPart/index.d.ts.map +1 -1
- package/dist/components/SkinLayer/SearchAndDiscoverySlideIn/ScenariosPart/Item.d.ts.map +1 -1
- package/dist/components/SkinLayer/SearchAndDiscoverySlideIn/index.d.ts.map +1 -1
- package/dist/hooks/useActionMiddleware.d.ts +1 -1
- package/dist/hooks/useActionMiddleware.d.ts.map +1 -1
- package/dist/types/SkinLayer/middleware.type.d.ts +1 -0
- package/dist/types/SkinLayer/middleware.type.d.ts.map +1 -1
- package/dist/web.js +1 -1
- package/package.json +1 -1
- package/Planning/README-middleware.md +0 -582
- package/Planning/README.md +0 -67
- package/Planning/TEMPLATE.md +0 -270
package/Planning/TEMPLATE.md
DELETED
|
@@ -1,270 +0,0 @@
|
|
|
1
|
-
# [Feature Name]
|
|
2
|
-
|
|
3
|
-
> **Status:** Planning | In Progress | Completed
|
|
4
|
-
> **Version:** 0.x.0
|
|
5
|
-
> **Last Updated:** YYYY-MM-DD
|
|
6
|
-
|
|
7
|
-
## Overview
|
|
8
|
-
|
|
9
|
-
Brief description of what this feature does and why it's needed.
|
|
10
|
-
|
|
11
|
-
**Key Benefits:**
|
|
12
|
-
|
|
13
|
-
- Benefit 1
|
|
14
|
-
- Benefit 2
|
|
15
|
-
- Benefit 3
|
|
16
|
-
|
|
17
|
-
## Quick Start
|
|
18
|
-
|
|
19
|
-
```typescript
|
|
20
|
-
// Basic usage example
|
|
21
|
-
import ShowroomVisualizer from '@clikvn/showroom-visualizer';
|
|
22
|
-
|
|
23
|
-
ShowroomVisualizer.initVisualizer({
|
|
24
|
-
apiHost: 'https://api.example.com',
|
|
25
|
-
config: { tourCode: 'TOUR_123' },
|
|
26
|
-
|
|
27
|
-
// Feature-specific configuration
|
|
28
|
-
featureName: {
|
|
29
|
-
option1: 'value1',
|
|
30
|
-
option2: true,
|
|
31
|
-
},
|
|
32
|
-
});
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
## Requirements
|
|
36
|
-
|
|
37
|
-
### Functional Requirements
|
|
38
|
-
|
|
39
|
-
- [ ] Requirement 1
|
|
40
|
-
- [ ] Requirement 2
|
|
41
|
-
- [ ] Requirement 3
|
|
42
|
-
|
|
43
|
-
### Non-Functional Requirements
|
|
44
|
-
|
|
45
|
-
- [ ] Performance: [target metrics]
|
|
46
|
-
- [ ] Backward compatibility: [yes/no and details]
|
|
47
|
-
- [ ] Browser support: [supported browsers]
|
|
48
|
-
|
|
49
|
-
## API Reference
|
|
50
|
-
|
|
51
|
-
### Types
|
|
52
|
-
|
|
53
|
-
```typescript
|
|
54
|
-
/**
|
|
55
|
-
* Description of the type
|
|
56
|
-
*/
|
|
57
|
-
export interface FeatureType {
|
|
58
|
-
/** Description */
|
|
59
|
-
property1: string;
|
|
60
|
-
/** Description */
|
|
61
|
-
property2?: number;
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
/**
|
|
65
|
-
* Description of the function type
|
|
66
|
-
*/
|
|
67
|
-
export type FeatureCallback = (param: FeatureType) => void;
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
### Configuration Options
|
|
71
|
-
|
|
72
|
-
| Option | Type | Required | Default | Description |
|
|
73
|
-
| --------- | --------- | -------- | ------- | ----------- |
|
|
74
|
-
| `option1` | `string` | Yes | - | Description |
|
|
75
|
-
| `option2` | `boolean` | No | `false` | Description |
|
|
76
|
-
| `option3` | `number` | No | `100` | Description |
|
|
77
|
-
|
|
78
|
-
### Methods
|
|
79
|
-
|
|
80
|
-
#### `methodName(param: Type): ReturnType`
|
|
81
|
-
|
|
82
|
-
Description of what the method does.
|
|
83
|
-
|
|
84
|
-
**Parameters:**
|
|
85
|
-
|
|
86
|
-
- `param` (Type) - Description
|
|
87
|
-
|
|
88
|
-
**Returns:**
|
|
89
|
-
|
|
90
|
-
- `ReturnType` - Description
|
|
91
|
-
|
|
92
|
-
**Example:**
|
|
93
|
-
|
|
94
|
-
```typescript
|
|
95
|
-
const result = tool.methodName('value');
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
## Architecture
|
|
99
|
-
|
|
100
|
-
### Component Hierarchy
|
|
101
|
-
|
|
102
|
-
```
|
|
103
|
-
ShowroomVisualizer
|
|
104
|
-
├── FeatureComponent
|
|
105
|
-
│ ├── SubComponent1
|
|
106
|
-
│ └── SubComponent2
|
|
107
|
-
└── AnotherComponent
|
|
108
|
-
```
|
|
109
|
-
|
|
110
|
-
### Data Flow
|
|
111
|
-
|
|
112
|
-
```
|
|
113
|
-
User Action → Component → Hook → Model → State Update → UI Render
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
### Key Files
|
|
117
|
-
|
|
118
|
-
- `src/types/SkinLayer/feature.type.ts` - Type definitions
|
|
119
|
-
- `src/hooks/useFeature.ts` - Custom hook
|
|
120
|
-
- `src/components/FeatureComponent/index.tsx` - Main component
|
|
121
|
-
- `src/models/Feature.ts` - Business logic model
|
|
122
|
-
|
|
123
|
-
### Integration Points
|
|
124
|
-
|
|
125
|
-
1. **Configuration Provider**: How the feature integrates with configuration
|
|
126
|
-
2. **State Management**: Which state it manages
|
|
127
|
-
3. **Event System**: What events it listens to/dispatches
|
|
128
|
-
|
|
129
|
-
## Implementation Plan
|
|
130
|
-
|
|
131
|
-
### Phase 1: Core Implementation
|
|
132
|
-
|
|
133
|
-
- [ ] Create type definitions
|
|
134
|
-
- [ ] Implement core hook
|
|
135
|
-
- [ ] Add component integration
|
|
136
|
-
- [ ] Unit tests
|
|
137
|
-
|
|
138
|
-
### Phase 2: UI Integration
|
|
139
|
-
|
|
140
|
-
- [ ] Add UI components
|
|
141
|
-
- [ ] Style implementation
|
|
142
|
-
- [ ] Mobile responsiveness
|
|
143
|
-
- [ ] Integration tests
|
|
144
|
-
|
|
145
|
-
### Phase 3: Documentation & Release
|
|
146
|
-
|
|
147
|
-
- [ ] API documentation
|
|
148
|
-
- [ ] Usage examples
|
|
149
|
-
- [ ] Migration guide (if breaking changes)
|
|
150
|
-
- [ ] Update CHANGELOG
|
|
151
|
-
|
|
152
|
-
## Usage Examples
|
|
153
|
-
|
|
154
|
-
### Example 1: Basic Usage
|
|
155
|
-
|
|
156
|
-
```typescript
|
|
157
|
-
import ShowroomVisualizer from '@clikvn/showroom-visualizer';
|
|
158
|
-
|
|
159
|
-
ShowroomVisualizer.initVisualizer({
|
|
160
|
-
apiHost: 'https://api.example.com',
|
|
161
|
-
config: { tourCode: 'TOUR_123' },
|
|
162
|
-
feature: {
|
|
163
|
-
// configuration
|
|
164
|
-
},
|
|
165
|
-
});
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
### Example 2: Advanced Usage
|
|
169
|
-
|
|
170
|
-
```typescript
|
|
171
|
-
// More complex example
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
### Example 3: Integration with Other Features
|
|
175
|
-
|
|
176
|
-
```typescript
|
|
177
|
-
// Example showing how it works with other features
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
## Error Handling
|
|
181
|
-
|
|
182
|
-
### Common Errors
|
|
183
|
-
|
|
184
|
-
| Error Code | Description | Solution |
|
|
185
|
-
| ---------- | ----------- | ---------- |
|
|
186
|
-
| `ERR_001` | Description | How to fix |
|
|
187
|
-
| `ERR_002` | Description | How to fix |
|
|
188
|
-
|
|
189
|
-
### Best Practices
|
|
190
|
-
|
|
191
|
-
- Best practice 1
|
|
192
|
-
- Best practice 2
|
|
193
|
-
- Best practice 3
|
|
194
|
-
|
|
195
|
-
## Performance Considerations
|
|
196
|
-
|
|
197
|
-
- Performance note 1
|
|
198
|
-
- Performance note 2
|
|
199
|
-
- Benchmark: [metrics]
|
|
200
|
-
|
|
201
|
-
## Browser Compatibility
|
|
202
|
-
|
|
203
|
-
| Browser | Minimum Version | Notes |
|
|
204
|
-
| ------- | --------------- | --------------- |
|
|
205
|
-
| Chrome | 90+ | Fully supported |
|
|
206
|
-
| Firefox | 88+ | Fully supported |
|
|
207
|
-
| Safari | 14+ | Fully supported |
|
|
208
|
-
| Edge | 90+ | Fully supported |
|
|
209
|
-
|
|
210
|
-
## Migration Guide
|
|
211
|
-
|
|
212
|
-
### From Version X to Y
|
|
213
|
-
|
|
214
|
-
If this feature introduces breaking changes:
|
|
215
|
-
|
|
216
|
-
**Breaking Changes:**
|
|
217
|
-
|
|
218
|
-
1. Change 1
|
|
219
|
-
2. Change 2
|
|
220
|
-
|
|
221
|
-
**Migration Steps:**
|
|
222
|
-
|
|
223
|
-
```typescript
|
|
224
|
-
// Before
|
|
225
|
-
oldApi();
|
|
226
|
-
|
|
227
|
-
// After
|
|
228
|
-
newApi();
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
## Testing
|
|
232
|
-
|
|
233
|
-
### Unit Tests
|
|
234
|
-
|
|
235
|
-
- Test case 1
|
|
236
|
-
- Test case 2
|
|
237
|
-
|
|
238
|
-
### Integration Tests
|
|
239
|
-
|
|
240
|
-
- Test case 1
|
|
241
|
-
- Test case 2
|
|
242
|
-
|
|
243
|
-
### Manual Testing Checklist
|
|
244
|
-
|
|
245
|
-
- [ ] Test scenario 1
|
|
246
|
-
- [ ] Test scenario 2
|
|
247
|
-
- [ ] Test on mobile
|
|
248
|
-
- [ ] Test on desktop
|
|
249
|
-
|
|
250
|
-
## FAQ
|
|
251
|
-
|
|
252
|
-
**Q: Question 1?**
|
|
253
|
-
A: Answer 1
|
|
254
|
-
|
|
255
|
-
**Q: Question 2?**
|
|
256
|
-
A: Answer 2
|
|
257
|
-
|
|
258
|
-
## References
|
|
259
|
-
|
|
260
|
-
- [Related documentation](link)
|
|
261
|
-
- [External resource](link)
|
|
262
|
-
- [API specification](link)
|
|
263
|
-
|
|
264
|
-
## Changelog
|
|
265
|
-
|
|
266
|
-
### Version 0.x.0 (YYYY-MM-DD)
|
|
267
|
-
|
|
268
|
-
- Initial implementation
|
|
269
|
-
- Feature 1 added
|
|
270
|
-
- Bug fix 1
|