@mj-biz-apps/contracts-ng 0.1.0

package/dist/lib/pages/contracts-dashboard.page.js

@@ -0,0 +1,215 @@
+/**
+ * @fileoverview The Contracts dashboard — "what needs attention", not "how are we doing".
+ *
+ * DELIBERATELY NOT A CHART. This app tracks obligations; the useful question on opening it is which
+ * agreements need a person this quarter, and the honest answer is four numbers and the lists behind
+ * them. A revenue chart would be a chart about orders' data drawn on contracts' screen, and it would
+ * invite reading it as authoritative about money — which contracts explicitly is not (plan §1).
+ *
+ * Every number is a count over the layered base view's DERIVED columns, so the dashboard cannot
+ * disagree with the worklists: both read `IsAwaitingDocument`, `RenewalNoticeDeadline` and `State`
+ * from the same view. A dashboard computing its own version of "expiring soon" is how a summary and a
+ * worklist end up giving different answers to the same question.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { ChangeDetectorRef, Component, EventEmitter, Output, ViewEncapsulation, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { MJC_ENTITIES } from '../data/entity-names';
+import { ScopedRunView } from '../data/provider';
+import * as i0 from "@angular/core";
+const _forTrack0 = ($index, $item) => $item.Id;
+function MJCContractsDashboardPageComponent_For_5_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵdomElementStart(0, "button", 7);
+    i0.ɵɵdomListener("click", function MJCContractsDashboardPageComponent_For_5_Template_button_click_0_listener() { const tile_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r2.Open(tile_r2)); });
+    i0.ɵɵtext(1);
+    i0.ɵɵdomElementStart(2, "span", 8);
+    i0.ɵɵtext(3);
+    i0.ɵɵdomElementEnd()();
+} if (rf & 2) {
+    const tile_r2 = ctx.$implicit;
+    i0.ɵɵclassProp("mjc-pill--active", tile_r2.Count !== null && tile_r2.Count > 0);
+    i0.ɵɵdomProperty("title", tile_r2.Hint)("disabled", !tile_r2.GoTo);
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate1(" ", tile_r2.Label, " ");
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(tile_r2.Count === null ? "\u2014" : tile_r2.Count);
+} }
+function MJCContractsDashboardPageComponent_Conditional_6_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵdomElementStart(0, "p", 4);
+    i0.ɵɵtext(1);
+    i0.ɵɵdomElementEnd();
+} if (rf & 2) {
+    const ctx_r2 = i0.ɵɵnextContext();
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate(ctx_r2.LoadError);
+} }
+export class MJCContractsDashboardPageComponent {
+    cdr = inject(ChangeDetectorRef);
+    /** Asks the host section to switch rail pages. The dashboard does not route itself. */
+    NavigateToPage = new EventEmitter();
+    LoadError = null;
+    /**
+     * The four questions worth answering on open, in priority order.
+     *
+     * "In force without paper" leads because it is the only one that is both an obligation we are
+     * already performing and a document we cannot produce — the combination that hurts in a dispute.
+     */
+    Tiles = [
+        {
+            Id: 'in-force-no-paper',
+            Label: 'In force without paper',
+            Hint: 'Active contracts whose type expects an executed document, with none attached',
+            Filter: `State = 'Active' AND IsAwaitingDocument = 1`,
+            GoTo: 'awaiting',
+            Count: null,
+        },
+        {
+            Id: 'notice-window',
+            Label: 'Notice window closing (60 days)',
+            Hint: 'The renewal-notice deadline falls within 60 days and has not passed',
+            Filter: 'RenewalNoticeDeadline IS NOT NULL ' +
+                'AND RenewalNoticeDeadline >= CAST(GETUTCDATE() AS date) ' +
+                'AND RenewalNoticeDeadline <= DATEADD(day, 60, CAST(GETUTCDATE() AS date))',
+            GoTo: 'renewals',
+            Count: null,
+        },
+        {
+            Id: 'ends-120',
+            Label: 'Ends within 120 days',
+            Hint: 'The quarter-ahead view — renew, re-paper or let expire',
+            Filter: 'DaysToEnd IS NOT NULL AND DaysToEnd BETWEEN 0 AND 120',
+            GoTo: 'renewals',
+            Count: null,
+        },
+        {
+            Id: 'signed-not-started',
+            Label: 'Signed, not yet in force',
+            Hint: 'Executed with a future effective date — nothing to do until the date arrives',
+            Filter: `State = 'Executed'`,
+            GoTo: 'list',
+            Count: null,
+        },
+        {
+            Id: 'modified',
+            Label: 'Modified agreements',
+            Hint: 'Carry at least one recorded deviation from the standard terms',
+            Filter: 'HasModifications = 1',
+            GoTo: 'modifications',
+            Count: null,
+        },
+    ];
+    ngOnInit() {
+        void this.refresh();
+    }
+    Open(tile) {
+        if (tile.GoTo)
+            this.NavigateToPage.emit(tile.GoTo);
+    }
+    /**
+     * Count every tile concurrently.
+     *
+     * `MaxRows: 1` and read `TotalRowCount` — the count comes back without transferring rows. A tile
+     * whose query fails shows an em dash rather than a zero: "we do not know" and "there are none" are
+     * different answers, and showing 0 for the first is the kind of quiet lie a dashboard should never
+     * tell. One shared error line explains it once rather than five times.
+     */
+    async refresh() {
+        const rv = ScopedRunView();
+        let failures = 0;
+        await Promise.all(this.Tiles.map(async (tile) => {
+            try {
+                const result = await rv.RunView({
+                    EntityName: MJC_ENTITIES.Contract,
+                    ExtraFilter: tile.Filter,
+                    MaxRows: 1,
+                });
+                tile.Count = result?.TotalRowCount ?? 0;
+            }
+            catch {
+                tile.Count = null;
+                failures += 1;
+            }
+        }));
+        this.LoadError = failures
+            ? `${failures} of ${this.Tiles.length} counts could not be read — the tiles showing “—” are unknown, not zero.`
+            : null;
+        this.cdr.detectChanges();
+    }
+    static ɵfac = function MJCContractsDashboardPageComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJCContractsDashboardPageComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJCContractsDashboardPageComponent, selectors: [["mjc-contracts-dashboard-page"]], outputs: { NavigateToPage: "NavigateToPage" }, decls: 15, vars: 1, consts: [[1, "mjc-page"], [1, "mjc-page__intro"], [1, "mjc-pills"], ["type", "button", 1, "mjc-pill", 3, "mjc-pill--active", "title", "disabled"], [1, "mjc-empty"], [1, "mjc-card"], [1, "mjc-card__title"], ["type", "button", 1, "mjc-pill", 3, "click", "title", "disabled"], [1, "mjc-pill__count"]], template: function MJCContractsDashboardPageComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵdomElementStart(0, "div", 0)(1, "p", 1);
+            i0.ɵɵtext(2, " What needs a person. Every number below is counted from the same view the worklists read, so this page and those pages cannot disagree. ");
+            i0.ɵɵdomElementEnd();
+            i0.ɵɵdomElementStart(3, "div", 2);
+            i0.ɵɵrepeaterCreate(4, MJCContractsDashboardPageComponent_For_5_Template, 4, 6, "button", 3, _forTrack0);
+            i0.ɵɵdomElementEnd();
+            i0.ɵɵconditionalCreate(6, MJCContractsDashboardPageComponent_Conditional_6_Template, 2, 1, "p", 4);
+            i0.ɵɵdomElementStart(7, "div", 5)(8, "h3", 6);
+            i0.ɵɵtext(9, "What this app is, and is not");
+            i0.ɵɵdomElementEnd();
+            i0.ɵɵdomElementStart(10, "p", 1);
+            i0.ɵɵtext(11, " Contracts is the record of ");
+            i0.ɵɵdomElementStart(12, "strong");
+            i0.ɵɵtext(13, "what we agreed");
+            i0.ɵɵdomElementEnd();
+            i0.ɵɵtext(14, ": the agreement, the standard terms it incorporates, the provisions negotiated away from those terms, and the executed paper. It does not bill and it does not price \u2014 orders does that, and a number here is never a number about money owed. ");
+            i0.ɵɵdomElementEnd()()();
+        } if (rf & 2) {
+            i0.ɵɵadvance(4);
+            i0.ɵɵrepeater(ctx.Tiles);
+            i0.ɵɵadvance(2);
+            i0.ɵɵconditional(ctx.LoadError ? 6 : -1);
+        } }, dependencies: [CommonModule], encapsulation: 2 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJCContractsDashboardPageComponent, [{
+        type: Component,
+        args: [{
+                selector: 'mjc-contracts-dashboard-page',
+                standalone: true,
+                encapsulation: ViewEncapsulation.None,
+                imports: [CommonModule],
+                template: `
+        <div class="mjc-page">
+            <p class="mjc-page__intro">
+                What needs a person. Every number below is counted from the same view the worklists read,
+                so this page and those pages cannot disagree.
+            </p>
+
+            <div class="mjc-pills">
+                @for (tile of Tiles; track tile.Id) {
+                    <button
+                        type="button"
+                        class="mjc-pill"
+                        [class.mjc-pill--active]="tile.Count !== null && tile.Count > 0"
+                        [title]="tile.Hint"
+                        [disabled]="!tile.GoTo"
+                        (click)="Open(tile)">
+                        {{ tile.Label }}
+                        <span class="mjc-pill__count">{{ tile.Count === null ? '—' : tile.Count }}</span>
+                    </button>
+                }
+            </div>
+
+            @if (LoadError) {
+                <p class="mjc-empty">{{ LoadError }}</p>
+            }
+
+            <div class="mjc-card">
+                <h3 class="mjc-card__title">What this app is, and is not</h3>
+                <p class="mjc-page__intro">
+                    Contracts is the record of <strong>what we agreed</strong>: the agreement, the standard
+                    terms it incorporates, the provisions negotiated away from those terms, and the
+                    executed paper. It does not bill and it does not price — orders does that, and a number
+                    here is never a number about money owed.
+                </p>
+            </div>
+        </div>
+    `,
+            }]
+    }], null, { NavigateToPage: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(MJCContractsDashboardPageComponent, { className: "MJCContractsDashboardPageComponent", filePath: "lib/pages/contracts-dashboard.page.ts", lineNumber: 76 }); })();
+//# sourceMappingURL=contracts-dashboard.page.js.map

