@mj-biz-apps/common-ng 5.43.0 → 5.44.0

package/dist/lib/components/related-chips/related-links.d.ts

@@ -0,0 +1,151 @@
+import type { RecordNavigationEvent } from '@memberjunction/ng-base-forms';
+/**
+ * One relationship a record header offers to follow.
+ *
+ * Give it either a {@link RecordID} (the ordinary case — this record holds the id) or a
+ * {@link Filter} (the reverse case — the other record holds the id, as with an Order whose Deal
+ * points at it). A link with neither names nothing and is dropped.
+ */
+export interface BizAppsRelatedLink {
+    /** Stable identity, used to track the chip and to correlate it back to the caller's own model. */
+    Key: string;
+    /**
+     * Entity that owns the linked record, as a name — e.g. `'MJ_BizApps_Orders: Order Headers'`.
+     *
+     * An entity that is not in the catalog produces NO chip. That covers both "the app that owns
+     * this record is not installed here" and "this user may not read it", and the two are
+     * deliberately one outcome: the entity catalog is already permission-filtered, and a reader who
+     * cannot open the record is no better served by a chip than one whose host never had the app.
+     * `bizapps-sales`' `OrdersIsInstalled()` draws the same line for the same reason.
+     */
+    EntityName: string;
+    /** Forward link: the linked record's primary key value, as held on the record being displayed. */
+    RecordID?: string | null;
+    /**
+     * Reverse link: a filter that selects the linked record. The first row wins, so pass something
+     * that identifies one record. Composed by the caller, which is the only party that knows the
+     * other entity's column names.
+     */
+    Filter?: string;
+    /** Names the relationship outright. Wins over {@link LabelPrefix}. */
+    Label?: string;
+    /**
+     * Builds the label as `<prefix> <entity's singular name>` — "Source Deal", "Source Order".
+     *
+     * For a polymorphic link, where the caller knows the ROLE the other record plays but not which
+     * entity fills it until the id is resolved. Hardcoding "Deal" is what this avoids.
+     */
+    LabelPrefix?: string;
+    /** Font Awesome class for a small leading icon. Optional. */
+    Icon?: string;
+}
+/** The part of `EntityInfo` a link needs. `EntityInfo` satisfies this. */
+export interface RelatedLinkEntity {
+    Name: string;
+    BaseTableDisplayName: string;
+    NameField: {
+        Name: string;
+    } | null;
+    PrimaryKeys: {
+        Name: string;
+    }[];
+}
+/** The part of `RunViewResult` a link needs. `RunViewResult<Record<string, unknown>>` satisfies this. */
+export interface RelatedLinkReadResult {
+    Success: boolean;
+    Results?: Record<string, unknown>[];
+}
+/** Reads one row for a link. The component supplies a provider-scoped `RunView`. */
+export type RelatedLinkReader = (params: {
+    EntityName: string;
+    Fields: string[];
+    ExtraFilter: string;
+    MaxRows: number;
+}) => Promise<RelatedLinkReadResult>;
+/** A link that resolved to something openable. Anything that did not resolve is absent, not blank. */
+export interface ResolvedRelatedChip {
+    Key: string;
+    /** What the relationship is: "Source Deal", "Order". */
+    Label: string;
+    /** The linked record's name. Empty ONLY when the record exists but could not be read — see below. */
+    Name: string;
+    Icon: string | null;
+    EntityName: string;
+    PrimaryKeyField: string;
+    RecordID: string;
+    /** Accessible name for the chip's button, composed once here so the template stays declarative. */
+    AriaLabel: string;
+}
+/**
+ * The filter that selects the linked record, or `null` when the link names nothing to select.
+ *
+ * A `RecordID` is preferred over a `Filter` when both are given: the caller holding the id is the
+ * more direct statement of the same fact.
+ */
+export declare function FilterForRelatedLink(link: BizAppsRelatedLink, entity: RelatedLinkEntity): string | null;
+/** The entity's primary key column, defaulting to `ID` as every other link in these apps does. */
+export declare function PrimaryKeyFieldFor(entity: RelatedLinkEntity): string;
+/**
+ * The chip's label: what the caller called it, else `<prefix> <entity>`, else the entity's own name.
+ *
+ * `BaseTableDisplayName` rather than `DisplayName` because a chip labels ONE record and the entity
+ * name is plural — it is what turns a Deals link into "Source Deal" without guessing at plurals.
+ */
+export declare function LabelForRelatedLink(link: BizAppsRelatedLink, entity: RelatedLinkEntity): string;
+/**
+ * Resolve one link to a chip, or to `null` for "show nothing".
+ *
+ * ## The two rules this function exists to hold
+ *
+ * **A CHIP NEVER SHOWS A RAW ID.** The whole point of the row is that a reader recognises what they
+ * are about to open. So the name is read from the entity's own name field, and an entity with no
+ * name field produces no chip rather than a GUID wearing a label.
+ *
+ * **A CHIP THAT CANNOT NAVIGATE IS NOT RENDERED.** A link that goes nowhere is worse than an absent
+ * one: it invites a click and spends the reader's trust. Five ways a link produces nothing — the
+ * entity is not in the catalog, the entity has no name field, the link names neither a record nor a
+ * filter, the read succeeded while matching zero rows, and the read was refused.
+ *
+ * ## Why a read that THREW is treated differently from one that FAILED or found nothing
+ *
+ * Three different facts, and the line between them is whether the server answered.
+ *
+ * **Zero rows from a successful read** means the record is not there — `bizapps-contracts` hit
+ * exactly this with CTR-000026, whose hand-typed provenance pair names a row that does not exist,
+ * and whose header rendered an "Open" button that navigated nowhere. No chip.
+ *
+ * **`Success: false`** is the server answering and refusing. In MJ that is the channel for a
+ * permission denial as much as for a bad filter: `GraphQLDataProvider.InternalRunView` throws when
+ * the transport fails and returns `Success: false` with an `ErrorMessage` when the request reached
+ * the server and was turned down. A reader who may not read Orders would otherwise get an
+ * "Order · Open" chip that navigates to a record that will not open — the dead link this component
+ * exists to prevent. So a refusal produces NO chip.
+ *
+ * **A thrown read** means we do not know: the record may well exist and simply be unreachable this
+ * moment. So a throw keeps the chip when we already hold the id to open — labelled, with "Open"
+ * where the name would go — and drops it for a reverse link, where the throw also cost us the id.
+ */
+export declare function ResolveRelatedChip(link: BizAppsRelatedLink, entities: RelatedLinkEntity[], read: RelatedLinkReader): Promise<ResolvedRelatedChip | null>;
+/** The part of a `MouseEvent` that decides where a chip opens. `MouseEvent` satisfies this. */
+export interface RelatedChipClick {
+    ctrlKey: boolean;
+    metaKey: boolean;
+}
+/**
+ * The navigation event a chip click produces.
+ *
+ * Ctrl (Windows/Linux) and Cmd (macOS) both mean "new tab", which is the idiom MJ uses everywhere a
+ * record link is clicked.
+ *
+ * `OpenInNewTab` is OMITTED rather than set to `false` on a plain click, and that is the whole of
+ * what makes shift-click work. `NavigationService.shouldForceNewTab` returns `options.forceNewTab`
+ * whenever it is `!== undefined` and only otherwise consults its global shift-key state, and
+ * Explorer passes `forceNewTab: event.OpenInNewTab` straight through. An explicit `false` therefore
+ * does not mean "no opinion" — it means "same tab", and it suppresses the shift detection outright.
+ *
+ * `CompositeKey.FromKeyValuePair` rather than `FromID`: the latter assumes the target's primary key
+ * is literally called `ID`, which is true of these apps today and is not a thing a shared component
+ * gets to assume.
+ */
+export declare function RelatedChipNavigation(chip: ResolvedRelatedChip, event: RelatedChipClick): RecordNavigationEvent;
+//# sourceMappingURL=related-links.d.ts.map

