@asd20/ui-next 2.10.3 → 2.10.5

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [2.10.5](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.10.4...ui-next-v2.10.5) (2026-05-15)
+
+## [2.10.4](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.10.3...ui-next-v2.10.4) (2026-05-14)
+
+
+### Bug Fixes
+
+* fix semantic markup for search component ([d63ce71](https://github.com/academydistrict20/asd20-ui-next/commit/d63ce71b149db115813fda8ff14e905612c526ba))
+
 ## [2.10.3](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.10.2...ui-next-v2.10.3) (2026-05-13)
 
 

package/README.md

@@ -1,53 +1,145 @@
 # @asd20/ui-next
 
-Vue 3 component library for ASD20 shared UI surfaces.
+Shared Vue 3 UI package for Academy District 20 websites and web apps.
 
-The current published baseline is `@asd20/ui-next@2.0.0`. This release is Vue 3-only and ships the model-only shared input contract.
+Current local version: `2.10.4`
+
+This package is the active shared presentation layer for the ASD20 web platform.
+It provides reusable components, public website templates, app-shell templates,
+icons, design tokens, Sass helpers, assets, directives, and helper functions
+used by the Nuxt website, standalone apps, and selected CommCenter preview
+surfaces.
+
+## Platform Role
+
+This repo owns the packaged UI contract for:
+
+- public website templates consumed by `asd20-website`
+- app templates and components consumed by calendar, directory, school
+  directory, and file directory apps
+- selected CommCenter preview components and icon/template imports
+- global design tokens and Sass helpers shared across consumers
+- icon metadata and SVG component exports
+- helper functions for event/message/page/file/people mapping, search calls,
+  organization labels, link handling, cookies, email, and analytics feedback
+
+The package is published to npm as `@asd20/ui-next`. It should be treated as a
+multi-repo contract, not as an app-local component folder.
+
+## Runtime Contract
+
+- Node `>=20`
+- npm `>=10`
+- Vue peer dependency `^3.0.0`
+- Package build system: Vue CLI / webpack
+- Unit test runner: Vitest
+- Component development: Storybook
 
 ## Public Entry Points
 
+Supported import paths are defined in `package.json` and guarded by
+`scripts/public-api-contract.js`:
+
 - `@asd20/ui-next`
 - `@asd20/ui-next/components`
 - `@asd20/ui-next/templates`
+- `@asd20/ui-next/templates/*`
 - `@asd20/ui-next/icons`
 - `@asd20/ui-next/helpers`
 - `@asd20/ui-next/directives`
+- `@asd20/ui-next/install`
 - `@asd20/ui-next/styles.css`
 - `@asd20/ui-next/design/*`
 - `@asd20/ui-next/assets/*`
-
-## Development
-
-```bash
+- `@asd20/ui-next/package.json`
+
+Downstream repos should import through those paths. Private source imports are
+not part of the supported contract unless they are explicitly covered by the
+package `exports` map.
+
+## Source Layout
+
+| Path | Purpose |
+| --- | --- |
+| `components.js` | Public component exports. |
+| `templates.js` | Public template exports. |
+| `icons.js` | Generated icon component exports. |
+| `helpers.js` | Public helper exports. |
+| `directives.js` | Public directive exports. |
+| `install.js` | Vue plugin install helpers. |
+| `src/components/atoms/` | Base UI components. |
+| `src/components/molecules/` | Combined controls and display units. |
+| `src/components/organisms/` | Larger site/app sections. |
+| `src/components/templates/` | Website and app templates. |
+| `src/design/` | CSS tokens, Sass helpers, typography, template stack, images. |
+| `src/assets/icons/` | Raw SVG icon assets. |
+| `src/helpers/` | Shared helper implementation. |
+| `src/directives/` | Directive implementation. |
+| `scripts/` | Build, package, release, and verification scripts. |
+| `docs/migration/` | Historical migration and release notes. |
+
+## Local Development
+
+```sh
 npm install
 npm run storybook
+npm test
 npm run build
 ```
 
-## Release Validation
+Regenerate icon metadata after adding, removing, or renaming SVG icon assets:
 
-Build the staged publish artifact with:
+```sh
+npm run generate:icons
+npm run verify:icon-metadata
+```
+
+## Package Verification
+
+Build the staged publish artifact:
 
-```bash
+```sh
 npm run build:package
 ```
 
-Validate the publish shape end to end with:
+Verify the source and staged package contract:
 
-```bash
+```sh
 npm run verify:publish
 ```
 
-That flow rebuilds `dist/package`, verifies the root and staged export contract, checks the public API surface, and runs `npm pack --dry-run` against the staged package.
+That command rebuilds `dist/package`, verifies public exports, verifies Vue 3
+input/lifecycle/instance-id contracts, verifies the staged package, and runs
+`npm pack --dry-run`.
 
-Validate the packed consumer install path with:
+Verify the packed consumer install path:
 
-```bash
+```sh
 npm run verify:release
 ```
 
-That flow packs the staged package into a tarball, installs it into a temporary Vue 3 smoke app, and confirms the consumer build succeeds against the installed package shape.
+That command packs the staged package, installs it into a temporary Vue 3 smoke
+app, imports the public components/templates/icons/helpers/directives/styles,
+and confirms the consumer build succeeds.
+
+## Release
+
+```sh
+npm run release
+```
+
+The release flow publishes from `dist/package`, tags as `ui-next-v${version}`,
+and runs `npm run verify:release` before publishing.
+
+## Change Guidance
+
+Before changing this package, identify which public entry point is affected and
+which downstream repos consume it. Template, style/token, icon, input model, and
+helper changes are especially likely to require downstream website or app
+verification.
 
-## Migration Record
+For broader architecture context, see
+`../asd20-website/docs/platform/shared-ui-contract.md`.
 
-The package is now release-ready and published, but the migration record is still kept under `docs/migration/` for downstream audit history, release decisions, and future cleanup planning.
+The migration record under `docs/migration/` is retained for audit history,
+release decisions, and future cleanup planning.

package/package.json

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

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

@@ -32,8 +32,7 @@
                 !searchingAi
             "
             title="Ask a Question or Search by Keyword"
-            description="Asking a <b>question</b> will generate an AI answer with related pages and files. Or just search for pages and files by entering <b>keyword(s)</b>.
-              <hr/>AI can make mistakes. Verify important information."
+            :description="idleSearchDescription"
           />
           <div
             v-if="showSearchInputBeforeResults"
@@ -268,8 +267,7 @@
                 !searchingAi
             "
             title="Ask a Question or Search by Keyword"
-            description="Asking a <b>question</b> will generate an AI answer with related pages and files. Or just search for pages and files by entering <b>keyword(s)</b>.
-              <hr/>AI can make mistakes. Verify important information."
+            :description="idleSearchDescription"
           />
           <asd20-notification
             v-if="aiErrorMessage"
@@ -320,8 +318,7 @@
                 !searchingAi
             "
             title="Ask a Question or Search by Keyword"
-            description="Asking a <b>question</b> will generate an AI answer with related pages and files. Or just search for pages and files by entering <b>keyword(s)</b>.
-              <hr/>AI can make mistakes. Verify important information."
+            :description="idleSearchDescription"
           />
           <asd20-notification
             v-if="
@@ -377,8 +374,7 @@
                 !searchingAi
             "
             title="Ask a Question or Search by Keyword"
-            description="Asking a <b>question</b> will generate an AI answer with related pages and files. Or just search for pages and files by entering <b>keyword(s)</b>.
-              <hr/>AI can make mistakes. Verify important information."
+            :description="idleSearchDescription"
           />
           <asd20-notification
             v-if="keywords && currentFiles.length === 0 && !searchingFiles"
@@ -581,6 +577,11 @@ const SEARCH_NO_PAGE_RESULTS_FALLBACKS = NO_PAGE_RESULTS_FALLBACKS.map(
     ownerOrganizationId: DISTRICT_ORG_ID,
   })
 )
+const IDLE_SEARCH_DESCRIPTION = [
+  'Asking a <strong>question</strong> will generate an AI answer with related pages and files. ',
+  'Or just search for pages and files by entering <strong>keyword(s)</strong>.',
+  '<hr/>AI can make mistakes. Verify important information.',
+].join('')
 
 // const SUBDOMAIN_LABELS = {
 //   rampart: 'Rampart High School',
@@ -704,6 +705,10 @@ export default {
   }),
 
   computed: {
+    idleSearchDescription() {
+      return IDLE_SEARCH_DESCRIPTION
+    },
+
     currentPages() {
       if (Array.isArray(this.localSearchPages)) return this.localSearchPages
       return Array.isArray(this.resolvedPages) ? this.resolvedPages : []