package/dist/lib/pages/contracts-dashboard.page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts-dashboard.page.js","sourceRoot":"","sources":["../../../src/lib/pages/contracts-dashboard.page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAU,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;;;;;IA4B7B,oCAMyB;IAArB,2NAAS,oBAAU,KAAC;IACpB,YACA;IAAA,kCAA8B;IAAA,YAA4C;IAC9E,AAD8E,oBAAO,EAC5E;;;IANL,+EAAgE;IAEhE,AADA,uCAAmB,2BACI;IAEvB,cACA;IADA,8CACA;IAA8B,eAA4C;IAA5C,uEAA4C;;;IAMlF,+BAAqB;IAAA,YAAe;IAAA,oBAAI;;;IAAnB,cAAe;IAAf,sCAAe;;AAepD,MAAM,OAAO,kCAAkC;IAC1B,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAEjD,uFAAuF;IAC7E,cAAc,GAAG,IAAI,YAAY,EAAU,CAAC;IAE/C,SAAS,GAAkB,IAAI,CAAC;IAEvC;;;;;OAKG;IACI,KAAK,GAAoB;QAC5B;YACI,EAAE,EAAE,mBAAmB;YACvB,KAAK,EAAE,wBAAwB;YAC/B,IAAI,EAAE,8EAA8E;YACpF,MAAM,EAAE,6CAA6C;YACrD,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI;SACd;QACD;YACI,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,iCAAiC;YACxC,IAAI,EAAE,qEAAqE;YAC3E,MAAM,EACF,oCAAoC;gBACpC,0DAA0D;gBAC1D,2EAA2E;YAC/E,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI;SACd;QACD;YACI,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,wDAAwD;YAC9D,MAAM,EAAE,uDAAuD;YAC/D,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI;SACd;QACD;YACI,EAAE,EAAE,oBAAoB;YACxB,KAAK,EAAE,0BAA0B;YACjC,IAAI,EAAE,8EAA8E;YACpF,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,IAAI;SACd;QACD;YACI,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,qBAAqB;YAC5B,IAAI,EAAE,+DAA+D;YACrE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,IAAI;SACd;KACJ,CAAC;IAEK,QAAQ;QACX,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAEM,IAAI,CAAC,IAAmB;QAC3B,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,OAAO;QACjB,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAC3B,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,OAAO,CAAC,GAAG,CACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1B,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC;oBAC5B,UAAU,EAAE,YAAY,CAAC,QAAQ;oBACjC,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,OAAO,EAAE,CAAC;iBACb,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,aAAa,IAAI,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACL,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBAClB,QAAQ,IAAI,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAC,CACL,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,QAAQ;YACrB,CAAC,CAAC,GAAG,QAAQ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,0EAA0E;YAC/G,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;4HAlGQ,kCAAkC;6DAAlC,kCAAkC;YApCnC,AADJ,iCAAsB,WACS;YACvB,yJAEJ;YAAA,oBAAI;YAEJ,iCAAuB;YACnB,wGAWC;YACL,oBAAM;YAEN,kGAAiB;YAKb,AADJ,iCAAsB,YACU;YAAA,4CAA4B;YAAA,oBAAK;YAC7D,gCAA2B;YACvB,6CAA2B;YAAA,kCAAQ;YAAA,+BAAc;YAAA,oBAAS;YAAA,qQAI9D;YAER,AADI,AADI,oBAAI,EACF,EACJ;;YA3BE,eAWC;YAXD,wBAWC;YAGL,eAEC;YAFD,wCAEC;4BAzBC,YAAY;;iFAuCb,kCAAkC;cA3C9C,SAAS;eAAC;gBACP,QAAQ,EAAE,8BAA8B;gBACxC,UAAU,EAAE,IAAI;gBAChB,aAAa,EAAE,iBAAiB,CAAC,IAAI;gBACrC,OAAO,EAAE,CAAC,YAAY,CAAC;gBACvB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoCT;aACJ;;kBAKI,MAAM;;kFAJE,kCAAkC"}

