@asd20/ui-next 2.11.0 → 2.12.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+# [2.12.0](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.11.1...ui-next-v2.12.0) (2026-05-26)
+
+
+### Bug Fixes
+
+* add querypeople to public api contract ([a1a3141](https://github.com/academydistrict20/asd20-ui-next/commit/a1a3141ec8b3df29da27e947fecba80baf0169e1))
+
+
+### Features
+
+* add people to ai search ([241cf12](https://github.com/academydistrict20/asd20-ui-next/commit/241cf1247633f83a47b6fe3cd3bc91bbff275e80))
+
+## [2.11.1](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.11.0...ui-next-v2.11.1) (2026-05-26)
+
+
+### Bug Fixes
+
+* remove search parameters from url ([b6bde4c](https://github.com/academydistrict20/asd20-ui-next/commit/b6bde4cb29ea762267ecd03f9739a47d8726ce1e))
+
 # [2.11.0](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.10.11...ui-next-v2.11.0) (2026-05-26)
 
 

package/helpers.js

@@ -42,6 +42,7 @@ export { default as queryEvents } from './src/helpers/queryEvents.js'
 export { default as queryFiles } from './src/helpers/queryFiles.js'
 export { default as queryMessages } from './src/helpers/queryMessages.js'
 export { default as queryPages } from './src/helpers/queryPages.js'
+export { default as queryPeople } from './src/helpers/queryPeople.js'
 export { default as sendAccessibilityIssue } from './src/helpers/sendAccessibilityIssue.js'
 export { default as sendEmail } from './src/helpers/sendEmail.js'
 export { default as sortOrgsByLevel } from './src/helpers/sortOrgsByLevel.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asd20/ui-next",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "private": false,
   "description": "ASD20 UI component library for Vue 3.",
   "license": "MIT",

package/src/components/organisms/Asd20AiSearch/index.vue

@@ -53,12 +53,14 @@ export default {
     pages: { type: Array, default: () => [] },
     files: { type: Array, default: () => [] },
     groups: { type: Array, default: () => [] },
+    people: { type: Array, default: () => [] },
     showContacts: { type: Boolean, default: true },
     includeDistrictResults: { type: Boolean, default: true },
     searchLanguageCode: { type: String, default: null },
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     organization: { type: Object, default: () => ({}) },
     organizationOptions: { type: Array, default: () => [] },

package/src/components/organisms/Asd20SiteNavigation/index.vue

@@ -71,11 +71,13 @@
         :pages="pages"
         :files="files"
         :groups="groups"
+        :people="people"
         :include-district-results="includeDistrictResults"
         :search-language-code="searchLanguageCode"
         :query-pages-handler="queryPagesHandler"
         :query-files-handler="queryFilesHandler"
         :query-groups-handler="queryGroupsHandler"
+        :query-people-handler="queryPeopleHandler"
         :query-ai-site-handler="queryAiSiteHandler"
         :organization="organization"
         :organization-options="organizationOptions"
@@ -118,12 +120,14 @@ export default {
     pages: { type: Array, default: () => [] },
     files: { type: Array, default: () => [] },
     groups: { type: Array, default: () => [] },
+    people: { type: Array, default: () => [] },
     showContacts: { type: Boolean, default: true },
     includeDistrictResults: { type: Boolean, default: true },
     searchLanguageCode: { type: String, default: null },
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     organization: { type: Object, default: null },
     organizationOptions: { type: Array, default: () => [] },

package/src/components/organisms/Asd20SiteSearch/index.vue

@@ -324,37 +324,35 @@
             v-if="
               hasSubmitted &&
                 showContacts &&
-                currentGroups.length === 0 &&
-                !searchingFiles
+                contactResultCount === 0 &&
+                !searchingFiles &&
+                !searchingPeople
             "
             title="No Contacts Found"
             description="Try using different keywords."
           />
           <div
-            v-if="currentGroups.length > 0 && showContacts"
+            v-if="contactResultCount > 0 && showContacts"
             class="asd20-site-search__suggested"
           >
             <h3>
               {{
-                currentGroups.length > 1
+                contactResultCount > 1
                   ? 'Suggested Contacts:'
                   : 'Suggested Contact:'
               }}
             </h3>
             <asd20-list-item
-              v-for="item in groupListItems"
-              :key="item.group.id"
-              :text-avatar="item.textAvatar"
-              :label="item.label"
-              :logo-url="item.logoUrl"
-              :source-title="item.sourceTitle"
-              :attribution="!!item.logoUrl"
-              actionable
-              @click="selectedGroup = item.group"
+              v-for="item in contactListItems"
+              v-bind="item"
+              :key="item.key"
+              @click="onContactClick(item)"
             />
           </div>
           <asd20-loader
-            v-if="searchingFiles && currentGroups.length === 0"
+            v-if="
+              (searchingFiles || searchingPeople) && contactResultCount === 0
+            "
             size="lg"
           />
         </asd20-viewport>
@@ -467,6 +465,12 @@
       </asd20-viewport>
     </asd20-modal>
 
+    <asd20-person-modal
+      :person="selectedPerson"
+      :open="!!selectedPerson"
+      @dismiss="selectedPerson = null"
+    />
+
     <asd20-modal
       :open="improvementFeedbackModalOpen"
       title="Report Missing or Incorrect Information"
@@ -539,6 +543,7 @@ import Asd20Notification from '../../molecules/Asd20Notification'
 import Asd20Loader from '../../molecules/Asd20Loader'
 import Asd20Modal from '../../molecules/Asd20Modal'
 import Asd20DepartmentContactCard from '../../molecules/Asd20DepartmentContactCard'
+import Asd20PersonModal from '../../organisms/Asd20PersonModal'
 import Asd20Button from '../../atoms/Asd20Button'
 import Asd20Icon from '../../atoms/Asd20Icon'
 import Asd20Spinner from '../../atoms/Asd20Spinner'
@@ -548,9 +553,11 @@ import Asd20Spinner from '../../atoms/Asd20Spinner'
 import debounce from 'lodash/debounce'
 import mapPagesToListItems from '../../../helpers/mapPagesToListItems'
 import mapFilesToListItems from '../../../helpers/mapFilesToListItems'
+import mapPeopleToListItems from '../../../helpers/mapPeopleToListItems'
 import logSearchAnalytics from '../../../helpers/logSearchAnalytics'
 import logSearchFeedback from '../../../helpers/logSearchFeedback'
 import queryAiSite from '../../../helpers/queryAiSite'
+import queryPeople from '../../../helpers/queryPeople'
 import { NO_PAGE_RESULTS_FALLBACKS } from '../../../helpers/queryPages'
 
 // Mixins
@@ -604,6 +611,7 @@ export default {
     Asd20Loader,
     Asd20Modal,
     Asd20DepartmentContactCard,
+    Asd20PersonModal,
     Asd20Button,
     Asd20Icon,
     Asd20Spinner,
@@ -625,6 +633,11 @@ export default {
       { type: Array, default: () => [] },
       'search'
     ),
+    globalPropMixinFactory(
+      'people',
+      { type: Array, default: () => [] },
+      'search'
+    ),
     globalPropMixinFactory(
       'includeDistrictResults',
       { type: Boolean, default: true },
@@ -642,6 +655,7 @@ export default {
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     organization: {
       type: Object,
@@ -666,12 +680,15 @@ export default {
     aiTranscript: [],
 
     selectedGroup: null,
+    selectedPerson: null,
     searchingPages: false,
     searchingFiles: false,
+    searchingPeople: false,
 
     localSearchPages: null,
     localSearchFiles: null,
     localSearchGroups: null,
+    localSearchPeople: null,
 
     keywordsFromAi: false,
     aiKeywordsDisplayAnswer: '',
@@ -683,7 +700,6 @@ export default {
     searchMode: '',
     routeRestoreInProgress: false,
     lastRestoredSearchKey: '',
-    skipNextRouteRestore: false,
     suppressAutoRestore: false,
     lastManualTabChangeAt: 0,
     lastManualTabLabel: '',
@@ -724,6 +740,15 @@ export default {
       return Array.isArray(this.resolvedGroups) ? this.resolvedGroups : []
     },
 
+    currentPeople() {
+      if (Array.isArray(this.localSearchPeople)) return this.localSearchPeople
+      return Array.isArray(this.resolvedPeople) ? this.resolvedPeople : []
+    },
+
+    contactResultCount() {
+      return this.currentGroups.length + this.currentPeople.length
+    },
+
     shouldUsePageFallbacks() {
       const hasSearchText =
         typeof this.keywords === 'string' && this.keywords.trim()
@@ -829,7 +854,7 @@ export default {
         if (this.showContacts) {
           assistantTabs.push({
             label: 'Contacts',
-            badge: this.currentGroups.length,
+            badge: this.contactResultCount,
             active: this.currentTab === 'Contacts',
           })
         }
@@ -852,7 +877,7 @@ export default {
         if (this.showContacts) {
           keywordTabs.push({
             label: 'Contacts',
-            badge: this.currentGroups.length,
+            badge: this.contactResultCount,
             active: this.currentTab === 'Contacts',
           })
         }
@@ -955,6 +980,8 @@ export default {
           ((g.shortName || g.title || '').match(/\b([A-Z])/g) || []).join('')
 
         return {
+          key: `group-${g.id || g.title}`,
+          contactType: 'group',
           group: g,
           label: `${g.title}`,
           textAvatar,
@@ -963,6 +990,17 @@ export default {
         }
       })
     },
+    peopleListItems() {
+      return (mapPeopleToListItems(this.currentPeople) || []).map(item => ({
+        ...item,
+        key: `person-${item.id || item.email || item.label}`,
+        contactType: 'person',
+      }))
+    },
+
+    contactListItems() {
+      return [...this.peopleListItems, ...this.groupListItems]
+    },
     feedbackFormUrlRaw() {
       if (this.aiSearchFeedbackFormUrl) return this.aiSearchFeedbackFormUrl
       const runtimeConfig = this.resolveRuntimeConfig()
@@ -1077,9 +1115,9 @@ export default {
           this.focusQuery()
           this.refreshResultsScrollLayer()
         })
-        this.restoreSearchStateFromRoute()
+        this.restoreSearchState()
       } else {
-        this.clearSearchStateFromRouteQuery()
+        this.clearLegacySearchRouteQuery()
         if (!this.inline) this.unlockBodyScroll()
         this.blurQuery()
       }
@@ -1090,7 +1128,7 @@ export default {
       if (newVal === 'Answers') {
         this.$nextTick(() => this.refreshResultsScrollLayer())
       }
-      this.syncSearchStateToRoute({ tab: newVal })
+      this.syncSearchState({ tab: newVal })
     },
 
     aiAnswer() {
@@ -1115,7 +1153,7 @@ export default {
         this.selectedGroup = null
         this.searchPages({ runId })
         this.searchFilesWithGroupOwners({ runId })
-        this.syncSearchStateToRoute()
+        this.syncSearchState()
       }
     }, 400),
 
@@ -1124,7 +1162,7 @@ export default {
       const runId = this.beginSearchRun()
       this.searchPages({ runId })
       this.searchFilesWithGroupOwners({ runId })
-      this.syncSearchStateToRoute()
+      this.syncSearchState()
     },
     // Clear AI answer if user clears the input
 
@@ -1137,34 +1175,20 @@ export default {
         this.aiKeywordsDisplayPages = ''
       }
     },
-
-    '$route.query': {
-      handler() {
-        if (this.suppressAutoRestore) return
-        if (this.searchingAi) return
-        if (this.hasRecentManualTabSelection()) return
-        if (this.skipNextRouteRestore) {
-          this.skipNextRouteRestore = false
-          return
-        }
-        if (!this.getRouteSearchState(this.$route.query)) {
-          this.lastRestoredSearchKey = ''
-        }
-        if (this.active) this.restoreSearchStateFromRoute()
-      },
-    },
   },
 
   mounted() {
     if (this.active && !this.inline) {
       this.lockBodyScroll()
     }
-    if (this.didPageReload()) {
+    const didReload = this.didPageReload()
+    if (didReload) {
       this.persistSearchState(null)
       this.lastRestoredSearchKey = ''
-      this.clearSearchStateFromRouteQuery()
-    } else if (this.active) {
-      this.restoreSearchStateFromRoute()
+    }
+    this.clearLegacySearchRouteQuery()
+    if (!didReload && this.active) {
+      this.restoreSearchState()
     }
     if (typeof window !== 'undefined') {
       window.addEventListener('resize', this.onWindowReflow, { passive: true })
@@ -1231,7 +1255,7 @@ export default {
         : 'en'
     },
 
-    setSearchResults({ pages, files, groups } = {}) {
+    setSearchResults({ pages, files, groups, people } = {}) {
       if (pages !== undefined) {
         this.localSearchPages = Array.isArray(pages) ? pages : []
       }
@@ -1241,12 +1265,16 @@ export default {
       if (groups !== undefined) {
         this.localSearchGroups = Array.isArray(groups) ? groups : []
       }
+      if (people !== undefined) {
+        this.localSearchPeople = Array.isArray(people) ? people : []
+      }
     },
 
     readSearchResults(target) {
       if (target === 'pages') return this.currentPages
       if (target === 'files') return this.currentFiles
       if (target === 'groups') return this.currentGroups
+      if (target === 'people') return this.currentPeople
       return []
     },
 
@@ -1260,6 +1288,9 @@ export default {
       if (target === 'groups') {
         return Array.isArray(this.resolvedGroups) ? this.resolvedGroups : []
       }
+      if (target === 'people') {
+        return Array.isArray(this.resolvedPeople) ? this.resolvedPeople : []
+      }
       return []
     },
 
@@ -1323,9 +1354,24 @@ export default {
       }
     },
 
-    normalizeRouteQueryValue(value) {
-      if (Array.isArray(value)) return value[0]
-      return value
+    async queryPeopleWithFallback(payload) {
+      if (typeof this.queryPeopleHandler === 'function') {
+        const result = await this.queryPeopleHandler(payload)
+        if (Array.isArray(result)) return result
+        return result && Array.isArray(result.people) ? result.people : []
+      }
+
+      const searchStore = this.getSearchStore()
+      if (searchStore) {
+        await searchStore.dispatch('search/queryPeople', payload)
+        return Array.isArray(this.resolvedPeople) ? this.resolvedPeople : []
+      }
+
+      const { people } = await queryPeople({
+        ...payload,
+        runtimeConfig: this.resolveRuntimeConfig(),
+      })
+      return Array.isArray(people) ? people : []
     },
 
     isLocalDevelopmentHost(hostname = '') {
@@ -1406,7 +1452,7 @@ export default {
       if (this.searchingAi) return
       if (this.hasRecentManualTabSelection()) return
       if (!this.active || this.routeRestoreInProgress) return
-      this.restoreSearchStateFromRoute()
+      this.restoreSearchState()
     },
 
     hasRecentManualTabSelection() {
@@ -1546,6 +1592,7 @@ export default {
         pages: Array.isArray(this.currentPages) ? this.currentPages : [],
         files: Array.isArray(this.currentFiles) ? this.currentFiles : [],
         groups: Array.isArray(this.currentGroups) ? this.currentGroups : [],
+        people: Array.isArray(this.currentPeople) ? this.currentPeople : [],
         aiAnswer: this.aiAnswer || null,
         aiSources: Array.isArray(this.aiSources) ? this.aiSources : [],
         aiErrorMessage: this.aiErrorMessage || '',
@@ -1560,7 +1607,7 @@ export default {
     },
 
     persistSearchCacheSnapshot(overrides = {}) {
-      const state = this.getCurrentSearchStateForRoute(overrides)
+      const state = this.getCurrentSearchState(overrides)
       if (!state) return
       this.persistSearchState(state, {
         cache: this.buildSearchCacheSnapshot(),
@@ -1656,7 +1703,8 @@ export default {
       const pages = Array.isArray(snapshot.pages) ? snapshot.pages : []
       const files = Array.isArray(snapshot.files) ? snapshot.files : []
       const groups = Array.isArray(snapshot.groups) ? snapshot.groups : []
-      this.setSearchResults({ pages, files, groups })
+      const people = Array.isArray(snapshot.people) ? snapshot.people : []
+      this.setSearchResults({ pages, files, groups, people })
 
       if (!skipTabUpdate) {
         const preferredTab = SEARCH_ROUTE_TABS.has(targetState.tab)
@@ -1673,33 +1721,7 @@ export default {
       return true
     },
 
-    getRouteSearchState(routeQuery = {}) {
-      const rawText = this.normalizeRouteQueryValue(
-        routeQuery[SEARCH_ROUTE_QUERY_KEYS.text]
-      )
-      const rawIncludeDistrictResults = this.normalizeRouteQueryValue(
-        routeQuery[SEARCH_ROUTE_QUERY_KEYS.includeDistrictResults]
-      )
-      const rawMode = this.normalizeRouteQueryValue(
-        routeQuery[SEARCH_ROUTE_QUERY_KEYS.mode]
-      )
-      const rawTab = this.normalizeRouteQueryValue(
-        routeQuery[SEARCH_ROUTE_QUERY_KEYS.tab]
-      )
-      const rawUpdatedAt = this.normalizeRouteQueryValue(
-        routeQuery[SEARCH_ROUTE_QUERY_KEYS.updatedAt]
-      )
-
-      return this.normalizeSearchState({
-        text: rawText,
-        mode: rawMode,
-        tab: rawTab,
-        includeDistrictResults: rawIncludeDistrictResults,
-        updatedAt: rawUpdatedAt,
-      })
-    },
-
-    getCurrentSearchStateForRoute(overrides = {}) {
+    getCurrentSearchState(overrides = {}) {
       const hasSubmitted =
         typeof overrides.hasSubmitted === 'boolean'
           ? overrides.hasSubmitted
@@ -1746,35 +1768,17 @@ export default {
       }
     },
 
-    buildRouteSearchQueryValues(state) {
-      if (!state) return {}
-      const values = {
-        [SEARCH_ROUTE_QUERY_KEYS.text]: state.text,
-        [SEARCH_ROUTE_QUERY_KEYS.mode]: state.mode,
-        [SEARCH_ROUTE_QUERY_KEYS.tab]: state.tab,
-        [SEARCH_ROUTE_QUERY_KEYS.includeDistrictResults]:
-          state.includeDistrictResults ? '1' : '0',
-      }
-      const updatedAt = Number(state.updatedAt)
-      if (Number.isFinite(updatedAt) && updatedAt > 0) {
-        values[SEARCH_ROUTE_QUERY_KEYS.updatedAt] = String(
-          Math.round(updatedAt)
-        )
-      }
-      return values
-    },
-
-    buildQueryWithSearchState(state) {
+    buildQueryWithoutSearchState() {
       const nextQuery = { ...((this.$route && this.$route.query) || {}) }
       Object.keys(SEARCH_ROUTE_QUERY_KEYS).forEach(key => {
         delete nextQuery[SEARCH_ROUTE_QUERY_KEYS[key]]
       })
-      return { ...nextQuery, ...this.buildRouteSearchQueryValues(state) }
+      return nextQuery
     },
 
-    async clearSearchStateFromRouteQuery() {
+    async clearLegacySearchRouteQuery() {
       if (!this.$router || !this.$route) return
-      const nextQuery = this.buildQueryWithSearchState(null)
+      const nextQuery = this.buildQueryWithoutSearchState()
       await this.replaceRouteQuery(nextQuery)
     },
 
@@ -1800,25 +1804,20 @@ export default {
     async replaceRouteQuery(query) {
       if (!this.$router || !this.$route) return
       if (this.isSameQuery(this.$route.query, query)) return
-      this.skipNextRouteRestore = true
       try {
         await this.$router.replace({ path: this.$route.path, query })
       } catch (error) {
-        this.skipNextRouteRestore = false
         // Ignore duplicate navigation and transient route replacement races.
       }
     },
 
-    async syncSearchStateToRoute(overrides = {}) {
+    syncSearchState(overrides = {}) {
       if (this.routeRestoreInProgress) return
-      if (!this.$router || !this.$route) return
-      const state = this.getCurrentSearchStateForRoute(overrides)
+      const state = this.getCurrentSearchState(overrides)
       this.lastRestoredSearchKey = state
-        ? `route:${JSON.stringify(state)}`
+        ? `storage:${JSON.stringify(state)}`
         : ''
       this.persistSearchState(state, { preserveCache: true })
-      const nextQuery = this.buildQueryWithSearchState(state)
-      await this.replaceRouteQuery(nextQuery)
     },
 
     appendSearchContextToUrl(rawUrl) {
@@ -1826,14 +1825,11 @@ export default {
       return rawUrl
     },
 
-    async restoreSearchStateFromRoute() {
+    async restoreSearchState() {
       if (this.suppressAutoRestore) return
       if (this.searchingAi) return
-      if (!this.$route || this.routeRestoreInProgress) return
+      if (this.routeRestoreInProgress) return
       const restoreStartedAt = Date.now()
-      const routeStateCandidate = this.getRouteSearchState(this.$route.query)
-      const routeStateFresh = this.isSearchStateFresh(routeStateCandidate)
-      const routeState = routeStateFresh ? routeStateCandidate : null
       const persistedRecordCandidate = this.readPersistedSearchRecord()
       const persistedRecordFresh =
         persistedRecordCandidate &&
@@ -1845,24 +1841,16 @@ export default {
       if (persistedRecordCandidate && !persistedRecordFresh) {
         this.persistSearchState(null)
       }
-      if (routeStateCandidate && !routeStateFresh) {
-        await this.clearSearchStateFromRouteQuery()
-      }
 
-      const persistedState = routeState
-        ? null
-        : persistedRecord && persistedRecord.state
-        ? persistedRecord.state
-        : null
-      const restoredState = routeState || persistedState
+      const restoredState =
+        persistedRecord && persistedRecord.state ? persistedRecord.state : null
       if (!restoredState) return
 
-      const restoreSource = routeState ? 'route' : 'storage'
       const cacheVersion = this.getSearchCacheVersion(
         persistedRecord,
         restoredState
       )
-      const restoreKey = `${restoreSource}:${JSON.stringify(
+      const restoreKey = `storage:${JSON.stringify(
         restoredState
       )}:${cacheVersion}`
       if (restoreKey === this.lastRestoredSearchKey) return
@@ -2253,10 +2241,43 @@ export default {
 
     dismiss() {
       if (!this.active) return
-      this.clearSearchStateFromRouteQuery()
+      this.clearLegacySearchRouteQuery()
       this.$emit('update:active', false)
     },
 
+    onContactClick(item) {
+      if (!item) return
+      if (item.contactType === 'person') {
+        this.selectedPerson = this.normalizePersonForModal(item.person || item)
+        return
+      }
+      if (item.group) {
+        this.selectedGroup = item.group
+      }
+    },
+
+    normalizePersonForModal(person = {}) {
+      const jobTitles = Array.isArray(person.jobTitles)
+        ? person.jobTitles
+        : person.jobTitles
+        ? [person.jobTitles]
+        : person.jobTypes
+        ? Array.isArray(person.jobTypes)
+          ? person.jobTypes
+          : [person.jobTypes]
+        : []
+
+      return {
+        ...person,
+        id: person.id || person.employeeId || person.profileId || person.userId,
+        displayName: person.displayName || person.name || '',
+        jobTitles,
+        workPhone: person.workPhone || person.phone || '',
+        thumbnailUrl:
+          person.thumbnailUrl || person.thumbnail || person.photoUrl || '',
+      }
+    },
+
     resolveRuntimeConfig() {
       const runtimeConfig =
         this.$config ||
@@ -2421,9 +2442,11 @@ export default {
         this.beginSearchRun()
       }
       this.selectedGroup = null
+      this.selectedPerson = null
       this.searchingAi = preserveAiLoading ? this.searchingAi : false
       this.searchingPages = false
       this.searchingFiles = false
+      this.searchingPeople = false
       this.activeAiQuestionKey = preserveAiLoading
         ? this.activeAiQuestionKey
         : ''
@@ -2446,7 +2469,7 @@ export default {
         this.aiTranscript = []
         this.anchoredUserTurnId = null
       }
-      this.setSearchResults({ pages: [], files: [], groups: [] })
+      this.setSearchResults({ pages: [], files: [], groups: [], people: [] })
     },
 
     async clearInput() {
@@ -2460,7 +2483,7 @@ export default {
       await this.clearSearchState()
       this.currentTab = 'Answers'
       this.persistSearchState(null)
-      await this.syncSearchStateToRoute({ hasSubmitted: false, text: '' })
+      this.syncSearchState({ hasSubmitted: false, text: '' })
       this.lastRestoredSearchKey = ''
 
       this.$nextTick(() => {
@@ -2551,8 +2574,11 @@ export default {
     async searchFilesWithGroupOwners(options = {}) {
       const runId = options.runId || this.searchRunId
       const groupsPromise = this.searchGroups({ runId })
+      const peoplePromise = this.searchPeople({ runId })
       await this.searchFiles({ runId })
       if (!this.isCurrentSearchRun(runId)) return []
+      await peoplePromise
+      if (!this.isCurrentSearchRun(runId)) return []
       const ownerFilters = await groupsPromise
       if (!this.isCurrentSearchRun(runId)) return ownerFilters
       if (ownerFilters.length > 0) {
@@ -2593,6 +2619,32 @@ export default {
       )
     },
 
+    async searchPeople(options = {}) {
+      const runId = options.runId || this.searchRunId
+      const searchInput = {
+        keywords: this.keywords,
+        question: this.searchQuestion || this.inputText,
+      }
+
+      this.searchingPeople = true
+      try {
+        let people = []
+        try {
+          people = await this.queryPeopleWithFallback(searchInput)
+        } catch (error) {
+          people = []
+        }
+        if (!this.isCurrentSearchRun(runId)) return this.currentPeople
+        this.setSearchResults({ people })
+        this.persistSearchCacheSnapshot()
+        return this.currentPeople
+      } finally {
+        if (this.isCurrentSearchRun(runId)) {
+          this.searchingPeople = false
+        }
+      }
+    },
+
     async onSubmitInput() {
       if (this.searchingAi) return
       const text = (this.inputText || '').trim()
@@ -2602,7 +2654,7 @@ export default {
         this.searchMode = ''
         await this.clearSearchState()
         this.persistSearchState(null)
-        await this.syncSearchStateToRoute({ hasSubmitted: false, text: '' })
+        this.syncSearchState({ hasSubmitted: false, text: '' })
         this.lastRestoredSearchKey = ''
         this.$nextTick(() => {
           this.suppressAutoRestore = false
@@ -2617,7 +2669,7 @@ export default {
       this.searchMode = mode
 
       if (mode === 'question') {
-        this.syncSearchStateToRoute({ text, mode, tab: 'Answers' })
+        this.syncSearchState({ text, mode, tab: 'Answers' })
         this.searchAi(text)
       } else {
         await this.clearSearchState()
@@ -2629,7 +2681,7 @@ export default {
         this.searchFilesWithGroupOwners({ runId })
         if (!this.isCurrentSearchRun(runId)) return
         this.currentTab = 'Pages'
-        this.syncSearchStateToRoute({ text, mode, tab: 'Pages' })
+        this.syncSearchState({ text, mode, tab: 'Pages' })
         this.$nextTick(() => this.refreshResultsScrollLayer())
 
         // Log keyword-only search analytics

package/src/components/templates/Asd20DistrictVideoTemplate/index.vue

@@ -13,11 +13,13 @@
       :pages="searchPages"
       :files="searchFiles"
       :groups="searchGroups"
+      :people="searchPeople"
       :include-district-results="includeDistrictResults"
       :search-language-code="searchLanguageCode"
       :query-pages-handler="queryPagesHandler"
       :query-files-handler="queryFilesHandler"
       :query-groups-handler="queryGroupsHandler"
+      :query-people-handler="queryPeopleHandler"
       :query-ai-site-handler="queryAiSiteHandler"
       :organization="organization"
       :organization-options="organizationOptions"
@@ -65,11 +67,13 @@
                 :pages="searchPages"
                 :files="searchFiles"
                 :groups="searchGroups"
+                :people="searchPeople"
                 :include-district-results="includeDistrictResults"
                 :search-language-code="searchLanguageCode"
                 :query-pages-handler="queryPagesHandler"
                 :query-files-handler="queryFilesHandler"
                 :query-groups-handler="queryGroupsHandler"
+                :query-people-handler="queryPeopleHandler"
                 :query-ai-site-handler="queryAiSiteHandler"
                 :organization="organization"
                 :organization-options="organizationOptions"
@@ -221,11 +225,13 @@ export default {
     searchPages: { type: Array, default: () => [] },
     searchFiles: { type: Array, default: () => [] },
     searchGroups: { type: Array, default: () => [] },
+    searchPeople: { type: Array, default: () => [] },
     includeDistrictResults: { type: Boolean, default: true },
     searchLanguageCode: { type: String, default: null },
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     aiSearchFeedbackFormUrl: { type: String, default: '' },
   },

package/src/components/templates/Asd20SchoolHomeTemplate/index.vue

@@ -13,11 +13,13 @@
       :pages="searchPages"
       :files="searchFiles"
       :groups="searchGroups"
+      :people="searchPeople"
       :include-district-results="includeDistrictResults"
       :search-language-code="searchLanguageCode"
       :query-pages-handler="queryPagesHandler"
       :query-files-handler="queryFilesHandler"
       :query-groups-handler="queryGroupsHandler"
+      :query-people-handler="queryPeopleHandler"
       :query-ai-site-handler="queryAiSiteHandler"
       :organization-options="organizationOptions"
       :organization="organization"
@@ -109,11 +111,13 @@
                 :pages="searchPages"
                 :files="searchFiles"
                 :groups="searchGroups"
+                :people="searchPeople"
                 :include-district-results="includeDistrictResults"
                 :search-language-code="searchLanguageCode"
                 :query-pages-handler="queryPagesHandler"
                 :query-files-handler="queryFilesHandler"
                 :query-groups-handler="queryGroupsHandler"
+                :query-people-handler="queryPeopleHandler"
                 :query-ai-site-handler="queryAiSiteHandler"
                 :organization="organization"
                 :organization-options="organizationOptions"
@@ -234,11 +238,13 @@ export default {
     searchPages: { type: Array, default: () => [] },
     searchFiles: { type: Array, default: () => [] },
     searchGroups: { type: Array, default: () => [] },
+    searchPeople: { type: Array, default: () => [] },
     includeDistrictResults: { type: Boolean, default: true },
     searchLanguageCode: { type: String, default: null },
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     aiSearchFeedbackFormUrl: { type: String, default: '' },
   },

package/src/components/templates/Asd20SchoolHomeVideoTemplate/index.vue

@@ -13,11 +13,13 @@
       :pages="searchPages"
       :files="searchFiles"
       :groups="searchGroups"
+      :people="searchPeople"
       :include-district-results="includeDistrictResults"
       :search-language-code="searchLanguageCode"
       :query-pages-handler="queryPagesHandler"
       :query-files-handler="queryFilesHandler"
       :query-groups-handler="queryGroupsHandler"
+      :query-people-handler="queryPeopleHandler"
       :query-ai-site-handler="queryAiSiteHandler"
       :organization="organization"
       :organization-options="organizationOptions"
@@ -110,11 +112,13 @@
                 :pages="searchPages"
                 :files="searchFiles"
                 :groups="searchGroups"
+                :people="searchPeople"
                 :include-district-results="includeDistrictResults"
                 :search-language-code="searchLanguageCode"
                 :query-pages-handler="queryPagesHandler"
                 :query-files-handler="queryFilesHandler"
                 :query-groups-handler="queryGroupsHandler"
+                :query-people-handler="queryPeopleHandler"
                 :query-ai-site-handler="queryAiSiteHandler"
                 :organization="organization"
                 :organization-options="organizationOptions"
@@ -239,11 +243,13 @@ export default {
     searchPages: { type: Array, default: () => [] },
     searchFiles: { type: Array, default: () => [] },
     searchGroups: { type: Array, default: () => [] },
+    searchPeople: { type: Array, default: () => [] },
     includeDistrictResults: { type: Boolean, default: true },
     searchLanguageCode: { type: String, default: null },
     queryPagesHandler: { type: Function, default: null },
     queryFilesHandler: { type: Function, default: null },
     queryGroupsHandler: { type: Function, default: null },
+    queryPeopleHandler: { type: Function, default: null },
     queryAiSiteHandler: { type: Function, default: null },
     aiSearchFeedbackFormUrl: { type: String, default: '' },
   },

package/src/helpers/queryPeople.js

@@ -0,0 +1,122 @@
+import axios from 'axios'
+
+import { hasSearchProxyRuntime, resolveSearchProxyUrl } from './searchProxyUrl'
+import { normalizeBaseUrl, resolveRuntimeConfigValue } from './runtimeConfig'
+
+function searchPayload({ keywords = '', top = 10 }) {
+  const trimmedKeywords = keywords.trim()
+  const terms = trimmedKeywords.split(/\s+/).filter(Boolean)
+  const expandedTerms = terms
+    .map(term => `displayName:${term}* OR email:${term}*`)
+    .join(' OR ')
+
+  return {
+    count: true,
+    queryType: 'full',
+    search: trimmedKeywords
+      ? `"${trimmedKeywords}"${expandedTerms ? ` OR ${expandedTerms}` : ''}`
+      : '*',
+    top,
+  }
+}
+
+export default async function queryPeople({
+  keywords = '',
+  top = 10,
+  limit = 0,
+  requireKeywords = true,
+  indexName = 'people-index',
+  requestUrl = '',
+  runtimeConfig = null,
+  searchKey = '',
+  apiVersion = '',
+  searchEndpoint = '',
+  endpoint = '',
+}) {
+  if (!keywords && requireKeywords) {
+    return {
+      people: [],
+      facets: [],
+    }
+  }
+
+  const resolvedLimit = Number.isFinite(Number(limit)) && Number(limit) > 0
+    ? Number(limit)
+    : top
+  const resolvedSearchKey = resolveRuntimeConfigValue({
+    explicitValue: searchKey,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchKey'],
+    envKeys: [
+      'AZURE_SEARCH_KEY',
+      'VUE_APP_AZURE_SEARCH_KEY',
+      'GRIDSOME_AZURE_SEARCH_KEY',
+    ],
+  })
+  const resolvedApiVersion = resolveRuntimeConfigValue({
+    explicitValue: apiVersion,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchVersion'],
+    envKeys: [
+      'AZURE_SEARCH_VERSION',
+      'VUE_APP_AZURE_SEARCH_API_VERSION',
+      'GRIDSOME_AZURE_SEARCH_API_VERSION',
+    ],
+  })
+  const resolvedSearchEndpoint = resolveRuntimeConfigValue({
+    explicitValue: searchEndpoint || endpoint,
+    runtimeConfig,
+    runtimeConfigKeys: ['azureSearchEndpoint'],
+    envKeys: [
+      'AZURE_SEARCH_ENDPOINT',
+      'VUE_APP_AZURE_SEARCH_ENDPOINT',
+      'GRIDSOME_AZURE_SEARCH_ENDPOINT',
+    ],
+  })
+  const resolvedRequestUrl =
+    typeof requestUrl === 'string' && requestUrl.trim()
+      ? requestUrl.trim()
+      : !resolvedSearchEndpoint &&
+        hasSearchProxyRuntime(runtimeConfig)
+      ? resolveSearchProxyUrl('people', runtimeConfig)
+      : ''
+
+  if (
+    !resolvedRequestUrl &&
+    (!resolvedSearchEndpoint || !resolvedSearchKey || !resolvedApiVersion)
+  ) {
+    throw new Error('Azure Search or proxy configuration is required for queryPeople.')
+  }
+
+  const payload = {
+    keywords,
+    limit: resolvedLimit,
+    indexName,
+  }
+
+  const { data } = resolvedRequestUrl
+    ? await axios({
+        method: 'post',
+        url: resolvedRequestUrl,
+        data: payload,
+      })
+    : await axios({
+        method: 'post',
+        headers: {
+          'api-key': resolvedSearchKey,
+        },
+        params: {
+          'api-version': resolvedApiVersion,
+        },
+        url: `${normalizeBaseUrl(resolvedSearchEndpoint)}/indexes/${indexName}/docs/search`,
+        data: searchPayload({
+          keywords,
+          top: resolvedLimit,
+        }),
+      })
+
+  return {
+    people: Array.isArray(data.value) ? data.value : [],
+    facets: data['@search.facets'],
+  }
+}

package/src/helpers/searchProxyUrl.js

@@ -5,6 +5,7 @@ const SEARCH_PROXY_PATHS = Object.freeze({
   pages: '/api/search/pages',
   files: '/api/search/files',
   events: '/api/search/events',
+  people: '/api/search/people',
 })
 
 export function resolveSearchProxyPath(kind) {