@memberjunction/ng-clustering 5.38.0 → 5.40.0

package/dist/lib/view-type/cluster-view-prop-sheet.component.js

@@ -0,0 +1,185 @@
+import { Component, Input, Output, EventEmitter, ViewEncapsulation } from '@angular/core';
+import { EntityInfo } from '@memberjunction/core';
+import { toClusterViewConfig } from './cluster-view.types';
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/forms";
+function ClusterViewPropSheetComponent_Conditional_9_Template(rf, ctx) { if (rf & 1) {
+    const _r1 = i0.ɵɵgetCurrentView();
+    i0.ɵɵelementStart(0, "label", 1)(1, "span");
+    i0.ɵɵtext(2, "Clusters (K)");
+    i0.ɵɵelementEnd();
+    i0.ɵɵelementStart(3, "input", 11);
+    i0.ɵɵlistener("input", function ClusterViewPropSheetComponent_Conditional_9_Template_input_input_3_listener($event) { i0.ɵɵrestoreView(_r1); const ctx_r1 = i0.ɵɵnextContext(); return i0.ɵɵresetView(ctx_r1.patch({ k: ctx_r1.asInt($event.target.value, ctx_r1.cfg.k) })); });
+    i0.ɵɵelementEnd()();
+} if (rf & 2) {
+    const ctx_r1 = i0.ɵɵnextContext();
+    i0.ɵɵadvance(3);
+    i0.ɵɵproperty("value", ctx_r1.cfg.k);
+} }
+/**
+ * ClusterViewPropSheetComponent
+ * -----------------------------
+ * The configuration prop-sheet for the Cluster view type — honors {@link IViewPropSheet}.
+ * Lets the user pick the algorithm, cluster count, 2D/3D layout, legend coloring, record cap,
+ * and LLM naming. Emits the updated config (as the opaque host map) on every change so the host
+ * can persist it into `UserView.DisplayState.viewTypeConfigs` and re-render the cluster.
+ */
+export class ClusterViewPropSheetComponent {
+    constructor() {
+        this.entity = null;
+        this._config = {};
+        this.configChange = new EventEmitter();
+        /** The current parsed config (defaults applied) bound by the template. */
+        this.cfg = toClusterViewConfig({});
+    }
+    set config(value) {
+        this._config = value ?? {};
+        this.cfg = toClusterViewConfig(this._config);
+    }
+    get config() {
+        return this._config;
+    }
+    /** Apply a partial change, re-emit the full config map to the host. */
+    patch(change) {
+        this.cfg = { ...this.cfg, ...change };
+        this._config = { ...this.cfg };
+        this.configChange.emit(this._config);
+    }
+    asAlgorithm(v) {
+        return v === 'dbscan' ? 'dbscan' : 'kmeans';
+    }
+    asDimensions(v) {
+        return String(v) === '3' ? 3 : 2;
+    }
+    asColorBy(v) {
+        return v === 'entity' ? 'entity' : 'cluster';
+    }
+    asInt(v, fallback) {
+        const n = parseInt(v, 10);
+        return Number.isNaN(n) ? fallback : n;
+    }
+    static { this.ɵfac = function ClusterViewPropSheetComponent_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || ClusterViewPropSheetComponent)(); }; }
+    static { this.ɵcmp = /*@__PURE__*/ i0.ɵɵdefineComponent({ type: ClusterViewPropSheetComponent, selectors: [["mj-cluster-view-prop-sheet"]], inputs: { entity: "entity", config: "config" }, outputs: { configChange: "configChange" }, standalone: false, decls: 34, vars: 8, consts: [[1, "cluster-prop-sheet"], [1, "cluster-prop-row"], [1, "mj-input", 3, "change", "value"], ["value", "kmeans"], ["value", "dbscan"], [3, "value"], ["value", "cluster"], ["value", "entity"], ["type", "number", "min", "50", "max", "5000", "step", "50", 1, "mj-input", 3, "input", "value"], [1, "cluster-prop-row", "cluster-prop-row--inline"], ["type", "checkbox", 1, "mj-checkbox", 3, "change", "checked"], ["type", "number", "min", "2", "max", "20", 1, "mj-input", 3, "input", "value"]], template: function ClusterViewPropSheetComponent_Template(rf, ctx) { if (rf & 1) {
+            i0.ɵɵelementStart(0, "div", 0)(1, "label", 1)(2, "span");
+            i0.ɵɵtext(3, "Algorithm");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(4, "select", 2);
+            i0.ɵɵlistener("change", function ClusterViewPropSheetComponent_Template_select_change_4_listener($event) { return ctx.patch({ algorithm: ctx.asAlgorithm($event.target.value) }); });
+            i0.ɵɵelementStart(5, "option", 3);
+            i0.ɵɵtext(6, "K-Means");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(7, "option", 4);
+            i0.ɵɵtext(8, "DBSCAN");
+            i0.ɵɵelementEnd()()();
+            i0.ɵɵconditionalCreate(9, ClusterViewPropSheetComponent_Conditional_9_Template, 4, 1, "label", 1);
+            i0.ɵɵelementStart(10, "label", 1)(11, "span");
+            i0.ɵɵtext(12, "Layout");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(13, "select", 2);
+            i0.ɵɵlistener("change", function ClusterViewPropSheetComponent_Template_select_change_13_listener($event) { return ctx.patch({ dimensions: ctx.asDimensions($event.target.value) }); });
+            i0.ɵɵelementStart(14, "option", 5);
+            i0.ɵɵtext(15, "2D");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(16, "option", 5);
+            i0.ɵɵtext(17, "3D");
+            i0.ɵɵelementEnd()()();
+            i0.ɵɵelementStart(18, "label", 1)(19, "span");
+            i0.ɵɵtext(20, "Color by");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(21, "select", 2);
+            i0.ɵɵlistener("change", function ClusterViewPropSheetComponent_Template_select_change_21_listener($event) { return ctx.patch({ colorBy: ctx.asColorBy($event.target.value) }); });
+            i0.ɵɵelementStart(22, "option", 6);
+            i0.ɵɵtext(23, "Cluster");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(24, "option", 7);
+            i0.ɵɵtext(25, "Entity");
+            i0.ɵɵelementEnd()()();
+            i0.ɵɵelementStart(26, "label", 1)(27, "span");
+            i0.ɵɵtext(28, "Max records");
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(29, "input", 8);
+            i0.ɵɵlistener("input", function ClusterViewPropSheetComponent_Template_input_input_29_listener($event) { return ctx.patch({ maxRecords: ctx.asInt($event.target.value, ctx.cfg.maxRecords) }); });
+            i0.ɵɵelementEnd()();
+            i0.ɵɵelementStart(30, "label", 9)(31, "input", 10);
+            i0.ɵɵlistener("change", function ClusterViewPropSheetComponent_Template_input_change_31_listener($event) { return ctx.patch({ nameClusters: $event.target.checked }); });
+            i0.ɵɵelementEnd();
+            i0.ɵɵelementStart(32, "span");
+            i0.ɵɵtext(33, "Name clusters with AI");
+            i0.ɵɵelementEnd()()();
+        } if (rf & 2) {
+            i0.ɵɵadvance(4);
+            i0.ɵɵproperty("value", ctx.cfg.algorithm);
+            i0.ɵɵadvance(5);
+            i0.ɵɵconditional(ctx.cfg.algorithm === "kmeans" ? 9 : -1);
+            i0.ɵɵadvance(4);
+            i0.ɵɵproperty("value", ctx.cfg.dimensions);
+            i0.ɵɵadvance();
+            i0.ɵɵproperty("value", 2);
+            i0.ɵɵadvance(2);
+            i0.ɵɵproperty("value", 3);
+            i0.ɵɵadvance(5);
+            i0.ɵɵproperty("value", ctx.cfg.colorBy);
+            i0.ɵɵadvance(8);
+            i0.ɵɵproperty("value", ctx.cfg.maxRecords);
+            i0.ɵɵadvance(2);
+            i0.ɵɵproperty("checked", ctx.cfg.nameClusters);
+        } }, dependencies: [i1.NgSelectOption, i1.ɵNgSelectMultipleOption], styles: ["\n    .cluster-prop-sheet { display: flex; flex-direction: column; gap: 12px; padding: 12px; }\n    .cluster-prop-row { display: flex; flex-direction: column; gap: 4px; font-size: 13px; color: var(--mj-text-secondary); }\n    .cluster-prop-row--inline { flex-direction: row; align-items: center; gap: 8px; }\n  "], encapsulation: 2 }); }
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(ClusterViewPropSheetComponent, [{
+        type: Component,
+        args: [{ standalone: false, selector: 'mj-cluster-view-prop-sheet', encapsulation: ViewEncapsulation.None, template: `
+    <div class="cluster-prop-sheet">
+      <label class="cluster-prop-row">
+        <span>Algorithm</span>
+        <select class="mj-input" [value]="cfg.algorithm" (change)="patch({ algorithm: asAlgorithm($any($event.target).value) })">
+          <option value="kmeans">K-Means</option>
+          <option value="dbscan">DBSCAN</option>
+        </select>
+      </label>
+
+      @if (cfg.algorithm === 'kmeans') {
+        <label class="cluster-prop-row">
+          <span>Clusters (K)</span>
+          <input class="mj-input" type="number" min="2" max="20" [value]="cfg.k"
+                 (input)="patch({ k: asInt($any($event.target).value, cfg.k) })" />
+        </label>
+      }
+
+      <label class="cluster-prop-row">
+        <span>Layout</span>
+        <select class="mj-input" [value]="cfg.dimensions" (change)="patch({ dimensions: asDimensions($any($event.target).value) })">
+          <option [value]="2">2D</option>
+          <option [value]="3">3D</option>
+        </select>
+      </label>
+
+      <label class="cluster-prop-row">
+        <span>Color by</span>
+        <select class="mj-input" [value]="cfg.colorBy" (change)="patch({ colorBy: asColorBy($any($event.target).value) })">
+          <option value="cluster">Cluster</option>
+          <option value="entity">Entity</option>
+        </select>
+      </label>
+
+      <label class="cluster-prop-row">
+        <span>Max records</span>
+        <input class="mj-input" type="number" min="50" max="5000" step="50" [value]="cfg.maxRecords"
+               (input)="patch({ maxRecords: asInt($any($event.target).value, cfg.maxRecords) })" />
+      </label>
+
+      <label class="cluster-prop-row cluster-prop-row--inline">
+        <input class="mj-checkbox" type="checkbox" [checked]="cfg.nameClusters"
+               (change)="patch({ nameClusters: $any($event.target).checked })" />
+        <span>Name clusters with AI</span>
+      </label>
+    </div>
+  `, styles: ["\n    .cluster-prop-sheet { display: flex; flex-direction: column; gap: 12px; padding: 12px; }\n    .cluster-prop-row { display: flex; flex-direction: column; gap: 4px; font-size: 13px; color: var(--mj-text-secondary); }\n    .cluster-prop-row--inline { flex-direction: row; align-items: center; gap: 8px; }\n  "] }]
+    }], null, { entity: [{
+            type: Input
+        }], config: [{
+            type: Input
+        }], configChange: [{
+            type: Output
+        }] }); })();
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassDebugInfo(ClusterViewPropSheetComponent, { className: "ClusterViewPropSheetComponent", filePath: "src/lib/view-type/cluster-view-prop-sheet.component.ts", lineNumber: 71 }); })();
+//# sourceMappingURL=cluster-view-prop-sheet.component.js.map

