@memberjunction/ng-entity-viewer 6.1.3 → 6.1.5

package/dist/lib/view-types/view-type.contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-type.contracts.js","sourceRoot":"","sources":["../../../src/lib/view-types/view-type.contracts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAsQvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,sBAAsB;IAKjC,kBAAkB,CAAiB;IAE5C;;;;OAIG;IACM,sBAAsB,GAAY,KAAK,CAAC;IAEjD;;;;OAIG;IACM,iBAAiB,GAAY,KAAK,CAAC;IAE5C;;;OAGG;IACH,cAAc,CAAC,OAAmB,EAAE,SAA6B;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAAC,SAA6B;QACxD,mBAAmB;IACrB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,kFAAkF;IAClF,KAAK,aAAa,CAAC;AACrB,CAAC","sourcesContent":["import { Type, EventEmitter } from '@angular/core';\nimport { EntityInfo, IMetadataProvider } from '@memberjunction/core';\nimport { RegisterClass } from '@memberjunction/global';\n\n/**\n * View-Type Plugin Architecture — Contracts\n * -----------------------------------------\n * This file defines the framework-level contracts for the entity-viewer's pluggable\n * view-type system. A \"view type\" is a way of rendering a set of entity records — the\n * built-in ones being Grid, Cards, Timeline, and Map, with future additions like\n * Cluster and Tag Cloud.\n *\n * The design separates three concerns:\n *   1. {@link IViewTypeDescriptor} — metadata + availability + the component types to mount.\n *      Descriptors are discovered at runtime via the {@link https MemberJunction ClassFactory}\n *      keyed off the `DriverClass` stored in the `MJ: View Types` entity.\n *   2. {@link IViewRenderer} — the contract a renderer component honors so the host can\n *      feed it data and listen for selection/open/config events uniformly.\n *   3. {@link IViewPropSheet} — the contract a configuration prop-sheet component honors.\n *\n * Because this lives in an Angular package, it is acceptable for the descriptor to reference\n * Angular's `Type<T>` (it points at the concrete component classes to instantiate).\n */\n\n/**\n * Framework-agnostic-ish descriptor for a single view type.\n *\n * A descriptor is the bridge between the `MJ: View Types` metadata row (which stores\n * the `DriverClass` name) and the concrete Angular components that actually render the\n * view and edit its configuration. Descriptors are registered with the ClassFactory via\n * `@RegisterClass(BaseViewTypeDescriptor, '<DriverClass>')` so they can be discovered by\n * name without a hard import from the host.\n */\nexport interface IViewTypeDescriptor {\n  /**\n   * Stable internal key for the view type — matches the `DriverClass` column on the\n   * `MJ: View Types` entity and the `@RegisterClass` registration key\n   * (e.g. \"GridViewType\", \"CardsViewType\").\n   */\n  readonly Name: string;\n\n  /** User-facing label shown in the view-mode switcher (e.g. \"Grid\", \"Tag Cloud\"). */\n  readonly DisplayName: string;\n\n  /** Font Awesome icon class shown in the switcher (e.g. \"fa-solid fa-table\"). */\n  readonly Icon: string;\n\n  /**\n   * The Angular component class that renders this view type. The host instantiates /\n   * mounts this component and feeds it data per the {@link IViewRenderer} contract.\n   */\n  readonly RendererComponent: Type<unknown>;\n\n  /**\n   * Optional Angular component class for this view type's configuration prop-sheet\n   * (honors {@link IViewPropSheet}). Undefined when the view type has no configurable\n   * options.\n   */\n  readonly PropSheetComponent?: Type<unknown>;\n\n  /**\n   * When `true`, this view type's `config.gridState` is backed by the **canonical**\n   * `UserView.GridState` column (the single, framework-wide store for a view's\n   * columns / sort / filter / aggregates — also read by `MJUserViewEntity.Columns`,\n   * the GraphQL data provider's field list, and export) rather than by an opaque\n   * per-view-type blob in `DisplayState.viewTypeConfigs`.\n   *\n   * The container honors this by (a) seeding the renderer's `config.gridState` from\n   * the canonical store and (b) routing the renderer's `configChanged.gridState`\n   * back to it on persist. This keeps the grid, the config panel, the server query,\n   * and export all reading/writing one source of truth. Defaults to `false`, so\n   * non-grid view types (Cards/Timeline/Map) keep their opaque per-type config.\n   */\n  readonly UsesCanonicalGridState?: boolean;\n\n  /**\n   * When `true`, this view type ships its OWN in-view export affordance (e.g. the Grid renderer's\n   * in-toolbar \"Export\" button + {@link IViewRenderer.exportRecords}). Hosts use this to decide\n   * whether to render a FALLBACK export button for view types that DON'T (Cards / Map / Timeline),\n   * so every view type can export without a duplicate button on the ones that already have one.\n   * Defaults to `false`. This is read off the (synchronously-resolved) descriptor rather than the\n   * mounted renderer instance, so it's correct the instant the active view type changes.\n   */\n  readonly ProvidesOwnExport?: boolean;\n\n  /**\n   * Predicate that decides whether this view type is available for a given entity.\n   * For example, Timeline requires a date field; Map requires geocoding support.\n   * Grid and Cards are always available.\n   *\n   * @param entity the entity the viewer is currently displaying\n   * @param provider optional metadata provider (for multi-provider scenarios)\n   */\n  IsAvailableFor(entity: EntityInfo, provider?: IMetadataProvider): boolean;\n\n  /**\n   * Optional async hook to load any data this descriptor's {@link IsAvailableFor} predicate\n   * depends on (e.g. the Cluster view type needs the set of entities that have an active\n   * Entity Document with vectors). The host awaits this once — before computing availability —\n   * so the synchronous predicate can read from a now-populated cache. Implementations should\n   * be cheap/idempotent (typically `await SomeEngine.Instance.Config(false, ...)`). Omit when\n   * availability is computable purely from the {@link EntityInfo} (Grid/Cards/Timeline/Map).\n   *\n   * @param provider optional metadata provider (for multi-provider scenarios)\n   */\n  EnsureAvailabilityData?(provider?: IMetadataProvider): Promise<void>;\n}\n\n/**\n * Contract honored by a view renderer component. The host binds these inputs and\n * subscribes to these outputs uniformly across all view types.\n *\n * @typeParam TConfig the shape of this view type's configuration object\n */\nexport interface IViewRenderer<TConfig = unknown> {\n  /** The entity whose records are being rendered. */\n  entity: EntityInfo | null;\n\n  /** The records to render (already loaded/filtered by the host). */\n  records: Record<string, unknown>[];\n\n  /** Primary-key string of the currently selected record, if any. */\n  selectedRecordId: string | null;\n\n  /** Active filter text (for highlighting / client-side concerns). */\n  filterText: string | null;\n\n  /** View-type-specific configuration. */\n  config: TConfig;\n\n  /**\n   * Optional: the metadata provider, handed to plug-ins that issue their own data calls\n   * (multi-provider safety). Generic — not specific to any one view type.\n   */\n  provider?: IMetadataProvider | null;\n\n  /**\n   * Optional generic data-context the host supplies alongside {@link records}. These are\n   * universal \"a view of records\" concepts (counts, current page, loading) — NOT specific to any\n   * view type — so a renderer that paginates or shows a total can read them, and one that doesn't\n   * simply ignores them. The host owns the actual data fetch; these describe its current result.\n   */\n  totalRecordCount?: number;\n  /** One-based current page of {@link records} when the host is paginating. */\n  page?: number;\n  /** Page size the host is using. */\n  pageSize?: number;\n  /** Whether the host is currently (re)loading the record set. */\n  isLoading?: boolean;\n\n  /** Emitted when a record is selected (single click). Payload is the raw record object. */\n  recordSelected: EventEmitter<unknown>;\n\n  /**\n   * Emitted when THIS entity's record should be opened (double-click / open). Payload is the raw\n   * record. This is a NAVIGATION request — the only category of signal that legitimately bubbles\n   * to the outer app (routing lives there). Everything else a view does (export, add-to-list,\n   * delete, …) is self-contained in the plug-in via Generic dialogs and never bubbles up.\n   */\n  recordOpened: EventEmitter<unknown>;\n\n  /**\n   * Optional: NAVIGATION request to open a *related* record on a DIFFERENT entity (e.g. a\n   * foreign-key drill-through in a grid cell). Bubbles to the outer app for routing. Generic —\n   * the container forwards it without acting on it.\n   */\n  openRelatedRecordRequested?: EventEmitter<ViewRelatedRecordNavigation>;\n\n  /**\n   * Optional: NAVIGATION request to create a new record of the current entity (e.g. a grid's\n   * \"New\" button) — opening the create form is a routing concern owned by the outer app. Bubbles\n   * up; the container forwards it without acting on it.\n   */\n  createRecordRequested?: EventEmitter<void>;\n\n  /**\n   * Emitted when the renderer mutates its own opaque {@link config} (e.g. timeline date field,\n   * grid columns/sort/widths, map render mode). The container persists the blob verbatim against\n   * the active `ViewTypeID` and never inspects it. (Container ↔ plug-in coordination inside the\n   * Generic layer — NOT a signal that drives the outer app.)\n   */\n  configChanged: EventEmitter<TConfig>;\n\n  /**\n   * Optional: ask the container to (re)load the record set differently. The ONLY data-access\n   * channel a plug-in has, fully generic — the container honors the request (sort / page /\n   * load-all) without knowing which plug-in asked or why. A grid emits sort/page; a map emits\n   * `{ loadAll: true }`; a plug-in happy with the records it's given emits nothing. The container\n   * owns the actual `RunView`; no per-view-type branching. (Container ↔ plug-in coordination —\n   * NOT a signal that drives the outer app.)\n   */\n  dataRequest?: EventEmitter<ViewDataRequest>;\n\n  /**\n   * Optional: ask the host to open this view's configuration UI (e.g. the workspace's config\n   * panel). Generic — every view type has configurable settings (the descriptor's\n   * {@link IViewTypeDescriptor.PropSheetComponent}); a plug-in raises this when the user invokes\n   * an in-renderer affordance for it (e.g. the grid's \"Manage Columns\" toolbar item). The\n   * container forwards it to the host, which owns the config UI; no per-view-type branching.\n   * (Container ↔ plug-in coordination — NOT a signal that drives the outer app.)\n   */\n  configureRequested?: EventEmitter<void>;\n\n  /**\n   * Optional IMPERATIVE export entry point. A renderer that owns a self-contained export\n   * affordance (e.g. the grid's export dialog) may expose this so an external driver — the\n   * host's programmatic API, ultimately the AI agent — can trigger an export of the current\n   * record set WITHOUT going through the renderer's own toolbar UI. Renderers that don't\n   * support export simply don't implement it (the host treats absence as \"not exportable\").\n   *\n   * This is NOT a navigation/UI-coordination signal — it's a direct method call the host makes\n   * on the active renderer, mirroring how export is otherwise self-contained in the plug-in.\n   *\n   * @param format optional output format ('csv' | 'excel' | 'json'); the renderer picks a sensible\n   *   default (typically 'excel') when omitted.\n   * @returns true when the export was initiated, false when it couldn't be (no data / unsupported).\n   */\n  exportRecords?(format?: 'csv' | 'excel' | 'json'): Promise<boolean>;\n}\n\n/**\n * A generic, view-type-agnostic request from a renderer for the host to change how it loads the\n * record set. Every field is optional; the host applies whatever is present. No field names a\n * specific view type — these are universal data-access concepts.\n */\nexport interface ViewDataRequest {\n  /** Desired sort, applied to the host's RunView OrderBy. Empty/omitted clears sorting. */\n  sort?: Array<{ field: string; direction: 'asc' | 'desc' }>;\n  /** One-based page to load (for paginated views). */\n  page?: number;\n  /** Page size to load. */\n  pageSize?: number;\n  /** When true, the host loads the full result set (up to its safety cap) instead of paginating. */\n  loadAll?: boolean;\n}\n\n/**\n * A NAVIGATION request to open a record on a (possibly different) entity — the generic payload\n * for {@link IViewRenderer.openRelatedRecordRequested}. Routing lives in the outer app, so this\n * is one of the few signals that legitimately bubbles up. The container forwards it untouched.\n */\nexport interface ViewRelatedRecordNavigation {\n  /** The entity whose record should be opened. */\n  entityName: string;\n  /** The record's key — a composite-key string or the raw key value(s). Opaque to the container. */\n  recordKey: unknown;\n}\n\n/**\n * Contract honored by a view-type configuration prop-sheet component.\n *\n * @typeParam TConfig the shape of the configuration object being edited\n */\nexport interface IViewPropSheet<TConfig = unknown> {\n  /** The entity the configuration applies to. */\n  entity: EntityInfo | null;\n\n  /** The current configuration being edited. */\n  config: TConfig;\n\n  /** Emitted when the user changes the configuration. */\n  configChange: EventEmitter<TConfig>;\n}\n\n/**\n * Abstract base class for all view-type descriptors.\n *\n * Concrete descriptors extend this and register themselves with the ClassFactory:\n *\n * ```typescript\n * @RegisterClass(BaseViewTypeDescriptor, 'GridViewType')\n * export class GridViewType extends BaseViewTypeDescriptor {\n *   readonly Name = 'GridViewType';\n *   readonly DisplayName = 'Grid';\n *   readonly Icon = 'fa-solid fa-table';\n *   readonly RendererComponent = EntityDataGridComponent;\n *   IsAvailableFor(): boolean { return true; }\n * }\n * ```\n *\n * The {@link ViewTypeEngine} resolves descriptors by `DriverClass` name after\n * probing ClassFactory registrations, then `CreateInstance`. Unregistered keys\n * (e.g. a seeded TagCloud row) are omitted rather than falling back to this base.\n *\n * NOTE: This class is registered with the ClassFactory itself (via subclasses) and is\n * intentionally NOT decorated — only concrete subclasses carry `@RegisterClass`.\n */\nexport abstract class BaseViewTypeDescriptor implements IViewTypeDescriptor {\n  abstract readonly Name: string;\n  abstract readonly DisplayName: string;\n  abstract readonly Icon: string;\n  abstract readonly RendererComponent: Type<unknown>;\n  readonly PropSheetComponent?: Type<unknown>;\n\n  /**\n   * Default: this view type uses its own opaque per-view-type config (stored in\n   * `DisplayState.viewTypeConfigs`). Override to `true` in a view type that renders the\n   * canonical grid columns (see {@link IViewTypeDescriptor.UsesCanonicalGridState}).\n   */\n  readonly UsesCanonicalGridState: boolean = false;\n\n  /**\n   * Default: this view type has no built-in export UI, so a host should provide a fallback Export\n   * affordance. Override to `true` in a view type that ships its own export (see\n   * {@link IViewTypeDescriptor.ProvidesOwnExport}).\n   */\n  readonly ProvidesOwnExport: boolean = false;\n\n  /**\n   * Default availability: available for every entity. Override in subclasses that have\n   * requirements (e.g. Timeline needs a date field, Map needs geocoding).\n   */\n  IsAvailableFor(_entity: EntityInfo, _provider?: IMetadataProvider): boolean {\n    return true;\n  }\n\n  /**\n   * Default: nothing to preload. Override in subclasses whose availability predicate needs\n   * async data (e.g. the Cluster view type loading which entities have Entity Documents).\n   */\n  async EnsureAvailabilityData(_provider?: IMetadataProvider): Promise<void> {\n    // no-op by default\n  }\n}\n\n/**\n * Tree-shaking guard. Force-references {@link RegisterClass} so bundlers don't drop the\n * decorator import in builds that only touch this contracts module. Concrete descriptor\n * modules each carry their own `@RegisterClass` and load guard, but this keeps the base\n * module self-consistent.\n */\nexport function LoadViewTypeContracts(): void {\n  // no-op; presence prevents tree-shaking of this module's side-effect-free exports\n  void RegisterClass;\n}\n"]}
+{"version":3,"file":"view-type.contracts.js","sourceRoot":"","sources":["../../../src/lib/view-types/view-type.contracts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA8QvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,sBAAsB;IAKjC,kBAAkB,CAAiB;IAE5C;;;;OAIG;IACM,sBAAsB,GAAY,KAAK,CAAC;IAEjD;;;;OAIG;IACM,iBAAiB,GAAY,KAAK,CAAC;IAE5C;;;OAGG;IACH,cAAc,CAAC,OAAmB,EAAE,SAA6B;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAAC,SAA6B;QACxD,mBAAmB;IACrB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,kFAAkF;IAClF,KAAK,aAAa,CAAC;AACrB,CAAC","sourcesContent":["import { Type, EventEmitter } from '@angular/core';\nimport { EntityInfo, IMetadataProvider } from '@memberjunction/core';\nimport { ExportColumn } from '@memberjunction/export-engine';\nimport { RegisterClass } from '@memberjunction/global';\n\n/**\n * View-Type Plugin Architecture — Contracts\n * -----------------------------------------\n * This file defines the framework-level contracts for the entity-viewer's pluggable\n * view-type system. A \"view type\" is a way of rendering a set of entity records — the\n * built-in ones being Grid, Cards, Timeline, and Map, with future additions like\n * Cluster and Tag Cloud.\n *\n * The design separates three concerns:\n *   1. {@link IViewTypeDescriptor} — metadata + availability + the component types to mount.\n *      Descriptors are discovered at runtime via the {@link https MemberJunction ClassFactory}\n *      keyed off the `DriverClass` stored in the `MJ: View Types` entity.\n *   2. {@link IViewRenderer} — the contract a renderer component honors so the host can\n *      feed it data and listen for selection/open/config events uniformly.\n *   3. {@link IViewPropSheet} — the contract a configuration prop-sheet component honors.\n *\n * Because this lives in an Angular package, it is acceptable for the descriptor to reference\n * Angular's `Type<T>` (it points at the concrete component classes to instantiate).\n */\n\n/**\n * Framework-agnostic-ish descriptor for a single view type.\n *\n * A descriptor is the bridge between the `MJ: View Types` metadata row (which stores\n * the `DriverClass` name) and the concrete Angular components that actually render the\n * view and edit its configuration. Descriptors are registered with the ClassFactory via\n * `@RegisterClass(BaseViewTypeDescriptor, '<DriverClass>')` so they can be discovered by\n * name without a hard import from the host.\n */\nexport interface IViewTypeDescriptor {\n  /**\n   * Stable internal key for the view type — matches the `DriverClass` column on the\n   * `MJ: View Types` entity and the `@RegisterClass` registration key\n   * (e.g. \"GridViewType\", \"CardsViewType\").\n   */\n  readonly Name: string;\n\n  /** User-facing label shown in the view-mode switcher (e.g. \"Grid\", \"Tag Cloud\"). */\n  readonly DisplayName: string;\n\n  /** Font Awesome icon class shown in the switcher (e.g. \"fa-solid fa-table\"). */\n  readonly Icon: string;\n\n  /**\n   * The Angular component class that renders this view type. The host instantiates /\n   * mounts this component and feeds it data per the {@link IViewRenderer} contract.\n   */\n  readonly RendererComponent: Type<unknown>;\n\n  /**\n   * Optional Angular component class for this view type's configuration prop-sheet\n   * (honors {@link IViewPropSheet}). Undefined when the view type has no configurable\n   * options.\n   */\n  readonly PropSheetComponent?: Type<unknown>;\n\n  /**\n   * When `true`, this view type's `config.gridState` is backed by the **canonical**\n   * `UserView.GridState` column (the single, framework-wide store for a view's\n   * columns / sort / filter / aggregates — also read by `MJUserViewEntity.Columns`,\n   * the GraphQL data provider's field list, and export) rather than by an opaque\n   * per-view-type blob in `DisplayState.viewTypeConfigs`.\n   *\n   * The container honors this by (a) seeding the renderer's `config.gridState` from\n   * the canonical store and (b) routing the renderer's `configChanged.gridState`\n   * back to it on persist. This keeps the grid, the config panel, the server query,\n   * and export all reading/writing one source of truth. Defaults to `false`, so\n   * non-grid view types (Cards/Timeline/Map) keep their opaque per-type config.\n   */\n  readonly UsesCanonicalGridState?: boolean;\n\n  /**\n   * When `true`, this view type ships its OWN in-view export affordance (e.g. the Grid renderer's\n   * in-toolbar \"Export\" button + {@link IViewRenderer.exportRecords}). Hosts use this to decide\n   * whether to render a FALLBACK export button for view types that DON'T (Cards / Map / Timeline),\n   * so every view type can export without a duplicate button on the ones that already have one.\n   * Defaults to `false`. This is read off the (synchronously-resolved) descriptor rather than the\n   * mounted renderer instance, so it's correct the instant the active view type changes.\n   */\n  readonly ProvidesOwnExport?: boolean;\n\n  /**\n   * Predicate that decides whether this view type is available for a given entity.\n   * For example, Timeline requires a date field; Map requires geocoding support.\n   * Grid and Cards are always available.\n   *\n   * @param entity the entity the viewer is currently displaying\n   * @param provider optional metadata provider (for multi-provider scenarios)\n   */\n  IsAvailableFor(entity: EntityInfo, provider?: IMetadataProvider): boolean;\n\n  /**\n   * Optional async hook to load any data this descriptor's {@link IsAvailableFor} predicate\n   * depends on (e.g. the Cluster view type needs the set of entities that have an active\n   * Entity Document with vectors). The host awaits this once — before computing availability —\n   * so the synchronous predicate can read from a now-populated cache. Implementations should\n   * be cheap/idempotent (typically `await SomeEngine.Instance.Config(false, ...)`). Omit when\n   * availability is computable purely from the {@link EntityInfo} (Grid/Cards/Timeline/Map).\n   *\n   * @param provider optional metadata provider (for multi-provider scenarios)\n   */\n  EnsureAvailabilityData?(provider?: IMetadataProvider): Promise<void>;\n}\n\n/**\n * Contract honored by a view renderer component. The host binds these inputs and\n * subscribes to these outputs uniformly across all view types.\n *\n * @typeParam TConfig the shape of this view type's configuration object\n */\nexport interface IViewRenderer<TConfig = unknown> {\n  /** The entity whose records are being rendered. */\n  entity: EntityInfo | null;\n\n  /** The records to render (already loaded/filtered by the host). */\n  records: Record<string, unknown>[];\n\n  /** Primary-key string of the currently selected record, if any. */\n  selectedRecordId: string | null;\n\n  /** Active filter text (for highlighting / client-side concerns). */\n  filterText: string | null;\n\n  /** View-type-specific configuration. */\n  config: TConfig;\n\n  /**\n   * Optional: the metadata provider, handed to plug-ins that issue their own data calls\n   * (multi-provider safety). Generic — not specific to any one view type.\n   */\n  provider?: IMetadataProvider | null;\n\n  /**\n   * Optional generic data-context the host supplies alongside {@link records}. These are\n   * universal \"a view of records\" concepts (counts, current page, loading) — NOT specific to any\n   * view type — so a renderer that paginates or shows a total can read them, and one that doesn't\n   * simply ignores them. The host owns the actual data fetch; these describe its current result.\n   */\n  totalRecordCount?: number;\n  /** One-based current page of {@link records} when the host is paginating. */\n  page?: number;\n  /** Page size the host is using. */\n  pageSize?: number;\n  /** Whether the host is currently (re)loading the record set. */\n  isLoading?: boolean;\n\n  /** Emitted when a record is selected (single click). Payload is the raw record object. */\n  recordSelected: EventEmitter<unknown>;\n\n  /**\n   * Emitted when THIS entity's record should be opened (double-click / open). Payload is the raw\n   * record. This is a NAVIGATION request — the only category of signal that legitimately bubbles\n   * to the outer app (routing lives there). Everything else a view does (export, add-to-list,\n   * delete, …) is self-contained in the plug-in via Generic dialogs and never bubbles up.\n   */\n  recordOpened: EventEmitter<unknown>;\n\n  /**\n   * Optional: NAVIGATION request to open a *related* record on a DIFFERENT entity (e.g. a\n   * foreign-key drill-through in a grid cell). Bubbles to the outer app for routing. Generic —\n   * the container forwards it without acting on it.\n   */\n  openRelatedRecordRequested?: EventEmitter<ViewRelatedRecordNavigation>;\n\n  /**\n   * Optional: NAVIGATION request to create a new record of the current entity (e.g. a grid's\n   * \"New\" button) — opening the create form is a routing concern owned by the outer app. Bubbles\n   * up; the container forwards it without acting on it.\n   */\n  createRecordRequested?: EventEmitter<void>;\n\n  /**\n   * Emitted when the renderer mutates its own opaque {@link config} (e.g. timeline date field,\n   * grid columns/sort/widths, map render mode). The container persists the blob verbatim against\n   * the active `ViewTypeID` and never inspects it. (Container ↔ plug-in coordination inside the\n   * Generic layer — NOT a signal that drives the outer app.)\n   */\n  configChanged: EventEmitter<TConfig>;\n\n  /**\n   * Optional: ask the container to (re)load the record set differently. The ONLY data-access\n   * channel a plug-in has, fully generic — the container honors the request (sort / page /\n   * load-all) without knowing which plug-in asked or why. A grid emits sort/page; a map emits\n   * `{ loadAll: true }`; a plug-in happy with the records it's given emits nothing. The container\n   * owns the actual `RunView`; no per-view-type branching. (Container ↔ plug-in coordination —\n   * NOT a signal that drives the outer app.)\n   */\n  dataRequest?: EventEmitter<ViewDataRequest>;\n\n  /**\n   * Optional: ask the host to open this view's configuration UI (e.g. the workspace's config\n   * panel). Generic — every view type has configurable settings (the descriptor's\n   * {@link IViewTypeDescriptor.PropSheetComponent}); a plug-in raises this when the user invokes\n   * an in-renderer affordance for it (e.g. the grid's \"Manage Columns\" toolbar item). The\n   * container forwards it to the host, which owns the config UI; no per-view-type branching.\n   * (Container ↔ plug-in coordination — NOT a signal that drives the outer app.)\n   */\n  configureRequested?: EventEmitter<void>;\n\n  /**\n   * Optional IMPERATIVE export entry point. A renderer that owns a self-contained export\n   * affordance (e.g. the grid's export dialog) may expose this so an external driver — the\n   * host's programmatic API, ultimately the AI agent — can trigger an export of the current\n   * record set WITHOUT going through the renderer's own toolbar UI. Renderers that don't\n   * support export simply don't implement it (the host treats absence as \"not exportable\").\n   *\n   * This is NOT a navigation/UI-coordination signal — it's a direct method call the host makes\n   * on the active renderer, mirroring how export is otherwise self-contained in the plug-in.\n   *\n   * @param format optional output format ('csv' | 'excel' | 'json'); the renderer picks a sensible\n   *   default (typically 'excel') when omitted.\n   * @returns true when the export was initiated, false when it couldn't be (no data / unsupported).\n   */\n  exportRecords?(format?: 'csv' | 'excel' | 'json'): Promise<boolean>;\n\n  /**\n   * Optional: the columns this renderer is showing, in on-screen order and with on-screen headers.\n   * A host that exports on the renderer's behalf (the workspace toolbar's Export) uses this so its\n   * export matches the screen. Renderers without a column layout (Cards, Map, Timeline) omit it and\n   * the host falls back to the view's saved columns.\n   */\n  GetExportColumns?(): ExportColumn[];\n}\n\n/**\n * A generic, view-type-agnostic request from a renderer for the host to change how it loads the\n * record set. Every field is optional; the host applies whatever is present. No field names a\n * specific view type — these are universal data-access concepts.\n */\nexport interface ViewDataRequest {\n  /** Desired sort, applied to the host's RunView OrderBy. Empty/omitted clears sorting. */\n  sort?: Array<{ field: string; direction: 'asc' | 'desc' }>;\n  /** One-based page to load (for paginated views). */\n  page?: number;\n  /** Page size to load. */\n  pageSize?: number;\n  /** When true, the host loads the full result set (up to its safety cap) instead of paginating. */\n  loadAll?: boolean;\n}\n\n/**\n * A NAVIGATION request to open a record on a (possibly different) entity — the generic payload\n * for {@link IViewRenderer.openRelatedRecordRequested}. Routing lives in the outer app, so this\n * is one of the few signals that legitimately bubbles up. The container forwards it untouched.\n */\nexport interface ViewRelatedRecordNavigation {\n  /** The entity whose record should be opened. */\n  entityName: string;\n  /** The record's key — a composite-key string or the raw key value(s). Opaque to the container. */\n  recordKey: unknown;\n}\n\n/**\n * Contract honored by a view-type configuration prop-sheet component.\n *\n * @typeParam TConfig the shape of the configuration object being edited\n */\nexport interface IViewPropSheet<TConfig = unknown> {\n  /** The entity the configuration applies to. */\n  entity: EntityInfo | null;\n\n  /** The current configuration being edited. */\n  config: TConfig;\n\n  /** Emitted when the user changes the configuration. */\n  configChange: EventEmitter<TConfig>;\n}\n\n/**\n * Abstract base class for all view-type descriptors.\n *\n * Concrete descriptors extend this and register themselves with the ClassFactory:\n *\n * ```typescript\n * @RegisterClass(BaseViewTypeDescriptor, 'GridViewType')\n * export class GridViewType extends BaseViewTypeDescriptor {\n *   readonly Name = 'GridViewType';\n *   readonly DisplayName = 'Grid';\n *   readonly Icon = 'fa-solid fa-table';\n *   readonly RendererComponent = EntityDataGridComponent;\n *   IsAvailableFor(): boolean { return true; }\n * }\n * ```\n *\n * The {@link ViewTypeEngine} resolves descriptors by `DriverClass` name after\n * probing ClassFactory registrations, then `CreateInstance`. Unregistered keys\n * (e.g. a seeded TagCloud row) are omitted rather than falling back to this base.\n *\n * NOTE: This class is registered with the ClassFactory itself (via subclasses) and is\n * intentionally NOT decorated — only concrete subclasses carry `@RegisterClass`.\n */\nexport abstract class BaseViewTypeDescriptor implements IViewTypeDescriptor {\n  abstract readonly Name: string;\n  abstract readonly DisplayName: string;\n  abstract readonly Icon: string;\n  abstract readonly RendererComponent: Type<unknown>;\n  readonly PropSheetComponent?: Type<unknown>;\n\n  /**\n   * Default: this view type uses its own opaque per-view-type config (stored in\n   * `DisplayState.viewTypeConfigs`). Override to `true` in a view type that renders the\n   * canonical grid columns (see {@link IViewTypeDescriptor.UsesCanonicalGridState}).\n   */\n  readonly UsesCanonicalGridState: boolean = false;\n\n  /**\n   * Default: this view type has no built-in export UI, so a host should provide a fallback Export\n   * affordance. Override to `true` in a view type that ships its own export (see\n   * {@link IViewTypeDescriptor.ProvidesOwnExport}).\n   */\n  readonly ProvidesOwnExport: boolean = false;\n\n  /**\n   * Default availability: available for every entity. Override in subclasses that have\n   * requirements (e.g. Timeline needs a date field, Map needs geocoding).\n   */\n  IsAvailableFor(_entity: EntityInfo, _provider?: IMetadataProvider): boolean {\n    return true;\n  }\n\n  /**\n   * Default: nothing to preload. Override in subclasses whose availability predicate needs\n   * async data (e.g. the Cluster view type loading which entities have Entity Documents).\n   */\n  async EnsureAvailabilityData(_provider?: IMetadataProvider): Promise<void> {\n    // no-op by default\n  }\n}\n\n/**\n * Tree-shaking guard. Force-references {@link RegisterClass} so bundlers don't drop the\n * decorator import in builds that only touch this contracts module. Concrete descriptor\n * modules each carry their own `@RegisterClass` and load guard, but this keeps the base\n * module self-consistent.\n */\nexport function LoadViewTypeContracts(): void {\n  // no-op; presence prevents tree-shaking of this module's side-effect-free exports\n  void RegisterClass;\n}\n"]}

package/dist/lib/view-workspace/view-workspace.component.d.ts

@@ -293,7 +293,15 @@ export declare class ViewWorkspaceComponent extends BaseAngularComponent impleme
     onExportRequested(): Promise<void>;
     /** Closes the workspace export dialog (the dialog performs the export + download itself). */
     onExportDialogClosed(_result: ExportDialogResult): void;
-    /** Columns to export — from the active grid state, else the view's columns, else the entity fields. */
+    /**
+     * Columns to export: what the active renderer shows on screen (the grid), else the view's saved
+     * columns, else the entity fields. The fallbacks apply the grid's own rules, so Cards, Map and
+     * Timeline export the columns a grid of this view would show: saved settings are sorted by
+     * `orderIndex`, headed by the user's rename, resolved to the entity's field spelling (the export
+     * engine reads each row by that key), and dropped when the field no longer exists; fields the
+     * user is denied read access to are left out. Each column carries the type the grid gives it, so a
+     * date-only field exports as its day (`YYYY-MM-DD`) here as it does from the grid.
+     */
     private buildExportColumns;
     private buildExportFileName;
     /** Initializes the workspace and loads the per-user default grid state for the entity. */

package/dist/lib/view-workspace/view-workspace.component.d.ts.map

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

package/dist/lib/view-workspace/view-workspace.component.js

@@ -3,6 +3,7 @@ import { BaseAngularComponent } from '@memberjunction/ng-base-types';
 import { LogError } from '@memberjunction/core';
 import { UUIDsEqual } from '@memberjunction/global';
 import { UserInfoEngine } from '@memberjunction/core-entities';
+import { ExportColumnTypeForSQLType } from '../utils/export-column.util';
 import { MJNotificationService } from '@memberjunction/ng-notifications';
 import { EntityViewerComponent } from '../entity-viewer/entity-viewer.component';
 import { ViewSelectorComponent } from '../view-selector/view-selector.component';
@@ -403,20 +404,50 @@ export class ViewWorkspaceComponent extends BaseAngularComponent {
         this.exportDialogConfig = null;
         this.cdr.detectChanges();
     }
-    /** Columns to export — from the active grid state, else the view's columns, else the entity fields. */
+    /**
+     * Columns to export: what the active renderer shows on screen (the grid), else the view's saved
+     * columns, else the entity fields. The fallbacks apply the grid's own rules, so Cards, Map and
+     * Timeline export the columns a grid of this view would show: saved settings are sorted by
+     * `orderIndex`, headed by the user's rename, resolved to the entity's field spelling (the export
+     * engine reads each row by that key), and dropped when the field no longer exists; fields the
+     * user is denied read access to are left out. Each column carries the type the grid gives it, so a
+     * date-only field exports as its day (`YYYY-MM-DD`) here as it does from the grid.
+     */
     buildExportColumns() {
-        if (!this._entity) {
+        const entity = this._entity;
+        if (!entity) {
             return [];
         }
+        const onScreen = this.entityViewerRef?.GetExportColumns() ?? [];
+        if (onScreen.length > 0) {
+            return onScreen;
+        }
+        const user = this.ProviderToUse?.CurrentUser;
+        const denied = user ? entity.GetDeniedReadFields(user) : new Set();
+        const readable = (f) => !denied.has(f.Name.trim().toLowerCase());
         const gridCols = this.currentGridState?.columnSettings;
         if (gridCols && gridCols.length > 0) {
-            return gridCols
+            const columns = [];
+            const sorted = [...gridCols]
                 .filter(c => c.hidden !== true)
-                .map(c => ({ name: c.Name, displayName: c.DisplayName || c.Name }));
+                .sort((a, b) => (a.orderIndex ?? 0) - (b.orderIndex ?? 0));
+            for (const c of sorted) {
+                const field = entity.Fields.find(f => f.Name.toLowerCase() === c.Name.toLowerCase());
+                if (field && readable(field)) {
+                    columns.push({
+                        name: field.Name,
+                        displayName: c.userDisplayName || c.DisplayName || field.DisplayNameOrName,
+                        dataType: ExportColumnTypeForSQLType(field.Type),
+                    });
+                }
+            }
+            if (columns.length > 0) {
+                return columns;
+            }
         }
-        return this._entity.Fields
-            .filter(f => !f.IsVirtual)
-            .map(f => ({ name: f.Name, displayName: f.DisplayNameOrName }));
+        return entity.Fields
+            .filter(f => !f.IsVirtual && readable(f))
+            .map(f => ({ name: f.Name, displayName: f.DisplayNameOrName, dataType: ExportColumnTypeForSQLType(f.Type) }));
     }
     buildExportFileName() {
         const viewName = this.currentViewEntity?.Name || 'Data';
@@ -1345,5 +1376,5 @@ export class ViewWorkspaceComponent extends BaseAngularComponent {
             type: ViewChild,
             args: [ViewConfigPanelComponent]
         }] }); })();
-(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(ViewWorkspaceComponent, { className: "ViewWorkspaceComponent", filePath: "src/lib/view-workspace/view-workspace.component.ts", lineNumber: 132 }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(ViewWorkspaceComponent, { className: "ViewWorkspaceComponent", filePath: "src/lib/view-workspace/view-workspace.component.ts", lineNumber: 133 }); })();
 //# sourceMappingURL=view-workspace.component.js.map