@royaloperahouse/chord 2.2.6 → 2.2.7-a-chord-development

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.
Files changed (36) hide show
  1. package/CHANGELOG.md +213 -7
  2. package/README.md +250 -40
  3. package/dist/chord.cjs.development.js +182 -106
  4. package/dist/chord.cjs.development.js.map +1 -1
  5. package/dist/chord.cjs.production.min.js +1 -1
  6. package/dist/chord.cjs.production.min.js.map +1 -1
  7. package/dist/chord.esm.js +182 -106
  8. package/dist/chord.esm.js.map +1 -1
  9. package/dist/components/atoms/Icons/SvgIcons/Descriptors/Seat.svg.d.ts +4 -0
  10. package/dist/components/atoms/Icons/SvgIcons/Descriptors/Standing.svg.d.ts +4 -0
  11. package/dist/components/atoms/Icons/SvgIcons/Descriptors/Wheelchair.svg.d.ts +4 -0
  12. package/dist/components/atoms/Icons/SvgIcons/index.d.ts +3 -0
  13. package/dist/components/atoms/Radio/Radio.d.ts +3 -0
  14. package/dist/components/atoms/Radio2/Radio2.d.ts +23 -0
  15. package/dist/components/atoms/Radio2/Radio2.style.d.ts +7 -0
  16. package/dist/components/atoms/Radio2/index.d.ts +2 -0
  17. package/dist/components/atoms/Tickbox/Tickbox.d.ts +3 -0
  18. package/dist/components/atoms/Tickbox2/Tickbox2.d.ts +23 -0
  19. package/dist/components/atoms/Tickbox2/Tickbox2.style.d.ts +7 -0
  20. package/dist/components/atoms/Tickbox2/index.d.ts +2 -0
  21. package/dist/components/atoms/index.d.ts +3 -1
  22. package/dist/components/index.d.ts +3 -3
  23. package/dist/components/molecules/Card/Card.style.d.ts +1 -0
  24. package/dist/components/molecules/PageHeading/index.d.ts +1 -1
  25. package/dist/components/molecules/PeopleListing/CreditListing/CreditListing.style.d.ts +1 -0
  26. package/dist/components/molecules/RadioGroup/RadioGroup.d.ts +3 -0
  27. package/dist/components/molecules/RadioGroup2/RadioGroup2.d.ts +38 -0
  28. package/dist/components/molecules/RadioGroup2/RadioGroup2.style.d.ts +4 -0
  29. package/dist/components/molecules/RadioGroup2/index.d.ts +2 -0
  30. package/dist/components/molecules/index.d.ts +3 -2
  31. package/dist/index.d.ts +3 -2
  32. package/dist/types/card.d.ts +4 -0
  33. package/dist/types/formTypes.d.ts +125 -10
  34. package/dist/types/passwordStrength.d.ts +6 -6
  35. package/package.json +1 -1
  36. package/README.GIT +0 -277
package/CHANGELOG.md CHANGED
@@ -1,3 +1,6 @@
1
+ ## [2.2.7]
2
+ - Add new seat-type icons
3
+
1
4
  ## [2.2.6]
2
5
  - TextField: minor style fixes
3
6
 
@@ -19,121 +22,172 @@
19
22
  - Read More Component
20
23
 
21
24
  ## [2.2.0]
25
+
22
26
  - Fix Grid bug introduced in 2.1.9
23
27
 
24
28
  ## [2.1.10]
29
+
25
30
  - Add missing export for `CreditListing`
26
31
 
27
32
  ## [2.1.9]
33
+
28
34
  - Add Credit Listing
29
35
 
30
36
  ## [2.1.8]
37
+
31
38
  - Add Branding Link to Compact Header
32
39
 
33
40
  ## [2.1.7]
41
+
34
42
  - Footer updates
35
43
 
36
44
  ## [2.1.6]
45
+
37
46
  - Add X logo
38
47
 
39
48
  ## [2.1.5]
40
- - Revert search error caused by previous version
49
+
50
+ - Patch search bar hidden fix
41
51
 
42
52
  ## [2.1.4]
53
+
43
54
  - Fix screenreader accessibility for accordions
44
55
 
45
56
  ## [2.1.3]
57
+
46
58
  - Navigation: make links links
47
59
  - Clear testing errors
