@memberjunction/core-entities 6.2.0-edge.1 → 6.2.0-edge.3

package/dist/custom/FormScope/FormContributionClaims.d.ts

@@ -0,0 +1,20 @@
+import type { FormContributionSpecColumns } from './FormContributionRow.js';
+/**
+ * The claim rules of `MJ: Entity Form Contributions`, checked in code before anything is written.
+ *
+ * The database enforces the same rules with CHECK constraints, but a refused row save comes after
+ * its component was written. Lives here, beside the spec-to-row mapper, so the server and the
+ * browser can check a row the same way.
+ */
+/** The columns the claim rules read. */
+export type ContributionClaimColumns = Pick<FormContributionSpecColumns, 'Presentation' | 'Inclusion' | 'ChromeGroup' | 'RelatedEntityID' | 'RelatedJoinField' | 'ReplacesSectionKey' | 'ReplacesSectionKeys' | 'ReplacesFieldNames' | 'InSectionKey' | 'SectionPosition'>;
+/**
+ * Why the database would refuse this row's claim, or null when it would not.
+ *
+ * Checks `CK_EntityFormContribution_OneClaim` (a related grid, one section, several sections,
+ * fields of one section, or a place inside a section — at most one), `BareNoChrome`,
+ * `JoinNeedsRelated` and `SectionPositionNeedsSection`. The message names the spec fields, so an
+ * agent can correct its spec.
+ */
+export declare function ContributionClaimRefusal(row: ContributionClaimColumns): string | null;
+//# sourceMappingURL=FormContributionClaims.d.ts.map

package/dist/custom/FormScope/FormContributionClaims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionClaims.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionClaims.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,2BAA2B,EACjE,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,GACrF,oBAAoB,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAAC;AAWhH;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CAerF"}

package/dist/custom/FormScope/FormContributionClaims.js

@@ -0,0 +1,33 @@
+/** Each claim column, with the spec field an author sets to make that claim. */
+const CLAIMS = [
+    { Column: 'RelatedEntityID', SpecField: 'relatedEntity' },
+    { Column: 'ReplacesSectionKey', SpecField: 'replacesSectionKey' },
+    { Column: 'ReplacesSectionKeys', SpecField: 'replacesSectionKeys' },
+    { Column: 'ReplacesFieldNames', SpecField: 'replacesFieldNames' },
+    { Column: 'InSectionKey', SpecField: 'inSectionKey' },
+];
+/**
+ * Why the database would refuse this row's claim, or null when it would not.
+ *
+ * Checks `CK_EntityFormContribution_OneClaim` (a related grid, one section, several sections,
+ * fields of one section, or a place inside a section — at most one), `BareNoChrome`,
+ * `JoinNeedsRelated` and `SectionPositionNeedsSection`. The message names the spec fields, so an
+ * agent can correct its spec.
+ */
+export function ContributionClaimRefusal(row) {
+    const made = CLAIMS.filter((claim) => row[claim.Column] != null).map((claim) => claim.SpecField);
+    if (made.length > 1) {
+        return `A form contribution makes one claim at most, but this one sets ${made.join(' and ')}. Keep one of them.`;
+    }
+    if (row.Presentation === 'bare' && (row.Inclusion != null || row.ChromeGroup != null)) {
+        return 'A bare panel is never a rail item, so it takes no inclusion or chromeGroup.';
+    }
+    if (row.RelatedJoinField != null && row.RelatedEntityID == null) {
+        return 'relatedJoinField qualifies a related-grid claim, so it needs relatedEntity.';
+    }
+    if (row.SectionPosition != null && row.ReplacesFieldNames == null && row.InSectionKey == null) {
+        return 'sectionPosition places a panel inside a section, so it needs inSectionKey or replacesFieldNames.';
+    }
+    return null;
+}
+//# sourceMappingURL=FormContributionClaims.js.map

package/dist/custom/FormScope/FormContributionClaims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionClaims.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionClaims.ts"],"names":[],"mappings":"AAeA,gFAAgF;AAChF,MAAM,MAAM,GAAiF;IACzF,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE;IACzD,EAAE,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE;IACjE,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,qBAAqB,EAAE;IACnE,EAAE,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,EAAE;IACjE,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE;CACxD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA6B;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,kEAAkE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACrH,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,EAAE,CAAC;QACpF,OAAO,6EAA6E,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,IAAI,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QAC9D,OAAO,6EAA6E,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,IAAI,GAAG,CAAC,kBAAkB,IAAI,IAAI,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAC5F,OAAO,kGAAkG,CAAC;IAC9G,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/custom/FormScope/FormContributionLifecycle.d.ts

