@mj-biz-apps/contracts-ng 0.1.0

package/LICENSE

@@ -0,0 +1,183 @@
+Business Source License 1.1
+
+License text copyright (c) 2024 MariaDB plc, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB plc.
+
+-----------------------------------------------------------------------------
+
+Parameters
+
+Licensor:             Blue Cypress, Inc.
+
+Licensed Work:        MemberJunction.
+                      The Licensed Work is (c) 2023-2026 Blue Cypress, Inc.
+
+Additional Use Grant: Subject to the terms of this License, Licensor grants
+                      you the following additional rights to make Production
+                      Use of the Licensed Work.
+
+                      1. Internal Use
+
+                      You may make production use of the Licensed Work for
+                      your own internal business or organizational operations.
+
+                      2. Nonprofit Use
+
+                      If you are a Nonprofit, you may make production use of
+                      the Licensed Work for the operations and activities of
+                      your Organizational Family.
+
+                      3. MemberJunction Certified Program Use
+
+                      If you are authorized by Licensor under the
+                      MemberJunction Certified Program to provide professional
+                      services using the Licensed Work, you may make
+                      production use of the Licensed Work in providing such
+                      professional services to a client, provided that:
+
+                      (a) the Licensed Work is deployed in, and the applicable
+                      production use occurs within, an environment owned,
+                      leased, licensed, subscribed to, or otherwise controlled
+                      by that client; and
+
+                      (b) the production use is for that client's own internal
+                      business or organizational operations or is otherwise
+                      independently permitted to that client under this
+                      Additional Use Grant.
+
+                      4. Definitions Applicable to the Additional Use Grant
+
+                      "Affiliate" means, with respect to a specified Person,
+                      any other Person that directly or indirectly Controls,
+                      is Controlled by, or is under common Control with such
+                      specified Person.
+
+                      "Control" (including the terms "Controls," "Controlled
+                      by," and "under common Control with") means the direct
+                      or indirect possession of the power to direct or cause
+                      the direction of the management and policies of a
+                      Person, whether through ownership of voting interests,
+                      by contract, or otherwise.
+
+                      "Organizational Family" means, with respect to a Person,
+                      (a) such Person and its Affiliates, and (b) any
+                      nonprofit organization, governmental entity, chapter,
+                      division, local affiliate, regional affiliate, state
+                      affiliate, national affiliate, or other entity that is
+                      formally affiliated with such Person through governing
+                      documents, a charter, bylaws, a membership agreement, or
+                      another written organizational instrument, and is
+                      recognized under such documents as part of the same
+                      organizational structure.
+
+                      "Nonprofit" means a Person recognized by the Internal
+                      Revenue Service as exempt from federal income taxation
+                      under Section 501(c)(3), 501(c)(4), 501(c)(5), or
+                      501(c)(6) of the Internal Revenue Code, or a foreign
+                      organization recognized under substantially equivalent
+                      laws.
+
+                      A Person claiming eligibility as a Nonprofit shall, upon
+                      Licensor's reasonable request, provide documentation
+                      reasonably sufficient to demonstrate that it qualifies
+                      as a Nonprofit. If such Person materially misrepresents,
+                      or is unable to demonstrate, its qualification as a
+                      Nonprofit, the rights granted to such Person under
+                      Section 2 of this Additional Use Grant shall terminate.
+
+                      "MemberJunction Certified Program" means Licensor's
+                      then-current program for certifying and authorizing a
+                      Person to provide professional services using the
+                      Licensed Work.
+
+                      "Person" means any individual, corporation, limited
+                      liability company, partnership, association, nonprofit
+                      organization, governmental entity, or other legal or
+                      organizational entity.
+
+Change Date:          Four (4) years from the date the Licensed Work is first
+                      made available.
+
+Change License:       MIT License.
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact Blue Cypress, Inc.
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+-----------------------------------------------------------------------------
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License
+   can be included in a program with software provided under GPL Version 2.0
+   or a later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+-----------------------------------------------------------------------------
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/dist/lib/data/entity-names.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Entity names as constants, in one place.
+ *
+ * MJ addresses entities by NAME as a string — `RunView({ EntityName: '…' })`,
+ * `GetEntityObject('…')`, `@RegisterClass(BaseEntity, '…')`. A typo in one of those does not fail to
+ * compile; it fails at runtime, usually as an empty grid rather than an error, which is the hardest
+ * shape of bug to see. The prefix (`MJ_BizApps_Contracts: `) also comes from `mj.config.cjs`
+ * `NameRulesBySchema`, so it is a convention that could change — in one place it is a rename, scattered
+ * through templates it is an archaeology exercise.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+/** Every entity this app owns. */
+export declare const MJC_ENTITIES: {
+    readonly Contract: "MJ_BizApps_Contracts: Contracts";
+    readonly ContractType: "MJ_BizApps_Contracts: Contract Types";
+    readonly ContractTemplate: "MJ_BizApps_Contracts: Contract Templates";
+    readonly ContractTemplateType: "MJ_BizApps_Contracts: Contract Template Types";
+    readonly ContractTemplateProvision: "MJ_BizApps_Contracts: Contract Template Provisions";
+    readonly ContractTemplateModification: "MJ_BizApps_Contracts: Contract Template Modifications";
+};
+/** Entities in OTHER apps that contracts reads. Named here so a cross-app rename is one edit. */
+export declare const MJC_FOREIGN_ENTITIES: {
+    readonly Organization: "MJ_BizApps_Common: Organizations";
+    readonly Person: "MJ_BizApps_Common: People";
+    /** MJ CORE's Company, not accounting's — verified against __mj.EntityRelationship. */
+    readonly Company: "MJ: Companies";
+};
+//# sourceMappingURL=entity-names.d.ts.map

package/dist/lib/data/entity-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-names.d.ts","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,oBAAoB;;;IAG7B,sFAAsF;;CAEhF,CAAC"}

package/dist/lib/data/entity-names.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Entity names as constants, in one place.
+ *
+ * MJ addresses entities by NAME as a string — `RunView({ EntityName: '…' })`,
+ * `GetEntityObject('…')`, `@RegisterClass(BaseEntity, '…')`. A typo in one of those does not fail to
+ * compile; it fails at runtime, usually as an empty grid rather than an error, which is the hardest
+ * shape of bug to see. The prefix (`MJ_BizApps_Contracts: `) also comes from `mj.config.cjs`
+ * `NameRulesBySchema`, so it is a convention that could change — in one place it is a rename, scattered
+ * through templates it is an archaeology exercise.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+/** Every entity this app owns. */
+export const MJC_ENTITIES = {
+    Contract: 'MJ_BizApps_Contracts: Contracts',
+    ContractType: 'MJ_BizApps_Contracts: Contract Types',
+    ContractTemplate: 'MJ_BizApps_Contracts: Contract Templates',
+    ContractTemplateType: 'MJ_BizApps_Contracts: Contract Template Types',
+    ContractTemplateProvision: 'MJ_BizApps_Contracts: Contract Template Provisions',
+    ContractTemplateModification: 'MJ_BizApps_Contracts: Contract Template Modifications',
+};
+/** Entities in OTHER apps that contracts reads. Named here so a cross-app rename is one edit. */
+export const MJC_FOREIGN_ENTITIES = {
+    Organization: 'MJ_BizApps_Common: Organizations',
+    Person: 'MJ_BizApps_Common: People',
+    /** MJ CORE's Company, not accounting's — verified against __mj.EntityRelationship. */
+    Company: 'MJ: Companies',
+};
+//# sourceMappingURL=entity-names.js.map

package/dist/lib/data/entity-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-names.js","sourceRoot":"","sources":["../../../src/lib/data/entity-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,QAAQ,EAAE,iCAAiC;IAC3C,YAAY,EAAE,sCAAsC;IACpD,gBAAgB,EAAE,0CAA0C;IAC5D,oBAAoB,EAAE,+CAA+C;IACrE,yBAAyB,EAAE,oDAAoD;IAC/E,4BAA4B,EAAE,uDAAuD;CAC/E,CAAC;AAEX,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,YAAY,EAAE,kCAAkC;IAChD,MAAM,EAAE,2BAA2B;IACnC,sFAAsF;IACtF,OAAO,EAAE,eAAe;CAClB,CAAC"}

package/dist/lib/data/provider.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Provider scoping, stated once (D-25).
+ *
+ * THE RULE: every data access is provider-scoped. A bare `new RunView()` / `new Metadata()` uses the
+ * global provider, which is correct only by coincidence — in a host with more than one provider (a
+ * different connection, a different user's context, a server-side call) it silently reads the wrong
+ * database, and the failure is a wrong ANSWER rather than an error.
+ *
+ * Where each context gets its provider from:
+ *
+ *   · server subclasses / engines  → `this.ProviderToUse` (BaseEntity supplies it)
+ *   · form panels                  → `FormComponent.ProviderToUse` — the host form's, so a panel reads
+ *                                    from the same place the record it is showing came from
+ *   · standalone editors           → an `@Input() Provider`, falling back to `Metadata.Provider`
+ *   · anything else                → `RunView.FromMetadataProvider(Metadata.Provider)`
+ *
+ * The helpers below exist so the last two are one call rather than a repeated expression: a pattern
+ * copied into fifteen places is a pattern that is wrong in one of them.
+ *
+ * MJ's own code uses `RunView.FromMetadataProvider(this.ProviderToUse)` in exactly this way
+ * (`base-form-component.ts`), so this is the platform's idiom, not ours.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { Metadata, RunView, type IMetadataProvider } from '@memberjunction/core';
+/**
+ * A `RunView` scoped to `provider`, or to the ambient provider when none is supplied.
+ *
+ * The fallback is deliberate and is NOT the same thing as a bare `new RunView()`: it names the
+ * provider it is falling back to, so the choice is visible at the call site and a reviewer can see
+ * whether a scoped one was available.
+ */
+export declare function ScopedRunView(provider?: IMetadataProvider | null): RunView;
+/**
+ * A `Metadata` façade for entity construction, scoped the same way.
+ *
+ * `Metadata` has no provider constructor argument — `GetEntityObject` takes a context USER, and the
+ * provider is resolved from `Metadata.Provider`. So this returns a plain instance and exists to mark
+ * the intent at the call site: the caller has considered scoping and this is a context where the
+ * ambient provider is the right one. Where a scoped provider IS reachable (a server subclass, a form
+ * panel), construct through it instead — `provider.GetEntityObject(...)`.
+ */
+export declare function AmbientMetadata(): Metadata;
+//# sourceMappingURL=provider.d.ts.map

package/dist/lib/data/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/lib/data/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAE1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAE1C"}

package/dist/lib/data/provider.js

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Provider scoping, stated once (D-25).
+ *
+ * THE RULE: every data access is provider-scoped. A bare `new RunView()` / `new Metadata()` uses the
+ * global provider, which is correct only by coincidence — in a host with more than one provider (a
+ * different connection, a different user's context, a server-side call) it silently reads the wrong
+ * database, and the failure is a wrong ANSWER rather than an error.
+ *
+ * Where each context gets its provider from:
+ *
+ *   · server subclasses / engines  → `this.ProviderToUse` (BaseEntity supplies it)
+ *   · form panels                  → `FormComponent.ProviderToUse` — the host form's, so a panel reads
+ *                                    from the same place the record it is showing came from
+ *   · standalone editors           → an `@Input() Provider`, falling back to `Metadata.Provider`
+ *   · anything else                → `RunView.FromMetadataProvider(Metadata.Provider)`
+ *
+ * The helpers below exist so the last two are one call rather than a repeated expression: a pattern
+ * copied into fifteen places is a pattern that is wrong in one of them.
+ *
+ * MJ's own code uses `RunView.FromMetadataProvider(this.ProviderToUse)` in exactly this way
+ * (`base-form-component.ts`), so this is the platform's idiom, not ours.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { Metadata, RunView } from '@memberjunction/core';
+/**
+ * A `RunView` scoped to `provider`, or to the ambient provider when none is supplied.
+ *
+ * The fallback is deliberate and is NOT the same thing as a bare `new RunView()`: it names the
+ * provider it is falling back to, so the choice is visible at the call site and a reviewer can see
+ * whether a scoped one was available.
+ */
+export function ScopedRunView(provider) {
+    return RunView.FromMetadataProvider(provider ?? Metadata.Provider);
+}
+/**
+ * A `Metadata` façade for entity construction, scoped the same way.
+ *
+ * `Metadata` has no provider constructor argument — `GetEntityObject` takes a context USER, and the
+ * provider is resolved from `Metadata.Provider`. So this returns a plain instance and exists to mark
+ * the intent at the call site: the caller has considered scoping and this is a context where the
+ * ambient provider is the right one. Where a scoped provider IS reachable (a server subclass, a form
+ * panel), construct through it instead — `provider.GetEntityObject(...)`.
+ */
+export function AmbientMetadata() {
+    return new Metadata();
+}
+//# sourceMappingURL=provider.js.map

package/dist/lib/data/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/lib/data/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAA0B,MAAM,sBAAsB,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAmC;IAC7D,OAAO,OAAO,CAAC,oBAAoB,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,IAAI,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/lib/directives/fk-navigate.directive.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Make the grid's foreign-key links actually open the record they point at.
+ *
+ * THE DEFECT THIS EXISTS TO WORK AROUND (MJ, not ours). `mj-entity-data-grid` renders every FK cell as
+ * an anchor (`.cell-fk-link`, blue + underlined), detects the click, and emits `ForeignKeyClick` with
+ * the related entity and the FK value — see `entity-data-grid.component.ts` → `onAgCellClicked`. But
+ * `mj-explorer-entity-data-grid`, the wrapper the forms + our pages use, **never binds that output and
+ * declares no equivalent of its own** (verified in `explorer-entity-data-grid.component.ts`: the inner
+ * grid's template binds `AfterRowDoubleClick`, `AfterRowClick`, `AfterDataLoad` and
+ * `NewRecordTabRequested`, and nothing else). So the cell LOOKS like a link, the grid does its half of
+ * the work, and the event dies inside the wrapper. Every FK link in every wrapper-hosted grid is inert.
+ *
+ * That is a silent-failure UI bug of the worst kind — the affordance advertises navigation that cannot
+ * happen — and it is why Marcelo hit it immediately on the modifications grid.
+ *
+ * WHY A DIRECTIVE, and why this is not a DOM hack. The wrapper exposes the inner grid publicly
+ * (`@ViewChild('innerGrid') innerGrid!: EntityDataGridComponent`), so a directive on the same host
+ * element can inject the wrapper and subscribe to the inner component's own `@Output`. We use MJ's
+ * public API and MJ's own event — we do not reach into the DOM, re-parse the `data-*` attributes, or
+ * re-implement the hit test. When the wrapper grows a real `ForeignKeyClick` output, deleting this
+ * file and binding it is a one-line change with identical behaviour.
+ *
+ * The navigation itself mirrors MJ's own canonical handler
+ * (`grid-view-renderer.component.ts` → `onForeignKeyClick`): prefer the event's `relatedEntityName`,
+ * else resolve the name from `relatedEntityId` through metadata.
+ *
+ * FILED: see `plans/WORKAROUNDS.md` — this belongs upstream, as an output on the wrapper.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { AfterViewInit, OnDestroy } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class MJCFkNavigateDirective implements AfterViewInit, OnDestroy {
+    private readonly grid;
+    private readonly navigation;
+    /**
+     * Typed structurally rather than as an rxjs `Subscription`: this package does not declare rxjs as a
+     * dependency (Angular brings it transitively), and importing a type from an undeclared package is
+     * how a build breaks the first time the hoisting changes. `unsubscribe()` is all we use.
+     */
+    private sub;
+    /**
+     * Subscribe after the view exists, because `innerGrid` is a `@ViewChild` on the wrapper and is
+     * undefined until then. One retry on a microtask covers the case where the wrapper's own
+     * `AfterViewInit` has not yet run — directive and component hook order on the same host is not
+     * something to rely on.
+     */
+    ngAfterViewInit(): void;
+    private subscribe;
+    /**
+     * Open the related record.
+     *
+     * The FK event carries a bare value, not a key, so the primary-key FIELD NAME comes from the
+     * related entity's metadata rather than being assumed to be `ID`. It is `ID` for every entity in
+     * this app, but assuming it would break the first time this directive met a natural-key entity —
+     * and it would break as a wrong-record navigation, not an error.
+     */
+    private open;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCFkNavigateDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MJCFkNavigateDirective, "[mjcFkNavigate]", never, {}, {}, never, never, true, never>;
+}
+//# sourceMappingURL=fk-navigate.directive.d.ts.map

package/dist/lib/directives/fk-navigate.directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk-navigate.directive.d.ts","sourceRoot":"","sources":["../../../src/lib/directives/fk-navigate.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAE,aAAa,EAAa,SAAS,EAAU,MAAM,eAAe,CAAC;;AAM5E,qBAIa,sBAAuB,YAAW,aAAa,EAAE,SAAS;IACnE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2D;IAChF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD;;;;OAIG;IACH,OAAO,CAAC,GAAG,CAAwC;IAEnD;;;;;OAKG;IACI,eAAe,IAAI,IAAI;IAK9B,OAAO,CAAC,SAAS;IAQjB;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI;IAYL,WAAW,IAAI,IAAI;yCAjDjB,sBAAsB;2CAAtB,sBAAsB;CAqDlC"}

package/dist/lib/directives/fk-navigate.directive.js

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview Make the grid's foreign-key links actually open the record they point at.
+ *
+ * THE DEFECT THIS EXISTS TO WORK AROUND (MJ, not ours). `mj-entity-data-grid` renders every FK cell as
+ * an anchor (`.cell-fk-link`, blue + underlined), detects the click, and emits `ForeignKeyClick` with
+ * the related entity and the FK value — see `entity-data-grid.component.ts` → `onAgCellClicked`. But
+ * `mj-explorer-entity-data-grid`, the wrapper the forms + our pages use, **never binds that output and
+ * declares no equivalent of its own** (verified in `explorer-entity-data-grid.component.ts`: the inner
+ * grid's template binds `AfterRowDoubleClick`, `AfterRowClick`, `AfterDataLoad` and
+ * `NewRecordTabRequested`, and nothing else). So the cell LOOKS like a link, the grid does its half of
+ * the work, and the event dies inside the wrapper. Every FK link in every wrapper-hosted grid is inert.
+ *
+ * That is a silent-failure UI bug of the worst kind — the affordance advertises navigation that cannot
+ * happen — and it is why Marcelo hit it immediately on the modifications grid.
+ *
+ * WHY A DIRECTIVE, and why this is not a DOM hack. The wrapper exposes the inner grid publicly
+ * (`@ViewChild('innerGrid') innerGrid!: EntityDataGridComponent`), so a directive on the same host
+ * element can inject the wrapper and subscribe to the inner component's own `@Output`. We use MJ's
+ * public API and MJ's own event — we do not reach into the DOM, re-parse the `data-*` attributes, or
+ * re-implement the hit test. When the wrapper grows a real `ForeignKeyClick` output, deleting this
+ * file and binding it is a one-line change with identical behaviour.
+ *
+ * The navigation itself mirrors MJ's own canonical handler
+ * (`grid-view-renderer.component.ts` → `onForeignKeyClick`): prefer the event's `relatedEntityName`,
+ * else resolve the name from `relatedEntityId` through metadata.
+ *
+ * FILED: see `plans/WORKAROUNDS.md` — this belongs upstream, as an output on the wrapper.
+ *
+ * @module @mj-biz-apps/contracts-ng
+ */
+import { Directive, inject } from '@angular/core';
+import { CompositeKey } from '@memberjunction/core';
+import { ExplorerEntityDataGridComponent } from '@memberjunction/ng-base-forms';
+import { NavigationService } from '@memberjunction/ng-shared';
+import { AmbientMetadata } from '../data/provider';
+import * as i0 from "@angular/core";
+export class MJCFkNavigateDirective {
+    grid = inject(ExplorerEntityDataGridComponent, { host: true });
+    navigation = inject(NavigationService);
+    /**
+     * Typed structurally rather than as an rxjs `Subscription`: this package does not declare rxjs as a
+     * dependency (Angular brings it transitively), and importing a type from an undeclared package is
+     * how a build breaks the first time the hoisting changes. `unsubscribe()` is all we use.
+     */
+    sub = null;
+    /**
+     * Subscribe after the view exists, because `innerGrid` is a `@ViewChild` on the wrapper and is
+     * undefined until then. One retry on a microtask covers the case where the wrapper's own
+     * `AfterViewInit` has not yet run — directive and component hook order on the same host is not
+     * something to rely on.
+     */
+    ngAfterViewInit() {
+        if (this.subscribe())
+            return;
+        void Promise.resolve().then(() => this.subscribe());
+    }
+    subscribe() {
+        if (this.sub)
+            return true;
+        const inner = this.grid?.innerGrid;
+        if (!inner?.ForeignKeyClick)
+            return false;
+        this.sub = inner.ForeignKeyClick.subscribe((e) => this.open(e));
+        return true;
+    }
+    /**
+     * Open the related record.
+     *
+     * The FK event carries a bare value, not a key, so the primary-key FIELD NAME comes from the
+     * related entity's metadata rather than being assumed to be `ID`. It is `ID` for every entity in
+     * this app, but assuming it would break the first time this directive met a natural-key entity —
+     * and it would break as a wrong-record navigation, not an error.
+     */
+    open(e) {
+        if (!e?.recordId)
+            return;
+        const md = AmbientMetadata();
+        const entity = (e.relatedEntityName ? md.Entities.find((x) => x.Name === e.relatedEntityName) : undefined) ??
+            md.Entities.find((x) => x.ID === e.relatedEntityId);
+        if (!entity)
+            return;
+        const pkField = entity.PrimaryKeys?.[0]?.Name ?? 'ID';
+        this.navigation.OpenEntityRecord(entity.Name, CompositeKey.FromKeyValuePair(pkField, e.recordId));
+    }
+    ngOnDestroy() {
+        this.sub?.unsubscribe();
+        this.sub = null;
+    }
+    static ɵfac = function MJCFkNavigateDirective_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJCFkNavigateDirective)(); };
+    static ɵdir = /*@__PURE__*/ i0.ɵɵdefineDirective({ type: MJCFkNavigateDirective, selectors: [["", "mjcFkNavigate", ""]] });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJCFkNavigateDirective, [{
+        type: Directive,
+        args: [{
+                selector: '[mjcFkNavigate]',
+                standalone: true,
+            }]
+    }], null, null); })();
+//# sourceMappingURL=fk-navigate.directive.js.map

