@memberjunction/ng-entity-viewer 5.27.1 → 5.28.0

package/dist/lib/recycle-bin/events/recycle-bin-events.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Event arg types for {@link RecycleBinComponent}.
+ *
+ * Follows the same Before/After cancelable pattern used by
+ * {@link EntityDataGridComponent}: any event whose name starts with
+ * `Before` carries `cancel: boolean` and `cancelReason?: string` so
+ * consumers can intercept and abort or take over processing.
+ */
+import { MJRecordChangeEntity } from '@memberjunction/core-entities';
+/** Forward type to avoid circular dependency with the component. */
+export type RecycleBinComponentRef = unknown;
+/**
+ * Base shape for every Recycle Bin event.
+ */
+export interface RecycleBinEventArgs {
+    /** The Recycle Bin component instance that raised the event. */
+    bin: RecycleBinComponentRef;
+    /** When the event was raised. */
+    timestamp: Date;
+    /** The entity the bin is operating on. */
+    entityName: string;
+}
+/**
+ * Base shape for cancelable Recycle Bin events. Set `cancel = true` to
+ * abort the operation; the matching `after*` event will not fire.
+ */
+export interface CancelableRecycleBinEventArgs extends RecycleBinEventArgs {
+    /** Set to true to abort. */
+    cancel: boolean;
+    /** Optional reason surfaced by the consumer. */
+    cancelReason?: string;
+}
+export interface BeforeRecycleBinOpenEventArgs extends CancelableRecycleBinEventArgs {
+    /** Reserved for future filter/scope params the consumer may want to validate. */
+    readonly _kind: 'beforeRecycleBinOpen';
+}
+export interface AfterRecycleBinOpenEventArgs extends RecycleBinEventArgs {
+    /** Number of distinct deleted records discovered when the bin opened. */
+    deletedRecordCount: number;
+    readonly _kind: 'afterRecycleBinOpen';
+}
+/**
+ * One deleted-record entry surfaced by the bin. Built from the most recent
+ * Delete RecordChange for a given EntityID + RecordID.
+ */
+export interface RecycleBinEntry {
+    /** The Delete RecordChange row that captured this snapshot. */
+    RecordChange: MJRecordChangeEntity;
+    /** The composite-key string that identified the record. */
+    RecordID: string;
+    /** The user-friendly summary line (e.g., a name field from the snapshot). */
+    DisplaySummary: string;
+    /** Up to N supporting fields chosen heuristically for the card. */
+    SupportingFields: Array<{
+        Name: string;
+        DisplayName: string;
+        Value: string;
+    }>;
+}
+export interface BeforeRecordRestoreEventArgs extends CancelableRecycleBinEventArgs {
+    entry: RecycleBinEntry;
+    readonly _kind: 'beforeRecordRestore';
+}
+export interface AfterRecordRestoreEventArgs extends RecycleBinEventArgs {
+    entry: RecycleBinEntry;
+    /** True when the underlying insert succeeded. */
+    success: boolean;
+    /** Error message when success is false. */
+    errorMessage?: string;
+    readonly _kind: 'afterRecordRestore';
+}
+export interface BeforeRestoreCommitEventArgs extends CancelableRecycleBinEventArgs {
+    entry: RecycleBinEntry;
+    /** Field values that will be applied to the new record. */
+    fieldValues: Array<{
+        FieldName: string;
+        Value: unknown;
+    }>;
+    /** Optional reason captured at restore time. */
+    reason: string | null;
+    readonly _kind: 'beforeRestoreCommit';
+}
+export interface AfterRestoreCommitEventArgs extends RecycleBinEventArgs {
+    entry: RecycleBinEntry;
+    success: boolean;
+    /** ID of the newly created record (when success). */
+    newRecordID?: string;
+    errorMessage?: string;
+    readonly _kind: 'afterRestoreCommit';
+}
+//# sourceMappingURL=recycle-bin-events.d.ts.map

package/dist/lib/recycle-bin/events/recycle-bin-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recycle-bin-events.d.ts","sourceRoot":"","sources":["../../../../src/lib/recycle-bin/events/recycle-bin-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,oEAAoE;AACpE,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,GAAG,EAAE,sBAAsB,CAAC;IAC5B,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,6BAA8B,SAAQ,6BAA6B;IAClF,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAED,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAID;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,YAAY,EAAE,oBAAoB,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACjF,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,KAAK,EAAE,eAAe,CAAC;IACvB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC;AAID,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACjF,KAAK,EAAE,eAAe,CAAC;IACvB,2DAA2D;IAC3D,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,gDAAgD;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;CACtC"}

package/dist/lib/recycle-bin/events/recycle-bin-events.js

@@ -0,0 +1,10 @@
+/**
+ * Event arg types for {@link RecycleBinComponent}.
+ *
+ * Follows the same Before/After cancelable pattern used by
+ * {@link EntityDataGridComponent}: any event whose name starts with
+ * `Before` carries `cancel: boolean` and `cancelReason?: string` so
+ * consumers can intercept and abort or take over processing.
+ */
+export {};
+//# sourceMappingURL=recycle-bin-events.js.map