48
60
 
49
61
  ## [2.1.2]
62
+
50
63
  - TextField: include optional width param
51
64
 
52
65
  ## [2.1.1]
66
+
53
67
  - AnchorTabBar: change grid, to move tabs to the center
54
68
 
55
69
  ## [2.1.0]
70
+
56
71
  - Convert Pagination to href instead of React Router Link
57
72
 
58
73
  ## [2.0.0]
74
+
59
75
  - Remove swiper dependency
76
+
60
77
  ## [1.28.0]
78
+
61
79
  - Add new RadioGroup component
62
80
  - Progress: add the steps
63
81
  - Compact header: hide CTA if the prop is undefined
64
82
  - Compact header: change highlight color for Stream variant
65
83
 
66
84
  ## [1.27.1]
85
+
67
86
  - Fixed failing test on timer component
68
87
 
69
88
  ## [1.27.0]
89
+
70
90
  - ContentSummary component can now be configured to be fully clickable
71
91
 
72
92
  ## [1.26.0]
93
+
73
94
  - MiniCard and MinimalCarousel: add new components
74
95
 
75
96
  ## [1.25.2]
97
+
76
98
  - Now clicking on the gray overlay closes the search bar
77
99
 
78
100
  ## [1.25.1]
101
+
79
102
  - Stepper: Properly export component
80
103
 
81
104
  ## [1.25.0]
105
+
82
106
  - Stepper: Add Stepper component
83
107
 
84
108
  ## [1.24.2]
109
+
85
110
  - Increase Upsell Card Flag character limit to 30
86
111
 
87
112
  ## [1.24.1]
113
+
88
114
  - Include link field to Upsell Cards
89
115
 
90
116
  ## [1.24.0]
117
+
91
118
  - Implement Upsell Section & Upsell Cards
92
119
 
120
+ ## [1.23.2-b]
121
+
122
+ - Add Stepper component
123
+ - Fix solo negative sign NaN bug
124
+ -
125
+
93
126
  ## [1.23.2]
127
+
94
128
  - Fix BrandingStyle not showing bug
95
129
 
96
130
  ## [1.23.1]
131
+
97
132
  - Fix enum on BrandingStyle
98
133
 
99
134
  ## [1.23.0]
135
+
100
136
  - Re-enabled compact header on iOS
101
137
 
102
138
  ## [1.22.0]
139
+
103
140
  - TextArea: Added new TextArea component
104
141
  - TickBox: Added disabled and error states
105
142
 
106
143
  ## [1.21.1]
107
- - Made select state reset behaviour opt-in
144
+
145
+ - Compact PageHeading: Refactored to support iOS devices
108
146
 
109
147
  ## [1.21.0]
148
+
110
149
  - TextLogo: add new component
111
150
  - Compact PageHeading: swap logo with TextLogo to fix iOS issues
112
151
 
152
+ ## [1.20.2-a]
153
+
154
+ - Made select state reset behaviour opt-in
155
+
113
156
  ## [1.20.2]
157
+
114
158
  - Card: change cursor to default for cards without buttons
115
159
  - HighlightsCarousel: hide button in case there are no text for them
116
160
 
117
161
  ## [1.20.1]
162
+
118
163
  - Reset the select component's selected value to the first option if options change
119
164
 
120
165
  ## [1.20.0]
166
+
121
167
  - Tickbox: Add black-on-white option
168
+
122
169
  ## [1.19.0]
170
+
123
171
  - Add timer to navigation basket
172
+
124
173
  ## [1.18.3]
174
+
125
175
  - iOS devices show image instead of video for Compact PageHeading
126
176
 
127
177
  ## [1.18.1-2]
178
+
128
179
  - Fix iOS exception on VideoControls
129
180
 
130
181
  ## [1.18.0]
182
+
131
183
  - Add Compact PageHeading component
132
184
 
133
185
  ## [1.17.0]
186
+
134
187
  - Add Page Heading Panel variant
135
188
 
136
189
  ## [1.16.0]
190
+
137
191
  - Implemented a new Timer component
138
192
  - Progress: extended the component, added it to Storybook
139
193
  - PromoWithTags: added Timer component
@@ -142,290 +196,423 @@
142
196
  - Card: added label
143
197
 
144
198
  ## [1.15.1]