@@ -0,0 +1,43 @@
+import type { MJComponentEntity, MJEntityFormContributionEntity } from '../../generated/entities/__mj.js';
+/**
+ * How a form or panel goes live and is retired, as both write paths apply it: the server actions
+ * an agent calls, and the form's Manage drawer a person uses. Lives in a package both depend on,
+ * so the two cannot disagree about which row an activation retires.
+ */
+/** A form or panel's lifecycle, as the row stores it. */
+export type FormLifecycleStatus = MJEntityFormContributionEntity['Status'];
+/** The status of the Component a form or panel renders. */
+export type FormComponentStatus = NonNullable<MJComponentEntity['Status']>;
+/**
+ * The Component status that mirrors a form or panel's lifecycle: a live version is `Published`,
+ * a draft is `Draft`, a retired one is `Deprecated`. So a Component read on its own still says
+ * whether it is live. An unknown status reads as retired.
+ */
+export declare function FormLifecycleComponentStatus(status: FormLifecycleStatus): FormComponentStatus;
+/** The columns that place a form or panel row: its entity, audience, status and key. */
+export interface FormScopedRow {
+    ID: string;
+    EntityID: string;
+    Status: string;
+    Scope: string;
+    UserID: string | null;
+    RoleID: string | null;
+    /** Panels only. A full custom form has no key. */
+    ContributionKey?: string | null;
+}
+/**
+ * Whether two rows are for the same audience: the same scope, the same owner for a `User` row and
+ * the same role for a `Role` row. Every `Global` row is for the same audience.
+ */
+export declare function SameFormAudience(a: Pick<FormScopedRow, 'Scope' | 'UserID' | 'RoleID'>, b: Pick<FormScopedRow, 'Scope' | 'UserID' | 'RoleID'>): boolean;
+/**
+ * The Active panels that activating `target` must retire first: the same entity, the same
+ * audience and the same key, other than the target itself. A panel with no key has none: two
+ * keyless panels are two panels.
+ *
+ * `UQ_EntityFormContribution_Key` allows one Active row per entity, key and audience, so these are
+ * demoted before the target is promoted, in the same transaction. Keys are trimmed and compared
+ * without regard to case, which mirrors the index's case-insensitive collation.
+ */
+export declare function ActiveContributionSiblings<T extends FormScopedRow>(rows: readonly T[], target: FormScopedRow): T[];
+//# sourceMappingURL=FormContributionLifecycle.d.ts.map

package/dist/custom/FormScope/FormContributionLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionLifecycle.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEvG;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAE3E,2DAA2D;AAC3D,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAO7F;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,EACrD,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,GACtD,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,CAAC,EAAE,CASlH"}

package/dist/custom/FormScope/FormContributionLifecycle.js

@@ -0,0 +1,47 @@
+import { UUIDsEqual } from '@memberjunction/global';
+/**
+ * The Component status that mirrors a form or panel's lifecycle: a live version is `Published`,
+ * a draft is `Draft`, a retired one is `Deprecated`. So a Component read on its own still says
+ * whether it is live. An unknown status reads as retired.
+ */
+export function FormLifecycleComponentStatus(status) {
+    switch (status) {
+        case 'Active': return 'Published';
+        case 'Pending': return 'Draft';
+        case 'Inactive': return 'Deprecated';
+        default: return 'Deprecated';
+    }
+}
+/**
+ * Whether two rows are for the same audience: the same scope, the same owner for a `User` row and
+ * the same role for a `Role` row. Every `Global` row is for the same audience.
+ */
+export function SameFormAudience(a, b) {
+    if (a.Scope !== b.Scope)
+        return false;
+    if (a.Scope === 'User')
+        return UUIDsEqual(a.UserID ?? '', b.UserID ?? '');
+    if (a.Scope === 'Role')
+        return UUIDsEqual(a.RoleID ?? '', b.RoleID ?? '');
+    return true;
+}
+/**
+ * The Active panels that activating `target` must retire first: the same entity, the same
+ * audience and the same key, other than the target itself. A panel with no key has none: two
+ * keyless panels are two panels.
+ *
+ * `UQ_EntityFormContribution_Key` allows one Active row per entity, key and audience, so these are
+ * demoted before the target is promoted, in the same transaction. Keys are trimmed and compared
+ * without regard to case, which mirrors the index's case-insensitive collation.
+ */
+export function ActiveContributionSiblings(rows, target) {
+    const key = (target.ContributionKey ?? '').trim().toLowerCase();
+    if (!key)
+        return [];
+    return rows.filter((row) => row.Status === 'Active'
+        && !UUIDsEqual(row.ID, target.ID)
+        && UUIDsEqual(row.EntityID, target.EntityID)
+        && (row.ContributionKey ?? '').trim().toLowerCase() === key
+        && SameFormAudience(row, target));
+}
+//# sourceMappingURL=FormContributionLifecycle.js.map

