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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"related-links.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/components/related-chips/__tests__/related-links.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,183 @@
+import { describe, it, expect } from 'vitest';
+import { FilterForRelatedLink, LabelForRelatedLink, RelatedChipNavigation, ResolveRelatedChip, } from '../related-links';
+/**
+ * These pin the rules that decide whether a chip may be DRAWN, not the markup that draws it.
+ *
+ * Every one of them is silent when it regresses: a dead chip looks exactly like a live one until
+ * somebody clicks it, and a GUID in place of a name looks like data rather than a bug.
+ */
+const DEALS = {
+    Name: 'MJ_BizApps_Sales: Deals',
+    BaseTableDisplayName: 'Deal',
+    NameField: { Name: 'DealName' },
+    PrimaryKeys: [{ Name: 'ID' }],
+};
+const ORDERS = {
+    Name: 'MJ_BizApps_Orders: Order Headers',
+    BaseTableDisplayName: 'Order Header',
+    NameField: { Name: 'OrderNumber' },
+    PrimaryKeys: [{ Name: 'OrderKey' }],
+};
+const CATALOG = [DEALS, ORDERS];
+/** A reader that always answers the same way, and records what it was asked. */
+function readerReturning(result, asked = {}) {
+    return async (params) => {
+        asked.ExtraFilter = params.ExtraFilter;
+        asked.Fields = params.Fields;
+        return result;
+    };
+}
+function throwingReader() {
+    return async () => {
+        throw new Error('provider unreachable');
+    };
+}
+const DEAL_LINK = {
+    Key: 'source',
+    EntityName: DEALS.Name,
+    RecordID: 'D1',
+    LabelPrefix: 'Source',
+};
+describe('a chip that cannot navigate is not rendered', () => {
+    it('drops a link whose entity is not in the catalog — the app is not installed, or not readable', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'contract', EntityName: 'MJ_BizApps_Contracts: Contracts', RecordID: 'C1' }, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'C1', Name: 'CTR-1' }] }));
+        expect(chip).toBeNull();
+    });
+    it('drops a link to an entity with no name field — a chip may not fall back to an id', async () => {
+        const nameless = { ...DEALS, NameField: null };
+        const chip = await ResolveRelatedChip(DEAL_LINK, [nameless], readerReturning({ Success: true, Results: [{}] }));
+        expect(chip).toBeNull();
+    });
+    it('drops a link that names neither a record nor a filter', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'source', EntityName: DEALS.Name, RecordID: null }, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'D1', DealName: 'Acme' }] }));
+        expect(chip).toBeNull();
+    });
+    it('treats a blank RecordID as naming nothing', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'source', EntityName: DEALS.Name, RecordID: '   ' }, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'D1', DealName: 'Acme' }] }));
+        expect(chip).toBeNull();
+    });
+    it('drops a link whose read SUCCEEDED and matched nothing — the record is not there', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, readerReturning({ Success: true, Results: [] }));
+        expect(chip).toBeNull();
+    });
+});
+describe('a read that threw, a read that was refused, and a record that is absent', () => {
+    it('keeps a forward link when the read throws — the record may exist and merely be unreadable', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, throwingReader());
+        expect(chip).not.toBeNull();
+        expect(chip?.RecordID).toBe('D1');
+        expect(chip?.Name).toBe('');
+        expect(chip?.Label).toBe('Source Deal');
+    });
+    it('drops a forward link when the read REPORTS failure — the server answered and refused', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, readerReturning({ Success: false }));
+        expect(chip).toBeNull();
+    });
+    it('drops a reverse link when the read reports failure', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'deal', EntityName: DEALS.Name, Filter: `OrderID = 'O1'` }, CATALOG, readerReturning({ Success: false }));
+        expect(chip).toBeNull();
+    });
+    it('keeps a forward link when the reader answers nothing at all — still unknown', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, async () => undefined);
+        expect(chip?.RecordID).toBe('D1');
+        expect(chip?.Name).toBe('');
+    });
+    it('drops a REVERSE link when the read throws — the throw also cost us the id to open', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'deal', EntityName: DEALS.Name, Filter: `OrderID = 'O1'` }, CATALOG, throwingReader());
+        expect(chip).toBeNull();
+    });
+});
+describe('a chip never shows a raw id', () => {
+    it('reads the name from the entity name field', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'D1', DealName: 'Acme renewal' }] }));
+        expect(chip?.Name).toBe('Acme renewal');
+    });
+    it('asks for the primary key and the name field, and nothing else', async () => {
+        const asked = {};
+        await ResolveRelatedChip({ Key: 'order', EntityName: ORDERS.Name, RecordID: 'O1' }, CATALOG, readerReturning({ Success: true, Results: [{ OrderKey: 'O1', OrderNumber: 'ORD-9' }] }, asked));
+        expect(asked.Fields).toEqual(['OrderKey', 'OrderNumber']);
+    });
+    it('takes the id back from the row, so a reverse link knows what it found', async () => {
+        const chip = await ResolveRelatedChip({ Key: 'deal', EntityName: DEALS.Name, Filter: `OrderID = 'O1'` }, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'D7', DealName: 'Acme' }] }));
+        expect(chip?.RecordID).toBe('D7');
+        expect(chip?.Name).toBe('Acme');
+    });
+});
+describe('the filter', () => {
+    it('selects on the entity primary key, not a hardcoded ID column', () => {
+        expect(FilterForRelatedLink({ Key: 'o', EntityName: ORDERS.Name, RecordID: 'O1' }, ORDERS)).toBe(`OrderKey = 'O1'`);
+    });
+    it("escapes single quotes so an id cannot break out of the literal", () => {
+        expect(FilterForRelatedLink({ Key: 'd', EntityName: DEALS.Name, RecordID: "a'b" }, DEALS)).toBe(`ID = 'a''b'`);
+    });
+    it('prefers a RecordID over a Filter when both are given', () => {
+        expect(FilterForRelatedLink({ Key: 'd', EntityName: DEALS.Name, RecordID: 'D1', Filter: 'X = 1' }, DEALS)).toBe(`ID = 'D1'`);
+    });
+    it('passes a reverse filter through untouched', () => {
+        expect(FilterForRelatedLink({ Key: 'd', EntityName: DEALS.Name, Filter: `OrderID = 'O1'` }, DEALS)).toBe(`OrderID = 'O1'`);
+    });
+});
+describe('the label', () => {
+    it('uses an explicit Label above everything else', () => {
+        expect(LabelForRelatedLink({ Key: 'd', EntityName: DEALS.Name, Label: 'Won deal', LabelPrefix: 'Source' }, DEALS)).toBe('Won deal');
+    });
+    it('builds "<prefix> <singular entity>" from a LabelPrefix — "Source Deal"', () => {
+        expect(LabelForRelatedLink({ Key: 'd', EntityName: DEALS.Name, LabelPrefix: 'Source' }, DEALS)).toBe('Source Deal');
+    });
+    it('follows the entity for a polymorphic link, so Orders reads "Source Order Header"', () => {
+        expect(LabelForRelatedLink({ Key: 'd', EntityName: ORDERS.Name, LabelPrefix: 'Source' }, ORDERS)).toBe('Source Order Header');
+    });
+    it('falls back to the entity singular name when the caller names nothing', () => {
+        expect(LabelForRelatedLink({ Key: 'd', EntityName: DEALS.Name }, DEALS)).toBe('Deal');
+    });
+});
+describe('the accessible name', () => {
+    it('names the record when it could be read', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, readerReturning({ Success: true, Results: [{ ID: 'D1', DealName: 'Acme' }] }));
+        expect(chip?.AriaLabel).toBe('Open Source Deal Acme');
+    });
+    it('does not trail an empty name when the record could not be read', async () => {
+        const chip = await ResolveRelatedChip(DEAL_LINK, CATALOG, throwingReader());
+        expect(chip?.AriaLabel).toBe('Open Source Deal');
+    });
+});
+describe('navigation', () => {
+    const chip = {
+        Key: 'order',
+        Label: 'Order',
+        Name: 'ORD-9',
+        Icon: null,
+        EntityName: ORDERS.Name,
+        PrimaryKeyField: 'OrderKey',
+        RecordID: 'O1',
+        AriaLabel: 'Open Order ORD-9',
+    };
+    function mouse(modifiers) {
+        return { ctrlKey: false, metaKey: false, ...modifiers };
+    }
+    /**
+     * NOT `toBe(false)`. `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 — so an explicit `false`
+     * on a plain click silently disables shift-click for the whole row.
+     */
+    it('leaves OpenInNewTab UNSET on a plain click, so shift-click still reaches NavigationService', () => {
+        const event = RelatedChipNavigation(chip, mouse({}));
+        expect(event.OpenInNewTab).toBeUndefined();
+        expect('OpenInNewTab' in event).toBe(false);
+    });
+    it('opens a new tab on ctrl-click', () => {
+        expect(RelatedChipNavigation(chip, mouse({ ctrlKey: true })).OpenInNewTab).toBe(true);
+    });
+    it('opens a new tab on cmd-click, which is what a Mac user presses', () => {
+        expect(RelatedChipNavigation(chip, mouse({ metaKey: true })).OpenInNewTab).toBe(true);
+    });
+    it('keys on the entity own primary key column rather than assuming "ID"', () => {
+        const event = RelatedChipNavigation(chip, mouse({}));
+        expect(event.Kind).toBe('record');
+        expect(event.Kind === 'record' && event.PrimaryKey.KeyValuePairs).toEqual([
+            { FieldName: 'OrderKey', Value: 'O1' },
+        ]);
+    });
+});
+//# sourceMappingURL=related-links.test.js.map

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

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

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