199
+
145
200
  - Change to pagination component to align page numbers with URL numbers.
146
201
 
147
202
  ## [1.15.0]
148
- - Implemented a new Select component
203
+
204
+ - Add Compact PageHeading component
149
205
 
150
206
  ## [1.14.0]
207
+
151
208
  - Added standfirst functionality to Accordion/ Accordions component and theme for Schools Platform
152
209
 
153
210
  ## [1.13.2]
211
+
154
212
  - Add styled-components to dev-dependencies, to fix issues with tests that appear after adding the new styled components
155
213
 
156
214
  ## [1.13.1]
215
+
157
216
  - AnchorTabBar: fix the issues on mobile devices that are related to scroll/stickiness
158
217
 
159
218
  ## [1.13.0]
219
+
160
220
  - Implemented a new TextField component
161
221
 
162
222
  ## [1.12.4]
223
+
163
224
  - Search: change copy
164
225
 
165
226
  ## [1.12.0]
227
+
166
228
  - Search: Extend ContentSummary and SearchBar components to support new search results
167
229
 
230
+ ## [1.11.0-a]
231
+
232
+ - Pagination: add new component
233
+
168
234
  ## [1.11.0]
235
+
169
236
  - Carousels: Rewrite logic that cuts description, to support older browsers
170
237
 
238
+ ## [1.10.0-a]
239
+
240
+ - ContentSummary: make image clickable
241
+
171
242
  ## [1.10.0]
243
+
172
244
  - PageHeadingImpact: Replace CSS background-image with HTML image element
173
245
 
174
246
  ## [1.9.0]
247
+
175
248
  - Card: Add a new prop for the hover line color
176
249
 
250
+ ## [1.9.0-c]
251
+
252
+ - ContentSummary: make image clickable
253
+
254
+ ## [1.9.0-b]
255
+
256
+ - ContentSummary: change image size
257
+ - SearchBar: Export component
258
+
259
+ ## [1.9.0-a]
260
+
261
+ - ContentSummary: change image props
262
+
263
+ ## [1.9.0]
264
+
265
+ - Card: Add a new prop for the hover line color
266
+
267
+ ## [1.8.1-h]
268
+
269
+ - ContentSummary: add exports
270
+
271
+ ## [1.8.1-g]
272
+
273
+ - ContentSummary: refactor
274
+
275
+ ## [1.8.1-f]
276
+
277
+ - ContentSummary: update conditional rendering
278
+
279
+ ## [1.8.1-c]
280
+
281
+ - ContentSummary: update for Search results
282
+ - ContentSummarySection: remove
283
+
284
+ ## [1.8.1-b]
285
+
286
+ - Card: add new prop for the line color on hover
287
+
177
288
  ## [1.8.0]
289
+
178
290
  - SearchBar: Disable
179
291
 
180
292
  ## [1.7.2]
293
+
181
294
  - Add imageAltText to Card component
182
295
 
183
296
  ## [1.7.0]
297
+
184
298
  - Add new ContentSummary component
185
299
  - Add new ContentSummarySection component
186
300
  - Add Content Summary Section and individual Content Summaries
187
301
 
188
302
  ## [1.6.3]
303
+
189
304
  - Add exports for zIndexes
190
305
 
191
306
  ## [1.6.2]
192
- - ImpactHeader: add alt text for sponsors logo custom image
307
+
308
+ - ImpactHeader: add alt text for sponsors logo custom image
193
309
 
194
310
  ## [1.6.1]
311
+
195
312
  - PageHeadingHighlight component: update exports
196
313
 
197
314
  ## [1.6.0]
315
+
198
316
  - Add new PageHeadingHighlight component
199
317
 
200
318
  ## [1.5.0]
319
+
201
320
  - PageHeading: decrease header height when title is not available
202
321
 
203
322
  ## [1.4.0]
323
+
204
324
  - ImpactHeader: make it possible to pass custom image as a sponsor logo
205
325
 
206
326
  ## [1.3.1]
327
+
207
328
  - Enable reduced size textLinks on PromoWithTags/asCard
208
329
 
209
330
  ## [1.3.0]
331
+
210
332
  - Add Static Actvivity Cards as PromoWithTags variant
211
333
 
212
334
  ## [1.2.0]