package/dist/lib/pages/modifications.page.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Every recorded deviation, across all contracts.
+ *
+ * WHY THIS IS A PAGE AT ALL. A modification is normally read on its contract, in the editor panel. But
+ * "which clauses do we keep negotiating away?" is a question about the PROVISION, not about any one
+ * contract, and it is the question that tells the business its standard terms need changing. That
+ * question has no home on a contract form.
+ *
+ * It is a rail item under Contracts rather than its own section because it is a way of READING
+ * contracts, not a separate job.
+ *
+ * The grid selects the modification entity's base view, so `Contract`, `ContractTemplateProvision` and
+ * their name columns render as names rather than UUIDs (D-23) — a grid of modification rows showing
+ * three UUIDs would be unreadable, and this is the surface that proves the rule earns its keep.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { OnInit } from '@angular/core';
+import { NavigationService } from '@memberjunction/ng-shared';
+import type { CompositeKey } from '@memberjunction/core';
+import type { RunViewParams } from '@memberjunction/core';
+import * as i0 from "@angular/core";
+/** One provision and how often it has been modified. */
+interface ProvisionTally {
+    ProvisionID: string;
+    Label: string;
+    Count: number;
+}
+export declare class MJCModificationsPageComponent implements OnInit {
+    private readonly cdr;
+    protected readonly navigation: NavigationService;
+    /**
+     * Open the double-clicked record.
+     *
+     * THE GRID DOES NOT NAVIGATE ITSELF. `NavigateOnDoubleClick` only controls whether it EMITS
+     * `Navigate`; acting on it is the HOST's job. Without this, a double-click merely selected the row
+     * — measured in a real browser, where it looked exactly like the grid being broken. Explorer's own
+     * host wires this for generated forms; a page hosting the grid inside a BaseResourceComponent must
+     * do it itself.
+     */
+    OnNavigate(event: {
+        Kind?: string;
+        EntityName?: string;
+        PrimaryKey?: CompositeKey;
+        DefaultValues?: Record<string, unknown>;
+    }): void;
+    Params: RunViewParams | null;
+    TopProvisions: ProvisionTally[];
+    ActiveProvisionID: string | null;
+    /**
+     * Toolbar affordances that actually work, and one that does not.
+     *
+     * ⚠ `showFilterToggle` IS A NO-OP, and this comment used to claim the opposite. It is declared on
+     * `GridToolbarConfig` (`grid-types.ts:249`) and documented in the entity-viewer README, and it is
+     * **read nowhere in MJ** — no template branch renders a filter button. Three sibling hooks are dead
+     * the same way: the `AllowColumnFilters` input stores `_allowColumnFilters` and nothing reads it,
+     * `_filterState` is declared and never touched, and `defaultColDef.filter` is hardcoded `false`, so
+     * AG Grid's per-column filters are off with no input to turn them on. It is left set to `true` here
+     * because it costs nothing and is the flag to keep passing if MJ ever wires it up.
+     *
+     * So the ONLY filtering this page has beyond the pills is `showSearch` — which sets AG Grid's
+     * `quickFilterText`, a client-side substring match over the rows already loaded. It is not
+     * structured and not server-side. Filtering by date range / category / derived State needs a real
+     * filter popover (see `design-docs/ui-design/mockups-v2/renewal-watchlist.html`), which is ours to
+     * build; the pills stay regardless, because they encode the QUESTIONS people ask rather than
+     * predicates a user would assemble by hand.
+     */
+    readonly GridToolbar: {
+        showSearch: boolean;
+        showFilterToggle: boolean;
+        showColumnChooser: boolean;
+        showRefresh: boolean;
+        showExport: boolean;
+        showRowCount: boolean;
+    };
+    ngOnInit(): void;
+    /** Clicking the active provision clears the filter — the way back to everything. */
+    FilterByProvision(provisionID: string): void;
+    private rebuild;
+    /**
+     * Count modifications per provision, client-side.
+     *
+     * `RunView` has no GROUP BY, so this reads the rows and tallies them in memory. That is honest at
+     * this scale — a modification is a rare, human-authored record, so the whole table is hundreds of
+     * rows for years — and it avoids adding an entity or a stored procedure for a single panel. If it
+     * ever grows past a few thousand, the right answer is an MJ Query with real SQL, not a bigger loop
+     * here; that swap is why the tally is isolated in this method.
+     *
+     * Failure is swallowed to an empty list: the panel is an aid, and the grid below it is the page.
+     */
+    private loadTally;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCModificationsPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCModificationsPageComponent, "mjc-modifications-page", never, {}, {}, never, never, true, never>;
+}
+export {};
+//# sourceMappingURL=modifications.page.d.ts.map