package/dist/custom/FormScope/FormContributionLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionLifecycle.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAepD;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACpE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,OAAO,WAAW,CAAC;QAClC,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC;QAC/B,KAAK,UAAU,CAAC,CAAC,OAAO,YAAY,CAAC;QACrC,OAAO,CAAC,CAAC,OAAO,YAAY,CAAC;IACjC,CAAC;AACL,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC5B,CAAqD,EACrD,CAAqD;IAErD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAA0B,IAAkB,EAAE,MAAqB;IACzG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACvB,GAAG,CAAC,MAAM,KAAK,QAAQ;WACpB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;WAC9B,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;WACzC,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG;WACxD,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/custom/FormScope/FormContributionRow.d.ts

@@ -0,0 +1,40 @@
+import { type FormContributionSpec } from '@memberjunction/interactive-component-types/forms';
+import type { MJEntityFormContributionEntity } from '../../generated/entities/__mj.js';
+/**
+ * The spec-to-row mapping for `MJ: Entity Form Contributions`.
+ *
+ * The Create and Modify Form Contribution actions, and the Manage drawer's
+ * `FormPanelAdminService.SetPlacement` (`@memberjunction/ng-base-forms`), write rows through
+ * {@link ApplyContributionSpecToRow}, so the same spec produces the same row on every path.
+ * Lives here because both the server and the browser depend on this package.
+ */
+/** What {@link ApplyContributionSpecToRow} needs beyond the spec. */
+export interface ContributionRowOptions {
+    /** The ID of the entity `spec.relatedEntity` names, or null. */
+    relatedEntityID: string | null;
+    /** The registered name of that entity, which the derived key embeds. */
+    relatedEntityName: string | null;
+    /** The component name that seeds the key of a panel with no other key. */
+    componentName: string | null;
+}
+/** The contribution columns a spec's `formContribution` block decides. */
+export type FormContributionSpecColumns = Pick<MJEntityFormContributionEntity, 'Slot' | 'SortKey' | 'Presentation' | 'Title' | 'Icon' | 'Configuration' | 'Inclusion' | 'ChromeGroup' | 'RelatedEntityID' | 'RelatedJoinField' | 'ReplacesSectionKey' | 'ReplacesSectionKeys' | 'ReplacesFieldNames' | 'InSectionKey' | 'SectionPosition' | 'ContributionKey'>;
+/**
+ * Writes every column a contribution spec decides onto a row, and clears each claim column the
+ * spec does not set, so a row that changes its claim keeps nothing of the old one.
+ *
+ * The row it writes satisfies these CHECK constraints: `ReplacesFieldNamesShape` and
+ * `ReplacesSectionKeysShape` (an empty name list is stored as null), `JoinNeedsRelated` (a join
+ * field only with a related entity), `SectionPositionNeedsSection` (a position only for a panel
+ * drawn inside a section) and `BareNoChrome` (no Inclusion or ChromeGroup on a bare panel). It
+ * does not check `OneClaim`: a spec that makes two claims produces a row the database refuses.
+ *
+ * The caller resolves the related entity, because that needs metadata, and writes the columns
+ * that are not in the spec (scope, owner, status, precedence, names).
+ */
+export declare function ApplyContributionSpecToRow(row: FormContributionSpecColumns, spec: FormContributionSpec, opts: ContributionRowOptions): void;
+/** The columns a spec decides, on a new object, for checking a spec before any row is written. */
+export declare function ContributionSpecColumns(spec: FormContributionSpec, opts: ContributionRowOptions): FormContributionSpecColumns;
+/** The names in a `ReplacesFieldNames` or `ReplacesSectionKeys` cell. Empty for a cell that is not a JSON array. */
+export declare function ParseClaimedFieldNames(raw: string | null | undefined): string[];
+//# sourceMappingURL=FormContributionRow.d.ts.map