package/dist/lib/recycle-bin/events/recycle-bin-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recycle-bin-events.js","sourceRoot":"","sources":["../../../../src/lib/recycle-bin/events/recycle-bin-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * Event arg types for {@link RecycleBinComponent}.\n *\n * Follows the same Before/After cancelable pattern used by\n * {@link EntityDataGridComponent}: any event whose name starts with\n * `Before` carries `cancel: boolean` and `cancelReason?: string` so\n * consumers can intercept and abort or take over processing.\n */\n\nimport { MJRecordChangeEntity } from '@memberjunction/core-entities';\n\n/** Forward type to avoid circular dependency with the component. */\nexport type RecycleBinComponentRef = unknown;\n\n/**\n * Base shape for every Recycle Bin event.\n */\nexport interface RecycleBinEventArgs {\n  /** The Recycle Bin component instance that raised the event. */\n  bin: RecycleBinComponentRef;\n  /** When the event was raised. */\n  timestamp: Date;\n  /** The entity the bin is operating on. */\n  entityName: string;\n}\n\n/**\n * Base shape for cancelable Recycle Bin events. Set `cancel = true` to\n * abort the operation; the matching `after*` event will not fire.\n */\nexport interface CancelableRecycleBinEventArgs extends RecycleBinEventArgs {\n  /** Set to true to abort. */\n  cancel: boolean;\n  /** Optional reason surfaced by the consumer. */\n  cancelReason?: string;\n}\n\n// ─── Open / Close ──────────────────────────────────────────────────\n\nexport interface BeforeRecycleBinOpenEventArgs extends CancelableRecycleBinEventArgs {\n  /** Reserved for future filter/scope params the consumer may want to validate. */\n  readonly _kind: 'beforeRecycleBinOpen';\n}\n\nexport interface AfterRecycleBinOpenEventArgs extends RecycleBinEventArgs {\n  /** Number of distinct deleted records discovered when the bin opened. */\n  deletedRecordCount: number;\n  readonly _kind: 'afterRecycleBinOpen';\n}\n\n// ─── Per-record restore (the user clicked Restore on a single card) ─\n\n/**\n * One deleted-record entry surfaced by the bin. Built from the most recent\n * Delete RecordChange for a given EntityID + RecordID.\n */\nexport interface RecycleBinEntry {\n  /** The Delete RecordChange row that captured this snapshot. */\n  RecordChange: MJRecordChangeEntity;\n  /** The composite-key string that identified the record. */\n  RecordID: string;\n  /** The user-friendly summary line (e.g., a name field from the snapshot). */\n  DisplaySummary: string;\n  /** Up to N supporting fields chosen heuristically for the card. */\n  SupportingFields: Array<{ Name: string; DisplayName: string; Value: string }>;\n}\n\nexport interface BeforeRecordRestoreEventArgs extends CancelableRecycleBinEventArgs {\n  entry: RecycleBinEntry;\n  readonly _kind: 'beforeRecordRestore';\n}\n\nexport interface AfterRecordRestoreEventArgs extends RecycleBinEventArgs {\n  entry: RecycleBinEntry;\n  /** True when the underlying insert succeeded. */\n  success: boolean;\n  /** Error message when success is false. */\n  errorMessage?: string;\n  readonly _kind: 'afterRecordRestore';\n}\n\n// ─── Restore commit (after the user confirms in the preview panel) ──\n\nexport interface BeforeRestoreCommitEventArgs extends CancelableRecycleBinEventArgs {\n  entry: RecycleBinEntry;\n  /** Field values that will be applied to the new record. */\n  fieldValues: Array<{ FieldName: string; Value: unknown }>;\n  /** Optional reason captured at restore time. */\n  reason: string | null;\n  readonly _kind: 'beforeRestoreCommit';\n}\n\nexport interface AfterRestoreCommitEventArgs extends RecycleBinEventArgs {\n  entry: RecycleBinEntry;\n  success: boolean;\n  /** ID of the newly created record (when success). */\n  newRecordID?: string;\n  errorMessage?: string;\n  readonly _kind: 'afterRestoreCommit';\n}\n"]}

package/dist/lib/recycle-bin/recycle-bin-chip.component.d.ts

@@ -0,0 +1,75 @@
+import { ChangeDetectorRef, EventEmitter, OnInit } from '@angular/core';
+import { UserInfo } from '@memberjunction/core';
+import { AfterRecordRestoreEventArgs, AfterRecycleBinOpenEventArgs, AfterRestoreCommitEventArgs, BeforeRecordRestoreEventArgs, BeforeRecycleBinOpenEventArgs, BeforeRestoreCommitEventArgs } from './events/recycle-bin-events';
+import * as i0 from "@angular/core";
+/**
+ * Tiny composite that renders a Recycle Bin **chip button** (with live
+ * deleted-record count badge) and hosts the {@link RecycleBinComponent}
+ * slide-in panel that opens when clicked.
+ *
+ * Designed to be dropped into any toolbar in three lines:
+ *
+ * @example
+ *   <mj-recycle-bin-chip
+ *     *ngIf="ShowRecycleBin"
+ *     [EntityName]="effectiveEntity?.Name">
+ *   </mj-recycle-bin-chip>
+ *
+ * The chip auto-hides itself when:
+ *  - No `EntityName` is provided
+ *  - The entity has `TrackRecordChanges = false`
+ *  - The user lacks `CanDelete` permission on the entity
+ *  - The deleted-record count is zero
+ *
+ * Each of those is the right behavior to avoid cluttering toolbars on
+ * entities where the bin is irrelevant.
+ *
+ * Consumers who want to intercept any bin action can pass through the
+ * standard cancelable Before/After events.
+ */
+export declare class RecycleBinChipComponent implements OnInit {
+    private cdr;
+    /**
+     * Entity name whose deleted records will be surfaced. When null/empty,
+     * the chip hides itself entirely.
+     */
+    private _entityName;
+    set EntityName(value: string | null);
+    get EntityName(): string | null;
+    /**
+     * Optional context user for permission checks. Falls back to
+     * `Metadata.Provider.CurrentUser` when omitted.
+     */
+    ContextUser: UserInfo | null;
+    BeforeRecycleBinOpen: EventEmitter<BeforeRecycleBinOpenEventArgs>;
+    AfterRecycleBinOpen: EventEmitter<AfterRecycleBinOpenEventArgs>;
+    BeforeRecordRestore: EventEmitter<BeforeRecordRestoreEventArgs>;
+    AfterRecordRestore: EventEmitter<AfterRecordRestoreEventArgs>;
+    BeforeRestoreCommit: EventEmitter<BeforeRestoreCommitEventArgs>;
+    AfterRestoreCommit: EventEmitter<AfterRestoreCommitEventArgs>;
+    DeletedCount: number;
+    PanelVisible: boolean;
+    IsVisible: boolean;
+    CanDelete: boolean;
+    TracksChanges: boolean;
+    private isInitialized;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    Toggle(): void;
+    OnPanelClosed(): void;
+    /**
+     * After-events bubble through but we also use them to refresh the count
+     * — restoring a record means it's no longer "deleted".
+     */
+    OnAfterRecycleBinOpen(e: AfterRecycleBinOpenEventArgs): void;
+    OnAfterRestoreCommit(e: AfterRestoreCommitEventArgs): void;
+    /**
+     * Loads the deleted-record count and visibility flags. Called on init,
+     * when EntityName changes, and after the panel closes (so a restore
+     * decrements the badge).
+     */
+    private refreshCount;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RecycleBinChipComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RecycleBinChipComponent, "mj-recycle-bin-chip", never, { "EntityName": { "alias": "EntityName"; "required": false; }; "ContextUser": { "alias": "ContextUser"; "required": false; }; }, { "BeforeRecycleBinOpen": "BeforeRecycleBinOpen"; "AfterRecycleBinOpen": "AfterRecycleBinOpen"; "BeforeRecordRestore": "BeforeRecordRestore"; "AfterRecordRestore": "AfterRecordRestore"; "BeforeRestoreCommit": "BeforeRestoreCommit"; "AfterRestoreCommit": "AfterRestoreCommit"; }, never, never, false, never>;
+}
+//# sourceMappingURL=recycle-bin-chip.component.d.ts.map