213
- - Card: buttons do not change position on mobiles;
335
+
336
+ - Card: buttons do not change position on mobiles;
214
337
 
215
338
  ## [1.1.0]
339
+
216
340
  - TitleWithCTA: fix cases with a long title
217
341
  - Card: add pointer cursor to container
218
342
 
219
343
  ## [0.9.0]
344
+
220
345
  - PromoWithTags: Add margin under ExtraContent iframe
221
346
 
222
347
  ## [0.8.0]
348
+
223
349
  - Card component: buttons are aligned by height
224
350
  - Highlight carousel: added possibility to display two CTAs
225
351
 
226
352
  ## [0.7.50]
353
+
227
354
  - Add Static Actvivity Cards
228
355
 
229
356
  ## [0.7.49]
357
+
230
358
  - Change button behaviour on stream and DED pages
231
359
 
232
360
  ## [0.7.48]
361
+
233
362
  - Add background themes to Information component
234
363
 
235
364
  ## [0.7.47]
365
+
236
366
  - PromoWithTags: Swap Content & ExtraContent divs to correct keyboard tab order
237
367
 
238
368
  ## [0.7.46]
369
+
239
370
  - Information: Add new Information component
240
371
 
241
372
  ## [0.7.45]
373
+
242
374
  - PromoWithTags: extend the component to handle extra content
243
375
 
244
376
  ## [0.7.441]
377
+
245
378
  - PageHeading: increase max line height for mobile devices
246
379
 
247
380
  ## [0.7.44]
381
+
248
382
  - PromoWithTags, PromoWithTitle: change grid for text content on tablet view
249
383
 
250
384
  ## [0.7.43]
385
+
251
386
  - AnchorTabBar: fix the typo in the name of the component
252
387
  - PromoWithTags: increase spacing between tags and body text
253
388
  - PromoWithTags: change prop name for subtags
254
389
 
255
390
  ## [0.7.42]
391
+
256
392
  - Livechat: Add more branded fields
257
393
 
258
394
  ## [0.7.41]
395
+
259
396
  - PromoWithTags: convert the checks value to boolean
260
397
 
261
398
  ## [0.7.40]
399
+
262
400
  - Add new PromoWithTags component
263
401
  - StickyBar: remove bottom border for mobile viewport
264
402
 
265
403
  ## [0.7.39]
404
+
266
405
  - Livechat: restyling
267
406
 
268
407
  ## [0.7.38]
408
+
269
409
  - PromoWithTitle: add styles for headings
270
410
 
271
411
  ## [0.7.37]
412
+
272
413
  - Tabs: Fix nav item spacing for large desktop displays
273
414
 
274
415
  ## [0.7.36]
275
- - Update PromowithTitle component with tags and change highlight color for text and title in Stream Header
416
+
417
+ - Update PromowithTitle component with tags and change highlight color for text and title in Stream Header
276
418
 
277
419
  ## [0.7.35]
420
+
278
421
  - Add new StickyBar component
279
422
 
280
423
  ## [0.7.34]
424
+
281
425
  - Tabs: Left-align last dropdown menu in the navigation bar
282
426
 
283
427
  ## [0.7.33]
428
+
284
429
  - Livechat: add Talkdesk Livechat injection component
285
430
 
286
431
  ## [0.7.32]
432
+
287
433
  - Carousels: extend character limit for description
288
434
 
289
435
  ## [0.7.31]
436
+
290
437
  - Card: add image alt text as a prop
291
438
 
292
439
  ## [0.7.30]
440
+
293
441
  - Navigation: add possibility to pass basket link as prop
294
442
 
295
443
  ## [0.7.29]
444
+
296
445
  - TextOnly: change spacing for the headings
297
446
 
298
447
  ## [0.7.28]
448
+
299
449
  - Order PeopleListing component by presence of headshot
300
450
  - Show four listings per row on large desktop
301
451
 
302
452
  ## [0.7.27]
453
+
303
454
  - Extend ContactCard capabilities
304
455
  - Extend Tertiary Button text length
305
456
 
306
457
  ## [0.7.26]
458
+
307
459
  - Add storybook-deployer package
308
460
  - Update README with instructions for deployment
309
461
 
310
462
  ## [0.7.25]
463
+
311
464
  - PeopleListing: add headshot
312
465
 