package/dist/custom/FormScope/FormContributionRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormContributionRow.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormContributionRow.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,KAAK,oBAAoB,EAC5B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACnC,gEAAgE;IAChE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,8BAA8B,EACvE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,GACtG,iBAAiB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,qBAAqB,GAAG,oBAAoB,GAC5G,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACtC,GAAG,EAAE,2BAA2B,EAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,sBAAsB,GAC7B,IAAI,CAKN;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,sBAAsB,GAAG,2BAA2B,CAS7H;AAED,oHAAoH;AACpH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAI/E"}

package/dist/custom/FormScope/FormContributionRow.js

@@ -0,0 +1,84 @@
+import { SafeJSONParse } from '@memberjunction/global';
+import { DEFAULT_FORM_CONTRIBUTION_SLOT, ResolveContributionWriteKey, } from '@memberjunction/interactive-component-types/forms';
+/**
+ * Writes every column a contribution spec decides onto a row, and clears each claim column the
+ * spec does not set, so a row that changes its claim keeps nothing of the old one.
+ *
+ * The row it writes satisfies these CHECK constraints: `ReplacesFieldNamesShape` and
+ * `ReplacesSectionKeysShape` (an empty name list is stored as null), `JoinNeedsRelated` (a join
+ * field only with a related entity), `SectionPositionNeedsSection` (a position only for a panel
+ * drawn inside a section) and `BareNoChrome` (no Inclusion or ChromeGroup on a bare panel). It
+ * does not check `OneClaim`: a spec that makes two claims produces a row the database refuses.
+ *
+ * The caller resolves the related entity, because that needs metadata, and writes the columns
+ * that are not in the spec (scope, owner, status, precedence, names).
+ */
+export function ApplyContributionSpecToRow(row, spec, opts) {
+    applyPlacement(row, spec);
+    applyChrome(row, spec);
+    applyClaims(row, spec, opts.relatedEntityID);
+    row.ContributionKey = ResolveContributionWriteKey(spec, opts.relatedEntityName, opts.componentName);
+}
+/** The columns a spec decides, on a new object, for checking a spec before any row is written. */
+export function ContributionSpecColumns(spec, opts) {
+    const row = {
+        Slot: DEFAULT_FORM_CONTRIBUTION_SLOT, SortKey: 0, Presentation: 'panel', Title: null, Icon: null,
+        Configuration: null, Inclusion: null, ChromeGroup: null, RelatedEntityID: null, RelatedJoinField: null,
+        ReplacesSectionKey: null, ReplacesSectionKeys: null, ReplacesFieldNames: null, InSectionKey: null,
+        SectionPosition: null, ContributionKey: null,
+    };
+    ApplyContributionSpecToRow(row, spec, opts);
+    return row;
+}
+/** The names in a `ReplacesFieldNames` or `ReplacesSectionKeys` cell. Empty for a cell that is not a JSON array. */
+export function ParseClaimedFieldNames(raw) {
+    if (!raw || raw.trim().length === 0)
+        return [];
+    const parsed = SafeJSONParse(raw, false);
+    return Array.isArray(parsed) ? cleanNames(parsed) : [];
+}
+function applyPlacement(row, spec) {
+    row.Slot = spec.slot ?? DEFAULT_FORM_CONTRIBUTION_SLOT;
+    row.SortKey = spec.sortKey ?? 0;
+    row.Presentation = spec.presentation;
+    row.Title = spec.title;
+    row.Icon = spec.icon ?? null;
+    row.Configuration = spec.configuration && Object.keys(spec.configuration).length > 0
+        ? JSON.stringify(spec.configuration) : null;
+}
+/** A bare panel is never a rail item, so it carries no rail metadata. */
+function applyChrome(row, spec) {
+    const bare = spec.presentation === 'bare';
+    row.Inclusion = bare ? null : spec.inclusion ?? null;
+    row.ChromeGroup = bare ? null : spec.chromeGroup ?? null;
+}
+function applyClaims(row, spec, relatedEntityID) {
+    row.RelatedEntityID = relatedEntityID;
+    row.RelatedJoinField = relatedEntityID ? spec.relatedJoinField?.trim() || null : null;
+    const fieldNames = cleanNames(spec.replacesFieldNames);
+    row.ReplacesFieldNames = jsonArrayOrNull(fieldNames);
+    // One section is stored in the single-key column whichever spec field named it.
+    const sections = cleanNames([
+        ...(spec.replacesSectionKey ? [spec.replacesSectionKey] : []),
+        ...(spec.replacesSectionKeys ?? []),
+    ]);
+    row.ReplacesSectionKey = sections.length === 1 ? sections[0] : null;
+    row.ReplacesSectionKeys = sections.length > 1 ? JSON.stringify(sections) : null;
+    const inSection = spec.inSectionKey?.trim() || null;
+    row.InSectionKey = inSection;
+    row.SectionPosition = inSection || fieldNames.length > 0 ? spec.sectionPosition ?? null : null;
+}
+/** Trimmed, non-empty names without repeats, in their first-seen order. */
+function cleanNames(names) {
+    const out = [];
+    for (const raw of names ?? []) {
+        const name = typeof raw === 'string' ? raw.trim() : '';
+        if (name.length > 0 && !out.includes(name))
+            out.push(name);
+    }
+    return out;
+}
+function jsonArrayOrNull(names) {
+    return names.length > 0 ? JSON.stringify(names) : null;
+}
+//# sourceMappingURL=FormContributionRow.js.map

