@mj-biz-apps/contracts-ng 0.1.0

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

@@ -0,0 +1,240 @@
+/**
+ * @fileoverview Configuration — the small vocabularies every contract inherits (item 6).
+ *
+ * MOSTLY FREE, AND THAT IS THE DESIGN. The generated entity forms already cover creating and editing a
+ * contract type or a template type; what was missing was a place to FIND them. So these pages are
+ * grids over the generated base views plus one sentence of context each — no custom form, no bespoke
+ * editor. Item 6's "done" is "confirm each generated form opens clean", not "build CRUD".
+ *
+ * The sentences matter more than they look. `RequiresExecutedDocument` is the only rule column in the
+ * whole app, and a business user retiring a type by flipping `Status` needs to know old contracts keep
+ * resolving. Neither fact is visible from a grid of columns.
+ *
+ * @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 { MJCFkNavigateDirective } from '../directives/fk-navigate.directive';
+import * as i0 from "@angular/core";
+import * as i1 from "@memberjunction/ng-base-forms";
+/** Shared skeleton: one intro sentence, one stock grid. */
+class MJCConfigPageBase {
+    cdr = inject(ChangeDetectorRef);
+    navigation = inject(NavigationService);
+    Params = 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,
+    };
+    /**
+     * 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);
+        }
+    }
+    get orderBy() {
+        return 'Name ASC';
+    }
+    ngOnInit() {
+        this.Params = { EntityName: this.entityName, OrderBy: this.orderBy };
+        this.cdr.detectChanges();
+    }
+    static ɵfac = function MJCConfigPageBase_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJCConfigPageBase)(); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJCConfigPageBase, selectors: [["ng-component"]], decls: 0, vars: 0, template: function MJCConfigPageBase_Template(rf, ctx) { }, encapsulation: 2 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJCConfigPageBase, [{
+        type: Component,
+        args: [{ template: '' }]
+    }], null, null); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(MJCConfigPageBase, { className: "MJCConfigPageBase", filePath: "lib/pages/configuration.page.ts", lineNumber: 27 }); })();
+const CONFIG_TEMPLATE = `
+    <div class="mjc-page mjc-page--grid">
+        <p class="mjc-page__intro"><ng-content /></p>
+        <div class="mjc-grid-fill">
+            <mj-explorer-entity-data-grid mjcFkNavigate [Params]="Params" [ShowToolbar]="true" [ToolbarConfig]="GridToolbar" [NavigateOnDoubleClick]="true"
+                (Navigate)="OnNavigate($event)" />
+        </div>
+    </div>
+`;
+export class MJCContractTypesPageComponent extends MJCConfigPageBase {
+    get entityName() {
+        return MJC_ENTITIES.ContractType;
+    }
+    static ɵfac = /*@__PURE__*/ (() => { let ɵMJCContractTypesPageComponent_BaseFactory; return function MJCContractTypesPageComponent_Factory(__ngFactoryType__) { return (ɵMJCContractTypesPageComponent_BaseFactory || (ɵMJCContractTypesPageComponent_BaseFactory = i0.ɵɵgetInheritedFactory(MJCContractTypesPageComponent)))(__ngFactoryType__ || MJCContractTypesPageComponent); }; })();
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJCContractTypesPageComponent, selectors: [["mjc-contract-types-page"]], features: [i0.ɵɵInheritDefinitionFeature], decls: 28, vars: 4, consts: [[1, "mjc-page", "mjc-page--grid"], [1, "mjc-page__intro"], [1, "mjc-grid-fill"], ["mjcFkNavigate", "", 3, "Navigate", "Params", "ShowToolbar", "ToolbarConfig", "NavigateOnDoubleClick"]], template: function MJCContractTypesPageComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div", 0)(1, "p", 1);
+            i0.ɵɵtext(2, " What kind of document a contract is. Two columns here carry rules, and the rest is labelling. ");
+            i0.ɵɵelementStart(3, "strong");
+            i0.ɵɵtext(4, "Requires Executed Document");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(5, " is what makes a contract appear on the ");
+            i0.ɵɵelementStart(6, "em");
+            i0.ɵɵtext(7, "Awaiting documents");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(8, " worklist, so a Payment Link \u2014 where nobody signs anything \u2014 never reports as missing paper. ");
+            i0.ɵɵelementStart(9, "strong");
+            i0.ɵɵtext(10, "Parent status requirement");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(11, " decides whether a contract of this type must name the agreement it changes (");
+            i0.ɵɵelementStart(12, "em");
+            i0.ɵɵtext(13, "Required");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(14, " \u2014 a Change Order amends something, so it has to say what), must not (");
+            i0.ɵɵelementStart(15, "em");
+            i0.ɵɵtext(16, "Prohibited");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(17, " \u2014 it stands on its own), or may do either when left blank. Both are enforced when a contract is saved, and neither is decided from the type's NAME. ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(18, "p", 1);
+            i0.ɵɵtext(19, " Retire a type by setting its ");
+            i0.ɵɵelementStart(20, "strong");
+            i0.ɵɵtext(21, "Status");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(22, " to ");
+            i0.ɵɵelementStart(23, "em");
+            i0.ɵɵtext(24, "Inactive");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(25, " rather than deleting it: it stops being offered for new contracts, and every contract already referencing it keeps resolving. ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(26, "div", 2)(27, "mj-explorer-entity-data-grid", 3);
+            i0.ɵɵlistener("Navigate", function MJCContractTypesPageComponent_Template_mj_explorer_entity_data_grid_Navigate_27_listener($event) { return ctx.OnNavigate($event); });
+            i0.ɵɵelementEnd()()();
+        } if (rf & 2) {
+            i0.ɵɵadvance(27);
+            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(MJCContractTypesPageComponent, [{
+        type: Component,
+        args: [{
+                selector: 'mjc-contract-types-page',
+                standalone: true,
+                encapsulation: ViewEncapsulation.None,
+                imports: [CommonModule, BaseFormsModule, MJCFkNavigateDirective],
+                template: `
+        <div class="mjc-page mjc-page--grid">
+            <p class="mjc-page__intro">
+                What kind of document a contract is. Two columns here carry rules, and the rest is
+                labelling. <strong>Requires Executed Document</strong> is what makes a contract appear on
+                the <em>Awaiting documents</em> worklist, so a Payment Link — where nobody signs anything
+                — never reports as missing paper. <strong>Parent status requirement</strong> decides
+                whether a contract of this type must name the agreement it changes
+                (<em>Required</em> — a Change Order amends something, so it has to say what), must not
+                (<em>Prohibited</em> — it stands on its own), or may do either when left blank. Both are
+                enforced when a contract is saved, and neither is decided from the type's NAME.
+            </p>
+            <p class="mjc-page__intro">
+                Retire a type by setting its <strong>Status</strong> to <em>Inactive</em> rather than
+                deleting it: it stops being offered for new contracts, and every contract already
+                referencing it keeps resolving.
+            </p>
+            <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(MJCContractTypesPageComponent, { className: "MJCContractTypesPageComponent", filePath: "lib/pages/configuration.page.ts", lineNumber: 146 }); })();
+export class MJCTemplateTypesPageComponent extends MJCConfigPageBase {
+    get entityName() {
+        return MJC_ENTITIES.ContractTemplateType;
+    }
+    static ɵfac = /*@__PURE__*/ (() => { let ɵMJCTemplateTypesPageComponent_BaseFactory; return function MJCTemplateTypesPageComponent_Factory(__ngFactoryType__) { return (ɵMJCTemplateTypesPageComponent_BaseFactory || (ɵMJCTemplateTypesPageComponent_BaseFactory = i0.ɵɵgetInheritedFactory(MJCTemplateTypesPageComponent)))(__ngFactoryType__ || MJCTemplateTypesPageComponent); }; })();
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: MJCTemplateTypesPageComponent, selectors: [["mjc-template-types-page"]], features: [i0.ɵɵInheritDefinitionFeature], decls: 11, vars: 4, consts: [[1, "mjc-page", "mjc-page--grid"], [1, "mjc-page__intro"], [1, "mjc-grid-fill"], ["mjcFkNavigate", "", 3, "Navigate", "Params", "ShowToolbar", "ToolbarConfig", "NavigateOnDoubleClick"]], template: function MJCTemplateTypesPageComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div", 0)(1, "p", 1);
+            i0.ɵɵtext(2, " What kind of standard-terms document a version belongs to. Two rows today, and only one has a real template behind it: ");
+            i0.ɵɵelementStart(3, "strong");
+            i0.ɵɵtext(4, "Master Agreement");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(5, " is the versioned, numbered-provision document every Order Form incorporates. ");
+            i0.ɵɵelementStart(6, "strong");
+            i0.ɵɵtext(7, "Statement of Work");
+            i0.ɵɵelementEnd();
+            i0.ɵɵtext(8, " exists so the type is available \u2014 the business has standard SOW language but does not version it, so no template is registered against it. That absence is a fact about the business, not a gap in the data. ");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(9, "div", 2)(10, "mj-explorer-entity-data-grid", 3);
+            i0.ɵɵlistener("Navigate", function MJCTemplateTypesPageComponent_Template_mj_explorer_entity_data_grid_Navigate_10_listener($event) { return ctx.OnNavigate($event); });
+            i0.ɵɵelementEnd()()();
+        } if (rf & 2) {
+            i0.ɵɵadvance(10);
+            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(MJCTemplateTypesPageComponent, [{
+        type: Component,
+        args: [{
+                selector: 'mjc-template-types-page',
+                standalone: true,
+                encapsulation: ViewEncapsulation.None,
+                imports: [CommonModule, BaseFormsModule, MJCFkNavigateDirective],
+                template: `
+        <div class="mjc-page mjc-page--grid">
+            <p class="mjc-page__intro">
+                What kind of standard-terms document a version belongs to. Two rows today, and only one
+                has a real template behind it: <strong>Master Agreement</strong> is the versioned,
+                numbered-provision document every Order Form incorporates.
+                <strong>Statement of Work</strong> exists so the type is available — the business has
+                standard SOW language but does not version it, so no template is registered against it.
+                That absence is a fact about the business, not a gap in the data.
+            </p>
+            <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(MJCTemplateTypesPageComponent, { className: "MJCTemplateTypesPageComponent", filePath: "lib/pages/configuration.page.ts", lineNumber: 174 }); })();
+//# sourceMappingURL=configuration.page.js.map

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

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

package/dist/lib/pages/contract-grid.page.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview The contract list, and the two worklists that are the same list with a filter.
+ *
+ * ONE BASE, THREE PAGES. "All contracts", "Renewals & expiry" and "Awaiting documents" are the same
+ * grid over the same view with different `ExtraFilter`s and different default pills. Three separate
+ * implementations would be three places to fix a column, and they would drift — this is exactly the
+ * 2-to-4-locations-of-similar-logic case the workspace guide says to unify, parameterised by context
+ * (Template Method: shared skeleton, overridden hooks).
+ *
+ * THE GRID IS MJ'S OWN (`mj-explorer-entity-data-grid`), not a bespoke table. D-21 ruled the watchlist
+ * deliberately thin — stock grid plus filter pills, no saved views — and D-23 requires selecting the
+ * BASE VIEW so foreign keys render as names. Both are satisfied by construction here: `vwContracts` is
+ * what the entity's `BaseView` resolves to, and it already carries `ContractType`, `Company`,
+ * `CustomerOrganization`, `ContractTemplate` and `ParentContract` as joined name columns, plus the six
+ * derived columns from the layered wrapper. Showing a UUID would take extra work.
+ *
+ * WHY THE FILTERS ARE VIEW COLUMNS AND NOT DATE ARITHMETIC IN TYPESCRIPT. `RenewalNoticeDeadline`,
+ * `DaysToEnd`, `IsAwaitingDocument` and `State` are computed in the wrapper view (item 12), so a filter
+ * here is a comparison against a column rather than a re-derivation. That is the whole payoff of
+ * deriving them in SQL: the rule renders once, and a worklist cannot disagree with a form.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { ChangeDetectorRef, 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 filter pill: a label, the SQL it contributes, and a live count. */
+export interface MJCFilterPill {
+    Id: string;
+    Label: string;
+    /** SQL fragment ANDed into the grid's ExtraFilter. Empty means "no restriction". */
+    Filter: string;
+    /** Populated by a count query; omitted from the UI when zero or unknown. */
+    Count?: number;
+    /** One line explaining what the pill means, for its title attribute. */
+    Hint?: string;
+}
+/**
+ * Shared skeleton. A concrete page supplies its title, its pills, and which pill starts active.
+ *
+ * `standalone: false` is wrong for these — they are created dynamically by the section via
+ * `createComponent`, so they must be standalone and self-sufficient in their imports.
+ */
+export declare abstract class MJCContractGridPageBase implements OnInit {
+    protected readonly cdr: ChangeDetectorRef;
+    protected readonly navigation: NavigationService;
+    /** Pills for this page, in display order. The first is the default. */
+    Pills: MJCFilterPill[];
+    /** Which pill is active. Null means "no pill" — the unfiltered list. */
+    ActivePillId: string | null;
+    /** What the grid runs. Rebuilt whenever the active pill changes. */
+    Params: RunViewParams | null;
+    IsLoading: boolean;
+    LoadError: string | null;
+    /** Free-text restriction the user typed, ANDed with the pill. */
+    SearchText: string;
+    /**
+     * 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;
+    };
+    /**
+     * 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;
+    protected abstract get pills(): MJCFilterPill[];
+    /**
+     * A restriction that applies to EVERY pill on this page — what makes a worklist a worklist.
+     *
+     * Kept separate from the pills rather than baked into each one: the page-level scope is the
+     * page's identity ("contracts awaiting documents"), while a pill narrows within it. Merging them
+     * would mean repeating the scope in every pill and being able to forget it in one.
+     */
+    protected get pageFilter(): string;
+    ngOnInit(): void;
+    /** Pill click. Re-selecting the active pill CLEARS it, which is how a user gets back to unfiltered. */
+    SelectPill(id: string): void;
+    ApplySearch(text: string): void;
+    /** Compose page scope + active pill + search into one ExtraFilter. */
+    protected rebuild(): void;
+    /** Default ordering. Worklists override — a worklist sorts by urgency, not by identity. */
+    protected get orderBy(): string;
+    /**
+     * Count each pill, so the rail and the pills agree about how much work there is.
+     *
+     * One `RunView` per pill with `MaxRows: 1` — the count comes from `TotalRowCount`, so nothing is
+     * transferred. Failures are swallowed to a null count rather than surfaced: a missing badge is a
+     * cosmetic loss, and a page that refuses to render because a count query failed is not.
+     */
+    protected refreshCounts(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractGridPageBase, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractGridPageBase, "ng-component", never, {}, {}, never, never, true, never>;
+}
+/** Every contract, newest number first. */
+export declare class MJCAllContractsPageComponent extends MJCContractGridPageBase {
+    Intro: string;
+    protected get pills(): MJCFilterPill[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCAllContractsPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCAllContractsPageComponent, "mjc-all-contracts-page", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Renewals & expiry — item 12's screen.
+ *
+ * Sorted by `RenewalNoticeDeadline`, not `EndDate`, because the date that matters is when our chance to
+ * act ends rather than when the contract does. Nulls last: a contract with no notice period recorded
+ * has no deadline to miss, so it should not head a list of deadlines.
+ *
+ * The four defaults are exactly D-21's, and there is deliberately no Save-as-view: users drive filters
+ * in-session, and persisting custom watchlists is phase 2 or never.
+ */
+export declare class MJCRenewalsPageComponent extends MJCContractGridPageBase {
+    Intro: string;
+    /** Only live agreements can be renewed or allowed to expire. */
+    protected get pageFilter(): string;
+    protected get orderBy(): string;
+    protected get pills(): MJCFilterPill[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCRenewalsPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCRenewalsPageComponent, "mjc-renewals-page", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Awaiting documents — the other half of item 12's work group.
+ *
+ * `IsAwaitingDocument` is derived (the contract TYPE expects paper and no file is linked), which is why
+ * this page is a filter rather than a stored worklist: a Payment Link never appears here, because its
+ * type says paper was never expected. Nothing has to remember to clear a flag.
+ */
+export declare class MJCAwaitingDocumentsPageComponent extends MJCContractGridPageBase {
+    Intro: string;
+    protected get pageFilter(): string;
+    protected get orderBy(): string;
+    protected get pills(): MJCFilterPill[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCAwaitingDocumentsPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCAwaitingDocumentsPageComponent, "mjc-awaiting-documents-page", never, {}, {}, never, never, true, never>;
+}
+//# sourceMappingURL=contract-grid.page.d.ts.map

package/dist/lib/pages/contract-grid.page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-grid.page.d.ts","sourceRoot":"","sources":["../../../src/lib/pages/contract-grid.page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,iBAAiB,EAAa,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,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,8BACsB,uBAAwB,YAAW,MAAM;IAC3D,SAAS,CAAC,QAAQ,CAAC,GAAG,oBAA6B;IACnD,SAAS,CAAC,QAAQ,CAAC,UAAU,oBAA6B;IAG1D,uEAAuE;IAChE,KAAK,EAAE,aAAa,EAAE,CAAM;IAEnC,wEAAwE;IACjE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C,oEAAoE;IAC7D,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;IAEpC,SAAS,UAAS;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEvC,iEAAiE;IAC1D,UAAU,SAAM;IAEvB;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAgB,WAAW;;;;;;;MAOzB;IAIF;;;;;;;;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;IAwBR,SAAS,CAAC,QAAQ,KAAK,KAAK,IAAI,aAAa,EAAE,CAAC;IAEhD;;;;;;OAMG;IACH,SAAS,KAAK,UAAU,IAAI,MAAM,CAEjC;IAEM,QAAQ,IAAI,IAAI;IAOvB,uGAAuG;IAChG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtC,sEAAsE;IACtE,SAAS,CAAC,OAAO,IAAI,IAAI;IA0BzB,2FAA2F;IAC3F,SAAS,KAAK,OAAO,IAAI,MAAM,CAE9B;IAED;;;;;;OAMG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;yCA7J5B,uBAAuB;2CAAvB,uBAAuB;CAgL5C;AAqCD,2CAA2C;AAC3C,qBAOa,4BAA6B,SAAQ,uBAAuB;IAC9D,KAAK,SAA+D;IAE3E,SAAS,KAAK,KAAK,IAAI,aAAa,EAAE,CAQrC;yCAXQ,4BAA4B;2CAA5B,4BAA4B;CAYxC;AAED;;;;;;;;;GASG;AACH,qBAOa,wBAAyB,SAAQ,uBAAuB;IAC1D,KAAK,SAE2C;IAEvD,gEAAgE;IAChE,cAAuB,UAAU,IAAI,MAAM,CAE1C;IAED,cAAuB,OAAO,IAAI,MAAM,CAIvC;IAED,SAAS,KAAK,KAAK,IAAI,aAAa,EAAE,CAuBrC;yCAvCQ,wBAAwB;2CAAxB,wBAAwB;CAwCpC;AAED;;;;;;GAMG;AACH,qBAOa,iCAAkC,SAAQ,uBAAuB;IACnE,KAAK,SAEiD;IAE7D,cAAuB,UAAU,IAAI,MAAM,CAE1C;IAED,cAAuB,OAAO,IAAI,MAAM,CAGvC;IAED,SAAS,KAAK,KAAK,IAAI,aAAa,EAAE,CAOrC;yCArBQ,iCAAiC;2CAAjC,iCAAiC;CAsB7C"}