package/dist/lib/recycle-bin/recycle-bin-chip.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recycle-bin-chip.component.d.ts","sourceRoot":"","sources":["../../../src/lib/recycle-bin/recycle-bin-chip.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EACjB,YAAY,EAEZ,MAAM,EAGP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAqB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBA+Da,uBAAwB,YAAW,MAAM;IA0CxC,OAAO,CAAC,GAAG;IAzCvB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAuB;IAC1C,IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAKlC;IACD,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED;;;OAGG;IACM,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAInC,oBAAoB,8CAAqD;IACzE,mBAAmB,6CAAoD;IACvE,mBAAmB,6CAAoD;IACvE,kBAAkB,4CAAmD;IACrE,mBAAmB,6CAAoD;IACvE,kBAAkB,4CAAmD;IAIxE,YAAY,SAAK;IACjB,YAAY,UAAS;IACrB,SAAS,UAAS;IAClB,SAAS,UAAS;IAClB,aAAa,UAAS;IAE7B,OAAO,CAAC,aAAa,CAAS;gBAEV,GAAG,EAAE,iBAAiB;IAE1C,QAAQ,IAAI,IAAI;IAKT,MAAM,IAAI,IAAI;IAKd,aAAa,IAAI,IAAI;IAM5B;;;OAGG;IACI,qBAAqB,CAAC,CAAC,EAAE,4BAA4B,GAAG,IAAI;IAM5D,oBAAoB,CAAC,CAAC,EAAE,2BAA2B,GAAG,IAAI;IAMjE;;;;OAIG;YACW,YAAY;yCAjFf,uBAAuB;2CAAvB,uBAAuB;CA6InC"}

package/dist/lib/recycle-bin/recycle-bin-chip.component.js

