@naptics/vue-collection 0.3.2 → 1.0.0-beta.1

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 (129) hide show
  1. package/eslint.config.cjs +0 -2
  2. package/package.json +31 -30
  3. package/postcss.config.js +1 -4
  4. package/src/demo/App.css +47 -3
  5. package/src/demo/components/ComponentSection.tsx +1 -1
  6. package/src/demo/views/NavigationView.tsx +1 -1
  7. package/src/demo/views/presentation/TooltipView.tsx +1 -1
  8. package/src/lib/components/NAlert.tsx +3 -3
  9. package/src/lib/components/NBadge.tsx +1 -1
  10. package/src/lib/components/NButton.tsx +6 -4
  11. package/src/lib/components/NCheckbox.tsx +2 -2
  12. package/src/lib/components/NDialog.tsx +2 -2
  13. package/src/lib/components/NDropdown.tsx +11 -9
  14. package/src/lib/components/NDropzone.tsx +4 -4
  15. package/src/lib/components/NIconButton.tsx +2 -2
  16. package/src/lib/components/NInput.tsx +1 -1
  17. package/src/lib/components/NLink.tsx +1 -1
  18. package/src/lib/components/NModal.tsx +4 -4
  19. package/src/lib/components/NPagination.css +4 -2
  20. package/src/lib/components/NPagination.tsx +1 -1
  21. package/src/lib/components/NSearchbar.tsx +1 -1
  22. package/src/lib/components/NSelect.tsx +1 -1
  23. package/src/lib/components/NSuggestionList.tsx +1 -1
  24. package/src/lib/components/NTable.css +2 -0
  25. package/src/lib/components/NTableAction.tsx +1 -1
  26. package/src/lib/components/NTextArea.tsx +1 -1
  27. package/src/lib/components/NTooltip.css +2 -0
  28. package/src/lib/components/NTooltip.tsx +1 -1
  29. package/src/lib/utils/component.tsx +1 -1
  30. package/tsconfig.lib.json +1 -0
  31. package/vite.config.ts +2 -0
  32. package/components/NAlert.d.ts +0 -29
  33. package/components/NAlert.js +0 -84
  34. package/components/NBadge.d.ts +0 -73
  35. package/components/NBadge.js +0 -64
  36. package/components/NBreadcrub.d.ts +0 -69
  37. package/components/NBreadcrub.js +0 -71
  38. package/components/NButton.d.ts +0 -64
  39. package/components/NButton.js +0 -72
  40. package/components/NCheckbox.d.ts +0 -20
  41. package/components/NCheckbox.js +0 -43
  42. package/components/NCheckboxLabel.d.ts +0 -26
  43. package/components/NCheckboxLabel.js +0 -42
  44. package/components/NCrudModal.d.ts +0 -118
  45. package/components/NCrudModal.js +0 -120
  46. package/components/NDialog.d.ts +0 -81
  47. package/components/NDialog.js +0 -161
  48. package/components/NDropdown.d.ts +0 -67
  49. package/components/NDropdown.js +0 -115
  50. package/components/NDropzone.d.ts +0 -61
  51. package/components/NDropzone.js +0 -218
  52. package/components/NForm.d.ts +0 -21
  53. package/components/NForm.js +0 -29
  54. package/components/NFormModal.d.ts +0 -75
  55. package/components/NFormModal.js +0 -59
  56. package/components/NIconButton.d.ts +0 -83
  57. package/components/NIconButton.js +0 -88
  58. package/components/NIconCircle.d.ts +0 -49
  59. package/components/NIconCircle.js +0 -67
  60. package/components/NInput.css +0 -11
  61. package/components/NInput.d.ts +0 -94
  62. package/components/NInput.js +0 -110
  63. package/components/NInputPhone.d.ts +0 -58
  64. package/components/NInputPhone.js +0 -47
  65. package/components/NInputSelect.d.ts +0 -103
  66. package/components/NInputSelect.js +0 -115
  67. package/components/NInputSuggestion.d.ts +0 -79
  68. package/components/NInputSuggestion.js +0 -64
  69. package/components/NLink.d.ts +0 -47
  70. package/components/NLink.js +0 -67
  71. package/components/NList.d.ts +0 -37
  72. package/components/NList.js +0 -40
  73. package/components/NLoadingIndicator.css +0 -46
  74. package/components/NLoadingIndicator.d.ts +0 -29
  75. package/components/NLoadingIndicator.js +0 -54
  76. package/components/NModal.d.ts +0 -133
  77. package/components/NModal.js +0 -232
  78. package/components/NPagination.css +0 -15
  79. package/components/NPagination.d.ts +0 -37
  80. package/components/NPagination.js +0 -105
  81. package/components/NSearchbar.d.ts +0 -39
  82. package/components/NSearchbar.js +0 -64
  83. package/components/NSearchbarList.d.ts +0 -33
  84. package/components/NSearchbarList.js +0 -41
  85. package/components/NSelect.d.ts +0 -82
  86. package/components/NSelect.js +0 -101
  87. package/components/NSuggestionList.d.ts +0 -153
  88. package/components/NSuggestionList.js +0 -160
  89. package/components/NTable.css +0 -3
  90. package/components/NTable.d.ts +0 -97
  91. package/components/NTable.js +0 -128
  92. package/components/NTableAction.d.ts +0 -30
  93. package/components/NTableAction.js +0 -50
  94. package/components/NTextArea.d.ts +0 -96
  95. package/components/NTextArea.js +0 -133
  96. package/components/NTooltip.css +0 -37
  97. package/components/NTooltip.d.ts +0 -152
  98. package/components/NTooltip.js +0 -241
  99. package/components/NValInput.d.ts +0 -159
  100. package/components/NValInput.js +0 -113
  101. package/components/ValidatedForm.d.ts +0 -39
  102. package/components/ValidatedForm.js +0 -35
  103. package/i18n/de/vue-collection.json +0 -58
  104. package/i18n/en/vue-collection.json +0 -58
  105. package/i18n/index.d.ts +0 -40
  106. package/i18n/index.js +0 -31
  107. package/index.d.ts +0 -2
  108. package/index.js +0 -2
  109. package/tailwind.config.js +0 -38
  110. package/utils/breakpoints.d.ts +0 -18
  111. package/utils/breakpoints.js +0 -40
  112. package/utils/component.d.ts +0 -57
  113. package/utils/component.js +0 -79
  114. package/utils/deferred.d.ts +0 -13
  115. package/utils/deferred.js +0 -17
  116. package/utils/identifiable.d.ts +0 -56
  117. package/utils/identifiable.js +0 -81
  118. package/utils/stringMaxLength.d.ts +0 -14
  119. package/utils/stringMaxLength.js +0 -23
  120. package/utils/tailwind.d.ts +0 -4
  121. package/utils/tailwind.js +0 -1
  122. package/utils/utils.d.ts +0 -47
  123. package/utils/utils.js +0 -56
  124. package/utils/vModel.d.ts +0 -182
  125. package/utils/vModel.js +0 -224
  126. package/utils/validation.d.ts +0 -90
  127. package/utils/validation.js +0 -147
  128. package/utils/vue.d.ts +0 -13
  129. package/utils/vue.js +0 -21