313
466
  ## [0.7.24]
467
+
314
468
  - Add new ContactCard component
315
469
 
316
470
  ## [0.7.23]
471
+
317
472
  - Accordion: make accordion keyboard-navigable
318
473
 
319
474
  ## [0.7.22]
475
+
320
476
  - Add new AnnouncementBanner component
321
477
 
322
478
  ## [0.7.21]
479
+
323
480
  - PageHeading: add a possibility to handle bold and italic in text
324
481
  - Header-2: fix font size and line-height
325
482
 
326
483
  ## [0.7.20]
484
+
327
485
  - TextOnly: fix spacing between the elements
328
486
 
329
487
  ## [0.7.19]
488
+
330
489
  - TextOnly: extend styles for embedded headers and links
331
490
 
332
491
  ## [0.7.18]
492
+
333
493
  - Quote: fix qoute signs
334
494
 
335
495
  ## [0.7.17]
496
+
336
497
  - Add new Quote component
337
498
 
338
499
  ## [0.7.16]
500
+
339
501
  - Card: fix title font size for tablet
340
502
 
341
503
  ## [0.7.15]
504
+
342
505
  - Tickbox: fix keyboard key value
343
506
 
344
507
  ## [0.7.14]
508
+
345
509
  - Fix keyboard accessibility for Tickbox
346
510
 
347
511
  ## [0.7.13]
512
+
348
513
  - Fix Carousel Card typography
349
514
  - Fix Impact Header Grid
350
515
  - Fix Footer Grid
351
516
  - Add additional font sizes for tablet
352
517
 
353
518
  ## [0.7.12]
519
+
354
520
  - Tickbox: fixed issue with component's state updating
355
521
 
356
522
  ## [0.7.11]
523
+
357
524
  - PromoWithTitle: align image vertically
358
525
 
359
526
  ## [0.7.10]
527
+
360
528
  - Theme: increases font size
361
529
 
362
530
  ## [0.7.9]
531
+
363
532
  - Impact: fix sponsor click and font size on mobile
364
533
  - Carousel: add buttons to tablet
365
534
  - Navigation: position fixed when menu is open on mobile
366
535
  - Highlight Carousel: add html text to short description
367
536
 
368
537
  ## [0.7.8]
538
+
369
539
  - TitleWithCTA: add message prop
370
540
 
371
541
  ## [0.7.7]
542
+
372
543
  - Tabs: close dropdown when it is clicked twice
373
544
 
374
545
  ## [0.7.6]
546
+
375
547
  - Add new initOpen prop to Accordion component
376
548
 
377
549
  ## [0.7.5]
550
+
378
551
  - Fix Styling in PeopleListing on Desktop
379
552
 
380
553
  ## [0.7.4]
554
+
381
555
  - Fix git README
382
556
 
383
557
  ## [0.7.3]
558
+
384
559
  - Fix Styling in PeopleListing on Mobile
385
560
 
386
561
  ## [0.7.2]
562
+
387
563
  - Add align center image in Editorial component
388
564
  - Export ControlledDropdown component
389
565
 
390
566
  ## [0.7.1]
567
+
391
568
  - Fix TitleWithCTA bug (visualization in two lines) in tablet
392
569
  - Export TextLink component
393
570
  - PeopleListing: custom person separator
394
571
 
395
572
  ## [0.7.0]
573
+
396
574
  - PeopleListing: replace people prop by roles prop
397
575
 
398
576
  ## [0.6.0]
577
+
399
578
  - Refactor the AnchorTabBar to separate page title and buttons
400
579
  - Add new TitleWithCTA component
401
580
  - Export Tab component
402
581
 
403
582
  ## [0.5.11]
583
+
404
584
  - Add Tickbox component and TickboxMode enum
405
585
  - PageHeading: fix typography
406
586
 
407
587
  ## [0.5.10]
588
+
408
589
  - Highlights Carousel: tablet layout improvements
409
590
  - Navigation improvements for small desktops.
410
591
  - Hide Rotator Buttons in the Hihghlight Carousel when there is only one event
411
592
 
412
593
  ## [0.5.9]
594
+
413
595
  - Reduce tablet grid margin from 50px to 32px.
414
596
  - Add alternative to aspect-ratio css attribute.
415
597
 
416
598
  ## [0.5.8]
