@memberjunction/ng-base-forms 6.1.0-edge.2 → 6.1.0-edge.3

package/dist/lib/panel-slot/base-form-panel.js

@@ -1,4 +1,4 @@
-import { Directive, Input } from '@angular/core';
+import { Directive, HostBinding, Input } from '@angular/core';
 import { ValidationResult } from '@memberjunction/core';
 import * as i0 from "@angular/core";
 /**
@@ -20,6 +20,12 @@ import * as i0 from "@angular/core";
  * record itself does can leave this method off.
  */
 export class BaseFormPanel {
+    /**
+     * Slot-mounted hosts must not sit in the left-nav flex column — leftover
+     * height targets `mj-collapsible-panel` as a direct child of
+     * `.mj-forms-all-panels`. `display: contents` makes the inner panel that child.
+     */
+    HostDisplay = 'contents';
     /** The entity record being edited. Set by the slot host before view init. */
     Record;
     /** The host form component (use for EditMode, dirty notifications, etc). Set by the slot host. */
@@ -49,12 +55,75 @@ export class BaseFormPanel {
         result.Success = true;
         return result;
     }
+    /**
+     * Called after the parent form reloads the current record from the database.
+     * Default is a no-op. Override to refresh panel-owned data that is not a
+     * related-entity grid (those already subscribe to
+     * {@link FormRecordRefreshCoordinator} themselves).
+     */
+    OnRecordRefreshed(_record) {
+        // Subclasses can override
+    }
+    /**
+     * Registers a dynamic toolbar action item / button into the host form toolbar.
+     */
+    RegisterToolbarItem(item) {
+        this.FormComponent?.RegisterToolbarItem(item);
+    }
+    /**
+     * Unregisters a previously registered dynamic toolbar item by key.
+     */
+    UnregisterToolbarItem(key) {
+        this.FormComponent?.UnregisterToolbarItem(key);
+    }
+    /**
+     * Configures overrides for any toolbar item (standard built-in items like 'edit',
+     * 'delete', 'favorite', 'history', etc., or custom items).
+     */
+    ConfigureToolbarItem(key, overrides) {
+        this.FormComponent?.ConfigureToolbarItem(key, overrides);
+    }
+    /**
+     * Dynamically hides a toolbar item by key.
+     */
+    HideToolbarItem(key) {
+        this.FormComponent?.HideToolbarItem(key);
+    }
+    /**
+     * Dynamically shows a toolbar item by key.
+     */
+    ShowToolbarItem(key) {
+        this.FormComponent?.ShowToolbarItem(key);
+    }
+    /**
+     * Dynamically disables a toolbar item by key, with an optional reason string for the tooltip.
+     */
+    DisableToolbarItem(key, reason) {
+        this.FormComponent?.DisableToolbarItem(key, reason);
+    }
+    /**
+     * Dynamically enables a toolbar item by key.
+     */
+    EnableToolbarItem(key) {
+        this.FormComponent?.EnableToolbarItem(key);
+    }
+    /**
+     * Sets the numeric display order for a toolbar item.
+     */
+    SetToolbarItemOrder(key, order) {
+        this.FormComponent?.SetToolbarItemOrder(key, order);
+    }
     static ɵfac = function BaseFormPanel_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || BaseFormPanel)(); };
