@antify/ui-module 1.1.3

package/dist/runtime/components/form/Elements/AntBaseInput.vue

@@ -0,0 +1,216 @@
+<script lang="ts" setup>
+import {computed, onMounted, watch} from 'vue';
+import {Size} from '../../../enums/Size.enum'
+import AntSkeleton from '../../AntSkeleton.vue';
+import AntIcon from '../../AntIcon.vue';
+import {BaseInputType} from './__types/AntBaseInput.type';
+import {Grouped} from '../../../enums/Grouped.enum';
+import {
+  faExclamationTriangle,
+  faExclamationCircle,
+  faCircleCheck,
+  faCircleInfo,
+  faXmark
+} from '@fortawesome/free-solid-svg-icons';
+import {handleEnumValidation} from '../../../handler';
+import {type IconDefinition} from '@fortawesome/free-solid-svg-icons';
+import {classesToObjectSyntax} from '../../../utils';
+import {InputColorType} from '../../../enums';
+import {IconSize} from '../../__types';
+
+defineOptions({ inheritAttrs: false });
+
+const emit = defineEmits(['update:value', 'blur', 'validate']);
+const props = withDefaults(defineProps<{
+  value: string | number | null;
+  size?: Size;
+  colorType?: InputColorType;
+  disabled?: boolean;
+  placeholder?: string;
+  skeleton?: boolean;
+  type?: BaseInputType;
+  grouped?: Grouped;
+  wrapperClass?: string | Record<string, boolean>;
+  showIcon?: boolean;
+  iconLeft?: IconDefinition;
+  nullable?: boolean;
+  hasErrors?: boolean;
+}>(), {
+  colorType: InputColorType.base,
+  disabled: false,
+  size: Size.md,
+  skeleton: false,
+  type: BaseInputType.text,
+  grouped: Grouped.none,
+  showIcon: true,
+  default: false,
+  nullable: false,
+  hasErrors: false
+});
+
+const icons = {
+  [InputColorType.info]: faCircleInfo,
+  [InputColorType.warning]: faExclamationTriangle,
+  [InputColorType.danger]: faExclamationCircle,
+  [InputColorType.success]: faCircleCheck,
+  [InputColorType.base]: null,
+};
+
+const inputClasses = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'outline-neutral-300 focus:outline-primary-500 focus:ring-primary/25 bg-neutral-50 placeholder:text-neutral-500',
+    [InputColorType.danger]: 'outline-danger-500 focus:outline-danger-500 focus:ring-danger/25 bg-danger-100 placeholder:text-danger-700',
+    [InputColorType.info]: 'outline-info-500 focus:outline-info-500 focus:ring-info/25 bg-info-100 placeholder:text-info-700',
+    [InputColorType.success]: 'outline-success-500 focus:outline-success-500 focus:ring-success/25 bg-success-100 placeholder:text-success-700',
+    [InputColorType.warning]: 'outline-warning-500 focus:outline-warning-500 focus:ring-warning/25 bg-warning-100 placeholder:text-warning-700',
+  };
+
+  return {
+    'transition-colors relative border-none outline w-full focus:z-10': true,
+    'outline-offset-[-1px] outline-1 focus:outline-offset-[-1px] focus:outline-1': true,
+    'disabled:opacity-50 disabled:cursor-not-allowed': props.disabled,
+    'text-right': props.type === BaseInputType.number,
+    [variants[_colorType.value]]: true,
+    // Size
+    'focus:ring-2 p-1.5 text-xs': props.size === Size.sm,
+    'focus:ring-4 p-2.5 text-sm': props.size === Size.md,
+    // Icon left
+    'pl-7': props.size === Size.sm && props.iconLeft,
+    'pl-10': props.size === Size.md && props.iconLeft,
+    // Icon right
+    'pr-7': props.size === Size.sm && props.showIcon && icon.value,
+    'pr-10': props.size === Size.md && props.showIcon && icon.value,
+    // Grouped
+    'rounded-tl-md rounded-bl-md rounded-tr-none rounded-br-none': props.grouped === Grouped.left,
+    'rounded-none': props.grouped === Grouped.center,
+    'rounded-tl-none rounded-bl-none rounded-tr-md rounded-br-md': props.grouped === Grouped.right,
+    'rounded-md': props.grouped === Grouped.none,
+    'invisible': props.skeleton,
+  };
+});
+const iconClasses = computed(() => ({
+  'transition-[height]': true,
+  'h-4': props.size === Size.sm,
+  'h-5': props.size === Size.md,
+}));
+const iconColorClasses = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'text-neutral-500',
+    [InputColorType.danger]: 'text-danger-500',
+    [InputColorType.info]: 'text-info-500',
+    [InputColorType.success]: 'text-success-500',
+    [InputColorType.warning]: 'text-warning-500',
+  };
+
+  return {
+    [variants[_colorType.value]]: true,
+  };
+});
+const _wrapperClass = computed(() => classesToObjectSyntax(props.wrapperClass));
+const icon = computed(() => icons[_colorType.value]);
+const _value = computed<string | number | null>({
+  get: () => props.value,
+  set: (val: string | number | null) => {
+    if (props.type === BaseInputType.number && typeof val !== 'number') {
+      return emit('update:value', null);
+    }
+
+    emit('update:value', val);
+  },
+});
+const _colorType = computed(() => props.hasErrors ? InputColorType.danger : props.colorType);
+
+watch(_value, (val) => {
+  if (props.hasErrors) {
+    emit('validate', val)
+  }
+});
+
+/**
+ * Validate default value if given after delayed data fetching.
+ */
+watch(() => props.skeleton, (val) => {
+  if (!val && props.value !== null) {
+    emit('validate', props.value)
+  }
+});
+
+onMounted(() => {
+  handleEnumValidation(props.size, Size, 'size');
+  handleEnumValidation(props.colorType, InputColorType, 'colorType');
+  handleEnumValidation(props.type, BaseInputType, 'Type');
+  handleEnumValidation(props.grouped, Grouped, 'grouped');
+
+  /**
+   * Validate default value without delayed data fetching.
+   */
+  if (!props.skeleton && props.value !== null) {
+    emit('validate', props.value)
+  }
+});
+
+function onBlur(e: FocusEvent) {
+  emit('validate', props.value)
+  emit('blur', e);
+}
+</script>
+
+<template>
+  <div class="block relative w-full" :class="{...{'-mr-px': grouped !== Grouped.none}, ..._wrapperClass}">
+    <div
+        v-if="iconLeft"
+        class="absolute h-full flex items-center justify-center z-20"
+        :class="{'w-7': size === Size.sm, 'w-10': size === Size.md}"
+    >
+      <AntIcon
+          :icon="iconLeft"
+          :size="size as unknown as IconSize"
+          color="text-neutral-50-font"
+      />
+    </div>
+
+    <input
+        v-model="_value"
+        :class="inputClasses"
+        :type="type"
+        :placeholder="placeholder"
+        :disabled="disabled || skeleton"
+        @blur="onBlur"
+        v-bind="$attrs"
+    >
+
+    <div
+        v-if="nullable && _value !== null && _value !== ''"
+        class="absolute flex w-fit right-0 top-0 h-full transition-all z-20"
+        :class="{'p-1.5': size === Size.sm, 'p-2.5': size === Size.md}"
+    >
+      <!-- TODO:: Replace with AntIcon -->
+      <fa-icon
+          :icon="faXmark"
+          :class="iconClasses"
+          class="text-neutral-500-font cursor-pointer"
+          @click="() => _value = null"
+      />
+    </div>
+
+    <div
+        v-else-if="showIcon && icon"
+        class="absolute flex w-fit right-0 top-0 h-full transition-all z-20"
+        :class="{'p-1.5': size === Size.sm, 'p-2.5': size === Size.md}"
+    >
+      <!-- TODO:: Replace with AntIcon -->
+      <fa-icon :icon="icon" :class="{...iconClasses, ...iconColorClasses}"/>
+    </div>
+
+    <AntSkeleton
+        v-if="skeleton"
+        absolute
+        :grouped="grouped"
+        rounded
+    />
+  </div>
+</template>
+
+<style scoped>
+input::-webkit-inner-spin-button,input::-webkit-outer-spin-button{-webkit-appearance:none;margin:0}input[type=number]{-moz-appearance:textfield}input[type=search]::-ms-clear,input[type=search]::-ms-reveal{display:none;height:0;width:0}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration,input[type=search]::-webkit-search-results-button,input[type=search]::-webkit-search-results-decoration{display:none}
+</style>