@@ -0,0 +1,228 @@
+import { Component, ChangeDetectionStrategy, EventEmitter, Input, Output, ViewEncapsulation, } from '@angular/core';
+import { Metadata, RunView } from '@memberjunction/core';
+import * as i0 from "@angular/core";
+import * as i1 from "./recycle-bin.component";
+function RecycleBinChipComponent_Conditional_0_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "button", 0);
+    i0.ɵɵlistener("click", function RecycleBinChipComponent_Conditional_0_Template_button_click_0_listener() { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.Toggle()); });
+    i0.ɵɵelement(1, "i", 1);
+    i0.ɵɵelementStart(2, "span", 2);
+    i0.ɵɵtext(3, "Recycle Bin");
+    i0.ɵɵelementEnd();
+    i0.ɵɵelementStart(4, "span", 3);
+    i0.ɵɵtext(5);
+    i0.ɵɵelementEnd()();
+    i0.ɵɵelementStart(6, "mj-recycle-bin", 4);
+    i0.ɵɵlistener("Closed", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_Closed_6_listener() { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnPanelClosed()); })("BeforeRecycleBinOpen", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_BeforeRecycleBinOpen_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.BeforeRecycleBinOpen.emit($event)); })("AfterRecycleBinOpen", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_AfterRecycleBinOpen_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnAfterRecycleBinOpen($event)); })("BeforeRecordRestore", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_BeforeRecordRestore_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.BeforeRecordRestore.emit($event)); })("AfterRecordRestore", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_AfterRecordRestore_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.AfterRecordRestore.emit($event)); })("BeforeRestoreCommit", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_BeforeRestoreCommit_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.BeforeRestoreCommit.emit($event)); })("AfterRestoreCommit", function RecycleBinChipComponent_Conditional_0_Template_mj_recycle_bin_AfterRestoreCommit_6_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.OnAfterRestoreCommit($event)); });
+    i0.ɵɵelementEnd();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵattribute("title", "Recycle Bin \u00B7 " + ctx_r1.DeletedCount + " deleted record" + (ctx_r1.DeletedCount === 1 ? "" : "s"));
+    i0.ɵɵadvance(5);
+    i0.ɵɵtextInterpolate(ctx_r1.DeletedCount);
+    i0.ɵɵadvance();
+    i0.ɵɵproperty("Visible", ctx_r1.PanelVisible)("EntityName", ctx_r1.EntityName)("ContextUser", ctx_r1.ContextUser);
+} }
+/**
+ * Tiny composite that renders a Recycle Bin **chip button** (with live
+ * deleted-record count badge) and hosts the {@link RecycleBinComponent}
+ * slide-in panel that opens when clicked.
+ *
+ * Designed to be dropped into any toolbar in three lines:
+ *
+ * @example
+ *   <mj-recycle-bin-chip
+ *     *ngIf="ShowRecycleBin"
+ *     [EntityName]="effectiveEntity?.Name">
+ *   </mj-recycle-bin-chip>
+ *
+ * The chip auto-hides itself when:
+ *  - No `EntityName` is provided
+ *  - The entity has `TrackRecordChanges = false`
+ *  - The user lacks `CanDelete` permission on the entity
+ *  - The deleted-record count is zero
+ *
+ * Each of those is the right behavior to avoid cluttering toolbars on
+ * entities where the bin is irrelevant.
+ *
+ * Consumers who want to intercept any bin action can pass through the
+ * standard cancelable Before/After events.
+ */
+export class RecycleBinChipComponent {
+    cdr;
+    /**
+     * Entity name whose deleted records will be surfaced. When null/empty,
+     * the chip hides itself entirely.
+     */
+    _entityName = null;
+    set EntityName(value) {
+        if (value !== this._entityName) {
+            this._entityName = value;
+            if (this.isInitialized)
+                this.refreshCount();
+        }
+    }
+    get EntityName() {
+        return this._entityName;
+    }
+    /**
+     * Optional context user for permission checks. Falls back to
+     * `Metadata.Provider.CurrentUser` when omitted.
+     */
+    ContextUser = null;
+    // ─── Re-emitted events from the inner panel ────────────────────
+    BeforeRecycleBinOpen = new EventEmitter();
+    AfterRecycleBinOpen = new EventEmitter();
+    BeforeRecordRestore = new EventEmitter();
+    AfterRecordRestore = new EventEmitter();
+    BeforeRestoreCommit = new EventEmitter();
+    AfterRestoreCommit = new EventEmitter();
+    // ─── Public template state ──────────────────────────────────────
+    DeletedCount = 0;
+    PanelVisible = false;
+    IsVisible = false;
+    CanDelete = false;
+    TracksChanges = false;
+    isInitialized = false;
+    constructor(cdr) {
+        this.cdr = cdr;
+    }
+    ngOnInit() {
+        this.isInitialized = true;
+        this.refreshCount();
+    }
+    Toggle() {
+        this.PanelVisible = !this.PanelVisible;
+        this.cdr.markForCheck();
+    }
+    OnPanelClosed() {
+        this.PanelVisible = false;
+        // Refresh count — a restore may have removed an entry from the bin
+        this.refreshCount();
+    }
+    /**
+     * After-events bubble through but we also use them to refresh the count
+     * — restoring a record means it's no longer "deleted".
+     */
+    OnAfterRecycleBinOpen(e) {
+        this.DeletedCount = e.deletedRecordCount;
+        this.AfterRecycleBinOpen.emit(e);
+        this.cdr.markForCheck();
+    }
+    OnAfterRestoreCommit(e) {
+        if (e.success)
+            this.DeletedCount = Math.max(0, this.DeletedCount - 1);
+        this.AfterRestoreCommit.emit(e);
+        this.cdr.markForCheck();
+    }
+    /**
+     * Loads the deleted-record count and visibility flags. Called on init,
+     * when EntityName changes, and after the panel closes (so a restore
+     * decrements the badge).
+     */
+    async refreshCount() {
+        this.IsVisible = false;
+        this.DeletedCount = 0;
+        if (!this._entityName) {
+            this.cdr.markForCheck();
+            return;
+        }
+        const md = new Metadata();
+        const entityInfo = md.Entities.find(e => e.Name.trim().toLowerCase() === this._entityName.trim().toLowerCase());
+        if (!entityInfo) {
+            this.cdr.markForCheck();
+            return;
+        }
+        this.TracksChanges = !!entityInfo.TrackRecordChanges;
+        if (!this.TracksChanges) {
+            this.cdr.markForCheck();
+            return;
+        }
+        const effectiveUser = this.ContextUser ?? md.CurrentUser;
+        if (!effectiveUser) {
+            this.cdr.markForCheck();
+            return;
+        }
+        const perms = entityInfo.GetUserPermisions(effectiveUser);
+        this.CanDelete = perms?.CanDelete ?? false;
+        if (!this.CanDelete) {
+            this.cdr.markForCheck();
+            return;
+        }
+        // Cheap count query — just IDs, capped low
+        try {
+            const rv = new RunView();
+            const result = await rv.RunView({
+                EntityName: 'MJ: Record Changes',
+                Fields: ['ID', 'RecordID'],
+                ExtraFilter: `EntityID='${entityInfo.ID}' AND Type='Delete'`,
+                OrderBy: 'ChangedAt DESC',
+                MaxRows: 500,
+                ResultType: 'simple',
+            }, this.ContextUser ?? undefined);
+            if (result.Success) {
+                // Distinct RecordIDs (a record might have been deleted, recreated, deleted again)
+                const distinct = new Set(result.Results.map(r => r.RecordID));
+                this.DeletedCount = distinct.size;
+            }
+        }
+        catch {
+            // Silently ignore — chip just won't show
+        }
+        this.IsVisible = this.DeletedCount > 0;
+        this.cdr.markForCheck();
+    }
+    static ɵfac = function RecycleBinChipComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || RecycleBinChipComponent)(i0.ɵɵdirectiveInject(i0.ChangeDetectorRef)); };
+    static ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: RecycleBinChipComponent, selectors: [["mj-recycle-bin-chip"]], inputs: { EntityName: "EntityName", ContextUser: "ContextUser" }, outputs: { BeforeRecycleBinOpen: "BeforeRecycleBinOpen", AfterRecycleBinOpen: "AfterRecycleBinOpen", BeforeRecordRestore: "BeforeRecordRestore", AfterRecordRestore: "AfterRecordRestore", BeforeRestoreCommit: "BeforeRestoreCommit", AfterRestoreCommit: "AfterRestoreCommit" }, standalone: false, decls: 1, vars: 1, consts: [["type", "button", 1, "rbc-chip", 3, "click"], ["aria-hidden", "true", 1, "fa-solid", "fa-trash-can-arrow-up"], [1, "rbc-chip-label"], [1, "rbc-chip-count"], [3, "Closed", "BeforeRecycleBinOpen", "AfterRecycleBinOpen", "BeforeRecordRestore", "AfterRecordRestore", "BeforeRestoreCommit", "AfterRestoreCommit", "Visible", "EntityName", "ContextUser"]], template: function RecycleBinChipComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵconditionalCreate(0, RecycleBinChipComponent_Conditional_0_Template, 7, 5);
+        } if (rf & 2) {
+            i0.ɵɵconditional(ctx.IsVisible ? 0 : -1);
+        } }, dependencies: [i1.RecycleBinComponent], styles: ["\n    .rbc-chip {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 6px 11px;\n      border-radius: 16px;\n      font-size: 12px;\n      font-weight: 500;\n      background: color-mix(in srgb, var(--mj-status-info) 8%, var(--mj-bg-surface));\n      color: color-mix(in srgb, var(--mj-status-info) 80%, var(--mj-text-secondary));\n      border: 1px solid color-mix(in srgb, var(--mj-status-info) 25%, var(--mj-border-default));\n      cursor: pointer;\n      font-family: inherit;\n      transition: background-color 0.1s, border-color 0.1s;\n    }\n    .rbc-chip:hover {\n      background: color-mix(in srgb, var(--mj-status-info) 14%, var(--mj-bg-surface));\n      border-color: var(--mj-status-info);\n    }\n    .rbc-chip-label {\n      /* always show on wider screens; hide on narrow if needed */\n    }\n    .rbc-chip-count {\n      background: var(--mj-status-info);\n      color: var(--mj-text-inverse, #fff);\n      border-radius: 10px;\n      padding: 1px 7px;\n      font-size: 10px;\n      font-weight: 700;\n    }\n  "], encapsulation: 2, changeDetection: 0 });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(RecycleBinChipComponent, [{
+        type: Component,
+        args: [{ standalone: false, selector: 'mj-recycle-bin-chip', template: `
+    @if (IsVisible) {
+      <button class="rbc-chip"
+        type="button"
+        (click)="Toggle()"
+        [attr.title]="'Recycle Bin · ' + DeletedCount + ' deleted record' + (DeletedCount === 1 ? '' : 's')">
+        <i class="fa-solid fa-trash-can-arrow-up" aria-hidden="true"></i>
+        <span class="rbc-chip-label">Recycle Bin</span>
+        <span class="rbc-chip-count">{{ DeletedCount }}</span>
+      </button>
+
+      <mj-recycle-bin
+        [Visible]="PanelVisible"
+        [EntityName]="EntityName"
+        [ContextUser]="ContextUser"
+        (Closed)="OnPanelClosed()"
+        (BeforeRecycleBinOpen)="BeforeRecycleBinOpen.emit($event)"
+        (AfterRecycleBinOpen)="OnAfterRecycleBinOpen($event)"
+        (BeforeRecordRestore)="BeforeRecordRestore.emit($event)"
+        (AfterRecordRestore)="AfterRecordRestore.emit($event)"
+        (BeforeRestoreCommit)="BeforeRestoreCommit.emit($event)"
+        (AfterRestoreCommit)="OnAfterRestoreCommit($event)">
+      </mj-recycle-bin>
+    }
+  `, changeDetection: ChangeDetectionStrategy.OnPush, encapsulation: ViewEncapsulation.None, styles: ["\n    .rbc-chip {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 6px 11px;\n      border-radius: 16px;\n      font-size: 12px;\n      font-weight: 500;\n      background: color-mix(in srgb, var(--mj-status-info) 8%, var(--mj-bg-surface));\n      color: color-mix(in srgb, var(--mj-status-info) 80%, var(--mj-text-secondary));\n      border: 1px solid color-mix(in srgb, var(--mj-status-info) 25%, var(--mj-border-default));\n      cursor: pointer;\n      font-family: inherit;\n      transition: background-color 0.1s, border-color 0.1s;\n    }\n    .rbc-chip:hover {\n      background: color-mix(in srgb, var(--mj-status-info) 14%, var(--mj-bg-surface));\n      border-color: var(--mj-status-info);\n    }\n    .rbc-chip-label {\n      /* always show on wider screens; hide on narrow if needed */\n    }\n    .rbc-chip-count {\n      background: var(--mj-status-info);\n      color: var(--mj-text-inverse, #fff);\n      border-radius: 10px;\n      padding: 1px 7px;\n      font-size: 10px;\n      font-weight: 700;\n    }\n  "] }]
+    }], () => [{ type: i0.ChangeDetectorRef }], { EntityName: [{
+            type: Input
+        }], ContextUser: [{
+            type: Input
+        }], BeforeRecycleBinOpen: [{
+            type: Output
+        }], AfterRecycleBinOpen: [{
+            type: Output
+        }], BeforeRecordRestore: [{
+            type: Output
+        }], AfterRecordRestore: [{
+            type: Output
+        }], BeforeRestoreCommit: [{
+            type: Output
+        }], AfterRestoreCommit: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(RecycleBinChipComponent, { className: "RecycleBinChipComponent", filePath: "src/lib/recycle-bin/recycle-bin-chip.component.ts", lineNumber: 109 }); })();
+//# sourceMappingURL=recycle-bin-chip.component.js.map