package/dist/lib/view-type/cluster-view-prop-sheet.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-view-prop-sheet.component.js","sourceRoot":"","sources":["../../../src/lib/view-type/cluster-view-prop-sheet.component.ts"],"names":[],"mappings":"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","sourcesContent":["import { Component, Input, Output, EventEmitter, ViewEncapsulation } from '@angular/core';\nimport { EntityInfo } from '@memberjunction/core';\nimport { IViewPropSheet } from '@memberjunction/ng-entity-viewer';\nimport { ClusterViewConfig, toClusterViewConfig } from './cluster-view.types';\n\n/**\n * ClusterViewPropSheetComponent\n * -----------------------------\n * The configuration prop-sheet for the Cluster view type — honors {@link IViewPropSheet}.\n * Lets the user pick the algorithm, cluster count, 2D/3D layout, legend coloring, record cap,\n * and LLM naming. Emits the updated config (as the opaque host map) on every change so the host\n * can persist it into `UserView.DisplayState.viewTypeConfigs` and re-render the cluster.\n */\n@Component({\n  standalone: false,\n  selector: 'mj-cluster-view-prop-sheet',\n  encapsulation: ViewEncapsulation.None,\n  template: `\n    <div class=\"cluster-prop-sheet\">\n      <label class=\"cluster-prop-row\">\n        <span>Algorithm</span>\n        <select class=\"mj-input\" [value]=\"cfg.algorithm\" (change)=\"patch({ algorithm: asAlgorithm($any($event.target).value) })\">\n          <option value=\"kmeans\">K-Means</option>\n          <option value=\"dbscan\">DBSCAN</option>\n        </select>\n      </label>\n\n      @if (cfg.algorithm === 'kmeans') {\n        <label class=\"cluster-prop-row\">\n          <span>Clusters (K)</span>\n          <input class=\"mj-input\" type=\"number\" min=\"2\" max=\"20\" [value]=\"cfg.k\"\n                 (input)=\"patch({ k: asInt($any($event.target).value, cfg.k) })\" />\n        </label>\n      }\n\n      <label class=\"cluster-prop-row\">\n        <span>Layout</span>\n        <select class=\"mj-input\" [value]=\"cfg.dimensions\" (change)=\"patch({ dimensions: asDimensions($any($event.target).value) })\">\n          <option [value]=\"2\">2D</option>\n          <option [value]=\"3\">3D</option>\n        </select>\n      </label>\n\n      <label class=\"cluster-prop-row\">\n        <span>Color by</span>\n        <select class=\"mj-input\" [value]=\"cfg.colorBy\" (change)=\"patch({ colorBy: asColorBy($any($event.target).value) })\">\n          <option value=\"cluster\">Cluster</option>\n          <option value=\"entity\">Entity</option>\n        </select>\n      </label>\n\n      <label class=\"cluster-prop-row\">\n        <span>Max records</span>\n        <input class=\"mj-input\" type=\"number\" min=\"50\" max=\"5000\" step=\"50\" [value]=\"cfg.maxRecords\"\n               (input)=\"patch({ maxRecords: asInt($any($event.target).value, cfg.maxRecords) })\" />\n      </label>\n\n      <label class=\"cluster-prop-row cluster-prop-row--inline\">\n        <input class=\"mj-checkbox\" type=\"checkbox\" [checked]=\"cfg.nameClusters\"\n               (change)=\"patch({ nameClusters: $any($event.target).checked })\" />\n        <span>Name clusters with AI</span>\n      </label>\n    </div>\n  `,\n  styles: [`\n    .cluster-prop-sheet { display: flex; flex-direction: column; gap: 12px; padding: 12px; }\n    .cluster-prop-row { display: flex; flex-direction: column; gap: 4px; font-size: 13px; color: var(--mj-text-secondary); }\n    .cluster-prop-row--inline { flex-direction: row; align-items: center; gap: 8px; }\n  `],\n})\nexport class ClusterViewPropSheetComponent implements IViewPropSheet<Record<string, unknown>> {\n  @Input() entity: EntityInfo | null = null;\n\n  private _config: Record<string, unknown> = {};\n  @Input()\n  set config(value: Record<string, unknown>) {\n    this._config = value ?? {};\n    this.cfg = toClusterViewConfig(this._config);\n  }\n  get config(): Record<string, unknown> {\n    return this._config;\n  }\n\n  @Output() configChange = new EventEmitter<Record<string, unknown>>();\n\n  /** The current parsed config (defaults applied) bound by the template. */\n  public cfg: ClusterViewConfig = toClusterViewConfig({});\n\n  /** Apply a partial change, re-emit the full config map to the host. */\n  patch(change: Partial<ClusterViewConfig>): void {\n    this.cfg = { ...this.cfg, ...change };\n    this._config = { ...this.cfg } as unknown as Record<string, unknown>;\n    this.configChange.emit(this._config);\n  }\n\n  asAlgorithm(v: string): 'kmeans' | 'dbscan' {\n    return v === 'dbscan' ? 'dbscan' : 'kmeans';\n  }\n  asDimensions(v: string): 2 | 3 {\n    return String(v) === '3' ? 3 : 2;\n  }\n  asColorBy(v: string): 'cluster' | 'entity' {\n    return v === 'entity' ? 'entity' : 'cluster';\n  }\n  asInt(v: string, fallback: number): number {\n    const n = parseInt(v, 10);\n    return Number.isNaN(n) ? fallback : n;\n  }\n}\n"]}

