create-nexgen 1.0.4

package/template/src/resources/src/components/Select.vue

@@ -0,0 +1,390 @@
+<script setup lang="ts">
+import {
+  ref,
+  reactive,
+  onMounted,
+  nextTick,
+  computed,
+  onBeforeUnmount,
+  watch,
+  useAttrs
+} from "vue";
+import { debounce } from "lodash-es";
+import axios from "axios";
+import vSelect from "vue-select";
+import "vue-select/dist/vue-select.css";
+import { empty } from "../helpers/utils";
+
+defineOptions({ name: "Select", inheritAttrs: false });
+
+type AnyRecord = Record<string, unknown>;
+type SelectValue = string | number | boolean | AnyRecord | null;
+type OptionHook = ((value: unknown) => void | Promise<void>) | null;
+
+interface FetchPack {
+  url?: string | null;
+  data?: string | null;
+  params?: AnyRecord;
+  mapFn?: (x: AnyRecord) => AnyRecord;
+  option?:
+  | ((value: unknown) => void | Promise<void>)
+  | Array<(value: unknown) => void | Promise<void>>;
+  reset?: boolean;
+  reload?: boolean;
+}
+
+interface SelectProps {
+  fetched?: (payload: {
+    search: string;
+    reset?: boolean;
+    reload?: boolean;
+  }) => Promise<FetchPack | null | undefined> | FetchPack | null | undefined;
+  must?: boolean;
+  err?: string | boolean;
+  hood?: string | boolean;
+  defaultValue?: SelectValue;
+  resetKey?: string | number | boolean | AnyRecord | null;
+}
+
+const $attrs = useAttrs();
+const props = withDefaults(defineProps<SelectProps>(), {
+  defaultValue: null,
+  resetKey: null
+});
+
+// vue3.4 way
+const emit = defineEmits<{
+  (event: "fetched"): void;
+  (event: "clear"): void;
+}>();
+const model = defineModel<SelectValue | SelectValue[]>();
+
+const skipNextSearch = ref(false); // suppress search right after clear
+
+let observer = ref<IntersectionObserver | null>(null);
+let load = ref<HTMLElement | null>(null);
+
+// store callbacks coming from fetchedDropdown(pack)
+const hooks = ref<{ option: OptionHook | OptionHook[]; }>({ option: null }); // function | function[] | null
+
+// remember last fetch config and search so the child can refetch/append by itself
+const lastPack = ref<FetchPack | null>(null); // { url, data, params, mapFn }
+const lastSearch = ref(""); // current search term
+
+const hasNextPage = computed(() => {
+  const total = Number((fieldData.value as { total?: number; }).total ?? 0);
+  return field.all.length < total;
+});
+
+// ask parent for a pack and run our internal fetcher
+const callParentFetched = async (search: string, opts: Partial<FetchPack> = {}) => {
+  const maybePack = await props.fetched?.({ search, ...opts });
+  if (maybePack && typeof maybePack === "object") {
+    await fetchedDropdown(search, { ...maybePack, ...opts });
+  }
+};
+
+const onClear = () => {
+  resetMe(); // clear options + selected value
+  skipNextSearch.value = true; // suppress the immediate empty search
+  emit("clear"); // notify parent that clear button was clicked
+};
+
+const onOpen = async () => {
+  // if empty, load page 1 via parent fetcher (no boolean flags)
+  if (!field.all.length) {
+    if (lastPack.value) {
+      await fetchedDropdown("", { ...lastPack.value, reset: true });
+    } else {
+      // await props.fetched?.('');
+      await callParentFetched("", { reset: true });
+    }
+  }
+
+  await nextTick();
+  if (load.value && hasNextPage.value) {
+    observer.value?.observe(load.value);
+  }
+};
+
+const onClose = async () => {
+  observer.value?.disconnect();
+};
+
+const onModelUpdate = async (val: unknown) => {
+  const optHooks = Array.isArray(hooks.value.option)
+    ? hooks.value.option
+    : hooks.value.option
+      ? [hooks.value.option]
+      : [];
+
+  // When user clicks × or backspaces everything, v-select sets model to null.
+  if (val == null || val === "") {
+    for (const f of optHooks) {
+      if (typeof f === "function") {
+        await Promise.resolve(f(null));
+      }
+    }
+    emit("clear");
+    return;
+  }
+
+  field.val = val as SelectValue;
+
+  for (const f of optHooks) {
+    if (typeof f === "function") {
+      await Promise.resolve(f(val));
+    }
+  }
+};
+
+const inputSearch = debounce(async (search: string, loading: (value: boolean) => void) => {
+  if (skipNextSearch.value && (!search || !search.trim().length)) {
+    skipNextSearch.value = false; // consume the flag
+    return;
+  }
+
+  if (search && search.trim().length) {
+    loading(true);
+    if (lastPack.value) {
+      await fetchedDropdown(search, { ...lastPack.value, reset: true }).finally(() =>
+        loading(false)
+      );
+    } else {
+      await callParentFetched(search, { reset: true }).finally(() => loading(false));
+    }
+  } else {
+    // user erased the query manually
+    field.page = 0;
+    if (lastPack.value) {
+      await fetchedDropdown("", { ...lastPack.value }); // no reset → keep list
+    } else {
+      await callParentFetched("");
+    }
+    await nextTick();
+    if (load.value && hasNextPage.value) observer.value?.observe(load.value);
+  }
+}, 400);
+
+const infiniteScroll = async ([{ isIntersecting, target }]: IntersectionObserverEntry[]) => {
+  if (!isIntersecting) return;
+  const ul =
+    target instanceof HTMLElement && target.offsetParent instanceof HTMLElement
+      ? target.offsetParent
+      : null;
+  const scrollTop = ul?.scrollTop ?? 0;
+  if (lastPack.value) {
+    await fetchedDropdown(lastSearch.value, { ...lastPack.value }); // next page of current mode
+  } else {
+    await callParentFetched(lastSearch.value || "");
+  }
+  await nextTick();
+  if (ul) ul.scrollTop = scrollTop;
+};
+
+onMounted(async () => {
+  observer.value = new IntersectionObserver(infiniteScroll);
+
+  // set default value if provided
+  if (props.defaultValue) {
+    await nextTick();
+    field.val = props.defaultValue;
+    model.value = props.defaultValue;
+  }
+});
+
+onBeforeUnmount(() => {
+  observer.value?.disconnect();
+  observer.value = null;
+});
+
+// prototype and it will call from parent
+const field = reactive<{ all: AnyRecord[]; val: SelectValue; page: number; size: number; }>({
+  all: [],
+  val: "",
+  page: 0,
+  size: 10
+});
+const fieldData = ref<AnyRecord>({});
+
+const resetMe = () => {
+  field.all = [];
+  field.page = 0;
+  field.val = "";
+};
+
+const reloadMe = () => {
+  field.all = [];
+  field.page = 0;
+};
+
+const fetchedDropdown = async (search: string, pack: FetchPack | null = null) => {
+  const url = pack?.url ?? null;
+  const data = pack?.data ?? null;
+  const params = pack?.params ?? {};
+  const mapFn = pack?.mapFn ?? ((x: AnyRecord) => x);
+  const reset = !!pack?.reset;
+  const reload = !!pack?.reload;
+
+  // make option sticky: only overwrite if caller provided it
+  if (Object.prototype.hasOwnProperty.call(pack ?? {}, "option")) {
+    const pOpt = pack?.option;
+    hooks.value.option = Array.isArray(pOpt)
+      ? pOpt.filter((fn) => typeof fn === "function")
+      : typeof pOpt === "function"
+        ? [pOpt]
+        : [];
+  }
+
+  // remember essentials so the child can refetch/append on its own
+  lastPack.value = { url, data, params, mapFn };
+  lastSearch.value = search ?? "";
+
+  // if pass and true -> reset, reload , search
+  (reset && resetMe()) ||
+    (reload && reloadMe()) ||
+    (!empty(search) && !reset && !reload && reloadMe());
+
+  // after reset/reload/search
+  field.page++;
+  const param = { page: field.page, size: field.size, search: search };
+
+  // log once (don't call axios twice)
+  // console.log('GET', pack.url, { params: pack.params ? { ...pack.params, ...param } : param });
+
+  if (!url || !data) {
+    return;
+  }
+
+  const key = await axios.get(url, { params: params ? { ...params, ...param } : param });
+  const payload = key.data[data as string] as AnyRecord;
+
+  fieldData.value = payload;
+  const rows = Array.isArray((payload as { data?: unknown; }).data)
+    ? (payload as { data: AnyRecord[]; }).data
+    : [];
+  // console.log('Fetched', payload?.data);
+  rows.forEach((dt) => {
+    const opt = mapFn(dt);
+    const key = opt?.id ?? opt?.title ?? JSON.stringify(opt); // build a comparison key: prefer id, then title, then full object
+
+    if (
+      !field.all.some(
+        (o) =>
+          ((o as { id?: unknown; title?: unknown; }).id ??
+            (o as { id?: unknown; title?: unknown; }).title ??
+            JSON.stringify(o)) === key
+      )
+    ) {
+      field.all = [...field.all, opt];
+    }
+  });
+};
+
+/**
+ * This function created for
+ * functionally reset or reload
+ * from without component
+ * like fn.value.reload({reset:true/reload:true/both});
+ * it is exposed, so we can call from with
+ * template ref
+ */
+const reload = async () => {
+  resetMe(); // clear field.all, page, val
+  await callParentFetched("", { reset: true }); // ask parent to fetch first page again
+};
+
+/**
+ * if backend send proper object or null
+ * then watch function not get any axios
+ * error else axios can send error
+ */
+watch(
+  () => props.resetKey,
+  async (newVal, oldVal) => {
+    if (oldVal === undefined) return;
+
+    const optHooks = Array.isArray(hooks.value.option)
+      ? hooks.value.option
+      : hooks.value.option
+        ? [hooks.value.option]
+        : [];
+
+    resetMe(); // clears field.all, field.page, field.val
+    model.value = "";
+
+    // Notify hooks that selection is gone
+    for (const fn of optHooks) {
+      if (typeof fn === "function") {
+        await Promise.resolve(fn(null));
+      }
+    }
+
+    skipNextSearch.value = true; // avoid instant empty-search call
+    await callParentFetched("", { reset: true, reload: true });
+  }
+);
+
+defineExpose({ field, fieldData, fetchedDropdown, reload });
+
+const parentClass = computed(() => ($attrs.parentclass as string | undefined) || "mb-2");
+const inputId = computed(() => ($attrs.id as string | undefined) || "");
+const inputTitle = computed(() => ($attrs.title as string | undefined) || "");
+const hoodHtml = computed(() =>
+  props.hood === false || props.hood == null ? "" : String(props.hood)
+);
+</script>
+
+<template>
+  <div :class="parentClass">
+    <label
+      :for="inputId"
+      class="text-capitalize d-flex align-items-center mb-1"
+      :class="{ 'd-none': !inputTitle }">
+      <div class="position-relative">
+        <span class="text-capitalize" v-html="inputTitle"></span>
+        <span
+          class="position-absolute text-danger rounded-circle bg-danger must"
+          :class="{ 'd-none': !props.must }"></span>
+      </div>
+      <div
+        class="text-uppercase w-100 text-end text-primary fw-semibold"
+        :class="{ 'd-none': !props.hood }"
+        style="font-size: 12px; margin-top: 0.15rem"
+        v-html="hoodHtml"></div>
+    </label>
+    <v-select
+      v-model="model"
+      label="title"
+      :filterable="false"
+      :options="field.all"
+      v-bind="$attrs"
+      @open="onOpen"
+      @update:model-value="onModelUpdate"
+      @close="onClose"
+      @search="inputSearch"
+      @clear="onClear">
+      <template #list-footer>
+        <li v-show="hasNextPage" ref="load" class="loader">More...</li>
+      </template>
+    </v-select>
+    <div class="form-text text-danger" :class="{ 'd-none': !props.err }" style="font-size: 0.8rem">
+      {{ props.err }}
+    </div>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+.loader {
+  text-align: center;
+  color: #bbbbbb;
+}
+
+.must {
+  width: 4px;
+  height: 4px;
+  top: 0;
+  margin-top: 5px;
+  margin-left: 2px;
+}
+</style>