package/dist/lib/recycle-bin/recycle-bin-chip.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recycle-bin-chip.component.js","sourceRoot":"","sources":["../../../src/lib/recycle-bin/recycle-bin-chip.component.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Component,\n  ChangeDetectionStrategy,\n  ChangeDetectorRef,\n  EventEmitter,\n  Input,\n  OnInit,\n  Output,\n  ViewEncapsulation,\n} from '@angular/core';\nimport { Metadata, RunView, UserInfo } from '@memberjunction/core';\nimport {\n  AfterRecordRestoreEventArgs,\n  AfterRecycleBinOpenEventArgs,\n  AfterRestoreCommitEventArgs,\n  BeforeRecordRestoreEventArgs,\n  BeforeRecycleBinOpenEventArgs,\n  BeforeRestoreCommitEventArgs,\n} from './events/recycle-bin-events';\n\n/**\n * Tiny composite that renders a Recycle Bin **chip button** (with live\n * deleted-record count badge) and hosts the {@link RecycleBinComponent}\n * slide-in panel that opens when clicked.\n *\n * Designed to be dropped into any toolbar in three lines:\n *\n * @example\n *   <mj-recycle-bin-chip\n *     *ngIf=\"ShowRecycleBin\"\n *     [EntityName]=\"effectiveEntity?.Name\">\n *   </mj-recycle-bin-chip>\n *\n * The chip auto-hides itself when:\n *  - No `EntityName` is provided\n *  - The entity has `TrackRecordChanges = false`\n *  - The user lacks `CanDelete` permission on the entity\n *  - The deleted-record count is zero\n *\n * Each of those is the right behavior to avoid cluttering toolbars on\n * entities where the bin is irrelevant.\n *\n * Consumers who want to intercept any bin action can pass through the\n * standard cancelable Before/After events.\n */\n@Component({\n  standalone: false,\n  selector: 'mj-recycle-bin-chip',\n  template: `\n    @if (IsVisible) {\n      <button class=\"rbc-chip\"\n        type=\"button\"\n        (click)=\"Toggle()\"\n        [attr.title]=\"'Recycle Bin · ' + DeletedCount + ' deleted record' + (DeletedCount === 1 ? '' : 's')\">\n        <i class=\"fa-solid fa-trash-can-arrow-up\" aria-hidden=\"true\"></i>\n        <span class=\"rbc-chip-label\">Recycle Bin</span>\n        <span class=\"rbc-chip-count\">{{ DeletedCount }}</span>\n      </button>\n\n      <mj-recycle-bin\n        [Visible]=\"PanelVisible\"\n        [EntityName]=\"EntityName\"\n        [ContextUser]=\"ContextUser\"\n        (Closed)=\"OnPanelClosed()\"\n        (BeforeRecycleBinOpen)=\"BeforeRecycleBinOpen.emit($event)\"\n        (AfterRecycleBinOpen)=\"OnAfterRecycleBinOpen($event)\"\n        (BeforeRecordRestore)=\"BeforeRecordRestore.emit($event)\"\n        (AfterRecordRestore)=\"AfterRecordRestore.emit($event)\"\n        (BeforeRestoreCommit)=\"BeforeRestoreCommit.emit($event)\"\n        (AfterRestoreCommit)=\"OnAfterRestoreCommit($event)\">\n      </mj-recycle-bin>\n    }\n  `,\n  styles: [`\n    .rbc-chip {\n      display: inline-flex;\n      align-items: center;\n      gap: 6px;\n      padding: 6px 11px;\n      border-radius: 16px;\n      font-size: 12px;\n      font-weight: 500;\n      background: color-mix(in srgb, var(--mj-status-info) 8%, var(--mj-bg-surface));\n      color: color-mix(in srgb, var(--mj-status-info) 80%, var(--mj-text-secondary));\n      border: 1px solid color-mix(in srgb, var(--mj-status-info) 25%, var(--mj-border-default));\n      cursor: pointer;\n      font-family: inherit;\n      transition: background-color 0.1s, border-color 0.1s;\n    }\n    .rbc-chip:hover {\n      background: color-mix(in srgb, var(--mj-status-info) 14%, var(--mj-bg-surface));\n      border-color: var(--mj-status-info);\n    }\n    .rbc-chip-label {\n      /* always show on wider screens; hide on narrow if needed */\n    }\n    .rbc-chip-count {\n      background: var(--mj-status-info);\n      color: var(--mj-text-inverse, #fff);\n      border-radius: 10px;\n      padding: 1px 7px;\n      font-size: 10px;\n      font-weight: 700;\n    }\n  `],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  encapsulation: ViewEncapsulation.None,\n})\nexport class RecycleBinChipComponent implements OnInit {\n  /**\n   * Entity name whose deleted records will be surfaced. When null/empty,\n   * the chip hides itself entirely.\n   */\n  private _entityName: string | null = null;\n  @Input()\n  set EntityName(value: string | null) {\n    if (value !== this._entityName) {\n      this._entityName = value;\n      if (this.isInitialized) this.refreshCount();\n    }\n  }\n  get EntityName(): string | null {\n    return this._entityName;\n  }\n\n  /**\n   * Optional context user for permission checks. Falls back to\n   * `Metadata.Provider.CurrentUser` when omitted.\n   */\n  @Input() ContextUser: UserInfo | null = null;\n\n  // ─── Re-emitted events from the inner panel ────────────────────\n\n  @Output() BeforeRecycleBinOpen = new EventEmitter<BeforeRecycleBinOpenEventArgs>();\n  @Output() AfterRecycleBinOpen = new EventEmitter<AfterRecycleBinOpenEventArgs>();\n  @Output() BeforeRecordRestore = new EventEmitter<BeforeRecordRestoreEventArgs>();\n  @Output() AfterRecordRestore = new EventEmitter<AfterRecordRestoreEventArgs>();\n  @Output() BeforeRestoreCommit = new EventEmitter<BeforeRestoreCommitEventArgs>();\n  @Output() AfterRestoreCommit = new EventEmitter<AfterRestoreCommitEventArgs>();\n\n  // ─── Public template state ──────────────────────────────────────\n\n  public DeletedCount = 0;\n  public PanelVisible = false;\n  public IsVisible = false;\n  public CanDelete = false;\n  public TracksChanges = false;\n\n  private isInitialized = false;\n\n  constructor(private cdr: ChangeDetectorRef) {}\n\n  ngOnInit(): void {\n    this.isInitialized = true;\n    this.refreshCount();\n  }\n\n  public Toggle(): void {\n    this.PanelVisible = !this.PanelVisible;\n    this.cdr.markForCheck();\n  }\n\n  public OnPanelClosed(): void {\n    this.PanelVisible = false;\n    // Refresh count — a restore may have removed an entry from the bin\n    this.refreshCount();\n  }\n\n  /**\n   * After-events bubble through but we also use them to refresh the count\n   * — restoring a record means it's no longer \"deleted\".\n   */\n  public OnAfterRecycleBinOpen(e: AfterRecycleBinOpenEventArgs): void {\n    this.DeletedCount = e.deletedRecordCount;\n    this.AfterRecycleBinOpen.emit(e);\n    this.cdr.markForCheck();\n  }\n\n  public OnAfterRestoreCommit(e: AfterRestoreCommitEventArgs): void {\n    if (e.success) this.DeletedCount = Math.max(0, this.DeletedCount - 1);\n    this.AfterRestoreCommit.emit(e);\n    this.cdr.markForCheck();\n  }\n\n  /**\n   * Loads the deleted-record count and visibility flags. Called on init,\n   * when EntityName changes, and after the panel closes (so a restore\n   * decrements the badge).\n   */\n  private async refreshCount(): Promise<void> {\n    this.IsVisible = false;\n    this.DeletedCount = 0;\n\n    if (!this._entityName) {\n      this.cdr.markForCheck();\n      return;\n    }\n\n    const md = new Metadata();\n    const entityInfo = md.Entities.find(\n      e => e.Name.trim().toLowerCase() === this._entityName!.trim().toLowerCase(),\n    );\n    if (!entityInfo) {\n      this.cdr.markForCheck();\n      return;\n    }\n\n    this.TracksChanges = !!entityInfo.TrackRecordChanges;\n    if (!this.TracksChanges) {\n      this.cdr.markForCheck();\n      return;\n    }\n\n    const effectiveUser = this.ContextUser ?? md.CurrentUser;\n    if (!effectiveUser) {\n      this.cdr.markForCheck();\n      return;\n    }\n    const perms = entityInfo.GetUserPermisions(effectiveUser);\n    this.CanDelete = perms?.CanDelete ?? false;\n    if (!this.CanDelete) {\n      this.cdr.markForCheck();\n      return;\n    }\n\n    // Cheap count query — just IDs, capped low\n    try {\n      const rv = new RunView();\n      const result = await rv.RunView<{ ID: string; RecordID: string }>({\n        EntityName: 'MJ: Record Changes',\n        Fields: ['ID', 'RecordID'],\n        ExtraFilter: `EntityID='${entityInfo.ID}' AND Type='Delete'`,\n        OrderBy: 'ChangedAt DESC',\n        MaxRows: 500,\n        ResultType: 'simple',\n      }, this.ContextUser ?? undefined);\n\n      if (result.Success) {\n        // Distinct RecordIDs (a record might have been deleted, recreated, deleted again)\n        const distinct = new Set(result.Results.map(r => r.RecordID));\n        this.DeletedCount = distinct.size;\n      }\n    } catch {\n      // Silently ignore — chip just won't show\n    }\n\n    this.IsVisible = this.DeletedCount > 0;\n    this.cdr.markForCheck();\n  }\n}\n"]}

package/dist/lib/recycle-bin/recycle-bin.component.d.ts

@@ -0,0 +1,178 @@
+import { ChangeDetectorRef, EventEmitter, OnInit } from '@angular/core';
+import { UserInfo } from '@memberjunction/core';
+import { RestoreCommitEvent } from '@memberjunction/ng-record-changes';
+import { AfterRecordRestoreEventArgs, AfterRecycleBinOpenEventArgs, AfterRestoreCommitEventArgs, BeforeRecordRestoreEventArgs, BeforeRecycleBinOpenEventArgs, BeforeRestoreCommitEventArgs, RecycleBinEntry } from './events/recycle-bin-events';
+import * as i0 from "@angular/core";
+/**
+ * Slide-in panel that lists all hard-deleted records for a single entity
+ * and lets a user with `Delete` permission re-create any of them from its
+ * historical RecordChange snapshot.
+ *
+ * ### When to use
+ *
+ * Surface this component from any entity-viewing context where the user
+ * might need to restore a hard-deleted record. The {@link EntityViewerComponent},
+ * {@link EntityDataGridComponent}, and {@link EntityCardsComponent}
+ * already expose a `ShowRecycleBin` input (default `true`) that renders a
+ * chip in their toolbar — you only need to use this component directly if
+ * you're building a custom viewer.
+ *
+ * ### Permissions
+ *
+ * The chip / panel is gated on `entity.UserPermissions.CanDelete` —
+ * rationale: there is no native "undelete" permission in MemberJunction,
+ * but if a user has the higher-trust permission to *delete* records of an
+ * entity, restoring deleted ones is well within scope. The actual
+ * re-create action additionally requires `CanCreate`; without it the
+ * Restore button on each card disables with a tooltip.
+ *
+ * ### Soft deletes vs hard deletes
+ *
+ * This component only surfaces *hard*-deleted records. Soft-deletes (e.g.,
+ * `IsDeleted` flags, `Status='Inactive'`, etc.) leave the record visible
+ * in normal entity views, so the standard Record Changes panel + restore
+ * preview already handles them — no Recycle Bin needed.
+ *
+ * ### Cancelable Before/After event surface
+ *
+ * Every meaningful action emits a paired `before*` / `after*` event. The
+ * `before*` event carries `cancel: boolean` so consumers can intercept
+ * — useful for custom approval workflows, audit logging, or to take over
+ * the actual restore execution entirely. See {@link BeforeRecordRestoreEventArgs}
+ * and friends.
+ *
+ * @example Basic usage (rare — usually embedded by entity-viewer)
+ *   <mj-recycle-bin
+ *     [Visible]="showBin"
+ *     [EntityName]="'Customers'"
+ *     (Closed)="showBin = false"
+ *     (BeforeRecordRestore)="auditRestore($event)"
+ *     (AfterRestoreCommit)="onRestored($event)">
+ *   </mj-recycle-bin>
+ *
+ * @example Intercepting a restore
+ *   onBeforeRecordRestore(e: BeforeRecordRestoreEventArgs) {
+ *     if (!myCustomApproval(e.entry)) {
+ *       e.cancel = true;
+ *       e.cancelReason = 'Awaiting compliance approval';
+ *     }
+ *   }
+ */
+export declare class RecycleBinComponent implements OnInit {
+    private cdr;
+    /**
+     * Controls panel visibility. Set to true to slide in (and trigger an
+     * initial load); false to slide out.
+     */
+    private _visible;
+    set Visible(value: boolean);
+    get Visible(): boolean;
+    /**
+     * The name of the entity whose deleted records will be listed. Required.
+     */
+    EntityName: string | null;
+    /**
+     * Optional context user. When omitted, falls back to
+     * {@link Metadata.Provider.CurrentUser} per standard MJ conventions.
+     */
+    ContextUser: UserInfo | null;
+    /**
+     * Maximum number of deleted-record cards to load. Defaults to 200 — this
+     * is a UI affordance, not a hard limit; consumers needing pagination
+     * should listen to {@link AfterRecycleBinOpen} and surface their own UI
+     * if `deletedRecordCount === MaxRecords`.
+     */
+    MaxRecords: number;
+    /** Fires when the user closes the panel. */
+    Closed: EventEmitter<void>;
+    /**
+     * Cancelable. Fires when {@link Visible} flips to true and the bin is
+     * about to query for deleted records. Setting `cancel = true` aborts
+     * the query (and the panel will show the empty state).
+     */
+    BeforeRecycleBinOpen: EventEmitter<BeforeRecycleBinOpenEventArgs>;
+    /** Fires after the deleted-record query completes. */
+    AfterRecycleBinOpen: EventEmitter<AfterRecycleBinOpenEventArgs>;
+    /**
+     * Cancelable. Fires when the user clicks Restore on a deleted-record
+     * card, before the preview panel opens. Setting `cancel = true` skips
+     * the preview entirely — useful for consumers that want to take over
+     * the restore flow themselves.
+     */
+    BeforeRecordRestore: EventEmitter<BeforeRecordRestoreEventArgs>;
+    /**
+     * Fires after the user closes the restore preview, with `success`
+     * indicating whether the actual insert worked.
+     */
+    AfterRecordRestore: EventEmitter<AfterRecordRestoreEventArgs>;
+    /**
+     * Cancelable. Fires after the user clicks Restore in the preview but
+     * before the entity is inserted. Setting `cancel = true` aborts the
+     * insert.
+     */
+    BeforeRestoreCommit: EventEmitter<BeforeRestoreCommitEventArgs>;
+    /** Fires after the insert completes (success or failure). */
+    AfterRestoreCommit: EventEmitter<AfterRestoreCommitEventArgs>;
+    IsLoading: boolean;
+    LoadError: string | null;
+    Entries: RecycleBinEntry[];
+    /** The currently selected entry whose preview is open. */
+    SelectedEntry: RecycleBinEntry | null;
+    PreviewVisible: boolean;
+    /** Permission flags (computed once when EntityName is set). */
+    CanDelete: boolean;
+    CanCreate: boolean;
+    private isInitialized;
+    private resolvedEntityInfo;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    get HeaderSubtitle(): string;
+    /**
+     * The user has Delete permission and may browse the bin. The Restore
+     * button on each card additionally requires {@link CanCreate}.
+     */
+    get HasAccess(): boolean;
+    /**
+     * Manually trigger a re-load — useful for consumers who want to refresh
+     * after some external event (e.g., a delete happened and they want the
+     * bin to re-populate immediately).
+     */
+    LoadDeletedRecords(): Promise<void>;
+    /**
+     * User clicked Restore on a card — open the preview panel (unless a
+     * BeforeRecordRestore handler cancelled).
+     */
+    OnRestoreClicked(entry: RecycleBinEntry): void;
+    /**
+     * Preview panel emitted RestoreConfirmed — perform the insert and emit
+     * the matching after* events.
+     */
+    OnPreviewConfirmed(commit: RestoreCommitEvent): Promise<void>;
+    OnPreviewCancelled(): void;
+    OnClose(): void;
+    /**
+     * Dedupes the raw delete-change rows: keeps only the most recent Delete
+     * per RecordID (since a record could in principle have been recreated
+     * and re-deleted). Builds the display fields heuristically by reading
+     * the snapshot JSON.
+     */
+    private dedupeAndBuildEntries;
+    /**
+     * Builds the headline of the card. Prefers the entity's name field, then
+     * any non-PK string field, then the RecordID itself as a last resort.
+     */
+    private buildDisplaySummary;
+    /**
+     * Picks up to 3 "interesting" fields from the snapshot to render as
+     * supporting metadata under the headline. Heuristic: prefer fields that
+     * are non-empty, non-PK, non-system, and have a display name.
+     */
+    private buildSupportingFields;
+    private formatFieldValue;
+    private parseSnapshot;
+    formatTimestamp(date: Date | string | null): string;
+    getUserDisplay(user: string | null): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RecycleBinComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RecycleBinComponent, "mj-recycle-bin", never, { "Visible": { "alias": "Visible"; "required": false; }; "EntityName": { "alias": "EntityName"; "required": false; }; "ContextUser": { "alias": "ContextUser"; "required": false; }; "MaxRecords": { "alias": "MaxRecords"; "required": false; }; }, { "Closed": "Closed"; "BeforeRecycleBinOpen": "BeforeRecycleBinOpen"; "AfterRecycleBinOpen": "AfterRecycleBinOpen"; "BeforeRecordRestore": "BeforeRecordRestore"; "AfterRecordRestore": "AfterRecordRestore"; "BeforeRestoreCommit": "BeforeRestoreCommit"; "AfterRestoreCommit": "AfterRestoreCommit"; }, never, never, false, never>;
+}
+//# sourceMappingURL=recycle-bin.component.d.ts.map

package/dist/lib/recycle-bin/recycle-bin.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recycle-bin.component.d.ts","sourceRoot":"","sources":["../../../src/lib/recycle-bin/recycle-bin.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EACjB,YAAY,EAEZ,MAAM,EAGP,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,eAAe,EAChB,MAAM,6BAA6B,CAAC;;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,qBAQa,mBAAoB,YAAW,MAAM;IA+FpC,OAAO,CAAC,GAAG;IA5FvB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAS;IACzB,IACI,OAAO,CAAC,KAAK,EAAE,OAAO,EAMzB;IACD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACM,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C;;;OAGG;IACM,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAE7C;;;;;OAKG;IACM,UAAU,SAAO;IAI1B,4CAA4C;IAClC,MAAM,qBAA4B;IAE5C;;;;OAIG;IACO,oBAAoB,8CAAqD;IAEnF,sDAAsD;IAC5C,mBAAmB,6CAAoD;IAEjF;;;;;OAKG;IACO,mBAAmB,6CAAoD;IAEjF;;;OAGG;IACO,kBAAkB,4CAAmD;IAE/E;;;;OAIG;IACO,mBAAmB,6CAAoD;IAEjF,6DAA6D;IACnD,kBAAkB,4CAAmD;IAIxE,SAAS,UAAS;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChC,OAAO,EAAE,eAAe,EAAE,CAAM;IAEvC,0DAA0D;IACnD,aAAa,EAAE,eAAe,GAAG,IAAI,CAAQ;IAC7C,cAAc,UAAS;IAE9B,+DAA+D;IACxD,SAAS,UAAS;IAClB,SAAS,UAAS;IAEzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAA2B;gBAEjC,GAAG,EAAE,iBAAiB;IAE1C,QAAQ,IAAI,IAAI;IAOhB,IAAW,cAAc,IAAI,MAAM,CAIlC;IAED;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAID;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4FhD;;;OAGG;IACI,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAmBrD;;;OAGG;IACU,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+FnE,kBAAkB,IAAI,IAAI;IAM1B,OAAO,IAAI,IAAI;IAQtB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA2B7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAyB7B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,aAAa;IAWd,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM;IAYnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;yCArdvC,mBAAmB;2CAAnB,mBAAmB;CA0d/B"}