package/dist/runtime/components/form/Elements/AntDropDown.vue

@@ -0,0 +1,160 @@
+<script setup lang="ts">
+/**
+ * This is the custom DropDown for each element (like select / tag-select)
+ *
+ * TODO:: add screen reader support
+ * Fix overflow bug (See Ellipsis Text story)
+ * TODO:: if the dropdown is open and the user types something, the element with a matching value should be focused.
+ */
+
+import { computed, nextTick, ref, watch } from 'vue';
+import { InputColorType, Size } from '../../../enums';
+import type { SelectOption } from '../__types';
+import { useVModel } from '@vueuse/core';
+import type { Validator } from '@antify/validate';
+
+const emit = defineEmits(['update:open', 'update:modelValue']);
+const props = withDefaults(defineProps<{
+  modelValue: string | number | null;
+  open: boolean;
+  options: SelectOption[];
+  colorType?: InputColorType;
+  validator?: Validator;
+  size?: Size;
+  inputRef?: HTMLElement | null
+}>(), {
+  colorType: InputColorType.base,
+});
+
+const _modelValue = useVModel(props, 'modelValue', emit);
+const isOpen = useVModel(props, 'open', emit);
+
+const focusedDropDownItem = ref<string | number | null>(null);
+const dropDownRef = ref<HTMLElement | null>(null);
+
+const dropdownClasses = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'bg-neutral-300 border-neutral-300',
+    [InputColorType.success]: 'bg-success-500 border-success-500',
+    [InputColorType.info]: 'bg-info-500 border-info-500',
+    [InputColorType.warning]: 'bg-warning-500 border-warning-500',
+    [InputColorType.danger]: 'bg-danger-500 border-danger-500',
+  };
+
+  return {
+    'absolute w-full border flex flex-col gap-px outline-none -mt-px overflow-hidden shadow-md z-40': true,
+    'rounded-bl-md rounded-br-md': true,
+    [variants[props.colorType]]: true,
+    // Size
+    'text-xs': props.size === Size.sm,
+    'text-sm': props.size === Size.md,
+  };
+});
+const dropDownItemClasses = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'bg-neutral-50 text-neutral-50-font',
+    [InputColorType.success]: 'bg-success-100 border-success-100-font',
+    [InputColorType.info]: 'bg-info-100 border-info-100-font',
+    [InputColorType.warning]: 'bg-warning-100 border-warning-100-font',
+    [InputColorType.danger]: 'bg-danger-100 border-danger-100-font',
+  };
+
+  return {
+    'select-none text-ellipsis overflow-hidden whitespace-nowrap': true,
+    [variants[props.colorType]]: true,
+    // Size
+    'p-1.5': props.size === Size.sm,
+    'p-2.5': props.size === Size.md,
+  };
+});
+
+watch(isOpen, (val) => {
+  nextTick(() => {
+    if (val) {
+      dropDownRef.value?.focus();
+      focusedDropDownItem.value = _modelValue.value || props.options[0].value;
+    }
+  });
+});
+
+function onKeyDownDropDown(e: KeyboardEvent) {
+  if (e.key === 'Enter') {
+    isOpen.value = false;
+    _modelValue.value = focusedDropDownItem.value;
+    props.inputRef?.focus();
+  }
+
+  if (e.key === 'Escape') {
+    isOpen.value = false;
+    props.inputRef?.focus();
+  }
+
+  if (e.key === 'ArrowDown' || e.key === 'ArrowRight') {
+    const index = props.options.findIndex(option => option.value === focusedDropDownItem.value);
+    const option = props.options[index + 1];
+
+    if (index === -1) {
+      focusedDropDownItem.value = props.options[0].value
+    } else if (option !== undefined) {
+      focusedDropDownItem.value = option.value
+    }
+  }
+
+  if (e.key === 'ArrowUp' || e.key === 'ArrowLeft') {
+    const index = props.options.findIndex(option => option.value === focusedDropDownItem.value);
+    const option = props.options[index - 1];
+
+    if (option !== undefined) {
+      focusedDropDownItem.value = option.value
+    }
+  }
+
+  if (e.key === 'Tab') {
+    isOpen.value = false;
+  }
+}
+
+function getActiveDropDownItemClasses(option: SelectOption) {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'bg-neutral-50/25',
+    [InputColorType.success]: 'bg-success-100/25',
+    [InputColorType.info]: 'bg-info-100/25',
+    [InputColorType.warning]: 'bg-warning-100/25',
+    [InputColorType.danger]: 'bg-danger-100/25',
+  };
+
+  return option.value === focusedDropDownItem.value ? {[variants[props.colorType]]: true} : {};
+}
+
+function onClickDropDownItem(e: MouseEvent, value: string | number | null) {
+  e.preventDefault();
+  props.inputRef?.focus();
+
+  isOpen.value = false;
+  _modelValue.value = value;
+}
+</script>
+
+<template>
+  <div
+    v-if="isOpen"
+    :class="dropdownClasses"
+    @keydown="onKeyDownDropDown"
+    ref="dropDownRef"
+    tabindex="0"
+  >
+    <div
+      v-for="(option, index) in options"
+      :key="`option-${index}`"
+      :class="{...dropDownItemClasses, ...getActiveDropDownItemClasses(option)}"
+      @mousedown="(e) => onClickDropDownItem(e, option.value)"
+      @mouseover="() => focusedDropDownItem = option.value"
+    >
+      {{ option.label }}
+    </div>
+  </div>
+</template>
+
+<style scoped>
+
+</style>