@@ -0,0 +1,132 @@
+import { EventEmitter, type OnDestroy } from '@angular/core';
+import { type IMetadataProvider } from '@memberjunction/core';
+import type { FormNavigationEvent } from '@memberjunction/ng-base-forms';
+import { type BizAppsRelatedLink, type ResolvedRelatedChip } from './related-links';
+import * as i0 from "@angular/core";
+/**
+ * `bizapps-related-chips` — the row of links from a record to the records linked to it.
+ *
+ * THE SHARED BIZAPPS "RELATED" ROW. A tester walking Deal → Order → Contract found no consistent way
+ * to get from one record to the next: the Contract header linked its source Deal, the Deal form
+ * buried its Order in a panel, the Order form pointed at nothing, and where a link did exist it
+ * sometimes rendered a GUID. Each app had solved a slice of it differently. This is the one they
+ * collapse into.
+ *
+ * ## What a caller supplies, and what this owns
+ *
+ * The caller passes {@link Links} — descriptors naming an entity and either the id it holds or a
+ * filter that finds the record holding the id. Which links belong on which form is the caller's
+ * decision, because only the form knows its own record.
+ *
+ * Everything after that is this component's: resolving the entity, reading the record's NAME, and —
+ * the part worth having in one place — deciding when a chip must not be drawn at all. Those rules
+ * and their reasoning live in `related-links.ts`, deliberately outside this class so they can be
+ * tested without DI. In short: no chip for an entity this host does not have or this user cannot
+ * read, no chip for a record that is not there, and never a raw id in place of a name.
+ *
+ * ## Navigation goes up, not out
+ *
+ * The component emits {@link Navigate} and never touches `NavigationService`. A host form wires it
+ * to `FormComponent.OnFormNavigate($event)` — the same path every field link in these apps takes —
+ * which keeps this usable from a `BaseFormPanel` hero and from a form component override alike, and
+ * keeps the routing decision with the app that owns the surface.
+ *
+ * ## Example
+ *
+ * ```html
+ * <bizapps-related-chips
+ *     [Links]="RelatedLinks"
+ *     [Provider]="FormComponent?.ProviderToUse ?? null"
+ *     (Navigate)="FormComponent.OnFormNavigate($event)" />
+ * ```
+ *
+ * ```typescript
+ * public RelatedLinks: BizAppsRelatedLink[] = [
+ *     { Key: 'order', EntityName: 'MJ_BizApps_Orders: Order Headers', RecordID: deal.OrderID, Label: 'Order' },
+ *     { Key: 'contract', EntityName: 'MJ_BizApps_Contracts: Contracts', RecordID: deal.ContractID, Label: 'Contract' },
+ * ];
+ * ```
+ */
+export declare class RelatedChipsComponent implements OnDestroy {
+    private readonly cdr;
+    /** Chips that resolved. A link that resolved to nothing is absent here, never a blank chip. */
+    Chips: ResolvedRelatedChip[];
+    private links;
+    private provider;
+    /**
+     * Guards against a slower read for a PREVIOUS set of links landing after the caller moved on —
+     * a form navigating between records is the ordinary way that happens. Every resolve captures the
+     * generation it started in and discards itself if it no longer matches.
+     */
+    private generation;
+    /**
+     * The OTHER way a resolve becomes irrelevant, and the one the generation cannot see: the view it
+     * would publish into is gone. `detectChanges()` has no destroyed-view guard of its own, so a read
+     * still in flight when the user closes the tab would run change detection over a torn-down
+     * `LView`.
+     */
+    private destroyed;
+    /**
+     * The relationships to offer, in the order they should read.
+     *
+     * A setter rather than `ngOnChanges`, per MJ's rule: the input's own setter is the one place that
+     * knows the value changed. Assign a NEW array to trigger a re-resolve; mutating the existing one
+     * in place will not, which is the same contract every other data-driven MJ input has.
+     */
+    set Links(value: BizAppsRelatedLink[] | null | undefined);
+    get Links(): BizAppsRelatedLink[];
+    /**
+     * Metadata provider to read through. Falls back to the ambient one when not supplied.
+     *
+     * A form panel should pass `FormComponent.ProviderToUse`, so the chips read from the same place
+     * the record they describe came from. In a host with more than one provider the fallback reads
+     * the wrong database and the failure is a wrong ANSWER rather than an error, which is why this
+     * is worth passing even when there is only one today.
+     *
+     * A SETTER, and re-resolving, for the same reason. Angular assigns bound inputs in template
+     * order, and the usage above binds `[Links]` first — so a plain field would be read as `null` by
+     * the resolve the `Links` setter kicks off, silently reading the ambient provider, and would
+     * never be re-read once the real one arrived. `FormComponent?.ProviderToUse` starting out `null`
+     * and resolving a tick later has the same shape. Both resolve against the wrong database, and a
+     * wrong database here is a wrong answer rather than an error.
+     */
+    set Provider(value: IMetadataProvider | null | undefined);
+    get Provider(): IMetadataProvider | null;
+    /**
+     * Emitted when a chip is clicked, with `OpenInNewTab` set for ctrl/cmd-click.
+     *
+     * Wire it to the host form's `OnFormNavigate`. Nothing happens if it is left unbound — which is
+     * why the chip is drawn as a real `<button>` only because a click always has somewhere to go in
+     * practice; a host that binds nothing gets a row that looks live and is not.
+     */
+    Navigate: EventEmitter<FormNavigationEvent>;
+    /** The provider actually used — the one passed in, or the ambient one. */
+    get ProviderToUse(): IMetadataProvider;
+    Open(chip: ResolvedRelatedChip, event: MouseEvent): void;
+    ngOnDestroy(): void;
+    /**
+     * Drop what is on screen and queue a fresh resolve for the next microtask.
+     *
+     * CLEARED FIRST because the chips on screen describe the record we just left. A form container
+     * reuses this instance across records, so a header moving from Deal A to Deal B that kept A's
+     * chips for the length of the reads would offer a click that navigates to A's related record —
+     * a wrong destination, not a slow one.
+     *
+     * QUEUED because every input that feeds a resolve is assigned in the same change-detection pass,
+     * one after another. Resolving inside the setter would read a half-applied set of inputs, and
+     * would read twice. The microtask runs once both have landed; the generation it was queued under
+     * makes each superseded one drop itself.
+     */
+    private scheduleResolve;
+    /**
+     * Resolve every link concurrently, then publish the survivors in the caller's order.
+     *
+     * Published in one assignment rather than chip by chip: a row that grows an item at a time
+     * reflows the header under the reader, and the links are few enough that the slowest read is the
+     * whole wait either way.
+     */
+    private resolve;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RelatedChipsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RelatedChipsComponent, "bizapps-related-chips", never, { "Links": { "alias": "Links"; "required": false; }; "Provider": { "alias": "Provider"; "required": false; }; }, { "Navigate": "Navigate"; }, never, never, true, never>;
+}
+//# sourceMappingURL=related-chips.component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"related-chips.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/related-chips/related-chips.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,YAAY,EAEZ,KAAK,SAAS,EAIjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAGH,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAC3B,MAAM,iBAAiB,CAAC;;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAiFa,qBAAsB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IAEjD,+FAA+F;IACxF,KAAK,EAAE,mBAAmB,EAAE,CAAM;IAEzC,OAAO,CAAC,KAAK,CAA4B;IAEzC,OAAO,CAAC,QAAQ,CAAkC;IAElD;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAK;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;OAMG;IACH,IACW,KAAK,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,GAAG,SAAS,EAG9D;IACD,IAAW,KAAK,IAAI,kBAAkB,EAAE,CAEvC;IAED;;;;;;;;;;;;;;OAcG;IACH,IACW,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAG9D;IACD,IAAW,QAAQ,IAAI,iBAAiB,GAAG,IAAI,CAE9C;IAED;;;;;;OAMG;IACc,QAAQ,oCAA2C;IAEpE,0EAA0E;IAC1E,IAAW,aAAa,IAAI,iBAAiB,CAE5C;IAEM,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAKxD,WAAW,IAAI,IAAI;IAI1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;OAMG;YACW,OAAO;yCAvHZ,qBAAqB;2CAArB,qBAAqB;CAgJjC"}

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