package/dist/lib/view-type/cluster-view-renderer.component.d.ts

@@ -0,0 +1,143 @@
+import { EventEmitter, ChangeDetectorRef, OnInit, OnDestroy } from '@angular/core';
+import { EntityInfo } from '@memberjunction/core';
+import { BaseAngularComponent } from '@memberjunction/ng-base-types';
+import { IViewRenderer } from '@memberjunction/ng-entity-viewer';
+import { ClusterPoint, ClusterInfo } from '../clustering.types';
+import { ClusterViewConfig } from './cluster-view.types';
+import * as i0 from "@angular/core";
+/**
+ * ClusterViewRendererComponent
+ * ----------------------------
+ * The Cluster **view type** renderer — a thin {@link IViewRenderer} adapter that lets any
+ * entity with vectors be visualized as a cluster scatter directly inside `mj-entity-viewer`,
+ * reusing the exact same {@link ClusteringService} + `mj-cluster-scatter` the Knowledge Hub
+ * "Visualize" cluster surface uses.
+ *
+ * The host feeds it the standard renderer inputs (entity / records / filterText / config) via
+ * `setInput`, and listens for `recordSelected` / `recordOpened`. When the entity or config
+ * changes it re-runs the clustering pipeline and rebinds the scatter.
+ *
+ * **Why this mirrors the Knowledge Hub resource rather than the server `RunClusterAnalysis`
+ * path:** the server analysis returns points keyed only by record ID (so labels render as
+ * "Unknown"), produces generic "Cluster N" names, and picks an Entity Document
+ * non-deterministically when none is supplied (causing flip-flop "no vectors" results). This
+ * renderer instead:
+ *  1. Resolves the entity's **first active Entity Document explicitly** (deterministic source).
+ *  2. Fetches that document's vectors (with their JSON metadata) via {@link GraphQLAIClient.FetchEntityVectors}.
+ *  3. Builds real point labels from the entity's `IsNameField` fields ({@link buildLabel}).
+ *  4. Clusters in-browser via {@link ClusteringService.RunClustering} (client owns vectors + labels).
+ *  5. Requests + applies **LLM cluster names** so clusters read semantically, not "Cluster 1..5".
+ *
+ * Inputs use the camelCase names mandated by the {@link IViewRenderer} contract (the host
+ * binds them by those exact names), rather than MJ's usual PascalCase for public members.
+ */
+export declare class ClusterViewRendererComponent extends BaseAngularComponent implements IViewRenderer<Record<string, unknown>>, OnInit, OnDestroy {
+    private cdr;
+    private _entity;
+    set entity(value: EntityInfo | null);
+    get entity(): EntityInfo | null;
+    /** The view's records — used to map a clicked point back to its record object. */
+    records: Record<string, unknown>[];
+    selectedRecordId: string | null;
+    filterText: string | null;
+    private _config;
+    set config(value: Record<string, unknown>);
+    get config(): Record<string, unknown>;
+    recordSelected: EventEmitter<unknown>;
+    recordOpened: EventEmitter<unknown>;
+    configChanged: EventEmitter<Record<string, unknown>>;
+    /** The current parsed config (defaults applied). */
+    activeConfig: ClusterViewConfig;
+    points: ClusterPoint[];
+    clusters: ClusterInfo[];
+    /** Ordered field keys for prioritized display in the scatter tooltip / detail panel. */
+    fieldPriority: string[];
+    /** Map of field names → human-readable display names for the scatter tooltip / detail panel. */
+    fieldDisplayNames: Record<string, string>;
+    isLoading: boolean;
+    errorMessage: string | null;
+    private recluster$;
+    private destroy$;
+    private clusteringService;
+    /**
+     * Monotonically increasing token captured at the start of each run. Because runs are async
+     * and overlapping (entity/config can change mid-flight), each run compares the token it
+     * captured against the latest before applying results — a stale run silently bails so it
+     * cannot clobber a newer one.
+     */
+    private runToken;
+    constructor(cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private scheduleRecluster;
+    /**
+     * Run the clustering pipeline for the current entity + config and rebind the scatter.
+     *
+     * Mirrors the Knowledge Hub "Visualize" flow: resolve a deterministic Entity Document →
+     * fetch its vectors with metadata → build real labels → cluster client-side → request LLM
+     * cluster names. Guarded by {@link runToken} so an overlapping/stale run never clobbers a
+     * newer one.
+     */
+    private runClustering;
+    /** True when a newer run has started since `token` was captured — the caller should bail. */
+    private isStale;
+    /** Apply a successful clustering result to the view (no-op if the run is stale). */
+    private applyResult;
+    /** Apply an error state to the view (no-op if the run is stale). */
+    private applyError;
+    /**
+     * Resolve the {@link GraphQLDataProvider} backing this component's metadata provider, or
+     * `null` when the active provider is not a GraphQL transport (e.g. non-browser).
+     */
+    private resolveGraphQLProvider;
+    /**
+     * Resolve the entity's first active Entity Document ID **explicitly** (deterministic),
+     * loading the availability engine cache if needed. Returns `null` when the entity has no
+     * active document.
+     */
+    private resolveEntityDocumentID;
+    /**
+     * Fetch the entity document's vectors (with metadata) and build {@link ClusterInputVector}s,
+     * deriving each point's display label from the entity's name fields.
+     */
+    private fetchVectors;
+    /** Parse the JSON metadata string stored alongside a vector into a flat string map. */
+    private parseVectorMetadata;
+    /**
+     * Build a human-readable label for a point from the entity's name-field metadata. Combines
+     * all `IsNameField` fields in Sequence order (e.g. "Sarah Chen" from FirstName + LastName),
+     * then falls back to the single NameField, then to common heuristic keys, then to the record
+     * ID — so points show real names instead of "Unknown".
+     */
+    private buildLabel;
+    /**
+     * Compute the prioritized field order + display names for the scatter tooltip / detail panel.
+     * Orders: name fields first, then default-in-view fields, then the rest by Sequence; skips
+     * internal/virtual/primary-key fields. Also populates {@link fieldDisplayNames}.
+     */
+    private computeFieldPriority;
+    /** Build the engine {@link ClusterConfig} from the entity + the view-type config. */
+    private buildClusterConfig;
+    /**
+     * After clustering completes, send sample records per cluster to the "Cluster Naming" AI
+     * prompt and apply the returned semantic labels to {@link clusters}. Best-effort: failures
+     * are logged and leave the provisional "Cluster N" labels in place. No-op if the run became
+     * stale while the LLM call was in flight.
+     */
+    private requestClusterLabelsFromLLM;
+    /** Build a text block describing sample records per cluster for the LLM naming prompt. */
+    private buildClusterDataForPrompt;
+    /** Apply LLM-generated labels onto the live {@link clusters} array by cluster ID. */
+    private applyLabelsToClusters;
+    onPointClicked(point: ClusterPoint): void;
+    onOpenRecordRequested(point: ClusterPoint): void;
+    /**
+     * Resolve the host record corresponding to a scatter point. The vector key is the Entity
+     * Record Document ID, so match on the point metadata's `RecordID` (the underlying entity
+     * record's primary key) first, then fall back to a direct key match.
+     */
+    private recordForPoint;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ClusterViewRendererComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ClusterViewRendererComponent, "mj-cluster-view-renderer", never, { "entity": { "alias": "entity"; "required": false; }; "records": { "alias": "records"; "required": false; }; "selectedRecordId": { "alias": "selectedRecordId"; "required": false; }; "filterText": { "alias": "filterText"; "required": false; }; "config": { "alias": "config"; "required": false; }; }, { "recordSelected": "recordSelected"; "recordOpened": "recordOpened"; "configChanged": "configChanged"; }, never, never, false, never>;
+}
+//# sourceMappingURL=cluster-view-renderer.component.d.ts.map

package/dist/lib/view-type/cluster-view-renderer.component.d.ts.map

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