package/dist/lib/components/related-chips/related-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-links.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/related-chips/related-links.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAC/B,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnC;AAED,yGAAyG;AACzG,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvC;AAED,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAErC,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAQ/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA4CrC;AAmCD,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAU/G"}

package/dist/lib/components/related-chips/related-links.js

@@ -0,0 +1,178 @@
+/**
+ * @fileoverview The resolve-and-hide rules behind `bizapps-related-chips`, kept out of the component.
+ *
+ * WHY THIS IS NOT IN THE COMPONENT. Everything here is a decision about whether a chip may be shown
+ * at all — "is the app installed", "does the record still exist", "did the read fail or did it
+ * succeed and find nothing" — and those are exactly the things that must be pinned by tests. A rule
+ * declared inside an Angular component cannot be exercised without standing up DI, which this
+ * package's node-environment vitest setup deliberately does not do. Same split as
+ * `bizapps-contracts`' `source-record-candidates.ts`.
+ *
+ * The dependencies below are narrowed to the shape each function actually reads rather than taking
+ * `IMetadataProvider` / `RunView`. `EntityInfo[]` and `RunViewResult` satisfy them structurally, so
+ * the component passes the real objects while a test passes a literal.
+ *
+ * @module @mj-biz-apps/common-ng
+ */
+import { CompositeKey } from '@memberjunction/core';
+/** Single-quote escaping for a value going into an `ExtraFilter`. */
+function quote(value) {
+    return value.replace(/'/g, "''");
+}
+/** `true` for a value that actually names a record — not null, not undefined, not blank. */
+function isPresent(value) {
+    return value !== null && value !== undefined && String(value).trim().length > 0;
+}
+/**
+ * The filter that selects the linked record, or `null` when the link names nothing to select.
+ *
+ * A `RecordID` is preferred over a `Filter` when both are given: the caller holding the id is the
+ * more direct statement of the same fact.
+ */
+export function FilterForRelatedLink(link, entity) {
+    if (isPresent(link.RecordID)) {
+        return `${PrimaryKeyFieldFor(entity)} = '${quote(String(link.RecordID).trim())}'`;
+    }
+    return isPresent(link.Filter) ? link.Filter.trim() : null;
+}
+/** The entity's primary key column, defaulting to `ID` as every other link in these apps does. */
+export function PrimaryKeyFieldFor(entity) {
+    return entity.PrimaryKeys?.[0]?.Name ?? 'ID';
+}
+/**
+ * The chip's label: what the caller called it, else `<prefix> <entity>`, else the entity's own name.
+ *
+ * `BaseTableDisplayName` rather than `DisplayName` because a chip labels ONE record and the entity
+ * name is plural — it is what turns a Deals link into "Source Deal" without guessing at plurals.
+ */
+export function LabelForRelatedLink(link, entity) {
+    if (isPresent(link.Label)) {
+        return link.Label.trim();
+    }
+    if (isPresent(link.LabelPrefix)) {
+        return `${link.LabelPrefix.trim()} ${entity.BaseTableDisplayName}`;
+    }
+    return entity.BaseTableDisplayName;
+}
+/**
+ * Resolve one link to a chip, or to `null` for "show nothing".
+ *
+ * ## The two rules this function exists to hold
+ *
+ * **A CHIP NEVER SHOWS A RAW ID.** The whole point of the row is that a reader recognises what they
+ * are about to open. So the name is read from the entity's own name field, and an entity with no
+ * name field produces no chip rather than a GUID wearing a label.
+ *
+ * **A CHIP THAT CANNOT NAVIGATE IS NOT RENDERED.** A link that goes nowhere is worse than an absent
+ * one: it invites a click and spends the reader's trust. Five ways a link produces nothing — the
+ * entity is not in the catalog, the entity has no name field, the link names neither a record nor a
+ * filter, the read succeeded while matching zero rows, and the read was refused.
+ *
+ * ## Why a read that THREW is treated differently from one that FAILED or found nothing
+ *
+ * Three different facts, and the line between them is whether the server answered.
+ *
+ * **Zero rows from a successful read** means the record is not there — `bizapps-contracts` hit
+ * exactly this with CTR-000026, whose hand-typed provenance pair names a row that does not exist,
+ * and whose header rendered an "Open" button that navigated nowhere. No chip.
+ *
+ * **`Success: false`** is the server answering and refusing. In MJ that is the channel for a
+ * permission denial as much as for a bad filter: `GraphQLDataProvider.InternalRunView` throws when
+ * the transport fails and returns `Success: false` with an `ErrorMessage` when the request reached
+ * the server and was turned down. A reader who may not read Orders would otherwise get an
+ * "Order · Open" chip that navigates to a record that will not open — the dead link this component
+ * exists to prevent. So a refusal produces NO chip.
+ *
+ * **A thrown read** means we do not know: the record may well exist and simply be unreachable this
+ * moment. So a throw keeps the chip when we already hold the id to open — labelled, with "Open"
+ * where the name would go — and drops it for a reverse link, where the throw also cost us the id.
+ */
+export async function ResolveRelatedChip(link, entities, read) {
+    const entity = entities?.find((e) => e.Name === link.EntityName) ?? null;
+    if (!entity) {
+        return null;
+    }
+    const nameField = entity.NameField?.Name;
+    if (!isPresent(nameField)) {
+        return null;
+    }
+    const filter = FilterForRelatedLink(link, entity);
+    if (!filter) {
+        return null;
+    }
+    const pkField = PrimaryKeyFieldFor(entity);
+    const label = LabelForRelatedLink(link, entity);
+    try {
+        const result = await read({
+            EntityName: entity.Name,
+            Fields: [pkField, nameField],
+            ExtraFilter: filter,
+            MaxRows: 1,
+        });
+        if (result?.Success === false) {
+            return null;
+        }
+        const row = result?.Success ? result.Results?.[0] : undefined;
+        if (result?.Success && !row) {
+            return null;
+        }
+        if (!row) {
+            return unreadableChip(link, entity, label, pkField);
+        }
+        const recordID = String(row[pkField] ?? link.RecordID ?? '');
+        if (!isPresent(recordID)) {
+            return null;
+        }
+        return chip(link, entity, label, pkField, recordID, String(row[nameField] ?? ''));
+    }
+    catch {
+        return unreadableChip(link, entity, label, pkField);
+    }
+}
+/**
+ * The chip for a record we could not read but can still open — only possible when the link carried
+ * the id itself. A reverse link has nothing left to open, so it renders nothing.
+ */
+function unreadableChip(link, entity, label, pkField) {
+    return isPresent(link.RecordID) ? chip(link, entity, label, pkField, String(link.RecordID).trim(), '') : null;
+}
+function chip(link, entity, label, pkField, recordID, name) {
+    return {
+        Key: link.Key,
+        Label: label,
+        Name: name,
+        Icon: link.Icon ?? null,
+        EntityName: entity.Name,
+        PrimaryKeyField: pkField,
+        RecordID: recordID,
+        AriaLabel: name ? `Open ${label} ${name}` : `Open ${label}`,
+    };
+}
+/**
+ * The navigation event a chip click produces.
+ *
+ * Ctrl (Windows/Linux) and Cmd (macOS) both mean "new tab", which is the idiom MJ uses everywhere a
+ * record link is clicked.
+ *
+ * `OpenInNewTab` is OMITTED rather than set to `false` on a plain click, and that is the whole of
+ * what makes shift-click work. `NavigationService.shouldForceNewTab` returns `options.forceNewTab`
+ * whenever it is `!== undefined` and only otherwise consults its global shift-key state, and
+ * Explorer passes `forceNewTab: event.OpenInNewTab` straight through. An explicit `false` therefore
+ * does not mean "no opinion" — it means "same tab", and it suppresses the shift detection outright.
+ *
+ * `CompositeKey.FromKeyValuePair` rather than `FromID`: the latter assumes the target's primary key
+ * is literally called `ID`, which is true of these apps today and is not a thing a shared component
+ * gets to assume.
+ */
+export function RelatedChipNavigation(chip, event) {
+    const navigation = {
+        Kind: 'record',
+        EntityName: chip.EntityName,
+        PrimaryKey: CompositeKey.FromKeyValuePair(chip.PrimaryKeyField, chip.RecordID),
+    };
+    if (event.ctrlKey || event.metaKey) {
+        navigation.OpenInNewTab = true;
+    }
+    return navigation;
+}
+//# sourceMappingURL=related-links.js.map

package/dist/lib/components/related-chips/related-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-links.js","sourceRoot":"","sources":["../../../../src/lib/components/related-chips/related-links.ts"],"names":[],"mappings":"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"}

package/dist/lib/data/__tests__/directory-headline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=directory-headline.test.d.ts.map

package/dist/lib/data/__tests__/directory-headline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-headline.test.d.ts","sourceRoot":"","sources":["../../../../src/lib/data/__tests__/directory-headline.test.ts"],"names":[],"mappings":""}

package/dist/lib/data/__tests__/directory-headline.test.js

@@ -0,0 +1,102 @@
+import { describe, expect, it } from 'vitest';
+import { BuildDirectoryHeadline, DIRECTORY_HEADLINE_UNREADABLE } from '../directory-stats';
+/**
+ * These pin the one rule the directory dashboard cannot get wrong: a count nobody could read is NOT
+ * zero. `LoadDirectoryDashboardSummary` returns `null` when the query fails or comes back empty, and
+ * the headline it produces must reach the tiles as nulls — which render an em dash — with the row's
+ * error line set, never as four zeros claiming an empty party file.
+ */
+function queue(count, label = `queue-${count}`) {
+    return { Label: label, Count: count, Icon: 'fa-solid fa-flag', Tone: 'warning', PageId: 'people' };
+}
+function summary(partial = {}) {
+    return {
+        ActivePeopleCount: 120,
+        TotalPeopleCount: 120,
+        ActiveOrganizationCount: 30,
+        TotalOrganizationCount: 30,
+        RelationshipCount: 88,
+        Queues: [],
+        ...partial,
+    };
+}
+describe('BuildDirectoryHeadline', () => {
+    describe('a failed read', () => {
+        it('leaves every count null rather than zero — zero is a claim the directory is empty', () => {
+            const headline = BuildDirectoryHeadline(null);
+            expect(headline.ActivePeopleCount).toBeNull();
+            expect(headline.ActiveOrganizationCount).toBeNull();
+            expect(headline.RelationshipCount).toBeNull();
+            expect(headline.GapCount).toBeNull();
+        });
+        it('says so once, on the row', () => {
+            expect(BuildDirectoryHeadline(null).Error).toBe(DIRECTORY_HEADLINE_UNREADABLE);
+        });
+        it('flags the read as failed, so no section reports itself empty', () => {
+            expect(BuildDirectoryHeadline(null).ReadFailed).toBe(true);
+        });
+        it('drops the footnotes, which have no count left to qualify', () => {
+            const headline = BuildDirectoryHeadline(null);
+            expect(headline.PeopleDetail).toBeNull();
+            expect(headline.OrganizationDetail).toBeNull();
+        });
+        it('treats undefined the same as null, the shape an unset property arrives as', () => {
+            expect(BuildDirectoryHeadline(undefined).ActivePeopleCount).toBeNull();
+            expect(BuildDirectoryHeadline(undefined).Error).toBe(DIRECTORY_HEADLINE_UNREADABLE);
+        });
+    });
+    describe('a successful read', () => {
+        it('carries the counts through and reports no error', () => {
+            const headline = BuildDirectoryHeadline(summary());
+            expect(headline.ActivePeopleCount).toBe(120);
+            expect(headline.ActiveOrganizationCount).toBe(30);
+            expect(headline.RelationshipCount).toBe(88);
+            expect(headline.Error).toBeNull();
+            expect(headline.ReadFailed).toBe(false);
+        });
+        it('leaves ReadFailed false for a genuinely empty directory, so the sections still read empty', () => {
+            const headline = BuildDirectoryHeadline(summary({ ActivePeopleCount: 0, TotalPeopleCount: 0, ActiveOrganizationCount: 0, TotalOrganizationCount: 0, RelationshipCount: 0 }));
+            expect(headline.ReadFailed).toBe(false);
+        });
+        it('keeps a real zero as zero — nothing on file is a legitimate answer, unlike an unread count', () => {
+            const headline = BuildDirectoryHeadline(summary({ ActivePeopleCount: 0, TotalPeopleCount: 0, RelationshipCount: 0 }));
+            expect(headline.ActivePeopleCount).toBe(0);
+            expect(headline.RelationshipCount).toBe(0);
+            expect(headline.GapCount).toBe(0);
+            expect(headline.Error).toBeNull();
+        });
+        it('sums the queues into the gap count', () => {
+            const headline = BuildDirectoryHeadline(summary({ Queues: [queue(3), queue(4), queue(10)] }));
+            expect(headline.GapCount).toBe(17);
+        });
+    });
+    describe('the gap tone', () => {
+        it('warns on gaps that were actually counted', () => {
+            expect(BuildDirectoryHeadline(summary({ Queues: [queue(1)] })).GapTone).toBe('warn');
+        });
+        it('stays quiet when the count read as zero', () => {
+            expect(BuildDirectoryHeadline(summary({ Queues: [] })).GapTone).toBe('none');
+        });
+        it('stays quiet on an unread count — "could not check" is not "something to fix"', () => {
+            expect(BuildDirectoryHeadline(null).GapTone).toBe('none');
+        });
+    });
+    describe('the footnotes', () => {
+        it('reads "everyone on file" when active equals total', () => {
+            const headline = BuildDirectoryHeadline(summary({ ActivePeopleCount: 120, TotalPeopleCount: 120 }));
+            expect(headline.PeopleDetail).toBe('Everyone currently on file');
+            expect(headline.OrganizationDetail).toBe('Active organizations');
+        });
+        it('names the total when inactive records exist', () => {
+            const headline = BuildDirectoryHeadline(summary({
+                ActivePeopleCount: 120,
+                TotalPeopleCount: 145,
+                ActiveOrganizationCount: 30,
+                TotalOrganizationCount: 41,
+            }));
+            expect(headline.PeopleDetail).toBe('145 total, including inactive');
+            expect(headline.OrganizationDetail).toBe('41 total, including inactive');
+        });
+    });
+});
+//# sourceMappingURL=directory-headline.test.js.map

package/dist/lib/data/__tests__/directory-headline.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-headline.test.js","sourceRoot":"","sources":["../../../../src/lib/data/__tests__/directory-headline.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/data/directory-stats.d.ts

@@ -1,4 +1,4 @@
-import type { DirectoryAttentionItem, DirectoryBarRow, DirectoryDayBar, DirectoryOrganizationRow, DirectoryPersonRow, DirectoryQueue, DirectoryRelationshipRow } from './directory-types';
+import type { DirectoryAttentionItem, DirectoryBarRow, DirectoryDayBar, DirectoryHeadline, DirectoryOrganizationRow, DirectoryPersonRow, DirectoryQueue, DirectoryRelationshipRow } from './directory-types';
 export declare function PersonEmail(person: DirectoryPersonRow): string | null;
 export declare function PersonPhone(person: DirectoryPersonRow): string | null;
 export declare function LocalDayKey(value: Date | string): string;
@@ -28,4 +28,26 @@ export declare function EscapeFilterValue(value: string): string;
  * literal character instead of widening the match.
  */
 export declare function EscapeLikeValue(value: string): string;
+/**
+ * The summary fields {@link BuildDirectoryHeadline} reads. Declared structurally so this module stays
+ * free of the query layer — `DirectoryDashboardSummary` in `directory-queries.ts` satisfies it.
+ */
+export interface DirectorySummaryCounts {
+    ActivePeopleCount: number;
+    TotalPeopleCount: number;
+    ActiveOrganizationCount: number;
+    TotalOrganizationCount: number;
+    RelationshipCount: number;
+    Queues: readonly DirectoryQueue[];
+}
+/** What the row says when the summary query did not return. Muted, not red — see `StatRowComponent`. */
+export declare const DIRECTORY_HEADLINE_UNREADABLE = "The directory counts could not be read just now.";
+/**
+ * Turn one summary read into the four headline tiles.
+ *
+ * A `null` summary is the failed read, and every count comes back `null` so each tile shows an em
+ * dash and the row carries the sentence. It is deliberately all-or-nothing: the counts come from a
+ * single query, so there is no state in which some of them are known.
+ */
+export declare function BuildDirectoryHeadline(summary: DirectorySummaryCounts | null | undefined): DirectoryHeadline;
 //# sourceMappingURL=directory-stats.d.ts.map

package/dist/lib/data/directory-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-stats.d.ts","sourceRoot":"","sources":["../../../src/lib/data/directory-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAExF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAEzG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAE9F;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAErG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAE9G;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAEjH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS;IAAE,cAAc,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,IAAI,SAAI,GAAG,eAAe,EAAE,CAc1G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,eAAe,EAAE,CASlF;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,cAAc,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,SAAI,GAAG,CAAC,EAAE,CAI9G;AAED,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAC1C,cAAc,EAAE,CAoClB;AAED,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAC1C,sBAAsB,EAAE,CA6B1B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAIvE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD"}
+{"version":3,"file":"directory-stats.d.ts","sourceRoot":"","sources":["../../../src/lib/data/directory-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAExF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAEzG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAE9F;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAErG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAE9G;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAAG,wBAAwB,EAAE,CAEjH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS;IAAE,cAAc,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,EAAE,EAAE,IAAI,SAAI,GAAG,eAAe,EAAE,CAc1G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,eAAe,EAAE,CASlF;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,cAAc,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,SAAI,GAAG,CAAC,EAAE,CAI9G;AAED,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAC1C,cAAc,EAAE,CAoClB;AAED,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,IAAI,EAAE,SAAS,wBAAwB,EAAE,GAC1C,sBAAsB,EAAE,CA6B1B;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAIvE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC;AAED,wGAAwG;AACxG,eAAO,MAAM,6BAA6B,qDAAqD,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAgC5G"}

package/dist/lib/data/directory-stats.js

@@ -146,4 +146,44 @@ export function EscapeLikeValue(value) {
         .replace(/%/g, '[%]')
         .replace(/_/g, '[_]');
 }
+/** What the row says when the summary query did not return. Muted, not red — see `StatRowComponent`. */
+export const DIRECTORY_HEADLINE_UNREADABLE = 'The directory counts could not be read just now.';
+/**
+ * Turn one summary read into the four headline tiles.
+ *
+ * A `null` summary is the failed read, and every count comes back `null` so each tile shows an em
+ * dash and the row carries the sentence. It is deliberately all-or-nothing: the counts come from a
+ * single query, so there is no state in which some of them are known.
+ */
+export function BuildDirectoryHeadline(summary) {
+    if (!summary) {
+        return {
+            ReadFailed: true,
+            ActivePeopleCount: null,
+            ActiveOrganizationCount: null,
+            RelationshipCount: null,
+            GapCount: null,
+            GapTone: 'none',
+            PeopleDetail: null,
+            OrganizationDetail: null,
+            Error: DIRECTORY_HEADLINE_UNREADABLE,
+        };
+    }
+    const gapCount = summary.Queues.reduce((sum, queue) => sum + queue.Count, 0);
+    return {
+        ReadFailed: false,
+        ActivePeopleCount: summary.ActivePeopleCount,
+        ActiveOrganizationCount: summary.ActiveOrganizationCount,
+        RelationshipCount: summary.RelationshipCount,
+        GapCount: gapCount,
+        GapTone: gapCount > 0 ? 'warn' : 'none',
+        PeopleDetail: summary.TotalPeopleCount === summary.ActivePeopleCount
+            ? 'Everyone currently on file'
+            : `${summary.TotalPeopleCount} total, including inactive`,
+        OrganizationDetail: summary.TotalOrganizationCount === summary.ActiveOrganizationCount
+            ? 'Active organizations'
+            : `${summary.TotalOrganizationCount} total, including inactive`,
+        Error: null,
+    };
+}
 //# sourceMappingURL=directory-stats.js.map

package/dist/lib/data/directory-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"directory-stats.js","sourceRoot":"","sources":["../../../src/lib/data/directory-stats.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"directory-stats.js","sourceRoot":"","sources":["../../../src/lib/data/directory-stats.ts"],"names":[],"mappings":"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"}

package/dist/lib/data/directory-types.d.ts

@@ -30,4 +30,38 @@ export interface DirectoryAttentionItem {
     Headline: string;
     Detail: string;
 }
+/**
+ * The four headline counts of the directory dashboard, in the shape `bizapps-stat-tile` takes them.
+ *
+ * The counts are `number | null` rather than `number` on purpose. They all come from one query, so
+ * they are one atomic read: either every number is true or none of them is. `null` is the tile's
+ * "could not be read" value and renders an em dash; `0` is a real answer and renders "0". Defaulting
+ * an unread count to `0` tells the reader the directory is empty when it is only unreadable, which is
+ * the one thing a dashboard must not say.
+ */
+export interface DirectoryHeadline {
+    /**
+     * True when the summary query did not return. Every section fed by that one read consults this
+     * before it reports itself empty: a list that is empty because nothing was read is not "nothing
+     * to do", and a green check over an unread directory is the same lie as a zero count.
+     */
+    ReadFailed: boolean;
+    ActivePeopleCount: number | null;
+    ActiveOrganizationCount: number | null;
+    RelationshipCount: number | null;
+    GapCount: number | null;
+    /**
+     * How the gap count should read. `warn` only on a gap count that was actually read and is above
+     * zero: an unknown count is an em dash, and colouring it amber would turn "we could not check"
+     * into "there is something to fix". Matches `StatTileTone`, kept as a literal union so the data
+     * layer does not depend on the component layer.
+     */
+    GapTone: 'none' | 'warn';
+    /** Footnote under the people count, or `null` when there is no count to qualify. */
+    PeopleDetail: string | null;
+    /** Footnote under the organization count, or `null` when there is no count to qualify. */
+    OrganizationDetail: string | null;
+    /** One sentence for `bizapps-stat-row`'s error line, or `null` when everything read. */
+    Error: string | null;
+}
 //# sourceMappingURL=directory-types.d.ts.map

package/dist/lib/data/directory-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-types.d.ts","sourceRoot":"","sources":["../../../src/lib/data/directory-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAEtJ,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACjC,2BAA2B,EACzB,IAAI,GACJ,aAAa,GACb,WAAW,GACX,UAAU,GACV,OAAO,GACP,cAAc,GACd,OAAO,GACP,cAAc,GACd,QAAQ,GACR,OAAO,GACP,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,CACrB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACvC,iCAAiC,EAC/B,IAAI,GACJ,MAAM,GACN,WAAW,GACX,QAAQ,GACR,kBAAkB,GAClB,oBAAoB,GACpB,SAAS,GACT,OAAO,GACP,OAAO,GACP,QAAQ,GACR,oBAAoB,GACpB,gBAAgB,CACrB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACvC,iCAAiC,EAC/B,IAAI,GACJ,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,kBAAkB,GAClB,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CACrB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"directory-types.d.ts","sourceRoot":"","sources":["../../../src/lib/data/directory-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAEtJ,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACjC,2BAA2B,EACzB,IAAI,GACJ,aAAa,GACb,WAAW,GACX,UAAU,GACV,OAAO,GACP,cAAc,GACd,OAAO,GACP,cAAc,GACd,QAAQ,GACR,OAAO,GACP,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,CACrB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACvC,iCAAiC,EAC/B,IAAI,GACJ,MAAM,GACN,WAAW,GACX,QAAQ,GACR,kBAAkB,GAClB,oBAAoB,GACpB,SAAS,GACT,OAAO,GACP,OAAO,GACP,QAAQ,GACR,oBAAoB,GACpB,gBAAgB,CACrB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACvC,iCAAiC,EAC/B,IAAI,GACJ,kBAAkB,GAClB,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,kBAAkB,GAClB,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CACrB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oFAAoF;IACpF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wFAAwF;IACxF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}