-    static ɵdir = /*@__PURE__*/ i0.ɵɵdefineDirective({ type: BaseFormPanel, inputs: { Record: "Record", FormComponent: "FormComponent", FormContext: "FormContext" } });
+    static ɵdir = /*@__PURE__*/ i0.ɵɵdefineDirective({ type: BaseFormPanel, hostVars: 2, hostBindings: function BaseFormPanel_HostBindings(rf, ctx) { if (rf & 2) {
+            i0.ɵɵstyleProp("display", ctx.HostDisplay);
+        } }, inputs: { Record: "Record", FormComponent: "FormComponent", FormContext: "FormContext" } });
 }
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(BaseFormPanel, [{
         type: Directive
-    }], null, { Record: [{
+    }], null, { HostDisplay: [{
+            type: HostBinding,
+            args: ['style.display']
+        }], Record: [{
             type: Input
         }], FormComponent: [{
             type: Input

package/dist/lib/panel-slot/base-form-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-form-panel.js","sourceRoot":"","sources":["../../../src/lib/panel-slot/base-form-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAc,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;;AA+DpE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,OAAgB,aAAa;IAC/B,6EAA6E;IACpE,MAAM,CAAW;IAC1B,kGAAkG;IACzF,aAAa,CAAqB;IAC3C,qGAAqG;IAC5F,WAAW,CAAe;IAEnC;;;;;OAKG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,aAAa,EAAE,QAAQ,IAAI,KAAK,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACI,QAAQ;QACX,6EAA6E;QAC7E,6DAA6D;QAC7D,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,OAAO,MAAM,CAAC;IAClB,CAAC;uGA/BiB,aAAa;6DAAb,aAAa;;iFAAb,aAAa;cADlC,SAAS;;kBAGL,KAAK;;kBAEL,KAAK;;kBAEL,KAAK","sourcesContent":["import { Directive, Input } from '@angular/core';\nimport { BaseEntity, ValidationResult } from '@memberjunction/core';\nimport { BaseFormComponent } from '../base-form-component';\nimport { FormContext } from '../types/form-types';\n\n/**\n * Well-known slot positions where panels can be injected into a generated\n * entity form. Used as the `slot` field in a panel's registration metadata.\n *\n * Slot positions inside the form, top to bottom:\n *\n *   ┌─ <mj-record-form-container>\n *   │     [top-area slot]            ← CodeGen-emitted; rare (entities with top-area section)\n *   │     [before-fields slot]       ← CodeGen-emitted; banners / warnings above field panels\n *   │     <connection details>\n *   │     <other generated field panels>\n *   │     [after-fields slot]        ← CodeGen-emitted; typed config knobs, secondary settings — most common slot\n *   │     <content items grid>\n *   │     <other related-entity grids>\n *   │     [after-related slot]       ← CodeGen-emitted; bottom-of-form addenda\n *   │     [after-everything slot]    ← Container-emitted; ALWAYS present (fallback target)\n *   └─ </mj-record-form-container>\n *\n * Pick the slot that matches the panel's role. `after-fields` is the default\n * for most \"additional settings\" panels — it sits in the field column, before\n * the related-entity grids.\n *\n * **Fallback behavior** — see `FormSlotCoordinator`. If the registered slot is\n * missing in the current form (CodeGen hasn't been rerun against the new\n * template emitter), the panel walks forward in the chain until it finds an\n * existing slot. `after-everything` is always emitted by the container, so\n * fallback never dead-ends. Pre-CodeGen-regen forms show every panel at the\n * bottom of the form; post-regen forms show them in the preferred position.\n */\nexport type FormPanelSlot =\n    | 'top-area'\n    | 'before-fields'\n    | 'after-fields'\n    | 'after-related'\n    | 'after-everything';\n\n/**\n * Shape of the `metadata` object every BaseFormPanel registration MUST attach\n * via `@RegisterClass(BaseFormPanel, { metadata: {...} })`. The\n * `<mj-form-panel-slot>` host filters registrations by matching against this\n * shape — registrations without it are silently ignored.\n *\n *   - `entity` — the exact entity name (case-sensitive equality enforced by the\n *                slot host), OR the wildcard `'*'` to register an\n *                **entity-agnostic** panel that mounts on EVERY entity's form.\n *                Wildcard panels are expected to self-hide (render nothing) when\n *                they don't apply to the current record, so the cross-cutting\n *                registration stays unobtrusive on forms it has no business on.\n *   - `slot`   — which slot the panel renders into.\n *   - `sortKey`— higher = earlier within the slot. Defaults to 0 if omitted.\n *                Use ranges (e.g., 100/50/10) so future panels can wedge in\n *                without recomputing every neighbor's sort.\n */\nexport interface FormPanelRegistrationMetadata extends Record<string, unknown> {\n    entity: string;\n    slot: FormPanelSlot;\n    sortKey?: number;\n}\n\n/**\n * Abstract base for every dynamically-injectable form panel.\n *\n * Subclasses are standalone Angular components decorated with\n * `@RegisterClass(BaseFormPanel, { metadata: { entity, slot, sortKey? } })`.\n * At runtime, `<mj-form-panel-slot>` discovers matching registrations via\n * `ClassFactory.GetAllRegistrationsByMetadata`, instantiates each via\n * `ViewContainerRef.createComponent`, and wires `Record` + `FormComponent` +\n * `FormContext` into the inputs.\n *\n * Lifecycle hooks: standard Angular `ngOnInit` / `ngOnDestroy` work as usual.\n * `Record` is guaranteed to be set before the first change-detection pass.\n *\n * Optional `validate()` returns a synchronous validation result; the parent\n * `BaseFormComponent.Save()` path will surface it via the existing validation\n * pipeline when called. Panels that don't validate anything beyond what the\n * record itself does can leave this method off.\n */\n@Directive()\nexport abstract class BaseFormPanel<TRecord extends BaseEntity = BaseEntity> {\n    /** The entity record being edited. Set by the slot host before view init. */\n    @Input() Record!: TRecord;\n    /** The host form component (use for EditMode, dirty notifications, etc). Set by the slot host. */\n    @Input() FormComponent!: BaseFormComponent;\n    /** Optional form context — same shape the collapsible-panel chrome expects. Set by the slot host. */\n    @Input() FormContext?: FormContext;\n\n    /**\n     * Convenience getter for read-only / edit-mode rendering. Falls back to\n     * `false` when the panel is shown outside a `BaseFormComponent` host (e.g.,\n     * a dashboard quick-edit dialog reusing the same panel — see the\n     * \"composable panel\" docs).\n     */\n    public get EditMode(): boolean {\n        return this.FormComponent?.EditMode ?? false;\n    }\n\n    /**\n     * Override to add per-panel validation that should block the parent form's\n     * Save(). Return `{ Success: true, Errors: [] }` when valid, or include\n     * `ValidationErrorInfo` entries to surface field-level errors. The default\n     * implementation reports valid (panels that don't need extra validation\n     * can leave this method off).\n     */\n    public validate(): ValidationResult {\n        // Inline construction — ValidationResult is a class in @memberjunction/core,\n        // not a plain interface, so callers can construct via `new`.\n        const result = new ValidationResult();\n        result.Success = true;\n        return result;\n    }\n}\n"]}
+{"version":3,"file":"base-form-panel.js","sourceRoot":"","sources":["../../../src/lib/panel-slot/base-form-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAc,gBAAgB,EAAsB,MAAM,sBAAsB,CAAC;;AAqGxF;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,OAAgB,aAAa;IAC/B;;;;OAIG;IAEM,WAAW,GAAG,UAAU,CAAC;IAElC,6EAA6E;IACpE,MAAM,CAAW;IAC1B,kGAAkG;IACzF,aAAa,CAAqB;IAC3C,qGAAqG;IAC5F,WAAW,CAAe;IAEnC;;;;;OAKG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,aAAa,EAAE,QAAQ,IAAI,KAAK,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACI,QAAQ;QACX,6EAA6E;QAC7E,6DAA6D;QAC7D,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,OAAgB;QACrC,0BAA0B;IAC9B,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,IAA2B;QAClD,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,qBAAqB,CAAC,GAAW;QACpC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACI,oBAAoB,CAAC,GAAuB,EAAE,SAAyC;QAC1F,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,GAAuB;QAC1C,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,GAAuB;QAC1C,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,kBAAkB,CAAC,GAAuB,EAAE,MAAe;QAC9D,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACI,iBAAiB,CAAC,GAAuB;QAC5C,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,GAAuB,EAAE,KAAa;QAC7D,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;uGA1GiB,aAAa;6DAAb,aAAa;YAAb,0CAAa;;;iFAAb,aAAa;cADlC,SAAS;;kBAOL,WAAW;mBAAC,eAAe;;kBAI3B,KAAK;;kBAEL,KAAK;;kBAEL,KAAK","sourcesContent":["import { Directive, HostBinding, Input } from '@angular/core';\nimport { BaseEntity, ValidationResult, type FormInclusion } from '@memberjunction/core';\nimport { BaseFormComponent } from '../base-form-component';\nimport { FormContext } from '../types/form-types';\nimport { FormToolbarItemConfig, FormToolbarItemKey } from '../types/form-toolbar-item';\n\n/**\n * Well-known slot positions where panels can be injected into a generated\n * entity form. Used as the `slot` field in a panel's registration metadata.\n *\n * Slot positions inside the form, top to bottom:\n *\n *   ┌─ <mj-record-form-container>\n *   │     [top-area slot]            ← CodeGen-emitted; rare (entities with top-area section)\n *   │     [before-fields slot]       ← CodeGen-emitted; banners / warnings above field panels\n *   │     <connection details>\n *   │     <other generated field panels>\n *   │     [after-fields slot]        ← CodeGen-emitted; typed config knobs, secondary settings — most common slot\n *   │     <content items grid>\n *   │     <other related-entity grids>\n *   │     [after-related slot]       ← CodeGen-emitted; bottom-of-form addenda\n *   │     [after-everything slot]    ← Container-emitted; ALWAYS present (fallback target)\n *   └─ </mj-record-form-container>\n *\n * Pick the slot that matches the panel's role. `after-fields` is the default\n * for most \"additional settings\" panels — it sits in the field column, before\n * the related-entity grids.\n *\n * **Fallback behavior** — see `FormSlotCoordinator`. If the registered slot is\n * missing in the current form (CodeGen hasn't been rerun against the new\n * template emitter), the panel walks forward in the chain until it finds an\n * existing slot. `after-everything` is always emitted by the container, so\n * fallback never dead-ends. Pre-CodeGen-regen forms show every panel at the\n * bottom of the form; post-regen forms show them in the preferred position.\n */\nexport type FormPanelSlot =\n    | 'top-area'\n    | 'before-fields'\n    | 'after-fields'\n    | 'after-related'\n    | 'after-everything';\n\n/**\n * Shape of the `metadata` object every BaseFormPanel registration MUST attach\n * via `@RegisterClass(BaseFormPanel, { metadata: {...} })`. The\n * `<mj-form-panel-slot>` host filters registrations by matching against this\n * shape — registrations without it are silently ignored.\n *\n *   - `entity` — the exact entity name (case-sensitive equality enforced by the\n *                slot host), OR the wildcard `'*'` to register an\n *                **entity-agnostic** panel that mounts on EVERY entity's form.\n *                Wildcard panels are expected to self-hide (render nothing) when\n *                they don't apply to the current record, so the cross-cutting\n *                registration stays unobtrusive on forms it has no business on.\n *   - `slot`   — which slot the panel renders into.\n *   - `sortKey`— higher = earlier within the slot. Defaults to 0 if omitted.\n *                Use ranges (e.g., 100/50/10) so future panels can wedge in\n *                without recomputing every neighbor's sort.\n */\nexport interface FormPanelRegistrationMetadata extends Record<string, unknown> {\n    entity: string;\n    slot: FormPanelSlot;\n    sortKey?: number;\n    /**\n     * Identity for last-wins collapse. Two registrations with the same key\n     * compete; highest ClassFactory `Priority` wins. Omit to derive:\n     * `related:${relatedEntity}:${relatedJoinField}` when claiming a\n     * relationship, otherwise the registration is unique and never collapses.\n     */\n    contributionKey?: string;\n    /**\n     * When set, this panel **replaces** the default related-entity grid for\n     * that relationship on `entity`'s form. The baked CodeGen panel (if any)\n     * is hidden; the stock fill-in grid is not mounted.\n     */\n    relatedEntity?: string;\n    /**\n     * Disambiguates two FKs to the same related entity (BillTo vs ShipTo).\n     * Compared after stripping wrapping `[]`.\n     */\n    relatedJoinField?: string;\n    /**\n     * CodeGen `SectionKey` of a baked field (or other) panel this contribution\n     * replaces — e.g. `'details'`, `'personalIdentity'`. Hidden at runtime via\n     * `HiddenSectionKeys`. Use with `slot: 'before-fields'` for a form hero that\n     * is not a collapsible panel. Must name a concrete `entity` (not `'*'`).\n     */\n    replacesSectionKey?: string;\n    /**\n     * Pin this contribution to a chrome bucket instead of its own rail item.\n     * `'details'` — leftover own-fields group. `'more'` — overflow folder.\n     */\n    chromeGroup?: 'details' | 'more';\n    /**\n     * L1 inclusion for this contribution (same verbs as relationships).\n     * `'Primary'` — own first-class rail item, in the lead band before Details.\n     * `'More'` — overflow folder. `'None'` — hidden.\n     * L3 `MJ: Form Chrome Rules` still wins. `chromeGroup` still merges.\n     */\n    inclusion?: FormInclusion;\n}\n\n/**\n * Abstract base for every dynamically-injectable form panel.\n *\n * Subclasses are standalone Angular components decorated with\n * `@RegisterClass(BaseFormPanel, { metadata: { entity, slot, sortKey? } })`.\n * At runtime, `<mj-form-panel-slot>` discovers matching registrations via\n * `ClassFactory.GetAllRegistrationsByMetadata`, instantiates each via\n * `ViewContainerRef.createComponent`, and wires `Record` + `FormComponent` +\n * `FormContext` into the inputs.\n *\n * Lifecycle hooks: standard Angular `ngOnInit` / `ngOnDestroy` work as usual.\n * `Record` is guaranteed to be set before the first change-detection pass.\n *\n * Optional `validate()` returns a synchronous validation result; the parent\n * `BaseFormComponent.Save()` path will surface it via the existing validation\n * pipeline when called. Panels that don't validate anything beyond what the\n * record itself does can leave this method off.\n */\n@Directive()\nexport abstract class BaseFormPanel<TRecord extends BaseEntity = BaseEntity> {\n    /**\n     * Slot-mounted hosts must not sit in the left-nav flex column — leftover\n     * height targets `mj-collapsible-panel` as a direct child of\n     * `.mj-forms-all-panels`. `display: contents` makes the inner panel that child.\n     */\n    @HostBinding('style.display')\n    readonly HostDisplay = 'contents';\n\n    /** The entity record being edited. Set by the slot host before view init. */\n    @Input() Record!: TRecord;\n    /** The host form component (use for EditMode, dirty notifications, etc). Set by the slot host. */\n    @Input() FormComponent!: BaseFormComponent;\n    /** Optional form context — same shape the collapsible-panel chrome expects. Set by the slot host. */\n    @Input() FormContext?: FormContext;\n\n    /**\n     * Convenience getter for read-only / edit-mode rendering. Falls back to\n     * `false` when the panel is shown outside a `BaseFormComponent` host (e.g.,\n     * a dashboard quick-edit dialog reusing the same panel — see the\n     * \"composable panel\" docs).\n     */\n    public get EditMode(): boolean {\n        return this.FormComponent?.EditMode ?? false;\n    }\n\n    /**\n     * Override to add per-panel validation that should block the parent form's\n     * Save(). Return `{ Success: true, Errors: [] }` when valid, or include\n     * `ValidationErrorInfo` entries to surface field-level errors. The default\n     * implementation reports valid (panels that don't need extra validation\n     * can leave this method off).\n     */\n    public validate(): ValidationResult {\n        // Inline construction — ValidationResult is a class in @memberjunction/core,\n        // not a plain interface, so callers can construct via `new`.\n        const result = new ValidationResult();\n        result.Success = true;\n        return result;\n    }\n\n    /**\n     * Called after the parent form reloads the current record from the database.\n     * Default is a no-op. Override to refresh panel-owned data that is not a\n     * related-entity grid (those already subscribe to\n     * {@link FormRecordRefreshCoordinator} themselves).\n     */\n    public OnRecordRefreshed(_record: TRecord): void {\n        // Subclasses can override\n    }\n\n    /**\n     * Registers a dynamic toolbar action item / button into the host form toolbar.\n     */\n    public RegisterToolbarItem(item: FormToolbarItemConfig): void {\n        this.FormComponent?.RegisterToolbarItem(item);\n    }\n\n    /**\n     * Unregisters a previously registered dynamic toolbar item by key.\n     */\n    public UnregisterToolbarItem(key: string): void {\n        this.FormComponent?.UnregisterToolbarItem(key);\n    }\n\n    /**\n     * Configures overrides for any toolbar item (standard built-in items like 'edit',\n     * 'delete', 'favorite', 'history', etc., or custom items).\n     */\n    public ConfigureToolbarItem(key: FormToolbarItemKey, overrides: Partial<FormToolbarItemConfig>): void {\n        this.FormComponent?.ConfigureToolbarItem(key, overrides);\n    }\n\n    /**\n     * Dynamically hides a toolbar item by key.\n     */\n    public HideToolbarItem(key: FormToolbarItemKey): void {\n        this.FormComponent?.HideToolbarItem(key);\n    }\n\n    /**\n     * Dynamically shows a toolbar item by key.\n     */\n    public ShowToolbarItem(key: FormToolbarItemKey): void {\n        this.FormComponent?.ShowToolbarItem(key);\n    }\n\n    /**\n     * Dynamically disables a toolbar item by key, with an optional reason string for the tooltip.\n     */\n    public DisableToolbarItem(key: FormToolbarItemKey, reason?: string): void {\n        this.FormComponent?.DisableToolbarItem(key, reason);\n    }\n\n    /**\n     * Dynamically enables a toolbar item by key.\n     */\n    public EnableToolbarItem(key: FormToolbarItemKey): void {\n        this.FormComponent?.EnableToolbarItem(key);\n    }\n\n    /**\n     * Sets the numeric display order for a toolbar item.\n     */\n    public SetToolbarItemOrder(key: FormToolbarItemKey, order: number): void {\n        this.FormComponent?.SetToolbarItemOrder(key, order);\n    }\n}\n"]}

package/dist/lib/panel-slot/collect-form-panel-registrations.d.ts

@@ -0,0 +1,8 @@
+import type { FormContributionRegistration } from './form-contribution';
+/**
+ * Every BaseFormPanel registration that carries an `entity` metadata field.
+ * Used by the composer and by `BaseFormComponent.formContext` to hide baked
+ * related sections a panel has claimed.
+ */
+export declare function CollectFormPanelRegistrations(): FormContributionRegistration[];
+//# sourceMappingURL=collect-form-panel-registrations.d.ts.map

package/dist/lib/panel-slot/collect-form-panel-registrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-form-panel-registrations.d.ts","sourceRoot":"","sources":["../../../src/lib/panel-slot/collect-form-panel-registrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,4BAA4B,EAAE,CAY9E"}

package/dist/lib/panel-slot/collect-form-panel-registrations.js

@@ -0,0 +1,19 @@
+import { MJGlobal } from '@memberjunction/global';
+import { BaseFormPanel } from './base-form-panel';
+/**
+ * Every BaseFormPanel registration that carries an `entity` metadata field.
+ * Used by the composer and by `BaseFormComponent.formContext` to hide baked
+ * related sections a panel has claimed.
+ */
+export function CollectFormPanelRegistrations() {
+    return MJGlobal.Instance.ClassFactory.GetAllRegistrationsByMetadata(BaseFormPanel, (metadata) => {
+        if (!metadata)
+            return false;
+        const entity = metadata.entity;
+        return typeof entity === 'string' && entity.length > 0;
+    }).map((reg) => ({
+        Priority: reg.Priority,
+        Metadata: reg.Metadata,
+    }));
+}
+//# sourceMappingURL=collect-form-panel-registrations.js.map

package/dist/lib/panel-slot/collect-form-panel-registrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-form-panel-registrations.js","sourceRoot":"","sources":["../../../src/lib/panel-slot/collect-form-panel-registrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAiC,MAAM,mBAAmB,CAAC;AAGjF;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,6BAA6B,CAC/D,aAAa,EACb,CAAC,QAAQ,EAAE,EAAE;QACT,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,MAAM,MAAM,GAAI,QAAmD,CAAC,MAAM,CAAC;QAC3E,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,CAAC,CACJ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,GAAG,CAAC,QAAyC;KAC1D,CAAC,CAAC,CAAC;AACR,CAAC","sourcesContent":["import { MJGlobal } from '@memberjunction/global';\nimport { BaseFormPanel, FormPanelRegistrationMetadata } from './base-form-panel';\nimport type { FormContributionRegistration } from './form-contribution';\n\n/**\n * Every BaseFormPanel registration that carries an `entity` metadata field.\n * Used by the composer and by `BaseFormComponent.formContext` to hide baked\n * related sections a panel has claimed.\n */\nexport function CollectFormPanelRegistrations(): FormContributionRegistration[] {\n    return MJGlobal.Instance.ClassFactory.GetAllRegistrationsByMetadata(\n        BaseFormPanel,\n        (metadata) => {\n            if (!metadata) return false;\n            const entity = (metadata as Partial<FormPanelRegistrationMetadata>).entity;\n            return typeof entity === 'string' && entity.length > 0;\n        },\n    ).map((reg) => ({\n        Priority: reg.Priority,\n        Metadata: reg.Metadata as FormPanelRegistrationMetadata,\n    }));\n}\n"]}

package/dist/lib/panel-slot/form-contribution.d.ts

@@ -0,0 +1,79 @@
+import { FormPanelRegistrationMetadata, FormPanelSlot } from './base-form-panel';
+/** Minimum relationship shape the composer reads. Satisfied by EntityRelationshipInfo. */
+export interface FormContributionRelationship {
+    RelatedEntity: string;
+    RelatedEntityID: string;
+    RelatedEntityJoinField: string;
+    DisplayInForm: boolean;
+    DisplayName?: string | null;
+    Sequence?: number | null;
+}
+export interface FormContributionRegistration {
+    Priority: number;
+    Metadata: FormPanelRegistrationMetadata;
+}
+export interface ResolveFormContributionsInput {
+    EntityName: string;
+    RelatedEntities: readonly FormContributionRelationship[];
+    /** IS-A child entity IDs — CodeGen skips these (shown in the ISA side panel). */
+    IsaChildEntityIDs: readonly string[];
+    Registrations: readonly FormContributionRegistration[];
+    /** SectionKeys already projected as Variant="related-entity" in the form template. */
+    BakedSectionKeys: readonly string[];
+    ShowRelatedEntities: boolean;
+}
+export type FormContributionKind = 'registered' | 'stock-grid';
+export interface FormContributionWinner {
+    ContributionKey: string;
+    Slot: FormPanelSlot;
+    SortKey: number;
+    Priority: number;
+    Kind: FormContributionKind;
+    RelatedEntity?: string;
+    RelatedJoinField?: string;
+    /** Field/other section this registered winner asked to hide. */
+    ReplacesSectionKey?: string;
+    BakedSectionKey: string;
+    DisplayName: string;
+}
+export interface ResolveFormContributionsResult {
+    Winners: FormContributionWinner[];
+    /** CodeGen section keys to hide because a registered panel claimed them. */
+    HiddenBakedSectionKeys: string[];
+    /** Stock grids the host should mount (unclaimed and not already baked). */
+    StockGrids: FormContributionWinner[];
+}
+/** Strip wrapping [] from a join field, matching CodeGen's tab-name helper. */
+export declare function StripJoinFieldBrackets(joinField: string | null | undefined): string;
+/**
+ * camelCase + identifier sanitize. Byte-compatible with
+ * `CodeGenLib` `angular-codegen.ts` `camelCase` — do not "improve".
+ */
+export declare function FormSectionCamelCase(str: string): string;
+export declare function RelatedContributionKey(relatedEntity: string, joinField?: string | null): string;
+export declare function ResolveContributionKey(meta: FormPanelRegistrationMetadata): string;
+/**
+ * SectionKey CodeGen emits for a related-entity panel. When more than one
+ * DisplayInForm relationship points at the same entity, the join field is
+ * appended so BillTo / ShipTo do not collide.
+ */
+export declare function RelatedEntitySectionKey(relationship: FormContributionRelationship, displayInFormPeers: readonly FormContributionRelationship[]): string;
+export declare function RelationshipDisplayName(relationship: FormContributionRelationship): string;
+/**
+ * Last-wins collapse by contributionKey (or derived related key).
+ * Highest Priority keeps the slot. Registrations without a key never collapse.
+ */
+export declare function CollapseFormPanelRegistrations<T extends {
+    Priority: number;
+    Metadata: FormPanelRegistrationMetadata;
+}>(registrations: readonly T[]): T[];
+/**
+ * Resolve what belongs on the form. Stock grids are only those the template
+ * did not already bake and that no panel claimed.
+ */
+export declare function ResolveFormContributions(input: ResolveFormContributionsInput): ResolveFormContributionsResult;
+/** Section keys a form should hide because a winning contribution claimed them. */
+export declare function ContributionHiddenSectionKeys(entityName: string, relatedEntities: readonly FormContributionRelationship[], isaChildEntityIDs: readonly string[], registrations: readonly FormContributionRegistration[]): string[];
+/** @deprecated Use {@link ContributionHiddenSectionKeys}. */
+export declare function ClaimedRelatedSectionKeys(entityName: string, relatedEntities: readonly FormContributionRelationship[], isaChildEntityIDs: readonly string[], registrations: readonly FormContributionRegistration[]): string[];
+//# sourceMappingURL=form-contribution.d.ts.map

package/dist/lib/panel-slot/form-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-contribution.d.ts","sourceRoot":"","sources":["../../../src/lib/panel-slot/form-contribution.ts"],"names":[],"mappings":"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"}

package/dist/lib/panel-slot/form-contribution.js

@@ -0,0 +1,253 @@
+/**
+ * Form contributions — pure resolve of what should appear on an entity form.
+ *
+ * A contribution is either a registered BaseFormPanel or the stock related-entity
+ * grid. Related claims replace the stock/baked grid. No Angular, no ClassFactory
+ * — the host queries registrations and feeds this.
+ *
+ * Section keys for related panels MUST match CodeGen's camelCase
+ * (`angular-codegen.ts` `camelCase` + related-entity sectionKey). If they drift,
+ * hide-baked and skip-baked miss and the user sees a double grid.
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+/** Strip wrapping [] from a join field, matching CodeGen's tab-name helper. */
+export function StripJoinFieldBrackets(joinField) {
+    return (joinField ?? '').trim().replace(/^\[/, '').replace(/\]$/, '');
+}
+/**
+ * camelCase + identifier sanitize. Byte-compatible with
+ * `CodeGenLib` `angular-codegen.ts` `camelCase` — do not "improve".
+ */
+export function FormSectionCamelCase(str) {
+    const sanitized = str.replace(/[^a-zA-Z0-9\s]/g, ' ');
+    let result = sanitized
+        .replace(/\s(.)/g, (_match, char) => char.toUpperCase())
+        .replace(/\s/g, '')
+        .replace(/^(.)/, (_match, char) => char.toLowerCase());
+    if (/^\d/.test(result)) {
+        result = '_' + result;
+    }
+    return result.length === 0 ? 'section' : result;
+}
+export function RelatedContributionKey(relatedEntity, joinField) {
+    return `related:${relatedEntity.trim()}:${StripJoinFieldBrackets(joinField)}`;
+}
+export function ResolveContributionKey(meta) {
+    if (meta.contributionKey && meta.contributionKey.trim().length > 0) {
+        return meta.contributionKey.trim();
+    }
+    if (meta.relatedEntity && meta.relatedEntity.trim().length > 0) {
+        return RelatedContributionKey(meta.relatedEntity, meta.relatedJoinField);
+    }
+    return '';
+}
+/**
+ * SectionKey CodeGen emits for a related-entity panel. When more than one
+ * DisplayInForm relationship points at the same entity, the join field is
+ * appended so BillTo / ShipTo do not collide.
+ */
+export function RelatedEntitySectionKey(relationship, displayInFormPeers) {
+    const sameEntity = displayInFormPeers.filter((peer) => UUIDsEqual(peer.RelatedEntityID, relationship.RelatedEntityID));
+    if (sameEntity.length > 1) {
+        return FormSectionCamelCase(`${relationship.RelatedEntity} ${StripJoinFieldBrackets(relationship.RelatedEntityJoinField)}`);
+    }
+    return FormSectionCamelCase(relationship.RelatedEntity);
+}
+export function RelationshipDisplayName(relationship) {
+    const named = relationship.DisplayName?.trim();
+    const raw = named && named.length > 0 ? named : relationship.RelatedEntity;
+    return raw.replace(/^[A-Za-z][A-Za-z0-9_]*:\s+/, '').trim() || raw;
+}
+function isIsaChild(relationship, isaChildIds) {
+    return isaChildIds.some((id) => UUIDsEqual(id, relationship.RelatedEntityID));
+}
+function visibleRelationships(related, isaChildIds) {
+    const visible = related.filter((rel) => rel.DisplayInForm && !isIsaChild(rel, isaChildIds));
+    return [...visible].sort((a, b) => {
+        const aSeq = a.Sequence ?? 999999;
+        const bSeq = b.Sequence ?? 999999;
+        if (aSeq !== bSeq)
+            return aSeq - bSeq;
+        return a.RelatedEntity.localeCompare(b.RelatedEntity);
+    });
+}
+function entityMatches(registeredEntity, formEntity) {
+    return registeredEntity === '*' || registeredEntity === formEntity;
+}
+function applicableRegistrations(entityName, registrations) {
+    return registrations.filter((reg) => {
+        const entity = reg.Metadata.entity;
+        if (!entity || !entityMatches(entity, entityName))
+            return false;
+        // A related claim on entity:'*' would hide that grid on every form.
+        // Claims must name the form entity.
+        // Related / field-section claims on entity:'*' would hide panels on every
+        // form. Those claims must name the form entity.
+        if ((reg.Metadata.relatedEntity || reg.Metadata.replacesSectionKey) && entity === '*') {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Last-wins collapse by contributionKey (or derived related key).
+ * Highest Priority keeps the slot. Registrations without a key never collapse.
+ */
+export function CollapseFormPanelRegistrations(registrations) {
+    const winners = new Map();
+    let uniqueIndex = 0;
+    for (const reg of registrations) {
+        const key = ResolveContributionKey(reg.Metadata) || `__unique:${uniqueIndex++}`;
+        const incumbent = winners.get(key);
+        if (!incumbent || reg.Priority > incumbent.Priority) {
+            winners.set(key, reg);
+        }
+    }
+    return [...winners.values()];
+}
+function collapseRegistrations(registrations) {
+    const winners = new Map();
+    for (const reg of CollapseFormPanelRegistrations(registrations)) {
+        const key = ResolveContributionKey(reg.Metadata) || `${reg.Metadata.entity}:${reg.Metadata.slot}:${reg.Priority}`;
+        winners.set(key, reg);
+    }
+    return winners;
+}
+function stockWinner(relationship, peers) {
+    const join = StripJoinFieldBrackets(relationship.RelatedEntityJoinField);
+    return {
+        ContributionKey: RelatedContributionKey(relationship.RelatedEntity, join),
+        Slot: 'after-related',
+        SortKey: -(relationship.Sequence ?? 0),
+        Priority: 0,
+        Kind: 'stock-grid',
+        RelatedEntity: relationship.RelatedEntity,
+        RelatedJoinField: join,
+        BakedSectionKey: RelatedEntitySectionKey(relationship, peers),
+        DisplayName: RelationshipDisplayName(relationship),
+    };
+}
+function registeredWinner(key, reg, sectionKey, displayName) {
+    const meta = reg.Metadata;
+    return {
+        ContributionKey: key,
+        Slot: meta.slot,
+        SortKey: meta.sortKey ?? 0,
+        Priority: reg.Priority,
+        Kind: 'registered',
+        RelatedEntity: meta.relatedEntity,
+        RelatedJoinField: meta.relatedJoinField ? StripJoinFieldBrackets(meta.relatedJoinField) : undefined,
+        ReplacesSectionKey: meta.replacesSectionKey?.trim() || undefined,
+        BakedSectionKey: sectionKey,
+        DisplayName: displayName,
+    };
+}
+function sortWinners(winners) {
+    return [...winners].sort((a, b) => {
+        if (a.SortKey !== b.SortKey)
+            return b.SortKey - a.SortKey;
+        if (a.Priority !== b.Priority)
+            return b.Priority - a.Priority;
+        return a.ContributionKey.localeCompare(b.ContributionKey);
+    });
+}
+/**
+ * Resolve what belongs on the form. Stock grids are only those the template
+ * did not already bake and that no panel claimed.
+ */
+export function ResolveFormContributions(input) {
+    const peers = visibleRelationships(input.RelatedEntities, input.IsaChildEntityIDs);
+    const collapsed = collapseRegistrations(applicableRegistrations(input.EntityName, input.Registrations));
+    const baked = new Set(input.BakedSectionKeys);
+    const claimedKeys = new Set();
+    const registered = [];
+    for (const [key, reg] of collapsed) {
+        const related = reg.Metadata.relatedEntity?.trim();
+        const peer = related
+            ? peers.find((rel) => {
+                if (rel.RelatedEntity !== related)
+                    return false;
+                const wantJoin = StripJoinFieldBrackets(reg.Metadata.relatedJoinField);
+                if (!wantJoin)
+                    return true;
+                return StripJoinFieldBrackets(rel.RelatedEntityJoinField) === wantJoin;
+            })
+            : undefined;
+        const sectionKey = peer ? RelatedEntitySectionKey(peer, peers) : '';
+        if (related) {
+            claimedKeys.add(key);
+            // A claim that omits the join field covers every FK to that entity.
+            if (!StripJoinFieldBrackets(reg.Metadata.relatedJoinField)) {
+                for (const match of peers.filter((rel) => rel.RelatedEntity === related)) {
+                    claimedKeys.add(RelatedContributionKey(match.RelatedEntity, match.RelatedEntityJoinField));
+                }
+            }
+        }
+        registered.push(registeredWinner(key, reg, sectionKey, peer ? RelationshipDisplayName(peer) : related ?? key));
+    }
+    const hiddenBaked = [];
+    const stock = [];
+    if (input.ShowRelatedEntities) {
+        for (const rel of peers) {
+            const key = RelatedContributionKey(rel.RelatedEntity, rel.RelatedEntityJoinField);
+            const sectionKey = RelatedEntitySectionKey(rel, peers);
+            if (claimedKeys.has(key)) {
+                if (baked.has(sectionKey))
+                    hiddenBaked.push(sectionKey);
+                continue;
+            }
+            if (baked.has(sectionKey))
+                continue;
+            stock.push(stockWinner(rel, peers));
+        }
+    }
+    else {
+        for (const rel of peers) {
+            const key = RelatedContributionKey(rel.RelatedEntity, rel.RelatedEntityJoinField);
+            const sectionKey = RelatedEntitySectionKey(rel, peers);
+            if (claimedKeys.has(key) && baked.has(sectionKey))
+                hiddenBaked.push(sectionKey);
+        }
+    }
+    return {
+        Winners: sortWinners([...registered, ...stock]),
+        HiddenBakedSectionKeys: hiddenBaked,
+        StockGrids: sortWinners(stock),
+    };
+}
+/** Section keys a form should hide because a winning contribution claimed them. */
+export function ContributionHiddenSectionKeys(entityName, relatedEntities, isaChildEntityIDs, registrations) {
+    const resolved = ResolveFormContributions({
+        EntityName: entityName,
+        RelatedEntities: relatedEntities,
+        IsaChildEntityIDs: isaChildEntityIDs,
+        Registrations: registrations,
+        BakedSectionKeys: [],
+        ShowRelatedEntities: true,
+    });
+    const peers = visibleRelationships(relatedEntities, isaChildEntityIDs);
+    const keys = [];
+    for (const winner of resolved.Winners) {
+        if (winner.Kind !== 'registered')
+            continue;
+        if (winner.ReplacesSectionKey)
+            keys.push(winner.ReplacesSectionKey);
+        if (!winner.RelatedEntity)
+            continue;
+        const peer = peers.find((rel) => {
+            if (rel.RelatedEntity !== winner.RelatedEntity)
+                return false;
+            if (!winner.RelatedJoinField)
+                return true;
+            return StripJoinFieldBrackets(rel.RelatedEntityJoinField) === winner.RelatedJoinField;
+        });
+        if (peer)
+            keys.push(RelatedEntitySectionKey(peer, peers));
+    }
+    return keys;
+}
+/** @deprecated Use {@link ContributionHiddenSectionKeys}. */
+export function ClaimedRelatedSectionKeys(entityName, relatedEntities, isaChildEntityIDs, registrations) {
+    return ContributionHiddenSectionKeys(entityName, relatedEntities, isaChildEntityIDs, registrations);
+}
+//# sourceMappingURL=form-contribution.js.map

package/dist/lib/panel-slot/form-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-contribution.js","sourceRoot":"","sources":["../../../src/lib/panel-slot/form-contribution.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form contributions — pure resolve of what should appear on an entity form.\n *\n * A contribution is either a registered BaseFormPanel or the stock related-entity\n * grid. Related claims replace the stock/baked grid. No Angular, no ClassFactory\n * — the host queries registrations and feeds this.\n *\n * Section keys for related panels MUST match CodeGen's camelCase\n * (`angular-codegen.ts` `camelCase` + related-entity sectionKey). If they drift,\n * hide-baked and skip-baked miss and the user sees a double grid.\n */\nimport { UUIDsEqual } from '@memberjunction/global';\nimport { FormPanelRegistrationMetadata, FormPanelSlot } from './base-form-panel';\n\n/** Minimum relationship shape the composer reads. Satisfied by EntityRelationshipInfo. */\nexport interface FormContributionRelationship {\n    RelatedEntity: string;\n    RelatedEntityID: string;\n    RelatedEntityJoinField: string;\n    DisplayInForm: boolean;\n    DisplayName?: string | null;\n    Sequence?: number | null;\n}\n\nexport interface FormContributionRegistration {\n    Priority: number;\n    Metadata: FormPanelRegistrationMetadata;\n}\n\nexport interface ResolveFormContributionsInput {\n    EntityName: string;\n    RelatedEntities: readonly FormContributionRelationship[];\n    /** IS-A child entity IDs — CodeGen skips these (shown in the ISA side panel). */\n    IsaChildEntityIDs: readonly string[];\n    Registrations: readonly FormContributionRegistration[];\n    /** SectionKeys already projected as Variant=\"related-entity\" in the form template. */\n    BakedSectionKeys: readonly string[];\n    ShowRelatedEntities: boolean;\n}\n\nexport type FormContributionKind = 'registered' | 'stock-grid';\n\nexport interface FormContributionWinner {\n    ContributionKey: string;\n    Slot: FormPanelSlot;\n    SortKey: number;\n    Priority: number;\n    Kind: FormContributionKind;\n    RelatedEntity?: string;\n    RelatedJoinField?: string;\n    /** Field/other section this registered winner asked to hide. */\n    ReplacesSectionKey?: string;\n    BakedSectionKey: string;\n    DisplayName: string;\n}\n\nexport interface ResolveFormContributionsResult {\n    Winners: FormContributionWinner[];\n    /** CodeGen section keys to hide because a registered panel claimed them. */\n    HiddenBakedSectionKeys: string[];\n    /** Stock grids the host should mount (unclaimed and not already baked). */\n    StockGrids: FormContributionWinner[];\n}\n\n/** Strip wrapping [] from a join field, matching CodeGen's tab-name helper. */\nexport function StripJoinFieldBrackets(joinField: string | null | undefined): string {\n    return (joinField ?? '').trim().replace(/^\\[/, '').replace(/\\]$/, '');\n}\n\n/**\n * camelCase + identifier sanitize. Byte-compatible with\n * `CodeGenLib` `angular-codegen.ts` `camelCase` — do not \"improve\".\n */\nexport function FormSectionCamelCase(str: string): string {\n    const sanitized = str.replace(/[^a-zA-Z0-9\\s]/g, ' ');\n    let result = sanitized\n        .replace(/\\s(.)/g, (_match, char: string) => char.toUpperCase())\n        .replace(/\\s/g, '')\n        .replace(/^(.)/, (_match, char: string) => char.toLowerCase());\n    if (/^\\d/.test(result)) {\n        result = '_' + result;\n    }\n    return result.length === 0 ? 'section' : result;\n}\n\nexport function RelatedContributionKey(relatedEntity: string, joinField?: string | null): string {\n    return `related:${relatedEntity.trim()}:${StripJoinFieldBrackets(joinField)}`;\n}\n\nexport function ResolveContributionKey(meta: FormPanelRegistrationMetadata): string {\n    if (meta.contributionKey && meta.contributionKey.trim().length > 0) {\n        return meta.contributionKey.trim();\n    }\n    if (meta.relatedEntity && meta.relatedEntity.trim().length > 0) {\n        return RelatedContributionKey(meta.relatedEntity, meta.relatedJoinField);\n    }\n    return '';\n}\n\n/**\n * SectionKey CodeGen emits for a related-entity panel. When more than one\n * DisplayInForm relationship points at the same entity, the join field is\n * appended so BillTo / ShipTo do not collide.\n */\nexport function RelatedEntitySectionKey(\n    relationship: FormContributionRelationship,\n    displayInFormPeers: readonly FormContributionRelationship[],\n): string {\n    const sameEntity = displayInFormPeers.filter((peer) =>\n        UUIDsEqual(peer.RelatedEntityID, relationship.RelatedEntityID),\n    );\n    if (sameEntity.length > 1) {\n        return FormSectionCamelCase(\n            `${relationship.RelatedEntity} ${StripJoinFieldBrackets(relationship.RelatedEntityJoinField)}`,\n        );\n    }\n    return FormSectionCamelCase(relationship.RelatedEntity);\n}\n\nexport function RelationshipDisplayName(relationship: FormContributionRelationship): string {\n    const named = relationship.DisplayName?.trim();\n    const raw = named && named.length > 0 ? named : relationship.RelatedEntity;\n    return raw.replace(/^[A-Za-z][A-Za-z0-9_]*:\\s+/, '').trim() || raw;\n}\n\nfunction isIsaChild(relationship: FormContributionRelationship, isaChildIds: readonly string[]): boolean {\n    return isaChildIds.some((id) => UUIDsEqual(id, relationship.RelatedEntityID));\n}\n\nfunction visibleRelationships(\n    related: readonly FormContributionRelationship[],\n    isaChildIds: readonly string[],\n): FormContributionRelationship[] {\n    const visible = related.filter((rel) => rel.DisplayInForm && !isIsaChild(rel, isaChildIds));\n    return [...visible].sort((a, b) => {\n        const aSeq = a.Sequence ?? 999999;\n        const bSeq = b.Sequence ?? 999999;\n        if (aSeq !== bSeq) return aSeq - bSeq;\n        return a.RelatedEntity.localeCompare(b.RelatedEntity);\n    });\n}\n\nfunction entityMatches(registeredEntity: string, formEntity: string): boolean {\n    return registeredEntity === '*' || registeredEntity === formEntity;\n}\n\nfunction applicableRegistrations(\n    entityName: string,\n    registrations: readonly FormContributionRegistration[],\n): FormContributionRegistration[] {\n    return registrations.filter((reg) => {\n        const entity = reg.Metadata.entity;\n        if (!entity || !entityMatches(entity, entityName)) return false;\n        // A related claim on entity:'*' would hide that grid on every form.\n        // Claims must name the form entity.\n        // Related / field-section claims on entity:'*' would hide panels on every\n        // form. Those claims must name the form entity.\n        if ((reg.Metadata.relatedEntity || reg.Metadata.replacesSectionKey) && entity === '*') {\n            return false;\n        }\n        return true;\n    });\n}\n\n/**\n * Last-wins collapse by contributionKey (or derived related key).\n * Highest Priority keeps the slot. Registrations without a key never collapse.\n */\nexport function CollapseFormPanelRegistrations<T extends { Priority: number; Metadata: FormPanelRegistrationMetadata }>(\n    registrations: readonly T[],\n): T[] {\n    const winners = new Map<string, T>();\n    let uniqueIndex = 0;\n    for (const reg of registrations) {\n        const key = ResolveContributionKey(reg.Metadata) || `__unique:${uniqueIndex++}`;\n        const incumbent = winners.get(key);\n        if (!incumbent || reg.Priority > incumbent.Priority) {\n            winners.set(key, reg);\n        }\n    }\n    return [...winners.values()];\n}\n\nfunction collapseRegistrations(\n    registrations: readonly FormContributionRegistration[],\n): Map<string, FormContributionRegistration> {\n    const winners = new Map<string, FormContributionRegistration>();\n    for (const reg of CollapseFormPanelRegistrations(registrations)) {\n        const key = ResolveContributionKey(reg.Metadata) || `${reg.Metadata.entity}:${reg.Metadata.slot}:${reg.Priority}`;\n        winners.set(key, reg);\n    }\n    return winners;\n}\n\nfunction stockWinner(\n    relationship: FormContributionRelationship,\n    peers: readonly FormContributionRelationship[],\n): FormContributionWinner {\n    const join = StripJoinFieldBrackets(relationship.RelatedEntityJoinField);\n    return {\n        ContributionKey: RelatedContributionKey(relationship.RelatedEntity, join),\n        Slot: 'after-related',\n        SortKey: -(relationship.Sequence ?? 0),\n        Priority: 0,\n        Kind: 'stock-grid',\n        RelatedEntity: relationship.RelatedEntity,\n        RelatedJoinField: join,\n        BakedSectionKey: RelatedEntitySectionKey(relationship, peers),\n        DisplayName: RelationshipDisplayName(relationship),\n    };\n}\n\nfunction registeredWinner(\n    key: string,\n    reg: FormContributionRegistration,\n    sectionKey: string,\n    displayName: string,\n): FormContributionWinner {\n    const meta = reg.Metadata;\n    return {\n        ContributionKey: key,\n        Slot: meta.slot,\n        SortKey: meta.sortKey ?? 0,\n        Priority: reg.Priority,\n        Kind: 'registered',\n        RelatedEntity: meta.relatedEntity,\n        RelatedJoinField: meta.relatedJoinField ? StripJoinFieldBrackets(meta.relatedJoinField) : undefined,\n        ReplacesSectionKey: meta.replacesSectionKey?.trim() || undefined,\n        BakedSectionKey: sectionKey,\n        DisplayName: displayName,\n    };\n}\n\nfunction sortWinners(winners: FormContributionWinner[]): FormContributionWinner[] {\n    return [...winners].sort((a, b) => {\n        if (a.SortKey !== b.SortKey) return b.SortKey - a.SortKey;\n        if (a.Priority !== b.Priority) return b.Priority - a.Priority;\n        return a.ContributionKey.localeCompare(b.ContributionKey);\n    });\n}\n\n/**\n * Resolve what belongs on the form. Stock grids are only those the template\n * did not already bake and that no panel claimed.\n */\nexport function ResolveFormContributions(input: ResolveFormContributionsInput): ResolveFormContributionsResult {\n    const peers = visibleRelationships(input.RelatedEntities, input.IsaChildEntityIDs);\n    const collapsed = collapseRegistrations(applicableRegistrations(input.EntityName, input.Registrations));\n    const baked = new Set(input.BakedSectionKeys);\n\n    const claimedKeys = new Set<string>();\n    const registered: FormContributionWinner[] = [];\n    for (const [key, reg] of collapsed) {\n        const related = reg.Metadata.relatedEntity?.trim();\n        const peer = related\n            ? peers.find((rel) => {\n                  if (rel.RelatedEntity !== related) return false;\n                  const wantJoin = StripJoinFieldBrackets(reg.Metadata.relatedJoinField);\n                  if (!wantJoin) return true;\n                  return StripJoinFieldBrackets(rel.RelatedEntityJoinField) === wantJoin;\n              })\n            : undefined;\n        const sectionKey = peer ? RelatedEntitySectionKey(peer, peers) : '';\n        if (related) {\n            claimedKeys.add(key);\n            // A claim that omits the join field covers every FK to that entity.\n            if (!StripJoinFieldBrackets(reg.Metadata.relatedJoinField)) {\n                for (const match of peers.filter((rel) => rel.RelatedEntity === related)) {\n                    claimedKeys.add(RelatedContributionKey(match.RelatedEntity, match.RelatedEntityJoinField));\n                }\n            }\n        }\n        registered.push(\n            registeredWinner(key, reg, sectionKey, peer ? RelationshipDisplayName(peer) : related ?? key),\n        );\n    }\n\n    const hiddenBaked: string[] = [];\n    const stock: FormContributionWinner[] = [];\n    if (input.ShowRelatedEntities) {\n        for (const rel of peers) {\n            const key = RelatedContributionKey(rel.RelatedEntity, rel.RelatedEntityJoinField);\n            const sectionKey = RelatedEntitySectionKey(rel, peers);\n            if (claimedKeys.has(key)) {\n                if (baked.has(sectionKey)) hiddenBaked.push(sectionKey);\n                continue;\n            }\n            if (baked.has(sectionKey)) continue;\n            stock.push(stockWinner(rel, peers));\n        }\n    } else {\n        for (const rel of peers) {\n            const key = RelatedContributionKey(rel.RelatedEntity, rel.RelatedEntityJoinField);\n            const sectionKey = RelatedEntitySectionKey(rel, peers);\n            if (claimedKeys.has(key) && baked.has(sectionKey)) hiddenBaked.push(sectionKey);\n        }\n    }\n\n    return {\n        Winners: sortWinners([...registered, ...stock]),\n        HiddenBakedSectionKeys: hiddenBaked,\n        StockGrids: sortWinners(stock),\n    };\n}\n\n/** Section keys a form should hide because a winning contribution claimed them. */\nexport function ContributionHiddenSectionKeys(\n    entityName: string,\n    relatedEntities: readonly FormContributionRelationship[],\n    isaChildEntityIDs: readonly string[],\n    registrations: readonly FormContributionRegistration[],\n): string[] {\n    const resolved = ResolveFormContributions({\n        EntityName: entityName,\n        RelatedEntities: relatedEntities,\n        IsaChildEntityIDs: isaChildEntityIDs,\n        Registrations: registrations,\n        BakedSectionKeys: [],\n        ShowRelatedEntities: true,\n    });\n    const peers = visibleRelationships(relatedEntities, isaChildEntityIDs);\n    const keys: string[] = [];\n    for (const winner of resolved.Winners) {\n        if (winner.Kind !== 'registered') continue;\n        if (winner.ReplacesSectionKey) keys.push(winner.ReplacesSectionKey);\n        if (!winner.RelatedEntity) continue;\n        const peer = peers.find((rel) => {\n            if (rel.RelatedEntity !== winner.RelatedEntity) return false;\n            if (!winner.RelatedJoinField) return true;\n            return StripJoinFieldBrackets(rel.RelatedEntityJoinField) === winner.RelatedJoinField;\n        });\n        if (peer) keys.push(RelatedEntitySectionKey(peer, peers));\n    }\n    return keys;\n}\n\n/** @deprecated Use {@link ContributionHiddenSectionKeys}. */\nexport function ClaimedRelatedSectionKeys(\n    entityName: string,\n    relatedEntities: readonly FormContributionRelationship[],\n    isaChildEntityIDs: readonly string[],\n    registrations: readonly FormContributionRegistration[],\n): string[] {\n    return ContributionHiddenSectionKeys(entityName, relatedEntities, isaChildEntityIDs, registrations);\n}\n"]}

package/dist/lib/panel-slot/form-contributions.component.d.ts

@@ -0,0 +1,27 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
+import { BaseEntity } from '@memberjunction/core';
+import { BaseFormComponent } from '../base-form-component';
+import { FormContext } from '../types/form-types';
+import { type FormContributionWinner } from './form-contribution';
+import * as i0 from "@angular/core";
+/**
+ * Fills in related-entity grids that the form template did not bake and that
+ * no registered panel claimed. Lives in `<mj-record-form-container>` so every
+ * generated and custom form that uses the container picks it up.
+ *
+ * Claimed / extra panels still mount via `<mj-form-panel-slot>` — this host
+ * does not remount those (avoids doubles).
+ */
+export declare class FormContributionsComponent implements OnChanges {
+    Record: BaseEntity;
+    FormComponent: BaseFormComponent;
+    FormContext?: FormContext;
+    BakedSectionKeys: string[];
+    ShowRelatedEntities: boolean;
+    StockGrids: FormContributionWinner[];
+    ngOnChanges(changes: SimpleChanges): void;
+    private refresh;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormContributionsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormContributionsComponent, "mj-form-contributions", never, { "Record": { "alias": "Record"; "required": false; }; "FormComponent": { "alias": "FormComponent"; "required": false; }; "FormContext": { "alias": "FormContext"; "required": false; }; "BakedSectionKeys": { "alias": "BakedSectionKeys"; "required": false; }; "ShowRelatedEntities": { "alias": "ShowRelatedEntities"; "required": false; }; }, {}, never, never, false, never>;
+}
+//# sourceMappingURL=form-contributions.component.d.ts.map

package/dist/lib/panel-slot/form-contributions.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-contributions.component.d.ts","sourceRoot":"","sources":["../../../src/lib/panel-slot/form-contributions.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAEH,KAAK,sBAAsB,EAC9B,MAAM,qBAAqB,CAAC;;AAE7B;;;;;;;GAOG;AACH,qBAea,0BAA2B,YAAW,SAAS;IAC/C,MAAM,EAAG,UAAU,CAAC;IACpB,aAAa,EAAG,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAM;IAChC,mBAAmB,UAAQ;IAE7B,UAAU,EAAE,sBAAsB,EAAE,CAAM;IAE1C,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAOhD,OAAO,CAAC,OAAO;yCAhBN,0BAA0B;2CAA1B,0BAA0B;CAgCtC"}