package/dist/custom/FormScope/FormContributionRow.js.map

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

package/dist/custom/FormScope/FormPanelHides.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Where a user's hidden panels are stored.
+ *
+ * A user can hide a panel someone else put on their form and bring it back later. The list is an
+ * `MJ: User Settings` value per entity: a JSON array of panel keys. Lives here so the browser,
+ * which applies the hides, and the server, which reports the form a user sees, read one key.
+ */
+/** `MJ: User Settings` key prefix for the per-entity list of hidden panels. */
+export declare const FORM_PANEL_HIDE_SETTING_PREFIX = "mj.formPanels.hidden.";
+/** The settings key for one entity. Trimmed and lowercased, so case variants share one row. */
+export declare function FormPanelHideSettingKey(entityName: string): string;
+/** The hidden keys in a stored setting, trimmed and without repeats. A missing or malformed value hides nothing. */
+export declare function ParseHiddenFormPanelKeys(raw: string | null | undefined): string[];
+//# sourceMappingURL=FormPanelHides.d.ts.map

package/dist/custom/FormScope/FormPanelHides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPanelHides.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormPanelHides.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,oHAAoH;AACpH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAWjF"}

package/dist/custom/FormScope/FormPanelHides.js

@@ -0,0 +1,32 @@
+import { SafeJSONParse } from '@memberjunction/global';
+/**
+ * Where a user's hidden panels are stored.
+ *
+ * A user can hide a panel someone else put on their form and bring it back later. The list is an
+ * `MJ: User Settings` value per entity: a JSON array of panel keys. Lives here so the browser,
+ * which applies the hides, and the server, which reports the form a user sees, read one key.
+ */
+/** `MJ: User Settings` key prefix for the per-entity list of hidden panels. */
+export const FORM_PANEL_HIDE_SETTING_PREFIX = 'mj.formPanels.hidden.';
+/** The settings key for one entity. Trimmed and lowercased, so case variants share one row. */
+export function FormPanelHideSettingKey(entityName) {
+    return FORM_PANEL_HIDE_SETTING_PREFIX + (entityName ?? '').trim().toLowerCase();
+}
+/** The hidden keys in a stored setting, trimmed and without repeats. A missing or malformed value hides nothing. */
+export function ParseHiddenFormPanelKeys(raw) {
+    if (!raw)
+        return [];
+    const parsed = SafeJSONParse(raw, false);
+    if (!Array.isArray(parsed))
+        return [];
+    const keys = [];
+    for (const item of parsed) {
+        if (typeof item !== 'string')
+            continue;
+        const key = item.trim();
+        if (key && !keys.includes(key))
+            keys.push(key);
+    }
+    return keys;
+}
+//# sourceMappingURL=FormPanelHides.js.map

