From f54aa47c72a535dc6810ea843ca0147a56bc1d21 Mon Sep 17 00:00:00 2001
From: Mehedi Jaman <mail4mjaman@gmail.com>
Date: Tue, 19 Aug 2025 22:52:40 +0600
Subject: [PATCH 1/5] feat(AppDataSearch): add customizable placeholder prop

### Summary
This PR introduces a `placeholder` prop to the `AppDataSearch` component, allowing consumers to define custom placeholder text instead of using the hardcoded "Search".

### Changes
- Added `placeholder` prop with default value `"Search"`
- Updated template to use `:placeholder="placeholder"` instead of `__('Search')`
- Maintains backward compatibility (defaults to `"Search"` if no prop is passed)

### Usage Example
```vue
<AppDataSearch
    :url="route('student.index')"
    fields-to-search="name"
    placeholder="Search by student name"
></AppDataSearch>
---
 stubs/resources/js/Components/DataTable/AppDataSearch.vue | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/stubs/resources/js/Components/DataTable/AppDataSearch.vue b/stubs/resources/js/Components/DataTable/AppDataSearch.vue
index 4ee9114..b3b3d3c 100644
--- a/stubs/resources/js/Components/DataTable/AppDataSearch.vue
+++ b/stubs/resources/js/Components/DataTable/AppDataSearch.vue
@@ -8,7 +8,7 @@
             <AppInputText
                 id="search"
                 v-model="searchTerm"
-                :placeholder="__('Search')"
+                :placeholder="placeholder"
                 name="search"
                 class="w-full py-2 pl-9 md:w-1/2"
             ></AppInputText>
@@ -39,6 +39,10 @@ const props = defineProps({
     additionalParams: {
         type: Object,
         default: () => {}
+    },
+     placeholder: {
+        type: String,
+        default: 'Search'
     }
 })
 

From 6f25560444a6657f0f3511a2d33dd2227902aff8 Mon Sep 17 00:00:00 2001
From: Mehedi Jaman <mail4mjaman@gmail.com>
Date: Thu, 28 Aug 2025 12:43:25 +0600
Subject: [PATCH 2/5] feat: add AppMultiCombobox component for multi-select
 dropdown

- Implemented a reusable multi-select combobox component (`AppMultiCombobox.vue`)
- Supports search, tag-style selected items, and keyboard navigation
- Emits `update:modelValue` with array of selected options
- Styled consistently with existing `AppCombobox` component
- Enables selecting multiple recipients in message compose form
---
 .../js/Components/Form/AppMultiCombobox.vue   | 223 ++++++++++++++++++
 1 file changed, 223 insertions(+)
 create mode 100644 stubs/resources/js/Components/Form/AppMultiCombobox.vue

diff --git a/stubs/resources/js/Components/Form/AppMultiCombobox.vue b/stubs/resources/js/Components/Form/AppMultiCombobox.vue
new file mode 100644
index 0000000..60c0c2f
--- /dev/null
+++ b/stubs/resources/js/Components/Form/AppMultiCombobox.vue
@@ -0,0 +1,223 @@
+<template>
+    <div ref="wrapperRef" class="relative w-64">
+        <!-- Button to open dropdown -->
+        <AppButton
+            class="mt-1 flex w-full flex-wrap justify-between rounded-md border-0 bg-skin-neutral-1 px-3 py-2 text-left text-skin-neutral-12 shadow-sm ring-1 ring-inset ring-skin-neutral-7 focus:ring-2 focus:ring-inset focus:ring-skin-neutral-7 sm:text-sm sm:leading-6"
+            aria-haspopup="true"
+            :aria-expanded="isOpen"
+            @click="toggleState"
+        >
+            <!-- Selected tags -->
+            <div class="flex flex-wrap gap-1">
+                <span
+                    v-for="(item, index) in modelValue"
+                    :key="item.value"
+                    class="flex items-center rounded bg-skin-neutral-3 px-2 py-1 text-xs text-skin-neutral-12"
+                >
+                    {{ item.label }}
+                    <i
+                        class="ri-close-line ml-1 cursor-pointer hover:text-red-500"
+                        @click.stop="remove(index)"
+                    />
+                </span>
+
+                <span v-if="!modelValue.length" class="text-skin-neutral-9">
+                    {{ comboLabel }}
+                </span>
+            </div>
+
+            <span class="ml-auto">
+                <i class="ri-arrow-down-line hover:text-skin-neutral-9"></i>
+            </span>
+        </AppButton>
+
+        <!-- Dropdown -->
+        <transition name="slide-fade">
+            <div v-show="isOpen" class="absolute z-50 mt-1 w-full">
+                <!-- Search -->
+                <div v-show="useSearch" class="bg-white p-1 shadow">
+                    <label :for="getElementId()" class="sr-only">Search</label>
+                    <div class="relative">
+                        <div
+                            class="pointer-events-none absolute inset-y-0 left-0 flex items-center pl-3"
+                        >
+                            <i class="ri-search-line" aria-hidden="true"></i>
+                        </div>
+                        <AppInputText
+                            :id="getElementId()"
+                            ref="searchInputRef"
+                            v-model="searchOptionText"
+                            role="searchbox"
+                            aria-autocomplete="list"
+                            type="text"
+                            class="pl-10"
+                            :placeholder="searchPlaceholder"
+                            @keypress.enter="validateOptionHighlighted"
+                            @keydown="handleArrowKeys"
+                            @keydown.esc="toggleState"
+                        />
+                    </div>
+                </div>
+
+                <!-- Options -->
+                <ul
+                    class="max-h-60 overflow-y-auto bg-white p-1 shadow"
+                    role="listbox"
+                >
+                    <li
+                        v-for="(option, index) in filteredOptions"
+                        :key="option.value"
+                        role="option"
+                        class="flex items-center gap-2 px-4 py-2 text-sm hover:cursor-pointer hover:bg-skin-neutral-3 hover:text-skin-neutral-12"
+                        :class="{
+                            'bg-skin-neutral-3 text-skin-neutral-12':
+                                index === highlightedIndex
+                        }"
+                        @click="toggleSelect(option)"
+                    >
+                        <input
+                            type="checkbox"
+                            class="rounded border-gray-300"
+                            :checked="isSelected(option)"
+                            @change="toggleSelect(option)"
+                        />
+                        {{ option.label }}
+                    </li>
+                </ul>
+            </div>
+        </transition>
+    </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted, watch } from 'vue'
+import slug from '@resources/js/Utils/slug.js'
+import useClickOutside from '@resources/js/Composables/useClickOutside'
+
+const props = defineProps({
+    modelValue: {
+        type: Array,
+        required: true,
+        default: () => []
+    },
+    comboLabel: {
+        type: String,
+        default: 'Select options'
+    },
+    useSearch: {
+        type: Boolean,
+        default: true
+    },
+    searchPlaceholder: {
+        type: String,
+        default: 'Search'
+    },
+    options: {
+        type: Array,
+        default: () => []
+    }
+})
+
+const emit = defineEmits(['update:modelValue'])
+
+const wrapperRef = ref(null)
+const { isClickOutside } = useClickOutside(wrapperRef)
+
+watch(isClickOutside, (val) => {
+    if (val) {
+        isOpen.value = false
+    }
+})
+
+onMounted(() => {
+    isOpen.value && (highlightedIndex.value = 0)
+})
+
+const getElementId = () => {
+    return slug(props.comboLabel)
+}
+
+const isOpen = ref(false)
+const searchInputRef = ref(null)
+
+const toggleState = () => {
+    isOpen.value = !isOpen.value
+    highlightedIndex.value = 0
+    window.setTimeout(() => {
+        if (isOpen.value) {
+            searchOptionText.value = ''
+            searchInputRef.value.focusInput()
+        }
+    }, 100)
+}
+
+const searchOptionText = ref('')
+
+const filteredOptions = computed(() => {
+    if (searchOptionText.value) {
+        return props.options.filter((option) =>
+            option.label
+                .toLowerCase()
+                .includes(searchOptionText.value.toLowerCase())
+        )
+    } else {
+        return props.options
+    }
+})
+
+const highlightedIndex = ref(0)
+
+const handleArrowKeys = (event) => {
+    switch (event.key) {
+        case 'ArrowUp':
+            if (highlightedIndex.value > 0) {
+                highlightedIndex.value--
+            }
+            break
+        case 'ArrowDown':
+            if (highlightedIndex.value < filteredOptions.value.length - 1) {
+                highlightedIndex.value++
+            }
+            break
+    }
+}
+
+const validateOptionHighlighted = () => {
+    if (filteredOptions.value[highlightedIndex.value]) {
+        toggleSelect(filteredOptions.value[highlightedIndex.value])
+    }
+}
+
+const isSelected = (option) => {
+    return props.modelValue.some((item) => item.value === option.value)
+}
+
+const toggleSelect = (option) => {
+    let newValue
+    if (isSelected(option)) {
+        newValue = props.modelValue.filter(
+            (item) => item.value !== option.value
+        )
+    } else {
+        newValue = [...props.modelValue, option]
+    }
+    emit('update:modelValue', newValue)
+}
+
+const remove = (index) => {
+    const newValue = [...props.modelValue]
+    newValue.splice(index, 1)
+    emit('update:modelValue', newValue)
+}
+</script>
+
+<style scoped>
+.slide-fade-enter-active,
+.slide-fade-leave-active {
+    @apply transition-all duration-200 ease-in;
+}
+.slide-fade-enter-from,
+.slide-fade-leave-to {
+    @apply -translate-y-2 opacity-0;
+}
+</style>

From ddf2d31684571f35ce162daf8cbd17d3c2614ef7 Mon Sep 17 00:00:00 2001
From: Mehedi Jaman <mail4mjaman@gmail.com>
Date: Fri, 29 Aug 2025 11:52:07 +0600
Subject: [PATCH 3/5] Update Topbar: Add Fullscreen Toggle with Animation and
 Persisted Icon State

Fullscreen Toggle

Added a fullscreen button with smooth rotate + scale animation.

Fullscreen state icon (maximize / minimize) persists in localStorage.

Automatically updates icon when exiting fullscreen via Esc.

Notes:

Fullscreen cannot be automatically restored on page reload due to browser security restrictions; only the icon state persists.

Logout and theme toggling functionality remain unaffected.
---
 .../js/Components/Misc/AppTopBar.vue          | 66 +++++++++++++++++--
 1 file changed, 59 insertions(+), 7 deletions(-)

diff --git a/stubs/resources/js/Components/Misc/AppTopBar.vue b/stubs/resources/js/Components/Misc/AppTopBar.vue
index ca14d69..c8325bc 100644
--- a/stubs/resources/js/Components/Misc/AppTopBar.vue
+++ b/stubs/resources/js/Components/Misc/AppTopBar.vue
@@ -1,10 +1,10 @@
 <template>
     <div
-        class="bg-neutral-2 text-neutral-11 sticky top-0 z-40 flex h-16 shrink-0 justify-between py-3 pr-9 pl-3 shadow-xs"
+        class="sticky top-0 z-40 flex h-16 flex-shrink-0 justify-between bg-skin-neutral-2 py-3 pl-3 pr-4 text-skin-neutral-11 shadow-sm md:pr-6"
     >
         <div class="flex items-center">
             <AppButton
-                class="btn btn-icon hover:bg-neutral-4"
+                class="btn btn-icon hover:bg-skin-neutral-5"
                 @click="$emit('sidebar:toggle')"
             >
                 <i class="ri-menu-line"></i>
@@ -13,17 +13,33 @@
             <h1 class="flex items-center">{{ title }}</h1>
         </div>
 
-        <div class="flex items-center">
+        <div class="flex items-center gap-1">
+            <!-- Fullscreen toggle with animation -->
+            <AppButton
+                class="btn btn-icon hover:bg-skin-neutral-5 transition-all duration-300"
+                @click="toggleFullscreen"
+            >
+                <i
+                    :class="iconFullscreenClass"
+                    class="transition-transform duration-500 ease-in-out"
+                    :style="{ transform: isFullscreen ? 'rotate(180deg) scale(1.2)' : 'rotate(0deg) scale(1)' }"
+                ></i>
+            </AppButton>
+
+            
+            <!-- Theme toggle -->
             <AppButton
                 href="#"
-                class="btn btn-icon hover:bg-neutral-4"
+                class="btn btn-icon hover:bg-skin-neutral-5 transition-all duration-300"
                 @click="toggleTheme"
             >
                 <i :class="iconThemeClass"></i>
             </AppButton>
 
+            
+            <!-- Logout -->
             <AppButton
-                class="btn btn-icon hover:bg-neutral-4"
+                class="btn btn-icon hover:bg-skin-neutral-5"
                 @click="$inertia.visit(route('adminAuth.logout'))"
             >
                 <i class="ri-logout-circle-r-line"></i>
@@ -33,9 +49,9 @@
 </template>
 
 <script setup>
-import { ref, onMounted } from 'vue'
+import { ref, onMounted, onUnmounted } from 'vue'
 
-defineProps({
+const props = defineProps({
     title: {
         type: String,
         default: ''
@@ -44,6 +60,7 @@ defineProps({
 
 defineEmits(['sidebar:toggle'])
 
+/* ========== THEME ========== */
 const iconThemeClass = ref('ri-sun-line')
 
 onMounted(() => {
@@ -67,4 +84,39 @@ const toggleTheme = () => {
         iconThemeClass.value = 'ri-sun-line'
     }
 }
+
+/* ========== FULLSCREEN ========== */
+const isFullscreen = ref(false)
+const iconFullscreenClass = ref('ri-fullscreen-line')
+
+const toggleFullscreen = () => {
+    if (!isFullscreen.value) {
+        document.documentElement.requestFullscreen()
+    } else {
+        document.exitFullscreen()
+    }
+}
+
+const updateFullscreenState = () => {
+    isFullscreen.value = !!document.fullscreenElement
+    iconFullscreenClass.value = isFullscreen.value
+        ? 'ri-fullscreen-exit-line'
+        : 'ri-fullscreen-line'
+
+    // Persist fullscreen state
+    localStorage.setItem('fullscreen', isFullscreen.value ? '1' : '0')
+}
+
+onMounted(() => {
+    document.addEventListener('fullscreenchange', updateFullscreenState)
+
+    // Restore fullscreen if previously enabled
+    if (localStorage.getItem('fullscreen') === '1') {
+        document.documentElement.requestFullscreen().catch(() => {})
+    }
+})
+
+onUnmounted(() => {
+    document.removeEventListener('fullscreenchange', updateFullscreenState)
+})
 </script>

From 27a26d67235a73d5b35325597a07bebf2c4f3a37 Mon Sep 17 00:00:00 2001
From: Mehedi Jaman <mail4mjaman@gmail.com>
Date: Fri, 29 Aug 2025 12:10:59 +0600
Subject: [PATCH 4/5] Fix logout to redirect to login form route

- Updated logout() to redirect to GET route 'adminAuth.loginForm' instead of POST login route.
- Ensures a fresh CSRF token is generated and avoids 419 Page Expired errors on first login after logout.
- Session is invalidated and CSRF token regenerated for security.
---
 .../Http/Controllers/AuthenticatedSessionController.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php b/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
index 1ec7cec..549b625 100644
--- a/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
+++ b/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
@@ -48,6 +48,6 @@ public function logout(Request $request)
 
         $request->session()->regenerateToken();
 
-        return Inertia::location(config('modular.login-url'));
+        return redirect()->route('adminAuth.loginForm');
     }
 }

From 3e07921917948c76b252dcbf418a47696e307798 Mon Sep 17 00:00:00 2001
From: Mehedi Jaman <mail4mjaman@gmail.com>
Date: Sat, 6 Sep 2025 22:37:38 +0600
Subject: [PATCH 5/5] Update AuthenticatedSessionController.php

---
 .../Http/Controllers/AuthenticatedSessionController.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php b/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
index 549b625..3b2d0a4 100644
--- a/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
+++ b/stubs/modules/AdminAuth/Http/Controllers/AuthenticatedSessionController.php
@@ -47,7 +47,7 @@ public function logout(Request $request)
         $request->session()->invalidate();
 
         $request->session()->regenerateToken();
-
-        return redirect()->route('adminAuth.loginForm');
+        
+        return Inertia::location(config('modular.login-url'));
     }
 }