@mintplayer/ng-spark 22.2.0 → 22.4.0

package/types/mintplayer-ng-spark-po-detail.d.ts

@@ -2,13 +2,13 @@ import * as _angular_core from '@angular/core';
 import { TemplateRef, Type } from '@angular/core';
 import { Color } from '@mintplayer/ng-bootstrap';
 import { SparkLanguageService } from '@mintplayer/ng-spark/services';
-import { PersistentObject, EntityType, CustomActionDefinition, LookupReference, EntityAttributeDefinition, AttributeTab, AttributeGroup, SparkQuery } from '@mintplayer/ng-spark/models';
-import { DatatableSettings, BsDatatableFetch } from '@mintplayer/ng-bootstrap/datatable';
+import { PersistentObject, EntityType, CustomActionDefinition, LookupReference, EntityAttributeDefinition, AttributeTab, AttributeGroup } from '@mintplayer/ng-spark/models';
 
 declare class SparkPoDetailComponent {
     private readonly route;
     private readonly router;
     private readonly sparkService;
+    private readonly queryRefresh;
     protected readonly lang: SparkLanguageService;
     private readonly rendererRegistry;
     showCustomActions: _angular_core.InputSignal<boolean>;
@@ -17,6 +17,21 @@ declare class SparkPoDetailComponent {
         $implicit: PersistentObject;
         entityType: EntityType;
     }> | null>;
+    /**
+     * Header slots forwarded to every sub-query card on this page.
+     *
+     * A structural directive cannot cross a component boundary, and this component is created by
+     * the router — in a default app there is no `<spark-po-detail>` tag to project content into.
+     * So an app that wants slotted chrome on its sub-queries substitutes its own route component
+     * via `SparkRouteConfig.poDetail` and forwards the templates through here. Forwarding a
+     * `TemplateRef` as an input is already this component's idiom; see the two above.
+     *
+     * Each slot may target one query by alias, so a single forwarded set serves a page rendering
+     * several sub-queries.
+     */
+    queryIconTemplate: _angular_core.InputSignal<TemplateRef<any> | null>;
+    queryCaptionTemplate: _angular_core.InputSignal<TemplateRef<any> | null>;
+    queryActionsTemplate: _angular_core.InputSignal<TemplateRef<any> | null>;
     edited: _angular_core.OutputEmitterRef<void>;
     deleted: _angular_core.OutputEmitterRef<void>;
     customActionExecuted: _angular_core.OutputEmitterRef<{
@@ -56,34 +71,7 @@ declare class SparkPoDetailComponent {
     onDelete(): Promise<void>;
     onBack(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkPoDetailComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkPoDetailComponent, "spark-po-detail", never, { "showCustomActions": { "alias": "showCustomActions"; "required": false; "isSignal": true; }; "extraActionsTemplate": { "alias": "extraActionsTemplate"; "required": false; "isSignal": true; }; "extraContentTemplate": { "alias": "extraContentTemplate"; "required": false; "isSignal": true; }; }, { "edited": "edited"; "deleted": "deleted"; "customActionExecuted": "customActionExecuted"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkPoDetailComponent, "spark-po-detail", never, { "showCustomActions": { "alias": "showCustomActions"; "required": false; "isSignal": true; }; "extraActionsTemplate": { "alias": "extraActionsTemplate"; "required": false; "isSignal": true; }; "extraContentTemplate": { "alias": "extraContentTemplate"; "required": false; "isSignal": true; }; "queryIconTemplate": { "alias": "queryIconTemplate"; "required": false; "isSignal": true; }; "queryCaptionTemplate": { "alias": "queryCaptionTemplate"; "required": false; "isSignal": true; }; "queryActionsTemplate": { "alias": "queryActionsTemplate"; "required": false; "isSignal": true; }; }, { "edited": "edited"; "deleted": "deleted"; "customActionExecuted": "customActionExecuted"; }, never, never, true, never>;
 }
 
-declare class SparkSubQueryComponent {
-    private readonly sparkService;
-    private readonly rendererRegistry;
-    queryId: _angular_core.InputSignal<string>;
-    parentId: _angular_core.InputSignal<string>;
-    parentType: _angular_core.InputSignal<string>;
-    query: _angular_core.WritableSignal<SparkQuery | null>;
-    entityType: _angular_core.WritableSignal<EntityType | null>;
-    allEntityTypes: _angular_core.WritableSignal<EntityType[]>;
-    resultCount: _angular_core.WritableSignal<number | null>;
-    lookupReferenceOptions: _angular_core.WritableSignal<Record<string, LookupReference>>;
-    loading: _angular_core.WritableSignal<boolean>;
-    canRead: _angular_core.WritableSignal<boolean>;
-    settings: _angular_core.WritableSignal<DatatableSettings>;
-    fetchFn: _angular_core.WritableSignal<BsDatatableFetch<PersistentObject> | null>;
-    isVirtualScrolling: _angular_core.Signal<boolean>;
-    visibleAttributes: _angular_core.Signal<EntityAttributeDefinition[]>;
-    constructor();
-    private loadData;
-    private makeFetch;
-    private loadLookupReferenceOptions;
-    getColumnRendererComponent(attr: EntityAttributeDefinition): Type<any> | null;
-    getColumnRendererInputs(component: Type<any>, item: PersistentObject, attr: EntityAttributeDefinition): Record<string, any>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SparkSubQueryComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SparkSubQueryComponent, "spark-sub-query", never, { "queryId": { "alias": "queryId"; "required": true; "isSignal": true; }; "parentId": { "alias": "parentId"; "required": true; "isSignal": true; }; "parentType": { "alias": "parentType"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-export { SparkPoDetailComponent, SparkSubQueryComponent };
+export { SparkPoDetailComponent };

package/types/mintplayer-ng-spark-query-list.d.ts

@@ -1,18 +1,34 @@
+import * as _mintplayer_ng_spark_models from '@mintplayer/ng-spark/models';
+import { PersistentObject, CustomActionDefinition } from '@mintplayer/ng-spark/models';
 import * as _angular_core from '@angular/core';
-import { TemplateRef, Type } from '@angular/core';
+import { TemplateRef } from '@angular/core';
 import { Color } from '@mintplayer/ng-bootstrap';
-import { BsDatatableFetch, DatatableSettings } from '@mintplayer/ng-bootstrap/datatable';
 import { SparkLanguageService } from '@mintplayer/ng-spark/services';
-import { PersistentObject, CustomActionDefinition, SparkQuery, EntityType, LookupReference, EntityAttributeDefinition } from '@mintplayer/ng-spark/models';
 
+/**
+ * The routed query page: chrome around one {@link SparkQueryGridComponent}.
+ *
+ * It owns what is genuinely page-shaped and route-shaped, and nothing else:
+ *
+ *  - **Route resolution.** It has no `queryId` input; it reads `paramMap`, and it serves two
+ *    routes — `query/:queryId`, and `po/:type`, which resolves an entity type to a query. That
+ *    second one is type-to-query resolution, not query rendering, and is why this component still
+ *    exists rather than the router pointing at the grid.
+ *  - **Streaming.** The websocket lives here so it stays out of every PO detail page's bundle;
+ *    the snapshot is filtered and sorted client-side and handed to the grid as `[data]`.
+ *  - The action bar, the caption, the LIVE badge, the search box and the New button.
+ *
+ * The grid itself — columns, cells, paging, the row link, selection, custom-action execution —
+ * is the shared component. This page previously wrote out `<bs-datatable>` twice, once per
+ * transport, with a shared row template between them; both are gone.
+ */
 declare class SparkQueryListComponent {
     private readonly route;
     private readonly router;
     private readonly sparkService;
     private readonly streamingService;
-    protected readonly lang: SparkLanguageService;
-    private readonly rendererRegistry;
     private readonly destroyRef;
+    protected readonly lang: SparkLanguageService;
     extraActionsTemplate: _angular_core.InputSignal<TemplateRef<void> | null>;
     showCustomActions: _angular_core.InputSignal<boolean>;
     rowClicked: _angular_core.OutputEmitterRef<PersistentObject>;
@@ -21,44 +37,48 @@ declare class SparkQueryListComponent {
         action: CustomActionDefinition;
     }>;
     colors: typeof Color;
+    /** The query the grid should render, resolved from the route. Null until it is known. */
+    queryId: _angular_core.WritableSignal<string | null>;
     errorMessage: _angular_core.WritableSignal<string | null>;
-    query: _angular_core.WritableSignal<SparkQuery | null>;
-    entityType: _angular_core.WritableSignal<EntityType | null>;
-    allEntityTypes: _angular_core.WritableSignal<EntityType[]>;
-    lookupReferenceOptions: _angular_core.WritableSignal<Record<string, LookupReference>>;
-    resultCount: _angular_core.WritableSignal<number | null>;
-    searchTerm: string;
-    canRead: _angular_core.WritableSignal<boolean>;
-    canCreate: _angular_core.WritableSignal<boolean>;
-    customActions: _angular_core.WritableSignal<CustomActionDefinition[]>;
+    searchTerm: _angular_core.WritableSignal<string>;
+    private readonly grid;
+    /**
+     * Grid state, surfaced for this page's chrome.
+     *
+     * Optional `viewChild`, read defensively: the action bar and caption render above the grid, so
+     * on the first change-detection pass the query has not resolved yet.
+     */
+    protected readonly query: _angular_core.Signal<_mintplayer_ng_spark_models.SparkQuery | null>;
+    protected readonly entityType: _angular_core.Signal<_mintplayer_ng_spark_models.EntityType | null>;
+    protected readonly customActions: _angular_core.Signal<CustomActionDefinition[]>;
+    protected readonly canCreate: _angular_core.Signal<boolean>;
+    protected readonly resultCount: _angular_core.Signal<number | null>;
+    protected readonly isVirtualScrolling: _angular_core.Signal<boolean>;
+    protected readonly gridError: _angular_core.Signal<string | null>;
+    /** Whether an action's selection rule is satisfied. Delegated: the grid holds the selection. */
+    protected isActionEnabled(action: CustomActionDefinition): boolean;
     isStreaming: _angular_core.WritableSignal<boolean>;
     private streamingSub;
-    private allItems;
-    streamItems: _angular_core.WritableSignal<PersistentObject[]>;
-    fetchFn: _angular_core.WritableSignal<BsDatatableFetch<PersistentObject> | null>;
-    settings: _angular_core.WritableSignal<DatatableSettings>;
+    private readonly allItems;
+    private readonly streamItems;
+    /**
+     * Rows handed to the grid, or `null` to let it fetch for itself.
+     *
+     * Null for a normal query — an empty array would read as "here are no rows" and suppress the
+     * fetch entirely.
+     */
+    protected readonly gridData: _angular_core.Signal<PersistentObject[] | null>;
     constructor();
     private onParamsChange;
-    onCustomAction(action: CustomActionDefinition): Promise<void>;
-    private resolveEntityTypeForQuery;
-    private extractSourceName;
-    private singularize;
     /**
-     * Builds the server-side fetch callback the datatable invokes per page/sort.
-     * Reads `searchTerm` live, so a settings change (or a new fetchFn identity)
-     * refetches with the current search term.
+     * A load failure has to render, not just be swallowed: a denied query answers 404 (audit M-3, so
+     * existence is not leaked), which is indistinguishable from a missing one — hence a deliberately
+     * generic message rather than a guess at which it was.
      */
-    private makeFetch;
-    /** Force a refetch (e.g. after a custom action) without changing page/sort. */
-    private refresh;
-    onSearchChange(): void;
-    clearSearch(): void;
-    isVirtualScrolling: _angular_core.Signal<boolean>;
-    visibleAttributes: _angular_core.Signal<EntityAttributeDefinition[]>;
-    getColumnRendererComponent(attr: EntityAttributeDefinition): Type<any> | null;
-    getColumnRendererInputs(component: Type<any>, item: PersistentObject, attr: EntityAttributeDefinition): Record<string, any>;
-    private loadLookupReferenceOptions;
-    onCreate(): void;
+    private reportLoadFailure;
+    protected onCustomAction(action: CustomActionDefinition): Promise<void>;
+    protected onCreate(): void;
+    protected clearSearch(): void;
     private connectStreaming;
     private disconnectStreaming;
     private handleStreamingMessage;