package/template/src/resources/src/components/Spinner.vue

@@ -0,0 +1,42 @@
+<template>
+  <div class="h-100" v-bind="$attrs">
+    <div class="h-100 d-flex align-items-center justify-content-center">
+      <div class="spinner-grow" :style="spinnerStyle" role="status">
+        <span class="visually-hidden">Loading...</span>
+      </div>
+      <div class="fw-bold ms-2">
+        <span v-if="props.text" :class="props.textsize" :style="textStyle">
+          {{ props.text }}
+        </span>
+        <span v-else>Loading...</span>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from "vue";
+
+defineOptions({ name: "Spinner", inheritAttrs: false });
+
+interface SpinnerProps {
+  size?: string;
+  text?: string;
+  textsize?: string;
+}
+
+const props = withDefaults(defineProps<SpinnerProps>(), {
+  size: "3rem",
+  text: "",
+  textsize: ""
+});
+
+const spinnerStyle = computed(() => ({
+  width: props.size,
+  height: props.size
+}));
+
+const textStyle = computed(() => ({
+  fontSize: props.textsize || undefined
+}));
+</script>

package/template/src/resources/src/components/Switch.vue

@@ -0,0 +1,65 @@
+<template>
+  <div :class="wrapperClass">
+    <label :class="props.vertical ? 'form-check-label d-block' : 'd-none'">
+      <span v-html="statusHtml"></span>
+    </label>
+    <div class="form-check form-switch d-inline-block">
+      <input
+        class="form-check-input shadow-none border-primary"
+        type="checkbox"
+        role="switch"
+        :checked="isChecked"
+        v-bind="$attrs" />
+      <label :class="props.vertical ? 'd-none' : 'form-check-label'">
+        <span v-html="statusHtml"></span>
+      </label>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, useAttrs } from "vue";
+
+defineOptions({ name: "Switch", inheritAttrs: false });
+
+interface SwitchProps {
+  modelValue?: string | number | boolean;
+  value?: unknown[] | Record<string, unknown> | string | number | boolean;
+  vertical?: boolean;
+  checked?: boolean | number;
+}
+
+const $attrs = useAttrs();
+const props = defineProps<SwitchProps>();
+
+const textLabel = computed(() => ($attrs.text as string | undefined) || "");
+const blankLabel = computed(() => ($attrs.blank as string | undefined) || "");
+const topclass = computed(() => ($attrs.topclass as string | undefined) || "");
+
+const isChecked = computed(() => Boolean(props.checked));
+
+const wrapperClass = computed(() => (props.vertical ? `text-center ${topclass.value}`.trim() : ""));
+
+const statusHtml = computed(() => {
+  if (isChecked.value) {
+    return `<div class='d-flex justify-content-center'><span>${textLabel.value}</span><div class='rounded-circle bg-success indicator'></div></div>`;
+  }
+
+  return `<div class='d-flex justify-content-center'><span>${blankLabel.value}</span><div class='rounded-circle bg-danger indicator'></div></div>`;
+});
+</script>
+
+<style lang="scss">
+.indicator {
+  width: 4px;
+  height: 4px;
+  margin-left: 2px;
+  margin-top: 5px;
+}
+</style>
+<style lang="scss" scoped>
+label,
+input {
+  cursor: pointer;
+}
+</style>