package/dist/lib/pages/modifications.page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifications.page.d.ts","sourceRoot":"","sources":["../../../src/lib/pages/modifications.page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAgC,MAAM,EAA6B,MAAM,eAAe,CAAC;AAEhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;;AAM1D,wDAAwD;AACxD,UAAU,cAAc;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBA6Ca,6BAA8B,YAAW,MAAM;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,SAAS,CAAC,QAAQ,CAAC,UAAU,oBAA6B;IAE1D;;;;;;;;OAQG;IACI,UAAU,CAAC,KAAK,EAAE;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,YAAY,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC3C,GAAG,IAAI;IAsBD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IACpC,aAAa,EAAE,cAAc,EAAE,CAAM;IACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAgB,WAAW;;;;;;;MAOzB;IAGK,QAAQ,IAAI,IAAI;IAKvB,oFAAoF;IAC7E,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,CAAC,OAAO;IASf;;;;;;;;;;OAUG;YACW,SAAS;yCAvGd,6BAA6B;2CAA7B,6BAA6B;CAmIzC"}

package/dist/lib/pages/modifications.page.js

@@ -0,0 +1,243 @@
+/**
+ * @fileoverview Every recorded deviation, across all contracts.
+ *
+ * WHY THIS IS A PAGE AT ALL. A modification is normally read on its contract, in the editor panel. But
+ * "which clauses do we keep negotiating away?" is a question about the PROVISION, not about any one
+ * contract, and it is the question that tells the business its standard terms need changing. That
+ * question has no home on a contract form.
+ *
+ * It is a rail item under Contracts rather than its own section because it is a way of READING
+ * contracts, not a separate job.
+ *
+ * The grid selects the modification entity's base view, so `Contract`, `ContractTemplateProvision` and
+ * their name columns render as names rather than UUIDs (D-23) — a grid of modification rows showing
+ * three UUIDs would be unreadable, and this is the surface that proves the rule earns its keep.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { ChangeDetectorRef, Component, ViewEncapsulation, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { NavigationService } from '@memberjunction/ng-shared';
+import { BaseFormsModule } from '@memberjunction/ng-base-forms';
+import { MJC_ENTITIES } from '../data/entity-names';
+import { ScopedRunView } from '../data/provider';
+import { MJCFkNavigateDirective } from '../directives/fk-navigate.directive';
+import * as i0 from "@angular/core";
+import * as i1 from "@memberjunction/ng-base-forms";
+const _forTrack0 = ($index, $item) => $item.ProvisionID;
+function MJCModificationsPageComponent_Conditional_3_For_5_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "button", 8);
+    i0.ɵɵlistener("click", function MJCModificationsPageComponent_Conditional_3_For_5_Template_button_click_0_listener() { const t_r2 = i0.ɵɵrestoreView(_r1).$implicit; const ctx_r2 = i0.ɵɵnextContext(2); return i0.ɵɵresetView(ctx_r2.FilterByProvision(t_r2.ProvisionID)); });
+    i0.ɵɵtext(1);
+    i0.ɵɵelementStart(2, "span", 9);
+    i0.ɵɵtext(3);
+    i0.ɵɵelementEnd()();
+} if (rf & 2) {
+    const t_r2 = ctx.$implicit;
+    const ctx_r2 = i0.ɵɵnextContext(2);
+    i0.ɵɵclassProp("mjc-pill--active", t_r2.ProvisionID === ctx_r2.ActiveProvisionID);
+    i0.ɵɵattribute("aria-pressed", t_r2.ProvisionID === ctx_r2.ActiveProvisionID);
+    i0.ɵɵadvance();
+    i0.ɵɵtextInterpolate1(" ", t_r2.Label, " ");
+    i0.ɵɵadvance(2);
+    i0.ɵɵtextInterpolate(t_r2.Count);
+} }
+function MJCModificationsPageComponent_Conditional_3_Template(rf, ctx) { if (rf & 1) {
+    i0.ɵɵelementStart(0, "div", 2)(1, "h3", 5);
+    i0.ɵɵtext(2, "Most-modified provisions");
+    i0.ɵɵelementEnd();
+    i0.ɵɵelementStart(3, "div", 6);
+    i0.ɵɵrepeaterCreate(4, MJCModificationsPageComponent_Conditional_3_For_5_Template, 4, 5, "button", 7, _forTrack0);
+    i0.ɵɵelementEnd()();
+} if (rf & 2) {
+    const ctx_r2 = i0.ɵɵnextContext();
+    i0.ɵɵadvance(4);
+    i0.ɵɵrepeater(ctx_r2.TopProvisions);
+} }
+export class MJCModificationsPageComponent {
+    cdr = inject(ChangeDetectorRef);
+    navigation = inject(NavigationService);
+    /**
+     * Open the double-clicked record.
+     *
+     * THE GRID DOES NOT NAVIGATE ITSELF. `NavigateOnDoubleClick` only controls whether it EMITS
+     * `Navigate`; acting on it is the HOST's job. Without this, a double-click merely selected the row
+     * — measured in a real browser, where it looked exactly like the grid being broken. Explorer's own
+     * host wires this for generated forms; a page hosting the grid inside a BaseResourceComponent must
+     * do it itself.
+     */
+    OnNavigate(event) {
+        if (!event?.EntityName)
+            return;
+        if (event.Kind === 'record' && event.PrimaryKey) {
+            this.navigation.OpenEntityRecord(event.EntityName, event.PrimaryKey);
+            return;
+        }
+        if (event.Kind === 'new-record') {
+            // TWO kinds, and missing this one meant the toolbar's New button did NOTHING on every grid
+            // page — found in the browser, after the double-click bug had already taught me the same
+            // lesson about this component. Handling only 'record' silently dropped it.
+            //
+            // ⚠ `event.DefaultValues` is DISCARDED here, and it has nowhere to go: NavigationOptions
+            // carries no default-values field, so `OpenNewEntityRecord` cannot pre-populate. Harmless on
+            // these pages (nothing sets NewRecordValues), but it means the Organization agreements
+            // panel's pre-linking to the customer will NOT survive a New click routed through here —
+            // that panel needs its own affordance, or MJ needs the option. Written down rather than
+            // discovered later as "New forgets the customer".
+            this.navigation.OpenNewEntityRecord(event.EntityName);
+        }
+    }
+    Params = null;
+    TopProvisions = [];
+    ActiveProvisionID = null;
+    /**
+     * Toolbar affordances that actually work, and one that does not.
+     *
+     * ⚠ `showFilterToggle` IS A NO-OP, and this comment used to claim the opposite. It is declared on
+     * `GridToolbarConfig` (`grid-types.ts:249`) and documented in the entity-viewer README, and it is
+     * **read nowhere in MJ** — no template branch renders a filter button. Three sibling hooks are dead
+     * the same way: the `AllowColumnFilters` input stores `_allowColumnFilters` and nothing reads it,
+     * `_filterState` is declared and never touched, and `defaultColDef.filter` is hardcoded `false`, so
+     * AG Grid's per-column filters are off with no input to turn them on. It is left set to `true` here
+     * because it costs nothing and is the flag to keep passing if MJ ever wires it up.
+     *
+     * So the ONLY filtering this page has beyond the pills is `showSearch` — which sets AG Grid's
+     * `quickFilterText`, a client-side substring match over the rows already loaded. It is not
+     * structured and not server-side. Filtering by date range / category / derived State needs a real
+     * filter popover (see `design-docs/ui-design/mockups-v2/renewal-watchlist.html`), which is ours to
+     * build; the pills stay regardless, because they encode the QUESTIONS people ask rather than
+     * predicates a user would assemble by hand.
+     */
+    GridToolbar = {
+        showSearch: true,
+        showFilterToggle: true,
+        showColumnChooser: true,
+        showRefresh: true,
+        showExport: true,
+        showRowCount: true,
+    };
+    ngOnInit() {
+        this.rebuild();
+        void this.loadTally();
+    }
+    /** Clicking the active provision clears the filter — the way back to everything. */
+    FilterByProvision(provisionID) {
+        this.ActiveProvisionID = this.ActiveProvisionID === provisionID ? null : provisionID;
+        this.rebuild();
+    }
+    rebuild() {
+        this.Params = {
+            EntityName: MJC_ENTITIES.ContractTemplateModification,
+            ExtraFilter: this.ActiveProvisionID ? `ContractTemplateProvisionID = '${this.ActiveProvisionID}'` : '',
+            OrderBy: '__mj_CreatedAt DESC',
+        };
+        this.cdr.detectChanges();
+    }
+    /**
+     * Count modifications per provision, client-side.
+     *
+     * `RunView` has no GROUP BY, so this reads the rows and tallies them in memory. That is honest at
+     * this scale — a modification is a rare, human-authored record, so the whole table is hundreds of
+     * rows for years — and it avoids adding an entity or a stored procedure for a single panel. If it
+     * ever grows past a few thousand, the right answer is an MJ Query with real SQL, not a bigger loop
+     * here; that swap is why the tally is isolated in this method.
+     *
+     * Failure is swallowed to an empty list: the panel is an aid, and the grid below it is the page.
+     */
+    async loadTally() {
+        try {
+            const result = await ScopedRunView().RunView({
+                EntityName: MJC_ENTITIES.ContractTemplateModification,
+                // The base view already joins the provision's name columns (D-23), so no second read.
+                ResultType: 'simple',
+            });
+            const rows = (result?.Results ?? []);
+            const counts = new Map();
+            for (const row of rows) {
+                const id = String(row['ContractTemplateProvisionID'] ?? '');
+                if (!id)
+                    continue;
+                const existing = counts.get(id);
+                if (existing) {
+                    existing.Count += 1;
+                    continue;
+                }
+                // The joined name column is the provision's name field; fall back to the number so a
+                // tally never shows a blank pill.
+                const label = String(row['ContractTemplateProvision'] ?? row['ProvisionNumber'] ?? 'provision');
+                counts.set(id, { ProvisionID: id, Label: label, Count: 1 });
+            }
+            this.TopProvisions = [...counts.values()].sort((a, b) => b.Count - a.Count).slice(0, 8);
+        }
+        catch {
+            this.TopProvisions = [];
+        }
+        this.cdr.detectChanges();
+    }
+    static ɵfac = function MJCModificationsPageComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJCModificationsPageComponent)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJCModificationsPageComponent, selectors: [["mjc-modifications-page"]], decls: 6, vars: 5, consts: [[1, "mjc-page", "mjc-page--grid"], [1, "mjc-page__intro"], [1, "mjc-card"], [1, "mjc-grid-fill"], ["mjcFkNavigate", "", 3, "Navigate", "Params", "ShowToolbar", "ToolbarConfig", "NavigateOnDoubleClick"], [1, "mjc-card__title"], [1, "mjc-pills"], ["type", "button", 1, "mjc-pill", 3, "mjc-pill--active"], ["type", "button", 1, "mjc-pill", 3, "click"], [1, "mjc-pill__count"]], template: function MJCModificationsPageComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div", 0)(1, "p", 1);
+            i0.ɵɵtext(2, " Every deviation from standard terms that has been recorded, across all contracts. The clauses at the top are the ones the business negotiates away most often \u2014 which is the signal that a standard term needs revisiting rather than re-negotiating. ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵconditionalCreate(3, MJCModificationsPageComponent_Conditional_3_Template, 6, 0, "div", 2);
+            i0.ɵɵelementStart(4, "div", 3)(5, "mj-explorer-entity-data-grid", 4);
+            i0.ɵɵlistener("Navigate", function MJCModificationsPageComponent_Template_mj_explorer_entity_data_grid_Navigate_5_listener($event) { return ctx.OnNavigate($event); });
+            i0.ɵɵelementEnd()()();
+        } if (rf & 2) {
+            i0.ɵɵadvance(3);
+            i0.ɵɵconditional(ctx.TopProvisions.length ? 3 : -1);
+            i0.ɵɵadvance(2);
+            i0.ɵɵproperty("Params", ctx.Params)("ShowToolbar", true)("ToolbarConfig", ctx.GridToolbar)("NavigateOnDoubleClick", true);
+        } }, dependencies: [CommonModule, BaseFormsModule, i1.ExplorerEntityDataGridComponent, MJCFkNavigateDirective], encapsulation: 2 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJCModificationsPageComponent, [{
+        type: Component,
+        args: [{
+                selector: 'mjc-modifications-page',
+                standalone: true,
+                encapsulation: ViewEncapsulation.None,
+                imports: [CommonModule, BaseFormsModule, MJCFkNavigateDirective],
+                template: `
+        <div class="mjc-page mjc-page--grid">
+            <p class="mjc-page__intro">
+                Every deviation from standard terms that has been recorded, across all contracts. The
+                clauses at the top are the ones the business negotiates away most often — which is the
+                signal that a standard term needs revisiting rather than re-negotiating.
+            </p>
+
+            @if (TopProvisions.length) {
+                <div class="mjc-card">
+                    <h3 class="mjc-card__title">Most-modified provisions</h3>
+                    <div class="mjc-pills">
+                        @for (t of TopProvisions; track t.ProvisionID) {
+                            <button
+                                type="button"
+                                class="mjc-pill"
+                                [class.mjc-pill--active]="t.ProvisionID === ActiveProvisionID"
+                                [attr.aria-pressed]="t.ProvisionID === ActiveProvisionID"
+                                (click)="FilterByProvision(t.ProvisionID)">
+                                {{ t.Label }}
+                                <span class="mjc-pill__count">{{ t.Count }}</span>
+                            </button>
+                        }
+                    </div>
+                </div>
+            }
+
+            <div class="mjc-grid-fill">
+
+                <mj-explorer-entity-data-grid mjcFkNavigate
+                    [Params]="Params"
+                    [ShowToolbar]="true"
+                    [ToolbarConfig]="GridToolbar"
+                    [NavigateOnDoubleClick]="true"
+                    (Navigate)="OnNavigate($event)" />
+
+            </div>
+        </div>
+    `,
+            }]
+    }], null, null); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(MJCModificationsPageComponent, { className: "MJCModificationsPageComponent", filePath: "lib/pages/modifications.page.ts", lineNumber: 80 }); })();
+//# sourceMappingURL=modifications.page.js.map

package/dist/lib/pages/modifications.page.js.map

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