package/dist/runtime/components/form/Elements/AntField.vue

@@ -0,0 +1,102 @@
+<script lang="ts" setup>
+import {onMounted, computed} from 'vue';
+import {Size} from '../../../enums/Size.enum'
+import AntInputLabel from './AntInputLabel.vue';
+import AntInputDescription from './AntInputDescription.vue';
+import {handleEnumValidation} from '../../../handler';
+import AntInputLimiter from './AntInputLimiter.vue';
+import {InputColorType} from '../../../enums';
+
+const emits = defineEmits(['clickLabel', 'validate']);
+const props = withDefaults(defineProps<{
+  label?: string;
+  description?: string;
+  size?: Size;
+  colorType?: InputColorType;
+  skeleton?: boolean;
+  limiterValue?: number;
+  limiterMaxValue?: number;
+  labelFor?: string;
+  showMessageOnError?: boolean;
+  errors?: string[];
+  expanded?: boolean;
+}>(), {
+  colorType: InputColorType.base,
+  skeleton: false,
+  size: Size.md,
+  showMessageOnError: true,
+  errors: [],
+  expanded: true
+});
+
+onMounted(() => {
+  handleEnumValidation(props.size, Size, 'size');
+  handleEnumValidation(props.colorType, InputColorType, 'colorType');
+});
+
+const _errors = computed(() => props.skeleton ? [] : props.errors);
+const _colorType = computed(() => _errors.value.length > 0 ? InputColorType.danger : props.colorType)
+</script>
+
+<template>
+  <div
+      class="flex flex-col items-start gap-1.5"
+      :class="{'w-full': expanded}"
+  >
+    <AntInputLabel
+        :label="label"
+        :size="size"
+        :skeleton="skeleton"
+        :for="labelFor"
+        @clickContent="$emit('clickLabel')"
+    >
+      <div class="w-full">
+        <slot/>
+      </div>
+    </AntInputLabel>
+
+    <div
+        v-if="showMessageOnError && (description || _errors.length > 0)"
+        class="flex justify-between w-full"
+    >
+      <AntInputDescription
+          :size="size"
+          :skeleton="skeleton"
+          :color-type="_colorType"
+      >
+        <slot name="description">
+          <template v-if="_errors.length === 1">
+            {{ errors[0] }}
+          </template>
+
+          <template v-else-if="_errors.length > 1">
+            <ul class="list-disc list-outside pl-4">
+              <li
+                v-for="(error, index) of _errors"
+                :key="`field-error-${index}`"
+                class="marker:m-none marker:p-none"
+              >
+                {{ error }}
+              </li>
+            </ul>
+          </template>
+
+          <template v-else>
+            {{ description }}
+          </template>
+        </slot>
+      </AntInputDescription>
+
+      <AntInputLimiter
+          v-if="limiterMaxValue !== undefined && limiterValue !== undefined"
+          :value="limiterValue"
+          :max-value="limiterMaxValue"
+          :color-type="_colorType"
+          :size="size"
+          :skeleton="skeleton"
+      >
+        {{ limiterValue }}/{{ limiterMaxValue }}
+      </AntInputLimiter>
+    </div>
+  </div>
+</template>

