@asd20/ui-next 2.37.0 → 2.38.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+# [2.38.0](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.37.0...ui-next-v2.38.0) (2026-11-11)
+
+
+### Features
+
+* add organization email and omit missing public data ([8b1b8a7](https://github.com/academydistrict20/asd20-ui-next/commit/8b1b8a79a6b6ea04b8925cce517d022c839a1955))
+
 # [2.37.0](https://github.com/academydistrict20/asd20-ui-next/compare/ui-next-v2.36.0...ui-next-v2.37.0) (2026-11-10)
 
 

package/package.json

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

package/src/components/atoms/Asd20RichBodyContent/index.vue

@@ -6,7 +6,7 @@
     @click="onContentClick"
   >
     <p
-      v-if="liveDataError && !liveDataProvider"
+      v-if="showLiveDataDiagnostics && liveDataError && !liveDataProvider"
       role="status"
     >
       {{ liveDataError }} <button

package/src/components/atoms/Asd20RichBodyContent/messageDocumentRenderer.js

@@ -4,7 +4,7 @@ import {
   contextualAccordionItemKey,
   normalizeHeadingContext,
 } from './headingContext.js'
-import { validateLiveDataReference, liveDataLabel } from '../../../helpers/liveMessageData.js'
+import { validateLiveDataReference } from '../../../helpers/liveMessageData.js'
 
 const MESSAGE_DOCUMENT_SCHEMA_VERSION = 1
 
@@ -807,8 +807,7 @@ function renderImage(attrs, className = '') {
 
 function renderStandardNode(node, context, path, accordionItemId) {
   if (node.type === 'liveDataField' || node.type === 'liveDataBlock') {
-    const tag = node.type === 'liveDataField' ? 'span' : 'div'
-    return `<${tag} class="asd20-live-data-unavailable">${escapeHtml(liveDataLabel(node.attrs))} is currently unavailable.</${tag}>`
+    return ''
   }
   if (node.type === 'text') return renderMarkedText(node, context, path)
   if (node.type === 'hardBreak') return '<br>'

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

@@ -147,7 +147,7 @@
       >
         <slot name="sidebar-status" />
         <p
-          v-if="liveDataError && !liveDataManaged"
+          v-if="showLiveDataDiagnostics && liveDataError && !liveDataManaged"
           role="status"
         >
           {{ liveDataError }} <button

package/src/helpers/liveMessageData.js

@@ -3,21 +3,22 @@
 
 // Canonical public live-data contract. The shared UI's copy is generated by
 // scripts/sync-live-message-data.mjs; never add arbitrary paths or queries here.
-const LIVE_DATA_VERSION = 3;
+const LIVE_DATA_VERSION = 4;
 const ADMINISTRATION_TEAM_TAG = "asd20:handbook:administration";
 const LIVE_DATA_MEMBER_FIELDS = Object.freeze({ name: "Name", title: "Title", phone: "Phone" });
 const LIVE_DATA_FIELDS = Object.freeze({
   organization: Object.freeze({
-    title: "Organization name",
-    address: "Organization address",
-    phone: "Organization main phone",
-    hours: "Organization office hours",
-    administrators: "Organization administrators",
+    title: "Organization Name",
+    address: "Organization Address",
+    phone: "Organization Main Phone",
+    email: "Organization Email",
+    hours: "Organization Office Hours",
+    administrators: "Organization Administrators",
   }),
   team: Object.freeze({
-    contactPhone: "Team contact phone",
-    officeHours: "Team office hours",
-    staff: "Team staff list",
+    contactPhone: "Team Contact Phone",
+    officeHours: "Team Office Hours",
+    staff: "Team Staff List",
   }),
 });
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -55,7 +56,7 @@ function validateLiveDataReference(node) {
 
 function liveDataLabel(attrs) {
   const label = LIVE_DATA_FIELDS[attrs?.source]?.[attrs?.field] || "Live information";
-  return attrs?.binding === "currentSchool" ? `Current organization · ${label}` : label;
+  return attrs?.binding === "currentSchool" ? `Current Organization · ${label}` : label;
 }
 
 function liveDataKey(attrs) {
@@ -170,7 +171,7 @@ function liveDataContent(attrs, snapshot, organizationId) {
 
 // Materialization returns a copy containing only ordinary document nodes.
 // Persist the authored references, never this presentation projection.
-function resolveLiveDataDocument(bodyJson, snapshot, { strict = true, organizationId } = {}) {
+function resolveLiveDataDocument(bodyJson, snapshot, { strict = true, organizationId, unavailable = "message" } = {}) {
   collectLiveDataReferences(bodyJson);
   const value = typeof bodyJson === "string" ? JSON.parse(bodyJson || "null") : bodyJson;
   const diagnostics = [];
@@ -179,14 +180,22 @@ function resolveLiveDataDocument(bodyJson, snapshot, { strict = true, organizati
       const content = liveDataContent(node.attrs, snapshot, organizationId);
       if (content) return content;
       diagnostics.push({ code: "live-data-unavailable", reference: liveDataKey(node.attrs) });
+      if (unavailable === "omit") return [];
       const message = `${liveDataLabel(node.attrs)} is currently unavailable.`;
       return node.type === "liveDataBlock" ? [paragraph(message)] : [textNode(message)];
     }
     if (!node || typeof node !== "object") return [node];
+    const content = Array.isArray(node.content) ? node.content.flatMap(resolve) : undefined;
+    if (unavailable === "omit" && node.type === "heading" && content?.length === 0 &&
+        node.content.some(child => LIVE_DATA_NODE_TYPES.has(child.type))) return [];
     return [{ ...node, ...(node.attrs ? { attrs: { ...node.attrs } } : {}),
-      ...(Array.isArray(node.content) ? { content: node.content.flatMap(resolve) } : {}) }];
+      ...(content ? { content } : {}) }];
   }
   const document = resolve(value)[0];
+  // Keep an all-missing projection renderable without falling back to authored
+  // HTML. This placeholder is presentation-only and never saved to the message.
+  if (unavailable === "omit" && diagnostics.length && document?.type === "doc" && document.content?.length === 0)
+    document.content = [{ type: "paragraph" }];
   if (strict && diagnostics.length) throw new Error("Required live information is unavailable. Review the message data sources.");
   return { document, diagnostics };
 }
@@ -212,7 +221,7 @@ async function fetchLiveDataSnapshot(documents, { endpoint, fetchImpl = globalTh
     body: JSON.stringify({
       query: `query liveMessageData($organizationIds: [uuid!]!, $teamIds: [uuid!]!${currentTeam ? ", $contextOrganizationIds: [uuid!]!" : ""}) {
         organizations(where: {id: {_in: $organizationIds}, status: {_eq: "Published"}}) {
-          id status title address phone hours administrators
+          id status title address phone email hours administrators
         }
         teams: groups(where: {${currentTeam ? `_or: [{id: {_in: $teamIds}}, {ownerOrganizationId: {_in: $contextOrganizationIds}, tags: {_contains: ["${ADMINISTRATION_TEAM_TAG}"]}}]` : "id: {_in: $teamIds}"}, isPublic: {_eq: true}, ownerOrganization: {status: {_eq: "Published"}}}, limit: 101) {
           id title isPublic contactPhone officeHours ownerOrganizationId tags ownerOrganization { status }

package/src/helpers/liveMessageDataRuntime.js

@@ -9,6 +9,7 @@ export const liveMessageDataOrganizationKey = 'liveMessageDataOrganization'
 // descendants. Only references trigger a request; ordinary messages are inert.
 export const liveMessageDataMixin = {
   inject: {
+    showLiveDataDiagnostics: { from: 'liveMessageDataDiagnostics', default: false },
     liveDataEndpoint: { from: liveMessageDataEndpointKey, default: '' },
     liveDataProvider: { from: liveMessageDataProviderKey, default: null },
     liveDataOrganizationProvider: { from: liveMessageDataOrganizationKey, default: null },
@@ -46,9 +47,9 @@ export const liveMessageDataMixin = {
           signal: controller.signal,
           organizationId: this.liveDataContextOrganizationId,
         })
-        // Validate availability before accepting a partial capture.
+        // Validate references while retaining available fields in a partial capture.
         this.liveDataDocuments.forEach(doc => {
-          if (collectLiveDataReferences(doc).length) resolveLiveDataDocument(doc, snapshot, { organizationId: this.liveDataContextOrganizationId })
+          if (collectLiveDataReferences(doc).length) resolveLiveDataDocument(doc, snapshot, { strict: false, organizationId: this.liveDataContextOrganizationId })
         })
         if (epoch === this.liveDataEpoch) this.liveDataSnapshot = snapshot
       } catch { if (epoch === this.liveDataEpoch) this.liveDataError = 'Live information is currently unavailable.' }
@@ -57,7 +58,7 @@ export const liveMessageDataMixin = {
     projectLiveMessageData(bodyJson) {
       try {
         if (!collectLiveDataReferences(bodyJson).length) return bodyJson
-        return resolveLiveDataDocument(bodyJson, this.effectiveLiveDataSnapshot, { strict: false, organizationId: this.liveDataContextOrganizationId }).document
+        return resolveLiveDataDocument(bodyJson, this.effectiveLiveDataSnapshot, { strict: false, organizationId: this.liveDataContextOrganizationId, unavailable: this.showLiveDataDiagnostics ? 'message' : 'omit' }).document
       } catch { return bodyJson }
     },
   },