package/dist/lib/directives/fk-navigate.directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk-navigate.directive.js","sourceRoot":"","sources":["../../../src/lib/directives/fk-navigate.directive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAiB,SAAS,EAAa,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;;AAMnD,MAAM,OAAO,sBAAsB;IACd,IAAI,GAAG,MAAM,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACxD;;;;OAIG;IACK,GAAG,GAAmC,IAAI,CAAC;IAEnD;;;;;OAKG;IACI,eAAe;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC7B,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;IAEO,SAAS;QACb,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,eAAe;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACK,IAAI,CAAC,CAA4E;QACrF,IAAI,CAAC,CAAC,EAAE,QAAQ;YAAE,OAAO;QACzB,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7B,MAAM,MAAM,GACR,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3F,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;QACtD,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtG,CAAC;IAEM,WAAW;QACd,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IACpB,CAAC;gHApDQ,sBAAsB;6DAAtB,sBAAsB;;iFAAtB,sBAAsB;cAJlC,SAAS;eAAC;gBACP,QAAQ,EAAE,iBAAiB;gBAC3B,UAAU,EAAE,IAAI;aACnB"}

package/dist/lib/form-panels/contract.panels.d.ts

@@ -0,0 +1,124 @@
+import { BaseFormPanel } from '@memberjunction/ng-base-forms';
+import { type HierarchyTreeConfig, type HierarchyNodeEvent } from '@memberjunction/ng-hierarchy-tree';
+import { ContractEntity, type ContractState } from '@mj-biz-apps/contracts-entities';
+import * as i0 from "@angular/core";
+export declare class MJCContractHeroPanel extends BaseFormPanel<ContractEntity> {
+    /**
+     * The human name for this agreement: its description, falling back to the number.
+     *
+     * The mockup's hero title is a descriptive line ("Sidecar — Learning Hub, 2-year"), not the contract
+     * number — the number is already in the meta row directly beneath, and repeating it as the headline
+     * wastes the one place a reader looks first.
+     */
+    get Title(): string;
+    /**
+     * READ from the view's derived column. Application code does not re-derive state (Marcelo,
+     * 2026-08-19) — the view is the single authority, and `DeriveContractState()` is now for tests
+     * and the equivalence harness only.
+     *
+     * This panel used to re-derive it in the browser so the chip tracked UNSAVED date edits. That
+     * bought a live-updating chip and cost the thing worth more: a second implementation that could
+     * disagree with the view, which is exactly what happened — the two diverged on the termination
+     * boundary and no test could see it. The chip now shows what is PERSISTED, which is also the
+     * more honest claim: a state chip that reacts to an unsaved date is asserting something no
+     * query would agree with until the record is saved.
+     *
+     * A never-saved record has no column value, and `Draft` is not a guess there — it is what the
+     * view's own `ELSE` branch returns for a row with no dates, which is every new contract.
+     */
+    get State(): ContractState;
+    get StateChipClass(): string;
+    get TypeName(): string;
+    get CustomerName(): string;
+    get CompanyName(): string;
+    get ContactName(): string;
+    get TemplateName(): string;
+    get CreatingEntityName(): string;
+    get IsAwaitingDocument(): boolean;
+    get DaysToEnd(): number | null;
+    /** "in 16 months" reads better than "in 487 days" past a couple of months — the mockup's phrasing. */
+    get EndsInText(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractHeroPanel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractHeroPanel, "mjc-contract-hero-panel", never, {}, {}, never, never, true, never>;
+}
+export declare class MJCContractRenewalPanel extends BaseFormPanel<ContractEntity> {
+    /**
+     * Write a field through the typed entity. Named `Set` rather than bound with two-way `[(ngModel)]`
+     * so the write goes through one place — a two-way binding on `Record.X` works but gives no hook for
+     * the dirty notification the form toolbar needs.
+     */
+    Set(field: 'AutoRenew' | 'RenewalNoticeDays' | 'CancellationWindowDays' | 'AnnualIncreasePercent', value: unknown): void;
+    /** The authoritative view column — unlike State, nobody wants this tracking a half-typed edit. */
+    get NoticeDeadline(): Date | null;
+    get InCancellationWindow(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractRenewalPanel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractRenewalPanel, "mjc-contract-renewal-panel", never, {}, {}, never, never, true, never>;
+}
+/**
+ * The four dates, with the one piece of interpretation a reader needs.
+ *
+ * Exists as a panel for the same two reasons as Renewal terms: it earns a rail entry by REPLACING a
+ * named field section (a replaced section is not "leftover", so left-nav does not fold it into
+ * Details), and it can say things the generated field list cannot — that an executed date before the
+ * effective date is normal, and that a terminated date is a fact rather than a projection.
+ *
+ * The generated form renders these as datetime inputs with a time component (`7/19/2025, 7:00:00 PM`)
+ * because the underlying columns are `date` but the default control is a datetime picker. They are
+ * calendar dates — a contract does not start at 7pm — so this panel renders them as dates.
+ */
+export declare class MJCContractDatesPanel extends BaseFormPanel<ContractEntity> {
+    /** `<input type="date">` needs `yyyy-MM-dd`; the entity hands back a Date or an ISO string. */
+    AsInput(v: Date | string | null | undefined): string;
+    SetDate(field: 'ExecutedDate' | 'EffectiveDate' | 'EndDate' | 'TerminatedDate', value: string): void;
+    get EndsInText(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractDatesPanel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractDatesPanel, "mjc-contract-dates-panel", never, {}, {}, never, never, true, never>;
+}
+export declare class MJCContractLineagePanel extends BaseFormPanel<ContractEntity> {
+    private readonly cdr;
+    private readonly navigation;
+    /**
+     * The whole tree, declared rather than fetched.
+     *
+     * `ParentContractID` is an ordinary self-referential hierarchy, so MJ's tree does the recursive
+     * read, the expand/collapse state, the search box and — the part that matters — turns each node
+     * into something you can OPEN. The hand-rolled table this replaces could show a change order's
+     * number but gave no way to get to it, which is most of what a person wants from a lineage panel.
+     *
+     * NO `ExtraFilter`, deliberately — the component does the scoping better than a filter could. Given
+     * the whole entity plus `ActiveRecordID`, it focuses this contract's subtree on its own (the header
+     * reads "Focusing subtree: CTR-…") and offers "View Full Hierarchy" to widen. A filter rooted at
+     * the current record would hard-hide the parent a change order needs to show ABOVE it, with no way
+     * back out. Ordering is by contract number so siblings read in the order they were issued.
+     */
+    get TreeConfig(): HierarchyTreeConfig;
+    /** Whether anything hangs beneath this contract — drives the empty state, nothing else. */
+    HasChildren: boolean;
+    private loadStarted;
+    /**
+     * Open the contract a node stands for.
+     *
+     * The node carries a real `CompositeKey`, so this does not have to guess that the primary key is
+     * called `ID` — the same reasoning as `MJCFkNavigateDirective`, which would break on the first
+     * natural-key entity it met, and would break as a WRONG-RECORD navigation rather than an error.
+     */
+    OpenNode(e: HierarchyNodeEvent): void;
+    get ParentName(): string;
+    get Count(): number | undefined;
+    /** Direct children, for the badge. The TREE renders the hierarchy; this is just the count. */
+    ChildCount: number;
+    /**
+     * Read the children ONCE, lazily on first template read.
+     *
+     * `BaseFormPanel` has no lifecycle hook of its own and the slot host sets `Record` before view init,
+     * so the first template read is the earliest reliable moment. Read as a table rather than an
+     * embedded grid: a grid inside a panel inside a rail section is three nested scroll contexts, and
+     * the mockup renders four columns of read-only facts, which is a table.
+     */
+    private ensureLoaded;
+    private load;
+    private scopedRunView;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJCContractLineagePanel, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJCContractLineagePanel, "mjc-contract-lineage-panel", never, {}, {}, never, never, true, never>;
+}
+//# sourceMappingURL=contract.panels.d.ts.map