@asd20/ui-next 2.11.1 → 2.12.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [2.12.1](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.12.0...ui-next-v2.12.1) (2026-05-26)
+
+
+### Bug Fixes
+
+* add group matches to people searches by keyword ([1edabb4](https://github.com/academydistrict20/asd20-ui-next/commit/1edabb458ead8430e04375cdb00071db345605f3))
+
+# [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)
 
 

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.1",
+  "version": "2.12.1",
   "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: '',
@@ -723,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()
@@ -828,7 +854,7 @@ export default {
         if (this.showContacts) {
           assistantTabs.push({
             label: 'Contacts',
-            badge: this.currentGroups.length,
+            badge: this.contactResultCount,
             active: this.currentTab === 'Contacts',
           })
         }
@@ -851,7 +877,7 @@ export default {
         if (this.showContacts) {
           keywordTabs.push({
             label: 'Contacts',
-            badge: this.currentGroups.length,
+            badge: this.contactResultCount,
             active: this.currentTab === 'Contacts',
           })
         }
@@ -954,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,
@@ -962,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()
@@ -1216,7 +1255,7 @@ export default {
         : 'en'
     },
 
-    setSearchResults({ pages, files, groups } = {}) {
+    setSearchResults({ pages, files, groups, people } = {}) {
       if (pages !== undefined) {
         this.localSearchPages = Array.isArray(pages) ? pages : []
       }
@@ -1226,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 []
     },
 
@@ -1245,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 []
     },
 
@@ -1308,6 +1354,83 @@ export default {
       }
     },
 
+    async queryPeopleWithFallback(payload) {
+      if (typeof this.queryPeopleHandler === 'function') {
+        const result = await this.queryPeopleHandler(payload)
+        if (Array.isArray(result)) {
+          return { people: result, groups: [] }
+        }
+        return {
+          people: result && Array.isArray(result.people) ? result.people : [],
+          groups: result && Array.isArray(result.groups) ? result.groups : [],
+        }
+      }
+
+      const searchStore = this.getSearchStore()
+      if (searchStore) {
+        const result = await searchStore.dispatch('search/queryPeople', payload)
+        return {
+          people:
+            result && Array.isArray(result.people)
+              ? result.people
+              : Array.isArray(this.resolvedPeople)
+              ? this.resolvedPeople
+              : [],
+          groups: result && Array.isArray(result.groups) ? result.groups : [],
+        }
+      }
+
+      const { people } = await queryPeople({
+        ...payload,
+        runtimeConfig: this.resolveRuntimeConfig(),
+      })
+      return {
+        people: Array.isArray(people) ? people : [],
+        groups: [],
+      }
+    },
+
+    getContactGroupKey(group = {}) {
+      return String(group.id || group.title || group.contactEmail || '').trim()
+    },
+
+    mergeContactGroups(primaryGroups = [], relatedGroups = []) {
+      const merged = []
+      const keyedIndexes = new Map()
+      const addGroup = group => {
+        if (!group || typeof group !== 'object') return
+        const key = this.getContactGroupKey(group)
+        if (!key) return
+
+        if (keyedIndexes.has(key)) {
+          const existingIndex = keyedIndexes.get(key)
+          const existing = merged[existingIndex]
+          if (
+            existing &&
+            existing.relatedPersonMatch &&
+            !group.relatedPersonMatch
+          ) {
+            merged[existingIndex] = group
+          }
+          return
+        }
+
+        keyedIndexes.set(key, merged.length)
+        merged.push(group)
+      }
+
+      primaryGroups.forEach(addGroup)
+      relatedGroups.forEach(addGroup)
+
+      return merged
+    },
+
+    getDirectContactGroups() {
+      return (this.currentGroups || []).filter(
+        group => !(group && group.relatedPersonMatch)
+      )
+    },
+
     isLocalDevelopmentHost(hostname = '') {
       if (!hostname || typeof hostname !== 'string') return false
       const lower = hostname.toLowerCase()
@@ -1526,6 +1649,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 || '',
@@ -1636,7 +1760,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)
@@ -2177,6 +2302,39 @@ export default {
       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 ||
@@ -2341,9 +2499,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
         : ''
@@ -2366,7 +2526,7 @@ export default {
         this.aiTranscript = []
         this.anchoredUserTurnId = null
       }
-      this.setSearchResults({ pages: [], files: [], groups: [] })
+      this.setSearchResults({ pages: [], files: [], groups: [], people: [] })
     },
 
     async clearInput() {
@@ -2471,8 +2631,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) {
@@ -2481,8 +2644,27 @@ export default {
       return ownerFilters
     },
 
+    selectBestKeywordTabAfterContactResults({ runId, text } = {}) {
+      if (!this.isCurrentSearchRun(runId)) return
+      if (this.searchMode !== 'keyword') return
+      if (this.currentTab !== 'Pages') return
+      if (this.currentPages.length > 0 || this.contactResultCount === 0)
+        return
+
+      this.currentTab = 'Contacts'
+      this.syncSearchState({
+        text: text || this.searchQuestion || this.inputText,
+        mode: 'keyword',
+        tab: 'Contacts',
+      })
+      this.$nextTick(() => this.refreshResultsScrollLayer())
+    },
+
     async searchGroups(options = {}) {
       const runId = options.runId || this.searchRunId
+      const existingRelatedGroups = (this.currentGroups || []).filter(
+        group => group && group.relatedPersonMatch
+      )
       const searchInput = {
         keywords: this.keywords,
         question: this.searchQuestion || this.inputText,
@@ -2497,22 +2679,70 @@ export default {
       if (!this.isCurrentSearchRun(runId)) {
         return Array.from(
           new Set(
-            this.currentGroups
+            this.getDirectContactGroups()
               .map(group => (group && group.title ? group.title.trim() : ''))
               .filter(Boolean)
           )
         )
       }
+      if (existingRelatedGroups.length > 0) {
+        this.setSearchResults({
+          groups: this.mergeContactGroups(
+            this.currentGroups,
+            existingRelatedGroups
+          ),
+        })
+      }
       this.persistSearchCacheSnapshot()
       return Array.from(
         new Set(
-          (this.currentGroups || [])
+          this.getDirectContactGroups()
             .map(group => (group && group.title ? group.title.trim() : ''))
             .filter(Boolean)
         )
       )
     },
 
+    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 = []
+        let relatedGroups = []
+        try {
+          const result = await this.queryPeopleWithFallback(searchInput)
+          people = Array.isArray(result)
+            ? result
+            : result && Array.isArray(result.people)
+            ? result.people
+            : []
+          relatedGroups =
+            result && Array.isArray(result.groups) ? result.groups : []
+        } catch (error) {
+          people = []
+          relatedGroups = []
+        }
+        if (!this.isCurrentSearchRun(runId)) return this.currentPeople
+        this.setSearchResults({ people })
+        if (relatedGroups.length > 0) {
+          this.setSearchResults({
+            groups: this.mergeContactGroups(this.currentGroups, relatedGroups),
+          })
+        }
+        this.persistSearchCacheSnapshot()
+        return this.currentPeople
+      } finally {
+        if (this.isCurrentSearchRun(runId)) {
+          this.searchingPeople = false
+        }
+      }
+    },
+
     async onSubmitInput() {
       if (this.searchingAi) return
       const text = (this.inputText || '').trim()
@@ -2547,6 +2777,10 @@ export default {
         this.keywords = this.limitWords(text, 4)
         await this.searchPages({ keepAnswersTab: false, runId })
         this.searchFilesWithGroupOwners({ runId })
+          .then(() =>
+            this.selectBestKeywordTabAfterContactResults({ runId, text })
+          )
+          .catch(() => {})
         if (!this.isCurrentSearchRun(runId)) return
         this.currentTab = 'Pages'
         this.syncSearchState({ text, mode, tab: 'Pages' })

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) {