@memberjunction/ng-base-forms 5.38.0 → 5.39.0

package/dist/lib/field/linked-field-options.d.ts

@@ -0,0 +1,76 @@
+import { BaseSingleton } from '@memberjunction/global';
+/**
+ * Per (host-entity, FK-column) user overrides for the foreign-key search dropdown
+ * rendered by {@link MjFormFieldComponent}. Every field is optional — an entry
+ * exists only for the specific dropdowns a user has actively customized. Most users
+ * never customize anything, so the stored blob stays tiny (often empty).
+ */
+export interface LinkedFieldOption {
+    /**
+     * Related-entity field code name to search against. When unset, the dropdown
+     * searches the related entity's Name field (the default).
+     */
+    searchField?: string;
+    /**
+     * Related-entity field code name to sort the dropdown by. `null` (or unset) means
+     * natural order (whatever order the cache / DB returned).
+     */
+    sortField?: string | null;
+    /** Sort direction; only meaningful when {@link sortField} is set. */
+    sortDir?: 'asc' | 'desc';
+    /**
+     * User-resized column widths in pixels, keyed by related-entity field code name
+     * (the Name column uses its own field code name as the key). Columns the user
+     * never resized are absent and fall back to content-based sizing.
+     */
+    colWidths?: Record<string, number>;
+    /**
+     * Ordered list of extra-column field code names to display (besides the always-shown
+     * Name column). When set, fully overrides the default `DefaultInView`-derived columns —
+     * letting the user add normally-hidden fields (e.g. ID) or remove default ones.
+     * `undefined` = use the default column set. An empty array = only the Name column.
+     */
+    visibleFields?: string[];
+}
+/**
+ * The whole preference blob: a map of `"<hostEntity>|<fkField>"` (lowercased) →
+ * {@link LinkedFieldOption}. Persisted as a single `MJ: User Settings` row so we
+ * never spam the settings table with one key per field.
+ */
+export type LinkedFieldUserOptions = Record<string, LinkedFieldOption>;
+/**
+ * Reads/writes the user's per-FK-dropdown preferences (search scope, sort, column
+ * widths) through {@link UserInfoEngine} — server-side, cross-device, never
+ * `localStorage`. All writes are debounced (UI handlers can fire freely).
+ *
+ * Everything funnels through ONE settings key ({@link STORAGE_KEY}); reads are
+ * synchronous in-memory cache hits via `UserInfoEngine.GetSetting`, so calling
+ * `Get(...)` on every focus is cheap.
+ *
+ * Implemented as a {@link BaseSingleton} so the in-process parse cache is shared.
+ */
+export declare class LinkedFieldOptionsStore extends BaseSingleton<LinkedFieldOptionsStore> {
+    /** The single User Settings key holding the entire preference blob (v1 shape). */
+    private static readonly STORAGE_KEY;
+    protected constructor();
+    static get Instance(): LinkedFieldOptionsStore;
+    /** Compose the per-field map key from the host entity + FK column names. */
+    private buildKey;
+    /** Parse the full blob from the user setting (empty object when unset / malformed). */
+    private readAll;
+    /** Persist the full blob (debounced fire-and-forget). */
+    private writeAll;
+    /** Read the saved options for a (host entity, FK field) pair, or undefined. */
+    Get(entityName: string, fieldName: string): LinkedFieldOption | undefined;
+    /** Merge a shallow patch into a field's options and persist. */
+    private patch;
+    /** Persist the user's chosen search scope field for this dropdown. */
+    SetSearchField(entityName: string, fieldName: string, searchField: string): void;
+    /** Persist the user's chosen sort column + direction (or clear with sortField=null). */
+    SetSort(entityName: string, fieldName: string, sortField: string | null, sortDir: 'asc' | 'desc'): void;
+    /** Persist one column's resized width (px), merging into any existing widths. */
+    SetColWidth(entityName: string, fieldName: string, colField: string, width: number): void;
+    /** Persist the user's chosen set/order of visible extra columns. */
+    SetVisibleFields(entityName: string, fieldName: string, fields: string[]): void;
+}
+//# sourceMappingURL=linked-field-options.d.ts.map