package/dist/runtime/components/form/Elements/AntInputDescription.vue

@@ -0,0 +1,55 @@
+<script lang="ts" setup>
+import {computed, onMounted} from 'vue';
+import {Size} from '../../../enums/Size.enum'
+import AntSkeleton from '../../AntSkeleton.vue';
+import {handleEnumValidation} from '../../../handler';
+import {InputColorType} from '../../../enums';
+
+const props = withDefaults(defineProps<{
+  colorType?: InputColorType,
+  size?: Size;
+  skeleton?: boolean;
+}>(), {
+  skeleton: false,
+  size: Size.md,
+  colorType: InputColorType.base
+});
+
+const classes = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'text-neutral-500',
+    [InputColorType.danger]: 'text-danger-500',
+    [InputColorType.info]: 'text-info-500',
+    [InputColorType.success]: 'text-success-500',
+    [InputColorType.warning]: 'text-warning-500',
+  };
+
+  return {
+    'relative font-regular inline-block transition-color': true,
+    'text-xs': props.size === Size.sm,
+    'text-sm': props.size === Size.md,
+    [variants[props.colorType]]: true
+  };
+});
+
+onMounted(() => {
+  handleEnumValidation(props.size, Size, 'size');
+  handleEnumValidation(props.colorType, InputColorType, 'colorType');
+});
+</script>
+
+<template>
+  <div
+      :class="classes"
+  >
+    <span :class="{'invisible': skeleton}">
+      <slot/>
+    </span>
+
+    <AntSkeleton
+        v-if="skeleton"
+        absolute
+        rounded
+    />
+  </div>
+</template>