@@ -1,50 +0,0 @@
1
- import { Fragment as _Fragment, createVNode as _createVNode, isVNode as _isVNode } from "vue";
2
- import { createComponent } from '../utils/component';
3
- import { RouterLink } from 'vue-router';
4
- import { nButtonProps } from './NButton';
5
- function _isSlot(s) {
6
- return typeof s === 'function' || Object.prototype.toString.call(s) === '[object Object]' && !_isVNode(s);
7
- }
8
- export const nTableActionProps = {
9
- /**
10
- * The route of the action. If set the component will be a {@link RouterLink}.
11
- */
12
- route: [String, Object],
13
- /**
14
- * The text of the action.
15
- */
16
- text: String,
17
- /**
18
- * The html attribute, which indicates the type of the button.
19
- */
20
- type: nButtonProps.type,
21
- /**
22
- * This is called when the action is clicked.
23
- * It is only called when the `route` prop is not set on the action.
24
- */
25
- onClick: Function
26
- };
27
- /**
28
- * The `NTableAction` is a button or {@link RouterLink} which is styled to fit into a table.
29
- * It is basically styled as an emphasized text in the table.
30
- */
31
- const Component = createComponent('NTableAction', nTableActionProps, (props, {
32
- slots
33
- }) => {
34
- const content = () => slots.default?.() || _createVNode(_Fragment, null, [props.text]);
35
- const classes = ['text-left font-medium focus:outline-none focus-visible:ring-2 focus-visible:ring-default-900 rounded-sm ring-offset-2 text-default-900 hover:underline hover:text-default-700'];
36
- return () => {
37
- let _slot;
38
- return props.route ? _createVNode(RouterLink, {
39
- "to": props.route,
40
- "class": classes
41
- }, _isSlot(_slot = content()) ? _slot : {
42
- default: () => [_slot]
43
- }) : _createVNode("button", {
44
- "type": props.type,
45
- "class": classes,
46
- "onClick": props.onClick
47
- }, [content()]);
48
- };
49
- });
50
- export { Component as NTableAction, Component as default };
@@ -1,96 +0,0 @@
1
- import { type PropType } from 'vue';
2
- export declare const nTextAreaProps: {
3
- readonly disableValidation: BooleanConstructor;
4
- readonly optional: BooleanConstructor;
5
- readonly rules: {
6
- readonly type: PropType<import("../utils/validation").ValidationRule[] | import("../utils/validation").ValidationRule>;
7
- readonly default: () => never[];
8
- };
9
- readonly form: PropType<import("./ValidatedForm").ValidatedForm>;
10
- readonly error: BooleanConstructor;
11
- readonly errorMessage: StringConstructor;
12
- readonly hideErrorMessage: BooleanConstructor;
13
- readonly disableBlurValidation: BooleanConstructor;
14
- readonly tooltipText: StringConstructor;
15
- readonly tooltipContent: PropType<() => JSX.Element>;
16
- readonly tooltipHide: BooleanConstructor;
17
- readonly tooltipShow: BooleanConstructor;
18
- readonly tooltipPlacement: {
19
- readonly type: PropType<import("./NTooltip").TooltipPlacement>;
20
- readonly default: "auto";
21
- };
22
- readonly tooltipMaxWidth: {
23
- readonly type: PropType<import("../utils/tailwind").TWMaxWidth>;
24
- readonly default: "max-w-xs";
25
- };
26
- readonly tooltipWrapperClass: StringConstructor;
27
- readonly tooltipContentClass: StringConstructor;
28
- readonly tooltipArrowClass: StringConstructor;
29
- readonly tooltipDelay: {
30
- readonly type: NumberConstructor;
31
- readonly default: 0;
32
- };
33
- /**
34
- * The name of the text area. Is displayed as a label above the text area.
35
- */
36
- readonly name: StringConstructor;
37
- /**
38
- * The placeholder of the text area.
39
- */
40
- readonly placeholder: StringConstructor;
41
- /**
42
- * The html autocomplete attribute of the text area.
43
- */
44
- readonly autocomplete: {
45
- readonly type: StringConstructor;
46
- readonly default: "off";
47
- };
48
- /**
49
- * If set to `true`, the text area is resizable in y-direction.
50
- */
51
- readonly resizable: {
52
- readonly type: BooleanConstructor;
53
- readonly default: true;
54
- };
55
- /**
56
- * The initial height of the text area in terms of
57
- * how many text rows fit inside the text area.
58
- * The height can be change if {@link nTextAreaProps.resizable} is `true`
59
- */
60
- readonly rows: NumberConstructor;
61
- /**
62
- * The maximum length of the input string. Entering longer strings are simply
63
- * prevented, but no error message is shown to the user.
64
- */
65
- readonly maxLength: NumberConstructor;
66
- /**
67
- * If set to `true` the text area is disabled and no interaction is possible.
68
- */
69
- readonly disabled: BooleanConstructor;
70
- /**
71
- * If set to `true` the text area's label is hidden.
72
- */
73
- readonly hideLabel: BooleanConstructor;
74
- /**
75
- * Adds the classes directly to the input (e.g. for shadow).
76
- */
77
- readonly inputClass: StringConstructor;
78
- /**
79
- * This is called when the text area reveices focus.
80
- */
81
- readonly onFocus: PropType<() => void>;
82
- /**
83
- * This is called when the text area looses focus.
84
- */
85
- readonly onBlur: PropType<() => void>;
86
- readonly value: PropType<string>;
87
- readonly onUpdateValue: PropType<(newValue: string) => void>;
88
- };
89
- export type NTextAreaExposed = {
90
- /**
91
- * Request focus on the text area.
92
- */
93
- focus(): void;
94
- };
95
- declare const Component: import("vue").DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import("vue").PublicProps>;
96
- export { Component as NTextArea, Component as default };
@@ -1,133 +0,0 @@
1
- import { mergeProps as _mergeProps, createVNode as _createVNode, vShow as _vShow, withDirectives as _withDirectives } from "vue";
2
- import { createComponent } from '../utils/component';
3
- import { ref } from 'vue';
4
- import { ExclamationCircleIcon } from '@heroicons/vue/24/solid';
5
- import NTooltip, { mapTooltipProps, nToolTipPropsForImplementor } from './NTooltip';
6
- import { vModelProps } from '../utils/vModel';
7
- import NValInput, { validationProps } from './NValInput';
8
- const nTextAreaBaseProps = {
9
- ...vModelProps(String),
10
- /**
11
- * The name of the text area. Is displayed as a label above the text area.
12
- */
13
- name: String,
14
- /**
15
- * The placeholder of the text area.
16
- */
17
- placeholder: String,
18
- /**
19
- * The html autocomplete attribute of the text area.
20
- */
21
- autocomplete: {
22
- type: String,
23
- default: 'off'
24
- },
25
- /**
26
- * If set to `true`, the text area is resizable in y-direction.
27
- */
28
- resizable: {
29
- type: Boolean,
30
- default: true
31
- },
32
- /**
33
- * The initial height of the text area in terms of
34
- * how many text rows fit inside the text area.
35
- * The height can be change if {@link nTextAreaProps.resizable} is `true`
36
- */
37
- rows: Number,
38
- /**
39
- * The maximum length of the input string. Entering longer strings are simply
40
- * prevented, but no error message is shown to the user.
41
- */
42
- maxLength: Number,
43
- /**
44
- * If set to `true` the text area is displayed with a red border.
45
- */
46
- error: Boolean,
47
- /**
48
- * If set to `true` the text area is disabled and no interaction is possible.
49
- */
50
- disabled: Boolean,
51
- /**
52
- * If set to `true` the text area's label is hidden.
53
- */
54
- hideLabel: Boolean,
55
- /**
56
- * Adds the classes directly to the input (e.g. for shadow).
57
- */
58
- inputClass: String,
59
- /**
60
- * This is called when the text area reveices focus.
61
- */
62
- onFocus: Function,
63
- /**
64
- * This is called when the text area looses focus.
65
- */
66
- onBlur: Function,
67
- ...nToolTipPropsForImplementor
68
- };
69
- export const nTextAreaProps = {
70
- ...nTextAreaBaseProps,
71
- ...validationProps
72
- };
73
- const Component = createComponent('NTextArea', nTextAreaProps, (props, context) => {
74
- const textAreaRef = ref();
75
- const exposed = {
76
- focus: () => textAreaRef.value?.focus()
77
- };
78
- context.expose(exposed);
79
- return () => _createVNode(NValInput, _mergeProps(props, {
80
- "input": ({
81
- error,
82
- onBlur,
83
- onUpdateValue
84
- }) => _createVNode(NTextAreaBase, _mergeProps({
85
- "ref": textAreaRef
86
- }, {
87
- ...props,
88
- error,
89
- onBlur,
90
- onUpdateValue
91
- }), null)
92
- }), null);
93
- });
94
- export { Component as NTextArea, Component as default };
95
- /**
96
- * The `NTextArea` wraps the html text area with all the features from {@link NInput} and {@link NValInput}.
97
- */
98
- const NTextAreaBase = createComponent('NTextAreaBase', nTextAreaBaseProps, (props, context) => {
99
- const textAreaRef = ref();
100
- const exposed = {
101
- focus: () => textAreaRef.value?.focus()
102
- };
103
- context.expose(exposed);
104
- return () => _createVNode("div", null, [props.name && !props.hideLabel && _createVNode("label", {
105
- "for": props.name,
106
- "class": ['block text-sm font-medium mb-1', props.disabled ? 'text-default-300' : 'text-default-700']
107
- }, [props.name]), _createVNode(NTooltip, _mergeProps({
108
- "block": true
109
- }, mapTooltipProps(props)), {
110
- default: () => [_createVNode("div", {
111
- "class": "relative"
112
- }, [_createVNode("textarea", {
113
- "ref": textAreaRef,
114
- "name": props.name,
115
- "value": props.value,
116
- "onInput": event => props.onUpdateValue?.(event.target.value),
117
- "placeholder": props.placeholder,
118
- "autocomplete": props.autocomplete,
119
- "disabled": props.disabled,
120
- "rows": props.rows,
121
- "maxlength": props.maxLength,
122
- "onFocus": () => props.onFocus?.(),
123
- "onBlur": () => props.onBlur?.(),
124
- "onInvalid": event => event.preventDefault(),
125
- "class": ['block w-full rounded-md border focus:outline-none focus:ring-1 ', props.disabled ? 'text-default-500 placeholder-default-300 bg-default-50' : 'text-default-900 placeholder-default-400 ', props.error ? 'border-red-500 focus:border-red-500 focus:ring-red-500 pr-10' : 'border-default-300 focus:border-primary-500 focus:ring-primary-500', props.resizable ? 'resize-y' : 'resize-none', props.inputClass]
126
- }, null), _withDirectives(_createVNode("div", {
127
- "class": "absolute inset-y-0 right-0 pr-3 flex items-center pointer-events-none"
128
- }, [_createVNode(ExclamationCircleIcon, {
129
- "class": "h-5 w-5 text-red-700",
130
- "aria-hidden": "true"
131
- }, null)]), [[_vShow, props.error]])])]
132
- })]);
133
- });
@@ -1,37 +0,0 @@
1
- .arrow,
2
- .arrow::before {
3
- position: absolute;
4
- width: 8px;
5
- height: 8px;
6
- }
7
-
8
- .arrow {
9
- visibility: hidden;
10
- }
11
-
12
- .arrow::before {
13
- visibility: visible;
14
- content: '';
15
- transform: rotate(45deg);
16
- @apply bg-white border border-default-200 border-solid;
17
- }
18
-
19
- .tooltip[data-popper-placement^='top'] > .arrow {
20
- bottom: -3.8px;
21
- @apply before:border-t-transparent before:border-l-transparent;
22
- }
23
-
24
- .tooltip[data-popper-placement^='bottom'] > .arrow {
25
- top: -3.8px;
26
- @apply before:border-b-white before:border-r-white;
27
- }
28
-
29
- .tooltip[data-popper-placement^='left'] > .arrow {
30
- right: -3.8px;
31
- @apply before:border-b-transparent before:border-l-transparent;
32
- }
33
-
34
- .tooltip[data-popper-placement^='right'] > .arrow {
35
- left: -3.8px;
36
- @apply before:border-t-transparent before:border-r-transparent;
37
- }
@@ -1,152 +0,0 @@
1
- import { type ExtractedProps } from '../utils/component';
2
- import type { TWMaxWidth } from '../utils/tailwind';
3
- import { type PropType } from 'vue';
4
- import './NTooltip.css';
5
- export declare const nTooltipProps: {
6
- /**
7
- * The text content of the tooltip.
8
- */
9
- readonly text: StringConstructor;
10
- /**
11
- * A slot to replace the content of the tooltip. This will override the `text` prop.
12
- */
13
- readonly content: PropType<() => JSX.Element>;
14
- /**
15
- * If set to `true` the tooltip is shown constantly.
16
- */
17
- readonly show: BooleanConstructor;
18
- /**
19
- * If set to `true` the tooltip is hidden constantly.
20
- */
21
- readonly hide: BooleanConstructor;
22
- /**
23
- * If set to `true` the `block` class is applied to the tooltip.
24
- * This should be set if the content in the default slot is also block.
25
- */
26
- readonly block: BooleanConstructor;
27
- /**
28
- * The placement of the tooltip.
29
- */
30
- readonly placement: {
31
- readonly type: PropType<TooltipPlacement>;
32
- readonly default: "auto";
33
- };
34
- /**
35
- * The maximum width of the tooltip.
36
- */
37
- readonly maxWidth: {
38
- readonly type: PropType<TWMaxWidth>;
39
- readonly default: "max-w-xs";
40
- };
41
- /**
42
- * Adds the classes to the (invisible) wrapper element.
43
- */
44
- readonly wrapperClass: StringConstructor;
45
- /**
46
- * Adds the classes to the container of the tooltips content.
47
- */
48
- readonly contentClass: StringConstructor;
49
- /**
50
- * Adds the classes to the tooltip arrow. Make sure to use `before:` classes
51
- * to target the arrow (which is the before element).
52
- */
53
- readonly arrowClass: StringConstructor;
54
- /**
55
- * The delay in milliseconds before the tooltip is shown.
56
- * @default 0
57
- */
58
- readonly delay: {
59
- readonly type: NumberConstructor;
60
- readonly default: 0;
61
- };
62
- };
63
- /**
64
- * These props are made to use on a component which implements the tooltip
65
- * and wants it to be controllable via the own props.
66
- * e.g. `text` is now called `tooltipText`.
67
- * They can be mapped to the normal tooltip props with {@link mapTooltipProps}
68
- */
69
- export declare const nToolTipPropsForImplementor: {
70
- /**
71
- * Adds a tooltip to the component with the specified text.
72
- * @see {@link nTooltipProps.text}
73
- */
74
- tooltipText: StringConstructor;
75
- /**
76
- * A slot for the tooltip of this component.
77
- * If the slot is set, the tooltip with the specified content is added to the component.
78
- * @see {@link nTooltipProps.content}
79
- */
80
- tooltipContent: PropType<() => JSX.Element>;
81
- /**
82
- * @see {@link nTooltipProps.hide}
83
- */
84
- tooltipHide: BooleanConstructor;
85
- /**
86
- * @see {@link nTooltipProps.show}
87
- */
88
- tooltipShow: BooleanConstructor;
89
- /**
90
- * @see {@link nTooltipProps.placement}
91
- */
92
- tooltipPlacement: {
93
- readonly type: PropType<TooltipPlacement>;
94
- readonly default: "auto";
95
- };
96
- /**
97
- * @see {@link nTooltipProps.maxWidth}
98
- */
99
- tooltipMaxWidth: {
100
- readonly type: PropType<TWMaxWidth>;
101
- readonly default: "max-w-xs";
102
- };
103
- /**
104
- * @see {@link nTooltipProps.wrapperClass}
105
- */
106
- tooltipWrapperClass: StringConstructor;
107
- /**
108
- * @see {@link nTooltipProps.contentClass}
109
- */
110
- tooltipContentClass: StringConstructor;
111
- /**
112
- * @see {@link nTooltipProps.arrowClass}
113
- */
114
- tooltipArrowClass: StringConstructor;
115
- /**
116
- * @see {@link nTooltipProps.delay}
117
- */
118
- tooltipDelay: {
119
- readonly type: NumberConstructor;
120
- readonly default: 0;
121
- };
122
- };
123
- /**
124
- * Maps the {@link nToolTipPropsForImplementor} props to normal tooltip props
125
- * @returns an object containing the normal tooltip props.
126
- */
127
- export declare function mapTooltipProps(props: ExtractedProps<typeof nToolTipPropsForImplementor>): {
128
- text: string | undefined;
129
- content: (() => JSX.Element) | undefined;
130
- hide: boolean;
131
- show: boolean;
132
- placement: TooltipPlacement;
133
- maxWidth: TWMaxWidth;
134
- wrapperClass: string | undefined;
135
- contentClass: string | undefined;
136
- arrowClass: string | undefined;
137
- delay: number;
138
- };
139
- /**
140
- * The `NTooltip` is a wrapper for any component which adds a tooltip to it.
141
- * Any component can just be passed in the default slot and a tooltip will be added to it.
142
- * Note that this component disappears when neither the `text` nor the `content`
143
- * prop is passed as the tooltip would then be empty.
144
- * If this is the case, the default slot will just be rendered inside a div.
145
- * @example
146
- * <NTooltip text="Hello">
147
- * <NButton />
148
- * </NTooltip>
149
- */
150
- declare const Component: import("vue").DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import("vue").PublicProps>;
151
- export { Component as NTooltip, Component as default };
152
- export type TooltipPlacement = 'auto' | 'auto-start' | 'auto-end' | 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'right' | 'right-start' | 'right-end' | 'left' | 'left-start' | 'left-end';