package/dist/custom/FormScope/FormPanelHides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormPanelHides.js","sourceRoot":"","sources":["../../../src/custom/FormScope/FormPanelHides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;AAEtE,+FAA+F;AAC/F,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACtD,OAAO,8BAA8B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpF,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACnE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,aAAa,CAAU,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/custom/FormScope/FormScopeRules.d.ts

@@ -0,0 +1,220 @@
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import type { MJEntityFormContributionEntity } from '../../generated/entities/__mj.js';
+/**
+ * Who may write a full custom form or a panel, and at which scope.
+ *
+ * A form or panel belongs to one user, to a role, or to everyone. Anyone may manage their own.
+ * Changing what OTHER people see — creating, editing, removing or re-aiming a role or everyone
+ * item — takes the {@link MANAGE_FORM_DEFAULTS_AUTHORIZATION} grant. Changing the component a
+ * form or panel draws changes that form or panel, so {@link ComponentWriteRefusal},
+ * {@link FormRowComponentRefusal} and {@link ComponentNameCollisionRefusal} apply the same rule to
+ * the `MJ: Components` row, to which component a row points at, and to a component's name.
+ *
+ * Lives here, in a package both the server and the browser depend on, so the two cannot disagree:
+ * the server-side entity subclasses enforce this rule on every write path, and the form's drawer
+ * calls the same function to decide which controls to draw.
+ */
+/** The authorization that lets a user publish a form or panel to a role or to everyone. */
+export declare const MANAGE_FORM_DEFAULTS_AUTHORIZATION = "Manage Form Defaults";
+/** Who a form or panel is for. Derived from the entity so it tracks the column's value list. */
+export type FormScope = MJEntityFormContributionEntity['Scope'];
+/** True when `value` is exactly `User`, `Role` or `Global`: no padding, this casing. */
+export declare function IsCanonicalFormScope(value: unknown): value is FormScope;
+export type FormScopeOperation = 'create' | 'update' | 'delete';
+/** One write to a form or panel, as the rule needs to see it. */
+export interface FormScopeWrite {
+    Operation: FormScopeOperation;
+    /** Scope before the write. Null on create. */
+    PriorScope: FormScope | null;
+    /** Owner before the write. Null on create, or when the item was not personal. */
+    PriorUserID: string | null;
+    /** Scope after the write. On delete, the same as the prior scope. */
+    NextScope: FormScope;
+    /** Owner after the write. */
+    NextUserID: string | null;
+    CallerID: string;
+    CallerHoldsGrant: boolean;
+}
+/**
+ * Why this write is not allowed, or null when it is.
+ *
+ * Both sides of the write are checked. A personal side must belong to the caller; a shared side
+ * needs the grant. Checking only the new side would let a user demote a shared item to their own
+ * and take it over; checking only the old side would let them promote their own to everyone.
+ *
+ * A scope is read the way the database reads it: a side is personal when its scope is `User`
+ * after trimming and case-folding. Any side whose scope is not exactly `User` (`Role`, `Global`,
+ * a padded or re-cased value, a blank, an unknown value) counts as shared and needs the grant.
+ */
+export declare function FormScopeWriteRefusal(write: FormScopeWrite): string | null;
+/**
+ * The `MJ: Components` columns that change what a form or panel using the component draws, or
+ * which component a lookup by name finds. An update by a holder of the grant is checked only when
+ * it changes one of them; an update by any other caller is always checked. A write with no caller
+ * (a trusted server context) is not checked.
+ */
+export declare const GUARDED_COMPONENT_FIELDS: readonly ["Specification", "Status", "Name", "Type", "Namespace"];
+/** One of {@link GUARDED_COMPONENT_FIELDS}. */
+export type GuardedComponentField = typeof GUARDED_COMPONENT_FIELDS[number];
+/** A full custom form or panel row that uses a component, as the component rules read it. */
+export interface FormComponentReference {
+    /** The row's ID. Read only to leave a row out of its own check. */
+    ID?: string;
+    Scope: FormScope;
+    UserID: string | null;
+}
+/** A component as the ownership test reads it. */
+export interface OwnedComponentCheck {
+    /** Every `MJ: Entity Form Contributions` and `MJ: Entity Form Overrides` row that uses the component. */
+    References: readonly FormComponentReference[];
+    /** True when the component's `Create` record change names the caller. Read only when no row uses it. */
+    CreatedByCaller: boolean;
+}
+/** One write to a `MJ: Components` row, as {@link ComponentWriteRefusal} needs to see it. */
+export interface ComponentWrite extends OwnedComponentCheck {
+    Operation: FormScopeOperation;
+    /** The columns whose new value differs from the stored one. Read on an update by a holder only. */
+    ChangedFields: readonly string[];
+    /** Null when there is no caller: a trusted server context. */
+    CallerID: string | null;
+    CallerHoldsGrant: boolean;
+}
+/**
+ * Whether this write by a caller must be checked against the forms and panels that use the
+ * component: a delete; any update by a caller without the grant, whatever columns it changes; or
+ * an update by a holder that changes a {@link GUARDED_COMPONENT_FIELDS} column. With no caller (a
+ * trusted server context) nothing is checked. A create is never checked here;
+ * {@link ComponentNameCollisionRefusal} covers its name.
+ */
+export declare function ComponentWriteIsGuarded(write: Pick<ComponentWrite, 'Operation' | 'ChangedFields' | 'CallerID' | 'CallerHoldsGrant'>): boolean;
+/**
+ * Whether a component is the caller's own: used by at least one row and only by the caller's own
+ * personal rows, or used by no row and created by the caller. A row whose scope is not exactly
+ * `User` is not the caller's own, whoever it names.
+ */
+export declare function IsCallersOwnComponent(component: OwnedComponentCheck, callerID: string): boolean;
+/**
+ * Why a write to a component is not allowed, or null when it is. Only a write that
+ * {@link ComponentWriteIsGuarded} selects is checked.
+ *
+ * Without the grant, any update and a delete are allowed only for a component of the caller's own
+ * ({@link IsCallersOwnComponent}): used by at least one row and only by the caller's own personal
+ * rows, or used by no row and created by the caller. Forms can load a component by name, so a
+ * component with no row may still be what someone else's form draws.
+ *
+ * With the grant, each row that uses the component is checked with {@link FormScopeWriteRefusal}
+ * as if the caller were updating that row in place: a `Role` or `Global` row passes, another
+ * user's personal row refuses, and the caller's own personal row passes. A component no row uses
+ * may be changed.
+ *
+ * A refusal for a caller without the grant says whether the grant would help. It says the grant
+ * would allow the write when a holder making the same write would pass. It says the grant does
+ * not change the answer only when a holder would be refused too: the write is one a holder is
+ * checked for, and another user's personal row uses the component.
+ */
+export declare function ComponentWriteRefusal(write: ComponentWrite): string | null;
+/** A form or panel row pointed at a component: what the row rule needs to see. */
+export interface FormRowComponentCheck extends OwnedComponentCheck {
+    /** The row being written. Null on create. A reference with this ID is left out. */
+    RowID: string | null;
+    /** Null when there is no caller: a trusted server context. */
+    CallerID: string | null;
+    CallerHoldsGrant: boolean;
+}
+/**
+ * Why a form or panel row may not point at this component, or null when it may. Applies when the
+ * row is created or its `ComponentID` changes.
+ *
+ * Without the grant, the component must be the caller's own ({@link IsCallersOwnComponent}): used
+ * only by the caller's own personal rows, or used by none and created by the caller. With the
+ * grant, every other row that uses it is checked as {@link ComponentWriteRefusal} checks it: a
+ * shared row passes, and another user's personal row refuses everyone, an Owner included. Without
+ * this, a personal row pointed at someone else's component would make that component the
+ * caller's to change, or lock it against everyone else.
+ */
+export declare function FormRowComponentRefusal(check: FormRowComponentCheck): string | null;
+/** A component's name, as {@link ComponentNameCollisionRefusal} needs to see it. */
+export interface ComponentNameCheck {
+    /** True on create, or when an update changes `Name` or `Namespace`. */
+    NamesComponent: boolean;
+    /** Every other component a lookup by this name finds, as the ownership test reads it. */
+    Collisions: readonly OwnedComponentCheck[];
+    /** Null when there is no caller: a trusted server context. */
+    CallerID: string | null;
+    CallerHoldsGrant: boolean;
+}
+/**
+ * Why a component may not take this name, or null when it may.
+ *
+ * A form's spec can load a component by name, and the lookup returns whichever match it finds
+ * first, so a second component with the same name could stand in for the first. Without the grant,
+ * a created or renamed component may share its name only with components that are the caller's
+ * own ({@link IsCallersOwnComponent}). A holder is not restricted, so they can resolve a collision.
+ */
+export declare function ComponentNameCollisionRefusal(check: ComponentNameCheck): string | null;
+/**
+ * How narrow a scope's audience is, for breaking a tie between two rows at the same precedence.
+ * Higher wins: `User` (3) over `Role` (2) over `Global` (1). A value that is not one of the three
+ * ranks 0, below every scope.
+ */
+export declare function ContributionScopeRank(scope: FormScope | null | undefined): number;
+/** The fields the same-key tie-break reads from a contribution. */
+export interface RankedFormContribution {
+    /** Last-wins rank; null or undefined reads as 0. */
+    Precedence: number | null | undefined;
+    /** The row's scope. Not read for a compiled panel. */
+    Scope?: FormScope | null;
+    /** True for a compiled `BaseFormPanel` registration, which wins every precedence tie against a row. */
+    Compiled?: boolean;
+}
+/**
+ * Whether `candidate` beats `incumbent` for one contribution key: higher precedence first; on a
+ * tie a compiled panel beats any row, and between rows the narrower scope wins
+ * ({@link ContributionScopeRank}). On a full tie the incumbent stays, so the result follows the
+ * order the caller walks the contributions in.
+ */
+export declare function FormContributionOutranks(candidate: RankedFormContribution, incumbent: RankedFormContribution): boolean;
+/**
+ * Whether a user may pick a full custom form and see it rendered.
+ *
+ * A live (`Active`) form always. A set-aside (`Inactive`) form only when it is the user's own
+ * `User` row: applying a second form sets the first aside, and the user must be able to swap back.
+ * A shared form set to `Inactive` was retracted by whoever manages it, so it is neither offered nor
+ * rendered. A `Pending` row is a draft and is never either. The browser's form resolver and the
+ * server's composition action both decide with this.
+ *
+ * It checks `Status` and `Scope` only, not whose row it is or which role it is for. Callers pass
+ * rows that already apply to the user: their own `User` rows, their roles' rows and `Global` rows.
+ */
+export declare function IsSelectableFormOverride(row: {
+    Status: string | null | undefined;
+    Scope: string | null | undefined;
+}): boolean;
+/**
+ * Entities whose forms show only the user's own full custom forms and panels, lowercased.
+ *
+ * A full custom form or a panel runs a React spec the runtime interprets. On an identity,
+ * permission or form-metadata surface, one published to a role or to everyone would change what
+ * other people see where it matters most, so only `User`-scope items render there.
+ */
+export declare const RESTRICTED_FORM_ENTITIES: ReadonlySet<string>;
+/**
+ * Whether a full custom form or panel at this scope may render on this entity's form.
+ *
+ * Always for `User`. Any other scope only off {@link RESTRICTED_FORM_ENTITIES}; the name is
+ * matched trimmed and case-folded. Applied where rows are read, so it holds however a row was
+ * written, `mj sync` and direct SQL included.
+ */
+export declare function FormScopeAllowedOnEntity(entityName: string | null | undefined, scope: string | null | undefined): boolean;
+/**
+ * Whether this user may publish forms and panels to a role or to everyone.
+ *
+ * An `Owner`-type user counts as holding it: they are the platform's top authority and must never
+ * be locked out of this. It does not let them touch other people's personal items — that is
+ * {@link FormScopeWriteRefusal}'s ownership rule, which no grant overrides.
+ *
+ * False without a user or when the authorization is not defined, so a deployment that has not
+ * synced the authorization yet fails closed.
+ */
+export declare function UserCanManageFormDefaults(user: UserInfo | null | undefined, provider: IMetadataProvider | null | undefined): boolean;
+//# sourceMappingURL=FormScopeRules.d.ts.map

package/dist/custom/FormScope/FormScopeRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormScopeRules.d.ts","sourceRoot":"","sources":["../../../src/custom/FormScope/FormScopeRules.ts"],"names":[],"mappings":"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"}