package/template/src/resources/src/components/TextArea.vue

@@ -0,0 +1,121 @@
+<template>
+  <div :class="wrapperClass">
+    <div class="position-relative">
+      <div class="position-relative mb-1">
+        <span class="text-capitalize" v-html="inputLabel"></span>
+        <span
+          class="position-absolute text-danger rounded-circle bg-danger must"
+          :class="{ 'd-none': !props.must }"></span>
+      </div>
+      <div class="form-floating h-100">
+        <textarea
+          :value="props.modelValue"
+          class="form-control mb-0 h-100"
+          :maxlength="maxLengthAttr"
+          :aria-describedby="`${inputId}Help`"
+          v-bind="$attrs"
+          @input="updateModel">
+        </textarea>
+        <label
+          :for="inputId"
+          class="d-block placeholder-label border-0"
+          :class="{ 'd-none': !placeholderText }">
+          {{ placeholderText }}
+        </label>
+      </div>
+      <label
+        class="position-absolute end-0 pe-1 text-secondary max"
+        :class="{ 'd-none': !max }"
+        style="top: 28px">
+        {{ maxCounter }}
+      </label>
+    </div>
+    <div :id="`${inputId}Help`" class="form-text text-danger" :class="{ 'd-none': !props.err }">
+      {{ props.err }}
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, nextTick, onMounted, useAttrs } from "vue";
+
+defineOptions({ name: "TextArea", inheritAttrs: false });
+
+const $attrs = useAttrs();
+interface TextAreaProps {
+  focus?: boolean;
+  must?: boolean;
+  err?: string | boolean;
+  modelValue?: string | number;
+}
+
+const props = withDefaults(defineProps<TextAreaProps>(), {
+  modelValue: ""
+});
+
+const inputId = computed(() => ($attrs.id as string | undefined) || "");
+const inputLabel = computed(() => ($attrs.label as string | undefined) || "");
+const placeholderText = computed(() => ($attrs.placeholder as string | undefined) || "");
+const topclass = computed(() => ($attrs.topclass as string | undefined) || "");
+
+const wrapperClass = computed(() =>
+  topclass.value ? `${topclass.value} position-relative` : "mb-2"
+);
+
+const max = computed<number | null>(() => {
+  const raw = $attrs.maxlength as string | number | undefined;
+  return raw != null ? Number(raw) : null;
+});
+const maxLengthAttr = computed<number | undefined>(() => max.value ?? undefined);
+const maxCounter = computed(() =>
+  max.value == null ? "" : max.value - String(props.modelValue).length
+);
+
+const emit = defineEmits<{
+  (event: "update:modelValue", value: string): void;
+}>();
+const updateModel = (e: Event) => {
+  const target = e.target as HTMLTextAreaElement;
+  emit("update:modelValue", target.value);
+};
+
+onMounted(() => {
+  if (!props.focus || !inputId.value) {
+    return;
+  }
+
+  nextTick(() => {
+    const textarea = document.querySelector(`#${inputId.value}`) as HTMLTextAreaElement | null;
+    textarea?.focus();
+  });
+});
+</script>
+
+<style lang="scss" scoped>
+.form-floating {
+  label {
+    top: -1px;
+    left: 1px;
+  }
+
+  textarea:focus + label,
+  textarea:not(:placeholder-shown) + label {
+    top: -6px;
+  }
+}
+
+.placeholder-label {
+  color: #cccccc !important;
+}
+
+.must {
+  width: 4px;
+  height: 4px;
+  margin-left: 2px;
+  margin-top: 5px;
+}
+
+.max {
+  font-size: 0.6rem;
+}
+</style>