package/dist/lib/field/linked-field-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-field-options.d.ts","sourceRoot":"","sources":["../../../src/lib/field/linked-field-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qEAAqE;IACrE,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IACjF,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAErE,SAAS;IAIT,WAAkB,QAAQ,IAAI,uBAAuB,CAEpD;IAED,4EAA4E;IAC5E,OAAO,CAAC,QAAQ;IAIhB,uFAAuF;IACvF,OAAO,CAAC,OAAO;IAWf,yDAAyD;IACzD,OAAO,CAAC,QAAQ;IAOhB,+EAA+E;IACxE,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKhF,gEAAgE;IAChE,OAAO,CAAC,KAAK;IAUb,sEAAsE;IAC/D,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIvF,wFAAwF;IACjF,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAI9G,iFAAiF;IAC1E,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhG,oEAAoE;IAC7D,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;CAGvF"}

package/dist/lib/field/linked-field-options.js

@@ -0,0 +1,80 @@
+import { BaseSingleton } from '@memberjunction/global';
+import { UserInfoEngine } from '@memberjunction/core-entities';
+/**
+ * Reads/writes the user's per-FK-dropdown preferences (search scope, sort, column
+ * widths) through {@link UserInfoEngine} — server-side, cross-device, never
+ * `localStorage`. All writes are debounced (UI handlers can fire freely).
+ *
+ * Everything funnels through ONE settings key ({@link STORAGE_KEY}); reads are
+ * synchronous in-memory cache hits via `UserInfoEngine.GetSetting`, so calling
+ * `Get(...)` on every focus is cheap.
+ *
+ * Implemented as a {@link BaseSingleton} so the in-process parse cache is shared.
+ */
+export class LinkedFieldOptionsStore extends BaseSingleton {
+    /** The single User Settings key holding the entire preference blob (v1 shape). */
+    static STORAGE_KEY = 'mj.linkedFieldUserOptions.v1';
+    constructor() {
+        super();
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    /** Compose the per-field map key from the host entity + FK column names. */
+    buildKey(entityName, fieldName) {
+        return `${(entityName ?? '').trim().toLowerCase()}|${(fieldName ?? '').trim().toLowerCase()}`;
+    }
+    /** Parse the full blob from the user setting (empty object when unset / malformed). */
+    readAll() {
+        const raw = UserInfoEngine.Instance.GetSetting(LinkedFieldOptionsStore.STORAGE_KEY);
+        if (!raw)
+            return {};
+        try {
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed === 'object' ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    /** Persist the full blob (debounced fire-and-forget). */
+    writeAll(all) {
+        UserInfoEngine.Instance.SetSettingDebounced(LinkedFieldOptionsStore.STORAGE_KEY, JSON.stringify(all));
+    }
+    /** Read the saved options for a (host entity, FK field) pair, or undefined. */
+    Get(entityName, fieldName) {
+        if (!entityName || !fieldName)
+            return undefined;
+        return this.readAll()[this.buildKey(entityName, fieldName)];
+    }
+    /** Merge a shallow patch into a field's options and persist. */
+    patch(entityName, fieldName, mutate) {
+        if (!entityName || !fieldName)
+            return; // no host context → don't persist
+        const all = this.readAll();
+        const key = this.buildKey(entityName, fieldName);
+        const opt = { ...(all[key] ?? {}) };
+        mutate(opt);
+        all[key] = opt;
+        this.writeAll(all);
+    }
+    /** Persist the user's chosen search scope field for this dropdown. */
+    SetSearchField(entityName, fieldName, searchField) {
+        this.patch(entityName, fieldName, o => { o.searchField = searchField; });
+    }
+    /** Persist the user's chosen sort column + direction (or clear with sortField=null). */
+    SetSort(entityName, fieldName, sortField, sortDir) {
+        this.patch(entityName, fieldName, o => { o.sortField = sortField; o.sortDir = sortDir; });
+    }
+    /** Persist one column's resized width (px), merging into any existing widths. */
+    SetColWidth(entityName, fieldName, colField, width) {
+        this.patch(entityName, fieldName, o => {
+            o.colWidths = { ...(o.colWidths ?? {}), [colField]: Math.round(width) };
+        });
+    }
+    /** Persist the user's chosen set/order of visible extra columns. */
+    SetVisibleFields(entityName, fieldName, fields) {
+        this.patch(entityName, fieldName, o => { o.visibleFields = [...fields]; });
+    }
+}
+//# sourceMappingURL=linked-field-options.js.map

package/dist/lib/field/linked-field-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-field-options.js","sourceRoot":"","sources":["../../../src/lib/field/linked-field-options.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseSingleton } from '@memberjunction/global';\nimport { UserInfoEngine } from '@memberjunction/core-entities';\n\n/**\n * Per (host-entity, FK-column) user overrides for the foreign-key search dropdown\n * rendered by {@link MjFormFieldComponent}. Every field is optional — an entry\n * exists only for the specific dropdowns a user has actively customized. Most users\n * never customize anything, so the stored blob stays tiny (often empty).\n */\nexport interface LinkedFieldOption {\n  /**\n   * Related-entity field code name to search against. When unset, the dropdown\n   * searches the related entity's Name field (the default).\n   */\n  searchField?: string;\n  /**\n   * Related-entity field code name to sort the dropdown by. `null` (or unset) means\n   * natural order (whatever order the cache / DB returned).\n   */\n  sortField?: string | null;\n  /** Sort direction; only meaningful when {@link sortField} is set. */\n  sortDir?: 'asc' | 'desc';\n  /**\n   * User-resized column widths in pixels, keyed by related-entity field code name\n   * (the Name column uses its own field code name as the key). Columns the user\n   * never resized are absent and fall back to content-based sizing.\n   */\n  colWidths?: Record<string, number>;\n  /**\n   * Ordered list of extra-column field code names to display (besides the always-shown\n   * Name column). When set, fully overrides the default `DefaultInView`-derived columns —\n   * letting the user add normally-hidden fields (e.g. ID) or remove default ones.\n   * `undefined` = use the default column set. An empty array = only the Name column.\n   */\n  visibleFields?: string[];\n}\n\n/**\n * The whole preference blob: a map of `\"<hostEntity>|<fkField>\"` (lowercased) →\n * {@link LinkedFieldOption}. Persisted as a single `MJ: User Settings` row so we\n * never spam the settings table with one key per field.\n */\nexport type LinkedFieldUserOptions = Record<string, LinkedFieldOption>;\n\n/**\n * Reads/writes the user's per-FK-dropdown preferences (search scope, sort, column\n * widths) through {@link UserInfoEngine} — server-side, cross-device, never\n * `localStorage`. All writes are debounced (UI handlers can fire freely).\n *\n * Everything funnels through ONE settings key ({@link STORAGE_KEY}); reads are\n * synchronous in-memory cache hits via `UserInfoEngine.GetSetting`, so calling\n * `Get(...)` on every focus is cheap.\n *\n * Implemented as a {@link BaseSingleton} so the in-process parse cache is shared.\n */\nexport class LinkedFieldOptionsStore extends BaseSingleton<LinkedFieldOptionsStore> {\n  /** The single User Settings key holding the entire preference blob (v1 shape). */\n  private static readonly STORAGE_KEY = 'mj.linkedFieldUserOptions.v1';\n\n  protected constructor() {\n    super();\n  }\n\n  public static get Instance(): LinkedFieldOptionsStore {\n    return super.getInstance<LinkedFieldOptionsStore>();\n  }\n\n  /** Compose the per-field map key from the host entity + FK column names. */\n  private buildKey(entityName: string, fieldName: string): string {\n    return `${(entityName ?? '').trim().toLowerCase()}|${(fieldName ?? '').trim().toLowerCase()}`;\n  }\n\n  /** Parse the full blob from the user setting (empty object when unset / malformed). */\n  private readAll(): LinkedFieldUserOptions {\n    const raw = UserInfoEngine.Instance.GetSetting(LinkedFieldOptionsStore.STORAGE_KEY);\n    if (!raw) return {};\n    try {\n      const parsed = JSON.parse(raw);\n      return parsed && typeof parsed === 'object' ? (parsed as LinkedFieldUserOptions) : {};\n    } catch {\n      return {};\n    }\n  }\n\n  /** Persist the full blob (debounced fire-and-forget). */\n  private writeAll(all: LinkedFieldUserOptions): void {\n    UserInfoEngine.Instance.SetSettingDebounced(\n      LinkedFieldOptionsStore.STORAGE_KEY,\n      JSON.stringify(all)\n    );\n  }\n\n  /** Read the saved options for a (host entity, FK field) pair, or undefined. */\n  public Get(entityName: string, fieldName: string): LinkedFieldOption | undefined {\n    if (!entityName || !fieldName) return undefined;\n    return this.readAll()[this.buildKey(entityName, fieldName)];\n  }\n\n  /** Merge a shallow patch into a field's options and persist. */\n  private patch(entityName: string, fieldName: string, mutate: (o: LinkedFieldOption) => void): void {\n    if (!entityName || !fieldName) return; // no host context → don't persist\n    const all = this.readAll();\n    const key = this.buildKey(entityName, fieldName);\n    const opt: LinkedFieldOption = { ...(all[key] ?? {}) };\n    mutate(opt);\n    all[key] = opt;\n    this.writeAll(all);\n  }\n\n  /** Persist the user's chosen search scope field for this dropdown. */\n  public SetSearchField(entityName: string, fieldName: string, searchField: string): void {\n    this.patch(entityName, fieldName, o => { o.searchField = searchField; });\n  }\n\n  /** Persist the user's chosen sort column + direction (or clear with sortField=null). */\n  public SetSort(entityName: string, fieldName: string, sortField: string | null, sortDir: 'asc' | 'desc'): void {\n    this.patch(entityName, fieldName, o => { o.sortField = sortField; o.sortDir = sortDir; });\n  }\n\n  /** Persist one column's resized width (px), merging into any existing widths. */\n  public SetColWidth(entityName: string, fieldName: string, colField: string, width: number): void {\n    this.patch(entityName, fieldName, o => {\n      o.colWidths = { ...(o.colWidths ?? {}), [colField]: Math.round(width) };\n    });\n  }\n\n  /** Persist the user's chosen set/order of visible extra columns. */\n  public SetVisibleFields(entityName: string, fieldName: string, fields: string[]): void {\n    this.patch(entityName, fieldName, o => { o.visibleFields = [...fields]; });\n  }\n}\n"]}

package/dist/lib/host/entity-form-host.component.d.ts

@@ -0,0 +1,159 @@
+import { EventEmitter, AfterViewInit, OnDestroy } from '@angular/core';
+import { CompositeKey, BaseEntity } from '@memberjunction/core';
+import { BaseAngularComponent } from '@memberjunction/ng-base-types';
+import { BaseFormComponent } from '../base-form-component';
+import { EntityFormConfig } from '../types/entity-form-config';
+import { FormNavigationEvent } from '../types/navigation-events';
+import { FormNotificationEvent, RecordSavedEvent, RecordDeletedEvent, RecordSaveFailedEvent, ValidationFailedEvent } from '../types/form-types';
+import * as i0 from "@angular/core";
+/**
+ * Presentation-agnostic host that renders ANY MemberJunction entity form —
+ * generated (`@RegisterClass` / CodeGen), custom (`*Extended`), or interactive
+ * (`EntityFormOverride`) — for a given record.
+ *
+ * This is the shared core extracted from Explorer's `SingleRecordComponent`. It
+ * encapsulates the full lifecycle: **resolve** which form to use (via
+ * {@link FormResolverService}, honoring variant overrides) → **load** the
+ * record (or accept a pre-loaded one) → **create** the form component
+ * dynamically → **bind** record / EditMode / Config / variants → **re-emit**
+ * the form's events → **tear down** cleanly.
+ *
+ * It has ZERO routing and ZERO Explorer dependencies — it only emits events.
+ * The surrounding surface (a full-page tab in Explorer, a dialog, or a
+ * slide-in) decides what to do with `Navigate`, `Notification`, etc.
+ *
+ * @example Explorer tab (thin wrapper subscribes + maps to NavigationService)
+ * ```html
+ * <mj-entity-form-host [EntityName]="entityName" [PrimaryKey]="pk"
+ *   (Navigate)="handleNavigation($event)" (Saved)="onSaved($event)">
+ * </mj-entity-form-host>
+ * ```
+ *
+ * @example Bind a pre-loaded record (dialog/slide-in)
+ * ```html
+ * <mj-entity-form-host [Record]="myEntity" [Config]="DIALOG_FORM_CONFIG"></mj-entity-form-host>
+ * ```
+ */
+export declare class MjEntityFormHostComponent extends BaseAngularComponent implements AfterViewInit, OnDestroy {
+    private cdr;
+    private formResolver;
+    /** Anchor for the dynamically-created form component. Always present in the DOM. */
+    private anchor;
+    private _entityName;
+    /** Entity name to load a record for. Ignored when {@link Record} is supplied. */
+    set EntityName(value: string | null);
+    get EntityName(): string | null;
+    private _primaryKey;
+    /** Primary key of the record to load. Empty key → new record. */
+    set PrimaryKey(value: CompositeKey);
+    get PrimaryKey(): CompositeKey;
+    private _record;
+    /**
+     * Pre-loaded record to bind directly. When supplied, the host skips the
+     * load step entirely and mounts the resolved form against this instance —
+     * `EntityName`/`PrimaryKey` are not required.
+     */
+    set Record(value: BaseEntity | null);
+    get Record(): BaseEntity | null;
+    /** New-record default values: URL-segment string or a plain object. */
+    NewRecordValues: string | Record<string, unknown> | null;
+    /**
+     * Render a single registered form **section** (a `BaseFormSectionComponent`
+     * registered as `'<EntityName>.<SectionName>'`) instead of the full form.
+     * When set, the full-form resolver / variant picker / toolbar container are
+     * bypassed — the section component renders its own fields and the host saves
+     * the record directly. Used for compact, focused editors (e.g. a quick-edit
+     * grid row). Leave null for the normal full-form behavior.
+     */
+    SectionName: string | null;
+    private _editMode;
+    /** Force edit mode. When omitted, new records start in edit, existing in read. */
+    set EditMode(value: boolean | null);
+    get EditMode(): boolean | null;
+    /** Per-instance form presentation config (toolbar, sections, width, links). */
+    Config: EntityFormConfig | null;
+    /** Form navigation request (record link, new record, hierarchy, email, external, dismiss). */
+    Navigate: EventEmitter<FormNavigationEvent>;
+    /** User-facing notification request (success/error/warning/info). */
+    Notification: EventEmitter<FormNotificationEvent>;
+    /** Emitted after the record is successfully saved (carries the live entity). */
+    Saved: EventEmitter<BaseEntity<unknown>>;
+    /** Re-emitted form `RecordSaved` (richer payload). */
+    RecordSaved: EventEmitter<RecordSavedEvent>;
+    /** Re-emitted form `RecordDeleted`. */
+    RecordDeleted: EventEmitter<RecordDeletedEvent>;
+    /** Re-emitted form `RecordSaveFailed`. */
+    RecordSaveFailed: EventEmitter<RecordSaveFailedEvent>;
+    /** Re-emitted form `ValidationFailed`. */
+    ValidationFailed: EventEmitter<ValidationFailedEvent>;
+    /** Re-emitted form `RecordReady` (record fully initialized). */
+    RecordReady: EventEmitter<BaseEntity<unknown>>;
+    /** Form asked to be dismissed (e.g. Discard on a brand-new record). */
+    Dismissed: EventEmitter<void>;
+    /** Initial load + mount finished (success path). */
+    LoadComplete: EventEmitter<void>;
+    /** Load failed; carries a user-facing title + detail. */
+    LoadError: EventEmitter<{
+        title: string;
+        detail: string;
+    }>;
+    /** The live form instance, emitted right after it's created (for power-user wiring). */
+    FormCreated: EventEmitter<BaseFormComponent>;
+    loading: boolean;
+    errorTitle: string | null;
+    errorDetail: string | null;
+    private _formComponentRef;
+    private _sectionRef;
+    private _isSection;
+    private _currentRecord;
+    private _saveHandlerSub;
+    private _formEventSubs;
+    private _viewInitialized;
+    /** The live form component instance, or null before mount / after teardown. */
+    get Form(): BaseFormComponent | null;
+    /** Whether the bound record has unsaved changes. */
+    get Dirty(): boolean;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /**
+     * Save the bound record. In full-form mode this runs the form's save
+     * pipeline (validation, pending records, notifications); in section mode the
+     * section component has no pipeline, so we save the record directly (the
+     * record's own save event still drives the `Saved` output).
+     */
+    Save(): Promise<boolean>;
+    /** Cancel edits (revert). Full-form mode uses the form's cancel pipeline. */
+    Cancel(): void;
+    private reload;
+    private loadAndMount;
+    /**
+     * The config to bind for a given record. For brand-new (unsaved) records we hide the
+     * `systemMetadata` section by default — its fields (audit timestamps, IDs, etc.) are
+     * empty and irrelevant until the record exists. Doesn't mutate the consumer's config,
+     * and defers entirely to a consumer that uses an explicit `VisibleSectionKeys` allowlist.
+     */
+    private effectiveConfigFor;
+    /**
+     * Section mode: resolve a `BaseFormSectionComponent` registered as
+     * `'<entity>.<section>'`, mount it, and bind the record. No resolver,
+     * variants, container, or form-event surface — section components are bare
+     * field editors; the host saves the record directly (see {@link Save}).
+     */
+    private mountSection;
+    /** Resolve the BaseEntity to bind: the supplied instance, or a freshly loaded/new one. */
+    private obtainRecord;
+    /** Push variant list + active selection and wire the variant-switch handler. */
+    private applyVariants;
+    /** Subscribe to the form's outputs and re-emit them through the host. */
+    private subscribeToFormEvents;
+    private applyNewRecordValues;
+    /** Set a field with TSType-aware coercion (shared by string + object paths). */
+    private setTypedField;
+    private fail;
+    private compositeKeysEqual;
+    private cleanupFormSubs;
+    private teardown;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MjEntityFormHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MjEntityFormHostComponent, "mj-entity-form-host", never, { "EntityName": { "alias": "EntityName"; "required": false; }; "PrimaryKey": { "alias": "PrimaryKey"; "required": false; }; "Record": { "alias": "Record"; "required": false; }; "NewRecordValues": { "alias": "NewRecordValues"; "required": false; }; "SectionName": { "alias": "SectionName"; "required": false; }; "EditMode": { "alias": "EditMode"; "required": false; }; "Config": { "alias": "Config"; "required": false; }; }, { "Navigate": "Navigate"; "Notification": "Notification"; "Saved": "Saved"; "RecordSaved": "RecordSaved"; "RecordDeleted": "RecordDeleted"; "RecordSaveFailed": "RecordSaveFailed"; "ValidationFailed": "ValidationFailed"; "RecordReady": "RecordReady"; "Dismissed": "Dismissed"; "LoadComplete": "LoadComplete"; "LoadError": "LoadError"; "FormCreated": "FormCreated"; }, never, never, false, never>;
+}
+//# sourceMappingURL=entity-form-host.component.d.ts.map

package/dist/lib/host/entity-form-host.component.d.ts.map

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