@@ -0,0 +1,241 @@
+import { ChangeDetectionStrategy, ChangeDetectorRef, Component, EventEmitter, Input, Output, ViewEncapsulation, inject, } from '@angular/core';
+import { Metadata, RunView } from '@memberjunction/core';
+import { RelatedChipNavigation, ResolveRelatedChip, } from './related-links';
+import * as i0 from "@angular/core";
+const _forTrack0 = ($index, $item) => $item.Key;
+function RelatedChipsComponent_Conditional_0_For_2_Conditional_1_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵdomElement(0, "i", 6);
+} if (rf & 2) {
+    const chip_r2 = i0.ɵɵnextContext().$implicit;
+    i0.ɵɵclassMap(chip_r2.Icon);
+} }
+function RelatedChipsComponent_Conditional_0_For_2_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵdomElementStart(0, "button", 2);
+    i0.ɵɵdomListener("click", function RelatedChipsComponent_Conditional_0_For_2_Template_button_click_0_listener($event) { const chip_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r2.Open(chip_r2, $event)); });
+    i0.ɵɵconditionalCreate(1, RelatedChipsComponent_Conditional_0_For_2_Conditional_1_Template, 1, 2, "i", 3);
+    i0.ɵɵdomElementStart(2, "span", 4);
+    i0.ɵɵtext(3);
+    i0.ɵɵdomElementEnd();
+    i0.ɵɵdomElementStart(4, "span", 5);
+    i0.ɵɵtext(5);
+    i0.ɵɵdomElementEnd()();
+} if (rf & 2) {
+    const chip_r2 = ctx.$implicit;
+    i0.ɵɵattribute("aria-label", chip_r2.AriaLabel);
+    i0.ɵɵadvance();
+    i0.ɵɵconditional(chip_r2.Icon ? 1 : -1);
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(chip_r2.Label);
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(chip_r2.Name || "Open");
+} }
+function RelatedChipsComponent_Conditional_0_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵdomElementStart(0, "div", 0);
+    i0.ɵɵrepeaterCreate(1, RelatedChipsComponent_Conditional_0_For_2_Template, 6, 4, "button", 1, _forTrack0);
+    i0.ɵɵdomElementEnd();
+} if (rf & 2) {
+    const ctx_r2 = i0.ɵɵnextContext();
+    i0.ɵɵadvance();
+    i0.ɵɵrepeater(ctx_r2.Chips);
+} }
+/**
+ * `bizapps-related-chips` — the row of links from a record to the records linked to it.
+ *
+ * THE SHARED BIZAPPS "RELATED" ROW. A tester walking Deal → Order → Contract found no consistent way
+ * to get from one record to the next: the Contract header linked its source Deal, the Deal form
+ * buried its Order in a panel, the Order form pointed at nothing, and where a link did exist it
+ * sometimes rendered a GUID. Each app had solved a slice of it differently. This is the one they
+ * collapse into.
+ *
+ * ## What a caller supplies, and what this owns
+ *
+ * The caller passes {@link Links} — descriptors naming an entity and either the id it holds or a
+ * filter that finds the record holding the id. Which links belong on which form is the caller's
+ * decision, because only the form knows its own record.
+ *
+ * Everything after that is this component's: resolving the entity, reading the record's NAME, and —
+ * the part worth having in one place — deciding when a chip must not be drawn at all. Those rules
+ * and their reasoning live in `related-links.ts`, deliberately outside this class so they can be
+ * tested without DI. In short: no chip for an entity this host does not have or this user cannot
+ * read, no chip for a record that is not there, and never a raw id in place of a name.
+ *
+ * ## Navigation goes up, not out
+ *
+ * The component emits {@link Navigate} and never touches `NavigationService`. A host form wires it
+ * to `FormComponent.OnFormNavigate($event)` — the same path every field link in these apps takes —
+ * which keeps this usable from a `BaseFormPanel` hero and from a form component override alike, and
+ * keeps the routing decision with the app that owns the surface.
+ *
+ * ## Example
+ *
+ * ```html
+ * <bizapps-related-chips
+ *     [Links]="RelatedLinks"
+ *     [Provider]="FormComponent?.ProviderToUse ?? null"
+ *     (Navigate)="FormComponent.OnFormNavigate($event)" />
+ * ```
+ *
+ * ```typescript
+ * public RelatedLinks: BizAppsRelatedLink[] = [
+ *     { Key: 'order', EntityName: 'MJ_BizApps_Orders: Order Headers', RecordID: deal.OrderID, Label: 'Order' },
+ *     { Key: 'contract', EntityName: 'MJ_BizApps_Contracts: Contracts', RecordID: deal.ContractID, Label: 'Contract' },
+ * ];
+ * ```
+ */
+export class RelatedChipsComponent {
+    cdr = inject(ChangeDetectorRef);
+    /** Chips that resolved. A link that resolved to nothing is absent here, never a blank chip. */
+    Chips = [];
+    links = [];
+    provider = null;
+    /**
+     * Guards against a slower read for a PREVIOUS set of links landing after the caller moved on —
+     * a form navigating between records is the ordinary way that happens. Every resolve captures the
+     * generation it started in and discards itself if it no longer matches.
+     */
+    generation = 0;
+    /**
+     * The OTHER way a resolve becomes irrelevant, and the one the generation cannot see: the view it
+     * would publish into is gone. `detectChanges()` has no destroyed-view guard of its own, so a read
+     * still in flight when the user closes the tab would run change detection over a torn-down
+     * `LView`.
+     */
+    destroyed = false;
+    /**
+     * The relationships to offer, in the order they should read.
+     *
+     * A setter rather than `ngOnChanges`, per MJ's rule: the input's own setter is the one place that
+     * knows the value changed. Assign a NEW array to trigger a re-resolve; mutating the existing one
+     * in place will not, which is the same contract every other data-driven MJ input has.
+     */
+    set Links(value) {
+        this.links = value ?? [];
+        this.scheduleResolve();
+    }
+    get Links() {
+        return this.links;
+    }
+    /**
+     * Metadata provider to read through. Falls back to the ambient one when not supplied.
+     *
+     * A form panel should pass `FormComponent.ProviderToUse`, so the chips read from the same place
+     * the record they describe came from. In a host with more than one provider the fallback reads
+     * the wrong database and the failure is a wrong ANSWER rather than an error, which is why this
+     * is worth passing even when there is only one today.
+     *
+     * A SETTER, and re-resolving, for the same reason. Angular assigns bound inputs in template
+     * order, and the usage above binds `[Links]` first — so a plain field would be read as `null` by
+     * the resolve the `Links` setter kicks off, silently reading the ambient provider, and would
+     * never be re-read once the real one arrived. `FormComponent?.ProviderToUse` starting out `null`
+     * and resolving a tick later has the same shape. Both resolve against the wrong database, and a
+     * wrong database here is a wrong answer rather than an error.
+     */
+    set Provider(value) {
+        this.provider = value ?? null;
+        this.scheduleResolve();
+    }
+    get Provider() {
+        return this.provider;
+    }
+    /**
+     * Emitted when a chip is clicked, with `OpenInNewTab` set for ctrl/cmd-click.
+     *
+     * Wire it to the host form's `OnFormNavigate`. Nothing happens if it is left unbound — which is
+     * why the chip is drawn as a real `<button>` only because a click always has somewhere to go in
+     * practice; a host that binds nothing gets a row that looks live and is not.
+     */
+    Navigate = new EventEmitter();
+    /** The provider actually used — the one passed in, or the ambient one. */
+    get ProviderToUse() {
+        return this.provider ?? Metadata.Provider;
+    }
+    Open(chip, event) {
+        event.preventDefault();
+        this.Navigate.emit(RelatedChipNavigation(chip, event));
+    }
+    ngOnDestroy() {
+        this.destroyed = true;
+    }
+    /**
+     * Drop what is on screen and queue a fresh resolve for the next microtask.
+     *
+     * CLEARED FIRST because the chips on screen describe the record we just left. A form container
+     * reuses this instance across records, so a header moving from Deal A to Deal B that kept A's
+     * chips for the length of the reads would offer a click that navigates to A's related record —
+     * a wrong destination, not a slow one.
+     *
+     * QUEUED because every input that feeds a resolve is assigned in the same change-detection pass,
+     * one after another. Resolving inside the setter would read a half-applied set of inputs, and
+     * would read twice. The microtask runs once both have landed; the generation it was queued under
+     * makes each superseded one drop itself.
+     */
+    scheduleResolve() {
+        const generation = ++this.generation;
+        this.Chips = [];
+        void Promise.resolve().then(() => {
+            if (this.generation !== generation || this.destroyed) {
+                return;
+            }
+            return this.resolve(generation);
+        });
+    }
+    /**
+     * Resolve every link concurrently, then publish the survivors in the caller's order.
+     *
+     * Published in one assignment rather than chip by chip: a row that grows an item at a time
+     * reflows the header under the reader, and the links are few enough that the slowest read is the
+     * whole wait either way.
+     */
+    async resolve(generation) {
+        const links = this.links;
+        if (links.length === 0) {
+            return;
+        }
+        const provider = this.ProviderToUse;
+        const entities = provider?.Entities ?? [];
+        const runView = RunView.FromMetadataProvider(provider);
+        const resolved = await Promise.all(links.map((link) => ResolveRelatedChip(link, entities, (params) => runView.RunView({ ...params, ResultType: 'simple' }))));
+        if (this.generation !== generation || this.destroyed) {
+            return;
+        }
+        this.Chips = resolved.filter((chip) => chip !== null);
+        this.cdr.detectChanges();
+    }
+    static ɵfac = function RelatedChipsComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || RelatedChipsComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: RelatedChipsComponent, selectors: [["bizapps-related-chips"]], inputs: { Links: "Links", Provider: "Provider" }, outputs: { Navigate: "Navigate" }, decls: 1, vars: 1, consts: [["role", "group", "aria-label", "Related records", 1, "bizapps-related"], ["type", "button", 1, "bizapps-related__chip"], ["type", "button", 1, "bizapps-related__chip", 3, "click"], ["aria-hidden", "true", 3, "class"], [1, "bizapps-related__label"], [1, "bizapps-related__name"], ["aria-hidden", "true"]], template: function RelatedChipsComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵconditionalCreate(0, RelatedChipsComponent_Conditional_0_Template, 3, 0, "div", 0);
+        } if (rf & 2) {
+            i0.ɵɵconditional(ctx.Chips.length > 0 ? 0 : -1);
+        } }, styles: ["\n            /* Styles are the component's own and use design tokens only, under a class prefix of\n               their own: the app kits (orders-kit, contracts-kit) are global under\n               ViewEncapsulation.None, and .mj-chip / .mjc-chip / .mjo-* / .biz-hero__chip are all\n               already taken by unrelated things. A row that borrowed one of those would render\n               differently in each app, which is the failure this component exists to end. */\n            .bizapps-related {\n                display: flex;\n                flex-wrap: wrap;\n                align-items: center;\n                gap: var(--mj-space-2);\n            }\n            .bizapps-related__chip {\n                display: inline-flex;\n                align-items: center;\n                gap: var(--mj-space-1-5);\n                max-width: 100%;\n                margin: 0;\n                padding: var(--mj-space-1) var(--mj-space-3);\n                font-family: inherit;\n                font-size: var(--mj-text-xs);\n                font-weight: var(--mj-font-semibold);\n                line-height: 1.5;\n                background: var(--mj-bg-surface-card);\n                border: 1px solid var(--mj-border-default);\n                border-radius: var(--mj-radius-full);\n                cursor: pointer;\n                transition: var(--mj-transition-colors);\n            }\n            .bizapps-related__chip:hover {\n                background: var(--mj-bg-surface-hover);\n                border-color: var(--mj-brand-primary);\n            }\n            .bizapps-related__chip:focus-visible {\n                outline: var(--mj-ring-width) solid var(--mj-focus-ring-color);\n                outline-offset: var(--mj-ring-offset);\n            }\n            /* The relationship is the quiet half; the record's NAME is what the reader is looking\n               for, so it carries the link colour and the underline on hover. */\n            .bizapps-related__label {\n                color: var(--mj-text-secondary);\n                white-space: nowrap;\n            }\n            .bizapps-related__name {\n                overflow: hidden;\n                color: var(--mj-text-link);\n                text-overflow: ellipsis;\n                white-space: nowrap;\n            }\n            .bizapps-related__chip:hover .bizapps-related__name {\n                color: var(--mj-text-link-hover);\n                text-decoration: underline;\n            }\n        "], encapsulation: 2, changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(RelatedChipsComponent, [{
+        type: Component,
+        args: [{ selector: 'bizapps-related-chips', standalone: true, encapsulation: ViewEncapsulation.None, changeDetection: ChangeDetectionStrategy.OnPush, template: `
+        @if (Chips.length > 0) {
+            <div class="bizapps-related" role="group" aria-label="Related records">
+                @for (chip of Chips; track chip.Key) {
+                    <button
+                        type="button"
+                        class="bizapps-related__chip"
+                        [attr.aria-label]="chip.AriaLabel"
+                        (click)="Open(chip, $event)">
+                        @if (chip.Icon) {
+                            <i [class]="chip.Icon" aria-hidden="true"></i>
+                        }
+                        <span class="bizapps-related__label">{{ chip.Label }}</span>
+                        <span class="bizapps-related__name">{{ chip.Name || 'Open' }}</span>
+                    </button>
+                }
+            </div>
+        }
+    `, styles: ["\n            /* Styles are the component's own and use design tokens only, under a class prefix of\n               their own: the app kits (orders-kit, contracts-kit) are global under\n               ViewEncapsulation.None, and .mj-chip / .mjc-chip / .mjo-* / .biz-hero__chip are all\n               already taken by unrelated things. A row that borrowed one of those would render\n               differently in each app, which is the failure this component exists to end. */\n            .bizapps-related {\n                display: flex;\n                flex-wrap: wrap;\n                align-items: center;\n                gap: var(--mj-space-2);\n            }\n            .bizapps-related__chip {\n                display: inline-flex;\n                align-items: center;\n                gap: var(--mj-space-1-5);\n                max-width: 100%;\n                margin: 0;\n                padding: var(--mj-space-1) var(--mj-space-3);\n                font-family: inherit;\n                font-size: var(--mj-text-xs);\n                font-weight: var(--mj-font-semibold);\n                line-height: 1.5;\n                background: var(--mj-bg-surface-card);\n                border: 1px solid var(--mj-border-default);\n                border-radius: var(--mj-radius-full);\n                cursor: pointer;\n                transition: var(--mj-transition-colors);\n            }\n            .bizapps-related__chip:hover {\n                background: var(--mj-bg-surface-hover);\n                border-color: var(--mj-brand-primary);\n            }\n            .bizapps-related__chip:focus-visible {\n                outline: var(--mj-ring-width) solid var(--mj-focus-ring-color);\n                outline-offset: var(--mj-ring-offset);\n            }\n            /* The relationship is the quiet half; the record's NAME is what the reader is looking\n               for, so it carries the link colour and the underline on hover. */\n            .bizapps-related__label {\n                color: var(--mj-text-secondary);\n                white-space: nowrap;\n            }\n            .bizapps-related__name {\n                overflow: hidden;\n                color: var(--mj-text-link);\n                text-overflow: ellipsis;\n                white-space: nowrap;\n            }\n            .bizapps-related__chip:hover .bizapps-related__name {\n                color: var(--mj-text-link-hover);\n                text-decoration: underline;\n            }\n        "] }]
+    }], null, { Links: [{
+            type: Input
+        }], Provider: [{
+            type: Input
+        }], Navigate: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(RelatedChipsComponent, { className: "RelatedChipsComponent", filePath: "lib/components/related-chips/related-chips.component.ts", lineNumber: 146 }); })();
+//# sourceMappingURL=related-chips.component.js.map

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

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