599
+
417
600
  - PromoWithTitle links style
418
601
 
419
602
  ## [0.5.7]
603
+
420
604
  - Added Star icon to Iconography
421
605
 
422
606
  ## [0.5.6]
607
+
423
608
  - Added Favourite and Favourite Full icons to Iconography
424
609
 
425
610
  ## [0.5.5]
611
+
426
612
  - Export ImageAspectRatioWrapper component and AspectRatio enum
427
613
 
428
614
  ## [0.5.4]
615
+
429
616
  - Fix Card typography
430
617
  - Fix Carousel title typography
431
618
  - Fix Image Carousel size
@@ -434,51 +621,63 @@
434
621
  - Fix Anchor bar internal navigation
435
622
 
436
623
  ## [0.5.3]
624
+
437
625
  - Handle keyboard events using key attribute
438
626
 
439
627
  ## [0.5.2]
628
+
440
629
  - Highlights Carousel: info change swiping slide
441
630
  - Fix RotatorButtons a11y
442
631
 
443
632
  ## [0.5.1]
633
+
444
634
  - Highlights Carousel: fix box-sizing
445
635
 
446
636
  ## [0.5.0]
637
+
447
638
  - Highlights Carousel: new slides props (breaking change)
448
639
  - Fix in PageHeadingImpact image
449
640
 
450
641
  ## [0.4.4]
642
+
451
643
  - AnchorTabBar a11y: added tabIndex to links
452
644
 
453
645
  ## [0.4.3]
646
+
454
647
  - Prevent focus when navigation tab is clicked
455
648
 
456
649
  ## [0.4.2]
650
+
457
651
  - Highlights Carousel Components
458
652
  - Keyboard navigation fix for Navigation Component
459
653
 
460
654
  ## [0.4.1]
655
+
461
656
  - Swiper included as dependency
462
657
  - Fix for italics in Editorial, Card and PromoWithTitle components
463
658
  - Extra Props for AnchorTabBar
464
659
 
465
660
  ## [0.4.0]
661
+
466
662
  - Navigation Logo breaking change
467
663
  - Colors enum exported as in types
468
664
 
469
665
  ## [0.3.9]
666
+
470
667
  - Added Carousel Component
471
668
  - Dropdowns overlap fix
472
669
  - z-index fixes (for cards overlapping Anchor Tabs)
473
670
  - Navigation menu alignment fix
474
671
 
475
672
  ## [0.3.8]
673
+
476
674
  - Add possibility to configure GridItem for TextOnly component
477
675
  - Rich Text Editor Styling fix
478
676
  - Tweaks to Button layout for components
479
677
  - Anchor navigation arrows fix
480
678
 
481
679
  ## [0.3.7]
680
+
482
681
  - Typography change for Subtitle 2
483
682
  - AltHeader, BodyText, Header, Overline and Subtitle Components
484
683
  - REMOVED Heading Component - replaced by Header Component
@@ -486,22 +685,26 @@
486
685
  - made 'devices' public
487
686
 
488
687
  ## [0.3.6]
688
+
489
689
  - PageHeading Component
490
690
  - SectionTitle multiline fix
491
691
 
492
692
  ## [0.3.5]
693
+
493
694
  - Fix for Searchbox border on iOS
494
695
  - Fix for Accordion - Mobile Styling Issue
495
696
  - Fix for Card Component - Styling Issues
496
697
  - Change in Search layout
497
698
 
498
699
  ## [0.3.4]
700
+
499
701
  - Added Rotator Buttons
500
702
  - General Gotham SSm A & B font setup fixes
501
703
  - Fix for Footer font and size in mobile view
502
704
  - Subtitles 2 typography changes
503
705
 
504
706
  ## [0.3.3]
707
+
505
708
  - Added AnchorTabBar Component
506
709
  - Added Accordion Component
507
710
  - Added Card Component
@@ -509,10 +712,13 @@
509
712
  - Fix for Navigation Search font and mobile view
510
713
 
511
714
  ## [0.3.0]
715
+
512
716
  - Design system project renamed and moved to chord
513
717
 
514
718
  ## [0.2.0]
515
- - public NPM Library
719
+
720
+ - public NPM Library
516
721
 
517
722
  ## [0.1.0]
723
+
518
724
  - Initial version