@memberjunction/ng-base-forms 4.0.0 → 4.1.0

package/dist/lib/toolbar/form-toolbar.component.d.ts

@@ -0,0 +1,170 @@
+import { EventEmitter, TemplateRef, DoCheck } from '@angular/core';
+import { BaseEntity, EntityInfo } from '@memberjunction/core';
+import { FormToolbarConfig } from '../types/toolbar-config';
+import { FormNavigationEvent } from '../types/navigation-events';
+import { FormWidthMode } from '../types/form-types';
+import { BeforeSaveEventArgs, BeforeDeleteEventArgs, BeforeCancelEventArgs, BeforeHistoryViewEventArgs, BeforeListManagementEventArgs, CustomToolbarButtonClickEventArgs, CustomToolbarButton } from '../types/form-events';
+import * as i0 from "@angular/core";
+/**
+ * Configurable form toolbar component.
+ *
+ * Renders action buttons (edit, save, delete, favorite, history, lists),
+ * the IS-A entity hierarchy breadcrumb, and section controls (search, expand/collapse).
+ *
+ * All navigation actions are emitted as events - the toolbar never calls any routing
+ * service directly. The host application subscribes and maps to its own navigation.
+ *
+ * @example
+ * ```html
+ * <mj-form-toolbar
+ *   [record]="record"
+ *   [editMode]="editMode"
+ *   [config]="toolbarConfig"
+ *   (Navigate)="onNavigate($event)"
+ *   (EditModeChange)="editMode = $event"
+ *   (SaveRequested)="onSave()"
+ *   (DeleteRequested)="onDelete()">
+ * </mj-form-toolbar>
+ * ```
+ */
+export declare class MjFormToolbarComponent implements DoCheck {
+    private cdr;
+    private _formRef;
+    /**
+     * @deprecated Use `<mj-record-form-container>` or pass individual inputs instead.
+     * Accepts a form component reference for backward compatibility.
+     * When set, the toolbar reads Record, EditMode, etc. from this reference.
+     */
+    set Form(value: unknown);
+    get Form(): unknown;
+    /** @deprecated Use [Form] or individual inputs instead */
+    set _deprecatedForm(value: unknown);
+    /** The entity record being displayed/edited */
+    Record: BaseEntity;
+    /** Whether the form is in edit mode */
+    EditMode: boolean;
+    /** Whether the current user has edit permission */
+    UserCanEdit: boolean;
+    /** Whether the current user has delete permission */
+    UserCanDelete: boolean;
+    /** Whether the record is currently a favorite */
+    IsFavorite: boolean;
+    /** Whether favorite init has completed (prevents flash of wrong icon) */
+    FavoriteInitDone: boolean;
+    /** Whether the record has unsaved changes */
+    IsDirty: boolean;
+    /** Names of dirty fields for display in save bar */
+    DirtyFieldNames: string[];
+    /** Count of lists this record belongs to */
+    ListCount: number;
+    /** Entity info for IS-A hierarchy and metadata */
+    EntityInfo: EntityInfo | null;
+    /** Toolbar configuration controlling visibility and behavior */
+    Config: FormToolbarConfig;
+    /** Whether to show the toolbar in a saving/loading state */
+    IsSaving: boolean;
+    VisibleSectionCount: number;
+    TotalSectionCount: number;
+    ExpandedSectionCount: number;
+    SearchFilter: string;
+    ShowEmptyFields: boolean;
+    WidthMode: FormWidthMode;
+    HasCustomSectionOrder: boolean;
+    /** Optional template for additional toolbar actions */
+    AdditionalActionsTemplate: TemplateRef<unknown> | null;
+    /** Emitted for all navigation actions (record links, hierarchy clicks, etc.) */
+    Navigate: EventEmitter<FormNavigationEvent>;
+    /** Request to enter or exit edit mode */
+    EditModeChange: EventEmitter<boolean>;
+    /** Emitted BEFORE save - can be cancelled by setting event.Cancel = true */
+    BeforeSave: EventEmitter<BeforeSaveEventArgs>;
+    /** Request to save the current record */
+    SaveRequested: EventEmitter<void>;
+    /** Emitted BEFORE cancel - can be cancelled by setting event.Cancel = true */
+    BeforeCancel: EventEmitter<BeforeCancelEventArgs>;
+    /** Request to cancel editing and revert changes */
+    CancelRequested: EventEmitter<void>;
+    /** Emitted BEFORE delete - can be cancelled by setting event.Cancel = true */
+    BeforeDelete: EventEmitter<BeforeDeleteEventArgs>;
+    /** Request to delete the current record */
+    DeleteRequested: EventEmitter<void>;
+    /** Request to toggle favorite status */
+    FavoriteToggled: EventEmitter<void>;
+    /** Emitted BEFORE history view - can be cancelled by setting event.Cancel = true */
+    BeforeHistoryView: EventEmitter<BeforeHistoryViewEventArgs>;
+    /** Request to show record change history */
+    HistoryRequested: EventEmitter<void>;
+    /** Emitted BEFORE list management - can be cancelled by setting event.Cancel = true */
+    BeforeListManagement: EventEmitter<BeforeListManagementEventArgs>;
+    /** Request to show list management */
+    ListManagementRequested: EventEmitter<void>;
+    /** Request to show dirty field changes */
+    ShowChangesRequested: EventEmitter<void>;
+    /** Emitted when a custom toolbar button is clicked */
+    CustomButtonClick: EventEmitter<CustomToolbarButtonClickEventArgs>;
+    FilterChange: EventEmitter<string>;
+    ExpandAllRequested: EventEmitter<void>;
+    CollapseAllRequested: EventEmitter<void>;
+    ShowEmptyFieldsChange: EventEmitter<boolean>;
+    WidthModeChange: EventEmitter<FormWidthMode>;
+    ResetSectionOrderRequested: EventEmitter<void>;
+    ShowDeleteDialog: boolean;
+    ShowDiscardDialog: boolean;
+    ngDoCheck(): void;
+    /**
+     * Sync toolbar state from the legacy form reference.
+     * Only active when [Form] is set (backward-compat mode).
+     */
+    private SyncFromFormRef;
+    /** Whether entity tracks record changes (for history button) */
+    get TracksChanges(): boolean;
+    /** IS-A parent chain for breadcrumb display */
+    get ParentChain(): EntityInfo[];
+    /** Whether this entity has parent entities (IS-A child) */
+    get HasParentEntities(): boolean;
+    /** Child entity types for dropdown */
+    get ChildEntities(): EntityInfo[];
+    /** Whether this entity has child entity types (IS-A parent) */
+    get HasChildEntities(): boolean;
+    /** Display-friendly names of dirty fields for the edit banner */
+    get DirtyFieldDisplayNames(): string[];
+    /** Display name for the edit banner */
+    get RecordDisplayName(): string;
+    OnEdit(): void;
+    OnSave(): void;
+    OnCancel(): void;
+    OnDiscardConfirm(): void;
+    OnDiscardCancel(): void;
+    private EmitCancel;
+    OnDeleteClick(): void;
+    OnDeleteConfirm(): void;
+    OnDeleteCancel(): void;
+    OnFavoriteToggle(): void;
+    OnHistory(): void;
+    OnListManagement(): void;
+    OnCustomButtonClick(button: CustomToolbarButton): void;
+    OnShowChanges(): void;
+    /**
+     * Try to call a method on the legacy form reference.
+     * Returns true if the method was found and called, false otherwise.
+     */
+    private DispatchToFormRef;
+    /**
+     * Navigate to a parent entity record in the IS-A hierarchy.
+     */
+    OnParentBadgeClick(parentEntity: EntityInfo, event: MouseEvent): void;
+    /**
+     * Navigate to a child entity type list view.
+     */
+    OnChildEntityClick(childEntity: EntityInfo): void;
+    OnFilterInput(event: Event): void;
+    OnClearFilter(): void;
+    OnExpandAll(): void;
+    OnCollapseAll(): void;
+    OnToggleEmptyFields(): void;
+    OnToggleWidthMode(): void;
+    OnResetSectionOrder(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MjFormToolbarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MjFormToolbarComponent, "mj-form-toolbar", never, { "Form": { "alias": "Form"; "required": false; }; "_deprecatedForm": { "alias": "form"; "required": false; }; "Record": { "alias": "Record"; "required": false; }; "EditMode": { "alias": "EditMode"; "required": false; }; "UserCanEdit": { "alias": "UserCanEdit"; "required": false; }; "UserCanDelete": { "alias": "UserCanDelete"; "required": false; }; "IsFavorite": { "alias": "IsFavorite"; "required": false; }; "FavoriteInitDone": { "alias": "FavoriteInitDone"; "required": false; }; "IsDirty": { "alias": "IsDirty"; "required": false; }; "DirtyFieldNames": { "alias": "DirtyFieldNames"; "required": false; }; "ListCount": { "alias": "ListCount"; "required": false; }; "EntityInfo": { "alias": "EntityInfo"; "required": false; }; "Config": { "alias": "Config"; "required": false; }; "IsSaving": { "alias": "IsSaving"; "required": false; }; "VisibleSectionCount": { "alias": "VisibleSectionCount"; "required": false; }; "TotalSectionCount": { "alias": "TotalSectionCount"; "required": false; }; "ExpandedSectionCount": { "alias": "ExpandedSectionCount"; "required": false; }; "SearchFilter": { "alias": "SearchFilter"; "required": false; }; "ShowEmptyFields": { "alias": "ShowEmptyFields"; "required": false; }; "WidthMode": { "alias": "WidthMode"; "required": false; }; "HasCustomSectionOrder": { "alias": "HasCustomSectionOrder"; "required": false; }; "AdditionalActionsTemplate": { "alias": "AdditionalActionsTemplate"; "required": false; }; }, { "Navigate": "Navigate"; "EditModeChange": "EditModeChange"; "BeforeSave": "BeforeSave"; "SaveRequested": "SaveRequested"; "BeforeCancel": "BeforeCancel"; "CancelRequested": "CancelRequested"; "BeforeDelete": "BeforeDelete"; "DeleteRequested": "DeleteRequested"; "FavoriteToggled": "FavoriteToggled"; "BeforeHistoryView": "BeforeHistoryView"; "HistoryRequested": "HistoryRequested"; "BeforeListManagement": "BeforeListManagement"; "ListManagementRequested": "ListManagementRequested"; "ShowChangesRequested": "ShowChangesRequested"; "CustomButtonClick": "CustomButtonClick"; "FilterChange": "FilterChange"; "ExpandAllRequested": "ExpandAllRequested"; "CollapseAllRequested": "CollapseAllRequested"; "ShowEmptyFieldsChange": "ShowEmptyFieldsChange"; "WidthModeChange": "WidthModeChange"; "ResetSectionOrderRequested": "ResetSectionOrderRequested"; }, never, ["[toolbar-additional-controls]"], false, never>;
+}
+//# sourceMappingURL=form-toolbar.component.d.ts.map

package/dist/lib/toolbar/form-toolbar.component.d.ts.map

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