package/dist/runtime/components/form/Elements/AntInputLabel.vue

@@ -0,0 +1,55 @@
+<script lang="ts" setup>
+import {computed, onMounted} from 'vue';
+import {Size} from '../../../enums/Size.enum'
+import AntSkeleton from '../../AntSkeleton.vue';
+import {handleEnumValidation} from '../../../handler';
+
+defineEmits(['clickContent']);
+
+const props = withDefaults(defineProps<{
+  label?: string;
+  size?: Size;
+  skeleton?: boolean;
+}>(), {
+  skeleton: false,
+  size: Size.md,
+});
+
+const classes = computed(() => ({
+  'relative font-medium w-fit': true,
+  'text-xs': props.size === Size.sm,
+  'text-sm': props.size === Size.md,
+}));
+
+onMounted(() => {
+  handleEnumValidation(props.size, Size, 'size');
+});
+</script>
+
+<template>
+  <label
+      class="flex flex-col gap-1.5 w-full"
+  >
+    <span
+        v-if="label"
+        :class="classes"
+    >
+      <span
+          :class="{'invisible': skeleton}"
+          @click="$emit('clickContent')"
+      >
+        <slot name="label">
+          {{ label }}
+        </slot>
+      </span>
+
+      <AntSkeleton
+          v-if="skeleton"
+          absolute
+          rounded
+      />
+    </span>
+
+    <slot/>
+  </label>
+</template>

package/dist/runtime/components/form/Elements/AntInputLimiter.vue

@@ -0,0 +1,55 @@
+<script lang="ts" setup>
+import {computed, onMounted} from 'vue';
+import {Size} from '../../../enums/Size.enum'
+import AntSkeleton from '../../AntSkeleton.vue';
+import {handleEnumValidation} from '../../../handler';
+import {InputColorType} from '../../../enums';
+
+const props = withDefaults(defineProps<{
+  value: number;
+  maxValue: number;
+  colorType?: InputColorType;
+  size?: Size;
+  skeleton?: boolean;
+}>(), {
+  skeleton: false,
+  size: Size.md,
+  colorType: InputColorType.base
+});
+
+const classes = computed(() => {
+  const variants: Record<InputColorType, string> = {
+    [InputColorType.base]: 'text-neutral-500',
+    [InputColorType.danger]: 'text-danger-500',
+    [InputColorType.info]: 'text-info-500',
+    [InputColorType.success]: 'text-success-500',
+    [InputColorType.warning]: 'text-warning-500',
+  };
+
+  return {
+    'relative font-regular inline-block transition-color': true,
+    'text-xs': props.size === Size.sm,
+    'text-sm': props.size === Size.md,
+    [variants[props.colorType]]: true,
+  };
+});
+
+onMounted(() => {
+  handleEnumValidation(props.size, Size, 'size');
+  handleEnumValidation(props.colorType, InputColorType, 'colorType');
+});
+</script>
+
+<template>
+  <div :class="classes">
+    <span :class="{'invisible': skeleton}">
+        {{ value }}/{{ maxValue }}
+    </span>
+
+    <AntSkeleton
+        v-if="skeleton"
+        absolute
+        rounded
+    />
+  </div>
+</template>

package/dist/runtime/components/form/Elements/__stories/AntBaseInput.stories.d.ts

@@ -0,0 +1,9 @@
+import { type Meta, type StoryObj } from '@storybook/vue3';
+import AntBaseInput from '../AntBaseInput.vue';
+declare const meta: Meta<typeof AntBaseInput>;
+export default meta;
+type Story = StoryObj<typeof AntBaseInput>;
+export declare const Docs: Story;
+export declare const withValidator: Story;
+export declare const IconLeft: Story;
+export declare const Summary: Story;