package/template/src/resources/src/components/Toast.vue

@@ -0,0 +1,56 @@
+<template>
+  <Teleport to="#toast-show">
+    <div
+      ref="notify"
+      class="toast position-fixed"
+      role="alert"
+      aria-live="assertive"
+      aria-atomic="true"
+      style="z-index: 1000000; top: 10px; right: 23px"
+      data-bs-delay="2000">
+      <div :class="`text-bg-${bgcolor} align-items-center rounded-1 shadow-sm`">
+        <div class="d-flex">
+          <div class="toast-body">
+            {{ message }}
+          </div>
+          <button
+            type="button"
+            class="btn-close btn-close-white me-2 m-auto"
+            data-bs-dismiss="toast"
+            aria-label="Close"></button>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<script setup lang="ts">
+import { ref } from "vue";
+import { Toast } from "bootstrap";
+
+defineOptions({ name: "Toast", inheritAttrs: false });
+
+interface ToastProps {
+  icon?: string;
+}
+
+defineProps<ToastProps>();
+
+const notify = ref<HTMLElement | null>(null);
+const message = ref("");
+const bgcolor = ref("primary");
+
+const toastme = (msg: string, bg: string) => {
+  message.value = msg;
+  bgcolor.value = bg;
+  if (!notify.value) {
+    return;
+  }
+  const toast = Toast.getOrCreateInstance(notify.value);
+  toast.show();
+};
+
+defineExpose({ toastme });
+</script>
+
+<style lang="scss" scoped></style>