@mintplayer/ng-spark 22.19.0 → 22.20.0

package/types/mintplayer-ng-spark-renderers.d.ts

@@ -101,6 +101,19 @@ interface SparkAttributeRendererRegistration {
     columnComponent?: Type<any> | null;
     /** Optional component for create/edit forms. Must implement SparkAttributeEditRenderer. When omitted, the default input is used. */
     editComponent?: Type<any>;
+    /**
+     * Relabels this column's values in a filter panel (#431).
+     *
+     * A renderer is a component that paints arbitrary DOM, and a distinct value has no row, so it
+     * cannot be instantiated to produce text for a filter list. The label therefore defaults to the
+     * server-computed cell text: a status rendered as a coloured pill lists `Active`, a rating
+     * rendered as stars lists `3`. This is the escape for when that is too raw — a value stored as
+     * `2` whose cell reads "High priority".
+     *
+     * ⚠️ A **pure function**: no DOM, no component instantiation, no row context. There is no row to
+     * give it, which is the whole reason the renderer itself cannot be used here.
+     */
+    filterLabel?: (value: unknown) => string;
 }
 declare const SPARK_ATTRIBUTE_RENDERERS: InjectionToken<SparkAttributeRendererRegistration[]>;
 /**

package/types/mintplayer-ng-spark-services.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { RetryActionPayload, RetryActionResult, TranslatedString, StreamingMessage, EntityType, EntityPermissions, SparkQuery, QueryResult, ProgramUnitsConfiguration, PersistentObject, CustomActionDefinition, LookupReferenceListItem, LookupReference, LookupReferenceValue } from '@mintplayer/ng-spark/models';
+import { RetryActionPayload, RetryActionResult, TranslatedString, StreamingMessage, QueryColumnFilter, EntityType, EntityPermissions, SparkQuery, QueryResult, DistinctValuesResult, ProgramUnitsConfiguration, PersistentObject, CustomActionDefinition, LookupReferenceListItem, LookupReference, LookupReferenceValue } from '@mintplayer/ng-spark/models';
 import { Observable } from 'rxjs';
 import { SortColumn } from '@mintplayer/pagination';
 import { SafeHtml } from '@angular/platform-browser';
@@ -96,14 +96,23 @@ declare class SparkService {
      * lifetime; the service is scoped to the app, so a permission change lands on the next load.
      */
     getQueryByName(name: string): Promise<SparkQuery | undefined>;
-    executeQuery(queryId: string, options?: {
-        sortColumns?: SortColumn[];
+    executeQuery(queryId: string, options?: ExecuteQueryOptions): Promise<QueryResult>;
+    /**
+     * The distinct values behind one column's filter panel (#431).
+     *
+     * `columns` carries the OTHER columns' current filters, so the values returned are the ones still
+     * reachable — offering a value that empties the grid the moment it is picked is worse than
+     * omitting it.
+     *
+     * An empty result means either "nothing matches" or "you may not enumerate this column". The two
+     * are deliberately indistinguishable, so there is nothing for a caller to branch on.
+     */
+    getDistinctValues(queryId: string, column: string, options?: {
+        search?: string;
+        columns?: QueryColumnFilter[];
         parentId?: string;
         parentType?: string;
-        skip?: number;
-        take?: number;
-        search?: string;
-    }): Promise<QueryResult>;
+    }): Promise<DistinctValuesResult>;
     /**
      * Runs a query identified by name.
      *
@@ -112,14 +121,7 @@ declare class SparkService {
      * that the list was cut. A picker that omits the option you are looking for, and says nothing, is
      * worse than one that fails.
      */
-    executeQueryByName(queryName: string, options?: {
-        parentId?: string;
-        parentType?: string;
-        skip?: number;
-        take?: number;
-        search?: string;
-        sortColumns?: SortColumn[];
-    }): Promise<QueryResult>;
+    executeQueryByName(queryName: string, options?: ExecuteQueryOptions): Promise<QueryResult>;
     getProgramUnits(): Promise<ProgramUnitsConfiguration>;
     get(type: string, id: string): Promise<PersistentObject>;
     create(type: string, data: Partial<PersistentObject>): Promise<PersistentObject>;
@@ -196,6 +198,23 @@ declare class SparkService {
     static ɵfac: i0.ɵɵFactoryDeclaration<SparkService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SparkService>;
 }
+/**
+ * The options every query execution takes.
+ *
+ * Extracted because `executeQueryByName` forwards to `executeQuery`, and while both spelled their
+ * options as separate inline literals a field added to one silently failed to forward from the
+ * other — which is how skip/take/search were once dropped for every reference picker.
+ */
+interface ExecuteQueryOptions {
+    sortColumns?: SortColumn[];
+    parentId?: string;
+    parentType?: string;
+    skip?: number;
+    take?: number;
+    search?: string;
+    /** Per-column value filters (#431). Columns AND together; values within a column OR. */
+    columns?: QueryColumnFilter[];
+}
 
 /**
  * R2-M12: SVG icon registry. The registry no longer accepts a raw string —
@@ -319,4 +338,4 @@ declare const sparkTimezoneInterceptor: HttpInterceptorFn;
 declare function withSparkTimezone(): HttpFeature<HttpFeatureKind>[];
 
 export { RetryActionService, SPARK_TIMEZONE_HEADER, SparkIconRegistry, SparkLanguageService, SparkQueryActionsService, SparkService, SparkStreamingService, resolveBrowserTimeZone, sparkTimezoneInterceptor, withSparkTimezone };
-export type { DeleteRowOptions, NewObjectOptions };
+export type { DeleteRowOptions, ExecuteQueryOptions, NewObjectOptions };